@guuey/agent-client 0.3.1 → 0.4.0

package/README.md

@@ -34,7 +34,11 @@ import { createWebAdapters } from "@guuey/agent-client";
 
 export function Chat({ endpointUrl, appId }: { endpointUrl: string; appId: string }) {
   const adapters = createWebAdapters({ getAccessToken: async () => myToken });
-  const { messages, send, isStreaming } = useAgentInvoke({ endpointUrl, appId, adapters });
+  const { messages, send, status, activeTool, error } = useAgentInvoke({
+    endpointUrl,
+    appId,
+    adapters,
+  });
 
   return (
     <>
@@ -43,7 +47,10 @@ export function Chat({ endpointUrl, appId }: { endpointUrl: string; appId: strin
           {m.text}
         </p>
       ))}
-      <button disabled={isStreaming} onClick={() => send("hello")}>
+      {status === "connecting" && <p>Waking your agent…</p>}
+      {status === "using-tool" && <p>Using {activeTool}…</p>}
+      {error && <p role="alert">{error}</p>}
+      <button disabled={status !== "ready"} onClick={() => send("hello")}>
         Send
       </button>
     </>
@@ -51,6 +58,12 @@ export function Chat({ endpointUrl, appId }: { endpointUrl: string; appId: strin
 }
 ```
 
+`status` walks the turn lifecycle — `ready` → `connecting` → `thinking` /
+`using-tool` (with `activeTool` naming the tool) / `responding` → back to
+`ready`. Failures never occupy `status`; they land in `error` and the
+composer re-enables. The full vocabulary is documented at
+[docs.guuey.com/sdk](https://docs.guuey.com/sdk).
+
 On React Native, supply your own adapters (AsyncStorage + an `expo/fetch`
 transport) in place of `createWebAdapters` — the hook's contract is identical.
 

package/dist/error-codes.d.ts

@@ -0,0 +1,58 @@
+/**
+ * The pod's error-envelope wire codes, TRANSCRIBED.
+ *
+ * The source of truth is the runtime's own private module
+ * (`backend/services/nocode-runtime/src/error-codes.ts`). This package is
+ * published to npm and cannot take a `@guuey-private` dependency, so it keeps
+ * its own copy — the same arrangement as {@link GUEST_HEADER} in
+ * `./web-adapters.ts` and `@guuey/host`'s mirrored fs-contract constants. The
+ * copies are not trusted to prose alone: `agent-client-codes.sync.test.ts` in
+ * the runtime package (which can import BOTH) asserts they stay identical, so
+ * renaming a code on either side fails that test rather than silently breaking
+ * a client branch.
+ *
+ * WIRE CONTRACT (what these codes appear in):
+ *
+ *  - a pre-stream refusal — `{ "code": …, "message": … }` with an HTTP status,
+ *    parsed into {@link AgentResponseError};
+ *  - an in-band failure — `event: error` / `data: { code, message }`, surfaced
+ *    as `useAgentInvoke`'s `errorCode`.
+ *
+ * Both channels carry the SAME vocabulary, which is why one mirror serves them.
+ */
+export declare const AGENT_ERROR_CODES: {
+    /** No usable identity on a surface that requires one. */
+    readonly UNAUTHORIZED: "UNAUTHORIZED";
+    /** The invoke body did not parse / validate. */
+    readonly INVALID_REQUEST: "INVALID_REQUEST";
+    /** The builder turned anonymous access off for this agent. */
+    readonly GUEST_ACCESS_DISABLED: "GUEST_ACCESS_DISABLED";
+    /** The caller (or the app) is out of plan allowance — the upgrade prompt. */
+    readonly QUOTA_EXCEEDED: "QUOTA_EXCEEDED";
+    /** The app hit its builder-set managed spend cap. */
+    readonly MANAGED_SPEND_CAP: "MANAGED_SPEND_CAP";
+    /**
+     * The pod is at its concurrent-turn cap (scaling S1-F3). A 503 carrying a
+     * `Retry-After` hint, and the ONE code {@link fetchStreamTransport} retries
+     * by itself — see its docblock for the single-attempt rule.
+     */
+    readonly POD_SATURATED: "POD_SATURATED";
+    /**
+     * The pod took SIGTERM and refuses NEW turns while in-flight ones finish.
+     * Also a 503 + `Retry-After`, but deliberately NOT auto-retried (the
+     * endpoint pull re-routes the next request; retrying into the same pod is
+     * the one thing guaranteed not to help).
+     */
+    readonly DRAINING: "DRAINING";
+    /** Refused for this caller — e.g. the link-prompt dismiss route's byo-only rule. */
+    readonly FORBIDDEN: "FORBIDDEN";
+    /** The turn ran past the pod's wall-clock budget. */
+    readonly TIMEOUT: "TIMEOUT";
+    /** A guuey-side dependency failed (not the agent's own code). */
+    readonly PLATFORM_ERROR: "PLATFORM_ERROR";
+    /** Unclassified pod failure. */
+    readonly INTERNAL: "INTERNAL";
+};
+/** One of the pod's wire codes — see {@link AGENT_ERROR_CODES}. */
+export type AgentErrorCode = (typeof AGENT_ERROR_CODES)[keyof typeof AGENT_ERROR_CODES];
+//# sourceMappingURL=error-codes.d.ts.map

package/dist/error-codes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-codes.d.ts","sourceRoot":"","sources":["../src/error-codes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,iBAAiB;IAC5B,yDAAyD;;IAEzD,gDAAgD;;IAEhD,8DAA8D;;IAE9D,6EAA6E;;IAE7E,qDAAqD;;IAErD;;;;OAIG;;IAEH;;;;;OAKG;;IAEH,oFAAoF;;IAEpF,qDAAqD;;IAErD,iEAAiE;;IAEjE,gCAAgC;;CAExB,CAAC;AAEX,mEAAmE;AACnE,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,OAAO,iBAAiB,CAAC,CAAC"}

package/dist/error-codes.js

@@ -0,0 +1,55 @@
+/**
+ * The pod's error-envelope wire codes, TRANSCRIBED.
+ *
+ * The source of truth is the runtime's own private module
+ * (`backend/services/nocode-runtime/src/error-codes.ts`). This package is
+ * published to npm and cannot take a `@guuey-private` dependency, so it keeps
+ * its own copy — the same arrangement as {@link GUEST_HEADER} in
+ * `./web-adapters.ts` and `@guuey/host`'s mirrored fs-contract constants. The
+ * copies are not trusted to prose alone: `agent-client-codes.sync.test.ts` in
+ * the runtime package (which can import BOTH) asserts they stay identical, so
+ * renaming a code on either side fails that test rather than silently breaking
+ * a client branch.
+ *
+ * WIRE CONTRACT (what these codes appear in):
+ *
+ *  - a pre-stream refusal — `{ "code": …, "message": … }` with an HTTP status,
+ *    parsed into {@link AgentResponseError};
+ *  - an in-band failure — `event: error` / `data: { code, message }`, surfaced
+ *    as `useAgentInvoke`'s `errorCode`.
+ *
+ * Both channels carry the SAME vocabulary, which is why one mirror serves them.
+ */
+export const AGENT_ERROR_CODES = {
+    /** No usable identity on a surface that requires one. */
+    UNAUTHORIZED: "UNAUTHORIZED",
+    /** The invoke body did not parse / validate. */
+    INVALID_REQUEST: "INVALID_REQUEST",
+    /** The builder turned anonymous access off for this agent. */
+    GUEST_ACCESS_DISABLED: "GUEST_ACCESS_DISABLED",
+    /** The caller (or the app) is out of plan allowance — the upgrade prompt. */
+    QUOTA_EXCEEDED: "QUOTA_EXCEEDED",
+    /** The app hit its builder-set managed spend cap. */
+    MANAGED_SPEND_CAP: "MANAGED_SPEND_CAP",
+    /**
+     * The pod is at its concurrent-turn cap (scaling S1-F3). A 503 carrying a
+     * `Retry-After` hint, and the ONE code {@link fetchStreamTransport} retries
+     * by itself — see its docblock for the single-attempt rule.
+     */
+    POD_SATURATED: "POD_SATURATED",
+    /**
+     * The pod took SIGTERM and refuses NEW turns while in-flight ones finish.
+     * Also a 503 + `Retry-After`, but deliberately NOT auto-retried (the
+     * endpoint pull re-routes the next request; retrying into the same pod is
+     * the one thing guaranteed not to help).
+     */
+    DRAINING: "DRAINING",
+    /** Refused for this caller — e.g. the link-prompt dismiss route's byo-only rule. */
+    FORBIDDEN: "FORBIDDEN",
+    /** The turn ran past the pod's wall-clock budget. */
+    TIMEOUT: "TIMEOUT",
+    /** A guuey-side dependency failed (not the agent's own code). */
+    PLATFORM_ERROR: "PLATFORM_ERROR",
+    /** Unclassified pod failure. */
+    INTERNAL: "INTERNAL",
+};

package/dist/errors.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Error types the transports throw and the hook branches on.
+ *
+ * Its own module (rather than living in `./web-adapters.ts`) so `useAgentInvoke`
+ * — which must stay platform-agnostic — can `instanceof`-narrow a caught error
+ * without pulling the web adapter bundle (`fetch`, the history reader,
+ * `@guuey/mcp-apps-host`) into a React-Native build.
+ */
+/**
+ * Thrown when the pod returns a non-2xx status on `/agent/invoke` (before any
+ * SSE stream opens). Carries the pod's structured `{ code, message }` when
+ * present — e.g. a `QUOTA_EXCEEDED` 429 whose message ("…reached its plan
+ * generation limit…") the chat UI should surface — falling back to the bare
+ * status for non-JSON failures. See `AGENT_ERROR_CODES` for the vocabulary.
+ */
+export declare class AgentResponseError extends Error {
+    readonly status: number;
+    readonly code?: string | undefined;
+    /**
+     * The response's `Retry-After` hint in whole seconds, when it sent a
+     * parseable one. The pod attaches it to its two 503 refusals
+     * (`POD_SATURATED`, `DRAINING`) and exposes the header across origins via
+     * `Access-Control-Expose-Headers`, so a browser client can actually read
+     * it. `undefined` when the header was absent, malformed, or in the
+     * HTTP-date form the pod never emits.
+     */
+    readonly retryAfterSeconds?: number | undefined;
+    constructor(message: string, status: number, code?: string | undefined, 
+    /**
+     * The response's `Retry-After` hint in whole seconds, when it sent a
+     * parseable one. The pod attaches it to its two 503 refusals
+     * (`POD_SATURATED`, `DRAINING`) and exposes the header across origins via
+     * `Access-Control-Expose-Headers`, so a browser client can actually read
+     * it. `undefined` when the header was absent, malformed, or in the
+     * HTTP-date form the pod never emits.
+     */
+    retryAfterSeconds?: number | undefined);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;;GAMG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;IAGzC,QAAQ,CAAC,MAAM,EAAE,MAAM;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM;IACtB;;;;;;;OAOG;IACH,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM;gBAXnC,OAAO,EAAE,MAAM,EACN,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,MAAM,YAAA;IACtB;;;;;;;OAOG;IACM,iBAAiB,CAAC,EAAE,MAAM,YAAA;CAKtC"}

package/dist/errors.js

@@ -0,0 +1,36 @@
+/**
+ * Error types the transports throw and the hook branches on.
+ *
+ * Its own module (rather than living in `./web-adapters.ts`) so `useAgentInvoke`
+ * — which must stay platform-agnostic — can `instanceof`-narrow a caught error
+ * without pulling the web adapter bundle (`fetch`, the history reader,
+ * `@guuey/mcp-apps-host`) into a React-Native build.
+ */
+/**
+ * Thrown when the pod returns a non-2xx status on `/agent/invoke` (before any
+ * SSE stream opens). Carries the pod's structured `{ code, message }` when
+ * present — e.g. a `QUOTA_EXCEEDED` 429 whose message ("…reached its plan
+ * generation limit…") the chat UI should surface — falling back to the bare
+ * status for non-JSON failures. See `AGENT_ERROR_CODES` for the vocabulary.
+ */
+export class AgentResponseError extends Error {
+    status;
+    code;
+    retryAfterSeconds;
+    constructor(message, status, code, 
+    /**
+     * The response's `Retry-After` hint in whole seconds, when it sent a
+     * parseable one. The pod attaches it to its two 503 refusals
+     * (`POD_SATURATED`, `DRAINING`) and exposes the header across origins via
+     * `Access-Control-Expose-Headers`, so a browser client can actually read
+     * it. `undefined` when the header was absent, malformed, or in the
+     * HTTP-date form the pod never emits.
+     */
+    retryAfterSeconds) {
+        super(message);
+        this.status = status;
+        this.code = code;
+        this.retryAfterSeconds = retryAfterSeconds;
+        this.name = "AgentResponseError";
+    }
+}

package/dist/history.d.ts

@@ -11,7 +11,7 @@
  * has its own copy today and can migrate onto this later.
  */
 import type { AgMessage, JsonValue } from "@silverprotocol/core";
-import type { AgentMessage, HistoryCard, HistoryLoadResult } from "./types";
+import type { AgentMessage, HistoryCard, HistoryLoadResult } from "./types.js";
 /** One row of `GET /v1/threads/:id/messages`. */
 export interface ThreadHistoryRow {
     seq: number;

package/dist/history.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../src/history.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAE5E,iDAAiD;AACjD,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB;;;;OAIG;IACH,YAAY,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;CACjC;AAOD;;;;;;;;GAQG;AACH,qBAAa,wBAAyB,SAAQ,KAAK;gBACrC,OAAO,SAA6B;CAIjD;AAeD,qEAAqE;AACrE,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,gBAAgB,EAAE,GAAG,YAAY,EAAE,CAOpF;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,gBAAgB,EAAE,GAAG,WAAW,EAAE,CAOhF;AAED,MAAM,WAAW,yBAAyB;IACxC,uDAAuD;IACvD,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,2EAA2E;IAC3E,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B;;;;;OAKG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,gEAAgE;IAChE,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B;AAED;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CAAC,EACvC,OAAO,EACP,QAAQ,EACR,WAAW,EACX,YAAoB,EACpB,SAAiB,GAClB,EAAE,yBAAyB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAuBxD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAK1E;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,WAAW,EAAE,GAAG,WAAW,EAAE,CAE7E"}
+{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../src/history.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE/E,iDAAiD;AACjD,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB;;;;OAIG;IACH,YAAY,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;CACjC;AAOD;;;;;;;;GAQG;AACH,qBAAa,wBAAyB,SAAQ,KAAK;gBACrC,OAAO,SAA6B;CAIjD;AAeD,qEAAqE;AACrE,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,gBAAgB,EAAE,GAAG,YAAY,EAAE,CAOpF;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,gBAAgB,EAAE,GAAG,WAAW,EAAE,CAOhF;AAED,MAAM,WAAW,yBAAyB;IACxC,uDAAuD;IACvD,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,2EAA2E;IAC3E,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B;;;;;OAKG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,gEAAgE;IAChE,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B;AAED;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CAAC,EACvC,OAAO,EACP,QAAQ,EACR,WAAW,EACX,YAAoB,EACpB,SAAiB,GAClB,EAAE,yBAAyB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAuBxD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAK1E;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,WAAW,EAAE,GAAG,WAAW,EAAE,CAE7E"}

package/dist/index.d.ts

@@ -1,9 +1,12 @@
-export { parseSseEvents, extractAssistantText, reduceAssistantText, stringField, parseConsentRequest, parseLinkRequest, type ParsedSseEvent, } from "./sse";
-export { dismissLinkPrompt } from "./link-prompt";
-export { createUiResourceReader, type CreateUiResourceReaderOptions, createWebAdapters, localStorageThreadStore, webGenerateId, fetchStreamTransport, AgentResponseError, type CreateWebAdaptersOptions, } from "./web-adapters";
-export { fetchThreadHistory, threadHistoryRowsToMessages, threadHistoryRowsToCards, HistoryUnauthorizedError, type ThreadHistoryRow, type ThreadHistoryFetchOptions, } from "./history";
-export { ingestMessageFrame } from "./blocks";
-export { sortHistoryCards, toolNameFor } from "./history";
+export { parseSseEvents, extractAssistantText, reduceAssistantText, stringField, parseConsentRequest, parseLinkRequest, type ParsedSseEvent, } from "./sse.js";
+export { dismissLinkPrompt } from "./link-prompt.js";
+export { createUiActionRelay, type CreateUiActionRelayOptions, createUiResourceReader, type CreateUiResourceReaderOptions, createWebAdapters, localStorageThreadStore, webGenerateId, fetchStreamTransport, type CreateWebAdaptersOptions, } from "./web-adapters.js";
+export { withSaturationRetry, parseRetryAfterSeconds, type SaturationRetryOptions, } from "./saturation-retry.js";
+export { AgentResponseError } from "./errors.js";
+export { AGENT_ERROR_CODES, type AgentErrorCode } from "./error-codes.js";
+export { fetchThreadHistory, threadHistoryRowsToMessages, threadHistoryRowsToCards, HistoryUnauthorizedError, type ThreadHistoryRow, type ThreadHistoryFetchOptions, } from "./history.js";
+export { ingestMessageFrame } from "./blocks.js";
+export { sortHistoryCards, toolNameFor } from "./history.js";
 export type { AgEvent, AgReduceResult, AgMessage, AgBlock } from "@silverprotocol/core";
-export type { AgentMessage, HistoryCard, ProfileConsentRequest, ProfileLinkRequest, ThreadIdStore, GenerateId, InvokeRequest, InvokeTransport, AgentInvokeAdapters, AgentInvokeHistoryAdapter, AgentInvokeStatus, HistoryLoadResult, UseAgentInvokeOptions, UseAgentInvokeReturn, } from "./types";
+export type { AgentMessage, HistoryCard, ProfileConsentRequest, ProfileLinkRequest, ThreadIdStore, GenerateId, InvokeRequest, InvokeTransport, AgentInvokeAdapters, AgentInvokeHistoryAdapter, AgentInvokeStatus, HistoryLoadResult, UseAgentInvokeOptions, UseAgentInvokeReturn, } from "./types.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,mBAAmB,EACnB,WAAW,EACX,mBAAmB,EACnB,gBAAgB,EAChB,KAAK,cAAc,GACpB,MAAM,OAAO,CAAC;AACf,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EACL,sBAAsB,EACtB,KAAK,6BAA6B,EAClC,iBAAiB,EACjB,uBAAuB,EACvB,aAAa,EACb,oBAAoB,EACpB,kBAAkB,EAClB,KAAK,wBAAwB,GAC9B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,kBAAkB,EAClB,2BAA2B,EAC3B,wBAAwB,EACxB,wBAAwB,EACxB,KAAK,gBAAgB,EACrB,KAAK,yBAAyB,GAC/B,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAK9C,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAI1D,YAAY,EAAE,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACxF,YAAY,EACV,YAAY,EACZ,WAAW,EACX,qBAAqB,EACrB,kBAAkB,EAClB,aAAa,EACb,UAAU,EACV,aAAa,EACb,eAAe,EACf,mBAAmB,EACnB,yBAAyB,EACzB,iBAAiB,EACjB,iBAAiB,EACjB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,mBAAmB,EACnB,WAAW,EACX,mBAAmB,EACnB,gBAAgB,EAChB,KAAK,cAAc,GACpB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EACL,mBAAmB,EACnB,KAAK,0BAA0B,EAC/B,sBAAsB,EACtB,KAAK,6BAA6B,EAClC,iBAAiB,EACjB,uBAAuB,EACvB,aAAa,EACb,oBAAoB,EACpB,KAAK,wBAAwB,GAC9B,MAAM,mBAAmB,CAAC;AAO3B,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,KAAK,sBAAsB,GAC5B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAGjD,OAAO,EAAE,iBAAiB,EAAE,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC1E,OAAO,EACL,kBAAkB,EAClB,2BAA2B,EAC3B,wBAAwB,EACxB,wBAAwB,EACxB,KAAK,gBAAgB,EACrB,KAAK,yBAAyB,GAC/B,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAKjD,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAI7D,YAAY,EAAE,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACxF,YAAY,EACV,YAAY,EACZ,WAAW,EACX,qBAAqB,EACrB,kBAAkB,EAClB,aAAa,EACb,UAAU,EACV,aAAa,EACb,eAAe,EACf,mBAAmB,EACnB,yBAAyB,EACzB,iBAAiB,EACjB,iBAAiB,EACjB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -1,10 +1,21 @@
-export { parseSseEvents, extractAssistantText, reduceAssistantText, stringField, parseConsentRequest, parseLinkRequest, } from "./sse";
-export { dismissLinkPrompt } from "./link-prompt";
-export { createUiResourceReader, createWebAdapters, localStorageThreadStore, webGenerateId, fetchStreamTransport, AgentResponseError, } from "./web-adapters";
-export { fetchThreadHistory, threadHistoryRowsToMessages, threadHistoryRowsToCards, HistoryUnauthorizedError, } from "./history";
-export { ingestMessageFrame } from "./blocks";
+export { parseSseEvents, extractAssistantText, reduceAssistantText, stringField, parseConsentRequest, parseLinkRequest, } from "./sse.js";
+export { dismissLinkPrompt } from "./link-prompt.js";
+export { createUiActionRelay, createUiResourceReader, createWebAdapters, localStorageThreadStore, webGenerateId, fetchStreamTransport, } from "./web-adapters.js";
+// The `POD_SATURATED` single-retry wrapper, transport-agnostic: a host that
+// brings its own `fetch` (Portal's React-Native transport) wraps it to wear the
+// same semantics as the web transport instead of hand-rolling a second copy.
+// `parseRetryAfterSeconds` ships with it because filling
+// `AgentResponseError.retryAfterSeconds` the same way is what makes the wrapper
+// honour the pod's hint.
+export { withSaturationRetry, parseRetryAfterSeconds, } from "./saturation-retry.js";
+export { AgentResponseError } from "./errors.js";
+// The pod's wire-code vocabulary, mirrored — branch on these instead of
+// re-typing the string literals (see the module docblock for the sync guard).
+export { AGENT_ERROR_CODES } from "./error-codes.js";
+export { fetchThreadHistory, threadHistoryRowsToMessages, threadHistoryRowsToCards, HistoryUnauthorizedError, } from "./history.js";
+export { ingestMessageFrame } from "./blocks.js";
 // Pure block-walk / resource-narrowing helpers for a block-preserving renderer
 // (shared by Studio's `AgentBlocks` and Portal-web's agent chat). React-free.
 // Transcript labeling/ordering helpers (mount narrowing itself moved to
 // @guuey/mcp-apps-host — the SEP-1865 Host role package; import it directly).
-export { sortHistoryCards, toolNameFor } from "./history";
+export { sortHistoryCards, toolNameFor } from "./history.js";

package/dist/react.d.ts

@@ -6,6 +6,6 @@
  * history reader, and the web adapters). Consumers that only need those never
  * import React at all; consumers that render chat import the hook from here.
  */
-export { useAgentInvoke, applyHistoryResult, type HistoryApplication } from "./useAgentInvoke";
+export { useAgentInvoke, applyHistoryResult, type HistoryApplication } from "./useAgentInvoke.js";
 export type { AgEvent, AgReduceResult } from "@silverprotocol/core";
 //# sourceMappingURL=react.d.ts.map

package/dist/react.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../src/react.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,KAAK,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAI/F,YAAY,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../src/react.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,KAAK,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAIlG,YAAY,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/react.js

@@ -6,4 +6,4 @@
  * history reader, and the web adapters). Consumers that only need those never
  * import React at all; consumers that render chat import the hook from here.
  */
-export { useAgentInvoke, applyHistoryResult } from "./useAgentInvoke";
+export { useAgentInvoke, applyHistoryResult } from "./useAgentInvoke.js";

package/dist/saturation-retry.d.ts

@@ -0,0 +1,60 @@
+import type { InvokeTransport } from "./types.js";
+/**
+ * Read `Retry-After` as WHOLE SECONDS, or `undefined`.
+ *
+ * HTTP also allows an absolute HTTP-date, which is deliberately NOT parsed:
+ * the pod only ever emits a delta-seconds integer, and silently mis-reading a
+ * date as `NaN` seconds is worse than falling back to the fixed delay.
+ *
+ * Exported because every transport that builds an {@link AgentResponseError}
+ * has to fill `retryAfterSeconds` the same way for {@link withSaturationRetry}
+ * to honour the same hint — a second hand-rolled regex in a host adapter is
+ * exactly the drift this module exists to prevent.
+ */
+export declare function parseRetryAfterSeconds(header: string | null): number | undefined;
+/** Options for {@link withSaturationRetry}. */
+export interface SaturationRetryOptions {
+    /**
+     * The saturation-retry wait. Injectable so tests drive the retry without a
+     * real 15s timer; production uses an abort-aware `setTimeout`.
+     */
+    sleep?: (ms: number, signal: AbortSignal) => Promise<void>;
+}
+/**
+ * Wrap an invoke transport with ONE automatic retry on a saturated pod.
+ *
+ * ## What retries, and what deliberately does not
+ *
+ * `POD_SATURATED` (503) means the pod is at its concurrent-turn cap right now
+ * — a transient queue state that clears as in-flight turns finish, so a single
+ * delayed re-send usually just works. The wait is the pod's own `Retry-After`
+ * hint (via {@link AgentResponseError.retryAfterSeconds}), defaulting to 15s
+ * when it sent none and capped at 30s.
+ *
+ * `DRAINING` (also 503 + `Retry-After`) is NOT retried in v1. The refusing pod
+ * is shutting down: its readiness probe is already failing and the endpoint
+ * pull is in flight, so the useful retry is the one that reaches a DIFFERENT
+ * pod — and a wrapped transport re-sends to the same URL. Retrying here would
+ * spend the user's 15s to arrive back at the same draining pod (or at a fresh
+ * one by luck), which is not a guarantee worth building on. When the retry can
+ * be made routing-aware, this is the code to revisit.
+ *
+ * Exactly ONE retry: a second saturation propagates as
+ * {@link AgentResponseError}, so a genuinely overloaded agent surfaces instead
+ * of looping. Nothing is retried once a chunk has been yielded — replaying
+ * mid-stream would duplicate a partial assistant turn (the same `yielded`
+ * guard the widget's `withIdentifiedToken` 401-retry uses). An abort during
+ * the wait skips the retry and surfaces the original refusal.
+ *
+ * The retry is INVISIBLE to `useAgentInvoke`: no frames were yielded, so the
+ * turn simply stays in `connecting` for the duration of the wait. There is no
+ * `retrying` status by design — the hook's state machine describes the pod's
+ * turn lifecycle, not the transport's plumbing.
+ *
+ * The wrapped transport is re-invoked from scratch for the retry, so a host
+ * that resolves identity inside its own generator (Portal's RN transport reads
+ * the bearer bridge per attempt) re-reads it on the second try rather than
+ * replaying a token that may have expired during the wait.
+ */
+export declare function withSaturationRetry(transport: InvokeTransport, options?: SaturationRetryOptions): InvokeTransport;
+//# sourceMappingURL=saturation-retry.d.ts.map

package/dist/saturation-retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"saturation-retry.d.ts","sourceRoot":"","sources":["../src/saturation-retry.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAiB,eAAe,EAAE,MAAM,YAAY,CAAC;AAiBjE;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,SAAS,CAMhF;AA4BD,+CAA+C;AAC/C,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5D;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,eAAe,EAC1B,OAAO,GAAE,sBAA2B,GACnC,eAAe,CAqBjB"}

package/dist/saturation-retry.js

@@ -0,0 +1,135 @@
+/**
+ * The single `POD_SATURATED` auto-retry, as a transport-agnostic wrapper.
+ *
+ * Its own module — rather than living inside `./web-adapters.ts`, where it was
+ * born — because the behaviour is a property of the POD's refusal vocabulary,
+ * not of `fetch`. Every host that speaks `/agent/invoke` wants it, including
+ * the ones that cannot import the web adapter bundle: Portal's React-Native
+ * transport wraps its own `fetch` call with {@link withSaturationRetry} the
+ * same way `fetchStreamTransport` wraps its browser streaming reader, so the
+ * two wear byte-identical retry semantics instead of two hand-written copies
+ * that drift.
+ *
+ * This module imports only `./types.js`, `./errors.js` and `./error-codes.js`
+ * — all pure — so pulling it in costs a React-Native build nothing.
+ */
+import { AGENT_ERROR_CODES } from "./error-codes.js";
+import { AgentResponseError } from "./errors.js";
+/**
+ * Fallback wait before the saturation retry when the pod sent no usable
+ * `Retry-After` — the same 15s the pod's governor hints today
+ * (`GOVERNOR_RETRY_AFTER_SECONDS`), so a stripped header behaves like the
+ * normal case rather than hammering.
+ */
+const SATURATION_FALLBACK_DELAY_SECONDS = 15;
+/**
+ * Ceiling on the honoured hint. A pod that (mis)configures a multi-minute
+ * `Retry-After` must not park a chat UI in `connecting` for that long — past
+ * this the user is better served by the visible failure they can act on.
+ */
+const SATURATION_MAX_DELAY_SECONDS = 30;
+/**
+ * Read `Retry-After` as WHOLE SECONDS, or `undefined`.
+ *
+ * HTTP also allows an absolute HTTP-date, which is deliberately NOT parsed:
+ * the pod only ever emits a delta-seconds integer, and silently mis-reading a
+ * date as `NaN` seconds is worse than falling back to the fixed delay.
+ *
+ * Exported because every transport that builds an {@link AgentResponseError}
+ * has to fill `retryAfterSeconds` the same way for {@link withSaturationRetry}
+ * to honour the same hint — a second hand-rolled regex in a host adapter is
+ * exactly the drift this module exists to prevent.
+ */
+export function parseRetryAfterSeconds(header) {
+    if (header === null)
+        return undefined;
+    const trimmed = header.trim();
+    if (!/^\d+$/.test(trimmed))
+        return undefined;
+    const seconds = Number(trimmed);
+    return Number.isSafeInteger(seconds) ? seconds : undefined;
+}
+/** How long to wait before the single saturation retry, in milliseconds. */
+function saturationDelayMs(retryAfterSeconds) {
+    const hinted = retryAfterSeconds ?? SATURATION_FALLBACK_DELAY_SECONDS;
+    return Math.min(hinted, SATURATION_MAX_DELAY_SECONDS) * 1000;
+}
+/**
+ * Wait `ms`, or resolve early if the turn is aborted — a user who hits stop
+ * must not sit through the remainder of a 15s backoff before the UI settles.
+ */
+function delay(ms, signal) {
+    return new Promise((resolve) => {
+        if (signal.aborted) {
+            resolve();
+            return;
+        }
+        const finish = () => {
+            clearTimeout(timer);
+            signal.removeEventListener("abort", finish);
+            resolve();
+        };
+        const timer = setTimeout(finish, ms);
+        signal.addEventListener("abort", finish, { once: true });
+    });
+}
+/**
+ * Wrap an invoke transport with ONE automatic retry on a saturated pod.
+ *
+ * ## What retries, and what deliberately does not
+ *
+ * `POD_SATURATED` (503) means the pod is at its concurrent-turn cap right now
+ * — a transient queue state that clears as in-flight turns finish, so a single
+ * delayed re-send usually just works. The wait is the pod's own `Retry-After`
+ * hint (via {@link AgentResponseError.retryAfterSeconds}), defaulting to 15s
+ * when it sent none and capped at 30s.
+ *
+ * `DRAINING` (also 503 + `Retry-After`) is NOT retried in v1. The refusing pod
+ * is shutting down: its readiness probe is already failing and the endpoint
+ * pull is in flight, so the useful retry is the one that reaches a DIFFERENT
+ * pod — and a wrapped transport re-sends to the same URL. Retrying here would
+ * spend the user's 15s to arrive back at the same draining pod (or at a fresh
+ * one by luck), which is not a guarantee worth building on. When the retry can
+ * be made routing-aware, this is the code to revisit.
+ *
+ * Exactly ONE retry: a second saturation propagates as
+ * {@link AgentResponseError}, so a genuinely overloaded agent surfaces instead
+ * of looping. Nothing is retried once a chunk has been yielded — replaying
+ * mid-stream would duplicate a partial assistant turn (the same `yielded`
+ * guard the widget's `withIdentifiedToken` 401-retry uses). An abort during
+ * the wait skips the retry and surfaces the original refusal.
+ *
+ * The retry is INVISIBLE to `useAgentInvoke`: no frames were yielded, so the
+ * turn simply stays in `connecting` for the duration of the wait. There is no
+ * `retrying` status by design — the hook's state machine describes the pod's
+ * turn lifecycle, not the transport's plumbing.
+ *
+ * The wrapped transport is re-invoked from scratch for the retry, so a host
+ * that resolves identity inside its own generator (Portal's RN transport reads
+ * the bearer bridge per attempt) re-reads it on the second try rather than
+ * replaying a token that may have expired during the wait.
+ */
+export function withSaturationRetry(transport, options = {}) {
+    return async function* retrying(req) {
+        let yielded = false;
+        try {
+            for await (const chunk of transport(req)) {
+                yielded = true;
+                yield chunk;
+            }
+            return;
+        }
+        catch (err) {
+            const saturated = err instanceof AgentResponseError && err.code === AGENT_ERROR_CODES.POD_SATURATED;
+            if (!saturated || yielded)
+                throw err;
+            await (options.sleep ?? delay)(saturationDelayMs(err.retryAfterSeconds), req.signal);
+            // Aborted mid-wait: the user is done with this turn. Surface the refusal
+            // that caused the wait rather than spending a request that `fetch` would
+            // reject on the signal anyway.
+            if (req.signal.aborted)
+                throw err;
+        }
+        yield* transport(req);
+    };
+}

package/dist/sse.d.ts

@@ -3,7 +3,7 @@
  * platform dependencies — unit-tested in isolation (`sse.test.ts`) and shared
  * verbatim across web (Studio) and React-Native (Portal).
  */
-import type { ProfileConsentRequest, ProfileLinkRequest } from "./types";
+import type { ProfileConsentRequest, ProfileLinkRequest } from "./types.js";
 export interface ParsedSseEvent {
     event: string;
     data: unknown;

package/dist/sse.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sse.d.ts","sourceRoot":"","sources":["../src/sse.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAEzE,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;CACf;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,cAAc,EAAE,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAqBzF;AAsBD;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM,CAU1E;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAmC1D;AAED,kEAAkE;AAClE,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAI1E;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG,qBAAqB,GAAG,IAAI,CAO/E;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,kBAAkB,GAAG,IAAI,CAOzE"}
+{"version":3,"file":"sse.d.ts","sourceRoot":"","sources":["../src/sse.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAE5E,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;CACf;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,cAAc,EAAE,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAqBzF;AAsBD;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM,CAU1E;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAmC1D;AAED,kEAAkE;AAClE,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAI1E;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG,qBAAqB,GAAG,IAAI,CAO/E;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,kBAAkB,GAAG,IAAI,CAOzE"}

package/dist/types.d.ts

@@ -148,9 +148,16 @@ export interface UseAgentInvokeOptions {
  *  - `responding` — assistant text is arriving (`text.start`/`text.delta`
  *    silver frames, or bypass text/assistant frames).
  *
- * Failure keeps its own channel ({@link UseAgentInvokeReturn.error}) — there
- * is deliberately no `error` status: after any terminal outcome the status
- * returns to `ready` so the composer re-enables.
+ * Failure keeps its own channel ({@link UseAgentInvokeReturn.error} +
+ * {@link UseAgentInvokeReturn.errorCode}) — there is deliberately no `error`
+ * status: after any terminal outcome the status returns to `ready` so the
+ * composer re-enables.
+ *
+ * There is likewise no `retrying` state. `fetchStreamTransport` retries a
+ * `POD_SATURATED` refusal once by itself, but that happens before any frame is
+ * yielded, so the turn stays in `connecting` for the backoff and the hook never
+ * learns it happened. This union describes the POD's turn lifecycle; transport
+ * plumbing does not belong in it.
  */
 export type AgentInvokeStatus = "ready" | "connecting" | "thinking" | "using-tool" | "responding";
 export interface UseAgentInvokeReturn {
@@ -162,6 +169,25 @@ export interface UseAgentInvokeReturn {
     /** The active tool's wire name while `status === 'using-tool'`, else null. */
     activeTool: string | null;
     error: string | null;
+    /**
+     * The pod's wire code for the failure in {@link error}, when it carried one
+     * — `QUOTA_EXCEEDED`, `POD_SATURATED`, `GUEST_ACCESS_DISABLED`, … (see
+     * `AGENT_ERROR_CODES`, and branch on those constants rather than re-typing
+     * the literals). `null` when there is no error, or when the failure had no
+     * code: a network drop, a host-adapter throw, or an `event: error` frame
+     * without one.
+     *
+     * Both failure channels feed it — the pre-stream refusal (thrown as
+     * `AgentResponseError`) and the in-band `event: error` frame — because the
+     * two carry the SAME vocabulary; a consumer branches once, not per channel.
+     * Set and cleared in lockstep with {@link error}: a new `send()`, `reset()`,
+     * or an app switch clears both.
+     *
+     * It is a `string`, not the `AgentErrorCode` union: the pod may ship a new
+     * code before a consumer upgrades this SDK, and a narrowed type would make
+     * that unrepresentable rather than merely unhandled.
+     */
+    errorCode: string | null;
     threadId: string | null;
     /** Abort the in-flight turn (the stream stops; partial text is kept). */
     abort: () => void;

package/dist/types.d.ts.map

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

package/dist/useAgentInvoke.d.ts

@@ -1,4 +1,4 @@
-import type { AgentMessage, HistoryLoadResult, UseAgentInvokeOptions, UseAgentInvokeReturn } from "./types";
+import type { AgentMessage, HistoryLoadResult, UseAgentInvokeOptions, UseAgentInvokeReturn } from "./types.js";
 /** The decision `applyHistoryResult` reaches for a loaded transcript. */
 export type HistoryApplication = {
     kind: "seed";

package/dist/useAgentInvoke.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useAgentInvoke.d.ts","sourceRoot":"","sources":["../src/useAgentInvoke.ts"],"names":[],"mappings":"AAiCA,OAAO,KAAK,EAGV,YAAY,EAEZ,iBAAiB,EAGjB,qBAAqB,EACrB,oBAAoB,EACrB,MAAM,SAAS,CAAC;AAMjB,yEAAyE;AACzE,MAAM,MAAM,kBAAkB,GAC1B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,YAAY,EAAE,CAAA;CAAE,GAC1C;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC;AAEtB;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,iBAAiB,EACzB,eAAe,EAAE,YAAY,EAAE,GAC9B,kBAAkB,CAIpB;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,qBAAqB,GAAG,oBAAoB,CAqUhF"}
+{"version":3,"file":"useAgentInvoke.d.ts","sourceRoot":"","sources":["../src/useAgentInvoke.ts"],"names":[],"mappings":"AAkCA,OAAO,KAAK,EAGV,YAAY,EAEZ,iBAAiB,EAGjB,qBAAqB,EACrB,oBAAoB,EACrB,MAAM,YAAY,CAAC;AAMpB,yEAAyE;AACzE,MAAM,MAAM,kBAAkB,GAC1B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,YAAY,EAAE,CAAA;CAAE,GAC1C;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC;AAEtB;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,iBAAiB,EACzB,eAAe,EAAE,YAAY,EAAE,GAC9B,kBAAkB,CAIpB;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,qBAAqB,GAAG,oBAAoB,CAwVhF"}