@kuralle-agents/engagement 0.8.5 → 0.9.0

package/dist/interactive-renderer.d.ts

@@ -1,19 +1,4 @@
-import type { ChoiceOption } from '@kuralle-agents/core';
-import type { InteractiveMessage, OutboundMiddleware } from '@kuralle-agents/messaging';
+import type { OutboundMiddleware } from '@kuralle-agents/messaging';
 import type { ChannelPolicy } from './policy.js';
-/** WhatsApp reply-button title limit (R-11). */
-export declare const BUTTON_TITLE_MAX = 20;
-/** WhatsApp list row title limit (R-11). */
-export declare const LIST_ROW_TITLE_MAX = 24;
-/** WhatsApp reply buttons per message. */
-export declare const BUTTON_COUNT_MAX = 3;
-/** WhatsApp list rows per message. */
-export declare const LIST_ROW_COUNT_MAX = 10;
-/**
- * Renders author choices to a channel-neutral `InteractiveMessage`, enforcing
- * WhatsApp limits (R-11). URL options map to a single-button reply shape because
- * `InteractiveMessage` has no dedicated CTA variant — the sink must interpret
- * `ChoiceOption.url` when sending platform CTA messages.
- */
-export declare function renderChoices(options: ChoiceOption[], prompt: string): InteractiveMessage;
+export { renderChoices, BUTTON_TITLE_MAX, LIST_ROW_TITLE_MAX, BUTTON_COUNT_MAX, LIST_ROW_COUNT_MAX, } from '@kuralle-agents/messaging';
 export declare function interactiveRenderer(policies?: ChannelPolicy[]): OutboundMiddleware;

package/dist/interactive-renderer.js

@@ -1,105 +1,8 @@
-/** WhatsApp reply-button title limit (R-11). */
-export const BUTTON_TITLE_MAX = 20;
-/** WhatsApp list row title limit (R-11). */
-export const LIST_ROW_TITLE_MAX = 24;
-/** WhatsApp reply buttons per message. */
-export const BUTTON_COUNT_MAX = 3;
-/** WhatsApp list rows per message. */
-export const LIST_ROW_COUNT_MAX = 10;
-function assertButtonTitle(label, optionId) {
-    if (label.length > BUTTON_TITLE_MAX) {
-        throw new Error(`interactive: button title for "${optionId}" exceeds ${BUTTON_TITLE_MAX} characters (got ${label.length})`);
-    }
-}
-function assertListRowTitle(label, optionId) {
-    if (label.length > LIST_ROW_TITLE_MAX) {
-        throw new Error(`interactive: list row title for "${optionId}" exceeds ${LIST_ROW_TITLE_MAX} characters (got ${label.length})`);
-    }
-}
-/**
- * Renders author choices to a channel-neutral `InteractiveMessage`, enforcing
- * WhatsApp limits (R-11). URL options map to a single-button reply shape because
- * `InteractiveMessage` has no dedicated CTA variant — the sink must interpret
- * `ChoiceOption.url` when sending platform CTA messages.
- */
-export function renderChoices(options, prompt) {
-    if (options.length === 0) {
-        throw new Error('interactive: at least one option is required');
-    }
-    const flowOption = options.find((o) => o.flow);
-    if (flowOption) {
-        if (options.length > 1) {
-            throw new Error('interactive: flow messages support exactly one option');
-        }
-        const { flowId } = flowOption.flow;
-        if (!flowOption.flow.cta) {
-            throw new Error('interactive: flow option requires flow.cta');
-        }
-        return {
-            type: 'flow',
-            body: prompt,
-            action: {
-                type: 'flow',
-                flowId,
-                flowToken: flowOption.id,
-            },
-        };
-    }
-    if (options.some((o) => o.url)) {
-        const urlOptions = options.filter((o) => o.url);
-        if (urlOptions.length > BUTTON_COUNT_MAX) {
-            throw new Error(`interactive: too many URL options (max ${BUTTON_COUNT_MAX} reply buttons)`);
-        }
-        for (const o of urlOptions) {
-            assertButtonTitle(o.label, o.id);
-        }
-        return {
-            type: 'buttons',
-            body: prompt,
-            action: {
-                type: 'buttons',
-                buttons: urlOptions.map((o) => ({ id: o.id, title: o.label })),
-            },
-        };
-    }
-    if (options.length > LIST_ROW_COUNT_MAX) {
-        throw new Error(`interactive: too many options (max ${LIST_ROW_COUNT_MAX} list rows)`);
-    }
-    if (options.length <= BUTTON_COUNT_MAX) {
-        for (const o of options) {
-            assertButtonTitle(o.label, o.id);
-        }
-        return {
-            type: 'buttons',
-            body: prompt,
-            action: {
-                type: 'buttons',
-                buttons: options.map((o) => ({ id: o.id, title: o.label })),
-            },
-        };
-    }
-    for (const o of options) {
-        assertListRowTitle(o.label, o.id);
-    }
-    return {
-        type: 'list',
-        body: prompt,
-        action: {
-            type: 'list',
-            button: 'Choose',
-            sections: [
-                {
-                    title: 'Options',
-                    rows: options.map((o) => ({
-                        id: o.id,
-                        title: o.label,
-                        description: o.description,
-                    })),
-                },
-            ],
-        },
-    };
-}
+// Canonical ChoiceOption -> InteractiveMessage rendering now lives in
+// @kuralle-agents/messaging (the default stream mapper uses it too);
+// re-exported here for existing engagement consumers.
+export { renderChoices, BUTTON_TITLE_MAX, LIST_ROW_TITLE_MAX, BUTTON_COUNT_MAX, LIST_ROW_COUNT_MAX, } from '@kuralle-agents/messaging';
+import { renderChoices } from '@kuralle-agents/messaging';
 function policyFor(policies, platform) {
     return policies.find((p) => p.channel === platform);
 }

package/package.json

@@ -6,7 +6,7 @@
     "url": "git+https://github.com/kuralle/kuralle-agents.git",
     "directory": "packages/kuralle-engagement"
   },
-  "version": "0.8.5",
+  "version": "0.9.0",
   "description": "Channel-agnostic engagement layer for Kuralle agents (window-safe outbound, smart-send, interactive fidelity, handoff, consent, proactive).",
   "type": "module",
   "main": "dist/index.js",
@@ -27,9 +27,9 @@
   "dependencies": {
     "ai": "^6.0.0",
     "zod": "^4.0.0",
-    "@kuralle-agents/core": "0.8.5",
-    "@kuralle-agents/messaging-meta": "0.8.5",
-    "@kuralle-agents/messaging": "0.8.5"
+    "@kuralle-agents/core": "0.9.0",
+    "@kuralle-agents/messaging": "0.9.0",
+    "@kuralle-agents/messaging-meta": "0.9.0"
   },
   "devDependencies": {
     "typescript": "^5.8.2",