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

package/dist/chat-protocol/confirm-tool.d.ts

@@ -0,0 +1,50 @@
+/**
+ * The hub's confirm-tool contract — request shape and error envelope.
+ *
+ * Resolving a Product Guide proposal is a POST to `endpoints.approvalToolUrl`
+ * whose response is an ordinary guide stream (a `decision_resolved` frame, then
+ * the hub's auto-continuation). Two callers make that call today: the SSE chat
+ * adapter, and any host replaying the same route into a different transport's
+ * conversation (the product app resolves guide cards inside a NATS Mingo
+ * dialog). They MUST send byte-identical bodies — a proposal is single-use, so a
+ * caller that drifts on a field name does not degrade, it fails the write — and
+ * they must surface the same server copy, because the hub's errors are written
+ * for the end user ("This approval expired — ask again to get a fresh one").
+ *
+ * Hence both live here rather than at either call site.
+ *
+ * Server-safe: no React, no browser APIs.
+ */
+/** What the user did with the card. */
+export type ApprovalToolAction = 'approve' | 'reject';
+/** Client-side shape of a confirm; `buildConfirmToolBody` renames it to the
+ *  wire's own casing so no caller hand-writes `proposal_id`. */
+export interface ConfirmToolRequest {
+    /** The hub-minted proposal id carried by the card. */
+    proposalId: string;
+    action: ApprovalToolAction;
+    /**
+     * The hub's conversation id, quoted back verbatim. The hub rejects a confirm
+     * without it: a proposal only means something inside the conversation that
+     * minted it.
+     */
+    conversationId: string | null | undefined;
+}
+/** Build the confirm-tool request body. The ONE place that knows the wire
+ *  spells the id `proposal_id` while everything else is camelCase. */
+export declare function buildConfirmToolBody(request: ConfirmToolRequest): Record<string, unknown>;
+/**
+ * Pull the user-facing copy out of a failed chat/confirm response.
+ *
+ * The route-base envelope is `{error, code}`; `error` is written for the end
+ * user, so it beats any status-code copy the client could invent. Returns null
+ * when the body is not that envelope (HTML error page, empty body, gateway
+ * response) — the caller then supplies its own generic line.
+ *
+ * Consumes the body: call it once, on a response you have already decided is a
+ * failure.
+ */
+export declare function readServerErrorMessage(response: {
+    json: () => Promise<unknown>;
+}): Promise<string | null>;
+//# sourceMappingURL=confirm-tool.d.ts.map

package/dist/chat-protocol/confirm-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"confirm-tool.d.ts","sourceRoot":"","sources":["../../src/chat-protocol/confirm-tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,uCAAuC;AACvC,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,QAAQ,CAAA;AAErD;gEACgE;AAChE,MAAM,WAAW,kBAAkB;IACjC,sDAAsD;IACtD,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,kBAAkB,CAAA;IAC1B;;;;OAIG;IACH,cAAc,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAA;CAC1C;AAED;sEACsE;AACtE,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAMzF;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,sBAAsB,CAAC,QAAQ,EAAE;IACrD,IAAI,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAA;CAC7B,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAQzB"}

package/dist/chat-protocol/decode.d.ts

@@ -45,14 +45,6 @@ export interface SseFrameDecoder {
      */
     end(): ChatStreamEvent[];
 }
-/**
- * Escape `<` so markdown renderers that pass HTML through (rehypeRaw)
- * don't treat XML-like tokens in Claude's thinking output as elements.
- * `<` → `&lt;` preserves the visible character without breaking
- * blockquote `>` markers. Per-character, so it distributes over
- * concatenation: escape(a + b) === escape(a) + escape(b) — callers may
- * apply it per-delta or on the accumulated string interchangeably.
- */
-export declare function escapeThinkingTags(text: string): string;
+export { escapeThinkingTags } from './leading-frames';
 export declare function createSseFrameDecoder(): SseFrameDecoder;
 //# sourceMappingURL=decode.d.ts.map

package/dist/chat-protocol/decode.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"decode.d.ts","sourceRoot":"","sources":["../../src/chat-protocol/decode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAE/C,MAAM,WAAW,eAAe;IAC9B,iEAAiE;IACjE,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,eAAe,EAAE,CAAA;IAC1C;;;;;;OAMG;IACH,GAAG,IAAI,eAAe,EAAE,CAAA;CACzB;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEvD;AAgJD,wBAAgB,qBAAqB,IAAI,eAAe,CAmHvD"}
+{"version":3,"file":"decode.d.ts","sourceRoot":"","sources":["../../src/chat-protocol/decode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAK/C,MAAM,WAAW,eAAe;IAC9B,iEAAiE;IACjE,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,eAAe,EAAE,CAAA;IAC1C;;;;;;OAMG;IACH,GAAG,IAAI,eAAe,EAAE,CAAA;CACzB;AAKD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AAErD,wBAAgB,qBAAqB,IAAI,eAAe,CAmHvD"}

package/dist/chat-protocol/events.d.ts

@@ -116,7 +116,33 @@ export interface ApprovalRequestEvent extends ChatStreamEventBase {
     fields?: ApprovalRequestField[];
     toolCalls?: ApprovalToolCall[];
     status?: 'pending';
+    /** Set when the card came from a Product Guide frame — see {@link GuideOrigin}. */
+    origin?: GuideOrigin;
 }
+/**
+ * Marks an event whose payload is a Product Guide frame, whatever transport
+ * carried it. It exists because ONE stream can now mix both worlds: the agent
+ * re-streams the hub's frames into a NATS dialog, so a card typed the hub's way
+ * (`approvalType` = the tool name, resolved through the hub's confirm route)
+ * travels beside cards typed the agent's way (`approvalType` = an approval TIER
+ * routed to human escalation).
+ *
+ * Consumers read it to keep the guide half behaving exactly as it does in the
+ * hub's own chat — NOT to give it special treatment. Without it the NATS kernel
+ * would have to guess from `approvalType`, and every tool the hub adds would
+ * silently fall into the escalation path.
+ */
+export type GuideOrigin = 'guide';
+/** The only value of {@link GuideOrigin}. Lives beside the type, and beside the
+ *  predicate below, because both decoders and every consumer that branches on
+ *  provenance must compare against the same token — a bare `'guide'` literal
+ *  typo silently disables the branch instead of failing to compile. */
+export declare const GUIDE_ORIGIN: GuideOrigin;
+/** True for anything stamped as coming from the Product Guide — a stream event
+ *  or the `data` of a segment built from one. */
+export declare function isGuideOrigin(source: {
+    origin?: GuideOrigin | string;
+} | null | undefined): boolean;
 /** An approval request was resolved (SSE `decision_resolved` frame /
  *  NATS APPROVAL_RESULT chunk). */
 export interface ApprovalResolvedEvent extends ChatStreamEventBase {
@@ -135,6 +161,8 @@ export interface ApprovalResolvedEvent extends ChatStreamEventBase {
     marker?: string;
     result?: DecisionResolvedFrame['result'];
     willAutoContinue?: boolean;
+    /** Set when the resolution came from a Product Guide frame — see {@link GuideOrigin}. */
+    origin?: GuideOrigin;
 }
 /** The client is offered a handoff of this ticket to a human technician
  *  (NATS `ESCALATION_OFFER` chunk in state PENDING). Distinct from
@@ -203,6 +231,13 @@ export interface ChatMetadataEvent extends ChatStreamEventBase {
         routedModel?: string;
         routedThinkingBudget: number | null;
     };
+    /**
+     * Set when the metadata came from a Product Guide frame — see
+     * {@link GuideOrigin}. Such an event carries ONLY `conversationId`: it exists
+     * to record the hub's conversation id (every confirm-tool call must quote it
+     * back), NOT to describe the dialog's model, which stays the agent's.
+     */
+    origin?: GuideOrigin;
 }
 /** SSE usage frames — raw wire keys (snake_case) preserved. */
 export interface UsageEvent extends ChatStreamEventBase {

package/dist/chat-protocol/events.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/chat-protocol/events.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/chat-protocol/events.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EACV,oBAAoB,EACpB,qBAAqB,EACrB,cAAc,EACf,MAAM,UAAU,CAAA;AAKjB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAA;AAE3E;sEACsE;AACtE,UAAU,mBAAmB;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAA;CACb;AAED;;;;;;iDAMiD;AACjD,MAAM,WAAW,cAAe,SAAQ,mBAAmB;IACzD,IAAI,EAAE,YAAY,CAAA;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED,MAAM,WAAW,YAAa,SAAQ,mBAAmB;IACvD,IAAI,EAAE,UAAU,CAAA;CACjB;AAED;oEACoE;AACpE,MAAM,WAAW,cAAe,SAAQ,mBAAmB;IACzD,IAAI,EAAE,YAAY,CAAA;IAClB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED;iEACiE;AACjE,MAAM,WAAW,kBAAmB,SAAQ,mBAAmB;IAC7D,IAAI,EAAE,gBAAgB,CAAA;IACtB,IAAI,EAAE,MAAM,CAAA;CACb;AAED;;;;;;iDAMiD;AACjD,MAAM,WAAW,eAAgB,SAAQ,mBAAmB;IAC1D,IAAI,EAAE,aAAa,CAAA;IACnB,IAAI,EAAE,MAAM,CAAA;CACb;AAED;;;;;;0BAM0B;AAC1B,MAAM,WAAW,QAAS,SAAQ,mBAAmB;IACnD,IAAI,EAAE,KAAK,CAAA;IACX,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,aAAa,EAAE,CAAA;CACzB;AAED,MAAM,WAAW,WAAY,SAAQ,mBAAmB;IACtD,IAAI,EAAE,QAAQ,CAAA;IACd,KAAK,EAAE,UAAU,CAAA;CAClB;AAED,qEAAqE;AACrE,MAAM,WAAW,kBAAmB,SAAQ,mBAAmB;IAC7D,IAAI,EAAE,gBAAgB,CAAA;IACtB,IAAI,EAAE;QACJ,IAAI,EAAE,gBAAgB,GAAG,eAAe,CAAA;QACxC,kBAAkB,EAAE,MAAM,CAAA;QAC1B,YAAY,EAAE,MAAM,CAAA;QACpB,SAAS,CAAC,EAAE,MAAM,CAAA;QAClB;;;;;;;WAOG;QACH,eAAe,CAAC,EAAE,MAAM,CAAA;QACxB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;QACpC,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,OAAO,CAAC,EAAE,OAAO,CAAA;QACjB,sBAAsB,CAAC,EAAE,MAAM,CAAA;KAChC,CAAA;CACF;AAED,+DAA+D;AAC/D,MAAM,WAAW,gBAAgB;IAC/B,sBAAsB,EAAE,MAAM,CAAA;IAC9B,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,gBAAgB,EAAE,OAAO,CAAA;IACzB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;CACnD;AAED;;gCAEgC;AAChC,MAAM,WAAW,oBAAqB,SAAQ,mBAAmB;IAC/D,IAAI,EAAE,kBAAkB,CAAA;IACxB,SAAS,EAAE,MAAM,CAAA;IACjB,sEAAsE;IACtE,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,MAAM,CAAC,EAAE,oBAAoB,EAAE,CAAA;IAC/B,SAAS,CAAC,EAAE,gBAAgB,EAAE,CAAA;IAC9B,MAAM,CAAC,EAAE,SAAS,CAAA;IAClB,mFAAmF;IACnF,MAAM,CAAC,EAAE,WAAW,CAAA;CACrB;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,WAAW,GAAG,OAAO,CAAA;AAEjC;;;uEAGuE;AACvE,eAAO,MAAM,YAAY,EAAE,WAAqB,CAAA;AAEhD;iDACiD;AACjD,wBAAgB,aAAa,CAC3B,MAAM,EAAE;IAAE,MAAM,CAAC,EAAE,WAAW,GAAG,MAAM,CAAA;CAAE,GAAG,IAAI,GAAG,SAAS,GAC3D,OAAO,CAET;AAED;mCACmC;AACnC,MAAM,WAAW,qBAAsB,SAAQ,mBAAmB;IAChE,IAAI,EAAE,mBAAmB,CAAA;IACzB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,UAAU,GAAG,UAAU,CAAA;IAC/B,EAAE,CAAC,EAAE,OAAO,CAAA;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB;8CAC0C;IAC1C,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,qBAAqB,CAAC,QAAQ,CAAC,CAAA;IACxC,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B,yFAAyF;IACzF,MAAM,CAAC,EAAE,WAAW,CAAA;CACrB;AAED;;;;;2EAK2E;AAC3E,MAAM,WAAW,oBAAqB,SAAQ,mBAAmB;IAC/D,IAAI,EAAE,kBAAkB,CAAA;IACxB,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,sDAAsD;AACtD,eAAO,MAAM,gBAAgB;;;;;CAKnB,CAAA;AAEV;;uEAEuE;AACvE,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,OAAO,GACb,4BAA4B,CAAC,QAAQ,CAAC,GAAG,IAAI,CAW/C;AAED;;;0EAG0E;AAC1E,MAAM,WAAW,4BAA6B,SAAQ,mBAAmB;IACvE,IAAI,EAAE,2BAA2B,CAAA;IACjC,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,UAAU,GAAG,UAAU,GAAG,WAAW,CAAA;IAC7C,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC/B;AAED;;;;qBAIqB;AACrB,MAAM,WAAW,oBAAqB,SAAQ,mBAAmB;IAC/D,IAAI,EAAE,kBAAkB,CAAA;IACxB,QAAQ,EAAE,MAAM,CAAA;IAChB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED;;oEAEoE;AACpE,MAAM,WAAW,iBAAkB,SAAQ,mBAAmB;IAC5D,IAAI,EAAE,UAAU,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,yDAAyD;IACzD,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,sBAAsB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACtC,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB;;4DAEwD;IACxD,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,OAAO,CAAC,EAAE;QACR,gBAAgB,EAAE,MAAM,CAAA;QACxB,WAAW,CAAC,EAAE,MAAM,CAAA;QACpB,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAA;KACpC,CAAA;IACD;;;;;OAKG;IACH,MAAM,CAAC,EAAE,WAAW,CAAA;CACrB;AAED,+DAA+D;AAC/D,MAAM,WAAW,UAAW,SAAQ,mBAAmB;IACrD,IAAI,EAAE,OAAO,CAAA;IACb,KAAK,EAAE,OAAO,GAAG,KAAK,CAAA;IACtB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,uBAAuB,CAAC,EAAE,MAAM,CAAA;IAChC,2BAA2B,CAAC,EAAE,MAAM,CAAA;IACpC,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,SAAS,CAAC,EAAE,cAAc,CAAA;IAC1B;;;;yBAIqB;IACrB,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAED,wDAAwD;AACxD,MAAM,WAAW,eAAgB,SAAQ,mBAAmB;IAC1D,IAAI,EAAE,aAAa,CAAA;IACnB,eAAe,EAAE,MAAM,CAAA;IACvB,gBAAgB,EAAE,MAAM,CAAA;IACxB,eAAe,EAAE,MAAM,CAAA;IACvB,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,eAAgB,SAAQ,mBAAmB;IAC1D,IAAI,EAAE,YAAY,CAAA;IAClB,KAAK,EAAE,OAAO,GAAG,KAAK,CAAA;IACtB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,UAAW,SAAQ,mBAAmB;IACrD,IAAI,EAAE,OAAO,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED;;YAEY;AACZ;;;;;;;GAOG;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,QAAQ,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAA;AAE9D,8DAA8D;AAC9D,eAAO,MAAM,gBAAgB,UAAU,CAAA;AAEvC,MAAM,WAAW,gBAAiB,SAAQ,mBAAmB;IAC3D,IAAI,EAAE,aAAa,CAAA;IACnB,IAAI,EAAE,iBAAiB,GAAG,gBAAgB,GAAG,QAAQ,CAAA;IACrD,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,CAAC,EAAE,aAAa,CAAA;IACzB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,YAAY,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAClE;AAED,MAAM,WAAW,iBAAkB,SAAQ,mBAAmB;IAC5D,IAAI,EAAE,eAAe,CAAA;CACtB;AAED,MAAM,MAAM,eAAe,GACvB,cAAc,GACd,YAAY,GACZ,cAAc,GACd,kBAAkB,GAClB,eAAe,GACf,QAAQ,GACR,WAAW,GACX,kBAAkB,GAClB,oBAAoB,GACpB,qBAAqB,GACrB,oBAAoB,GACpB,4BAA4B,GAC5B,oBAAoB,GACpB,iBAAiB,GACjB,UAAU,GACV,eAAe,GACf,eAAe,GACf,UAAU,GACV,gBAAgB,GAChB,iBAAiB,CAAA"}

package/dist/chat-protocol/index.cjs

@@ -6,6 +6,10 @@ var END_OF_LEADING = "";
 var TRAILER_SENTINEL = "";
 
 // src/chat-protocol/events.ts
+var GUIDE_ORIGIN = "guide";
+function isGuideOrigin(source) {
+  return source?.origin === GUIDE_ORIGIN;
+}
 var ESCALATION_STATE = {
   PENDING: "PENDING",
   APPROVED: "APPROVED",
@@ -45,7 +49,7 @@ function encodeTrailingUsageFrame(frame) {
   return encoder.encode(TRAILER_SENTINEL + JSON.stringify(frame));
 }
 
-// src/chat-protocol/decode.ts
+// src/chat-protocol/leading-frames.ts
 function escapeThinkingTags(text) {
   return text.replace(/</g, "&lt;");
 }
@@ -152,6 +156,8 @@ function mapLeadingFrame(meta, out) {
     });
   }
 }
+
+// src/chat-protocol/decode.ts
 function createSseFrameDecoder() {
   const textDecoder = new TextDecoder();
   let buffer = "";
@@ -299,6 +305,37 @@ function normalizeAskOptions(raw) {
     description: typeof item.description === "string" ? item.description : void 0
   })).filter((option) => option.label.length > 0);
 }
+var AGENT_OWNED_EVENTS = /* @__PURE__ */ new Set([
+  "usage",
+  "token-usage",
+  "status",
+  "compaction",
+  "participant",
+  "dialog-closed"
+]);
+var ORIGIN_BEARING_EVENTS = /* @__PURE__ */ new Set([
+  "approval-request",
+  "approval-resolved"
+]);
+function guideEventForNats(event) {
+  switch (event.type) {
+    case "text-delta":
+      return { type: "guide-delta", text: event.text };
+    case "thinking-delta":
+      return { type: "thinking-delta", text: escapeThinkingTags(event.text) };
+    case "metadata":
+      return typeof event.conversationId === "string" && event.conversationId ? { type: "metadata", conversationId: event.conversationId, origin: GUIDE_ORIGIN } : null;
+    default:
+      if (AGENT_OWNED_EVENTS.has(event.type)) return null;
+      return ORIGIN_BEARING_EVENTS.has(event.type) ? { ...event, origin: GUIDE_ORIGIN } : event;
+  }
+}
+function guideFrameEvent(frame) {
+  const events = [];
+  mapLeadingFrame(frame, events);
+  const event = events[0];
+  return event ? guideEventForNats(event) : null;
+}
 function decodeNatsChunk(chunk) {
   if (!chunk || typeof chunk !== "object") return null;
   const data = chunk;
@@ -333,11 +370,20 @@ function decodeNatsChunk(chunk) {
         return { type: "thinking-delta", text: data.text, ...seq };
       }
       return null;
-    case MESSAGE_TYPE.GUIDE:
+    // Two shapes share this chunk type. `text` is the answer body the agent
+    // streams (and persists). `payload` is a Product Guide frame re-streamed
+    // verbatim from the hub — decoded through the shared frame table, with the
+    // narrowing `guideFrameEvent` documents.
+    case MESSAGE_TYPE.GUIDE: {
       if (typeof data.text === "string") {
         return { type: "guide-delta", text: data.text, ...seq };
       }
-      return null;
+      const frame = data.payload;
+      if (!frame || typeof frame !== "object" || Array.isArray(frame)) return null;
+      const event = guideFrameEvent(frame);
+      if (!event) return null;
+      return { ...event, ...seq };
+    }
     // An ask card is only an ask card with something to pick: a question and at
     // least one option. Anything less is dropped rather than rendered as an
     // empty card the user can't answer — the backend already falls back to a
@@ -517,6 +563,23 @@ function decodeNatsChunk(chunk) {
   }
 }
 
+// src/chat-protocol/confirm-tool.ts
+function buildConfirmToolBody(request) {
+  return {
+    proposal_id: request.proposalId,
+    action: request.action,
+    conversationId: request.conversationId
+  };
+}
+async function readServerErrorMessage(response) {
+  try {
+    const body = await response.json();
+    if (typeof body?.error === "string" && body.error.length > 0) return body.error;
+  } catch {
+  }
+  return null;
+}
+
 // src/chat-protocol/ip-normalize.ts
 var IP_BUCKET_KEY_MAX_LENGTH = 64;
 function isIpv4(value) {
@@ -594,8 +657,10 @@ exports.CHAT_OWNER_ADMIN = CHAT_OWNER_ADMIN;
 exports.END_OF_LEADING = END_OF_LEADING;
 exports.ESCALATION_STATE = ESCALATION_STATE;
 exports.FRAME_TERMINATOR = FRAME_TERMINATOR;
+exports.GUIDE_ORIGIN = GUIDE_ORIGIN;
 exports.IP_BUCKET_KEY_MAX_LENGTH = IP_BUCKET_KEY_MAX_LENGTH;
 exports.TRAILER_SENTINEL = TRAILER_SENTINEL;
+exports.buildConfirmToolBody = buildConfirmToolBody;
 exports.createSseFrameDecoder = createSseFrameDecoder;
 exports.decodeNatsChunk = decodeNatsChunk;
 exports.encodeEndOfLeading = encodeEndOfLeading;
@@ -605,8 +670,12 @@ exports.encodeTrailingUsageFrame = encodeTrailingUsageFrame;
 exports.envFlagEnabled = envFlagEnabled;
 exports.escalationResolvedStatus = escalationResolvedStatus;
 exports.escapeThinkingTags = escapeThinkingTags;
+exports.guideEventForNats = guideEventForNats;
+exports.guideFrameEvent = guideFrameEvent;
+exports.isGuideOrigin = isGuideOrigin;
 exports.normalizeAskOptions = normalizeAskOptions;
 exports.normalizeIpForBucketKey = normalizeIpForBucketKey;
+exports.readServerErrorMessage = readServerErrorMessage;
 exports.stripSentinelBytes = stripSentinelBytes;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map