@memberjunction/ng-conversations 6.2.0-edge.2 → 6.2.0-edge.4

package/dist/lib/components/realtime/interactive-component/component-data-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-data-state.js","sourceRoot":"","sources":["../../../../../src/lib/components/realtime/interactive-component/component-data-state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAYH,wEAAwE;AACxE,MAAM,SAAS,GAAG,CAAC,CAAC;AACpB,oDAAoD;AACpD,MAAM,gBAAgB,GAAG,GAAG,CAAC;AAC7B,kEAAkE;AAClE,MAAM,WAAW,GAAG,EAAE,CAAC;AACvB,yCAAyC;AACzC,MAAM,WAAW,GAAG,EAAE,CAAC;AAEvB,mEAAmE;AACnE,MAAM,OAAO,GAAG,WAAW,CAAC;AAE5B,uDAAuD;AACvD,SAAS,QAAQ,CAAC,KAAc;IAC5B,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAChF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,KAAc,EAAE,QAAgB,CAAC,EAAE,OAAwB,IAAI,OAAO,EAAE;IAClG,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxC,OAAO,IAAI,CAAC;IAChB,CAAC;IACD,QAAQ,OAAO,KAAK,EAAE,CAAC;QACnB,KAAK,QAAQ;YACT,OAAO,KAAK,CAAC,MAAM,GAAG,gBAAgB,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,gBAAgB,CAAC,MAAM,KAAK,CAAC,MAAM,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC;QACpH,KAAK,QAAQ;YACT,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;QACjD,KAAK,SAAS;YACV,OAAO,KAAK,CAAC;QACjB,KAAK,QAAQ;YACT,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAC;QAC5B,KAAK,UAAU,CAAC;QAChB,KAAK,QAAQ;YACT,OAAO,OAAO,CAAC;QACnB;YACI,MAAM;IACd,CAAC;IACD,OAAO,mBAAmB,CAAC,KAAe,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;AAC7D,CAAC;AAED,gDAAgD;AAChD,SAAS,mBAAmB,CAAC,KAAa,EAAE,KAAa,EAAE,IAAqB;IAC5E,IAAI,KAAK,YAAY,IAAI,EAAE,CAAC;QACxB,OAAO,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;IACtE,CAAC;IACD,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QAClB,OAAO,YAAY,CAAC;IACxB,CAAC;IACD,IAAI,KAAK,IAAI,SAAS,EAAE,CAAC;QACrB,OAAO,YAAY,CAAC;IACxB,CAAC;IACD,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAChB,IAAI,CAAC;QACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACvB,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;YAC9F,OAAO,KAAK,CAAC,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,EAAE,KAAK,KAAK,CAAC,MAAM,GAAG,WAAW,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QACnG,CAAC;QACD,MAAM,GAAG,GAAe,EAAE,CAAC;QAC3B,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,WAAW,CAAC,EAAE,CAAC;YACzD,oFAAoF;YACpF,IAAI,GAAG,KAAK,WAAW,IAAI,GAAG,KAAK,aAAa,IAAI,GAAG,KAAK,WAAW,EAAE,CAAC;gBACtE,SAAS;YACb,CAAC;YACD,GAAG,CAAC,GAAG,CAAC,GAAG,aAAa,CAAE,KAAiC,CAAC,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC;QACvF,CAAC;QACD,OAAO,GAAG,CAAC;IACf,CAAC;YAAS,CAAC;QACP,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;AACL,CAAC;AAED,qEAAqE;AACrE,SAAS,cAAc,CAAC,KAAc,EAAE,KAAa,EAAE,OAAe;IAClE,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACnB,OAAO,EAAE,IAAI,EAAE,SAAS,KAAK,GAAG,CAAC,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;IACvD,CAAC;IACD,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAE,KAAK,CAAC,MAAM,CAAe,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9E,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAE,KAAK,CAAC,SAAS,CAAe,CAAC,CAAC,CAAC,EAAE,CAAC;IACvF,MAAM,WAAW,GAAG,OAAO;SACtB,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;SACvI,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,IAAI,KAAK,IAAI,CAAC;SAC/C,KAAK,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC;IAC3B,MAAM,OAAO,GAAe;QACxB,IAAI,EAAE,OAAO,KAAK,CAAC,MAAM,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,KAAK,GAAG,CAAC,EAAE;QAC9E,QAAQ,EAAE,IAAI,CAAC,MAAM;QACrB,OAAO,EAAE,WAAW;QACpB,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,aAAa,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;KACnE,CAAC;IACF,IAAI,IAAI,CAAC,MAAM,GAAG,OAAO,EAAE,CAAC;QACxB,OAAO,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC;IACnD,CAAC;IACD,OAAO,OAAO,CAAC;AACnB,CAAC;AAED,gEAAgE;AAChE,SAAS,YAAY,CAAC,KAA8B,EAAE,OAAe;IACjE,MAAM,OAAO,GAAe,EAAE,CAAC;IAC/B,KAAK,MAAM,GAAG,IAAI,CAAC,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,gBAAgB,CAAU,EAAE,CAAC;QAChF,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;QACzB,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAChD,OAAO,CAAC,GAAG,CAAC,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;QACxC,CAAC;IACL,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,IAAI,KAAK,CAAC,WAAW,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrE,OAAO,CAAC,WAAW,CAAC,GAAG,aAAa,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC;IAC7D,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;QACjC,OAAO,CAAC,QAAQ,CAAC,GAAI,KAAK,CAAC,QAAQ,CAAe,CAAC,KAAK,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;IAClI,CAAC;IACD,IAAI,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvE,OAAO,CAAC,QAAQ,CAAC,GAAG,aAAa,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;IACvD,CAAC;IACD,OAAO,OAAO,CAAC;AACnB,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAgC,EAAE,MAAuB;IACxF,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACnB,OAAO,IAAI,CAAC;IAChB,CAAC;IACD,IAAI,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;IACnD,IAAI,OAAO,GAAG,YAAY,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACxC,OAAO,IAAI,GAAG,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,MAAM,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;QAClE,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC;QAC5B,OAAO,GAAG,YAAY,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACxC,CAAC;IACD,IAAI,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,MAAM,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;QACnD,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,iCAAiC,MAAM,CAAC,QAAQ,iCAAiC,EAAE,CAAC;IACxH,CAAC;IACD,OAAO,OAAO,CAAC;AACnB,CAAC","sourcesContent":["/**\n * @fileoverview Bounds a component's data state before it is described to the model.\n *\n * A component's `getCurrentDataState()` can hold thousands of rows. A perception note that carried them all\n * would flood the model's context and, when the component shows private data, leak far more than the model\n * needs to answer \"what is the user looking at\". This turns an arbitrary data state into a small JSON summary:\n * the per-table row count and columns always, and only the first `MaxRows` rows; long strings are clipped;\n * the whole thing is held under a character budget.\n *\n * The input is whatever the component returned, so it is treated as untrusted: it may be cyclic, hold functions,\n * dates or class instances. The output is always plain JSON.\n *\n * @module @memberjunction/ng-conversations\n */\n\nimport type { JSONObject, JSONValue } from '@memberjunction/ai';\n\n/** Limits applied to a data state. */\nexport interface DataStateLimits {\n    /** The most rows kept per table. */\n    MaxRows: number;\n    /** The most characters of the serialized summary; beyond it rows are dropped until it fits. */\n    MaxChars: number;\n}\n\n/** The deepest nesting kept; deeper values are replaced by a marker. */\nconst MAX_DEPTH = 5;\n/** The longest string kept before it is clipped. */\nconst MAX_STRING_CHARS = 200;\n/** The most keys kept per object or items per non-table array. */\nconst MAX_BREADTH = 30;\n/** The most columns listed per table. */\nconst MAX_COLUMNS = 40;\n\n/** Marker for a value the summary could not or would not carry. */\nconst OMITTED = '[omitted]';\n\n/** True for a non-null object that is not an array. */\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n    return value !== null && typeof value === 'object' && !Array.isArray(value);\n}\n\n/**\n * Converts one arbitrary value into JSON, bounded in depth, breadth and string length.\n * Functions and symbols become a marker, dates their ISO string, cycles a marker.\n */\nexport function ToBoundedJson(value: unknown, depth: number = 0, seen: WeakSet<object> = new WeakSet()): JSONValue {\n    if (value === null || value === undefined) {\n        return null;\n    }\n    switch (typeof value) {\n        case 'string':\n            return value.length > MAX_STRING_CHARS ? `${value.slice(0, MAX_STRING_CHARS)}… (${value.length} chars)` : value;\n        case 'number':\n            return Number.isFinite(value) ? value : null;\n        case 'boolean':\n            return value;\n        case 'bigint':\n            return value.toString();\n        case 'function':\n        case 'symbol':\n            return OMITTED;\n        default:\n            break;\n    }\n    return objectToBoundedJson(value as object, depth, seen);\n}\n\n/** The object half of {@link ToBoundedJson}. */\nfunction objectToBoundedJson(value: object, depth: number, seen: WeakSet<object>): JSONValue {\n    if (value instanceof Date) {\n        return Number.isNaN(value.getTime()) ? null : value.toISOString();\n    }\n    if (seen.has(value)) {\n        return '[circular]';\n    }\n    if (depth >= MAX_DEPTH) {\n        return '[too deep]';\n    }\n    seen.add(value);\n    try {\n        if (Array.isArray(value)) {\n            const items = value.slice(0, MAX_BREADTH).map((item) => ToBoundedJson(item, depth + 1, seen));\n            return value.length > MAX_BREADTH ? [...items, `… ${value.length - MAX_BREADTH} more`] : items;\n        }\n        const out: JSONObject = {};\n        for (const key of Object.keys(value).slice(0, MAX_BREADTH)) {\n            // Component state is untrusted; never copy a key that would reach Object.prototype.\n            if (key === '__proto__' || key === 'constructor' || key === 'prototype') {\n                continue;\n            }\n            out[key] = ToBoundedJson((value as Record<string, unknown>)[key], depth + 1, seen);\n        }\n        return out;\n    } finally {\n        seen.delete(value);\n    }\n}\n\n/** Summarizes one table-shaped entry (`{ name, columns, rows }`). */\nfunction summarizeTable(table: unknown, index: number, maxRows: number): JSONObject {\n    if (!isRecord(table)) {\n        return { name: `table ${index + 1}`, rowCount: 0 };\n    }\n    const rows = Array.isArray(table['rows']) ? (table['rows'] as unknown[]) : [];\n    const columns = Array.isArray(table['columns']) ? (table['columns'] as unknown[]) : [];\n    const columnNames = columns\n        .map((column) => (typeof column === 'string' ? column : isRecord(column) && typeof column['name'] === 'string' ? column['name'] : null))\n        .filter((name): name is string => name !== null)\n        .slice(0, MAX_COLUMNS);\n    const summary: JSONObject = {\n        name: typeof table['name'] === 'string' ? table['name'] : `table ${index + 1}`,\n        rowCount: rows.length,\n        columns: columnNames,\n        rows: rows.slice(0, maxRows).map((row) => ToBoundedJson(row, 1)),\n    };\n    if (rows.length > maxRows) {\n        summary['rowsOmitted'] = rows.length - maxRows;\n    }\n    return summary;\n}\n\n/** Builds the summary with at most `maxRows` rows per table. */\nfunction buildSummary(state: Record<string, unknown>, maxRows: number): JSONObject {\n    const summary: JSONObject = {};\n    for (const key of ['title', 'activeTab', 'searchText', 'interpretation'] as const) {\n        const value = state[key];\n        if (typeof value === 'string' && value.length > 0) {\n            summary[key] = ToBoundedJson(value);\n        }\n    }\n    if (Array.isArray(state['drillPath']) && state['drillPath'].length > 0) {\n        summary['drillPath'] = ToBoundedJson(state['drillPath']);\n    }\n    if (Array.isArray(state['tables'])) {\n        summary['tables'] = (state['tables'] as unknown[]).slice(0, MAX_BREADTH).map((table, i) => summarizeTable(table, i, maxRows));\n    }\n    if (isRecord(state['custom']) && Object.keys(state['custom']).length > 0) {\n        summary['custom'] = ToBoundedJson(state['custom']);\n    }\n    return summary;\n}\n\n/**\n * Summarizes a component's data state for the model.\n *\n * The result is plain JSON no larger than `limits.MaxChars`: when the first attempt is over budget the per-table\n * row cap is halved until it fits, down to zero rows (counts and columns only).\n *\n * @param state The value `getCurrentDataState()` returned (a `DataSnapshot` or anything else), or nothing.\n * @param limits The row and size caps.\n * @returns The summary, or `null` when the component has no data state.\n */\nexport function SummarizeDataState(state: object | null | undefined, limits: DataStateLimits): JSONObject | null {\n    if (!isRecord(state)) {\n        return null;\n    }\n    let rows = Math.max(0, Math.floor(limits.MaxRows));\n    let summary = buildSummary(state, rows);\n    while (rows > 0 && JSON.stringify(summary).length > limits.MaxChars) {\n        rows = Math.floor(rows / 2);\n        summary = buildSummary(state, rows);\n    }\n    if (JSON.stringify(summary).length > limits.MaxChars) {\n        return { truncated: true, note: `The data state is larger than ${limits.MaxChars} characters; ask for specifics.` };\n    }\n    return summary;\n}\n"]}

package/dist/lib/components/realtime/interactive-component/component-instance-engine.d.ts

@@ -0,0 +1,109 @@
+/**
+ * @fileoverview The Interactive Component channel's state of record: which components are open, which one the
+ * user is looking at, what version each shows, and the last thing each reported.
+ *
+ * Framework-free and synchronous. The channel mutates it; the Angular surface observes {@link ComponentInstanceEngine.Changed$}
+ * and renders it. Keeping it separate means the rules (the instance cap, "swapping a version keeps the instance")
+ * are tested without a browser and are the same whoever drives them.
+ *
+ * @module @memberjunction/ng-conversations
+ */
+import { Observable } from 'rxjs';
+import type { JSONObject, JSONValue } from '@memberjunction/ai';
+import { type ComponentContract } from './component-contract';
+import type { IInteractiveComponentHandle, ResolvedComponentArtifact } from './interactive-component-types';
+/** The last thing a component reported, kept so it can ride in the state the model perceives. */
+export interface ComponentLastEvent {
+    /** The event type or state path. */
+    Type: string;
+    /** The (bounded) payload. */
+    Payload: JSONValue;
+    /** Monotonic per engine, so two identical events in a row still register as a change. */
+    Seq: number;
+}
+/** One open component. */
+export interface ComponentInstanceRecord {
+    /** The instance id the agent addresses (`c1`, `c2`, ...). Stable for the life of the instance, across version swaps. */
+    readonly InstanceID: string;
+    /** The artifact version currently shown. */
+    Artifact: ResolvedComponentArtifact;
+    /** What the agent can do with it, derived from {@link Artifact}'s spec; re-derived on a version swap. */
+    Contract: ComponentContract;
+    /** The inputs it was opened with. */
+    Inputs: JSONObject;
+    /** The last event it reported, if any. */
+    LastEvent: ComponentLastEvent | null;
+    /** The live handle on the rendered component, once the surface has mounted it. */
+    Handle: IInteractiveComponentHandle | null;
+}
+/** What changed, for the surface to react to. */
+export type ComponentInstanceChange = {
+    Kind: 'added';
+    InstanceID: string;
+} | {
+    Kind: 'removed';
+    InstanceID: string;
+} | {
+    Kind: 'version';
+    InstanceID: string;
+} | {
+    Kind: 'active';
+    InstanceID: string | null;
+} | {
+    Kind: 'event';
+    InstanceID: string;
+};
+/** Why an instance could not be added. */
+export declare class InstanceLimitError extends Error {
+    readonly Limit: number;
+    /** @param Limit The configured cap. */
+    constructor(Limit: number);
+}
+/** The set of open components. */
+export declare class ComponentInstanceEngine {
+    private maxInstances;
+    private readonly records;
+    private readonly changedSubject;
+    private activeId;
+    private instanceSeq;
+    private eventSeq;
+    /** @param maxInstances The most components that may be open at once. */
+    constructor(maxInstances: number);
+    /** Every change, as it happens. Completes at {@link Dispose}. */
+    readonly Changed$: Observable<ComponentInstanceChange>;
+    /** Updates the instance cap (the configuration is read after the engine is created). Open instances above a lowered cap stay open. */
+    SetMaxInstances(maxInstances: number): void;
+    /** The open components, in the order they were opened. */
+    get Instances(): readonly ComponentInstanceRecord[];
+    /** The id of the instance the user is looking at, or `null` when nothing is open. */
+    get ActiveID(): string | null;
+    /** The instance with this id, or `undefined`. */
+    Get(instanceId: string): ComponentInstanceRecord | undefined;
+    /** The instance showing a version of this artifact, or `undefined`. */
+    FindByArtifact(artifactId: string): ComponentInstanceRecord | undefined;
+    /**
+     * Opens a component and makes it the active one.
+     *
+     * @param artifact The loaded artifact version.
+     * @param inputs What the agent passed to seed it with.
+     * @throws {InstanceLimitError} When the cap is reached.
+     */
+    Add(artifact: ResolvedComponentArtifact, inputs: JSONObject): ComponentInstanceRecord;
+    /** Closes an instance; the previous one in open order becomes active. Returns `false` when there is no such instance. */
+    Remove(instanceId: string): boolean;
+    /**
+     * Shows another version in an existing instance. The instance id, its inputs and its place in the open order are
+     * kept; only the artifact version (and what is derived from its spec) changes, and the old handle is dropped
+     * (the surface re-attaches one once the new version has initialized).
+     */
+    SwapVersion(instanceId: string, artifact: ResolvedComponentArtifact): boolean;
+    /** Makes an instance the active one (or `null` for none). Returns `false` for an unknown id. */
+    SetActive(instanceId: string | null): boolean;
+    /** Attaches (or detaches, with `null`) the live handle on a rendered component. */
+    AttachHandle(instanceId: string, handle: IInteractiveComponentHandle | null): void;
+    /** Records what a component just reported. Returns `false` for an unknown instance. */
+    RecordEvent(instanceId: string, type: string, payload: JSONValue): boolean;
+    /** Closes every instance without emitting per-instance changes, and completes {@link Changed$}. */
+    Dispose(): void;
+}
+//# sourceMappingURL=component-instance-engine.d.ts.map

package/dist/lib/components/realtime/interactive-component/component-instance-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-instance-engine.d.ts","sourceRoot":"","sources":["../../../../../src/lib/components/realtime/interactive-component/component-instance-engine.ts"],"names":[],"mappings":"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"}

package/dist/lib/components/realtime/interactive-component/component-instance-engine.js

@@ -0,0 +1,146 @@
+/**
+ * @fileoverview The Interactive Component channel's state of record: which components are open, which one the
+ * user is looking at, what version each shows, and the last thing each reported.
+ *
+ * Framework-free and synchronous. The channel mutates it; the Angular surface observes {@link ComponentInstanceEngine.Changed$}
+ * and renders it. Keeping it separate means the rules (the instance cap, "swapping a version keeps the instance")
+ * are tested without a browser and are the same whoever drives them.
+ *
+ * @module @memberjunction/ng-conversations
+ */
+import { Subject } from 'rxjs';
+import { DeriveComponentContract } from './component-contract';
+/** Why an instance could not be added. */
+export class InstanceLimitError extends Error {
+    Limit;
+    /** @param Limit The configured cap. */
+    constructor(Limit) {
+        super(`At most ${Limit} component${Limit === 1 ? ' is' : 's are'} open at once. Close one first.`);
+        this.Limit = Limit;
+        this.name = 'InstanceLimitError';
+    }
+}
+/** The set of open components. */
+export class ComponentInstanceEngine {
+    maxInstances;
+    records = new Map();
+    changedSubject = new Subject();
+    activeId = null;
+    instanceSeq = 0;
+    eventSeq = 0;
+    /** @param maxInstances The most components that may be open at once. */
+    constructor(maxInstances) {
+        this.maxInstances = maxInstances;
+    }
+    /** Every change, as it happens. Completes at {@link Dispose}. */
+    Changed$ = this.changedSubject.asObservable();
+    /** Updates the instance cap (the configuration is read after the engine is created). Open instances above a lowered cap stay open. */
+    SetMaxInstances(maxInstances) {
+        this.maxInstances = maxInstances;
+    }
+    /** The open components, in the order they were opened. */
+    get Instances() {
+        return [...this.records.values()];
+    }
+    /** The id of the instance the user is looking at, or `null` when nothing is open. */
+    get ActiveID() {
+        return this.activeId;
+    }
+    /** The instance with this id, or `undefined`. */
+    Get(instanceId) {
+        return this.records.get(instanceId);
+    }
+    /** The instance showing a version of this artifact, or `undefined`. */
+    FindByArtifact(artifactId) {
+        return this.Instances.find((r) => r.Artifact.ArtifactID.toLowerCase() === artifactId.toLowerCase());
+    }
+    /**
+     * Opens a component and makes it the active one.
+     *
+     * @param artifact The loaded artifact version.
+     * @param inputs What the agent passed to seed it with.
+     * @throws {InstanceLimitError} When the cap is reached.
+     */
+    Add(artifact, inputs) {
+        if (this.records.size >= this.maxInstances) {
+            throw new InstanceLimitError(this.maxInstances);
+        }
+        const record = {
+            InstanceID: `c${++this.instanceSeq}`,
+            Artifact: artifact,
+            Contract: DeriveComponentContract(artifact.Spec),
+            Inputs: inputs,
+            LastEvent: null,
+            Handle: null,
+        };
+        this.records.set(record.InstanceID, record);
+        this.changedSubject.next({ Kind: 'added', InstanceID: record.InstanceID });
+        this.SetActive(record.InstanceID);
+        return record;
+    }
+    /** Closes an instance; the previous one in open order becomes active. Returns `false` when there is no such instance. */
+    Remove(instanceId) {
+        if (!this.records.delete(instanceId)) {
+            return false;
+        }
+        this.changedSubject.next({ Kind: 'removed', InstanceID: instanceId });
+        if (this.activeId === instanceId) {
+            const remaining = this.Instances;
+            this.activeId = null;
+            this.SetActive(remaining.length > 0 ? remaining[remaining.length - 1].InstanceID : null);
+        }
+        return true;
+    }
+    /**
+     * Shows another version in an existing instance. The instance id, its inputs and its place in the open order are
+     * kept; only the artifact version (and what is derived from its spec) changes, and the old handle is dropped
+     * (the surface re-attaches one once the new version has initialized).
+     */
+    SwapVersion(instanceId, artifact) {
+        const record = this.records.get(instanceId);
+        if (!record) {
+            return false;
+        }
+        record.Artifact = artifact;
+        record.Contract = DeriveComponentContract(artifact.Spec);
+        record.LastEvent = null;
+        record.Handle = null;
+        this.changedSubject.next({ Kind: 'version', InstanceID: instanceId });
+        return true;
+    }
+    /** Makes an instance the active one (or `null` for none). Returns `false` for an unknown id. */
+    SetActive(instanceId) {
+        if (instanceId !== null && !this.records.has(instanceId)) {
+            return false;
+        }
+        if (this.activeId !== instanceId) {
+            this.activeId = instanceId;
+            this.changedSubject.next({ Kind: 'active', InstanceID: instanceId });
+        }
+        return true;
+    }
+    /** Attaches (or detaches, with `null`) the live handle on a rendered component. */
+    AttachHandle(instanceId, handle) {
+        const record = this.records.get(instanceId);
+        if (record) {
+            record.Handle = handle;
+        }
+    }
+    /** Records what a component just reported. Returns `false` for an unknown instance. */
+    RecordEvent(instanceId, type, payload) {
+        const record = this.records.get(instanceId);
+        if (!record) {
+            return false;
+        }
+        record.LastEvent = { Type: type, Payload: payload, Seq: ++this.eventSeq };
+        this.changedSubject.next({ Kind: 'event', InstanceID: instanceId });
+        return true;
+    }
+    /** Closes every instance without emitting per-instance changes, and completes {@link Changed$}. */
+    Dispose() {
+        this.records.clear();
+        this.activeId = null;
+        this.changedSubject.complete();
+    }
+}
+//# sourceMappingURL=component-instance-engine.js.map

package/dist/lib/components/realtime/interactive-component/component-instance-engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-instance-engine.js","sourceRoot":"","sources":["../../../../../src/lib/components/realtime/interactive-component/component-instance-engine.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * @fileoverview The Interactive Component channel's state of record: which components are open, which one the\n * user is looking at, what version each shows, and the last thing each reported.\n *\n * Framework-free and synchronous. The channel mutates it; the Angular surface observes {@link ComponentInstanceEngine.Changed$}\n * and renders it. Keeping it separate means the rules (the instance cap, \"swapping a version keeps the instance\")\n * are tested without a browser and are the same whoever drives them.\n *\n * @module @memberjunction/ng-conversations\n */\n\nimport { Observable, Subject } from 'rxjs';\nimport type { JSONObject, JSONValue } from '@memberjunction/ai';\nimport { DeriveComponentContract, type ComponentContract } from './component-contract';\nimport type { IInteractiveComponentHandle, ResolvedComponentArtifact } from './interactive-component-types';\n\n/** The last thing a component reported, kept so it can ride in the state the model perceives. */\nexport interface ComponentLastEvent {\n    /** The event type or state path. */\n    Type: string;\n    /** The (bounded) payload. */\n    Payload: JSONValue;\n    /** Monotonic per engine, so two identical events in a row still register as a change. */\n    Seq: number;\n}\n\n/** One open component. */\nexport interface ComponentInstanceRecord {\n    /** The instance id the agent addresses (`c1`, `c2`, ...). Stable for the life of the instance, across version swaps. */\n    readonly InstanceID: string;\n    /** The artifact version currently shown. */\n    Artifact: ResolvedComponentArtifact;\n    /** What the agent can do with it, derived from {@link Artifact}'s spec; re-derived on a version swap. */\n    Contract: ComponentContract;\n    /** The inputs it was opened with. */\n    Inputs: JSONObject;\n    /** The last event it reported, if any. */\n    LastEvent: ComponentLastEvent | null;\n    /** The live handle on the rendered component, once the surface has mounted it. */\n    Handle: IInteractiveComponentHandle | null;\n}\n\n/** What changed, for the surface to react to. */\nexport type ComponentInstanceChange =\n    | { Kind: 'added'; InstanceID: string }\n    | { Kind: 'removed'; InstanceID: string }\n    | { Kind: 'version'; InstanceID: string }\n    | { Kind: 'active'; InstanceID: string | null }\n    | { Kind: 'event'; InstanceID: string };\n\n/** Why an instance could not be added. */\nexport class InstanceLimitError extends Error {\n    /** @param Limit The configured cap. */\n    public constructor(public readonly Limit: number) {\n        super(`At most ${Limit} component${Limit === 1 ? ' is' : 's are'} open at once. Close one first.`);\n        this.name = 'InstanceLimitError';\n    }\n}\n\n/** The set of open components. */\nexport class ComponentInstanceEngine {\n    private readonly records = new Map<string, ComponentInstanceRecord>();\n    private readonly changedSubject = new Subject<ComponentInstanceChange>();\n    private activeId: string | null = null;\n    private instanceSeq = 0;\n    private eventSeq = 0;\n\n    /** @param maxInstances The most components that may be open at once. */\n    public constructor(private maxInstances: number) {}\n\n    /** Every change, as it happens. Completes at {@link Dispose}. */\n    public readonly Changed$: Observable<ComponentInstanceChange> = this.changedSubject.asObservable();\n\n    /** Updates the instance cap (the configuration is read after the engine is created). Open instances above a lowered cap stay open. */\n    public SetMaxInstances(maxInstances: number): void {\n        this.maxInstances = maxInstances;\n    }\n\n    /** The open components, in the order they were opened. */\n    public get Instances(): readonly ComponentInstanceRecord[] {\n        return [...this.records.values()];\n    }\n\n    /** The id of the instance the user is looking at, or `null` when nothing is open. */\n    public get ActiveID(): string | null {\n        return this.activeId;\n    }\n\n    /** The instance with this id, or `undefined`. */\n    public Get(instanceId: string): ComponentInstanceRecord | undefined {\n        return this.records.get(instanceId);\n    }\n\n    /** The instance showing a version of this artifact, or `undefined`. */\n    public FindByArtifact(artifactId: string): ComponentInstanceRecord | undefined {\n        return this.Instances.find((r) => r.Artifact.ArtifactID.toLowerCase() === artifactId.toLowerCase());\n    }\n\n    /**\n     * Opens a component and makes it the active one.\n     *\n     * @param artifact The loaded artifact version.\n     * @param inputs What the agent passed to seed it with.\n     * @throws {InstanceLimitError} When the cap is reached.\n     */\n    public Add(artifact: ResolvedComponentArtifact, inputs: JSONObject): ComponentInstanceRecord {\n        if (this.records.size >= this.maxInstances) {\n            throw new InstanceLimitError(this.maxInstances);\n        }\n        const record: ComponentInstanceRecord = {\n            InstanceID: `c${++this.instanceSeq}`,\n            Artifact: artifact,\n            Contract: DeriveComponentContract(artifact.Spec),\n            Inputs: inputs,\n            LastEvent: null,\n            Handle: null,\n        };\n        this.records.set(record.InstanceID, record);\n        this.changedSubject.next({ Kind: 'added', InstanceID: record.InstanceID });\n        this.SetActive(record.InstanceID);\n        return record;\n    }\n\n    /** Closes an instance; the previous one in open order becomes active. Returns `false` when there is no such instance. */\n    public Remove(instanceId: string): boolean {\n        if (!this.records.delete(instanceId)) {\n            return false;\n        }\n        this.changedSubject.next({ Kind: 'removed', InstanceID: instanceId });\n        if (this.activeId === instanceId) {\n            const remaining = this.Instances;\n            this.activeId = null;\n            this.SetActive(remaining.length > 0 ? remaining[remaining.length - 1].InstanceID : null);\n        }\n        return true;\n    }\n\n    /**\n     * Shows another version in an existing instance. The instance id, its inputs and its place in the open order are\n     * kept; only the artifact version (and what is derived from its spec) changes, and the old handle is dropped\n     * (the surface re-attaches one once the new version has initialized).\n     */\n    public SwapVersion(instanceId: string, artifact: ResolvedComponentArtifact): boolean {\n        const record = this.records.get(instanceId);\n        if (!record) {\n            return false;\n        }\n        record.Artifact = artifact;\n        record.Contract = DeriveComponentContract(artifact.Spec);\n        record.LastEvent = null;\n        record.Handle = null;\n        this.changedSubject.next({ Kind: 'version', InstanceID: instanceId });\n        return true;\n    }\n\n    /** Makes an instance the active one (or `null` for none). Returns `false` for an unknown id. */\n    public SetActive(instanceId: string | null): boolean {\n        if (instanceId !== null && !this.records.has(instanceId)) {\n            return false;\n        }\n        if (this.activeId !== instanceId) {\n            this.activeId = instanceId;\n            this.changedSubject.next({ Kind: 'active', InstanceID: instanceId });\n        }\n        return true;\n    }\n\n    /** Attaches (or detaches, with `null`) the live handle on a rendered component. */\n    public AttachHandle(instanceId: string, handle: IInteractiveComponentHandle | null): void {\n        const record = this.records.get(instanceId);\n        if (record) {\n            record.Handle = handle;\n        }\n    }\n\n    /** Records what a component just reported. Returns `false` for an unknown instance. */\n    public RecordEvent(instanceId: string, type: string, payload: JSONValue): boolean {\n        const record = this.records.get(instanceId);\n        if (!record) {\n            return false;\n        }\n        record.LastEvent = { Type: type, Payload: payload, Seq: ++this.eventSeq };\n        this.changedSubject.next({ Kind: 'event', InstanceID: instanceId });\n        return true;\n    }\n\n    /** Closes every instance without emitting per-instance changes, and completes {@link Changed$}. */\n    public Dispose(): void {\n        this.records.clear();\n        this.activeId = null;\n        this.changedSubject.complete();\n    }\n}\n"]}

package/dist/lib/components/realtime/interactive-component/component-spec-content.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @fileoverview Turns a component artifact version's `Content` into a renderable {@link ComponentSpec}.
+ *
+ * Kept apart from the database-backed source so the rules for "is this a component I can show" are plain
+ * functions that need no provider to test.
+ *
+ * @module @memberjunction/ng-conversations
+ */
+import type { ComponentSpec } from '@memberjunction/interactive-component-types';
+/**
+ * Parses an artifact version's `Content` as a component specification.
+ *
+ * @param content The version's `Content` column (JSON text), or `null` when the content is stored as a file.
+ * @param label How to name the artifact in a failure message (so the model is told which one).
+ * @throws {ComponentArtifactError} `'unreadable'` when there is no usable content, `'not_a_component'` when the
+ *   content is JSON that is not a component spec or has no executable code.
+ */
+export declare function ParseComponentSpecContent(content: string | null | undefined, label: string): ComponentSpec;
+//# sourceMappingURL=component-spec-content.d.ts.map

package/dist/lib/components/realtime/interactive-component/component-spec-content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-spec-content.d.ts","sourceRoot":"","sources":["../../../../../src/lib/components/realtime/interactive-component/component-spec-content.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6CAA6C,CAAC;AAQjF;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,aAAa,CAkB1G"}

package/dist/lib/components/realtime/interactive-component/component-spec-content.js

@@ -0,0 +1,39 @@
+/**
+ * @fileoverview Turns a component artifact version's `Content` into a renderable {@link ComponentSpec}.
+ *
+ * Kept apart from the database-backed source so the rules for "is this a component I can show" are plain
+ * functions that need no provider to test.
+ *
+ * @module @memberjunction/ng-conversations
+ */
+import { SafeJSONParse } from '@memberjunction/global';
+import { ComponentArtifactError } from './interactive-component-types';
+/** True for a non-null, non-array object. */
+function isRecord(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+/**
+ * Parses an artifact version's `Content` as a component specification.
+ *
+ * @param content The version's `Content` column (JSON text), or `null` when the content is stored as a file.
+ * @param label How to name the artifact in a failure message (so the model is told which one).
+ * @throws {ComponentArtifactError} `'unreadable'` when there is no usable content, `'not_a_component'` when the
+ *   content is JSON that is not a component spec or has no executable code.
+ */
+export function ParseComponentSpecContent(content, label) {
+    if (typeof content !== 'string' || content.trim().length === 0) {
+        throw new ComponentArtifactError('unreadable', `${label} has no inline content to render (content stored as a file is not supported by the Interactive Component channel).`);
+    }
+    const parsed = SafeJSONParse(content);
+    if (!isRecord(parsed) || typeof parsed['name'] !== 'string') {
+        throw new ComponentArtifactError('not_a_component', `${label} is not an interactive component (its content is not a component specification).`);
+    }
+    const hasCode = typeof parsed['code'] === 'string' && parsed['code'].trim().length > 0;
+    const isRegistry = typeof parsed['namespace'] === 'string' && parsed['namespace'].length > 0;
+    if (!hasCode && !isRegistry) {
+        throw new ComponentArtifactError('not_a_component', `${label} is a component specification with no executable code yet, so it cannot be shown.`);
+    }
+    // The parsed value is the artifact's own ComponentSpec JSON; the fields above are the ones rendering needs.
+    return parsed;
+}
+//# sourceMappingURL=component-spec-content.js.map

package/dist/lib/components/realtime/interactive-component/component-spec-content.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-spec-content.js","sourceRoot":"","sources":["../../../../../src/lib/components/realtime/interactive-component/component-spec-content.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAEvD,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAEvE,6CAA6C;AAC7C,SAAS,QAAQ,CAAC,KAAc;IAC5B,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAChF,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,yBAAyB,CAAC,OAAkC,EAAE,KAAa;IACvF,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7D,MAAM,IAAI,sBAAsB,CAC5B,YAAY,EACZ,GAAG,KAAK,oHAAoH,CAC/H,CAAC;IACN,CAAC;IACD,MAAM,MAAM,GAAY,aAAa,CAAC,OAAO,CAAC,CAAC;IAC/C,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,QAAQ,EAAE,CAAC;QAC1D,MAAM,IAAI,sBAAsB,CAAC,iBAAiB,EAAE,GAAG,KAAK,kFAAkF,CAAC,CAAC;IACpJ,CAAC;IACD,MAAM,OAAO,GAAG,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,QAAQ,IAAI,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;IACvF,MAAM,UAAU,GAAG,OAAO,MAAM,CAAC,WAAW,CAAC,KAAK,QAAQ,IAAI,MAAM,CAAC,WAAW,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;IAC7F,IAAI,CAAC,OAAO,IAAI,CAAC,UAAU,EAAE,CAAC;QAC1B,MAAM,IAAI,sBAAsB,CAAC,iBAAiB,EAAE,GAAG,KAAK,mFAAmF,CAAC,CAAC;IACrJ,CAAC;IACD,4GAA4G;IAC5G,OAAO,MAAkC,CAAC;AAC9C,CAAC","sourcesContent":["/**\n * @fileoverview Turns a component artifact version's `Content` into a renderable {@link ComponentSpec}.\n *\n * Kept apart from the database-backed source so the rules for \"is this a component I can show\" are plain\n * functions that need no provider to test.\n *\n * @module @memberjunction/ng-conversations\n */\n\nimport { SafeJSONParse } from '@memberjunction/global';\nimport type { ComponentSpec } from '@memberjunction/interactive-component-types';\nimport { ComponentArtifactError } from './interactive-component-types';\n\n/** True for a non-null, non-array object. */\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n    return value !== null && typeof value === 'object' && !Array.isArray(value);\n}\n\n/**\n * Parses an artifact version's `Content` as a component specification.\n *\n * @param content The version's `Content` column (JSON text), or `null` when the content is stored as a file.\n * @param label How to name the artifact in a failure message (so the model is told which one).\n * @throws {ComponentArtifactError} `'unreadable'` when there is no usable content, `'not_a_component'` when the\n *   content is JSON that is not a component spec or has no executable code.\n */\nexport function ParseComponentSpecContent(content: string | null | undefined, label: string): ComponentSpec {\n    if (typeof content !== 'string' || content.trim().length === 0) {\n        throw new ComponentArtifactError(\n            'unreadable',\n            `${label} has no inline content to render (content stored as a file is not supported by the Interactive Component channel).`\n        );\n    }\n    const parsed: unknown = SafeJSONParse(content);\n    if (!isRecord(parsed) || typeof parsed['name'] !== 'string') {\n        throw new ComponentArtifactError('not_a_component', `${label} is not an interactive component (its content is not a component specification).`);\n    }\n    const hasCode = typeof parsed['code'] === 'string' && parsed['code'].trim().length > 0;\n    const isRegistry = typeof parsed['namespace'] === 'string' && parsed['namespace'].length > 0;\n    if (!hasCode && !isRegistry) {\n        throw new ComponentArtifactError('not_a_component', `${label} is a component specification with no executable code yet, so it cannot be shown.`);\n    }\n    // The parsed value is the artifact's own ComponentSpec JSON; the fields above are the ones rendering needs.\n    return parsed as unknown as ComponentSpec;\n}\n"]}

package/dist/lib/components/realtime/interactive-component/interactive-component-channel.d.ts

@@ -0,0 +1,183 @@
+import type { Type } from '@angular/core';
+import type { JSONObject, RealtimeToolDefinition } from '@memberjunction/ai';
+import { type RealtimeChannelActor, type RealtimeChannelDescriptor } from '@memberjunction/ai-core-plus';
+import { BaseRealtimeChannelClient, type ChannelOnboardingDetails, type ParsedDelegationArtifact, type RealtimeChannelVerbResult } from '@memberjunction/realtime-runtime';
+import { ComponentInstanceEngine } from './component-instance-engine';
+import { RealtimeInteractiveComponentSurfaceComponent } from './realtime-interactive-component-surface.component';
+import { type ComponentActivity, type IComponentArtifactSource, type InteractiveComponentConfig } from './interactive-component-types';
+/**
+ * The INTERACTIVE COMPONENT channel: shows the user any interactive component artifact (a dashboard, a report, a
+ * form, a chart) next to the voice conversation, and lets the agent operate it.
+ *
+ * It is a MULTI-INSTANCE channel (several components may be open at once, each addressed by `target.instance`) and
+ * its contract is DERIVED from what it hosts: the actions an agent can take on an instance are that component's own
+ * `customMethods` and the standard methods its spec says it supports; its state is the component's data state;
+ * its events are the spec's `events`; the inputs for opening it are the spec's `properties`. A component nobody
+ * wrote channel code for is therefore operable from its spec alone. See `DeriveComponentContract`.
+ *
+ * Built-in: `open { artifactId | artifactVersionId, inputs? }` (the dispatcher's reserved action), `show_version`, `close`.
+ *
+ * ### What the model perceives
+ * Per instance: which artifact version is open, what the user last did in it (its events), and its data state,
+ * bounded to a handful of rows. All of it is gated by exposure policy (`min(channel, agent config, zero-data-retention,
+ * user)`). Pixels flow only if the host registered a frame capturer ({@link ChannelFrameCapture}).
+ * Agent-INVOKED verbs return what the component returns; exposure gates what is volunteered to the model, not what it
+ * asked for.
+ *
+ * ### Access
+ * Artifacts are loaded through the signed-in user's own session and read permission (see `RunViewComponentArtifactSource`).
+ * The agent cannot open anything the user cannot.
+ *
+ * ### Lifetime
+ * Open components are live-only: they are not persisted with the session and are not restored on resume.
+ */
+export declare class InteractiveComponentChannel extends BaseRealtimeChannelClient<RealtimeInteractiveComponentSurfaceComponent> {
+    /** The components that are open. */
+    readonly Engine: ComponentInstanceEngine;
+    /** The resolved configuration; the defaults until {@link Initialize} reads the cascade. */
+    Config: InteractiveComponentConfig;
+    /** How long a verb waits for a component to initialize; overridable so tests need not sleep. */
+    protected HandlePollIntervalMs: number;
+    /** How long after an action the data state is re-read; overridable for tests. */
+    protected DataSettleMs: number;
+    private artifactSource;
+    private surface;
+    private settleTimer;
+    get ChannelName(): string;
+    /**
+     * The id state notes carry. A multi-instance channel's snapshot describes ALL its instances (keyed by their own ids,
+     * `c1`, `c2`, ...), so the notes about the snapshot as a whole are addressed to `all` rather than to one of them.
+     */
+    get InstanceId(): string;
+    get TabTitle(): string;
+    get TabIcon(): string;
+    /** The channel has no native tools: every verb is reached through the `ContextTool` proxy, because the verbs depend on what is open. */
+    GetToolDefinitions(): RealtimeToolDefinition[];
+    /**
+     * Replaces where artifacts are loaded from (a host with its own store, or a test). Without it the channel loads
+     * through the session's provider and the signed-in user's access.
+     */
+    SetArtifactSource(source: IComponentArtifactSource | null): void;
+    /**
+     * The channel's self-description. The verbs and events are the built-ins plus those of every component that is
+     * open right now, so the contract grows as components are opened and the dispatcher validates against it.
+     */
+    GetDescriptor(): RealtimeChannelDescriptor;
+    /** The built-in verbs plus each open component's, merged by name. */
+    private collectVerbs;
+    /** The built-in events plus each open component's declared ones. */
+    private collectEvents;
+    GetOnboardingDetails(): ChannelOnboardingDetails;
+    protected OnInitialize(): void;
+    /** Opts into pixels only when the host registered something that can rasterize a component. */
+    private enableVisualPerceptionIfAvailable;
+    /**
+     * A picture of the component the user is looking at, as base64 JPEG, or `null` when there is none to send: exposure is
+     * below `pixels`, the session has no inbound video track, nothing is on screen, or the host's rasterizer produced nothing
+     * (it reports why, once, itself). Never throws.
+     *
+     * The base channel's visual pump has already checked exposure and the track before it asks; they are checked again so a
+     * frame is never rasterized (the costly part) for a model that may not see it, whoever asks.
+     */
+    protected CaptureActiveFrame(): Promise<string | null>;
+    GetSurfaceComponent(): Type<RealtimeInteractiveComponentSurfaceComponent>;
+    /** Hands the dynamically created surface the engine it renders and the hooks it reports through. */
+    BindSurface(instance: RealtimeInteractiveComponentSurfaceComponent): void;
+    UnbindSurface(): void;
+    Dispose(): void;
+    /**
+     * Open components are LIVE-ONLY: there is no state of record to persist, so nothing is saved with the session
+     * (`null`, which the host never writes) and {@link RestoreState} refuses what it is offered. A resumed session starts
+     * with no component open; the agent opens them again. What the model perceives right now is {@link GetState}.
+     */
+    SerializeState(): string | null;
+    /** Live-only: a resumed session never restores open components (see {@link SerializeState}). Always `false`. */
+    RestoreState(_stateJson: string): boolean;
+    /** The open components, keyed by instance id (see the `components` noun). A pure read. */
+    GetState(): JSONObject;
+    /** One instance as the model perceives it. */
+    private describeForState;
+    /**
+     * Loads the artifact and opens it as a new instance (or, when that artifact is already open, brings the existing
+     * instance forward and moves it to the requested version). Refusals are structured results, never exceptions.
+     */
+    protected OnOpen(inputs: JSONObject): Promise<RealtimeChannelVerbResult>;
+    /** Opens a new instance for a loaded artifact. */
+    private addInstance;
+    /** The inputs schema a freshly derived contract would have, so opening is validated before an instance exists. */
+    private inputsSchemaFor;
+    /** An artifact that is already open is not opened twice: focus it, and show the requested version. */
+    private reuseOpenInstance;
+    /** What the agent is told when it opens (or revisits) a component: how to operate it. */
+    private describeOpened;
+    /** Maps a failed artifact load to a result the model can act on. */
+    private mapLoadFailure;
+    /**
+     * Asks to be offered a delegated run's artifacts when the operator turned on auto-open, or when one of them is
+     * already open here (so a revised version replaces it). Whether an artifact is a component is only known once it
+     * is loaded, so with auto-open on the channel is mounted for any delegated artifact and ignores the ones that are not.
+     */
+    AcceptsDelegationArtifacts(artifacts: readonly ParsedDelegationArtifact[], config: JSONObject): boolean;
+    /**
+     * Takes a delegated run's artifacts: an artifact that is already open moves to its newer version (or, when the
+     * configuration says not to swap, the agent is told one exists); with auto-open on, a component that is not open is opened.
+     */
+    OnDelegationArtifacts(artifacts: readonly ParsedDelegationArtifact[]): Promise<void>;
+    /** Opens a delegated artifact; one that is not a component is ignored (expected), anything else is logged. */
+    private autoOpen;
+    /** Moves an open instance to the version a delegated run produced, when that version is newer. */
+    private takeNewerVersion;
+    /** Shows another version in an existing instance, keeping its id; tells observers, and the model when it did not ask. */
+    private swapVersion;
+    /**
+     * Runs one verb. The dispatcher has already checked the verb against the (merged) descriptor; the exact check against
+     * the addressed component's own schema happens here.
+     */
+    ApplyVerb(verb: string, args: JSONObject, actor: RealtimeChannelActor, instanceId?: string): Promise<RealtimeChannelVerbResult>;
+    /**
+     * Refuses a verb whose result carries the component's data while exposure keeps that from the agent. The dispatcher
+     * checks the same thing against the (merged) descriptor; this is the exact per-instance check, and it keeps the
+     * channel safe when it is driven by something other than the dispatcher.
+     */
+    private refuseForExposure;
+    /**
+     * Finds the instance a verb addresses: the one named, else the one the user is looking at when it supports the verb,
+     * else the only one that does. Anything else is a refusal that lists what would have worked.
+     */
+    private resolveInstance;
+    /** `c1 (Revenue), c2 (Pipeline)`. */
+    private listOpen;
+    /** `show_version`: swap an instance to another version of ITS artifact. */
+    private showVersion;
+    /** `close`. */
+    private closeInstance;
+    /** Runs a verb derived from the component's spec. */
+    private invokeDerived;
+    /** Waits (bounded) for the surface to mount the component and report it ready. */
+    private waitForHandle;
+    /** Executes a derived verb against the live component and returns what to tell the model. */
+    private runBinding;
+    /** `scroll_to`: a selector, or an offset. */
+    private scrollTo;
+    /** What happens after a verb ran: the state may have changed, and the picture may have too. */
+    private afterAction;
+    /**
+     * Called by the surface when something happens inside a rendered component: an event it emits, a state change,
+     * or the end of its initialization. Becomes a change in the state the model perceives and a typed event for observers.
+     */
+    OnComponentActivity(instanceId: string, activity: ComponentActivity): void;
+    /** The user closed a component's tab. */
+    private userClosed;
+    /**
+     * A component's data usually arrives AFTER the action that asked for it, so the state is described once more shortly
+     * afterward. One timer covers a burst.
+     */
+    private scheduleSettle;
+}
+/**
+ * Tree-shaking prevention: the channel is resolved through the ClassFactory by the registry row's `ClientPluginClass`
+ * key, so this static call keeps its `@RegisterClass` side effect from being eliminated by the bundler. Called alongside
+ * `LoadRealtimeMediaChannel()`.
+ */
+export declare function LoadRealtimeInteractiveComponentChannel(): void;
+//# sourceMappingURL=interactive-component-channel.d.ts.map

package/dist/lib/components/realtime/interactive-component/interactive-component-channel.d.ts.map

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