agentfootprint 10.3.1 → 10.5.0

package/dist/esm/hosting/stream.js.map

@@ -1 +1 @@
-{"version":3,"file":"stream.js","sourceRoot":"","sources":["../../../src/hosting/stream.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAKH,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAwDhD;;;GAGG;AACH,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,KAAK,CAC1B,MAA6B,EAC7B,UAAwB,EAAE;IAE1B,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAC9B,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,MAAM,CAAC;IACxC,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,CAAC,CAAC,CAAsB,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAC5E,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,CAAC,CAAC;IAE7C,+DAA+D;IAC/D,+DAA+D;IAC/D,0DAA0D;IAC1D,MAAM,UAAU,GAAI,MAAqD,CAAC,UAAU,CAAC;IAErF,0DAA0D;IAC1D,MAAM,KAAK,GAA0B,EAAE,CAAC;IACxC,IAAI,MAAM,GAAmC,IAAI,CAAC;IAClD,IAAI,IAAI,GAAG,KAAK,CAAC;IAEjB,MAAM,MAAM,GAAG,GAAS,EAAE;QACxB,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,CAAC,GAAG,MAAM,CAAC;YACjB,MAAM,GAAG,IAAI,CAAC;YACd,CAAC,CAAC,OAAO,EAAE,CAAC;QACd,CAAC;IACH,CAAC,CAAC;IAEF,yEAAyE;IACzE,mEAAmE;IACnE,yEAAyE;IACzE,wEAAwE;IACxE,+DAA+D;IAC/D,0EAA0E;IAC1E,2EAA2E;IAC3E,sEAAsE;IACtE,oEAAoE;IACpE,+EAA+E;IAC/E,MAAM,IAAI,GAAG,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAChE,MAAM,OAAO,GAAG,IAAI,GAAG,EAAoB,CAAC;IAC5C,MAAM,UAAU,GAAG,IAAI,EAAE,WAAW,CAAC,CAAC,KAAK,EAAE,EAAE;QAC7C,IAAI,KAAK,CAAC,IAAI,KAAK,6BAA6B;YAAE,OAAO;QACzD,MAAM,OAAO,GAAI,KAA6C,CAAC,OAAO,EAAE,OAAO,CAAC;QAChF,MAAM,GAAG,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;QAChC,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACjC,MAAM,IAAI,GAAG,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;QACxD,IAAI,OAAO,KAAK,SAAS;YAAE,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;;YAC/C,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC,CAAC,CAAC;IACH,MAAM,QAAQ,GAAG,CAAC,KAA0B,EAAsB,EAAE;QAClE,MAAM,GAAG,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;QAChC,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACjC,MAAM,IAAI,GAAG,OAAO,EAAE,KAAK,EAAE,CAAC;QAC9B,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACvE,OAAO,IAAI,CAAC;IACd,CAAC,CAAC;IACF,MAAM,QAAQ,GAAG,CAAC,KAA0B,EAAQ,EAAE;QACpD,4EAA4E;QAC5E,MAAM,KAAK,GACT,IAAI,KAAK,SAAS,IAAI,KAAK,CAAC,IAAI,KAAK,6BAA6B;YAChE,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC;YACjB,CAAC,CAAC,SAAS,CAAC;QAChB,IAAI,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;YAAE,OAAO;QACrC,KAAK,CAAC,IAAI,CACR,KAAK,KAAK,SAAS;YACjB,CAAC,CAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,EAAqC;YACvF,CAAC,CAAC,KAAK,CACV,CAAC;QACF,MAAM,EAAE,CAAC;QACT,iEAAiE;QACjE,iEAAiE;QACjE,6BAA6B;QAC7B,IACE,KAAK,CAAC,IAAI,KAAK,+BAA+B;YAC9C,KAAK,CAAC,IAAI,KAAK,4BAA4B,EAC3C,CAAC;YACD,IAAI,GAAG,IAAI,CAAC;YACZ,MAAM,EAAE,CAAC;QACX,CAAC;IACH,CAAC,CAAC;IACF,MAAM,SAAS,GAAgB,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IAC5D,MAAM,KAAK,GAAG,GAAS,EAAE;QACvB,SAAS,EAAE,CAAC;QACZ,UAAU,EAAE,EAAE,CAAC;IACjB,CAAC,CAAC;IAEF,IAAI,SAAqD,CAAC;IAC1D,IAAI,WAAW,GAAG,CAAC,EAAE,CAAC;QACpB,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE;YAC3B,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,aAAa,EAAW,CAAC,CAAC;YAC7C,MAAM,EAAE,CAAC;QACX,CAAC,EAAE,WAAW,CAAC,CAAC;IAClB,CAAC;IAED,IAAI,CAAC;QACH,OAAO,CAAC,IAAI,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACjC,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACxB,wDAAwD;gBACxD,oEAAoE;gBACpE,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,EAAG,CAAC;gBAC7B,IAAK,KAAK,CAAC,IAAe,KAAK,aAAa,EAAE,CAAC;oBAC7C,MAAM,YAAY,CAAC;oBACnB,SAAS;gBACX,CAAC;gBACD,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;oBACtB,IAAI,KAAK,CAAC,IAAI,KAAK,6BAA6B,EAAE,CAAC;wBACjD,MAAM,OAAO,GAAI,KAA4C,CAAC,OAAO,CAAC;wBACtE,IAAI,OAAO,EAAE,OAAO;4BAAE,MAAM,OAAO,CAAC,OAAO,CAAC;oBAC9C,CAAC;gBACH,CAAC;qBAAM,CAAC;oBACN,MAAM,SAAS,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC;gBAC3C,CAAC;YACH,CAAC;YACD,IAAI,IAAI;gBAAE,MAAM;YAChB,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;gBAClC,MAAM,GAAG,EAAE,OAAO,EAAE,CAAC;YACvB,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;YAAS,CAAC;QACT,KAAK,EAAE,CAAC;QACR,IAAI,SAAS;YAAE,aAAa,CAAC,SAAS,CAAC,CAAC;IAC1C,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,OAAO,YAAY;IAEJ;IACA;IAFnB,YACmB,MAA6B,EAC7B,UAAwB,EAAE;QAD1B,WAAM,GAAN,MAAM,CAAuB;QAC7B,YAAO,GAAP,OAAO,CAAmB;IAC1C,CAAC;IAEJ,8DAA8D;IAC9D,MAAM;QACJ,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IAC1C,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,SAAiB,EAAE,OAAgB;IAC3D,0EAA0E;IAC1E,wEAAwE;IACxE,MAAM,IAAI,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;IACjC,sEAAsE;IACtE,gEAAgE;IAChE,qCAAqC;IACrC,OAAO,UAAU,SAAS,WAAW,IAAI,MAAM,CAAC;AAClD,CAAC;AAED;;;;GAIG;AACH,SAAS,YAAY,CAAC,KAA0B;IAC9C,MAAM,OAAO,GAAG,KAAK,CAAC,OAAoE,CAAC;IAC3F,OAAO;QACL,KAAK,CAAC,IAAI,EAAE,cAAc,IAAI,EAAE;QAChC,MAAM,CAAC,OAAO,EAAE,SAAS,IAAI,EAAE,CAAC;QAChC,MAAM,CAAC,OAAO,EAAE,UAAU,IAAI,EAAE,CAAC;KAClC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AACnB,CAAC"}
+{"version":3,"file":"stream.js","sourceRoot":"","sources":["../../../src/hosting/stream.ts"],"names":[],"mappings":"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"}

package/dist/esm/hosting/streamHandler.d.ts

@@ -0,0 +1,153 @@
+/**
+ * streamHandler — one run per request, streamed in a wire protocol, as a
+ * framework-agnostic Fetch-API handler: `(request: Request) => Promise<Response>`.
+ *
+ * Pattern: Template method over a {@link ProtocolAdapter} (the protocol is a
+ *          strategy; AG-UI is one). Everything HTTP happens here once — the
+ *          door guard, the body ceiling, the JSON parse, binding the
+ *          conversation to its caller, keeping it between requests, the client
+ *          hanging up, a failure that is never the process's — so an adapter
+ *          only reads its request, plans the turn and translates.
+ * Role:    the host for a protocol whose response is a STREAM OF EVENTS rather
+ *          than text pieces (`httpHost`'s port). It mounts in anything that
+ *          speaks `Request`/`Response` — a framework's route handler, an edge
+ *          or serverless runtime, or Node through any fetch adapter.
+ *          Deliberately names no vendor, like every file in this folder.
+ *
+ * THE REQUEST IS UNTRUSTED. A body is what anybody could send. It decides
+ * nothing the server owns:
+ *   - WHO is calling and WHICH conversation is theirs come from the app's
+ *     {@link ThreadBinder} (`threads`), from the request's headers — the id a
+ *     request names is format-checked caller data and never a key;
+ *   - WHAT WAS SAID BEFORE comes from the server: the session store
+ *     (`sessions`), or the agent's own memory keyed by the bound session;
+ *   - WHAT A PAUSED RUN WAITS ON is the stored run's own record — an answer is
+ *     matched to it by the adapter, never taken on the request's word;
+ *   - identity and redaction settings never come from a request. A credential
+ *     the request CARRIES (a gateway's per-request token) reaches its own run
+ *     only through the app's `sealRequest`, sealed: never a frame, a stored
+ *     session or a checkpoint.
+ *
+ * NOTHING IS SHARED BETWEEN REQUESTS. Every request builds a FRESH runner
+ * (`agent`, a factory): footprintjs runs one executor per run and a runner
+ * holds one run's context, so a request can neither see another's events nor
+ * leave anything behind for one — no shared listener, recorder, buffer, tool
+ * session or frame count (each stream numbers its own frames, and hands the
+ * number to the framing: `SseFramePosition`). A factory that hands back a
+ * runner it handed back before is refused; so is a `sealRequest` that hands
+ * back a sealed request twice. The handler's own state is KEYS, never content:
+ * the bound conversations with a turn in flight and who holds each (a second
+ * turn on one conversation is refused rather than racing the first for the
+ * stored state), and the runners and sealed requests already used (by
+ * identity, held weakly).
+ *
+ * ONE TURN PER THREAD IS A PER-PROCESS GUARD. Two instances of the handler
+ * (several serverless instances, several workers) do not see each other's
+ * turns: route a thread to one instance (sticky sessions), or a double-sent
+ * answer can resume one paused run twice and a later persist can overwrite an
+ * earlier one. The session store port has no compare-and-set yet.
+ *
+ * The laws it keeps from `httpHost`:
+ *   - The door guard runs first, on the headers alone (`doorGuard.ts`): a Host
+ *     not configured (421), a browser origin not allowed (403), a POST that
+ *     does not say it is JSON (415). A refused body is never read.
+ *   - A body over `maxBodyBytes` is refused at the byte that crosses it (413).
+ *   - A refusal answers with its own status and code (`refusalStatus.ts`);
+ *     anything else is a 500 that names nothing the caller sent and no thrown
+ *     message.
+ *   - Nothing in a request's lifecycle is the process's failure: every step is
+ *     caught, and a stream always ends.
+ */
+import type { AgentRunCheckpoint } from '../core/runCheckpoint.js';
+import type { Runner } from '../core/runner.js';
+import { type CrossSiteOptions } from './doorGuard.js';
+import type { ProtocolAdapter, StreamRunContext, ThreadBinder } from './protocolAdapter.js';
+import { type RequestSealer } from './requestSealing.js';
+import type { SessionLifecycle } from './types.js';
+/** The default body ceiling — 1 MiB, the same as `nodeHost`. */
+export declare const DEFAULT_STREAM_MAX_BODY_BYTES = 1048576;
+/** The default keep-alive interval: an SSE comment every 15 s of silence. */
+export declare const DEFAULT_STREAM_HEARTBEAT_MS = 15000;
+/**
+ * The runner one request runs — an `Agent`, an `LLMCall`, a composition. An
+ * Agent's `checkpoint()` is the conversation a session store keeps; a runner
+ * without one answers each request's message on its own.
+ */
+export type StreamRunner = Pick<Runner, 'on' | 'run' | 'resume'> & {
+    checkpoint?(): AgentRunCheckpoint | undefined;
+    shutdown?(options?: {
+        readonly stop?: boolean;
+    }): Promise<void>;
+};
+/** Options for {@link streamHandler}. */
+export interface StreamHandlerOptions<TRequest, TEvent> extends CrossSiteOptions {
+    /**
+     * Builds a FRESH runner for every request — called once per request, with
+     * what that request's runner is built with ({@link StreamRunContext}: the
+     * tools the caller runs, the values the app's validators accepted, the bound
+     * conversation). A runner is never shared between requests; one handed back
+     * twice is refused.
+     */
+    readonly agent: (run: StreamRunContext) => StreamRunner;
+    /** The wire protocol — `agUi()` from `agentfootprint/ag-ui`. */
+    readonly adapter: ProtocolAdapter<TRequest, TEvent>;
+    /**
+     * The app's port that binds the conversation a request names to the caller
+     * the app authenticates ({@link ThreadBinder}). Without it every request is
+     * a conversation of one message: no session, no identity, nothing kept.
+     */
+    readonly threads?: ThreadBinder;
+    /**
+     * Where a bound conversation is kept between requests — what was said (an
+     * Agent's `checkpoint()`) and a run paused on an answer — under the key
+     * `threads` binds (`memorySessions()`, `sqliteSessions()`, or yours). Needs
+     * `threads`: nothing is ever kept under the id a request names.
+     */
+    readonly sessions?: SessionLifecycle;
+    /**
+     * Seal the credential a request carries for its run ({@link RequestSealer}) —
+     * a gateway's per-request token in a header, read by a `requestCredentials`
+     * provider for the tools that declare a `needs` for it. Called once per
+     * request that runs, after the thread is bound and the turn is planned, with
+     * the request's headers; its handle goes to THAT request's
+     * `run()` / `resume()` and nowhere else — never a frame, a stored session or
+     * a checkpoint. A handle returned twice is refused; a sealer that throws
+     * refuses the request in fixed words (`ERR_REQUEST_NOT_SEALED`, 400).
+     * Without it, no run carries a request.
+     */
+    readonly sealRequest?: RequestSealer;
+    /** The largest request body read, in bytes. Default {@link DEFAULT_STREAM_MAX_BODY_BYTES}. */
+    readonly maxBodyBytes?: number;
+    /**
+     * An SSE comment (`: ping`) every this many milliseconds, so a proxy does not
+     * cut a stream that is quiet while the model thinks. Default
+     * {@link DEFAULT_STREAM_HEARTBEAT_MS}; `0` turns it off.
+     */
+    readonly heartbeatMs?: number;
+    /** Names this handler in refusals. Default `'<adapter name> stream'`. */
+    readonly name?: string;
+}
+/** A Fetch-API handler: one request in, one streamed response out. */
+export type StreamHandler = (request: Request) => Promise<Response>;
+/**
+ * Serve runs in `adapter`'s protocol: POST a protocol request, read a stream
+ * of the protocol's events.
+ *
+ * @throws TypeError at construction for options that cannot be served, and
+ *   when the adapter's framing cannot be built (an optional peer missing) —
+ *   refused at boot, never mid-request.
+ *
+ * @example A route handler that speaks `Request`/`Response`
+ * ```ts
+ * import { memorySessions, streamHandler } from 'agentfootprint/hosting';
+ * import { agUi } from 'agentfootprint/ag-ui';
+ *
+ * export const POST = streamHandler({
+ *   agent: ({ tools }) => buildAgent(tools), // a fresh agent per request
+ *   adapter: agUi(),
+ *   threads: { bind: ({ conversation, headers }) => bindToUser(conversation, headers) },
+ *   sessions: memorySessions(),
+ * });
+ * ```
+ */
+export declare function streamHandler<TRequest, TEvent>(options: StreamHandlerOptions<TRequest, TEvent>): StreamHandler;