agentfootprint 10.3.1 → 10.4.0

package/dist/types/ag-ui/ids.d.ts

@@ -0,0 +1,44 @@
+/**
+ * ids — every id the AG-UI adapter mints, from ONE grammar.
+ *
+ *   <run>/<kind>/<n>/<address>
+ *
+ *   run      the AG-UI `runId`, through `encodeIdentityField` — `%` and `/`
+ *            escaped, so it holds no `/`;
+ *   kind     one of {@link AgUiIdKind} — no `/`;
+ *   n        a decimal ordinal — no `/`;
+ *   address  the agentfootprint `runtimeStageId` of the event that opened the
+ *            entity (`call-llm#18`, `step-p/x/tool-calls#97`) — any string.
+ *
+ * INJECTIVE by construction: the first three `/` end the three segments that
+ * cannot hold one, so two different (run, kind, n, address) tuples never spell
+ * the same id. `test/ag-ui/ids.test.ts` pins it with a property test.
+ *
+ * WHY THE ADDRESS, NOT THE PROVIDER'S ID. A model's tool-call id is not unique
+ * in a run: a provider may reuse it across iterations, and two parallel branches
+ * routinely mint the same one (`call_1`, `c1`). An AG-UI client finds a tool
+ * call by its id across the WHOLE conversation, so a reused id would land a new
+ * call's arguments on an old message. And under a redaction policy the record
+ * serves every id as the placeholder. The address — the stage execution that
+ * produced the entity, unique within a run — is unique, survives redaction (it
+ * is the record's own key, never a value a policy selects) and lines up with the
+ * recording; the run segment makes it unique across the thread. The provider's
+ * id, as the record serves it, rides `metadata.agentfootprint.toolCallId`.
+ */
+/** The kinds of entity the adapter mints ids for. */
+export type AgUiIdKind = 'text' | 'reasoning' | 'tool' | 'result' | 'agent' | 'interrupt';
+/** One run's minter: ordinals counted per (kind, address), ids spelled by {@link agUiId}. */
+export interface AgUiIdMinter {
+    /** The next id of `kind` at `address` — `n` counts up from 0 per (kind, address). */
+    next(kind: AgUiIdKind, address: string): {
+        readonly id: string;
+        readonly n: number;
+    };
+    /** The id of `kind` at `address` with a KNOWN ordinal — a tool result reuses its call's. */
+    at(kind: AgUiIdKind, n: number, address: string): string;
+}
+/** Spell one id. Exported for the property test; the minter is the only caller. */
+export declare function agUiId(runId: string, kind: AgUiIdKind, n: number, address: string): string;
+/** A minter for the AG-UI run `runId`. Refuses an empty run id: it would mint `_` ids. */
+export declare function agUiIdMinter(runId: string): AgUiIdMinter;
+//# sourceMappingURL=ids.d.ts.map

package/dist/types/ag-ui/ids.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.d.ts","sourceRoot":"","sources":["../../../src/ag-ui/ids.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAIH,qDAAqD;AACrD,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,WAAW,CAAC;AAE1F,6FAA6F;AAC7F,MAAM,WAAW,YAAY;IAC3B,qFAAqF;IACrF,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,GAAG;QAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACrF,4FAA4F;IAC5F,EAAE,CAAC,IAAI,EAAE,UAAU,EAAE,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;CAC1D;AAED,mFAAmF;AACnF,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAE1F;AAED,0FAA0F;AAC1F,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,CAgBxD"}

package/dist/types/ag-ui/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * ag-ui — the AG-UI protocol adapter over agentfootprint's event stream.
+ *
+ * `agUi()` is the adapter a host takes (`streamHandler` on
+ * `agentfootprint/hosting`): it reads an untrusted `RunAgentInput`, plans the
+ * turn against what the server holds, and translates the run.
+ * `agUiSerializer` turns one run's served events into AG-UI events; `agUiSse`
+ * frames them for the wire with the official `@ag-ui/encoder`. Published
+ * through the `agentfootprint/ag-ui` door. The fixed sentences and the id
+ * grammar stay internal — tests import them by module path.
+ */
+export { agUiSerializer, AG_UI_CUSTOM_EVENTS, type AgUiCustomContext, type AgUiCustomProjection, type AgUiSerializerOptions, type AgUiTranslation, } from './serializer.js';
+export { agUiSse, type AgUiEncoderModule, type AgUiSseOptions } from './framing.js';
+export { agUi, type AgUiOptions } from './adapter.js';
+export type { AgUiFrontendTool } from './frontendTools.js';
+export { AG_UI_MAX_ID_LENGTH, readAgUiRunInput, type AgUiValidator } from './request.js';
+export { AG_UI_PROTOCOL_VERSION, type AgUiAddress, type AgUiEvent, type AgUiEventType, type AgUiInterrupt, type AgUiMessage, type AgUiMetadata, type AgUiResumeEntry, type AgUiRunInput, type AgUiRunOutcome, type AgUiSuspendedCall, type AgUiSuspendedScope, type AgUiSuspension, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/ag-ui/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ag-ui/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,KAAK,eAAe,GACrB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,OAAO,EAAE,KAAK,iBAAiB,EAAE,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AACpF,OAAO,EAAE,IAAI,EAAE,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AACtD,YAAY,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AACzF,OAAO,EACL,sBAAsB,EACtB,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,cAAc,GACpB,MAAM,YAAY,CAAC"}

package/dist/types/ag-ui/request.d.ts

@@ -0,0 +1,73 @@
+/**
+ * request — an AG-UI request (`RunAgentInput`) read as UNTRUSTED browser input,
+ * and the one turn it may ask for.
+ *
+ * Two steps, each refusing by NAME (a `WireRequestRefusal`: its own status and
+ * code; the field named, the value never quoted back):
+ *
+ *   readAgUiRunInput   the body's SHAPE, field by field, and the ids' FORMAT
+ *                      and length — nothing here is trusted, nothing the
+ *                      server holds is read;
+ *   planAgUiTurn       the turn, from the request AND what the server holds
+ *                      for the bound conversation.
+ *
+ * WHAT A REQUEST MAY DECIDE, and what it may not:
+ *   - the newest USER message is the run's message. Nothing else the browser
+ *     sends is ever conversation: its assistant and tool messages are its own
+ *     copy of what the server said, and the server's copy is the one kept
+ *     (`sessions`, or the agent's memory under the bound session). A system or
+ *     developer message is refused — the agent's instructions are its own;
+ *   - an ANSWER is taken only for the pause the server is keeping, matched to
+ *     the ids that pause handed out (`AgUiSuspension`): a resume entry naming
+ *     its interrupt, or the tool message answering the frontend tool call it is
+ *     waiting on. Any other tool result is refused — never folded in;
+ *   - a frontend tool runs only when the app allow-listed its NAME — with the
+ *     app's own description and schema, never the page's (a description the
+ *     model reads is an instruction) — and only on a host that keeps the paused
+ *     run until the page answers;
+ *   - `state` and `context` reach the agent only through the app's validators;
+ *     without one, a request carrying either is refused;
+ *   - identity, credentials and redaction never come from a request: the host
+ *     binds the thread to the caller the app authenticates (`ThreadBinder`).
+ * `forwardedProps` is never read.
+ */
+import type { HeldConversation, PlanFacts, ProtocolPlan, ThreadBinding } from '../hosting/protocolAdapter.js';
+import type { Tool } from '../tools/tools.js';
+import type { AgUiRunInput, AgUiSuspension } from './types.js';
+/** The longest thread or run id read — longer is refused, never truncated. */
+export declare const AG_UI_MAX_ID_LENGTH = 128;
+/**
+ * Read one AG-UI request body — its shape and its ids — refusing what the
+ * protocol does not allow by the field's NAME, never by its value.
+ *
+ * @throws WireRequestRefusal (400, `ERR_INVALID_RUN_INPUT`)
+ */
+export declare function readAgUiRunInput(body: unknown): AgUiRunInput;
+/** What a page's `state` or `context` is checked by before the agent may see it. */
+export type AgUiValidator = (value: unknown, at: {
+    /** The conversation the request was bound to — whose state this claims to be. */
+    readonly thread?: ThreadBinding;
+    readonly headers: Readonly<Record<string, string>>;
+}) => unknown;
+/** The rules one adapter plans by — built from `agUi()`'s options. */
+export interface AgUiTurnRules {
+    /** The frontend tools the app allow-listed, by name: each builds the tool the agent is given. */
+    readonly frontendTools: ReadonlyMap<string, () => Tool>;
+    readonly accept: {
+        readonly state?: AgUiValidator;
+        readonly context?: AgUiValidator;
+    };
+}
+/**
+ * Plan one turn: the request (read by {@link readAgUiRunInput}) against what
+ * the server holds for its bound conversation.
+ *
+ * @throws WireRequestRefusal — by name, for everything a page may not decide.
+ */
+export declare function planAgUiTurn(input: AgUiRunInput, held: HeldConversation, facts: PlanFacts, rules: AgUiTurnRules): ProtocolPlan;
+/**
+ * A stored suspension record, checked — the store holds bytes; a record that
+ * is not one this adapter wrote is `undefined`, and nothing is matched to it.
+ */
+export declare function readAgUiSuspension(value: unknown): AgUiSuspension | undefined;
+//# sourceMappingURL=request.d.ts.map

package/dist/types/ag-ui/request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../../../src/ag-ui/request.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAGH,OAAO,KAAK,EACV,gBAAgB,EAChB,SAAS,EACT,YAAY,EAEZ,aAAa,EACd,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,KAAK,EAIV,YAAY,EAEZ,cAAc,EACf,MAAM,YAAY,CAAC;AAEpB,8EAA8E;AAC9E,eAAO,MAAM,mBAAmB,MAAM,CAAC;AA0GvC;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,YAAY,CAuC5D;AAED,oFAAoF;AACpF,MAAM,MAAM,aAAa,GAAG,CAC1B,KAAK,EAAE,OAAO,EACd,EAAE,EAAE;IACF,iFAAiF;IACjF,QAAQ,CAAC,MAAM,CAAC,EAAE,aAAa,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACpD,KACE,OAAO,CAAC;AAEb,sEAAsE;AACtE,MAAM,WAAW,aAAa;IAC5B,iGAAiG;IACjG,QAAQ,CAAC,aAAa,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC,CAAC;IACxD,QAAQ,CAAC,MAAM,EAAE;QACf,QAAQ,CAAC,KAAK,CAAC,EAAE,aAAa,CAAC;QAC/B,QAAQ,CAAC,OAAO,CAAC,EAAE,aAAa,CAAC;KAClC,CAAC;CACH;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,YAAY,EACnB,IAAI,EAAE,gBAAgB,EACtB,KAAK,EAAE,SAAS,EAChB,KAAK,EAAE,aAAa,GACnB,YAAY,CAyBd;AAyKD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc,GAAG,SAAS,CAuB7E"}

package/dist/types/ag-ui/serializer.d.ts

@@ -0,0 +1,174 @@
+/**
+ * serializer — one run's served agentfootprint events → AG-UI events.
+ *
+ * Pattern: a per-run state machine (`RunTranslation`), pure — no I/O, no clock,
+ *          no import of `@ag-ui/*`. Frames are the framing strategy's job
+ *          (`framing.ts`); reading a request is the adapter's (`adapter.ts`).
+ * Role:    the Lens over a run for an AG-UI reader. It composes what that reader
+ *          is served, from the RECORD only: every value it writes comes from a
+ *          served event (the placeholder wherever a redaction policy selected a
+ *          value), from the record's address (`meta.runtimeStageId`,
+ *          `meta.subflowPath` — never selected by a policy), or from the
+ *          AG-UI request's own ids. It never reads the run's live values, so
+ *          nothing a policy hides can reach an AG-UI event. The record's own
+ *          run id is never written: it counts every run the process made.
+ *
+ * THE MAPPING
+ *   agent.turn_start (nested)          → SUBAGENT_STARTED      (a sub-agent's turn)
+ *   agent.turn_end                     → SUBAGENT_FINISHED / the root answer
+ *   agent.iteration_start/_end         → STEP_STARTED/_FINISHED  `iteration <n>`
+ *   composition.enter/exit             → STEP_STARTED/_FINISHED  `<Kind>[:<mount>]`
+ *   stream.token                       → TEXT_MESSAGE_START/CONTENT/END
+ *   stream.llm_end (no agent around)   → one whole TEXT message (an LLM call that streams nothing)
+ *   stream.thinking_delta/_end         → REASONING_START … REASONING_END   (only with `reasoning: true`)
+ *   stream.tool_start                  → TOOL_CALL_START + TOOL_CALL_ARGS + TOOL_CALL_END
+ *   stream.tool_end                    → TOOL_CALL_RESULT
+ *   pause.request + settle('paused')   → RUN_FINISHED { outcome: interrupt }
+ *   settle('paused', awaiting caller)  → RUN_FINISHED { outcome: success, pendingToolCallIds }
+ *                                        (a tool the client runs: its call is left to answer)
+ *   error.fatal + settle('failed')     → RUN_ERROR — the served error.fatal's words when they
+ *                                        are a fixed sentence, else "The run failed."
+ *   an allow-listed event              → CUSTOM { name: <event type>, value: <its listed fields> }
+ *   anything else                      → nothing
+ *
+ * WHAT LEAVES THE PROCESS. An AG-UI stream goes to a browser, so nothing goes
+ * out by default that a person is not meant to read. Every value comes from a
+ * served payload; `CUSTOM` carries only the event types on an allow-list, each
+ * with the fields its projection picks ({@link AG_UI_CUSTOM_EVENTS} — the whole
+ * record, such as `context.injected`'s assembled prompt or `error.retried`'s
+ * raw error, stays off the wire unless the app lists it); the model's
+ * reasoning goes out only when the app says so; and a failure is described by
+ * the record, never by the thrown value. Identity on the meta (`principal`,
+ * `tenant`, `sessionId`) is never written.
+ *
+ * WHO OWNS AN EVENT. Each agent's turn opens a SCOPE at its mount — the
+ * subflow path its `turn_start` fired at (`[]` for the root agent, `step-p/x`
+ * for an agent in a parallel branch). An event belongs to the deepest open scope
+ * whose mount prefixes its own subflow path, segment by segment, and carries
+ * that scope's `subagentRunId`. Parallel branches have different mounts, so
+ * their interleaved events can never be attributed to each other.
+ *
+ * A RUN THAT CONTINUES A PAUSE. A paused run hands back `suspension()` — the
+ * ids it gave the client (the interrupt, the open call) and every scope and
+ * step open at the pause. The run that continues it passes that as `resume`:
+ * the same sub-agents re-open (AG-UI: "a later run may continue the same
+ * invocation"), their steps re-open, and the first result in the paused call's
+ * scope answers that call under its own id — or, for a tool the client ran, is
+ * not written at all, because the client holds the result it sent.
+ *
+ * TEXT. The reply is what the record streamed (`stream.token`) — the channel
+ * `toSSE({ format: 'text' })` and a hosted reply read. An agent turn whose
+ * answer streamed no token (a provider without `stream()`) is written whole
+ * from `turn_end.finalContent`, unless the record marks it refused. An
+ * agent's `llm_end.content` is a DRAFT the library may be holding back
+ * (answer validation, an output policy) and is never written.
+ */
+import type { AgentfootprintEvent } from '../events/registry.js';
+import type { RunTranslation } from '../hosting/protocolAdapter.js';
+import { type AgUiEvent, type AgUiSuspension } from './types.js';
+/** What a CUSTOM projection is told beside the payload: where the event landed. */
+export interface AgUiCustomContext {
+    /** The AG-UI id of the tool call open where the event happened, when one is. */
+    readonly toolCallId?: string;
+}
+/**
+ * One allow-listed event's `CUSTOM` value: the fields of its SERVED payload
+ * that go out (the payload is the one every listener receives — the
+ * placeholder wherever a redaction policy selected a value). Return only what
+ * a person using the frontend is meant to read.
+ */
+export type AgUiCustomProjection = (payload: Readonly<Record<string, unknown>>, at: AgUiCustomContext) => unknown;
+/**
+ * The agentfootprint events that go out as AG-UI `CUSTOM` by default, each with
+ * the fields it carries: progress (which call, which iteration), spend, the
+ * loop's route, the answer's standing and a provider's retries — counts and the
+ * library's own words. Content (a tool's own progress `payload`,
+ * `context.injected`'s assembled prompt, `error.retried`'s raw error, memory,
+ * permission and credential facts) stays off the wire unless an app lists it:
+ * `agUiSerializer({ ..., custom: { ...AG_UI_CUSTOM_EVENTS, [type]: projection } })`.
+ */
+export declare const AG_UI_CUSTOM_EVENTS: Readonly<Record<string, AgUiCustomProjection>>;
+/** Options for {@link agUiSerializer}. */
+export interface AgUiSerializerOptions {
+    /** The conversation this run belongs to — `RunAgentInput.threadId`. */
+    readonly threadId: string;
+    /** This run's AG-UI id — `RunAgentInput.runId`. Every id the run mints is under it. */
+    readonly runId: string;
+    /**
+     * The events with no AG-UI equivalent that go out as `CUSTOM`, keyed by event
+     * type, each with the projection that picks its fields. Default
+     * {@link AG_UI_CUSTOM_EVENTS}; `{}` sends none. An event not listed sends
+     * nothing. Events the mapping consumes (tokens, tool calls, turns,
+     * iterations, compositions, the pause and the fatal error) are never CUSTOM.
+     */
+    readonly custom?: Readonly<Record<string, AgUiCustomProjection>>;
+    /**
+     * Write the model's reasoning — `REASONING_*` events from the served
+     * `stream.thinking_*` events. Default `false`: a model's chain of thought is
+     * shown to a person only when the app decides it is.
+     */
+    readonly reasoning?: boolean;
+    /**
+     * What a FAILED tool call's result says. Default `'withheld'`: the fixed words
+     * "The tool failed." — the record's result for a failed call is the thrown
+     * text, which may hold a connection string, a path or a provider's response.
+     * `'served'` sends the record's own result (still the served value: the
+     * placeholder wherever a redaction policy selected one).
+     */
+    readonly toolErrors?: 'withheld' | 'served';
+    /**
+     * Which served events are this run's. Default: the events of the first run
+     * an event names (plus events that name no run). Pass it when the listener
+     * can hear more than one run — an instance several callers share — so the
+     * translation never binds to whichever run spoke first.
+     */
+    readonly owns?: (event: AgentfootprintEvent) => boolean;
+    /**
+     * The paused run this one continues — what that run's translation returned
+     * from `suspension()` after it settled `'paused'`. Its suspended sub-agents
+     * and open steps re-open under the same ids, and the call it stopped in is
+     * answered under its own id (or, for a frontend tool, not at all: the client
+     * already holds the result it sent).
+     */
+    readonly resume?: AgUiSuspension;
+}
+/** One run's AG-UI translation — and, once it pauses, what its continuation needs. */
+export interface AgUiTranslation extends RunTranslation<AgUiEvent> {
+    /**
+     * The record to `resume` from. Before settling, what a `'paused'` settlement
+     * with the same `awaiting` will hand out (keep it first, then settle); after
+     * `settle({ kind: 'paused' })`, what it handed out; after any other ending,
+     * `undefined`.
+     */
+    suspension(awaiting?: 'person' | 'caller'): AgUiSuspension | undefined;
+}
+/** Said by `TOOL_CALL_RESULT` for a failed call, unless `toolErrors: 'served'`. */
+export declare const AG_UI_TOOL_FAILED = "The tool failed.";
+/** Said by `RUN_ERROR` when the run's `error.fatal` is not one of the record's fixed sentences. */
+export declare const AG_UI_RUN_FAILED = "The run failed.";
+/** Said by `SUBAGENT_ERROR` for a sub-agent whose turn ended without an answer. */
+export declare const AG_UI_SUBAGENT_UNFINISHED = "The sub-agent's turn ended without an answer.";
+/** Said by `SUBAGENT_ERROR` for a sub-agent still running when its run was cancelled. */
+export declare const AG_UI_SUBAGENT_CANCELLED = "The run was cancelled before this sub-agent finished.";
+/**
+ * The AG-UI serializer for ONE run: feed it every served agentfootprint event
+ * of the run, in order, then settle it once. `RUN_STARTED` comes before the
+ * first event it returns; `RUN_FINISHED` or `RUN_ERROR` is the last thing
+ * `settle` returns, with everything still open closed before it.
+ *
+ * @example
+ * ```ts
+ * const ag = agUiSerializer({ threadId, runId });
+ * const off = agent.on('*', (event) => send(ag.event(event)));
+ * try {
+ *   const out = await agent.run({ message });
+ *   send(ag.settle({ kind: isPaused(out) ? 'paused' : 'finished' }));
+ * } catch {
+ *   send(ag.settle({ kind: 'failed' })); // described by the record, never by the thrown value
+ * } finally {
+ *   off();
+ * }
+ * ```
+ */
+export declare function agUiSerializer(options: AgUiSerializerOptions): AgUiTranslation;
+//# sourceMappingURL=serializer.d.ts.map

package/dist/types/ag-ui/serializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serializer.d.ts","sourceRoot":"","sources":["../../../src/ag-ui/serializer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgEG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAEjE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAIpE,OAAO,EAGL,KAAK,SAAS,EAId,KAAK,cAAc,EACpB,MAAM,YAAY,CAAC;AAEpB,mFAAmF;AACnF,MAAM,WAAW,iBAAiB;IAChC,gFAAgF;IAChF,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;;;;GAKG;AACH,MAAM,MAAM,oBAAoB,GAAG,CACjC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAC1C,EAAE,EAAE,iBAAiB,KAClB,OAAO,CAAC;AAYb;;;;;;;;GAQG;AACH,eAAO,MAAM,mBAAmB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAuB7E,CAAC;AAEH,0CAA0C;AAC1C,MAAM,WAAW,qBAAqB;IACpC,uEAAuE;IACvE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,uFAAuF;IACvF,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB;;;;;;OAMG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC,CAAC;IACjE;;;;OAIG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B;;;;;;OAMG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,UAAU,GAAG,QAAQ,CAAC;IAC5C;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,OAAO,CAAC;IACxD;;;;;;OAMG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,cAAc,CAAC;CAClC;AAED,sFAAsF;AACtF,MAAM,WAAW,eAAgB,SAAQ,cAAc,CAAC,SAAS,CAAC;IAChE;;;;;OAKG;IACH,UAAU,CAAC,QAAQ,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,cAAc,GAAG,SAAS,CAAC;CACxE;AAED,mFAAmF;AACnF,eAAO,MAAM,iBAAiB,qBAAqB,CAAC;AAEpD,mGAAmG;AACnG,eAAO,MAAM,gBAAgB,oBAAoB,CAAC;AAMlD,mFAAmF;AACnF,eAAO,MAAM,yBAAyB,kDAAkD,CAAC;AAEzF,yFAAyF;AACzF,eAAO,MAAM,wBAAwB,0DAA0D,CAAC;AAyFhG;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,eAAe,CAgvB9E"}

package/dist/types/ag-ui/types.d.ts

@@ -0,0 +1,306 @@
+/**
+ * types — the AG-UI events this adapter writes, as plain structural types.
+ *
+ * AG-UI (the Agent–User Interaction protocol, `@ag-ui/core`) is an OPTIONAL
+ * peer of this package, so no declaration here imports it: a consumer who
+ * only reads these types compiles without it, and nothing in `dist/` names a
+ * module they may not have installed. The shapes mirror protocol 1.0 field
+ * for field — `test/type-regressions/AgUiEvents.assignability.test.ts`
+ * compiles every one of them against `@ag-ui/core`'s own `Event` union, and
+ * `test/ag-ui/contract.test.ts` validates every event a real run produces with
+ * `@ag-ui/core/schemas` and the official client's verifier.
+ *
+ * Only the fields this adapter sets are declared. `type` is a string literal
+ * here where `@ag-ui/core` uses its `EventType` enum; the wire values are the
+ * same strings.
+ */
+/** The AG-UI protocol version this adapter speaks — stated on `RUN_STARTED`. */
+export declare const AG_UI_PROTOCOL_VERSION = "1.0";
+/**
+ * Extra information on an event — AG-UI's open `metadata` object. This adapter
+ * writes one key, `agentfootprint`, holding the record's ADDRESS for the event
+ * (see {@link AgUiAddress}); the key `ag-ui` is the protocol's own.
+ */
+export interface AgUiMetadata {
+    readonly agentfootprint?: AgUiAddress;
+    readonly [key: string]: unknown;
+}
+/**
+ * Where an AG-UI event came from in agentfootprint's record: the stage
+ * execution and the subflow path — the coordinates a recording, a trace or a
+ * commit log is keyed by within its run. Address only: a redaction policy never
+ * selects any of it, so it reads the same with or without one. The record's
+ * own run id is never written: it counts every run the PROCESS made, and a
+ * browser must not learn how many other callers ran.
+ */
+export interface AgUiAddress {
+    /** The stage execution that emitted the source event (`meta.runtimeStageId`). */
+    readonly runtimeStageId?: string;
+    /** The subflow path of that stage, outermost first (`meta.subflowPath`). */
+    readonly subflowPath?: readonly string[];
+    /** The tool call's id as the record serves it — the placeholder under a policy. */
+    readonly toolCallId?: string;
+}
+interface AgUiEventBase<T extends string> {
+    readonly type: T;
+    /** Milliseconds since the epoch — the source event's wall clock. */
+    readonly timestamp?: number;
+    readonly metadata?: AgUiMetadata;
+}
+/** Everything a subagent can own carries its invocation handle; absent = the parent agent. */
+interface Attributable {
+    readonly subagentRunId?: string;
+}
+export interface AgUiRunStartedEvent extends AgUiEventBase<'RUN_STARTED'> {
+    readonly threadId: string;
+    readonly runId: string;
+    readonly protocolVersion?: string;
+}
+/** Something a paused run is waiting for. */
+export interface AgUiInterrupt extends Attributable {
+    readonly id: string;
+    readonly reason: string;
+    readonly message?: string;
+    readonly toolCallId?: string;
+    readonly metadata?: AgUiMetadata;
+}
+/**
+ * Why a run ended — absent means success. A success may leave tool calls for
+ * the application to answer (a frontend tool): `pendingToolCallIds` names them.
+ */
+export type AgUiRunOutcome = {
+    readonly type: 'success';
+    readonly pendingToolCallIds?: readonly string[];
+} | {
+    readonly type: 'interrupt';
+    readonly interrupts: readonly AgUiInterrupt[];
+} | {
+    readonly type: 'cancelled';
+};
+/** A tool call still open where a run paused. */
+export interface AgUiSuspendedCall {
+    /** Its AG-UI id — answered under it in the run that continues. */
+    readonly toolCallId: string;
+    /** Answered by the CLIENT (a frontend tool): its result is never written back. */
+    readonly client: boolean;
+}
+/** One scope open where a run paused — the root, or a sub-agent's turn — and what is open in it. */
+export interface AgUiSuspendedScope {
+    /** The scope's mount: the subflow path its turn opened at (`[]` for the root). */
+    readonly mount: readonly string[];
+    /** The sub-agent invocation — absent for the root. */
+    readonly subagentRunId?: string;
+    /** The sub-agent's name as `SUBAGENT_STARTED` gave it. */
+    readonly name?: string;
+    /** The sub-agent that spawned it, when one did. */
+    readonly parentSubagentRunId?: string;
+    /** Its open steps, in the order they opened. */
+    readonly steps: readonly string[];
+    /**
+     * Its open tool calls — the one the pause is about, and a parallel sibling's
+     * that paused with it and waits its turn — each answered under its own id.
+     */
+    readonly calls: readonly AgUiSuspendedCall[];
+    /** The assistant message its current model response's calls belong to. */
+    readonly messageId?: string;
+}
+/**
+ * What a PAUSED run's translation hands the run that continues it
+ * (`agUiSerializer({ resume })`): the ids the paused run gave the client, so the
+ * answer can be matched and the continuation is the same invocation —
+ * suspended sub-agents re-open under their own `subagentRunId`, open steps
+ * re-open, and the call the run stopped in is answered under its own id.
+ *
+ * Plain JSON — keep it with the paused run (a host stores it beside the
+ * checkpoint). It holds ids and step names only, never a value of the run.
+ */
+export interface AgUiSuspension {
+    readonly version: 1;
+    /** The AG-UI run that paused. */
+    readonly runId: string;
+    /** The interrupt the run waits on — absent when it waits on a frontend tool's result. */
+    readonly interruptId?: string;
+    /**
+     * The call the pause is about: its AG-UI id, where it is, and whether the
+     * CLIENT answers it (a frontend tool — `pendingToolCallIds`) rather than the
+     * run continuing it after the interrupt. It is also among its scope's `calls`.
+     */
+    readonly call?: AgUiSuspendedCall & {
+        readonly mount: readonly string[];
+    };
+    /** The run's root is an agent's turn (its answer is the run's result). */
+    readonly rootAgent: boolean;
+    /** The scopes open at the pause, outermost first — the root always first. */
+    readonly scopes: readonly AgUiSuspendedScope[];
+}
+export interface AgUiRunFinishedEvent extends AgUiEventBase<'RUN_FINISHED'> {
+    readonly threadId: string;
+    readonly runId: string;
+    readonly result?: unknown;
+    readonly outcome?: AgUiRunOutcome;
+}
+export interface AgUiRunErrorEvent extends AgUiEventBase<'RUN_ERROR'> {
+    readonly message: string;
+    readonly code?: string;
+}
+export interface AgUiStepStartedEvent extends AgUiEventBase<'STEP_STARTED'>, Attributable {
+    readonly stepName: string;
+}
+export interface AgUiStepFinishedEvent extends AgUiEventBase<'STEP_FINISHED'>, Attributable {
+    readonly stepName: string;
+}
+export interface AgUiTextMessageStartEvent extends AgUiEventBase<'TEXT_MESSAGE_START'>, Attributable {
+    readonly messageId: string;
+    readonly role: 'assistant';
+}
+export interface AgUiTextMessageContentEvent extends AgUiEventBase<'TEXT_MESSAGE_CONTENT'>, Attributable {
+    readonly messageId: string;
+    readonly delta: string;
+}
+export interface AgUiTextMessageEndEvent extends AgUiEventBase<'TEXT_MESSAGE_END'>, Attributable {
+    readonly messageId: string;
+}
+export interface AgUiToolCallStartEvent extends AgUiEventBase<'TOOL_CALL_START'>, Attributable {
+    readonly toolCallId: string;
+    readonly toolCallName: string;
+    readonly parentMessageId?: string;
+}
+export interface AgUiToolCallArgsEvent extends AgUiEventBase<'TOOL_CALL_ARGS'>, Attributable {
+    readonly toolCallId: string;
+    readonly delta: string;
+}
+export interface AgUiToolCallEndEvent extends AgUiEventBase<'TOOL_CALL_END'>, Attributable {
+    readonly toolCallId: string;
+}
+export interface AgUiToolCallResultEvent extends AgUiEventBase<'TOOL_CALL_RESULT'>, Attributable {
+    readonly messageId: string;
+    readonly toolCallId: string;
+    readonly content: string;
+    readonly role: 'tool';
+}
+export interface AgUiReasoningStartEvent extends AgUiEventBase<'REASONING_START'>, Attributable {
+    readonly messageId: string;
+}
+export interface AgUiReasoningMessageStartEvent extends AgUiEventBase<'REASONING_MESSAGE_START'>, Attributable {
+    readonly messageId: string;
+    readonly role: 'reasoning';
+}
+export interface AgUiReasoningMessageContentEvent extends AgUiEventBase<'REASONING_MESSAGE_CONTENT'>, Attributable {
+    readonly messageId: string;
+    readonly delta: string;
+}
+export interface AgUiReasoningMessageEndEvent extends AgUiEventBase<'REASONING_MESSAGE_END'>, Attributable {
+    readonly messageId: string;
+}
+export interface AgUiReasoningEndEvent extends AgUiEventBase<'REASONING_END'>, Attributable {
+    readonly messageId: string;
+}
+export interface AgUiSubagentStartedEvent extends AgUiEventBase<'SUBAGENT_STARTED'> {
+    readonly subagentRunId: string;
+    readonly name: string;
+    readonly parentSubagentRunId?: string;
+}
+export interface AgUiSubagentFinishedEvent extends AgUiEventBase<'SUBAGENT_FINISHED'> {
+    readonly subagentRunId: string;
+    readonly result?: unknown;
+    readonly outcome?: {
+        readonly type: 'success';
+    } | {
+        readonly type: 'suspended';
+        readonly interruptIds?: readonly string[];
+    };
+}
+export interface AgUiSubagentErrorEvent extends AgUiEventBase<'SUBAGENT_ERROR'> {
+    readonly subagentRunId: string;
+    readonly message: string;
+    readonly code?: string;
+}
+export interface AgUiCustomEvent extends AgUiEventBase<'CUSTOM'>, Attributable {
+    readonly name: string;
+    readonly value: unknown;
+}
+/** Every AG-UI event this adapter writes. */
+export type AgUiEvent = AgUiRunStartedEvent | AgUiRunFinishedEvent | AgUiRunErrorEvent | AgUiStepStartedEvent | AgUiStepFinishedEvent | AgUiTextMessageStartEvent | AgUiTextMessageContentEvent | AgUiTextMessageEndEvent | AgUiToolCallStartEvent | AgUiToolCallArgsEvent | AgUiToolCallEndEvent | AgUiToolCallResultEvent | AgUiReasoningStartEvent | AgUiReasoningMessageStartEvent | AgUiReasoningMessageContentEvent | AgUiReasoningMessageEndEvent | AgUiReasoningEndEvent | AgUiSubagentStartedEvent | AgUiSubagentFinishedEvent | AgUiSubagentErrorEvent | AgUiCustomEvent;
+/** The `type` of every AG-UI event this adapter writes. */
+export type AgUiEventType = AgUiEvent['type'];
+/** A text part of a message body. */
+export interface AgUiTextPart {
+    readonly type: 'text';
+    readonly text: string;
+}
+/** A part of a message body: text, or a media part (named so it can be refused by name). */
+export type AgUiContentPart = AgUiTextPart | {
+    readonly type: 'image' | 'audio' | 'video' | 'document';
+    readonly [key: string]: unknown;
+};
+/** A call an assistant message made. */
+export interface AgUiToolCall {
+    readonly id: string;
+    readonly type: 'function';
+    readonly function: {
+        readonly name: string;
+        readonly arguments: string;
+    };
+}
+/** A message of the conversation a request carries, by role. */
+export type AgUiMessage = {
+    readonly id: string;
+    readonly role: 'user';
+    readonly content: string | readonly AgUiContentPart[];
+} | {
+    readonly id: string;
+    readonly role: 'assistant';
+    readonly content?: string;
+    readonly toolCalls?: readonly AgUiToolCall[];
+} | {
+    readonly id: string;
+    readonly role: 'tool';
+    readonly toolCallId: string;
+    readonly content: string | readonly AgUiContentPart[];
+} | {
+    readonly id: string;
+    readonly role: 'system' | 'developer';
+    readonly content: string;
+} | {
+    readonly id: string;
+    readonly role: 'reasoning';
+    readonly content: string;
+} | {
+    readonly id: string;
+    readonly role: 'activity';
+    readonly activityType: string;
+    readonly content: Readonly<Record<string, unknown>>;
+};
+/** An answer to one interrupt, sent on the run that continues from it. */
+export interface AgUiResumeEntry {
+    readonly interruptId: string;
+    readonly status: 'resolved' | 'cancelled';
+    readonly payload?: unknown;
+}
+/**
+ * An AG-UI request (`RunAgentInput`) as the browser sent it — UNTRUSTED. Read
+ * by `readAgUiRunInput` (shape and id format), then planned against what the
+ * server holds: only the newest USER message, an answer to the pause the
+ * server is keeping, the names of tools the app allow-listed, and the
+ * `state`/`context` the app's own validators accept are ever used.
+ */
+export interface AgUiRunInput {
+    readonly threadId: string;
+    readonly runId: string;
+    readonly protocolVersion?: string;
+    readonly parentRunId?: string;
+    readonly messages: readonly AgUiMessage[];
+    readonly tools: readonly {
+        readonly name: string;
+        readonly description?: string;
+    }[];
+    readonly context: readonly {
+        readonly description: string;
+        readonly value: string;
+    }[];
+    readonly state?: unknown;
+    readonly forwardedProps?: unknown;
+    readonly resume?: readonly AgUiResumeEntry[];
+}
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/types/ag-ui/types.d.ts.map

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