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

package/src/server/cards/promotion-offer-list/samples.ts

@@ -0,0 +1,154 @@
+/**
+ * promotion-offer-list 附加预览样本（沉淀自 mall dev-gallery 优惠券链路画廊）。
+ *
+ * 方法论（迁移自画廊维护约定）：
+ * - 覆盖基准是组件实际读取的 data 分支（多券主态/展开收起/缺图长文案/滤掉不可领/空态/
+ *   定向单张），而非 sampleData 的形状；
+ * - 视觉等价的输入合并为一格，note 列全合并口径；
+ * - 样本即契约：data 必须 dataSchema 校验通过且无 shape 外键（tests/samples.test.ts 双断言）；
+ * - 券图为内联 SVG 占位（画廊时期用本地 PNG 位图；模块样本走无网络依赖的 SVG——
+ *   验证的是行高/截断/按钮对齐与缺图兜底，不是图案还原）。
+ */
+import type { CardSample } from '@tbox.cn/app-contracts';
+import type { PromotionOfferListCardData } from '@tbox.cn/app-contracts-mall';
+
+/** 券图占位：中性色块 + 品类色角标（咖啡棕/零售蓝/餐饮红——区分行间差异即可） */
+function couponImage(accent: string): string {
+  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>';
+}
+
+const IMG = {
+  coffee: couponImage('8a5a3b'),
+  lifestyle: couponImage('3d5a80'),
+  dining: couponImage('9e2b25'),
+} as const;
+
+/** 浮层无令牌时的兜底动作（真机 provider 下发的就是「查看详情」的发消息动作）。
+ *  行上的领/抢按钮不读它——那是 claimActionLabel，见样本各条。 */
+const claimAction = (label: string, title: string) => [{
+  kind: 'send' as const,
+  label,
+  value: `我要${label}「${title}」`,
+}];
+
+const claimableOffers = [
+  {
+    offerRef: 'offer:coffee-30',
+    title: '瑞幸咖啡（杭州拱墅示例店）｜30元饮品代金券',
+    subtitle: '1F · 到店点单可用 · 爆卖674万+',
+    offerType: 'COUPON',
+    benefitText: '¥30',
+    priceText: '免费',
+    originalPriceText: '¥30',
+    claimable: true,
+    availabilityStatus: 'AVAILABLE',
+    validityText: '领取后 30 天内有效',
+    imageUrl: IMG.coffee,
+    tags: ['饮品'],
+    itemActions: claimAction('领取', '30元饮品代金券'),
+  },
+  {
+    offerRef: 'offer:lifestyle-120',
+    title: 'KKV 120元优惠券',
+    subtitle: '2F · 全场精选商品可用',
+    offerType: 'COUPON',
+    benefitText: '¥105 · 8.8折',
+    priceText: '¥105',
+    originalPriceText: '¥120',
+    discountLabel: '8.8折',
+    claimable: true,
+    availabilityStatus: 'AVAILABLE',
+    validityText: '有效期至 2026-09-30',
+    imageUrl: IMG.lifestyle,
+    tags: ['零售'],
+    claimActionLabel: '抢购',
+    itemActions: claimAction('抢购', 'KKV 120元优惠券'),
+  },
+  {
+    offerRef: 'offer:dining-30',
+    title: '南京大牌档｜招牌菜品30元无门槛券',
+    subtitle: '4F · 周末及节假日通用',
+    offerType: 'COUPON',
+    benefitText: '¥30',
+    priceText: '¥28.8',
+    originalPriceText: '¥38.8',
+    discountLabel: '7.5折',
+    stockText: '剩余 29 份',
+    usageSceneText: '到店出示券码核销',
+    guaranteeText: '随时退 · 过期自动退',
+    claimable: true,
+    availabilityStatus: 'AVAILABLE',
+    validityText: '有效期至 2026-10-08',
+    imageUrl: IMG.dining,
+    tags: ['餐饮'],
+    claimActionLabel: '抢购',
+    itemActions: claimAction('抢购', '招牌菜品30元无门槛券'),
+  },
+] satisfies NonNullable<PromotionOfferListCardData['items']>;
+
+export const samples: CardSample<PromotionOfferListCardData>[] = [
+  {
+    label: '领券·多券列表',
+    note: '商场神券主态：券图、长标题、利益点和查看入口同屏',
+    group: '领券列表',
+    data: { mode: 'claimable', presentation: 'coupon', summary: '当前商场 · 优惠精选', items: claimableOffers },
+  },
+  {
+    label: '领券·展开与收起',
+    note: 'maxItems 截断 + 透明底部入口与门店导览对齐，文字右侧箭头随展开状态切换',
+    group: '领券列表',
+    data: { mode: 'claimable', presentation: 'coupon', maxItems: 2, items: claimableOffers },
+  },
+  {
+    label: '领券·缺图与长文案',
+    note: '缺图走中性灰兜底（不带色相，免得比真图还抢眼）+ 两行标题截断，不应改变行高与按钮对齐',
+    group: '领券列表',
+    data: {
+      mode: 'claimable', presentation: 'coupon', summary: '部分优惠资格有变化',
+      items: [{
+        ...claimableOffers[0], offerRef: 'offer:no-image', imageUrl: undefined,
+        title: '会员限定超长名称测试｜仅限本周末指定时段到店消费使用的满减优惠券',
+        subtitle: '限周末及节假日 · 每人每日一张', benefitText: '满100减20',
+        priceText: '免费', originalPriceText: '¥20',
+        itemActions: claimAction('领取', '会员限定满减优惠券'),
+      }],
+    },
+  },
+  {
+    label: '领券·滤掉不可领',
+    note: '列表只呈现能领的：三条里一条 claimable=false，渲染出来应只有两行——列出领不了的券，用户点一次才知道点不动',
+    group: '领券列表',
+    data: {
+      mode: 'claimable', presentation: 'coupon',
+      items: [
+        claimableOffers[0],
+        { ...claimableOffers[1], offerRef: 'offer:sold-out', claimable: false, availabilityStatus: 'UNAVAILABLE' },
+        claimableOffers[2],
+      ],
+    },
+  },
+  {
+    label: '领券·空态',
+    note: '当前没有可领取优惠时的明确解释',
+    group: '领券列表',
+    data: { mode: 'claimable', presentation: 'coupon', items: [], noResultsReason: '当前暂无可领取优惠，稍后再来看看' },
+  },
+  {
+    label: '券·定向单张',
+    note: '用户问「XX 券的详情」时的落点：出这一张券的券行（mode=search——用户指名要看的搜索态），点开浮层看详情并领取。'
+      + '不像领券态那样滤掉不可领——指名要看的券即便当下领不了也照样呈现',
+    group: '领券列表',
+    data: {
+      mode: 'search',
+      presentation: 'coupon',
+      items: [{ ...claimableOffers[2], claimable: false, availabilityStatus: 'UNAVAILABLE' }],
+    },
+  },
+];

package/src/server/handler.ts

@@ -1,22 +1,384 @@
-import type { HandlerDefinition } from '@tbox.cn/app-sdk/server';
-import type { PromotionQueryPort } from '@tbox.cn/app-contracts-mall';
-import type { ServerContext } from '@tbox.cn/app-sdk/server';
+/**
+ * promotion 意图 handler（015 S6：intents patterns 命中出搜索/推荐卡；写走 acquire 动作）。
+ */
+import type { HandlerDefinition, ServerContext } from '@tbox.cn/app-sdk/server';
+import { matchIntent } from '@tbox.cn/app-sdk/server';
+import type { IntentRoute } from '@tbox.cn/app-sdk/server';
+import { resolveMemberGate, toMallQueryContext } from '@tbox.cn/app-contracts-mall';
+import type { MemberStatusFactory, PromotionActivityPort } from '@tbox.cn/app-contracts-mall';
+import {
+  resolvePromotionActivitiesPort,
+  resolvePromotionEntitlementsPort,
+  resolvePromotionOffersPort,
+} from './ports';
+import type { PromotionService } from './service';
+import {
+  activityDetail,
+  activitySummary,
+  entitlementSummary,
+  offerDetail,
+  offerSummary,
+} from './tools';
+import { parsePromotionNavigationQuery } from './navigation';
 
-/** promotion handler：查询可领券 → 出 coupon 卡 */
-export function createPromotionHandler(ctx: ServerContext): HandlerDefinition {
+/** 意图路由 patterns（collectIntentRoutes 装配收集；BM25 路由词同源；收窄：删跨域泛词——
+ *  「便宜/折扣/团购/市集/展览」独立泛词经 bigram 泄漏致无关长句误入直出卡；「活动中心」
+ *  为 QuickCommands 固定句补偿，「活动」子串保留于域内长词以维持卡按钮 value 路由） */
+export const PROMOTION_INTENTS = {
+  'list-entitlements': {
+    patterns: ['我的优惠券', '我的券包', '我的券', '已领取的券', '已领优惠券', '持有的优惠券'],
+    description: '查询当前会员已拥有的优惠券',
+  },
+  'search-offers': {
+    patterns: ['领券', '领取优惠券', '有什么优惠', '现在有什么优惠？'],
+    description: '搜索可领优惠',
+  },
+  'list-activities': {
+    patterns: ['营销活动', '有什么活动', '活动中心'],
+    description: '查询营销活动',
+  },
+} as const;
+
+/** 二层分类路由（模块级常量——matchIntent WeakMap 身份缓存稳定；patterns 与 PROMOTION_INTENTS 同源） */
+const PROMOTION_RESOLVE_ROUTES: IntentRoute[] = [
+  {
+    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',
+  },
+];
+
+const OWNED_INTENT_HINTS = ['我的优惠券', '我的券包', '我的券', '已领取', '已领优惠券', '持有的优惠券'];
+const CLAIMABLE_INTENT_HINTS = ['有什么优惠', '可领取', '可领', '领取优惠券', '领券'];
+
+function intentContent(payload: unknown): string {
+  if (typeof payload === 'string') return payload;
+  if (payload && typeof payload === 'object' && 'content' in payload) {
+    const content = (payload as { content?: unknown }).content;
+    return typeof content === 'string' ? content : '';
+  }
+  return '';
+}
+
+type ResolvedIntent =
+  | { kind: keyof typeof PROMOTION_INTENTS }
+  | { kind: 'search-coupons' }
+  | { kind: 'activity-detail'; title: string }
+  | { kind: 'offer-detail'; title: string }
+  | { kind: 'entitlement-detail'; title: string }
+  | { kind: 'activity-category'; name: string };
+
+function resolveIntent(payload: unknown): ResolvedIntent | null {
+  const content = intentContent(payload);
+  const navigation = parsePromotionNavigationQuery(content);
+  if (navigation) return navigation;
+  // 前缀路由洋葱守卫：查看「 引导句未命中导航模板 = 非本域确定性语义（外层 prefix 误延展）
+  // → 返回 null 由 handle 放行 LLM，不以 search-offers 兜底吞轮（bumpin/member/guide 同惯例）。
+  if (content.startsWith(NAVIGATION_SENTENCE_PREFIX)) return null;
+  // 先处理业务边界，再交给 BM25：可领取与已领取是互斥查询轴，避免“优惠券”宽词把首页入口落到券包。
+  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' };
+  // 统一检索层：BM25 竞争决策（替代原 list-activities 优先的双层 includes 翻转）；
+  // 未命中兜底 search-offers（与既有缺省方向一致）
+  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: string, payload: unknown): ResolvedIntent | null {
+  if (action === 'intent') return resolveIntent(payload);
+  if (action === 'list-entitlements' || action === 'search-offers' || action === 'list-activities') {
+    return { kind: action };
+  }
+  return null;
+}
+
+function offerPresentation(offerType: string) {
+  if (offerType === 'PROMOTION') return 'promotion' as const;
+  if (offerType === 'BUNDLE') return 'package' as const;
+  return 'offer' as const;
+}
+
+function offerListPresentation(items: readonly { offerType: string }[]) {
+  return items.length > 0 && items.every((item) => item.offerType === 'COUPON')
+    ? 'coupon' as const
+    : 'offer' as const;
+}
+
+async function activityCategoryNames(service: PromotionActivityPort) {
+  const categories = (await service.listActivityCategories?.()) ?? [];
+  return {
+    categories,
+    names: new Map(categories.map((item) => [item.categoryId, item.name])),
+  };
+}
+
+/** 卡片导航模板句头（promotionNavigationQuery 四式共享头）：确定性前缀路由入口 */
+const NAVIGATION_SENTENCE_PREFIX = '查看「';
+
+/**
+ * 活动意图统一交给 alipay-activity，由该模块按 provider 能力策略投影联单卡。
+ * 未启用策略时返回 continueWith，调用方继续执行既有 promotion provider 路径。
+ */
+async function delegateLinkedActivity(
+  ctx: ServerContext,
+  payload: unknown,
+  reqCtx: NonNullable<Parameters<HandlerDefinition['handle']>[3]>,
+) {
+  const handler = ctx.handlers.resolve('alipay-activity');
+  if (!handler) return undefined;
+  const result = await handler.handle('activity-router', payload, ctx, reqCtx);
+  return result.continueWith ? undefined : result;
+}
+
+export function createPromotionIntentHandler(ctx: ServerContext): HandlerDefinition {
   return {
     id: 'promotion',
-    handle: async (_action, payload) => {
-      const promotion = ctx.resolveService<PromotionQueryPort>('promotion');
-      if (!promotion) return { cards: [], text: '营销服务不可用' };
-      const { userId } = (payload ?? {}) as { userId?: string };
-      if (!userId) return { cards: [], text: '缺少 userId' };
-      const coupons = await promotion.queryEligibleCoupons(userId);
-      if (coupons.length === 0) return { cards: [], text: '暂无可用优惠券' };
-      return {
-        cards: [{ cardType: 'coupon', data: coupons[0] as unknown as Record<string, unknown> }],
-        text: `推荐 ${coupons[0].title}（可抵 ${coupons[0].amount} 元）`,
-      };
+    // 顶层意图 = 确定性触发器（exact 整句 + prefix 导航模板头）：语义分类职责归
+    // skill 路由与 LLM 工具编排（BM25 单标签 + 硬短路会截断复合句，如「推荐门店+领券」）。
+    // QuickCommands 固定句（现在有什么优惠？/活动中心）随 exact 句面直出。
+    intents: [
+      ...Object.values(PROMOTION_INTENTS).map(({ patterns }) => ({ patterns: [...patterns], match: 'exact' as const })),
+      {
+        // 卡片导航模板句（「查看「X」…」四式）前缀路由：handler 内
+        // parsePromotionNavigationQuery 模板全等校验承接；未命中模板 → 洋葱放行（resolveIntent null）。
+        patterns: [NAVIGATION_SENTENCE_PREFIX],
+        match: 'prefix',
+      },
+    ],
+    handle: async (action, payload, _ctx, reqCtx) => {
+      if (!reqCtx) return { cards: [], text: '营销服务不可用（缺少运行上下文）' };
+      const q = toMallQueryContext(reqCtx);
+
+      const resolved = resolveAction(action, payload);
+      if (!resolved) {
+        // 洋葱守卫（洋葱定律 1：未识别 = 失败 = 放行不吞——同 bumpin/member/shopping-guide 惯例）：
+        // prefix 误延展或 action 无法分辨时交还 LLM 主路径（preTool/记忆/Skill 照常），不产卡不产兜底文案。
+        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: `未找到「${resolved.title}」` };
+          const { names } = await activityCategoryNames(service);
+          const registrationUrl = summary.registrationUrl;
+          let detail;
+          try {
+            detail = await service.getActivityDetail(q, summary.activityRef);
+          } catch (error) {
+            (ctx as ServerContext & { logger?: { warn(message: string): void } }).logger?.warn(
+              `活动详情查询失败，降级展示列表摘要：${(error as Error).message}`,
+            );
+          }
+          const projected = detail
+            ? activityDetail(detail, 'detail')
+            : activityDetail(
+                {
+                  ...summary,
+                  sessions: [],
+                  guide: {
+                    steps: [],
+                    conditions: [],
+                    notice: registrationUrl
+                      ? '完整活动安排请前往支付宝活动页查看'
+                      : '活动详细安排暂时无法获取，请稍后重试',
+                  },
+                },
+                'detail',
+              );
+          return {
+            cards: [
+              {
+                cardType: 'promotion-activity-detail',
+                data: {
+                  ...projected,
+                  ...(summary.categoryId && names.get(summary.categoryId)
+                    ? { categoryName: names.get(summary.categoryId) }
+                    : {}),
+                },
+              },
+            ],
+            text: detail
+              ? `这是「${detail.title}」的活动详情`
+              : registrationUrl
+                ? `这是「${summary.title}」的活动概览，可前往支付宝查看完整安排并报名`
+                : `先为你展示「${summary.title}」的活动概览，详细安排暂时无法获取`,
+          };
+        }
+        case 'offer-detail': {
+          const service = await resolvePromotionOffersPort(reqCtx, ctx);
+          const offer = await service.getOfferDetail(q, { keyword: resolved.title });
+          if (!offer) return { cards: [], text: `未找到「${resolved.title}」` };
+          const stores = await service.listOfferStores?.(q, offer.offerRef);
+          return {
+            cards: [
+              {
+                cardType: 'promotion-offer-detail',
+                data: offerDetail(offer, (service as PromotionService).supportsAcquisition !== false, offerPresentation(offer.offerType), stores), // 能力位运行期探测
+              },
+            ],
+            text: `这是「${offer.title}」的优惠详情，可查看使用须知并${offer.claimActionLabel === '抢购' ? '前往小程序抢购' : '领取'}`,
+          };
+        }
+        case 'entitlement-detail': {
+          // 券详情不再单独出卡：出这一张券的「我的券」行，券码与使用说明由行内浮层承载
+          const gate = await resolveMemberGate(
+            ctx.services?.resolve?.('member.status') as MemberStatusFactory | undefined,
+            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: `未在你的券包中找到「${resolved.title}」` };
+          return {
+            cards: [{ cardType: 'promotion-entitlement-list', data: { mallId: q.scope.mallId, miniAppId: q.scope.miniAppId, items: [entitlementSummary(summary)] } }],
+            text: `这是「${summary.title}」，点开可看券码与使用说明`,
+          };
+        }
+        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 as PromotionService).resolveCategoryId?.(resolved.name); // 能力口运行期探测
+          if (!categoryId) return { cards: [], text: `未找到「${resolved.name}」活动分类` };
+          const page = await service.listActivities(q, { categoryId, dataScope: 'CURRENT', limit: 10 });
+          if (page.items.length === 0) return { cards: [], text: `近期暂无「${resolved.name}」分类活动` };
+          return {
+            cards: [
+              {
+                cardType: 'promotion-activity-list',
+                data: {
+                  items: page.items.map((item) => activitySummary(item, names)),
+                  ...(page.nextCursor ? { nextCursor: page.nextCursor } : {}),
+                },
+              },
+            ],
+            text: `为你找到 ${page.items.length} 场「${resolved.name}」活动`,
+          };
+        }
+        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: '暂无可领优惠' };
+          const presentation = offerListPresentation(items);
+          return {
+            cards: [
+              {
+                cardType: 'promotion-offer-list',
+                data: {
+                  presentation,
+                  mode: 'claimable',
+                  items: items.map(offerSummary),
+                },
+              },
+            ],
+            text: `为你找到 ${items.length} 条可领优惠`,
+          };
+        }
+        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: '当前商场暂未找到可领取优惠券' };
+          return {
+            cards: [{ cardType: 'promotion-offer-list', data: {
+              presentation: 'coupon', mode: 'claimable', items: items.map(offerSummary),
+            } }],
+            text: `为你找到 ${items.length} 张可领取优惠券`,
+          };
+        }
+        case 'list-entitlements': {
+          const gate = await resolveMemberGate(
+            ctx.services?.resolve?.('member.status') as MemberStatusFactory | undefined,
+            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) {
+            // 空券降级推荐走 offers 槽（双槽分支：entitlements 查 + offers 推荐）
+            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: `你的券包里还没有优惠券，为你找到 ${items.length} 条可领优惠`,
+              };
+            }
+            return { cards: [], text: '你的券包里还没有优惠券，当前也没有可领取优惠' };
+          }
+          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: `你的券包里有 ${page.items.length} 张优惠券`,
+          };
+        }
+        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: '当前商场近期暂无营销活动' } : {}),
+                },
+              },
+            ],
+            text: page.items.length > 0 ? `近期有 ${page.items.length} 场活动` : '近期暂无营销活动',
+          };
+        }
+        default:
+          return { cards: [], text: '营销服务已就绪，可问我优惠或活动' };
+      }
     },
   };
 }