@modainteract/moda-interact-shared 0.13.1 → 0.14.1

package/dist/commerce/index.js

@@ -25,11 +25,25 @@ import {
   CommerceToolResultSchema,
   CommerceToolRevisionIdentitySchema,
   CommerceTurnIdentitySchema,
+  ConnectionCommandSchema,
+  ConnectionIssueSchema,
+  ConnectionResultSchema,
+  ConnectionRevisionViewSchema,
+  ConnectionViewSchema,
   ContractVersionSchema,
+  CredentialStatusSchema,
   CurrencySchema,
   DateSchema,
   DetailsSchemaSchema,
   EMPTY_RESPONSE_CONTRACT,
+  ExternalHttpExecutionSchema,
+  ExternalHttpResultDataSchema,
+  ExternalPathSchema,
+  ExternalQueryMappingSchema,
+  ExternalQueryMappingsSchema,
+  ExternalQueryValueSchema,
+  ExternalResponseFormatSchema,
+  FieldProjectionSchema,
   GrantedToolSchema,
   GrantedToolsSchema,
   HashSchema,
@@ -41,12 +55,18 @@ import {
   POLICY_OPERATIONS,
   POLICY_OPERATION_DESCRIPTORS,
   ReferralReasonSchema,
+  ResponseFilterSchema,
+  ResponseProcessingSchema,
   ResponseTemplateSchema,
+  RevisionInputSchema,
   SemverSchema,
   ToolBindingSchema,
   ToolBindingsSchema,
   ToolDescriptorSchema,
   ToolNameSchema,
+  TransformResponseSchema,
+  TransformSampleSchema,
+  VisualResponseProcessingSchema,
   boundedJson,
   canonicalJson,
   capabilityHashInput,
@@ -73,7 +93,7 @@ import {
   validateDefinitionVersion,
   validateSubset,
   verifyResponseContract
-} from "../chunk-OIRLIV5F.js";
+} from "../chunk-WVQWQFVR.js";
 import "../chunk-B6Y3QQLI.js";
 
 // src/commerce/fixtures.ts
@@ -200,11 +220,25 @@ export {
   CommerceToolResultSchema,
   CommerceToolRevisionIdentitySchema,
   CommerceTurnIdentitySchema,
+  ConnectionCommandSchema,
+  ConnectionIssueSchema,
+  ConnectionResultSchema,
+  ConnectionRevisionViewSchema,
+  ConnectionViewSchema,
   ContractVersionSchema,
+  CredentialStatusSchema,
   CurrencySchema,
   DateSchema,
   DetailsSchemaSchema,
   EMPTY_RESPONSE_CONTRACT,
+  ExternalHttpExecutionSchema,
+  ExternalHttpResultDataSchema,
+  ExternalPathSchema,
+  ExternalQueryMappingSchema,
+  ExternalQueryMappingsSchema,
+  ExternalQueryValueSchema,
+  ExternalResponseFormatSchema,
+  FieldProjectionSchema,
   GrantedToolSchema,
   GrantedToolsSchema,
   HashSchema,
@@ -216,12 +250,18 @@ export {
   POLICY_OPERATIONS,
   POLICY_OPERATION_DESCRIPTORS,
   ReferralReasonSchema,
+  ResponseFilterSchema,
+  ResponseProcessingSchema,
   ResponseTemplateSchema,
+  RevisionInputSchema,
   SemverSchema,
   ToolBindingSchema,
   ToolBindingsSchema,
   ToolDescriptorSchema,
   ToolNameSchema,
+  TransformResponseSchema,
+  TransformSampleSchema,
+  VisualResponseProcessingSchema,
   boundedJson,
   canonicalJson,
   capabilityHashInput,

package/dist/commerce/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/commerce/fixtures.ts"],"sourcesContent":["/** Synthetic examples; no provider identity, schema artifact or publication claim. */\nimport type {\n  CommerceManifest,\n  CommerceConversationGrant,\n  CommerceTurnIdentity,\n} from \"./schemas\";\nimport {\n  EMPTY_RESPONSE_CONTRACT,\n  type CommerceFinalResponse,\n} from \"./response\";\nimport type { Digest } from \"./canonical-json\";\nimport { responseContractCanonicalJson } from \"./canonical-json\";\nimport type { ToolDescriptor, CommerceToolDefinition } from \"./definitions\";\nexport const exampleTool: ToolDescriptor = {\n  toolId: \"tool-fixture\",\n  toolRevisionId: \"revision-fixture\",\n  name: \"never_seeded_catalogue_facts\",\n  definitionVersion: \"1.0.0\",\n  description: \"Read synthetic catalogue facts.\",\n  inputSchema: {\n    type: \"object\",\n    properties: { handle: { type: \"string\", minLength: 1, maxLength: 255 } },\n    required: [\"handle\"],\n    additionalProperties: false,\n  },\n};\nexport const exampleDefinition: CommerceToolDefinition = {\n  name: exampleTool.name,\n  definitionVersion: \"1.0.0\",\n  description: exampleTool.description,\n  inputSchema: exampleTool.inputSchema,\n  execution: {\n    kind: \"SHOPIFY_STOREFRONT_QUERY\",\n    executorVersion: \"1.0.0\",\n    apiVersion: \"2026-07\",\n    schemaHash: \"a\".repeat(64),\n    document:\n      \"query ProductDetails($handle: String!) { product(handle: $handle) { title description } }\",\n    operationName: \"ProductDetails\",\n    variables: { handle: { input: \"handle\" } },\n    resultPath: \"product\",\n  },\n  responseTemplate: {\n    kind: \"text\",\n    text: \"{{result.values.title}}: {{result.values.description}}\",\n    unavailable: \"Product details could not be verified.\",\n  },\n};\nexport const exampleTurn: CommerceTurnIdentity = {\n  contractVersion: \"commerce.v1\",\n  shopId: \"shop-fixture\",\n  checkoutRecoveryId: \"recovery-fixture\",\n  conversationId: \"conversation-fixture\",\n  inboundVersion: 1,\n};\nexport function exampleManifest(\n  digest: Digest,\n  withTool = false,\n): CommerceManifest {\n  const capabilities = [\n    {\n      key: \"conversation_core\",\n      revisionId: \"core-revision\",\n      position: 0,\n      promptName: \"commerce/release-fixture/conversation_core/core-revision\",\n      configuration: {},\n      toolDescriptors: withTool ? [structuredClone(exampleTool)] : [],\n    },\n  ];\n  return {\n    contractVersion: \"commerce.v1\",\n    releaseId: \"release-fixture\",\n    runnerCompatibility: \"^1.0.0\",\n    capabilities,\n    selectedCapabilityKeys: [\"conversation_core\"],\n    grantedTools: withTool\n      ? [\n          {\n            toolId: exampleTool.toolId,\n            toolRevisionId: exampleTool.toolRevisionId,\n            toolName: exampleTool.name,\n            definitionVersion: \"1.0.0\",\n            capabilityKeys: [\"conversation_core\"],\n          },\n        ]\n      : [],\n    responseContract: structuredClone(EMPTY_RESPONSE_CONTRACT),\n    responseContractHash: digest(\n      responseContractCanonicalJson(EMPTY_RESPONSE_CONTRACT),\n    ),\n  };\n}\nexport function exampleGrant(\n  manifest: CommerceManifest,\n): CommerceConversationGrant {\n  return {\n    id: \"grant-fixture\",\n    shopId: exampleTurn.shopId,\n    conversationId: exampleTurn.conversationId,\n    initialInboundVersion: 1,\n    releaseId: manifest.releaseId,\n    selectedCapabilityKeys: [...manifest.selectedCapabilityKeys],\n    grantedTools: structuredClone(manifest.grantedTools),\n    runnerVersion: \"1.0.0\",\n    createdAt: \"2026-09-20T00:00:00.000Z\",\n    expiresAt: null,\n  };\n}\nexport const exampleFinal: CommerceFinalResponse = {\n  answerKind: \"REFER_TO_STORE\",\n  replyText:\n    \"I cannot verify that information. Please contact the store directly.\",\n  referralReason: \"INSUFFICIENT_TOOLS\",\n  detectedLanguageTag: null,\n  detectedLanguageConfidence: null,\n  evidenceIds: [],\n  details: {},\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAaO,IAAM,cAA8B;AAAA,EACzC,QAAQ;AAAA,EACR,gBAAgB;AAAA,EAChB,MAAM;AAAA,EACN,mBAAmB;AAAA,EACnB,aAAa;AAAA,EACb,aAAa;AAAA,IACX,MAAM;AAAA,IACN,YAAY,EAAE,QAAQ,EAAE,MAAM,UAAU,WAAW,GAAG,WAAW,IAAI,EAAE;AAAA,IACvE,UAAU,CAAC,QAAQ;AAAA,IACnB,sBAAsB;AAAA,EACxB;AACF;AACO,IAAM,oBAA4C;AAAA,EACvD,MAAM,YAAY;AAAA,EAClB,mBAAmB;AAAA,EACnB,aAAa,YAAY;AAAA,EACzB,aAAa,YAAY;AAAA,EACzB,WAAW;AAAA,IACT,MAAM;AAAA,IACN,iBAAiB;AAAA,IACjB,YAAY;AAAA,IACZ,YAAY,IAAI,OAAO,EAAE;AAAA,IACzB,UACE;AAAA,IACF,eAAe;AAAA,IACf,WAAW,EAAE,QAAQ,EAAE,OAAO,SAAS,EAAE;AAAA,IACzC,YAAY;AAAA,EACd;AAAA,EACA,kBAAkB;AAAA,IAChB,MAAM;AAAA,IACN,MAAM;AAAA,IACN,aAAa;AAAA,EACf;AACF;AACO,IAAM,cAAoC;AAAA,EAC/C,iBAAiB;AAAA,EACjB,QAAQ;AAAA,EACR,oBAAoB;AAAA,EACpB,gBAAgB;AAAA,EAChB,gBAAgB;AAClB;AACO,SAAS,gBACd,QACA,WAAW,OACO;AAClB,QAAM,eAAe;AAAA,IACnB;AAAA,MACE,KAAK;AAAA,MACL,YAAY;AAAA,MACZ,UAAU;AAAA,MACV,YAAY;AAAA,MACZ,eAAe,CAAC;AAAA,MAChB,iBAAiB,WAAW,CAAC,gBAAgB,WAAW,CAAC,IAAI,CAAC;AAAA,IAChE;AAAA,EACF;AACA,SAAO;AAAA,IACL,iBAAiB;AAAA,IACjB,WAAW;AAAA,IACX,qBAAqB;AAAA,IACrB;AAAA,IACA,wBAAwB,CAAC,mBAAmB;AAAA,IAC5C,cAAc,WACV;AAAA,MACE;AAAA,QACE,QAAQ,YAAY;AAAA,QACpB,gBAAgB,YAAY;AAAA,QAC5B,UAAU,YAAY;AAAA,QACtB,mBAAmB;AAAA,QACnB,gBAAgB,CAAC,mBAAmB;AAAA,MACtC;AAAA,IACF,IACA,CAAC;AAAA,IACL,kBAAkB,gBAAgB,uBAAuB;AAAA,IACzD,sBAAsB;AAAA,MACpB,8BAA8B,uBAAuB;AAAA,IACvD;AAAA,EACF;AACF;AACO,SAAS,aACd,UAC2B;AAC3B,SAAO;AAAA,IACL,IAAI;AAAA,IACJ,QAAQ,YAAY;AAAA,IACpB,gBAAgB,YAAY;AAAA,IAC5B,uBAAuB;AAAA,IACvB,WAAW,SAAS;AAAA,IACpB,wBAAwB,CAAC,GAAG,SAAS,sBAAsB;AAAA,IAC3D,cAAc,gBAAgB,SAAS,YAAY;AAAA,IACnD,eAAe;AAAA,IACf,WAAW;AAAA,IACX,WAAW;AAAA,EACb;AACF;AACO,IAAM,eAAsC;AAAA,EACjD,YAAY;AAAA,EACZ,WACE;AAAA,EACF,gBAAgB;AAAA,EAChB,qBAAqB;AAAA,EACrB,4BAA4B;AAAA,EAC5B,aAAa,CAAC;AAAA,EACd,SAAS,CAAC;AACZ;","names":[]}
+{"version":3,"sources":["../../src/commerce/fixtures.ts"],"sourcesContent":["/** Synthetic examples; no provider identity, schema artifact or publication claim. */\nimport type {\n  CommerceManifest,\n  CommerceConversationGrant,\n  CommerceTurnIdentity,\n} from \"./schemas\";\nimport {\n  EMPTY_RESPONSE_CONTRACT,\n  type CommerceFinalResponse,\n} from \"./response\";\nimport type { Digest } from \"./canonical-json\";\nimport { responseContractCanonicalJson } from \"./canonical-json\";\nimport type { ToolDescriptor, CommerceToolDefinition } from \"./definitions\";\nexport const exampleTool: ToolDescriptor = {\n  toolId: \"tool-fixture\",\n  toolRevisionId: \"revision-fixture\",\n  name: \"never_seeded_catalogue_facts\",\n  definitionVersion: \"1.0.0\",\n  description: \"Read synthetic catalogue facts.\",\n  inputSchema: {\n    type: \"object\",\n    properties: { handle: { type: \"string\", minLength: 1, maxLength: 255 } },\n    required: [\"handle\"],\n    additionalProperties: false,\n  },\n};\nexport const exampleDefinition: CommerceToolDefinition = {\n  name: exampleTool.name,\n  definitionVersion: \"1.0.0\",\n  description: exampleTool.description,\n  inputSchema: exampleTool.inputSchema,\n  execution: {\n    kind: \"SHOPIFY_STOREFRONT_QUERY\",\n    executorVersion: \"1.0.0\",\n    apiVersion: \"2026-07\",\n    schemaHash: \"a\".repeat(64),\n    document:\n      \"query ProductDetails($handle: String!) { product(handle: $handle) { title description } }\",\n    operationName: \"ProductDetails\",\n    variables: { handle: { input: \"handle\" } },\n    resultPath: \"product\",\n  },\n  responseTemplate: {\n    kind: \"text\",\n    text: \"{{result.values.title}}: {{result.values.description}}\",\n    unavailable: \"Product details could not be verified.\",\n  },\n};\nexport const exampleTurn: CommerceTurnIdentity = {\n  contractVersion: \"commerce.v1\",\n  shopId: \"shop-fixture\",\n  checkoutRecoveryId: \"recovery-fixture\",\n  conversationId: \"conversation-fixture\",\n  inboundVersion: 1,\n};\nexport function exampleManifest(\n  digest: Digest,\n  withTool = false,\n): CommerceManifest {\n  const capabilities = [\n    {\n      key: \"conversation_core\",\n      revisionId: \"core-revision\",\n      position: 0,\n      promptName: \"commerce/release-fixture/conversation_core/core-revision\",\n      configuration: {},\n      toolDescriptors: withTool ? [structuredClone(exampleTool)] : [],\n    },\n  ];\n  return {\n    contractVersion: \"commerce.v1\",\n    releaseId: \"release-fixture\",\n    runnerCompatibility: \"^1.0.0\",\n    capabilities,\n    selectedCapabilityKeys: [\"conversation_core\"],\n    grantedTools: withTool\n      ? [\n          {\n            toolId: exampleTool.toolId,\n            toolRevisionId: exampleTool.toolRevisionId,\n            toolName: exampleTool.name,\n            definitionVersion: \"1.0.0\",\n            capabilityKeys: [\"conversation_core\"],\n          },\n        ]\n      : [],\n    responseContract: structuredClone(EMPTY_RESPONSE_CONTRACT),\n    responseContractHash: digest(\n      responseContractCanonicalJson(EMPTY_RESPONSE_CONTRACT),\n    ),\n  };\n}\nexport function exampleGrant(\n  manifest: CommerceManifest,\n): CommerceConversationGrant {\n  return {\n    id: \"grant-fixture\",\n    shopId: exampleTurn.shopId,\n    conversationId: exampleTurn.conversationId,\n    initialInboundVersion: 1,\n    releaseId: manifest.releaseId,\n    selectedCapabilityKeys: [...manifest.selectedCapabilityKeys],\n    grantedTools: structuredClone(manifest.grantedTools),\n    runnerVersion: \"1.0.0\",\n    createdAt: \"2026-09-20T00:00:00.000Z\",\n    expiresAt: null,\n  };\n}\nexport const exampleFinal: CommerceFinalResponse = {\n  answerKind: \"REFER_TO_STORE\",\n  replyText:\n    \"I cannot verify that information. Please contact the store directly.\",\n  referralReason: \"INSUFFICIENT_TOOLS\",\n  detectedLanguageTag: null,\n  detectedLanguageConfidence: null,\n  evidenceIds: [],\n  details: {},\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAaO,IAAM,cAA8B;AAAA,EACzC,QAAQ;AAAA,EACR,gBAAgB;AAAA,EAChB,MAAM;AAAA,EACN,mBAAmB;AAAA,EACnB,aAAa;AAAA,EACb,aAAa;AAAA,IACX,MAAM;AAAA,IACN,YAAY,EAAE,QAAQ,EAAE,MAAM,UAAU,WAAW,GAAG,WAAW,IAAI,EAAE;AAAA,IACvE,UAAU,CAAC,QAAQ;AAAA,IACnB,sBAAsB;AAAA,EACxB;AACF;AACO,IAAM,oBAA4C;AAAA,EACvD,MAAM,YAAY;AAAA,EAClB,mBAAmB;AAAA,EACnB,aAAa,YAAY;AAAA,EACzB,aAAa,YAAY;AAAA,EACzB,WAAW;AAAA,IACT,MAAM;AAAA,IACN,iBAAiB;AAAA,IACjB,YAAY;AAAA,IACZ,YAAY,IAAI,OAAO,EAAE;AAAA,IACzB,UACE;AAAA,IACF,eAAe;AAAA,IACf,WAAW,EAAE,QAAQ,EAAE,OAAO,SAAS,EAAE;AAAA,IACzC,YAAY;AAAA,EACd;AAAA,EACA,kBAAkB;AAAA,IAChB,MAAM;AAAA,IACN,MAAM;AAAA,IACN,aAAa;AAAA,EACf;AACF;AACO,IAAM,cAAoC;AAAA,EAC/C,iBAAiB;AAAA,EACjB,QAAQ;AAAA,EACR,oBAAoB;AAAA,EACpB,gBAAgB;AAAA,EAChB,gBAAgB;AAClB;AACO,SAAS,gBACd,QACA,WAAW,OACO;AAClB,QAAM,eAAe;AAAA,IACnB;AAAA,MACE,KAAK;AAAA,MACL,YAAY;AAAA,MACZ,UAAU;AAAA,MACV,YAAY;AAAA,MACZ,eAAe,CAAC;AAAA,MAChB,iBAAiB,WAAW,CAAC,gBAAgB,WAAW,CAAC,IAAI,CAAC;AAAA,IAChE;AAAA,EACF;AACA,SAAO;AAAA,IACL,iBAAiB;AAAA,IACjB,WAAW;AAAA,IACX,qBAAqB;AAAA,IACrB;AAAA,IACA,wBAAwB,CAAC,mBAAmB;AAAA,IAC5C,cAAc,WACV;AAAA,MACE;AAAA,QACE,QAAQ,YAAY;AAAA,QACpB,gBAAgB,YAAY;AAAA,QAC5B,UAAU,YAAY;AAAA,QACtB,mBAAmB;AAAA,QACnB,gBAAgB,CAAC,mBAAmB;AAAA,MACtC;AAAA,IACF,IACA,CAAC;AAAA,IACL,kBAAkB,gBAAgB,uBAAuB;AAAA,IACzD,sBAAsB;AAAA,MACpB,8BAA8B,uBAAuB;AAAA,IACvD;AAAA,EACF;AACF;AACO,SAAS,aACd,UAC2B;AAC3B,SAAO;AAAA,IACL,IAAI;AAAA,IACJ,QAAQ,YAAY;AAAA,IACpB,gBAAgB,YAAY;AAAA,IAC5B,uBAAuB;AAAA,IACvB,WAAW,SAAS;AAAA,IACpB,wBAAwB,CAAC,GAAG,SAAS,sBAAsB;AAAA,IAC3D,cAAc,gBAAgB,SAAS,YAAY;AAAA,IACnD,eAAe;AAAA,IACf,WAAW;AAAA,IACX,WAAW;AAAA,EACb;AACF;AACO,IAAM,eAAsC;AAAA,EACjD,YAAY;AAAA,EACZ,WACE;AAAA,EACF,gBAAgB;AAAA,EAChB,qBAAqB;AAAA,EACrB,4BAA4B;AAAA,EAC5B,aAAa,CAAC;AAAA,EACd,SAAS,CAAC;AACZ;","names":[]}

package/dist/commerce/runner/index.d.ts

@@ -1,4 +1,4 @@
-import { C as CommerceTurnIdentity, a as CommerceConversationGrant, b as CommerceManifest, T as ToolDescriptor, G as GrantedTool, c as CommerceToolResult, D as Digest, d as CommerceFinalResponse } from '../../response-CrhM-N0k.js';
+import { C as CommerceTurnIdentity, a as CommerceConversationGrant, b as CommerceManifest, T as ToolDescriptor, G as GrantedTool, c as CommerceToolResult, D as Digest, d as CommerceFinalResponse } from '../../response-D3LgdEbH.js';
 import 'zod';
 
 declare const runnerVersion = "1.0.0";

package/dist/commerce/runner/index.js

@@ -12,7 +12,7 @@ import {
   jsonBytes,
   manifestMatchesGrant,
   verifyResponseContract
-} from "../../chunk-OIRLIV5F.js";
+} from "../../chunk-WVQWQFVR.js";
 import {
   LanguageSourceSchema
 } from "../../chunk-B6Y3QQLI.js";

package/dist/{response-CrhM-N0k.d.ts → response-D3LgdEbH.d.ts}

@@ -67,6 +67,71 @@ declare const ToolDescriptorSchema: z.ZodObject<{
     inputSchema: z.ZodCustom<SubsetSchema, SubsetSchema>;
 }, z.core.$strict>;
 declare const POLICY_OPERATIONS: readonly ["recovery.getBasket", "shopify.searchProducts", "discounts.getOptions", "discounts.evaluate", "products.findQualifying", "products.findSimilar"];
+declare const ExternalHttpExecutionSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"EXTERNAL_HTTP">;
+    executorVersion: z.ZodLiteral<"1.0.0">;
+    connectionRevisionId: z.ZodString;
+    method: z.ZodLiteral<"GET">;
+    path: z.ZodString;
+    query: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodObject<{
+        input: z.ZodString;
+        omitIfMissing: z.ZodOptional<z.ZodLiteral<true>>;
+    }, z.core.$strict>, z.ZodObject<{
+        literal: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>;
+    }, z.core.$strict>]>>;
+    responseFormat: z.ZodObject<{
+        mode: z.ZodEnum<{
+            JSON: "JSON";
+            TEXT: "TEXT";
+        }>;
+        mediaTypes: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>;
+    resultPath: z.ZodString;
+    responseProcessing: z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodObject<{
+        kind: z.ZodLiteral<"OBJECT">;
+        fields: z.ZodRecord<z.ZodString, z.ZodObject<{
+            path: z.ZodString;
+            omitIfMissing: z.ZodOptional<z.ZodLiteral<true>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"LIST">;
+        fields: z.ZodRecord<z.ZodString, z.ZodObject<{
+            path: z.ZodString;
+            omitIfMissing: z.ZodOptional<z.ZodLiteral<true>>;
+        }, z.core.$strict>>;
+        filters: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            path: z.ZodString;
+            op: z.ZodEnum<{
+                GT: "GT";
+                LT: "LT";
+                NE: "NE";
+                EQ: "EQ";
+                GTE: "GTE";
+                LTE: "LTE";
+                CONTAINS: "CONTAINS";
+                STARTS_WITH: "STARTS_WITH";
+            }>;
+            value: z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>, z.ZodNull]>;
+        }, z.core.$strict>, z.ZodObject<{
+            path: z.ZodString;
+            op: z.ZodLiteral<"IN">;
+            values: z.ZodArray<z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>, z.ZodNull]>>;
+        }, z.core.$strict>], "op">>;
+        sort: z.ZodUnion<readonly [z.ZodNull, z.ZodObject<{
+            path: z.ZodString;
+            direction: z.ZodEnum<{
+                ASC: "ASC";
+                DESC: "DESC";
+            }>;
+        }, z.core.$strict>]>;
+        limit: z.ZodInt;
+    }, z.core.$strict>]>, z.ZodObject<{
+        kind: z.ZodLiteral<"JAVASCRIPT">;
+        runtimeVersion: z.ZodLiteral<"quickjs-sync.v1">;
+        source: z.ZodString;
+    }, z.core.$strict>]>;
+    resultSchema: z.ZodCustom<SubsetSchema, SubsetSchema>;
+}, z.core.$strict>;
 declare const CommerceExecutionSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     kind: z.ZodLiteral<"SHOPIFY_STOREFRONT_QUERY">;
     executorVersion: z.ZodLiteral<"1.0.0">;
@@ -98,7 +163,74 @@ declare const CommerceExecutionSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     }, z.core.$strict>, z.ZodObject<{
         literal: z.ZodUnknown;
     }, z.core.$strict>]>>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"EXTERNAL_HTTP">;
+    executorVersion: z.ZodLiteral<"1.0.0">;
+    connectionRevisionId: z.ZodString;
+    method: z.ZodLiteral<"GET">;
+    path: z.ZodString;
+    query: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodObject<{
+        input: z.ZodString;
+        omitIfMissing: z.ZodOptional<z.ZodLiteral<true>>;
+    }, z.core.$strict>, z.ZodObject<{
+        literal: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>;
+    }, z.core.$strict>]>>;
+    responseFormat: z.ZodObject<{
+        mode: z.ZodEnum<{
+            JSON: "JSON";
+            TEXT: "TEXT";
+        }>;
+        mediaTypes: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>;
+    resultPath: z.ZodString;
+    responseProcessing: z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodObject<{
+        kind: z.ZodLiteral<"OBJECT">;
+        fields: z.ZodRecord<z.ZodString, z.ZodObject<{
+            path: z.ZodString;
+            omitIfMissing: z.ZodOptional<z.ZodLiteral<true>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"LIST">;
+        fields: z.ZodRecord<z.ZodString, z.ZodObject<{
+            path: z.ZodString;
+            omitIfMissing: z.ZodOptional<z.ZodLiteral<true>>;
+        }, z.core.$strict>>;
+        filters: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            path: z.ZodString;
+            op: z.ZodEnum<{
+                GT: "GT";
+                LT: "LT";
+                NE: "NE";
+                EQ: "EQ";
+                GTE: "GTE";
+                LTE: "LTE";
+                CONTAINS: "CONTAINS";
+                STARTS_WITH: "STARTS_WITH";
+            }>;
+            value: z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>, z.ZodNull]>;
+        }, z.core.$strict>, z.ZodObject<{
+            path: z.ZodString;
+            op: z.ZodLiteral<"IN">;
+            values: z.ZodArray<z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>, z.ZodNull]>>;
+        }, z.core.$strict>], "op">>;
+        sort: z.ZodUnion<readonly [z.ZodNull, z.ZodObject<{
+            path: z.ZodString;
+            direction: z.ZodEnum<{
+                ASC: "ASC";
+                DESC: "DESC";
+            }>;
+        }, z.core.$strict>]>;
+        limit: z.ZodInt;
+    }, z.core.$strict>]>, z.ZodObject<{
+        kind: z.ZodLiteral<"JAVASCRIPT">;
+        runtimeVersion: z.ZodLiteral<"quickjs-sync.v1">;
+        source: z.ZodString;
+    }, z.core.$strict>]>;
+    resultSchema: z.ZodCustom<SubsetSchema, SubsetSchema>;
 }, z.core.$strict>], "kind">;
+type ExternalHttpExecution = Extract<z.infer<typeof CommerceExecutionSchema>, {
+    kind: "EXTERNAL_HTTP";
+}>;
 declare const ResponseTemplateSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     kind: z.ZodLiteral<"text">;
     text: z.ZodString;
@@ -143,6 +275,70 @@ declare const CommerceToolDefinitionSchema: z.ZodObject<{
         }, z.core.$strict>, z.ZodObject<{
             literal: z.ZodUnknown;
         }, z.core.$strict>]>>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"EXTERNAL_HTTP">;
+        executorVersion: z.ZodLiteral<"1.0.0">;
+        connectionRevisionId: z.ZodString;
+        method: z.ZodLiteral<"GET">;
+        path: z.ZodString;
+        query: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodObject<{
+            input: z.ZodString;
+            omitIfMissing: z.ZodOptional<z.ZodLiteral<true>>;
+        }, z.core.$strict>, z.ZodObject<{
+            literal: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>;
+        }, z.core.$strict>]>>;
+        responseFormat: z.ZodObject<{
+            mode: z.ZodEnum<{
+                JSON: "JSON";
+                TEXT: "TEXT";
+            }>;
+            mediaTypes: z.ZodArray<z.ZodString>;
+        }, z.core.$strict>;
+        resultPath: z.ZodString;
+        responseProcessing: z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodObject<{
+            kind: z.ZodLiteral<"OBJECT">;
+            fields: z.ZodRecord<z.ZodString, z.ZodObject<{
+                path: z.ZodString;
+                omitIfMissing: z.ZodOptional<z.ZodLiteral<true>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"LIST">;
+            fields: z.ZodRecord<z.ZodString, z.ZodObject<{
+                path: z.ZodString;
+                omitIfMissing: z.ZodOptional<z.ZodLiteral<true>>;
+            }, z.core.$strict>>;
+            filters: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                path: z.ZodString;
+                op: z.ZodEnum<{
+                    GT: "GT";
+                    LT: "LT";
+                    NE: "NE";
+                    EQ: "EQ";
+                    GTE: "GTE";
+                    LTE: "LTE";
+                    CONTAINS: "CONTAINS";
+                    STARTS_WITH: "STARTS_WITH";
+                }>;
+                value: z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>, z.ZodNull]>;
+            }, z.core.$strict>, z.ZodObject<{
+                path: z.ZodString;
+                op: z.ZodLiteral<"IN">;
+                values: z.ZodArray<z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>, z.ZodNull]>>;
+            }, z.core.$strict>], "op">>;
+            sort: z.ZodUnion<readonly [z.ZodNull, z.ZodObject<{
+                path: z.ZodString;
+                direction: z.ZodEnum<{
+                    ASC: "ASC";
+                    DESC: "DESC";
+                }>;
+            }, z.core.$strict>]>;
+            limit: z.ZodInt;
+        }, z.core.$strict>]>, z.ZodObject<{
+            kind: z.ZodLiteral<"JAVASCRIPT">;
+            runtimeVersion: z.ZodLiteral<"quickjs-sync.v1">;
+            source: z.ZodString;
+        }, z.core.$strict>]>;
+        resultSchema: z.ZodCustom<SubsetSchema, SubsetSchema>;
     }, z.core.$strict>], "kind">;
     responseTemplate: z.ZodDiscriminatedUnion<[z.ZodObject<{
         kind: z.ZodLiteral<"text">;
@@ -181,6 +377,55 @@ interface CommerceDefinitionCompiler {
 declare function validateDefinitionForPublication(raw: unknown, compiler: CommerceDefinitionCompiler): {
     inputSchema: SubsetSchema;
     execution: {
+        kind: "EXTERNAL_HTTP";
+        executorVersion: "1.0.0";
+        connectionRevisionId: string;
+        method: "GET";
+        path: string;
+        query: Record<string, {
+            input: string;
+            omitIfMissing?: true | undefined;
+        } | {
+            literal: string | number | boolean;
+        }>;
+        responseFormat: {
+            mode: "JSON" | "TEXT";
+            mediaTypes: string[];
+        };
+        resultPath: string;
+        responseProcessing: {
+            kind: "OBJECT";
+            fields: Record<string, {
+                path: string;
+                omitIfMissing?: true | undefined;
+            }>;
+        } | {
+            kind: "LIST";
+            fields: Record<string, {
+                path: string;
+                omitIfMissing?: true | undefined;
+            }>;
+            filters: ({
+                path: string;
+                op: "GT" | "LT" | "NE" | "EQ" | "GTE" | "LTE" | "CONTAINS" | "STARTS_WITH";
+                value: string | number | boolean | null;
+            } | {
+                path: string;
+                op: "IN";
+                values: (string | number | boolean | null)[];
+            })[];
+            sort: {
+                path: string;
+                direction: "ASC" | "DESC";
+            } | null;
+            limit: number;
+        } | {
+            kind: "JAVASCRIPT";
+            runtimeVersion: "quickjs-sync.v1";
+            source: string;
+        };
+        resultSchema: SubsetSchema;
+    } | {
         kind: "SHOPIFY_STOREFRONT_QUERY";
         executorVersion: "1.0.0";
         apiVersion: "2026-07";
@@ -231,6 +476,55 @@ declare const toolHashInput: (definition: CommerceToolDefinition) => {
     definition: {
         inputSchema: SubsetSchema;
         execution: {
+            kind: "EXTERNAL_HTTP";
+            executorVersion: "1.0.0";
+            connectionRevisionId: string;
+            method: "GET";
+            path: string;
+            query: Record<string, {
+                input: string;
+                omitIfMissing?: true | undefined;
+            } | {
+                literal: string | number | boolean;
+            }>;
+            responseFormat: {
+                mode: "JSON" | "TEXT";
+                mediaTypes: string[];
+            };
+            resultPath: string;
+            responseProcessing: {
+                kind: "OBJECT";
+                fields: Record<string, {
+                    path: string;
+                    omitIfMissing?: true | undefined;
+                }>;
+            } | {
+                kind: "LIST";
+                fields: Record<string, {
+                    path: string;
+                    omitIfMissing?: true | undefined;
+                }>;
+                filters: ({
+                    path: string;
+                    op: "GT" | "LT" | "NE" | "EQ" | "GTE" | "LTE" | "CONTAINS" | "STARTS_WITH";
+                    value: string | number | boolean | null;
+                } | {
+                    path: string;
+                    op: "IN";
+                    values: (string | number | boolean | null)[];
+                })[];
+                sort: {
+                    path: string;
+                    direction: "ASC" | "DESC";
+                } | null;
+                limit: number;
+            } | {
+                kind: "JAVASCRIPT";
+                runtimeVersion: "quickjs-sync.v1";
+                source: string;
+            };
+            resultSchema: SubsetSchema;
+        } | {
             kind: "SHOPIFY_STOREFRONT_QUERY";
             executorVersion: "1.0.0";
             apiVersion: "2026-07";
@@ -590,13 +884,13 @@ declare const CommerceAlternativeSchema: z.ZodObject<{
     similarityReasons: z.ZodArray<z.ZodString>;
 }, z.core.$strict>;
 declare const CommerceErrorCodeSchema: z.ZodEnum<{
+    DEADLINE: "DEADLINE";
+    THROTTLED: "THROTTLED";
     INVALID_INPUT: "INVALID_INPUT";
     DENIED: "DENIED";
     STALE_TURN: "STALE_TURN";
     NOT_FOUND: "NOT_FOUND";
     UNAVAILABLE: "UNAVAILABLE";
-    THROTTLED: "THROTTLED";
-    DEADLINE: "DEADLINE";
     INCOMPATIBLE_VERSION: "INCOMPATIBLE_VERSION";
 }>;
 declare function commerceToolResultSchema<T extends z.ZodType>(data: T): z.ZodUnion<readonly [z.ZodObject<{
@@ -608,13 +902,13 @@ declare function commerceToolResultSchema<T extends z.ZodType>(data: T): z.ZodUn
     contractVersion: z.ZodLiteral<"commerce.v1">;
     status: z.ZodLiteral<"ERROR">;
     code: z.ZodEnum<{
+        DEADLINE: "DEADLINE";
+        THROTTLED: "THROTTLED";
         INVALID_INPUT: "INVALID_INPUT";
         DENIED: "DENIED";
         STALE_TURN: "STALE_TURN";
         NOT_FOUND: "NOT_FOUND";
         UNAVAILABLE: "UNAVAILABLE";
-        THROTTLED: "THROTTLED";
-        DEADLINE: "DEADLINE";
         INCOMPATIBLE_VERSION: "INCOMPATIBLE_VERSION";
     }>;
     retryable: z.ZodBoolean;
@@ -629,13 +923,13 @@ declare const CommerceToolResultSchema: z.ZodUnion<readonly [z.ZodObject<{
     contractVersion: z.ZodLiteral<"commerce.v1">;
     status: z.ZodLiteral<"ERROR">;
     code: z.ZodEnum<{
+        DEADLINE: "DEADLINE";
+        THROTTLED: "THROTTLED";
         INVALID_INPUT: "INVALID_INPUT";
         DENIED: "DENIED";
         STALE_TURN: "STALE_TURN";
         NOT_FOUND: "NOT_FOUND";
         UNAVAILABLE: "UNAVAILABLE";
-        THROTTLED: "THROTTLED";
-        DEADLINE: "DEADLINE";
         INCOMPATIBLE_VERSION: "INCOMPATIBLE_VERSION";
     }>;
     retryable: z.ZodBoolean;
@@ -1001,4 +1295,4 @@ declare function verifyResponseContract(definition: unknown, hash: string, diges
 /** JSON Schema branches retain the immutable envelope; only ANSWER details vary. */
 declare function finalResponseToolSchema(definition: CommerceResponseContract): Json;
 
-export { ToolNameSchema as $, type CommerceToolDraftDefinition as A, CommerceToolDraftDefinitionSchema as B, type CommerceTurnIdentity as C, type Digest as D, CommerceToolIdentitySchema as E, CommerceToolInputs as F, type GrantedTool as G, CommerceToolOutputs as H, CommerceToolResultSchema as I, CommerceToolRevisionIdentitySchema as J, CommerceTurnIdentitySchema as K, DetailsSchemaSchema as L, EMPTY_RESPONSE_CONTRACT as M, GrantedToolSchema as N, GrantedToolsSchema as O, InputSchemaSchema as P, type Json as Q, MONEY_PATTERN as R, type SubsetSchema as S, type ToolDescriptor as T, POLICY_OPERATIONS as U, POLICY_OPERATION_DESCRIPTORS as V, ReferralReasonSchema as W, ResponseTemplateSchema as X, ToolBindingSchema as Y, ToolBindingsSchema as Z, ToolDescriptorSchema as _, type CommerceConversationGrant as a, canonicalJson as a0, capabilityHashInput as a1, commerceToolResultSchema as a2, compileSubset as a3, definitionToMcpDescriptor as a4, finalResponseSchema as a5, finalResponseToolSchema as a6, jsonBytes as a7, mapToolArguments as a8, matchesSubset as a9, productBelongsToDomain as aa, responseContractCanonicalJson as ab, safeName as ac, safePath as ad, toolHashInput as ae, validateDefinitionForPublication as af, validateDefinitionVersion as ag, validateSubset as ah, verifyResponseContract as ai, type CommerceManifest as b, type CommerceToolResult as c, type CommerceFinalResponse as d, type CommerceToolDefinition as e, CommerceAlternativeSchema as f, CommerceAssertionSchema as g, CommerceBasketSchema as h, CommerceConfigurationSchema as i, CommerceConversationGrantSchema as j, type CommerceDefinitionCompiler as k, CommerceErrorCodeSchema as l, type CommerceEvidence as m, CommerceEvidenceSchema as n, CommerceExecuteAssertionSchema as o, CommerceExecutionSchema as p, CommerceFinalResponseSchema as q, CommerceManifestSchema as r, CommerceOfferSchema as s, CommerceProductSchema as t, CommerceProposalSchema as u, CommerceReleaseIdentitySchema as v, CommerceResolveAssertionSchema as w, type CommerceResponseContract as x, CommerceResponseContractSchema as y, CommerceToolDefinitionSchema as z };
+export { ToolBindingsSchema as $, type CommerceToolDraftDefinition as A, CommerceToolDraftDefinitionSchema as B, type CommerceTurnIdentity as C, type Digest as D, CommerceToolIdentitySchema as E, CommerceToolInputs as F, type GrantedTool as G, CommerceToolOutputs as H, CommerceToolResultSchema as I, CommerceToolRevisionIdentitySchema as J, CommerceTurnIdentitySchema as K, DetailsSchemaSchema as L, EMPTY_RESPONSE_CONTRACT as M, type ExternalHttpExecution as N, ExternalHttpExecutionSchema as O, GrantedToolSchema as P, GrantedToolsSchema as Q, InputSchemaSchema as R, type SubsetSchema as S, type ToolDescriptor as T, type Json as U, MONEY_PATTERN as V, POLICY_OPERATIONS as W, POLICY_OPERATION_DESCRIPTORS as X, ReferralReasonSchema as Y, ResponseTemplateSchema as Z, ToolBindingSchema as _, type CommerceConversationGrant as a, ToolDescriptorSchema as a0, ToolNameSchema as a1, canonicalJson as a2, capabilityHashInput as a3, commerceToolResultSchema as a4, compileSubset as a5, definitionToMcpDescriptor as a6, finalResponseSchema as a7, finalResponseToolSchema as a8, jsonBytes as a9, mapToolArguments as aa, matchesSubset as ab, productBelongsToDomain as ac, responseContractCanonicalJson as ad, safeName as ae, safePath as af, toolHashInput as ag, validateDefinitionForPublication as ah, validateDefinitionVersion as ai, validateSubset as aj, verifyResponseContract as ak, type CommerceManifest as b, type CommerceToolResult as c, type CommerceFinalResponse as d, type CommerceToolDefinition as e, CommerceAlternativeSchema as f, CommerceAssertionSchema as g, CommerceBasketSchema as h, CommerceConfigurationSchema as i, CommerceConversationGrantSchema as j, type CommerceDefinitionCompiler as k, CommerceErrorCodeSchema as l, type CommerceEvidence as m, CommerceEvidenceSchema as n, CommerceExecuteAssertionSchema as o, CommerceExecutionSchema as p, CommerceFinalResponseSchema as q, CommerceManifestSchema as r, CommerceOfferSchema as s, CommerceProductSchema as t, CommerceProposalSchema as u, CommerceReleaseIdentitySchema as v, CommerceResolveAssertionSchema as w, type CommerceResponseContract as x, CommerceResponseContractSchema as y, CommerceToolDefinitionSchema as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@modainteract/moda-interact-shared",
-  "version": "0.13.1",
+  "version": "0.14.1",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -88,6 +88,7 @@
     "build": "tsup",
     "typecheck": "tsc --noEmit",
     "test": "tsx --test \"src/**/*.test.ts\"",
+    "test:arch020-external-contracts": "tsx --test src/commerce/external-contracts.test.ts",
     "validate:billing-entrypoint": "npm run build && node scripts/validate-billing-entrypoint.mjs",
     "validate:recovery-policy-entrypoint": "npm run build && node scripts/validate-recovery-policy-entrypoint.mjs",
     "validate:internationalization-entrypoint": "npm run build && node scripts/validate-internationalization-entrypoint.mjs",