@modainteract/moda-interact-shared 5.4.0 → 5.6.0

package/dist/product-context-D3FuI6ah.d.ts

@@ -0,0 +1,746 @@
+import { S as SubsetSchema, e as CommercePurposeOutputSchema, f as CommerceProductSchema } from './response-Cs4zC3d3.js';
+import { z } from 'zod';
+
+declare const ToolNameSchema: z.ZodString;
+declare const CommerceExecutionPurposeSchema: z.ZodLiteral<"INITIAL_RECOVERY_OUTREACH">;
+declare const CommercePurposeProfileSchema: z.ZodPipe<z.ZodObject<{
+    purpose: z.ZodLiteral<"INITIAL_RECOVERY_OUTREACH">;
+    featureId: z.ZodString;
+    releaseId: z.ZodString;
+    behaviourPrompt: z.ZodString;
+    capabilities: z.ZodArray<z.ZodObject<{
+        capabilityId: z.ZodString;
+        toolId: z.ZodString;
+        revisionId: z.ZodString;
+        name: z.ZodString;
+        position: z.ZodNumber;
+        inputSchema: z.ZodCustom<SubsetSchema, SubsetSchema>;
+        outputSchema: z.ZodCustom<CommercePurposeOutputSchema, CommercePurposeOutputSchema>;
+    }, z.core.$strict>>;
+}, z.core.$strict>, z.ZodTransform<{
+    purpose: "INITIAL_RECOVERY_OUTREACH";
+    featureId: string;
+    releaseId: string;
+    behaviourPrompt: string;
+    capabilities: {
+        capabilityId: string;
+        toolId: string;
+        revisionId: string;
+        name: string;
+        position: number;
+        inputSchema: SubsetSchema;
+        outputSchema: CommercePurposeOutputSchema;
+    }[];
+}, {
+    purpose: "INITIAL_RECOVERY_OUTREACH";
+    featureId: string;
+    releaseId: string;
+    behaviourPrompt: string;
+    capabilities: {
+        capabilityId: string;
+        toolId: string;
+        revisionId: string;
+        name: string;
+        position: number;
+        inputSchema: SubsetSchema;
+        outputSchema: CommercePurposeOutputSchema;
+    }[];
+}>>;
+/** New outreach callers must resolve a present validated snapshot; legacy conversation parsing remains optional. */
+declare function requireCommercePurposeProfile(raw: unknown): {
+    purpose: "INITIAL_RECOVERY_OUTREACH";
+    featureId: string;
+    releaseId: string;
+    behaviourPrompt: string;
+    capabilities: {
+        capabilityId: string;
+        toolId: string;
+        revisionId: string;
+        name: string;
+        position: number;
+        inputSchema: SubsetSchema;
+        outputSchema: CommercePurposeOutputSchema;
+    }[];
+};
+type CommerceExecutionPurpose = z.infer<typeof CommerceExecutionPurposeSchema>;
+type CommercePurposeProfile = z.infer<typeof CommercePurposeProfileSchema>;
+declare const PublishedGrantedToolSchema: z.ZodObject<{
+    toolId: z.ZodString;
+    toolRevisionId: z.ZodString;
+    toolName: z.ZodString;
+    definitionVersion: z.ZodString;
+    capabilityKeys: z.ZodArray<z.ZodString>;
+}, z.core.$strict>;
+declare const PublishedToolDescriptorSchema: z.ZodObject<{
+    toolId: z.ZodString;
+    toolRevisionId: z.ZodString;
+    name: z.ZodString;
+    definitionVersion: z.ZodString;
+    description: z.ZodString;
+    inputSchema: z.ZodCustom<SubsetSchema, SubsetSchema>;
+}, z.core.$strict>;
+declare const CommerceBuiltInToolNameSchema: z.ZodEnum<{
+    commerce_get_discount_options: "commerce_get_discount_options";
+    commerce_get_discount_details: "commerce_get_discount_details";
+}>;
+declare const CommerceBuiltInToolGrantSchema: z.ZodObject<{
+    kind: z.ZodEnum<{
+        BUILT_IN: "BUILT_IN";
+    }>;
+    toolName: z.ZodEnum<{
+        commerce_get_discount_options: "commerce_get_discount_options";
+        commerce_get_discount_details: "commerce_get_discount_details";
+    }>;
+    definitionVersion: z.ZodEnum<{
+        "2.0.0": "2.0.0";
+    }>;
+}, z.core.$strict>;
+declare const CommerceBuiltInToolDescriptorSchema: z.ZodObject<{
+    kind: z.ZodEnum<{
+        BUILT_IN: "BUILT_IN";
+    }>;
+    name: z.ZodEnum<{
+        commerce_get_discount_options: "commerce_get_discount_options";
+        commerce_get_discount_details: "commerce_get_discount_details";
+    }>;
+    definitionVersion: z.ZodEnum<{
+        "2.0.0": "2.0.0";
+    }>;
+    description: z.ZodString;
+    inputSchema: z.ZodCustom<SubsetSchema, SubsetSchema>;
+}, z.core.$strict>;
+type PublishedGrantedTool = z.infer<typeof PublishedGrantedToolSchema>;
+type PublishedToolDescriptor = z.infer<typeof PublishedToolDescriptorSchema>;
+type CommerceBuiltInToolGrant = z.infer<typeof CommerceBuiltInToolGrantSchema>;
+type CommerceBuiltInToolDescriptor = z.infer<typeof CommerceBuiltInToolDescriptorSchema>;
+declare const GrantedToolSchema: z.ZodUnion<readonly [z.ZodObject<{
+    toolId: z.ZodString;
+    toolRevisionId: z.ZodString;
+    toolName: z.ZodString;
+    definitionVersion: z.ZodString;
+    capabilityKeys: z.ZodArray<z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodEnum<{
+        BUILT_IN: "BUILT_IN";
+    }>;
+    toolName: z.ZodEnum<{
+        commerce_get_discount_options: "commerce_get_discount_options";
+        commerce_get_discount_details: "commerce_get_discount_details";
+    }>;
+    definitionVersion: z.ZodEnum<{
+        "2.0.0": "2.0.0";
+    }>;
+}, z.core.$strict>]>;
+declare const ToolDescriptorSchema: z.ZodUnion<readonly [z.ZodObject<{
+    toolId: z.ZodString;
+    toolRevisionId: z.ZodString;
+    name: z.ZodString;
+    definitionVersion: z.ZodString;
+    description: z.ZodString;
+    inputSchema: z.ZodCustom<SubsetSchema, SubsetSchema>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodEnum<{
+        BUILT_IN: "BUILT_IN";
+    }>;
+    name: z.ZodEnum<{
+        commerce_get_discount_options: "commerce_get_discount_options";
+        commerce_get_discount_details: "commerce_get_discount_details";
+    }>;
+    definitionVersion: z.ZodEnum<{
+        "2.0.0": "2.0.0";
+    }>;
+    description: z.ZodString;
+    inputSchema: z.ZodCustom<SubsetSchema, SubsetSchema>;
+}, z.core.$strict>]>;
+declare const GrantedToolsSchema: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+    toolId: z.ZodString;
+    toolRevisionId: z.ZodString;
+    toolName: z.ZodString;
+    definitionVersion: z.ZodString;
+    capabilityKeys: z.ZodArray<z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodEnum<{
+        BUILT_IN: "BUILT_IN";
+    }>;
+    toolName: z.ZodEnum<{
+        commerce_get_discount_options: "commerce_get_discount_options";
+        commerce_get_discount_details: "commerce_get_discount_details";
+    }>;
+    definitionVersion: z.ZodEnum<{
+        "2.0.0": "2.0.0";
+    }>;
+}, z.core.$strict>]>>;
+declare const isBuiltInTool: <T extends GrantedTool | ToolDescriptor>(value: T) => value is Extract<T, {
+    kind: "BUILT_IN";
+}>;
+declare const POLICY_OPERATIONS: readonly ["taxonomy.resolveCategories", "products.search", "products.get", "shipping.getInformation", "recovery.getBasket", "shopify.searchProducts", "discounts.getOptions", "discounts.getDetails", "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">;
+    apiVersion: z.ZodLiteral<"2026-07">;
+    schemaHash: z.ZodString;
+    document: z.ZodString;
+    operationName: z.ZodString;
+    variables: 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.ZodUnknown;
+    }, z.core.$strict>]>>;
+    resultPath: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"POLICY_OPERATION">;
+    operation: z.ZodEnum<{
+        "taxonomy.resolveCategories": "taxonomy.resolveCategories";
+        "products.search": "products.search";
+        "products.get": "products.get";
+        "shipping.getInformation": "shipping.getInformation";
+        "recovery.getBasket": "recovery.getBasket";
+        "shopify.searchProducts": "shopify.searchProducts";
+        "discounts.getOptions": "discounts.getOptions";
+        "discounts.getDetails": "discounts.getDetails";
+        "discounts.evaluate": "discounts.evaluate";
+        "products.findQualifying": "products.findQualifying";
+        "products.findSimilar": "products.findSimilar";
+    }>;
+    operationVersion: z.ZodLiteral<"1.0.0">;
+    arguments: 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.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;
+    unavailable: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"items">;
+    itemsPath: z.ZodString;
+    item: z.ZodString;
+    empty: z.ZodString;
+    unavailable: z.ZodString;
+}, z.core.$strict>], "kind">;
+declare const CommerceToolDefinitionSchema: z.ZodObject<{
+    inputSchema: z.ZodCustom<SubsetSchema, SubsetSchema>;
+    execution: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"SHOPIFY_STOREFRONT_QUERY">;
+        executorVersion: z.ZodLiteral<"1.0.0">;
+        apiVersion: z.ZodLiteral<"2026-07">;
+        schemaHash: z.ZodString;
+        document: z.ZodString;
+        operationName: z.ZodString;
+        variables: 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.ZodUnknown;
+        }, z.core.$strict>]>>;
+        resultPath: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"POLICY_OPERATION">;
+        operation: z.ZodEnum<{
+            "taxonomy.resolveCategories": "taxonomy.resolveCategories";
+            "products.search": "products.search";
+            "products.get": "products.get";
+            "shipping.getInformation": "shipping.getInformation";
+            "recovery.getBasket": "recovery.getBasket";
+            "shopify.searchProducts": "shopify.searchProducts";
+            "discounts.getOptions": "discounts.getOptions";
+            "discounts.getDetails": "discounts.getDetails";
+            "discounts.evaluate": "discounts.evaluate";
+            "products.findQualifying": "products.findQualifying";
+            "products.findSimilar": "products.findSimilar";
+        }>;
+        operationVersion: z.ZodLiteral<"1.0.0">;
+        arguments: 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.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">;
+        text: z.ZodString;
+        unavailable: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"items">;
+        itemsPath: z.ZodString;
+        item: z.ZodString;
+        empty: z.ZodString;
+        unavailable: z.ZodString;
+    }, z.core.$strict>], "kind">;
+    name: z.ZodString;
+    definitionVersion: z.ZodString;
+    description: z.ZodString;
+}, z.core.$strict>;
+declare const CommerceToolDraftDefinitionSchema: z.ZodObject<{
+    inputSchema: z.ZodUnknown;
+    execution: z.ZodUnknown;
+    responseTemplate: z.ZodUnknown;
+    name: z.ZodString;
+    definitionVersion: z.ZodString;
+    description: z.ZodString;
+}, z.core.$strict>;
+type CommerceToolDefinition = z.infer<typeof CommerceToolDefinitionSchema>;
+type CommerceToolDraftDefinition = z.infer<typeof CommerceToolDraftDefinitionSchema>;
+type GrantedTool = z.infer<typeof GrantedToolSchema>;
+type ToolDescriptor = z.infer<typeof ToolDescriptorSchema>;
+/** Commerce owns schema-backed GraphQL parsing, restrictions and output derivation. */
+interface CommerceDefinitionCompiler {
+    compile(execution: CommerceToolDefinition["execution"], input: SubsetSchema): {
+        outputSchema: SubsetSchema;
+        validateMappedArguments: (mapping: CommerceToolDefinition["execution"]) => boolean;
+    };
+}
+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";
+        schemaHash: string;
+        document: string;
+        operationName: string;
+        variables: Record<string, {
+            input: string;
+            omitIfMissing?: true | undefined;
+        } | {
+            literal: unknown;
+        }>;
+        resultPath: string;
+    } | {
+        kind: "POLICY_OPERATION";
+        operation: "taxonomy.resolveCategories" | "products.search" | "products.get" | "shipping.getInformation" | "recovery.getBasket" | "shopify.searchProducts" | "discounts.getOptions" | "discounts.getDetails" | "discounts.evaluate" | "products.findQualifying" | "products.findSimilar";
+        operationVersion: "1.0.0";
+        arguments: Record<string, {
+            input: string;
+            omitIfMissing?: true | undefined;
+        } | {
+            literal: unknown;
+        }>;
+    };
+    responseTemplate: {
+        kind: "text";
+        text: string;
+        unavailable: string;
+    } | {
+        kind: "items";
+        itemsPath: string;
+        item: string;
+        empty: string;
+        unavailable: string;
+    };
+    name: string;
+    definitionVersion: string;
+    description: string;
+};
+declare function definitionToMcpDescriptor(definition: CommerceToolDefinition): {
+    name: string;
+    description: string;
+    inputSchema: SubsetSchema;
+};
+declare function mapToolArguments(definition: CommerceToolDefinition, raw: unknown): Record<string, unknown>;
+declare const toolHashInput: (definition: CommerceToolDefinition) => {
+    contractVersion: "commerce.v1";
+    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";
+            schemaHash: string;
+            document: string;
+            operationName: string;
+            variables: Record<string, {
+                input: string;
+                omitIfMissing?: true | undefined;
+            } | {
+                literal: unknown;
+            }>;
+            resultPath: string;
+        } | {
+            kind: "POLICY_OPERATION";
+            operation: "taxonomy.resolveCategories" | "products.search" | "products.get" | "shipping.getInformation" | "recovery.getBasket" | "shopify.searchProducts" | "discounts.getOptions" | "discounts.getDetails" | "discounts.evaluate" | "products.findQualifying" | "products.findSimilar";
+            operationVersion: "1.0.0";
+            arguments: Record<string, {
+                input: string;
+                omitIfMissing?: true | undefined;
+            } | {
+                literal: unknown;
+            }>;
+        };
+        responseTemplate: {
+            kind: "text";
+            text: string;
+            unavailable: string;
+        } | {
+            kind: "items";
+            itemsPath: string;
+            item: string;
+            empty: string;
+            unavailable: string;
+        };
+        name: string;
+        definitionVersion: string;
+        description: string;
+    };
+};
+/** Publication adapters supply the actual highest published version from persistence. */
+declare function validateDefinitionVersion(proposed: string, highestPublished: string | null): boolean;
+declare const CommerceToolIdentitySchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    enabled: z.ZodBoolean;
+}, z.core.$strict>;
+declare const CommerceToolRevisionIdentitySchema: z.ZodObject<{
+    toolId: z.ZodString;
+    toolRevisionId: z.ZodString;
+    definitionVersion: z.ZodString;
+    contentHash: z.ZodString;
+}, z.core.$strict>;
+declare const POLICY_OPERATION_DESCRIPTORS: {
+    operation: "taxonomy.resolveCategories" | "products.search" | "products.get" | "shipping.getInformation" | "recovery.getBasket" | "shopify.searchProducts" | "discounts.getOptions" | "discounts.getDetails" | "discounts.evaluate" | "products.findQualifying" | "products.findSimilar";
+    operationVersion: "1.0.0";
+}[];
+
+declare const CommerceConversationProductContextSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    shopId: z.ZodString;
+    conversationId: z.ZodString;
+    platform: z.ZodEnum<{
+        SHOPIFY: "SHOPIFY";
+        WOOCOMMERCE: "WOOCOMMERCE";
+    }>;
+    references: z.ZodArray<z.ZodObject<{
+        productId: z.ZodString;
+        variantId: z.ZodNullable<z.ZodString>;
+        title: z.ZodString;
+        observedAt: z.ZodISODateTime;
+    }, z.core.$strict>>;
+    updatedAt: z.ZodISODateTime;
+}, z.core.$strict>;
+type CommerceConversationProductContext = z.infer<typeof CommerceConversationProductContextSchema>;
+type CommerceProductObservation = {
+    toolName: string;
+    products: z.infer<typeof CommerceProductSchema>[];
+    observedAt: string;
+};
+type CommerceProductContextIdentity = {
+    shopId: string;
+    conversationId: string;
+    platform: "SHOPIFY" | "WOOCOMMERCE";
+    now: number;
+};
+declare function mergeConversationProductContext(previous: CommerceConversationProductContext | null, observations: readonly CommerceProductObservation[], identity: CommerceProductContextIdentity): CommerceConversationProductContext;
+declare function resolveConversationProductReference(context: CommerceConversationProductContext, reference: {
+    productId?: string;
+    variantId?: string | null;
+    title?: string;
+}): {
+    kind: "MATCH";
+    productId: string;
+    variantId: string | null;
+} | {
+    kind: "AMBIGUOUS";
+} | {
+    kind: "MISSING";
+};
+
+export { PublishedGrantedToolSchema as A, PublishedToolDescriptorSchema as B, type CommerceExecutionPurpose as C, ToolDescriptorSchema as D, type ExternalHttpExecution as E, ToolNameSchema as F, type GrantedTool as G, definitionToMcpDescriptor as H, isBuiltInTool as I, mapToolArguments as J, mergeConversationProductContext as K, requireCommercePurposeProfile as L, resolveConversationProductReference as M, toolHashInput as N, validateDefinitionForPublication as O, type PublishedToolDescriptor as P, validateDefinitionVersion as Q, ResponseTemplateSchema as R, type ToolDescriptor as T, type CommerceConversationProductContext as a, type CommerceBuiltInToolDescriptor as b, type CommerceToolDefinition as c, type CommerceBuiltInToolGrant as d, CommerceBuiltInToolDescriptorSchema as e, CommerceBuiltInToolGrantSchema as f, CommerceBuiltInToolNameSchema as g, CommerceConversationProductContextSchema as h, type CommerceDefinitionCompiler as i, CommerceExecutionPurposeSchema as j, CommerceExecutionSchema as k, type CommerceProductContextIdentity as l, type CommerceProductObservation as m, type CommercePurposeProfile as n, CommercePurposeProfileSchema as o, CommerceToolDefinitionSchema as p, type CommerceToolDraftDefinition as q, CommerceToolDraftDefinitionSchema as r, CommerceToolIdentitySchema as s, CommerceToolRevisionIdentitySchema as t, ExternalHttpExecutionSchema as u, GrantedToolSchema as v, GrantedToolsSchema as w, POLICY_OPERATIONS as x, POLICY_OPERATION_DESCRIPTORS as y, type PublishedGrantedTool as z };