@anvia/client 1.2.0 → 1.3.0

package/README.md

@@ -1,83 +1,75 @@
 # @anvia/client
 
-Framework-neutral client protocol, transports, message conversion, and stream state for Anvia.
+Connect any frontend to Anvia with a framework-neutral streaming protocol. This package provides
+HTTP and direct transports, runtime validation, and UI message state for text, tools, and interactions.
 
-`@anvia/core` owns native completion and Agent events. `@anvia/client` owns the public wire boundary:
+## Install
+
+```sh
+pnpm add @anvia/client @anvia/core
+```
+
+## Quickstart
+
+Consume a chat endpoint that returns an Anvia client stream, such as one created with
+`@anvia/server`:
 
 ```ts
-import { completionToClientStream, parseClientStreamRequest } from "@anvia/client";
-import { streamCompletion } from "@anvia/core";
-
-const request = parseClientStreamRequest(await httpRequest.json());
-if (request.type !== "messages") throw new Error("This endpoint does not resume interactions.");
-const events = completionToClientStream({
-  events: streamCompletion({ model, messages: request.messages }),
-});
+import {
+  applyClientStreamEvent,
+  createHttpClientTransport,
+  messagesToUIMessages,
+  type UIMessage,
+} from "@anvia/client";
+import type { Message } from "@anvia/core/completion";
+
+const transport = createHttpClientTransport({ endpoint: "/api/chat" });
+const messages: Message[] = [{ role: "user", content: "Hello!" }];
+let uiMessages: readonly UIMessage[] = messagesToUIMessages(messages);
+
+for await (const frame of transport.send({ request: { type: "messages", messages } })) {
+  if (frame.type === "stream_event") {
+    uiMessages = applyClientStreamEvent(uiMessages, frame.event);
+    console.log(uiMessages);
+  }
+}
 ```
 
-The request carries core `Message[]`; client-side `UIMessage[]` never crosses the server boundary.
-The response uses `ClientStreamEvent` records inside an always-framed `anvia.client.v3` stream.
-Agent endpoints accept either a `messages` request or an `interaction_response` request, while
-keeping the matching `AgentContinuation` exclusively on the server.
-Agent interaction wire contracts come from the browser-safe `@anvia/core/agent/interactions`
-subpath; importing Client does not load the Agent runtime or its infrastructure dependencies.
+The transport validates framing, event order, and stream identity. Send Core `Message[]` to the
+server; keep `UIMessage[]` as presentation state in your application.
 
-## Bun
+## Capabilities
 
-Bun 1.3.14 is the currently tested and supported runtime baseline:
+- HTTP transport for JSONL or SSE, plus direct transport for in-process integrations.
+- Adapters for native completion and Agent events at the server boundary.
+- Validated requests, events, frames, and persisted UI messages.
+- Message conversion and reduction, including streamed tool arguments and generation usage.
+- Typed custom stream data, Agent interactions, and HTTP resume cursors.
 
-```sh
-bun add @anvia/client @anvia/core
-```
+For React, `@anvia/react` manages this state through `useChat` and `useCompletion`. Generic JSONL/SSE
+readers are also available from `@anvia/client/transport` for other event contracts.
 
-Compatibility tests cover framed JSONL and SSE consumption, resumable client streams, fetch
-cancellation, and installation from packed package artifacts.
-
-## Public API
-
-- `completionToClientStream({ events, ...options })` adapts native completion events.
-- `agentToClientStream({ events, ...options })` adapts native Agent events, including nested-agent
-  scope.
-- `parseClientStreamRequest`, `parseClientStreamEvent`, and `parseClientStreamFrame` validate public
-  input at runtime.
-- `createHttpClientTransport(options)` consumes framed JSONL or SSE responses and validates the
-  protocol header, frame order, stream identity, and event IDs.
-- `createDirectClientTransport({ handler })` provides the same framed contract without HTTP.
-- `messagesToUIMessages` and `uiMessagesToMessages` explicitly convert server messages and UI
-  state.
-- `applyClientStreamEvent(messages, event)` applies canonical events to `UIMessage[]` state.
-- `parseUIMessage` and `parseUIMessages` validate externally loaded UI state.
-
-Tool-call start, delta, and end events are automatic when the provider exposes streamed arguments.
-`UIToolMessagePart` states are exact: `input-streaming` carries raw partial text,
-`input-available` carries parsed JSON input, and terminal `output-available` or `error` parts retain
-that input with their result. `uiMessagesToMessages()` rejects partial calls instead of replaying
-incomplete JSON or inventing empty arguments.
-Errors are masked by default. Use `mapError` only at the server adapter boundary when an application
-intentionally exposes a safe error shape. Non-JSON outputs require an explicit `mapOutput`; returning
-`undefined` intentionally omits the output, while returning `null` exposes JSON `null`.
-
-`UIMessage.metadata` remains application-owned and round-trips unchanged. Runtime details such as
-run ID, usage, context usage, status, and trace correlation are stored separately in
-`UIMessage.generation`. Converting persisted core messages hydrates per-generation usage and context
-usage into that UI field and restores persisted sources as UI message parts while preserving the
-original metadata.
-
-Application-specific stream data is explicit and schema-validated:
+## Learn more
 
-```ts
-type AppData = {
-  citation_preview: { title: string; url: string };
-};
-
-const transport = createHttpClientTransport<ClientStreamRequest, AppData>({
-  endpoint: "/api/chat",
-  dataSchemas: {
-    citation_preview: citationPreviewSchema,
-  },
-});
-```
+- [Client protocol guide](https://github.com/anvia-hq/anvia/blob/main/docs/packages/client.md)
+- [Server response helpers](https://github.com/anvia-hq/anvia/tree/main/packages/server#readme)
+- [React hooks](https://github.com/anvia-hq/anvia/tree/main/packages/react#readme)
+
+## Durable HTTP client
+
+The optional `@anvia/client/durable` entrypoint exports `DurableClient` and
+`DurableHttpError`. Install `@anvia/durable` to use it. It supports submit, list, snapshot,
+SSE observation, approval responses, retry, cancellation, and tool reconciliation.
+
+Construct it with an absolute `endpoint`, optional `fetch`, `credentials`, and static or
+per-request `headers`. Restore UI state from `snapshot(runId)`, then observe
+`stream(runId, { after: snapshot.cursor })`. Incoming records and event ordering are
+validated. Reconnection is explicit; aborting observation does not cancel execution.
+These committed progress events are separate from token-delta chat streams.
+
+See the [durable HTTP guide](../../docs/packages/durable.md#http-server-and-client).
 
-Low-level generic JSONL/SSE readers and event transports are available from
-`@anvia/client/transport`. They do not imply the Anvia client protocol; use them only for endpoints
-that intentionally expose a different event contract.
+`DurableClient` also exposes `submitGraph`, `listGraphs`, `graphSnapshot`, `streamGraph`, and
+`cancelGraph`. Graph snapshots contain renderable nodes/edges and explicit waiting reasons.
+Use each node's `runId` with the existing response/retry/reconciliation methods. Graph streams
+carry `graphId` and `taskId`; refresh the snapshot to obtain the latest graph-wide state.

package/dist/chunk-63JX2QNP.js

@@ -0,0 +1,86 @@
+// src/transport/streams.ts
+async function* readJsonlStream(stream) {
+  const reader = stream.getReader();
+  const decoder = new TextDecoder();
+  let buffer = "";
+  let completed = false;
+  try {
+    while (true) {
+      const next = await reader.read();
+      if (next.done) {
+        completed = true;
+        break;
+      }
+      buffer += decoder.decode(next.value, { stream: true });
+      const lines = buffer.split(/\r?\n/);
+      buffer = lines.pop() ?? "";
+      for (const line of lines) {
+        const value2 = line.trim();
+        if (value2.length > 0) yield JSON.parse(value2);
+      }
+    }
+    buffer += decoder.decode();
+    const value = buffer.trim();
+    if (value.length > 0) yield JSON.parse(value);
+  } finally {
+    if (!completed) await cancelReader(reader);
+    reader.releaseLock();
+  }
+}
+async function* readSseStream(stream) {
+  const reader = stream.getReader();
+  const decoder = new TextDecoder();
+  let buffer = "";
+  let data = [];
+  let completed = false;
+  function parseLine(line) {
+    if (line === "") {
+      const complete = data.length === 0 ? void 0 : data.join("\n");
+      data = [];
+      return complete;
+    }
+    if (line.startsWith(":")) return void 0;
+    const separator = line.indexOf(":");
+    const field = separator === -1 ? line : line.slice(0, separator);
+    const value = separator === -1 ? "" : line.slice(separator + 1).replace(/^ /, "");
+    if (field === "data") data.push(value);
+    return void 0;
+  }
+  try {
+    while (true) {
+      const next = await reader.read();
+      if (next.done) {
+        completed = true;
+        break;
+      }
+      buffer += decoder.decode(next.value, { stream: true });
+      const lines = buffer.split(/\r?\n/);
+      buffer = lines.pop() ?? "";
+      for (const line of lines) {
+        const complete = parseLine(line);
+        if (complete !== void 0) yield JSON.parse(complete);
+      }
+    }
+    buffer += decoder.decode();
+    if (buffer.length > 0) {
+      const complete = parseLine(buffer);
+      if (complete !== void 0) yield JSON.parse(complete);
+    }
+    if (data.length > 0) yield JSON.parse(data.join("\n"));
+  } finally {
+    if (!completed) await cancelReader(reader);
+    reader.releaseLock();
+  }
+}
+async function cancelReader(reader) {
+  try {
+    await reader.cancel();
+  } catch {
+  }
+}
+
+export {
+  readJsonlStream,
+  readSseStream
+};
+//# sourceMappingURL=chunk-63JX2QNP.js.map

package/dist/chunk-63JX2QNP.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/transport/streams.ts"],"sourcesContent":["export async function* readJsonlStream<TEvent>(\n  stream: ReadableStream<Uint8Array>,\n): AsyncIterable<TEvent> {\n  const reader = stream.getReader();\n  const decoder = new TextDecoder();\n  let buffer = \"\";\n  let completed = false;\n\n  try {\n    while (true) {\n      const next = await reader.read();\n      if (next.done) {\n        completed = true;\n        break;\n      }\n      buffer += decoder.decode(next.value, { stream: true });\n      const lines = buffer.split(/\\r?\\n/);\n      buffer = lines.pop() ?? \"\";\n      for (const line of lines) {\n        const value = line.trim();\n        if (value.length > 0) yield JSON.parse(value) as TEvent;\n      }\n    }\n    buffer += decoder.decode();\n    const value = buffer.trim();\n    if (value.length > 0) yield JSON.parse(value) as TEvent;\n  } finally {\n    if (!completed) await cancelReader(reader);\n    reader.releaseLock();\n  }\n}\n\nexport async function* readSseStream<TEvent>(\n  stream: ReadableStream<Uint8Array>,\n): AsyncIterable<TEvent> {\n  const reader = stream.getReader();\n  const decoder = new TextDecoder();\n  let buffer = \"\";\n  let data: string[] = [];\n  let completed = false;\n\n  function parseLine(line: string): string | undefined {\n    if (line === \"\") {\n      const complete = data.length === 0 ? undefined : data.join(\"\\n\");\n      data = [];\n      return complete;\n    }\n    if (line.startsWith(\":\")) return undefined;\n    const separator = line.indexOf(\":\");\n    const field = separator === -1 ? line : line.slice(0, separator);\n    const value = separator === -1 ? \"\" : line.slice(separator + 1).replace(/^ /, \"\");\n    if (field === \"data\") data.push(value);\n    return undefined;\n  }\n\n  try {\n    while (true) {\n      const next = await reader.read();\n      if (next.done) {\n        completed = true;\n        break;\n      }\n      buffer += decoder.decode(next.value, { stream: true });\n      const lines = buffer.split(/\\r?\\n/);\n      buffer = lines.pop() ?? \"\";\n      for (const line of lines) {\n        const complete = parseLine(line);\n        if (complete !== undefined) yield JSON.parse(complete) as TEvent;\n      }\n    }\n    buffer += decoder.decode();\n    if (buffer.length > 0) {\n      const complete = parseLine(buffer);\n      if (complete !== undefined) yield JSON.parse(complete) as TEvent;\n    }\n    if (data.length > 0) yield JSON.parse(data.join(\"\\n\")) as TEvent;\n  } finally {\n    if (!completed) await cancelReader(reader);\n    reader.releaseLock();\n  }\n}\n\nasync function cancelReader(reader: ReadableStreamDefaultReader<Uint8Array>): Promise<void> {\n  try {\n    await reader.cancel();\n  } catch {\n    // The request may already have been aborted by its owner.\n  }\n}\n"],"mappings":";AAAA,gBAAuB,gBACrB,QACuB;AACvB,QAAM,SAAS,OAAO,UAAU;AAChC,QAAM,UAAU,IAAI,YAAY;AAChC,MAAI,SAAS;AACb,MAAI,YAAY;AAEhB,MAAI;AACF,WAAO,MAAM;AACX,YAAM,OAAO,MAAM,OAAO,KAAK;AAC/B,UAAI,KAAK,MAAM;AACb,oBAAY;AACZ;AAAA,MACF;AACA,gBAAU,QAAQ,OAAO,KAAK,OAAO,EAAE,QAAQ,KAAK,CAAC;AACrD,YAAM,QAAQ,OAAO,MAAM,OAAO;AAClC,eAAS,MAAM,IAAI,KAAK;AACxB,iBAAW,QAAQ,OAAO;AACxB,cAAMA,SAAQ,KAAK,KAAK;AACxB,YAAIA,OAAM,SAAS,EAAG,OAAM,KAAK,MAAMA,MAAK;AAAA,MAC9C;AAAA,IACF;AACA,cAAU,QAAQ,OAAO;AACzB,UAAM,QAAQ,OAAO,KAAK;AAC1B,QAAI,MAAM,SAAS,EAAG,OAAM,KAAK,MAAM,KAAK;AAAA,EAC9C,UAAE;AACA,QAAI,CAAC,UAAW,OAAM,aAAa,MAAM;AACzC,WAAO,YAAY;AAAA,EACrB;AACF;AAEA,gBAAuB,cACrB,QACuB;AACvB,QAAM,SAAS,OAAO,UAAU;AAChC,QAAM,UAAU,IAAI,YAAY;AAChC,MAAI,SAAS;AACb,MAAI,OAAiB,CAAC;AACtB,MAAI,YAAY;AAEhB,WAAS,UAAU,MAAkC;AACnD,QAAI,SAAS,IAAI;AACf,YAAM,WAAW,KAAK,WAAW,IAAI,SAAY,KAAK,KAAK,IAAI;AAC/D,aAAO,CAAC;AACR,aAAO;AAAA,IACT;AACA,QAAI,KAAK,WAAW,GAAG,EAAG,QAAO;AACjC,UAAM,YAAY,KAAK,QAAQ,GAAG;AAClC,UAAM,QAAQ,cAAc,KAAK,OAAO,KAAK,MAAM,GAAG,SAAS;AAC/D,UAAM,QAAQ,cAAc,KAAK,KAAK,KAAK,MAAM,YAAY,CAAC,EAAE,QAAQ,MAAM,EAAE;AAChF,QAAI,UAAU,OAAQ,MAAK,KAAK,KAAK;AACrC,WAAO;AAAA,EACT;AAEA,MAAI;AACF,WAAO,MAAM;AACX,YAAM,OAAO,MAAM,OAAO,KAAK;AAC/B,UAAI,KAAK,MAAM;AACb,oBAAY;AACZ;AAAA,MACF;AACA,gBAAU,QAAQ,OAAO,KAAK,OAAO,EAAE,QAAQ,KAAK,CAAC;AACrD,YAAM,QAAQ,OAAO,MAAM,OAAO;AAClC,eAAS,MAAM,IAAI,KAAK;AACxB,iBAAW,QAAQ,OAAO;AACxB,cAAM,WAAW,UAAU,IAAI;AAC/B,YAAI,aAAa,OAAW,OAAM,KAAK,MAAM,QAAQ;AAAA,MACvD;AAAA,IACF;AACA,cAAU,QAAQ,OAAO;AACzB,QAAI,OAAO,SAAS,GAAG;AACrB,YAAM,WAAW,UAAU,MAAM;AACjC,UAAI,aAAa,OAAW,OAAM,KAAK,MAAM,QAAQ;AAAA,IACvD;AACA,QAAI,KAAK,SAAS,EAAG,OAAM,KAAK,MAAM,KAAK,KAAK,IAAI,CAAC;AAAA,EACvD,UAAE;AACA,QAAI,CAAC,UAAW,OAAM,aAAa,MAAM;AACzC,WAAO,YAAY;AAAA,EACrB;AACF;AAEA,eAAe,aAAa,QAAgE;AAC1F,MAAI;AACF,UAAM,OAAO,OAAO;AAAA,EACtB,QAAQ;AAAA,EAER;AACF;","names":["value"]}

package/dist/{chunk-2KGXQZWA.js → chunk-HZZDET2H.js}

@@ -1,83 +1,7 @@
-// src/transport/streams.ts
-async function* readJsonlStream(stream) {
-  const reader = stream.getReader();
-  const decoder = new TextDecoder();
-  let buffer = "";
-  let completed = false;
-  try {
-    while (true) {
-      const next = await reader.read();
-      if (next.done) {
-        completed = true;
-        break;
-      }
-      buffer += decoder.decode(next.value, { stream: true });
-      const lines = buffer.split(/\r?\n/);
-      buffer = lines.pop() ?? "";
-      for (const line of lines) {
-        const value2 = line.trim();
-        if (value2.length > 0) yield JSON.parse(value2);
-      }
-    }
-    buffer += decoder.decode();
-    const value = buffer.trim();
-    if (value.length > 0) yield JSON.parse(value);
-  } finally {
-    if (!completed) await cancelReader(reader);
-    reader.releaseLock();
-  }
-}
-async function* readSseStream(stream) {
-  const reader = stream.getReader();
-  const decoder = new TextDecoder();
-  let buffer = "";
-  let data = [];
-  let completed = false;
-  function parseLine(line) {
-    if (line === "") {
-      const complete = data.length === 0 ? void 0 : data.join("\n");
-      data = [];
-      return complete;
-    }
-    if (line.startsWith(":")) return void 0;
-    const separator = line.indexOf(":");
-    const field = separator === -1 ? line : line.slice(0, separator);
-    const value = separator === -1 ? "" : line.slice(separator + 1).replace(/^ /, "");
-    if (field === "data") data.push(value);
-    return void 0;
-  }
-  try {
-    while (true) {
-      const next = await reader.read();
-      if (next.done) {
-        completed = true;
-        break;
-      }
-      buffer += decoder.decode(next.value, { stream: true });
-      const lines = buffer.split(/\r?\n/);
-      buffer = lines.pop() ?? "";
-      for (const line of lines) {
-        const complete = parseLine(line);
-        if (complete !== void 0) yield JSON.parse(complete);
-      }
-    }
-    buffer += decoder.decode();
-    if (buffer.length > 0) {
-      const complete = parseLine(buffer);
-      if (complete !== void 0) yield JSON.parse(complete);
-    }
-    if (data.length > 0) yield JSON.parse(data.join("\n"));
-  } finally {
-    if (!completed) await cancelReader(reader);
-    reader.releaseLock();
-  }
-}
-async function cancelReader(reader) {
-  try {
-    await reader.cancel();
-  } catch {
-  }
-}
+import {
+  readJsonlStream,
+  readSseStream
+} from "./chunk-63JX2QNP.js";
 
 // src/transport/fetch.ts
 var EventStreamHttpError = class extends Error {
@@ -191,11 +115,9 @@ function mergeHeaders(...values) {
 }
 
 export {
-  readJsonlStream,
-  readSseStream,
   EventStreamHttpError,
   fetchEventStream,
   createFetchEventTransport,
   createDirectEventTransport
 };
-//# sourceMappingURL=chunk-2KGXQZWA.js.map
+//# sourceMappingURL=chunk-HZZDET2H.js.map

package/dist/chunk-HZZDET2H.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/transport/fetch.ts","../src/transport/event-transport.ts"],"sourcesContent":["import { readJsonlStream, readSseStream } from \"./streams\";\nimport type { EventStreamFormat } from \"./types\";\n\nexport type FetchEventStreamOptions = Omit<RequestInit, \"headers\"> & {\n  input: string | URL | Request;\n  format?: EventStreamFormat | \"auto\";\n  fetch?: typeof fetch;\n  headers?: HeadersInit;\n  validateResponse?: (response: Response) => void;\n};\n\nexport class EventStreamHttpError extends Error {\n  constructor(\n    readonly response: Response,\n    readonly body: string,\n  ) {\n    super(`Event stream request failed with status ${response.status}`);\n    this.name = \"EventStreamHttpError\";\n  }\n}\n\nexport async function* fetchEventStream<TEvent>(\n  options: FetchEventStreamOptions,\n): AsyncIterable<TEvent> {\n  const fetchImpl = options.fetch ?? globalThis.fetch;\n  if (fetchImpl === undefined) throw new Error(\"fetchEventStream requires a fetch implementation.\");\n\n  const response = await fetchImpl(options.input, fetchOptions(options));\n  if (!response.ok) throw new EventStreamHttpError(response, await response.text());\n  options.validateResponse?.(response);\n  if (response.body === null) throw new Error(\"Event stream response does not include a body.\");\n\n  const format =\n    options.format === undefined || options.format === \"auto\"\n      ? inferEventStreamFormat(response.headers.get(\"content-type\"))\n      : options.format;\n  if (format === \"sse\") {\n    yield* readSseStream<TEvent>(response.body);\n  } else {\n    yield* readJsonlStream<TEvent>(response.body);\n  }\n}\n\nfunction fetchOptions(options: FetchEventStreamOptions): RequestInit {\n  const {\n    input: _input,\n    format: _format,\n    fetch: _fetch,\n    validateResponse: _validate,\n    ...init\n  } = options;\n  return init;\n}\n\nfunction inferEventStreamFormat(contentType: string | null): EventStreamFormat {\n  return contentType?.toLowerCase().includes(\"text/event-stream\") ? \"sse\" : \"jsonl\";\n}\n","import { type FetchEventStreamOptions, fetchEventStream } from \"./fetch\";\nimport type { EventStreamFormat, EventTransport, EventTransportSendOptions } from \"./types\";\n\nexport type EventTransportContext<TRequest> = EventTransportSendOptions<TRequest>;\n\nexport type EventTransportBodyContext<TRequest> = Omit<\n  EventTransportContext<TRequest>,\n  \"headers\"\n> & {\n  headers: Headers;\n};\n\nexport type CreateFetchEventTransportOptions<TRequest, TEvent> = {\n  endpoint: string | URL | ((context: EventTransportContext<TRequest>) => string | URL);\n  method?: string;\n  format?: EventStreamFormat | \"auto\";\n  fetch?: typeof fetch;\n  headers?:\n    | HeadersInit\n    | ((context: EventTransportContext<TRequest>) => HeadersInit | Promise<HeadersInit>);\n  body?: (\n    context: EventTransportBodyContext<TRequest>,\n  ) => BodyInit | null | undefined | Promise<BodyInit | null | undefined>;\n  init?: Omit<RequestInit, \"body\" | \"headers\" | \"method\" | \"signal\">;\n  mapEvent?: (event: unknown) => TEvent;\n  validateResponse?: (response: Response) => void;\n};\n\nexport function createFetchEventTransport<TRequest, TEvent = unknown>(\n  options: CreateFetchEventTransportOptions<TRequest, TEvent>,\n): EventTransport<TRequest, TEvent> {\n  return {\n    async *send(transportOptions) {\n      const endpoint =\n        typeof options.endpoint === \"function\"\n          ? options.endpoint(transportOptions)\n          : options.endpoint;\n      const requestHeaders = await resolveHeaders(options.headers, transportOptions);\n      const headers = mergeHeaders(requestHeaders, transportOptions.headers);\n      const method = options.method ?? \"POST\";\n      const body = await resolveBody(options.body, transportOptions, headers, method);\n      const init: FetchEventStreamOptions = {\n        ...options.init,\n        input: endpoint,\n        method,\n        headers,\n        format: options.format ?? \"auto\",\n      };\n      if (body !== undefined) init.body = body;\n      if (transportOptions.abortSignal !== undefined) init.signal = transportOptions.abortSignal;\n      if (options.fetch !== undefined) init.fetch = options.fetch;\n      if (options.validateResponse !== undefined) init.validateResponse = options.validateResponse;\n\n      for await (const event of fetchEventStream<unknown>(init)) {\n        yield options.mapEvent === undefined ? (event as TEvent) : options.mapEvent(event);\n      }\n    },\n  };\n}\n\nexport function createDirectEventTransport<TRequest, TEvent>(options: {\n  handler(context: EventTransportContext<TRequest>): AsyncIterable<TEvent>;\n}): EventTransport<TRequest, TEvent> {\n  return {\n    async *send(context) {\n      const iterator = options.handler(context)[Symbol.asyncIterator]();\n      let closePromise: Promise<unknown> | undefined;\n      const close = () => {\n        closePromise ??= Promise.resolve(iterator.return?.());\n        return closePromise;\n      };\n      const onAbort = () => {\n        void close();\n      };\n      context.abortSignal?.addEventListener(\"abort\", onAbort, { once: true });\n      try {\n        while (!context.abortSignal?.aborted) {\n          const next = await iterator.next();\n          if (next.done) break;\n          yield next.value;\n        }\n      } finally {\n        context.abortSignal?.removeEventListener(\"abort\", onAbort);\n        await close();\n      }\n    },\n  };\n}\n\nasync function resolveHeaders<TRequest>(\n  headers: CreateFetchEventTransportOptions<TRequest, unknown>[\"headers\"],\n  context: EventTransportContext<TRequest>,\n): Promise<HeadersInit | undefined> {\n  return typeof headers === \"function\" ? headers(context) : headers;\n}\n\nasync function resolveBody<TRequest>(\n  body: CreateFetchEventTransportOptions<TRequest, unknown>[\"body\"],\n  context: EventTransportContext<TRequest>,\n  headers: Headers,\n  method: string,\n): Promise<BodyInit | null | undefined> {\n  if (body !== undefined) return body({ ...context, headers });\n  if (method.toUpperCase() === \"GET\" || method.toUpperCase() === \"HEAD\") return undefined;\n  if (!headers.has(\"content-type\")) headers.set(\"content-type\", \"application/json\");\n  return JSON.stringify(context.request);\n}\n\nfunction mergeHeaders(...values: Array<HeadersInit | undefined>): Headers {\n  const headers = new Headers();\n  for (const value of values) {\n    if (value === undefined) continue;\n    new Headers(value).forEach((headerValue, key) => {\n      headers.set(key, headerValue);\n    });\n  }\n  return headers;\n}\n"],"mappings":";;;;;;AAWO,IAAM,uBAAN,cAAmC,MAAM;AAAA,EAC9C,YACW,UACA,MACT;AACA,UAAM,2CAA2C,SAAS,MAAM,EAAE;AAHzD;AACA;AAGT,SAAK,OAAO;AAAA,EACd;AAAA,EALW;AAAA,EACA;AAKb;AAEA,gBAAuB,iBACrB,SACuB;AACvB,QAAM,YAAY,QAAQ,SAAS,WAAW;AAC9C,MAAI,cAAc,OAAW,OAAM,IAAI,MAAM,mDAAmD;AAEhG,QAAM,WAAW,MAAM,UAAU,QAAQ,OAAO,aAAa,OAAO,CAAC;AACrE,MAAI,CAAC,SAAS,GAAI,OAAM,IAAI,qBAAqB,UAAU,MAAM,SAAS,KAAK,CAAC;AAChF,UAAQ,mBAAmB,QAAQ;AACnC,MAAI,SAAS,SAAS,KAAM,OAAM,IAAI,MAAM,gDAAgD;AAE5F,QAAM,SACJ,QAAQ,WAAW,UAAa,QAAQ,WAAW,SAC/C,uBAAuB,SAAS,QAAQ,IAAI,cAAc,CAAC,IAC3D,QAAQ;AACd,MAAI,WAAW,OAAO;AACpB,WAAO,cAAsB,SAAS,IAAI;AAAA,EAC5C,OAAO;AACL,WAAO,gBAAwB,SAAS,IAAI;AAAA,EAC9C;AACF;AAEA,SAAS,aAAa,SAA+C;AACnE,QAAM;AAAA,IACJ,OAAO;AAAA,IACP,QAAQ;AAAA,IACR,OAAO;AAAA,IACP,kBAAkB;AAAA,IAClB,GAAG;AAAA,EACL,IAAI;AACJ,SAAO;AACT;AAEA,SAAS,uBAAuB,aAA+C;AAC7E,SAAO,aAAa,YAAY,EAAE,SAAS,mBAAmB,IAAI,QAAQ;AAC5E;;;AC5BO,SAAS,0BACd,SACkC;AAClC,SAAO;AAAA,IACL,OAAO,KAAK,kBAAkB;AAC5B,YAAM,WACJ,OAAO,QAAQ,aAAa,aACxB,QAAQ,SAAS,gBAAgB,IACjC,QAAQ;AACd,YAAM,iBAAiB,MAAM,eAAe,QAAQ,SAAS,gBAAgB;AAC7E,YAAM,UAAU,aAAa,gBAAgB,iBAAiB,OAAO;AACrE,YAAM,SAAS,QAAQ,UAAU;AACjC,YAAM,OAAO,MAAM,YAAY,QAAQ,MAAM,kBAAkB,SAAS,MAAM;AAC9E,YAAM,OAAgC;AAAA,QACpC,GAAG,QAAQ;AAAA,QACX,OAAO;AAAA,QACP;AAAA,QACA;AAAA,QACA,QAAQ,QAAQ,UAAU;AAAA,MAC5B;AACA,UAAI,SAAS,OAAW,MAAK,OAAO;AACpC,UAAI,iBAAiB,gBAAgB,OAAW,MAAK,SAAS,iBAAiB;AAC/E,UAAI,QAAQ,UAAU,OAAW,MAAK,QAAQ,QAAQ;AACtD,UAAI,QAAQ,qBAAqB,OAAW,MAAK,mBAAmB,QAAQ;AAE5E,uBAAiB,SAAS,iBAA0B,IAAI,GAAG;AACzD,cAAM,QAAQ,aAAa,SAAa,QAAmB,QAAQ,SAAS,KAAK;AAAA,MACnF;AAAA,IACF;AAAA,EACF;AACF;AAEO,SAAS,2BAA6C,SAExB;AACnC,SAAO;AAAA,IACL,OAAO,KAAK,SAAS;AACnB,YAAM,WAAW,QAAQ,QAAQ,OAAO,EAAE,OAAO,aAAa,EAAE;AAChE,UAAI;AACJ,YAAM,QAAQ,MAAM;AAClB,yBAAiB,QAAQ,QAAQ,SAAS,SAAS,CAAC;AACpD,eAAO;AAAA,MACT;AACA,YAAM,UAAU,MAAM;AACpB,aAAK,MAAM;AAAA,MACb;AACA,cAAQ,aAAa,iBAAiB,SAAS,SAAS,EAAE,MAAM,KAAK,CAAC;AACtE,UAAI;AACF,eAAO,CAAC,QAAQ,aAAa,SAAS;AACpC,gBAAM,OAAO,MAAM,SAAS,KAAK;AACjC,cAAI,KAAK,KAAM;AACf,gBAAM,KAAK;AAAA,QACb;AAAA,MACF,UAAE;AACA,gBAAQ,aAAa,oBAAoB,SAAS,OAAO;AACzD,cAAM,MAAM;AAAA,MACd;AAAA,IACF;AAAA,EACF;AACF;AAEA,eAAe,eACb,SACA,SACkC;AAClC,SAAO,OAAO,YAAY,aAAa,QAAQ,OAAO,IAAI;AAC5D;AAEA,eAAe,YACb,MACA,SACA,SACA,QACsC;AACtC,MAAI,SAAS,OAAW,QAAO,KAAK,EAAE,GAAG,SAAS,QAAQ,CAAC;AAC3D,MAAI,OAAO,YAAY,MAAM,SAAS,OAAO,YAAY,MAAM,OAAQ,QAAO;AAC9E,MAAI,CAAC,QAAQ,IAAI,cAAc,EAAG,SAAQ,IAAI,gBAAgB,kBAAkB;AAChF,SAAO,KAAK,UAAU,QAAQ,OAAO;AACvC;AAEA,SAAS,gBAAgB,QAAiD;AACxE,QAAM,UAAU,IAAI,QAAQ;AAC5B,aAAW,SAAS,QAAQ;AAC1B,QAAI,UAAU,OAAW;AACzB,QAAI,QAAQ,KAAK,EAAE,QAAQ,CAAC,aAAa,QAAQ;AAC/C,cAAQ,IAAI,KAAK,WAAW;AAAA,IAC9B,CAAC;AAAA,EACH;AACA,SAAO;AACT;","names":[]}

package/dist/durable.d.ts

@@ -0,0 +1,64 @@
+import { TaskSubmission, TaskSnapshot, TaskGraphSnapshot, TaskListOptions, TaskPage, TaskEvent, DurableGraphSubmission, DurableGraphSnapshot, DurableGraphListOptions, DurableGraphPage, DurableGraphEvent, DurableSubmission, DurableSubmitOptions, DurableSnapshot, DurableListOptions, DurableRunPage, DurableEvent } from '@anvia/durable/protocol';
+import { AgentInteractionResponse } from '@anvia/core/agent/interactions';
+import { JsonValue, ToolResultOutput } from '@anvia/core/completion';
+
+type DurableRequestOptions = {
+    abortSignal?: AbortSignal;
+};
+type DurableClientOptions = {
+    /** Absolute HTTP(S) URL matching the server handler's basePath. */
+    endpoint: string;
+    fetch?: typeof fetch;
+    headers?: HeadersInit | (() => HeadersInit | Promise<HeadersInit>);
+    credentials?: RequestCredentials;
+};
+declare class DurableHttpError extends Error {
+    readonly status: number;
+    constructor(status: number);
+}
+/** Browser-safe HTTP client. Reconnect explicitly using a snapshot or last applied event cursor. */
+declare class DurableClient {
+    private readonly options;
+    private readonly endpoint;
+    constructor(options: DurableClientOptions);
+    submitTask(submission: TaskSubmission, options?: DurableRequestOptions): Promise<TaskSnapshot>;
+    taskSnapshot(id: string, options?: DurableRequestOptions): Promise<TaskSnapshot>;
+    taskGraph(id: string, options?: DurableRequestOptions): Promise<TaskGraphSnapshot>;
+    listTasks(filter: TaskListOptions & {
+        sessionId: string;
+    }, options?: DurableRequestOptions): Promise<TaskPage>;
+    signalTask(id: string, name: string, requestId: string, value: JsonValue, options?: DurableRequestOptions): Promise<void>;
+    resolveEffect(id: string, key: string, value: JsonValue, options?: DurableRequestOptions): Promise<void>;
+    retryTask(id: string, options?: DurableRequestOptions): Promise<void>;
+    cancelTask(id: string, options?: DurableRequestOptions): Promise<void>;
+    streamTask(id: string, options?: DurableRequestOptions & {
+        after?: number;
+    }): AsyncIterable<TaskEvent>;
+    private taskPath;
+    submitGraph(submission: DurableGraphSubmission, options?: DurableRequestOptions): Promise<DurableGraphSnapshot>;
+    graphSnapshot(graphId: string, options?: DurableRequestOptions): Promise<DurableGraphSnapshot>;
+    listGraphs(filter: DurableGraphListOptions & {
+        sessionId: string;
+    }, options?: DurableRequestOptions): Promise<DurableGraphPage>;
+    cancelGraph(graphId: string, options?: DurableRequestOptions): Promise<void>;
+    streamGraph(graphId: string, options?: DurableRequestOptions & {
+        after?: number;
+    }): AsyncIterable<DurableGraphEvent>;
+    submit(submission: DurableSubmission, options?: DurableSubmitOptions & DurableRequestOptions): Promise<DurableSnapshot>;
+    listRuns(filter: DurableListOptions & {
+        sessionId: string;
+    }, options?: DurableRequestOptions): Promise<DurableRunPage>;
+    snapshot(runId: string, options?: DurableRequestOptions): Promise<DurableSnapshot>;
+    stream(runId: string, options?: DurableRequestOptions & {
+        after?: number;
+    }): AsyncIterable<DurableEvent>;
+    respond(runId: string, interactionId: string, response: AgentInteractionResponse, options?: DurableRequestOptions): Promise<void>;
+    resolveTool(runId: string, operationId: string, output: ToolResultOutput, options?: DurableRequestOptions): Promise<void>;
+    retry(runId: string, options?: DurableRequestOptions): Promise<void>;
+    cancel(runId: string, options?: DurableRequestOptions): Promise<void>;
+    private graphPath;
+    private path;
+    private request;
+}
+
+export { DurableClient, type DurableClientOptions, DurableHttpError, type DurableRequestOptions };