@tbox.cn/app-module-promotion 0.2.0 → 0.9.4

package/dist/chunk-QOTX4XDS.js

@@ -0,0 +1,1745 @@
+// src/server/index.ts
+import { definePreTool, getRequestContext, loadModuleSkills } from "@tbox.cn/app-sdk/server";
+import { Router } from "express";
+import { toMallQueryContext as toMallQueryContext4, withMallScopeFromQuery } from "@tbox.cn/app-contracts-mall";
+
+// src/server/ports.ts
+import {
+  mallScopeOf,
+  PROMOTION_ACQUISITION_SERVICE,
+  PROMOTION_ACTIVITIES_SERVICE,
+  PROMOTION_ENTITLEMENTS_SERVICE,
+  PROMOTION_OFFERS_SERVICE
+} from "@tbox.cn/app-contracts-mall";
+import { isExpectedProviderAbsence } from "@tbox.cn/app-contracts";
+
+// src/server/service.ts
+var now = () => (/* @__PURE__ */ new Date()).toISOString();
+var inDays = (d) => new Date(Date.now() + d * 864e5).toISOString();
+var DEMO_OFFERS = [
+  {
+    offerRef: "demo:coupon:1001",
+    offerType: "COUPON",
+    title: "\u6EE1 100 \u51CF 20 \u5143\u5238",
+    subtitle: "\u5168\u573A\u901A\u7528\uFF08\u90E8\u5206\u7279\u4F8B\u5546\u54C1\u9664\u5916\uFF09",
+    tags: ["\u901A\u7528"],
+    validity: { start: now(), end: inDays(30) },
+    facets: [{ kind: "COUPON", discountType: "AMOUNT", value: 2e3, thresholdCents: 1e4 }],
+    availability: { status: "AVAILABLE", reasonCodes: [], evaluatedAt: now(), authoritative: false },
+    participation: { mode: "CLAIM_THEN_PURCHASE", steps: [{ title: "\u9886\u53D6", description: "\u70B9\u51FB\u9886\u53D6\u540E\u81EA\u52A8\u5B58\u5165\u5361\u5305" }] }
+  },
+  {
+    offerRef: "demo:coupon:1002",
+    offerType: "COUPON",
+    title: "\u9910\u996E 85 \u6298\u5238",
+    subtitle: "\u9650\u9910\u996E\u697C\u5C42\u95E8\u5E97",
+    tags: ["\u9910\u996E"],
+    validity: { start: now(), end: inDays(15) },
+    facets: [{ kind: "COUPON", discountType: "PERCENTAGE", value: 85, thresholdCents: 5e3 }],
+    availability: { status: "AVAILABLE", reasonCodes: [], evaluatedAt: now(), authoritative: false }
+  },
+  {
+    offerRef: "demo-c:groupon:2001",
+    offerType: "GROUPON",
+    title: "\u53CC\u4EBA\u9910\u56E2\u8D2D 129 \u5143",
+    tags: ["\u56E2\u8D2D", "\u9910\u996E"],
+    validity: { end: inDays(20) },
+    facets: [{ kind: "GROUPON", requiredParticipants: 2 }],
+    availability: { status: "AVAILABLE", reasonCodes: [], evaluatedAt: now(), authoritative: true }
+  }
+];
+var DEMO_ACTIVITY = {
+  activityRef: "demo-act:3001",
+  title: "\u5468\u672B\u4EB2\u5B50\u5E02\u96C6",
+  subtitle: "\u624B\u4F5C\u4F53\u9A8C + \u4EB2\u5B50\u6E38\u620F",
+  categoryId: "family",
+  registrationRequired: true,
+  remainingQuota: 12,
+  startAt: inDays(3),
+  endAt: inDays(4),
+  offerRefs: ["demo:coupon:1002"],
+  description: "\u672C\u5468\u672B\u4E2D\u5EAD\u4EB2\u5B50\u5E02\u96C6\uFF0C\u542B 10+ \u624B\u4F5C\u644A\u4F4D",
+  sessions: [
+    { sessionRef: "s_1", title: "\u7B2C\u4E00\u573A 10:00-12:00", startAt: inDays(3), remainingQuota: 5, status: "OPEN" },
+    { sessionRef: "s_2", title: "\u7B2C\u4E8C\u573A 14:00-16:00", startAt: inDays(3), remainingQuota: 7, status: "OPEN" }
+  ],
+  guide: {
+    steps: [
+      { title: "\u9886\u53D6\u4F18\u60E0\u5238", description: "\u9886\u53D6\u9910\u996E 85 \u6298\u5238\uFF0C\u5E02\u96C6\u9910\u996E\u644A\u4F4D\u53EF\u7528" },
+      { title: "\u9009\u62E9\u573A\u6B21\u62A5\u540D", description: "\u51ED\u62A5\u540D\u7801\u5165\u573A" }
+    ],
+    conditions: ["\u9650\u4F1A\u5458\u672C\u4EBA\u53C2\u4E0E", "\u6BCF\u573A\u9650\u91CF 20 \u7EC4\u5BB6\u5EAD"]
+  }
+};
+var InMemoryPromotionService = class {
+  supportsAcquisition = true;
+  entitlements = /* @__PURE__ */ new Map();
+  operations = /* @__PURE__ */ new Map();
+  acquireKeys = /* @__PURE__ */ new Map();
+  // idempotencyKey → operationRef
+  async searchOffers(_q, input) {
+    const keyword = input.keyword?.trim();
+    const typed = input.offerTypes?.length ? DEMO_OFFERS.filter((offer) => input.offerTypes.includes(offer.offerType)) : DEMO_OFFERS;
+    const items = keyword ? typed.filter((o) => o.title.includes(keyword) || o.tags.some((t) => t.includes(keyword))) : typed;
+    const limit = Math.min(50, input.limit ?? 10);
+    return { items: items.slice(0, limit), hasMore: items.length > limit };
+  }
+  async getOfferDetail(_q, input) {
+    if (input.offerRef) return DEMO_OFFERS.find((o) => o.offerRef === input.offerRef) ?? null;
+    if (input.entitlementRef) {
+      for (const list of this.entitlements.values()) {
+        const ent = list.find((e) => e.entitlementRef === input.entitlementRef);
+        if (ent?.offerRef) return DEMO_OFFERS.find((o) => o.offerRef === ent.offerRef) ?? null;
+      }
+      return null;
+    }
+    if (input.keyword) {
+      const page = await this.searchOffers(_q, { keyword: input.keyword, limit: 1 });
+      return page.items[0] ?? null;
+    }
+    return null;
+  }
+  async recommendOffers(q, input) {
+    const page = await this.searchOffers(q, { ...input, limit: 3 });
+    return page.items;
+  }
+  async calculateBestDeal(_q, input) {
+    const candidates = input.candidateOfferRefs ? DEMO_OFFERS.filter((o) => input.candidateOfferRefs.includes(o.offerRef)) : DEMO_OFFERS;
+    let best = {
+      offerRef: "",
+      title: "\u6682\u65E0\u9002\u7528\u4F18\u60E0",
+      estimatedSavingCents: 0,
+      reason: "\u5F53\u524D\u91D1\u989D\u672A\u8FBE\u5230\u53EF\u7528\u95E8\u69DB",
+      candidatesConsidered: candidates.length
+    };
+    for (const offer of candidates) {
+      const facet = offer.facets.find((f) => f.kind === "COUPON");
+      if (!facet) continue;
+      const threshold = facet.thresholdCents ?? 0;
+      if (input.currentAmountCents < threshold) continue;
+      const saving = facet.discountType === "AMOUNT" ? facet.value : Math.round(input.currentAmountCents * (100 - facet.value) / 100);
+      if (saving > best.estimatedSavingCents) {
+        best = {
+          offerRef: offer.offerRef,
+          title: offer.title,
+          estimatedSavingCents: saving,
+          reason: `\u6EE1 ${(threshold / 100).toFixed(0)} \u5143\u53EF\u7528\uFF0C\u9884\u8BA1\u7701 ${(saving / 100).toFixed(2)} \u5143`,
+          candidatesConsidered: candidates.length
+        };
+      }
+    }
+    return best;
+  }
+  async listEntitlements(q, _input) {
+    const items = this.entitlementsOf(q);
+    return { items, hasMore: false };
+  }
+  async getEntitlementDetail(q, entitlementRef) {
+    return this.entitlementsOf(q).find((e) => e.entitlementRef === entitlementRef) ?? null;
+  }
+  async listActivities(_q, input) {
+    const { sessions: _s, guide: _g, ...activity } = DEMO_ACTIVITY;
+    void _s;
+    void _g;
+    const keyword = input.keyword?.trim();
+    const matchesKeyword = !keyword || `${activity.title} ${activity.subtitle ?? ""}`.includes(keyword);
+    const matchesRegistration = input.registrationRequired === void 0 || activity.registrationRequired === input.registrationRequired;
+    const matchesCategory = !input.categoryId || activity.categoryId === input.categoryId;
+    return {
+      items: matchesKeyword && matchesRegistration && matchesCategory ? [activity] : [],
+      hasMore: false
+    };
+  }
+  async getActivityDetail(_q, activityRef) {
+    return DEMO_ACTIVITY.activityRef === activityRef ? DEMO_ACTIVITY : null;
+  }
+  async listActivitySessions(_q, activityRef) {
+    return activityRef === DEMO_ACTIVITY.activityRef ? DEMO_ACTIVITY.sessions : [];
+  }
+  async listActivityCategories() {
+    return [{ categoryId: "family", name: "\u4EB2\u5B50" }];
+  }
+  async acquire(q, input) {
+    const existingRef = this.acquireKeys.get(input.idempotencyKey);
+    if (existingRef) {
+      const existing = this.operations.get(existingRef);
+      if (existing) return existing;
+    }
+    const offer = DEMO_OFFERS.find((o) => o.offerRef === input.offerRef);
+    const operationRef = `op_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`;
+    const operation = offer ? { operationRef, status: "SUCCEEDED", offerRef: offer.offerRef, codeMasked: "AB**CD**EF", observedAt: now() } : { operationRef, status: "REJECTED", offerRef: input.offerRef, code: "30017", message: "\u4F18\u60E0\u4E0D\u5B58\u5728\u6216\u4E0D\u53EF\u9886\u53D6", observedAt: now() };
+    if (offer) {
+      const list = this.entitlements.get(q.subjectId ?? "anon") ?? [];
+      list.unshift({
+        entitlementRef: `ent_${operationRef}`,
+        offerRef: offer.offerRef,
+        title: offer.title,
+        entitlementType: offer.offerType,
+        status: "EFFECTIVE",
+        codeMasked: "AB**CD**EF",
+        validUntil: offer.validity.end
+      });
+      this.entitlements.set(q.subjectId ?? "anon", list);
+    }
+    this.operations.set(operationRef, operation);
+    this.acquireKeys.set(input.idempotencyKey, operationRef);
+    return operation;
+  }
+  entitlementsOf(q) {
+    return this.entitlements.get(q.subjectId ?? "anon") ?? [];
+  }
+};
+
+// src/server/ports.ts
+var inMemoryPromotion = new InMemoryPromotionService();
+async function resolvePromotionSlot(service, reqCtx, ctx, fallback) {
+  if (!ctx?.integrations) return fallback;
+  try {
+    return await ctx.integrations.resolveService({
+      service,
+      scope: mallScopeOf(reqCtx),
+      request: reqCtx
+    });
+  } catch (e) {
+    if (isExpectedProviderAbsence(e)) return fallback;
+    throw e;
+  }
+}
+var resolvePromotionOffersPort = (reqCtx, ctx) => resolvePromotionSlot(PROMOTION_OFFERS_SERVICE, reqCtx, ctx, inMemoryPromotion);
+var resolvePromotionEntitlementsPort = (reqCtx, ctx) => resolvePromotionSlot(PROMOTION_ENTITLEMENTS_SERVICE, reqCtx, ctx, inMemoryPromotion);
+var resolvePromotionActivitiesPort = (reqCtx, ctx) => resolvePromotionSlot(PROMOTION_ACTIVITIES_SERVICE, reqCtx, ctx, inMemoryPromotion);
+var resolvePromotionAcquisitionPort = (reqCtx, ctx) => resolvePromotionSlot(PROMOTION_ACQUISITION_SERVICE, reqCtx, ctx, inMemoryPromotion);
+
+// src/server/cards/promotion-offer-list/meta.ts
+import { promotionOfferListCardDataSchema } from "@tbox.cn/app-contracts-mall";
+
+// src/server/cards/promotion-offer-list/samples.ts
+function couponImage(accent) {
+  return `data:image/svg+xml;utf8,<svg xmlns="http://www.w3.org/2000/svg" width="240" height="180"><rect width="240" height="180" rx="12" fill="%23f2f4f7"/><rect x="0" y="0" width="240" height="52" rx="12" fill="%23${accent}" opacity="0.85"/><rect x="20" y="76" width="140" height="16" rx="4" fill="%23d5dae2"/><rect x="20" y="104" width="96" height="12" rx="3" fill="%23e3e7ed"/><circle cx="196" cy="128" r="26" fill="none" stroke="%23c6ccd6" stroke-width="4" stroke-dasharray="6 6"/></svg>`;
+}
+var IMG = {
+  coffee: couponImage("8a5a3b"),
+  lifestyle: couponImage("3d5a80"),
+  dining: couponImage("9e2b25")
+};
+var claimAction = (label, title) => [{
+  kind: "send",
+  label,
+  value: `\u6211\u8981${label}\u300C${title}\u300D`
+}];
+var claimableOffers = [
+  {
+    offerRef: "offer:coffee-30",
+    title: "\u745E\u5E78\u5496\u5561\uFF08\u676D\u5DDE\u62F1\u5885\u793A\u4F8B\u5E97\uFF09\uFF5C30\u5143\u996E\u54C1\u4EE3\u91D1\u5238",
+    subtitle: "1F \xB7 \u5230\u5E97\u70B9\u5355\u53EF\u7528 \xB7 \u7206\u5356674\u4E07+",
+    offerType: "COUPON",
+    benefitText: "\xA530",
+    priceText: "\u514D\u8D39",
+    originalPriceText: "\xA530",
+    claimable: true,
+    availabilityStatus: "AVAILABLE",
+    validityText: "\u9886\u53D6\u540E 30 \u5929\u5185\u6709\u6548",
+    imageUrl: IMG.coffee,
+    tags: ["\u996E\u54C1"],
+    itemActions: claimAction("\u9886\u53D6", "30\u5143\u996E\u54C1\u4EE3\u91D1\u5238")
+  },
+  {
+    offerRef: "offer:lifestyle-120",
+    title: "KKV 120\u5143\u4F18\u60E0\u5238",
+    subtitle: "2F \xB7 \u5168\u573A\u7CBE\u9009\u5546\u54C1\u53EF\u7528",
+    offerType: "COUPON",
+    benefitText: "\xA5105 \xB7 8.8\u6298",
+    priceText: "\xA5105",
+    originalPriceText: "\xA5120",
+    discountLabel: "8.8\u6298",
+    claimable: true,
+    availabilityStatus: "AVAILABLE",
+    validityText: "\u6709\u6548\u671F\u81F3 2026-09-30",
+    imageUrl: IMG.lifestyle,
+    tags: ["\u96F6\u552E"],
+    claimActionLabel: "\u62A2\u8D2D",
+    itemActions: claimAction("\u62A2\u8D2D", "KKV 120\u5143\u4F18\u60E0\u5238")
+  },
+  {
+    offerRef: "offer:dining-30",
+    title: "\u5357\u4EAC\u5927\u724C\u6863\uFF5C\u62DB\u724C\u83DC\u54C130\u5143\u65E0\u95E8\u69DB\u5238",
+    subtitle: "4F \xB7 \u5468\u672B\u53CA\u8282\u5047\u65E5\u901A\u7528",
+    offerType: "COUPON",
+    benefitText: "\xA530",
+    priceText: "\xA528.8",
+    originalPriceText: "\xA538.8",
+    discountLabel: "7.5\u6298",
+    stockText: "\u5269\u4F59 29 \u4EFD",
+    usageSceneText: "\u5230\u5E97\u51FA\u793A\u5238\u7801\u6838\u9500",
+    guaranteeText: "\u968F\u65F6\u9000 \xB7 \u8FC7\u671F\u81EA\u52A8\u9000",
+    claimable: true,
+    availabilityStatus: "AVAILABLE",
+    validityText: "\u6709\u6548\u671F\u81F3 2026-10-08",
+    imageUrl: IMG.dining,
+    tags: ["\u9910\u996E"],
+    claimActionLabel: "\u62A2\u8D2D",
+    itemActions: claimAction("\u62A2\u8D2D", "\u62DB\u724C\u83DC\u54C130\u5143\u65E0\u95E8\u69DB\u5238")
+  }
+];
+var samples = [
+  {
+    label: "\u9886\u5238\xB7\u591A\u5238\u5217\u8868",
+    note: "\u5546\u573A\u795E\u5238\u4E3B\u6001\uFF1A\u5238\u56FE\u3001\u957F\u6807\u9898\u3001\u5229\u76CA\u70B9\u548C\u67E5\u770B\u5165\u53E3\u540C\u5C4F",
+    group: "\u9886\u5238\u5217\u8868",
+    data: { mode: "claimable", presentation: "coupon", summary: "\u5F53\u524D\u5546\u573A \xB7 \u4F18\u60E0\u7CBE\u9009", items: claimableOffers }
+  },
+  {
+    label: "\u9886\u5238\xB7\u5C55\u5F00\u4E0E\u6536\u8D77",
+    note: "maxItems \u622A\u65AD + \u900F\u660E\u5E95\u90E8\u5165\u53E3\u4E0E\u95E8\u5E97\u5BFC\u89C8\u5BF9\u9F50\uFF0C\u6587\u5B57\u53F3\u4FA7\u7BAD\u5934\u968F\u5C55\u5F00\u72B6\u6001\u5207\u6362",
+    group: "\u9886\u5238\u5217\u8868",
+    data: { mode: "claimable", presentation: "coupon", maxItems: 2, items: claimableOffers }
+  },
+  {
+    label: "\u9886\u5238\xB7\u7F3A\u56FE\u4E0E\u957F\u6587\u6848",
+    note: "\u7F3A\u56FE\u8D70\u4E2D\u6027\u7070\u515C\u5E95\uFF08\u4E0D\u5E26\u8272\u76F8\uFF0C\u514D\u5F97\u6BD4\u771F\u56FE\u8FD8\u62A2\u773C\uFF09+ \u4E24\u884C\u6807\u9898\u622A\u65AD\uFF0C\u4E0D\u5E94\u6539\u53D8\u884C\u9AD8\u4E0E\u6309\u94AE\u5BF9\u9F50",
+    group: "\u9886\u5238\u5217\u8868",
+    data: {
+      mode: "claimable",
+      presentation: "coupon",
+      summary: "\u90E8\u5206\u4F18\u60E0\u8D44\u683C\u6709\u53D8\u5316",
+      items: [{
+        ...claimableOffers[0],
+        offerRef: "offer:no-image",
+        imageUrl: void 0,
+        title: "\u4F1A\u5458\u9650\u5B9A\u8D85\u957F\u540D\u79F0\u6D4B\u8BD5\uFF5C\u4EC5\u9650\u672C\u5468\u672B\u6307\u5B9A\u65F6\u6BB5\u5230\u5E97\u6D88\u8D39\u4F7F\u7528\u7684\u6EE1\u51CF\u4F18\u60E0\u5238",
+        subtitle: "\u9650\u5468\u672B\u53CA\u8282\u5047\u65E5 \xB7 \u6BCF\u4EBA\u6BCF\u65E5\u4E00\u5F20",
+        benefitText: "\u6EE1100\u51CF20",
+        priceText: "\u514D\u8D39",
+        originalPriceText: "\xA520",
+        itemActions: claimAction("\u9886\u53D6", "\u4F1A\u5458\u9650\u5B9A\u6EE1\u51CF\u4F18\u60E0\u5238")
+      }]
+    }
+  },
+  {
+    label: "\u9886\u5238\xB7\u6EE4\u6389\u4E0D\u53EF\u9886",
+    note: "\u5217\u8868\u53EA\u5448\u73B0\u80FD\u9886\u7684\uFF1A\u4E09\u6761\u91CC\u4E00\u6761 claimable=false\uFF0C\u6E32\u67D3\u51FA\u6765\u5E94\u53EA\u6709\u4E24\u884C\u2014\u2014\u5217\u51FA\u9886\u4E0D\u4E86\u7684\u5238\uFF0C\u7528\u6237\u70B9\u4E00\u6B21\u624D\u77E5\u9053\u70B9\u4E0D\u52A8",
+    group: "\u9886\u5238\u5217\u8868",
+    data: {
+      mode: "claimable",
+      presentation: "coupon",
+      items: [
+        claimableOffers[0],
+        { ...claimableOffers[1], offerRef: "offer:sold-out", claimable: false, availabilityStatus: "UNAVAILABLE" },
+        claimableOffers[2]
+      ]
+    }
+  },
+  {
+    label: "\u9886\u5238\xB7\u7A7A\u6001",
+    note: "\u5F53\u524D\u6CA1\u6709\u53EF\u9886\u53D6\u4F18\u60E0\u65F6\u7684\u660E\u786E\u89E3\u91CA",
+    group: "\u9886\u5238\u5217\u8868",
+    data: { mode: "claimable", presentation: "coupon", items: [], noResultsReason: "\u5F53\u524D\u6682\u65E0\u53EF\u9886\u53D6\u4F18\u60E0\uFF0C\u7A0D\u540E\u518D\u6765\u770B\u770B" }
+  },
+  {
+    label: "\u5238\xB7\u5B9A\u5411\u5355\u5F20",
+    note: "\u7528\u6237\u95EE\u300CXX \u5238\u7684\u8BE6\u60C5\u300D\u65F6\u7684\u843D\u70B9\uFF1A\u51FA\u8FD9\u4E00\u5F20\u5238\u7684\u5238\u884C\uFF08mode=search\u2014\u2014\u7528\u6237\u6307\u540D\u8981\u770B\u7684\u641C\u7D22\u6001\uFF09\uFF0C\u70B9\u5F00\u6D6E\u5C42\u770B\u8BE6\u60C5\u5E76\u9886\u53D6\u3002\u4E0D\u50CF\u9886\u5238\u6001\u90A3\u6837\u6EE4\u6389\u4E0D\u53EF\u9886\u2014\u2014\u6307\u540D\u8981\u770B\u7684\u5238\u5373\u4FBF\u5F53\u4E0B\u9886\u4E0D\u4E86\u4E5F\u7167\u6837\u5448\u73B0",
+    group: "\u9886\u5238\u5217\u8868",
+    data: {
+      mode: "search",
+      presentation: "coupon",
+      items: [{ ...claimableOffers[2], claimable: false, availabilityStatus: "UNAVAILABLE" }]
+    }
+  }
+];
+
+// src/server/cards/promotion-offer-list/meta.ts
+var meta = {
+  cardType: "promotion-offer-list",
+  dataSchema: promotionOfferListCardDataSchema,
+  displayName: "\u4F18\u60E0\u5217\u8868",
+  description: "\u4F18\u60E0\u3001\u4FC3\u9500\u3001\u5238\u4E0E\u63A8\u8350\u56DB\u79CD legacy \u5C55\u793A\u8BED\u4E49",
+  sampleData: {
+    presentation: "promotion",
+    mode: "search",
+    summary: "\u672C\u5468\u503C\u5F97\u5173\u6CE8\u7684\u6D3B\u52A8",
+    items: [{ offerRef: "demo:promotion:1001", title: "\u4F1A\u5458\u590F\u65E5\u793C\u9047", subtitle: "\u9650\u65F6\u4F1A\u5458\u4E13\u4EAB", offerType: "PROMOTION", benefitText: "\u6EE1\u989D\u8D60\u793C", claimable: true, availabilityStatus: "AVAILABLE", validityText: "\u6709\u6548\u671F\u81F3 2026-08-31", tags: ["\u4F1A\u5458"] }]
+  },
+  samples,
+  schemaVersion: 1
+};
+var meta_default = meta;
+
+// src/server/cards/promotion-offer-detail/meta.ts
+import { promotionOfferDetailCardDataSchema } from "@tbox.cn/app-contracts-mall";
+var meta2 = {
+  cardType: "promotion-offer-detail",
+  dataSchema: promotionOfferDetailCardDataSchema,
+  displayName: "\u4F18\u60E0\u8BE6\u60C5",
+  description: "\u4F18\u60E0\u8BE6\u60C5 + \u9886\u53D6\uFF08\u52A8\u4F5C promotion.acquire\uFF09",
+  sampleData: {
+    presentation: "coupon",
+    offerRef: "demo:coupon:1001",
+    title: "\u6EE1 100 \u51CF 20 \u5143\u5238",
+    offerType: "COUPON",
+    benefitText: "\u6EE1 100 \u51CF 20",
+    subtitle: "\u4F1A\u5458\u4E13\u4EAB",
+    validityText: "\u6709\u6548\u671F\u81F3 2026-08-31",
+    rules: ["\u5355\u7B14\u6EE1 100 \u53EF\u7528", "\u9650\u9886 1 \u5F20"],
+    steps: [{ title: "\u9886\u53D6\u4F18\u60E0", description: "\u8FDB\u5165\u4F1A\u5458\u5238\u5305\u5B8C\u6210\u9886\u53D6" }],
+    claimable: true,
+    caveats: ["\u4F18\u60E0\u8D44\u683C\u3001\u5E93\u5B58\u548C\u6700\u7EC8\u4F18\u60E0\u4EE5\u9886\u53D6\u6216\u4F7F\u7528\u65F6\u4E3A\u51C6"]
+  },
+  schemaVersion: 1
+};
+var meta_default2 = meta2;
+
+// src/server/cards/promotion-entitlement-list/meta.ts
+import { promotionEntitlementListCardDataSchema } from "@tbox.cn/app-contracts-mall";
+
+// src/server/cards/promotion-entitlement-list/samples.ts
+function couponImage2(accent) {
+  return `data:image/svg+xml;utf8,<svg xmlns="http://www.w3.org/2000/svg" width="240" height="180"><rect width="240" height="180" rx="12" fill="%23f2f4f7"/><rect x="0" y="0" width="240" height="52" rx="12" fill="%23${accent}" opacity="0.85"/><rect x="20" y="76" width="140" height="16" rx="4" fill="%23d5dae2"/><rect x="20" y="104" width="96" height="12" rx="3" fill="%23e3e7ed"/><circle cx="196" cy="128" r="26" fill="none" stroke="%23c6ccd6" stroke-width="4" stroke-dasharray="6 6"/></svg>`;
+}
+var IMG2 = {
+  coffee: couponImage2("8a5a3b"),
+  lifestyle: couponImage2("3d5a80"),
+  dining: couponImage2("9e2b25")
+};
+var samples2 = [
+  {
+    label: "\u6211\u7684\u5238\xB7\u72B6\u6001\u77E9\u9635",
+    note: "\u5F85\u4F7F\u7528\u3001\u5DF2\u4F7F\u7528\u3001\u5DF2\u8FC7\u671F\u4E09\u6001\u53CA\u52A8\u4F5C\u964D\u7EA7\u540C\u5C4F",
+    group: "\u6211\u7684\u5238",
+    data: {
+      items: [
+        { entitlementRef: "ent:effective", title: "\u745E\u5E78\u5496\u5561\uFF5C30\u5143\u996E\u54C1\u4EE3\u91D1\u5238", imageUrl: IMG2.coffee, entitlementType: "COUPON", status: "EFFECTIVE", codeMasked: "**** 6688", benefitText: "\xA530", thresholdText: "\u65E0\u95E8\u69DB", usageNotice: "1F \xB7 \u5230\u5E97\u70B9\u5355\u53EF\u7528", validUntilText: "2026-09-27 \u5230\u671F" },
+        { entitlementRef: "ent:used", title: "KKV 120\u5143\u4F18\u60E0\u5238", imageUrl: IMG2.lifestyle, entitlementType: "COUPON", status: "USED", codeMasked: "**** 1058", benefitText: "\xA5105 \xB7 8.8\u6298", usageNotice: "\u5DF2\u4E8E 2026-08-26 \u4F7F\u7528", validUntilText: "\u5DF2\u4F7F\u7528" },
+        { entitlementRef: "ent:expired", title: "\u5357\u4EAC\u5927\u724C\u6863\uFF5C\u62DB\u724C\u83DC\u54C130\u5143\u5238", imageUrl: IMG2.dining, entitlementType: "COUPON", status: "EXPIRED", benefitText: "\xA530", usageNotice: "4F \xB7 \u9910\u996E\u533A", validUntilText: "\u5DF2\u4E8E 2026-08-20 \u8FC7\u671F" }
+      ]
+    }
+  },
+  {
+    label: "\u6211\u7684\u5238\xB7\u7F3A\u56FE\u957F\u6587\u6848",
+    note: "\u65E0\u56FE\u7247\u3001\u957F\u6807\u9898\u548C UNKNOWN \u72B6\u6001\u7684\u5BB9\u9519\u5F62\u6001",
+    group: "\u6211\u7684\u5238",
+    data: { items: [{ entitlementRef: "ent:unknown", title: "\u4F1A\u5458\u9650\u5B9A\u8D85\u957F\u540D\u79F0\u6D4B\u8BD5\uFF5C\u6307\u5B9A\u5546\u6237\u5468\u672B\u5230\u5E97\u6D88\u8D39\u4E13\u4EAB\u6743\u76CA", entitlementType: "COUPON", status: "UNKNOWN", codeMasked: "**** 0000", benefitText: "\u6EE1100\u51CF20", usageNotice: "\u4F7F\u7528\u95E8\u5E97\u548C\u9002\u7528\u5546\u54C1\u8BF7\u4EE5\u5238\u8BE6\u60C5\u8BF4\u660E\u4E3A\u51C6", validUntilText: "\u6709\u6548\u671F\u5F85\u54C1\u724C\u65B9\u786E\u8BA4" }] }
+  },
+  {
+    label: "\u6211\u7684\u5238\xB7\u7A7A\u6001",
+    note: "\u8D26\u6237\u6CA1\u6709\u5238\u65F6\u4FDD\u7559\u53BB\u9886\u5238\u7684\u8BED\u4E49\u5F15\u5BFC",
+    group: "\u6211\u7684\u5238",
+    data: { items: [], noResultsReason: "\u8FD8\u6CA1\u6709\u4F18\u60E0\u5238\uFF0C\u5148\u53BB\u770B\u770B\u672C\u5468\u795E\u5238\u5427" }
+  }
+];
+
+// src/server/cards/promotion-entitlement-list/meta.ts
+var meta3 = {
+  cardType: "promotion-entitlement-list",
+  dataSchema: promotionEntitlementListCardDataSchema,
+  displayName: "\u6211\u7684\u5238",
+  description: "\u5DF2\u9886\u53D6\u8D44\u4EA7\u5217\u8868\uFF08\u5238\u7801\u8131\u654F\uFF09",
+  sampleData: {
+    items: [{ entitlementRef: "ent_1", title: "\u6EE1 100 \u51CF 20 \u5143\u5238", entitlementType: "COUPON", status: "EFFECTIVE", codeMasked: "AB**CD" }]
+  },
+  samples: samples2,
+  schemaVersion: 1
+};
+var meta_default3 = meta3;
+
+// src/server/cards/promotion-activity-list/meta.ts
+import { promotionActivityListCardDataSchema } from "@tbox.cn/app-contracts-mall";
+var meta4 = {
+  cardType: "promotion-activity-list",
+  dataSchema: promotionActivityListCardDataSchema,
+  displayName: "\u6D3B\u52A8\u5217\u8868",
+  description: "\u8425\u9500\u6D3B\u52A8\u5217\u8868\uFF08\u62A5\u540D\u8981\u6C42 + \u540D\u989D\uFF09",
+  sampleData: { items: [{ activityRef: "demo-act:3001", title: "\u5468\u672B\u4EB2\u5B50\u5E02\u96C6", subtitle: "\u4F1A\u5458\u9650\u5B9A\u4F53\u9A8C", categoryName: "\u4EB2\u5B50", registrationRequired: true, remainingQuota: 12, periodText: "8\u670822\u65E5 14:00", availabilityStatus: "AVAILABLE" }] },
+  schemaVersion: 1
+};
+var meta_default4 = meta4;
+
+// src/server/cards/promotion-activity-detail/meta.ts
+import { promotionActivityDetailCardDataSchema } from "@tbox.cn/app-contracts-mall";
+var meta5 = {
+  cardType: "promotion-activity-detail",
+  dataSchema: promotionActivityDetailCardDataSchema,
+  displayName: "\u6D3B\u52A8\u8BE6\u60C5",
+  description: "\u6D3B\u52A8\u8BE6\u60C5 + \u573A\u6B21 + \u53C2\u4E0E\u6307\u5357",
+  sampleData: {
+    presentation: "detail",
+    activityRef: "demo-act:3001",
+    title: "\u5468\u672B\u4EB2\u5B50\u5E02\u96C6",
+    subtitle: "\u4F1A\u5458\u9650\u5B9A\u4F53\u9A8C",
+    categoryName: "\u4EB2\u5B50",
+    periodText: "8\u670822\u65E5 14:00",
+    location: "\u5546\u573A\u5317\u5EA7",
+    remainingQuota: 12,
+    registrationRequired: true,
+    registrationUrl: "alipays://platformapi/startapp?appId=demo&page=v%2Fmarketing%2Factivity%2Fdetail%3Fid%3Ddemo-activity",
+    sessions: [{ sessionRef: "s_1", title: "\u7B2C\u4E00\u573A", startText: "\u5468\u516D 10:00", remainingQuota: 12, status: "OPEN" }],
+    guideSteps: ["\u9886\u53D6\u4F18\u60E0\u5238", "\u9009\u62E9\u573A\u6B21\u62A5\u540D"],
+    guideItems: [{ title: "\u9886\u53D6\u4F18\u60E0\u5238", description: "\u5728\u4F1A\u5458\u4E2D\u5FC3\u5B8C\u6210\u8D44\u683C\u6821\u9A8C" }, { title: "\u9009\u62E9\u573A\u6B21\u62A5\u540D" }],
+    conditions: ["\u9650\u4F1A\u5458\u672C\u4EBA\u53C2\u4E0E"]
+  },
+  schemaVersion: 2,
+  migrate: (oldData) => oldData
+};
+var meta_default5 = meta5;
+
+// src/server/cards/promotion-activity-category-list/meta.ts
+import { promotionActivityCategoryListCardDataSchema } from "@tbox.cn/app-contracts-mall";
+var meta6 = {
+  cardType: "promotion-activity-category-list",
+  dataSchema: promotionActivityCategoryListCardDataSchema,
+  displayName: "\u6D3B\u52A8\u5206\u7C7B",
+  description: "\u5546\u573A\u6D3B\u52A8\u5206\u7C7B\u5165\u53E3",
+  sampleData: { items: [{ categoryId: "family", name: "\u4EB2\u5B50" }, { categoryId: "market", name: "\u5E02\u96C6" }] },
+  schemaVersion: 1
+};
+var meta_default6 = meta6;
+
+// src/server/cards/promotion-best-deal/meta.ts
+import { promotionBestDealCardDataSchema } from "@tbox.cn/app-contracts-mall";
+var meta7 = {
+  cardType: "promotion-best-deal",
+  dataSchema: promotionBestDealCardDataSchema,
+  displayName: "\u4F18\u60E0\u6D4B\u7B97",
+  description: "\u4F18\u60E0\u6D4B\u7B97\u7ED3\u679C\u6216\u5907\u9009\u5EFA\u8BAE",
+  sampleData: {
+    authoritative: true,
+    originalAmountCents: 2e4,
+    savingsCents: 3e3,
+    expectedPayCents: 17e3,
+    appliedOfferRefs: ["demo:coupon:demo"],
+    message: "\u9884\u8BA1\u8282\u7701 30 \u5143"
+  },
+  schemaVersion: 1
+};
+var meta_default7 = meta7;
+
+// src/server/tools.ts
+import { createTool, coerceStringifiedFields, withCardEmissionHint } from "@tbox.cn/app-sdk/server";
+import { requireToolRequestContext } from "@tbox.cn/app-sdk/server";
+import { resolveMemberGate, toMallQueryContext } from "@tbox.cn/app-contracts-mall";
+import { z } from "zod";
+
+// src/server/navigation.ts
+var promotionNavigationQuery = {
+  activityDetail: (title) => `\u67E5\u770B\u300C${title}\u300D\u7684\u6D3B\u52A8\u8BE6\u60C5`,
+  offerDetail: (title) => `\u67E5\u770B\u300C${title}\u300D\u7684\u4F18\u60E0\u8BE6\u60C5`,
+  entitlementDetail: (title) => `\u67E5\u770B\u300C${title}\u300D\u8FD9\u5F20\u4F18\u60E0\u5238\u7684\u4F7F\u7528\u8BE6\u60C5`,
+  activityCategory: (name) => `\u67E5\u770B\u300C${name}\u300D\u5206\u7C7B\u7684\u6D3B\u52A8`
+};
+function parsePromotionNavigationQuery(text) {
+  const subject = text.match(/「([^」]{1,200})」/)?.[1]?.trim();
+  if (!subject) return null;
+  if (text === promotionNavigationQuery.activityDetail(subject)) return { kind: "activity-detail", title: subject };
+  if (text === promotionNavigationQuery.offerDetail(subject)) return { kind: "offer-detail", title: subject };
+  if (text === promotionNavigationQuery.entitlementDetail(subject)) return { kind: "entitlement-detail", title: subject };
+  if (text === promotionNavigationQuery.activityCategory(subject)) return { kind: "activity-category", name: subject };
+  return null;
+}
+
+// src/server/tools.ts
+function coerce(schema) {
+  return z.preprocess(coerceStringifiedFields, schema);
+}
+function toQueryContext(reqCtx) {
+  return { q: toMallQueryContext(reqCtx), reqCtx };
+}
+function withCards(facts, cardType, note) {
+  return { ...facts, cards: [{ cardType, data: facts, note }] };
+}
+function dateText(value) {
+  if (!value) return void 0;
+  const date = new Date(value);
+  return Number.isNaN(date.valueOf()) ? void 0 : date.toLocaleDateString("zh-CN");
+}
+function dateRangeText(start, end) {
+  const startText = dateTimeText(start);
+  const endText = dateTimeText(end);
+  if (startText && endText) return `${startText} \u81F3 ${endText}`;
+  return startText || endText;
+}
+function dateTimeText(value) {
+  if (!value) return void 0;
+  const text = value.trim().replace("T", " ");
+  return text.length > 19 ? text.slice(0, 19) : text;
+}
+function yuanText(cents) {
+  return (cents / 100).toFixed(2).replace(/\.?(0+)$/, "");
+}
+function facetText(offer) {
+  const facet = offer.facets.find((item) => item.kind === "COUPON");
+  if (facet?.discountType === "AMOUNT") {
+    return facet.thresholdCents !== void 0 ? `\u6EE1 ${yuanText(facet.thresholdCents)} \u51CF ${yuanText(facet.value)} \u5143` : `\xA5${yuanText(facet.value)}`;
+  }
+  if (facet?.discountType === "PERCENTAGE") return `${(facet.value / 10).toFixed(1)} \u6298`;
+  const promotion = offer.facets.find((item) => item.kind === "PROMOTION");
+  return promotion?.kind === "PROMOTION" ? promotion.ruleDescription : void 0;
+}
+function thresholdText(offer) {
+  const facet = offer.facets.find((item) => item.kind === "COUPON");
+  return facet?.kind === "COUPON" && facet.thresholdCents !== void 0 ? `\u6EE1 ${yuanText(facet.thresholdCents)} \u5143\u53EF\u7528` : void 0;
+}
+function offerListPresentation(items) {
+  return items.length > 0 && items.every((item) => item.offerType === "COUPON") ? "coupon" : "offer";
+}
+function offerPresentation(offerType) {
+  if (offerType === "PROMOTION") return "promotion";
+  if (offerType === "BUNDLE") return "package";
+  return "offer";
+}
+function offerSummary(offer) {
+  const validity = offer.validityText ?? dateRangeText(offer.validity.start, offer.validity.end);
+  return {
+    offerRef: offer.offerRef,
+    title: offer.title,
+    ...offer.subtitle ? { subtitle: offer.subtitle } : {},
+    offerType: offer.offerType,
+    ...facetText(offer) ? { benefitText: facetText(offer) } : {},
+    ...thresholdText(offer) ? { thresholdText: thresholdText(offer) } : {},
+    ...offer.priceText ? { priceText: offer.priceText } : {},
+    ...offer.originalPriceText ? { originalPriceText: offer.originalPriceText } : {},
+    ...offer.discountLabel ? { discountLabel: offer.discountLabel } : {},
+    ...offer.claimActionLabel ? { claimActionLabel: offer.claimActionLabel } : {},
+    ...offer.purchaseUrl ? { purchaseUrl: offer.purchaseUrl } : {},
+    ...offer.freeCouponClaimMode ? { freeCouponClaimMode: offer.freeCouponClaimMode } : {},
+    ...offer.stockText ? { stockText: offer.stockText } : {},
+    ...offer.usageNoticeText ? { usageNoticeText: offer.usageNoticeText } : {},
+    ...offer.usageSceneText ? { usageSceneText: offer.usageSceneText } : {},
+    ...offer.usageTimeText ? { usageTimeText: offer.usageTimeText } : {},
+    ...offer.claimTimeText ? { claimTimeText: offer.claimTimeText } : {},
+    ...offer.usageRuleText ? { usageRuleText: offer.usageRuleText } : {},
+    ...offer.guaranteeText ? { guaranteeText: offer.guaranteeText } : {},
+    claimable: offer.availability.status === "AVAILABLE",
+    availabilityStatus: offer.availability.status,
+    ...validity ? { validityText: validity } : {},
+    ...offer.imageUrl ? { imageUrl: offer.imageUrl } : {},
+    tags: [...offer.tags],
+    itemActions: [
+      {
+        kind: "send",
+        label: "\u67E5\u770B\u8BE6\u60C5",
+        value: promotionNavigationQuery.offerDetail(offer.title)
+      }
+    ]
+  };
+}
+function offerDetail(offer, supportsAcquisition, presentation = "offer", stores) {
+  const validity = offer.validityText ?? dateRangeText(offer.validity.start, offer.validity.end);
+  const claimable = supportsAcquisition && offer.availability.status === "AVAILABLE";
+  return {
+    presentation,
+    offerRef: offer.offerRef,
+    title: offer.title,
+    offerType: offer.offerType,
+    ...offer.subtitle ? { subtitle: offer.subtitle } : {},
+    ...offer.description ? { description: offer.description } : {},
+    ...offer.imageUrl ? { imageUrl: offer.imageUrl } : {},
+    ...facetText(offer) ? { benefitText: facetText(offer) } : {},
+    ...thresholdText(offer) ? { thresholdText: thresholdText(offer) } : {},
+    ...offer.priceText ? { priceText: offer.priceText } : {},
+    ...offer.originalPriceText ? { originalPriceText: offer.originalPriceText } : {},
+    ...offer.discountLabel ? { discountLabel: offer.discountLabel } : {},
+    ...offer.claimActionLabel ? { claimActionLabel: offer.claimActionLabel } : {},
+    ...offer.purchaseUrl ? { purchaseUrl: offer.purchaseUrl } : {},
+    ...offer.stockText ? { stockText: offer.stockText } : {},
+    ...offer.usageNoticeText ? { usageNoticeText: offer.usageNoticeText } : {},
+    ...offer.usageSceneText ? { usageSceneText: offer.usageSceneText } : {},
+    ...offer.usageTimeText ? { usageTimeText: offer.usageTimeText } : {},
+    ...offer.claimTimeText ? { claimTimeText: offer.claimTimeText } : {},
+    ...offer.usageRuleText ? { usageRuleText: offer.usageRuleText } : {},
+    ...offer.guaranteeText ? { guaranteeText: offer.guaranteeText } : {},
+    ...validity ? { validityText: validity } : {},
+    rules: offer.participation?.steps.map(
+      (step) => step.description ? `${step.title}\uFF1A${step.description}` : step.title
+    ) ?? [],
+    ...offer.participation ? {
+      participationMode: offer.participation.mode,
+      steps: offer.participation.steps.map((step) => ({
+        title: step.title,
+        ...step.description ? { description: step.description } : {}
+      })),
+      requirements: [...offer.participation.requirements ?? []],
+      ...offer.participation.notice ? { notice: offer.participation.notice } : {}
+    } : {},
+    ...stores && stores.length > 0 ? { stores: [...stores] } : {},
+    ...offer.facets.find((facet) => facet.kind === "BUNDLE")?.kind === "BUNDLE" ? {
+      bundleItems: offer.facets.filter((facet) => facet.kind === "BUNDLE").flatMap((facet) => facet.items.map((item) => ({ ...item })))
+    } : {},
+    claimable,
+    ...!claimable ? {
+      unavailableReason: !supportsAcquisition ? "\u5F53\u524D\u5546\u573A\u672A\u88C5\u914D\u4F18\u60E0\u9886\u53D6\u901A\u9053" : offer.availability.reasonCodes.join("\uFF1B") || "\u6682\u4E0D\u53EF\u9886\u53D6"
+    } : {},
+    caveats: ["\u4F18\u60E0\u8D44\u683C\u3001\u5E93\u5B58\u548C\u6700\u7EC8\u4F18\u60E0\u4EE5\u9886\u53D6\u6216\u4F7F\u7528\u65F6\u4E3A\u51C6"]
+  };
+}
+function entitlementSummary(entitlement) {
+  const validUntil = dateText(entitlement.validUntil);
+  const validity = dateRangeText(entitlement.validFrom, entitlement.validUntil);
+  return {
+    entitlementRef: entitlement.entitlementRef,
+    title: entitlement.title,
+    ...entitlement.imageUrl ? { imageUrl: entitlement.imageUrl } : {},
+    entitlementType: entitlement.entitlementType,
+    status: entitlement.status,
+    ...entitlement.codeMasked ? { codeMasked: entitlement.codeMasked } : {},
+    ...entitlement.code ? { code: entitlement.code } : {},
+    ...entitlement.qrCodeEnabled !== void 0 ? { qrCodeEnabled: entitlement.qrCodeEnabled } : {},
+    ...entitlement.benefitText ? { benefitText: entitlement.benefitText } : {},
+    ...entitlement.thresholdText ? { thresholdText: entitlement.thresholdText } : {},
+    ...entitlement.usageNotice ? { usageNotice: entitlement.usageNotice } : {},
+    ...entitlement.guaranteeText ? { guaranteeText: entitlement.guaranteeText } : {},
+    ...entitlement.usageSceneText ? { usageSceneText: entitlement.usageSceneText } : {},
+    ...entitlement.usageTimeText ? { usageTimeText: entitlement.usageTimeText } : {},
+    ...entitlement.claimTimeText ? { claimTimeText: entitlement.claimTimeText } : {},
+    ...entitlement.usageRuleText ? { usageRuleText: entitlement.usageRuleText } : {},
+    ...entitlement.stores?.length ? { stores: entitlement.stores.map((store) => ({ ...store })) } : {},
+    // CouponSheet already supplies the "有效期" label; keep this value label-free.
+    ...entitlement.validityText || validity ? { validityText: entitlement.validityText ?? validity } : {},
+    ...validUntil ? { validUntilText: `\u6709\u6548\u671F\u81F3 ${validUntil}` } : {}
+  };
+}
+function activityAvailability(detail) {
+  if (detail.remainingQuota === 0) return "FULL";
+  const now2 = Date.now();
+  if (detail.endAt && new Date(detail.endAt).valueOf() < now2) return "ENDED";
+  if (detail.startAt && new Date(detail.startAt).valueOf() > now2) return "UPCOMING";
+  return "AVAILABLE";
+}
+function activitySummary(item, categoryNames = /* @__PURE__ */ new Map()) {
+  return {
+    activityRef: item.activityRef,
+    title: item.title,
+    ...item.subtitle ? { subtitle: item.subtitle } : {},
+    ...item.coverUrl ? { coverUrl: item.coverUrl } : {},
+    registrationRequired: item.registrationRequired,
+    ...item.jumpOnly ? { jumpOnly: true } : {},
+    ...item.jumpLabel ? { jumpLabel: item.jumpLabel } : {},
+    ...item.categoryId && categoryNames.get(item.categoryId) ? { categoryName: categoryNames.get(item.categoryId) } : {},
+    availabilityStatus: activityAvailability(item),
+    ...item.remainingQuota !== void 0 ? { remainingQuota: item.remainingQuota } : {},
+    ...dateText(item.startAt) ? { periodText: `${dateText(item.startAt)} \u8D77` } : {},
+    itemActions: item.jumpOnly && item.registrationUrl ? [{ kind: "link", label: item.jumpLabel ?? "\u6253\u5F00\u5C0F\u7A0B\u5E8F", url: item.registrationUrl }] : [{ kind: "send", label: "\u67E5\u770B\u6D3B\u52A8\u8BE6\u60C5", value: promotionNavigationQuery.activityDetail(item.title) }]
+  };
+}
+function activityDetail(detail, presentation = "detail") {
+  const start = dateText(detail.startAt);
+  const end = dateText(detail.endAt);
+  const registrationUrl = detail.registrationUrl;
+  return {
+    presentation,
+    activityRef: detail.activityRef,
+    title: detail.title,
+    ...detail.subtitle ? { subtitle: detail.subtitle } : {},
+    ...detail.description ? { description: detail.description } : {},
+    ...detail.coverUrl ? { coverUrl: detail.coverUrl } : {},
+    ...start ? { periodText: end && end !== start ? `${start} - ${end}` : `${start} \u8D77` } : {},
+    registrationRequired: detail.registrationRequired,
+    ...detail.jumpOnly ? { jumpOnly: true } : {},
+    ...detail.jumpLabel ? { jumpLabel: detail.jumpLabel } : {},
+    ...registrationUrl ? { registrationUrl } : {},
+    ...detail.remainingQuota !== void 0 ? { remainingQuota: detail.remainingQuota } : {},
+    sessions: detail.sessions.map((session) => ({
+      sessionRef: session.sessionRef,
+      title: session.title,
+      startText: new Date(session.startAt).toLocaleString("zh-CN"),
+      ...session.endAt ? { endText: new Date(session.endAt).toLocaleString("zh-CN") } : {},
+      ...session.location ? { location: session.location } : {},
+      ...session.remainingQuota !== void 0 ? { remainingQuota: session.remainingQuota } : {},
+      status: session.status
+    })),
+    guideSteps: detail.guide?.steps.map(
+      (step) => step.description ? `${step.title}\uFF1A${step.description}` : step.title
+    ) ?? [],
+    conditions: [...detail.guide?.conditions ?? []],
+    guideItems: detail.guide?.steps.map((step) => ({
+      title: step.title,
+      ...step.description ? { description: step.description } : {}
+    })) ?? [],
+    ...detail.guide?.notice ? { notice: detail.guide.notice } : {}
+  };
+}
+var searchInput = coerce(
+  z.object({
+    keyword: z.string().optional(),
+    scene: z.string().optional(),
+    cursor: z.string().optional(),
+    limit: z.string().optional()
+  })
+);
+var detailInput = coerce(z.object({ offerRef: z.string().optional(), keyword: z.string().optional() }));
+var activityDetailInput = coerce(
+  z.object({ activityRef: z.string().optional(), keyword: z.string().optional() })
+);
+function createPromotionTools(opts) {
+  const delegateLinkedActivity2 = async (reqCtx) => {
+    const ctx = opts.getCtx();
+    const handler = ctx.handlers.resolve("alipay-activity");
+    if (!handler) return void 0;
+    const result = await handler.handle("activity-router", { content: "\u6D3B\u52A8\u4E2D\u5FC3" }, ctx, reqCtx);
+    return result.continueWith ? void 0 : result;
+  };
+  const requireService = async (execCtx, resolve) => {
+    const ctx = opts.getCtx();
+    const reqCtx = requireToolRequestContext(execCtx);
+    const context = toQueryContext(reqCtx);
+    return { service: await resolve(context.reqCtx, ctx), q: context.q, reqCtx: context.reqCtx };
+  };
+  const supportsAcquire = (service) => service.supportsAcquisition !== false;
+  const resolveOffer = async (service, q, args, offerTypes) => {
+    if (typeof args.offerRef === "string" && args.offerRef) {
+      return service.getOfferDetail(q, { offerRef: args.offerRef });
+    }
+    const page = await service.searchOffers(q, {
+      keyword: args.keyword,
+      offerTypes,
+      limit: 1
+    });
+    return page.items[0] ?? null;
+  };
+  const resolveActivity = async (service, q, args) => {
+    if (typeof args.activityRef === "string" && args.activityRef) {
+      return service.getActivityDetail(q, args.activityRef);
+    }
+    const page = await service.listActivities(q, { keyword: args.keyword, limit: 1 });
+    const first = page.items[0];
+    return first ? service.getActivityDetail(q, first.activityRef) : null;
+  };
+  const search = (service, q, args, offerTypes) => service.searchOffers(q, {
+    keyword: args.keyword,
+    scene: args.scene,
+    cursor: args.cursor,
+    limit: args.limit ? Number(args.limit) : 50,
+    offerTypes
+  });
+  const entitlementFacts = async (service, q, args, reqCtx) => {
+    const ctx = opts.getCtx();
+    const factory = ctx.services?.resolve?.("member.status");
+    const gate = reqCtx ? await resolveMemberGate(factory, reqCtx) : void 0;
+    if (gate) {
+      return {
+        found: false,
+        items: [],
+        noResultsReason: gate.notice,
+        ...gate.card ? { cards: [gate.card] } : {}
+      };
+    }
+    const page = await service.listEntitlements(q, {
+      cursor: args.cursor,
+      limit: args.limit ? Number(args.limit) : 50
+    });
+    return {
+      mallId: q.scope.mallId,
+      miniAppId: q.scope.miniAppId,
+      items: page.items.map(entitlementSummary),
+      ...page.nextCursor ? { nextCursor: page.nextCursor } : {},
+      ...page.items.length === 0 ? { noResultsReason: "\u8FD8\u6CA1\u6709\u4F18\u60E0\u5238\uFF0C\u53EF\u8BA9\u6211\u5E2E\u4F60\u627E\u627E\u53EF\u9886\u4F18\u60E0" } : {}
+    };
+  };
+  const listActivityCategories = createTool({
+    id: "listActivityCategories",
+    description: "\u67E5\u8BE2\u5F53\u524D\u5546\u573A\u5168\u90E8\u6D3B\u52A8\u5206\u7C7B\uFF0C\u7528\u4E8E\u4EB2\u5B50\u3001\u5E02\u96C6\u3001\u7F8E\u98DF\u7B49\u6D3B\u52A8\u7B5B\u9009\u3002",
+    inputSchema: coerce(z.object({})),
+    execute: async (_args, execCtx) => {
+      const reqCtx = requireToolRequestContext(execCtx, "listActivityCategories");
+      const delegated = await delegateLinkedActivity2(reqCtx);
+      if (delegated) return delegated;
+      const { service } = await requireService(execCtx, resolvePromotionActivitiesPort);
+      const items = await service.listActivityCategories?.() ?? [];
+      const facts = {
+        items: items.map((item) => ({
+          ...item,
+          itemActions: [
+            {
+              kind: "send",
+              label: `\u67E5\u770B${item.name}\u6D3B\u52A8`,
+              value: promotionNavigationQuery.activityCategory(item.name)
+            }
+          ]
+        })),
+        ...items.length === 0 ? { noResultsReason: "\u5F53\u524D\u5546\u573A\u6682\u672A\u8FD4\u56DE\u6D3B\u52A8\u5206\u7C7B" } : {}
+      };
+      return items.length ? withCards(facts, "promotion-activity-category-list", `\u6D3B\u52A8\u5206\u7C7B ${items.length} \u4E2A${items[0] ? ` \xB7 \u542B${items[0].name}` : ""}`) : facts;
+    }
+  });
+  const listActivities = createTool({
+    id: "listActivities",
+    description: "\u6309\u5206\u7C7B\u3001\u5173\u952E\u8BCD\u3001\u5F53\u524D/\u5F80\u671F\u3001\u62A5\u540D\u8981\u6C42\u548C\u65E5\u671F\u8303\u56F4\u67E5\u8BE2\u5546\u573A\u6D3B\u52A8\uFF1B\u67E5\u8BE2\u672C\u5468\u6D3B\u52A8\u65F6\u4F20\u672C\u5468\u65E5\u671F\u8303\u56F4\u3002",
+    inputSchema: coerce(
+      z.object({
+        categoryId: z.string().optional(),
+        keyword: z.string().optional(),
+        dataScope: z.enum(["CURRENT", "HISTORY"]).optional(),
+        registrationRequired: z.string().optional(),
+        startsAfter: z.string().optional(),
+        endsBefore: z.string().optional(),
+        cursor: z.string().optional(),
+        limit: z.string().optional()
+      })
+    ),
+    execute: async (args, execCtx) => {
+      const reqCtx = requireToolRequestContext(execCtx, "listActivities");
+      const delegated = await delegateLinkedActivity2(reqCtx);
+      if (delegated) return delegated;
+      const { service, q } = await requireService(execCtx, resolvePromotionActivitiesPort);
+      let categoryId = args.categoryId;
+      const resolveCategoryId = service.resolveCategoryId;
+      if (categoryId && resolveCategoryId) categoryId = await resolveCategoryId(categoryId);
+      const page = await service.listActivities(q, {
+        categoryId,
+        keyword: args.keyword,
+        dataScope: args.dataScope,
+        registrationRequired: args.registrationRequired === void 0 ? void 0 : args.registrationRequired === "true",
+        startsAfter: args.startsAfter,
+        endsBefore: args.endsBefore,
+        cursor: args.cursor,
+        limit: args.limit ? Number(args.limit) : 10
+      });
+      const categories = await service.listActivityCategories?.() ?? [];
+      const categoryNames = new Map(categories.map((item) => [item.categoryId, item.name]));
+      const facts = {
+        items: page.items.map((item) => activitySummary(item, categoryNames)),
+        ...page.nextCursor ? { nextCursor: page.nextCursor } : {},
+        ...page.items.length === 0 ? { noResultsReason: "\u5F53\u524D\u7B5B\u9009\u8303\u56F4\u5185\u6682\u65E0\u6D3B\u52A8" } : {}
+      };
+      return page.items.length ? withCards(facts, "promotion-activity-list", `\u5546\u573A\u6D3B\u52A8 ${page.items.length} \u573A${page.items[0] ? ` \xB7 ${page.items[0].title}` : ""}`) : facts;
+    }
+  });
+  const getActivityDetail = createTool({
+    id: "getActivityDetail",
+    description: "\u67E5\u8BE2\u6307\u5B9A\u6D3B\u52A8\u8BE6\u60C5\u3001\u65F6\u95F4\u3001\u540D\u989D\u548C\u53C2\u4E0E\u6761\u4EF6\u3002",
+    inputSchema: activityDetailInput,
+    execute: async (args, execCtx) => {
+      const reqCtx = requireToolRequestContext(execCtx, "getActivityDetail");
+      const delegated = await delegateLinkedActivity2(reqCtx);
+      if (delegated) return delegated;
+      const { service, q } = await requireService(execCtx, resolvePromotionActivitiesPort);
+      const detail = await resolveActivity(service, q, args);
+      if (!detail) return { found: false, message: "\u672A\u627E\u5230\u8BE5\u6D3B\u52A8" };
+      const facts = { found: true, ...activityDetail(detail, "detail") };
+      return withCards(facts, "promotion-activity-detail", `\u6D3B\u52A8\u8BE6\u60C5\uFF1A${detail.title}`);
+    }
+  });
+  const listActivitySessions = createTool({
+    id: "listActivitySessions",
+    description: "\u67E5\u8BE2\u6307\u5B9A\u6D3B\u52A8\u7684\u53EF\u9009\u573A\u6B21\uFF0C\u53EA\u8FD4\u56DE\u53EA\u8BFB\u72B6\u6001\uFF0C\u4E0D\u6267\u884C\u62A5\u540D\u3002",
+    inputSchema: activityDetailInput,
+    execute: async (args, execCtx) => {
+      const reqCtx = requireToolRequestContext(execCtx, "listActivitySessions");
+      const delegated = await delegateLinkedActivity2(reqCtx);
+      if (delegated) return delegated;
+      const { service, q } = await requireService(execCtx, resolvePromotionActivitiesPort);
+      const detail = await resolveActivity(service, q, args);
+      if (!detail) return { found: false, message: "\u672A\u627E\u5230\u8BE5\u6D3B\u52A8" };
+      const sessions = service.listActivitySessions ? await service.listActivitySessions(q, detail.activityRef) : detail.sessions;
+      const facts = activityDetail({ ...detail, sessions }, "schedule");
+      return withCards(facts, "promotion-activity-detail", `\u6D3B\u52A8\u573A\u6B21\uFF1A${detail.title}`);
+    }
+  });
+  const getActivityGuide = createTool({
+    id: "getActivityGuide",
+    description: "\u67E5\u8BE2\u6307\u5B9A\u6D3B\u52A8\u7684\u62A5\u540D\u6761\u4EF6\u548C\u53C2\u4E0E\u6B65\u9AA4\uFF0C\u4E0D\u6267\u884C\u62A5\u540D\u3002",
+    inputSchema: activityDetailInput,
+    execute: async (args, execCtx) => {
+      const reqCtx = requireToolRequestContext(execCtx, "getActivityGuide");
+      const delegated = await delegateLinkedActivity2(reqCtx);
+      if (delegated) return delegated;
+      const { service, q } = await requireService(execCtx, resolvePromotionActivitiesPort);
+      const detail = await resolveActivity(service, q, args);
+      if (!detail) return { found: false, message: "\u672A\u627E\u5230\u8BE5\u6D3B\u52A8" };
+      const facts = activityDetail(detail, "guide");
+      return withCards(facts, "promotion-activity-detail", `\u6D3B\u52A8\u53C2\u4E0E\u65B9\u5F0F\uFF1A${detail.title}`);
+    }
+  });
+  const searchOffers = createTool({
+    id: "searchOffers",
+    description: "\u641C\u7D22\u5F53\u524D\u5546\u573A\u4F18\u60E0\u3001\u6298\u6263\u3001\u56E2\u8D2D\u5E76\u652F\u6301\u5206\u9875\u3002",
+    inputSchema: searchInput,
+    execute: async (args, execCtx) => {
+      const { service, q } = await requireService(execCtx, resolvePromotionOffersPort);
+      const page = await search(service, q, args);
+      const facts = {
+        presentation: offerListPresentation(page.items),
+        mode: "search",
+        items: page.items.map(offerSummary),
+        ...page.nextCursor ? { nextCursor: page.nextCursor } : {},
+        ...page.items.length === 0 ? { noResultsReason: "\u672A\u627E\u5230\u76F8\u5173\u4F18\u60E0\uFF0C\u53EF\u6362\u4E2A\u5173\u952E\u8BCD\u8BD5\u8BD5" } : {}
+      };
+      return page.items.length ? withCards(facts, "promotion-offer-list", `\u4F18\u60E0\u641C\u7D22 ${page.items.length} \u6761${page.items[0] ? ` \xB7 ${page.items[0].title}` : ""}`) : facts;
+    }
+  });
+  const getOfferDetail = createTool({
+    id: "getOfferDetail",
+    description: "\u67E5\u8BE2\u901A\u7528\u4F18\u60E0\u8BE6\u60C5\u5361\uFF08\u89C4\u5219\u3001\u95E8\u69DB\u3001\u6709\u6548\u671F\u53CA\u9886\u53D6\u72B6\u6001\uFF09\uFF0C\u652F\u6301 offerRef\u3001entitlementRef \u6216\u5173\u952E\u8BCD\u53CD\u67E5\u3002",
+    inputSchema: coerce(
+      z.object({ offerRef: z.string().optional(), entitlementRef: z.string().optional(), keyword: z.string().optional() })
+    ),
+    execute: async (args, execCtx) => {
+      const { service, q, reqCtx } = await requireService(execCtx, resolvePromotionOffersPort);
+      if (typeof args.entitlementRef === "string" && args.entitlementRef) {
+        const ctx = opts.getCtx();
+        const factory = ctx.services?.resolve?.("member.status");
+        const gate = await resolveMemberGate(factory, reqCtx);
+        if (gate) {
+          return { found: false, noResultsReason: gate.notice, ...gate.card ? { cards: [gate.card] } : {} };
+        }
+      }
+      const offer = await service.getOfferDetail(q, {
+        offerRef: args.offerRef,
+        entitlementRef: args.entitlementRef,
+        keyword: args.keyword
+      });
+      if (!offer) return { found: false, message: "\u672A\u627E\u5230\u8BE5\u4F18\u60E0" };
+      const facts = {
+        found: true,
+        ...offerDetail(offer, supportsAcquire(service), offer.offerType === "COUPON" ? "coupon" : offerPresentation(offer.offerType))
+      };
+      return withCards(facts, "promotion-offer-detail", `\u4F18\u60E0\u8BE6\u60C5\uFF1A${offer.title}`);
+    }
+  });
+  const listEntitlements = createTool({
+    id: "listEntitlements",
+    description: "\u4EC5\u67E5\u8BE2\u5F53\u524D\u767B\u5F55\u4F1A\u5458\u5DF2\u7ECF\u9886\u53D6/\u62E5\u6709\u7684\u4F18\u60E0\u6743\u76CA\u548C\u5238\u5305\uFF1B\u7528\u6237\u95EE\u201C\u6709\u4EC0\u4E48\u53EF\u9886\u53D6/\u53EF\u9886\u4F18\u60E0\u5238\u201D\u65F6\u7981\u6B62\u8C03\u7528\uFF0C\u6539\u7528 listCoupons(mode=CLAIMABLE)\u3002\u5DF2\u767B\u5F55\u672A\u5165\u4F1A\u65F6\u8FD4\u56DE\u5165\u4F1A\u5F15\u5BFC\u5361\uFF08member-enrollment-cta\uFF09\uFF0C\u65E0\u9700\u518D\u8C03 member \u57DF queryEnrollmentCta\u3002",
+    inputSchema: searchInput,
+    execute: async (args, execCtx) => {
+      const { service, q, reqCtx } = await requireService(execCtx, resolvePromotionEntitlementsPort);
+      const facts = await entitlementFacts(service, q, args, reqCtx);
+      return facts.items.length ? withCards(
+        facts,
+        "promotion-entitlement-list",
+        `\u6211\u7684\u4F18\u60E0\u5238 ${facts.items.length} \u5F20${facts.items[0] ? ` \xB7 ${facts.items[0].title}` : ""}`
+      ) : facts;
+    }
+  });
+  const listPromotions = createTool({
+    id: "listPromotions",
+    description: "\u67E5\u8BE2\u672C\u5468\u8425\u9500\u4E13\u9898\u548C\u4FC3\u9500\u6D3B\u52A8\u3002",
+    inputSchema: searchInput,
+    execute: async (args, execCtx) => {
+      const { service, q } = await requireService(execCtx, resolvePromotionOffersPort);
+      const page = await search(service, q, args, ["PROMOTION"]);
+      const facts = {
+        presentation: "promotion",
+        mode: "search",
+        summary: "\u672C\u5468\u503C\u5F97\u5173\u6CE8\u7684\u6D3B\u52A8",
+        items: page.items.map(offerSummary),
+        ...page.nextCursor ? { nextCursor: page.nextCursor } : {},
+        ...page.items.length === 0 ? { noResultsReason: "\u672C\u5468\u6682\u672A\u67E5\u8BE2\u5230\u8425\u9500\u4E13\u9898" } : {}
+      };
+      return page.items.length ? withCards(facts, "promotion-offer-list", `\u8425\u9500\u4E13\u9898 ${page.items.length} \u4E2A${page.items[0] ? ` \xB7 ${page.items[0].title}` : ""}`) : facts;
+    }
+  });
+  const getPromotionDetail = createTool({
+    id: "getPromotionDetail",
+    description: "\u6309\u8425\u9500\u4E13\u9898\u6807\u8BC6\u6216\u5173\u952E\u8BCD\u7CBE\u786E\u67E5\u8BE2\u6D3B\u52A8\u8BE6\u60C5\u3002",
+    inputSchema: detailInput,
+    execute: async (args, execCtx) => {
+      const { service, q } = await requireService(execCtx, resolvePromotionOffersPort);
+      const offer = await resolveOffer(service, q, args, ["PROMOTION"]);
+      if (!offer) return { found: false, message: "\u672A\u627E\u5230\u8BE5\u8425\u9500\u4E13\u9898" };
+      const facts = { found: true, ...offerDetail(offer, false, "promotion") };
+      return withCards(facts, "promotion-offer-detail", `\u8425\u9500\u6D3B\u52A8\u8BE6\u60C5\uFF1A${offer.title}`);
+    }
+  });
+  const getParticipationGuide = createTool({
+    id: "getParticipationGuide",
+    description: "\u67E5\u8BE2\u8425\u9500\u4E13\u9898\u7684\u5382\u5546\u53C2\u4E0E\u6B65\u9AA4\uFF0C\u4E0D\u6267\u884C\u62A5\u540D\u6216\u9886\u53D6\u3002",
+    inputSchema: detailInput,
+    execute: async (args, execCtx) => {
+      const { service, q } = await requireService(execCtx, resolvePromotionOffersPort);
+      const offer = await resolveOffer(service, q, args, ["PROMOTION"]);
+      if (!offer) return { found: false, message: "\u672A\u627E\u5230\u8BE5\u8425\u9500\u4E13\u9898" };
+      const facts = { found: true, ...offerDetail(offer, false, "promotion-guide") };
+      return withCards(facts, "promotion-offer-detail", `\u53C2\u4E0E\u65B9\u5F0F\uFF1A${offer.title}`);
+    }
+  });
+  const listCoupons = createTool({
+    id: "listCoupons",
+    description: "\u67E5\u8BE2\u4F18\u60E0\u5238\u5217\u8868\u3002\u9ED8\u8BA4\u53EA\u67E5\u8BE2\u5F53\u524D\u53EF\u9886\u53D6\u4F18\u60E0\u5238\uFF08CLAIMABLE\uFF09\uFF1B\u53EA\u6709\u7528\u6237\u660E\u786E\u8BF4\u201C\u6211\u7684\u5238/\u5DF2\u9886\u53D6/\u5238\u5305\u201D\u65F6\u624D\u4F20 mode=OWNED\u3002mode=OWNED \u5DF2\u767B\u5F55\u672A\u5165\u4F1A\u65F6\u8FD4\u56DE\u5165\u4F1A\u5F15\u5BFC\u5361\uFF08member-enrollment-cta\uFF09\uFF0C\u65E0\u9700\u518D\u8C03 member \u57DF queryEnrollmentCta\u3002",
+    inputSchema: coerce(
+      z.object({
+        mode: z.enum(["CLAIMABLE", "OWNED"]).default("CLAIMABLE"),
+        keyword: z.string().optional(),
+        cursor: z.string().optional(),
+        limit: z.string().optional()
+      })
+    ),
+    execute: async (args, execCtx) => {
+      if (args.mode === "OWNED") {
+        const { service: service2, q: q2, reqCtx } = await requireService(execCtx, resolvePromotionEntitlementsPort);
+        const facts2 = await entitlementFacts(service2, q2, args, reqCtx);
+        return facts2.items.length ? withCards(facts2, "promotion-entitlement-list", `\u6211\u7684\u4F18\u60E0\u5238 ${facts2.items.length} \u5F20${facts2.items[0] ? ` \xB7 ${facts2.items[0].title ?? ""}` : ""}`) : facts2;
+      }
+      const { service, q } = await requireService(execCtx, resolvePromotionOffersPort);
+      const page = await search(service, q, args, ["COUPON"]);
+      const items = page.items.filter((item) => item.availability.status === "AVAILABLE");
+      const facts = {
+        presentation: "coupon",
+        mode: "claimable",
+        summary: "\u53EF\u9886\u53D6\u4F18\u60E0\u5238",
+        items: items.map(offerSummary),
+        ...page.nextCursor ? { nextCursor: page.nextCursor } : {},
+        ...items.length === 0 ? { noResultsReason: "\u5F53\u524D\u5546\u573A\u6682\u672A\u8FD4\u56DE\u53EF\u9886\u4F18\u60E0\u5238" } : {}
+      };
+      return items.length ? withCards(facts, "promotion-offer-list", `\u53EF\u9886\u4F18\u60E0\u5238 ${items.length} \u5F20${items[0] ? ` \xB7 ${items[0].title}` : ""}`) : facts;
+    }
+  });
+  const getPackageDetail = createTool({
+    id: "getPackageDetail",
+    description: "\u67E5\u8BE2\u7EC4\u5408\u793C\u5305\u53CA\u5176\u5B50\u6743\u76CA\u3002",
+    inputSchema: detailInput,
+    execute: async (args, execCtx) => {
+      const { service, q } = await requireService(execCtx, resolvePromotionOffersPort);
+      const offer = await resolveOffer(service, q, args, ["BUNDLE"]);
+      if (!offer) return { found: false, message: "\u672A\u627E\u5230\u8BE5\u4F18\u60E0\u793C\u5305" };
+      const facts = {
+        found: true,
+        ...offerDetail(offer, supportsAcquire(service), "package")
+      };
+      return withCards(facts, "promotion-offer-detail", `\u4F18\u60E0\u793C\u5305\uFF1A${offer.title}`);
+    }
+  });
+  const recommendOffers = createTool({
+    id: "recommendOffers",
+    description: "\u6309\u8D44\u683C\u3001\u53EF\u7528\u6027\u4E0E\u9884\u8BA1\u8282\u7701\u989D\u63A8\u8350\u5F53\u524D\u5546\u573A\u4F18\u60E0\u3002",
+    inputSchema: searchInput,
+    execute: async (args, execCtx) => {
+      const { service, q } = await requireService(execCtx, resolvePromotionOffersPort);
+      const items = await service.recommendOffers(q, {
+        keyword: args.keyword,
+        scene: args.scene,
+        limit: args.limit ? Number(args.limit) : 4
+      });
+      const unifiedCouponList = service.usesUnifiedCouponList === true;
+      const facts = {
+        presentation: unifiedCouponList ? "coupon" : "recommendation",
+        mode: unifiedCouponList ? "claimable" : "recommend",
+        summary: items[0]?.availability.status === "AVAILABLE" ? "\u5F53\u524D\u53EF\u7528\uFF0C\u5E76\u4F18\u5148\u8003\u8651\u9884\u8BA1\u8282\u7701\u989D" : "\u5F53\u524D\u6682\u65F6\u65E0\u6CD5\u786E\u8BA4\u53EF\u7528\u4F18\u60E0\uFF0C\u8BF7\u67E5\u770B\u5019\u9009\u6761\u4EF6",
+        items: items.slice(0, 4).map(offerSummary),
+        ...items.length === 0 ? { noResultsReason: "\u5F53\u524D\u6682\u65E0\u53EF\u63A8\u8350\u4F18\u60E0" } : {}
+      };
+      return items.length ? withCards(facts, "promotion-offer-list", `\u63A8\u8350\u4F18\u60E0 ${items.length} \u6761${items[0] ? ` \xB7 ${items[0].title}` : ""}`) : facts;
+    }
+  });
+  const calculateBestDeal = createTool({
+    id: "calculateBestDeal",
+    description: "\u8C03\u7528\u5DF2\u88C5\u914D\u5382\u5546\u80FD\u529B\u8FDB\u884C\u4F18\u60E0\u6D4B\u7B97\uFF1B\u672A\u88C5\u914D\u6D4B\u7B97\u80FD\u529B\u65F6\u4EC5\u8FD4\u56DE\u6587\u5B57\u8BF4\u660E\uFF0C\u4E0D\u51FA\u6D4B\u7B97\u5361\u3002",
+    inputSchema: coerce(
+      z.object({ currentAmountCents: z.string(), candidateOfferRefs: z.array(z.string()).optional() })
+    ),
+    execute: async (args, execCtx) => {
+      const { service, q } = await requireService(execCtx, resolvePromotionOffersPort);
+      const amount = Number(args.currentAmountCents);
+      if (!Number.isSafeInteger(amount) || amount < 0) return { supported: true, message: "\u8BF7\u63D0\u4F9B\u6709\u6548\u7684\u6D88\u8D39\u91D1\u989D\uFF08\u5206\uFF09" };
+      const bestDealService = service;
+      if (!bestDealService.calculateBestDeal || bestDealService.supportsBestDeal === false) {
+        return { supported: false, originalAmountCents: amount, message: "\u5F53\u524D\u5546\u573A\u6682\u4E0D\u652F\u6301\u4F18\u60E0\u6D4B\u7B97\uFF0C\u8BF7\u5728\u7ED3\u7B97\u9875\u786E\u8BA4\u6700\u7EC8\u4F18\u60E0" };
+      }
+      const result = await bestDealService.calculateBestDeal(q, {
+        currentAmountCents: amount,
+        candidateOfferRefs: args.candidateOfferRefs
+      });
+      const facts = {
+        authoritative: true,
+        originalAmountCents: amount,
+        savingsCents: result.estimatedSavingCents,
+        expectedPayCents: Math.max(0, amount - result.estimatedSavingCents),
+        appliedOfferRefs: result.offerRef ? [result.offerRef] : [],
+        message: result.reason
+      };
+      return withCards(
+        facts,
+        "promotion-best-deal",
+        `\u9884\u8BA1\u7701 ${(result.estimatedSavingCents / 100).toFixed(0)} \u5143 \xB7 \u5E94\u4ED8 ${(Math.max(0, amount - result.estimatedSavingCents) / 100).toFixed(0)} \u5143`
+      );
+    }
+  });
+  return {
+    listActivityCategories: withCardEmissionHint(listActivityCategories),
+    listActivities: withCardEmissionHint(listActivities),
+    getActivityDetail: withCardEmissionHint(getActivityDetail),
+    listActivitySessions: withCardEmissionHint(listActivitySessions),
+    getActivityGuide: withCardEmissionHint(getActivityGuide),
+    searchOffers: withCardEmissionHint(searchOffers),
+    getOfferDetail: withCardEmissionHint(getOfferDetail, { actions: true }),
+    listEntitlements: withCardEmissionHint(listEntitlements),
+    listPromotions: withCardEmissionHint(listPromotions),
+    getPromotionDetail: withCardEmissionHint(getPromotionDetail),
+    getParticipationGuide: withCardEmissionHint(getParticipationGuide),
+    listCoupons: withCardEmissionHint(listCoupons, { actions: true }),
+    getPackageDetail: withCardEmissionHint(getPackageDetail, { actions: true }),
+    recommendOffers: withCardEmissionHint(recommendOffers),
+    calculateBestDeal: withCardEmissionHint(calculateBestDeal)
+  };
+}
+
+// src/server/actions.ts
+import { randomUUID } from "crypto";
+import { memberGateCardOf, externalMemberRefOf, toMallQueryContext as toMallQueryContext2 } from "@tbox.cn/app-contracts-mall";
+import { z as z2 } from "zod";
+async function listEntitlementsAfterAcquire(service, q) {
+  for (let attempt = 0; attempt < 3; attempt += 1) {
+    const page = await service.listEntitlements(q, { limit: 10 });
+    if (page.items.length > 0 || attempt === 2) return page;
+    await new Promise((resolve) => setTimeout(resolve, 150));
+  }
+  return { items: [] };
+}
+function classifyRejection(code) {
+  switch (code) {
+    case "30013":
+    case "30011":
+      return { kind: "AUTH_FAILED", message: "\u4F1A\u5458\u767B\u5F55\u5DF2\u8FC7\u671F\uFF0C\u8BF7\u91CD\u65B0\u767B\u5F55\u4F1A\u5458\u540E\u518D\u9886\u53D6" };
+    case "636":
+    case "637":
+      return { kind: "OUT_OF_STOCK", message: "\u5238\u5DF2\u88AB\u9886\u5B8C\uFF0C\u53EF\u5173\u6CE8\u4E0B\u6B21\u653E\u91CF" };
+    case "638":
+      return { kind: "ALREADY_ACQUIRED", message: "\u5DF2\u9886\u53D6\u8FC7\u8BE5\u5238\uFF0C\u53EF\u5728\u300C\u6211\u7684\u5238\u300D\u4E2D\u67E5\u770B" };
+    case "5113":
+      return { kind: "ALREADY_ACQUIRED", message: "\u9886\u53D6\u6B21\u6570\u5DF2\u8FBE\u5230\u4E0A\u9650" };
+    case "30017":
+      return { kind: "NOT_ELIGIBLE", message: "\u4E0D\u6EE1\u8DB3\u9886\u53D6\u6761\u4EF6\uFF08\u5982\u4EC5\u9650\u7279\u5B9A\u7B49\u7EA7\u4F1A\u5458\uFF09" };
+    default:
+      return { kind: "UNKNOWN", message: "\u9886\u53D6\u5931\u8D25\uFF0C\u8BF7\u7A0D\u540E\u91CD\u8BD5" };
+  }
+}
+var ACQUIRE_MEMBER_NOTICE = "\u9886\u53D6\u9700\u8981\u4F1A\u5458\u8EAB\u4EFD\uFF0C\u8BF7\u5148\u767B\u5F55\u6216\u529E\u7406\u5165\u4F1A\u540E\u518D\u9886\u5238";
+var ACQUIRE_ENROLL_NOTICE = "\u9886\u53D6\u9700\u8981\u4F1A\u5458\u8EAB\u4EFD\uFF0C\u529E\u7406\u5165\u4F1A\u540E\u5373\u53EF\u9886\u5238";
+var ACQUIRE_UNKNOWN_NOTICE = "\u6682\u65F6\u65E0\u6CD5\u786E\u8BA4\u4F1A\u5458\u72B6\u6001\uFF0C\u8BF7\u7A0D\u540E\u518D\u8BD5";
+var ACQUIRE_GATE_COPY = {
+  unauthenticated: ACQUIRE_MEMBER_NOTICE,
+  not_enrolled: ACQUIRE_ENROLL_NOTICE,
+  closed: ACQUIRE_ENROLL_NOTICE,
+  unknown: ACQUIRE_UNKNOWN_NOTICE,
+  unavailable: ACQUIRE_UNKNOWN_NOTICE
+};
+function createPromotionActions(ctx) {
+  const resolveAcquireGate = async (reqCtx) => {
+    const factory = ctx.services?.resolve?.("member.status");
+    if (!factory) return { blocked: ACQUIRE_MEMBER_NOTICE };
+    const status = await factory(reqCtx);
+    if (status.outcome !== "active") {
+      const card = memberGateCardOf(reqCtx?.identity?.userId ?? "", status);
+      return card ? { blocked: ACQUIRE_GATE_COPY[status.outcome], card } : { blocked: ACQUIRE_GATE_COPY[status.outcome] };
+    }
+    if (!status.account) {
+      ctx.logger?.warn("promotion.acquire\uFF1Amember.status active \u7F3A\u8D26\u6237\u5FEB\u7167\uFF08\u89E3\u6790\u5668\u539F\u5B50\u6027\u7834\u574F\uFF09");
+      return { blocked: ACQUIRE_UNKNOWN_NOTICE };
+    }
+    const externalMemberRef = externalMemberRefOf(status.account) ?? "";
+    if (!externalMemberRef) {
+      ctx.logger?.warn("promotion.acquire\uFF1Aactive \u4F1A\u5458\u8D26\u6237\u65E0\u5382\u5546\u4FA7\u5F15\u7528\uFF08\u771F\u5B9E\u5361\u53F7\u4E0E opaque \u5F15\u7528\u53CC\u7F3A\uFF09");
+      return { blocked: ACQUIRE_UNKNOWN_NOTICE };
+    }
+    return { externalMemberRef };
+  };
+  const executeAcquire = async (input, reqCtx) => {
+    const { offerRef } = input ?? {};
+    const userId = reqCtx?.identity?.userId ?? "";
+    if (!offerRef || !userId || !reqCtx) {
+      return { text: "\u9886\u53D6\u5931\u8D25\uFF1A\u7F3A\u5C11\u4F18\u60E0\u5F15\u7528\u6216\u8EAB\u4EFD" };
+    }
+    const gate = await resolveAcquireGate(reqCtx);
+    if ("blocked" in gate) {
+      return gate.card ? { card: { cardType: gate.card.cardType, data: gate.card.data }, text: gate.blocked } : { text: gate.blocked };
+    }
+    const externalMemberRef = gate.externalMemberRef;
+    const q = toMallQueryContext2(reqCtx);
+    const service = await resolvePromotionAcquisitionPort(reqCtx, ctx);
+    const idempotencyKey = randomUUID();
+    let operation;
+    try {
+      operation = await service.acquire(q, { offerRef, externalMemberRef, idempotencyKey });
+    } catch (e) {
+      const errorType = e instanceof Error ? e.name : "UnknownError";
+      ctx.logger?.warn(`\u9886\u5238\u8BF7\u6C42\u5F02\u5E38 key=${idempotencyKey.slice(0, 8)}\u2026\uFF1Atype=${errorType}`);
+      return { text: "\u9886\u53D6\u8BF7\u6C42\u5931\u8D25\uFF0C\u8BF7\u7A0D\u540E\u91CD\u8BD5" };
+    }
+    if (operation.status === "SUCCEEDED") {
+      try {
+        const entitlements = await resolvePromotionEntitlementsPort(reqCtx, ctx);
+        const page = await listEntitlementsAfterAcquire(entitlements, q);
+        if (page.items.length) {
+          return {
+            card: {
+              cardType: "promotion-entitlement-list",
+              data: { mallId: q.scope.mallId, miniAppId: q.scope.miniAppId, items: page.items.map(entitlementSummary) }
+            },
+            text: "\u9886\u53D6\u6210\u529F\uFF01\u5DF2\u5B58\u5165\u5361\u5305"
+          };
+        }
+      } catch (e) {
+        ctx.logger?.warn(`\u9886\u5238\u6210\u529F\u4F46\u6211\u7684\u5238\u5217\u8868\u67E5\u8BE2\u5931\u8D25\uFF1Aerr=${e.message}`);
+      }
+      return { text: "\u9886\u53D6\u6210\u529F\uFF01\u5DF2\u5B58\u5165\u5361\u5305\uFF0C\u53EF\u5728\u300C\u6211\u7684\u5238\u300D\u4E2D\u67E5\u770B" };
+    }
+    if (operation.status === "PENDING_AUTHORITY") {
+      return { text: "\u9886\u53D6\u5DF2\u53D7\u7406\uFF0C\u6B63\u5728\u786E\u8BA4\u7ED3\u679C\uFF0C\u7A0D\u540E\u53EF\u5728\u300C\u6211\u7684\u5238\u300D\u67E5\u770B" };
+    }
+    const providerMessage = operation.message?.trim();
+    ctx.logger?.warn(`\u9886\u5238\u88AB\u5382\u5546\u62D2\u7EDD code=${operation.code ?? "unknown"} operation=${operation.operationRef.slice(0, 12)} message=${logText(providerMessage)}`);
+    const reason = providerMessage || classifyRejection(operation.code).message;
+    return { text: `\u9886\u53D6\u5931\u8D25\uFF1A${reason}${operation.code ? `\uFF08code ${operation.code}\uFF09` : ""}` };
+  };
+  return {
+    acquire: {
+      actionId: "promotion.acquire",
+      moduleId: "promotion",
+      cardType: "promotion-offer-detail",
+      label: "\u7ACB\u5373\u9886\u53D6",
+      singleUse: true,
+      inputSchema: z2.object({ offerRef: z2.string().min(1) }),
+      execute: executeAcquire
+    },
+    // 列表内浮层的领取入口：一张列表卡对应 N 张券，令牌必须可重复使用——
+    // singleUse 按 grantId 一次性消费，领完第一张后同卡其余券会全部撞 TOKEN_CONSUMED。
+    // 重复领同一张券由 provider 侧幂等兜底（已领会回一句文字提示）。
+    acquireFromList: {
+      actionId: "promotion.acquire-from-list",
+      moduleId: "promotion",
+      cardType: "promotion-offer-list",
+      label: "\u9886\u53D6",
+      singleUse: false,
+      inputSchema: z2.object({ offerRef: z2.string().min(1) }),
+      execute: executeAcquire
+    },
+    // 门店券行领取入口（2026-09-02）：couponList 携 offerRef 的券——与优惠列表领取逐字同链路
+    // （executeAcquire 单源）。token 按 cardType 签发而注册表按 actionId 键控——两个卡上下文
+    // （shop-detail 卡直开 / shop-list 卡下钻浮层）= 两个变体 id；门店列表卡本体无领取按钮
+    // （按钮只在两个上下文打开的门店详情浮层券条目里）。
+    acquireFromShopDetail: {
+      actionId: "promotion.acquire-from-shop-detail",
+      moduleId: "promotion",
+      cardType: "shop-detail",
+      label: "\u9886\u53D6",
+      singleUse: false,
+      inputSchema: z2.object({ offerRef: z2.string().min(1) }),
+      execute: executeAcquire
+    },
+    acquireFromShopList: {
+      actionId: "promotion.acquire-from-shop-list",
+      moduleId: "promotion",
+      cardType: "shop-list",
+      label: "\u9886\u53D6",
+      singleUse: false,
+      inputSchema: z2.object({ offerRef: z2.string().min(1) }),
+      execute: executeAcquire
+    }
+  };
+}
+function logText(value) {
+  const text = typeof value === "string" ? value : String(value ?? "");
+  const bounded = text.length > 200 ? `${text.slice(0, 200)}\u2026` : text;
+  return JSON.stringify(bounded);
+}
+
+// src/server/handler.ts
+import { matchIntent } from "@tbox.cn/app-sdk/server";
+import { resolveMemberGate as resolveMemberGate2, toMallQueryContext as toMallQueryContext3 } from "@tbox.cn/app-contracts-mall";
+var PROMOTION_INTENTS = {
+  "list-entitlements": {
+    patterns: ["\u6211\u7684\u4F18\u60E0\u5238", "\u6211\u7684\u5238\u5305", "\u6211\u7684\u5238", "\u5DF2\u9886\u53D6\u7684\u5238", "\u5DF2\u9886\u4F18\u60E0\u5238", "\u6301\u6709\u7684\u4F18\u60E0\u5238"],
+    description: "\u67E5\u8BE2\u5F53\u524D\u4F1A\u5458\u5DF2\u62E5\u6709\u7684\u4F18\u60E0\u5238"
+  },
+  "search-offers": {
+    patterns: ["\u9886\u5238", "\u9886\u53D6\u4F18\u60E0\u5238", "\u6709\u4EC0\u4E48\u4F18\u60E0", "\u73B0\u5728\u6709\u4EC0\u4E48\u4F18\u60E0\uFF1F"],
+    description: "\u641C\u7D22\u53EF\u9886\u4F18\u60E0"
+  },
+  "list-activities": {
+    patterns: ["\u8425\u9500\u6D3B\u52A8", "\u6709\u4EC0\u4E48\u6D3B\u52A8", "\u6D3B\u52A8\u4E2D\u5FC3"],
+    description: "\u67E5\u8BE2\u8425\u9500\u6D3B\u52A8"
+  }
+};
+var PROMOTION_RESOLVE_ROUTES = [
+  {
+    id: "list-entitlements",
+    keywords: [...PROMOTION_INTENTS["list-entitlements"].patterns],
+    handlerId: "promotion",
+    action: "list-entitlements"
+  },
+  {
+    id: "search-offers",
+    keywords: [...PROMOTION_INTENTS["search-offers"].patterns],
+    handlerId: "promotion",
+    action: "search-offers"
+  },
+  {
+    id: "list-activities",
+    keywords: [...PROMOTION_INTENTS["list-activities"].patterns],
+    handlerId: "promotion",
+    action: "list-activities"
+  }
+];
+var OWNED_INTENT_HINTS = ["\u6211\u7684\u4F18\u60E0\u5238", "\u6211\u7684\u5238\u5305", "\u6211\u7684\u5238", "\u5DF2\u9886\u53D6", "\u5DF2\u9886\u4F18\u60E0\u5238", "\u6301\u6709\u7684\u4F18\u60E0\u5238"];
+var CLAIMABLE_INTENT_HINTS = ["\u6709\u4EC0\u4E48\u4F18\u60E0", "\u53EF\u9886\u53D6", "\u53EF\u9886", "\u9886\u53D6\u4F18\u60E0\u5238", "\u9886\u5238"];
+function intentContent(payload) {
+  if (typeof payload === "string") return payload;
+  if (payload && typeof payload === "object" && "content" in payload) {
+    const content = payload.content;
+    return typeof content === "string" ? content : "";
+  }
+  return "";
+}
+function resolveIntent(payload) {
+  const content = intentContent(payload);
+  const navigation = parsePromotionNavigationQuery(content);
+  if (navigation) return navigation;
+  if (content.startsWith(NAVIGATION_SENTENCE_PREFIX)) return null;
+  const owned = OWNED_INTENT_HINTS.some((hint) => content.includes(hint));
+  const claimable = CLAIMABLE_INTENT_HINTS.some((hint) => content.includes(hint));
+  if (claimable && !owned) return { kind: "search-coupons" };
+  if (owned) return { kind: "list-entitlements" };
+  const id = matchIntent(PROMOTION_RESOLVE_ROUTES, content)?.id;
+  return {
+    kind: id === "list-entitlements" ? "list-entitlements" : id === "list-activities" ? "list-activities" : "search-offers"
+  };
+}
+function resolveAction(action, payload) {
+  if (action === "intent") return resolveIntent(payload);
+  if (action === "list-entitlements" || action === "search-offers" || action === "list-activities") {
+    return { kind: action };
+  }
+  return null;
+}
+function offerPresentation2(offerType) {
+  if (offerType === "PROMOTION") return "promotion";
+  if (offerType === "BUNDLE") return "package";
+  return "offer";
+}
+function offerListPresentation2(items) {
+  return items.length > 0 && items.every((item) => item.offerType === "COUPON") ? "coupon" : "offer";
+}
+async function activityCategoryNames(service) {
+  const categories = await service.listActivityCategories?.() ?? [];
+  return {
+    categories,
+    names: new Map(categories.map((item) => [item.categoryId, item.name]))
+  };
+}
+var NAVIGATION_SENTENCE_PREFIX = "\u67E5\u770B\u300C";
+async function delegateLinkedActivity(ctx, payload, reqCtx) {
+  const handler = ctx.handlers.resolve("alipay-activity");
+  if (!handler) return void 0;
+  const result = await handler.handle("activity-router", payload, ctx, reqCtx);
+  return result.continueWith ? void 0 : result;
+}
+function createPromotionIntentHandler(ctx) {
+  return {
+    id: "promotion",
+    // 顶层意图 = 确定性触发器（exact 整句 + prefix 导航模板头）：语义分类职责归
+    // skill 路由与 LLM 工具编排（BM25 单标签 + 硬短路会截断复合句，如「推荐门店+领券」）。
+    // QuickCommands 固定句（现在有什么优惠？/活动中心）随 exact 句面直出。
+    intents: [
+      ...Object.values(PROMOTION_INTENTS).map(({ patterns }) => ({ patterns: [...patterns], match: "exact" })),
+      {
+        // 卡片导航模板句（「查看「X」…」四式）前缀路由：handler 内
+        // parsePromotionNavigationQuery 模板全等校验承接；未命中模板 → 洋葱放行（resolveIntent null）。
+        patterns: [NAVIGATION_SENTENCE_PREFIX],
+        match: "prefix"
+      }
+    ],
+    handle: async (action, payload, _ctx, reqCtx) => {
+      if (!reqCtx) return { cards: [], text: "\u8425\u9500\u670D\u52A1\u4E0D\u53EF\u7528\uFF08\u7F3A\u5C11\u8FD0\u884C\u4E0A\u4E0B\u6587\uFF09" };
+      const q = toMallQueryContext3(reqCtx);
+      const resolved = resolveAction(action, payload);
+      if (!resolved) {
+        return { cards: [], continueWith: { content: intentContent(payload) } };
+      }
+      switch (resolved.kind) {
+        case "activity-detail": {
+          const delegated = await delegateLinkedActivity(ctx, payload, reqCtx);
+          if (delegated) return delegated;
+          const service = await resolvePromotionActivitiesPort(reqCtx, ctx);
+          const page = await service.listActivities(q, { keyword: resolved.title, limit: 10 });
+          const summary = page.items.find((item) => item.title === resolved.title) ?? page.items[0];
+          if (!summary) return { cards: [], text: `\u672A\u627E\u5230\u300C${resolved.title}\u300D` };
+          const { names } = await activityCategoryNames(service);
+          const registrationUrl = summary.registrationUrl;
+          let detail;
+          try {
+            detail = await service.getActivityDetail(q, summary.activityRef);
+          } catch (error) {
+            ctx.logger?.warn(
+              `\u6D3B\u52A8\u8BE6\u60C5\u67E5\u8BE2\u5931\u8D25\uFF0C\u964D\u7EA7\u5C55\u793A\u5217\u8868\u6458\u8981\uFF1A${error.message}`
+            );
+          }
+          const projected = detail ? activityDetail(detail, "detail") : activityDetail(
+            {
+              ...summary,
+              sessions: [],
+              guide: {
+                steps: [],
+                conditions: [],
+                notice: registrationUrl ? "\u5B8C\u6574\u6D3B\u52A8\u5B89\u6392\u8BF7\u524D\u5F80\u652F\u4ED8\u5B9D\u6D3B\u52A8\u9875\u67E5\u770B" : "\u6D3B\u52A8\u8BE6\u7EC6\u5B89\u6392\u6682\u65F6\u65E0\u6CD5\u83B7\u53D6\uFF0C\u8BF7\u7A0D\u540E\u91CD\u8BD5"
+              }
+            },
+            "detail"
+          );
+          return {
+            cards: [
+              {
+                cardType: "promotion-activity-detail",
+                data: {
+                  ...projected,
+                  ...summary.categoryId && names.get(summary.categoryId) ? { categoryName: names.get(summary.categoryId) } : {}
+                }
+              }
+            ],
+            text: detail ? `\u8FD9\u662F\u300C${detail.title}\u300D\u7684\u6D3B\u52A8\u8BE6\u60C5` : registrationUrl ? `\u8FD9\u662F\u300C${summary.title}\u300D\u7684\u6D3B\u52A8\u6982\u89C8\uFF0C\u53EF\u524D\u5F80\u652F\u4ED8\u5B9D\u67E5\u770B\u5B8C\u6574\u5B89\u6392\u5E76\u62A5\u540D` : `\u5148\u4E3A\u4F60\u5C55\u793A\u300C${summary.title}\u300D\u7684\u6D3B\u52A8\u6982\u89C8\uFF0C\u8BE6\u7EC6\u5B89\u6392\u6682\u65F6\u65E0\u6CD5\u83B7\u53D6`
+          };
+        }
+        case "offer-detail": {
+          const service = await resolvePromotionOffersPort(reqCtx, ctx);
+          const offer = await service.getOfferDetail(q, { keyword: resolved.title });
+          if (!offer) return { cards: [], text: `\u672A\u627E\u5230\u300C${resolved.title}\u300D` };
+          const stores = await service.listOfferStores?.(q, offer.offerRef);
+          return {
+            cards: [
+              {
+                cardType: "promotion-offer-detail",
+                data: offerDetail(offer, service.supportsAcquisition !== false, offerPresentation2(offer.offerType), stores)
+                // 能力位运行期探测
+              }
+            ],
+            text: `\u8FD9\u662F\u300C${offer.title}\u300D\u7684\u4F18\u60E0\u8BE6\u60C5\uFF0C\u53EF\u67E5\u770B\u4F7F\u7528\u987B\u77E5\u5E76${offer.claimActionLabel === "\u62A2\u8D2D" ? "\u524D\u5F80\u5C0F\u7A0B\u5E8F\u62A2\u8D2D" : "\u9886\u53D6"}`
+          };
+        }
+        case "entitlement-detail": {
+          const gate = await resolveMemberGate2(
+            ctx.services?.resolve?.("member.status"),
+            reqCtx
+          );
+          if (gate) return { cards: gate.card ? [gate.card] : [], text: gate.notice };
+          const service = await resolvePromotionEntitlementsPort(reqCtx, ctx);
+          const page = await service.listEntitlements(q, { limit: 50 });
+          const summary = page.items.find((item) => item.title === resolved.title) ?? page.items.find((item) => item.title.includes(resolved.title) || resolved.title.includes(item.title));
+          if (!summary) return { cards: [], text: `\u672A\u5728\u4F60\u7684\u5238\u5305\u4E2D\u627E\u5230\u300C${resolved.title}\u300D` };
+          return {
+            cards: [{ cardType: "promotion-entitlement-list", data: { mallId: q.scope.mallId, miniAppId: q.scope.miniAppId, items: [entitlementSummary(summary)] } }],
+            text: `\u8FD9\u662F\u300C${summary.title}\u300D\uFF0C\u70B9\u5F00\u53EF\u770B\u5238\u7801\u4E0E\u4F7F\u7528\u8BF4\u660E`
+          };
+        }
+        case "activity-category": {
+          const delegated = await delegateLinkedActivity(ctx, payload, reqCtx);
+          if (delegated) return delegated;
+          const service = await resolvePromotionActivitiesPort(reqCtx, ctx);
+          const { categories, names } = await activityCategoryNames(service);
+          const category = categories.find((item) => item.name === resolved.name) ?? categories.find((item) => item.name.includes(resolved.name) || resolved.name.includes(item.name));
+          const categoryId = category?.categoryId ?? await service.resolveCategoryId?.(resolved.name);
+          if (!categoryId) return { cards: [], text: `\u672A\u627E\u5230\u300C${resolved.name}\u300D\u6D3B\u52A8\u5206\u7C7B` };
+          const page = await service.listActivities(q, { categoryId, dataScope: "CURRENT", limit: 10 });
+          if (page.items.length === 0) return { cards: [], text: `\u8FD1\u671F\u6682\u65E0\u300C${resolved.name}\u300D\u5206\u7C7B\u6D3B\u52A8` };
+          return {
+            cards: [
+              {
+                cardType: "promotion-activity-list",
+                data: {
+                  items: page.items.map((item) => activitySummary(item, names)),
+                  ...page.nextCursor ? { nextCursor: page.nextCursor } : {}
+                }
+              }
+            ],
+            text: `\u4E3A\u4F60\u627E\u5230 ${page.items.length} \u573A\u300C${resolved.name}\u300D\u6D3B\u52A8`
+          };
+        }
+        case "search-offers": {
+          const service = await resolvePromotionOffersPort(reqCtx, ctx);
+          const page = await service.searchOffers(q, {});
+          const items = page.items.filter((item) => item.availability.status === "AVAILABLE");
+          if (items.length === 0) return { cards: [], text: "\u6682\u65E0\u53EF\u9886\u4F18\u60E0" };
+          const presentation = offerListPresentation2(items);
+          return {
+            cards: [
+              {
+                cardType: "promotion-offer-list",
+                data: {
+                  presentation,
+                  mode: "claimable",
+                  items: items.map(offerSummary)
+                }
+              }
+            ],
+            text: `\u4E3A\u4F60\u627E\u5230 ${items.length} \u6761\u53EF\u9886\u4F18\u60E0`
+          };
+        }
+        case "search-coupons": {
+          const service = await resolvePromotionOffersPort(reqCtx, ctx);
+          const page = await service.searchOffers(q, { offerTypes: ["COUPON"], limit: 50 });
+          const items = page.items.filter((item) => item.availability.status === "AVAILABLE");
+          if (items.length === 0) return { cards: [], text: "\u5F53\u524D\u5546\u573A\u6682\u672A\u627E\u5230\u53EF\u9886\u53D6\u4F18\u60E0\u5238" };
+          return {
+            cards: [{ cardType: "promotion-offer-list", data: {
+              presentation: "coupon",
+              mode: "claimable",
+              items: items.map(offerSummary)
+            } }],
+            text: `\u4E3A\u4F60\u627E\u5230 ${items.length} \u5F20\u53EF\u9886\u53D6\u4F18\u60E0\u5238`
+          };
+        }
+        case "list-entitlements": {
+          const gate = await resolveMemberGate2(
+            ctx.services?.resolve?.("member.status"),
+            reqCtx
+          );
+          if (gate) return { cards: gate.card ? [gate.card] : [], text: gate.notice };
+          const service = await resolvePromotionEntitlementsPort(reqCtx, ctx);
+          const page = await service.listEntitlements(q, { limit: 50 });
+          if (page.items.length === 0) {
+            const offersService = await resolvePromotionOffersPort(reqCtx, ctx);
+            const offers = await offersService.searchOffers(q, { offerTypes: ["COUPON"], limit: 50 });
+            const items = offers.items.filter((item) => item.availability.status === "AVAILABLE");
+            if (items.length > 0) {
+              return {
+                cards: [{ cardType: "promotion-offer-list", data: {
+                  presentation: "coupon",
+                  mode: "claimable",
+                  items: items.map(offerSummary)
+                } }],
+                text: `\u4F60\u7684\u5238\u5305\u91CC\u8FD8\u6CA1\u6709\u4F18\u60E0\u5238\uFF0C\u4E3A\u4F60\u627E\u5230 ${items.length} \u6761\u53EF\u9886\u4F18\u60E0`
+              };
+            }
+            return { cards: [], text: "\u4F60\u7684\u5238\u5305\u91CC\u8FD8\u6CA1\u6709\u4F18\u60E0\u5238\uFF0C\u5F53\u524D\u4E5F\u6CA1\u6709\u53EF\u9886\u53D6\u4F18\u60E0" };
+          }
+          return {
+            cards: [
+              {
+                cardType: "promotion-entitlement-list",
+                data: {
+                  mallId: q.scope.mallId,
+                  miniAppId: q.scope.miniAppId,
+                  items: page.items.map(entitlementSummary),
+                  ...page.nextCursor ? { nextCursor: page.nextCursor } : {}
+                }
+              }
+            ],
+            text: `\u4F60\u7684\u5238\u5305\u91CC\u6709 ${page.items.length} \u5F20\u4F18\u60E0\u5238`
+          };
+        }
+        case "list-activities": {
+          const delegated = await delegateLinkedActivity(ctx, payload, reqCtx);
+          if (delegated) return delegated;
+          const service = await resolvePromotionActivitiesPort(reqCtx, ctx);
+          const page = await service.listActivities(q, { dataScope: "CURRENT", limit: 10 });
+          const { names: categoryNames } = await activityCategoryNames(service);
+          return {
+            cards: [
+              {
+                cardType: "promotion-activity-list",
+                data: {
+                  items: page.items.map((item) => activitySummary(item, categoryNames)),
+                  ...page.nextCursor ? { nextCursor: page.nextCursor } : {},
+                  ...page.items.length === 0 ? { noResultsReason: "\u5F53\u524D\u5546\u573A\u8FD1\u671F\u6682\u65E0\u8425\u9500\u6D3B\u52A8" } : {}
+                }
+              }
+            ],
+            text: page.items.length > 0 ? `\u8FD1\u671F\u6709 ${page.items.length} \u573A\u6D3B\u52A8` : "\u8FD1\u671F\u6682\u65E0\u8425\u9500\u6D3B\u52A8"
+          };
+        }
+        default:
+          return { cards: [], text: "\u8425\u9500\u670D\u52A1\u5DF2\u5C31\u7EEA\uFF0C\u53EF\u95EE\u6211\u4F18\u60E0\u6216\u6D3B\u52A8" };
+      }
+    }
+  };
+}
+
+// src/server/cards/index.ts
+var promotionCards = {
+  "promotion-offer-list": meta_default,
+  "promotion-offer-detail": meta_default2,
+  "promotion-entitlement-list": meta_default3,
+  "promotion-activity-list": meta_default4,
+  "promotion-activity-detail": meta_default5,
+  "promotion-activity-category-list": meta_default6,
+  "promotion-best-deal": meta_default7
+};
+
+// src/server/index.ts
+var serverCtx;
+var getCtx = () => {
+  if (!serverCtx) throw new Error("promotion \u6A21\u5757\u672A\u6CE8\u518C\uFF08ServerContext \u672A\u7ED1\u5B9A\uFF09");
+  return serverCtx;
+};
+var tools = createPromotionTools({ getCtx });
+var OWNED_INTENT_RE = /我的券|已领|券包|券码/;
+var listCouponsPreTool = definePreTool(tools.listCoupons, {
+  routing: { mode: "keywords", terms: ["\u4F18\u60E0\u5238", "\u9886\u5238", "\u6709\u4EC0\u4E48\u5238", "\u53EF\u9886"] },
+  decide: ({ text }) => {
+    if (!text?.trim()) return { decision: "skip", reason: "\u7A7A\u6587\u672C" };
+    if (OWNED_INTENT_RE.test(text)) return { decision: "skip", reason: "OWNED \u610F\u56FE\uFF08\u6A21\u578B\u4F20 mode\uFF09" };
+    return { decision: "run", args: { mode: "CLAIMABLE" } };
+  },
+  silent: true
+});
+var preTools = {
+  listCoupons: listCouponsPreTool
+};
+var cards = {
+  "promotion-offer-list": meta_default,
+  "promotion-offer-detail": meta_default2,
+  "promotion-entitlement-list": meta_default3,
+  "promotion-activity-list": meta_default4,
+  "promotion-activity-detail": meta_default5,
+  "promotion-activity-category-list": meta_default6,
+  "promotion-best-deal": meta_default7
+};
+var skills = Object.fromEntries(
+  (await loadModuleSkills("@tbox.cn/app-module-promotion", import.meta.url)).map((s) => [s.name, s])
+);
+var serverModule = {
+  declaration: {
+    moduleId: "promotion"
+  },
+  cards,
+  skills,
+  preTools,
+  register(ctx) {
+    serverCtx = ctx;
+    ctx.services.register("promotion", inMemoryPromotion);
+    for (const tool of Object.values(tools)) {
+      ctx.tools.register(tool);
+    }
+    ctx.cards.registerMap(cards);
+    ctx.handlers.register(createPromotionIntentHandler(ctx));
+    const router = Router();
+    router.get("/entitlement-detail", async (req, res) => {
+      const entitlementRef = typeof req.query["entitlementRef"] === "string" ? req.query["entitlementRef"].trim() : "";
+      if (!entitlementRef) {
+        res.status(400).json({ error: "entitlementRef required" });
+        return;
+      }
+      const reqCtx = getRequestContext(req);
+      if (!reqCtx) {
+        res.status(401).json({ error: "unauthorized" });
+        return;
+      }
+      try {
+        const scopedReqCtx = withMallScopeFromQuery(reqCtx, req.query);
+        const service = await resolvePromotionEntitlementsPort(scopedReqCtx, ctx);
+        const detail = await service.getEntitlementDetail({
+          ...toMallQueryContext4(scopedReqCtx)
+        }, entitlementRef);
+        if (!detail) {
+          res.status(404).json({ error: "not_found" });
+          return;
+        }
+        res.json({ data: entitlementSummary(detail) });
+      } catch (error) {
+        ctx.logger?.warn(`promotion entitlement-detail route failed: ${error.message}`);
+        res.status(500).json({ error: "internal_error" });
+      }
+    });
+    ctx.routes.register("promotion", router);
+    const actions = createPromotionActions(ctx);
+    for (const action of Object.values(actions)) {
+      ctx.cardActions.register(action);
+    }
+  }
+};
+
+export {
+  InMemoryPromotionService,
+  inMemoryPromotion,
+  resolvePromotionOffersPort,
+  resolvePromotionEntitlementsPort,
+  resolvePromotionActivitiesPort,
+  resolvePromotionAcquisitionPort,
+  promotionCards,
+  serverModule
+};