@darqlabs/curator-sdk-react 0.1.0

package/dist/cjs/useCuratorChat.js

@@ -0,0 +1,135 @@
+"use strict";
+/**
+ * Headless chat hook for the Curator SDK.
+ *
+ * Manages a single conversation against a deployed agent. Owns the
+ * `Chat` instance from the SDK, exposes the rolling message list, a
+ * `send()` action, and the various pending/error states the UI needs.
+ *
+ * Bring your own UI on top of this hook, or use `<CuratorChat />` for
+ * the drop-in styled widget that consumes this hook internally.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useCuratorChat = useCuratorChat;
+const react_1 = require("react");
+const curator_sdk_1 = require("@darqlabs/curator-sdk");
+const CuratorProvider_js_1 = require("./CuratorProvider.js");
+let counter = 0;
+function localId() {
+    counter += 1;
+    return `local_${Date.now().toString(36)}_${counter}`;
+}
+function useCuratorChat(opts) {
+    const { agent, project, environment, system, conversationId, onMessage, onError } = opts;
+    // Resolve the client: explicit prop wins, then context, then fail loud.
+    const contextClient = (0, CuratorProvider_js_1.useCuratorOrNull)();
+    const curator = opts.curator ?? contextClient;
+    if (!curator) {
+        throw new Error("useCuratorChat() requires a Curator client. Either pass `curator` explicitly " +
+            "or wrap your app in <CuratorProvider client={curator}>.");
+    }
+    // Construct the Chat on first render and whenever any addressing input
+    // changes. Re-creating on slug/project/env changes prevents accidentally
+    // sending to a stale agent if the consumer swaps props.
+    const chat = (0, react_1.useMemo)(() => {
+        const agentHandle = curator.agent(agent, { project, environment, system });
+        return conversationId ? agentHandle.conversation(conversationId) : agentHandle.chat();
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [curator, agent, project, environment, system, conversationId]);
+    const [messages, setMessages] = (0, react_1.useState)([]);
+    const [sending, setSending] = (0, react_1.useState)(false);
+    const [error, setError] = (0, react_1.useState)(null);
+    const [conversationIdState, setConversationIdState] = (0, react_1.useState)(conversationId ?? null);
+    // Whenever the chat handle changes (consumer swapped props or called
+    // reset), wipe local message state to avoid mixing transcripts.
+    const lastChatRef = (0, react_1.useRef)(null);
+    (0, react_1.useEffect)(() => {
+        if (lastChatRef.current !== chat) {
+            lastChatRef.current = chat;
+            setMessages([]);
+            setError(null);
+            setConversationIdState(chat.id);
+        }
+    }, [chat]);
+    const send = (0, react_1.useCallback)(async (content, args = {}) => {
+        const trimmed = content.trim();
+        if (!trimmed && !args.files?.length)
+            return;
+        const userBubble = { kind: "user", content: trimmed, localId: localId() };
+        setMessages((prev) => [...prev, userBubble]);
+        setSending(true);
+        setError(null);
+        try {
+            const reply = await chat.send(trimmed, args);
+            setConversationIdState(reply.conversationId);
+            setMessages((prev) => [
+                ...prev,
+                {
+                    kind: "assistant",
+                    content: reply.content,
+                    sequence: reply.sequence,
+                    stepId: reply.stepId,
+                    createdAt: reply.createdAt,
+                    runId: reply.runId,
+                },
+            ]);
+            onMessage?.(reply);
+        }
+        catch (err) {
+            const message = renderError(err);
+            setError(err);
+            setMessages((prev) => [...prev, { kind: "error", message, localId: localId() }]);
+            onError?.(err);
+        }
+        finally {
+            setSending(false);
+        }
+    }, [chat, onMessage, onError]);
+    const reset = (0, react_1.useCallback)(() => {
+        // Force the memo to refresh by zeroing the ref; the consumer-controlled
+        // inputs determine the next Chat. For the no-prop-change case, we
+        // instead just clear local state — the existing Chat is still valid.
+        setMessages([]);
+        setError(null);
+        setConversationIdState(chat.id);
+    }, [chat]);
+    return {
+        messages,
+        send,
+        sending,
+        error,
+        chat,
+        conversationId: conversationIdState,
+        reset,
+    };
+}
+function renderError(err) {
+    if (err instanceof curator_sdk_1.CuratorApprovalRequiredError) {
+        return `That action needs administrator approval. Please contact your administrator to review the request for "${err.approval.tool_name}".`;
+    }
+    if (err instanceof curator_sdk_1.CuratorAgentError) {
+        return err.message || `Agent error (${err.failureClass}).`;
+    }
+    if (err instanceof curator_sdk_1.CuratorTimeoutError) {
+        return "The agent is taking longer than expected. It may still complete in the background.";
+    }
+    if (err instanceof curator_sdk_1.CuratorAuthError) {
+        return "Authentication failed. Check your API key.";
+    }
+    if (err instanceof curator_sdk_1.CuratorForbiddenError) {
+        return err.message || "Permission denied.";
+    }
+    if (err instanceof curator_sdk_1.CuratorNotFoundError) {
+        return err.message || "Deployment or conversation not found.";
+    }
+    if (err instanceof curator_sdk_1.CuratorDeploymentRetiredError) {
+        return "This deployment has been retired by the operator.";
+    }
+    if (err instanceof curator_sdk_1.CuratorRateLimitError) {
+        return "Rate limit reached. Please wait a moment and try again.";
+    }
+    if (err instanceof Error)
+        return err.message;
+    return "Something went wrong.";
+}
+//# sourceMappingURL=useCuratorChat.js.map

package/dist/cjs/useCuratorChat.js.map

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

package/dist/esm/CuratorAdapter.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Adapter that plugs the Curator SDK into assistant-ui's `useLocalRuntime`.
+ *
+ * Each invocation of `run()` is one user-turn. We pull the latest user
+ * message text out of assistant-ui's structured `messages[]`, hand it to
+ * `chat.stream(...)`, and yield assistant-ui-shaped updates back as the
+ * SDK's stream events flow in.
+ *
+ *   stream.delta            → accumulate text, yield partial assistant content
+ *   stream.done             → yield final content + status: complete
+ *   stream.error            → yield friendly text + status: incomplete
+ *   stream.paused_for_      → yield "contact your administrator" text +
+ *     approval                status: incomplete
+ *
+ * The Chat handle is constructed once per chat session (one per
+ * mounted CuratorChat / launcher panel) so multi-turn context stays
+ * intact across runs.
+ */
+import type { ChatModelAdapter } from "@assistant-ui/react";
+import type { AssistantMessage, Chat, CuratorError } from "@darqlabs/curator-sdk";
+export interface CuratorAdapterCallbacks {
+    /** Fired once per successfully-returned assistant message. */
+    onMessage?: (message: AssistantMessage) => void;
+    /** Fired on any send-time error surfaced through the stream. */
+    onError?: (error: CuratorError | Error) => void;
+}
+export declare function createCuratorAdapter(chat: Chat, callbacks?: CuratorAdapterCallbacks): ChatModelAdapter;
+//# sourceMappingURL=CuratorAdapter.d.ts.map

package/dist/esm/CuratorAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CuratorAdapter.d.ts","sourceRoot":"","sources":["../../src/CuratorAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAsB,MAAM,qBAAqB,CAAA;AAC/E,OAAO,KAAK,EACV,gBAAgB,EAChB,IAAI,EACJ,YAAY,EACb,MAAM,uBAAuB,CAAA;AAE9B,MAAM,WAAW,uBAAuB;IACtC,8DAA8D;IAC9D,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,gBAAgB,KAAK,IAAI,CAAA;IAC/C,gEAAgE;IAChE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,GAAG,KAAK,KAAK,IAAI,CAAA;CAChD;AAED,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,IAAI,EACV,SAAS,GAAE,uBAA4B,GACtC,gBAAgB,CA6DlB"}

package/dist/esm/CuratorAdapter.js

@@ -0,0 +1,97 @@
+/**
+ * Adapter that plugs the Curator SDK into assistant-ui's `useLocalRuntime`.
+ *
+ * Each invocation of `run()` is one user-turn. We pull the latest user
+ * message text out of assistant-ui's structured `messages[]`, hand it to
+ * `chat.stream(...)`, and yield assistant-ui-shaped updates back as the
+ * SDK's stream events flow in.
+ *
+ *   stream.delta            → accumulate text, yield partial assistant content
+ *   stream.done             → yield final content + status: complete
+ *   stream.error            → yield friendly text + status: incomplete
+ *   stream.paused_for_      → yield "contact your administrator" text +
+ *     approval                status: incomplete
+ *
+ * The Chat handle is constructed once per chat session (one per
+ * mounted CuratorChat / launcher panel) so multi-turn context stays
+ * intact across runs.
+ */
+export function createCuratorAdapter(chat, callbacks = {}) {
+    return {
+        async *run({ messages, abortSignal }) {
+            const userText = extractLatestUserText(messages);
+            if (!userText)
+                return;
+            let acc = "";
+            try {
+                for await (const event of chat.stream(userText)) {
+                    if (abortSignal.aborted)
+                        return;
+                    if (event.type === "delta") {
+                        acc += event.text;
+                        yield { content: [{ type: "text", text: acc }] };
+                        continue;
+                    }
+                    if (event.type === "done") {
+                        const finalText = event.message?.content ?? acc;
+                        yield {
+                            content: [{ type: "text", text: finalText }],
+                            status: { type: "complete", reason: "stop" },
+                        };
+                        if (event.message)
+                            callbacks.onMessage?.(event.message);
+                        return;
+                    }
+                    if (event.type === "error") {
+                        yield {
+                            content: [{ type: "text", text: event.message }],
+                            status: { type: "incomplete", reason: "error" },
+                        };
+                        callbacks.onError?.(new Error(event.message));
+                        return;
+                    }
+                    if (event.type === "paused_for_approval") {
+                        const pausedMessage = `This action needs administrator approval. ` +
+                            `Contact your administrator to review the request for "${event.approval.tool_name}".`;
+                        yield {
+                            content: [{ type: "text", text: pausedMessage }],
+                            status: { type: "incomplete", reason: "error" },
+                        };
+                        callbacks.onError?.(new Error(pausedMessage));
+                        return;
+                    }
+                    // tool_call.* and any future event types are silently dropped
+                    // until a richer UI surface ships for them.
+                }
+            }
+            catch (err) {
+                const message = err?.message || "Something went wrong sending your message.";
+                yield {
+                    content: [{ type: "text", text: message }],
+                    status: { type: "incomplete", reason: "error" },
+                };
+                callbacks.onError?.(err);
+            }
+        },
+    };
+}
+/**
+ * Pull the latest user-turn text out of assistant-ui's structured
+ * message array. Text parts are concatenated with newlines; other
+ * part types (image, file, etc.) are ignored for now — the SDK's
+ * `chat.stream` accepts plain text content only.
+ */
+function extractLatestUserText(messages) {
+    for (let i = messages.length - 1; i >= 0; i--) {
+        const m = messages[i];
+        if (m.role !== "user")
+            continue;
+        const text = m.content
+            .filter((p) => typeof p === "object" && p !== null && p.type === "text")
+            .map((p) => p.text)
+            .join("\n");
+        return text.trim();
+    }
+    return "";
+}
+//# sourceMappingURL=CuratorAdapter.js.map

package/dist/esm/CuratorAdapter.js.map

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

package/dist/esm/CuratorChat.d.ts

@@ -0,0 +1,70 @@
+/**
+ * <CuratorChat /> — drop-in chat widget backed by a Curator SDK client.
+ *
+ *   <CuratorChat curator={curator} agent="support-bot" />
+ *
+ * Internals are powered by `@assistant-ui/react` — `useLocalRuntime`
+ * wraps our `CuratorAdapter`, which delegates each user turn to
+ * `chat.stream(...)` for token-by-token rendering. The outer chrome
+ * (header, brand footer, theme tokens, close button) and the bubble
+ * layout stay ours so the widget keeps its identity across themes.
+ */
+import { type CSSProperties, type ReactNode } from "react";
+import type { AssistantMessage, Curator, CuratorError, Environment } from "@darqlabs/curator-sdk";
+export interface CuratorChatProps {
+    /** SDK instance. Optional when a `<CuratorProvider>` is mounted. */
+    curator?: Curator;
+    /** Deployment slug to chat with. */
+    agent: string;
+    /** Override the SDK's default project for this widget. */
+    project?: string;
+    /** Override the SDK's default environment for this widget. */
+    environment?: Environment;
+    /** Address a system-scoped deployment. */
+    system?: boolean;
+    /** Reattach to an existing conversation id instead of starting fresh. */
+    conversationId?: string;
+    /** Header title. Default: "Chat". */
+    title?: string;
+    /** Input placeholder. Default: "Type a message…". */
+    placeholder?: string;
+    /** Shown above the empty message list as a system prompt. */
+    welcomeMessage?: string;
+    /** Built-in palette. Default: "light". */
+    theme?: "light" | "dark";
+    /** Class applied to the outer wrapper. */
+    className?: string;
+    /** Inline styles merged onto the outer wrapper. */
+    style?: CSSProperties;
+    /** If set, the header shows an X button that calls this. */
+    onClose?: () => void;
+    /**
+     * Indicator rendered inside the assistant bubble while it's waiting
+     * for the first token (the gap between Send and the first delta).
+     * Default: animated three-dot pulse. Pass any node to swap it out.
+     */
+    loadingIndicator?: ReactNode;
+    /** Fired once per assistant message that completes successfully. */
+    onMessage?: (message: AssistantMessage) => void;
+    /** Fired on any terminal stream error or thrown exception. */
+    onError?: (error: CuratorError | Error) => void;
+    /**
+     * Show a retry (↻) button under the latest assistant message. Default:
+     * off. Retry re-sends the preceding user message through the SDK — note
+     * that this appends a fresh turn to the server-side conversation rather
+     * than regenerating the last reply in place, so persisted history will
+     * contain the duplicated user message. Fine for casual / demo widgets;
+     * enable only if that history shape is acceptable for your deployment.
+     */
+    enableRetry?: boolean;
+    /**
+     * Show a copy button on assistant messages that copies the message text
+     * to the clipboard. Default: off. Appears alongside retry (when enabled)
+     * in the per-message action bar; a check glyph confirms the copy briefly.
+     */
+    enableCopy?: boolean;
+}
+export declare function CuratorChat(props: CuratorChatProps): import("react").JSX.Element;
+declare function AssistantMessage(): import("react").JSX.Element;
+export {};
+//# sourceMappingURL=CuratorChat.d.ts.map

package/dist/esm/CuratorChat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CuratorChat.d.ts","sourceRoot":"","sources":["../../src/CuratorChat.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAML,KAAK,aAAa,EAClB,KAAK,SAAS,EACf,MAAM,OAAO,CAAA;AAUd,OAAO,KAAK,EACV,gBAAgB,EAEhB,OAAO,EACP,YAAY,EACZ,WAAW,EACZ,MAAM,uBAAuB,CAAA;AAM9B,MAAM,WAAW,gBAAgB;IAC/B,oEAAoE;IACpE,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,oCAAoC;IACpC,KAAK,EAAE,MAAM,CAAA;IACb,0DAA0D;IAC1D,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,8DAA8D;IAC9D,WAAW,CAAC,EAAE,WAAW,CAAA;IACzB,0CAA0C;IAC1C,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,yEAAyE;IACzE,cAAc,CAAC,EAAE,MAAM,CAAA;IAEvB,qCAAqC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,qDAAqD;IACrD,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,6DAA6D;IAC7D,cAAc,CAAC,EAAE,MAAM,CAAA;IAEvB,0CAA0C;IAC1C,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,CAAA;IACxB,0CAA0C;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,mDAAmD;IACnD,KAAK,CAAC,EAAE,aAAa,CAAA;IAErB,4DAA4D;IAC5D,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;IAEpB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,SAAS,CAAA;IAC5B,oEAAoE;IACpE,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,gBAAgB,KAAK,IAAI,CAAA;IAC/C,8DAA8D;IAC9D,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,GAAG,KAAK,KAAK,IAAI,CAAA;IAE/C;;;;;;;OAOG;IACH,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,CAAA;CACrB;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,+BAqGlD;AAoDD,iBAAS,gBAAgB,gCAqCxB"}