@jini-ai/agentic 0.1.1 → 0.3.0

package/dist/core/a2ui/interpreter.js

@@ -0,0 +1,341 @@
+/**
+ * @module interpreter
+ *
+ * The minimal A2UI client-side interpreter: client state (a component map + a JSON-Pointer-
+ * addressed data model, per surface) that processes agent→renderer messages
+ * (`createSurface -> updateComponents -> updateDataModel -> ...`) and produces renderer→agent
+ * messages (`action`/`functionResponse`/`error`) in return. This is the piece GenUI/AG-UI
+ * (`packages/agentic/src/gen-ui/`, this repo's existing, much smaller GenUI surface-request shim)
+ * has no equivalent of — AG-UI streams
+ * opaque `ui.surface_requested`/`ui.surface_responded` events with no component tree, no catalog,
+ * no data binding; A2UI's interpreter has to actually hold and mutate structured state.
+ *
+ * **Design decisions made where the spec text (fetched from
+ * https://github.com/a2ui-project/a2ui, `main` branch, this session) is silent, documented here
+ * rather than left implicit:**
+ *
+ * 1. **Per-component, not per-message, validation granularity.** `updateComponents`'s own spec
+ *    text says forward-referenced children/bindings should be handled gracefully — the spirit of
+ *    that is "don't be brittle about partial/out-of-order information." This interpreter extends
+ *    that spirit to catalog violations: one bad component in a 5-component `updateComponents`
+ *    message produces one `VALIDATION_FAILED` error for that component and is skipped, while the
+ *    other 4 valid components are still applied. The alternative (reject the whole message
+ *    atomically) was considered and rejected as more brittle than the spec's own examples call for,
+ *    not as spec-mandated either way.
+ * 2. **`callFunction`/`actionResponse` are not surface-scoped on the wire** (verified directly
+ *    against the fetched JSON Schemas — neither message type has a `surfaceId` field). Functions
+ *    are catalog-global (one active catalog per interpreter instance); `actionResponse` is
+ *    correlated by `actionId` searched across every open surface's own pending-action table.
+ * 3. **`callFunction`'s `args` may contain `DataBinding` paths** (`FunctionCall.args` is typed
+ *    against `DynamicValue` in `common_types.json`, which includes `DataBinding`) **but
+ *    `callFunction` has no data model to bind against** (see point 2) — a real spec ambiguity, not
+ *    an oversight in this port. Resolved pragmatically: such args resolve against an empty/absent
+ *    data model, so any `DataBinding`-typed arg simply fails to resolve (`PATH_NOT_FOUND`,
+ *    degrading sanely per `resolve.ts`'s contract) rather than crashing or guessing which surface's
+ *    data model was "meant."
+ * 4. **An envelope malformed enough to have no attributable `surfaceId`/`functionCallId` at all**
+ *    (missing `version`, no/ambiguous message-type key) cannot be turned into a spec-shaped
+ *    `error` message — `renderer_to_agent.json`'s own generic-error schema *requires* one of those
+ *    two identifiers. Rather than fabricate one, `applyAgentMessage` surfaces this case out-of-band
+ *    via `unattributedViolation` (a string, not sent over the wire) instead of forcing a fake
+ *    identifier into a wire-conformant shape.
+ */
+import { AGENT_TO_RENDERER_MESSAGE_KEYS, parseAgentToRendererMessage } from './agent-to-renderer.js';
+import { WireComponentSchema } from './agent-to-renderer.js';
+import { buildActionMessage, buildFunctionResponseMessage, buildGenericErrorMessage, buildValidationFailedMessage, } from './renderer-to-agent.js';
+import { setAtPointer } from './json-pointer.js';
+import { isComponentAllowed } from './catalog.js';
+import { resolveDynamicValue } from './resolve.js';
+import { isLocalFunctionAction, } from './common-types.js';
+let actionIdCounter = 0;
+function nextActionId() {
+    actionIdCounter += 1;
+    return `a2ui-action-${actionIdCounter}-${Date.now().toString(36)}`;
+}
+/**
+ * Best-effort `surfaceId` extraction from a raw envelope's message-type-keyed body, without
+ * assuming the envelope is well-formed. Used only to attribute a parse failure to a surface when
+ * possible (see `buildParseFailureResult`); never trusted for anything else.
+ */
+function bestEffortSurfaceId(raw, key) {
+    if (typeof raw !== 'object' || raw === null)
+        return undefined;
+    const body = raw[key];
+    if (typeof body !== 'object' || body === null)
+        return undefined;
+    const surfaceId = body.surfaceId;
+    return typeof surfaceId === 'string' ? surfaceId : undefined;
+}
+/**
+ * Turns a `ParseFailure` (from `parseAgentToRendererMessage`) into what `applyAgentMessage`
+ * returns for it. See this module's doc, decision 4: an envelope malformed enough to carry no
+ * attributable `surfaceId`/`functionCallId` cannot be turned into a spec-shaped `error` message —
+ * `renderer_to_agent.json`'s own generic-error schema *requires* one of those two identifiers —
+ * so it surfaces out-of-band via `unattributedViolation` (a string, not sent over the wire)
+ * instead of forcing a fake identifier into a wire-conformant shape.
+ *
+ * Exported and pure — it only reads `parsed`/`raw`, so the surfaceId-attribution rule can be
+ * tested directly, without a live interpreter instance.
+ */
+export function buildParseFailureResult(parsed, raw) {
+    if (parsed.code === 'MISSING_VERSION'
+        || parsed.code === 'UNSUPPORTED_VERSION'
+        || parsed.code === 'NO_MESSAGE_KEY'
+        || parsed.code === 'AMBIGUOUS_MESSAGE') {
+        return { rendererMessages: [], unattributedViolation: parsed.message };
+    }
+    // VALIDATION_FAILED from the dispatcher: either `raw` wasn't even an object (`bestEffortSurfaceId`
+    // safely returns `undefined` for that, same as every other shape it doesn't recognize — no
+    // separate guard needed here), or exactly one of the six known message-type keys was present
+    // and its body failed schema validation. Checked against the *known* keys specifically
+    // (`AGENT_TO_RENDERER_MESSAGE_KEYS`), not "whatever the first non-version object key happens to
+    // be" — an envelope could carry unrelated extra top-level junk ahead of the real message key in
+    // insertion order, and grabbing that first would attribute the error to the wrong place. Best-
+    // effort surfaceId extraction so this can still be a spec-shaped error where possible
+    // (createSurface/updateComponents/updateDataModel/deleteSurface all carry surfaceId at the top
+    // of their body even when some other field is what actually failed validation); callFunction/
+    // actionResponse have no surfaceId at all, so those fall back to the out-of-band channel too.
+    const surfaceId = AGENT_TO_RENDERER_MESSAGE_KEYS.map((key) => bestEffortSurfaceId(raw, key)).find((id) => id !== undefined);
+    if (surfaceId) {
+        // `parsed.path` is guaranteed set here: `ParseFailure.path` is only ever omitted for the
+        // "raw input wasn't even an object" case (`agent-to-renderer.ts`'s very first guard), and
+        // `surfaceId` above could only have resolved to a truthy value if `raw` *was* an object
+        // (`bestEffortSurfaceId` requires that) — so this specific combination (object-shaped raw,
+        // yet no `path`) cannot occur. Asserted, not defensively branched, per this package's
+        // testing discipline (see the zod-issues-array comments elsewhere in this file).
+        return { rendererMessages: [buildValidationFailedMessage(surfaceId, parsed.path, parsed.message)] };
+    }
+    return { rendererMessages: [], unattributedViolation: parsed.message };
+}
+/**
+ * Runs a component's local `functionCall` action synchronously against `dataModel` — no network
+ * round trip, no pending-action bookkeeping (that only applies to the agent-event branch; see
+ * `interpreter`'s `buildAction`/`buildAgentEventAction`).
+ *
+ * Exported and pure given its inputs, so "a local action resolves against the surface's actual
+ * data model, and a resolution failure becomes a typed refusal rather than a thrown error" can be
+ * tested without a live interpreter instance.
+ */
+export function runLocalFunctionAction(dataModel, catalog, action) {
+    const result = resolveDynamicValue(action.functionCall, { dataModel, catalog, side: 'renderer' });
+    return result.ok ? { ok: true, kind: 'local', result: result.value } : { ok: false, reason: result.detail };
+}
+export function createA2uiInterpreter(catalog) {
+    const surfaces = new Map();
+    const listeners = new Set();
+    function notify() {
+        for (const listener of listeners)
+            listener();
+    }
+    function applyComponentsList(surface, wireComponents) {
+        const errors = [];
+        wireComponents.forEach((wireComponent, index) => {
+            const { id, component: type, ...rest } = wireComponent;
+            if (!isComponentAllowed(catalog, type)) {
+                errors.push(buildValidationFailedMessage(surface.surfaceId, `/components/${index}/component`, `Component type "${type}" is not in catalog "${catalog.catalogId}" — refused, not rendered.`));
+                return;
+            }
+            const spec = catalog.components.get(type);
+            const parsed = spec.propsSchema.safeParse(rest);
+            if (!parsed.success) {
+                // zod guarantees a non-empty `issues` array on failure — see agent-to-renderer.ts's
+                // parseAgentToRendererMessage for the same asserted (not defensively branched) invariant.
+                const issue = parsed.error.issues[0];
+                // `issue.message` alone ("Required") names no field — Zod puts the field on `issue.path`
+                // instead, so it has to be spliced back in here or the only place a human sees this (this
+                // string, not the sibling `path` pointer on the built message) never says which prop.
+                const field = issue.path.length > 0 ? issue.path.join('.') : '(root)';
+                errors.push(buildValidationFailedMessage(surface.surfaceId, `/components/${index}/${issue.path.join('/')}`, `Component "${id}" (${type}) failed catalog validation: ${field}: ${issue.message}`));
+                return;
+            }
+            surface.components.set(id, { id, component: type, props: parsed.data });
+        });
+        return errors;
+    }
+    function handleCreateSurface(message) {
+        const { surfaceId, catalogId, components, dataModel } = message.createSurface;
+        if (catalogId !== catalog.catalogId) {
+            return [buildValidationFailedMessage(surfaceId, '/createSurface/catalogId', `Unknown catalogId "${catalogId}" — this renderer only has "${catalog.catalogId}" loaded.`)];
+        }
+        if (surfaces.has(surfaceId)) {
+            return [buildValidationFailedMessage(surfaceId, '/createSurface/surfaceId', `Surface "${surfaceId}" already exists — delete it before recreating (per spec).`)];
+        }
+        const surface = {
+            surfaceId,
+            catalogId,
+            components: new Map(),
+            dataModel: dataModel ?? {},
+            sendDataModel: message.createSurface.sendDataModel ?? false,
+            pendingActions: new Map(),
+        };
+        surfaces.set(surfaceId, surface);
+        return components ? applyComponentsList(surface, components) : [];
+    }
+    function handleUpdateComponents(message) {
+        const { surfaceId, components } = message.updateComponents;
+        const surface = surfaces.get(surfaceId);
+        if (!surface) {
+            return [buildValidationFailedMessage(surfaceId, '/updateComponents/surfaceId', `Unknown surfaceId "${surfaceId}" — createSurface must be sent first.`)];
+        }
+        return applyComponentsList(surface, components);
+    }
+    function handleUpdateDataModel(message) {
+        const { surfaceId, path, value } = message.updateDataModel;
+        const surface = surfaces.get(surfaceId);
+        if (!surface) {
+            return [buildValidationFailedMessage(surfaceId, '/updateDataModel/surfaceId', `Unknown surfaceId "${surfaceId}" — createSurface must be sent first.`)];
+        }
+        surface.dataModel = setAtPointer(surface.dataModel, path ?? '/', value);
+        return [];
+    }
+    function handleDeleteSurface(message) {
+        const { surfaceId } = message.deleteSurface;
+        if (!surfaces.has(surfaceId)) {
+            return [buildValidationFailedMessage(surfaceId, '/deleteSurface/surfaceId', `Unknown surfaceId "${surfaceId}" — nothing to delete.`)];
+        }
+        // Dropping the whole SurfaceState also drops its pendingActions map — any actionResponse that
+        // arrives afterward for an actionId that lived here simply won't be found (handled gracefully
+        // in handleActionResponse below), which is exactly the "deleteSurface mid-flight" adversarial
+        // case this is designed to answer.
+        surfaces.delete(surfaceId);
+        return [];
+    }
+    function handleCallFunction(message) {
+        const { functionCallId, callFunction, wantResponse } = message;
+        const result = resolveDynamicValue(callFunction, { dataModel: undefined, catalog, side: 'agent' });
+        if (!result.ok) {
+            const code = result.reason === 'FUNCTION_NOT_CALLABLE_FROM_SIDE' || result.reason === 'FUNCTION_NOT_REGISTERED' ? 'INVALID_FUNCTION_CALL' : result.reason;
+            return [buildGenericErrorMessage(code, result.detail, { functionCallId })];
+        }
+        if (!wantResponse)
+            return [];
+        // `?? null` because `functionResponse.value` is required on the wire and JSON has no
+        // `undefined`: a `returnType: 'void'` function (the catalog has three) resolves to
+        // `undefined`, and passing that straight through built a message whose `value` vanished on
+        // serialization — one this package's own `parseRendererToAgentMessage` correctly refuses.
+        return [buildFunctionResponseMessage({ functionCallId, call: callFunction.call, value: result.value ?? null })];
+    }
+    function handleActionResponse(message) {
+        const { actionId, actionResponse } = message;
+        for (const surface of surfaces.values()) {
+            const pending = surface.pendingActions.get(actionId);
+            if (!pending)
+                continue;
+            surface.pendingActions.delete(actionId);
+            if ('value' in actionResponse && pending.responsePath) {
+                surface.dataModel = setAtPointer(surface.dataModel, pending.responsePath, actionResponse.value);
+            }
+            return [];
+        }
+        // No surface has a pending action under this id — already resolved, never existed, or its
+        // surface was deleted while the action was in flight. Graceful no-op, not an error: the agent
+        // sent a well-formed message, it just arrived too late (or was mistaken) to mean anything now.
+        return [];
+    }
+    /** Routes one successfully-parsed envelope to its message-type handler. */
+    function dispatchAgentMessage(message) {
+        if ('createSurface' in message)
+            return handleCreateSurface(message);
+        if ('updateComponents' in message)
+            return handleUpdateComponents(message);
+        if ('updateDataModel' in message)
+            return handleUpdateDataModel(message);
+        if ('deleteSurface' in message)
+            return handleDeleteSurface(message);
+        if ('callFunction' in message)
+            return handleCallFunction(message);
+        return handleActionResponse(message);
+    }
+    function applyAgentMessage(raw) {
+        const parsed = parseAgentToRendererMessage(raw);
+        if (!parsed.ok)
+            return buildParseFailureResult(parsed, raw);
+        const rendererMessages = dispatchAgentMessage(parsed.message);
+        notify();
+        return { rendererMessages };
+    }
+    function getSurface(surfaceId) {
+        const surface = surfaces.get(surfaceId);
+        if (!surface)
+            return undefined;
+        return { surfaceId: surface.surfaceId, catalogId: surface.catalogId, components: surface.components, dataModel: surface.dataModel };
+    }
+    function getRoot(surfaceId) {
+        return surfaces.get(surfaceId)?.components.get('root');
+    }
+    function resolve(surfaceId, value, itemBasePath, itemIndex) {
+        const surface = surfaces.get(surfaceId);
+        const itemScope = itemBasePath !== undefined && itemIndex !== undefined ? { basePath: itemBasePath, index: itemIndex } : undefined;
+        return resolveDynamicValue(value, { dataModel: surface?.dataModel, catalog, side: 'renderer', ...(itemScope ? { itemScope } : {}) });
+    }
+    function resolveActionContext(context, surfaceId) {
+        const resolved = {};
+        for (const [key, value] of Object.entries(context ?? {})) {
+            const result = resolve(surfaceId, value);
+            resolved[key] = result.ok ? result.value : null;
+        }
+        return resolved;
+    }
+    /** Looks up the surface, component, and `action` prop `buildAction` needs, or the specific reason it can't. */
+    function resolveActionTarget(surfaceId, componentId) {
+        const surface = surfaces.get(surfaceId);
+        if (!surface)
+            return { ok: false, reason: `unknown surfaceId "${surfaceId}"` };
+        const component = surface.components.get(componentId);
+        if (!component)
+            return { ok: false, reason: `unknown componentId "${componentId}" on surface "${surfaceId}"` };
+        const action = component.props.action;
+        if (!action)
+            return { ok: false, reason: `component "${componentId}" has no action` };
+        return { ok: true, surface, action };
+    }
+    /** Builds the `action` wire envelope for an agent-event action, registering a pending response if `wantResponse` was set. */
+    function buildAgentEventAction(surface, surfaceId, componentId, event, now) {
+        const { name, context, wantResponse, responsePath } = event;
+        const actionId = wantResponse ? nextActionId() : undefined;
+        if (actionId) {
+            surface.pendingActions.set(actionId, { name, sourceComponentId: componentId, responsePath });
+        }
+        const payload = {
+            name,
+            surfaceId,
+            sourceComponentId: componentId,
+            timestamp: new Date(now()).toISOString(),
+            context: resolveActionContext(context, surfaceId),
+            ...(wantResponse !== undefined ? { wantResponse } : {}),
+            ...(actionId !== undefined ? { actionId } : {}),
+        };
+        return { ok: true, kind: 'agent', message: buildActionMessage(payload) };
+    }
+    function buildAction(surfaceId, componentId, now = Date.now) {
+        const target = resolveActionTarget(surfaceId, componentId);
+        if (!target.ok)
+            return target;
+        const { surface, action } = target;
+        if (isLocalFunctionAction(action)) {
+            return runLocalFunctionAction(surface.dataModel, catalog, action);
+        }
+        // `ActionSchema` (validated when this component's props were ingested — see
+        // `applyComponentsList`) is a closed 2-branch union: `{event}` | `{functionCall}`. Having
+        // already eliminated the `functionCall` branch above, TypeScript itself narrows `action` to
+        // the `event` branch here — no runtime `isAgentEventAction` re-check is reachable to fail; a
+        // malformed third shape could never have made it into `component.props.action` in the first
+        // place. (Not defensively branched-and-left-untested, per this package's own testing
+        // discipline — see the zod-issues-array comments above for the same principle.)
+        return buildAgentEventAction(surface, surfaceId, componentId, action.event, now);
+    }
+    return {
+        applyAgentMessage,
+        getSurface,
+        listSurfaceIds: () => [...surfaces.keys()],
+        getRoot,
+        buildAction,
+        resolve,
+        subscribe: (listener) => {
+            listeners.add(listener);
+            return () => listeners.delete(listener);
+        },
+    };
+}
+export { WireComponentSchema };
+//# sourceMappingURL=interpreter.js.map

package/dist/core/a2ui/interpreter.js.map

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

package/dist/core/a2ui/json-pointer.d.ts

@@ -0,0 +1,48 @@
+/**
+ * @module json-pointer
+ *
+ * A minimal RFC 6901 (JSON Pointer) implementation for A2UI's data-model bindings
+ * (`common_types.json#/$defs/DataBinding`: `{"path": "/user/name"}`). Deliberately small — no
+ * external dependency pulled in for this; the operations A2UI actually needs (root-scope read,
+ * collection-scope relative read via string concatenation, write-with-null-deletes) are a thin
+ * slice of the full RFC.
+ *
+ * One documented, deliberate deviation from strict RFC 6901: `updateDataModel`'s own spec text
+ * (`agent_to_renderer.json`, `UpdateDataModelMessage.path`'s description, fetched verbatim) says
+ * "An optional path to a location within the data model (e.g., '/user/name'). If omitted, or set
+ * to '/', refers to the entire data model." Under strict RFC 6901, `""` (empty string) is the
+ * pointer to the whole document and `"/"` is the pointer to the property keyed by the empty
+ * string on the root object — two different things. A2UI's own spec text explicitly overloads
+ * `"/"` to mean "the whole document," not "the empty-string-keyed property." This module follows
+ * A2UI's own wording exactly (not raw RFC 6901) since that is what a conformant renderer must do;
+ * flagged here rather than silently treated as an oversight.
+ */
+export interface PointerGetResult {
+    readonly found: boolean;
+    readonly value: unknown;
+}
+/** Splits a non-root pointer into its unescaped reference tokens. `pointer` must start with `/`. */
+export declare function parsePointerTokens(pointer: string): string[];
+export declare function joinPointer(base: string, ...tokens: string[]): string;
+/** Reads the value at `pointer` in `doc`. Never throws on a non-resolving path — `found: false` degrades sanely, matching this port's "a bad binding must not crash the renderer" adversarial requirement (see `resolve.ts`). */
+export declare function getAtPointer(doc: unknown, pointer: string): PointerGetResult;
+/**
+ * Writes `value` at `pointer` in `doc`, returning a **new** document (the original is never
+ * mutated — every intermediate object on the path is shallow-copied). Missing intermediate
+ * segments are created as plain objects (this port does not attempt array-vs-object inference for
+ * not-yet-existing intermediate segments — a documented simplification, not a spec requirement).
+ * `value === null` at a non-root pointer deletes the key/value at that location, per
+ * `updateDataModel`'s own spec text ("To delete the key/value at path, set value explicitly to
+ * null."). At the root pointer, `value === null` replaces the entire data model with `null` (there
+ * is no "key" to delete at the root; documented as this port's own consistent interpretation).
+ *
+ * Never throws on a malformed pointer (e.g. missing leading `/`) — degrades to a no-op (`doc`
+ * returned unchanged), matching `getAtPointer`'s "a bad binding must not crash the renderer"
+ * contract. `updateDataModel`'s `path` is agent-authored wire data; an uncaught throw here had no
+ * error boundary above it anywhere in `packages/chat-react` or its hosts to stop it from
+ * unmounting the whole chat React root (see `ExtEventErrorBoundary`, added as a systemic backstop
+ * for the same class of bug — this is the specific root cause it would otherwise have had to
+ * catch).
+ */
+export declare function setAtPointer(doc: unknown, pointer: string, value: unknown): unknown;
+//# sourceMappingURL=json-pointer.d.ts.map

package/dist/core/a2ui/json-pointer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-pointer.d.ts","sourceRoot":"","sources":["../../../src/core/a2ui/json-pointer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB;AA4CD,oGAAoG;AACpG,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAM5D;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAGrE;AAED,iOAAiO;AACjO,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,gBAAgB,CA4B5E;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAkDnF"}

package/dist/core/a2ui/json-pointer.js

@@ -0,0 +1,174 @@
+/**
+ * @module json-pointer
+ *
+ * A minimal RFC 6901 (JSON Pointer) implementation for A2UI's data-model bindings
+ * (`common_types.json#/$defs/DataBinding`: `{"path": "/user/name"}`). Deliberately small — no
+ * external dependency pulled in for this; the operations A2UI actually needs (root-scope read,
+ * collection-scope relative read via string concatenation, write-with-null-deletes) are a thin
+ * slice of the full RFC.
+ *
+ * One documented, deliberate deviation from strict RFC 6901: `updateDataModel`'s own spec text
+ * (`agent_to_renderer.json`, `UpdateDataModelMessage.path`'s description, fetched verbatim) says
+ * "An optional path to a location within the data model (e.g., '/user/name'). If omitted, or set
+ * to '/', refers to the entire data model." Under strict RFC 6901, `""` (empty string) is the
+ * pointer to the whole document and `"/"` is the pointer to the property keyed by the empty
+ * string on the root object — two different things. A2UI's own spec text explicitly overloads
+ * `"/"` to mean "the whole document," not "the empty-string-keyed property." This module follows
+ * A2UI's own wording exactly (not raw RFC 6901) since that is what a conformant renderer must do;
+ * flagged here rather than silently treated as an oversight.
+ */
+/**
+ * Whether `record` itself carries `token` — never whether it *inherits* it.
+ *
+ * A JSON Pointer addresses a member of a JSON document, and a JSON document has no inherited
+ * members. The `token in record` form this replaced answered `true` for everything
+ * `Object.prototype` contributes, so `getAtPointer({}, "/constructor")` resolved the `Object`
+ * constructor as though the agent's data model contained it.
+ */
+function hasOwnToken(record, token) {
+    return Object.prototype.hasOwnProperty.call(record, token);
+}
+/**
+ * Writes one own, plain data property — never through an inherited accessor.
+ *
+ * `record[token] = value` looks like it defines a key, and does for every token but one:
+ * `__proto__` is an inherited accessor on `Object.prototype`, so assigning to it *sets the
+ * object's prototype* instead. An agent sending `{"path": "/__proto__", "value": {...}}` therefore
+ * reshaped the object this function was building rather than putting a key in it. (Narrower than
+ * classic prototype pollution — the shallow-copy discipline here means only the one returned
+ * object was affected, never the global `Object.prototype` — but a pointer must address the
+ * document, so this defines the key RFC 6901 actually named.)
+ */
+function defineOwn(record, token, value) {
+    Object.defineProperty(record, token, { value, writable: true, enumerable: true, configurable: true });
+}
+/** `true` for the two spellings A2UI's own spec treats as "the whole document" (see module doc). Anything else is parsed as a normal RFC 6901 pointer. */
+function isRootPointer(pointer) {
+    return pointer === '' || pointer === '/';
+}
+function unescapeToken(token) {
+    // RFC 6901 §4: ~1 must be decoded *before* ~0 is checked (a literal '~' that was itself part of
+    // an escaped '/' must not be re-decoded as '~0').
+    return token.replaceAll('~1', '/').replaceAll('~0', '~');
+}
+function escapeToken(token) {
+    return token.replaceAll('~', '~0').replaceAll('/', '~1');
+}
+/** Splits a non-root pointer into its unescaped reference tokens. `pointer` must start with `/`. */
+export function parsePointerTokens(pointer) {
+    if (pointer === '')
+        return [];
+    if (!pointer.startsWith('/')) {
+        throw new Error(`invalid JSON Pointer (must start with "/"): ${JSON.stringify(pointer)}`);
+    }
+    return pointer.slice(1).split('/').map(unescapeToken);
+}
+export function joinPointer(base, ...tokens) {
+    const baseTokens = base === '' || base === '/' ? [] : parsePointerTokens(base);
+    return '/' + [...baseTokens, ...tokens].map(escapeToken).join('/');
+}
+/** Reads the value at `pointer` in `doc`. Never throws on a non-resolving path — `found: false` degrades sanely, matching this port's "a bad binding must not crash the renderer" adversarial requirement (see `resolve.ts`). */
+export function getAtPointer(doc, pointer) {
+    if (isRootPointer(pointer))
+        return { found: true, value: doc };
+    let tokens;
+    try {
+        tokens = parsePointerTokens(pointer);
+    }
+    catch {
+        return { found: false, value: undefined };
+    }
+    let current = doc;
+    for (const token of tokens) {
+        if (Array.isArray(current)) {
+            if (!/^(0|[1-9]\d*)$/.test(token))
+                return { found: false, value: undefined };
+            const index = Number(token);
+            if (index >= current.length)
+                return { found: false, value: undefined };
+            current = current[index];
+            continue;
+        }
+        if (current !== null && typeof current === 'object') {
+            const record = current;
+            if (!hasOwnToken(record, token))
+                return { found: false, value: undefined };
+            current = record[token];
+            continue;
+        }
+        return { found: false, value: undefined };
+    }
+    return { found: true, value: current };
+}
+/**
+ * Writes `value` at `pointer` in `doc`, returning a **new** document (the original is never
+ * mutated — every intermediate object on the path is shallow-copied). Missing intermediate
+ * segments are created as plain objects (this port does not attempt array-vs-object inference for
+ * not-yet-existing intermediate segments — a documented simplification, not a spec requirement).
+ * `value === null` at a non-root pointer deletes the key/value at that location, per
+ * `updateDataModel`'s own spec text ("To delete the key/value at path, set value explicitly to
+ * null."). At the root pointer, `value === null` replaces the entire data model with `null` (there
+ * is no "key" to delete at the root; documented as this port's own consistent interpretation).
+ *
+ * Never throws on a malformed pointer (e.g. missing leading `/`) — degrades to a no-op (`doc`
+ * returned unchanged), matching `getAtPointer`'s "a bad binding must not crash the renderer"
+ * contract. `updateDataModel`'s `path` is agent-authored wire data; an uncaught throw here had no
+ * error boundary above it anywhere in `packages/chat-react` or its hosts to stop it from
+ * unmounting the whole chat React root (see `ExtEventErrorBoundary`, added as a systemic backstop
+ * for the same class of bug — this is the specific root cause it would otherwise have had to
+ * catch).
+ */
+export function setAtPointer(doc, pointer, value) {
+    if (isRootPointer(pointer))
+        return value;
+    let tokens;
+    try {
+        tokens = parsePointerTokens(pointer);
+    }
+    catch {
+        return doc;
+    }
+    const parentTokens = tokens.slice(0, -1);
+    const lastToken = tokens[tokens.length - 1];
+    function recurse(current, remaining) {
+        if (remaining.length === 0) {
+            // `current` here is the parent container; apply the final write/delete.
+            if (Array.isArray(current)) {
+                if (!/^(0|[1-9]\d*)$/.test(lastToken))
+                    return current;
+                const index = Number(lastToken);
+                const next = current.slice();
+                if (value === null) {
+                    if (index < next.length)
+                        next.splice(index, 1);
+                    return next;
+                }
+                next[index] = value;
+                return next;
+            }
+            const record = current !== null && typeof current === 'object' ? { ...current } : {};
+            if (value === null) {
+                delete record[lastToken];
+                return record;
+            }
+            defineOwn(record, lastToken, value);
+            return record;
+        }
+        const [head, ...rest] = remaining;
+        if (Array.isArray(current)) {
+            if (!head || !/^(0|[1-9]\d*)$/.test(head))
+                return current;
+            const index = Number(head);
+            const next = current.slice();
+            next[index] = recurse(index < next.length ? next[index] : {}, rest);
+            return next;
+        }
+        const record = current !== null && typeof current === 'object' ? { ...current } : {};
+        if (!head)
+            return record;
+        defineOwn(record, head, recurse(hasOwnToken(record, head) ? record[head] : {}, rest));
+        return record;
+    }
+    return recurse(doc, parentTokens);
+}
+//# sourceMappingURL=json-pointer.js.map

package/dist/core/a2ui/json-pointer.js.map

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