@modainteract/moda-interact-shared 3.1.0 → 5.0.0

package/dist/{response-CAw8y5nS.d.ts → response-DUOmPh9C.d.ts}

@@ -36,29 +36,116 @@ declare function matchesSubset(schema: SubsetSchema, value: unknown): boolean;
 declare function compileSubset(schema: SubsetSchema, mode: "input" | "details"): z.ZodCustom<Record<string, Json>, Record<string, Json>>;
 
 declare const ToolNameSchema: z.ZodString;
-declare const GrantedToolSchema: z.ZodObject<{
+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 GrantedToolsSchema: z.ZodArray<z.ZodObject<{
+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>>;
-declare const ToolDescriptorSchema: z.ZodObject<{
+}, 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>;
-declare const POLICY_OPERATIONS: readonly ["recovery.getBasket", "shopify.searchProducts", "discounts.getOptions", "discounts.evaluate", "products.findQualifying", "products.findSimilar"];
+}, 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.evaluate", "products.findQualifying", "products.findSimilar"];
 declare const ExternalHttpExecutionSchema: z.ZodObject<{
     kind: z.ZodLiteral<"EXTERNAL_HTTP">;
     executorVersion: z.ZodLiteral<"1.0.0">;
@@ -141,6 +228,10 @@ declare const CommerceExecutionSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
 }, 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";
@@ -253,6 +344,10 @@ declare const CommerceToolDefinitionSchema: z.ZodObject<{
     }, 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";
@@ -433,7 +528,7 @@ declare function validateDefinitionForPublication(raw: unknown, compiler: Commer
         resultPath: string;
     } | {
         kind: "POLICY_OPERATION";
-        operation: "recovery.getBasket" | "shopify.searchProducts" | "discounts.getOptions" | "discounts.evaluate" | "products.findQualifying" | "products.findSimilar";
+        operation: "taxonomy.resolveCategories" | "products.search" | "products.get" | "shipping.getInformation" | "recovery.getBasket" | "shopify.searchProducts" | "discounts.getOptions" | "discounts.evaluate" | "products.findQualifying" | "products.findSimilar";
         operationVersion: "1.0.0";
         arguments: Record<string, {
             input: string;
@@ -532,7 +627,7 @@ declare const toolHashInput: (definition: CommerceToolDefinition) => {
             resultPath: string;
         } | {
             kind: "POLICY_OPERATION";
-            operation: "recovery.getBasket" | "shopify.searchProducts" | "discounts.getOptions" | "discounts.evaluate" | "products.findQualifying" | "products.findSimilar";
+            operation: "taxonomy.resolveCategories" | "products.search" | "products.get" | "shipping.getInformation" | "recovery.getBasket" | "shopify.searchProducts" | "discounts.getOptions" | "discounts.evaluate" | "products.findQualifying" | "products.findSimilar";
             operationVersion: "1.0.0";
             arguments: Record<string, {
                 input: string;
@@ -571,7 +666,7 @@ declare const CommerceToolRevisionIdentitySchema: z.ZodObject<{
     contentHash: z.ZodString;
 }, z.core.$strict>;
 declare const POLICY_OPERATION_DESCRIPTORS: {
-    operation: "recovery.getBasket" | "shopify.searchProducts" | "discounts.getOptions" | "discounts.evaluate" | "products.findQualifying" | "products.findSimilar";
+    operation: "taxonomy.resolveCategories" | "products.search" | "products.get" | "shipping.getInformation" | "recovery.getBasket" | "shopify.searchProducts" | "discounts.getOptions" | "discounts.evaluate" | "products.findQualifying" | "products.findSimilar";
     operationVersion: "1.0.0";
 }[];
 
@@ -590,13 +685,24 @@ declare const CommerceConversationGrantSchema: z.ZodObject<{
     initialInboundVersion: z.ZodNumber;
     releaseId: z.ZodString;
     selectedCapabilityKeys: z.ZodArray<z.ZodString>;
-    grantedTools: z.ZodArray<z.ZodObject<{
+    grantedTools: 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.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>]>>;
     runnerVersion: z.ZodString;
     createdAt: z.ZodISODateTime;
     expiresAt: z.ZodNullable<z.ZodISODateTime>;
@@ -625,13 +731,38 @@ declare const CommerceManifestSchema: z.ZodObject<{
         behaviourPrompt: z.ZodString;
     }, z.core.$strict>>;
     selectedCapabilityKeys: z.ZodArray<z.ZodString>;
-    grantedTools: z.ZodArray<z.ZodObject<{
+    builtInTools: z.ZodDefault<z.ZodArray<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>>>;
+    grantedTools: 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.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>]>>;
     responseContract: z.ZodObject<{
         version: z.ZodLiteral<"response.v1">;
         instructions: z.ZodString;
@@ -745,8 +876,8 @@ declare const CommerceOfferSchema: z.ZodObject<{
         CODE: "CODE";
     }>;
     code: z.ZodNullable<z.ZodString>;
-    startsAt: z.ZodNullable<z.ZodISODateTime>;
-    endsAt: z.ZodNullable<z.ZodISODateTime>;
+    startsAt: z.ZodNullable<z.ZodString>;
+    endsAt: z.ZodNullable<z.ZodString>;
     support: z.ZodEnum<{
         SUPPORTED: "SUPPORTED";
         UNSUPPORTED: "UNSUPPORTED";
@@ -780,9 +911,9 @@ declare const CommerceDiscountConditionFactsSchema: z.ZodObject<{
         COMPLETE: "COMPLETE";
         PARTIAL: "PARTIAL";
     }>;
-    observedAt: z.ZodISODateTime;
+    observedAt: z.ZodString;
     providerStatus: z.ZodString;
-    unavailableAt: z.ZodNullable<z.ZodISODateTime>;
+    unavailableAt: z.ZodNullable<z.ZodString>;
     discountKind: z.ZodEnum<{
         UNKNOWN: "UNKNOWN";
         PERCENTAGE: "PERCENTAGE";
@@ -853,8 +984,8 @@ declare const CommerceDiscountDetailsSchema: z.ZodObject<{
             CODE: "CODE";
         }>;
         code: z.ZodNullable<z.ZodString>;
-        startsAt: z.ZodNullable<z.ZodISODateTime>;
-        endsAt: z.ZodNullable<z.ZodISODateTime>;
+        startsAt: z.ZodNullable<z.ZodString>;
+        endsAt: z.ZodNullable<z.ZodString>;
         support: z.ZodEnum<{
             SUPPORTED: "SUPPORTED";
             UNSUPPORTED: "UNSUPPORTED";
@@ -872,9 +1003,9 @@ declare const CommerceDiscountDetailsSchema: z.ZodObject<{
             COMPLETE: "COMPLETE";
             PARTIAL: "PARTIAL";
         }>;
-        observedAt: z.ZodISODateTime;
+        observedAt: z.ZodString;
         providerStatus: z.ZodString;
-        unavailableAt: z.ZodNullable<z.ZodISODateTime>;
+        unavailableAt: z.ZodNullable<z.ZodString>;
         discountKind: z.ZodEnum<{
             UNKNOWN: "UNKNOWN";
             PERCENTAGE: "PERCENTAGE";
@@ -1123,10 +1254,179 @@ declare const CommerceToolResultSchema: z.ZodUnion<readonly [z.ZodObject<{
     renderedText: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>]>;
 type CommerceToolResult = z.infer<typeof CommerceToolResultSchema>;
+declare const CommerceCategoryCandidateSchema: z.ZodObject<{
+    categoryId: z.ZodString;
+    name: z.ZodString;
+    fullName: z.ZodString;
+    parentId: z.ZodNullable<z.ZodString>;
+    level: z.ZodNumber;
+    ancestorIds: z.ZodArray<z.ZodString>;
+    distance: z.ZodNumber;
+}, z.core.$strict>;
+type CommerceCategoryCandidate = z.infer<typeof CommerceCategoryCandidateSchema>;
+declare const CommerceCategoryResolutionSchema: z.ZodUnion<readonly [z.ZodObject<{
+    outcome: z.ZodEnum<{
+        CANDIDATES: "CANDIDATES";
+        NO_CANDIDATES: "NO_CANDIDATES";
+    }>;
+    generationId: z.ZodString;
+    source: z.ZodEnum<{
+        SHOPIFY_STANDARD_PRODUCT_TAXONOMY: "SHOPIFY_STANDARD_PRODUCT_TAXONOMY";
+    }>;
+    taxonomyVersion: z.ZodString;
+    languageTag: z.ZodString;
+    candidates: z.ZodArray<z.ZodObject<{
+        categoryId: z.ZodString;
+        name: z.ZodString;
+        fullName: z.ZodString;
+        parentId: z.ZodNullable<z.ZodString>;
+        level: z.ZodNumber;
+        ancestorIds: z.ZodArray<z.ZodString>;
+        distance: z.ZodNumber;
+    }, z.core.$strict>>;
+}, z.core.$strict>, z.ZodObject<{
+    outcome: z.ZodEnum<{
+        UNAVAILABLE: "UNAVAILABLE";
+    }>;
+    reasonCode: z.ZodEnum<{
+        NOT_READY: "NOT_READY";
+        TEMPORARY_UNAVAILABLE: "TEMPORARY_UNAVAILABLE";
+    }>;
+}, z.core.$strict>]>;
+type CommerceCategoryResolution = z.infer<typeof CommerceCategoryResolutionSchema>;
+declare const CommerceOptionalLookupUnavailableSchema: z.ZodObject<{
+    outcome: z.ZodEnum<{
+        UNAVAILABLE: "UNAVAILABLE";
+    }>;
+    reasonCode: z.ZodEnum<{
+        TEMPORARY_UNAVAILABLE: "TEMPORARY_UNAVAILABLE";
+    }>;
+}, z.core.$strict>;
+type CommerceOptionalLookupUnavailable = z.infer<typeof CommerceOptionalLookupUnavailableSchema>;
+declare const CommerceProductRecommendationSelectionSchema: z.ZodObject<{
+    productRecommendationVersion: z.ZodOptional<z.ZodEnum<{
+        1: "1";
+    }>>;
+    productRecommendations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        scope: z.ZodEnum<{
+            PRODUCT_ONLY: "PRODUCT_ONLY";
+            ADD_TO_BASKET: "ADD_TO_BASKET";
+            REPLACE_BASKET_LINE: "REPLACE_BASKET_LINE";
+        }>;
+        basketLineId: z.ZodNullable<z.ZodString>;
+        productId: z.ZodString;
+        variantId: z.ZodNullable<z.ZodString>;
+        quantity: z.ZodNumber;
+        promotionKind: z.ZodEnum<{
+            NONE: "NONE";
+            NATIVE_SALE: "NATIVE_SALE";
+            DISCOUNT: "DISCOUNT";
+        }>;
+        offerIds: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>>>;
+}, z.core.$strict>;
+type CommerceProductRecommendationSelection = z.infer<typeof CommerceProductRecommendationSelectionSchema>;
+declare const CommerceResponseDispositionSchema: z.ZodEnum<{
+    STANDARD: "STANDARD";
+    OUT_OF_SCOPE_REDIRECT: "OUT_OF_SCOPE_REDIRECT";
+    SHIPPING_INFORMATION_UNVERIFIED: "SHIPPING_INFORMATION_UNVERIFIED";
+}>;
+type CommerceResponseDisposition = z.infer<typeof CommerceResponseDispositionSchema>;
+declare const CommerceAnswerPresentationSelectionSchema: z.ZodObject<{
+    responseDisposition: z.ZodOptional<z.ZodEnum<{
+        STANDARD: "STANDARD";
+        OUT_OF_SCOPE_REDIRECT: "OUT_OF_SCOPE_REDIRECT";
+        SHIPPING_INFORMATION_UNVERIFIED: "SHIPPING_INFORMATION_UNVERIFIED";
+    }>>;
+    shippingInformationSelection: z.ZodOptional<z.ZodObject<{
+        productId: z.ZodNullable<z.ZodString>;
+        variantId: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+type CommerceAnswerPresentationSelection = z.infer<typeof CommerceAnswerPresentationSelectionSchema>;
+declare const CommerceShippingInformationInputSchema: z.ZodObject<{
+    productId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    variantId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+}, z.core.$strict>;
+type CommerceShippingInformationInput = z.infer<typeof CommerceShippingInformationInputSchema>;
+declare const CommerceShippingInformationSchema: z.ZodObject<{
+    provider: z.ZodEnum<{
+        SHOPIFY: "SHOPIFY";
+        WOOCOMMERCE: "WOOCOMMERCE";
+    }>;
+    observedAt: z.ZodISODateTime;
+    product: z.ZodObject<{
+        status: z.ZodEnum<{
+            NOT_REQUESTED: "NOT_REQUESTED";
+            VARIANT_REQUIRED: "VARIANT_REQUIRED";
+            AVAILABLE: "AVAILABLE";
+        }>;
+        productId: z.ZodNullable<z.ZodString>;
+        variantId: z.ZodNullable<z.ZodString>;
+        requiresShipping: z.ZodNullable<z.ZodBoolean>;
+        virtual: z.ZodNullable<z.ZodBoolean>;
+        weight: z.ZodNullable<z.ZodObject<{
+            value: z.ZodNumber;
+            unit: z.ZodNullable<z.ZodEnum<{
+                GRAMS: "GRAMS";
+                KILOGRAMS: "KILOGRAMS";
+                OUNCES: "OUNCES";
+                POUNDS: "POUNDS";
+            }>>;
+        }, z.core.$strict>>;
+        dimensions: z.ZodNullable<z.ZodObject<{
+            length: z.ZodNullable<z.ZodNumber>;
+            width: z.ZodNullable<z.ZodNumber>;
+            height: z.ZodNullable<z.ZodNumber>;
+            unit: z.ZodNullable<z.ZodString>;
+        }, z.core.$strict>>;
+        shippingClassId: z.ZodNullable<z.ZodString>;
+        shippingClassSlug: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>;
+    policy: z.ZodObject<{
+        status: z.ZodEnum<{
+            UNSUPPORTED: "UNSUPPORTED";
+            AVAILABLE: "AVAILABLE";
+            NOT_CONFIGURED: "NOT_CONFIGURED";
+            SCOPE_NOT_GRANTED: "SCOPE_NOT_GRANTED";
+        }>;
+        trust: z.ZodEnum<{
+            UNTRUSTED_REFERENCE: "UNTRUSTED_REFERENCE";
+        }>;
+        title: z.ZodNullable<z.ZodString>;
+        bodyStatus: z.ZodEnum<{
+            AVAILABLE: "AVAILABLE";
+            EMPTY: "EMPTY";
+            TOO_LARGE: "TOO_LARGE";
+            NOT_AVAILABLE: "NOT_AVAILABLE";
+        }>;
+        bodyHtml: z.ZodNullable<z.ZodString>;
+        url: z.ZodNullable<z.ZodURL>;
+        updatedAt: z.ZodNullable<z.ZodISODateTime>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+type CommerceShippingInformation = z.infer<typeof CommerceShippingInformationSchema>;
 declare const CommerceToolInputs: {
+    commerce_resolve_product_categories: z.ZodObject<{
+        query: z.ZodString;
+        limit: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strict>;
+    commerce_get_shipping_information: z.ZodObject<{
+        productId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        variantId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strict>;
     commerce_get_basket: z.ZodObject<{}, z.core.$strict>;
     commerce_search_products: z.ZodObject<{
-        query: z.ZodString;
+        query: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        category: z.ZodOptional<z.ZodObject<{
+            system: z.ZodEnum<{
+                SHOPIFY_STANDARD_PRODUCT_TAXONOMY: "SHOPIFY_STANDARD_PRODUCT_TAXONOMY";
+                WOOCOMMERCE_PRODUCT_CATEGORY: "WOOCOMMERCE_PRODUCT_CATEGORY";
+            }>;
+            id: z.ZodString;
+            taxonomyVersion: z.ZodNullable<z.ZodString>;
+        }, z.core.$strict>>;
+        browse: z.ZodDefault<z.ZodBoolean>;
         maximumPrice: z.ZodOptional<z.ZodString>;
         availableOnly: z.ZodDefault<z.ZodBoolean>;
         limit: z.ZodDefault<z.ZodNumber>;
@@ -1170,6 +1470,91 @@ declare const CommerceToolInputs: {
     }, z.core.$strict>;
 };
 declare const CommerceToolOutputs: {
+    commerce_resolve_product_categories: z.ZodUnion<readonly [z.ZodObject<{
+        outcome: z.ZodEnum<{
+            CANDIDATES: "CANDIDATES";
+            NO_CANDIDATES: "NO_CANDIDATES";
+        }>;
+        generationId: z.ZodString;
+        source: z.ZodEnum<{
+            SHOPIFY_STANDARD_PRODUCT_TAXONOMY: "SHOPIFY_STANDARD_PRODUCT_TAXONOMY";
+        }>;
+        taxonomyVersion: z.ZodString;
+        languageTag: z.ZodString;
+        candidates: z.ZodArray<z.ZodObject<{
+            categoryId: z.ZodString;
+            name: z.ZodString;
+            fullName: z.ZodString;
+            parentId: z.ZodNullable<z.ZodString>;
+            level: z.ZodNumber;
+            ancestorIds: z.ZodArray<z.ZodString>;
+            distance: z.ZodNumber;
+        }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        outcome: z.ZodEnum<{
+            UNAVAILABLE: "UNAVAILABLE";
+        }>;
+        reasonCode: z.ZodEnum<{
+            NOT_READY: "NOT_READY";
+            TEMPORARY_UNAVAILABLE: "TEMPORARY_UNAVAILABLE";
+        }>;
+    }, z.core.$strict>]>;
+    commerce_get_shipping_information: z.ZodObject<{
+        provider: z.ZodEnum<{
+            SHOPIFY: "SHOPIFY";
+            WOOCOMMERCE: "WOOCOMMERCE";
+        }>;
+        observedAt: z.ZodISODateTime;
+        product: z.ZodObject<{
+            status: z.ZodEnum<{
+                NOT_REQUESTED: "NOT_REQUESTED";
+                VARIANT_REQUIRED: "VARIANT_REQUIRED";
+                AVAILABLE: "AVAILABLE";
+            }>;
+            productId: z.ZodNullable<z.ZodString>;
+            variantId: z.ZodNullable<z.ZodString>;
+            requiresShipping: z.ZodNullable<z.ZodBoolean>;
+            virtual: z.ZodNullable<z.ZodBoolean>;
+            weight: z.ZodNullable<z.ZodObject<{
+                value: z.ZodNumber;
+                unit: z.ZodNullable<z.ZodEnum<{
+                    GRAMS: "GRAMS";
+                    KILOGRAMS: "KILOGRAMS";
+                    OUNCES: "OUNCES";
+                    POUNDS: "POUNDS";
+                }>>;
+            }, z.core.$strict>>;
+            dimensions: z.ZodNullable<z.ZodObject<{
+                length: z.ZodNullable<z.ZodNumber>;
+                width: z.ZodNullable<z.ZodNumber>;
+                height: z.ZodNullable<z.ZodNumber>;
+                unit: z.ZodNullable<z.ZodString>;
+            }, z.core.$strict>>;
+            shippingClassId: z.ZodNullable<z.ZodString>;
+            shippingClassSlug: z.ZodNullable<z.ZodString>;
+        }, z.core.$strict>;
+        policy: z.ZodObject<{
+            status: z.ZodEnum<{
+                UNSUPPORTED: "UNSUPPORTED";
+                AVAILABLE: "AVAILABLE";
+                NOT_CONFIGURED: "NOT_CONFIGURED";
+                SCOPE_NOT_GRANTED: "SCOPE_NOT_GRANTED";
+            }>;
+            trust: z.ZodEnum<{
+                UNTRUSTED_REFERENCE: "UNTRUSTED_REFERENCE";
+            }>;
+            title: z.ZodNullable<z.ZodString>;
+            bodyStatus: z.ZodEnum<{
+                AVAILABLE: "AVAILABLE";
+                EMPTY: "EMPTY";
+                TOO_LARGE: "TOO_LARGE";
+                NOT_AVAILABLE: "NOT_AVAILABLE";
+            }>;
+            bodyHtml: z.ZodNullable<z.ZodString>;
+            url: z.ZodNullable<z.ZodURL>;
+            updatedAt: z.ZodNullable<z.ZodISODateTime>;
+        }, z.core.$strict>;
+    }, z.core.$strict>;
     commerce_get_basket: z.ZodObject<{
         basketId: z.ZodString;
         source: z.ZodEnum<{
@@ -1236,7 +1621,14 @@ declare const CommerceToolOutputs: {
             observedAt: z.ZodISODateTime;
         }, z.core.$strict>>;
     }, z.core.$strict>;
-    commerce_get_discount_options: z.ZodObject<{
+    commerce_get_discount_options: z.ZodUnion<readonly [z.ZodObject<{
+        outcome: z.ZodEnum<{
+            UNAVAILABLE: "UNAVAILABLE";
+        }>;
+        reasonCode: z.ZodEnum<{
+            TEMPORARY_UNAVAILABLE: "TEMPORARY_UNAVAILABLE";
+        }>;
+    }, z.core.$strict>, z.ZodObject<{
         mode: z.ZodEnum<{
             NONE: "NONE";
             FIXED: "FIXED";
@@ -1250,8 +1642,8 @@ declare const CommerceToolOutputs: {
                 CODE: "CODE";
             }>;
             code: z.ZodNullable<z.ZodString>;
-            startsAt: z.ZodNullable<z.ZodISODateTime>;
-            endsAt: z.ZodNullable<z.ZodISODateTime>;
+            startsAt: z.ZodNullable<z.ZodString>;
+            endsAt: z.ZodNullable<z.ZodString>;
             support: z.ZodEnum<{
                 SUPPORTED: "SUPPORTED";
                 UNSUPPORTED: "UNSUPPORTED";
@@ -1261,8 +1653,15 @@ declare const CommerceToolOutputs: {
         }, z.core.$strict>>;
         truncated: z.ZodBoolean;
         cursor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    }, z.core.$strict>;
-    commerce_get_discount_details: z.ZodObject<{
+    }, z.core.$strict>]>;
+    commerce_get_discount_details: z.ZodUnion<readonly [z.ZodObject<{
+        outcome: z.ZodEnum<{
+            UNAVAILABLE: "UNAVAILABLE";
+        }>;
+        reasonCode: z.ZodEnum<{
+            TEMPORARY_UNAVAILABLE: "TEMPORARY_UNAVAILABLE";
+        }>;
+    }, z.core.$strict>, z.ZodObject<{
         details: z.ZodNullable<z.ZodObject<{
             offer: z.ZodObject<{
                 offerId: z.ZodString;
@@ -1272,8 +1671,8 @@ declare const CommerceToolOutputs: {
                     CODE: "CODE";
                 }>;
                 code: z.ZodNullable<z.ZodString>;
-                startsAt: z.ZodNullable<z.ZodISODateTime>;
-                endsAt: z.ZodNullable<z.ZodISODateTime>;
+                startsAt: z.ZodNullable<z.ZodString>;
+                endsAt: z.ZodNullable<z.ZodString>;
                 support: z.ZodEnum<{
                     SUPPORTED: "SUPPORTED";
                     UNSUPPORTED: "UNSUPPORTED";
@@ -1291,9 +1690,9 @@ declare const CommerceToolOutputs: {
                     COMPLETE: "COMPLETE";
                     PARTIAL: "PARTIAL";
                 }>;
-                observedAt: z.ZodISODateTime;
+                observedAt: z.ZodString;
                 providerStatus: z.ZodString;
-                unavailableAt: z.ZodNullable<z.ZodISODateTime>;
+                unavailableAt: z.ZodNullable<z.ZodString>;
                 discountKind: z.ZodEnum<{
                     UNKNOWN: "UNKNOWN";
                     PERCENTAGE: "PERCENTAGE";
@@ -1356,7 +1755,7 @@ declare const CommerceToolOutputs: {
             }, z.core.$strict>;
             providerDiscountId: z.ZodNullable<z.ZodString>;
         }, z.core.$strict>>;
-    }, z.core.$strict>;
+    }, z.core.$strict>]>;
     commerce_evaluate_discount: z.ZodObject<{
         evidenceId: z.ZodString;
         turn: z.ZodObject<{
@@ -1638,4 +2037,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 { type Json as $, CommerceProductSchema as A, CommerceProposalSchema as B, type CommerceTurnIdentity as C, type Digest as D, CommerceReleaseIdentitySchema as E, CommerceResolveAssertionSchema as F, type GrantedTool as G, type CommerceResponseContract as H, CommerceResponseContractSchema as I, CommerceToolDefinitionSchema as J, type CommerceToolDraftDefinition as K, CommerceToolDraftDefinitionSchema as L, CommerceToolIdentitySchema as M, CommerceToolInputs as N, CommerceToolOutputs as O, CommerceToolResultSchema as P, CommerceToolRevisionIdentitySchema as Q, CommerceTurnIdentitySchema as R, type SubsetSchema as S, type ToolDescriptor as T, DetailsSchemaSchema as U, EMPTY_RESPONSE_CONTRACT as V, type ExternalHttpExecution as W, ExternalHttpExecutionSchema as X, GrantedToolSchema as Y, GrantedToolsSchema as Z, InputSchemaSchema as _, type CommerceConversationGrant as a, MONEY_PATTERN as a0, POLICY_OPERATIONS as a1, POLICY_OPERATION_DESCRIPTORS as a2, ReferralReasonSchema as a3, ResponseTemplateSchema as a4, ToolDescriptorSchema as a5, ToolNameSchema as a6, canonicalJson as a7, commerceToolResultSchema as a8, compileSubset as a9, definitionToMcpDescriptor as aa, finalResponseSchema as ab, finalResponseToolSchema as ac, jsonBytes as ad, mapToolArguments as ae, matchesSubset as af, productBelongsToDomain as ag, responseContractCanonicalJson as ah, safeName as ai, safePath as aj, toolHashInput as ak, validateDefinitionForPublication as al, validateDefinitionVersion as am, validateSubset as an, verifyResponseContract as ao, 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, CommerceConversationGrantSchema as i, type CommerceDefinitionCompiler as j, type CommerceDiscountCombinationFacts as k, CommerceDiscountCombinationFactsSchema as l, type CommerceDiscountConditionFacts as m, CommerceDiscountConditionFactsSchema as n, type CommerceDiscountDetails as o, CommerceDiscountDetailsSchema as p, CommerceErrorCodeSchema as q, type CommerceEvidence as r, CommerceEvidenceSchema as s, CommerceExecuteAssertionSchema as t, CommerceExecutionSchema as u, CommerceFinalResponseSchema as v, CommerceManifestSchema as w, CommerceOfferSchema as x, type CommerceProductSaleEvidence as y, CommerceProductSaleEvidenceSchema as z };
+export { type CommerceResponseDisposition as $, CommerceDiscountDetailsSchema as A, CommerceErrorCodeSchema as B, type CommerceTurnIdentity as C, type Digest as D, type CommerceEvidence as E, CommerceEvidenceSchema as F, type GrantedTool as G, CommerceExecuteAssertionSchema as H, CommerceExecutionSchema as I, CommerceFinalResponseSchema as J, CommerceManifestSchema as K, CommerceOfferSchema as L, type CommerceOptionalLookupUnavailable as M, CommerceOptionalLookupUnavailableSchema as N, type CommerceProductRecommendationSelection as O, type PublishedToolDescriptor as P, CommerceProductRecommendationSelectionSchema as Q, type CommerceProductSaleEvidence as R, type SubsetSchema as S, type ToolDescriptor as T, CommerceProductSaleEvidenceSchema as U, CommerceProductSchema as V, CommerceProposalSchema as W, CommerceReleaseIdentitySchema as X, CommerceResolveAssertionSchema as Y, type CommerceResponseContract as Z, CommerceResponseContractSchema as _, type CommerceConversationGrant as a, CommerceResponseDispositionSchema as a0, type CommerceShippingInformation as a1, type CommerceShippingInformationInput as a2, CommerceShippingInformationInputSchema as a3, CommerceShippingInformationSchema as a4, CommerceToolDefinitionSchema as a5, type CommerceToolDraftDefinition as a6, CommerceToolDraftDefinitionSchema as a7, CommerceToolIdentitySchema as a8, CommerceToolInputs as a9, finalResponseSchema as aA, finalResponseToolSchema as aB, isBuiltInTool as aC, jsonBytes as aD, mapToolArguments as aE, matchesSubset as aF, productBelongsToDomain as aG, responseContractCanonicalJson as aH, safeName as aI, safePath as aJ, toolHashInput as aK, validateDefinitionForPublication as aL, validateDefinitionVersion as aM, validateSubset as aN, verifyResponseContract as aO, CommerceToolOutputs as aa, CommerceToolResultSchema as ab, CommerceToolRevisionIdentitySchema as ac, CommerceTurnIdentitySchema as ad, DetailsSchemaSchema as ae, EMPTY_RESPONSE_CONTRACT as af, type ExternalHttpExecution as ag, ExternalHttpExecutionSchema as ah, GrantedToolSchema as ai, GrantedToolsSchema as aj, InputSchemaSchema as ak, type Json as al, MONEY_PATTERN as am, POLICY_OPERATIONS as an, POLICY_OPERATION_DESCRIPTORS as ao, type PublishedGrantedTool as ap, PublishedGrantedToolSchema as aq, PublishedToolDescriptorSchema as ar, ReferralReasonSchema as as, ResponseTemplateSchema as at, ToolDescriptorSchema as au, ToolNameSchema as av, canonicalJson as aw, commerceToolResultSchema as ax, compileSubset as ay, definitionToMcpDescriptor as az, type CommerceManifest as b, type CommerceToolResult as c, type CommerceFinalResponse as d, type CommerceBuiltInToolDescriptor as e, type CommerceToolDefinition as f, type CommerceBuiltInToolGrant as g, CommerceAlternativeSchema as h, type CommerceAnswerPresentationSelection as i, CommerceAnswerPresentationSelectionSchema as j, CommerceAssertionSchema as k, CommerceBasketSchema as l, CommerceBuiltInToolDescriptorSchema as m, CommerceBuiltInToolGrantSchema as n, CommerceBuiltInToolNameSchema as o, type CommerceCategoryCandidate as p, CommerceCategoryCandidateSchema as q, type CommerceCategoryResolution as r, CommerceCategoryResolutionSchema as s, CommerceConversationGrantSchema as t, type CommerceDefinitionCompiler as u, type CommerceDiscountCombinationFacts as v, CommerceDiscountCombinationFactsSchema as w, type CommerceDiscountConditionFacts as x, CommerceDiscountConditionFactsSchema as y, type CommerceDiscountDetails as z };

package/dist/{types-C0bsVczG.d.ts → types-COI4ckJc.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-CAw8y5nS.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-DUOmPh9C.js';
 import { S as StructuredLogger } from './types-B32wDMLO.js';
 
 /** Finite, non-customer-facing failure taxonomy for Commerce hosts and logs. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@modainteract/moda-interact-shared",
-  "version": "3.1.0",
+  "version": "5.0.0",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -154,7 +154,8 @@
     "validate:arch023-shared-entrypoints": "npm run build && node scripts/validate-arch023-shared-entrypoints.mjs",
     "validate:arch024-model-entrypoints": "npm run build && node scripts/validate-arch024-model-entrypoints.mjs",
     "test:arch033-incidents:postgres": "node scripts/test-arch033-incidents-postgres.mjs",
-    "validate:arch047-whatsapp-template-events": "node scripts/validate-whatsapp-template-events-entrypoint.mjs"
+    "validate:arch047-whatsapp-template-events": "node scripts/validate-whatsapp-template-events-entrypoint.mjs",
+    "test:product-discovery-contracts": "tsx --test src/commerce/product-discovery-contracts.test.ts src/commerce/product-discovery-projection.test.ts src/commerce/runner/built-in-tools.test.ts src/commerce/runner/runner.test.ts"
   },
   "dependencies": {
     "@opentelemetry/api": "^1.9.0",