@shipfox/api-workflows 4.0.0 → 6.0.0

package/.turbo/turbo-build.log

@@ -1,6 +1,6 @@
 $ shipfox-swc && shipfox-temporal-bundle dist/temporal/workflows/index.js
-Successfully compiled: 114 files with swc (131.56ms)
-2026-07-19T08:15:25.864Z [INFO] asset workflow-bundle-4cbe48212b3a51eda262.js 1.59 MiB [emitted] [immutable] (name: main)
+Successfully compiled: 116 files with swc (715.25ms)
+2026-07-21T08:12:09.510Z [INFO] asset workflow-bundle-4cbe48212b3a51eda262.js 1.59 MiB [emitted] [immutable] (name: main)
 runtime modules 670 bytes 3 modules
 modules by path ../../../node_modules/.pnpm/ 424 KiB
   modules by path ../../../node_modules/.pnpm/@temporalio+common@1.18.1/node_modules/@temporal...(truncated) 155 KiB 34 modules
@@ -16,6 +16,6 @@ modules by path ./dist/ 39.5 KiB
 optional modules 30 bytes [optional]
   __temporal_custom_payload_converter (ignored) 15 bytes [optional] [built] [code generated]
   __temporal_custom_failure_converter (ignored) 15 bytes [optional] [built] [code generated]
-webpack 5.107.2 compiled successfully in 743 ms
-2026-07-19T08:15:25.867Z [INFO] Workflow bundle created { size: '1.59MB' }
+webpack 5.107.2 compiled successfully in 4093 ms
+2026-07-21T08:12:09.538Z [INFO] Workflow bundle created { size: '1.59MB' }
 /home/runner/work/shipfox/shipfox/libs/api/workflows/dist/temporal/workflows/index.js: 1665965 bytes

package/CHANGELOG.md

@@ -1,5 +1,109 @@
 # @shipfox/api-workflows
 
+## 6.0.0
+
+### Major Changes
+
+- a8f0545: Adds the versioned Definitions workflow snapshot contract and registered presentation.
+- 9006b75: Adds the Runners inter-module contract and requires the injected Runners client when composing Workflows.
+
+### Minor Changes
+
+- 23563de: Moves Triggers to the injected Workflows inter-module contract with stable run idempotency and listener delivery commands.
+- a42b575: Exposes Secrets through its inter-module contract and migrates Agent, integrations, and Workflows consumers.
+- 23a4dc2: Moves Logs and Integrations to injected Workflows inter-module clients with minimal log and leased agent-tool queries.
+
+### Patch Changes
+
+- 0bb82a4: Adds the Agent and Integrations inter-module APIs, moving Workflows agent configuration, runtime credential resolution, and integration consumers behind producer-owned clients.
+- 9cb2442: Moves workflow capability-warning annotations behind the producer-owned inter-module API.
+- b70f920: Adds assigned runner activation and descendant provisioner revocation.
+- 112c0fa: Adds the Auth inter-module token-minting contract and removes Auth implementation and configuration coupling from its consumers.
+- f73da5d: Enforces bounded API context imports and routes inter-module consumers through producer contracts.
+- Updated dependencies [e52513c]
+- Updated dependencies [a8f0545]
+- Updated dependencies [0bb82a4]
+- Updated dependencies [9cb2442]
+- Updated dependencies [b70f920]
+- Updated dependencies [23563de]
+- Updated dependencies [6a52909]
+- Updated dependencies [e6eba5b]
+- Updated dependencies [54ce48b]
+- Updated dependencies [add4c77]
+- Updated dependencies [9006b75]
+- Updated dependencies [3cda0c6]
+- Updated dependencies [ba2e3dc]
+- Updated dependencies [f4bc2eb]
+- Updated dependencies [c0162b0]
+- Updated dependencies [7ac43a4]
+- Updated dependencies [f262539]
+- Updated dependencies [a01e917]
+- Updated dependencies [3bb4e26]
+- Updated dependencies [a42b575]
+- Updated dependencies [112c0fa]
+- Updated dependencies [8bdc149]
+- Updated dependencies [795e293]
+- Updated dependencies [e10c829]
+- Updated dependencies [f73da5d]
+- Updated dependencies [3810996]
+- Updated dependencies [23a4dc2]
+- Updated dependencies [b00ed29]
+- Updated dependencies [8aa7cd3]
+- Updated dependencies [4a91956]
+- Updated dependencies [81f9544]
+- Updated dependencies [4604a06]
+- Updated dependencies [6741be8]
+  - @shipfox/api-runners@6.0.0
+  - @shipfox/api-runners-dto@6.0.0
+  - @shipfox/api-definitions-dto@6.0.0
+  - @shipfox/api-agent-dto@6.0.0
+  - @shipfox/api-integration-core-dto@6.0.0
+  - @shipfox/api-projects@6.0.0
+  - @shipfox/annotations-dto@6.0.0
+  - @shipfox/api-workflows-dto@6.0.0
+  - @shipfox/api-auth-dto@6.0.0
+  - @shipfox/node-module@0.4.0
+  - @shipfox/node-temporal@0.3.2
+  - @shipfox/node-drizzle@0.3.2
+  - @shipfox/node-outbox@0.2.4
+  - @shipfox/api-secrets-dto@6.0.0
+  - @shipfox/api-auth-context@6.0.0
+  - @shipfox/node-fastify@0.2.4
+  - @shipfox/inter-module@0.2.0
+  - @shipfox/api-projects-dto@6.0.0
+
+## 5.0.0
+
+### Patch Changes
+
+- bb037af: Resolves workspace packages from source during development while published consumers continue to use compiled output.
+- Updated dependencies [2875241]
+- Updated dependencies [bb037af]
+- Updated dependencies [fb70438]
+  - @shipfox/api-integration-core@5.0.0
+  - @shipfox/annotations@5.0.0
+  - @shipfox/api-agent@5.0.0
+  - @shipfox/api-agent-dto@5.0.0
+  - @shipfox/api-auth@5.0.0
+  - @shipfox/api-auth-context@5.0.0
+  - @shipfox/api-definitions@5.0.0
+  - @shipfox/api-projects@5.0.0
+  - @shipfox/api-runners@5.0.0
+  - @shipfox/api-runners-dto@5.0.0
+  - @shipfox/api-secrets@5.0.0
+  - @shipfox/api-secrets-dto@5.0.0
+  - @shipfox/api-workflows-dto@5.0.0
+  - @shipfox/expression@1.1.3
+  - @shipfox/node-drizzle@0.3.1
+  - @shipfox/node-error-monitoring@0.1.3
+  - @shipfox/node-fastify@0.2.3
+  - @shipfox/node-module@0.3.2
+  - @shipfox/node-opentelemetry@0.5.2
+  - @shipfox/node-outbox@0.2.3
+  - @shipfox/node-postgres@0.4.2
+  - @shipfox/node-temporal@0.3.1
+  - @shipfox/runner-labels@0.1.1
+
 ## 4.0.0
 
 ### Patch Changes

package/dist/core/agent-defaults.d.ts

@@ -0,0 +1,17 @@
+import type { AgentThinking, Harness, ModelProviderRef } from '@shipfox/api-agent-dto';
+import type { AgentInterModuleClient } from '@shipfox/api-agent-dto/inter-module';
+export interface AgentDefaultsInput {
+    readonly harness?: Harness | undefined;
+    readonly provider?: ModelProviderRef | undefined;
+    readonly model?: string | undefined;
+    readonly thinking?: AgentThinking | undefined;
+}
+export interface ResolvedAgentDefaults {
+    readonly harness: Harness;
+    readonly provider: ModelProviderRef;
+    readonly model: string;
+    readonly thinking: AgentThinking;
+}
+export type AgentDefaultsResolver = (input: AgentDefaultsInput) => ResolvedAgentDefaults | Promise<ResolvedAgentDefaults>;
+export declare function createAgentDefaultsResolver(agent: AgentInterModuleClient, workspaceId: string | null): AgentDefaultsResolver;
+//# sourceMappingURL=agent-defaults.d.ts.map

package/dist/core/agent-defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-defaults.d.ts","sourceRoot":"","sources":["../../src/core/agent-defaults.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,aAAa,EAAE,OAAO,EAAE,gBAAgB,EAAC,MAAM,wBAAwB,CAAC;AACrF,OAAO,KAAK,EAAC,sBAAsB,EAAC,MAAM,qCAAqC,CAAC;AAEhF,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,QAAQ,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAAC;IACjD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,QAAQ,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;CAC/C;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;CAClC;AAED,MAAM,MAAM,qBAAqB,GAAG,CAClC,KAAK,EAAE,kBAAkB,KACtB,qBAAqB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;AAE5D,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,sBAAsB,EAC7B,WAAW,EAAE,MAAM,GAAG,IAAI,GACzB,qBAAqB,CAWvB"}

package/dist/core/agent-defaults.js

@@ -0,0 +1,21 @@
+export function createAgentDefaultsResolver(agent, workspaceId) {
+    return async (config)=>await agent.resolveAgentConfig({
+            workspaceId,
+            config: {
+                ...config.harness === undefined ? {} : {
+                    harness: config.harness
+                },
+                ...config.provider === undefined ? {} : {
+                    provider: config.provider
+                },
+                ...config.model === undefined ? {} : {
+                    model: config.model
+                },
+                ...config.thinking === undefined ? {} : {
+                    thinking: config.thinking
+                }
+            }
+        });
+}
+
+//# sourceMappingURL=agent-defaults.js.map

package/dist/core/agent-defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/core/agent-defaults.ts"],"sourcesContent":["import type {AgentThinking, Harness, ModelProviderRef} from '@shipfox/api-agent-dto';\nimport type {AgentInterModuleClient} from '@shipfox/api-agent-dto/inter-module';\n\nexport interface AgentDefaultsInput {\n  readonly harness?: Harness | undefined;\n  readonly provider?: ModelProviderRef | undefined;\n  readonly model?: string | undefined;\n  readonly thinking?: AgentThinking | undefined;\n}\n\nexport interface ResolvedAgentDefaults {\n  readonly harness: Harness;\n  readonly provider: ModelProviderRef;\n  readonly model: string;\n  readonly thinking: AgentThinking;\n}\n\nexport type AgentDefaultsResolver = (\n  input: AgentDefaultsInput,\n) => ResolvedAgentDefaults | Promise<ResolvedAgentDefaults>;\n\nexport function createAgentDefaultsResolver(\n  agent: AgentInterModuleClient,\n  workspaceId: string | null,\n): AgentDefaultsResolver {\n  return async (config) =>\n    await agent.resolveAgentConfig({\n      workspaceId,\n      config: {\n        ...(config.harness === undefined ? {} : {harness: config.harness}),\n        ...(config.provider === undefined ? {} : {provider: config.provider}),\n        ...(config.model === undefined ? {} : {model: config.model}),\n        ...(config.thinking === undefined ? {} : {thinking: config.thinking}),\n      },\n    });\n}\n"],"names":["createAgentDefaultsResolver","agent","workspaceId","config","resolveAgentConfig","harness","undefined","provider","model","thinking"],"mappings":"AAqBA,OAAO,SAASA,4BACdC,KAA6B,EAC7BC,WAA0B;IAE1B,OAAO,OAAOC,SACZ,MAAMF,MAAMG,kBAAkB,CAAC;YAC7BF;YACAC,QAAQ;gBACN,GAAIA,OAAOE,OAAO,KAAKC,YAAY,CAAC,IAAI;oBAACD,SAASF,OAAOE,OAAO;gBAAA,CAAC;gBACjE,GAAIF,OAAOI,QAAQ,KAAKD,YAAY,CAAC,IAAI;oBAACC,UAAUJ,OAAOI,QAAQ;gBAAA,CAAC;gBACpE,GAAIJ,OAAOK,KAAK,KAAKF,YAAY,CAAC,IAAI;oBAACE,OAAOL,OAAOK,KAAK;gBAAA,CAAC;gBAC3D,GAAIL,OAAOM,QAAQ,KAAKH,YAAY,CAAC,IAAI;oBAACG,UAAUN,OAAOM,QAAQ;gBAAA,CAAC;YACtE;QACF;AACJ"}

package/dist/core/agent-tool-capability-warning.d.ts

@@ -1,6 +1,10 @@
+import { type AnnotationsInterModuleClient } from '@shipfox/annotations-dto/inter-module';
 import type { LeasedJobContext } from '@shipfox/api-auth-context';
+import type { RunnersInterModuleClient } from '@shipfox/api-runners-dto/inter-module';
 import type { Step } from './entities/step.js';
 export declare function warnAgentToolCapabilityMismatchOnDispatch(params: {
+    annotations: AnnotationsInterModuleClient;
+    runners: RunnersInterModuleClient;
     leaseIdentity: LeasedJobContext;
     step: Step;
 }): Promise<void>;

package/dist/core/agent-tool-capability-warning.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-tool-capability-warning.d.ts","sourceRoot":"","sources":["../../src/core/agent-tool-capability-warning.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAC,gBAAgB,EAAC,MAAM,2BAA2B,CAAC;AAIhE,OAAO,KAAK,EAAC,IAAI,EAAC,MAAM,oBAAoB,CAAC;AAO7C,wBAAsB,yCAAyC,CAAC,MAAM,EAAE;IACtE,aAAa,EAAE,gBAAgB,CAAC;IAChC,IAAI,EAAE,IAAI,CAAC;CACZ,GAAG,OAAO,CAAC,IAAI,CAAC,CAqFhB"}
+{"version":3,"file":"agent-tool-capability-warning.d.ts","sourceRoot":"","sources":["../../src/core/agent-tool-capability-warning.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,4BAA4B,EAElC,MAAM,uCAAuC,CAAC;AAM/C,OAAO,KAAK,EAAC,gBAAgB,EAAC,MAAM,2BAA2B,CAAC;AAChE,OAAO,KAAK,EAAC,wBAAwB,EAAC,MAAM,uCAAuC,CAAC;AAIpF,OAAO,KAAK,EAAC,IAAI,EAAC,MAAM,oBAAoB,CAAC;AAO7C,wBAAsB,yCAAyC,CAAC,MAAM,EAAE;IACtE,WAAW,EAAE,4BAA4B,CAAC;IAC1C,OAAO,EAAE,wBAAwB,CAAC;IAClC,aAAa,EAAE,gBAAgB,CAAC;IAChC,IAAI,EAAE,IAAI,CAAC;CACZ,GAAG,OAAO,CAAC,IAAI,CAAC,CAqFhB"}

package/dist/core/agent-tool-capability-warning.js

@@ -1,6 +1,6 @@
-import { AnnotationBodyTooLargeError, AnnotationCountLimitExceededError, AnnotationTotalBytesLimitExceededError, writeAnnotations } from '@shipfox/annotations';
+import { annotationsInterModuleContract } from '@shipfox/annotations-dto/inter-module';
 import { harnessSchema, materializedAgentStepConfigSchema } from '@shipfox/api-agent-dto';
-import { getEffectiveRunnerToolCapabilities, unadvertisedRunnerTools } from '@shipfox/api-runners';
+import { isInterModuleKnownError } from '@shipfox/inter-module';
 import { logger } from '@shipfox/node-opentelemetry';
 import { recordWorkflowAgentToolWarningFailed } from '#metrics/instance.js';
 const TOOL_LIST_LIMIT = 10;
@@ -13,7 +13,7 @@ export async function warnAgentToolCapabilityMismatchOnDispatch(params) {
     if (!harness.success) return;
     let effective;
     try {
-        effective = await getEffectiveRunnerToolCapabilities({
+        effective = await params.runners.getEffectiveRunnerToolCapabilities({
             runnerSessionId: params.leaseIdentity.runnerSessionId
         });
     } catch (error) {
@@ -25,11 +25,8 @@ export async function warnAgentToolCapabilityMismatchOnDispatch(params) {
         }, 'Failed to read runner tool capabilities for agent tool warning');
         return;
     }
-    const missing = unadvertisedRunnerTools({
-        harness: harness.data,
-        requestedTools,
-        capabilities: effective.capabilities
-    });
+    const advertised = new Set(effective.capabilities.harnesses[harness.data]?.tools ?? []);
+    const missing = requestedTools.filter((tool)=>!advertised.has(tool));
     const context = `agent-tool-capability:${params.step.id}`;
     const operation = missing.length === 0 ? {
         context,
@@ -44,18 +41,19 @@ export async function warnAgentToolCapabilityMismatchOnDispatch(params) {
             missing,
             reason: warningReason({
                 reportFresh: effective.reportFresh,
-                harnessKnown: effective.harnessKnown(harness.data)
+                harnessKnown: effective.capabilities.harnesses[harness.data] !== undefined
             })
         })
     };
     try {
-        await writeAnnotations({
-            ...writeParamsFromLease(params.leaseIdentity),
+        await params.annotations.replaceOrRemoveAnnotation({
+            ...annotationTargetFromLease(params.leaseIdentity),
             originStepId: params.step.id,
             originStepAttempt: params.step.currentAttempt,
-            operations: [
-                operation
-            ]
+            context,
+            annotation: operation.op === 'remove' ? {
+                op: 'remove'
+            } : operation
         });
     } catch (error) {
         const reason = isAnnotationBudgetError(error) ? 'budget' : 'write';
@@ -76,7 +74,7 @@ export async function warnAgentToolCapabilityMismatchOnDispatch(params) {
             missing,
             reason: warningReason({
                 reportFresh: effective.reportFresh,
-                harnessKnown: effective.harnessKnown(harness.data)
+                harnessKnown: effective.capabilities.harnesses[harness.data] !== undefined
             })
         }, 'Runner missing requested agent tools; dispatch is continuing');
     }
@@ -128,7 +126,7 @@ function warningReason(params) {
     if (params.harnessKnown) return 'known-absence';
     return params.reportFresh ? 'harness-not-advertised' : 'unknown-or-stale';
 }
-function writeParamsFromLease(lease) {
+function annotationTargetFromLease(lease) {
     return {
         workspaceId: lease.workspaceId,
         projectId: lease.projectId,
@@ -140,7 +138,7 @@ function writeParamsFromLease(lease) {
     };
 }
 function isAnnotationBudgetError(error) {
-    return error instanceof AnnotationBodyTooLargeError || error instanceof AnnotationCountLimitExceededError || error instanceof AnnotationTotalBytesLimitExceededError;
+    return isInterModuleKnownError(annotationsInterModuleContract.methods.replaceOrRemoveAnnotation, error);
 }
 function recordWarningWriteFailure(reason) {
     recordWorkflowAgentToolWarningFailed(reason);

package/dist/core/agent-tool-capability-warning.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/core/agent-tool-capability-warning.ts"],"sourcesContent":["import {\n  AnnotationBodyTooLargeError,\n  AnnotationCountLimitExceededError,\n  AnnotationTotalBytesLimitExceededError,\n  type WriteAnnotationsParams,\n  writeAnnotations,\n} from '@shipfox/annotations';\nimport {\n  harnessSchema,\n  type MaterializedAgentStepConfigDto,\n  materializedAgentStepConfigSchema,\n} from '@shipfox/api-agent-dto';\nimport type {LeasedJobContext} from '@shipfox/api-auth-context';\nimport {getEffectiveRunnerToolCapabilities, unadvertisedRunnerTools} from '@shipfox/api-runners';\nimport {logger} from '@shipfox/node-opentelemetry';\nimport {recordWorkflowAgentToolWarningFailed} from '#metrics/instance.js';\nimport type {Step} from './entities/step.js';\n\nconst TOOL_LIST_LIMIT = 10;\n\ntype WarningFailureReason = 'budget' | 'lookup' | 'write';\ntype WarningReason = 'known-absence' | 'harness-not-advertised' | 'unknown-or-stale';\n\nexport async function warnAgentToolCapabilityMismatchOnDispatch(params: {\n  leaseIdentity: LeasedJobContext;\n  step: Step;\n}): Promise<void> {\n  const config = parseAgentConfig(params.step);\n  if (!config) return;\n\n  const requestedTools = config.tools ?? [];\n  if (requestedTools.length === 0) return;\n\n  const harness = harnessSchema.safeParse(config.harness);\n  if (!harness.success) return;\n\n  let effective: Awaited<ReturnType<typeof getEffectiveRunnerToolCapabilities>>;\n  try {\n    effective = await getEffectiveRunnerToolCapabilities({\n      runnerSessionId: params.leaseIdentity.runnerSessionId,\n    });\n  } catch (error) {\n    recordWarningWriteFailure('lookup');\n    logger().warn(\n      {error, jobExecutionId: params.leaseIdentity.jobExecutionId, stepId: params.step.id},\n      'Failed to read runner tool capabilities for agent tool warning',\n    );\n    return;\n  }\n\n  const missing = unadvertisedRunnerTools({\n    harness: harness.data,\n    requestedTools,\n    capabilities: effective.capabilities,\n  });\n  const context = `agent-tool-capability:${params.step.id}`;\n\n  const operation =\n    missing.length === 0\n      ? {context, style: 'warning' as const, op: 'remove' as const}\n      : {\n          context,\n          style: 'warning' as const,\n          op: 'replace' as const,\n          body: warningBody({\n            harness: harness.data,\n            missing,\n            reason: warningReason({\n              reportFresh: effective.reportFresh,\n              harnessKnown: effective.harnessKnown(harness.data),\n            }),\n          }),\n        };\n\n  try {\n    await writeAnnotations({\n      ...writeParamsFromLease(params.leaseIdentity),\n      originStepId: params.step.id,\n      originStepAttempt: params.step.currentAttempt,\n      operations: [operation],\n    });\n  } catch (error) {\n    const reason = isAnnotationBudgetError(error) ? 'budget' : 'write';\n    recordWarningWriteFailure(reason);\n    logger().warn(\n      {\n        error,\n        reason,\n        jobExecutionId: params.leaseIdentity.jobExecutionId,\n        stepId: params.step.id,\n      },\n      'Failed to write agent tool capability warning annotation',\n    );\n    return;\n  }\n\n  if (missing.length > 0) {\n    logger().warn(\n      {\n        jobExecutionId: params.leaseIdentity.jobExecutionId,\n        stepId: params.step.id,\n        harness: harness.data,\n        missing,\n        reason: warningReason({\n          reportFresh: effective.reportFresh,\n          harnessKnown: effective.harnessKnown(harness.data),\n        }),\n      },\n      'Runner missing requested agent tools; dispatch is continuing',\n    );\n  }\n}\n\nfunction parseAgentConfig(step: Step): MaterializedAgentStepConfigDto | null {\n  if (step.type !== 'agent') return null;\n\n  const parsed = materializedAgentStepConfigSchema.safeParse(step.config);\n  return parsed.success ? parsed.data : null;\n}\n\nfunction warningBody(params: {\n  harness: string;\n  missing: readonly string[];\n  reason: WarningReason;\n}): string {\n  const tools = formatToolList(params.missing);\n  const harness = markdownInlineCode(params.harness);\n  if (params.reason === 'known-absence') {\n    return [\n      '**Runner missing requested agent tools**',\n      '',\n      `The matched runner advertised a ${harness} tool set without: ${tools}.`,\n      'Execution is continuing on this runner because labels matched; the step may fail if the harness cannot provide these tools.',\n    ].join('\\n');\n  }\n\n  if (params.reason === 'harness-not-advertised') {\n    return [\n      '**Runner missing requested agent harness tools**',\n      '',\n      `The matched runner advertised fresh tool capabilities, but did not advertise a ${harness} tool set. Support for ${tools} could not be confirmed.`,\n      'Execution is continuing on this runner because labels matched; the step may fail if the harness cannot provide these tools.',\n    ].join('\\n');\n  }\n\n  return [\n    '**Could not confirm runner agent tools**',\n    '',\n    `The matched runner reported no or stale tool capabilities, so support for ${tools} could not be confirmed.`,\n    'Execution is continuing on this runner because labels matched.',\n  ].join('\\n');\n}\n\nfunction formatToolList(tools: readonly string[]): string {\n  const visible = tools.slice(0, TOOL_LIST_LIMIT).map(markdownInlineCode);\n  const remaining = tools.length - visible.length;\n  return remaining > 0 ? `${visible.join(', ')} ...and ${remaining} more` : visible.join(', ');\n}\n\nfunction markdownInlineCode(value: string): string {\n  const maxBacktickRun = Math.max(\n    0,\n    ...Array.from(value.matchAll(/`+/g), (match) => match[0].length),\n  );\n  const delimiter = '`'.repeat(maxBacktickRun + 1);\n  const needsPadding = value.startsWith('`') || value.endsWith('`');\n  const content = needsPadding ? ` ${value} ` : value;\n  return `${delimiter}${content}${delimiter}`;\n}\n\nfunction warningReason(params: {reportFresh: boolean; harnessKnown: boolean}): WarningReason {\n  if (params.harnessKnown) return 'known-absence';\n  return params.reportFresh ? 'harness-not-advertised' : 'unknown-or-stale';\n}\n\nfunction writeParamsFromLease(\n  lease: LeasedJobContext,\n): Omit<WriteAnnotationsParams, 'originStepId' | 'originStepAttempt' | 'operations'> {\n  return {\n    workspaceId: lease.workspaceId,\n    projectId: lease.projectId,\n    workflowRunId: lease.workflowRunId,\n    workflowRunAttempt: lease.workflowRunAttempt ?? 1,\n    workflowRunAttemptId: lease.workflowRunAttemptId,\n    jobId: lease.jobId,\n    jobExecutionId: lease.jobExecutionId,\n  };\n}\n\nfunction isAnnotationBudgetError(error: unknown): boolean {\n  return (\n    error instanceof AnnotationBodyTooLargeError ||\n    error instanceof AnnotationCountLimitExceededError ||\n    error instanceof AnnotationTotalBytesLimitExceededError\n  );\n}\n\nfunction recordWarningWriteFailure(reason: WarningFailureReason): void {\n  recordWorkflowAgentToolWarningFailed(reason);\n}\n"],"names":["AnnotationBodyTooLargeError","AnnotationCountLimitExceededError","AnnotationTotalBytesLimitExceededError","writeAnnotations","harnessSchema","materializedAgentStepConfigSchema","getEffectiveRunnerToolCapabilities","unadvertisedRunnerTools","logger","recordWorkflowAgentToolWarningFailed","TOOL_LIST_LIMIT","warnAgentToolCapabilityMismatchOnDispatch","params","config","parseAgentConfig","step","requestedTools","tools","length","harness","safeParse","success","effective","runnerSessionId","leaseIdentity","error","recordWarningWriteFailure","warn","jobExecutionId","stepId","id","missing","data","capabilities","context","operation","style","op","body","warningBody","reason","warningReason","reportFresh","harnessKnown","writeParamsFromLease","originStepId","originStepAttempt","currentAttempt","operations","isAnnotationBudgetError","type","parsed","formatToolList","markdownInlineCode","join","visible","slice","map","remaining","value","maxBacktickRun","Math","max","Array","from","matchAll","match","delimiter","repeat","needsPadding","startsWith","endsWith","content","lease","workspaceId","projectId","workflowRunId","workflowRunAttempt","workflowRunAttemptId","jobId"],"mappings":"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"}
+{"version":3,"sources":["../../src/core/agent-tool-capability-warning.ts"],"sourcesContent":["import {\n  type AnnotationsInterModuleClient,\n  annotationsInterModuleContract,\n} from '@shipfox/annotations-dto/inter-module';\nimport {\n  harnessSchema,\n  type MaterializedAgentStepConfigDto,\n  materializedAgentStepConfigSchema,\n} from '@shipfox/api-agent-dto';\nimport type {LeasedJobContext} from '@shipfox/api-auth-context';\nimport type {RunnersInterModuleClient} from '@shipfox/api-runners-dto/inter-module';\nimport {isInterModuleKnownError} from '@shipfox/inter-module';\nimport {logger} from '@shipfox/node-opentelemetry';\nimport {recordWorkflowAgentToolWarningFailed} from '#metrics/instance.js';\nimport type {Step} from './entities/step.js';\n\nconst TOOL_LIST_LIMIT = 10;\n\ntype WarningFailureReason = 'budget' | 'lookup' | 'write';\ntype WarningReason = 'known-absence' | 'harness-not-advertised' | 'unknown-or-stale';\n\nexport async function warnAgentToolCapabilityMismatchOnDispatch(params: {\n  annotations: AnnotationsInterModuleClient;\n  runners: RunnersInterModuleClient;\n  leaseIdentity: LeasedJobContext;\n  step: Step;\n}): Promise<void> {\n  const config = parseAgentConfig(params.step);\n  if (!config) return;\n\n  const requestedTools = config.tools ?? [];\n  if (requestedTools.length === 0) return;\n\n  const harness = harnessSchema.safeParse(config.harness);\n  if (!harness.success) return;\n\n  let effective: Awaited<\n    ReturnType<RunnersInterModuleClient['getEffectiveRunnerToolCapabilities']>\n  >;\n  try {\n    effective = await params.runners.getEffectiveRunnerToolCapabilities({\n      runnerSessionId: params.leaseIdentity.runnerSessionId,\n    });\n  } catch (error) {\n    recordWarningWriteFailure('lookup');\n    logger().warn(\n      {error, jobExecutionId: params.leaseIdentity.jobExecutionId, stepId: params.step.id},\n      'Failed to read runner tool capabilities for agent tool warning',\n    );\n    return;\n  }\n\n  const advertised = new Set(effective.capabilities.harnesses[harness.data]?.tools ?? []);\n  const missing = requestedTools.filter((tool) => !advertised.has(tool));\n  const context = `agent-tool-capability:${params.step.id}`;\n\n  const operation =\n    missing.length === 0\n      ? {context, style: 'warning' as const, op: 'remove' as const}\n      : {\n          context,\n          style: 'warning' as const,\n          op: 'replace' as const,\n          body: warningBody({\n            harness: harness.data,\n            missing,\n            reason: warningReason({\n              reportFresh: effective.reportFresh,\n              harnessKnown: effective.capabilities.harnesses[harness.data] !== undefined,\n            }),\n          }),\n        };\n\n  try {\n    await params.annotations.replaceOrRemoveAnnotation({\n      ...annotationTargetFromLease(params.leaseIdentity),\n      originStepId: params.step.id,\n      originStepAttempt: params.step.currentAttempt,\n      context,\n      annotation: operation.op === 'remove' ? {op: 'remove'} : operation,\n    });\n  } catch (error) {\n    const reason = isAnnotationBudgetError(error) ? 'budget' : 'write';\n    recordWarningWriteFailure(reason);\n    logger().warn(\n      {\n        error,\n        reason,\n        jobExecutionId: params.leaseIdentity.jobExecutionId,\n        stepId: params.step.id,\n      },\n      'Failed to write agent tool capability warning annotation',\n    );\n    return;\n  }\n\n  if (missing.length > 0) {\n    logger().warn(\n      {\n        jobExecutionId: params.leaseIdentity.jobExecutionId,\n        stepId: params.step.id,\n        harness: harness.data,\n        missing,\n        reason: warningReason({\n          reportFresh: effective.reportFresh,\n          harnessKnown: effective.capabilities.harnesses[harness.data] !== undefined,\n        }),\n      },\n      'Runner missing requested agent tools; dispatch is continuing',\n    );\n  }\n}\n\nfunction parseAgentConfig(step: Step): MaterializedAgentStepConfigDto | null {\n  if (step.type !== 'agent') return null;\n\n  const parsed = materializedAgentStepConfigSchema.safeParse(step.config);\n  return parsed.success ? parsed.data : null;\n}\n\nfunction warningBody(params: {\n  harness: string;\n  missing: readonly string[];\n  reason: WarningReason;\n}): string {\n  const tools = formatToolList(params.missing);\n  const harness = markdownInlineCode(params.harness);\n  if (params.reason === 'known-absence') {\n    return [\n      '**Runner missing requested agent tools**',\n      '',\n      `The matched runner advertised a ${harness} tool set without: ${tools}.`,\n      'Execution is continuing on this runner because labels matched; the step may fail if the harness cannot provide these tools.',\n    ].join('\\n');\n  }\n\n  if (params.reason === 'harness-not-advertised') {\n    return [\n      '**Runner missing requested agent harness tools**',\n      '',\n      `The matched runner advertised fresh tool capabilities, but did not advertise a ${harness} tool set. Support for ${tools} could not be confirmed.`,\n      'Execution is continuing on this runner because labels matched; the step may fail if the harness cannot provide these tools.',\n    ].join('\\n');\n  }\n\n  return [\n    '**Could not confirm runner agent tools**',\n    '',\n    `The matched runner reported no or stale tool capabilities, so support for ${tools} could not be confirmed.`,\n    'Execution is continuing on this runner because labels matched.',\n  ].join('\\n');\n}\n\nfunction formatToolList(tools: readonly string[]): string {\n  const visible = tools.slice(0, TOOL_LIST_LIMIT).map(markdownInlineCode);\n  const remaining = tools.length - visible.length;\n  return remaining > 0 ? `${visible.join(', ')} ...and ${remaining} more` : visible.join(', ');\n}\n\nfunction markdownInlineCode(value: string): string {\n  const maxBacktickRun = Math.max(\n    0,\n    ...Array.from(value.matchAll(/`+/g), (match) => match[0].length),\n  );\n  const delimiter = '`'.repeat(maxBacktickRun + 1);\n  const needsPadding = value.startsWith('`') || value.endsWith('`');\n  const content = needsPadding ? ` ${value} ` : value;\n  return `${delimiter}${content}${delimiter}`;\n}\n\nfunction warningReason(params: {reportFresh: boolean; harnessKnown: boolean}): WarningReason {\n  if (params.harnessKnown) return 'known-absence';\n  return params.reportFresh ? 'harness-not-advertised' : 'unknown-or-stale';\n}\n\nfunction annotationTargetFromLease(\n  lease: LeasedJobContext,\n): Omit<\n  Parameters<AnnotationsInterModuleClient['replaceOrRemoveAnnotation']>[0],\n  'originStepId' | 'originStepAttempt' | 'context' | 'annotation'\n> {\n  return {\n    workspaceId: lease.workspaceId,\n    projectId: lease.projectId,\n    workflowRunId: lease.workflowRunId,\n    workflowRunAttempt: lease.workflowRunAttempt ?? 1,\n    workflowRunAttemptId: lease.workflowRunAttemptId,\n    jobId: lease.jobId,\n    jobExecutionId: lease.jobExecutionId,\n  };\n}\n\nfunction isAnnotationBudgetError(error: unknown): boolean {\n  return isInterModuleKnownError(\n    annotationsInterModuleContract.methods.replaceOrRemoveAnnotation,\n    error,\n  );\n}\n\nfunction recordWarningWriteFailure(reason: WarningFailureReason): void {\n  recordWorkflowAgentToolWarningFailed(reason);\n}\n"],"names":["annotationsInterModuleContract","harnessSchema","materializedAgentStepConfigSchema","isInterModuleKnownError","logger","recordWorkflowAgentToolWarningFailed","TOOL_LIST_LIMIT","warnAgentToolCapabilityMismatchOnDispatch","params","config","parseAgentConfig","step","requestedTools","tools","length","harness","safeParse","success","effective","runners","getEffectiveRunnerToolCapabilities","runnerSessionId","leaseIdentity","error","recordWarningWriteFailure","warn","jobExecutionId","stepId","id","advertised","Set","capabilities","harnesses","data","missing","filter","tool","has","context","operation","style","op","body","warningBody","reason","warningReason","reportFresh","harnessKnown","undefined","annotations","replaceOrRemoveAnnotation","annotationTargetFromLease","originStepId","originStepAttempt","currentAttempt","annotation","isAnnotationBudgetError","type","parsed","formatToolList","markdownInlineCode","join","visible","slice","map","remaining","value","maxBacktickRun","Math","max","Array","from","matchAll","match","delimiter","repeat","needsPadding","startsWith","endsWith","content","lease","workspaceId","projectId","workflowRunId","workflowRunAttempt","workflowRunAttemptId","jobId","methods"],"mappings":"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"}

package/dist/core/agent-tools.d.ts

@@ -1,16 +1,18 @@
 import type { MaterializedAgentIntegrationConfigDto } from '@shipfox/api-agent-dto';
-import type { WorkflowModel } from '@shipfox/api-definitions';
-import type { AgentToolCatalogs, GetIntegrationConnectionByIdFn, IntegrationProviderKind, LoadWorkspaceConnectionSnapshot, WorkspaceConnectionSnapshot } from '@shipfox/api-integration-core';
+import type { WorkflowModel } from '@shipfox/api-definitions-dto';
+import type { AgentToolCatalogEntry, IntegrationProviderKind, IntegrationsModuleClient } from '@shipfox/api-integration-core-dto';
+import type { ProjectsModuleClient } from '@shipfox/api-projects-dto';
 type WorkflowModelJob = WorkflowModel['jobs'][number];
 type WorkflowModelAgentStep = Extract<WorkflowModelJob['steps'][number], {
     kind: 'agent';
 }>;
 type WorkflowModelStepIntegration = NonNullable<WorkflowModelAgentStep['integrations']>[number];
-interface AgentToolMaterializationServices {
-    readonly catalogs: AgentToolCatalogs;
-    readonly loadWorkspaceConnectionSnapshot: LoadWorkspaceConnectionSnapshot;
-    readonly getIntegrationConnectionById: GetIntegrationConnectionByIdFn;
-}
+type AgentToolCatalogs = ReadonlyMap<IntegrationProviderKind, readonly AgentToolCatalogEntry[]>;
+type WorkspaceConnectionSnapshot = ReadonlyMap<string, {
+    id: string;
+    provider: IntegrationProviderKind;
+    capabilities: readonly ('source_control' | 'agent_tools')[];
+}>;
 export interface AgentToolMaterializationContext {
     readonly catalogs: AgentToolCatalogs;
     readonly workspaceConnectionSnapshot: WorkspaceConnectionSnapshot;
@@ -28,12 +30,12 @@ export interface AgentToolMaterializationSnapshotStep {
     readonly stepId: string;
     readonly integrations: readonly MaterializedAgentIntegrationConfigDto[];
 }
-export declare function setAgentToolMaterializationServices(nextServices: AgentToolMaterializationServices): void;
-export declare function clearAgentToolMaterializationServices(): void;
 export declare function loadAgentToolMaterializationContext(params: {
     readonly model: WorkflowModel | null;
     readonly workspaceId: string;
     readonly projectId: string;
+    readonly integrations?: IntegrationsModuleClient | undefined;
+    readonly projects?: ProjectsModuleClient | undefined;
     readonly jobs?: readonly WorkflowModelJob[] | undefined;
 }): Promise<AgentToolMaterializationContext | undefined>;
 export declare function materializeAgentIntegrations(params: {

package/dist/core/agent-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-tools.d.ts","sourceRoot":"","sources":["../../src/core/agent-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,qCAAqC,EAEtC,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAGV,iBAAiB,EACjB,8BAA8B,EAC9B,uBAAuB,EACvB,+BAA+B,EAC/B,2BAA2B,EAC5B,MAAM,+BAA+B,CAAC;AAIvC,KAAK,gBAAgB,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC;AACtD,KAAK,sBAAsB,GAAG,OAAO,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,EAAE;IAAC,IAAI,EAAE,OAAO,CAAA;CAAC,CAAC,CAAC;AAC1F,KAAK,4BAA4B,GAAG,WAAW,CAAC,sBAAsB,CAAC,cAAc,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AAEhG,UAAU,gCAAgC;IACxC,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;IACrC,QAAQ,CAAC,+BAA+B,EAAE,+BAA+B,CAAC;IAC1E,QAAQ,CAAC,4BAA4B,EAAE,8BAA8B,CAAC;CACvE;AAED,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;IACrC,QAAQ,CAAC,2BAA2B,EAAE,2BAA2B,CAAC;IAClE,QAAQ,CAAC,iBAAiB,EAAE;QAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,QAAQ,EAAE,uBAAuB,CAAC;KAC5C,CAAC;CACH;AAED,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,KAAK,EAAE,SAAS,oCAAoC,EAAE,CAAC;CACjE;AAED,MAAM,WAAW,oCAAoC;IACnD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,YAAY,EAAE,SAAS,qCAAqC,EAAE,CAAC;CACzE;AAUD,wBAAgB,mCAAmC,CACjD,YAAY,EAAE,gCAAgC,GAC7C,IAAI,CAEN;AAED,wBAAgB,qCAAqC,IAAI,IAAI,CAE5D;AAED,wBAAsB,mCAAmC,CAAC,MAAM,EAAE;IAChE,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,CAAC;IACrC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,gBAAgB,EAAE,GAAG,SAAS,CAAC;CACzD,GAAG,OAAO,CAAC,+BAA+B,GAAG,SAAS,CAAC,CAgCvD;AAED,wBAAgB,4BAA4B,CAAC,MAAM,EAAE;IACnD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,YAAY,EAAE,SAAS,4BAA4B,EAAE,GAAG,SAAS,CAAC;IAC3E,QAAQ,CAAC,OAAO,EAAE,+BAA+B,GAAG,SAAS,CAAC;IAC9D,QAAQ,CAAC,QAAQ,CAAC,EAAE,gCAAgC,GAAG,IAAI,GAAG,SAAS,CAAC;CACzE,GAAG,qCAAqC,EAAE,GAAG,SAAS,CActD;AAED,wBAAgB,sCAAsC,CAAC,MAAM,EAAE;IAC7D,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,+BAA+B,GAAG,SAAS,CAAC;CAC/D,GAAG,gCAAgC,GAAG,IAAI,CAwB1C"}
+{"version":3,"file":"agent-tools.d.ts","sourceRoot":"","sources":["../../src/core/agent-tools.ts"],"names":[],"mappings":"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"}

package/dist/core/agent-tools.js

@@ -1,30 +1,35 @@
-import { getProjectById } from '@shipfox/api-projects';
 import { AgentIntegrationMaterializationError } from './errors.js';
-let services;
-export function setAgentToolMaterializationServices(nextServices) {
-    services = nextServices;
-}
-export function clearAgentToolMaterializationServices() {
-    services = undefined;
-}
 export async function loadAgentToolMaterializationContext(params) {
     if (!modelHasAgentStepIntegrations(params.model, params.jobs)) return undefined;
-    if (services === undefined) {
-        throw new AgentIntegrationMaterializationError('Agent tool materialization is not configured');
+    if (params.projects === undefined) {
+        throw new AgentIntegrationMaterializationError('Project access is not configured');
     }
-    const project = await getProjectById(params.projectId);
-    if (project === undefined) {
+    const { project } = await params.projects.getProjectById({
+        projectId: params.projectId
+    });
+    if (project === null) {
         throw new AgentIntegrationMaterializationError(`Project ${params.projectId} was not found while materializing agent integrations`);
     }
-    const [workspaceConnectionSnapshot, defaultConnection] = await Promise.all([
-        services.loadWorkspaceConnectionSnapshot(params.workspaceId),
-        services.getIntegrationConnectionById(project.sourceConnectionId)
-    ]);
-    if (defaultConnection === undefined) {
+    if (params.integrations === undefined) {
+        throw new AgentIntegrationMaterializationError('Agent tool materialization is not configured');
+    }
+    const context = await params.integrations.getAgentToolsContext({
+        workspaceId: params.workspaceId,
+        defaultConnectionId: project.sourceConnectionId
+    });
+    const workspaceConnectionSnapshot = new Map(context.workspaceConnections.map(({ slug, ...connection })=>[
+            slug,
+            connection
+        ]));
+    const defaultConnection = context.defaultConnection;
+    if (defaultConnection === null) {
         throw new AgentIntegrationMaterializationError(`Source connection ${project.sourceConnectionId} was not found while materializing agent integrations`);
     }
     return {
-        catalogs: services.catalogs,
+        catalogs: new Map(context.catalogs.map(({ provider, tools })=>[
+                provider,
+                tools
+            ])),
         workspaceConnectionSnapshot,
         defaultConnection: {
             id: defaultConnection.id,

package/dist/core/agent-tools.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/core/agent-tools.ts"],"sourcesContent":["import type {\n  MaterializedAgentIntegrationConfigDto,\n  MaterializedAgentIntegrationToolConfigDto,\n} from '@shipfox/api-agent-dto';\nimport type {WorkflowModel} from '@shipfox/api-definitions';\nimport type {\n  AgentToolCatalogEntry,\n  AgentToolCatalogMethod,\n  AgentToolCatalogs,\n  GetIntegrationConnectionByIdFn,\n  IntegrationProviderKind,\n  LoadWorkspaceConnectionSnapshot,\n  WorkspaceConnectionSnapshot,\n} from '@shipfox/api-integration-core';\nimport {getProjectById} from '@shipfox/api-projects';\nimport {AgentIntegrationMaterializationError} from './errors.js';\n\ntype WorkflowModelJob = WorkflowModel['jobs'][number];\ntype WorkflowModelAgentStep = Extract<WorkflowModelJob['steps'][number], {kind: 'agent'}>;\ntype WorkflowModelStepIntegration = NonNullable<WorkflowModelAgentStep['integrations']>[number];\n\ninterface AgentToolMaterializationServices {\n  readonly catalogs: AgentToolCatalogs;\n  readonly loadWorkspaceConnectionSnapshot: LoadWorkspaceConnectionSnapshot;\n  readonly getIntegrationConnectionById: GetIntegrationConnectionByIdFn;\n}\n\nexport interface AgentToolMaterializationContext {\n  readonly catalogs: AgentToolCatalogs;\n  readonly workspaceConnectionSnapshot: WorkspaceConnectionSnapshot;\n  readonly defaultConnection: {\n    readonly id: string;\n    readonly slug: string;\n    readonly provider: IntegrationProviderKind;\n  };\n}\n\nexport interface AgentToolMaterializationSnapshot {\n  readonly steps: readonly AgentToolMaterializationSnapshotStep[];\n}\n\nexport interface AgentToolMaterializationSnapshotStep {\n  readonly jobKey: string;\n  readonly stepId: string;\n  readonly integrations: readonly MaterializedAgentIntegrationConfigDto[];\n}\n\ninterface SelectedToolState {\n  readonly entry: AgentToolCatalogEntry;\n  readonly methods: Map<string, AgentToolCatalogMethod>;\n  selectedStandalone: boolean;\n}\n\nlet services: AgentToolMaterializationServices | undefined;\n\nexport function setAgentToolMaterializationServices(\n  nextServices: AgentToolMaterializationServices,\n): void {\n  services = nextServices;\n}\n\nexport function clearAgentToolMaterializationServices(): void {\n  services = undefined;\n}\n\nexport async function loadAgentToolMaterializationContext(params: {\n  readonly model: WorkflowModel | null;\n  readonly workspaceId: string;\n  readonly projectId: string;\n  readonly jobs?: readonly WorkflowModelJob[] | undefined;\n}): Promise<AgentToolMaterializationContext | undefined> {\n  if (!modelHasAgentStepIntegrations(params.model, params.jobs)) return undefined;\n  if (services === undefined) {\n    throw new AgentIntegrationMaterializationError('Agent tool materialization is not configured');\n  }\n\n  const project = await getProjectById(params.projectId);\n  if (project === undefined) {\n    throw new AgentIntegrationMaterializationError(\n      `Project ${params.projectId} was not found while materializing agent integrations`,\n    );\n  }\n\n  const [workspaceConnectionSnapshot, defaultConnection] = await Promise.all([\n    services.loadWorkspaceConnectionSnapshot(params.workspaceId),\n    services.getIntegrationConnectionById(project.sourceConnectionId),\n  ]);\n  if (defaultConnection === undefined) {\n    throw new AgentIntegrationMaterializationError(\n      `Source connection ${project.sourceConnectionId} was not found while materializing agent integrations`,\n    );\n  }\n\n  return {\n    catalogs: services.catalogs,\n    workspaceConnectionSnapshot,\n    defaultConnection: {\n      id: defaultConnection.id,\n      slug: defaultConnection.slug,\n      provider: defaultConnection.provider,\n    },\n  };\n}\n\nexport function materializeAgentIntegrations(params: {\n  readonly jobKey: string;\n  readonly stepId: string;\n  readonly integrations: readonly WorkflowModelStepIntegration[] | undefined;\n  readonly context: AgentToolMaterializationContext | undefined;\n  readonly snapshot?: AgentToolMaterializationSnapshot | null | undefined;\n}): MaterializedAgentIntegrationConfigDto[] | undefined {\n  const snapshot = findSnapshotStep(params);\n  if (snapshot !== undefined) return snapshot.integrations.map(copyMaterializedIntegration);\n  if (params.integrations === undefined) return undefined;\n  if (params.context === undefined) {\n    throw new AgentIntegrationMaterializationError(\n      'Agent integrations require materialization context',\n    );\n  }\n  const {context} = params;\n\n  return params.integrations.map((integration) =>\n    materializeAgentIntegration({integration, context}),\n  );\n}\n\nexport function createAgentToolMaterializationSnapshot(params: {\n  readonly model: WorkflowModel;\n  readonly context: AgentToolMaterializationContext | undefined;\n}): AgentToolMaterializationSnapshot | null {\n  if (params.context === undefined) return null;\n\n  const steps = params.model.jobs.flatMap((job) =>\n    job.steps.flatMap((step) => {\n      if (step.kind !== 'agent' || step.integrations === undefined) return [];\n      const integrations = materializeAgentIntegrations({\n        jobKey: job.key,\n        stepId: step.id,\n        integrations: step.integrations,\n        context: params.context,\n      });\n      if (integrations === undefined) return [];\n      return [\n        {\n          jobKey: job.key,\n          stepId: step.id,\n          integrations,\n        },\n      ];\n    }),\n  );\n\n  return steps.length === 0 ? null : {steps};\n}\n\nfunction findSnapshotStep(params: {\n  readonly jobKey: string;\n  readonly stepId: string;\n  readonly snapshot?: AgentToolMaterializationSnapshot | null | undefined;\n}): AgentToolMaterializationSnapshotStep | undefined {\n  return params.snapshot?.steps.find(\n    (step) => step.jobKey === params.jobKey && step.stepId === params.stepId,\n  );\n}\n\nfunction materializeAgentIntegration(params: {\n  readonly integration: WorkflowModelStepIntegration;\n  readonly context: AgentToolMaterializationContext;\n}): MaterializedAgentIntegrationConfigDto {\n  const connection = resolveConnection(params);\n  const catalog = params.context.catalogs.get(connection.provider);\n  if (catalog === undefined) {\n    throw new AgentIntegrationMaterializationError(\n      `Integration provider ${connection.provider} has no agent tool catalog`,\n    );\n  }\n\n  const tools = selectTools({\n    catalog,\n    include: params.integration.include,\n    exclude: params.integration.exclude ?? [],\n  });\n  const requiredScope = mergeRequiredScopes(tools.map((tool) => tool.requiredScope));\n\n  return {\n    connectionId: connection.id,\n    connectionSlug: connection.slug,\n    provider: connection.provider,\n    requiredScope,\n    tools,\n  };\n}\n\nfunction copyMaterializedIntegration(\n  integration: MaterializedAgentIntegrationConfigDto,\n): MaterializedAgentIntegrationConfigDto {\n  return {\n    ...integration,\n    requiredScope: [...integration.requiredScope],\n    tools: integration.tools.map((tool) => ({\n      ...tool,\n      requiredScope: [...tool.requiredScope],\n      ...(tool.methods === undefined\n        ? {}\n        : {\n            methods: tool.methods.map((method) => ({\n              ...method,\n              requiredScope: [...method.requiredScope],\n            })),\n          }),\n    })),\n  };\n}\n\nfunction resolveConnection(params: {\n  readonly integration: WorkflowModelStepIntegration;\n  readonly context: AgentToolMaterializationContext;\n}): AgentToolMaterializationContext['defaultConnection'] {\n  if (params.integration.connection === undefined) return params.context.defaultConnection;\n\n  const connection = params.context.workspaceConnectionSnapshot.get(params.integration.connection);\n  if (connection === undefined) {\n    throw new AgentIntegrationMaterializationError(\n      `Integration connection ${params.integration.connection} was not found while materializing agent integrations`,\n    );\n  }\n  return {\n    id: connection.id,\n    slug: params.integration.connection,\n    provider: connection.provider,\n  };\n}\n\nfunction selectTools(params: {\n  readonly catalog: readonly AgentToolCatalogEntry[];\n  readonly include: readonly string[];\n  readonly exclude: readonly string[];\n}): MaterializedAgentIntegrationToolConfigDto[] {\n  const selected = new Map<string, SelectedToolState>();\n\n  for (const token of params.include) {\n    applySelection({catalog: params.catalog, selected, token, mode: 'include'});\n  }\n  for (const token of params.exclude) {\n    applySelection({catalog: params.catalog, selected, token, mode: 'exclude'});\n  }\n\n  const tools = params.catalog.flatMap((entry) => {\n    const state = selected.get(entry.id);\n    if (state === undefined) return [];\n    return [materializedTool(state)];\n  });\n  if (tools.length === 0) {\n    throw new AgentIntegrationMaterializationError(\n      'Agent integration selection resolved to no tools',\n    );\n  }\n  return tools;\n}\n\nfunction applySelection(params: {\n  readonly catalog: readonly AgentToolCatalogEntry[];\n  readonly selected: Map<string, SelectedToolState>;\n  readonly token: string;\n  readonly mode: 'include' | 'exclude';\n}): void {\n  if (params.token === '*') {\n    for (const entry of params.catalog) applyEntrySelection(params, entry);\n    return;\n  }\n\n  const match = findCatalogSelection(params.catalog, params.token);\n  if (match === undefined) {\n    throw new AgentIntegrationMaterializationError(`Unknown integration tool: ${params.token}`);\n  }\n  applyEntrySelection(params, match.entry, match.method);\n}\n\nfunction applyEntrySelection(\n  params: {\n    readonly selected: Map<string, SelectedToolState>;\n    readonly token: string;\n    readonly mode: 'include' | 'exclude';\n  },\n  entry: AgentToolCatalogEntry,\n  method?: AgentToolCatalogMethod | undefined,\n): void {\n  if (params.mode === 'exclude') {\n    excludeEntrySelection(params.selected, entry, method);\n    return;\n  }\n\n  const state =\n    params.selected.get(entry.id) ??\n    ({entry, methods: new Map(), selectedStandalone: false} satisfies SelectedToolState);\n  if (entry.methods === undefined) {\n    state.selectedStandalone = true;\n  } else if (method === undefined) {\n    for (const candidate of entry.methods) state.methods.set(candidate.id, candidate);\n  } else {\n    state.methods.set(method.id, method);\n  }\n  params.selected.set(entry.id, state);\n}\n\nfunction excludeEntrySelection(\n  selected: Map<string, SelectedToolState>,\n  entry: AgentToolCatalogEntry,\n  method?: AgentToolCatalogMethod | undefined,\n): void {\n  if (method === undefined) {\n    selected.delete(entry.id);\n    return;\n  }\n\n  const state = selected.get(entry.id);\n  if (state === undefined) return;\n  state.methods.delete(method.id);\n  if (!state.selectedStandalone && state.methods.size === 0) selected.delete(entry.id);\n}\n\nfunction findCatalogSelection(\n  catalog: readonly AgentToolCatalogEntry[],\n  token: string,\n):\n  | {readonly entry: AgentToolCatalogEntry; readonly method?: AgentToolCatalogMethod | undefined}\n  | undefined {\n  const entry = catalog.find((candidate) => candidate.id === token);\n  if (entry !== undefined) return {entry};\n\n  const wildcardSuffix = '.*';\n  if (token.endsWith(wildcardSuffix)) {\n    const family = token.slice(0, -wildcardSuffix.length);\n    const familyEntry = catalog.find((candidate) => candidate.id === family);\n    return familyEntry === undefined ? undefined : {entry: familyEntry};\n  }\n\n  const dotIndex = token.indexOf('.');\n  if (dotIndex < 1) return undefined;\n  const family = token.slice(0, dotIndex);\n  const methodId = token.slice(dotIndex + 1);\n  const familyEntry = catalog.find((candidate) => candidate.id === family);\n  const method = familyEntry?.methods?.find((candidate) => candidate.id === methodId);\n  if (familyEntry === undefined || method === undefined) return undefined;\n  return {entry: familyEntry, method};\n}\n\nfunction materializedTool(state: SelectedToolState): MaterializedAgentIntegrationToolConfigDto {\n  if (state.entry.methods === undefined) {\n    return {\n      id: state.entry.id,\n      sensitivity: state.entry.sensitivity,\n      sensitive: state.entry.sensitive,\n      requiredScope: normalizeRequiredScope(state.entry.requiredScope),\n      inputSchema: state.entry.inputSchema,\n      ...(state.entry.outputSchema === undefined ? {} : {outputSchema: state.entry.outputSchema}),\n    };\n  }\n\n  const methods = state.entry.methods\n    .filter((method) => state.methods.has(method.id))\n    .map((method) => ({\n      id: method.id,\n      token: `${state.entry.id}.${method.id}`,\n      description: method.description,\n      sensitivity: method.sensitivity,\n      sensitive: method.sensitive,\n      requiredScope: normalizeRequiredScope(method.requiredScope),\n    }));\n\n  return {\n    id: state.entry.id,\n    sensitivity: methods.some((method) => method.sensitivity === 'write') ? 'write' : 'read',\n    sensitive: methods.some((method) => method.sensitive),\n    requiredScope: mergeRequiredScopes(methods.map((method) => method.requiredScope)),\n    inputSchema: state.entry.inputSchema,\n    ...(state.entry.outputSchema === undefined ? {} : {outputSchema: state.entry.outputSchema}),\n    methods,\n  };\n}\n\nfunction mergeRequiredScopes(scopes: readonly unknown[]): unknown[] {\n  const items = scopes.flatMap(normalizeRequiredScope);\n  if (items.every(isPermissionScope)) {\n    const byPermission = new Map<string, 'read' | 'write'>();\n    for (const item of items) {\n      const existing = byPermission.get(item.permission);\n      if (existing === 'write') continue;\n      byPermission.set(item.permission, item.access);\n    }\n    return [...byPermission.entries()].map(([permission, access]) => ({permission, access}));\n  }\n\n  const deduped = new Map<string, unknown>();\n  for (const item of items) deduped.set(JSON.stringify(item), item);\n  return [...deduped.values()];\n}\n\nfunction normalizeRequiredScope(scope: unknown): unknown[] {\n  return Array.isArray(scope) ? [...scope] : [scope];\n}\n\nfunction isPermissionScope(\n  value: unknown,\n): value is {permission: string; access: 'read' | 'write'} {\n  if (typeof value !== 'object' || value === null) return false;\n  const candidate = value as {permission?: unknown; access?: unknown};\n  return (\n    typeof candidate.permission === 'string' &&\n    (candidate.access === 'read' || candidate.access === 'write')\n  );\n}\n\nfunction modelHasAgentStepIntegrations(\n  model: WorkflowModel | null,\n  jobs: readonly WorkflowModelJob[] | undefined,\n): boolean {\n  if (model === null) return false;\n  return (jobs ?? model.jobs).some((job) =>\n    job.steps.some((step) => step.kind === 'agent' && step.integrations !== undefined),\n  );\n}\n"],"names":["getProjectById","AgentIntegrationMaterializationError","services","setAgentToolMaterializationServices","nextServices","clearAgentToolMaterializationServices","undefined","loadAgentToolMaterializationContext","params","modelHasAgentStepIntegrations","model","jobs","project","projectId","workspaceConnectionSnapshot","defaultConnection","Promise","all","loadWorkspaceConnectionSnapshot","workspaceId","getIntegrationConnectionById","sourceConnectionId","catalogs","id","slug","provider","materializeAgentIntegrations","snapshot","findSnapshotStep","integrations","map","copyMaterializedIntegration","context","integration","materializeAgentIntegration","createAgentToolMaterializationSnapshot","steps","flatMap","job","step","kind","jobKey","key","stepId","length","find","connection","resolveConnection","catalog","get","tools","selectTools","include","exclude","requiredScope","mergeRequiredScopes","tool","connectionId","connectionSlug","methods","method","selected","Map","token","applySelection","mode","entry","state","materializedTool","applyEntrySelection","match","findCatalogSelection","excludeEntrySelection","selectedStandalone","candidate","set","delete","size","wildcardSuffix","endsWith","family","slice","familyEntry","dotIndex","indexOf","methodId","sensitivity","sensitive","normalizeRequiredScope","inputSchema","outputSchema","filter","has","description","some","scopes","items","every","isPermissionScope","byPermission","item","existing","permission","access","entries","deduped","JSON","stringify","values","scope","Array","isArray","value"],"mappings":"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"}
+{"version":3,"sources":["../../src/core/agent-tools.ts"],"sourcesContent":["import type {\n  MaterializedAgentIntegrationConfigDto,\n  MaterializedAgentIntegrationToolConfigDto,\n} from '@shipfox/api-agent-dto';\nimport type {WorkflowModel} from '@shipfox/api-definitions-dto';\nimport type {\n  AgentToolCatalogEntry,\n  AgentToolCatalogMethod,\n  IntegrationProviderKind,\n  IntegrationsModuleClient,\n} from '@shipfox/api-integration-core-dto';\nimport type {ProjectsModuleClient} from '@shipfox/api-projects-dto';\nimport {AgentIntegrationMaterializationError} from './errors.js';\n\ntype WorkflowModelJob = WorkflowModel['jobs'][number];\ntype WorkflowModelAgentStep = Extract<WorkflowModelJob['steps'][number], {kind: 'agent'}>;\ntype WorkflowModelStepIntegration = NonNullable<WorkflowModelAgentStep['integrations']>[number];\ntype AgentToolCatalogs = ReadonlyMap<IntegrationProviderKind, readonly AgentToolCatalogEntry[]>;\ntype WorkspaceConnectionSnapshot = ReadonlyMap<\n  string,\n  {\n    id: string;\n    provider: IntegrationProviderKind;\n    capabilities: readonly ('source_control' | 'agent_tools')[];\n  }\n>;\n\nexport interface AgentToolMaterializationContext {\n  readonly catalogs: AgentToolCatalogs;\n  readonly workspaceConnectionSnapshot: WorkspaceConnectionSnapshot;\n  readonly defaultConnection: {\n    readonly id: string;\n    readonly slug: string;\n    readonly provider: IntegrationProviderKind;\n  };\n}\n\nexport interface AgentToolMaterializationSnapshot {\n  readonly steps: readonly AgentToolMaterializationSnapshotStep[];\n}\n\nexport interface AgentToolMaterializationSnapshotStep {\n  readonly jobKey: string;\n  readonly stepId: string;\n  readonly integrations: readonly MaterializedAgentIntegrationConfigDto[];\n}\n\ninterface SelectedToolState {\n  readonly entry: AgentToolCatalogEntry;\n  readonly methods: Map<string, AgentToolCatalogMethod>;\n  selectedStandalone: boolean;\n}\n\nexport async function loadAgentToolMaterializationContext(params: {\n  readonly model: WorkflowModel | null;\n  readonly workspaceId: string;\n  readonly projectId: string;\n  readonly integrations?: IntegrationsModuleClient | undefined;\n  readonly projects?: ProjectsModuleClient | undefined;\n  readonly jobs?: readonly WorkflowModelJob[] | undefined;\n}): Promise<AgentToolMaterializationContext | undefined> {\n  if (!modelHasAgentStepIntegrations(params.model, params.jobs)) return undefined;\n\n  if (params.projects === undefined) {\n    throw new AgentIntegrationMaterializationError('Project access is not configured');\n  }\n  const {project} = await params.projects.getProjectById({projectId: params.projectId});\n  if (project === null) {\n    throw new AgentIntegrationMaterializationError(\n      `Project ${params.projectId} was not found while materializing agent integrations`,\n    );\n  }\n\n  if (params.integrations === undefined) {\n    throw new AgentIntegrationMaterializationError('Agent tool materialization is not configured');\n  }\n  const context = await params.integrations.getAgentToolsContext({\n    workspaceId: params.workspaceId,\n    defaultConnectionId: project.sourceConnectionId,\n  });\n  const workspaceConnectionSnapshot = new Map(\n    context.workspaceConnections.map(({slug, ...connection}) => [slug, connection]),\n  );\n  const defaultConnection = context.defaultConnection;\n  if (defaultConnection === null) {\n    throw new AgentIntegrationMaterializationError(\n      `Source connection ${project.sourceConnectionId} was not found while materializing agent integrations`,\n    );\n  }\n\n  return {\n    catalogs: new Map(context.catalogs.map(({provider, tools}) => [provider, tools])),\n    workspaceConnectionSnapshot,\n    defaultConnection: {\n      id: defaultConnection.id,\n      slug: defaultConnection.slug,\n      provider: defaultConnection.provider,\n    },\n  };\n}\n\nexport function materializeAgentIntegrations(params: {\n  readonly jobKey: string;\n  readonly stepId: string;\n  readonly integrations: readonly WorkflowModelStepIntegration[] | undefined;\n  readonly context: AgentToolMaterializationContext | undefined;\n  readonly snapshot?: AgentToolMaterializationSnapshot | null | undefined;\n}): MaterializedAgentIntegrationConfigDto[] | undefined {\n  const snapshot = findSnapshotStep(params);\n  if (snapshot !== undefined) return snapshot.integrations.map(copyMaterializedIntegration);\n  if (params.integrations === undefined) return undefined;\n  if (params.context === undefined) {\n    throw new AgentIntegrationMaterializationError(\n      'Agent integrations require materialization context',\n    );\n  }\n  const {context} = params;\n\n  return params.integrations.map((integration) =>\n    materializeAgentIntegration({integration, context}),\n  );\n}\n\nexport function createAgentToolMaterializationSnapshot(params: {\n  readonly model: WorkflowModel;\n  readonly context: AgentToolMaterializationContext | undefined;\n}): AgentToolMaterializationSnapshot | null {\n  if (params.context === undefined) return null;\n\n  const steps = params.model.jobs.flatMap((job) =>\n    job.steps.flatMap((step) => {\n      if (step.kind !== 'agent' || step.integrations === undefined) return [];\n      const integrations = materializeAgentIntegrations({\n        jobKey: job.key,\n        stepId: step.id,\n        integrations: step.integrations,\n        context: params.context,\n      });\n      if (integrations === undefined) return [];\n      return [\n        {\n          jobKey: job.key,\n          stepId: step.id,\n          integrations,\n        },\n      ];\n    }),\n  );\n\n  return steps.length === 0 ? null : {steps};\n}\n\nfunction findSnapshotStep(params: {\n  readonly jobKey: string;\n  readonly stepId: string;\n  readonly snapshot?: AgentToolMaterializationSnapshot | null | undefined;\n}): AgentToolMaterializationSnapshotStep | undefined {\n  return params.snapshot?.steps.find(\n    (step) => step.jobKey === params.jobKey && step.stepId === params.stepId,\n  );\n}\n\nfunction materializeAgentIntegration(params: {\n  readonly integration: WorkflowModelStepIntegration;\n  readonly context: AgentToolMaterializationContext;\n}): MaterializedAgentIntegrationConfigDto {\n  const connection = resolveConnection(params);\n  const catalog = params.context.catalogs.get(connection.provider);\n  if (catalog === undefined) {\n    throw new AgentIntegrationMaterializationError(\n      `Integration provider ${connection.provider} has no agent tool catalog`,\n    );\n  }\n\n  const tools = selectTools({\n    catalog,\n    include: params.integration.include,\n    exclude: params.integration.exclude ?? [],\n  });\n  const requiredScope = mergeRequiredScopes(tools.map((tool) => tool.requiredScope));\n\n  return {\n    connectionId: connection.id,\n    connectionSlug: connection.slug,\n    provider: connection.provider,\n    requiredScope,\n    tools,\n  };\n}\n\nfunction copyMaterializedIntegration(\n  integration: MaterializedAgentIntegrationConfigDto,\n): MaterializedAgentIntegrationConfigDto {\n  return {\n    ...integration,\n    requiredScope: [...integration.requiredScope],\n    tools: integration.tools.map((tool) => ({\n      ...tool,\n      requiredScope: [...tool.requiredScope],\n      ...(tool.methods === undefined\n        ? {}\n        : {\n            methods: tool.methods.map((method) => ({\n              ...method,\n              requiredScope: [...method.requiredScope],\n            })),\n          }),\n    })),\n  };\n}\n\nfunction resolveConnection(params: {\n  readonly integration: WorkflowModelStepIntegration;\n  readonly context: AgentToolMaterializationContext;\n}): AgentToolMaterializationContext['defaultConnection'] {\n  if (params.integration.connection === undefined) return params.context.defaultConnection;\n\n  const connection = params.context.workspaceConnectionSnapshot.get(params.integration.connection);\n  if (connection === undefined) {\n    throw new AgentIntegrationMaterializationError(\n      `Integration connection ${params.integration.connection} was not found while materializing agent integrations`,\n    );\n  }\n  return {\n    id: connection.id,\n    slug: params.integration.connection,\n    provider: connection.provider,\n  };\n}\n\nfunction selectTools(params: {\n  readonly catalog: readonly AgentToolCatalogEntry[];\n  readonly include: readonly string[];\n  readonly exclude: readonly string[];\n}): MaterializedAgentIntegrationToolConfigDto[] {\n  const selected = new Map<string, SelectedToolState>();\n\n  for (const token of params.include) {\n    applySelection({catalog: params.catalog, selected, token, mode: 'include'});\n  }\n  for (const token of params.exclude) {\n    applySelection({catalog: params.catalog, selected, token, mode: 'exclude'});\n  }\n\n  const tools = params.catalog.flatMap((entry) => {\n    const state = selected.get(entry.id);\n    if (state === undefined) return [];\n    return [materializedTool(state)];\n  });\n  if (tools.length === 0) {\n    throw new AgentIntegrationMaterializationError(\n      'Agent integration selection resolved to no tools',\n    );\n  }\n  return tools;\n}\n\nfunction applySelection(params: {\n  readonly catalog: readonly AgentToolCatalogEntry[];\n  readonly selected: Map<string, SelectedToolState>;\n  readonly token: string;\n  readonly mode: 'include' | 'exclude';\n}): void {\n  if (params.token === '*') {\n    for (const entry of params.catalog) applyEntrySelection(params, entry);\n    return;\n  }\n\n  const match = findCatalogSelection(params.catalog, params.token);\n  if (match === undefined) {\n    throw new AgentIntegrationMaterializationError(`Unknown integration tool: ${params.token}`);\n  }\n  applyEntrySelection(params, match.entry, match.method);\n}\n\nfunction applyEntrySelection(\n  params: {\n    readonly selected: Map<string, SelectedToolState>;\n    readonly token: string;\n    readonly mode: 'include' | 'exclude';\n  },\n  entry: AgentToolCatalogEntry,\n  method?: AgentToolCatalogMethod | undefined,\n): void {\n  if (params.mode === 'exclude') {\n    excludeEntrySelection(params.selected, entry, method);\n    return;\n  }\n\n  const state =\n    params.selected.get(entry.id) ??\n    ({entry, methods: new Map(), selectedStandalone: false} satisfies SelectedToolState);\n  if (entry.methods === undefined) {\n    state.selectedStandalone = true;\n  } else if (method === undefined) {\n    for (const candidate of entry.methods) state.methods.set(candidate.id, candidate);\n  } else {\n    state.methods.set(method.id, method);\n  }\n  params.selected.set(entry.id, state);\n}\n\nfunction excludeEntrySelection(\n  selected: Map<string, SelectedToolState>,\n  entry: AgentToolCatalogEntry,\n  method?: AgentToolCatalogMethod | undefined,\n): void {\n  if (method === undefined) {\n    selected.delete(entry.id);\n    return;\n  }\n\n  const state = selected.get(entry.id);\n  if (state === undefined) return;\n  state.methods.delete(method.id);\n  if (!state.selectedStandalone && state.methods.size === 0) selected.delete(entry.id);\n}\n\nfunction findCatalogSelection(\n  catalog: readonly AgentToolCatalogEntry[],\n  token: string,\n):\n  | {readonly entry: AgentToolCatalogEntry; readonly method?: AgentToolCatalogMethod | undefined}\n  | undefined {\n  const entry = catalog.find((candidate) => candidate.id === token);\n  if (entry !== undefined) return {entry};\n\n  const wildcardSuffix = '.*';\n  if (token.endsWith(wildcardSuffix)) {\n    const family = token.slice(0, -wildcardSuffix.length);\n    const familyEntry = catalog.find((candidate) => candidate.id === family);\n    return familyEntry === undefined ? undefined : {entry: familyEntry};\n  }\n\n  const dotIndex = token.indexOf('.');\n  if (dotIndex < 1) return undefined;\n  const family = token.slice(0, dotIndex);\n  const methodId = token.slice(dotIndex + 1);\n  const familyEntry = catalog.find((candidate) => candidate.id === family);\n  const method = familyEntry?.methods?.find((candidate) => candidate.id === methodId);\n  if (familyEntry === undefined || method === undefined) return undefined;\n  return {entry: familyEntry, method};\n}\n\nfunction materializedTool(state: SelectedToolState): MaterializedAgentIntegrationToolConfigDto {\n  if (state.entry.methods === undefined) {\n    return {\n      id: state.entry.id,\n      sensitivity: state.entry.sensitivity,\n      sensitive: state.entry.sensitive,\n      requiredScope: normalizeRequiredScope(state.entry.requiredScope),\n      inputSchema: state.entry.inputSchema,\n      ...(state.entry.outputSchema === undefined ? {} : {outputSchema: state.entry.outputSchema}),\n    };\n  }\n\n  const methods = state.entry.methods\n    .filter((method) => state.methods.has(method.id))\n    .map((method) => ({\n      id: method.id,\n      token: `${state.entry.id}.${method.id}`,\n      description: method.description,\n      sensitivity: method.sensitivity,\n      sensitive: method.sensitive,\n      requiredScope: normalizeRequiredScope(method.requiredScope),\n    }));\n\n  return {\n    id: state.entry.id,\n    sensitivity: methods.some((method) => method.sensitivity === 'write') ? 'write' : 'read',\n    sensitive: methods.some((method) => method.sensitive),\n    requiredScope: mergeRequiredScopes(methods.map((method) => method.requiredScope)),\n    inputSchema: state.entry.inputSchema,\n    ...(state.entry.outputSchema === undefined ? {} : {outputSchema: state.entry.outputSchema}),\n    methods,\n  };\n}\n\nfunction mergeRequiredScopes(scopes: readonly unknown[]): unknown[] {\n  const items = scopes.flatMap(normalizeRequiredScope);\n  if (items.every(isPermissionScope)) {\n    const byPermission = new Map<string, 'read' | 'write'>();\n    for (const item of items) {\n      const existing = byPermission.get(item.permission);\n      if (existing === 'write') continue;\n      byPermission.set(item.permission, item.access);\n    }\n    return [...byPermission.entries()].map(([permission, access]) => ({permission, access}));\n  }\n\n  const deduped = new Map<string, unknown>();\n  for (const item of items) deduped.set(JSON.stringify(item), item);\n  return [...deduped.values()];\n}\n\nfunction normalizeRequiredScope(scope: unknown): unknown[] {\n  return Array.isArray(scope) ? [...scope] : [scope];\n}\n\nfunction isPermissionScope(\n  value: unknown,\n): value is {permission: string; access: 'read' | 'write'} {\n  if (typeof value !== 'object' || value === null) return false;\n  const candidate = value as {permission?: unknown; access?: unknown};\n  return (\n    typeof candidate.permission === 'string' &&\n    (candidate.access === 'read' || candidate.access === 'write')\n  );\n}\n\nfunction modelHasAgentStepIntegrations(\n  model: WorkflowModel | null,\n  jobs: readonly WorkflowModelJob[] | undefined,\n): boolean {\n  if (model === null) return false;\n  return (jobs ?? model.jobs).some((job) =>\n    job.steps.some((step) => step.kind === 'agent' && step.integrations !== undefined),\n  );\n}\n"],"names":["AgentIntegrationMaterializationError","loadAgentToolMaterializationContext","params","modelHasAgentStepIntegrations","model","jobs","undefined","projects","project","getProjectById","projectId","integrations","context","getAgentToolsContext","workspaceId","defaultConnectionId","sourceConnectionId","workspaceConnectionSnapshot","Map","workspaceConnections","map","slug","connection","defaultConnection","catalogs","provider","tools","id","materializeAgentIntegrations","snapshot","findSnapshotStep","copyMaterializedIntegration","integration","materializeAgentIntegration","createAgentToolMaterializationSnapshot","steps","flatMap","job","step","kind","jobKey","key","stepId","length","find","resolveConnection","catalog","get","selectTools","include","exclude","requiredScope","mergeRequiredScopes","tool","connectionId","connectionSlug","methods","method","selected","token","applySelection","mode","entry","state","materializedTool","applyEntrySelection","match","findCatalogSelection","excludeEntrySelection","selectedStandalone","candidate","set","delete","size","wildcardSuffix","endsWith","family","slice","familyEntry","dotIndex","indexOf","methodId","sensitivity","sensitive","normalizeRequiredScope","inputSchema","outputSchema","filter","has","description","some","scopes","items","every","isPermissionScope","byPermission","item","existing","permission","access","entries","deduped","JSON","stringify","values","scope","Array","isArray","value"],"mappings":"AAYA,SAAQA,oCAAoC,QAAO,cAAc;AAyCjE,OAAO,eAAeC,oCAAoCC,MAOzD;IACC,IAAI,CAACC,8BAA8BD,OAAOE,KAAK,EAAEF,OAAOG,IAAI,GAAG,OAAOC;IAEtE,IAAIJ,OAAOK,QAAQ,KAAKD,WAAW;QACjC,MAAM,IAAIN,qCAAqC;IACjD;IACA,MAAM,EAACQ,OAAO,EAAC,GAAG,MAAMN,OAAOK,QAAQ,CAACE,cAAc,CAAC;QAACC,WAAWR,OAAOQ,SAAS;IAAA;IACnF,IAAIF,YAAY,MAAM;QACpB,MAAM,IAAIR,qCACR,CAAC,QAAQ,EAAEE,OAAOQ,SAAS,CAAC,qDAAqD,CAAC;IAEtF;IAEA,IAAIR,OAAOS,YAAY,KAAKL,WAAW;QACrC,MAAM,IAAIN,qCAAqC;IACjD;IACA,MAAMY,UAAU,MAAMV,OAAOS,YAAY,CAACE,oBAAoB,CAAC;QAC7DC,aAAaZ,OAAOY,WAAW;QAC/BC,qBAAqBP,QAAQQ,kBAAkB;IACjD;IACA,MAAMC,8BAA8B,IAAIC,IACtCN,QAAQO,oBAAoB,CAACC,GAAG,CAAC,CAAC,EAACC,IAAI,EAAE,GAAGC,YAAW,GAAK;YAACD;YAAMC;SAAW;IAEhF,MAAMC,oBAAoBX,QAAQW,iBAAiB;IACnD,IAAIA,sBAAsB,MAAM;QAC9B,MAAM,IAAIvB,qCACR,CAAC,kBAAkB,EAAEQ,QAAQQ,kBAAkB,CAAC,qDAAqD,CAAC;IAE1G;IAEA,OAAO;QACLQ,UAAU,IAAIN,IAAIN,QAAQY,QAAQ,CAACJ,GAAG,CAAC,CAAC,EAACK,QAAQ,EAAEC,KAAK,EAAC,GAAK;gBAACD;gBAAUC;aAAM;QAC/ET;QACAM,mBAAmB;YACjBI,IAAIJ,kBAAkBI,EAAE;YACxBN,MAAME,kBAAkBF,IAAI;YAC5BI,UAAUF,kBAAkBE,QAAQ;QACtC;IACF;AACF;AAEA,OAAO,SAASG,6BAA6B1B,MAM5C;IACC,MAAM2B,WAAWC,iBAAiB5B;IAClC,IAAI2B,aAAavB,WAAW,OAAOuB,SAASlB,YAAY,CAACS,GAAG,CAACW;IAC7D,IAAI7B,OAAOS,YAAY,KAAKL,WAAW,OAAOA;IAC9C,IAAIJ,OAAOU,OAAO,KAAKN,WAAW;QAChC,MAAM,IAAIN,qCACR;IAEJ;IACA,MAAM,EAACY,OAAO,EAAC,GAAGV;IAElB,OAAOA,OAAOS,YAAY,CAACS,GAAG,CAAC,CAACY,cAC9BC,4BAA4B;YAACD;YAAapB;QAAO;AAErD;AAEA,OAAO,SAASsB,uCAAuChC,MAGtD;IACC,IAAIA,OAAOU,OAAO,KAAKN,WAAW,OAAO;IAEzC,MAAM6B,QAAQjC,OAAOE,KAAK,CAACC,IAAI,CAAC+B,OAAO,CAAC,CAACC,MACvCA,IAAIF,KAAK,CAACC,OAAO,CAAC,CAACE;YACjB,IAAIA,KAAKC,IAAI,KAAK,WAAWD,KAAK3B,YAAY,KAAKL,WAAW,OAAO,EAAE;YACvE,MAAMK,eAAeiB,6BAA6B;gBAChDY,QAAQH,IAAII,GAAG;gBACfC,QAAQJ,KAAKX,EAAE;gBACfhB,cAAc2B,KAAK3B,YAAY;gBAC/BC,SAASV,OAAOU,OAAO;YACzB;YACA,IAAID,iBAAiBL,WAAW,OAAO,EAAE;YACzC,OAAO;gBACL;oBACEkC,QAAQH,IAAII,GAAG;oBACfC,QAAQJ,KAAKX,EAAE;oBACfhB;gBACF;aACD;QACH;IAGF,OAAOwB,MAAMQ,MAAM,KAAK,IAAI,OAAO;QAACR;IAAK;AAC3C;AAEA,SAASL,iBAAiB5B,MAIzB;IACC,OAAOA,OAAO2B,QAAQ,EAAEM,MAAMS,KAC5B,CAACN,OAASA,KAAKE,MAAM,KAAKtC,OAAOsC,MAAM,IAAIF,KAAKI,MAAM,KAAKxC,OAAOwC,MAAM;AAE5E;AAEA,SAAST,4BAA4B/B,MAGpC;IACC,MAAMoB,aAAauB,kBAAkB3C;IACrC,MAAM4C,UAAU5C,OAAOU,OAAO,CAACY,QAAQ,CAACuB,GAAG,CAACzB,WAAWG,QAAQ;IAC/D,IAAIqB,YAAYxC,WAAW;QACzB,MAAM,IAAIN,qCACR,CAAC,qBAAqB,EAAEsB,WAAWG,QAAQ,CAAC,0BAA0B,CAAC;IAE3E;IAEA,MAAMC,QAAQsB,YAAY;QACxBF;QACAG,SAAS/C,OAAO8B,WAAW,CAACiB,OAAO;QACnCC,SAAShD,OAAO8B,WAAW,CAACkB,OAAO,IAAI,EAAE;IAC3C;IACA,MAAMC,gBAAgBC,oBAAoB1B,MAAMN,GAAG,CAAC,CAACiC,OAASA,KAAKF,aAAa;IAEhF,OAAO;QACLG,cAAchC,WAAWK,EAAE;QAC3B4B,gBAAgBjC,WAAWD,IAAI;QAC/BI,UAAUH,WAAWG,QAAQ;QAC7B0B;QACAzB;IACF;AACF;AAEA,SAASK,4BACPC,WAAkD;IAElD,OAAO;QACL,GAAGA,WAAW;QACdmB,eAAe;eAAInB,YAAYmB,aAAa;SAAC;QAC7CzB,OAAOM,YAAYN,KAAK,CAACN,GAAG,CAAC,CAACiC,OAAU,CAAA;gBACtC,GAAGA,IAAI;gBACPF,eAAe;uBAAIE,KAAKF,aAAa;iBAAC;gBACtC,GAAIE,KAAKG,OAAO,KAAKlD,YACjB,CAAC,IACD;oBACEkD,SAASH,KAAKG,OAAO,CAACpC,GAAG,CAAC,CAACqC,SAAY,CAAA;4BACrC,GAAGA,MAAM;4BACTN,eAAe;mCAAIM,OAAON,aAAa;6BAAC;wBAC1C,CAAA;gBACF,CAAC;YACP,CAAA;IACF;AACF;AAEA,SAASN,kBAAkB3C,MAG1B;IACC,IAAIA,OAAO8B,WAAW,CAACV,UAAU,KAAKhB,WAAW,OAAOJ,OAAOU,OAAO,CAACW,iBAAiB;IAExF,MAAMD,aAAapB,OAAOU,OAAO,CAACK,2BAA2B,CAAC8B,GAAG,CAAC7C,OAAO8B,WAAW,CAACV,UAAU;IAC/F,IAAIA,eAAehB,WAAW;QAC5B,MAAM,IAAIN,qCACR,CAAC,uBAAuB,EAAEE,OAAO8B,WAAW,CAACV,UAAU,CAAC,qDAAqD,CAAC;IAElH;IACA,OAAO;QACLK,IAAIL,WAAWK,EAAE;QACjBN,MAAMnB,OAAO8B,WAAW,CAACV,UAAU;QACnCG,UAAUH,WAAWG,QAAQ;IAC/B;AACF;AAEA,SAASuB,YAAY9C,MAIpB;IACC,MAAMwD,WAAW,IAAIxC;IAErB,KAAK,MAAMyC,SAASzD,OAAO+C,OAAO,CAAE;QAClCW,eAAe;YAACd,SAAS5C,OAAO4C,OAAO;YAAEY;YAAUC;YAAOE,MAAM;QAAS;IAC3E;IACA,KAAK,MAAMF,SAASzD,OAAOgD,OAAO,CAAE;QAClCU,eAAe;YAACd,SAAS5C,OAAO4C,OAAO;YAAEY;YAAUC;YAAOE,MAAM;QAAS;IAC3E;IAEA,MAAMnC,QAAQxB,OAAO4C,OAAO,CAACV,OAAO,CAAC,CAAC0B;QACpC,MAAMC,QAAQL,SAASX,GAAG,CAACe,MAAMnC,EAAE;QACnC,IAAIoC,UAAUzD,WAAW,OAAO,EAAE;QAClC,OAAO;YAAC0D,iBAAiBD;SAAO;IAClC;IACA,IAAIrC,MAAMiB,MAAM,KAAK,GAAG;QACtB,MAAM,IAAI3C,qCACR;IAEJ;IACA,OAAO0B;AACT;AAEA,SAASkC,eAAe1D,MAKvB;IACC,IAAIA,OAAOyD,KAAK,KAAK,KAAK;QACxB,KAAK,MAAMG,SAAS5D,OAAO4C,OAAO,CAAEmB,oBAAoB/D,QAAQ4D;QAChE;IACF;IAEA,MAAMI,QAAQC,qBAAqBjE,OAAO4C,OAAO,EAAE5C,OAAOyD,KAAK;IAC/D,IAAIO,UAAU5D,WAAW;QACvB,MAAM,IAAIN,qCAAqC,CAAC,0BAA0B,EAAEE,OAAOyD,KAAK,EAAE;IAC5F;IACAM,oBAAoB/D,QAAQgE,MAAMJ,KAAK,EAAEI,MAAMT,MAAM;AACvD;AAEA,SAASQ,oBACP/D,MAIC,EACD4D,KAA4B,EAC5BL,MAA2C;IAE3C,IAAIvD,OAAO2D,IAAI,KAAK,WAAW;QAC7BO,sBAAsBlE,OAAOwD,QAAQ,EAAEI,OAAOL;QAC9C;IACF;IAEA,MAAMM,QACJ7D,OAAOwD,QAAQ,CAACX,GAAG,CAACe,MAAMnC,EAAE,KAC3B;QAACmC;QAAON,SAAS,IAAItC;QAAOmD,oBAAoB;IAAK;IACxD,IAAIP,MAAMN,OAAO,KAAKlD,WAAW;QAC/ByD,MAAMM,kBAAkB,GAAG;IAC7B,OAAO,IAAIZ,WAAWnD,WAAW;QAC/B,KAAK,MAAMgE,aAAaR,MAAMN,OAAO,CAAEO,MAAMP,OAAO,CAACe,GAAG,CAACD,UAAU3C,EAAE,EAAE2C;IACzE,OAAO;QACLP,MAAMP,OAAO,CAACe,GAAG,CAACd,OAAO9B,EAAE,EAAE8B;IAC/B;IACAvD,OAAOwD,QAAQ,CAACa,GAAG,CAACT,MAAMnC,EAAE,EAAEoC;AAChC;AAEA,SAASK,sBACPV,QAAwC,EACxCI,KAA4B,EAC5BL,MAA2C;IAE3C,IAAIA,WAAWnD,WAAW;QACxBoD,SAASc,MAAM,CAACV,MAAMnC,EAAE;QACxB;IACF;IAEA,MAAMoC,QAAQL,SAASX,GAAG,CAACe,MAAMnC,EAAE;IACnC,IAAIoC,UAAUzD,WAAW;IACzByD,MAAMP,OAAO,CAACgB,MAAM,CAACf,OAAO9B,EAAE;IAC9B,IAAI,CAACoC,MAAMM,kBAAkB,IAAIN,MAAMP,OAAO,CAACiB,IAAI,KAAK,GAAGf,SAASc,MAAM,CAACV,MAAMnC,EAAE;AACrF;AAEA,SAASwC,qBACPrB,OAAyC,EACzCa,KAAa;IAIb,MAAMG,QAAQhB,QAAQF,IAAI,CAAC,CAAC0B,YAAcA,UAAU3C,EAAE,KAAKgC;IAC3D,IAAIG,UAAUxD,WAAW,OAAO;QAACwD;IAAK;IAEtC,MAAMY,iBAAiB;IACvB,IAAIf,MAAMgB,QAAQ,CAACD,iBAAiB;QAClC,MAAME,SAASjB,MAAMkB,KAAK,CAAC,GAAG,CAACH,eAAe/B,MAAM;QACpD,MAAMmC,cAAchC,QAAQF,IAAI,CAAC,CAAC0B,YAAcA,UAAU3C,EAAE,KAAKiD;QACjE,OAAOE,gBAAgBxE,YAAYA,YAAY;YAACwD,OAAOgB;QAAW;IACpE;IAEA,MAAMC,WAAWpB,MAAMqB,OAAO,CAAC;IAC/B,IAAID,WAAW,GAAG,OAAOzE;IACzB,MAAMsE,SAASjB,MAAMkB,KAAK,CAAC,GAAGE;IAC9B,MAAME,WAAWtB,MAAMkB,KAAK,CAACE,WAAW;IACxC,MAAMD,cAAchC,QAAQF,IAAI,CAAC,CAAC0B,YAAcA,UAAU3C,EAAE,KAAKiD;IACjE,MAAMnB,SAASqB,aAAatB,SAASZ,KAAK,CAAC0B,YAAcA,UAAU3C,EAAE,KAAKsD;IAC1E,IAAIH,gBAAgBxE,aAAamD,WAAWnD,WAAW,OAAOA;IAC9D,OAAO;QAACwD,OAAOgB;QAAarB;IAAM;AACpC;AAEA,SAASO,iBAAiBD,KAAwB;IAChD,IAAIA,MAAMD,KAAK,CAACN,OAAO,KAAKlD,WAAW;QACrC,OAAO;YACLqB,IAAIoC,MAAMD,KAAK,CAACnC,EAAE;YAClBuD,aAAanB,MAAMD,KAAK,CAACoB,WAAW;YACpCC,WAAWpB,MAAMD,KAAK,CAACqB,SAAS;YAChChC,eAAeiC,uBAAuBrB,MAAMD,KAAK,CAACX,aAAa;YAC/DkC,aAAatB,MAAMD,KAAK,CAACuB,WAAW;YACpC,GAAItB,MAAMD,KAAK,CAACwB,YAAY,KAAKhF,YAAY,CAAC,IAAI;gBAACgF,cAAcvB,MAAMD,KAAK,CAACwB,YAAY;YAAA,CAAC;QAC5F;IACF;IAEA,MAAM9B,UAAUO,MAAMD,KAAK,CAACN,OAAO,CAChC+B,MAAM,CAAC,CAAC9B,SAAWM,MAAMP,OAAO,CAACgC,GAAG,CAAC/B,OAAO9B,EAAE,GAC9CP,GAAG,CAAC,CAACqC,SAAY,CAAA;YAChB9B,IAAI8B,OAAO9B,EAAE;YACbgC,OAAO,GAAGI,MAAMD,KAAK,CAACnC,EAAE,CAAC,CAAC,EAAE8B,OAAO9B,EAAE,EAAE;YACvC8D,aAAahC,OAAOgC,WAAW;YAC/BP,aAAazB,OAAOyB,WAAW;YAC/BC,WAAW1B,OAAO0B,SAAS;YAC3BhC,eAAeiC,uBAAuB3B,OAAON,aAAa;QAC5D,CAAA;IAEF,OAAO;QACLxB,IAAIoC,MAAMD,KAAK,CAACnC,EAAE;QAClBuD,aAAa1B,QAAQkC,IAAI,CAAC,CAACjC,SAAWA,OAAOyB,WAAW,KAAK,WAAW,UAAU;QAClFC,WAAW3B,QAAQkC,IAAI,CAAC,CAACjC,SAAWA,OAAO0B,SAAS;QACpDhC,eAAeC,oBAAoBI,QAAQpC,GAAG,CAAC,CAACqC,SAAWA,OAAON,aAAa;QAC/EkC,aAAatB,MAAMD,KAAK,CAACuB,WAAW;QACpC,GAAItB,MAAMD,KAAK,CAACwB,YAAY,KAAKhF,YAAY,CAAC,IAAI;YAACgF,cAAcvB,MAAMD,KAAK,CAACwB,YAAY;QAAA,CAAC;QAC1F9B;IACF;AACF;AAEA,SAASJ,oBAAoBuC,MAA0B;IACrD,MAAMC,QAAQD,OAAOvD,OAAO,CAACgD;IAC7B,IAAIQ,MAAMC,KAAK,CAACC,oBAAoB;QAClC,MAAMC,eAAe,IAAI7E;QACzB,KAAK,MAAM8E,QAAQJ,MAAO;YACxB,MAAMK,WAAWF,aAAahD,GAAG,CAACiD,KAAKE,UAAU;YACjD,IAAID,aAAa,SAAS;YAC1BF,aAAaxB,GAAG,CAACyB,KAAKE,UAAU,EAAEF,KAAKG,MAAM;QAC/C;QACA,OAAO;eAAIJ,aAAaK,OAAO;SAAG,CAAChF,GAAG,CAAC,CAAC,CAAC8E,YAAYC,OAAO,GAAM,CAAA;gBAACD;gBAAYC;YAAM,CAAA;IACvF;IAEA,MAAME,UAAU,IAAInF;IACpB,KAAK,MAAM8E,QAAQJ,MAAOS,QAAQ9B,GAAG,CAAC+B,KAAKC,SAAS,CAACP,OAAOA;IAC5D,OAAO;WAAIK,QAAQG,MAAM;KAAG;AAC9B;AAEA,SAASpB,uBAAuBqB,KAAc;IAC5C,OAAOC,MAAMC,OAAO,CAACF,SAAS;WAAIA;KAAM,GAAG;QAACA;KAAM;AACpD;AAEA,SAASX,kBACPc,KAAc;IAEd,IAAI,OAAOA,UAAU,YAAYA,UAAU,MAAM,OAAO;IACxD,MAAMtC,YAAYsC;IAClB,OACE,OAAOtC,UAAU4B,UAAU,KAAK,YAC/B5B,CAAAA,UAAU6B,MAAM,KAAK,UAAU7B,UAAU6B,MAAM,KAAK,OAAM;AAE/D;AAEA,SAAShG,8BACPC,KAA2B,EAC3BC,IAA6C;IAE7C,IAAID,UAAU,MAAM,OAAO;IAC3B,OAAO,AAACC,CAAAA,QAAQD,MAAMC,IAAI,AAAD,EAAGqF,IAAI,CAAC,CAACrD,MAChCA,IAAIF,KAAK,CAACuD,IAAI,CAAC,CAACpD,OAASA,KAAKC,IAAI,KAAK,WAAWD,KAAK3B,YAAY,KAAKL;AAE5E"}

package/dist/core/checkout.d.ts

@@ -1,4 +1,5 @@
-import type { CheckoutSpec, IntegrationSourceControlService } from '@shipfox/api-integration-core';
+import type { IntegrationsModuleClient } from '@shipfox/api-integration-core-dto';
+import type { ProjectsModuleClient } from '@shipfox/api-projects-dto';
 export interface CheckoutIntent {
     workspaceId: string;
     connectionId: string;
@@ -13,17 +14,30 @@ export interface CheckoutIntent {
  * (`workflowRunId`/`workflowRunAttemptId`/`workspaceId` in the lease claim are informational).
  * Chain: job → attempt → run → project source metadata. Credential-free.
  */
-export declare function resolveCheckoutIntent(jobId: string): Promise<CheckoutIntent>;
+export declare function resolveCheckoutIntent(jobId: string, projects: ProjectsModuleClient): Promise<CheckoutIntent>;
 /**
  * Resolves the job's checkout intent and exchanges it for a short-lived,
- * scoped checkout spec. `ref` is left undefined so the provider defaults to the
- * repository's default branch.
+ * scoped checkout spec. Omitting `ref` lets the provider use the repository's
+ * default branch while preserving the JSON-only inter-module boundary.
  */
-export declare function createJobCheckoutSpec({ jobId, sourceControl, }: {
+export declare function createJobCheckoutSpec({ jobId, integrations, projects, }: {
     jobId: string;
-    sourceControl: IntegrationSourceControlService;
+    integrations: IntegrationsModuleClient;
+    projects: ProjectsModuleClient;
 }): Promise<{
-    spec: CheckoutSpec;
+    spec: {
+        repositoryUrl: string;
+        ref: string;
+        credentials?: {
+            username: string;
+            token: string;
+            expiresAt: Date;
+        };
+        gitAuthor?: {
+            name: string;
+            email: string;
+        };
+    };
     persistCredentials: boolean;
 }>;
 //# sourceMappingURL=checkout.d.ts.map