feat(ecosystem): discover, import, and use Codex pets

docs/interactive-capabilities/technical/tauri-command-map.json

@@ -4818,7 +4818,7 @@
       "visibility": "documented",
       "rustPath": "list_agent_companion_pets",
       "sourceFile": "src/apps/desktop/src/api/commands.rs",
-      "signature": "fn list_agent_companion_pets( state: State<'_, AppState>, ) -> Result<ListAgentCompanionPetsResponse, String>",
+      "signature": "fn list_agent_companion_pets( state: State<'_, AppState>, request: Option<ListAgentCompanionPetsRequest>, ) -> Result<ListAgentCompanionPetsResponse, String>",
       "remoteWorkspacePolicy": "LegacyUnaudited"
     },
     {

scripts/core-boundaries/cargo-dependency-boundaries.mjs

@@ -539,6 +539,13 @@ const THIRD_PARTY_CAPABILITY_PROFILES = new Map([
   ['image', {
     label: 'Image',
     packages: new Map([
+      ['openbitfun-services-core', dependencyProfile([], {
+        optional: true,
+        useDefaultFeatures: false,
+        ownerFeatureCapabilities: new Map([
+          ['pet-packages', ['gif', 'jpeg', 'png', 'webp']],
+        ]),
+      })],
       ['openbitfun-cli', dependencyProfile(['gif', 'jpeg', 'png', 'webp'], {
         useDefaultFeatures: false,
       })],

scripts/core-boundaries/rules/feature-rules.mjs

@@ -43,10 +43,13 @@ export const optionalDependencyFeatureOwnerRules = [
     reason:
       'services-core optional implementation dependencies must stay behind their exact owner capability',
     dependencies: [
+      { depName: 'image', ownerFeatures: ['pet-packages'] },
+      { depName: 'zip', ownerFeatures: ['pet-packages'] },
+      { depName: 'uuid', ownerFeatures: ['pet-packages'] },
       { depName: 'aes-gcm', ownerFeatures: ['credential-vault'] },
       { depName: 'anyhow', ownerFeatures: ['credential-vault', 'dispatch-workspace', 'workspace-runtime', 'workspace-transfer'] },
       { depName: 'async-trait', ownerFeatures: ['permission', 'workspace-runtime'] },
-      { depName: 'base64', ownerFeatures: ['credential-vault', 'filesystem'] },
+      { depName: 'base64', ownerFeatures: ['pet-packages', 'credential-vault', 'filesystem'] },
       {
         depName: 'openbitfun-core-types',
         ownerFeatures: ['filesystem', 'local-storage', 'product-identity', 'workspace-persistence'],
@@ -55,8 +58,8 @@ export const optionalDependencyFeatureOwnerRules = [
       { depName: 'openbitfun-runtime-ports', ownerFeatures: ['permission', 'workspace-runtime', 'workspace-persistence', 'workspace-transfer'] },
       { depName: 'chrono', ownerFeatures: ['filesystem', 'local-storage', 'workspace-persistence'] },
       { depName: 'chrono-tz', ownerFeatures: ['token-usage-statistics'] },
-      { depName: 'dunce', ownerFeatures: ['runtime-ownership', 'workspace-identity', 'workspace-runtime'] },
-      { depName: 'fs2', ownerFeatures: ['credential-vault', 'json-io', 'local-storage', 'runtime-ownership'] },
+      { depName: 'dunce', ownerFeatures: ['pet-packages', 'runtime-ownership', 'workspace-identity', 'workspace-runtime'] },
+      { depName: 'fs2', ownerFeatures: ['pet-packages', 'credential-vault', 'json-io', 'local-storage', 'runtime-ownership'] },
       { depName: 'git2', ownerFeatures: ['session-git'] },
       { depName: 'globset', ownerFeatures: ['workspace-instructions'] },
       { depName: 'ignore', ownerFeatures: ['filesystem'] },
@@ -79,6 +82,7 @@ export const optionalDependencyFeatureOwnerRules = [
       {
         depName: 'sha2',
         ownerFeatures: [
+          'pet-packages',
           'dispatch-workspace',
           'filesystem',
           'local-storage',
@@ -89,7 +93,7 @@ export const optionalDependencyFeatureOwnerRules = [
       },
       { depName: 'which', ownerFeatures: ['process-runtime'] },
       { depName: 'win32job', ownerFeatures: ['process-runtime'] },
-      { depName: 'windows', ownerFeatures: ['json-io', 'local-storage', 'process-runtime'] },
+      { depName: 'windows', ownerFeatures: ['installed-apps', 'json-io', 'local-storage', 'process-runtime'] },
       {
         depName: 'tokio',
         ownerFeatures: [

scripts/core-boundaries/rules/source/public-api-rules.mjs

@@ -10,6 +10,7 @@ export const publicApiContractSlices = [
   'external-source-tool-contract',
   'external-source-subagent-contract',
   'external-source-mcp-contract',
+  'external-source-pet-contract',
   'external-source-hook-contract',
   'external-source-reference-contract',
   'user-instruction-source-boundary',
@@ -67,6 +68,7 @@ const contractSlices = {
   externalSourceToolContract: 'external-source-tool-contract',
   externalSourceSubagentContract: 'external-source-subagent-contract',
   externalSourceMcpContract: 'external-source-mcp-contract',
+  externalSourcePetContract: 'external-source-pet-contract',
   externalSourceHookContract: 'external-source-hook-contract',
   externalSourceReferenceContract: 'external-source-reference-contract',
   userInstructionSourceBoundary: 'user-instruction-source-boundary',
@@ -539,7 +541,17 @@ export const codexAdapterPublicApiEntries = [
 ))).concat([
   'load_codex_user_instructions',
   'CodexInstructionSourceOptions',
-].map((symbol) => userInstructionSourceAdapterEntry(symbol, 'Codex')));
+].map((symbol) => userInstructionSourceAdapterEntry(symbol, 'Codex'))).concat(['pet_source_root', 'builtin_pet_sources', 'BuiltinPetCatalog', 'BuiltinPetSource'].map((symbol) => ({
+  symbol,
+  owner: 'Codex adapter static pet source owner',
+  consumer: 'openbitfun-core external source composition facade',
+  verification: 'Codex pet source fixtures, installed bundle smoke test, and services-core pet package tests',
+  p0: 'local custom and bundled pet source discovery without execution or installation',
+  contractSlice: contractSlices.externalSourcePetContract,
+  wireImpact: false,
+  rationale: 'the adapter translates Codex package metadata; portable services own bounded resource IO and native copying',
+  exit: 'remove only when an equivalent typed pet source provider owns this root',
+})));
 
 export const staticHookSupportPublicApiEntries = [
   // Shared by DSH/PI only for validated, redacted source/event construction.
@@ -1211,6 +1223,9 @@ export const externalSourceCorePublicApiEntries = [
     'NativePromptCommandConflictSnapshot',
     'native_prompt_command_conflicts',
     'instruction_source_catalog',
+    'external_pet_source_root',
+    'external_builtin_pet_sources',
+    'ExternalBuiltinPetCatalog',
     'InstructionSourceCatalog',
     'set_native_prompt_command_conflict_choice',
     'external_source_conflict_choices',

src/apps/desktop/Cargo.toml

@@ -18,6 +18,7 @@ tauri-build = { workspace = true }
 serde_json = { workspace = true }
 
 [dependencies]
+openbitfun-services-core = { path = "../../crates/services/services-core", features = ["pet-packages"] }
 # Internal crates
 openbitfun-core = { path = "../../crates/assembly/core", features = ["product-full"] }
 openbitfun-relay-service = { path = "../../crates/services/relay-service" }