@memberjunction/realtime-runtime 6.2.0-edge.3 → 6.2.0-edge.5

package/dist/channels/channel-descriptor-synthesis.d.ts

@@ -0,0 +1,56 @@
+/**
+ * @fileoverview **Legacy descriptor synthesis** — how a channel written against the original (v1)
+ * members gets a v2 descriptor without being edited.
+ *
+ * Back-compat is absolute: a plugin that implements only `GetToolDefinitions()`, `ApplyAgentTool()`
+ * and tab chrome keeps working unchanged, and — because the runtime reads descriptors, never the
+ * v1 members, when it scopes channels and advertises them — it must be *describable*. Synthesis
+ * derives a descriptor from what the plugin already declares:
+ *
+ * - **verbs** from its tool definitions (the tool name minus the shared prefix; the full tool name
+ *   is kept as `NativeToolName`, so the proxy and the native path reach the same executor);
+ * - **instructions** from the registry row's `Description` when the runtime has one, else the
+ *   channel's first-run intro, else a plain statement of the tool prefix;
+ * - **availability / display / exposure** from conservative defaults that preserve today's
+ *   behavior: `'all-sessions'` (every pre-existing channel was), `'open-on-start'` when it has a
+ *   surface and `'headless'` when it does not, and `'pixels'` only when it sources video.
+ *
+ * The result is stamped with {@link REALTIME_CHANNEL_LEGACY_CONTRACT_VERSION} so a synthesized
+ * descriptor is always distinguishable from an authored one.
+ *
+ * @module @memberjunction/realtime-runtime
+ */
+import type { RealtimeToolDefinition } from '@memberjunction/ai';
+import { type RealtimeChannelDescriptor, type RealtimeChannelInvoker, type RealtimeChannelVerb } from '@memberjunction/ai-core-plus';
+import type { BaseRealtimeChannelClient } from './base-realtime-channel-client.js';
+/**
+ * The verb name for a native tool: the tool name with the channel's shared prefix removed
+ * (`'Whiteboard_AddNote'` → `'AddNote'`). A tool that does not carry the prefix — or that *is* the
+ * prefix, like `ContextTool` — keeps its full name.
+ */
+export declare function VerbNameForTool(toolName: string, toolNamePrefix: string): string;
+/**
+ * Builds the verb list for a channel whose actions are its native tools. Both the synthesizer and
+ * the reference channels' explicit descriptors use it, so a subclass that adds a tool (an app
+ * extending a MJ channel) gets a verb for it automatically instead of a descriptor that lies.
+ *
+ * @param tools The channel's current tool declarations (`GetToolDefinitions()`).
+ * @param toolNamePrefix The channel's shared tool-name prefix.
+ * @param invokableBy Who may invoke these verbs (default `'agent'` — native tools are agent tools).
+ * @param returnsChannelData Native tool name to the exposure its RESULT requires, for the tools whose result carries what
+ *   the channel holds (see `RealtimeChannelVerb.ReturnsChannelData`); tools not listed only act.
+ */
+export declare function BuildToolBackedVerbs(tools: ReadonlyArray<RealtimeToolDefinition>, toolNamePrefix: string, invokableBy?: RealtimeChannelInvoker, returnsChannelData?: Readonly<Record<string, 'state' | 'pixels'>>): RealtimeChannelVerb[];
+/** Extra context the runtime can supply that the channel instance cannot know. */
+export interface DescriptorSynthesisContext {
+    /** The registry row's `Description`, when the channel was resolved from a row. */
+    RegistryDescription?: string | null;
+}
+/**
+ * Synthesizes a v2 descriptor for a channel that implements only the v1 members.
+ *
+ * @param channel The channel (need not be initialized).
+ * @param context Optional runtime-supplied context (the registry row's description).
+ */
+export declare function SynthesizeChannelDescriptor(channel: BaseRealtimeChannelClient, context?: DescriptorSynthesisContext): RealtimeChannelDescriptor;
+//# sourceMappingURL=channel-descriptor-synthesis.d.ts.map

package/dist/channels/channel-descriptor-synthesis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel-descriptor-synthesis.d.ts","sourceRoot":"","sources":["../../src/channels/channel-descriptor-synthesis.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAEH,KAAK,yBAAyB,EAC9B,KAAK,sBAAsB,EAC3B,KAAK,mBAAmB,EAC3B,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAEhF;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM,CAIhF;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAChC,KAAK,EAAE,aAAa,CAAC,sBAAsB,CAAC,EAC5C,cAAc,EAAE,MAAM,EACtB,WAAW,GAAE,sBAAgC,EAC7C,kBAAkB,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,QAAQ,CAAC,CAAM,GACtE,mBAAmB,EAAE,CASvB;AAED,kFAAkF;AAClF,MAAM,WAAW,0BAA0B;IACvC,kFAAkF;IAClF,mBAAmB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACvC;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CACvC,OAAO,EAAE,yBAAyB,EAClC,OAAO,GAAE,0BAA+B,GACzC,yBAAyB,CAa3B"}

package/dist/channels/channel-descriptor-synthesis.js

@@ -0,0 +1,90 @@
+/**
+ * @fileoverview **Legacy descriptor synthesis** — how a channel written against the original (v1)
+ * members gets a v2 descriptor without being edited.
+ *
+ * Back-compat is absolute: a plugin that implements only `GetToolDefinitions()`, `ApplyAgentTool()`
+ * and tab chrome keeps working unchanged, and — because the runtime reads descriptors, never the
+ * v1 members, when it scopes channels and advertises them — it must be *describable*. Synthesis
+ * derives a descriptor from what the plugin already declares:
+ *
+ * - **verbs** from its tool definitions (the tool name minus the shared prefix; the full tool name
+ *   is kept as `NativeToolName`, so the proxy and the native path reach the same executor);
+ * - **instructions** from the registry row's `Description` when the runtime has one, else the
+ *   channel's first-run intro, else a plain statement of the tool prefix;
+ * - **availability / display / exposure** from conservative defaults that preserve today's
+ *   behavior: `'all-sessions'` (every pre-existing channel was), `'open-on-start'` when it has a
+ *   surface and `'headless'` when it does not, and `'pixels'` only when it sources video.
+ *
+ * The result is stamped with {@link REALTIME_CHANNEL_LEGACY_CONTRACT_VERSION} so a synthesized
+ * descriptor is always distinguishable from an authored one.
+ *
+ * @module @memberjunction/realtime-runtime
+ */
+import { REALTIME_CHANNEL_LEGACY_CONTRACT_VERSION, } from '@memberjunction/ai-core-plus';
+/**
+ * The verb name for a native tool: the tool name with the channel's shared prefix removed
+ * (`'Whiteboard_AddNote'` → `'AddNote'`). A tool that does not carry the prefix — or that *is* the
+ * prefix, like `ContextTool` — keeps its full name.
+ */
+export function VerbNameForTool(toolName, toolNamePrefix) {
+    return toolNamePrefix.length > 0 && toolName.length > toolNamePrefix.length && toolName.startsWith(toolNamePrefix)
+        ? toolName.slice(toolNamePrefix.length)
+        : toolName;
+}
+/**
+ * Builds the verb list for a channel whose actions are its native tools. Both the synthesizer and
+ * the reference channels' explicit descriptors use it, so a subclass that adds a tool (an app
+ * extending a MJ channel) gets a verb for it automatically instead of a descriptor that lies.
+ *
+ * @param tools The channel's current tool declarations (`GetToolDefinitions()`).
+ * @param toolNamePrefix The channel's shared tool-name prefix.
+ * @param invokableBy Who may invoke these verbs (default `'agent'` — native tools are agent tools).
+ * @param returnsChannelData Native tool name to the exposure its RESULT requires, for the tools whose result carries what
+ *   the channel holds (see `RealtimeChannelVerb.ReturnsChannelData`); tools not listed only act.
+ */
+export function BuildToolBackedVerbs(tools, toolNamePrefix, invokableBy = 'agent', returnsChannelData = {}) {
+    return tools.map((tool) => ({
+        Name: VerbNameForTool(tool.Name, toolNamePrefix),
+        Description: tool.Description,
+        ParametersSchema: tool.ParametersSchema,
+        InvokableBy: invokableBy,
+        NativeToolName: tool.Name,
+        ...(returnsChannelData[tool.Name] ? { ReturnsChannelData: returnsChannelData[tool.Name] } : {}),
+    }));
+}
+/**
+ * Synthesizes a v2 descriptor for a channel that implements only the v1 members.
+ *
+ * @param channel The channel (need not be initialized).
+ * @param context Optional runtime-supplied context (the registry row's description).
+ */
+export function SynthesizeChannelDescriptor(channel, context = {}) {
+    const sourcesVideo = channel.GetSourcedTracks().some((t) => t.Modality === 'video' && t.Direction === 'inbound');
+    return {
+        Key: channel.ChannelName,
+        Version: REALTIME_CHANNEL_LEGACY_CONTRACT_VERSION,
+        DisplayName: channel.TabTitle,
+        Instructions: legacyInstructions(channel, context),
+        Nouns: [],
+        Verbs: BuildToolBackedVerbs(channel.GetToolDefinitions(), channel.ToolNamePrefix),
+        DisplayPolicy: channel.HasSurface() ? 'open-on-start' : 'headless',
+        DefaultAvailability: 'all-sessions',
+        MaxExposure: sourcesVideo ? 'pixels' : 'state',
+    };
+}
+/** The best available natural-language account of a legacy channel. */
+function legacyInstructions(channel, context) {
+    const fromRegistry = context.RegistryDescription?.trim();
+    if (fromRegistry) {
+        return fromRegistry;
+    }
+    const fromIntro = channel.GetOnboardingDetails()?.Description?.trim();
+    if (fromIntro) {
+        return fromIntro;
+    }
+    const prefix = channel.ToolNamePrefix;
+    return prefix.length > 0
+        ? `The ${channel.TabTitle} channel. Use its tools (names beginning "${prefix}") to act on it.`
+        : `The ${channel.TabTitle} channel.`;
+}
+//# sourceMappingURL=channel-descriptor-synthesis.js.map

package/dist/channels/channel-descriptor-synthesis.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel-descriptor-synthesis.js","sourceRoot":"","sources":["../../src/channels/channel-descriptor-synthesis.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH,OAAO,EACH,wCAAwC,GAI3C,MAAM,8BAA8B,CAAC;AAGtC;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,QAAgB,EAAE,cAAsB;IACpE,OAAO,cAAc,CAAC,MAAM,GAAG,CAAC,IAAI,QAAQ,CAAC,MAAM,GAAG,cAAc,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,CAAC,cAAc,CAAC;QAC9G,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC;QACvC,CAAC,CAAC,QAAQ,CAAC;AACnB,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,oBAAoB,CAChC,KAA4C,EAC5C,cAAsB,EACtB,cAAsC,OAAO,EAC7C,qBAAmE,EAAE;IAErE,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACxB,IAAI,EAAE,eAAe,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC;QAChD,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;QACvC,WAAW,EAAE,WAAW;QACxB,cAAc,EAAE,IAAI,CAAC,IAAI;QACzB,GAAG,CAAC,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,kBAAkB,EAAE,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAClG,CAAC,CAAC,CAAC;AACR,CAAC;AAQD;;;;;GAKG;AACH,MAAM,UAAU,2BAA2B,CACvC,OAAkC,EAClC,UAAsC,EAAE;IAExC,MAAM,YAAY,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,IAAI,CAAC,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC;IACjH,OAAO;QACH,GAAG,EAAE,OAAO,CAAC,WAAW;QACxB,OAAO,EAAE,wCAAwC;QACjD,WAAW,EAAE,OAAO,CAAC,QAAQ;QAC7B,YAAY,EAAE,kBAAkB,CAAC,OAAO,EAAE,OAAO,CAAC;QAClD,KAAK,EAAE,EAAE;QACT,KAAK,EAAE,oBAAoB,CAAC,OAAO,CAAC,kBAAkB,EAAE,EAAE,OAAO,CAAC,cAAc,CAAC;QACjF,aAAa,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,UAAU;QAClE,mBAAmB,EAAE,cAAc;QACnC,WAAW,EAAE,YAAY,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO;KACjD,CAAC;AACN,CAAC;AAED,uEAAuE;AACvE,SAAS,kBAAkB,CAAC,OAAkC,EAAE,OAAmC;IAC/F,MAAM,YAAY,GAAG,OAAO,CAAC,mBAAmB,EAAE,IAAI,EAAE,CAAC;IACzD,IAAI,YAAY,EAAE,CAAC;QACf,OAAO,YAAY,CAAC;IACxB,CAAC;IACD,MAAM,SAAS,GAAG,OAAO,CAAC,oBAAoB,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;IACtE,IAAI,SAAS,EAAE,CAAC;QACZ,OAAO,SAAS,CAAC;IACrB,CAAC;IACD,MAAM,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IACtC,OAAO,MAAM,CAAC,MAAM,GAAG,CAAC;QACpB,CAAC,CAAC,OAAO,OAAO,CAAC,QAAQ,6CAA6C,MAAM,kBAAkB;QAC9F,CAAC,CAAC,OAAO,OAAO,CAAC,QAAQ,WAAW,CAAC;AAC7C,CAAC"}

package/dist/channels/channel-perception.d.ts

@@ -0,0 +1,82 @@
+/**
+ * @fileoverview The **perception coalescer** — turns a burst of channel state changes into ONE
+ * structured note carrying a delta.
+ *
+ * A user dragging a shape on a whiteboard, or typing in a form, changes state dozens of times a
+ * second. The model needs to know *where things ended up*, not to be narrated every intermediate
+ * step: each note is context it must read, tokens it is billed for, and — worst — a prompt to
+ * respond. So changes are debounced: the first change arms a timer, further changes inside the
+ * window only extend the count, and when the window closes exactly one note goes out describing
+ * the difference between what the model was last told and the state now.
+ *
+ * Deliberately a small standalone class with injected clock/timers/state access, so the debounce
+ * and delta behavior are unit-testable with fake timers and no channel, session or DOM.
+ *
+ * @module @memberjunction/realtime-runtime
+ */
+import type { JSONObject } from '@memberjunction/ai';
+/** How the coalescer reaches the channel it speaks for. */
+export interface ChannelPerceptionHost {
+    /** The channel's key, for the note prefix. */
+    readonly ChannelKey: string;
+    /** The instance id, for the note prefix. */
+    readonly InstanceId: string;
+    /** Reads the channel's current state snapshot (the nouns). */
+    GetState(): JSONObject;
+    /** Delivers a finished note to the model. */
+    SendNote(text: string): void;
+    /** Reports a problem reading state (logged by the caller); the coalescer never throws into a timer. */
+    OnError(error: unknown): void;
+}
+/** Tuning for a {@link ChannelPerceptionCoalescer}. */
+export interface ChannelPerceptionOptions {
+    /** How long a burst may keep extending before its note is sent (default 750ms — matches the whiteboard's surface coalescing). */
+    DebounceMs: number;
+    /** The largest note body (JSON chars) sent in full; larger ones degrade to a list of changed paths (default 4000). */
+    MaxNoteChars: number;
+}
+/** The defaults. */
+export declare const DEFAULT_CHANNEL_PERCEPTION_OPTIONS: ChannelPerceptionOptions;
+/**
+ * Coalesces state changes into debounced delta notes. One instance per channel instance.
+ */
+export declare class ChannelPerceptionCoalescer {
+    private readonly host;
+    private readonly options;
+    private timer;
+    /** What the model was last told, or `null` before the first note (the first note is a snapshot). */
+    private baseline;
+    private pendingChanges;
+    private pendingChangeId;
+    constructor(host: ChannelPerceptionHost, options?: ChannelPerceptionOptions);
+    /**
+     * Records that the state changed. Arms the debounce timer if it is not already running; the
+     * timer is NOT re-armed by further changes, so a continuous stream of edits still produces a
+     * note every {@link ChannelPerceptionOptions.DebounceMs} rather than starving until it stops.
+     *
+     * @param changeId The id the change was assigned; the note carries the latest one.
+     */
+    Record(changeId: number): void;
+    /**
+     * Sets what the model is known to have been told, without sending anything — used right after a
+     * snapshot note went out by another route (e.g. when a channel opens), so the next change is
+     * described as a delta against it.
+     */
+    SetBaseline(state: JSONObject): void;
+    /**
+     * Forgets what the model was told, so the NEXT note is a full snapshot. Used when the model starts
+     * seeing the channel again after exposure was withdrawn: whatever it was last told is stale.
+     */
+    ResetBaseline(): void;
+    /** Drops any pending note without sending it (exposure was withdrawn: the model is no longer to be told). */
+    CancelPending(): void;
+    /** Sends the pending note now, if anything is pending. Safe to call at any time. */
+    Flush(): void;
+    /** Cancels any pending note. Call at teardown. */
+    Dispose(): void;
+    /** Builds and sends the note for the current burst: a snapshot the first time, a delta after. */
+    private sendNote;
+    /** Sends `full` unless it is too large, in which case the compact fallback goes instead. */
+    private deliver;
+}
+//# sourceMappingURL=channel-perception.d.ts.map

package/dist/channels/channel-perception.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel-perception.d.ts","sourceRoot":"","sources":["../../src/channels/channel-perception.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAGrD,2DAA2D;AAC3D,MAAM,WAAW,qBAAqB;IAClC,8CAA8C;IAC9C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,4CAA4C;IAC5C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,8DAA8D;IAC9D,QAAQ,IAAI,UAAU,CAAC;IACvB,6CAA6C;IAC7C,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,uGAAuG;IACvG,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;CACjC;AAED,uDAAuD;AACvD,MAAM,WAAW,wBAAwB;IACrC,iIAAiI;IACjI,UAAU,EAAE,MAAM,CAAC;IACnB,sHAAsH;IACtH,YAAY,EAAE,MAAM,CAAC;CACxB;AAED,oBAAoB;AACpB,eAAO,MAAM,kCAAkC,EAAE,wBAGhD,CAAC;AAEF;;GAEG;AACH,qBAAa,0BAA0B;IAQ/B,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAR5B,OAAO,CAAC,KAAK,CAA8C;IAC3D,oGAAoG;IACpG,OAAO,CAAC,QAAQ,CAA2B;IAC3C,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,eAAe,CAAK;gBAGP,IAAI,EAAE,qBAAqB,EAC3B,OAAO,GAAE,wBAA6D;IAG3F;;;;;;OAMG;IACI,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAQrC;;;;OAIG;IACI,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAI3C;;;OAGG;IACI,aAAa,IAAI,IAAI;IAI5B,6GAA6G;IACtG,aAAa,IAAI,IAAI;IAQ5B,oFAAoF;IAC7E,KAAK,IAAI,IAAI;IAkBpB,kDAAkD;IAC3C,OAAO,IAAI,IAAI;IAQtB,iGAAiG;IACjG,OAAO,CAAC,QAAQ;IAiBhB,4FAA4F;IAC5F,OAAO,CAAC,OAAO;CAIlB"}

package/dist/channels/channel-perception.js

@@ -0,0 +1,120 @@
+/**
+ * @fileoverview The **perception coalescer** — turns a burst of channel state changes into ONE
+ * structured note carrying a delta.
+ *
+ * A user dragging a shape on a whiteboard, or typing in a form, changes state dozens of times a
+ * second. The model needs to know *where things ended up*, not to be narrated every intermediate
+ * step: each note is context it must read, tokens it is billed for, and — worst — a prompt to
+ * respond. So changes are debounced: the first change arms a timer, further changes inside the
+ * window only extend the count, and when the window closes exactly one note goes out describing
+ * the difference between what the model was last told and the state now.
+ *
+ * Deliberately a small standalone class with injected clock/timers/state access, so the debounce
+ * and delta behavior are unit-testable with fake timers and no channel, session or DOM.
+ *
+ * @module @memberjunction/realtime-runtime
+ */
+import { ComputeStateDelta, FormatChannelNote, ListChangedPaths } from './channel-state-delta.js';
+/** The defaults. */
+export const DEFAULT_CHANNEL_PERCEPTION_OPTIONS = {
+    DebounceMs: 750,
+    MaxNoteChars: 4000,
+};
+/**
+ * Coalesces state changes into debounced delta notes. One instance per channel instance.
+ */
+export class ChannelPerceptionCoalescer {
+    constructor(host, options = DEFAULT_CHANNEL_PERCEPTION_OPTIONS) {
+        this.host = host;
+        this.options = options;
+        this.timer = null;
+        /** What the model was last told, or `null` before the first note (the first note is a snapshot). */
+        this.baseline = null;
+        this.pendingChanges = 0;
+        this.pendingChangeId = 0;
+    }
+    /**
+     * Records that the state changed. Arms the debounce timer if it is not already running; the
+     * timer is NOT re-armed by further changes, so a continuous stream of edits still produces a
+     * note every {@link ChannelPerceptionOptions.DebounceMs} rather than starving until it stops.
+     *
+     * @param changeId The id the change was assigned; the note carries the latest one.
+     */
+    Record(changeId) {
+        this.pendingChanges++;
+        this.pendingChangeId = Math.max(this.pendingChangeId, changeId);
+        if (this.timer === null) {
+            this.timer = setTimeout(() => this.Flush(), this.options.DebounceMs);
+        }
+    }
+    /**
+     * Sets what the model is known to have been told, without sending anything — used right after a
+     * snapshot note went out by another route (e.g. when a channel opens), so the next change is
+     * described as a delta against it.
+     */
+    SetBaseline(state) {
+        this.baseline = state;
+    }
+    /**
+     * Forgets what the model was told, so the NEXT note is a full snapshot. Used when the model starts
+     * seeing the channel again after exposure was withdrawn: whatever it was last told is stale.
+     */
+    ResetBaseline() {
+        this.baseline = null;
+    }
+    /** Drops any pending note without sending it (exposure was withdrawn: the model is no longer to be told). */
+    CancelPending() {
+        if (this.timer !== null) {
+            clearTimeout(this.timer);
+            this.timer = null;
+        }
+        this.pendingChanges = 0;
+    }
+    /** Sends the pending note now, if anything is pending. Safe to call at any time. */
+    Flush() {
+        if (this.timer !== null) {
+            clearTimeout(this.timer);
+            this.timer = null;
+        }
+        if (this.pendingChanges === 0) {
+            return;
+        }
+        const changes = this.pendingChanges;
+        const changeId = this.pendingChangeId;
+        this.pendingChanges = 0;
+        try {
+            this.sendNote(this.host.GetState(), changes, changeId);
+        }
+        catch (error) {
+            this.host.OnError(error);
+        }
+    }
+    /** Cancels any pending note. Call at teardown. */
+    Dispose() {
+        if (this.timer !== null) {
+            clearTimeout(this.timer);
+            this.timer = null;
+        }
+        this.pendingChanges = 0;
+    }
+    /** Builds and sends the note for the current burst: a snapshot the first time, a delta after. */
+    sendNote(state, changes, changeId) {
+        const previous = this.baseline;
+        this.baseline = state;
+        if (previous === null) {
+            this.deliver({ changeId, changes, snapshot: state }, () => ({ changeId, changes, truncated: true, keys: Object.keys(state) }));
+            return;
+        }
+        const delta = ComputeStateDelta(previous, state);
+        if (delta === null) {
+            return; // the burst netted out to no change — nothing to tell the model
+        }
+        this.deliver({ changeId, changes, delta: { changed: delta.Changed, removed: delta.Removed } }, () => ({ changeId, changes, truncated: true, changedPaths: ListChangedPaths(delta) }));
+    }
+    /** Sends `full` unless it is too large, in which case the compact fallback goes instead. */
+    deliver(full, compact) {
+        const body = JSON.stringify(full).length <= this.options.MaxNoteChars ? full : compact();
+        this.host.SendNote(FormatChannelNote(this.host.ChannelKey, this.host.InstanceId, 'state_changed', body));
+    }
+}
+//# sourceMappingURL=channel-perception.js.map

package/dist/channels/channel-perception.js.map

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

package/dist/channels/channel-schema-format.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @fileoverview Renders a JSON Schema's top-level parameters as a compact, model-readable list —
+ * `row:integer, col:integer, note?:string` — for error messages and the channel catalog note.
+ *
+ * Intentionally shallow: a speaking model needs the names, rough types and which are optional to
+ * form a call, not a schema dump. Nested structure collapses to its type (`object`, `array`).
+ *
+ * @module @memberjunction/realtime-runtime
+ */
+/**
+ * Lists a schema's top-level properties as `name:type`, with `?` after the name of optional ones.
+ * An empty or property-less schema renders as an empty string.
+ *
+ * @param schema A JSON Schema object.
+ */
+export declare function FormatParameterList(schema: unknown): string;
+//# sourceMappingURL=channel-schema-format.d.ts.map

package/dist/channels/channel-schema-format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel-schema-format.d.ts","sourceRoot":"","sources":["../../src/channels/channel-schema-format.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAwBH;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAQ3D"}

package/dist/channels/channel-schema-format.js

@@ -0,0 +1,45 @@
+/**
+ * @fileoverview Renders a JSON Schema's top-level parameters as a compact, model-readable list —
+ * `row:integer, col:integer, note?:string` — for error messages and the channel catalog note.
+ *
+ * Intentionally shallow: a speaking model needs the names, rough types and which are optional to
+ * form a call, not a schema dump. Nested structure collapses to its type (`object`, `array`).
+ *
+ * @module @memberjunction/realtime-runtime
+ */
+import { IsPlainObject } from '@memberjunction/global';
+/** Renders one property's type: its `enum` as `a|b|c`, else its `type` (a union joined with `|`), else `any`. */
+function describePropertyType(schema) {
+    if (!IsPlainObject(schema)) {
+        return 'any';
+    }
+    const options = schema['enum'];
+    if (Array.isArray(options) && options.length > 0) {
+        return options.map((o) => String(o)).join('|');
+    }
+    const type = schema['type'];
+    if (typeof type === 'string') {
+        return type;
+    }
+    if (Array.isArray(type)) {
+        const names = type.filter((t) => typeof t === 'string');
+        return names.length > 0 ? names.join('|') : 'any';
+    }
+    return 'any';
+}
+/**
+ * Lists a schema's top-level properties as `name:type`, with `?` after the name of optional ones.
+ * An empty or property-less schema renders as an empty string.
+ *
+ * @param schema A JSON Schema object.
+ */
+export function FormatParameterList(schema) {
+    if (!IsPlainObject(schema) || !IsPlainObject(schema['properties'])) {
+        return '';
+    }
+    const required = new Set(Array.isArray(schema['required']) ? schema['required'].filter((r) => typeof r === 'string') : []);
+    return Object.entries(schema['properties'])
+        .map(([name, property]) => `${name}${required.has(name) ? '' : '?'}:${describePropertyType(property)}`)
+        .join(', ');
+}
+//# sourceMappingURL=channel-schema-format.js.map

package/dist/channels/channel-schema-format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel-schema-format.js","sourceRoot":"","sources":["../../src/channels/channel-schema-format.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAEvD,iHAAiH;AACjH,SAAS,oBAAoB,CAAC,MAAe;IAC3C,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;IAC/B,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACjD,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACjD,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;IAC5B,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACxB,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC;QACrE,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IACpD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAe;IACjD,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC;QACnE,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACxI,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;SACxC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,EAAE,CAAC,GAAG,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,oBAAoB,CAAC,QAAQ,CAAC,EAAE,CAAC;SACtG,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC"}

package/dist/channels/channel-state-delta.d.ts

@@ -0,0 +1,59 @@
+/**
+ * @fileoverview Pure helpers for **structured perception notes** — the compact, typed context notes
+ * a channel sends the model when its state changes.
+ *
+ * Perception used to be free-form text: each channel invented its own wording and its own idea of
+ * when to speak, so a burst of edits became a burst of sentences the model had to read and ignore.
+ * The contract now is:
+ *
+ * ```
+ * [channel:<Key>#<instance>] <event> <json>
+ * ```
+ *
+ * with the JSON carrying **what changed** (a delta against what the model was last told), not the
+ * whole state. These helpers are the arithmetic behind that: a structural delta between two state
+ * snapshots, and the one place the note is formatted.
+ *
+ * @module @memberjunction/realtime-runtime
+ */
+import type { JSONObject } from '@memberjunction/ai';
+/**
+ * The structural difference between two state snapshots.
+ *
+ * `Changed` is a nested *partial* of the new state — overlay it on the old state and you have the
+ * new one (arrays and scalars are replaced whole, never patched element-wise: a patch language the
+ * model would have to execute in its head is worse than re-reading a short array). `Removed` lists
+ * the dotted paths that existed before and do not now.
+ */
+export interface StateDelta {
+    /** The changed and added values, as a nested partial of the new state. */
+    Changed: JSONObject;
+    /** Dotted paths that were present before and are gone. */
+    Removed: string[];
+}
+/**
+ * Computes what changed between two state snapshots.
+ *
+ * @param previous The state the model was last told about.
+ * @param next The state now.
+ * @returns The delta, or `null` when nothing changed (so a burst that nets out to no change sends nothing).
+ */
+export declare function ComputeStateDelta(previous: JSONObject, next: JSONObject): StateDelta | null;
+/**
+ * Lists the dotted paths a delta touched, to a bounded depth — what a note falls back to when the
+ * full delta would be too large to send. Paths to a changed *subtree* stop at `maxDepth`.
+ *
+ * @param delta The delta to summarize.
+ * @param maxDepth How many path segments to keep (default 2).
+ */
+export declare function ListChangedPaths(delta: StateDelta, maxDepth?: number): string[];
+/**
+ * Formats the one-line structured note: `[channel:<Key>#<instance>] <event> <json>`.
+ *
+ * @param channelKey The channel's key.
+ * @param instanceId The instance's id.
+ * @param event The event name (`state_changed`, `opened`, `completed`, …).
+ * @param payload The JSON payload (omit for an event with none).
+ */
+export declare function FormatChannelNote(channelKey: string, instanceId: string, event: string, payload?: JSONObject): string;
+//# sourceMappingURL=channel-state-delta.d.ts.map

package/dist/channels/channel-state-delta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel-state-delta.d.ts","sourceRoot":"","sources":["../../src/channels/channel-state-delta.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAa,MAAM,oBAAoB,CAAC;AAGhE;;;;;;;GAOG;AACH,MAAM,WAAW,UAAU;IACvB,0EAA0E;IAC1E,OAAO,EAAE,UAAU,CAAC;IACpB,0DAA0D;IAC1D,OAAO,EAAE,MAAM,EAAE,CAAC;CACrB;AAiBD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,GAAG,UAAU,GAAG,IAAI,CAG3F;AAkCD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,EAAE,QAAQ,GAAE,MAAU,GAAG,MAAM,EAAE,CAiBlF;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,MAAM,CAGrH"}

package/dist/channels/channel-state-delta.js

@@ -0,0 +1,116 @@
+/**
+ * @fileoverview Pure helpers for **structured perception notes** — the compact, typed context notes
+ * a channel sends the model when its state changes.
+ *
+ * Perception used to be free-form text: each channel invented its own wording and its own idea of
+ * when to speak, so a burst of edits became a burst of sentences the model had to read and ignore.
+ * The contract now is:
+ *
+ * ```
+ * [channel:<Key>#<instance>] <event> <json>
+ * ```
+ *
+ * with the JSON carrying **what changed** (a delta against what the model was last told), not the
+ * whole state. These helpers are the arithmetic behind that: a structural delta between two state
+ * snapshots, and the one place the note is formatted.
+ *
+ * @module @memberjunction/realtime-runtime
+ */
+import { IsPlainObject } from '@memberjunction/global';
+/** Deep equality for JSON values. */
+function jsonEqual(a, b) {
+    if (a === b) {
+        return true;
+    }
+    if (Array.isArray(a) && Array.isArray(b)) {
+        return a.length === b.length && a.every((item, index) => jsonEqual(item, b[index]));
+    }
+    if (IsPlainObject(a) && IsPlainObject(b)) {
+        const aKeys = Object.keys(a);
+        return aKeys.length === Object.keys(b).length && aKeys.every((k) => k in b && jsonEqual(a[k], b[k]));
+    }
+    return false;
+}
+/**
+ * Computes what changed between two state snapshots.
+ *
+ * @param previous The state the model was last told about.
+ * @param next The state now.
+ * @returns The delta, or `null` when nothing changed (so a burst that nets out to no change sends nothing).
+ */
+export function ComputeStateDelta(previous, next) {
+    const delta = diffObjects(previous, next, '');
+    return Object.keys(delta.Changed).length === 0 && delta.Removed.length === 0 ? null : delta;
+}
+/** Recursive worker for {@link ComputeStateDelta}. */
+function diffObjects(previous, next, prefix) {
+    const changed = {};
+    const removed = [];
+    for (const key of Object.keys(next)) {
+        // Channel state is caller-supplied JSON; a key like `__proto__` must never be copied through.
+        if (key === '__proto__' || key === 'constructor' || key === 'prototype') {
+            continue;
+        }
+        const path = prefix ? `${prefix}.${key}` : key;
+        const before = previous[key];
+        const after = next[key];
+        if (!(key in previous)) {
+            changed[key] = after;
+        }
+        else if (IsPlainObject(before) && IsPlainObject(after)) {
+            const child = diffObjects(before, after, path);
+            if (Object.keys(child.Changed).length > 0) {
+                changed[key] = child.Changed;
+            }
+            removed.push(...child.Removed);
+        }
+        else if (!jsonEqual(before, after)) {
+            changed[key] = after;
+        }
+    }
+    for (const key of Object.keys(previous)) {
+        if (!(key in next)) {
+            removed.push(prefix ? `${prefix}.${key}` : key);
+        }
+    }
+    return { Changed: changed, Removed: removed };
+}
+/**
+ * Lists the dotted paths a delta touched, to a bounded depth — what a note falls back to when the
+ * full delta would be too large to send. Paths to a changed *subtree* stop at `maxDepth`.
+ *
+ * @param delta The delta to summarize.
+ * @param maxDepth How many path segments to keep (default 2).
+ */
+export function ListChangedPaths(delta, maxDepth = 2) {
+    const paths = new Set();
+    const walk = (node, prefix) => {
+        for (const [key, value] of Object.entries(node)) {
+            const here = [...prefix, key];
+            if (IsPlainObject(value) && here.length < maxDepth) {
+                walk(value, here);
+            }
+            else {
+                paths.add(here.join('.'));
+            }
+        }
+    };
+    walk(delta.Changed, []);
+    for (const removed of delta.Removed) {
+        paths.add(removed.split('.').slice(0, maxDepth).join('.'));
+    }
+    return [...paths];
+}
+/**
+ * Formats the one-line structured note: `[channel:<Key>#<instance>] <event> <json>`.
+ *
+ * @param channelKey The channel's key.
+ * @param instanceId The instance's id.
+ * @param event The event name (`state_changed`, `opened`, `completed`, …).
+ * @param payload The JSON payload (omit for an event with none).
+ */
+export function FormatChannelNote(channelKey, instanceId, event, payload) {
+    const head = `[channel:${channelKey}#${instanceId}] ${event}`;
+    return payload === undefined ? head : `${head} ${JSON.stringify(payload)}`;
+}
+//# sourceMappingURL=channel-state-delta.js.map

package/dist/channels/channel-state-delta.js.map

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