@pouchy_ai/companion-sdk 0.29.1 → 0.32.0

package/dist/index.d.ts

@@ -1,13 +1,17 @@
 import { CompanionClient, type CompanionClientOptions } from './client.js';
 export { CompanionClient, CompanionError, pouchyBrandIconUrl } from './client.js';
-export type { CompanionErrorCodeValue } from './errors.js';
-export type { CompanionClientOptions, HelloAck, RecalledMemory, CompanionTurn, CallCredentials, CompanionToolDecl, ToolCallEvent, WorldStateInput, CompanionAvatar, CompanionWallet, WalletBalance, BrandIconSize, EndSessionResult, SendTextReply } from './client.js';
+export type { CompanionDebugEvent } from './client.js';
+export type { CompanionErrorCodeValue, ControlErrorCodeValue } from './errors.js';
+export type { CompanionClientOptions, CompanionStreamState, HelloAck, RecalledMemory, CompanionTurn, CallCredentials, CompanionToolDecl, ToolCallEvent, WorldStateInput, CompanionAvatar, CompanionWallet, WalletBalance, BrandIconSize, EndSessionResult, SendTextReply } from './client.js';
 export { openCompanionCall, HOST_CONTROL_TOOLS, HOST_CONTROL_TOOL_NAMES, AVATAR_VISUAL_TOOLS, AVATAR_VISUAL_TOOL_NAMES } from './call.js';
 export type { CompanionCall, CompanionCallOptions, VoiceToolBridge } from './call.js';
 export { COMPANION_SCOPES, COMPANION_MODALITIES, SENSITIVE_SCOPES, REPRESENT_SCOPES, DEFAULT_SCOPES, DEFAULT_MODALITIES, isSensitiveScope, isRepresentScope, hasScope } from './scopes.js';
 export type { CompanionScope, CompanionModality } from './scopes.js';
-export type { CompanionEnvelope, OutboundType, InboundType, WorldStateEvent, RenderInterfacePayload, InterfaceUpdatePayload, SocialMessagePayload, ConfirmRequestPayload, PendingConfirm, ToolCallPayload, AudioClipPayload, ExpressionPayload, TypingPayload, VoiceInjectPayload, UsagePayload, MessagePayload } from './protocol.js';
-export { PROTOCOL_VERSION, INBOUND_TYPES, OUTBOUND_TYPES, COMPANION_ERROR_CODES } from './protocol.js';
-export type { CompanionErrorCode } from './protocol.js';
+export type { CompanionEnvelope, OutboundType, InboundType, WorldStateEvent, RenderInterfacePayload, InterfaceUpdatePayload, SocialMessagePayload, ConfirmRequestPayload, PendingConfirm, ToolCallPayload, AudioClipPayload, ExpressionPayload, TypingPayload, VoiceInjectPayload, UsagePayload, MessagePayload, ControlErrorPayload, HelloAckPayload, CallReadyPayload, OutboundPayloadMap } from './protocol.js';
+export { PROTOCOL_VERSION, INBOUND_TYPES, OUTBOUND_TYPES, COMPANION_ERROR_CODES, CONTROL_ERROR_CODES } from './protocol.js';
+export type { CompanionErrorCode, ControlErrorCode } from './protocol.js';
+export { createCompanionView } from './adapter-core.js';
+export type { CompanionView, CompanionViewOptions, CompanionViewSnapshot, CompanionTranscriptEntry } from './adapter-core.js';
 /** Create a companion client. */
 export declare function createCompanion(opts: CompanionClientOptions): CompanionClient;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,eAAe,EAAE,KAAK,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAExE,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAC/E,YAAY,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AACpD,YAAY,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AAC/E,YAAY,EACX,sBAAsB,EACtB,oBAAoB,EACpB,QAAQ,EACR,cAAc,EACd,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,aAAa,EACb,eAAe,EACf,eAAe,EACf,eAAe,EACf,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,aAAa,EACb,MAAM,UAAU,CAAC;AAClB,OAAO,EACN,iBAAiB,EACjB,kBAAkB,EAClB,uBAAuB,EACvB,mBAAmB,EACnB,wBAAwB,EACxB,MAAM,QAAQ,CAAC;AAChB,YAAY,EAAE,aAAa,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AACnF,OAAO,EACN,gBAAgB,EAChB,oBAAoB,EACpB,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACd,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,QAAQ,EACR,MAAM,UAAU,CAAC;AAClB,YAAY,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAClE,YAAY,EACX,iBAAiB,EACjB,YAAY,EACZ,WAAW,EACX,eAAe,EACf,sBAAsB,EACtB,sBAAsB,EACtB,oBAAoB,EACpB,qBAAqB,EACrB,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,aAAa,EACb,kBAAkB,EAClB,YAAY,EACZ,cAAc,EACd,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAClB,MAAM,YAAY,CAAC;AAKpB,OAAO,EACN,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,qBAAqB,EACrB,mBAAmB,EACnB,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAKvE,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrD,YAAY,EACX,aAAa,EACb,oBAAoB,EACpB,qBAAqB,EACrB,wBAAwB,EACxB,MAAM,gBAAgB,CAAC;AAExB,iCAAiC;AACjC,wBAAgB,eAAe,CAAC,IAAI,EAAE,sBAAsB,GAAG,eAAe,CAE7E"}

package/dist/index.js

@@ -15,8 +15,15 @@ export { openCompanionCall, HOST_CONTROL_TOOLS, HOST_CONTROL_TOOL_NAMES, AVATAR_
 export { COMPANION_SCOPES, COMPANION_MODALITIES, SENSITIVE_SCOPES, REPRESENT_SCOPES, DEFAULT_SCOPES, DEFAULT_MODALITIES, isSensitiveScope, isRepresentScope, hasScope } from './scopes.js';
 // Runtime protocol constants — so a host can assert PROTOCOL_VERSION or
 // enumerate/validate the event vocabulary without hard-coding the strings.
-export { PROTOCOL_VERSION, INBOUND_TYPES, OUTBOUND_TYPES, COMPANION_ERROR_CODES } from './protocol.js';
+// CONTROL_ERROR_CODES (0.30.0) is the stream-plane control.error vocabulary —
+// a separate, smaller list than the HTTP COMPANION_ERROR_CODES.
+export { PROTOCOL_VERSION, INBOUND_TYPES, OUTBOUND_TYPES, COMPANION_ERROR_CODES, CONTROL_ERROR_CODES } from './protocol.js';
+// The framework-agnostic view controller behind the /react, /svelte and /vue
+// subpath adapters — exported from the root too, so a host on any OTHER
+// framework (or none) can reuse the same tested snapshot bookkeeping.
+export { createCompanionView } from './adapter-core.js';
 /** Create a companion client. */
 export function createCompanion(opts) {
     return new CompanionClient(opts);
 }
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,yEAAyE;AACzE,sDAAsD;AACtD,EAAE;AACF,0DAA0D;AAC1D,6EAA6E;AAC7E,uBAAuB;AACvB,8CAA8C;AAC9C,eAAe;AACf,8EAA8E;AAC9E,2CAA2C;AAE3C,OAAO,EAAE,eAAe,EAA+B,MAAM,UAAU,CAAC;AAExE,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAoB/E,OAAO,EACN,iBAAiB,EACjB,kBAAkB,EAClB,uBAAuB,EACvB,mBAAmB,EACnB,wBAAwB,EACxB,MAAM,QAAQ,CAAC;AAEhB,OAAO,EACN,gBAAgB,EAChB,oBAAoB,EACpB,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACd,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,QAAQ,EACR,MAAM,UAAU,CAAC;AAwBlB,wEAAwE;AACxE,2EAA2E;AAC3E,8EAA8E;AAC9E,gEAAgE;AAChE,OAAO,EACN,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,qBAAqB,EACrB,mBAAmB,EACnB,MAAM,YAAY,CAAC;AAGpB,6EAA6E;AAC7E,wEAAwE;AACxE,sEAAsE;AACtE,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAQrD,iCAAiC;AACjC,MAAM,UAAU,eAAe,CAAC,IAA4B;IAC3D,OAAO,IAAI,eAAe,CAAC,IAAI,CAAC,CAAC;AAClC,CAAC"}

package/dist/protocol.d.ts

@@ -12,6 +12,15 @@ export type InboundType = (typeof INBOUND_TYPES)[number];
 export declare const OUTBOUND_TYPES: readonly ["hello.ack", "companion.message", "companion.audio", "companion.tool_call", "companion.ui_action", "companion.ui_update", "companion.expression", "companion.voice_inject", "companion.confirm_request", "companion.social_message", "companion.typing", "control.call_ready", "control.error", "control.usage"];
 export type OutboundType = (typeof OUTBOUND_TYPES)[number];
 export type MessageType = InboundType | OutboundType;
+/** `control.error` STREAM-plane code vocabulary (0.30.0) — a separate, smaller
+ *  vocabulary from COMPANION_ERROR_CODES below (those tag HTTP `{ok:false}`
+ *  response bodies; these tag `control.error` envelopes on the event stream,
+ *  surfaced by `onError`). Self-contained mirror of the server list
+ *  (drift-tested); APPEND-ONLY. The SDK itself synthesizes one more,
+ *  `stream_unauthorized` (errors.ts) — the public union `ControlErrorCodeValue`
+ *  covers both plus a forward-compat string arm. */
+export declare const CONTROL_ERROR_CODES: readonly ["agent_error", "call_mint_failed"];
+export type ControlErrorCode = (typeof CONTROL_ERROR_CODES)[number];
 /** HTTP error `code` vocabulary — what `CompanionError.code` can hold. A
  *  self-contained mirror of the server's api-error.ts list (drift-tested);
  *  APPEND-ONLY: renaming or removing a code is a breaking SDK change.
@@ -187,3 +196,52 @@ export interface WorldStateEvent<D = unknown> {
     salience?: number;
     voiceRelevant?: boolean;
 }
+/** Payload of a `control.error` event — a typed error on the event stream
+ *  (surfaced by `onError`). `code` is one of CONTROL_ERROR_CODES, the
+ *  SDK-synthesized `stream_unauthorized`, or a code newer than this SDK build
+ *  (the open arm keeps forward compat without losing autocomplete). */
+export interface ControlErrorPayload {
+    code: ControlErrorCode | (string & {});
+    message: string;
+}
+/** Payload of a `hello.ack` — the handshake reply. On the REST plane this is
+ *  the `/session` response body (what `connect()` normalizes into `HelloAck`);
+ *  the event stream's greeting `open` frame carries a partial echo (just
+ *  `{ resumeCursor }`), so every field is optional at the wire level. */
+export interface HelloAckPayload {
+    session?: string;
+    grantedScopes?: string[];
+    modalities?: string[];
+    resumeCursor?: number;
+    representative?: boolean;
+    visitorPaired?: boolean;
+}
+/** Payload of a `control.call_ready` event — the stream echo of `start_call`'s
+ *  accept. Deliberately SECRET-FREE (`provider` plus non-secret metadata such
+ *  as `agentId` / `model` / `voice`); the actual WebRTC credentials only ride
+ *  the `startCall` HTTP response. */
+export interface CallReadyPayload {
+    provider: string;
+    [k: string]: unknown;
+}
+/** Per-event payload types, keyed by outbound event name — what `client.on()`
+ *  narrows envelopes with (0.30.0). Type-only; extending the base Record keeps
+ *  indexing valid for every OutboundType, so an event added to the vocabulary
+ *  before it gets a dedicated payload type simply reads as `unknown`. */
+export interface OutboundPayloadMap extends Record<OutboundType, unknown> {
+    'hello.ack': HelloAckPayload;
+    'companion.message': MessagePayload;
+    'companion.audio': AudioClipPayload;
+    'companion.tool_call': ToolCallPayload;
+    'companion.ui_action': RenderInterfacePayload;
+    'companion.ui_update': InterfaceUpdatePayload;
+    'companion.expression': ExpressionPayload;
+    'companion.voice_inject': VoiceInjectPayload;
+    'companion.confirm_request': ConfirmRequestPayload;
+    'companion.social_message': SocialMessagePayload;
+    'companion.typing': TypingPayload;
+    'control.call_ready': CallReadyPayload;
+    'control.error': ControlErrorPayload;
+    'control.usage': UsagePayload;
+}
+//# sourceMappingURL=protocol.d.ts.map

package/dist/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"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"}

package/dist/protocol.js

@@ -40,6 +40,17 @@ export const OUTBOUND_TYPES = [
     'control.error',
     'control.usage' // reserved — not emitted yet
 ];
+/** `control.error` STREAM-plane code vocabulary (0.30.0) — a separate, smaller
+ *  vocabulary from COMPANION_ERROR_CODES below (those tag HTTP `{ok:false}`
+ *  response bodies; these tag `control.error` envelopes on the event stream,
+ *  surfaced by `onError`). Self-contained mirror of the server list
+ *  (drift-tested); APPEND-ONLY. The SDK itself synthesizes one more,
+ *  `stream_unauthorized` (errors.ts) — the public union `ControlErrorCodeValue`
+ *  covers both plus a forward-compat string arm. */
+export const CONTROL_ERROR_CODES = [
+    'agent_error', // a server-side turn failed after the input was accepted — no reply was produced; safe to re-send
+    'call_mint_failed' // start_call couldn't mint the voice-provider credential — retry later or fall back to text
+];
 /** HTTP error `code` vocabulary — what `CompanionError.code` can hold. A
  *  self-contained mirror of the server's api-error.ts list (drift-tested);
  *  APPEND-ONLY: renaming or removing a code is a breaking SDK change.
@@ -62,3 +73,4 @@ export const COMPANION_ERROR_CODES = [
     'step_up_required', // 401 — approval needs a passkey assertion (fetch confirm/stepup)
     'step_up_failed' // 401 — the passkey assertion didn't verify; retry the step-up
 ];
+//# sourceMappingURL=protocol.js.map

package/dist/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,+EAA+E;AAC/E,EAAE;AACF,mFAAmF;AACnF,iFAAiF;AACjF,gFAAgF;AAEhF,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAU,CAAC;AAE3C,yCAAyC;AACzC,MAAM,CAAC,MAAM,aAAa,GAAG;IAC5B,OAAO;IACP,YAAY;IACZ,eAAe;IACf,kBAAkB;IAClB,aAAa;IACb,oBAAoB;IACpB,kBAAkB;IAClB,wBAAwB;IACxB,cAAc;CACL,CAAC;AAGX;;;;;;qCAMqC;AACrC,MAAM,CAAC,MAAM,cAAc,GAAG;IAC7B,WAAW;IACX,mBAAmB;IACnB,iBAAiB,EAAE,6BAA6B;IAChD,qBAAqB;IACrB,qBAAqB;IACrB,qBAAqB;IACrB,sBAAsB,EAAE,6BAA6B;IACrD,wBAAwB;IACxB,2BAA2B;IAC3B,0BAA0B;IAC1B,kBAAkB;IAClB,oBAAoB;IACpB,eAAe;IACf,eAAe,CAAC,6BAA6B;CACpC,CAAC;AAKX;;;;;;oDAMoD;AACpD,MAAM,CAAC,MAAM,mBAAmB,GAAG;IAClC,aAAa,EAAE,kGAAkG;IACjH,kBAAkB,CAAC,4FAA4F;CACtG,CAAC;AAGX;;;4EAG4E;AAC5E,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACpC,eAAe,EAAE,wCAAwC;IACzD,eAAe,EAAE,2CAA2C;IAC5D,eAAe,EAAE,qCAAqC;IACtD,iBAAiB,EAAE,mDAAmD;IACtE,mBAAmB,EAAE,2CAA2C;IAChE,cAAc,EAAE,+CAA+C;IAC/D,kBAAkB,EAAE,kDAAkD;IACtE,cAAc,EAAE,uDAAuD;IACvE,mBAAmB,EAAE,2CAA2C;IAChE,cAAc,EAAE,mFAAmF;IACnG,WAAW,EAAE,wDAAwD;IACrE,aAAa,EAAE,sDAAsD;IACrE,mBAAmB,EAAE,iDAAiD;IACtE,kBAAkB,EAAE,6DAA6D;IACjF,kBAAkB,EAAE,kEAAkE;IACtF,gBAAgB,CAAC,+DAA+D;CACvE,CAAC"}

package/dist/scopes.d.ts

@@ -22,3 +22,4 @@ export declare function isRepresentScope(s: CompanionScope): boolean;
 /** Does a granted scope set (e.g. `hello.ack.grantedScopes`) satisfy a
  *  required scope? Exact-match for v1 (no hierarchical wildcards). */
 export declare function hasScope(granted: readonly string[], required: CompanionScope): boolean;
+//# sourceMappingURL=scopes.d.ts.map

package/dist/scopes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scopes.d.ts","sourceRoot":"","sources":["../src/scopes.ts"],"names":[],"mappings":"AAUA,8EAA8E;AAC9E,eAAO,MAAM,gBAAgB,8UAsBnB,CAAC;AACX,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE/D,2DAA2D;AAC3D,eAAO,MAAM,oBAAoB,6CAA8C,CAAC;AAChF,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEtE;;iDAEiD;AACjD,eAAO,MAAM,gBAAgB,EAAE,WAAW,CAAC,cAAc,CAWvD,CAAC;AAEH;;;6EAG6E;AAC7E,eAAO,MAAM,gBAAgB,EAAE,WAAW,CAAC,cAAc,CAMvD,CAAC;AAEH;oEACoE;AACpE,eAAO,MAAM,cAAc,EAAE,SAAS,cAAc,EASnD,CAAC;AACF,eAAO,MAAM,kBAAkB,EAAE,SAAS,iBAAiB,EAAsB,CAAC;AAElF,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,cAAc,GAAG,OAAO,CAE3D;AACD,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,cAAc,GAAG,OAAO,CAE3D;AAED;sEACsE;AACtE,wBAAgB,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,EAAE,QAAQ,EAAE,cAAc,GAAG,OAAO,CAEtF"}

package/dist/scopes.js

@@ -83,3 +83,4 @@ export function isRepresentScope(s) {
 export function hasScope(granted, required) {
     return granted.includes(required);
 }
+//# sourceMappingURL=scopes.js.map

package/dist/scopes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scopes.js","sourceRoot":"","sources":["../src/scopes.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,0EAA0E;AAC1E,6EAA6E;AAC7E,kCAAkC;AAClC,EAAE;AACF,4EAA4E;AAC5E,8EAA8E;AAC9E,8EAA8E;AAC9E,0CAA0C;AAE1C,8EAA8E;AAC9E,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC/B,MAAM,EAAE,aAAa;IACrB,OAAO,EAAE,YAAY;IACrB,MAAM,EAAE,gCAAgC;IACxC,OAAO,EAAE,0CAA0C;IACnD,kBAAkB,EAAE,8CAA8C;IAClE,kBAAkB,EAAE,iDAAiD;IACrE,WAAW,EAAE,4FAA4F;IACzG,iBAAiB,EAAE,uCAAuC;IAC1D,kBAAkB,EAAE,6CAA6C;IACjE,kBAAkB,EAAE,2CAA2C;IAC/D,mBAAmB,EAAE,iDAAiD;IACtE,gBAAgB,EAAE,8CAA8C;IAChE,aAAa,EAAE,4KAA4K;IAC3L,cAAc,EAAE,yCAAyC;IACzD,gBAAgB,EAAE,sCAAsC;IACxD,yEAAyE;IACzE,WAAW,EAAE,0DAA0D;IACvE,kBAAkB,EAAE,wEAAwE;IAC5F,cAAc,EAAE,qEAAqE;IACrF,gBAAgB,EAAE,mFAAmF;IACrG,oBAAoB,CAAC,gFAAgF;CAC5F,CAAC;AAGX,2DAA2D;AAC3D,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAU,CAAC;AAGhF;;iDAEiD;AACjD,MAAM,CAAC,MAAM,gBAAgB,GAAgC,IAAI,GAAG,CAAiB;IACpF,kBAAkB;IAClB,mBAAmB;IACnB,gBAAgB;IAChB,cAAc;IACd,gBAAgB;IAChB,WAAW;IACX,kBAAkB;IAClB,cAAc;IACd,gBAAgB;IAChB,oBAAoB;CACpB,CAAC,CAAC;AAEH;;;6EAG6E;AAC7E,MAAM,CAAC,MAAM,gBAAgB,GAAgC,IAAI,GAAG,CAAiB;IACpF,WAAW;IACX,kBAAkB;IAClB,cAAc;IACd,gBAAgB;IAChB,oBAAoB;CACpB,CAAC,CAAC;AAEH;oEACoE;AACpE,MAAM,CAAC,MAAM,cAAc,GAA8B;IACxD,MAAM;IACN,OAAO;IACP,MAAM;IACN,OAAO;IACP,kBAAkB;IAClB,kBAAkB;IAClB,iBAAiB;IACjB,kBAAkB;CAClB,CAAC;AACF,MAAM,CAAC,MAAM,kBAAkB,GAAiC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAElF,MAAM,UAAU,gBAAgB,CAAC,CAAiB;IACjD,OAAO,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AAChC,CAAC;AACD,MAAM,UAAU,gBAAgB,CAAC,CAAiB;IACjD,OAAO,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AAChC,CAAC;AAED;sEACsE;AACtE,MAAM,UAAU,QAAQ,CAAC,OAA0B,EAAE,QAAwB;IAC5E,OAAO,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AACnC,CAAC"}

package/dist/sse.d.ts

@@ -10,3 +10,4 @@ export declare function parseSse(buffer: string): {
     events: SseEvent[];
     rest: string;
 };
+//# sourceMappingURL=sse.d.ts.map

package/dist/sse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.d.ts","sourceRoot":"","sources":["../src/sse.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,QAAQ;IACxB,kEAAkE;IAClE,KAAK,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;CACb;AAED;yEACyE;AACzE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAsB7E"}

package/dist/sse.js

@@ -36,3 +36,4 @@ export function parseSse(buffer) {
     }
     return { events, rest: working };
 }
+//# sourceMappingURL=sse.js.map

package/dist/sse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.js","sourceRoot":"","sources":["../src/sse.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,gFAAgF;AAChF,iFAAiF;AACjF,iCAAiC;AACjC,EAAE;AACF,8EAA8E;AAC9E,iFAAiF;AACjF,2EAA2E;AAS3E;yEACyE;AACzE,MAAM,UAAU,QAAQ,CAAC,MAAc;IACtC,MAAM,MAAM,GAAe,EAAE,CAAC;IAC9B,IAAI,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAC5C,IAAI,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAClC,OAAO,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC;QACnB,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QACpC,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;QACjC,IAAI,KAAK,GAAG,SAAS,CAAC;QACtB,MAAM,SAAS,GAAa,EAAE,CAAC;QAC/B,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YACtC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;gBAAE,SAAS,CAAC,gCAAgC;YAC7E,MAAM,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YAC7B,MAAM,KAAK,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACnD,IAAI,KAAK,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;YAChD,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC;gBAAE,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,gCAAgC;YACnF,IAAI,KAAK,KAAK,OAAO;gBAAE,KAAK,GAAG,KAAK,CAAC;iBAChC,IAAI,KAAK,KAAK,MAAM;gBAAE,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAClD,CAAC;QACD,IAAI,SAAS,CAAC,MAAM;YAAE,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACzE,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AAClC,CAAC"}

package/dist/svelte.d.ts

@@ -0,0 +1,16 @@
+import type { CompanionClient } from './client.js';
+import { type CompanionView, type CompanionViewOptions, type CompanionViewSnapshot } from './adapter-core.js';
+/** Svelte-store-contract readable of the companion view snapshot. */
+export interface CompanionStore {
+    /** Store contract: calls `run` with the current snapshot immediately and on
+     *  every change. Returns unsubscribe. */
+    subscribe(run: (snapshot: CompanionViewSnapshot) => void): () => void;
+    sendText: CompanionView['sendText'];
+    confirmAction: CompanionView['confirmAction'];
+    /** Detach from the client (does not close it). */
+    dispose(): void;
+    client: CompanionClient;
+}
+/** Wrap a host-owned client as a Svelte-compatible readable store. */
+export declare function companionStore(client: CompanionClient, opts?: CompanionViewOptions): CompanionStore;
+//# sourceMappingURL=svelte.d.ts.map

package/dist/svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"svelte.d.ts","sourceRoot":"","sources":["../src/svelte.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,EAEN,KAAK,aAAa,EAClB,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,MAAM,gBAAgB,CAAC;AAExB,qEAAqE;AACrE,MAAM,WAAW,cAAc;IAC9B;6CACyC;IACzC,SAAS,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,qBAAqB,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IACtE,QAAQ,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;IACpC,aAAa,EAAE,aAAa,CAAC,eAAe,CAAC,CAAC;IAC9C,kDAAkD;IAClD,OAAO,IAAI,IAAI,CAAC;IAChB,MAAM,EAAE,eAAe,CAAC;CACxB;AAED,sEAAsE;AACtE,wBAAgB,cAAc,CAC7B,MAAM,EAAE,eAAe,EACvB,IAAI,CAAC,EAAE,oBAAoB,GACzB,cAAc,CAYhB"}

package/dist/svelte.js

@@ -0,0 +1,25 @@
+// Svelte adapter (0.31.0) — `@pouchy_ai/companion-sdk/svelte`.
+// Implements the Svelte STORE CONTRACT (subscribe(run) → unsubscribe) by hand,
+// so it needs no `svelte` import and works from Svelte 3 through 5 (`$store`
+// auto-subscription, or `fromStore()` in runes mode). Behavior lives in
+// adapter-core.ts.
+//
+//   const companion = companionStore(client);
+//   $companion.transcript / $companion.draft / $companion.streamState
+//   companion.sendText('hi');
+import { createCompanionView } from './adapter-core.js';
+/** Wrap a host-owned client as a Svelte-compatible readable store. */
+export function companionStore(client, opts) {
+    const view = createCompanionView(client, opts);
+    return {
+        subscribe(run) {
+            run(view.getSnapshot());
+            return view.subscribe(() => run(view.getSnapshot()));
+        },
+        sendText: view.sendText,
+        confirmAction: view.confirmAction,
+        dispose: view.dispose,
+        client
+    };
+}
+//# sourceMappingURL=svelte.js.map

package/dist/svelte.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"svelte.js","sourceRoot":"","sources":["../src/svelte.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+EAA+E;AAC/E,6EAA6E;AAC7E,wEAAwE;AACxE,mBAAmB;AACnB,EAAE;AACF,8CAA8C;AAC9C,sEAAsE;AACtE,8BAA8B;AAG9B,OAAO,EACN,mBAAmB,EAInB,MAAM,gBAAgB,CAAC;AAcxB,sEAAsE;AACtE,MAAM,UAAU,cAAc,CAC7B,MAAuB,EACvB,IAA2B;IAE3B,MAAM,IAAI,GAAG,mBAAmB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC/C,OAAO;QACN,SAAS,CAAC,GAAG;YACZ,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;YACxB,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;QACtD,CAAC;QACD,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,aAAa,EAAE,IAAI,CAAC,aAAa;QACjC,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,MAAM;KACN,CAAC;AACH,CAAC"}

package/dist/vue.d.ts

@@ -0,0 +1,15 @@
+import { type ShallowRef } from 'vue';
+import type { CompanionClient } from './client.js';
+import { type CompanionView, type CompanionViewOptions, type CompanionViewSnapshot } from './adapter-core.js';
+export interface UseCompanionReturn {
+    /** Reactive, immutable view snapshot (replaced wholesale per change). */
+    snapshot: ShallowRef<CompanionViewSnapshot>;
+    sendText: CompanionView['sendText'];
+    confirmAction: CompanionView['confirmAction'];
+    /** Manual teardown for use outside an effect scope. */
+    dispose(): void;
+    client: CompanionClient;
+}
+/** Reactive companion view state for a host-owned client. */
+export declare function useCompanion(client: CompanionClient, opts?: CompanionViewOptions): UseCompanionReturn;
+//# sourceMappingURL=vue.d.ts.map

package/dist/vue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vue.d.ts","sourceRoot":"","sources":["../src/vue.ts"],"names":[],"mappings":"AAUA,OAAO,EAA+C,KAAK,UAAU,EAAE,MAAM,KAAK,CAAC;AACnF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,EAEN,KAAK,aAAa,EAClB,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,MAAM,gBAAgB,CAAC;AAExB,MAAM,WAAW,kBAAkB;IAClC,yEAAyE;IACzE,QAAQ,EAAE,UAAU,CAAC,qBAAqB,CAAC,CAAC;IAC5C,QAAQ,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;IACpC,aAAa,EAAE,aAAa,CAAC,eAAe,CAAC,CAAC;IAC9C,uDAAuD;IACvD,OAAO,IAAI,IAAI,CAAC;IAChB,MAAM,EAAE,eAAe,CAAC;CACxB;AAED,6DAA6D;AAC7D,wBAAgB,YAAY,CAC3B,MAAM,EAAE,eAAe,EACvB,IAAI,CAAC,EAAE,oBAAoB,GACzB,kBAAkB,CAYpB"}

package/dist/vue.js

@@ -0,0 +1,27 @@
+// Vue 3 adapter (0.31.0) — `@pouchy_ai/companion-sdk/vue`.
+// Thin binding of adapter-core onto a shallowRef; behavior lives (and is
+// tested) in adapter-core.ts.
+//
+//   const { snapshot, sendText } = useCompanion(client);
+//   snapshot.value.transcript / snapshot.value.streamState
+//
+// Inside a component/effect scope the subscription is torn down automatically
+// (onScopeDispose); outside any scope, call dispose() yourself.
+import { getCurrentScope, onScopeDispose, shallowRef } from 'vue';
+import { createCompanionView } from './adapter-core.js';
+/** Reactive companion view state for a host-owned client. */
+export function useCompanion(client, opts) {
+    const view = createCompanionView(client, opts);
+    const snapshot = shallowRef(view.getSnapshot());
+    const unsub = view.subscribe(() => {
+        snapshot.value = view.getSnapshot();
+    });
+    const dispose = () => {
+        unsub();
+        view.dispose();
+    };
+    if (getCurrentScope())
+        onScopeDispose(dispose);
+    return { snapshot, sendText: view.sendText, confirmAction: view.confirmAction, dispose, client };
+}
+//# sourceMappingURL=vue.js.map

package/dist/vue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vue.js","sourceRoot":"","sources":["../src/vue.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAC3D,yEAAyE;AACzE,8BAA8B;AAC9B,EAAE;AACF,yDAAyD;AACzD,2DAA2D;AAC3D,EAAE;AACF,8EAA8E;AAC9E,gEAAgE;AAEhE,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,UAAU,EAAmB,MAAM,KAAK,CAAC;AAEnF,OAAO,EACN,mBAAmB,EAInB,MAAM,gBAAgB,CAAC;AAYxB,6DAA6D;AAC7D,MAAM,UAAU,YAAY,CAC3B,MAAuB,EACvB,IAA2B;IAE3B,MAAM,IAAI,GAAG,mBAAmB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC/C,MAAM,QAAQ,GAAG,UAAU,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;IAChD,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE;QACjC,QAAQ,CAAC,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IACrC,CAAC,CAAC,CAAC;IACH,MAAM,OAAO,GAAG,GAAG,EAAE;QACpB,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,OAAO,EAAE,CAAC;IAChB,CAAC,CAAC;IACF,IAAI,eAAe,EAAE;QAAE,cAAc,CAAC,OAAO,CAAC,CAAC;IAC/C,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,aAAa,EAAE,IAAI,CAAC,aAAa,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;AAClG,CAAC"}

package/dist/ws-transport.d.ts

@@ -19,3 +19,4 @@ export declare function decodeWsMessage(raw: string): {
 export declare function encodeWsInput(text: string, opts?: {
     image?: string;
 }): string;
+//# sourceMappingURL=ws-transport.d.ts.map

package/dist/ws-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws-transport.d.ts","sourceRoot":"","sources":["../src/ws-transport.ts"],"names":[],"mappings":"AAeA;;;;+BAI+B;AAC/B,wBAAgB,iBAAiB,CAChC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,MAAM,SAAI,GACR,MAAM,CAKR;AAED;;;;;mEAKmE;AACnE,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAuBnF;AAED;qEACqE;AACrE,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAI7E"}

package/dist/ws-transport.js

@@ -60,3 +60,4 @@ export function encodeWsInput(text, opts) {
         payload.image = opts.image;
     return JSON.stringify(payload);
 }
+//# sourceMappingURL=ws-transport.js.map

package/dist/ws-transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws-transport.js","sourceRoot":"","sources":["../src/ws-transport.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAC3D,EAAE;AACF,4EAA4E;AAC5E,6EAA6E;AAC7E,+EAA+E;AAC/E,8EAA8E;AAC9E,yEAAyE;AACzE,EAAE;AACF,sEAAsE;AACtE,0EAA0E;AAC1E,4EAA4E;AAC5E,8EAA8E;AAC9E,2EAA2E;AAC3E,8EAA8E;AAE9E;;;;+BAI+B;AAC/B,MAAM,UAAU,iBAAiB,CAChC,OAAe,EACf,SAAiB,EACjB,KAAa,EACb,MAAM,GAAG,CAAC;IAEV,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,iBAAiB,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC9F,MAAM,EAAE,GAAG,kBAAkB,CAAC,SAAS,CAAC,CAAC;IACzC,MAAM,CAAC,GAAG,IAAI,eAAe,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IACjE,OAAO,GAAG,MAAM,0BAA0B,EAAE,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC;AACnE,CAAC;AAED;;;;;mEAKmE;AACnE,MAAM,UAAU,eAAe,CAAC,GAAW;IAC1C,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACJ,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,IAAI,CAAC;IACb,CAAC;IACD,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACvD,MAAM,GAAG,GAAG,MAAiC,CAAC;IAE9C,2BAA2B;IAC3B,IAAI,OAAO,GAAG,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;QACnC,MAAM,IAAI,GAAG,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;QACtF,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC;IACnC,CAAC;IAED,6EAA6E;IAC7E,yDAAyD;IACzD,IAAI,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAClC,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC;IACxC,CAAC;IAED,OAAO,IAAI,CAAC;AACb,CAAC;AAED;qEACqE;AACrE,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,IAAyB;IACpE,MAAM,OAAO,GAA4B,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IACjE,IAAI,IAAI,EAAE,KAAK;QAAE,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;IAC5C,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;AAChC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pouchy_ai/companion-sdk",
-  "version": "0.29.1",
+  "version": "0.32.0",
   "description": "Embed the Pouchy companion — chat, voice, tools, memory, live world-state, instant UI, and agent-to-agent messaging — in any app, game, or site.",
   "type": "module",
   "license": "SEE LICENSE IN LICENSE",
@@ -18,12 +18,23 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
       "default": "./dist/index.js"
+    },
+    "./svelte": {
+      "types": "./dist/svelte.d.ts",
+      "import": "./dist/svelte.js",
+      "default": "./dist/svelte.js"
+    },
+    "./vue": {
+      "types": "./dist/vue.d.ts",
+      "import": "./dist/vue.js",
+      "default": "./dist/vue.js"
     }
   },
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "files": [
     "dist",
+    "src",
     "README.md",
     "CHANGELOG.md",
     "LICENSE"
@@ -33,28 +44,35 @@
     "node": ">=18"
   },
   "scripts": {
-    "build": "tsc -p tsconfig.json && node scripts/fix-esm-extensions.mjs",
-    "build:cdn": "esbuild ../../src/lib/companion-sdk/index.ts --bundle --format=esm --platform=browser --external:@elevenlabs/client --legal-comments=none --outfile=cdn/companion-sdk.js && node scripts/cdn-banner.mjs",
+    "build": "tsc -p tsconfig.json && node scripts/fix-esm-extensions.mjs && node scripts/package-src-maps.mjs",
+    "build:cdn": "esbuild ../../src/lib/companion-sdk/index.ts --bundle --format=esm --platform=browser --external:@elevenlabs/client --legal-comments=none --outfile=cdn/companion-sdk.js && esbuild ../../src/lib/companion-sdk/index.ts --bundle --minify --format=esm --platform=browser --external:@elevenlabs/client --legal-comments=none --outfile=cdn/companion-sdk.min.js && node scripts/cdn-banner.mjs",
     "prepublishOnly": "npm run build"
   },
   "peerDependencies": {
-    "@elevenlabs/client": "^1.9.0"
+    "@elevenlabs/client": "^1.9.0",
+    "vue": "^3.0.0"
   },
   "peerDependenciesMeta": {
     "@elevenlabs/client": {
       "optional": true
+    },
+    "vue": {
+      "optional": true
     }
   },
   "devDependencies": {
     "esbuild": "^0.24.0",
-    "typescript": "^5.5.0"
+    "typescript": "^5.5.0",
+    "vue": "^3.5.0"
   },
   "keywords": [
     "pouchy",
     "ai-companion",
     "voice",
     "agent",
-    "sdk"
+    "sdk",
+    "svelte",
+    "vue"
   ],
   "publishConfig": {
     "access": "public"

package/src/adapter-core.ts

@@ -0,0 +1,193 @@
+// Framework-agnostic view controller behind the /svelte and /vue adapters
+// (0.31.0). One place owns the subscription wiring + snapshot bookkeeping the
+// adapters share, so each adapter stays a logic-free ~40-line binding to its
+// framework's reactivity primitive — and THIS file is where the behavior gets
+// unit-tested once instead of per-framework. (React hosts use the richer
+// standalone `@pouchy_ai/react` package — Provider-owned lifecycle, voice-call
+// hook — which predates this controller and keeps its own state wiring.)
+//
+// Contract (deliberately useSyncExternalStore-shaped, the strictest of the
+// three): `getSnapshot()` returns the SAME object reference until something
+// changes, and every change produces a new frozen snapshot + one listener
+// sweep. Svelte's store contract and Vue's shallowRef both accept that shape
+// as-is.
+
+import type { CompanionClient } from './client';
+import type { CompanionStreamState } from './client';
+import type { ConfirmRequestPayload, TypingPayload } from './protocol';
+
+/** One rendered line of the conversation, in arrival order. */
+export interface CompanionTranscriptEntry {
+	role: 'user' | 'companion';
+	text: string;
+	/** Client wall-clock ms when the entry was appended. */
+	at: number;
+}
+
+/** Immutable view snapshot. A new object per change — safe to hand to
+ *  useSyncExternalStore / $state / shallowRef without defensive copies. */
+export interface CompanionViewSnapshot {
+	streamState: CompanionStreamState;
+	/** Rolling transcript, oldest first, capped at `transcriptCap`. */
+	transcript: readonly CompanionTranscriptEntry[];
+	/** The in-flight streamed reply (token deltas), '' when none. */
+	draft: string;
+	typing: boolean;
+	/** Confirm requests that arrived on the stream and haven't been resolved
+	 *  through this view yet. Rebuild after a reload via client.pendingConfirms()
+	 *  — confirm_request events are not replayed. */
+	pendingConfirms: readonly ConfirmRequestPayload[];
+}
+
+export interface CompanionViewOptions {
+	/** Max transcript entries kept (oldest dropped). Default 200. */
+	transcriptCap?: number;
+	/** Restore up to this many recent turns from `client.history()` on
+	 *  creation, so a reloaded tab isn't blank (same semantic as
+	 *  `@pouchy_ai/react`'s useMessages). Requires a connected client (a
+	 *  session must exist). Restored turns land ONLY while the live transcript
+	 *  is still empty — they never clobber messages that arrived first.
+	 *  Default 0 (off). */
+	restore?: number;
+}
+
+export interface CompanionView {
+	/** Stable-reference snapshot (useSyncExternalStore contract). */
+	getSnapshot(): CompanionViewSnapshot;
+	/** Subscribe to snapshot changes. Returns unsubscribe. */
+	subscribe(listener: () => void): () => void;
+	/** sendText that also appends the user turn to the transcript. */
+	sendText(
+		text: string,
+		opts?: Parameters<CompanionClient['sendText']>[1]
+	): ReturnType<CompanionClient['sendText']>;
+	/** confirmAction that also removes the confirm from `pendingConfirms`
+	 *  (on approve AND deny — both resolve the card server-side). */
+	confirmAction(
+		confirmId: string,
+		approve: boolean,
+		opts?: { signal?: AbortSignal }
+	): ReturnType<CompanionClient['confirmAction']>;
+	/** Detach every client subscription. The view goes inert (snapshot frozen,
+	 *  listeners dropped); the client itself is NOT closed — it belongs to the
+	 *  host. Idempotent. */
+	dispose(): void;
+	/** The underlying client, for everything the view doesn't wrap. */
+	readonly client: CompanionClient;
+}
+
+const DEFAULT_TRANSCRIPT_CAP = 200;
+
+/** Wire a client into an immutable-snapshot view. Adapters bind this to their
+ *  framework; hosts using none of the adapters can consume it directly. */
+export function createCompanionView(
+	client: CompanionClient,
+	opts?: CompanionViewOptions
+): CompanionView {
+	const cap = Math.max(1, opts?.transcriptCap ?? DEFAULT_TRANSCRIPT_CAP);
+	const listeners = new Set<() => void>();
+	let disposed = false;
+
+	let snapshot: CompanionViewSnapshot = Object.freeze({
+		streamState: client.streamState,
+		transcript: Object.freeze([]) as readonly CompanionTranscriptEntry[],
+		draft: '',
+		typing: false,
+		pendingConfirms: Object.freeze([]) as readonly ConfirmRequestPayload[]
+	});
+
+	function commit(patch: Partial<CompanionViewSnapshot>): void {
+		if (disposed) return;
+		snapshot = Object.freeze({ ...snapshot, ...patch });
+		// Snapshot-first, then notify: a listener that re-reads getSnapshot()
+		// synchronously must see the new value. Handler isolation matches the
+		// client's emit() doctrine — one throwing listener must not starve the rest.
+		for (const l of [...listeners]) {
+			try {
+				l();
+			} catch {
+				/* listener errors are the listener's problem */
+			}
+		}
+	}
+
+	function appendTranscript(entry: CompanionTranscriptEntry): void {
+		const next = [...snapshot.transcript, entry];
+		commit({ transcript: Object.freeze(next.slice(-cap)) });
+	}
+
+	const restore = opts?.restore ?? 0;
+	if (restore > 0) {
+		void client
+			.history({ limit: restore })
+			.then((turns) => {
+				// Only fill a still-empty transcript — live traffic wins.
+				if (disposed || snapshot.transcript.length) return;
+				const restored: CompanionTranscriptEntry[] = [];
+				for (const t of turns) {
+					if (t.user) restored.push({ role: 'user', text: t.user, at: t.ts });
+					if (t.assistant) restored.push({ role: 'companion', text: t.assistant, at: t.ts });
+				}
+				if (restored.length) commit({ transcript: Object.freeze(restored.slice(-cap)) });
+			})
+			.catch(() => {
+				/* a brand-new session has no history — fine */
+			});
+	}
+
+	const unsubs: Array<() => void> = [
+		client.onStreamStateChange((next: CompanionStreamState) => commit({ streamState: next })),
+		client.onMessage((text: string) => {
+			// The authoritative full reply replaces any streamed draft; typing is
+			// definitionally over once the reply lands.
+			const next = [...snapshot.transcript, { role: 'companion' as const, text, at: Date.now() }];
+			commit({
+				transcript: Object.freeze(next.slice(-cap)),
+				draft: '',
+				typing: false
+			});
+		}),
+		client.onDelta((chunk: string, meta: { reset?: boolean }) => {
+			commit({ draft: meta.reset ? chunk : snapshot.draft + chunk });
+		}),
+		client.onTyping((payload: TypingPayload) => commit({ typing: !!payload.active })),
+		client.onConfirmRequest((payload: ConfirmRequestPayload) => {
+			// The stream can redeliver on reconnect replay — dedupe by confirmId.
+			if (snapshot.pendingConfirms.some((c) => c.confirmId === payload.confirmId)) return;
+			commit({ pendingConfirms: Object.freeze([...snapshot.pendingConfirms, payload]) });
+		})
+	];
+
+	return {
+		client,
+		getSnapshot: () => snapshot,
+		subscribe(listener: () => void) {
+			listeners.add(listener);
+			return () => listeners.delete(listener);
+		},
+		async sendText(text, sendOpts) {
+			appendTranscript({ role: 'user', text, at: Date.now() });
+			return client.sendText(text, sendOpts as never);
+		},
+		async confirmAction(confirmId, approve, confirmOpts) {
+			const res = await client.confirmAction(confirmId, approve, confirmOpts);
+			// Remove on any settled resolution; exec_failed with retryable keeps the
+			// card — the host may re-approve the SAME confirmId (documented server
+			// semantic), so dropping it would strand the retry affordance.
+			if (!(res.status === 'exec_failed' && res.retryable)) {
+				commit({
+					pendingConfirms: Object.freeze(
+						snapshot.pendingConfirms.filter((c) => c.confirmId !== confirmId)
+					)
+				});
+			}
+			return res;
+		},
+		dispose() {
+			if (disposed) return;
+			for (const u of unsubs) u();
+			listeners.clear();
+			disposed = true;
+		}
+	};
+}