@modainteract/moda-interact-shared 5.11.1 → 5.12.0

package/dist/wrapper-contracts-BcxDQPon.d.ts

@@ -0,0 +1,243 @@
+import { z } from 'zod';
+
+/** Admin's documented stable JSON hashing protocol, without importing its AST/compiler. */
+declare function stableJson(value: unknown): string;
+type PresentationDigest = (value: string) => string;
+declare function digest(value: string, sha256: PresentationDigest): string;
+/** Never parse localeAst.authoring. Fail closed if the compiled runtime projection is absent. */
+declare function readPreparedWrapper(localeAst: unknown, contentHash: string | null, sha256: PresentationDigest): {
+    kind: "ok";
+    prepared: PreparedWrapper;
+} | {
+    kind: "missing" | "invalid";
+};
+
+declare const Platform: z.ZodEnum<{
+    SHOPIFY: "SHOPIFY";
+    WOOCOMMERCE: "WOOCOMMERCE";
+}>;
+declare const ConversationProductImageBindingSchema: z.ZodObject<{
+    variable: z.ZodLiteral<"response.productImage">;
+    placement: z.ZodLiteral<"BEFORE_BODY">;
+    optional: z.ZodLiteral<true>;
+}, z.core.$strict>;
+type ConversationProductImageBinding = z.infer<typeof ConversationProductImageBindingSchema>;
+declare const ConversationProductPairSchema: z.ZodObject<{
+    productId: z.ZodString;
+    variantId: z.ZodNullable<z.ZodString>;
+}, z.core.$strict>;
+type ConversationProductPair = z.infer<typeof ConversationProductPairSchema>;
+declare const ConversationVerifiedProductsSchema: z.ZodObject<{
+    shopId: z.ZodString;
+    platform: z.ZodEnum<{
+        SHOPIFY: "SHOPIFY";
+        WOOCOMMERCE: "WOOCOMMERCE";
+    }>;
+    products: z.ZodArray<z.ZodObject<{
+        stock: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            status: z.ZodLiteral<"KNOWN">;
+            quantity: z.ZodNumber;
+            scope: z.ZodEnum<{
+                PRODUCT: "PRODUCT";
+                VARIANT: "VARIANT";
+            }>;
+        }, z.core.$strict>, z.ZodObject<{
+            status: z.ZodLiteral<"NOT_TRACKED">;
+        }, z.core.$strict>, z.ZodObject<{
+            status: z.ZodLiteral<"UNAVAILABLE">;
+        }, z.core.$strict>], "status">>;
+        description: z.ZodOptional<z.ZodPreprocess<z.ZodObject<{
+            status: z.ZodEnum<{
+                AVAILABLE: "AVAILABLE";
+                NOT_PROVIDED: "NOT_PROVIDED";
+                PARTIAL: "PARTIAL";
+            }>;
+            text: z.ZodString;
+        }, z.core.$strict>>>;
+        attributes: z.ZodOptional<z.ZodPreprocess<z.ZodObject<{
+            status: z.ZodEnum<{
+                AVAILABLE: "AVAILABLE";
+                NOT_PROVIDED: "NOT_PROVIDED";
+                PARTIAL: "PARTIAL";
+            }>;
+            items: z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                values: z.ZodArray<z.ZodString>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>>>;
+        options: z.ZodOptional<z.ZodPreprocess<z.ZodObject<{
+            status: z.ZodEnum<{
+                AVAILABLE: "AVAILABLE";
+                NOT_PROVIDED: "NOT_PROVIDED";
+                PARTIAL: "PARTIAL";
+            }>;
+            items: z.ZodArray<z.ZodObject<{
+                name: z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodString>;
+                values: z.ZodArray<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodString>>;
+                usedForVariants: z.ZodNullable<z.ZodBoolean>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>>>;
+        selectedOptions: z.ZodOptional<z.ZodPreprocess<z.ZodArray<z.ZodObject<{
+            name: z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodString>;
+            value: z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodString>;
+        }, z.core.$strict>>>>;
+        productId: z.ZodString;
+        variantId: z.ZodNullable<z.ZodString>;
+        title: z.ZodString;
+        url: z.ZodNullable<z.ZodURL>;
+        available: z.ZodNullable<z.ZodBoolean>;
+        unitPrice: z.ZodNullable<z.ZodString>;
+        currency: z.ZodNullable<z.ZodString>;
+        productType: z.ZodNullable<z.ZodString>;
+        vendor: z.ZodNullable<z.ZodString>;
+        categories: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        categoryIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        collectionIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        imageUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        saleEvidence: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            regularPrice: z.ZodNullable<z.ZodString>;
+            salePrice: z.ZodNullable<z.ZodString>;
+            observedAt: z.ZodISODateTime;
+        }, z.core.$strict>>>;
+        observedAt: z.ZodISODateTime;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+type ConversationVerifiedProducts = z.infer<typeof ConversationVerifiedProductsSchema>;
+declare const ConversationProductImageSourceSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"SOURCE">;
+    shopId: z.ZodString;
+    platform: z.ZodEnum<{
+        SHOPIFY: "SHOPIFY";
+        WOOCOMMERCE: "WOOCOMMERCE";
+    }>;
+    productId: z.ZodString;
+    variantId: z.ZodNullable<z.ZodString>;
+    sourceUrl: z.ZodString;
+}, z.core.$strict>;
+type ConversationProductImageSource = z.infer<typeof ConversationProductImageSourceSchema>;
+declare const ConversationPreparedProductImageSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    shopId: z.ZodString;
+    productId: z.ZodString;
+    variantId: z.ZodNullable<z.ZodString>;
+    publicUrl: z.ZodString;
+    objectKey: z.ZodString;
+    contentSha256: z.ZodString;
+    contentType: z.ZodLiteral<"image/jpeg">;
+    byteLength: z.ZodNumber;
+    width: z.ZodLiteral<1125>;
+    height: z.ZodLiteral<600>;
+}, z.core.$strict>;
+type ConversationPreparedProductImage = z.infer<typeof ConversationPreparedProductImageSchema>;
+declare const ConversationDeliveryPlanSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    kind: z.ZodLiteral<"TEXT">;
+    body: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    kind: z.ZodLiteral<"IMAGE">;
+    body: z.ZodString;
+    image: z.ZodObject<{
+        schemaVersion: z.ZodLiteral<1>;
+        shopId: z.ZodString;
+        productId: z.ZodString;
+        variantId: z.ZodNullable<z.ZodString>;
+        publicUrl: z.ZodString;
+        objectKey: z.ZodString;
+        contentSha256: z.ZodString;
+        contentType: z.ZodLiteral<"image/jpeg">;
+        byteLength: z.ZodNumber;
+        width: z.ZodLiteral<1125>;
+        height: z.ZodLiteral<600>;
+    }, z.core.$strict>;
+}, z.core.$strict>], "kind">;
+type ConversationDeliveryPlan = z.infer<typeof ConversationDeliveryPlanSchema>;
+declare function chooseConversationProductImageSource(input: {
+    shopId: string;
+    platform: z.infer<typeof Platform>;
+    displayedPairs: readonly ConversationProductPair[];
+    verifiedProducts: ConversationVerifiedProducts;
+}): ConversationProductImageSource | {
+    kind: 'OMITTED';
+    reason: 'NO_PRESENTED_PRODUCT' | 'NO_PRODUCT_IMAGE' | 'PRODUCT_NOT_VERIFIED';
+};
+type ConversationMediaOmission = 'BINDING_DISABLED' | 'NO_PRESENTED_PRODUCT' | 'CAPTION_TOO_LONG' | 'IMAGE_UNAVAILABLE' | 'IMAGE_IDENTITY_MISMATCH';
+declare function buildConversationDeliveryPlan(input: {
+    body: string;
+    binding?: ConversationProductImageBinding;
+    image?: ConversationPreparedProductImage | null;
+    shopId: string;
+    displayedPairs: readonly ConversationProductPair[];
+}): {
+    plan: ConversationDeliveryPlan;
+    mediaOmission: ConversationMediaOmission | null;
+};
+declare function digestConversationDeliveryPlan(plan: ConversationDeliveryPlan, sha256: PresentationDigest): string;
+
+/** Pure immutable wrapper projections. Host-owned persistence and sending stay outside Shared. */
+type WrapperSource = "AI" | "HUMAN";
+type WrapperAudience = "SHARED" | WrapperSource;
+type WrapperVariable = "customer.firstName" | "shop.name" | "checkout.url" | "shopBrand.brandName" | "shopBrand.logoUrl" | "shopBrand.logoAltText" | "shopBrand.logoWidth" | "shopBrand.logoHeight" | "shopBrand.squareLogoUrl" | "shopBrand.squareLogoAltText" | "shopBrand.coverImageUrl";
+type PreparedToken = Readonly<{
+    kind: "text";
+    value: string;
+}> | Readonly<{
+    kind: "variable";
+    name: WrapperVariable;
+}> | Readonly<{
+    kind: "responseSlot";
+    name: "response.body";
+}>;
+/** Admin emits this immutable projection in WhatsAppTemplateLocale.localeAst.prepared. */
+type PreparedWrapper = Readonly<{
+    schemaVersion: 1;
+    family: "MODA_CONVERSATION_WRAPPER";
+    responseSlot: "response.body";
+    productImage?: ConversationProductImageBinding;
+    header: readonly PreparedToken[];
+    body: readonly PreparedToken[];
+    footer: readonly PreparedToken[];
+    conditionals: readonly Readonly<{
+        when: "checkout.available";
+        tokens: readonly PreparedToken[];
+    }>[];
+}>;
+type VerifiedWrapperContext = Readonly<{
+    conversationId: string;
+    shopId: string;
+    conversationLanguageTag: string | null;
+    merchantLanguageTag: string | null;
+    variables: Partial<Record<WrapperVariable, string>>;
+    checkoutAvailable: boolean;
+}>;
+type WrapperDefinition = Readonly<{
+    id: string;
+    kind: string;
+    audience: string | null;
+    status: string;
+    sourceLanguageTag: string;
+    astSchemaVersion: number;
+    sourceHash: string;
+    publishedAt: Date | null;
+    retiredAt: Date | null;
+    createdByAdminId: string;
+    locales: readonly Readonly<{
+        id: string;
+        languageTag: string;
+        status: string;
+        providerLanguageCode: string | null;
+        localeAst: unknown;
+        contentHash: string | null;
+        reviewedAt: Date | null;
+        reviewedByAdminId: string | null;
+    }>[];
+}>;
+type WrapperSlot = Readonly<{
+    audience: string;
+    definitionId: string;
+    editVersion: number;
+    definition: WrapperDefinition;
+}>;
+type WrapperRefusal = "INVALID_INPUT" | "INVALID_LANGUAGE" | "CONVERSATION_UNAVAILABLE" | "TENANT_MISMATCH" | "NOT_CONFIGURED" | "DEFINITION_UNAVAILABLE" | "LOCALE_UNAVAILABLE" | "PREPARED_MISSING" | "PREPARED_INVALID" | "VARIABLE_UNAVAILABLE" | "ALREADY_WRAPPED" | "OUTPUT_TOO_LONG" | "REPLAY_MISMATCH";
+
+export { type ConversationPreparedProductImage as C, type PreparedWrapper as P, type VerifiedWrapperContext as V, type WrapperRefusal as W, type ConversationProductImageSource as a, type WrapperSlot as b, type WrapperDefinition as c, type PresentationDigest as d, type ConversationDeliveryPlan as e, ConversationDeliveryPlanSchema as f, type ConversationMediaOmission as g, ConversationPreparedProductImageSchema as h, type ConversationProductImageBinding as i, ConversationProductImageBindingSchema as j, ConversationProductImageSourceSchema as k, type ConversationProductPair as l, ConversationProductPairSchema as m, type ConversationVerifiedProducts as n, ConversationVerifiedProductsSchema as o, type PreparedToken as p, type WrapperAudience as q, type WrapperSource as r, type WrapperVariable as s, buildConversationDeliveryPlan as t, chooseConversationProductImageSource as u, digest as v, digestConversationDeliveryPlan as w, readPreparedWrapper as x, stableJson as y };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@modainteract/moda-interact-shared",
-  "version": "5.11.1",
+  "version": "5.12.0",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -138,6 +138,10 @@
     "./commerce/outreach": {
       "types": "./dist/commerce/outreach/index.d.ts",
       "import": "./dist/commerce/outreach/index.js"
+    },
+    "./commerce/presentation/node": {
+      "types": "./dist/commerce/presentation/node/index.d.ts",
+      "import": "./dist/commerce/presentation/node/index.js"
     }
   },
   "files": [
@@ -165,9 +169,11 @@
     "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",
     "validate:commerce-presentation": "node scripts/validate-commerce-presentation.mjs",
-    "validate:commerce-outreach": "node scripts/validate-commerce-outreach.mjs"
+    "validate:commerce-outreach": "node scripts/validate-commerce-outreach.mjs",
+    "validate:conversation-product-image-node": "node scripts/validate-conversation-product-image-node.mjs"
   },
   "dependencies": {
+    "@aws-sdk/client-s3": "3.1143.0",
     "@langchain/core": "1.2.13",
     "@langchain/langgraph": "1.4.15",
     "@langchain/openrouter": "0.4.15",
@@ -190,6 +196,7 @@
     "libphonenumber-js": "1.12.30",
     "parse5": "8.0.1",
     "semver": "7.8.5",
+    "sharp": "0.35.4",
     "winston": "3.19.0",
     "winston-loki": "6.1.7",
     "zod": "^4.0.0"

package/dist/chunk-5BIYNMMT.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/commerce/selection.ts","../src/commerce/product-context.ts"],"sourcesContent":["import { IdSchema } from \"./primitives\";\nimport {\n  CommerceAnswerPresentationSelectionSchema,\n  type CommerceAnswerPresentationSelection,\n  type CommerceManifest,\n  CommerceManifestSchema,\n  type CommerceConversationGrant,\n  CommerceConversationGrantSchema,\n} from \"./schemas\";\nimport { GrantedToolsSchema, PublishedToolDescriptorSchema, type GrantedTool, type PublishedGrantedTool, type PublishedToolDescriptor, type CommerceBuiltInToolDescriptor, isBuiltInTool } from \"./definitions\";\nimport { isTrustedCommerceBuiltInDescriptor, isTrustedCommerceBuiltInGrant } from \"./built-in-tools\";\nimport { canonicalJson } from \"./canonical-json\";\nexport type FeatureFacts = {\n  id: string;\n  active: boolean;\n  planMappingEnabled: boolean;\n  mode: \"ALWAYS_ENABLED\" | \"MERCHANT_OPT_IN\";\n  preferenceEnabled: boolean | null;\n};\nexport function selectCapabilities(\n  candidates: Array<{\n    key: string;\n    featureId: string;\n    enabled: boolean;\n    position: number;\n  }>,\n  facts: {\n    features: FeatureFacts[];\n  },\n) {\n  for (const candidate of candidates) {\n    IdSchema.parse(candidate.key);\n    IdSchema.parse(candidate.featureId);\n    if (!Number.isSafeInteger(candidate.position) || candidate.position < 0)\n      throw new TypeError(\"Invalid capability position\");\n  }\n  const selected = candidates\n    .filter((c) => {\n      if (!c.enabled) return false;\n      const f = facts.features.find((f) => f.id === c.featureId);\n      return (\n        !!f &&\n        f.active &&\n        f.planMappingEnabled &&\n        (f.mode === \"ALWAYS_ENABLED\" || f.preferenceEnabled === true)\n      );\n    })\n    .sort((a, b) => a.position - b.position);\n  if (\n    new Set(selected.map((c) => c.key)).size !== selected.length ||\n    new Set(selected.map((c) => c.position)).size !== selected.length\n  )\n    throw new TypeError(\"Duplicate release membership\");\n  return selected.map((c) => c.key);\n}\nexport function deduplicateTools(\n  capabilities: Array<{ key: string; toolDescriptor: PublishedToolDescriptor }>,\n  builtInTools: readonly CommerceBuiltInToolDescriptor[] = [],\n): GrantedTool[] {\n  const byId = new Map<string, { tool: PublishedGrantedTool; descriptor: string }>();\n  const names = new Map<string, string>();\n  for (const cap of capabilities) {\n    const d = PublishedToolDescriptorSchema.parse(cap.toolDescriptor);\n    const previous = byId.get(d.toolId);\n    const descriptor = canonicalJson(d);\n    if (\n      (previous && previous.descriptor !== descriptor) ||\n      (names.has(d.name) && names.get(d.name) !== d.toolId)\n    )\n      throw new TypeError(\"Conflicting tool association\");\n    names.set(d.name, d.toolId);\n    if (previous)\n      previous.tool.capabilityKeys = [\n        ...new Set([...previous.tool.capabilityKeys, cap.key]),\n      ].sort();\n    else\n      byId.set(d.toolId, {\n        descriptor,\n        tool: {\n          toolId: d.toolId,\n          toolRevisionId: d.toolRevisionId,\n          toolName: d.name,\n          definitionVersion: d.definitionVersion,\n          capabilityKeys: [cap.key],\n        },\n      });\n  }\n  if (builtInTools.some(tool => !isTrustedCommerceBuiltInDescriptor(tool)))\n    throw new TypeError(\"Untrusted built-in descriptor\");\n  return GrantedToolsSchema.parse([\n    ...[...byId.values()].map(value => value.tool),\n    ...builtInTools.map(tool => ({\n      kind: \"BUILT_IN\" as const, toolName: tool.name,\n      definitionVersion: tool.definitionVersion,\n    })),\n  ]).sort((a, b) => a.toolName.localeCompare(b.toolName, \"en\"));\n}\nexport function manifestMatchesGrant(\n  manifest: CommerceManifest,\n  grant: CommerceConversationGrant,\n) {\n  if (!CommerceManifestSchema.safeParse(manifest).success || !CommerceConversationGrantSchema.safeParse(grant).success) return false;\n  return (\n    manifest.releaseId === grant.releaseId &&\n    canonicalJson(manifest.purposeProfile ?? null) === canonicalJson(grant.purposeProfile ?? null) &&\n    canonicalJson(manifest.selectedCapabilityKeys) ===\n      canonicalJson(grant.selectedCapabilityKeys) &&\n    canonicalJson(\n      [...manifest.grantedTools].sort((a, b) =>\n        a.toolName.localeCompare(b.toolName),\n      ),\n    ) ===\n      canonicalJson(\n        [...grant.grantedTools].sort((a, b) =>\n          a.toolName.localeCompare(b.toolName),\n        ),\n      )\n  );\n}\nexport const parseCommerceManifest = (raw: unknown) =>\n  CommerceManifestSchema.parse(raw);\nexport function currentlyGrantedTools(\n  grant: CommerceConversationGrant,\n  eligibleCapabilityKeys: ReadonlySet<string>,\n  enabledToolIds: ReadonlySet<string>,\n  allowedBuiltInTools: readonly CommerceBuiltInToolDescriptor[] = [],\n) {\n  return grant.grantedTools.filter(\n    (t) =>\n      isBuiltInTool(t)\n        ? isTrustedCommerceBuiltInGrant(t) && allowedBuiltInTools.some(descriptor =>\n            isTrustedCommerceBuiltInDescriptor(descriptor) && descriptor.name === t.toolName &&\n            descriptor.definitionVersion === t.definitionVersion)\n        : enabledToolIds.has(t.toolId) && t.capabilityKeys.some((k) => eligibleCapabilityKeys.has(k)),\n  );\n}\n\n/** Validate model-selected identities; hosts must still authorize and freshly verify facts. */\nexport function verifyCommerceAnswerPresentationSelection(raw: unknown):\n  | { kind: \"verified\"; selection: CommerceAnswerPresentationSelection }\n  | { kind: \"limitation\"; reason: \"INVALID_SELECTION\" } {\n  const parsed = CommerceAnswerPresentationSelectionSchema.safeParse(raw);\n  if (!parsed.success || (parsed.data.productOptionSelections?.length && parsed.data.productDetailSelections?.length))\n    return { kind: \"limitation\", reason: \"INVALID_SELECTION\" };\n  return { kind: \"verified\", selection: parsed.data };\n}\n","import { z } from \"zod\";\nimport { CommerceProductSchema, CommerceProductSelectedOptionsSchema } from \"./schemas.js\";\nconst id = z.string().min(1).max(128);\nconst date = z.iso.datetime({offset:false});\nexport const CommerceConversationProductContextSchema = z.strictObject({schemaVersion:z.literal(1),shopId:id,conversationId:id,platform:z.enum([\"SHOPIFY\",\"WOOCOMMERCE\"]),references:z.array(z.strictObject({productId:id,variantId:id.nullable(),title:z.string().min(1).max(512),selectedOptions:CommerceProductSelectedOptionsSchema.optional(),observedAt:date})).max(20),presentation:z.strictObject({references:z.array(z.strictObject({productId:id,variantId:id.nullable()})).max(3),presentedAt:date}).optional(),updatedAt:date}).superRefine((v,c)=>{\n const pairs=v.presentation?.references??[];\n if(new Set(pairs.map(r=>JSON.stringify([r.productId,r.variantId]))).size!==pairs.length||pairs.some(p=>!v.references.some(r=>r.productId===p.productId&&r.variantId===p.variantId)))c.addIssue({code:'custom',message:'Invalid product presentation'});\n const valid=(value:string,kind:string)=>v.platform === \"SHOPIFY\" ? new RegExp(`^gid://shopify/${kind}/[1-9][0-9]*$`).test(value) : /^[1-9][0-9]*$/.test(value) && Number.isSafeInteger(Number(value));\n if(v.references.some(r=>!valid(r.productId,\"Product\")||(r.variantId!==null&&!valid(r.variantId,\"ProductVariant\")))||new TextEncoder().encode(JSON.stringify(v)).length>32768)c.addIssue({code:\"custom\",message:\"Invalid product context\"});\n});\nexport type CommerceConversationProductContext = z.infer<typeof CommerceConversationProductContextSchema>;\nexport type CommerceProductObservation = {toolName:string;products:z.infer<typeof CommerceProductSchema>[];observedAt:string};\nexport type CommerceProductContextIdentity = {shopId:string;conversationId:string;platform:\"SHOPIFY\"|\"WOOCOMMERCE\";now:number};\nexport function mergeConversationProductContext(previous:CommerceConversationProductContext|null,observations:readonly CommerceProductObservation[],identity:CommerceProductContextIdentity):CommerceConversationProductContext {\n id.parse(identity.shopId);id.parse(identity.conversationId);z.enum([\"SHOPIFY\",\"WOOCOMMERCE\"]).parse(identity.platform);if(!Number.isFinite(identity.now))throw new Error(\"PRODUCT_CONTEXT_TIME_INVALID\");\n let admitted=false;\n if(previous){previous=CommerceConversationProductContextSchema.parse(previous);if(previous.shopId!==identity.shopId||previous.conversationId!==identity.conversationId||previous.platform!==identity.platform)throw new Error(\"PRODUCT_CONTEXT_IDENTITY_MISMATCH\");}\n const fresh=(time:string)=>Number.isFinite(Date.parse(time))&&Date.parse(time)<=identity.now&&Date.parse(time)>=identity.now-86400000;\n const entries=new Map<string,CommerceConversationProductContext[\"references\"][number]>();\n const add=(r:CommerceConversationProductContext[\"references\"][number])=>{if(!fresh(r.observedAt))return;const key=JSON.stringify([r.productId,r.variantId]);const old=entries.get(key);if(!old||Date.parse(r.observedAt)>=Date.parse(old.observedAt))entries.set(key,r);};\n if(previous&&fresh(previous.updatedAt))previous.references.forEach(add);\n for(const o of observations){if(![\"commerce_search_products\",\"commerce_get_product\"].includes(o.toolName)||!fresh(o.observedAt))continue;for(const raw of o.products){const p=CommerceProductSchema.parse(raw);admitted=true;add({productId:p.productId,variantId:p.variantId,title:p.title,...(p.selectedOptions!==undefined?{selectedOptions:p.selectedOptions}:{}),observedAt:o.observedAt});}}\n const references=[...entries.values()].sort((a,b)=>Date.parse(b.observedAt)-Date.parse(a.observedAt)||(a.productId<b.productId?-1:a.productId>b.productId?1:0)||((a.variantId??\"\")<(b.variantId??\"\")?-1:(a.variantId??\"\")>(b.variantId??\"\")?1:0)).slice(0,20);\n const result:CommerceConversationProductContext={schemaVersion:1 as const,shopId:identity.shopId,conversationId:identity.conversationId,platform:identity.platform,references,updatedAt:admitted?new Date(identity.now).toISOString():previous&&fresh(previous.updatedAt)?previous.updatedAt:new Date(identity.now).toISOString()};\n if(previous?.presentation&&fresh(previous.presentation.presentedAt)&&previous.presentation.references.every(p=>references.some(r=>r.productId===p.productId&&r.variantId===p.variantId)))result.presentation=previous.presentation;\n while(references.length&&new TextEncoder().encode(JSON.stringify(result)).length>32768){references.pop();if(result.presentation?.references.some(p=>!references.some(r=>r.productId===p.productId&&r.variantId===p.variantId)))delete result.presentation;}\n return CommerceConversationProductContextSchema.parse(result);\n}\nexport function resolveConversationProductReference(context:CommerceConversationProductContext,reference:{productId?:string;variantId?:string|null;title?:string}):{kind:\"MATCH\";productId:string;variantId:string|null}|{kind:\"AMBIGUOUS\"}|{kind:\"MISSING\"}{\n const parsed=CommerceConversationProductContextSchema.parse(context);\n const matches=parsed.references.filter(r=>(reference.productId!==undefined?r.productId===reference.productId:reference.title!==undefined&&r.title.trim().toLowerCase()===reference.title.trim().toLowerCase())&&(reference.variantId===undefined||r.variantId===reference.variantId));\n const unique=[...new Map(matches.map(r=>[JSON.stringify([r.productId,r.variantId]),r])).values()];return unique.length===1?{kind:\"MATCH\",productId:unique[0]!.productId,variantId:unique[0]!.variantId}:unique.length>1?{kind:\"AMBIGUOUS\"}:{kind:\"MISSING\"};\n}\n\n/** Record only exact pairs actually composed by the host; references remain stale labels. */\nexport function recordCommerceProductPresentation(context:CommerceConversationProductContext,pairs:readonly {productId:string;variantId:string|null}[],identity:CommerceProductContextIdentity):CommerceConversationProductContext {\n const fresh=mergeConversationProductContext(context,[],identity);\n const parsed=z.array(z.strictObject({productId:id,variantId:id.nullable()})).max(3).safeParse(pairs);\n if(!parsed.success||new Set(pairs.map(p=>JSON.stringify([p.productId,p.variantId]))).size!==pairs.length||pairs.some(p=>!fresh.references.some(r=>r.productId===p.productId&&r.variantId===p.variantId)))throw new Error('PRODUCT_PRESENTATION_INVALID');\n const result:CommerceConversationProductContext={...fresh,presentation:{references:parsed.data,presentedAt:new Date(identity.now).toISOString()}};\n while(result.references.length&&new TextEncoder().encode(JSON.stringify(result)).length>32768){result.references.pop();if(result.presentation?.references.some(p=>!result.references.some(r=>r.productId===p.productId&&r.variantId===p.variantId)))delete result.presentation;}\n return CommerceConversationProductContextSchema.parse(result);\n}\n"],"mappings":"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","names":["f"]}