@shipfox/api-agent-dto 5.0.0 → 8.0.0

package/.turbo/turbo-build.log

@@ -1,2 +1,2 @@
 $ shipfox-swc
-Successfully compiled: 10 files with swc (422.74ms)
+Successfully compiled: 11 files with swc (272.78ms)

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # @shipfox/api-agent-dto
 
+## 8.0.0
+
+### Minor Changes
+
+- de559bb: Moves Agent validation policy behind a versioned inter-module catalog and injects it into Definitions normalization.
+
+## 6.0.0
+
+### Minor Changes
+
+- 0bb82a4: Adds the Agent and Integrations inter-module APIs, moving Workflows agent configuration, runtime credential resolution, and integration consumers behind producer-owned clients.
+
+### Patch Changes
+
+- Updated dependencies [81f9544]
+  - @shipfox/inter-module@0.2.0
+
 ## 5.0.0
 
 ### Patch Changes

package/dist/inter-module.d.ts

@@ -0,0 +1,176 @@
+import { type InterModuleClient } from '@shipfox/inter-module';
+import { z } from 'zod';
+declare const agentValidationCatalogSchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    providers: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        support_status: z.ZodEnum<{
+            supported: "supported";
+            unsupported: "unsupported";
+        }>;
+    }, z.core.$strip>>;
+    harnesses: z.ZodArray<z.ZodObject<{
+        id: z.ZodEnum<{
+            pi: "pi";
+            claude: "claude";
+        }>;
+        supported_provider_ids: z.ZodArray<z.ZodString>;
+        thinking_levels: z.ZodArray<z.ZodEnum<{
+            off: "off";
+            minimal: "minimal";
+            low: "low";
+            medium: "medium";
+            high: "high";
+            xhigh: "xhigh";
+            max: "max";
+        }>>;
+        effective_tools: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type AgentValidationCatalog = z.infer<typeof agentValidationCatalogSchema>;
+export declare const agentInterModuleContract: import("@shipfox/inter-module").InterModuleContract<{
+    readonly module: "agent";
+    readonly methods: {
+        readonly getValidationCatalog: {
+            readonly input: z.ZodObject<{}, z.core.$strip>;
+            readonly output: z.ZodObject<{
+                version: z.ZodLiteral<1>;
+                providers: z.ZodArray<z.ZodObject<{
+                    id: z.ZodString;
+                    support_status: z.ZodEnum<{
+                        supported: "supported";
+                        unsupported: "unsupported";
+                    }>;
+                }, z.core.$strip>>;
+                harnesses: z.ZodArray<z.ZodObject<{
+                    id: z.ZodEnum<{
+                        pi: "pi";
+                        claude: "claude";
+                    }>;
+                    supported_provider_ids: z.ZodArray<z.ZodString>;
+                    thinking_levels: z.ZodArray<z.ZodEnum<{
+                        off: "off";
+                        minimal: "minimal";
+                        low: "low";
+                        medium: "medium";
+                        high: "high";
+                        xhigh: "xhigh";
+                        max: "max";
+                    }>>;
+                    effective_tools: z.ZodArray<z.ZodString>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>;
+            readonly errors: {};
+        };
+        readonly resolveAgentConfig: {
+            readonly input: z.ZodObject<{
+                workspaceId: z.ZodNullable<z.ZodString>;
+                config: z.ZodObject<{
+                    harness: z.ZodOptional<z.ZodEnum<{
+                        pi: "pi";
+                        claude: "claude";
+                    }>>;
+                    provider: z.ZodOptional<z.ZodString>;
+                    model: z.ZodOptional<z.ZodString>;
+                    thinking: z.ZodOptional<z.ZodEnum<{
+                        off: "off";
+                        minimal: "minimal";
+                        low: "low";
+                        medium: "medium";
+                        high: "high";
+                        xhigh: "xhigh";
+                        max: "max";
+                    }>>;
+                }, z.core.$strip>;
+            }, z.core.$strip>;
+            readonly output: z.ZodObject<{
+                harness: z.ZodEnum<{
+                    pi: "pi";
+                    claude: "claude";
+                }>;
+                provider: z.ZodString;
+                model: z.ZodString;
+                thinking: z.ZodEnum<{
+                    off: "off";
+                    minimal: "minimal";
+                    low: "low";
+                    medium: "medium";
+                    high: "high";
+                    xhigh: "xhigh";
+                    max: "max";
+                }>;
+            }, z.core.$strip>;
+            readonly errors: {
+                readonly 'agent-config-invalid': z.ZodObject<{}, z.core.$strip>;
+            };
+        };
+        readonly resolveRuntimeCredentials: {
+            readonly input: z.ZodObject<{
+                workspaceId: z.ZodString;
+                harness: z.ZodEnum<{
+                    pi: "pi";
+                    claude: "claude";
+                }>;
+                provider: z.ZodString;
+                model: z.ZodString;
+                thinking: z.ZodEnum<{
+                    off: "off";
+                    minimal: "minimal";
+                    low: "low";
+                    medium: "medium";
+                    high: "high";
+                    xhigh: "xhigh";
+                    max: "max";
+                }>;
+            }, z.core.$strip>;
+            readonly output: z.ZodObject<{
+                harness: z.ZodEnum<{
+                    pi: "pi";
+                    claude: "claude";
+                }>;
+                provider_id: z.ZodString;
+                model: z.ZodString;
+                thinking: z.ZodEnum<{
+                    off: "off";
+                    minimal: "minimal";
+                    low: "low";
+                    medium: "medium";
+                    high: "high";
+                    xhigh: "xhigh";
+                    max: "max";
+                }>;
+                credentials: z.ZodRecord<z.ZodString, z.ZodString>;
+                custom_provider: z.ZodOptional<z.ZodObject<{
+                    api: z.ZodEnum<{
+                        "openai-completions": "openai-completions";
+                        "openai-responses": "openai-responses";
+                        "anthropic-messages": "anthropic-messages";
+                        "google-generative-ai": "google-generative-ai";
+                    }>;
+                    base_url: z.ZodString;
+                    headers: z.ZodArray<z.ZodObject<{
+                        name: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+                        value: z.ZodString;
+                    }, z.core.$strip>>;
+                    secret_header_names: z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>;
+                    models: z.ZodArray<z.ZodObject<{
+                        id: z.ZodString;
+                        label: z.ZodString;
+                        context_window: z.ZodOptional<z.ZodNumber>;
+                        max_output_tokens: z.ZodOptional<z.ZodNumber>;
+                        input_image: z.ZodOptional<z.ZodBoolean>;
+                        reasoning: z.ZodOptional<z.ZodBoolean>;
+                    }, z.core.$strip>>;
+                    requires_api_key: z.ZodBoolean;
+                }, z.core.$strip>>;
+            }, z.core.$strip>;
+            readonly errors: {
+                readonly 'model-provider-not-configured': z.ZodObject<{}, z.core.$strip>;
+                readonly 'model-provider-credentials-invalid': z.ZodObject<{}, z.core.$strip>;
+            };
+        };
+    };
+}>;
+export type AgentInterModuleClient = InterModuleClient<typeof agentInterModuleContract>;
+export {};
+//# sourceMappingURL=inter-module.d.ts.map

package/dist/inter-module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inter-module.d.ts","sourceRoot":"","sources":["../src/inter-module.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4B,KAAK,iBAAiB,EAAC,MAAM,uBAAuB,CAAC;AACxF,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAQtB,QAAA,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;iBAgBhC,CAAC;AAEH,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAgBlF,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4BnC,CAAC;AAEH,MAAM,MAAM,sBAAsB,GAAG,iBAAiB,CAAC,OAAO,wBAAwB,CAAC,CAAC"}

package/dist/inter-module.js

@@ -0,0 +1,67 @@
+import { defineInterModuleContract } from '@shipfox/inter-module';
+import { z } from 'zod';
+import { agentRuntimeCredentialsResponseSchema, agentThinkingSchema, harnessSchema, modelProviderRefSchema } from '#schemas/index.js';
+const agentValidationCatalogSchema = z.object({
+    version: z.literal(1),
+    providers: z.array(z.object({
+        id: z.string().min(1),
+        support_status: z.enum([
+            'supported',
+            'unsupported'
+        ])
+    })),
+    harnesses: z.array(z.object({
+        id: harnessSchema,
+        supported_provider_ids: z.array(z.string().min(1)),
+        thinking_levels: z.array(agentThinkingSchema),
+        effective_tools: z.array(z.string().min(1))
+    }))
+});
+const agentConfigInputSchema = z.object({
+    harness: harnessSchema.optional(),
+    provider: modelProviderRefSchema.optional(),
+    model: z.string().optional(),
+    thinking: agentThinkingSchema.optional()
+});
+const resolvedAgentConfigSchema = z.object({
+    harness: harnessSchema,
+    provider: modelProviderRefSchema,
+    model: z.string(),
+    thinking: agentThinkingSchema
+});
+export const agentInterModuleContract = defineInterModuleContract({
+    module: 'agent',
+    methods: {
+        getValidationCatalog: {
+            input: z.object({}),
+            output: agentValidationCatalogSchema,
+            errors: {}
+        },
+        resolveAgentConfig: {
+            input: z.object({
+                workspaceId: z.string().uuid().nullable(),
+                config: agentConfigInputSchema
+            }),
+            output: resolvedAgentConfigSchema,
+            errors: {
+                'agent-config-invalid': z.object({})
+            }
+        },
+        resolveRuntimeCredentials: {
+            input: z.object({
+                workspaceId: z.string().uuid(),
+                harness: harnessSchema,
+                provider: modelProviderRefSchema,
+                model: z.string(),
+                thinking: agentThinkingSchema
+            }),
+            output: agentRuntimeCredentialsResponseSchema,
+            errors: {
+                'model-provider-not-configured': z.object({}),
+                'model-provider-credentials-invalid': z.object({})
+            }
+        }
+    }
+});
+
+//# sourceMappingURL=inter-module.js.map

package/dist/inter-module.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/inter-module.ts"],"sourcesContent":["import {defineInterModuleContract, type InterModuleClient} from '@shipfox/inter-module';\nimport {z} from 'zod';\nimport {\n  agentRuntimeCredentialsResponseSchema,\n  agentThinkingSchema,\n  harnessSchema,\n  modelProviderRefSchema,\n} from '#schemas/index.js';\n\nconst agentValidationCatalogSchema = z.object({\n  version: z.literal(1),\n  providers: z.array(\n    z.object({\n      id: z.string().min(1),\n      support_status: z.enum(['supported', 'unsupported']),\n    }),\n  ),\n  harnesses: z.array(\n    z.object({\n      id: harnessSchema,\n      supported_provider_ids: z.array(z.string().min(1)),\n      thinking_levels: z.array(agentThinkingSchema),\n      effective_tools: z.array(z.string().min(1)),\n    }),\n  ),\n});\n\nexport type AgentValidationCatalog = z.infer<typeof agentValidationCatalogSchema>;\n\nconst agentConfigInputSchema = z.object({\n  harness: harnessSchema.optional(),\n  provider: modelProviderRefSchema.optional(),\n  model: z.string().optional(),\n  thinking: agentThinkingSchema.optional(),\n});\n\nconst resolvedAgentConfigSchema = z.object({\n  harness: harnessSchema,\n  provider: modelProviderRefSchema,\n  model: z.string(),\n  thinking: agentThinkingSchema,\n});\n\nexport const agentInterModuleContract = defineInterModuleContract({\n  module: 'agent',\n  methods: {\n    getValidationCatalog: {\n      input: z.object({}),\n      output: agentValidationCatalogSchema,\n      errors: {},\n    },\n    resolveAgentConfig: {\n      input: z.object({workspaceId: z.string().uuid().nullable(), config: agentConfigInputSchema}),\n      output: resolvedAgentConfigSchema,\n      errors: {'agent-config-invalid': z.object({})},\n    },\n    resolveRuntimeCredentials: {\n      input: z.object({\n        workspaceId: z.string().uuid(),\n        harness: harnessSchema,\n        provider: modelProviderRefSchema,\n        model: z.string(),\n        thinking: agentThinkingSchema,\n      }),\n      output: agentRuntimeCredentialsResponseSchema,\n      errors: {\n        'model-provider-not-configured': z.object({}),\n        'model-provider-credentials-invalid': z.object({}),\n      },\n    },\n  },\n});\n\nexport type AgentInterModuleClient = InterModuleClient<typeof agentInterModuleContract>;\n"],"names":["defineInterModuleContract","z","agentRuntimeCredentialsResponseSchema","agentThinkingSchema","harnessSchema","modelProviderRefSchema","agentValidationCatalogSchema","object","version","literal","providers","array","id","string","min","support_status","enum","harnesses","supported_provider_ids","thinking_levels","effective_tools","agentConfigInputSchema","harness","optional","provider","model","thinking","resolvedAgentConfigSchema","agentInterModuleContract","module","methods","getValidationCatalog","input","output","errors","resolveAgentConfig","workspaceId","uuid","nullable","config","resolveRuntimeCredentials"],"mappings":"AAAA,SAAQA,yBAAyB,QAA+B,wBAAwB;AACxF,SAAQC,CAAC,QAAO,MAAM;AACtB,SACEC,qCAAqC,EACrCC,mBAAmB,EACnBC,aAAa,EACbC,sBAAsB,QACjB,oBAAoB;AAE3B,MAAMC,+BAA+BL,EAAEM,MAAM,CAAC;IAC5CC,SAASP,EAAEQ,OAAO,CAAC;IACnBC,WAAWT,EAAEU,KAAK,CAChBV,EAAEM,MAAM,CAAC;QACPK,IAAIX,EAAEY,MAAM,GAAGC,GAAG,CAAC;QACnBC,gBAAgBd,EAAEe,IAAI,CAAC;YAAC;YAAa;SAAc;IACrD;IAEFC,WAAWhB,EAAEU,KAAK,CAChBV,EAAEM,MAAM,CAAC;QACPK,IAAIR;QACJc,wBAAwBjB,EAAEU,KAAK,CAACV,EAAEY,MAAM,GAAGC,GAAG,CAAC;QAC/CK,iBAAiBlB,EAAEU,KAAK,CAACR;QACzBiB,iBAAiBnB,EAAEU,KAAK,CAACV,EAAEY,MAAM,GAAGC,GAAG,CAAC;IAC1C;AAEJ;AAIA,MAAMO,yBAAyBpB,EAAEM,MAAM,CAAC;IACtCe,SAASlB,cAAcmB,QAAQ;IAC/BC,UAAUnB,uBAAuBkB,QAAQ;IACzCE,OAAOxB,EAAEY,MAAM,GAAGU,QAAQ;IAC1BG,UAAUvB,oBAAoBoB,QAAQ;AACxC;AAEA,MAAMI,4BAA4B1B,EAAEM,MAAM,CAAC;IACzCe,SAASlB;IACToB,UAAUnB;IACVoB,OAAOxB,EAAEY,MAAM;IACfa,UAAUvB;AACZ;AAEA,OAAO,MAAMyB,2BAA2B5B,0BAA0B;IAChE6B,QAAQ;IACRC,SAAS;QACPC,sBAAsB;YACpBC,OAAO/B,EAAEM,MAAM,CAAC,CAAC;YACjB0B,QAAQ3B;YACR4B,QAAQ,CAAC;QACX;QACAC,oBAAoB;YAClBH,OAAO/B,EAAEM,MAAM,CAAC;gBAAC6B,aAAanC,EAAEY,MAAM,GAAGwB,IAAI,GAAGC,QAAQ;gBAAIC,QAAQlB;YAAsB;YAC1FY,QAAQN;YACRO,QAAQ;gBAAC,wBAAwBjC,EAAEM,MAAM,CAAC,CAAC;YAAE;QAC/C;QACAiC,2BAA2B;YACzBR,OAAO/B,EAAEM,MAAM,CAAC;gBACd6B,aAAanC,EAAEY,MAAM,GAAGwB,IAAI;gBAC5Bf,SAASlB;gBACToB,UAAUnB;gBACVoB,OAAOxB,EAAEY,MAAM;gBACfa,UAAUvB;YACZ;YACA8B,QAAQ/B;YACRgC,QAAQ;gBACN,iCAAiCjC,EAAEM,MAAM,CAAC,CAAC;gBAC3C,sCAAsCN,EAAEM,MAAM,CAAC,CAAC;YAClD;QACF;IACF;AACF,GAAG"}