@flamingo-stack/openframe-frontend-core 0.0.532 → 0.0.533

package/dist/chat-protocol/nats-decoder.d.ts

@@ -17,10 +17,51 @@
  */
 import type { AskOptionData } from '../components/chat/types/message.types';
 import type { ChatStreamEvent } from './events';
+export { GUIDE_ORIGIN } from './events';
 /** Coerce the wire's ask `options[]` into the card's row shape. Rows without a
  *  usable `label` are dropped: the label is what gets SENT when the row is
  *  picked, so a blank one would post an empty reply. */
 export declare function normalizeAskOptions(raw: unknown): AskOptionData[];
+/**
+ * Adapt ONE Product Guide event to the NATS kernel.
+ *
+ * The guide half of a Mingo dialog is the hub's own stream, so it is decoded by
+ * the shared table in `./leading-frames` and then passed through here — the ONE
+ * place that reconciles the two kernels. Both entry points use it: frames
+ * re-streamed by the agent inside `GUIDE` chunks, and the SSE response of the
+ * hub's confirm-tool route, which a host replays into the same dialog.
+ *
+ * Pass-through is the DEFAULT; only these rules alter an event, and each exists
+ * because the two kernels genuinely disagree:
+ *
+ *   - `text-delta` becomes `guide-delta`: the body of a guide turn belongs
+ *     inside the "OpenFrame Guide" card, and a `text` segment would strand part
+ *     of the same answer outside it.
+ *   - thinking is escaped HERE. The SSE kernel escapes `<` on the way in, the
+ *     NATS kernel does not, and the guide's thinking is full of XML-ish tokens
+ *     that would otherwise render as markup.
+ *   - `metadata` survives ONLY to carry `conversationId`, which the hub mints
+ *     and every confirm-tool call must quote back. Everything else on that
+ *     frame (the hub's model, routing) is dropped: `applyNats` rebuilds the
+ *     dialog's live model from a metadata event, so letting it through would
+ *     relabel a Mingo turn with the hub's model, and a routing frame — which
+ *     carries no model at all — would blank the badge mid-answer.
+ *   - dialog-level events stop here (`AGENT_OWNED_EVENTS`).
+ *
+ * Everything else crosses over as the hub typed it, gaining only `origin`.
+ * `approvalType` in particular stays the TOOL NAME, exactly as in the hub's own
+ * chat: the NATS kernel gates approvals on approval TIER and escalates the rest,
+ * which is an agent-side concept a hub proposal has no tier for. Rewriting the
+ * tool name into a fake tier to slip past that gate would make the guide half of
+ * the stream diverge from the guide chat itself.
+ */
+export declare function guideEventForNats(event: ChatStreamEvent): ChatStreamEvent | null;
+/**
+ * Decode one re-streamed Product Guide frame (a `GUIDE` chunk's `payload`) into
+ * a NATS event. The frame grammar is decoded by the shared table, never by a
+ * second copy here; the kernel reconciliation is `guideEventForNats`.
+ */
+export declare function guideFrameEvent(frame: Record<string, unknown>): ChatStreamEvent | null;
 /**
  * Parse one raw NATS chunk into a normalized event. Returns `null` for
  * unknown/malformed chunks — an unrecognized `type`, a missing required

package/dist/chat-protocol/nats-decoder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"nats-decoder.d.ts","sourceRoot":"","sources":["../../src/chat-protocol/nats-decoder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAA;AAE3E,OAAO,KAAK,EAAoB,eAAe,EAAE,MAAM,UAAU,CAAA;AA4BjE;;wDAEwD;AACxD,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,GAAG,aAAa,EAAE,CASjE;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,GAAG,IAAI,CAiRtE"}
+{"version":3,"file":"nats-decoder.d.ts","sourceRoot":"","sources":["../../src/chat-protocol/nats-decoder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAA;AAE3E,OAAO,KAAK,EAAoB,eAAe,EAAE,MAAM,UAAU,CAAA;AAUjE,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AAwBvC;;wDAEwD;AACxD,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,GAAG,aAAa,EAAE,CASjE;AA+BD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,eAAe,GAAG,eAAe,GAAG,IAAI,CAgBhF;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,eAAe,GAAG,IAAI,CAMtF;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,GAAG,IAAI,CA0RtE"}