@modainteract/moda-interact-shared 3.0.0 → 4.0.0

package/README.md

@@ -2382,3 +2382,70 @@ Type-only exports:
 - `RunnerTool`
 
 </details>
+
+
+## Product discovery and code-owned discount contracts
+
+The existing `/commerce` entrypoint exports `CommerceCategoryCandidateSchema`,
+`CommerceCategoryResolutionSchema`, `CommerceOptionalLookupUnavailableSchema`,
+`CommerceConversationToolContextSchema`, and
+`CommerceProductRecommendationSelectionSchema`, with matching inferred types.
+The product input/output dictionaries include category resolution and flat,
+category-aware search. Recommendation selection contains identifiers and quantity,
+not model-authored prices or savings; applicability and cross-field relationships
+remain service policy.
+
+`CommerceBuiltInToolDescriptorSchema`, `CommerceBuiltInToolGrantSchema`,
+`commerceDiscountBuiltInDescriptors`, and `commerceBuiltInToolContractPayload`
+define the two code-owned discount reads. Their checked-in SHA256 hashes cover
+the name, version, description, bounded input schema and actual generated output
+schema using canonical JSON. The helper returns canonical text; hashing is
+injected by the trusted Node adapter. Reading these exports needs no Node crypto
+or provider/database configuration.
+
+Grants and runner descriptors now explicitly distinguish published identities
+from `kind: "BUILT_IN"`. Built-ins have no fabricated tool/revision IDs or
+capability provenance. Manifest `builtInTools` defaults to an empty array, but
+retained grants must equal the exact canonical descriptor set as well as the
+published capability union. `deduplicateTools` accepts the optional built-in
+descriptor set; `currentlyGrantedTools` requires an explicit currently permitted
+canonical built-in set and otherwise denies built-ins. Hosts still check current
+tenant/turn/release/permission before and after asynchronous tool work.
+
+The runtime runner version is **1.1.0**. Optional lookup unavailability is data
+inside `status: "OK"`; hard errors, stale turns and required referrals retain
+their existing semantics. Details permit bounded nullable scalars and depth five;
+input depth stays three and details payloads stay at 16KiB.
+
+These inferred output/grant changes require the coordinated **4.0.0** publication
+and consumer migrations in the separate release task. This source change does
+not bump package metadata or publish to a registry.
+
+Run `npm run test:product-discovery-contracts` for the focused contracts/runner
+fixtures. To execute the actual Commerce-owned projector/publication integration,
+set `COMMERCE_CONTRACT_SOURCE_ROOT` to its explicit accepted source checkout.
+The test passes candidate schemas as function arguments to that existing
+projector; it neither changes nor links the consumer's installed package.
+The installed consumer still has the released operation registry: candidate operation
+metadata is checked against candidate Shared, and the installed publication pipeline
+is exercised with a registered operation and the actual generated input schema.
+This does not certify consumer adoption of the new operations before release.
+Without this test-only source prerequisite, that integration case is explicitly
+skipped rather than reported as executed.
+
+The discovery input dictionary also supports explicit `browse` (default `false`)
+and the published `commerce_get_shipping_information` operation
+(`shipping.getInformation`, version `1.0.0`). The named
+`CommerceShippingInformationInputSchema` / `CommerceShippingInformationSchema`
+and inferred types expose bounded native facts and independent product/policy outcomes.
+Policy HTML remains untrusted data; adapters enforce ownership, status relationships,
+verified hosts and the UTF-8 body budget.
+
+`CommerceResponseDispositionSchema` / `CommerceResponseDisposition` and
+`CommerceAnswerPresentationSelectionSchema` / `CommerceAnswerPresentationSelection`
+add optional identifier-only presentation fields. Merge their shape with recommendation
+and existing release details; Commerce owns explicit published instructions, and Background
+owns controlled composition. Product-bearing shipping observations latch that host path even
+without a selection; policy-only observations alone may retain ordinary grounded answers.
+Expected limitations never clear a terminal tool error. The default empty response contract,
+hard-referral envelope and two-tool discount built-in allowlist remain unchanged.

package/dist/ai-response-delay.d.ts

@@ -0,0 +1,26 @@
+import { z } from 'zod';
+
+/** Version shared by hosted Woo API and Shopify response-delay settings. */
+declare const AI_RESPONSE_DELAY_SCHEMA_VERSION: 1;
+/** Merchant-selected additional wait before an AI reply; human replies are not delayed. */
+declare const AiResponseDelayMinutesSchema: z.ZodNumber;
+/** Wire revision shape. Consumers must also validate that timestamp values parse as real dates. */
+declare const AiResponseDelayRevisionSchema: z.ZodUnion<readonly [z.ZodLiteral<"UNCONFIGURED">, z.ZodString]>;
+/** Canonical GET and successful PUT response shared by hosted Woo API and Shopify. */
+declare const MerchantAiResponseDelayReadV1Schema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    revision: z.ZodUnion<readonly [z.ZodLiteral<"UNCONFIGURED">, z.ZodString]>;
+    aiResponseDelayMinutes: z.ZodNumber;
+}, z.core.$strict>;
+/** Canonical optimistic-concurrency PUT request shared by hosted Woo API and Shopify. */
+declare const MerchantAiResponseDelayWriteV1Schema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    expectedRevision: z.ZodUnion<readonly [z.ZodLiteral<"UNCONFIGURED">, z.ZodString]>;
+    aiResponseDelayMinutes: z.ZodNumber;
+}, z.core.$strict>;
+type AiResponseDelayMinutes = z.infer<typeof AiResponseDelayMinutesSchema>;
+type AiResponseDelayRevision = z.infer<typeof AiResponseDelayRevisionSchema>;
+type MerchantAiResponseDelayReadV1 = z.infer<typeof MerchantAiResponseDelayReadV1Schema>;
+type MerchantAiResponseDelayWriteV1 = z.infer<typeof MerchantAiResponseDelayWriteV1Schema>;
+
+export { AI_RESPONSE_DELAY_SCHEMA_VERSION, type AiResponseDelayMinutes, AiResponseDelayMinutesSchema, type AiResponseDelayRevision, AiResponseDelayRevisionSchema, type MerchantAiResponseDelayReadV1, MerchantAiResponseDelayReadV1Schema, type MerchantAiResponseDelayWriteV1, MerchantAiResponseDelayWriteV1Schema };

package/dist/ai-response-delay.js

@@ -0,0 +1,26 @@
+// src/ai-response-delay.ts
+import { z } from "zod";
+var AI_RESPONSE_DELAY_SCHEMA_VERSION = 1;
+var AiResponseDelayMinutesSchema = z.number().int().min(0).max(30);
+var AiResponseDelayRevisionSchema = z.union([
+  z.literal("UNCONFIGURED"),
+  z.string().regex(/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z$/)
+]);
+var MerchantAiResponseDelayReadV1Schema = z.strictObject({
+  schemaVersion: z.literal(AI_RESPONSE_DELAY_SCHEMA_VERSION),
+  revision: AiResponseDelayRevisionSchema,
+  aiResponseDelayMinutes: AiResponseDelayMinutesSchema
+});
+var MerchantAiResponseDelayWriteV1Schema = z.strictObject({
+  schemaVersion: z.literal(AI_RESPONSE_DELAY_SCHEMA_VERSION),
+  expectedRevision: AiResponseDelayRevisionSchema,
+  aiResponseDelayMinutes: AiResponseDelayMinutesSchema
+});
+export {
+  AI_RESPONSE_DELAY_SCHEMA_VERSION,
+  AiResponseDelayMinutesSchema,
+  AiResponseDelayRevisionSchema,
+  MerchantAiResponseDelayReadV1Schema,
+  MerchantAiResponseDelayWriteV1Schema
+};
+//# sourceMappingURL=ai-response-delay.js.map

package/dist/ai-response-delay.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/ai-response-delay.ts"],"sourcesContent":["import { z } from \"zod\";\n\n/** Version shared by hosted Woo API and Shopify response-delay settings. */\nexport const AI_RESPONSE_DELAY_SCHEMA_VERSION = 1 as const;\n\n/** Merchant-selected additional wait before an AI reply; human replies are not delayed. */\nexport const AiResponseDelayMinutesSchema = z.number().int().min(0).max(30);\n\n/** Wire revision shape. Consumers must also validate that timestamp values parse as real dates. */\nexport const AiResponseDelayRevisionSchema = z.union([\n  z.literal(\"UNCONFIGURED\"),\n  z.string().regex(/^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}\\.\\d{3}Z$/),\n]);\n\n/** Canonical GET and successful PUT response shared by hosted Woo API and Shopify. */\nexport const MerchantAiResponseDelayReadV1Schema = z.strictObject({\n  schemaVersion: z.literal(AI_RESPONSE_DELAY_SCHEMA_VERSION),\n  revision: AiResponseDelayRevisionSchema,\n  aiResponseDelayMinutes: AiResponseDelayMinutesSchema,\n});\n\n/** Canonical optimistic-concurrency PUT request shared by hosted Woo API and Shopify. */\nexport const MerchantAiResponseDelayWriteV1Schema = z.strictObject({\n  schemaVersion: z.literal(AI_RESPONSE_DELAY_SCHEMA_VERSION),\n  expectedRevision: AiResponseDelayRevisionSchema,\n  aiResponseDelayMinutes: AiResponseDelayMinutesSchema,\n});\n\nexport type AiResponseDelayMinutes =\n  z.infer<typeof AiResponseDelayMinutesSchema>;\nexport type AiResponseDelayRevision =\n  z.infer<typeof AiResponseDelayRevisionSchema>;\nexport type MerchantAiResponseDelayReadV1 =\n  z.infer<typeof MerchantAiResponseDelayReadV1Schema>;\nexport type MerchantAiResponseDelayWriteV1 =\n  z.infer<typeof MerchantAiResponseDelayWriteV1Schema>;\n"],"mappings":";AAAA,SAAS,SAAS;AAGX,IAAM,mCAAmC;AAGzC,IAAM,+BAA+B,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,IAAI,EAAE;AAGnE,IAAM,gCAAgC,EAAE,MAAM;AAAA,EACnD,EAAE,QAAQ,cAAc;AAAA,EACxB,EAAE,OAAO,EAAE,MAAM,+CAA+C;AAClE,CAAC;AAGM,IAAM,sCAAsC,EAAE,aAAa;AAAA,EAChE,eAAe,EAAE,QAAQ,gCAAgC;AAAA,EACzD,UAAU;AAAA,EACV,wBAAwB;AAC1B,CAAC;AAGM,IAAM,uCAAuC,EAAE,aAAa;AAAA,EACjE,eAAe,EAAE,QAAQ,gCAAgC;AAAA,EACzD,kBAAkB;AAAA,EAClB,wBAAwB;AAC1B,CAAC;","names":[]}

package/dist/{chunk-H7AUKACO.js → chunk-HR7T3UEW.js}

@@ -40,7 +40,7 @@ var keywords = [
 ];
 function validateSubset(value, mode) {
   let propertyCount = 0;
-  const maxDepth = mode === "input" ? 3 : 4;
+  const maxDepth = mode === "input" ? 3 : 5;
   function walk(raw, depth) {
     if (depth > maxDepth || !raw || typeof raw !== "object" || Array.isArray(raw))
       return false;
@@ -50,7 +50,7 @@ function validateSubset(value, mode) {
     ))
       return false;
     const nullable = Array.isArray(s.type);
-    if (nullable && (mode !== "input" || s.type.length !== 2 || s.type[1] !== "null"))
+    if (nullable && (s.type.length !== 2 || s.type[1] !== "null" || mode === "details" && ["object", "array"].includes(s.type[0])))
       return false;
     const type = typeof s.type === "string" ? s.type : s.type[0];
     if (![
@@ -255,17 +255,14 @@ var DEFINITION_SIZE_MESSAGE = "Definition exceeds the 65536-byte jsonb text limi
 
 // src/commerce/definitions.ts
 var ToolNameSchema = z3.string().regex(/^[a-z][a-z0-9_]{0,127}$/).refine((n) => n !== "finalResponse");
-var GrantedToolSchema = z3.strictObject({
+var PublishedGrantedToolSchema = z3.strictObject({
   toolId: IdSchema,
   toolRevisionId: IdSchema,
   toolName: ToolNameSchema,
   definitionVersion: SemverSchema,
   capabilityKeys: z3.array(IdSchema).min(1).max(32).refine((v) => distinct(v) && v.join("\0") === [...v].sort().join("\0"))
 });
-var GrantedToolsSchema = z3.array(GrantedToolSchema).max(32).refine(
-  (v) => distinct(v.map((x) => x.toolId)) && distinct(v.map((x) => x.toolName))
-);
-var ToolDescriptorSchema = z3.strictObject({
+var PublishedToolDescriptorSchema = z3.strictObject({
   toolId: IdSchema,
   toolRevisionId: IdSchema,
   name: ToolNameSchema,
@@ -273,6 +270,31 @@ var ToolDescriptorSchema = z3.strictObject({
   description: z3.string().min(1).max(4096),
   inputSchema: InputSchemaSchema
 });
+var CommerceBuiltInToolNameSchema = z3.enum([
+  "commerce_get_discount_options",
+  "commerce_get_discount_details"
+]).meta({ maxLength: 29 });
+var CommerceBuiltInToolGrantSchema = z3.strictObject({
+  kind: z3.enum(["BUILT_IN"]).meta({ maxLength: 8 }),
+  toolName: CommerceBuiltInToolNameSchema,
+  definitionVersion: z3.enum(["1.0.0"]).meta({ maxLength: 5 }),
+  contractHash: HashSchema
+});
+var CommerceBuiltInToolDescriptorSchema = z3.strictObject({
+  kind: z3.enum(["BUILT_IN"]).meta({ maxLength: 8 }),
+  name: CommerceBuiltInToolNameSchema,
+  definitionVersion: z3.enum(["1.0.0"]).meta({ maxLength: 5 }),
+  contractHash: HashSchema,
+  description: z3.string().min(1).max(4096),
+  inputSchema: InputSchemaSchema
+});
+var GrantedToolSchema = z3.union([PublishedGrantedToolSchema, CommerceBuiltInToolGrantSchema]);
+var ToolDescriptorSchema = z3.union([PublishedToolDescriptorSchema, CommerceBuiltInToolDescriptorSchema]);
+var GrantedToolsSchema = z3.array(GrantedToolSchema).max(32).refine((values) => {
+  const published = values.filter((value) => !("kind" in value));
+  return distinct(values.map((value) => value.toolName)) && distinct(published.map((value) => value.toolId));
+});
+var isBuiltInTool = (value) => "kind" in value && value.kind === "BUILT_IN";
 var MappingSchema = z3.union([
   z3.strictObject({
     input: z3.string().refine(safeName),
@@ -282,6 +304,10 @@ var MappingSchema = z3.union([
 ]);
 var MappingsSchema = z3.record(z3.string().refine(safeName), MappingSchema).refine((v) => Object.keys(v).length <= 32);
 var POLICY_OPERATIONS = [
+  "taxonomy.resolveCategories",
+  "products.search",
+  "products.get",
+  "shipping.getInformation",
   "recovery.getBasket",
   "shopify.searchProducts",
   "discounts.getOptions",
@@ -499,6 +525,13 @@ var POLICY_OPERATION_DESCRIPTORS = POLICY_OPERATIONS.map(
   (operation) => ({ operation, operationVersion: "1.0.0" })
 );
 
+// src/commerce/built-in-tools.ts
+import { z as z6 } from "zod";
+
+// src/commerce/schemas.ts
+import { z as z5 } from "zod";
+import { validRange } from "semver";
+
 // src/commerce/response.ts
 import { z as z4 } from "zod";
 var CommerceResponseContractSchema = z4.strictObject({
@@ -676,8 +709,6 @@ function finalResponseToolSchema(definition) {
 }
 
 // src/commerce/schemas.ts
-import { z as z5 } from "zod";
-import { validRange } from "semver";
 var CommerceTurnIdentitySchema = z5.strictObject({
   contractVersion: ContractVersionSchema,
   shopId: IdSchema,
@@ -700,7 +731,7 @@ var CommerceConversationGrantSchema = z5.strictObject({
   if (v.expiresAt && Date.parse(v.expiresAt) <= Date.parse(v.createdAt))
     c.addIssue({ code: "custom", message: "Invalid grant retention date" });
   if (jsonBytes(v.grantedTools) > 65536 || jsonBytes(v.selectedCapabilityKeys) > 8192 || v.grantedTools.some(
-    (t) => t.capabilityKeys.some((k) => !v.selectedCapabilityKeys.includes(k))
+    (t) => isBuiltInTool(t) ? !isTrustedCommerceBuiltInGrant(t) : t.capabilityKeys.some((k) => !v.selectedCapabilityKeys.includes(k))
   ))
     c.addIssue({ code: "custom", message: "Unselected grant provenance" });
 });
@@ -714,7 +745,7 @@ var CommerceManifestSchema = z5.strictObject({
       key: IdSchema,
       featureId: IdSchema,
       position: z5.number().int().nonnegative(),
-      toolDescriptor: ToolDescriptorSchema
+      toolDescriptor: PublishedToolDescriptorSchema
     })
   ).max(32),
   featureBehaviours: z5.array(
@@ -724,6 +755,7 @@ var CommerceManifestSchema = z5.strictObject({
     })
   ).max(32),
   selectedCapabilityKeys: z5.array(IdSchema).max(32).refine(distinct),
+  builtInTools: z5.array(CommerceBuiltInToolDescriptorSchema).max(2).default([]),
   grantedTools: GrantedToolsSchema,
   responseContract: CommerceResponseContractSchema,
   responseContractHash: HashSchema
@@ -765,7 +797,8 @@ var CommerceManifestSchema = z5.strictObject({
         }
       });
   }
-  if (union.size !== v.grantedTools.length || v.grantedTools.some((t) => {
+  if (union.size + v.builtInTools.length !== v.grantedTools.length || !distinct(v.builtInTools.map((tool) => tool.name)) || v.builtInTools.some((tool) => !isTrustedCommerceBuiltInDescriptor(tool)) || v.grantedTools.some((t) => {
+    if (isBuiltInTool(t)) return !v.builtInTools.some((descriptor) => descriptor.name === t.toolName && descriptor.definitionVersion === t.definitionVersion && descriptor.contractHash === t.contractHash && isTrustedCommerceBuiltInGrant(t));
     const expected = union.get(t.toolId)?.tool;
     return !expected || expected.toolRevisionId !== t.toolRevisionId || expected.toolName !== t.toolName || expected.definitionVersion !== t.definitionVersion || JSON.stringify([...new Set(expected.capabilityKeys)].sort()) !== JSON.stringify(t.capabilityKeys);
   }))
@@ -1003,11 +1036,117 @@ function commerceToolResultSchema(data) {
 var CommerceToolResultSchema = commerceToolResultSchema(
   boundedJson(262144)
 );
+var wireId = z5.string().min(1).max(128);
+var taxonomySource = z5.enum(["SHOPIFY_STANDARD_PRODUCT_TAXONOMY"]).meta({ maxLength: 33 });
+var CommerceCategoryCandidateSchema = z5.strictObject({
+  categoryId: wireId,
+  name: z5.string().min(1).max(512),
+  fullName: z5.string().min(1).max(4096),
+  parentId: wireId.nullable(),
+  level: z5.number().int().min(0).max(32),
+  ancestorIds: z5.array(wireId).max(32),
+  distance: z5.number().min(0).max(2)
+});
+var CommerceCategoryResolutionSchema = z5.union([
+  z5.strictObject({
+    outcome: z5.enum(["CANDIDATES", "NO_CANDIDATES"]).meta({ maxLength: 13 }),
+    generationId: wireId,
+    source: taxonomySource,
+    taxonomyVersion: z5.string().min(1).max(64),
+    languageTag: z5.string().min(1).max(35),
+    candidates: z5.array(CommerceCategoryCandidateSchema).max(10)
+  }),
+  z5.strictObject({
+    outcome: z5.enum(["UNAVAILABLE"]).meta({ maxLength: 11 }),
+    reasonCode: z5.enum(["NOT_READY", "TEMPORARY_UNAVAILABLE"]).meta({ maxLength: 21 })
+  })
+]);
+var CommerceOptionalLookupUnavailableSchema = z5.strictObject({
+  outcome: z5.enum(["UNAVAILABLE"]).meta({ maxLength: 11 }),
+  reasonCode: z5.enum(["TEMPORARY_UNAVAILABLE"]).meta({ maxLength: 21 })
+});
+var CommerceConversationToolContextSchema = z5.strictObject({
+  purpose: z5.enum(["CONVERSATION"]).meta({ maxLength: 12 }),
+  conversationId: IdSchema,
+  inboundVersion: z5.number().int().positive(),
+  grantId: IdSchema.nullable()
+});
+var CommerceProductRecommendationSelectionSchema = z5.strictObject({
+  productRecommendationVersion: z5.enum(["1"]).meta({ maxLength: 1 }).optional(),
+  productRecommendations: z5.array(z5.strictObject({
+    scope: z5.enum(["PRODUCT_ONLY", "ADD_TO_BASKET", "REPLACE_BASKET_LINE"]).meta({ maxLength: 19 }),
+    basketLineId: wireId.nullable(),
+    productId: wireId,
+    variantId: wireId.nullable(),
+    quantity: z5.number().int().min(1).max(99),
+    promotionKind: z5.enum(["NONE", "NATIVE_SALE", "DISCOUNT"]).meta({ maxLength: 11 }),
+    offerIds: z5.array(wireId).max(3)
+  })).min(1).max(3).optional()
+});
+var CommerceResponseDispositionSchema = z5.enum([
+  "STANDARD",
+  "OUT_OF_SCOPE_REDIRECT",
+  "SHIPPING_INFORMATION_UNVERIFIED"
+]).meta({ maxLength: 31 });
+var CommerceAnswerPresentationSelectionSchema = z5.strictObject({
+  responseDisposition: CommerceResponseDispositionSchema.optional(),
+  shippingInformationSelection: z5.strictObject({
+    productId: wireId.nullable(),
+    variantId: wireId.nullable()
+  }).optional()
+});
+var CommerceShippingInformationInputSchema = z5.strictObject({
+  productId: wireId.nullable().default(null),
+  variantId: wireId.nullable().default(null)
+});
+var CommerceShippingInformationSchema = z5.strictObject({
+  provider: z5.enum(["SHOPIFY", "WOOCOMMERCE"]).meta({ maxLength: 11 }),
+  observedAt: DateSchema,
+  product: z5.strictObject({
+    status: z5.enum(["NOT_REQUESTED", "VARIANT_REQUIRED", "AVAILABLE"]).meta({ maxLength: 16 }),
+    productId: wireId.nullable(),
+    variantId: wireId.nullable(),
+    requiresShipping: z5.boolean().nullable(),
+    virtual: z5.boolean().nullable(),
+    weight: z5.strictObject({
+      value: z5.number().min(0),
+      unit: z5.enum(["GRAMS", "KILOGRAMS", "OUNCES", "POUNDS"]).meta({ maxLength: 9 }).nullable()
+    }).nullable(),
+    dimensions: z5.strictObject({
+      length: z5.number().min(0).nullable(),
+      width: z5.number().min(0).nullable(),
+      height: z5.number().min(0).nullable(),
+      unit: z5.string().min(1).max(16).nullable()
+    }).nullable(),
+    shippingClassId: wireId.nullable(),
+    shippingClassSlug: z5.string().min(1).max(512).nullable()
+  }),
+  policy: z5.strictObject({
+    status: z5.enum(["AVAILABLE", "NOT_CONFIGURED", "SCOPE_NOT_GRANTED", "UNSUPPORTED"]).meta({ maxLength: 17 }),
+    trust: z5.enum(["UNTRUSTED_REFERENCE"]).meta({ maxLength: 19 }),
+    title: z5.string().min(1).max(512).nullable(),
+    bodyStatus: z5.enum(["AVAILABLE", "EMPTY", "TOO_LARGE", "NOT_AVAILABLE"]).meta({ maxLength: 13 }),
+    bodyHtml: z5.string().min(1).max(8e3).nullable(),
+    url: z5.url({ protocol: /^https$/ }).min(1).max(2048).nullable(),
+    updatedAt: DateSchema.nullable()
+  })
+});
 var limit = z5.number().int().min(1).max(3).default(3);
 var CommerceToolInputs = {
+  commerce_resolve_product_categories: z5.strictObject({
+    query: z5.string().min(1).max(200),
+    limit: z5.number().int().min(1).max(10).default(5)
+  }),
+  commerce_get_shipping_information: CommerceShippingInformationInputSchema,
   commerce_get_basket: z5.strictObject({}),
   commerce_search_products: z5.strictObject({
-    query: z5.string().min(1).max(200),
+    query: z5.string().min(1).max(200).nullable().default(null),
+    category: z5.strictObject({
+      system: z5.enum(["SHOPIFY_STANDARD_PRODUCT_TAXONOMY", "WOOCOMMERCE_PRODUCT_CATEGORY"]).meta({ maxLength: 33 }),
+      id: wireId,
+      taxonomyVersion: z5.string().min(1).max(64).nullable()
+    }).optional(),
+    browse: z5.boolean().default(false),
     maximumPrice: MoneySchema.optional(),
     availableOnly: z5.boolean().default(true),
     limit: z5.number().int().min(1).max(20).default(10),
@@ -1042,6 +1181,8 @@ var alternatives = z5.strictObject({
   truncated: z5.boolean()
 });
 var CommerceToolOutputs = {
+  commerce_resolve_product_categories: CommerceCategoryResolutionSchema,
+  commerce_get_shipping_information: CommerceShippingInformationSchema,
   commerce_get_basket: CommerceBasketSchema,
   commerce_search_products: z5.strictObject({
     products: z5.array(CommerceProductSchema).max(20),
@@ -1051,15 +1192,15 @@ var CommerceToolOutputs = {
   commerce_get_product: z5.strictObject({
     product: CommerceProductSchema.nullable()
   }),
-  commerce_get_discount_options: z5.strictObject({
+  commerce_get_discount_options: z5.union([CommerceOptionalLookupUnavailableSchema, z5.strictObject({
     mode: z5.enum(["NONE", "FIXED", "AI_BEST_APPLICABLE"]),
     offers: z5.array(CommerceOfferSchema).max(50),
     truncated: z5.boolean(),
     cursor: z5.string().max(2048).nullable().optional()
-  }),
-  commerce_get_discount_details: z5.strictObject({
+  })]),
+  commerce_get_discount_details: z5.union([CommerceOptionalLookupUnavailableSchema, z5.strictObject({
     details: CommerceDiscountDetailsSchema.nullable()
-  }),
+  })]),
   commerce_evaluate_discount: CommerceEvidenceSchema,
   commerce_find_qualifying_products: alternatives,
   commerce_find_similar_products: alternatives
@@ -1072,6 +1213,58 @@ function productBelongsToDomain(product, verifiedDomain) {
   }
 }
 
+// src/commerce/built-in-tools.ts
+function immutable(value) {
+  for (const child of Object.values(value))
+    if (child && typeof child === "object") immutable(child);
+  return Object.freeze(value);
+}
+var commerceDiscountBuiltInDescriptors = immutable([
+  {
+    kind: "BUILT_IN",
+    name: "commerce_get_discount_options",
+    definitionVersion: "1.0.0",
+    contractHash: "a0a4a88c7920a25a31657a03761b6556419189aeab251261a58e2dfb83a3bdcb",
+    description: "Read the current shop's permitted discount options.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        limit: { type: "integer", minimum: 1, maximum: 50 },
+        cursor: { type: ["string", "null"], maxLength: 2048 }
+      },
+      additionalProperties: false
+    }
+  },
+  {
+    kind: "BUILT_IN",
+    name: "commerce_get_discount_details",
+    definitionVersion: "1.0.0",
+    contractHash: "776f6bc6ac1800c75744c2ffa7357f07a32be2b61309b1d71abf0493a2de316f",
+    description: "Read details for a permitted discount in the current shop.",
+    inputSchema: {
+      type: "object",
+      properties: { offerId: { type: "string", minLength: 1, maxLength: 128 } },
+      required: ["offerId"],
+      additionalProperties: false
+    }
+  }
+]);
+function commerceBuiltInToolContractPayload(descriptor) {
+  return canonicalJson({
+    name: descriptor.name,
+    definitionVersion: descriptor.definitionVersion,
+    description: descriptor.description,
+    inputSchema: descriptor.inputSchema,
+    outputSchema: z6.toJSONSchema(CommerceToolOutputs[descriptor.name], { io: "output", unrepresentable: "any" })
+  });
+}
+function isTrustedCommerceBuiltInDescriptor(value) {
+  return commerceDiscountBuiltInDescriptors.some((expected) => canonicalJson(expected) === canonicalJson(value));
+}
+function isTrustedCommerceBuiltInGrant(value) {
+  return commerceDiscountBuiltInDescriptors.some((expected) => value.toolName === expected.name && value.definitionVersion === expected.definitionVersion && value.contractHash === expected.contractHash);
+}
+
 export {
   MONEY_PATTERN,
   safeName,
@@ -1101,9 +1294,15 @@ export {
   ConnectionIssueSchema,
   ConnectionResultSchema,
   ToolNameSchema,
+  PublishedGrantedToolSchema,
+  PublishedToolDescriptorSchema,
+  CommerceBuiltInToolNameSchema,
+  CommerceBuiltInToolGrantSchema,
+  CommerceBuiltInToolDescriptorSchema,
   GrantedToolSchema,
-  GrantedToolsSchema,
   ToolDescriptorSchema,
+  GrantedToolsSchema,
+  isBuiltInTool,
   POLICY_OPERATIONS,
   ExternalHttpExecutionSchema,
   CommerceExecutionSchema,
@@ -1118,6 +1317,10 @@ export {
   CommerceToolIdentitySchema,
   CommerceToolRevisionIdentitySchema,
   POLICY_OPERATION_DESCRIPTORS,
+  commerceDiscountBuiltInDescriptors,
+  commerceBuiltInToolContractPayload,
+  isTrustedCommerceBuiltInDescriptor,
+  isTrustedCommerceBuiltInGrant,
   CommerceResponseContractSchema,
   EMPTY_RESPONSE_CONTRACT,
   ReferralReasonSchema,
@@ -1145,8 +1348,17 @@ export {
   CommerceErrorCodeSchema,
   commerceToolResultSchema,
   CommerceToolResultSchema,
+  CommerceCategoryCandidateSchema,
+  CommerceCategoryResolutionSchema,
+  CommerceOptionalLookupUnavailableSchema,
+  CommerceConversationToolContextSchema,
+  CommerceProductRecommendationSelectionSchema,
+  CommerceResponseDispositionSchema,
+  CommerceAnswerPresentationSelectionSchema,
+  CommerceShippingInformationInputSchema,
+  CommerceShippingInformationSchema,
   CommerceToolInputs,
   CommerceToolOutputs,
   productBelongsToDomain
 };
-//# sourceMappingURL=chunk-H7AUKACO.js.map
+//# sourceMappingURL=chunk-HR7T3UEW.js.map