@tangle-network/agent-app 0.45.23 → 0.45.24

package/dist/web-react/async/index.js

@@ -1,310 +1,22 @@
-// src/web-react/async/state.ts
-var DEFAULT_ASYNC_ERROR_MESSAGE = "Something went wrong. Please try again.";
-function defaultIsEmpty(value) {
-  if (value === null || value === void 0) return true;
-  if (Array.isArray(value)) return value.length === 0;
-  if (value instanceof Map || value instanceof Set) return value.size === 0;
-  return false;
-}
-function hasMessage(value) {
-  return "message" in value;
-}
-function asyncErrorMessage(error, fallback = DEFAULT_ASYNC_ERROR_MESSAGE) {
-  if (typeof error === "string" && error.trim() !== "") return error;
-  if (typeof error === "object" && error !== null && hasMessage(error)) {
-    const message = error.message;
-    if (typeof message === "string" && message.trim() !== "") return message;
-  }
-  return fallback;
-}
-function resolveAsyncValue(value, isEmpty = defaultIsEmpty) {
-  return isEmpty(value) ? { status: "empty", value } : { status: "ready", value };
-}
-var AsyncRequestError = class extends Error {
-  status;
-  statusText;
-  url;
-  /** First 200 characters of the response body when it could be read, else `''`.
-   *  Kept off `message` so a server's HTML error page never becomes UI copy. */
-  body;
-  constructor(response, body = "") {
-    const statusText = response.statusText ?? "";
-    super(`Request failed (${response.status}${statusText ? ` ${statusText}` : ""})`);
-    this.name = "AsyncRequestError";
-    this.status = response.status;
-    this.statusText = statusText;
-    this.url = response.url ?? "";
-    this.body = body;
-  }
-};
-async function readBodySnippet(response) {
-  try {
-    return (await response.text()).slice(0, 200);
-  } catch {
-    return "";
-  }
-}
-async function requireOk(response) {
-  if (response.ok) return response;
-  throw new AsyncRequestError(response, await readBodySnippet(response));
-}
-async function readOkJson(response, parse) {
-  await requireOk(response);
-  let data;
-  try {
-    data = await response.json();
-  } catch (error) {
-    throw new Error("The response was not valid JSON.", { cause: error });
-  }
-  return parse ? parse(data) : data;
-}
-
-// src/web-react/async/use-async-resource.ts
-import { useCallback, useEffect, useMemo, useRef, useState } from "react";
-function useChangeToken(deps) {
-  const ref = useRef({ deps, token: 0 });
-  const changed = ref.current.deps.length !== deps.length || deps.some((dep, index) => !Object.is(dep, ref.current.deps[index]));
-  if (changed) ref.current = { deps, token: ref.current.token + 1 };
-  return ref.current.token;
-}
-var NO_DEPS = [];
-function useAsyncResource({
-  load,
-  deps = NO_DEPS,
-  enabled = true,
-  initialValue,
-  isEmpty,
-  errorMessage
-}) {
-  const loadRef = useRef(load);
-  loadRef.current = load;
-  const isEmptyRef = useRef(isEmpty ?? defaultIsEmpty);
-  isEmptyRef.current = isEmpty ?? defaultIsEmpty;
-  const errorMessageRef = useRef(errorMessage);
-  errorMessageRef.current = errorMessage;
-  const [resolution, setResolution] = useState(() => {
-    if (initialValue !== void 0) return resolveAsyncValue(initialValue, isEmpty ?? defaultIsEmpty);
-    return enabled ? { status: "loading" } : { status: "idle" };
-  });
-  const [reloadKey, setReloadKey] = useState(0);
-  const seqRef = useRef(0);
-  const seededRef = useRef(initialValue !== void 0);
-  const token = useChangeToken(deps);
-  useEffect(() => {
-    if (!enabled) return;
-    if (seededRef.current) {
-      seededRef.current = false;
-      return;
-    }
-    const seq = ++seqRef.current;
-    const controller = new AbortController();
-    setResolution({ status: "loading" });
-    void (async () => {
-      try {
-        const value = await loadRef.current({ signal: controller.signal });
-        if (seq !== seqRef.current || controller.signal.aborted) return;
-        setResolution(resolveAsyncValue(value, isEmptyRef.current));
-      } catch (error) {
-        if (seq !== seqRef.current || controller.signal.aborted) return;
-        setResolution({
-          status: "error",
-          message: errorMessageRef.current ? errorMessageRef.current(error) : asyncErrorMessage(error),
-          error
-        });
-      }
-    })();
-    return () => controller.abort();
-  }, [token, enabled, reloadKey]);
-  const retry = useCallback(() => {
-    setReloadKey((key) => key + 1);
-  }, []);
-  return useMemo(() => {
-    switch (resolution.status) {
-      case "ready":
-        return { status: "ready", value: resolution.value, retry };
-      case "empty":
-        return { status: "empty", value: resolution.value, retry };
-      case "error":
-        return { status: "error", message: resolution.message, error: resolution.error, retry };
-      case "loading":
-        return { status: "loading", retry };
-      case "idle":
-        return { status: "idle", retry };
-    }
-  }, [resolution, retry]);
-}
-
-// src/web-react/async/use-confirmed-mutation.ts
-import { useCallback as useCallback2, useMemo as useMemo2, useRef as useRef2, useState as useState2 } from "react";
-var CONFIRMED_WRITE = /* @__PURE__ */ Symbol("agent-app.confirmed-write");
-function confirmWrite(value) {
-  return { succeeded: true, value, [CONFIRMED_WRITE]: true };
-}
-function rejectWrite(message, error) {
-  return error === void 0 ? { succeeded: false, message } : { succeeded: false, message, error };
-}
-async function confirmResponse(response) {
-  try {
-    return confirmWrite(await requireOk(response));
-  } catch (error) {
-    return rejectWrite(asyncErrorMessage(error), error);
-  }
-}
-async function confirmJson(response, parse) {
-  try {
-    return confirmWrite(await readOkJson(response, parse));
-  } catch (error) {
-    return rejectWrite(asyncErrorMessage(error), error);
-  }
-}
-function isConfirmedWrite(outcome) {
-  if (typeof outcome !== "object" || outcome === null) return false;
-  return outcome[CONFIRMED_WRITE] === true;
-}
-function asRejection(outcome) {
-  if (typeof outcome !== "object" || outcome === null) return null;
-  const candidate = outcome;
-  if (candidate.succeeded !== false) return null;
-  const message = typeof candidate.message === "string" && candidate.message.trim() !== "" ? candidate.message : UNCONFIRMED_MESSAGE;
-  return rejectWrite(message, candidate.error);
-}
-var UNCONFIRMED_MESSAGE = "The write could not be confirmed.";
-var UNCONFIRMED_CONTRACT = "mutate() resolved without a confirmation. Return confirmWrite(value), confirmResponse(response) or confirmJson(response, parse) so the success state proves the write landed.";
-function useConfirmedMutation({
-  mutate,
-  onSucceeded,
-  onFailed,
-  errorMessage
-}) {
-  const mutateRef = useRef2(mutate);
-  mutateRef.current = mutate;
-  const onSucceededRef = useRef2(onSucceeded);
-  onSucceededRef.current = onSucceeded;
-  const onFailedRef = useRef2(onFailed);
-  onFailedRef.current = onFailed;
-  const errorMessageRef = useRef2(errorMessage);
-  errorMessageRef.current = errorMessage;
-  const [state, setState] = useState2({ status: "idle" });
-  const seqRef = useRef2(0);
-  const inFlightRef = useRef2(null);
-  const run = useCallback2(async (input) => {
-    inFlightRef.current?.abort();
-    const controller = new AbortController();
-    inFlightRef.current = controller;
-    const seq = ++seqRef.current;
-    setState({ status: "pending" });
-    let outcome;
-    try {
-      const returned = await mutateRef.current(input, { signal: controller.signal });
-      outcome = isConfirmedWrite(returned) ? returned : asRejection(returned) ?? rejectWrite(UNCONFIRMED_MESSAGE, new Error(UNCONFIRMED_CONTRACT));
-    } catch (error) {
-      outcome = rejectWrite(errorMessageRef.current ? errorMessageRef.current(error) : asyncErrorMessage(error), error);
-    }
-    if (seq !== seqRef.current) return outcome;
-    if (outcome.succeeded) {
-      setState({ status: "succeeded", value: outcome.value });
-      onSucceededRef.current?.(outcome.value);
-    } else {
-      setState({ status: "failed", message: outcome.message, error: outcome.error });
-      onFailedRef.current?.(outcome.message, outcome.error);
-    }
-    return outcome;
-  }, []);
-  const reset = useCallback2(() => {
-    seqRef.current += 1;
-    inFlightRef.current?.abort();
-    inFlightRef.current = null;
-    setState({ status: "idle" });
-  }, []);
-  return useMemo2(() => ({ state, run, reset }), [state, run, reset]);
-}
-
-// src/web-react/async/async-view.tsx
-import { isValidElement } from "react";
-import { Fragment, jsx, jsxs } from "react/jsx-runtime";
-var BLOCK_CLASS = "flex flex-col items-center justify-center gap-2 px-4 py-10 text-center";
-function AsyncView({
-  state,
-  children,
-  empty,
-  renderLoading,
-  renderError,
-  renderIdle,
-  loadingLabel = "Loading\u2026",
-  retryLabel = "Retry",
-  className
-}) {
-  if (state.status === "ready") return /* @__PURE__ */ jsx(Fragment, { children: children(state.value) });
-  const branch = () => {
-    switch (state.status) {
-      case "idle":
-        return renderIdle?.() ?? /* @__PURE__ */ jsx(LoadingBlock, { label: loadingLabel });
-      case "loading":
-        return renderLoading?.() ?? /* @__PURE__ */ jsx(LoadingBlock, { label: loadingLabel });
-      case "error":
-        return renderError?.({ message: state.message, retry: state.retry }) ?? /* @__PURE__ */ jsx(ErrorBlock, { message: state.message, retry: state.retry, retryLabel });
-      case "empty":
-        if (isValidElement(empty)) return empty;
-        return typeof empty === "object" && empty !== null && typeof empty.title === "string" ? /* @__PURE__ */ jsx(EmptyBlock, { spec: empty }) : /* @__PURE__ */ jsx(EmptyBlock, { spec: { title: "Nothing here yet." } });
-    }
-  };
-  return /* @__PURE__ */ jsx("div", { "data-async-state": state.status, className, children: branch() });
-}
-function LoadingBlock({ label }) {
-  return /* @__PURE__ */ jsxs("div", { role: "status", "aria-live": "polite", "aria-busy": "true", className: BLOCK_CLASS, children: [
-    /* @__PURE__ */ jsx(
-      "span",
-      {
-        className: "h-4 w-4 animate-spin rounded-full border-2 border-border border-t-transparent",
-        "aria-hidden": "true"
-      }
-    ),
-    /* @__PURE__ */ jsx("span", { className: "text-sm text-muted-foreground", children: label })
-  ] });
-}
-function ErrorBlock({
-  message,
-  retry,
-  retryLabel
-}) {
-  return /* @__PURE__ */ jsxs("div", { role: "alert", className: BLOCK_CLASS, children: [
-    /* @__PURE__ */ jsx("p", { className: "max-w-md text-sm text-muted-foreground", children: message }),
-    /* @__PURE__ */ jsx(
-      "button",
-      {
-        type: "button",
-        onClick: retry,
-        className: "h-8 rounded-md border border-border px-3 text-xs font-medium text-foreground transition hover:bg-accent/30",
-        children: retryLabel
-      }
-    )
-  ] });
-}
-function EmptyBlock({ spec }) {
-  return /* @__PURE__ */ jsxs("div", { className: BLOCK_CLASS, children: [
-    /* @__PURE__ */ jsx("p", { className: "text-sm font-medium text-foreground", children: spec.title }),
-    spec.description ? /* @__PURE__ */ jsx("p", { className: "max-w-md text-sm text-muted-foreground", children: spec.description }) : null,
-    spec.action ? isValidElement(spec.action) ? spec.action : /* @__PURE__ */ jsx(
-      "button",
-      {
-        type: "button",
-        onClick: spec.action.onClick,
-        className: "h-8 rounded-md border border-border px-3 text-xs font-medium text-foreground transition hover:bg-accent/30",
-        children: spec.action.label
-      }
-    ) : null
-  ] });
-}
-function MutationStatus({ state, labels, className }) {
-  if (state.status === "idle") return null;
-  if (state.status === "pending") {
-    return /* @__PURE__ */ jsx("span", { role: "status", "aria-live": "polite", className: className ?? "text-xs text-muted-foreground", children: labels?.pending ?? "Saving\u2026" });
-  }
-  if (state.status === "succeeded") {
-    return /* @__PURE__ */ jsx("span", { role: "status", "aria-live": "polite", className: className ?? "text-xs text-muted-foreground", children: labels?.succeeded ?? "Saved" });
-  }
-  return /* @__PURE__ */ jsx("span", { role: "alert", className: className ?? "text-xs text-destructive", children: state.message });
-}
+import {
+  AsyncRequestError,
+  AsyncView,
+  CONFIRMED_WRITE,
+  DEFAULT_ASYNC_ERROR_MESSAGE,
+  MutationStatus,
+  asyncErrorMessage,
+  confirmJson,
+  confirmResponse,
+  confirmWrite,
+  defaultIsEmpty,
+  isConfirmedWrite,
+  readOkJson,
+  rejectWrite,
+  requireOk,
+  resolveAsyncValue,
+  useAsyncResource,
+  useConfirmedMutation
+} from "../../chunk-YIQHOAHN.js";
 export {
   AsyncRequestError,
   AsyncView,

package/dist/web-react/async/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/web-react/async/state.ts","../../../src/web-react/async/use-async-resource.ts","../../../src/web-react/async/use-confirmed-mutation.ts","../../../src/web-react/async/async-view.tsx"],"sourcesContent":["/**\n * The fetch-state contract: a failed load cannot render as empty data.\n *\n * Three shapes produce that defect, and two audited verticals shipped dozens of\n * each: a `catch` handler that only clears a loading flag, an early return on a\n * non-ok response, and a bare `null` returned while loading. All three end with\n * the same pixels a successful-but-empty load produces — \"No templates\n * available\", an empty member list, a blank conversation — so the reader cannot\n * tell \"we asked and there is nothing\" from \"we could not ask\", and the retry\n * that would fix it is never offered.\n *\n * `AsyncResourceState` makes the two outcomes separate variants: `error` is the\n * only one carrying a message and it is never reachable with a value, `empty` is\n * the only one carrying a resolved-but-empty value and it never carries a\n * message. A component rendering one is structurally not rendering the other.\n *\n * This file is React-free so the state model, the emptiness rule and the\n * Response readers can be unit-tested and reused outside a component.\n */\n\n/**\n * - `idle` — no load has been attempted (the hook is disabled, or its inputs\n *   are not resolved yet). Distinct from `loading`: nothing is in flight.\n * - `loading` — a load is in flight and no value is held.\n * - `error` — the load failed. Carries the message and never a value.\n * - `empty` — the load succeeded and the value is empty. Never carries a message.\n * - `ready` — the load succeeded and the value is non-empty.\n */\nexport type AsyncResourceStatus = 'idle' | 'loading' | 'error' | 'empty' | 'ready'\n\n/** Re-runs the load. Present on every variant so the error branch can never be\n *  rendered without the action that recovers from it. */\nexport interface AsyncRetryable {\n  readonly retry: () => void\n}\n\nexport type AsyncResourceState<T> =\n  | ({ readonly status: 'idle' } & AsyncRetryable)\n  | ({ readonly status: 'loading' } & AsyncRetryable)\n  | ({ readonly status: 'error'; readonly message: string; readonly error: unknown } & AsyncRetryable)\n  | ({ readonly status: 'empty'; readonly value: T } & AsyncRetryable)\n  | ({ readonly status: 'ready'; readonly value: T } & AsyncRetryable)\n\n/** The state model without the retry action — what a reducer produces. */\nexport type AsyncResolution<T> =\n  | { readonly status: 'idle' }\n  | { readonly status: 'loading' }\n  | { readonly status: 'error'; readonly message: string; readonly error: unknown }\n  | { readonly status: 'empty'; readonly value: T }\n  | { readonly status: 'ready'; readonly value: T }\n\nexport const DEFAULT_ASYNC_ERROR_MESSAGE = 'Something went wrong. Please try again.'\n\n/**\n * Default emptiness rule: `null`/`undefined`, an empty array, an empty `Map` or\n * `Set`. A string, a number and a plain object are `ready` — `''` and `{}` are\n * legitimate values for the resources that produce them, and guessing otherwise\n * would route a real answer into the empty branch. Pass `isEmpty` for a shape\n * this cannot see into (`{ items: [] }`, a paged envelope, a count).\n */\nexport function defaultIsEmpty(value: unknown): boolean {\n  if (value === null || value === undefined) return true\n  if (Array.isArray(value)) return value.length === 0\n  if (value instanceof Map || value instanceof Set) return value.size === 0\n  return false\n}\n\nfunction hasMessage(value: object): value is { message: unknown } {\n  return 'message' in value\n}\n\n/** Best available human-readable message for a thrown value. Never returns an\n *  empty string — a blank error block reads as a rendering bug. */\nexport function asyncErrorMessage(error: unknown, fallback: string = DEFAULT_ASYNC_ERROR_MESSAGE): string {\n  if (typeof error === 'string' && error.trim() !== '') return error\n  if (typeof error === 'object' && error !== null && hasMessage(error)) {\n    const message = error.message\n    if (typeof message === 'string' && message.trim() !== '') return message\n  }\n  return fallback\n}\n\n/** Classifies a successfully loaded value into `ready` or `empty`. */\nexport function resolveAsyncValue<T>(value: T, isEmpty: (value: T) => boolean = defaultIsEmpty): AsyncResolution<T> {\n  return isEmpty(value) ? { status: 'empty', value } : { status: 'ready', value }\n}\n\n/**\n * A non-ok HTTP response, as a throwable. `requireOk`/`readOkJson` raise this so\n * a non-ok response reaches the `error` branch instead of an early `return` that\n * leaves the caller rendering the empty branch.\n */\nexport class AsyncRequestError extends Error {\n  readonly status: number\n  readonly statusText: string\n  readonly url: string\n  /** First 200 characters of the response body when it could be read, else `''`.\n   *  Kept off `message` so a server's HTML error page never becomes UI copy. */\n  readonly body: string\n\n  constructor(response: { status: number; statusText?: string; url?: string }, body = '') {\n    const statusText = response.statusText ?? ''\n    super(`Request failed (${response.status}${statusText ? ` ${statusText}` : ''})`)\n    this.name = 'AsyncRequestError'\n    this.status = response.status\n    this.statusText = statusText\n    this.url = response.url ?? ''\n    this.body = body\n  }\n}\n\nasync function readBodySnippet(response: Response): Promise<string> {\n  try {\n    return (await response.text()).slice(0, 200)\n  } catch {\n    // An already-consumed or unreadable body is a missing diagnostic, not a\n    // second failure — the status is what the error reports.\n    return ''\n  }\n}\n\n/** Returns the response when ok; throws `AsyncRequestError` otherwise. Reads the\n *  body only on the failure path, so the caller keeps an unconsumed stream. */\nexport async function requireOk(response: Response): Promise<Response> {\n  if (response.ok) return response\n  throw new AsyncRequestError(response, await readBodySnippet(response))\n}\n\n/**\n * `requireOk` + `response.json()`. Without `parse` the result is `unknown`, so a\n * caller narrows at the JSON boundary rather than inheriting an unchecked shape;\n * with `parse` the validator runs inside the load and a rejection lands in the\n * `error` branch.\n */\nexport async function readOkJson(response: Response): Promise<unknown>\nexport async function readOkJson<T>(response: Response, parse: (data: unknown) => T): Promise<T>\nexport async function readOkJson<T>(response: Response, parse?: (data: unknown) => T): Promise<T | unknown> {\n  await requireOk(response)\n  let data: unknown\n  try {\n    data = await response.json()\n  } catch (error) {\n    throw new Error('The response was not valid JSON.', { cause: error })\n  }\n  return parse ? parse(data) : data\n}\n","import { useCallback, useEffect, useMemo, useRef, useState } from 'react'\n\nimport {\n  asyncErrorMessage,\n  defaultIsEmpty,\n  resolveAsyncValue,\n  type AsyncResolution,\n  type AsyncResourceState,\n} from './state'\n\nexport interface AsyncLoadContext {\n  /** Aborted when the inputs change, a retry supersedes this load, or the\n   *  component unmounts. Forward it to `fetch` so a superseded request stops. */\n  readonly signal: AbortSignal\n}\n\nexport interface UseAsyncResourceOptions<T> {\n  /**\n   * The one load. Reject (or throw) to reach the `error` branch — a non-ok\n   * response must reject too, which is what `requireOk`/`readOkJson` are for.\n   * Read from a ref internally, so an inline arrow does not re-trigger; `deps`\n   * is what declares when the load must run again.\n   */\n  load: (context: AsyncLoadContext) => Promise<T>\n  /** Re-runs the load when any entry changes by `Object.is`, like `useEffect`. */\n  deps?: readonly unknown[]\n  /** `false` holds the resource at `idle` and runs nothing — for inputs that are\n   *  not resolved yet. Flipping it to `true` starts the load. */\n  enabled?: boolean\n  /** First-render seed (an SSR/loader page). The hook starts resolved and skips\n   *  the first load. Read once — later identity changes are ignored, so a\n   *  revalidating loader belongs in `deps`, not here. */\n  initialValue?: T\n  /** Splits a successful load into `empty` vs `ready`. Default: `defaultIsEmpty`. */\n  isEmpty?: (value: T) => boolean\n  /** Maps a thrown value to the message the `error` branch renders. */\n  errorMessage?: (error: unknown) => string\n}\n\n/** Bumps a token when any dependency changes identity, so the effect's own\n *  dependency list stays a fixed length whatever the caller passes. */\nfunction useChangeToken(deps: readonly unknown[]): number {\n  const ref = useRef<{ deps: readonly unknown[]; token: number }>({ deps, token: 0 })\n  const changed =\n    ref.current.deps.length !== deps.length || deps.some((dep, index) => !Object.is(dep, ref.current.deps[index]))\n  if (changed) ref.current = { deps, token: ref.current.token + 1 }\n  return ref.current.token\n}\n\nconst NO_DEPS: readonly unknown[] = []\n\n/**\n * The five-state fetch machine: `idle | loading | error | empty | ready`.\n *\n * What it guarantees, and what the hand-rolled versions it replaces did not:\n *\n * - a rejected load lands on `error` with a message and a `retry`, never on an\n *   empty list;\n * - `empty` is only reachable from a load that actually succeeded;\n * - a superseded load (inputs changed, retry pressed, component unmounted) is\n *   aborted and its late result is dropped by a monotonic sequence guard, so it\n *   cannot repaint a newer view.\n */\nexport function useAsyncResource<T>({\n  load,\n  deps = NO_DEPS,\n  enabled = true,\n  initialValue,\n  isEmpty,\n  errorMessage,\n}: UseAsyncResourceOptions<T>): AsyncResourceState<T> {\n  const loadRef = useRef(load)\n  loadRef.current = load\n  const isEmptyRef = useRef(isEmpty ?? defaultIsEmpty)\n  isEmptyRef.current = isEmpty ?? defaultIsEmpty\n  const errorMessageRef = useRef(errorMessage)\n  errorMessageRef.current = errorMessage\n\n  const [resolution, setResolution] = useState<AsyncResolution<T>>(() => {\n    if (initialValue !== undefined) return resolveAsyncValue(initialValue, isEmpty ?? defaultIsEmpty)\n    return enabled ? { status: 'loading' } : { status: 'idle' }\n  })\n  const [reloadKey, setReloadKey] = useState(0)\n\n  const seqRef = useRef(0)\n  // Consumed by the first load attempt: a seeded resource must not throw its\n  // seed away to re-fetch what the server already sent.\n  const seededRef = useRef(initialValue !== undefined)\n  const token = useChangeToken(deps)\n\n  useEffect(() => {\n    if (!enabled) return\n    if (seededRef.current) {\n      seededRef.current = false\n      return\n    }\n\n    const seq = ++seqRef.current\n    const controller = new AbortController()\n    setResolution({ status: 'loading' })\n\n    void (async () => {\n      try {\n        const value = await loadRef.current({ signal: controller.signal })\n        if (seq !== seqRef.current || controller.signal.aborted) return\n        setResolution(resolveAsyncValue(value, isEmptyRef.current))\n      } catch (error) {\n        if (seq !== seqRef.current || controller.signal.aborted) return\n        setResolution({\n          status: 'error',\n          message: errorMessageRef.current ? errorMessageRef.current(error) : asyncErrorMessage(error),\n          error,\n        })\n      }\n    })()\n\n    return () => controller.abort()\n  }, [token, enabled, reloadKey])\n\n  const retry = useCallback(() => {\n    setReloadKey((key) => key + 1)\n  }, [])\n\n  return useMemo<AsyncResourceState<T>>(() => {\n    switch (resolution.status) {\n      case 'ready':\n        return { status: 'ready', value: resolution.value, retry }\n      case 'empty':\n        return { status: 'empty', value: resolution.value, retry }\n      case 'error':\n        return { status: 'error', message: resolution.message, error: resolution.error, retry }\n      case 'loading':\n        return { status: 'loading', retry }\n      case 'idle':\n        return { status: 'idle', retry }\n    }\n  }, [resolution, retry])\n}\n","import { useCallback, useMemo, useRef, useState } from 'react'\n\nimport { asyncErrorMessage, readOkJson, requireOk } from './state'\nimport type { AsyncLoadContext } from './use-async-resource'\n\n/**\n * The brand that makes \"Saved\" unreachable without a confirmed write.\n *\n * A resolved promise is not a success: `fetch` resolves on a 404, and the\n * shipped defect this closes is a save button that rendered \"Saved\" because the\n * only thing awaited was that the request came back at all. The success variant\n * therefore carries a symbol no object literal can spell, so the only way into\n * `succeeded` is `confirmWrite` / `confirmResponse` / `confirmJson` — each of\n * which has already checked that the write landed.\n */\nexport const CONFIRMED_WRITE: unique symbol = Symbol('agent-app.confirmed-write')\n\nexport interface MutationConfirmed<T> {\n  readonly succeeded: true\n  readonly value: T\n  readonly [CONFIRMED_WRITE]: true\n}\n\nexport interface MutationRejected {\n  readonly succeeded: false\n  /** Safe to render: what the user is told the write did not do. */\n  readonly message: string\n  readonly error?: unknown\n}\n\nexport type MutationOutcome<T> = MutationConfirmed<T> | MutationRejected\n\n/** Confirms a write whose success is already established (an SDK call that\n *  throws on failure, a store returning its own typed outcome). The deliberate\n *  act is the point — this call is what an audit greps for. */\nexport function confirmWrite<T>(value: T): MutationConfirmed<T> {\n  return { succeeded: true, value, [CONFIRMED_WRITE]: true }\n}\n\n/** A write that did not land. Constructible by hand: failing loud is never the\n *  direction that needs guarding. */\nexport function rejectWrite(message: string, error?: unknown): MutationRejected {\n  return error === undefined ? { succeeded: false, message } : { succeeded: false, message, error }\n}\n\n/** Confirms only a 2xx response. A 404/500 becomes a rejection carrying the\n *  status — never a success, whatever the promise did. */\nexport async function confirmResponse(response: Response): Promise<MutationOutcome<Response>> {\n  try {\n    return confirmWrite(await requireOk(response))\n  } catch (error) {\n    return rejectWrite(asyncErrorMessage(error), error)\n  }\n}\n\n/** `confirmResponse` + a JSON body. A non-ok status, an unreadable body and a\n *  throwing `parse` are all rejections. */\nexport async function confirmJson<T>(response: Response, parse: (data: unknown) => T): Promise<MutationOutcome<T>> {\n  try {\n    return confirmWrite(await readOkJson(response, parse))\n  } catch (error) {\n    return rejectWrite(asyncErrorMessage(error), error)\n  }\n}\n\n/** True only for a value built by one of the confirm helpers. Takes `unknown`\n *  because an untyped consumer can return anything from `mutate`. */\nexport function isConfirmedWrite<T>(outcome: unknown): outcome is MutationConfirmed<T> {\n  if (typeof outcome !== 'object' || outcome === null) return false\n  return (outcome as { readonly [CONFIRMED_WRITE]?: unknown })[CONFIRMED_WRITE] === true\n}\n\nfunction asRejection(outcome: unknown): MutationRejected | null {\n  if (typeof outcome !== 'object' || outcome === null) return null\n  const candidate = outcome as { succeeded?: unknown; message?: unknown; error?: unknown }\n  if (candidate.succeeded !== false) return null\n  const message = typeof candidate.message === 'string' && candidate.message.trim() !== ''\n    ? candidate.message\n    : UNCONFIRMED_MESSAGE\n  return rejectWrite(message, candidate.error)\n}\n\nexport type MutationState<T> =\n  | { readonly status: 'idle' }\n  | { readonly status: 'pending' }\n  | { readonly status: 'succeeded'; readonly value: T }\n  | { readonly status: 'failed'; readonly message: string; readonly error: unknown }\n\nexport interface UseConfirmedMutationOptions<TInput, TValue> {\n  /**\n   * Performs the write and returns a confirmation. Anything else — including a\n   * hand-written `{ succeeded: true }` — is treated as a failed write, because\n   * an unbranded object is exactly the shape produced by code that never\n   * checked the response.\n   *\n   * The context signal aborts only when a later `run` supersedes this one. It is\n   * NOT aborted on unmount: a write the user asked for must not be cancelled by\n   * navigating away.\n   */\n  mutate: (input: TInput, context: AsyncLoadContext) => Promise<MutationOutcome<TValue>>\n  /** Fires after the state reaches `succeeded` (latest run only). */\n  onSucceeded?: (value: TValue) => void\n  /** Fires after the state reaches `failed` (latest run only). */\n  onFailed?: (message: string, error: unknown) => void\n  /** Maps a thrown value to the message the `failed` state renders. */\n  errorMessage?: (error: unknown) => string\n}\n\nexport interface ConfirmedMutation<TInput, TValue> {\n  readonly state: MutationState<TValue>\n  /** Runs the write. Never rejects — the outcome is returned and mirrored into\n   *  `state`. Concurrent runs are last-write-wins; disable the control while\n   *  `state.status === 'pending'`. */\n  readonly run: (input: TInput) => Promise<MutationOutcome<TValue>>\n  /** Back to `idle` (dismisses a \"Saved\" or error affordance). */\n  readonly reset: () => void\n}\n\nconst UNCONFIRMED_MESSAGE = 'The write could not be confirmed.'\n\nconst UNCONFIRMED_CONTRACT =\n  'mutate() resolved without a confirmation. Return confirmWrite(value), confirmResponse(response) or confirmJson(response, parse) so the success state proves the write landed.'\n\n/**\n * `idle | pending | succeeded | failed` over a write that must confirm itself.\n *\n * `succeeded` is reachable only through a branded confirmation, so the audited\n * \"Saved on a 404\" bug cannot be written with this hook: the 404 path produces\n * `failed` carrying the status, and a `mutate` that forgot to check produces\n * `failed` carrying the contract violation rather than a success it never\n * earned.\n */\nexport function useConfirmedMutation<TInput, TValue>({\n  mutate,\n  onSucceeded,\n  onFailed,\n  errorMessage,\n}: UseConfirmedMutationOptions<TInput, TValue>): ConfirmedMutation<TInput, TValue> {\n  const mutateRef = useRef(mutate)\n  mutateRef.current = mutate\n  const onSucceededRef = useRef(onSucceeded)\n  onSucceededRef.current = onSucceeded\n  const onFailedRef = useRef(onFailed)\n  onFailedRef.current = onFailed\n  const errorMessageRef = useRef(errorMessage)\n  errorMessageRef.current = errorMessage\n\n  const [state, setState] = useState<MutationState<TValue>>({ status: 'idle' })\n  const seqRef = useRef(0)\n  const inFlightRef = useRef<AbortController | null>(null)\n\n  const run = useCallback(async (input: TInput): Promise<MutationOutcome<TValue>> => {\n    inFlightRef.current?.abort()\n    const controller = new AbortController()\n    inFlightRef.current = controller\n    const seq = ++seqRef.current\n\n    setState({ status: 'pending' })\n\n    let outcome: MutationOutcome<TValue>\n    try {\n      const returned: unknown = await mutateRef.current(input, { signal: controller.signal })\n      outcome = isConfirmedWrite<TValue>(returned)\n        ? returned\n        : asRejection(returned) ?? rejectWrite(UNCONFIRMED_MESSAGE, new Error(UNCONFIRMED_CONTRACT))\n    } catch (error) {\n      outcome = rejectWrite(errorMessageRef.current ? errorMessageRef.current(error) : asyncErrorMessage(error), error)\n    }\n\n    // A superseded run reports its own outcome to its own caller and never\n    // repaints the state a newer run owns.\n    if (seq !== seqRef.current) return outcome\n\n    if (outcome.succeeded) {\n      setState({ status: 'succeeded', value: outcome.value })\n      onSucceededRef.current?.(outcome.value)\n    } else {\n      setState({ status: 'failed', message: outcome.message, error: outcome.error })\n      onFailedRef.current?.(outcome.message, outcome.error)\n    }\n    return outcome\n  }, [])\n\n  const reset = useCallback(() => {\n    seqRef.current += 1\n    inFlightRef.current?.abort()\n    inFlightRef.current = null\n    setState({ status: 'idle' })\n  }, [])\n\n  return useMemo(() => ({ state, run, reset }), [state, run, reset])\n}\n","import { isValidElement, type ReactElement, type ReactNode } from 'react'\n\nimport type { AsyncResourceState } from './state'\nimport type { MutationState } from './use-confirmed-mutation'\n\nexport interface AsyncEmptyAction {\n  label: string\n  onClick: () => void\n}\n\nexport interface AsyncEmptySpec {\n  /** What is not there, in the reader's words (\"No templates yet\"). Required:\n   *  an empty state with nothing to say is the state this module exists to\n   *  stop being mistaken for a failure. */\n  title: string\n  description?: string\n  /** The next action. An element is rendered as supplied (a link, a dialog\n   *  trigger); the object form renders the standard button. */\n  action?: AsyncEmptyAction | ReactElement\n}\n\nexport interface AsyncErrorRenderProps {\n  message: string\n  retry: () => void\n}\n\nexport interface AsyncViewProps<T> {\n  state: AsyncResourceState<T>\n  /** Rendered only for `ready`, with the loaded value — the branch cannot be\n   *  entered without one. */\n  children: (value: T) => ReactNode\n  /** Required: `empty` must name what is missing and what to do about it. */\n  empty: AsyncEmptySpec | ReactElement\n  /** Must return an element. Returning nothing is what produced the blank\n   *  screens this component replaces, so a nullish return falls back to the\n   *  built-in block rather than rendering nothing. */\n  renderLoading?: () => ReactElement\n  renderError?: (props: AsyncErrorRenderProps) => ReactElement\n  /** `idle` renders the loading block by default — from the reader's side,\n   *  \"not started\" and \"in flight\" are the same wait. */\n  renderIdle?: () => ReactElement\n  loadingLabel?: string\n  retryLabel?: string\n  /** Applied to the wrapper around the non-`ready` branches. `ready` renders the\n   *  children with no wrapper element, so grids and lists keep their layout. */\n  className?: string\n}\n\nconst BLOCK_CLASS = 'flex flex-col items-center justify-center gap-2 px-4 py-10 text-center'\n\n/**\n * Renders the branch the state is actually in.\n *\n * The three anti-patterns this replaces (`catch` that only clears a loading\n * flag, early return on a non-ok response, bare `null` while loading) all end at\n * the same rendered output as a successful-but-empty load. Here every branch is\n * reached from a different variant and each renders visibly: `loading` and\n * `idle` render a labelled busy block, `error` renders the message plus the\n * retry, `empty` renders the caller's copy and next action, and `ready` is the\n * only branch with a value to hand to `children`.\n */\nexport function AsyncView<T>({\n  state,\n  children,\n  empty,\n  renderLoading,\n  renderError,\n  renderIdle,\n  loadingLabel = 'Loading…',\n  retryLabel = 'Retry',\n  className,\n}: AsyncViewProps<T>): ReactElement {\n  if (state.status === 'ready') return <>{children(state.value)}</>\n\n  // Every `??` here is the guarantee: a custom renderer that returns nothing\n  // leaves the reader with the built-in block, never a blank region.\n  const branch = (): ReactNode => {\n    switch (state.status) {\n      case 'idle':\n        return renderIdle?.() ?? <LoadingBlock label={loadingLabel} />\n      case 'loading':\n        return renderLoading?.() ?? <LoadingBlock label={loadingLabel} />\n      case 'error':\n        return (\n          renderError?.({ message: state.message, retry: state.retry }) ?? (\n            <ErrorBlock message={state.message} retry={state.retry} retryLabel={retryLabel} />\n          )\n        )\n      case 'empty':\n        if (isValidElement(empty)) return empty\n        return typeof empty === 'object' && empty !== null && typeof empty.title === 'string' ? (\n          <EmptyBlock spec={empty} />\n        ) : (\n          <EmptyBlock spec={{ title: 'Nothing here yet.' }} />\n        )\n    }\n  }\n\n  return (\n    <div data-async-state={state.status} className={className}>\n      {branch()}\n    </div>\n  )\n}\n\nfunction LoadingBlock({ label }: { label: string }): ReactElement {\n  return (\n    <div role=\"status\" aria-live=\"polite\" aria-busy=\"true\" className={BLOCK_CLASS}>\n      <span\n        className=\"h-4 w-4 animate-spin rounded-full border-2 border-border border-t-transparent\"\n        aria-hidden=\"true\"\n      />\n      <span className=\"text-sm text-muted-foreground\">{label}</span>\n    </div>\n  )\n}\n\nfunction ErrorBlock({\n  message,\n  retry,\n  retryLabel,\n}: {\n  message: string\n  retry: () => void\n  retryLabel: string\n}): ReactElement {\n  return (\n    <div role=\"alert\" className={BLOCK_CLASS}>\n      <p className=\"max-w-md text-sm text-muted-foreground\">{message}</p>\n      <button\n        type=\"button\"\n        onClick={retry}\n        className=\"h-8 rounded-md border border-border px-3 text-xs font-medium text-foreground transition hover:bg-accent/30\"\n      >\n        {retryLabel}\n      </button>\n    </div>\n  )\n}\n\nfunction EmptyBlock({ spec }: { spec: AsyncEmptySpec }): ReactElement {\n  return (\n    <div className={BLOCK_CLASS}>\n      <p className=\"text-sm font-medium text-foreground\">{spec.title}</p>\n      {spec.description ? <p className=\"max-w-md text-sm text-muted-foreground\">{spec.description}</p> : null}\n      {spec.action ? (\n        isValidElement(spec.action) ? (\n          spec.action\n        ) : (\n          <button\n            type=\"button\"\n            onClick={(spec.action as AsyncEmptyAction).onClick}\n            className=\"h-8 rounded-md border border-border px-3 text-xs font-medium text-foreground transition hover:bg-accent/30\"\n          >\n            {(spec.action as AsyncEmptyAction).label}\n          </button>\n        )\n      ) : null}\n    </div>\n  )\n}\n\nexport interface MutationStatusLabels {\n  pending?: string\n  succeeded?: string\n}\n\nexport interface MutationStatusProps<T> {\n  state: MutationState<T>\n  labels?: MutationStatusLabels\n  className?: string\n}\n\n/**\n * The write's own status line. \"Saved\" renders only from `succeeded`, which\n * `useConfirmedMutation` can only reach through a confirmed write, so the label\n * cannot appear over a failed request.\n */\nexport function MutationStatus<T>({ state, labels, className }: MutationStatusProps<T>): ReactElement | null {\n  if (state.status === 'idle') return null\n  if (state.status === 'pending') {\n    return (\n      <span role=\"status\" aria-live=\"polite\" className={className ?? 'text-xs text-muted-foreground'}>\n        {labels?.pending ?? 'Saving…'}\n      </span>\n    )\n  }\n  if (state.status === 'succeeded') {\n    return (\n      <span role=\"status\" aria-live=\"polite\" className={className ?? 'text-xs text-muted-foreground'}>\n        {labels?.succeeded ?? 'Saved'}\n      </span>\n    )\n  }\n  return (\n    <span role=\"alert\" className={className ?? 'text-xs text-destructive'}>\n      {state.message}\n    </span>\n  )\n}\n"],"mappings":"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","names":["useCallback","useMemo","useRef","useState","useRef","useState","useCallback","useMemo"]}
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/web-react/index.d.ts

@@ -372,15 +372,82 @@ interface ComposerFile {
      *  `status: 'ready'` files with a part travel on a parts-aware send. */
     part?: ComposerFilePart;
 }
+/** A send the host refused. `error` is shown verbatim in the composer's notice;
+ *  omit it for the generic copy. */
+interface ComposerSendRejected {
+    ok: false;
+    error?: string;
+}
+/**
+ * What a send handler reports back. `void` — what every handler returned before
+ * this existed — reads as accepted, so wiring stays unchanged; a thrown error, a
+ * rejected promise, or `{ ok: false }` is the rejection that restores the draft.
+ * A handler that resolves only when the whole turn finishes still reports
+ * correctly: the input already cleared on dispatch, so the answer only decides
+ * whether the draft comes back.
+ */
+type ComposerSendOutcome = void | {
+    ok: true;
+} | ComposerSendRejected;
+type ComposerSendResult = ComposerSendOutcome | Promise<ComposerSendOutcome>;
+/**
+ * A send handler, typed as a UNION with the legacy `=> void` signature rather
+ * than as `(…) => ComposerSendResult` alone.
+ *
+ * TypeScript's return-type-`void` rule accepts a function returning ANYTHING
+ * where a `=> void` is expected, and that rule fires only when the target's
+ * return type is exactly `void` — not when it is a union that contains `void`.
+ * So narrowing this prop to `ComposerSendResult` would reject handler shapes
+ * that compiled against the shipped `onSend?: (message: string) => void`:
+ * `onSend={(m) => rows.push(m)}` (returns `number`) and
+ * `onSend={(m) => append({ role: 'user', content: m })}` (an ai-sdk append
+ * returns `Promise<string | null | undefined>`) both stop compiling, on a
+ * package whose pinned consumers must never need a source edit to take a minor.
+ *
+ * The union keeps both: a legacy handler lands on the first member, and a
+ * handler that reports an outcome lands on the second. A call through it
+ * resolves to `void | ComposerSendResult`, which IS `ComposerSendResult`, so
+ * the composer reads the outcome exactly as before.
+ */
+type ComposerSendHandler = ((message: string) => void) | ((message: string) => ComposerSendResult);
+/** @see ComposerSendHandler — the parts-aware arity, same union for the same reason. */
+type ComposerSendPartsHandler = ((message: string, parts: ComposerFilePart[]) => void) | ((message: string, parts: ComposerFilePart[]) => ComposerSendResult);
+/** The rejected send, handed to `onSendFailed` so the host can undo whatever it
+ *  cleared optimistically — most importantly the staged attachments, which the
+ *  composer does not own (`pendingFiles` is a prop). */
+interface ComposerSendFailure {
+    /** The reason as the composer renders it. */
+    message: string;
+    /** The user's exact draft, untrimmed. */
+    text: string;
+    /** The parts the rejected send carried. */
+    parts: ComposerFilePart[];
+    /** Whatever the handler threw / rejected with, or the `{ ok: false }` value. */
+    error: unknown;
+    /** True when the draft was put back in the textarea (the box was empty).
+     *  False means the user had typed a replacement, so the unsent text is held in
+     *  the notice instead. */
+    restored: boolean;
+}
 interface ChatComposerProps {
     /** Send the trimmed, non-empty message. Attached files travel separately via
      *  `onAttach` + `pendingFiles` (the host consumes and clears them on send).
-     *  Optional when `onSendParts` is wired. */
-    onSend?: (message: string) => void;
+     *  Optional when `onSendParts` is wired.
+     *
+     *  Report a refused send by throwing, rejecting, or returning `{ ok: false }`
+     *  — the composer restores the draft rather than losing it. */
+    onSend?: ComposerSendHandler;
     /** Parts-aware send: receives the trimmed message plus the `part`
      *  descriptors of every `ready` pending file. Takes precedence over
-     *  `onSend`; enables file-only sends (empty text, ≥1 ready part). */
-    onSendParts?: (message: string, parts: ComposerFilePart[]) => void;
+     *  `onSend`; enables file-only sends (empty text, ≥1 ready part).
+     *
+     *  Same rejection contract as `onSend`. */
+    onSendParts?: ComposerSendPartsHandler;
+    /** Notified when a send is rejected, after the composer has restored what it
+     *  owns. The host uses it to put back the `pendingFiles` it consumed. */
+    onSendFailed?: (failure: ComposerSendFailure) => void;
+    /** Notice copy when the handler names no reason of its own. */
+    sendFailureMessage?: string;
     /** Stop the in-flight turn; shown in place of Send while `isStreaming`. */
     onCancel?: () => void;
     isStreaming?: boolean;
@@ -425,7 +492,7 @@ interface ChatComposerProps {
     sendLabel?: string;
     className?: string;
 }
-declare function ChatComposer({ onSend, onSendParts, onCancel, isStreaming, disabled, placeholder, value, onValueChange, initialValue, seed, onSeedApplied, controls, controlsPlacement, onAttach, onAttachFolder, pendingFiles, onRemoveFile, accept, dropTitle, dropDescription, focusShortcut, sendLabel, className, }: ChatComposerProps): react.JSX.Element;
+declare function ChatComposer({ onSend, onSendParts, onSendFailed, sendFailureMessage, onCancel, isStreaming, disabled, placeholder, value, onValueChange, initialValue, seed, onSeedApplied, controls, controlsPlacement, onAttach, onAttachFolder, pendingFiles, onRemoveFile, accept, dropTitle, dropDescription, focusShortcut, sendLabel, className, }: ChatComposerProps): react.JSX.Element;
 
 type InteractionBadgeVariant = 'outline' | 'default' | 'destructive';
 declare function InteractionBadge({ variant, children }: {
@@ -2156,4 +2223,4 @@ declare function useThinkingSeconds(active: boolean): number;
  */
 declare function ChatMessages({ messages, messageSize, models, renderMarkdown, renderExtras, durableCards, userLabel, agentLabel, loading, approval, onToolCallClick, toolRenderers, error, onRetry, renderEmpty, emptyState, header, resolveAttachmentUrl, workProductCards, }: ChatMessagesProps): react.JSX.Element;
 
-export { type ActivityTone, type AgentActivityPage, AgentActivityPanel, type AgentActivityPanelProps, type AgentActivityRecord, AgentSessionControls, type AgentSessionControlsProps, type AttachmentFileResult, CatalogModel, ChatAttachmentInput, ChatAttachmentKind, ChatAttachmentPart, ChatComposer, type ChatComposerProps, type ChatEmptyDoor, ChatEmptyState, type ChatEmptyStateProps, ChatInteraction, ChatInteractionField, type ChatInteractionRestoreMode, ChatInteractionStatus, ChatMentionPart, type ChatMessageMetrics, type ChatMessageSegment, ChatMessages, type ChatMessagesProps, ChatSelectField, type ChatStreamCallbacks, type ChatStreamToolCall, type ChatStreamToolResult, type ChatToolCallInfo, type ChatUiMessage, type ComposerFile, type ComposerFilePart, type ConsumeChatStreamResult, DEFAULT_EFFORT_LEVELS, DEFAULT_PROVENANCE_CONFIDENCE_POLICY, type DurableChatCard, DurableChatCards, type DurableChatCardsProps, type DurableInteractionAnswerSubmitterOptions, DurablePlanCard, type DurablePlanCardProps, DurablePlanClientError, type DurablePlanCurrentInput, type DurablePlanDecision, type DurablePlanDecisionClient, type DurablePlanDecisionClientOptions, type DurablePlanDecisionInput, type DurablePlanDecisionResult, type DurablePlanFollowUpReceipt, EMPTY_RECORD_GRID_OVERLAY, type EffortLevel, EffortPicker, type EffortPickerProps, EvidenceLineageTable, type EvidenceLineageTableProps, ExceptionList, type ExceptionListProps, type FetchSessionPage, type FieldValues, FlowWaterfall, type FlowWaterfallProps, INTERACTION_SUBMIT_TIMEOUT_MESSAGE, INTERACTION_SUBMIT_TIMEOUT_MS, InteractionActionButton, type InteractionAnswerSubmission, type InteractionAnswerSubmitterOptions, InteractionAnswers, type InteractionAttemptStore, InteractionBadge, type InteractionBadgeVariant, InteractionCancelData, InteractionPlanCard, type InteractionPlanCardProps, InteractionQuestionCard, type InteractionQuestionCardProps, InteractionRequestWire, type InteractionSubmitResult, type LinkLikeComponent, type LinkLikeProps, type MentionTextSegment, MessageAttachments, type MessageAttachmentsProps, MissionActivityLane, type MissionActivityLaneProps, ModelPicker, type ModelPickerProps, PROVENANCE_BASES, type ProposalApprovalHandlers, type ProvenanceBasis, type ProvenanceBasisMeta, type ProvenanceConfidencePolicy, type ProvenanceGap, type ProvenanceGapKind, ProvenanceLegend, type ProvenanceLegendProps, type ProvenanceRecord, type ProvenanceSource, type ProvenanceSourceStatus, ProvenanceStamp, type ProvenanceStampProps, type ProvenanceStanding, type ProvenanceStandingMeta, ProvenanceValue, type ProvenanceValueProps, ProviderLogo, type ProviderLogoProps, QualityCheckList, type QualityCheckListProps, QuestionOptionList, type QuestionOptionListProps, RecordGrid, type RecordGridBooleanColumn, type RecordGridCellChange, type RecordGridCellOutcome, type RecordGridCellSource, type RecordGridColumn, type RecordGridColumnBase, type RecordGridCreateOutcome, type RecordGridCurrencyColumn, type RecordGridDateColumn, type RecordGridDependency, type RecordGridEmptyState, type RecordGridNumberColumn, type RecordGridOverlay, type RecordGridProps, type RecordGridRow, type RecordGridRowOutcome, type RecordGridSelectColumn, type RecordGridSelectOption, type RecordGridSourceBasis, type RecordGridState, type RecordGridTextColumn, type RecordGridValue, type RecordGridWriteOutcome, type RestoreChatInteractionsOptions, ReviewQueueItem, type ReviewQueuePage, ReviewQueuePanel, type ReviewQueuePanelProps, ReviewQueueState, RunDrillIn, type RunDrillInProps, SeatPaywall, type SeatPaywallProps, type SessionActionLabels, type SessionActions, type SessionActionsOptions, type SessionBulkAction, SessionHistoryPanel, type SessionHistoryPanelProps, type SessionHistoryState, type SessionPageQuery, type SmoothRevealOptions, type StreamChatOptions, type SubmitInteractionAnswer, type ToolDetailRenderers, type ToolRunRecord, type ToolRunStep, type UseChatInteractionsOptions, type UseChatInteractionsResult, type UseComposerAttachmentsOptions, type UseComposerAttachmentsResult, type UseDurablePlanFlowOptions, type UseDurablePlanFlowResult, type UseInfiniteScrollOptions, type UseSessionHistoryOptions, type WaterfallRow, WorkProductCard, type WorkProductCardProps, __resetAttachmentFileCacheForTests, activityTone, buildAnswerData, cancelChatInteraction, consumeChatStream, createDurableInteractionAnswerSubmitter, createDurablePlanDecisionClient, createInteractionAnswerSubmitter, createMemoryInteractionAttemptStore, createSessionInteractionAttemptStore, describeProvenance, describeProvenanceSourceStatus, dispatchChatStreamLine, durableChatCardsFromParts, fieldAnswer, fieldValuesFromAnswers, formatActivityCost, formatActivityDuration, formatModelCost, formatRecordGridValue, formatSessionTimestamp, formatTokensPerSecond, hasSecretField, hydrateChatInteractions, interactionStatusLabels, interactionSubmissionSignature, interactionTerminalNotes, isLateAnswerableStatus, isRecordGridCellApplicable, lateAnswerMessage, loadAttachmentFile, loadingProvenanceSources, mergeActivityPages, mergeReviewQueuePages, nextRevealCount, parseRecordGridInput, pendingApprovalOf, projectRecordGridRows, provenanceBasisMeta, provenanceGaps, provenanceNextMove, provenanceStandingMeta, provenanceTriggerLabel, pruneRecordGridOverlay, readRecordGridCell, recordGridEditorText, recordGridFail, recordGridOk, recordGridRowLabel, resolveChatInteraction, resolveProvenanceStanding, responseErrorMessage, restoreChatInteractions, reviewQueueStateLabel, rollUpProvenanceStanding, sameRecordGridValue, segmentMentionContent, settleInteractionSubmit, standingFromConfidence, streamChatTurn, sumRecordGridColumn, terminalizePendingChatInteractions, triggerAttachmentDownload, upsertChatInteraction, useChatInteractions, useComposerAttachments, useDurablePlanFlow, useInfiniteScroll, usePending, usePopover, useSessionActions, useSessionHistory, useSmoothText, useThinkingSeconds, validateRecordGridCell, validateRecordGridRow, waterfallLayout, weakerProvenanceStanding, withRecordGridCreated, withRecordGridRemoved, withRecordGridServerRow, withRecordGridUpdate, withoutRecordGridCreated, withoutRecordGridRemoved, withoutRecordGridUpdate, workProductPartsFromMessageParts, workProductStatusLabel };
+export { type ActivityTone, type AgentActivityPage, AgentActivityPanel, type AgentActivityPanelProps, type AgentActivityRecord, AgentSessionControls, type AgentSessionControlsProps, type AttachmentFileResult, CatalogModel, ChatAttachmentInput, ChatAttachmentKind, ChatAttachmentPart, ChatComposer, type ChatComposerProps, type ChatEmptyDoor, ChatEmptyState, type ChatEmptyStateProps, ChatInteraction, ChatInteractionField, type ChatInteractionRestoreMode, ChatInteractionStatus, ChatMentionPart, type ChatMessageMetrics, type ChatMessageSegment, ChatMessages, type ChatMessagesProps, ChatSelectField, type ChatStreamCallbacks, type ChatStreamToolCall, type ChatStreamToolResult, type ChatToolCallInfo, type ChatUiMessage, type ComposerFile, type ComposerFilePart, type ComposerSendFailure, type ComposerSendHandler, type ComposerSendOutcome, type ComposerSendPartsHandler, type ComposerSendRejected, type ComposerSendResult, type ConsumeChatStreamResult, DEFAULT_EFFORT_LEVELS, DEFAULT_PROVENANCE_CONFIDENCE_POLICY, type DurableChatCard, DurableChatCards, type DurableChatCardsProps, type DurableInteractionAnswerSubmitterOptions, DurablePlanCard, type DurablePlanCardProps, DurablePlanClientError, type DurablePlanCurrentInput, type DurablePlanDecision, type DurablePlanDecisionClient, type DurablePlanDecisionClientOptions, type DurablePlanDecisionInput, type DurablePlanDecisionResult, type DurablePlanFollowUpReceipt, EMPTY_RECORD_GRID_OVERLAY, type EffortLevel, EffortPicker, type EffortPickerProps, EvidenceLineageTable, type EvidenceLineageTableProps, ExceptionList, type ExceptionListProps, type FetchSessionPage, type FieldValues, FlowWaterfall, type FlowWaterfallProps, INTERACTION_SUBMIT_TIMEOUT_MESSAGE, INTERACTION_SUBMIT_TIMEOUT_MS, InteractionActionButton, type InteractionAnswerSubmission, type InteractionAnswerSubmitterOptions, InteractionAnswers, type InteractionAttemptStore, InteractionBadge, type InteractionBadgeVariant, InteractionCancelData, InteractionPlanCard, type InteractionPlanCardProps, InteractionQuestionCard, type InteractionQuestionCardProps, InteractionRequestWire, type InteractionSubmitResult, type LinkLikeComponent, type LinkLikeProps, type MentionTextSegment, MessageAttachments, type MessageAttachmentsProps, MissionActivityLane, type MissionActivityLaneProps, ModelPicker, type ModelPickerProps, PROVENANCE_BASES, type ProposalApprovalHandlers, type ProvenanceBasis, type ProvenanceBasisMeta, type ProvenanceConfidencePolicy, type ProvenanceGap, type ProvenanceGapKind, ProvenanceLegend, type ProvenanceLegendProps, type ProvenanceRecord, type ProvenanceSource, type ProvenanceSourceStatus, ProvenanceStamp, type ProvenanceStampProps, type ProvenanceStanding, type ProvenanceStandingMeta, ProvenanceValue, type ProvenanceValueProps, ProviderLogo, type ProviderLogoProps, QualityCheckList, type QualityCheckListProps, QuestionOptionList, type QuestionOptionListProps, RecordGrid, type RecordGridBooleanColumn, type RecordGridCellChange, type RecordGridCellOutcome, type RecordGridCellSource, type RecordGridColumn, type RecordGridColumnBase, type RecordGridCreateOutcome, type RecordGridCurrencyColumn, type RecordGridDateColumn, type RecordGridDependency, type RecordGridEmptyState, type RecordGridNumberColumn, type RecordGridOverlay, type RecordGridProps, type RecordGridRow, type RecordGridRowOutcome, type RecordGridSelectColumn, type RecordGridSelectOption, type RecordGridSourceBasis, type RecordGridState, type RecordGridTextColumn, type RecordGridValue, type RecordGridWriteOutcome, type RestoreChatInteractionsOptions, ReviewQueueItem, type ReviewQueuePage, ReviewQueuePanel, type ReviewQueuePanelProps, ReviewQueueState, RunDrillIn, type RunDrillInProps, SeatPaywall, type SeatPaywallProps, type SessionActionLabels, type SessionActions, type SessionActionsOptions, type SessionBulkAction, SessionHistoryPanel, type SessionHistoryPanelProps, type SessionHistoryState, type SessionPageQuery, type SmoothRevealOptions, type StreamChatOptions, type SubmitInteractionAnswer, type ToolDetailRenderers, type ToolRunRecord, type ToolRunStep, type UseChatInteractionsOptions, type UseChatInteractionsResult, type UseComposerAttachmentsOptions, type UseComposerAttachmentsResult, type UseDurablePlanFlowOptions, type UseDurablePlanFlowResult, type UseInfiniteScrollOptions, type UseSessionHistoryOptions, type WaterfallRow, WorkProductCard, type WorkProductCardProps, __resetAttachmentFileCacheForTests, activityTone, buildAnswerData, cancelChatInteraction, consumeChatStream, createDurableInteractionAnswerSubmitter, createDurablePlanDecisionClient, createInteractionAnswerSubmitter, createMemoryInteractionAttemptStore, createSessionInteractionAttemptStore, describeProvenance, describeProvenanceSourceStatus, dispatchChatStreamLine, durableChatCardsFromParts, fieldAnswer, fieldValuesFromAnswers, formatActivityCost, formatActivityDuration, formatModelCost, formatRecordGridValue, formatSessionTimestamp, formatTokensPerSecond, hasSecretField, hydrateChatInteractions, interactionStatusLabels, interactionSubmissionSignature, interactionTerminalNotes, isLateAnswerableStatus, isRecordGridCellApplicable, lateAnswerMessage, loadAttachmentFile, loadingProvenanceSources, mergeActivityPages, mergeReviewQueuePages, nextRevealCount, parseRecordGridInput, pendingApprovalOf, projectRecordGridRows, provenanceBasisMeta, provenanceGaps, provenanceNextMove, provenanceStandingMeta, provenanceTriggerLabel, pruneRecordGridOverlay, readRecordGridCell, recordGridEditorText, recordGridFail, recordGridOk, recordGridRowLabel, resolveChatInteraction, resolveProvenanceStanding, responseErrorMessage, restoreChatInteractions, reviewQueueStateLabel, rollUpProvenanceStanding, sameRecordGridValue, segmentMentionContent, settleInteractionSubmit, standingFromConfidence, streamChatTurn, sumRecordGridColumn, terminalizePendingChatInteractions, triggerAttachmentDownload, upsertChatInteraction, useChatInteractions, useComposerAttachments, useDurablePlanFlow, useInfiniteScroll, usePending, usePopover, useSessionActions, useSessionHistory, useSmoothText, useThinkingSeconds, validateRecordGridCell, validateRecordGridRow, waterfallLayout, weakerProvenanceStanding, withRecordGridCreated, withRecordGridRemoved, withRecordGridServerRow, withRecordGridUpdate, withoutRecordGridCreated, withoutRecordGridRemoved, withoutRecordGridUpdate, workProductPartsFromMessageParts, workProductStatusLabel };

package/dist/web-react/index.js

@@ -117,7 +117,7 @@ import {
   withoutRecordGridCreated,
   withoutRecordGridRemoved,
   withoutRecordGridUpdate
-} from "../chunk-7PFFFRVU.js";
+} from "../chunk-KOMP6NDW.js";
 import "../chunk-FBVLEGEG.js";
 import {
   useComposerAttachments
@@ -138,7 +138,7 @@ import {
   reviewQueueStateLabel,
   workProductPartsFromMessageParts,
   workProductStatusLabel
-} from "../chunk-YTMKRL3L.js";
+} from "../chunk-HZ4WCA37.js";
 import {
   parseReviewQueueItem
 } from "../chunk-GEYACSFW.js";

package/dist/work-product-react/index.js

@@ -4,7 +4,7 @@ import {
   ProvenanceStamp,
   QualityCheckList,
   workProductStatusLabel
-} from "../chunk-YTMKRL3L.js";
+} from "../chunk-HZ4WCA37.js";
 import "../chunk-GEYACSFW.js";
 import {
   unresolvedBlockingExceptions

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tangle-network/agent-app",
-  "version": "0.45.23",
+  "version": "0.45.24",
   "packageManager": "pnpm@11.17.0",
   "description": "Build agent applications with typed chat, tools, sandboxes, integrations, billing, and evaluation.",
   "keywords": [

package/dist/VaultPane-HFH734K6.js

@@ -1,7 +0,0 @@
-import {
-  VaultPane
-} from "./chunk-FVJP2RTC.js";
-export {
-  VaultPane
-};
-//# sourceMappingURL=VaultPane-HFH734K6.js.map