@shipfox/api-integration-core 12.4.0 → 12.6.0

package/.turbo/turbo-build.log

@@ -1,6 +1,6 @@
 $ shipfox-swc && shipfox-temporal-bundle dist/temporal/workflows/index.js
-Successfully compiled: 54 files with swc (614.81ms)
-2026-08-08T09:17:35.462Z [INFO] asset workflow-bundle-e0d869d865fd59433325.js 3.17 MiB [emitted] [immutable] (name: main)
+Successfully compiled: 54 files with swc (470.87ms)
+2026-08-10T11:40:57.271Z [INFO] asset workflow-bundle-e0d869d865fd59433325.js 3.17 MiB [emitted] [immutable] (name: main)
 orphan modules 33.5 KiB [orphan] 21 modules
 runtime modules 1.13 KiB 5 modules
 modules by path ../../../../node_modules/.pnpm/ 970 KiB 196 modules
@@ -15,6 +15,6 @@ 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]
 ../../../shared/node/temporal/dist/workflow-error-interceptor.js 1.21 KiB [built] [code generated]
-webpack 5.107.2 compiled successfully in 9013 ms
-2026-08-08T09:17:35.479Z [INFO] Workflow bundle created { size: '3.17MB' }
+webpack 5.107.2 compiled successfully in 7525 ms
+2026-08-10T11:40:57.305Z [INFO] Workflow bundle created { size: '3.17MB' }
 /home/runner/work/shipfox/shipfox/libs/api/integration/core/dist/temporal/workflows/index.js: 3328998 bytes

package/CHANGELOG.md

@@ -1,5 +1,37 @@
 # @shipfox/api-integration-core
 
+## 12.6.0
+
+### Patch Changes
+
+- 8aaed9e: Record bounded integration tool error details in audit logs and metrics.
+- Updated dependencies [8aaed9e]
+- Updated dependencies [4848ad7]
+- Updated dependencies [594cdbe]
+- Updated dependencies [53b87f0]
+  - @shipfox/api-integration-github@12.6.0
+  - @shipfox/api-workflows-dto@12.6.0
+
+## 12.5.0
+
+### Patch Changes
+
+- f2b20af: Preserve GitHub provider rejection details and classify terminal agent-tool failures without reporting them as provider outages.
+- Updated dependencies [420ef97]
+- Updated dependencies [f2b20af]
+- Updated dependencies [da02bd8]
+- Updated dependencies [4fa3667]
+- Updated dependencies [5b1838c]
+  - @shipfox/api-integration-github@12.5.0
+  - @shipfox/api-integration-spi@1.1.1
+  - @shipfox/api-workflows-dto@12.5.0
+  - @shipfox/api-integration-gitea@12.5.0
+  - @shipfox/api-integration-jira@12.5.0
+  - @shipfox/api-integration-linear@12.5.0
+  - @shipfox/api-integration-sentry@12.5.0
+  - @shipfox/api-integration-slack@12.5.0
+  - @shipfox/api-integration-webhook@12.5.0
+
 ## 12.4.0
 
 ### Patch Changes

package/dist/metrics/instance.d.ts

@@ -1,8 +1,13 @@
+import type { IntegrationProviderErrorReason } from '@shipfox/api-integration-spi';
 export type IntegrationAgentToolCallOutcome = 'success' | 'tool-error' | 'invalid-request' | 'exception';
+export type IntegrationAgentToolCallErrorCode = 'invalid-request' | 'unknown' | 'provider-timeout' | 'credentials-unavailable' | IntegrationProviderErrorReason;
+export type IntegrationAgentToolCallErrorLabel = IntegrationAgentToolCallErrorCode | 'none';
 export declare function recordIntegrationAgentToolCall(params: {
     provider: string;
     tool: string;
     method: string;
     outcome: IntegrationAgentToolCallOutcome;
+    error_code: IntegrationAgentToolCallErrorLabel;
 }): void;
+export declare function normalizeIntegrationAgentToolCallErrorCode(value: unknown): IntegrationAgentToolCallErrorCode;
 //# sourceMappingURL=instance.d.ts.map

package/dist/metrics/instance.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"instance.d.ts","sourceRoot":"","sources":["../../src/metrics/instance.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,+BAA+B,GACvC,SAAS,GACT,YAAY,GACZ,iBAAiB,GACjB,WAAW,CAAC;AAmBhB,wBAAgB,8BAA8B,CAAC,MAAM,EAAE;IACrD,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,+BAA+B,CAAC;CAC1C,GAAG,IAAI,CAEP"}
+{"version":3,"file":"instance.d.ts","sourceRoot":"","sources":["../../src/metrics/instance.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,8BAA8B,EAAC,MAAM,8BAA8B,CAAC;AAKjF,MAAM,MAAM,+BAA+B,GACvC,SAAS,GACT,YAAY,GACZ,iBAAiB,GACjB,WAAW,CAAC;AAEhB,MAAM,MAAM,iCAAiC,GACzC,iBAAiB,GACjB,SAAS,GACT,kBAAkB,GAClB,yBAAyB,GACzB,8BAA8B,CAAC;AAEnC,MAAM,MAAM,kCAAkC,GAAG,iCAAiC,GAAG,MAAM,CAAC;AAuC5F,wBAAgB,8BAA8B,CAAC,MAAM,EAAE;IACrD,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,+BAA+B,CAAC;IACzC,UAAU,EAAE,kCAAkC,CAAC;CAChD,GAAG,IAAI,CAEP;AAED,wBAAgB,0CAA0C,CACxD,KAAK,EAAE,OAAO,GACb,iCAAiC,CAInC"}

package/dist/metrics/instance.js

@@ -1,7 +1,24 @@
 import { instanceMetrics } from '@shipfox/node-opentelemetry';
 const meter = instanceMetrics.getMeter('integrations');
+const integrationAgentToolCallErrorCodes = new Set([
+    'invalid-request',
+    'unknown',
+    'provider-timeout',
+    'credentials-unavailable',
+    'repository-not-found',
+    'installation-not-found',
+    'file-not-found',
+    'access-denied',
+    'rate-limited',
+    'timeout',
+    'provider-unavailable',
+    'provider-rejected',
+    'malformed-provider-response',
+    'content-too-large',
+    'too-many-files'
+]);
 const agentToolCallCount = meter.createCounter('integrations_agent_tool_call', {
-    description: 'Integration agent tool calls by provider, tool, method, and outcome'
+    description: 'Integration agent tool calls by provider, tool, method, outcome, and bounded error code'
 });
 function recordMetric(record) {
     try {
@@ -13,5 +30,8 @@ function recordMetric(record) {
 export function recordIntegrationAgentToolCall(params) {
     recordMetric(()=>agentToolCallCount.add(1, params));
 }
+export function normalizeIntegrationAgentToolCallErrorCode(value) {
+    return typeof value === 'string' && integrationAgentToolCallErrorCodes.has(value) ? value : 'unknown';
+}
 
 //# sourceMappingURL=instance.js.map

package/dist/metrics/instance.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/metrics/instance.ts"],"sourcesContent":["import {instanceMetrics} from '@shipfox/node-opentelemetry';\n\nconst meter = instanceMetrics.getMeter('integrations');\n\nexport type IntegrationAgentToolCallOutcome =\n  | 'success'\n  | 'tool-error'\n  | 'invalid-request'\n  | 'exception';\n\nconst agentToolCallCount = meter.createCounter<{\n  provider: string;\n  tool: string;\n  method: string;\n  outcome: IntegrationAgentToolCallOutcome;\n}>('integrations_agent_tool_call', {\n  description: 'Integration agent tool calls by provider, tool, method, and outcome',\n});\n\nfunction recordMetric(record: () => void): void {\n  try {\n    record();\n  } catch {\n    // Metrics must not affect integration tool call outcomes.\n  }\n}\n\nexport function recordIntegrationAgentToolCall(params: {\n  provider: string;\n  tool: string;\n  method: string;\n  outcome: IntegrationAgentToolCallOutcome;\n}): void {\n  recordMetric(() => agentToolCallCount.add(1, params));\n}\n"],"names":["instanceMetrics","meter","getMeter","agentToolCallCount","createCounter","description","recordMetric","record","recordIntegrationAgentToolCall","params","add"],"mappings":"AAAA,SAAQA,eAAe,QAAO,8BAA8B;AAE5D,MAAMC,QAAQD,gBAAgBE,QAAQ,CAAC;AAQvC,MAAMC,qBAAqBF,MAAMG,aAAa,CAK3C,gCAAgC;IACjCC,aAAa;AACf;AAEA,SAASC,aAAaC,MAAkB;IACtC,IAAI;QACFA;IACF,EAAE,OAAM;IACN,0DAA0D;IAC5D;AACF;AAEA,OAAO,SAASC,+BAA+BC,MAK9C;IACCH,aAAa,IAAMH,mBAAmBO,GAAG,CAAC,GAAGD;AAC/C"}
+{"version":3,"sources":["../../src/metrics/instance.ts"],"sourcesContent":["import type {IntegrationProviderErrorReason} from '@shipfox/api-integration-spi';\nimport {instanceMetrics} from '@shipfox/node-opentelemetry';\n\nconst meter = instanceMetrics.getMeter('integrations');\n\nexport type IntegrationAgentToolCallOutcome =\n  | 'success'\n  | 'tool-error'\n  | 'invalid-request'\n  | 'exception';\n\nexport type IntegrationAgentToolCallErrorCode =\n  | 'invalid-request'\n  | 'unknown'\n  | 'provider-timeout'\n  | 'credentials-unavailable'\n  | IntegrationProviderErrorReason;\n\nexport type IntegrationAgentToolCallErrorLabel = IntegrationAgentToolCallErrorCode | 'none';\n\nconst integrationAgentToolCallErrorCodes = new Set<string>([\n  'invalid-request',\n  'unknown',\n  'provider-timeout',\n  'credentials-unavailable',\n  'repository-not-found',\n  'installation-not-found',\n  'file-not-found',\n  'access-denied',\n  'rate-limited',\n  'timeout',\n  'provider-unavailable',\n  'provider-rejected',\n  'malformed-provider-response',\n  'content-too-large',\n  'too-many-files',\n]);\n\nconst agentToolCallCount = meter.createCounter<{\n  provider: string;\n  tool: string;\n  method: string;\n  outcome: IntegrationAgentToolCallOutcome;\n  error_code: IntegrationAgentToolCallErrorLabel;\n}>('integrations_agent_tool_call', {\n  description:\n    'Integration agent tool calls by provider, tool, method, outcome, and bounded error code',\n});\n\nfunction recordMetric(record: () => void): void {\n  try {\n    record();\n  } catch {\n    // Metrics must not affect integration tool call outcomes.\n  }\n}\n\nexport function recordIntegrationAgentToolCall(params: {\n  provider: string;\n  tool: string;\n  method: string;\n  outcome: IntegrationAgentToolCallOutcome;\n  error_code: IntegrationAgentToolCallErrorLabel;\n}): void {\n  recordMetric(() => agentToolCallCount.add(1, params));\n}\n\nexport function normalizeIntegrationAgentToolCallErrorCode(\n  value: unknown,\n): IntegrationAgentToolCallErrorCode {\n  return typeof value === 'string' && integrationAgentToolCallErrorCodes.has(value)\n    ? (value as IntegrationAgentToolCallErrorCode)\n    : 'unknown';\n}\n"],"names":["instanceMetrics","meter","getMeter","integrationAgentToolCallErrorCodes","Set","agentToolCallCount","createCounter","description","recordMetric","record","recordIntegrationAgentToolCall","params","add","normalizeIntegrationAgentToolCallErrorCode","value","has"],"mappings":"AACA,SAAQA,eAAe,QAAO,8BAA8B;AAE5D,MAAMC,QAAQD,gBAAgBE,QAAQ,CAAC;AAiBvC,MAAMC,qCAAqC,IAAIC,IAAY;IACzD;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;CACD;AAED,MAAMC,qBAAqBJ,MAAMK,aAAa,CAM3C,gCAAgC;IACjCC,aACE;AACJ;AAEA,SAASC,aAAaC,MAAkB;IACtC,IAAI;QACFA;IACF,EAAE,OAAM;IACN,0DAA0D;IAC5D;AACF;AAEA,OAAO,SAASC,+BAA+BC,MAM9C;IACCH,aAAa,IAAMH,mBAAmBO,GAAG,CAAC,GAAGD;AAC/C;AAEA,OAAO,SAASE,2CACdC,KAAc;IAEd,OAAO,OAAOA,UAAU,YAAYX,mCAAmCY,GAAG,CAACD,SACtEA,QACD;AACN"}

package/dist/presentation/routes/agent-tools-gateway/audit.d.ts

@@ -1,6 +1,7 @@
 import type { LeasedJobContext } from '@shipfox/api-auth-context';
-import { type IntegrationAgentToolCallOutcome, recordIntegrationAgentToolCall } from '#metrics/index.js';
+import { type IntegrationAgentToolCallErrorLabel, type IntegrationAgentToolCallOutcome, recordIntegrationAgentToolCall } from '#metrics/index.js';
 import type { AuthorizedIntegrationTool } from './resolve-authorized-tools.js';
+export type { IntegrationAgentToolCallErrorCode } from '#metrics/index.js';
 export declare const UNKNOWN_TOOL_LABEL = "unknown";
 export declare const NO_METHOD_LABEL = "none";
 export declare const INVALID_METHOD_LABEL = "invalid";
@@ -13,6 +14,8 @@ export interface IntegrationToolCallAuditRecord {
     arguments: unknown;
     method: string;
     outcome: IntegrationAgentToolCallOutcome;
+    errorCode: IntegrationAgentToolCallErrorLabel;
+    providerStatus?: number | undefined;
 }
 export type IntegrationToolCallRecorder = (record: IntegrationToolCallAuditRecord) => void;
 export interface CreateIntegrationToolCallRecorderOptions {

package/dist/presentation/routes/agent-tools-gateway/audit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"audit.d.ts","sourceRoot":"","sources":["../../../../src/presentation/routes/agent-tools-gateway/audit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,gBAAgB,EAAC,MAAM,2BAA2B,CAAC;AAEhE,OAAO,EACL,KAAK,+BAA+B,EACpC,8BAA8B,EAC/B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAC,yBAAyB,EAAC,MAAM,+BAA+B,CAAC;AAE7E,eAAO,MAAM,kBAAkB,YAAY,CAAC;AAC5C,eAAO,MAAM,eAAe,SAAS,CAAC;AACtC,eAAO,MAAM,oBAAoB,YAAY,CAAC;AAE9C,MAAM,WAAW,8BAA8B;IAC7C,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,8BAA8B;IAC7C,cAAc,CAAC,EAAE,yBAAyB,GAAG,SAAS,CAAC;IACvD,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,+BAA+B,CAAC;CAC1C;AAED,MAAM,MAAM,2BAA2B,GAAG,CAAC,MAAM,EAAE,8BAA8B,KAAK,IAAI,CAAC;AAE3F,MAAM,WAAW,wCAAwC;IACvD,YAAY,CAAC,EAAE,OAAO,8BAA8B,GAAG,SAAS,CAAC;IACjE,OAAO,CAAC,EACJ,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,+BAA+B,KAAK,IAAI,CAAC,GACtF,SAAS,CAAC;CACf;AAED,wBAAgB,iCAAiC,CAC/C,KAAK,EAAE,gBAAgB,EACvB,OAAO,GAAE,wCAA6C,GACrD,2BAA2B,CAkC7B;AAED,wBAAgB,iCAAiC,CAAC,KAAK,EAAE,OAAO,GAAG,8BAA8B,CAKhG"}
+{"version":3,"file":"audit.d.ts","sourceRoot":"","sources":["../../../../src/presentation/routes/agent-tools-gateway/audit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,gBAAgB,EAAC,MAAM,2BAA2B,CAAC;AAEhE,OAAO,EACL,KAAK,kCAAkC,EACvC,KAAK,+BAA+B,EACpC,8BAA8B,EAC/B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAC,yBAAyB,EAAC,MAAM,+BAA+B,CAAC;AAE7E,YAAY,EAAC,iCAAiC,EAAC,MAAM,mBAAmB,CAAC;AAEzE,eAAO,MAAM,kBAAkB,YAAY,CAAC;AAC5C,eAAO,MAAM,eAAe,SAAS,CAAC;AACtC,eAAO,MAAM,oBAAoB,YAAY,CAAC;AAE9C,MAAM,WAAW,8BAA8B;IAC7C,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,8BAA8B;IAC7C,cAAc,CAAC,EAAE,yBAAyB,GAAG,SAAS,CAAC;IACvD,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,+BAA+B,CAAC;IACzC,SAAS,EAAE,kCAAkC,CAAC;IAC9C,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACrC;AAED,MAAM,MAAM,2BAA2B,GAAG,CAAC,MAAM,EAAE,8BAA8B,KAAK,IAAI,CAAC;AAE3F,MAAM,WAAW,wCAAwC;IACvD,YAAY,CAAC,EAAE,OAAO,8BAA8B,GAAG,SAAS,CAAC;IACjE,OAAO,CAAC,EACJ,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,+BAA+B,KAAK,IAAI,CAAC,GACtF,SAAS,CAAC;CACf;AAED,wBAAgB,iCAAiC,CAC/C,KAAK,EAAE,gBAAgB,EACvB,OAAO,GAAE,wCAA6C,GACrD,2BAA2B,CAqC7B;AAED,wBAAgB,iCAAiC,CAAC,KAAK,EAAE,OAAO,GAAG,8BAA8B,CAKhG"}

package/dist/presentation/routes/agent-tools-gateway/audit.js

@@ -13,7 +13,8 @@ export function createIntegrationToolCallRecorder(lease, options = {}) {
             provider,
             tool: toolId,
             method: record.method,
-            outcome: record.outcome
+            outcome: record.outcome,
+            error_code: record.errorCode
         });
         logInfo({
             jobId: lease.jobId,
@@ -28,6 +29,10 @@ export function createIntegrationToolCallRecorder(lease, options = {}) {
             toolId,
             method: record.method,
             outcome: record.outcome,
+            errorCode: record.errorCode,
+            ...record.providerStatus === undefined ? {} : {
+                providerStatus: record.providerStatus
+            },
             argumentSummary: summarizeIntegrationToolArguments(record.arguments)
         }, 'integration tool call audited');
     };

package/dist/presentation/routes/agent-tools-gateway/audit.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/presentation/routes/agent-tools-gateway/audit.ts"],"sourcesContent":["import type {LeasedJobContext} from '@shipfox/api-auth-context';\nimport {logger} from '@shipfox/node-opentelemetry';\nimport {\n  type IntegrationAgentToolCallOutcome,\n  recordIntegrationAgentToolCall,\n} from '#metrics/index.js';\nimport type {AuthorizedIntegrationTool} from './resolve-authorized-tools.js';\n\nexport const UNKNOWN_TOOL_LABEL = 'unknown';\nexport const NO_METHOD_LABEL = 'none';\nexport const INVALID_METHOD_LABEL = 'invalid';\n\nexport interface IntegrationToolArgumentSummary {\n  keys: string[];\n  serializedSizeBytes: number;\n}\n\nexport interface IntegrationToolCallAuditRecord {\n  authorizedTool?: AuthorizedIntegrationTool | undefined;\n  arguments: unknown;\n  method: string;\n  outcome: IntegrationAgentToolCallOutcome;\n}\n\nexport type IntegrationToolCallRecorder = (record: IntegrationToolCallAuditRecord) => void;\n\nexport interface CreateIntegrationToolCallRecorderOptions {\n  recordMetric?: typeof recordIntegrationAgentToolCall | undefined;\n  logInfo?:\n    | ((context: Record<string, unknown>, message: 'integration tool call audited') => void)\n    | undefined;\n}\n\nexport function createIntegrationToolCallRecorder(\n  lease: LeasedJobContext,\n  options: CreateIntegrationToolCallRecorderOptions = {},\n): IntegrationToolCallRecorder {\n  const recordMetric = options.recordMetric ?? recordIntegrationAgentToolCall;\n  const logInfo = options.logInfo ?? ((context, message) => logger().info(context, message));\n\n  return (record) => {\n    const provider = record.authorizedTool?.integration.provider ?? UNKNOWN_TOOL_LABEL;\n    const toolId = record.authorizedTool?.tool.id ?? UNKNOWN_TOOL_LABEL;\n\n    recordMetric({\n      provider,\n      tool: toolId,\n      method: record.method,\n      outcome: record.outcome,\n    });\n\n    logInfo(\n      {\n        jobId: lease.jobId,\n        jobExecutionId: lease.jobExecutionId,\n        workflowRunId: lease.workflowRunId,\n        workflowRunAttemptId: lease.workflowRunAttemptId,\n        workspaceId: lease.workspaceId,\n        currentStepId: lease.currentStepId,\n        currentStepAttempt: lease.currentStepAttempt,\n        connectionId: record.authorizedTool?.connection.id,\n        provider,\n        toolId,\n        method: record.method,\n        outcome: record.outcome,\n        argumentSummary: summarizeIntegrationToolArguments(record.arguments),\n      },\n      'integration tool call audited',\n    );\n  };\n}\n\nexport function summarizeIntegrationToolArguments(value: unknown): IntegrationToolArgumentSummary {\n  return {\n    keys: isRecord(value) ? Object.keys(value).sort() : [],\n    serializedSizeBytes: serializedSize(value),\n  };\n}\n\nfunction serializedSize(value: unknown): number {\n  try {\n    return Buffer.byteLength(JSON.stringify(value) ?? '', 'utf8');\n  } catch {\n    return 0;\n  }\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n"],"names":["logger","recordIntegrationAgentToolCall","UNKNOWN_TOOL_LABEL","NO_METHOD_LABEL","INVALID_METHOD_LABEL","createIntegrationToolCallRecorder","lease","options","recordMetric","logInfo","context","message","info","record","provider","authorizedTool","integration","toolId","tool","id","method","outcome","jobId","jobExecutionId","workflowRunId","workflowRunAttemptId","workspaceId","currentStepId","currentStepAttempt","connectionId","connection","argumentSummary","summarizeIntegrationToolArguments","arguments","value","keys","isRecord","Object","sort","serializedSizeBytes","serializedSize","Buffer","byteLength","JSON","stringify","Array","isArray"],"mappings":"AACA,SAAQA,MAAM,QAAO,8BAA8B;AACnD,SAEEC,8BAA8B,QACzB,oBAAoB;AAG3B,OAAO,MAAMC,qBAAqB,UAAU;AAC5C,OAAO,MAAMC,kBAAkB,OAAO;AACtC,OAAO,MAAMC,uBAAuB,UAAU;AAuB9C,OAAO,SAASC,kCACdC,KAAuB,EACvBC,UAAoD,CAAC,CAAC;IAEtD,MAAMC,eAAeD,QAAQC,YAAY,IAAIP;IAC7C,MAAMQ,UAAUF,QAAQE,OAAO,IAAK,CAAA,CAACC,SAASC,UAAYX,SAASY,IAAI,CAACF,SAASC,QAAO;IAExF,OAAO,CAACE;QACN,MAAMC,WAAWD,OAAOE,cAAc,EAAEC,YAAYF,YAAYZ;QAChE,MAAMe,SAASJ,OAAOE,cAAc,EAAEG,KAAKC,MAAMjB;QAEjDM,aAAa;YACXM;YACAI,MAAMD;YACNG,QAAQP,OAAOO,MAAM;YACrBC,SAASR,OAAOQ,OAAO;QACzB;QAEAZ,QACE;YACEa,OAAOhB,MAAMgB,KAAK;YAClBC,gBAAgBjB,MAAMiB,cAAc;YACpCC,eAAelB,MAAMkB,aAAa;YAClCC,sBAAsBnB,MAAMmB,oBAAoB;YAChDC,aAAapB,MAAMoB,WAAW;YAC9BC,eAAerB,MAAMqB,aAAa;YAClCC,oBAAoBtB,MAAMsB,kBAAkB;YAC5CC,cAAchB,OAAOE,cAAc,EAAEe,WAAWX;YAChDL;YACAG;YACAG,QAAQP,OAAOO,MAAM;YACrBC,SAASR,OAAOQ,OAAO;YACvBU,iBAAiBC,kCAAkCnB,OAAOoB,SAAS;QACrE,GACA;IAEJ;AACF;AAEA,OAAO,SAASD,kCAAkCE,KAAc;IAC9D,OAAO;QACLC,MAAMC,SAASF,SAASG,OAAOF,IAAI,CAACD,OAAOI,IAAI,KAAK,EAAE;QACtDC,qBAAqBC,eAAeN;IACtC;AACF;AAEA,SAASM,eAAeN,KAAc;IACpC,IAAI;QACF,OAAOO,OAAOC,UAAU,CAACC,KAAKC,SAAS,CAACV,UAAU,IAAI;IACxD,EAAE,OAAM;QACN,OAAO;IACT;AACF;AAEA,SAASE,SAASF,KAAc;IAC9B,OAAO,OAAOA,UAAU,YAAYA,UAAU,QAAQ,CAACW,MAAMC,OAAO,CAACZ;AACvE"}
+{"version":3,"sources":["../../../../src/presentation/routes/agent-tools-gateway/audit.ts"],"sourcesContent":["import type {LeasedJobContext} from '@shipfox/api-auth-context';\nimport {logger} from '@shipfox/node-opentelemetry';\nimport {\n  type IntegrationAgentToolCallErrorLabel,\n  type IntegrationAgentToolCallOutcome,\n  recordIntegrationAgentToolCall,\n} from '#metrics/index.js';\nimport type {AuthorizedIntegrationTool} from './resolve-authorized-tools.js';\n\nexport type {IntegrationAgentToolCallErrorCode} from '#metrics/index.js';\n\nexport const UNKNOWN_TOOL_LABEL = 'unknown';\nexport const NO_METHOD_LABEL = 'none';\nexport const INVALID_METHOD_LABEL = 'invalid';\n\nexport interface IntegrationToolArgumentSummary {\n  keys: string[];\n  serializedSizeBytes: number;\n}\n\nexport interface IntegrationToolCallAuditRecord {\n  authorizedTool?: AuthorizedIntegrationTool | undefined;\n  arguments: unknown;\n  method: string;\n  outcome: IntegrationAgentToolCallOutcome;\n  errorCode: IntegrationAgentToolCallErrorLabel;\n  providerStatus?: number | undefined;\n}\n\nexport type IntegrationToolCallRecorder = (record: IntegrationToolCallAuditRecord) => void;\n\nexport interface CreateIntegrationToolCallRecorderOptions {\n  recordMetric?: typeof recordIntegrationAgentToolCall | undefined;\n  logInfo?:\n    | ((context: Record<string, unknown>, message: 'integration tool call audited') => void)\n    | undefined;\n}\n\nexport function createIntegrationToolCallRecorder(\n  lease: LeasedJobContext,\n  options: CreateIntegrationToolCallRecorderOptions = {},\n): IntegrationToolCallRecorder {\n  const recordMetric = options.recordMetric ?? recordIntegrationAgentToolCall;\n  const logInfo = options.logInfo ?? ((context, message) => logger().info(context, message));\n\n  return (record) => {\n    const provider = record.authorizedTool?.integration.provider ?? UNKNOWN_TOOL_LABEL;\n    const toolId = record.authorizedTool?.tool.id ?? UNKNOWN_TOOL_LABEL;\n\n    recordMetric({\n      provider,\n      tool: toolId,\n      method: record.method,\n      outcome: record.outcome,\n      error_code: record.errorCode,\n    });\n\n    logInfo(\n      {\n        jobId: lease.jobId,\n        jobExecutionId: lease.jobExecutionId,\n        workflowRunId: lease.workflowRunId,\n        workflowRunAttemptId: lease.workflowRunAttemptId,\n        workspaceId: lease.workspaceId,\n        currentStepId: lease.currentStepId,\n        currentStepAttempt: lease.currentStepAttempt,\n        connectionId: record.authorizedTool?.connection.id,\n        provider,\n        toolId,\n        method: record.method,\n        outcome: record.outcome,\n        errorCode: record.errorCode,\n        ...(record.providerStatus === undefined ? {} : {providerStatus: record.providerStatus}),\n        argumentSummary: summarizeIntegrationToolArguments(record.arguments),\n      },\n      'integration tool call audited',\n    );\n  };\n}\n\nexport function summarizeIntegrationToolArguments(value: unknown): IntegrationToolArgumentSummary {\n  return {\n    keys: isRecord(value) ? Object.keys(value).sort() : [],\n    serializedSizeBytes: serializedSize(value),\n  };\n}\n\nfunction serializedSize(value: unknown): number {\n  try {\n    return Buffer.byteLength(JSON.stringify(value) ?? '', 'utf8');\n  } catch {\n    return 0;\n  }\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n"],"names":["logger","recordIntegrationAgentToolCall","UNKNOWN_TOOL_LABEL","NO_METHOD_LABEL","INVALID_METHOD_LABEL","createIntegrationToolCallRecorder","lease","options","recordMetric","logInfo","context","message","info","record","provider","authorizedTool","integration","toolId","tool","id","method","outcome","error_code","errorCode","jobId","jobExecutionId","workflowRunId","workflowRunAttemptId","workspaceId","currentStepId","currentStepAttempt","connectionId","connection","providerStatus","undefined","argumentSummary","summarizeIntegrationToolArguments","arguments","value","keys","isRecord","Object","sort","serializedSizeBytes","serializedSize","Buffer","byteLength","JSON","stringify","Array","isArray"],"mappings":"AACA,SAAQA,MAAM,QAAO,8BAA8B;AACnD,SAGEC,8BAA8B,QACzB,oBAAoB;AAK3B,OAAO,MAAMC,qBAAqB,UAAU;AAC5C,OAAO,MAAMC,kBAAkB,OAAO;AACtC,OAAO,MAAMC,uBAAuB,UAAU;AAyB9C,OAAO,SAASC,kCACdC,KAAuB,EACvBC,UAAoD,CAAC,CAAC;IAEtD,MAAMC,eAAeD,QAAQC,YAAY,IAAIP;IAC7C,MAAMQ,UAAUF,QAAQE,OAAO,IAAK,CAAA,CAACC,SAASC,UAAYX,SAASY,IAAI,CAACF,SAASC,QAAO;IAExF,OAAO,CAACE;QACN,MAAMC,WAAWD,OAAOE,cAAc,EAAEC,YAAYF,YAAYZ;QAChE,MAAMe,SAASJ,OAAOE,cAAc,EAAEG,KAAKC,MAAMjB;QAEjDM,aAAa;YACXM;YACAI,MAAMD;YACNG,QAAQP,OAAOO,MAAM;YACrBC,SAASR,OAAOQ,OAAO;YACvBC,YAAYT,OAAOU,SAAS;QAC9B;QAEAd,QACE;YACEe,OAAOlB,MAAMkB,KAAK;YAClBC,gBAAgBnB,MAAMmB,cAAc;YACpCC,eAAepB,MAAMoB,aAAa;YAClCC,sBAAsBrB,MAAMqB,oBAAoB;YAChDC,aAAatB,MAAMsB,WAAW;YAC9BC,eAAevB,MAAMuB,aAAa;YAClCC,oBAAoBxB,MAAMwB,kBAAkB;YAC5CC,cAAclB,OAAOE,cAAc,EAAEiB,WAAWb;YAChDL;YACAG;YACAG,QAAQP,OAAOO,MAAM;YACrBC,SAASR,OAAOQ,OAAO;YACvBE,WAAWV,OAAOU,SAAS;YAC3B,GAAIV,OAAOoB,cAAc,KAAKC,YAAY,CAAC,IAAI;gBAACD,gBAAgBpB,OAAOoB,cAAc;YAAA,CAAC;YACtFE,iBAAiBC,kCAAkCvB,OAAOwB,SAAS;QACrE,GACA;IAEJ;AACF;AAEA,OAAO,SAASD,kCAAkCE,KAAc;IAC9D,OAAO;QACLC,MAAMC,SAASF,SAASG,OAAOF,IAAI,CAACD,OAAOI,IAAI,KAAK,EAAE;QACtDC,qBAAqBC,eAAeN;IACtC;AACF;AAEA,SAASM,eAAeN,KAAc;IACpC,IAAI;QACF,OAAOO,OAAOC,UAAU,CAACC,KAAKC,SAAS,CAACV,UAAU,IAAI;IACxD,EAAE,OAAM;QACN,OAAO;IACT;AACF;AAEA,SAASE,SAASF,KAAc;IAC9B,OAAO,OAAOA,UAAU,YAAYA,UAAU,QAAQ,CAACW,MAAMC,OAAO,CAACZ;AACvE"}

package/dist/presentation/routes/agent-tools-gateway/dispatch.d.ts

@@ -1,7 +1,15 @@
+import type { LeasedJobContext } from '@shipfox/api-auth-context';
+import { reportError } from '@shipfox/node-error-monitoring';
+import { logger } from '@shipfox/node-opentelemetry';
 import type { IntegrationProviderRegistry } from '#core/providers/registry.js';
 import type { IntegrationToolDispatcher } from './mcp-server.js';
 export interface CreateIntegrationToolDispatcherParams {
     registry: IntegrationProviderRegistry;
+    lease?: LeasedJobContext | undefined;
 }
-export declare function createIntegrationToolDispatcher(params: CreateIntegrationToolDispatcherParams): IntegrationToolDispatcher;
+export interface IntegrationToolDispatcherDependencies {
+    logger?: typeof logger;
+    reportError?: typeof reportError;
+}
+export declare function createIntegrationToolDispatcher(params: CreateIntegrationToolDispatcherParams, dependencies?: IntegrationToolDispatcherDependencies): IntegrationToolDispatcher;
 //# sourceMappingURL=dispatch.d.ts.map

package/dist/presentation/routes/agent-tools-gateway/dispatch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dispatch.d.ts","sourceRoot":"","sources":["../../../../src/presentation/routes/agent-tools-gateway/dispatch.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAC,2BAA2B,EAAC,MAAM,6BAA6B,CAAC;AAC7E,OAAO,KAAK,EAAC,yBAAyB,EAA+B,MAAM,iBAAiB,CAAC;AAE7F,MAAM,WAAW,qCAAqC;IACpD,QAAQ,EAAE,2BAA2B,CAAC;CACvC;AAKD,wBAAgB,+BAA+B,CAC7C,MAAM,EAAE,qCAAqC,GAC5C,yBAAyB,CAE3B"}
+{"version":3,"file":"dispatch.d.ts","sourceRoot":"","sources":["../../../../src/presentation/routes/agent-tools-gateway/dispatch.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAC,gBAAgB,EAAC,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAC,WAAW,EAAC,MAAM,gCAAgC,CAAC;AAC3D,OAAO,EAAC,MAAM,EAAC,MAAM,6BAA6B,CAAC;AAQnD,OAAO,KAAK,EAAC,2BAA2B,EAAC,MAAM,6BAA6B,CAAC;AAG7E,OAAO,KAAK,EAAC,yBAAyB,EAA+B,MAAM,iBAAiB,CAAC;AAE7F,MAAM,WAAW,qCAAqC;IACpD,QAAQ,EAAE,2BAA2B,CAAC;IACtC,KAAK,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAAC;CACtC;AAED,MAAM,WAAW,qCAAqC;IACpD,MAAM,CAAC,EAAE,OAAO,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,OAAO,WAAW,CAAC;CAClC;AAMD,wBAAgB,+BAA+B,CAC7C,MAAM,EAAE,qCAAqC,EAC7C,YAAY,GAAE,qCAA0C,GACvD,yBAAyB,CAS3B"}

package/dist/presentation/routes/agent-tools-gateway/dispatch.js

@@ -1,12 +1,17 @@
 import { reportError } from '@shipfox/node-error-monitoring';
 import { logger } from '@shipfox/node-opentelemetry';
 import { IntegrationProviderError } from '#core/errors.js';
-const timeoutErrorPattern = /timed?\s*out|timeout/i;
+import { NO_METHOD_LABEL } from './audit.js';
+const timeoutErrorNamePattern = /timed?\s*out|timeout/i;
+const mcpRequestTimeoutMessagePattern = /^MCP error -32001:\s*Request timed out\b/i;
 const credentialErrorNamePattern = /Token|Credential|Secret|AccessToken/;
-export function createIntegrationToolDispatcher(params) {
+export function createIntegrationToolDispatcher(params, dependencies = {}) {
     return (input)=>dispatchIntegrationToolCall({
             ...input,
-            registry: params.registry
+            registry: params.registry,
+            lease: params.lease,
+            logger: dependencies.logger ?? logger,
+            reportError: dependencies.reportError ?? reportError
         });
 }
 async function dispatchIntegrationToolCall(input) {
@@ -26,20 +31,41 @@ async function dispatchIntegrationToolCall(input) {
         });
     } catch (error) {
         const result = errorResult(error);
-        if (result.code === 'provider-unavailable') {
-            logger().error({
+        if (result.code === 'provider-unavailable' || result.code === 'unknown') {
+            input.logger().error({
+                ...toolCallLogContext(input),
                 err: error,
-                provider: input.authorizedTool.integration.provider
-            }, 'Integration agent tool provider was unavailable');
-            reportError(error, {
+                errorCode: result.code,
+                ...result.status === undefined ? {} : {
+                    providerStatus: result.status
+                }
+            }, result.code === 'provider-unavailable' ? 'Integration agent tool provider was unavailable' : 'Integration agent tool call failed');
+            input.reportError(error, {
                 boundary: 'integration.agent-tool'
             });
         }
         return toolError(result);
     } finally{
-        await closeSession(session);
+        await closeSession(session, input.logger, input.reportError);
     }
 }
+function toolCallLogContext(input) {
+    return {
+        ...input.lease === undefined ? {} : {
+            jobId: input.lease.jobId,
+            jobExecutionId: input.lease.jobExecutionId,
+            workflowRunId: input.lease.workflowRunId,
+            workflowRunAttemptId: input.lease.workflowRunAttemptId,
+            workspaceId: input.lease.workspaceId,
+            currentStepId: input.lease.currentStepId,
+            currentStepAttempt: input.lease.currentStepAttempt
+        },
+        connectionId: input.authorizedTool.connection.id,
+        provider: input.authorizedTool.integration.provider,
+        toolId: input.authorizedTool.tool.id,
+        method: input.method ?? NO_METHOD_LABEL
+    };
+}
 function agentToolCatalogEntry(input) {
     const { tool, description, inputSchema, outputSchema } = input.authorizedTool;
     return {
@@ -63,15 +89,15 @@ function agentToolCatalogEntry(input) {
         }
     };
 }
-async function closeSession(session) {
+async function closeSession(session, loggerFactory, reportErrorFn) {
     try {
         await session?.close?.();
     } catch (error) {
         // Cleanup must not mask the tool result returned to the runner.
-        logger().error({
+        loggerFactory().error({
             err: error
         }, 'Failed to close integration agent tool session');
-        reportError(error, {
+        reportErrorFn(error, {
             boundary: 'integration.agent-tool',
             operation: 'close-session'
         });
@@ -81,7 +107,13 @@ function errorResult(error) {
     if (error instanceof IntegrationProviderError) {
         return {
             code: error.reason,
-            message: `Integration provider error: ${error.reason}`
+            message: error.message,
+            ...error.retryAfterSeconds === undefined ? {} : {
+                retryAfterSeconds: error.retryAfterSeconds
+            },
+            ...error.status === undefined ? {} : {
+                status: error.status
+            }
         };
     }
     if (isTimeoutError(error)) {
@@ -97,13 +129,13 @@ function errorResult(error) {
         };
     }
     return {
-        code: 'provider-unavailable',
-        message: 'Integration provider call failed'
+        code: 'unknown',
+        message: 'Integration tool call failed'
     };
 }
 function isTimeoutError(error) {
     if (!(error instanceof Error)) return false;
-    return error.name === 'AbortError' || timeoutErrorPattern.test(error.name) || timeoutErrorPattern.test(error.message);
+    return error.name === 'AbortError' || timeoutErrorNamePattern.test(error.name) || error.name === 'McpError' && mcpRequestTimeoutMessagePattern.test(error.message);
 }
 function isCredentialError(error) {
     if (!(error instanceof Error)) return false;
@@ -119,7 +151,13 @@ function toolError(params) {
             }
         ],
         structuredContent: {
-            code: params.code
+            code: params.code,
+            ...params.retryAfterSeconds === undefined ? {} : {
+                retryAfterSeconds: params.retryAfterSeconds
+            },
+            ...params.status === undefined ? {} : {
+                status: params.status
+            }
         }
     };
 }

package/dist/presentation/routes/agent-tools-gateway/dispatch.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/presentation/routes/agent-tools-gateway/dispatch.ts"],"sourcesContent":["import type {CallToolResult} from '@modelcontextprotocol/sdk/types.js';\nimport {reportError} from '@shipfox/node-error-monitoring';\nimport {logger} from '@shipfox/node-opentelemetry';\nimport {IntegrationProviderError} from '#core/errors.js';\nimport type {\n  AgentToolCatalogEntry,\n  AgentToolCatalogMethod,\n  AgentToolSession,\n  AgentToolsProvider,\n} from '#core/providers/agent-tools.js';\nimport type {IntegrationProviderRegistry} from '#core/providers/registry.js';\nimport type {IntegrationToolDispatcher, IntegrationToolDispatchInput} from './mcp-server.js';\n\nexport interface CreateIntegrationToolDispatcherParams {\n  registry: IntegrationProviderRegistry;\n}\n\nconst timeoutErrorPattern = /timed?\\s*out|timeout/i;\nconst credentialErrorNamePattern = /Token|Credential|Secret|AccessToken/;\n\nexport function createIntegrationToolDispatcher(\n  params: CreateIntegrationToolDispatcherParams,\n): IntegrationToolDispatcher {\n  return (input) => dispatchIntegrationToolCall({...input, registry: params.registry});\n}\n\nasync function dispatchIntegrationToolCall(\n  input: IntegrationToolDispatchInput & {registry: IntegrationProviderRegistry},\n): Promise<CallToolResult> {\n  let session: AgentToolSession<CallToolResult> | undefined;\n\n  try {\n    const adapter = input.registry.getAdapter(\n      input.authorizedTool.integration.provider,\n      'agent_tools',\n    ) as AgentToolsProvider<\n      typeof input.authorizedTool.connection,\n      unknown,\n      typeof input.authorizedTool.integration,\n      CallToolResult\n    >;\n    session = await adapter.openSession({\n      connection: input.authorizedTool.connection,\n      tools: [agentToolCatalogEntry(input)],\n      scope: input.authorizedTool.integration,\n    });\n\n    return await session.call({\n      toolId: input.authorizedTool.tool.id,\n      arguments: input.arguments,\n    });\n  } catch (error) {\n    const result = errorResult(error);\n    if (result.code === 'provider-unavailable') {\n      logger().error(\n        {err: error, provider: input.authorizedTool.integration.provider},\n        'Integration agent tool provider was unavailable',\n      );\n      reportError(error, {boundary: 'integration.agent-tool'});\n    }\n    return toolError(result);\n  } finally {\n    await closeSession(session);\n  }\n}\n\nfunction agentToolCatalogEntry(input: IntegrationToolDispatchInput): AgentToolCatalogEntry {\n  const {tool, description, inputSchema, outputSchema} = input.authorizedTool;\n  return {\n    id: tool.id,\n    description,\n    sensitivity: tool.sensitivity,\n    sensitive: tool.sensitive,\n    requiredScope: tool.requiredScope,\n    inputSchema,\n    ...(outputSchema === undefined ? {} : {outputSchema}),\n    ...(tool.methods === undefined\n      ? {}\n      : {\n          methods: tool.methods.map(\n            (method): AgentToolCatalogMethod => ({\n              id: method.id,\n              description: method.description ?? method.token,\n              sensitivity: method.sensitivity,\n              sensitive: method.sensitive,\n              requiredScope: method.requiredScope,\n            }),\n          ),\n        }),\n  };\n}\n\nasync function closeSession(session: {close?(): Promise<void>} | undefined): Promise<void> {\n  try {\n    await session?.close?.();\n  } catch (error) {\n    // Cleanup must not mask the tool result returned to the runner.\n    logger().error({err: error}, 'Failed to close integration agent tool session');\n    reportError(error, {boundary: 'integration.agent-tool', operation: 'close-session'});\n  }\n}\n\nfunction errorResult(error: unknown): {code: string; message: string} {\n  if (error instanceof IntegrationProviderError) {\n    return {\n      code: error.reason,\n      message: `Integration provider error: ${error.reason}`,\n    };\n  }\n\n  if (isTimeoutError(error)) {\n    return {\n      code: 'provider-timeout',\n      message: 'Integration provider timed out',\n    };\n  }\n\n  if (isCredentialError(error)) {\n    return {\n      code: 'credentials-unavailable',\n      message: 'Integration provider credentials are unavailable',\n    };\n  }\n\n  return {\n    code: 'provider-unavailable',\n    message: 'Integration provider call failed',\n  };\n}\n\nfunction isTimeoutError(error: unknown): boolean {\n  if (!(error instanceof Error)) return false;\n  return (\n    error.name === 'AbortError' ||\n    timeoutErrorPattern.test(error.name) ||\n    timeoutErrorPattern.test(error.message)\n  );\n}\n\nfunction isCredentialError(error: unknown): boolean {\n  if (!(error instanceof Error)) return false;\n  return credentialErrorNamePattern.test(error.name);\n}\n\nfunction toolError(params: {code: string; message: string}): CallToolResult {\n  return {\n    isError: true,\n    content: [{type: 'text', text: params.message}],\n    structuredContent: {code: params.code},\n  };\n}\n"],"names":["reportError","logger","IntegrationProviderError","timeoutErrorPattern","credentialErrorNamePattern","createIntegrationToolDispatcher","params","input","dispatchIntegrationToolCall","registry","session","adapter","getAdapter","authorizedTool","integration","provider","openSession","connection","tools","agentToolCatalogEntry","scope","call","toolId","tool","id","arguments","error","result","errorResult","code","err","boundary","toolError","closeSession","description","inputSchema","outputSchema","sensitivity","sensitive","requiredScope","undefined","methods","map","method","token","close","operation","reason","message","isTimeoutError","isCredentialError","Error","name","test","isError","content","type","text","structuredContent"],"mappings":"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"}
+{"version":3,"sources":["../../../../src/presentation/routes/agent-tools-gateway/dispatch.ts"],"sourcesContent":["import type {CallToolResult} from '@modelcontextprotocol/sdk/types.js';\nimport type {LeasedJobContext} from '@shipfox/api-auth-context';\nimport {reportError} from '@shipfox/node-error-monitoring';\nimport {logger} from '@shipfox/node-opentelemetry';\nimport {IntegrationProviderError} from '#core/errors.js';\nimport type {\n  AgentToolCatalogEntry,\n  AgentToolCatalogMethod,\n  AgentToolSession,\n  AgentToolsProvider,\n} from '#core/providers/agent-tools.js';\nimport type {IntegrationProviderRegistry} from '#core/providers/registry.js';\nimport type {IntegrationAgentToolCallErrorCode} from '#metrics/index.js';\nimport {NO_METHOD_LABEL} from './audit.js';\nimport type {IntegrationToolDispatcher, IntegrationToolDispatchInput} from './mcp-server.js';\n\nexport interface CreateIntegrationToolDispatcherParams {\n  registry: IntegrationProviderRegistry;\n  lease?: LeasedJobContext | undefined;\n}\n\nexport interface IntegrationToolDispatcherDependencies {\n  logger?: typeof logger;\n  reportError?: typeof reportError;\n}\n\nconst timeoutErrorNamePattern = /timed?\\s*out|timeout/i;\nconst mcpRequestTimeoutMessagePattern = /^MCP error -32001:\\s*Request timed out\\b/i;\nconst credentialErrorNamePattern = /Token|Credential|Secret|AccessToken/;\n\nexport function createIntegrationToolDispatcher(\n  params: CreateIntegrationToolDispatcherParams,\n  dependencies: IntegrationToolDispatcherDependencies = {},\n): IntegrationToolDispatcher {\n  return (input) =>\n    dispatchIntegrationToolCall({\n      ...input,\n      registry: params.registry,\n      lease: params.lease,\n      logger: dependencies.logger ?? logger,\n      reportError: dependencies.reportError ?? reportError,\n    });\n}\n\nasync function dispatchIntegrationToolCall(\n  input: IntegrationToolDispatchInput & {\n    registry: IntegrationProviderRegistry;\n    lease?: LeasedJobContext | undefined;\n    logger: typeof logger;\n    reportError: typeof reportError;\n  },\n): Promise<CallToolResult> {\n  let session: AgentToolSession<CallToolResult> | undefined;\n\n  try {\n    const adapter = input.registry.getAdapter(\n      input.authorizedTool.integration.provider,\n      'agent_tools',\n    ) as AgentToolsProvider<\n      typeof input.authorizedTool.connection,\n      unknown,\n      typeof input.authorizedTool.integration,\n      CallToolResult\n    >;\n    session = await adapter.openSession({\n      connection: input.authorizedTool.connection,\n      tools: [agentToolCatalogEntry(input)],\n      scope: input.authorizedTool.integration,\n    });\n\n    return await session.call({\n      toolId: input.authorizedTool.tool.id,\n      arguments: input.arguments,\n    });\n  } catch (error) {\n    const result = errorResult(error);\n    if (result.code === 'provider-unavailable' || result.code === 'unknown') {\n      input.logger().error(\n        {\n          ...toolCallLogContext(input),\n          err: error,\n          errorCode: result.code,\n          ...(result.status === undefined ? {} : {providerStatus: result.status}),\n        },\n        result.code === 'provider-unavailable'\n          ? 'Integration agent tool provider was unavailable'\n          : 'Integration agent tool call failed',\n      );\n      input.reportError(error, {boundary: 'integration.agent-tool'});\n    }\n    return toolError(result);\n  } finally {\n    await closeSession(session, input.logger, input.reportError);\n  }\n}\n\nfunction toolCallLogContext(\n  input: IntegrationToolDispatchInput & {lease?: LeasedJobContext | undefined},\n): Record<string, unknown> {\n  return {\n    ...(input.lease === undefined\n      ? {}\n      : {\n          jobId: input.lease.jobId,\n          jobExecutionId: input.lease.jobExecutionId,\n          workflowRunId: input.lease.workflowRunId,\n          workflowRunAttemptId: input.lease.workflowRunAttemptId,\n          workspaceId: input.lease.workspaceId,\n          currentStepId: input.lease.currentStepId,\n          currentStepAttempt: input.lease.currentStepAttempt,\n        }),\n    connectionId: input.authorizedTool.connection.id,\n    provider: input.authorizedTool.integration.provider,\n    toolId: input.authorizedTool.tool.id,\n    method: input.method ?? NO_METHOD_LABEL,\n  };\n}\n\nfunction agentToolCatalogEntry(input: IntegrationToolDispatchInput): AgentToolCatalogEntry {\n  const {tool, description, inputSchema, outputSchema} = input.authorizedTool;\n  return {\n    id: tool.id,\n    description,\n    sensitivity: tool.sensitivity,\n    sensitive: tool.sensitive,\n    requiredScope: tool.requiredScope,\n    inputSchema,\n    ...(outputSchema === undefined ? {} : {outputSchema}),\n    ...(tool.methods === undefined\n      ? {}\n      : {\n          methods: tool.methods.map(\n            (method): AgentToolCatalogMethod => ({\n              id: method.id,\n              description: method.description ?? method.token,\n              sensitivity: method.sensitivity,\n              sensitive: method.sensitive,\n              requiredScope: method.requiredScope,\n            }),\n          ),\n        }),\n  };\n}\n\nasync function closeSession(\n  session: {close?(): Promise<void>} | undefined,\n  loggerFactory: typeof logger,\n  reportErrorFn: typeof reportError,\n): Promise<void> {\n  try {\n    await session?.close?.();\n  } catch (error) {\n    // Cleanup must not mask the tool result returned to the runner.\n    loggerFactory().error({err: error}, 'Failed to close integration agent tool session');\n    reportErrorFn(error, {boundary: 'integration.agent-tool', operation: 'close-session'});\n  }\n}\n\ninterface IntegrationToolError {\n  code: IntegrationAgentToolCallErrorCode;\n  message: string;\n  retryAfterSeconds?: number | undefined;\n  status?: number | undefined;\n}\n\nfunction errorResult(error: unknown): IntegrationToolError {\n  if (error instanceof IntegrationProviderError) {\n    return {\n      code: error.reason,\n      message: error.message,\n      ...(error.retryAfterSeconds === undefined\n        ? {}\n        : {retryAfterSeconds: error.retryAfterSeconds}),\n      ...(error.status === undefined ? {} : {status: error.status}),\n    };\n  }\n\n  if (isTimeoutError(error)) {\n    return {\n      code: 'provider-timeout',\n      message: 'Integration provider timed out',\n    };\n  }\n\n  if (isCredentialError(error)) {\n    return {\n      code: 'credentials-unavailable',\n      message: 'Integration provider credentials are unavailable',\n    };\n  }\n\n  return {\n    code: 'unknown',\n    message: 'Integration tool call failed',\n  };\n}\n\nfunction isTimeoutError(error: unknown): boolean {\n  if (!(error instanceof Error)) return false;\n  return (\n    error.name === 'AbortError' ||\n    timeoutErrorNamePattern.test(error.name) ||\n    (error.name === 'McpError' && mcpRequestTimeoutMessagePattern.test(error.message))\n  );\n}\n\nfunction isCredentialError(error: unknown): boolean {\n  if (!(error instanceof Error)) return false;\n  return credentialErrorNamePattern.test(error.name);\n}\n\nfunction toolError(params: IntegrationToolError): CallToolResult {\n  return {\n    isError: true,\n    content: [{type: 'text', text: params.message}],\n    structuredContent: {\n      code: params.code,\n      ...(params.retryAfterSeconds === undefined\n        ? {}\n        : {retryAfterSeconds: params.retryAfterSeconds}),\n      ...(params.status === undefined ? {} : {status: params.status}),\n    },\n  };\n}\n"],"names":["reportError","logger","IntegrationProviderError","NO_METHOD_LABEL","timeoutErrorNamePattern","mcpRequestTimeoutMessagePattern","credentialErrorNamePattern","createIntegrationToolDispatcher","params","dependencies","input","dispatchIntegrationToolCall","registry","lease","session","adapter","getAdapter","authorizedTool","integration","provider","openSession","connection","tools","agentToolCatalogEntry","scope","call","toolId","tool","id","arguments","error","result","errorResult","code","toolCallLogContext","err","errorCode","status","undefined","providerStatus","boundary","toolError","closeSession","jobId","jobExecutionId","workflowRunId","workflowRunAttemptId","workspaceId","currentStepId","currentStepAttempt","connectionId","method","description","inputSchema","outputSchema","sensitivity","sensitive","requiredScope","methods","map","token","loggerFactory","reportErrorFn","close","operation","reason","message","retryAfterSeconds","isTimeoutError","isCredentialError","Error","name","test","isError","content","type","text","structuredContent"],"mappings":"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"}

package/dist/presentation/routes/agent-tools-gateway/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/presentation/routes/agent-tools-gateway/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAc,KAAK,UAAU,EAAC,MAAM,uBAAuB,CAAC;AAEnE,OAAO,KAAK,EAAC,2BAA2B,EAAC,MAAM,6BAA6B,CAAC;AAC7E,OAAO,KAAK,EAAC,8BAA8B,EAAC,MAAM,oBAAoB,CAAC;AAIvE,OAAO,EACL,KAAK,qBAAqB,EAE3B,MAAM,+BAA+B,CAAC;AAEvC,YAAY,EAAC,qBAAqB,EAAC,MAAM,+BAA+B,CAAC;AACzE,OAAO,EAAC,oCAAoC,EAAC,MAAM,+BAA+B,CAAC;AAEnF,MAAM,WAAW,mCAAmC;IAClD,mBAAmB,EAAE,qBAAqB,CAAC;IAC3C,QAAQ,EAAE,2BAA2B,CAAC;IACtC,4BAA4B,EAAE,8BAA8B,CAAC;CAC9D;AAED,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,mCAAmC,GAC1C,UAAU,CAiDZ"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/presentation/routes/agent-tools-gateway/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAc,KAAK,UAAU,EAAC,MAAM,uBAAuB,CAAC;AAEnE,OAAO,KAAK,EAAC,2BAA2B,EAAC,MAAM,6BAA6B,CAAC;AAC7E,OAAO,KAAK,EAAC,8BAA8B,EAAC,MAAM,oBAAoB,CAAC;AAIvE,OAAO,EACL,KAAK,qBAAqB,EAE3B,MAAM,+BAA+B,CAAC;AAEvC,YAAY,EAAC,qBAAqB,EAAC,MAAM,+BAA+B,CAAC;AACzE,OAAO,EAAC,oCAAoC,EAAC,MAAM,+BAA+B,CAAC;AAEnF,MAAM,WAAW,mCAAmC;IAClD,mBAAmB,EAAE,qBAAqB,CAAC;IAC3C,QAAQ,EAAE,2BAA2B,CAAC;IACtC,4BAA4B,EAAE,8BAA8B,CAAC;CAC9D;AAED,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,mCAAmC,GAC1C,UAAU,CAgDZ"}

package/dist/presentation/routes/agent-tools-gateway/index.js

@@ -9,9 +9,6 @@ import { buildAgentToolsMcpServer } from './mcp-server.js';
 import { resolveAuthorizedIntegrationTools } from './resolve-authorized-tools.js';
 export { createWorkflowsLeasedAgentStepLoader } from './resolve-authorized-tools.js';
 export function createAgentToolsGatewayRoutes(params) {
-    const dispatchIntegrationToolCall = createIntegrationToolDispatcher({
-        registry: params.registry
-    });
     return {
         prefix: '/runs/jobs/current/integration-tools',
         auth: AUTH_LEASED_JOB,
@@ -21,6 +18,7 @@ export function createAgentToolsGatewayRoutes(params) {
                 path: '/mcp',
                 description: 'Gateway MCP endpoint for integration-backed agent tools',
                 handler: async (request, reply)=>{
+                    const lease = requireLeasedJobContext(request);
                     const authorizedTools = await resolveAuthorizedIntegrationTools({
                         request,
                         loadLeasedAgentStep: params.loadLeasedAgentStep,
@@ -29,8 +27,11 @@ export function createAgentToolsGatewayRoutes(params) {
                     });
                     const server = buildAgentToolsMcpServer({
                         authorizedTools,
-                        dispatch: dispatchIntegrationToolCall,
-                        recordCall: createIntegrationToolCallRecorder(requireLeasedJobContext(request))
+                        dispatch: createIntegrationToolDispatcher({
+                            registry: params.registry,
+                            lease
+                        }),
+                        recordCall: createIntegrationToolCallRecorder(lease)
                     });
                     const transport = new StreamableHTTPServerTransport();
                     await server.connect(transport);

package/dist/presentation/routes/agent-tools-gateway/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/presentation/routes/agent-tools-gateway/index.ts"],"sourcesContent":["import {StreamableHTTPServerTransport} from '@modelcontextprotocol/sdk/server/streamableHttp.js';\nimport type {Transport} from '@modelcontextprotocol/sdk/shared/transport.js';\nimport {AUTH_LEASED_JOB, requireLeasedJobContext} from '@shipfox/api-auth-context';\nimport {reportError} from '@shipfox/node-error-monitoring';\nimport {defineRoute, type RouteGroup} from '@shipfox/node-fastify';\nimport {logger} from '@shipfox/node-opentelemetry';\nimport type {IntegrationProviderRegistry} from '#core/providers/registry.js';\nimport type {GetIntegrationConnectionByIdFn} from '#db/connections.js';\nimport {createIntegrationToolCallRecorder} from './audit.js';\nimport {createIntegrationToolDispatcher} from './dispatch.js';\nimport {buildAgentToolsMcpServer} from './mcp-server.js';\nimport {\n  type LeasedAgentStepLoader,\n  resolveAuthorizedIntegrationTools,\n} from './resolve-authorized-tools.js';\n\nexport type {LeasedAgentStepLoader} from './resolve-authorized-tools.js';\nexport {createWorkflowsLeasedAgentStepLoader} from './resolve-authorized-tools.js';\n\nexport interface CreateAgentToolsGatewayRoutesParams {\n  loadLeasedAgentStep: LeasedAgentStepLoader;\n  registry: IntegrationProviderRegistry;\n  getIntegrationConnectionById: GetIntegrationConnectionByIdFn;\n}\n\nexport function createAgentToolsGatewayRoutes(\n  params: CreateAgentToolsGatewayRoutesParams,\n): RouteGroup {\n  const dispatchIntegrationToolCall = createIntegrationToolDispatcher({registry: params.registry});\n\n  return {\n    prefix: '/runs/jobs/current/integration-tools',\n    auth: AUTH_LEASED_JOB,\n    routes: [\n      defineRoute({\n        method: 'POST',\n        path: '/mcp',\n        description: 'Gateway MCP endpoint for integration-backed agent tools',\n        handler: async (request, reply) => {\n          const authorizedTools = await resolveAuthorizedIntegrationTools({\n            request,\n            loadLeasedAgentStep: params.loadLeasedAgentStep,\n            registry: params.registry,\n            getIntegrationConnectionById: params.getIntegrationConnectionById,\n          });\n          const server = buildAgentToolsMcpServer({\n            authorizedTools,\n            dispatch: dispatchIntegrationToolCall,\n            recordCall: createIntegrationToolCallRecorder(requireLeasedJobContext(request)),\n          });\n          const transport = new StreamableHTTPServerTransport();\n\n          await server.connect(transport as unknown as Transport);\n          reply.raw.on('close', () => {\n            void transport.close().catch((error) => {\n              logger().error({err: error}, 'Failed to close integration agent tool transport');\n              reportError(error, {\n                boundary: 'integration.agent-tool',\n                operation: 'close-transport',\n              });\n            });\n            void server.close().catch((error) => {\n              logger().error({err: error}, 'Failed to close integration agent tool server');\n              reportError(error, {\n                boundary: 'integration.agent-tool',\n                operation: 'close-server',\n              });\n            });\n          });\n\n          reply.hijack();\n          await transport.handleRequest(request.raw, reply.raw, request.body);\n        },\n      }),\n    ],\n  };\n}\n"],"names":["StreamableHTTPServerTransport","AUTH_LEASED_JOB","requireLeasedJobContext","reportError","defineRoute","logger","createIntegrationToolCallRecorder","createIntegrationToolDispatcher","buildAgentToolsMcpServer","resolveAuthorizedIntegrationTools","createWorkflowsLeasedAgentStepLoader","createAgentToolsGatewayRoutes","params","dispatchIntegrationToolCall","registry","prefix","auth","routes","method","path","description","handler","request","reply","authorizedTools","loadLeasedAgentStep","getIntegrationConnectionById","server","dispatch","recordCall","transport","connect","raw","on","close","catch","error","err","boundary","operation","hijack","handleRequest","body"],"mappings":"AAAA,SAAQA,6BAA6B,QAAO,qDAAqD;AAEjG,SAAQC,eAAe,EAAEC,uBAAuB,QAAO,4BAA4B;AACnF,SAAQC,WAAW,QAAO,iCAAiC;AAC3D,SAAQC,WAAW,QAAwB,wBAAwB;AACnE,SAAQC,MAAM,QAAO,8BAA8B;AAGnD,SAAQC,iCAAiC,QAAO,aAAa;AAC7D,SAAQC,+BAA+B,QAAO,gBAAgB;AAC9D,SAAQC,wBAAwB,QAAO,kBAAkB;AACzD,SAEEC,iCAAiC,QAC5B,gCAAgC;AAGvC,SAAQC,oCAAoC,QAAO,gCAAgC;AAQnF,OAAO,SAASC,8BACdC,MAA2C;IAE3C,MAAMC,8BAA8BN,gCAAgC;QAACO,UAAUF,OAAOE,QAAQ;IAAA;IAE9F,OAAO;QACLC,QAAQ;QACRC,MAAMf;QACNgB,QAAQ;YACNb,YAAY;gBACVc,QAAQ;gBACRC,MAAM;gBACNC,aAAa;gBACbC,SAAS,OAAOC,SAASC;oBACvB,MAAMC,kBAAkB,MAAMf,kCAAkC;wBAC9Da;wBACAG,qBAAqBb,OAAOa,mBAAmB;wBAC/CX,UAAUF,OAAOE,QAAQ;wBACzBY,8BAA8Bd,OAAOc,4BAA4B;oBACnE;oBACA,MAAMC,SAASnB,yBAAyB;wBACtCgB;wBACAI,UAAUf;wBACVgB,YAAYvB,kCAAkCJ,wBAAwBoB;oBACxE;oBACA,MAAMQ,YAAY,IAAI9B;oBAEtB,MAAM2B,OAAOI,OAAO,CAACD;oBACrBP,MAAMS,GAAG,CAACC,EAAE,CAAC,SAAS;wBACpB,KAAKH,UAAUI,KAAK,GAAGC,KAAK,CAAC,CAACC;4BAC5B/B,SAAS+B,KAAK,CAAC;gCAACC,KAAKD;4BAAK,GAAG;4BAC7BjC,YAAYiC,OAAO;gCACjBE,UAAU;gCACVC,WAAW;4BACb;wBACF;wBACA,KAAKZ,OAAOO,KAAK,GAAGC,KAAK,CAAC,CAACC;4BACzB/B,SAAS+B,KAAK,CAAC;gCAACC,KAAKD;4BAAK,GAAG;4BAC7BjC,YAAYiC,OAAO;gCACjBE,UAAU;gCACVC,WAAW;4BACb;wBACF;oBACF;oBAEAhB,MAAMiB,MAAM;oBACZ,MAAMV,UAAUW,aAAa,CAACnB,QAAQU,GAAG,EAAET,MAAMS,GAAG,EAAEV,QAAQoB,IAAI;gBACpE;YACF;SACD;IACH;AACF"}
+{"version":3,"sources":["../../../../src/presentation/routes/agent-tools-gateway/index.ts"],"sourcesContent":["import {StreamableHTTPServerTransport} from '@modelcontextprotocol/sdk/server/streamableHttp.js';\nimport type {Transport} from '@modelcontextprotocol/sdk/shared/transport.js';\nimport {AUTH_LEASED_JOB, requireLeasedJobContext} from '@shipfox/api-auth-context';\nimport {reportError} from '@shipfox/node-error-monitoring';\nimport {defineRoute, type RouteGroup} from '@shipfox/node-fastify';\nimport {logger} from '@shipfox/node-opentelemetry';\nimport type {IntegrationProviderRegistry} from '#core/providers/registry.js';\nimport type {GetIntegrationConnectionByIdFn} from '#db/connections.js';\nimport {createIntegrationToolCallRecorder} from './audit.js';\nimport {createIntegrationToolDispatcher} from './dispatch.js';\nimport {buildAgentToolsMcpServer} from './mcp-server.js';\nimport {\n  type LeasedAgentStepLoader,\n  resolveAuthorizedIntegrationTools,\n} from './resolve-authorized-tools.js';\n\nexport type {LeasedAgentStepLoader} from './resolve-authorized-tools.js';\nexport {createWorkflowsLeasedAgentStepLoader} from './resolve-authorized-tools.js';\n\nexport interface CreateAgentToolsGatewayRoutesParams {\n  loadLeasedAgentStep: LeasedAgentStepLoader;\n  registry: IntegrationProviderRegistry;\n  getIntegrationConnectionById: GetIntegrationConnectionByIdFn;\n}\n\nexport function createAgentToolsGatewayRoutes(\n  params: CreateAgentToolsGatewayRoutesParams,\n): RouteGroup {\n  return {\n    prefix: '/runs/jobs/current/integration-tools',\n    auth: AUTH_LEASED_JOB,\n    routes: [\n      defineRoute({\n        method: 'POST',\n        path: '/mcp',\n        description: 'Gateway MCP endpoint for integration-backed agent tools',\n        handler: async (request, reply) => {\n          const lease = requireLeasedJobContext(request);\n          const authorizedTools = await resolveAuthorizedIntegrationTools({\n            request,\n            loadLeasedAgentStep: params.loadLeasedAgentStep,\n            registry: params.registry,\n            getIntegrationConnectionById: params.getIntegrationConnectionById,\n          });\n          const server = buildAgentToolsMcpServer({\n            authorizedTools,\n            dispatch: createIntegrationToolDispatcher({registry: params.registry, lease}),\n            recordCall: createIntegrationToolCallRecorder(lease),\n          });\n          const transport = new StreamableHTTPServerTransport();\n\n          await server.connect(transport as unknown as Transport);\n          reply.raw.on('close', () => {\n            void transport.close().catch((error) => {\n              logger().error({err: error}, 'Failed to close integration agent tool transport');\n              reportError(error, {\n                boundary: 'integration.agent-tool',\n                operation: 'close-transport',\n              });\n            });\n            void server.close().catch((error) => {\n              logger().error({err: error}, 'Failed to close integration agent tool server');\n              reportError(error, {\n                boundary: 'integration.agent-tool',\n                operation: 'close-server',\n              });\n            });\n          });\n\n          reply.hijack();\n          await transport.handleRequest(request.raw, reply.raw, request.body);\n        },\n      }),\n    ],\n  };\n}\n"],"names":["StreamableHTTPServerTransport","AUTH_LEASED_JOB","requireLeasedJobContext","reportError","defineRoute","logger","createIntegrationToolCallRecorder","createIntegrationToolDispatcher","buildAgentToolsMcpServer","resolveAuthorizedIntegrationTools","createWorkflowsLeasedAgentStepLoader","createAgentToolsGatewayRoutes","params","prefix","auth","routes","method","path","description","handler","request","reply","lease","authorizedTools","loadLeasedAgentStep","registry","getIntegrationConnectionById","server","dispatch","recordCall","transport","connect","raw","on","close","catch","error","err","boundary","operation","hijack","handleRequest","body"],"mappings":"AAAA,SAAQA,6BAA6B,QAAO,qDAAqD;AAEjG,SAAQC,eAAe,EAAEC,uBAAuB,QAAO,4BAA4B;AACnF,SAAQC,WAAW,QAAO,iCAAiC;AAC3D,SAAQC,WAAW,QAAwB,wBAAwB;AACnE,SAAQC,MAAM,QAAO,8BAA8B;AAGnD,SAAQC,iCAAiC,QAAO,aAAa;AAC7D,SAAQC,+BAA+B,QAAO,gBAAgB;AAC9D,SAAQC,wBAAwB,QAAO,kBAAkB;AACzD,SAEEC,iCAAiC,QAC5B,gCAAgC;AAGvC,SAAQC,oCAAoC,QAAO,gCAAgC;AAQnF,OAAO,SAASC,8BACdC,MAA2C;IAE3C,OAAO;QACLC,QAAQ;QACRC,MAAMb;QACNc,QAAQ;YACNX,YAAY;gBACVY,QAAQ;gBACRC,MAAM;gBACNC,aAAa;gBACbC,SAAS,OAAOC,SAASC;oBACvB,MAAMC,QAAQpB,wBAAwBkB;oBACtC,MAAMG,kBAAkB,MAAMd,kCAAkC;wBAC9DW;wBACAI,qBAAqBZ,OAAOY,mBAAmB;wBAC/CC,UAAUb,OAAOa,QAAQ;wBACzBC,8BAA8Bd,OAAOc,4BAA4B;oBACnE;oBACA,MAAMC,SAASnB,yBAAyB;wBACtCe;wBACAK,UAAUrB,gCAAgC;4BAACkB,UAAUb,OAAOa,QAAQ;4BAAEH;wBAAK;wBAC3EO,YAAYvB,kCAAkCgB;oBAChD;oBACA,MAAMQ,YAAY,IAAI9B;oBAEtB,MAAM2B,OAAOI,OAAO,CAACD;oBACrBT,MAAMW,GAAG,CAACC,EAAE,CAAC,SAAS;wBACpB,KAAKH,UAAUI,KAAK,GAAGC,KAAK,CAAC,CAACC;4BAC5B/B,SAAS+B,KAAK,CAAC;gCAACC,KAAKD;4BAAK,GAAG;4BAC7BjC,YAAYiC,OAAO;gCACjBE,UAAU;gCACVC,WAAW;4BACb;wBACF;wBACA,KAAKZ,OAAOO,KAAK,GAAGC,KAAK,CAAC,CAACC;4BACzB/B,SAAS+B,KAAK,CAAC;gCAACC,KAAKD;4BAAK,GAAG;4BAC7BjC,YAAYiC,OAAO;gCACjBE,UAAU;gCACVC,WAAW;4BACb;wBACF;oBACF;oBAEAlB,MAAMmB,MAAM;oBACZ,MAAMV,UAAUW,aAAa,CAACrB,QAAQY,GAAG,EAAEX,MAAMW,GAAG,EAAEZ,QAAQsB,IAAI;gBACpE;YACF;SACD;IACH;AACF"}

package/dist/presentation/routes/agent-tools-gateway/mcp-server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-server.d.ts","sourceRoot":"","sources":["../../../../src/presentation/routes/agent-tools-gateway/mcp-server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,MAAM,EAAC,MAAM,2CAA2C,CAAC;AACjE,OAAO,EAEL,KAAK,cAAc,EAEpB,MAAM,oCAAoC,CAAC;AAG5C,OAAO,EAAuB,KAAK,2BAA2B,EAAkB,MAAM,YAAY,CAAC;AACnG,OAAO,KAAK,EACV,yBAAyB,EACzB,4BAA4B,EAC7B,MAAM,+BAA+B,CAAC;AAEvC,MAAM,WAAW,4BAA4B;IAC3C,cAAc,EAAE,yBAAyB,CAAC;IAC1C,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7B;AAED,MAAM,MAAM,yBAAyB,GAAG,CACtC,KAAK,EAAE,4BAA4B,KAChC,OAAO,CAAC,cAAc,CAAC,CAAC;AAE7B,MAAM,WAAW,8BAA8B;IAC7C,eAAe,EAAE,4BAA4B,CAAC;IAC9C,QAAQ,EAAE,yBAAyB,CAAC;IACpC,UAAU,CAAC,EAAE,2BAA2B,GAAG,SAAS,CAAC;CACtD;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,8BAA8B,GAAG,MAAM,CAqFvF"}
+{"version":3,"file":"mcp-server.d.ts","sourceRoot":"","sources":["../../../../src/presentation/routes/agent-tools-gateway/mcp-server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,MAAM,EAAC,MAAM,2CAA2C,CAAC;AACjE,OAAO,EAEL,KAAK,cAAc,EAEpB,MAAM,oCAAoC,CAAC;AAI5C,OAAO,EAGL,KAAK,2BAA2B,EAEjC,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EACV,yBAAyB,EACzB,4BAA4B,EAC7B,MAAM,+BAA+B,CAAC;AAEvC,MAAM,WAAW,4BAA4B;IAC3C,cAAc,EAAE,yBAAyB,CAAC;IAC1C,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7B;AAED,MAAM,MAAM,yBAAyB,GAAG,CACtC,KAAK,EAAE,4BAA4B,KAChC,OAAO,CAAC,cAAc,CAAC,CAAC;AAE7B,MAAM,WAAW,8BAA8B;IAC7C,eAAe,EAAE,4BAA4B,CAAC;IAC9C,QAAQ,EAAE,yBAAyB,CAAC;IACpC,UAAU,CAAC,EAAE,2BAA2B,GAAG,SAAS,CAAC;CACtD;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,8BAA8B,GAAG,MAAM,CA0FvF"}

package/dist/presentation/routes/agent-tools-gateway/mcp-server.js

@@ -2,6 +2,7 @@ import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';
 import { reportError } from '@shipfox/node-error-monitoring';
 import { logger } from '@shipfox/node-opentelemetry';
+import { normalizeIntegrationAgentToolCallErrorCode } from '#metrics/index.js';
 import { INVALID_METHOD_LABEL, NO_METHOD_LABEL } from './audit.js';
 export function buildAgentToolsMcpServer(params) {
     const server = new Server({
@@ -30,7 +31,8 @@ export function buildAgentToolsMcpServer(params) {
             recordToolCall(params.recordCall, {
                 arguments: request.params.arguments ?? {},
                 method: NO_METHOD_LABEL,
-                outcome: 'invalid-request'
+                outcome: 'invalid-request',
+                errorCode: 'invalid-request'
             });
             return toolError(`Unknown integration tool: ${request.params.name}`);
         }
@@ -40,7 +42,8 @@ export function buildAgentToolsMcpServer(params) {
                 authorizedTool,
                 arguments: args,
                 method: NO_METHOD_LABEL,
-                outcome: 'invalid-request'
+                outcome: 'invalid-request',
+                errorCode: 'invalid-request'
             });
             return toolError('Tool arguments must be an object');
         }
@@ -50,7 +53,8 @@ export function buildAgentToolsMcpServer(params) {
                 authorizedTool,
                 arguments: args,
                 method: INVALID_METHOD_LABEL,
-                outcome: 'invalid-request'
+                outcome: 'invalid-request',
+                errorCode: 'invalid-request'
             });
             return toolError(methodValidation.message);
         }
@@ -65,7 +69,8 @@ export function buildAgentToolsMcpServer(params) {
                 authorizedTool,
                 arguments: args,
                 method,
-                outcome: result.isError === true ? 'tool-error' : 'success'
+                outcome: result.isError === true ? 'tool-error' : 'success',
+                ...toolCallErrorDetails(result)
             });
             return result;
         } catch (error) {
@@ -73,13 +78,27 @@ export function buildAgentToolsMcpServer(params) {
                 authorizedTool,
                 arguments: args,
                 method,
-                outcome: 'exception'
+                outcome: 'exception',
+                errorCode: 'unknown'
             });
             throw error;
         }
     });
     return server;
 }
+function toolCallErrorDetails(result) {
+    if (result.isError !== true) return {
+        errorCode: 'none'
+    };
+    const structuredContent = isRecord(result.structuredContent) ? result.structuredContent : undefined;
+    const providerStatus = statusCode(structuredContent?.status);
+    return {
+        errorCode: normalizeIntegrationAgentToolCallErrorCode(structuredContent?.code),
+        ...providerStatus === undefined ? {} : {
+            providerStatus
+        }
+    };
+}
 function recordToolCall(recordCall, record) {
     try {
         recordCall?.(record);
@@ -131,5 +150,8 @@ function toolError(message) {
 function isRecord(value) {
     return typeof value === 'object' && value !== null && !Array.isArray(value);
 }
+function statusCode(value) {
+    return typeof value === 'number' && Number.isInteger(value) && value >= 100 && value <= 599 ? value : undefined;
+}
 
 //# sourceMappingURL=mcp-server.js.map