@deuz-sdk/react 1.7.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Umutcan Edizaslan (U-C4N / Deuz)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,35 @@
+# @deuz-sdk/react
+
+React bindings for the [Deuz SDK](https://github.com/Deuz-AI/Deuz-SDK) — `useChat` / `useObject` hooks and minimal headless components on top of `@deuz-sdk/core`.
+
+```bash
+npm i @deuz-sdk/core @deuz-sdk/react
+```
+
+Thin adapter by design: every chat-state transformation lives in `@deuz-sdk/core/chat` (the pure reducer/branch helpers) and the Deuz UI wire (`@deuz-sdk/core/ui`); this package only binds them to React state. `react` is a peer dependency (`^18 || ^19`). The legacy `@deuz-sdk/core/react` subpath keeps working but is frozen; new features land here.
+
+## API
+
+### `useChat(options): UseChatResult`
+
+Options: `api`, `initialMessages?` (rendered via `uiFromMessages`), `headers?`, `body?`, `chatId?` (merged into every request body), `resume?` (`{ endpoint, lastEventId? }` — enables `reconnect()`), `generateId?`, `onToolCall?` (client-tool executor, auto round-trip with self-healing errors), `onError?`, `fetch?`.
+
+Result:
+
+- State: `messages: UIMessage[]`, `status: 'idle' | 'streaming' | 'error'`, `error`, `pendingApprovals: ToolApprovalRequest[]`, `cost?: { costUsd, cacheSavingsUsd? }`, `budgetExceeded?: { kind, limit, value }`, `dataParts: { name, payload }[]`, `citations`.
+- Methods: `sendMessage(text)`, `stop()`, `regenerate()` (core `dropTrailingAssistant`), `editAndResend(messageId, text)` (core `branchBeforeUserMessage`), `addToolApprovalResponse(response)` (auto-preserves the request's signed `token`; auto-resumes with `approvalResponses` once every pending approval has a verdict), `reconnect()` (reads the resume endpoint via `connectDeuzStream`).
+
+### `useObject<T>(options): UseObjectResult<T>`
+
+Streams `toDeuzObjectStreamResponse` output. Options: `api`, `headers?`, `fetch?`. Result: `object` (latest `DeepPartial<T>`), `isLoading`, `error`, `submit(input)`, `stop()`.
+
+### Headless components (zero styling)
+
+- `ToolApprovalCard({ approval, onRespond, render? })` — Approve/Deny for one pending approval; the verdict always carries the request's signed `token`. `render` overrides presentation and receives wired `approve()` / `deny(reason?)` callbacks.
+- `CostBadge({ cost, format? })` — `$X.XXXX` plus ` (saved $Y.YYYY)` when cache savings are positive; `format` overrides.
+
+### Re-exported core types
+
+`UIMessage`, `UIToolCall`, `AssistantTurnState`, `ChatHistory`, `DeuzUIPart`, `Message`, `ToolApprovalRequest`, `ToolApprovalResponse`.
+
+See the [main README](https://github.com/Deuz-AI/Deuz-SDK#readme) for the full SDK tour.

package/dist/index.cjs

@@ -0,0 +1,368 @@
+'use strict';
+
+var react = require('react');
+var chat = require('@deuz-sdk/core/chat');
+var ui = require('@deuz-sdk/core/ui');
+var jsxRuntime = require('react/jsx-runtime');
+
+// src/use-chat.ts
+function foldPart(turn, part) {
+  const next = chat.applyUIPart(turn, part);
+  if (part.type === "tool-approval-request" && part.token !== void 0) {
+    return {
+      ...next,
+      approvals: next.approvals.map(
+        (a) => a.approvalId === part.approvalId && a.token === void 0 ? { ...a, token: part.token } : a
+      )
+    };
+  }
+  return next;
+}
+var defaultGenerateId = () => typeof crypto !== "undefined" && typeof crypto.randomUUID === "function" ? crypto.randomUUID() : `deuz-ui-${Math.random().toString(36).slice(2)}`;
+function useChat(options) {
+  const genId = options.generateId ?? defaultGenerateId;
+  const [messages, setMessages] = react.useState(
+    () => chat.uiFromMessages(options.initialMessages ?? [], genId)
+  );
+  const [status, setStatus] = react.useState("idle");
+  const [error, setError] = react.useState(void 0);
+  const [pendingApprovals, setPendingApprovals] = react.useState([]);
+  const [cost, setCost] = react.useState(void 0);
+  const [budgetExceeded, setBudgetExceeded] = react.useState(
+    void 0
+  );
+  const [dataParts, setDataParts] = react.useState([]);
+  const [citations, setCitations] = react.useState([]);
+  const uiRef = react.useRef(messages);
+  const canonicalRef = react.useRef(
+    options.initialMessages ? [...options.initialMessages] : []
+  );
+  const turnRef = react.useRef(void 0);
+  const approvalsRef = react.useRef([]);
+  const verdictsRef = react.useRef([]);
+  const abortRef = react.useRef(null);
+  const lastEventIdRef = react.useRef(options.resume?.lastEventId);
+  const pushMessage = react.useCallback((message) => {
+    uiRef.current = [...uiRef.current, message];
+    setMessages(uiRef.current);
+  }, []);
+  const syncTurn = react.useCallback((turn) => {
+    uiRef.current = [...uiRef.current.slice(0, -1), turn.message];
+    setMessages(uiRef.current);
+    if (turn.costUsd !== void 0) {
+      setCost({
+        costUsd: turn.costUsd,
+        ...turn.cacheSavingsUsd !== void 0 ? { cacheSavingsUsd: turn.cacheSavingsUsd } : {}
+      });
+    }
+    setBudgetExceeded(turn.budgetExceeded);
+    setDataParts(turn.dataParts);
+    setCitations(turn.citations);
+  }, []);
+  const stop = react.useCallback(() => {
+    abortRef.current?.abort();
+  }, []);
+  const run = react.useCallback(
+    async (approvalResponses) => {
+      const controller = new AbortController();
+      abortRef.current = controller;
+      setStatus("streaming");
+      setError(void 0);
+      try {
+        for (; ; ) {
+          const doFetch = options.fetch ?? fetch;
+          const res = await doFetch(options.api, {
+            method: "POST",
+            headers: { "content-type": "application/json", ...options.headers },
+            body: JSON.stringify({
+              messages: canonicalRef.current,
+              ...options.chatId !== void 0 ? { chatId: options.chatId } : {},
+              ...approvalResponses?.length ? { approvalResponses } : {},
+              ...options.body
+            }),
+            signal: controller.signal
+          });
+          approvalResponses = void 0;
+          let turn = chat.createAssistantTurn(genId());
+          turnRef.current = turn;
+          pushMessage(turn.message);
+          syncTurn(turn);
+          for await (const part of ui.readDeuzStream(res)) {
+            turn = foldPart(turn, part);
+            turnRef.current = turn;
+            syncTurn(turn);
+          }
+          if (turn.error !== void 0) throw new Error(turn.error);
+          canonicalRef.current = [...canonicalRef.current, chat.assistantMessageFromTurn(turn)];
+          turnRef.current = void 0;
+          if (turn.approvals.length > 0) {
+            approvalsRef.current = turn.approvals;
+            verdictsRef.current = [];
+            setPendingApprovals(turn.approvals);
+            return;
+          }
+          const toolCalls = turn.message.toolCalls ?? [];
+          const serverResults = new Set(turn.serverResults);
+          const clientPending = toolCalls.filter((t) => !serverResults.has(t.toolCallId));
+          if (clientPending.length === 0 || !options.onToolCall) return;
+          const results = [];
+          for (const call of clientPending) {
+            try {
+              const out = await options.onToolCall({
+                toolCallId: call.toolCallId,
+                toolName: call.toolName,
+                input: call.input
+              });
+              results.push({ toolCallId: call.toolCallId, result: out });
+              turn = chat.applyUIPart(turn, {
+                type: "tool-result",
+                toolCallId: call.toolCallId,
+                toolName: call.toolName,
+                output: out
+              });
+            } catch (err) {
+              const message = err instanceof Error ? err.message : String(err);
+              results.push({ toolCallId: call.toolCallId, result: message, isError: true });
+              turn = chat.applyUIPart(turn, {
+                type: "tool-result",
+                toolCallId: call.toolCallId,
+                toolName: call.toolName,
+                output: message,
+                isError: true
+              });
+            }
+            syncTurn(turn);
+          }
+          canonicalRef.current = [...canonicalRef.current, chat.clientToolResultMessage(results)];
+        }
+      } catch (err) {
+        if (controller.signal.aborted) return;
+        const e = err instanceof Error ? err : new Error(String(err));
+        setError(e);
+        setStatus("error");
+        options.onError?.(e);
+        return;
+      } finally {
+        setStatus((s) => s === "error" ? s : "idle");
+      }
+    },
+    [
+      options.api,
+      options.fetch,
+      options.headers,
+      options.body,
+      options.chatId,
+      options.generateId,
+      options.onToolCall,
+      options.onError,
+      pushMessage,
+      syncTurn
+    ]
+  );
+  const sendMessage = react.useCallback(
+    async (text) => {
+      canonicalRef.current = [...canonicalRef.current, { role: "user", content: text }];
+      pushMessage({ id: genId(), role: "user", content: text });
+      approvalsRef.current = [];
+      verdictsRef.current = [];
+      setPendingApprovals([]);
+      await run();
+    },
+    [run, pushMessage, options.generateId]
+  );
+  const regenerate = react.useCallback(async () => {
+    const cut = chat.dropTrailingAssistant({ ui: uiRef.current, canonical: canonicalRef.current });
+    uiRef.current = cut.ui;
+    canonicalRef.current = cut.canonical;
+    setMessages(cut.ui);
+    approvalsRef.current = [];
+    verdictsRef.current = [];
+    setPendingApprovals([]);
+    await run();
+  }, [run]);
+  const editAndResend = react.useCallback(
+    async (messageId, text) => {
+      const cut = chat.branchBeforeUserMessage(
+        { ui: uiRef.current, canonical: canonicalRef.current },
+        messageId
+      );
+      if (!cut) return;
+      uiRef.current = cut.ui;
+      canonicalRef.current = cut.canonical;
+      setMessages(cut.ui);
+      approvalsRef.current = [];
+      verdictsRef.current = [];
+      setPendingApprovals([]);
+      await sendMessage(text);
+    },
+    [sendMessage]
+  );
+  const addToolApprovalResponse = react.useCallback(
+    async (response) => {
+      const request = approvalsRef.current.find((p) => p.approvalId === response.approvalId);
+      const verdict = response.token === void 0 && request?.token !== void 0 ? { ...response, token: request.token } : response;
+      verdictsRef.current = [
+        ...verdictsRef.current.filter((v) => v.approvalId !== verdict.approvalId),
+        verdict
+      ];
+      const verdicts = verdictsRef.current;
+      const allSettled = approvalsRef.current.every(
+        (p) => verdicts.some((v) => v.approvalId === p.approvalId)
+      );
+      if (!allSettled) return;
+      approvalsRef.current = [];
+      verdictsRef.current = [];
+      setPendingApprovals([]);
+      await run(verdicts);
+    },
+    [run]
+  );
+  const reconnect = react.useCallback(async () => {
+    const resume = options.resume;
+    if (!resume) return;
+    const controller = new AbortController();
+    abortRef.current = controller;
+    setStatus("streaming");
+    setError(void 0);
+    try {
+      const cursor = lastEventIdRef.current;
+      let turn;
+      if (turnRef.current && cursor !== void 0) {
+        turn = turnRef.current;
+      } else {
+        turn = chat.createAssistantTurn(genId());
+        if (!turnRef.current) pushMessage(turn.message);
+      }
+      turnRef.current = turn;
+      const parts = ui.connectDeuzStream(resume.endpoint, {
+        ...cursor !== void 0 ? { lastEventId: cursor } : {},
+        onCursor: (id) => {
+          lastEventIdRef.current = id;
+        },
+        signal: controller.signal,
+        ...options.fetch ? { fetch: options.fetch } : {},
+        ...options.headers ? { headers: options.headers } : {}
+      });
+      for await (const part of parts) {
+        turn = foldPart(turn, part);
+        turnRef.current = turn;
+        syncTurn(turn);
+      }
+      if (turn.error !== void 0) throw new Error(turn.error);
+      canonicalRef.current = [...canonicalRef.current, chat.assistantMessageFromTurn(turn)];
+      turnRef.current = void 0;
+      if (turn.approvals.length > 0) {
+        approvalsRef.current = turn.approvals;
+        verdictsRef.current = [];
+        setPendingApprovals(turn.approvals);
+      }
+    } catch (err) {
+      if (controller.signal.aborted) return;
+      const e = err instanceof Error ? err : new Error(String(err));
+      setError(e);
+      setStatus("error");
+      options.onError?.(e);
+      return;
+    } finally {
+      setStatus((s) => s === "error" ? s : "idle");
+    }
+  }, [
+    options.resume,
+    options.fetch,
+    options.headers,
+    options.generateId,
+    options.onError,
+    pushMessage,
+    syncTurn
+  ]);
+  return {
+    messages,
+    status,
+    error,
+    pendingApprovals,
+    ...cost !== void 0 ? { cost } : {},
+    ...budgetExceeded !== void 0 ? { budgetExceeded } : {},
+    dataParts,
+    citations,
+    sendMessage,
+    stop,
+    regenerate,
+    editAndResend,
+    addToolApprovalResponse,
+    reconnect
+  };
+}
+function useObject(options) {
+  const [object, setObject] = react.useState(void 0);
+  const [isLoading, setLoading] = react.useState(false);
+  const [error, setError] = react.useState(void 0);
+  const abortRef = react.useRef(null);
+  const stop = react.useCallback(() => {
+    abortRef.current?.abort();
+  }, []);
+  const submit = react.useCallback(
+    async (input) => {
+      abortRef.current?.abort();
+      const controller = new AbortController();
+      abortRef.current = controller;
+      setLoading(true);
+      setError(void 0);
+      setObject(void 0);
+      try {
+        const doFetch = options.fetch ?? fetch;
+        const res = await doFetch(options.api, {
+          method: "POST",
+          headers: { "content-type": "application/json", ...options.headers },
+          body: JSON.stringify({ input }),
+          signal: controller.signal
+        });
+        for await (const part of ui.readDeuzStream(res)) {
+          if (part.type === "object-delta") {
+            setObject(part.object);
+          } else if (part.type === "error") {
+            setError(new Error(part.message));
+            break;
+          }
+        }
+      } catch (err) {
+        if (!controller.signal.aborted) {
+          setError(err instanceof Error ? err : new Error(String(err)));
+        }
+      } finally {
+        setLoading(false);
+      }
+    },
+    [options.api, options.fetch, options.headers]
+  );
+  return { object, isLoading, error, submit, stop };
+}
+function ToolApprovalCard({ approval, onRespond, render }) {
+  const respond = (approved, reason) => onRespond({
+    approvalId: approval.approvalId,
+    approved,
+    ...reason !== void 0 ? { reason } : {},
+    ...approval.token !== void 0 ? { token: approval.token } : {}
+  });
+  const approve = () => respond(true);
+  const deny = (reason) => respond(false, reason);
+  if (render) return /* @__PURE__ */ jsxRuntime.jsx(jsxRuntime.Fragment, { children: render({ approval, approve, deny }) });
+  return /* @__PURE__ */ jsxRuntime.jsxs("div", { "data-deuz": "tool-approval", children: [
+    /* @__PURE__ */ jsxRuntime.jsx("span", { "data-deuz": "tool-approval-name", children: approval.toolName }),
+    /* @__PURE__ */ jsxRuntime.jsx("pre", { "data-deuz": "tool-approval-input", children: JSON.stringify(approval.input, null, 2) }),
+    /* @__PURE__ */ jsxRuntime.jsx("button", { type: "button", onClick: approve, children: "Approve" }),
+    /* @__PURE__ */ jsxRuntime.jsx("button", { type: "button", onClick: () => deny(), children: "Deny" })
+  ] });
+}
+function CostBadge({ cost, format }) {
+  if (cost === void 0) return null;
+  if (format) return /* @__PURE__ */ jsxRuntime.jsx(jsxRuntime.Fragment, { children: format(cost) });
+  const saved = cost.cacheSavingsUsd !== void 0 && cost.cacheSavingsUsd > 0 ? ` (saved $${cost.cacheSavingsUsd.toFixed(4)})` : "";
+  return /* @__PURE__ */ jsxRuntime.jsx("span", { "data-deuz": "cost-badge", children: `$${cost.costUsd.toFixed(4)}${saved}` });
+}
+
+exports.CostBadge = CostBadge;
+exports.ToolApprovalCard = ToolApprovalCard;
+exports.useChat = useChat;
+exports.useObject = useObject;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/use-chat.ts","../src/use-object.ts","../src/components.tsx"],"names":["applyUIPart","useState","uiFromMessages","useRef","useCallback","createAssistantTurn","readDeuzStream","assistantMessageFromTurn","clientToolResultMessage","dropTrailingAssistant","branchBeforeUserMessage","connectDeuzStream","jsx","Fragment","jsxs"],"mappings":";;;;;;;;AA4BA,SAAS,QAAA,CACP,MACA,IAAA,EACoB;AACpB,EAAA,MAAM,IAAA,GAAOA,gBAAA,CAAY,IAAA,EAAM,IAAI,CAAA;AACnC,EAAA,IAAI,IAAA,CAAK,IAAA,KAAS,uBAAA,IAA2B,IAAA,CAAK,UAAU,MAAA,EAAW;AACrE,IAAA,OAAO;AAAA,MACL,GAAG,IAAA;AAAA,MACH,SAAA,EAAW,KAAK,SAAA,CAAU,GAAA;AAAA,QAAI,CAAC,CAAA,KAC7B,CAAA,CAAE,UAAA,KAAe,KAAK,UAAA,IAAc,CAAA,CAAE,KAAA,KAAU,MAAA,GAAY,EAAE,GAAG,CAAA,EAAG,KAAA,EAAO,IAAA,CAAK,OAAM,GAAI;AAAA;AAC5F,KACF;AAAA,EACF;AACA,EAAA,OAAO,IAAA;AACT;AAGA,IAAM,iBAAA,GAAoB,MACxB,OAAO,MAAA,KAAW,eAAe,OAAO,MAAA,CAAO,eAAe,UAAA,GAC1D,MAAA,CAAO,YAAW,GAClB,CAAA,QAAA,EAAW,KAAK,MAAA,EAAO,CAAE,SAAS,EAAE,CAAA,CAAE,KAAA,CAAM,CAAC,CAAC,CAAA,CAAA;AAyF7C,SAAS,QAAQ,OAAA,EAAwC;AAC9D,EAAA,MAAM,KAAA,GAAQ,QAAQ,UAAA,IAAc,iBAAA;AACpC,EAAA,MAAM,CAAC,QAAA,EAAU,WAAW,CAAA,GAAIC,cAAA;AAAA,IAAsB,MACpDC,mBAAA,CAAe,OAAA,CAAQ,eAAA,IAAmB,IAAI,KAAK;AAAA,GACrD;AACA,EAAA,MAAM,CAAC,MAAA,EAAQ,SAAS,CAAA,GAAID,eAAyC,MAAM,CAAA;AAC3E,EAAA,MAAM,CAAC,KAAA,EAAO,QAAQ,CAAA,GAAIA,eAA4B,MAAS,CAAA;AAC/D,EAAA,MAAM,CAAC,gBAAA,EAAkB,mBAAmB,CAAA,GAAIA,cAAA,CAAgC,EAAE,CAAA;AAClF,EAAA,MAAM,CAAC,IAAA,EAAM,OAAO,CAAA,GAAIA,eAAkC,MAAS,CAAA;AACnE,EAAA,MAAM,CAAC,cAAA,EAAgB,iBAAiB,CAAA,GAAIA,cAAA;AAAA,IAC1C;AAAA,GACF;AACA,EAAA,MAAM,CAAC,SAAA,EAAW,YAAY,CAAA,GAAIA,cAAA,CAAoD,EAAE,CAAA;AACxF,EAAA,MAAM,CAAC,SAAA,EAAW,YAAY,CAAA,GAAIA,cAAA,CAA0C,EAAE,CAAA;AAE9E,EAAA,MAAM,KAAA,GAAQE,aAAoB,QAAQ,CAAA;AAC1C,EAAA,MAAM,YAAA,GAAeA,YAAA;AAAA,IACnB,QAAQ,eAAA,GAAkB,CAAC,GAAG,OAAA,CAAQ,eAAe,IAAI;AAAC,GAC5D;AAEA,EAAA,MAAM,OAAA,GAAUA,aAAuC,MAAS,CAAA;AAChE,EAAA,MAAM,YAAA,GAAeA,YAAA,CAA8B,EAAE,CAAA;AACrD,EAAA,MAAM,WAAA,GAAcA,YAAA,CAA+B,EAAE,CAAA;AACrD,EAAA,MAAM,QAAA,GAAWA,aAA+B,IAAI,CAAA;AACpD,EAAA,MAAM,cAAA,GAAiBA,YAAA,CAA2B,OAAA,CAAQ,MAAA,EAAQ,WAAW,CAAA;AAE7E,EAAA,MAAM,WAAA,GAAcC,iBAAA,CAAY,CAAC,OAAA,KAA6B;AAC5D,IAAA,KAAA,CAAM,OAAA,GAAU,CAAC,GAAG,KAAA,CAAM,SAAS,OAAO,CAAA;AAC1C,IAAA,WAAA,CAAY,MAAM,OAAO,CAAA;AAAA,EAC3B,CAAA,EAAG,EAAE,CAAA;AAGL,EAAA,MAAM,QAAA,GAAWA,iBAAA,CAAY,CAAC,IAAA,KAAmC;AAC/D,IAAA,KAAA,CAAM,OAAA,GAAU,CAAC,GAAG,KAAA,CAAM,OAAA,CAAQ,MAAM,CAAA,EAAG,EAAE,CAAA,EAAG,IAAA,CAAK,OAAO,CAAA;AAC5D,IAAA,WAAA,CAAY,MAAM,OAAO,CAAA;AACzB,IAAA,IAAI,IAAA,CAAK,YAAY,MAAA,EAAW;AAC9B,MAAA,OAAA,CAAQ;AAAA,QACN,SAAS,IAAA,CAAK,OAAA;AAAA,QACd,GAAI,KAAK,eAAA,KAAoB,MAAA,GAAY,EAAE,eAAA,EAAiB,IAAA,CAAK,eAAA,EAAgB,GAAI;AAAC,OACvF,CAAA;AAAA,IACH;AACA,IAAA,iBAAA,CAAkB,KAAK,cAAc,CAAA;AACrC,IAAA,YAAA,CAAa,KAAK,SAAS,CAAA;AAC3B,IAAA,YAAA,CAAa,KAAK,SAAS,CAAA;AAAA,EAC7B,CAAA,EAAG,EAAE,CAAA;AAEL,EAAA,MAAM,IAAA,GAAOA,kBAAY,MAAY;AACnC,IAAA,QAAA,CAAS,SAAS,KAAA,EAAM;AAAA,EAC1B,CAAA,EAAG,EAAE,CAAA;AAEL,EAAA,MAAM,GAAA,GAAMA,iBAAA;AAAA,IACV,OAAO,iBAAA,KAA8D;AACnE,MAAA,MAAM,UAAA,GAAa,IAAI,eAAA,EAAgB;AACvC,MAAA,QAAA,CAAS,OAAA,GAAU,UAAA;AACnB,MAAA,SAAA,CAAU,WAAW,CAAA;AACrB,MAAA,QAAA,CAAS,MAAS,CAAA;AAClB,MAAA,IAAI;AAEF,QAAA,WAAS;AACP,UAAA,MAAM,OAAA,GAAU,QAAQ,KAAA,IAAS,KAAA;AACjC,UAAA,MAAM,GAAA,GAAM,MAAM,OAAA,CAAQ,OAAA,CAAQ,GAAA,EAAK;AAAA,YACrC,MAAA,EAAQ,MAAA;AAAA,YACR,SAAS,EAAE,cAAA,EAAgB,kBAAA,EAAoB,GAAG,QAAQ,OAAA,EAAQ;AAAA,YAClE,IAAA,EAAM,KAAK,SAAA,CAAU;AAAA,cACnB,UAAU,YAAA,CAAa,OAAA;AAAA,cACvB,GAAI,QAAQ,MAAA,KAAW,KAAA,CAAA,GAAY,EAAE,MAAA,EAAQ,OAAA,CAAQ,MAAA,EAAO,GAAI,EAAC;AAAA,cACjE,GAAI,iBAAA,EAAmB,MAAA,GAAS,EAAE,iBAAA,KAAsB,EAAC;AAAA,cACzD,GAAG,OAAA,CAAQ;AAAA,aACZ,CAAA;AAAA,YACD,QAAQ,UAAA,CAAW;AAAA,WACpB,CAAA;AACD,UAAA,iBAAA,GAAoB,KAAA,CAAA;AAEpB,UAAA,IAAI,IAAA,GAAOC,wBAAA,CAAoB,KAAA,EAAO,CAAA;AACtC,UAAA,OAAA,CAAQ,OAAA,GAAU,IAAA;AAClB,UAAA,WAAA,CAAY,KAAK,OAAO,CAAA;AACxB,UAAA,QAAA,CAAS,IAAI,CAAA;AAEb,UAAA,WAAA,MAAiB,IAAA,IAAQC,iBAAA,CAAe,GAAG,CAAA,EAAG;AAC5C,YAAA,IAAA,GAAO,QAAA,CAAS,MAAM,IAAI,CAAA;AAC1B,YAAA,OAAA,CAAQ,OAAA,GAAU,IAAA;AAClB,YAAA,QAAA,CAAS,IAAI,CAAA;AAAA,UACf;AACA,UAAA,IAAI,KAAK,KAAA,KAAU,KAAA,CAAA,QAAiB,IAAI,KAAA,CAAM,KAAK,KAAK,CAAA;AAGxD,UAAA,YAAA,CAAa,UAAU,CAAC,GAAG,aAAa,OAAA,EAASC,6BAAA,CAAyB,IAAI,CAAC,CAAA;AAC/E,UAAA,OAAA,CAAQ,OAAA,GAAU,KAAA,CAAA;AAGlB,UAAA,IAAI,IAAA,CAAK,SAAA,CAAU,MAAA,GAAS,CAAA,EAAG;AAC7B,YAAA,YAAA,CAAa,UAAU,IAAA,CAAK,SAAA;AAC5B,YAAA,WAAA,CAAY,UAAU,EAAC;AACvB,YAAA,mBAAA,CAAoB,KAAK,SAAS,CAAA;AAClC,YAAA;AAAA,UACF;AAGA,UAAA,MAAM,SAAA,GAAY,IAAA,CAAK,OAAA,CAAQ,SAAA,IAAa,EAAC;AAC7C,UAAA,MAAM,aAAA,GAAgB,IAAI,GAAA,CAAI,IAAA,CAAK,aAAa,CAAA;AAChD,UAAA,MAAM,aAAA,GAAgB,SAAA,CAAU,MAAA,CAAO,CAAC,CAAA,KAAM,CAAC,aAAA,CAAc,GAAA,CAAI,CAAA,CAAE,UAAU,CAAC,CAAA;AAC9E,UAAA,IAAI,aAAA,CAAc,MAAA,KAAW,CAAA,IAAK,CAAC,QAAQ,UAAA,EAAY;AACvD,UAAA,MAAM,UAA6E,EAAC;AACpF,UAAA,KAAA,MAAW,QAAQ,aAAA,EAAe;AAChC,YAAA,IAAI;AACF,cAAA,MAAM,GAAA,GAAM,MAAM,OAAA,CAAQ,UAAA,CAAW;AAAA,gBACnC,YAAY,IAAA,CAAK,UAAA;AAAA,gBACjB,UAAU,IAAA,CAAK,QAAA;AAAA,gBACf,OAAO,IAAA,CAAK;AAAA,eACb,CAAA;AACD,cAAA,OAAA,CAAQ,KAAK,EAAE,UAAA,EAAY,KAAK,UAAA,EAAY,MAAA,EAAQ,KAAK,CAAA;AACzD,cAAA,IAAA,GAAOP,iBAAY,IAAA,EAAM;AAAA,gBACvB,IAAA,EAAM,aAAA;AAAA,gBACN,YAAY,IAAA,CAAK,UAAA;AAAA,gBACjB,UAAU,IAAA,CAAK,QAAA;AAAA,gBACf,MAAA,EAAQ;AAAA,eACT,CAAA;AAAA,YACH,SAAS,GAAA,EAAK;AACZ,cAAA,MAAM,UAAU,GAAA,YAAe,KAAA,GAAQ,GAAA,CAAI,OAAA,GAAU,OAAO,GAAG,CAAA;AAC/D,cAAA,OAAA,CAAQ,IAAA,CAAK,EAAE,UAAA,EAAY,IAAA,CAAK,YAAY,MAAA,EAAQ,OAAA,EAAS,OAAA,EAAS,IAAA,EAAM,CAAA;AAC5E,cAAA,IAAA,GAAOA,iBAAY,IAAA,EAAM;AAAA,gBACvB,IAAA,EAAM,aAAA;AAAA,gBACN,YAAY,IAAA,CAAK,UAAA;AAAA,gBACjB,UAAU,IAAA,CAAK,QAAA;AAAA,gBACf,MAAA,EAAQ,OAAA;AAAA,gBACR,OAAA,EAAS;AAAA,eACV,CAAA;AAAA,YACH;AACA,YAAA,QAAA,CAAS,IAAI,CAAA;AAAA,UACf;AACA,UAAA,YAAA,CAAa,UAAU,CAAC,GAAG,aAAa,OAAA,EAASQ,4BAAA,CAAwB,OAAO,CAAC,CAAA;AAAA,QAEnF;AAAA,MACF,SAAS,GAAA,EAAK;AACZ,QAAA,IAAI,UAAA,CAAW,OAAO,OAAA,EAAS;AAC/B,QAAA,MAAM,CAAA,GAAI,eAAe,KAAA,GAAQ,GAAA,GAAM,IAAI,KAAA,CAAM,MAAA,CAAO,GAAG,CAAC,CAAA;AAC5D,QAAA,QAAA,CAAS,CAAC,CAAA;AACV,QAAA,SAAA,CAAU,OAAO,CAAA;AACjB,QAAA,OAAA,CAAQ,UAAU,CAAC,CAAA;AACnB,QAAA;AAAA,MACF,CAAA,SAAE;AACA,QAAA,SAAA,CAAU,CAAC,CAAA,KAAO,CAAA,KAAM,OAAA,GAAU,IAAI,MAAO,CAAA;AAAA,MAC/C;AAAA,IACF,CAAA;AAAA,IACA;AAAA,MACE,OAAA,CAAQ,GAAA;AAAA,MACR,OAAA,CAAQ,KAAA;AAAA,MACR,OAAA,CAAQ,OAAA;AAAA,MACR,OAAA,CAAQ,IAAA;AAAA,MACR,OAAA,CAAQ,MAAA;AAAA,MACR,OAAA,CAAQ,UAAA;AAAA,MACR,OAAA,CAAQ,UAAA;AAAA,MACR,OAAA,CAAQ,OAAA;AAAA,MACR,WAAA;AAAA,MACA;AAAA;AACF,GACF;AAEA,EAAA,MAAM,WAAA,GAAcJ,iBAAA;AAAA,IAClB,OAAO,IAAA,KAAgC;AACrC,MAAA,YAAA,CAAa,OAAA,GAAU,CAAC,GAAG,YAAA,CAAa,OAAA,EAAS,EAAE,IAAA,EAAM,MAAA,EAAQ,OAAA,EAAS,IAAA,EAAM,CAAA;AAChF,MAAA,WAAA,CAAY,EAAE,IAAI,KAAA,EAAM,EAAG,MAAM,MAAA,EAAQ,OAAA,EAAS,MAAM,CAAA;AACxD,MAAA,YAAA,CAAa,UAAU,EAAC;AACxB,MAAA,WAAA,CAAY,UAAU,EAAC;AACvB,MAAA,mBAAA,CAAoB,EAAE,CAAA;AACtB,MAAA,MAAM,GAAA,EAAI;AAAA,IACZ,CAAA;AAAA,IACA,CAAC,GAAA,EAAK,WAAA,EAAa,OAAA,CAAQ,UAAU;AAAA,GACvC;AAEA,EAAA,MAAM,UAAA,GAAaA,kBAAY,YAA2B;AACxD,IAAA,MAAM,GAAA,GAAMK,2BAAsB,EAAE,EAAA,EAAI,MAAM,OAAA,EAAS,SAAA,EAAW,YAAA,CAAa,OAAA,EAAS,CAAA;AACxF,IAAA,KAAA,CAAM,UAAU,GAAA,CAAI,EAAA;AACpB,IAAA,YAAA,CAAa,UAAU,GAAA,CAAI,SAAA;AAC3B,IAAA,WAAA,CAAY,IAAI,EAAE,CAAA;AAClB,IAAA,YAAA,CAAa,UAAU,EAAC;AACxB,IAAA,WAAA,CAAY,UAAU,EAAC;AACvB,IAAA,mBAAA,CAAoB,EAAE,CAAA;AACtB,IAAA,MAAM,GAAA,EAAI;AAAA,EACZ,CAAA,EAAG,CAAC,GAAG,CAAC,CAAA;AAER,EAAA,MAAM,aAAA,GAAgBL,iBAAA;AAAA,IACpB,OAAO,WAAmB,IAAA,KAAgC;AACxD,MAAA,MAAM,GAAA,GAAMM,4BAAA;AAAA,QACV,EAAE,EAAA,EAAI,KAAA,CAAM,OAAA,EAAS,SAAA,EAAW,aAAa,OAAA,EAAQ;AAAA,QACrD;AAAA,OACF;AACA,MAAA,IAAI,CAAC,GAAA,EAAK;AACV,MAAA,KAAA,CAAM,UAAU,GAAA,CAAI,EAAA;AACpB,MAAA,YAAA,CAAa,UAAU,GAAA,CAAI,SAAA;AAC3B,MAAA,WAAA,CAAY,IAAI,EAAE,CAAA;AAClB,MAAA,YAAA,CAAa,UAAU,EAAC;AACxB,MAAA,WAAA,CAAY,UAAU,EAAC;AACvB,MAAA,mBAAA,CAAoB,EAAE,CAAA;AACtB,MAAA,MAAM,YAAY,IAAI,CAAA;AAAA,IACxB,CAAA;AAAA,IACA,CAAC,WAAW;AAAA,GACd;AAEA,EAAA,MAAM,uBAAA,GAA0BN,iBAAA;AAAA,IAC9B,OAAO,QAAA,KAAkD;AAEvD,MAAA,MAAM,OAAA,GAAU,aAAa,OAAA,CAAQ,IAAA,CAAK,CAAC,CAAA,KAAM,CAAA,CAAE,UAAA,KAAe,QAAA,CAAS,UAAU,CAAA;AACrF,MAAA,MAAM,OAAA,GACJ,QAAA,CAAS,KAAA,KAAU,MAAA,IAAa,OAAA,EAAS,KAAA,KAAU,MAAA,GAC/C,EAAE,GAAG,QAAA,EAAU,KAAA,EAAO,OAAA,CAAQ,OAAM,GACpC,QAAA;AACN,MAAA,WAAA,CAAY,OAAA,GAAU;AAAA,QACpB,GAAG,YAAY,OAAA,CAAQ,MAAA,CAAO,CAAC,CAAA,KAAM,CAAA,CAAE,UAAA,KAAe,OAAA,CAAQ,UAAU,CAAA;AAAA,QACxE;AAAA,OACF;AACA,MAAA,MAAM,WAAW,WAAA,CAAY,OAAA;AAC7B,MAAA,MAAM,UAAA,GAAa,aAAa,OAAA,CAAQ,KAAA;AAAA,QAAM,CAAC,MAC7C,QAAA,CAAS,IAAA,CAAK,CAAC,CAAA,KAAM,CAAA,CAAE,UAAA,KAAe,CAAA,CAAE,UAAU;AAAA,OACpD;AACA,MAAA,IAAI,CAAC,UAAA,EAAY;AACjB,MAAA,YAAA,CAAa,UAAU,EAAC;AACxB,MAAA,WAAA,CAAY,UAAU,EAAC;AACvB,MAAA,mBAAA,CAAoB,EAAE,CAAA;AACtB,MAAA,MAAM,IAAI,QAAQ,CAAA;AAAA,IACpB,CAAA;AAAA,IACA,CAAC,GAAG;AAAA,GACN;AAEA,EAAA,MAAM,SAAA,GAAYA,kBAAY,YAA2B;AACvD,IAAA,MAAM,SAAS,OAAA,CAAQ,MAAA;AACvB,IAAA,IAAI,CAAC,MAAA,EAAQ;AACb,IAAA,MAAM,UAAA,GAAa,IAAI,eAAA,EAAgB;AACvC,IAAA,QAAA,CAAS,OAAA,GAAU,UAAA;AACnB,IAAA,SAAA,CAAU,WAAW,CAAA;AACrB,IAAA,QAAA,CAAS,MAAS,CAAA;AAClB,IAAA,IAAI;AACF,MAAA,MAAM,SAAS,cAAA,CAAe,OAAA;AAC9B,MAAA,IAAI,IAAA;AACJ,MAAA,IAAI,OAAA,CAAQ,OAAA,IAAW,MAAA,KAAW,KAAA,CAAA,EAAW;AAC3C,QAAA,IAAA,GAAO,OAAA,CAAQ,OAAA;AAAA,MACjB,CAAA,MAAO;AAGL,QAAA,IAAA,GAAOC,wBAAA,CAAoB,OAAO,CAAA;AAClC,QAAA,IAAI,CAAC,OAAA,CAAQ,OAAA,EAAS,WAAA,CAAY,KAAK,OAAO,CAAA;AAAA,MAChD;AACA,MAAA,OAAA,CAAQ,OAAA,GAAU,IAAA;AAClB,MAAA,MAAM,KAAA,GAAQM,oBAAA,CAAkB,MAAA,CAAO,QAAA,EAAU;AAAA,QAC/C,GAAI,MAAA,KAAW,KAAA,CAAA,GAAY,EAAE,WAAA,EAAa,MAAA,KAAW,EAAC;AAAA,QACtD,QAAA,EAAU,CAAC,EAAA,KAAO;AAChB,UAAA,cAAA,CAAe,OAAA,GAAU,EAAA;AAAA,QAC3B,CAAA;AAAA,QACA,QAAQ,UAAA,CAAW,MAAA;AAAA,QACnB,GAAI,QAAQ,KAAA,GAAQ,EAAE,OAAO,OAAA,CAAQ,KAAA,KAAU,EAAC;AAAA,QAChD,GAAI,QAAQ,OAAA,GAAU,EAAE,SAAS,OAAA,CAAQ,OAAA,KAAY;AAAC,OACvD,CAAA;AACD,MAAA,WAAA,MAAiB,QAAQ,KAAA,EAAO;AAC9B,QAAA,IAAA,GAAO,QAAA,CAAS,MAAM,IAAI,CAAA;AAC1B,QAAA,OAAA,CAAQ,OAAA,GAAU,IAAA;AAClB,QAAA,QAAA,CAAS,IAAI,CAAA;AAAA,MACf;AACA,MAAA,IAAI,KAAK,KAAA,KAAU,KAAA,CAAA,QAAiB,IAAI,KAAA,CAAM,KAAK,KAAK,CAAA;AACxD,MAAA,YAAA,CAAa,UAAU,CAAC,GAAG,aAAa,OAAA,EAASJ,6BAAA,CAAyB,IAAI,CAAC,CAAA;AAC/E,MAAA,OAAA,CAAQ,OAAA,GAAU,KAAA,CAAA;AAClB,MAAA,IAAI,IAAA,CAAK,SAAA,CAAU,MAAA,GAAS,CAAA,EAAG;AAC7B,QAAA,YAAA,CAAa,UAAU,IAAA,CAAK,SAAA;AAC5B,QAAA,WAAA,CAAY,UAAU,EAAC;AACvB,QAAA,mBAAA,CAAoB,KAAK,SAAS,CAAA;AAAA,MACpC;AAAA,IACF,SAAS,GAAA,EAAK;AACZ,MAAA,IAAI,UAAA,CAAW,OAAO,OAAA,EAAS;AAC/B,MAAA,MAAM,CAAA,GAAI,eAAe,KAAA,GAAQ,GAAA,GAAM,IAAI,KAAA,CAAM,MAAA,CAAO,GAAG,CAAC,CAAA;AAC5D,MAAA,QAAA,CAAS,CAAC,CAAA;AACV,MAAA,SAAA,CAAU,OAAO,CAAA;AACjB,MAAA,OAAA,CAAQ,UAAU,CAAC,CAAA;AACnB,MAAA;AAAA,IACF,CAAA,SAAE;AACA,MAAA,SAAA,CAAU,CAAC,CAAA,KAAO,CAAA,KAAM,OAAA,GAAU,IAAI,MAAO,CAAA;AAAA,IAC/C;AAAA,EACF,CAAA,EAAG;AAAA,IACD,OAAA,CAAQ,MAAA;AAAA,IACR,OAAA,CAAQ,KAAA;AAAA,IACR,OAAA,CAAQ,OAAA;AAAA,IACR,OAAA,CAAQ,UAAA;AAAA,IACR,OAAA,CAAQ,OAAA;AAAA,IACR,WAAA;AAAA,IACA;AAAA,GACD,CAAA;AAED,EAAA,OAAO;AAAA,IACL,QAAA;AAAA,IACA,MAAA;AAAA,IACA,KAAA;AAAA,IACA,gBAAA;AAAA,IACA,GAAI,IAAA,KAAS,MAAA,GAAY,EAAE,IAAA,KAAS,EAAC;AAAA,IACrC,GAAI,cAAA,KAAmB,MAAA,GAAY,EAAE,cAAA,KAAmB,EAAC;AAAA,IACzD,SAAA;AAAA,IACA,SAAA;AAAA,IACA,WAAA;AAAA,IACA,IAAA;AAAA,IACA,UAAA;AAAA,IACA,aAAA;AAAA,IACA,uBAAA;AAAA,IACA;AAAA,GACF;AACF;AC3ZO,SAAS,UAAuB,OAAA,EAA+C;AACpF,EAAA,MAAM,CAAC,MAAA,EAAQ,SAAS,CAAA,GAAIN,eAAqC,MAAS,CAAA;AAC1E,EAAA,MAAM,CAAC,SAAA,EAAW,UAAU,CAAA,GAAIA,eAAS,KAAK,CAAA;AAC9C,EAAA,MAAM,CAAC,KAAA,EAAO,QAAQ,CAAA,GAAIA,eAA4B,MAAS,CAAA;AAC/D,EAAA,MAAM,QAAA,GAAWE,aAA+B,IAAI,CAAA;AAEpD,EAAA,MAAM,IAAA,GAAOC,kBAAY,MAAY;AACnC,IAAA,QAAA,CAAS,SAAS,KAAA,EAAM;AAAA,EAC1B,CAAA,EAAG,EAAE,CAAA;AAEL,EAAA,MAAM,MAAA,GAASA,iBAAAA;AAAA,IACb,OAAO,KAAA,KAAkC;AACvC,MAAA,QAAA,CAAS,SAAS,KAAA,EAAM;AACxB,MAAA,MAAM,UAAA,GAAa,IAAI,eAAA,EAAgB;AACvC,MAAA,QAAA,CAAS,OAAA,GAAU,UAAA;AACnB,MAAA,UAAA,CAAW,IAAI,CAAA;AACf,MAAA,QAAA,CAAS,MAAS,CAAA;AAClB,MAAA,SAAA,CAAU,MAAS,CAAA;AACnB,MAAA,IAAI;AACF,QAAA,MAAM,OAAA,GAAU,QAAQ,KAAA,IAAS,KAAA;AACjC,QAAA,MAAM,GAAA,GAAM,MAAM,OAAA,CAAQ,OAAA,CAAQ,GAAA,EAAK;AAAA,UACrC,MAAA,EAAQ,MAAA;AAAA,UACR,SAAS,EAAE,cAAA,EAAgB,kBAAA,EAAoB,GAAG,QAAQ,OAAA,EAAQ;AAAA,UAClE,IAAA,EAAM,IAAA,CAAK,SAAA,CAAU,EAAE,OAAO,CAAA;AAAA,UAC9B,QAAQ,UAAA,CAAW;AAAA,SACpB,CAAA;AACD,QAAA,WAAA,MAAiB,IAAA,IAAQE,iBAAAA,CAAe,GAAG,CAAA,EAAG;AAC5C,UAAA,IAAI,IAAA,CAAK,SAAS,cAAA,EAAgB;AAChC,YAAA,SAAA,CAAU,KAAK,MAAwB,CAAA;AAAA,UACzC,CAAA,MAAA,IAAW,IAAA,CAAK,IAAA,KAAS,OAAA,EAAS;AAChC,YAAA,QAAA,CAAS,IAAI,KAAA,CAAM,IAAA,CAAK,OAAO,CAAC,CAAA;AAChC,YAAA;AAAA,UACF;AAAA,QACF;AAAA,MACF,SAAS,GAAA,EAAK;AACZ,QAAA,IAAI,CAAC,UAAA,CAAW,MAAA,CAAO,OAAA,EAAS;AAC9B,UAAA,QAAA,CAAS,GAAA,YAAe,QAAQ,GAAA,GAAM,IAAI,MAAM,MAAA,CAAO,GAAG,CAAC,CAAC,CAAA;AAAA,QAC9D;AAAA,MACF,CAAA,SAAE;AACA,QAAA,UAAA,CAAW,KAAK,CAAA;AAAA,MAClB;AAAA,IACF,CAAA;AAAA,IACA,CAAC,OAAA,CAAQ,GAAA,EAAK,OAAA,CAAQ,KAAA,EAAO,QAAQ,OAAO;AAAA,GAC9C;AAEA,EAAA,OAAO,EAAE,MAAA,EAAQ,SAAA,EAAW,KAAA,EAAO,QAAQ,IAAA,EAAK;AAClD;AChDO,SAAS,gBAAA,CAAiB,EAAE,QAAA,EAAU,SAAA,EAAW,QAAO,EAA0B;AACvF,EAAA,MAAM,OAAA,GAAU,CAAC,QAAA,EAAmB,MAAA,KAClC,SAAA,CAAU;AAAA,IACR,YAAY,QAAA,CAAS,UAAA;AAAA,IACrB,QAAA;AAAA,IACA,GAAI,MAAA,KAAW,MAAA,GAAY,EAAE,MAAA,KAAW,EAAC;AAAA,IACzC,GAAI,SAAS,KAAA,KAAU,MAAA,GAAY,EAAE,KAAA,EAAO,QAAA,CAAS,KAAA,EAAM,GAAI;AAAC,GACjE,CAAA;AACH,EAAA,MAAM,OAAA,GAAU,MAAY,OAAA,CAAQ,IAAI,CAAA;AACxC,EAAA,MAAM,IAAA,GAAO,CAAC,MAAA,KAA0B,OAAA,CAAQ,OAAO,MAAM,CAAA;AAE7D,EAAA,IAAI,MAAA,yBAAeM,cAAA,CAAAC,mBAAA,EAAA,EAAG,QAAA,EAAA,MAAA,CAAO,EAAE,QAAA,EAAU,OAAA,EAAS,IAAA,EAAM,CAAA,EAAE,CAAA;AAC1D,EAAA,uBACEC,eAAA,CAAC,KAAA,EAAA,EAAI,WAAA,EAAU,eAAA,EACb,QAAA,EAAA;AAAA,oBAAAF,cAAA,CAAC,MAAA,EAAA,EAAK,WAAA,EAAU,oBAAA,EAAsB,QAAA,EAAA,QAAA,CAAS,QAAA,EAAS,CAAA;AAAA,oBACxDA,cAAA,CAAC,KAAA,EAAA,EAAI,WAAA,EAAU,qBAAA,EAAuB,QAAA,EAAA,IAAA,CAAK,UAAU,QAAA,CAAS,KAAA,EAAO,IAAA,EAAM,CAAC,CAAA,EAAE,CAAA;AAAA,mCAC7E,QAAA,EAAA,EAAO,IAAA,EAAK,QAAA,EAAS,OAAA,EAAS,SAAS,QAAA,EAAA,SAAA,EAExC,CAAA;AAAA,oBACAA,cAAA,CAAC,YAAO,IAAA,EAAK,QAAA,EAAS,SAAS,MAAM,IAAA,IAAQ,QAAA,EAAA,MAAA,EAE7C;AAAA,GAAA,EACF,CAAA;AAEJ;AAUO,SAAS,SAAA,CAAU,EAAE,IAAA,EAAM,MAAA,EAAO,EAAmB;AAC1D,EAAA,IAAI,IAAA,KAAS,QAAW,OAAO,IAAA;AAC/B,EAAA,IAAI,MAAA,EAAQ,uBAAOA,cAAA,CAAAC,mBAAA,EAAA,EAAG,QAAA,EAAA,MAAA,CAAO,IAAI,CAAA,EAAE,CAAA;AACnC,EAAA,MAAM,KAAA,GACJ,IAAA,CAAK,eAAA,KAAoB,MAAA,IAAa,IAAA,CAAK,eAAA,GAAkB,CAAA,GACzD,CAAA,SAAA,EAAY,IAAA,CAAK,eAAA,CAAgB,OAAA,CAAQ,CAAC,CAAC,CAAA,CAAA,CAAA,GAC3C,EAAA;AACN,EAAA,uBAAOD,cAAA,CAAC,MAAA,EAAA,EAAK,WAAA,EAAU,YAAA,EAAc,QAAA,EAAA,CAAA,CAAA,EAAI,IAAA,CAAK,OAAA,CAAQ,OAAA,CAAQ,CAAC,CAAC,CAAA,EAAG,KAAK,CAAA,CAAA,EAAG,CAAA;AAC7E","file":"index.cjs","sourcesContent":["/**\n * useChat — the React binding over `@deuz-sdk/core/chat` + the Deuz UI wire.\n *\n * THIN by contract: every chat-state transformation is a core call\n * (`createAssistantTurn`/`applyUIPart`/`assistantMessageFromTurn`/\n * `clientToolResultMessage`/`uiFromMessages`/`dropTrailingAssistant`/\n * `branchBeforeUserMessage`). This hook only owns React state, the fetch\n * round-trips, and abort wiring. Supersedes the frozen `@deuz-sdk/core/react`.\n */\nimport { useCallback, useRef, useState } from 'react';\nimport type { Message, ToolApprovalRequest, ToolApprovalResponse } from '@deuz-sdk/core';\nimport {\n  applyUIPart,\n  assistantMessageFromTurn,\n  branchBeforeUserMessage,\n  clientToolResultMessage,\n  createAssistantTurn,\n  dropTrailingAssistant,\n  uiFromMessages,\n} from '@deuz-sdk/core/chat';\nimport type { AssistantTurnState, UIMessage } from '@deuz-sdk/core/chat';\nimport { connectDeuzStream, readDeuzStream } from '@deuz-sdk/core/ui';\n\n/**\n * Fold one wire part via the core reducer. Trivial glue on top: core 1.7.0's\n * `applyUIPart` drops the `token` field of a `tool-approval-request` when it\n * builds the approval entry — re-attach it so verdicts can echo it (D4).\n */\nfunction foldPart(\n  turn: AssistantTurnState,\n  part: Parameters<typeof applyUIPart>[1],\n): AssistantTurnState {\n  const next = applyUIPart(turn, part);\n  if (part.type === 'tool-approval-request' && part.token !== undefined) {\n    return {\n      ...next,\n      approvals: next.approvals.map((a) =>\n        a.approvalId === part.approvalId && a.token === undefined ? { ...a, token: part.token } : a,\n      ),\n    };\n  }\n  return next;\n}\n\n/** Local id fallback — this package is not edge-lint-constrained. */\nconst defaultGenerateId = (): string =>\n  typeof crypto !== 'undefined' && typeof crypto.randomUUID === 'function'\n    ? crypto.randomUUID()\n    : `deuz-ui-${Math.random().toString(36).slice(2)}`;\n\n/** Live cumulative USD cost, from the wire's `cost` parts (last one wins). */\nexport interface UseChatCost {\n  costUsd: number;\n  cacheSavingsUsd?: number;\n}\n\n/** The server's budget guardrail tripped (`budget-exceeded` part). */\nexport interface UseChatBudgetExceeded {\n  kind: 'usd' | 'tokens';\n  limit: number;\n  value: number;\n}\n\nexport interface UseChatResumeOptions {\n  /**\n   * Resume endpoint (see core's `resumeDeuzStreamResponse`): a GET URL or a\n   * factory returning the `Response` for a given cursor. Do NOT point it at\n   * the generating POST route — that would re-run the model.\n   */\n  endpoint: string | ((ctx: { lastEventId?: string }) => Response | Promise<Response>);\n  /** Cursor to resume from (e.g. persisted across a page reload). */\n  lastEventId?: string;\n}\n\nexport interface UseChatOptions {\n  /** Endpoint serving `toDeuzStreamResponse` output. */\n  api: string;\n  /** Seed canonical history (e.g. restored from a ChatStore) — rendered via `uiFromMessages`. */\n  initialMessages?: Message[];\n  headers?: Record<string, string>;\n  /** Extra fields merged into every request body. */\n  body?: Record<string, unknown>;\n  /** Chat identity — merged into every request body (server-side ChatStore persistence). */\n  chatId?: string;\n  /** Enables `reconnect()` against a resume endpoint (wire v2, `connectDeuzStream`). */\n  resume?: UseChatResumeOptions;\n  /** Id source for UI messages/turns. Default: `crypto.randomUUID` (with a fallback). */\n  generateId?: () => string;\n  /**\n   * Client-tool executor: called for every streamed tool call the SERVER did\n   * not execute. The return value is appended as its tool_result and the chat\n   * auto-continues; a throw self-heals as an is_error result.\n   */\n  onToolCall?: (call: {\n    toolCallId: string;\n    toolName: string;\n    input: unknown;\n  }) => Promise<unknown> | unknown;\n  onError?: (error: Error) => void;\n  /** Injectable for tests / custom transports. Defaults to global fetch. */\n  fetch?: typeof fetch;\n}\n\nexport interface UseChatResult {\n  messages: UIMessage[];\n  status: 'idle' | 'streaming' | 'error';\n  error: Error | undefined;\n  /** Gated tool calls awaiting verdicts — the chat is PAUSED while non-empty. */\n  pendingApprovals: ToolApprovalRequest[];\n  /** Live cumulative cost from the wire's `cost` parts (last one wins). */\n  cost?: UseChatCost;\n  /** Set when the server's budget guardrail tripped this turn. */\n  budgetExceeded?: UseChatBudgetExceeded;\n  /** This turn's app-defined `data-{name}` parts, in arrival order. */\n  dataParts: Array<{ name: string; payload: unknown }>;\n  /** This turn's RAG citations. */\n  citations: AssistantTurnState['citations'];\n  sendMessage: (text: string) => Promise<void>;\n  /** Abort the in-flight stream (not an error). */\n  stop: () => void;\n  /** Drop the trailing assistant/tool turns (core `dropTrailingAssistant`) and re-run. */\n  regenerate: () => Promise<void>;\n  /** Cut history before `messageId` (core `branchBeforeUserMessage`) and send `text`. */\n  editAndResend: (messageId: string, text: string) => Promise<void>;\n  /**\n   * Record one verdict (the request's signed `token` is auto-preserved). Once\n   * EVERY pending approval has a verdict, the chat auto-resumes with\n   * `approvalResponses` in the request body.\n   */\n  addToolApprovalResponse: (response: ToolApprovalResponse) => Promise<void>;\n  /**\n   * Re-read the stream from `resume.endpoint` via `connectDeuzStream` and fold\n   * the parts into the current turn. No-op unless `options.resume` is set.\n   */\n  reconnect: () => Promise<void>;\n}\n\nexport function useChat(options: UseChatOptions): UseChatResult {\n  const genId = options.generateId ?? defaultGenerateId;\n  const [messages, setMessages] = useState<UIMessage[]>(() =>\n    uiFromMessages(options.initialMessages ?? [], genId),\n  );\n  const [status, setStatus] = useState<'idle' | 'streaming' | 'error'>('idle');\n  const [error, setError] = useState<Error | undefined>(undefined);\n  const [pendingApprovals, setPendingApprovals] = useState<ToolApprovalRequest[]>([]);\n  const [cost, setCost] = useState<UseChatCost | undefined>(undefined);\n  const [budgetExceeded, setBudgetExceeded] = useState<UseChatBudgetExceeded | undefined>(\n    undefined,\n  );\n  const [dataParts, setDataParts] = useState<Array<{ name: string; payload: unknown }>>([]);\n  const [citations, setCitations] = useState<AssistantTurnState['citations']>([]);\n\n  const uiRef = useRef<UIMessage[]>(messages);\n  const canonicalRef = useRef<Message[]>(\n    options.initialMessages ? [...options.initialMessages] : [],\n  );\n  /** The in-flight turn — kept across a drop so `reconnect()` can continue it. */\n  const turnRef = useRef<AssistantTurnState | undefined>(undefined);\n  const approvalsRef = useRef<ToolApprovalRequest[]>([]);\n  const verdictsRef = useRef<ToolApprovalResponse[]>([]);\n  const abortRef = useRef<AbortController | null>(null);\n  const lastEventIdRef = useRef<string | undefined>(options.resume?.lastEventId);\n\n  const pushMessage = useCallback((message: UIMessage): void => {\n    uiRef.current = [...uiRef.current, message];\n    setMessages(uiRef.current);\n  }, []);\n\n  /** Sync ALL turn-derived React state (the turn's message is the trailing UI element). */\n  const syncTurn = useCallback((turn: AssistantTurnState): void => {\n    uiRef.current = [...uiRef.current.slice(0, -1), turn.message];\n    setMessages(uiRef.current);\n    if (turn.costUsd !== undefined) {\n      setCost({\n        costUsd: turn.costUsd,\n        ...(turn.cacheSavingsUsd !== undefined ? { cacheSavingsUsd: turn.cacheSavingsUsd } : {}),\n      });\n    }\n    setBudgetExceeded(turn.budgetExceeded);\n    setDataParts(turn.dataParts);\n    setCitations(turn.citations);\n  }, []);\n\n  const stop = useCallback((): void => {\n    abortRef.current?.abort();\n  }, []);\n\n  const run = useCallback(\n    async (approvalResponses?: ToolApprovalResponse[]): Promise<void> => {\n      const controller = new AbortController();\n      abortRef.current = controller;\n      setStatus('streaming');\n      setError(undefined);\n      try {\n        // One iteration per model round; client-tool results loop back in.\n        for (;;) {\n          const doFetch = options.fetch ?? fetch;\n          const res = await doFetch(options.api, {\n            method: 'POST',\n            headers: { 'content-type': 'application/json', ...options.headers },\n            body: JSON.stringify({\n              messages: canonicalRef.current,\n              ...(options.chatId !== undefined ? { chatId: options.chatId } : {}),\n              ...(approvalResponses?.length ? { approvalResponses } : {}),\n              ...options.body,\n            }),\n            signal: controller.signal,\n          });\n          approvalResponses = undefined; // consumed by the first round only\n\n          let turn = createAssistantTurn(genId());\n          turnRef.current = turn;\n          pushMessage(turn.message);\n          syncTurn(turn); // resets this-turn state (dataParts/citations/budget)\n\n          for await (const part of readDeuzStream(res)) {\n            turn = foldPart(turn, part);\n            turnRef.current = turn;\n            syncTurn(turn);\n          }\n          if (turn.error !== undefined) throw new Error(turn.error);\n\n          // Append the canonical assistant turn (client-tools reconstruction).\n          canonicalRef.current = [...canonicalRef.current, assistantMessageFromTurn(turn)];\n          turnRef.current = undefined;\n\n          // Approval pause: verdicts arrive via addToolApprovalResponse.\n          if (turn.approvals.length > 0) {\n            approvalsRef.current = turn.approvals;\n            verdictsRef.current = [];\n            setPendingApprovals(turn.approvals);\n            return;\n          }\n\n          // Client-tool auto-round-trip: everything the server didn't execute.\n          const toolCalls = turn.message.toolCalls ?? [];\n          const serverResults = new Set(turn.serverResults);\n          const clientPending = toolCalls.filter((t) => !serverResults.has(t.toolCallId));\n          if (clientPending.length === 0 || !options.onToolCall) return;\n          const results: Array<{ toolCallId: string; result: unknown; isError?: boolean }> = [];\n          for (const call of clientPending) {\n            try {\n              const out = await options.onToolCall({\n                toolCallId: call.toolCallId,\n                toolName: call.toolName,\n                input: call.input,\n              });\n              results.push({ toolCallId: call.toolCallId, result: out });\n              turn = applyUIPart(turn, {\n                type: 'tool-result',\n                toolCallId: call.toolCallId,\n                toolName: call.toolName,\n                output: out,\n              });\n            } catch (err) {\n              const message = err instanceof Error ? err.message : String(err);\n              results.push({ toolCallId: call.toolCallId, result: message, isError: true });\n              turn = applyUIPart(turn, {\n                type: 'tool-result',\n                toolCallId: call.toolCallId,\n                toolName: call.toolName,\n                output: message,\n                isError: true,\n              });\n            }\n            syncTurn(turn);\n          }\n          canonicalRef.current = [...canonicalRef.current, clientToolResultMessage(results)];\n          // loop → next round POSTs the extended history\n        }\n      } catch (err) {\n        if (controller.signal.aborted) return; // user abort — not an error\n        const e = err instanceof Error ? err : new Error(String(err));\n        setError(e);\n        setStatus('error');\n        options.onError?.(e);\n        return;\n      } finally {\n        setStatus((s) => (s === 'error' ? s : 'idle'));\n      }\n    },\n    [\n      options.api,\n      options.fetch,\n      options.headers,\n      options.body,\n      options.chatId,\n      options.generateId,\n      options.onToolCall,\n      options.onError,\n      pushMessage,\n      syncTurn,\n    ],\n  );\n\n  const sendMessage = useCallback(\n    async (text: string): Promise<void> => {\n      canonicalRef.current = [...canonicalRef.current, { role: 'user', content: text }];\n      pushMessage({ id: genId(), role: 'user', content: text });\n      approvalsRef.current = [];\n      verdictsRef.current = [];\n      setPendingApprovals([]);\n      await run();\n    },\n    [run, pushMessage, options.generateId],\n  );\n\n  const regenerate = useCallback(async (): Promise<void> => {\n    const cut = dropTrailingAssistant({ ui: uiRef.current, canonical: canonicalRef.current });\n    uiRef.current = cut.ui;\n    canonicalRef.current = cut.canonical;\n    setMessages(cut.ui);\n    approvalsRef.current = [];\n    verdictsRef.current = [];\n    setPendingApprovals([]);\n    await run();\n  }, [run]);\n\n  const editAndResend = useCallback(\n    async (messageId: string, text: string): Promise<void> => {\n      const cut = branchBeforeUserMessage(\n        { ui: uiRef.current, canonical: canonicalRef.current },\n        messageId,\n      );\n      if (!cut) return; // not a user message — nothing to branch\n      uiRef.current = cut.ui;\n      canonicalRef.current = cut.canonical;\n      setMessages(cut.ui);\n      approvalsRef.current = [];\n      verdictsRef.current = [];\n      setPendingApprovals([]);\n      await sendMessage(text);\n    },\n    [sendMessage],\n  );\n\n  const addToolApprovalResponse = useCallback(\n    async (response: ToolApprovalResponse): Promise<void> => {\n      // Preserve the request's signed token unless the caller set one.\n      const request = approvalsRef.current.find((p) => p.approvalId === response.approvalId);\n      const verdict =\n        response.token === undefined && request?.token !== undefined\n          ? { ...response, token: request.token }\n          : response;\n      verdictsRef.current = [\n        ...verdictsRef.current.filter((v) => v.approvalId !== verdict.approvalId),\n        verdict,\n      ];\n      const verdicts = verdictsRef.current;\n      const allSettled = approvalsRef.current.every((p) =>\n        verdicts.some((v) => v.approvalId === p.approvalId),\n      );\n      if (!allSettled) return;\n      approvalsRef.current = [];\n      verdictsRef.current = [];\n      setPendingApprovals([]);\n      await run(verdicts);\n    },\n    [run],\n  );\n\n  const reconnect = useCallback(async (): Promise<void> => {\n    const resume = options.resume;\n    if (!resume) return;\n    const controller = new AbortController();\n    abortRef.current = controller;\n    setStatus('streaming');\n    setError(undefined);\n    try {\n      const cursor = lastEventIdRef.current;\n      let turn: AssistantTurnState;\n      if (turnRef.current && cursor !== undefined) {\n        turn = turnRef.current; // continue in place — replay dedupes by seq upstream\n      } else {\n        // No cursor → full replay rebuilds the turn from the start; it lands in\n        // the trailing slot (replacing a partial turn if one is on screen).\n        turn = createAssistantTurn(genId());\n        if (!turnRef.current) pushMessage(turn.message);\n      }\n      turnRef.current = turn;\n      const parts = connectDeuzStream(resume.endpoint, {\n        ...(cursor !== undefined ? { lastEventId: cursor } : {}),\n        onCursor: (id) => {\n          lastEventIdRef.current = id;\n        },\n        signal: controller.signal,\n        ...(options.fetch ? { fetch: options.fetch } : {}),\n        ...(options.headers ? { headers: options.headers } : {}),\n      });\n      for await (const part of parts) {\n        turn = foldPart(turn, part);\n        turnRef.current = turn;\n        syncTurn(turn);\n      }\n      if (turn.error !== undefined) throw new Error(turn.error);\n      canonicalRef.current = [...canonicalRef.current, assistantMessageFromTurn(turn)];\n      turnRef.current = undefined;\n      if (turn.approvals.length > 0) {\n        approvalsRef.current = turn.approvals;\n        verdictsRef.current = [];\n        setPendingApprovals(turn.approvals);\n      }\n    } catch (err) {\n      if (controller.signal.aborted) return; // user abort — not an error\n      const e = err instanceof Error ? err : new Error(String(err));\n      setError(e);\n      setStatus('error');\n      options.onError?.(e);\n      return;\n    } finally {\n      setStatus((s) => (s === 'error' ? s : 'idle'));\n    }\n  }, [\n    options.resume,\n    options.fetch,\n    options.headers,\n    options.generateId,\n    options.onError,\n    pushMessage,\n    syncTurn,\n  ]);\n\n  return {\n    messages,\n    status,\n    error,\n    pendingApprovals,\n    ...(cost !== undefined ? { cost } : {}),\n    ...(budgetExceeded !== undefined ? { budgetExceeded } : {}),\n    dataParts,\n    citations,\n    sendMessage,\n    stop,\n    regenerate,\n    editAndResend,\n    addToolApprovalResponse,\n    reconnect,\n  };\n}\n","/**\n * useObject — streams `toDeuzObjectStreamResponse` output (`object-delta`\n * parts) into React state. Ported from the frozen `@deuz-sdk/core/react` hook.\n */\nimport { useCallback, useRef, useState } from 'react';\nimport type { DeepPartial } from '@deuz-sdk/core';\nimport { readDeuzStream } from '@deuz-sdk/core/ui';\n\nexport interface UseObjectOptions {\n  /** Endpoint serving `toDeuzObjectStreamResponse` output. */\n  api: string;\n  headers?: Record<string, string>;\n  /** Injectable for tests / custom transports. Defaults to global fetch. */\n  fetch?: typeof fetch;\n}\n\nexport interface UseObjectResult<T> {\n  /** Latest partial (each `object-delta` replaces it wholesale). */\n  object: DeepPartial<T> | undefined;\n  isLoading: boolean;\n  error: Error | undefined;\n  /** POSTs `{ input }` to `api` and streams partials into `object`. */\n  submit: (input: unknown) => Promise<void>;\n  /** Abort the in-flight stream (not an error). */\n  stop: () => void;\n}\n\nexport function useObject<T = unknown>(options: UseObjectOptions): UseObjectResult<T> {\n  const [object, setObject] = useState<DeepPartial<T> | undefined>(undefined);\n  const [isLoading, setLoading] = useState(false);\n  const [error, setError] = useState<Error | undefined>(undefined);\n  const abortRef = useRef<AbortController | null>(null);\n\n  const stop = useCallback((): void => {\n    abortRef.current?.abort();\n  }, []);\n\n  const submit = useCallback(\n    async (input: unknown): Promise<void> => {\n      abortRef.current?.abort();\n      const controller = new AbortController();\n      abortRef.current = controller;\n      setLoading(true);\n      setError(undefined);\n      setObject(undefined);\n      try {\n        const doFetch = options.fetch ?? fetch;\n        const res = await doFetch(options.api, {\n          method: 'POST',\n          headers: { 'content-type': 'application/json', ...options.headers },\n          body: JSON.stringify({ input }),\n          signal: controller.signal,\n        });\n        for await (const part of readDeuzStream(res)) {\n          if (part.type === 'object-delta') {\n            setObject(part.object as DeepPartial<T>);\n          } else if (part.type === 'error') {\n            setError(new Error(part.message));\n            break;\n          }\n        }\n      } catch (err) {\n        if (!controller.signal.aborted) {\n          setError(err instanceof Error ? err : new Error(String(err)));\n        }\n      } finally {\n        setLoading(false);\n      }\n    },\n    [options.api, options.fetch, options.headers],\n  );\n\n  return { object, isLoading, error, submit, stop };\n}\n","/**\n * Headless chat components — zero styling, zero business logic. They only\n * wire core types (`ToolApprovalRequest`/`ToolApprovalResponse`, the useChat\n * cost state) to DOM events; presentation is overridable via render props.\n */\nimport type { ReactNode } from 'react';\nimport type { ToolApprovalRequest, ToolApprovalResponse } from '@deuz-sdk/core';\nimport type { UseChatCost } from './use-chat';\n\nexport interface ToolApprovalCardProps {\n  approval: ToolApprovalRequest;\n  /** Feed this straight into `useChat().addToolApprovalResponse`. */\n  onRespond: (response: ToolApprovalResponse) => void;\n  /** Override presentation; the component supplies the wired callbacks. */\n  render?: (ctx: {\n    approval: ToolApprovalRequest;\n    approve: () => void;\n    deny: (reason?: string) => void;\n  }) => ReactNode;\n}\n\n/**\n * One pending tool approval. The verdict always carries the request's signed\n * `token` (D4) — callers never have to thread it themselves.\n */\nexport function ToolApprovalCard({ approval, onRespond, render }: ToolApprovalCardProps) {\n  const respond = (approved: boolean, reason?: string): void =>\n    onRespond({\n      approvalId: approval.approvalId,\n      approved,\n      ...(reason !== undefined ? { reason } : {}),\n      ...(approval.token !== undefined ? { token: approval.token } : {}),\n    });\n  const approve = (): void => respond(true);\n  const deny = (reason?: string): void => respond(false, reason);\n\n  if (render) return <>{render({ approval, approve, deny })}</>;\n  return (\n    <div data-deuz=\"tool-approval\">\n      <span data-deuz=\"tool-approval-name\">{approval.toolName}</span>\n      <pre data-deuz=\"tool-approval-input\">{JSON.stringify(approval.input, null, 2)}</pre>\n      <button type=\"button\" onClick={approve}>\n        Approve\n      </button>\n      <button type=\"button\" onClick={() => deny()}>\n        Deny\n      </button>\n    </div>\n  );\n}\n\nexport interface CostBadgeProps {\n  /** The `useChat` cost state (undefined until the first `cost` part arrives). */\n  cost: UseChatCost | undefined;\n  /** Override presentation. */\n  format?: (cost: UseChatCost) => ReactNode;\n}\n\n/** Live cost readout: `$X.XXXX`, plus ` (saved $Y.YYYY)` when caching saved money. */\nexport function CostBadge({ cost, format }: CostBadgeProps) {\n  if (cost === undefined) return null;\n  if (format) return <>{format(cost)}</>;\n  const saved =\n    cost.cacheSavingsUsd !== undefined && cost.cacheSavingsUsd > 0\n      ? ` (saved $${cost.cacheSavingsUsd.toFixed(4)})`\n      : '';\n  return <span data-deuz=\"cost-badge\">{`$${cost.costUsd.toFixed(4)}${saved}`}</span>;\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,142 @@
+import { Message, ToolApprovalRequest, ToolApprovalResponse, DeepPartial } from '@deuz-sdk/core';
+export { Message, ToolApprovalRequest, ToolApprovalResponse } from '@deuz-sdk/core';
+import { UIMessage, AssistantTurnState } from '@deuz-sdk/core/chat';
+export { AssistantTurnState, ChatHistory, UIMessage, UIToolCall } from '@deuz-sdk/core/chat';
+import * as react from 'react';
+import { ReactNode } from 'react';
+export { DeuzUIPart } from '@deuz-sdk/core/ui';
+
+/** Live cumulative USD cost, from the wire's `cost` parts (last one wins). */
+interface UseChatCost {
+    costUsd: number;
+    cacheSavingsUsd?: number;
+}
+/** The server's budget guardrail tripped (`budget-exceeded` part). */
+interface UseChatBudgetExceeded {
+    kind: 'usd' | 'tokens';
+    limit: number;
+    value: number;
+}
+interface UseChatResumeOptions {
+    /**
+     * Resume endpoint (see core's `resumeDeuzStreamResponse`): a GET URL or a
+     * factory returning the `Response` for a given cursor. Do NOT point it at
+     * the generating POST route — that would re-run the model.
+     */
+    endpoint: string | ((ctx: {
+        lastEventId?: string;
+    }) => Response | Promise<Response>);
+    /** Cursor to resume from (e.g. persisted across a page reload). */
+    lastEventId?: string;
+}
+interface UseChatOptions {
+    /** Endpoint serving `toDeuzStreamResponse` output. */
+    api: string;
+    /** Seed canonical history (e.g. restored from a ChatStore) — rendered via `uiFromMessages`. */
+    initialMessages?: Message[];
+    headers?: Record<string, string>;
+    /** Extra fields merged into every request body. */
+    body?: Record<string, unknown>;
+    /** Chat identity — merged into every request body (server-side ChatStore persistence). */
+    chatId?: string;
+    /** Enables `reconnect()` against a resume endpoint (wire v2, `connectDeuzStream`). */
+    resume?: UseChatResumeOptions;
+    /** Id source for UI messages/turns. Default: `crypto.randomUUID` (with a fallback). */
+    generateId?: () => string;
+    /**
+     * Client-tool executor: called for every streamed tool call the SERVER did
+     * not execute. The return value is appended as its tool_result and the chat
+     * auto-continues; a throw self-heals as an is_error result.
+     */
+    onToolCall?: (call: {
+        toolCallId: string;
+        toolName: string;
+        input: unknown;
+    }) => Promise<unknown> | unknown;
+    onError?: (error: Error) => void;
+    /** Injectable for tests / custom transports. Defaults to global fetch. */
+    fetch?: typeof fetch;
+}
+interface UseChatResult {
+    messages: UIMessage[];
+    status: 'idle' | 'streaming' | 'error';
+    error: Error | undefined;
+    /** Gated tool calls awaiting verdicts — the chat is PAUSED while non-empty. */
+    pendingApprovals: ToolApprovalRequest[];
+    /** Live cumulative cost from the wire's `cost` parts (last one wins). */
+    cost?: UseChatCost;
+    /** Set when the server's budget guardrail tripped this turn. */
+    budgetExceeded?: UseChatBudgetExceeded;
+    /** This turn's app-defined `data-{name}` parts, in arrival order. */
+    dataParts: Array<{
+        name: string;
+        payload: unknown;
+    }>;
+    /** This turn's RAG citations. */
+    citations: AssistantTurnState['citations'];
+    sendMessage: (text: string) => Promise<void>;
+    /** Abort the in-flight stream (not an error). */
+    stop: () => void;
+    /** Drop the trailing assistant/tool turns (core `dropTrailingAssistant`) and re-run. */
+    regenerate: () => Promise<void>;
+    /** Cut history before `messageId` (core `branchBeforeUserMessage`) and send `text`. */
+    editAndResend: (messageId: string, text: string) => Promise<void>;
+    /**
+     * Record one verdict (the request's signed `token` is auto-preserved). Once
+     * EVERY pending approval has a verdict, the chat auto-resumes with
+     * `approvalResponses` in the request body.
+     */
+    addToolApprovalResponse: (response: ToolApprovalResponse) => Promise<void>;
+    /**
+     * Re-read the stream from `resume.endpoint` via `connectDeuzStream` and fold
+     * the parts into the current turn. No-op unless `options.resume` is set.
+     */
+    reconnect: () => Promise<void>;
+}
+declare function useChat(options: UseChatOptions): UseChatResult;
+
+interface UseObjectOptions {
+    /** Endpoint serving `toDeuzObjectStreamResponse` output. */
+    api: string;
+    headers?: Record<string, string>;
+    /** Injectable for tests / custom transports. Defaults to global fetch. */
+    fetch?: typeof fetch;
+}
+interface UseObjectResult<T> {
+    /** Latest partial (each `object-delta` replaces it wholesale). */
+    object: DeepPartial<T> | undefined;
+    isLoading: boolean;
+    error: Error | undefined;
+    /** POSTs `{ input }` to `api` and streams partials into `object`. */
+    submit: (input: unknown) => Promise<void>;
+    /** Abort the in-flight stream (not an error). */
+    stop: () => void;
+}
+declare function useObject<T = unknown>(options: UseObjectOptions): UseObjectResult<T>;
+
+interface ToolApprovalCardProps {
+    approval: ToolApprovalRequest;
+    /** Feed this straight into `useChat().addToolApprovalResponse`. */
+    onRespond: (response: ToolApprovalResponse) => void;
+    /** Override presentation; the component supplies the wired callbacks. */
+    render?: (ctx: {
+        approval: ToolApprovalRequest;
+        approve: () => void;
+        deny: (reason?: string) => void;
+    }) => ReactNode;
+}
+/**
+ * One pending tool approval. The verdict always carries the request's signed
+ * `token` (D4) — callers never have to thread it themselves.
+ */
+declare function ToolApprovalCard({ approval, onRespond, render }: ToolApprovalCardProps): react.JSX.Element;
+interface CostBadgeProps {
+    /** The `useChat` cost state (undefined until the first `cost` part arrives). */
+    cost: UseChatCost | undefined;
+    /** Override presentation. */
+    format?: (cost: UseChatCost) => ReactNode;
+}
+/** Live cost readout: `$X.XXXX`, plus ` (saved $Y.YYYY)` when caching saved money. */
+declare function CostBadge({ cost, format }: CostBadgeProps): react.JSX.Element | null;
+
+export { CostBadge, type CostBadgeProps, ToolApprovalCard, type ToolApprovalCardProps, type UseChatBudgetExceeded, type UseChatCost, type UseChatOptions, type UseChatResult, type UseChatResumeOptions, type UseObjectOptions, type UseObjectResult, useChat, useObject };

package/dist/index.d.ts

@@ -0,0 +1,142 @@
+import { Message, ToolApprovalRequest, ToolApprovalResponse, DeepPartial } from '@deuz-sdk/core';
+export { Message, ToolApprovalRequest, ToolApprovalResponse } from '@deuz-sdk/core';
+import { UIMessage, AssistantTurnState } from '@deuz-sdk/core/chat';
+export { AssistantTurnState, ChatHistory, UIMessage, UIToolCall } from '@deuz-sdk/core/chat';
+import * as react from 'react';
+import { ReactNode } from 'react';
+export { DeuzUIPart } from '@deuz-sdk/core/ui';
+
+/** Live cumulative USD cost, from the wire's `cost` parts (last one wins). */
+interface UseChatCost {
+    costUsd: number;
+    cacheSavingsUsd?: number;
+}
+/** The server's budget guardrail tripped (`budget-exceeded` part). */
+interface UseChatBudgetExceeded {
+    kind: 'usd' | 'tokens';
+    limit: number;
+    value: number;
+}
+interface UseChatResumeOptions {
+    /**
+     * Resume endpoint (see core's `resumeDeuzStreamResponse`): a GET URL or a
+     * factory returning the `Response` for a given cursor. Do NOT point it at
+     * the generating POST route — that would re-run the model.
+     */
+    endpoint: string | ((ctx: {
+        lastEventId?: string;
+    }) => Response | Promise<Response>);
+    /** Cursor to resume from (e.g. persisted across a page reload). */
+    lastEventId?: string;
+}
+interface UseChatOptions {
+    /** Endpoint serving `toDeuzStreamResponse` output. */
+    api: string;
+    /** Seed canonical history (e.g. restored from a ChatStore) — rendered via `uiFromMessages`. */
+    initialMessages?: Message[];
+    headers?: Record<string, string>;
+    /** Extra fields merged into every request body. */
+    body?: Record<string, unknown>;
+    /** Chat identity — merged into every request body (server-side ChatStore persistence). */
+    chatId?: string;
+    /** Enables `reconnect()` against a resume endpoint (wire v2, `connectDeuzStream`). */
+    resume?: UseChatResumeOptions;
+    /** Id source for UI messages/turns. Default: `crypto.randomUUID` (with a fallback). */
+    generateId?: () => string;
+    /**
+     * Client-tool executor: called for every streamed tool call the SERVER did
+     * not execute. The return value is appended as its tool_result and the chat
+     * auto-continues; a throw self-heals as an is_error result.
+     */
+    onToolCall?: (call: {
+        toolCallId: string;
+        toolName: string;
+        input: unknown;
+    }) => Promise<unknown> | unknown;
+    onError?: (error: Error) => void;
+    /** Injectable for tests / custom transports. Defaults to global fetch. */
+    fetch?: typeof fetch;
+}
+interface UseChatResult {
+    messages: UIMessage[];
+    status: 'idle' | 'streaming' | 'error';
+    error: Error | undefined;
+    /** Gated tool calls awaiting verdicts — the chat is PAUSED while non-empty. */
+    pendingApprovals: ToolApprovalRequest[];
+    /** Live cumulative cost from the wire's `cost` parts (last one wins). */
+    cost?: UseChatCost;
+    /** Set when the server's budget guardrail tripped this turn. */
+    budgetExceeded?: UseChatBudgetExceeded;
+    /** This turn's app-defined `data-{name}` parts, in arrival order. */
+    dataParts: Array<{
+        name: string;
+        payload: unknown;
+    }>;
+    /** This turn's RAG citations. */
+    citations: AssistantTurnState['citations'];
+    sendMessage: (text: string) => Promise<void>;
+    /** Abort the in-flight stream (not an error). */
+    stop: () => void;
+    /** Drop the trailing assistant/tool turns (core `dropTrailingAssistant`) and re-run. */
+    regenerate: () => Promise<void>;
+    /** Cut history before `messageId` (core `branchBeforeUserMessage`) and send `text`. */
+    editAndResend: (messageId: string, text: string) => Promise<void>;
+    /**
+     * Record one verdict (the request's signed `token` is auto-preserved). Once
+     * EVERY pending approval has a verdict, the chat auto-resumes with
+     * `approvalResponses` in the request body.
+     */
+    addToolApprovalResponse: (response: ToolApprovalResponse) => Promise<void>;
+    /**
+     * Re-read the stream from `resume.endpoint` via `connectDeuzStream` and fold
+     * the parts into the current turn. No-op unless `options.resume` is set.
+     */
+    reconnect: () => Promise<void>;
+}
+declare function useChat(options: UseChatOptions): UseChatResult;
+
+interface UseObjectOptions {
+    /** Endpoint serving `toDeuzObjectStreamResponse` output. */
+    api: string;
+    headers?: Record<string, string>;
+    /** Injectable for tests / custom transports. Defaults to global fetch. */
+    fetch?: typeof fetch;
+}
+interface UseObjectResult<T> {
+    /** Latest partial (each `object-delta` replaces it wholesale). */
+    object: DeepPartial<T> | undefined;
+    isLoading: boolean;
+    error: Error | undefined;
+    /** POSTs `{ input }` to `api` and streams partials into `object`. */
+    submit: (input: unknown) => Promise<void>;
+    /** Abort the in-flight stream (not an error). */
+    stop: () => void;
+}
+declare function useObject<T = unknown>(options: UseObjectOptions): UseObjectResult<T>;
+
+interface ToolApprovalCardProps {
+    approval: ToolApprovalRequest;
+    /** Feed this straight into `useChat().addToolApprovalResponse`. */
+    onRespond: (response: ToolApprovalResponse) => void;
+    /** Override presentation; the component supplies the wired callbacks. */
+    render?: (ctx: {
+        approval: ToolApprovalRequest;
+        approve: () => void;
+        deny: (reason?: string) => void;
+    }) => ReactNode;
+}
+/**
+ * One pending tool approval. The verdict always carries the request's signed
+ * `token` (D4) — callers never have to thread it themselves.
+ */
+declare function ToolApprovalCard({ approval, onRespond, render }: ToolApprovalCardProps): react.JSX.Element;
+interface CostBadgeProps {
+    /** The `useChat` cost state (undefined until the first `cost` part arrives). */
+    cost: UseChatCost | undefined;
+    /** Override presentation. */
+    format?: (cost: UseChatCost) => ReactNode;
+}
+/** Live cost readout: `$X.XXXX`, plus ` (saved $Y.YYYY)` when caching saved money. */
+declare function CostBadge({ cost, format }: CostBadgeProps): react.JSX.Element | null;
+
+export { CostBadge, type CostBadgeProps, ToolApprovalCard, type ToolApprovalCardProps, type UseChatBudgetExceeded, type UseChatCost, type UseChatOptions, type UseChatResult, type UseChatResumeOptions, type UseObjectOptions, type UseObjectResult, useChat, useObject };

package/dist/index.js

@@ -0,0 +1,363 @@
+import { useState, useRef, useCallback } from 'react';
+import { uiFromMessages, createAssistantTurn, assistantMessageFromTurn, applyUIPart, clientToolResultMessage, dropTrailingAssistant, branchBeforeUserMessage } from '@deuz-sdk/core/chat';
+import { readDeuzStream, connectDeuzStream } from '@deuz-sdk/core/ui';
+import { jsx, Fragment, jsxs } from 'react/jsx-runtime';
+
+// src/use-chat.ts
+function foldPart(turn, part) {
+  const next = applyUIPart(turn, part);
+  if (part.type === "tool-approval-request" && part.token !== void 0) {
+    return {
+      ...next,
+      approvals: next.approvals.map(
+        (a) => a.approvalId === part.approvalId && a.token === void 0 ? { ...a, token: part.token } : a
+      )
+    };
+  }
+  return next;
+}
+var defaultGenerateId = () => typeof crypto !== "undefined" && typeof crypto.randomUUID === "function" ? crypto.randomUUID() : `deuz-ui-${Math.random().toString(36).slice(2)}`;
+function useChat(options) {
+  const genId = options.generateId ?? defaultGenerateId;
+  const [messages, setMessages] = useState(
+    () => uiFromMessages(options.initialMessages ?? [], genId)
+  );
+  const [status, setStatus] = useState("idle");
+  const [error, setError] = useState(void 0);
+  const [pendingApprovals, setPendingApprovals] = useState([]);
+  const [cost, setCost] = useState(void 0);
+  const [budgetExceeded, setBudgetExceeded] = useState(
+    void 0
+  );
+  const [dataParts, setDataParts] = useState([]);
+  const [citations, setCitations] = useState([]);
+  const uiRef = useRef(messages);
+  const canonicalRef = useRef(
+    options.initialMessages ? [...options.initialMessages] : []
+  );
+  const turnRef = useRef(void 0);
+  const approvalsRef = useRef([]);
+  const verdictsRef = useRef([]);
+  const abortRef = useRef(null);
+  const lastEventIdRef = useRef(options.resume?.lastEventId);
+  const pushMessage = useCallback((message) => {
+    uiRef.current = [...uiRef.current, message];
+    setMessages(uiRef.current);
+  }, []);
+  const syncTurn = useCallback((turn) => {
+    uiRef.current = [...uiRef.current.slice(0, -1), turn.message];
+    setMessages(uiRef.current);
+    if (turn.costUsd !== void 0) {
+      setCost({
+        costUsd: turn.costUsd,
+        ...turn.cacheSavingsUsd !== void 0 ? { cacheSavingsUsd: turn.cacheSavingsUsd } : {}
+      });
+    }
+    setBudgetExceeded(turn.budgetExceeded);
+    setDataParts(turn.dataParts);
+    setCitations(turn.citations);
+  }, []);
+  const stop = useCallback(() => {
+    abortRef.current?.abort();
+  }, []);
+  const run = useCallback(
+    async (approvalResponses) => {
+      const controller = new AbortController();
+      abortRef.current = controller;
+      setStatus("streaming");
+      setError(void 0);
+      try {
+        for (; ; ) {
+          const doFetch = options.fetch ?? fetch;
+          const res = await doFetch(options.api, {
+            method: "POST",
+            headers: { "content-type": "application/json", ...options.headers },
+            body: JSON.stringify({
+              messages: canonicalRef.current,
+              ...options.chatId !== void 0 ? { chatId: options.chatId } : {},
+              ...approvalResponses?.length ? { approvalResponses } : {},
+              ...options.body
+            }),
+            signal: controller.signal
+          });
+          approvalResponses = void 0;
+          let turn = createAssistantTurn(genId());
+          turnRef.current = turn;
+          pushMessage(turn.message);
+          syncTurn(turn);
+          for await (const part of readDeuzStream(res)) {
+            turn = foldPart(turn, part);
+            turnRef.current = turn;
+            syncTurn(turn);
+          }
+          if (turn.error !== void 0) throw new Error(turn.error);
+          canonicalRef.current = [...canonicalRef.current, assistantMessageFromTurn(turn)];
+          turnRef.current = void 0;
+          if (turn.approvals.length > 0) {
+            approvalsRef.current = turn.approvals;
+            verdictsRef.current = [];
+            setPendingApprovals(turn.approvals);
+            return;
+          }
+          const toolCalls = turn.message.toolCalls ?? [];
+          const serverResults = new Set(turn.serverResults);
+          const clientPending = toolCalls.filter((t) => !serverResults.has(t.toolCallId));
+          if (clientPending.length === 0 || !options.onToolCall) return;
+          const results = [];
+          for (const call of clientPending) {
+            try {
+              const out = await options.onToolCall({
+                toolCallId: call.toolCallId,
+                toolName: call.toolName,
+                input: call.input
+              });
+              results.push({ toolCallId: call.toolCallId, result: out });
+              turn = applyUIPart(turn, {
+                type: "tool-result",
+                toolCallId: call.toolCallId,
+                toolName: call.toolName,
+                output: out
+              });
+            } catch (err) {
+              const message = err instanceof Error ? err.message : String(err);
+              results.push({ toolCallId: call.toolCallId, result: message, isError: true });
+              turn = applyUIPart(turn, {
+                type: "tool-result",
+                toolCallId: call.toolCallId,
+                toolName: call.toolName,
+                output: message,
+                isError: true
+              });
+            }
+            syncTurn(turn);
+          }
+          canonicalRef.current = [...canonicalRef.current, clientToolResultMessage(results)];
+        }
+      } catch (err) {
+        if (controller.signal.aborted) return;
+        const e = err instanceof Error ? err : new Error(String(err));
+        setError(e);
+        setStatus("error");
+        options.onError?.(e);
+        return;
+      } finally {
+        setStatus((s) => s === "error" ? s : "idle");
+      }
+    },
+    [
+      options.api,
+      options.fetch,
+      options.headers,
+      options.body,
+      options.chatId,
+      options.generateId,
+      options.onToolCall,
+      options.onError,
+      pushMessage,
+      syncTurn
+    ]
+  );
+  const sendMessage = useCallback(
+    async (text) => {
+      canonicalRef.current = [...canonicalRef.current, { role: "user", content: text }];
+      pushMessage({ id: genId(), role: "user", content: text });
+      approvalsRef.current = [];
+      verdictsRef.current = [];
+      setPendingApprovals([]);
+      await run();
+    },
+    [run, pushMessage, options.generateId]
+  );
+  const regenerate = useCallback(async () => {
+    const cut = dropTrailingAssistant({ ui: uiRef.current, canonical: canonicalRef.current });
+    uiRef.current = cut.ui;
+    canonicalRef.current = cut.canonical;
+    setMessages(cut.ui);
+    approvalsRef.current = [];
+    verdictsRef.current = [];
+    setPendingApprovals([]);
+    await run();
+  }, [run]);
+  const editAndResend = useCallback(
+    async (messageId, text) => {
+      const cut = branchBeforeUserMessage(
+        { ui: uiRef.current, canonical: canonicalRef.current },
+        messageId
+      );
+      if (!cut) return;
+      uiRef.current = cut.ui;
+      canonicalRef.current = cut.canonical;
+      setMessages(cut.ui);
+      approvalsRef.current = [];
+      verdictsRef.current = [];
+      setPendingApprovals([]);
+      await sendMessage(text);
+    },
+    [sendMessage]
+  );
+  const addToolApprovalResponse = useCallback(
+    async (response) => {
+      const request = approvalsRef.current.find((p) => p.approvalId === response.approvalId);
+      const verdict = response.token === void 0 && request?.token !== void 0 ? { ...response, token: request.token } : response;
+      verdictsRef.current = [
+        ...verdictsRef.current.filter((v) => v.approvalId !== verdict.approvalId),
+        verdict
+      ];
+      const verdicts = verdictsRef.current;
+      const allSettled = approvalsRef.current.every(
+        (p) => verdicts.some((v) => v.approvalId === p.approvalId)
+      );
+      if (!allSettled) return;
+      approvalsRef.current = [];
+      verdictsRef.current = [];
+      setPendingApprovals([]);
+      await run(verdicts);
+    },
+    [run]
+  );
+  const reconnect = useCallback(async () => {
+    const resume = options.resume;
+    if (!resume) return;
+    const controller = new AbortController();
+    abortRef.current = controller;
+    setStatus("streaming");
+    setError(void 0);
+    try {
+      const cursor = lastEventIdRef.current;
+      let turn;
+      if (turnRef.current && cursor !== void 0) {
+        turn = turnRef.current;
+      } else {
+        turn = createAssistantTurn(genId());
+        if (!turnRef.current) pushMessage(turn.message);
+      }
+      turnRef.current = turn;
+      const parts = connectDeuzStream(resume.endpoint, {
+        ...cursor !== void 0 ? { lastEventId: cursor } : {},
+        onCursor: (id) => {
+          lastEventIdRef.current = id;
+        },
+        signal: controller.signal,
+        ...options.fetch ? { fetch: options.fetch } : {},
+        ...options.headers ? { headers: options.headers } : {}
+      });
+      for await (const part of parts) {
+        turn = foldPart(turn, part);
+        turnRef.current = turn;
+        syncTurn(turn);
+      }
+      if (turn.error !== void 0) throw new Error(turn.error);
+      canonicalRef.current = [...canonicalRef.current, assistantMessageFromTurn(turn)];
+      turnRef.current = void 0;
+      if (turn.approvals.length > 0) {
+        approvalsRef.current = turn.approvals;
+        verdictsRef.current = [];
+        setPendingApprovals(turn.approvals);
+      }
+    } catch (err) {
+      if (controller.signal.aborted) return;
+      const e = err instanceof Error ? err : new Error(String(err));
+      setError(e);
+      setStatus("error");
+      options.onError?.(e);
+      return;
+    } finally {
+      setStatus((s) => s === "error" ? s : "idle");
+    }
+  }, [
+    options.resume,
+    options.fetch,
+    options.headers,
+    options.generateId,
+    options.onError,
+    pushMessage,
+    syncTurn
+  ]);
+  return {
+    messages,
+    status,
+    error,
+    pendingApprovals,
+    ...cost !== void 0 ? { cost } : {},
+    ...budgetExceeded !== void 0 ? { budgetExceeded } : {},
+    dataParts,
+    citations,
+    sendMessage,
+    stop,
+    regenerate,
+    editAndResend,
+    addToolApprovalResponse,
+    reconnect
+  };
+}
+function useObject(options) {
+  const [object, setObject] = useState(void 0);
+  const [isLoading, setLoading] = useState(false);
+  const [error, setError] = useState(void 0);
+  const abortRef = useRef(null);
+  const stop = useCallback(() => {
+    abortRef.current?.abort();
+  }, []);
+  const submit = useCallback(
+    async (input) => {
+      abortRef.current?.abort();
+      const controller = new AbortController();
+      abortRef.current = controller;
+      setLoading(true);
+      setError(void 0);
+      setObject(void 0);
+      try {
+        const doFetch = options.fetch ?? fetch;
+        const res = await doFetch(options.api, {
+          method: "POST",
+          headers: { "content-type": "application/json", ...options.headers },
+          body: JSON.stringify({ input }),
+          signal: controller.signal
+        });
+        for await (const part of readDeuzStream(res)) {
+          if (part.type === "object-delta") {
+            setObject(part.object);
+          } else if (part.type === "error") {
+            setError(new Error(part.message));
+            break;
+          }
+        }
+      } catch (err) {
+        if (!controller.signal.aborted) {
+          setError(err instanceof Error ? err : new Error(String(err)));
+        }
+      } finally {
+        setLoading(false);
+      }
+    },
+    [options.api, options.fetch, options.headers]
+  );
+  return { object, isLoading, error, submit, stop };
+}
+function ToolApprovalCard({ approval, onRespond, render }) {
+  const respond = (approved, reason) => onRespond({
+    approvalId: approval.approvalId,
+    approved,
+    ...reason !== void 0 ? { reason } : {},
+    ...approval.token !== void 0 ? { token: approval.token } : {}
+  });
+  const approve = () => respond(true);
+  const deny = (reason) => respond(false, reason);
+  if (render) return /* @__PURE__ */ jsx(Fragment, { children: render({ approval, approve, deny }) });
+  return /* @__PURE__ */ jsxs("div", { "data-deuz": "tool-approval", children: [
+    /* @__PURE__ */ jsx("span", { "data-deuz": "tool-approval-name", children: approval.toolName }),
+    /* @__PURE__ */ jsx("pre", { "data-deuz": "tool-approval-input", children: JSON.stringify(approval.input, null, 2) }),
+    /* @__PURE__ */ jsx("button", { type: "button", onClick: approve, children: "Approve" }),
+    /* @__PURE__ */ jsx("button", { type: "button", onClick: () => deny(), children: "Deny" })
+  ] });
+}
+function CostBadge({ cost, format }) {
+  if (cost === void 0) return null;
+  if (format) return /* @__PURE__ */ jsx(Fragment, { children: format(cost) });
+  const saved = cost.cacheSavingsUsd !== void 0 && cost.cacheSavingsUsd > 0 ? ` (saved $${cost.cacheSavingsUsd.toFixed(4)})` : "";
+  return /* @__PURE__ */ jsx("span", { "data-deuz": "cost-badge", children: `$${cost.costUsd.toFixed(4)}${saved}` });
+}
+
+export { CostBadge, ToolApprovalCard, useChat, useObject };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/use-chat.ts","../src/use-object.ts","../src/components.tsx"],"names":["useState","useRef","useCallback","readDeuzStream"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * useChat — the React binding over `@deuz-sdk/core/chat` + the Deuz UI wire.\n *\n * THIN by contract: every chat-state transformation is a core call\n * (`createAssistantTurn`/`applyUIPart`/`assistantMessageFromTurn`/\n * `clientToolResultMessage`/`uiFromMessages`/`dropTrailingAssistant`/\n * `branchBeforeUserMessage`). This hook only owns React state, the fetch\n * round-trips, and abort wiring. Supersedes the frozen `@deuz-sdk/core/react`.\n */\nimport { useCallback, useRef, useState } from 'react';\nimport type { Message, ToolApprovalRequest, ToolApprovalResponse } from '@deuz-sdk/core';\nimport {\n  applyUIPart,\n  assistantMessageFromTurn,\n  branchBeforeUserMessage,\n  clientToolResultMessage,\n  createAssistantTurn,\n  dropTrailingAssistant,\n  uiFromMessages,\n} from '@deuz-sdk/core/chat';\nimport type { AssistantTurnState, UIMessage } from '@deuz-sdk/core/chat';\nimport { connectDeuzStream, readDeuzStream } from '@deuz-sdk/core/ui';\n\n/**\n * Fold one wire part via the core reducer. Trivial glue on top: core 1.7.0's\n * `applyUIPart` drops the `token` field of a `tool-approval-request` when it\n * builds the approval entry — re-attach it so verdicts can echo it (D4).\n */\nfunction foldPart(\n  turn: AssistantTurnState,\n  part: Parameters<typeof applyUIPart>[1],\n): AssistantTurnState {\n  const next = applyUIPart(turn, part);\n  if (part.type === 'tool-approval-request' && part.token !== undefined) {\n    return {\n      ...next,\n      approvals: next.approvals.map((a) =>\n        a.approvalId === part.approvalId && a.token === undefined ? { ...a, token: part.token } : a,\n      ),\n    };\n  }\n  return next;\n}\n\n/** Local id fallback — this package is not edge-lint-constrained. */\nconst defaultGenerateId = (): string =>\n  typeof crypto !== 'undefined' && typeof crypto.randomUUID === 'function'\n    ? crypto.randomUUID()\n    : `deuz-ui-${Math.random().toString(36).slice(2)}`;\n\n/** Live cumulative USD cost, from the wire's `cost` parts (last one wins). */\nexport interface UseChatCost {\n  costUsd: number;\n  cacheSavingsUsd?: number;\n}\n\n/** The server's budget guardrail tripped (`budget-exceeded` part). */\nexport interface UseChatBudgetExceeded {\n  kind: 'usd' | 'tokens';\n  limit: number;\n  value: number;\n}\n\nexport interface UseChatResumeOptions {\n  /**\n   * Resume endpoint (see core's `resumeDeuzStreamResponse`): a GET URL or a\n   * factory returning the `Response` for a given cursor. Do NOT point it at\n   * the generating POST route — that would re-run the model.\n   */\n  endpoint: string | ((ctx: { lastEventId?: string }) => Response | Promise<Response>);\n  /** Cursor to resume from (e.g. persisted across a page reload). */\n  lastEventId?: string;\n}\n\nexport interface UseChatOptions {\n  /** Endpoint serving `toDeuzStreamResponse` output. */\n  api: string;\n  /** Seed canonical history (e.g. restored from a ChatStore) — rendered via `uiFromMessages`. */\n  initialMessages?: Message[];\n  headers?: Record<string, string>;\n  /** Extra fields merged into every request body. */\n  body?: Record<string, unknown>;\n  /** Chat identity — merged into every request body (server-side ChatStore persistence). */\n  chatId?: string;\n  /** Enables `reconnect()` against a resume endpoint (wire v2, `connectDeuzStream`). */\n  resume?: UseChatResumeOptions;\n  /** Id source for UI messages/turns. Default: `crypto.randomUUID` (with a fallback). */\n  generateId?: () => string;\n  /**\n   * Client-tool executor: called for every streamed tool call the SERVER did\n   * not execute. The return value is appended as its tool_result and the chat\n   * auto-continues; a throw self-heals as an is_error result.\n   */\n  onToolCall?: (call: {\n    toolCallId: string;\n    toolName: string;\n    input: unknown;\n  }) => Promise<unknown> | unknown;\n  onError?: (error: Error) => void;\n  /** Injectable for tests / custom transports. Defaults to global fetch. */\n  fetch?: typeof fetch;\n}\n\nexport interface UseChatResult {\n  messages: UIMessage[];\n  status: 'idle' | 'streaming' | 'error';\n  error: Error | undefined;\n  /** Gated tool calls awaiting verdicts — the chat is PAUSED while non-empty. */\n  pendingApprovals: ToolApprovalRequest[];\n  /** Live cumulative cost from the wire's `cost` parts (last one wins). */\n  cost?: UseChatCost;\n  /** Set when the server's budget guardrail tripped this turn. */\n  budgetExceeded?: UseChatBudgetExceeded;\n  /** This turn's app-defined `data-{name}` parts, in arrival order. */\n  dataParts: Array<{ name: string; payload: unknown }>;\n  /** This turn's RAG citations. */\n  citations: AssistantTurnState['citations'];\n  sendMessage: (text: string) => Promise<void>;\n  /** Abort the in-flight stream (not an error). */\n  stop: () => void;\n  /** Drop the trailing assistant/tool turns (core `dropTrailingAssistant`) and re-run. */\n  regenerate: () => Promise<void>;\n  /** Cut history before `messageId` (core `branchBeforeUserMessage`) and send `text`. */\n  editAndResend: (messageId: string, text: string) => Promise<void>;\n  /**\n   * Record one verdict (the request's signed `token` is auto-preserved). Once\n   * EVERY pending approval has a verdict, the chat auto-resumes with\n   * `approvalResponses` in the request body.\n   */\n  addToolApprovalResponse: (response: ToolApprovalResponse) => Promise<void>;\n  /**\n   * Re-read the stream from `resume.endpoint` via `connectDeuzStream` and fold\n   * the parts into the current turn. No-op unless `options.resume` is set.\n   */\n  reconnect: () => Promise<void>;\n}\n\nexport function useChat(options: UseChatOptions): UseChatResult {\n  const genId = options.generateId ?? defaultGenerateId;\n  const [messages, setMessages] = useState<UIMessage[]>(() =>\n    uiFromMessages(options.initialMessages ?? [], genId),\n  );\n  const [status, setStatus] = useState<'idle' | 'streaming' | 'error'>('idle');\n  const [error, setError] = useState<Error | undefined>(undefined);\n  const [pendingApprovals, setPendingApprovals] = useState<ToolApprovalRequest[]>([]);\n  const [cost, setCost] = useState<UseChatCost | undefined>(undefined);\n  const [budgetExceeded, setBudgetExceeded] = useState<UseChatBudgetExceeded | undefined>(\n    undefined,\n  );\n  const [dataParts, setDataParts] = useState<Array<{ name: string; payload: unknown }>>([]);\n  const [citations, setCitations] = useState<AssistantTurnState['citations']>([]);\n\n  const uiRef = useRef<UIMessage[]>(messages);\n  const canonicalRef = useRef<Message[]>(\n    options.initialMessages ? [...options.initialMessages] : [],\n  );\n  /** The in-flight turn — kept across a drop so `reconnect()` can continue it. */\n  const turnRef = useRef<AssistantTurnState | undefined>(undefined);\n  const approvalsRef = useRef<ToolApprovalRequest[]>([]);\n  const verdictsRef = useRef<ToolApprovalResponse[]>([]);\n  const abortRef = useRef<AbortController | null>(null);\n  const lastEventIdRef = useRef<string | undefined>(options.resume?.lastEventId);\n\n  const pushMessage = useCallback((message: UIMessage): void => {\n    uiRef.current = [...uiRef.current, message];\n    setMessages(uiRef.current);\n  }, []);\n\n  /** Sync ALL turn-derived React state (the turn's message is the trailing UI element). */\n  const syncTurn = useCallback((turn: AssistantTurnState): void => {\n    uiRef.current = [...uiRef.current.slice(0, -1), turn.message];\n    setMessages(uiRef.current);\n    if (turn.costUsd !== undefined) {\n      setCost({\n        costUsd: turn.costUsd,\n        ...(turn.cacheSavingsUsd !== undefined ? { cacheSavingsUsd: turn.cacheSavingsUsd } : {}),\n      });\n    }\n    setBudgetExceeded(turn.budgetExceeded);\n    setDataParts(turn.dataParts);\n    setCitations(turn.citations);\n  }, []);\n\n  const stop = useCallback((): void => {\n    abortRef.current?.abort();\n  }, []);\n\n  const run = useCallback(\n    async (approvalResponses?: ToolApprovalResponse[]): Promise<void> => {\n      const controller = new AbortController();\n      abortRef.current = controller;\n      setStatus('streaming');\n      setError(undefined);\n      try {\n        // One iteration per model round; client-tool results loop back in.\n        for (;;) {\n          const doFetch = options.fetch ?? fetch;\n          const res = await doFetch(options.api, {\n            method: 'POST',\n            headers: { 'content-type': 'application/json', ...options.headers },\n            body: JSON.stringify({\n              messages: canonicalRef.current,\n              ...(options.chatId !== undefined ? { chatId: options.chatId } : {}),\n              ...(approvalResponses?.length ? { approvalResponses } : {}),\n              ...options.body,\n            }),\n            signal: controller.signal,\n          });\n          approvalResponses = undefined; // consumed by the first round only\n\n          let turn = createAssistantTurn(genId());\n          turnRef.current = turn;\n          pushMessage(turn.message);\n          syncTurn(turn); // resets this-turn state (dataParts/citations/budget)\n\n          for await (const part of readDeuzStream(res)) {\n            turn = foldPart(turn, part);\n            turnRef.current = turn;\n            syncTurn(turn);\n          }\n          if (turn.error !== undefined) throw new Error(turn.error);\n\n          // Append the canonical assistant turn (client-tools reconstruction).\n          canonicalRef.current = [...canonicalRef.current, assistantMessageFromTurn(turn)];\n          turnRef.current = undefined;\n\n          // Approval pause: verdicts arrive via addToolApprovalResponse.\n          if (turn.approvals.length > 0) {\n            approvalsRef.current = turn.approvals;\n            verdictsRef.current = [];\n            setPendingApprovals(turn.approvals);\n            return;\n          }\n\n          // Client-tool auto-round-trip: everything the server didn't execute.\n          const toolCalls = turn.message.toolCalls ?? [];\n          const serverResults = new Set(turn.serverResults);\n          const clientPending = toolCalls.filter((t) => !serverResults.has(t.toolCallId));\n          if (clientPending.length === 0 || !options.onToolCall) return;\n          const results: Array<{ toolCallId: string; result: unknown; isError?: boolean }> = [];\n          for (const call of clientPending) {\n            try {\n              const out = await options.onToolCall({\n                toolCallId: call.toolCallId,\n                toolName: call.toolName,\n                input: call.input,\n              });\n              results.push({ toolCallId: call.toolCallId, result: out });\n              turn = applyUIPart(turn, {\n                type: 'tool-result',\n                toolCallId: call.toolCallId,\n                toolName: call.toolName,\n                output: out,\n              });\n            } catch (err) {\n              const message = err instanceof Error ? err.message : String(err);\n              results.push({ toolCallId: call.toolCallId, result: message, isError: true });\n              turn = applyUIPart(turn, {\n                type: 'tool-result',\n                toolCallId: call.toolCallId,\n                toolName: call.toolName,\n                output: message,\n                isError: true,\n              });\n            }\n            syncTurn(turn);\n          }\n          canonicalRef.current = [...canonicalRef.current, clientToolResultMessage(results)];\n          // loop → next round POSTs the extended history\n        }\n      } catch (err) {\n        if (controller.signal.aborted) return; // user abort — not an error\n        const e = err instanceof Error ? err : new Error(String(err));\n        setError(e);\n        setStatus('error');\n        options.onError?.(e);\n        return;\n      } finally {\n        setStatus((s) => (s === 'error' ? s : 'idle'));\n      }\n    },\n    [\n      options.api,\n      options.fetch,\n      options.headers,\n      options.body,\n      options.chatId,\n      options.generateId,\n      options.onToolCall,\n      options.onError,\n      pushMessage,\n      syncTurn,\n    ],\n  );\n\n  const sendMessage = useCallback(\n    async (text: string): Promise<void> => {\n      canonicalRef.current = [...canonicalRef.current, { role: 'user', content: text }];\n      pushMessage({ id: genId(), role: 'user', content: text });\n      approvalsRef.current = [];\n      verdictsRef.current = [];\n      setPendingApprovals([]);\n      await run();\n    },\n    [run, pushMessage, options.generateId],\n  );\n\n  const regenerate = useCallback(async (): Promise<void> => {\n    const cut = dropTrailingAssistant({ ui: uiRef.current, canonical: canonicalRef.current });\n    uiRef.current = cut.ui;\n    canonicalRef.current = cut.canonical;\n    setMessages(cut.ui);\n    approvalsRef.current = [];\n    verdictsRef.current = [];\n    setPendingApprovals([]);\n    await run();\n  }, [run]);\n\n  const editAndResend = useCallback(\n    async (messageId: string, text: string): Promise<void> => {\n      const cut = branchBeforeUserMessage(\n        { ui: uiRef.current, canonical: canonicalRef.current },\n        messageId,\n      );\n      if (!cut) return; // not a user message — nothing to branch\n      uiRef.current = cut.ui;\n      canonicalRef.current = cut.canonical;\n      setMessages(cut.ui);\n      approvalsRef.current = [];\n      verdictsRef.current = [];\n      setPendingApprovals([]);\n      await sendMessage(text);\n    },\n    [sendMessage],\n  );\n\n  const addToolApprovalResponse = useCallback(\n    async (response: ToolApprovalResponse): Promise<void> => {\n      // Preserve the request's signed token unless the caller set one.\n      const request = approvalsRef.current.find((p) => p.approvalId === response.approvalId);\n      const verdict =\n        response.token === undefined && request?.token !== undefined\n          ? { ...response, token: request.token }\n          : response;\n      verdictsRef.current = [\n        ...verdictsRef.current.filter((v) => v.approvalId !== verdict.approvalId),\n        verdict,\n      ];\n      const verdicts = verdictsRef.current;\n      const allSettled = approvalsRef.current.every((p) =>\n        verdicts.some((v) => v.approvalId === p.approvalId),\n      );\n      if (!allSettled) return;\n      approvalsRef.current = [];\n      verdictsRef.current = [];\n      setPendingApprovals([]);\n      await run(verdicts);\n    },\n    [run],\n  );\n\n  const reconnect = useCallback(async (): Promise<void> => {\n    const resume = options.resume;\n    if (!resume) return;\n    const controller = new AbortController();\n    abortRef.current = controller;\n    setStatus('streaming');\n    setError(undefined);\n    try {\n      const cursor = lastEventIdRef.current;\n      let turn: AssistantTurnState;\n      if (turnRef.current && cursor !== undefined) {\n        turn = turnRef.current; // continue in place — replay dedupes by seq upstream\n      } else {\n        // No cursor → full replay rebuilds the turn from the start; it lands in\n        // the trailing slot (replacing a partial turn if one is on screen).\n        turn = createAssistantTurn(genId());\n        if (!turnRef.current) pushMessage(turn.message);\n      }\n      turnRef.current = turn;\n      const parts = connectDeuzStream(resume.endpoint, {\n        ...(cursor !== undefined ? { lastEventId: cursor } : {}),\n        onCursor: (id) => {\n          lastEventIdRef.current = id;\n        },\n        signal: controller.signal,\n        ...(options.fetch ? { fetch: options.fetch } : {}),\n        ...(options.headers ? { headers: options.headers } : {}),\n      });\n      for await (const part of parts) {\n        turn = foldPart(turn, part);\n        turnRef.current = turn;\n        syncTurn(turn);\n      }\n      if (turn.error !== undefined) throw new Error(turn.error);\n      canonicalRef.current = [...canonicalRef.current, assistantMessageFromTurn(turn)];\n      turnRef.current = undefined;\n      if (turn.approvals.length > 0) {\n        approvalsRef.current = turn.approvals;\n        verdictsRef.current = [];\n        setPendingApprovals(turn.approvals);\n      }\n    } catch (err) {\n      if (controller.signal.aborted) return; // user abort — not an error\n      const e = err instanceof Error ? err : new Error(String(err));\n      setError(e);\n      setStatus('error');\n      options.onError?.(e);\n      return;\n    } finally {\n      setStatus((s) => (s === 'error' ? s : 'idle'));\n    }\n  }, [\n    options.resume,\n    options.fetch,\n    options.headers,\n    options.generateId,\n    options.onError,\n    pushMessage,\n    syncTurn,\n  ]);\n\n  return {\n    messages,\n    status,\n    error,\n    pendingApprovals,\n    ...(cost !== undefined ? { cost } : {}),\n    ...(budgetExceeded !== undefined ? { budgetExceeded } : {}),\n    dataParts,\n    citations,\n    sendMessage,\n    stop,\n    regenerate,\n    editAndResend,\n    addToolApprovalResponse,\n    reconnect,\n  };\n}\n","/**\n * useObject — streams `toDeuzObjectStreamResponse` output (`object-delta`\n * parts) into React state. Ported from the frozen `@deuz-sdk/core/react` hook.\n */\nimport { useCallback, useRef, useState } from 'react';\nimport type { DeepPartial } from '@deuz-sdk/core';\nimport { readDeuzStream } from '@deuz-sdk/core/ui';\n\nexport interface UseObjectOptions {\n  /** Endpoint serving `toDeuzObjectStreamResponse` output. */\n  api: string;\n  headers?: Record<string, string>;\n  /** Injectable for tests / custom transports. Defaults to global fetch. */\n  fetch?: typeof fetch;\n}\n\nexport interface UseObjectResult<T> {\n  /** Latest partial (each `object-delta` replaces it wholesale). */\n  object: DeepPartial<T> | undefined;\n  isLoading: boolean;\n  error: Error | undefined;\n  /** POSTs `{ input }` to `api` and streams partials into `object`. */\n  submit: (input: unknown) => Promise<void>;\n  /** Abort the in-flight stream (not an error). */\n  stop: () => void;\n}\n\nexport function useObject<T = unknown>(options: UseObjectOptions): UseObjectResult<T> {\n  const [object, setObject] = useState<DeepPartial<T> | undefined>(undefined);\n  const [isLoading, setLoading] = useState(false);\n  const [error, setError] = useState<Error | undefined>(undefined);\n  const abortRef = useRef<AbortController | null>(null);\n\n  const stop = useCallback((): void => {\n    abortRef.current?.abort();\n  }, []);\n\n  const submit = useCallback(\n    async (input: unknown): Promise<void> => {\n      abortRef.current?.abort();\n      const controller = new AbortController();\n      abortRef.current = controller;\n      setLoading(true);\n      setError(undefined);\n      setObject(undefined);\n      try {\n        const doFetch = options.fetch ?? fetch;\n        const res = await doFetch(options.api, {\n          method: 'POST',\n          headers: { 'content-type': 'application/json', ...options.headers },\n          body: JSON.stringify({ input }),\n          signal: controller.signal,\n        });\n        for await (const part of readDeuzStream(res)) {\n          if (part.type === 'object-delta') {\n            setObject(part.object as DeepPartial<T>);\n          } else if (part.type === 'error') {\n            setError(new Error(part.message));\n            break;\n          }\n        }\n      } catch (err) {\n        if (!controller.signal.aborted) {\n          setError(err instanceof Error ? err : new Error(String(err)));\n        }\n      } finally {\n        setLoading(false);\n      }\n    },\n    [options.api, options.fetch, options.headers],\n  );\n\n  return { object, isLoading, error, submit, stop };\n}\n","/**\n * Headless chat components — zero styling, zero business logic. They only\n * wire core types (`ToolApprovalRequest`/`ToolApprovalResponse`, the useChat\n * cost state) to DOM events; presentation is overridable via render props.\n */\nimport type { ReactNode } from 'react';\nimport type { ToolApprovalRequest, ToolApprovalResponse } from '@deuz-sdk/core';\nimport type { UseChatCost } from './use-chat';\n\nexport interface ToolApprovalCardProps {\n  approval: ToolApprovalRequest;\n  /** Feed this straight into `useChat().addToolApprovalResponse`. */\n  onRespond: (response: ToolApprovalResponse) => void;\n  /** Override presentation; the component supplies the wired callbacks. */\n  render?: (ctx: {\n    approval: ToolApprovalRequest;\n    approve: () => void;\n    deny: (reason?: string) => void;\n  }) => ReactNode;\n}\n\n/**\n * One pending tool approval. The verdict always carries the request's signed\n * `token` (D4) — callers never have to thread it themselves.\n */\nexport function ToolApprovalCard({ approval, onRespond, render }: ToolApprovalCardProps) {\n  const respond = (approved: boolean, reason?: string): void =>\n    onRespond({\n      approvalId: approval.approvalId,\n      approved,\n      ...(reason !== undefined ? { reason } : {}),\n      ...(approval.token !== undefined ? { token: approval.token } : {}),\n    });\n  const approve = (): void => respond(true);\n  const deny = (reason?: string): void => respond(false, reason);\n\n  if (render) return <>{render({ approval, approve, deny })}</>;\n  return (\n    <div data-deuz=\"tool-approval\">\n      <span data-deuz=\"tool-approval-name\">{approval.toolName}</span>\n      <pre data-deuz=\"tool-approval-input\">{JSON.stringify(approval.input, null, 2)}</pre>\n      <button type=\"button\" onClick={approve}>\n        Approve\n      </button>\n      <button type=\"button\" onClick={() => deny()}>\n        Deny\n      </button>\n    </div>\n  );\n}\n\nexport interface CostBadgeProps {\n  /** The `useChat` cost state (undefined until the first `cost` part arrives). */\n  cost: UseChatCost | undefined;\n  /** Override presentation. */\n  format?: (cost: UseChatCost) => ReactNode;\n}\n\n/** Live cost readout: `$X.XXXX`, plus ` (saved $Y.YYYY)` when caching saved money. */\nexport function CostBadge({ cost, format }: CostBadgeProps) {\n  if (cost === undefined) return null;\n  if (format) return <>{format(cost)}</>;\n  const saved =\n    cost.cacheSavingsUsd !== undefined && cost.cacheSavingsUsd > 0\n      ? ` (saved $${cost.cacheSavingsUsd.toFixed(4)})`\n      : '';\n  return <span data-deuz=\"cost-badge\">{`$${cost.costUsd.toFixed(4)}${saved}`}</span>;\n}\n"]}

package/package.json

@@ -0,0 +1,78 @@
+{
+  "name": "@deuz-sdk/react",
+  "version": "1.7.0",
+  "description": "React bindings for the Deuz SDK — useChat/useObject hooks and headless chat components.",
+  "license": "MIT",
+  "author": "Umutcan Edizaslan (U-C4N)",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Deuz-AI/Deuz-SDK.git",
+    "directory": "packages/react"
+  },
+  "homepage": "https://github.com/Deuz-AI/Deuz-SDK#readme",
+  "bugs": "https://github.com/Deuz-AI/Deuz-SDK/issues",
+  "type": "module",
+  "sideEffects": false,
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "lint": "eslint .",
+    "typecheck": "tsc --noEmit",
+    "verify:package": "publint --strict && attw --pack .",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "ai",
+    "react",
+    "hooks",
+    "chat",
+    "useChat",
+    "streaming",
+    "deuz"
+  ],
+  "peerDependencies": {
+    "@deuz-sdk/core": "^1.7.0",
+    "react": "^18.0.0 || ^19.0.0"
+  },
+  "devDependencies": {
+    "@arethetypeswrong/cli": "^0.18.0",
+    "@deuz-sdk/core": "^1.7.0",
+    "@testing-library/react": "^16.3.2",
+    "@types/react": "^19.2.17",
+    "eslint": "^9.18.0",
+    "eslint-config-prettier": "^9.1.0",
+    "jsdom": "^29.1.1",
+    "publint": "^0.3.0",
+    "react": "^19.2.7",
+    "react-dom": "^19.2.7",
+    "tsup": "^8.5.0",
+    "typescript": "^5.7.0",
+    "typescript-eslint": "^8.20.0",
+    "vitest": "^4.0.0"
+  }
+}