@steerable/agent-ui 0.2.0

package/dist/components/ToolCallRenderer.js

@@ -0,0 +1,70 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * `ToolCallRenderer` — display a single tool call + (optional) tool result.
+ *
+ * Renders three visual rows depending on lifecycle / mode:
+ *
+ *   ┌──────────────────────────────────────────────────┐
+ *   │ [icon] tool_name [mode-pill]              [time] │
+ *   │   args (collapsed by default)                    │
+ *   │   ── result ──                                   │
+ *   │   message + data (collapsed by default)          │
+ *   └──────────────────────────────────────────────────┘
+ *
+ * Headless body: callers can override the args / result subtree with
+ * `renderArgs` / `renderResult` if they need richer formatting (diffs, code
+ * blocks, structured cards). Default body uses pretty-printed JSON.
+ */
+import { useState } from 'react';
+import { useToolCallStatus } from '../hooks/useToolCallStatus.js';
+import { cn } from './cn.js';
+const modeBadgeClass = {
+    read: 'bg-agent-tool-read/15 text-agent-tool-read border-agent-tool-read/40',
+    safe_write: 'bg-agent-tool-write/15 text-agent-tool-write border-agent-tool-write/40',
+    destructive: 'bg-agent-tool-destructive/15 text-agent-tool-destructive border-agent-tool-destructive/40',
+    local: 'bg-agent-accent/15 text-agent-accent border-agent-accent/40',
+    external: 'bg-agent-muted text-agent-muted-foreground border-agent-border',
+    ui: 'bg-agent-muted text-agent-muted-foreground border-agent-border',
+    synthetic: 'bg-agent-muted text-agent-muted-foreground border-agent-border',
+    unknown: 'bg-agent-muted text-agent-muted-foreground border-agent-border',
+};
+const statusDotClass = {
+    pending: 'bg-agent-muted-foreground animate-pulse',
+    running: 'bg-agent-accent animate-pulse',
+    done: 'bg-agent-tool-read',
+    error: 'bg-agent-destructive',
+};
+function defaultArgsRenderer(call) {
+    return (_jsx("pre", { className: "whitespace-pre-wrap break-words text-xs leading-relaxed text-agent-muted-foreground", children: safeStringify(call.arguments) }));
+}
+function defaultResultRenderer(result) {
+    const lines = [];
+    if (result.message) {
+        lines.push(_jsx("div", { className: "text-xs text-agent-foreground", children: result.message }, "msg"));
+    }
+    if (result.error) {
+        lines.push(_jsx("div", { className: "text-xs text-agent-destructive", children: result.error }, "err"));
+    }
+    if (result.data) {
+        lines.push(_jsx("pre", { className: "mt-1 whitespace-pre-wrap break-words text-xs leading-relaxed text-agent-muted-foreground", children: safeStringify(result.data) }, "data"));
+    }
+    if (lines.length === 0) {
+        lines.push(_jsx("div", { className: "text-xs text-agent-muted-foreground", children: "ok" }, "ok"));
+    }
+    return _jsx("div", { className: "space-y-1", children: lines });
+}
+function safeStringify(value) {
+    try {
+        return JSON.stringify(value, null, 2);
+    }
+    catch {
+        return String(value);
+    }
+}
+export function ToolCallRenderer(props) {
+    const { call, result, mode, runningHint, onApprove, onReject, className, renderArgs = defaultArgsRenderer, renderResult = defaultResultRenderer, defaultExpanded = false, } = props;
+    const [expanded, setExpanded] = useState(defaultExpanded);
+    const status = useToolCallStatus({ call, result, mode, runningHint });
+    return (_jsxs("div", { "data-status": status.status, "data-mode": status.mode, className: cn('rounded-agent-md border bg-agent-canvas px-3 py-2 text-agent-foreground', status.isDestructive ? 'border-agent-destructive/40' : 'border-agent-border', className), children: [_jsxs("button", { type: "button", className: "flex w-full items-center justify-between gap-2 text-left", onClick: () => setExpanded((v) => !v), "aria-expanded": expanded, children: [_jsxs("span", { className: "flex min-w-0 items-center gap-2", children: [_jsx("span", { className: cn('h-2 w-2 rounded-full', statusDotClass[status.status]), "aria-hidden": true }), _jsx("span", { className: "truncate font-mono text-xs font-medium", children: call.name }), _jsx("span", { className: cn('shrink-0 rounded-full border px-1.5 py-0.5 text-[10px] font-semibold uppercase tracking-wide', modeBadgeClass[status.mode]), children: status.mode })] }), _jsx("span", { className: "shrink-0 text-[10px] uppercase tracking-wide text-agent-muted-foreground", children: status.status })] }), status.requiresApproval && !result ? (_jsxs("div", { className: "mt-2 flex items-center gap-2", children: [_jsx("span", { className: "text-xs text-agent-muted-foreground", children: "Local execution requires approval." }), onApprove ? (_jsx("button", { type: "button", className: "rounded-agent-sm bg-agent-accent px-2 py-1 text-xs font-medium text-agent-accent-foreground", onClick: () => onApprove(call), children: "Approve" })) : null, onReject ? (_jsx("button", { type: "button", className: "rounded-agent-sm border border-agent-border px-2 py-1 text-xs font-medium text-agent-foreground", onClick: () => onReject(call), children: "Reject" })) : null] })) : null, expanded ? (_jsxs("div", { className: "mt-2 space-y-2 border-t border-agent-border pt-2", children: [renderArgs(call), result ? (_jsx("div", { className: "border-t border-dashed border-agent-border pt-2", children: renderResult(result) })) : null] })) : null] }));
+}
+//# sourceMappingURL=ToolCallRenderer.js.map

package/dist/components/ToolCallRenderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolCallRenderer.js","sourceRoot":"","sources":["../../src/components/ToolCallRenderer.tsx"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAEjC,OAAO,EAAE,iBAAiB,EAAqB,MAAM,+BAA+B,CAAC;AACrF,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAyB7B,MAAM,cAAc,GAAiC;IACnD,IAAI,EAAE,sEAAsE;IAC5E,UAAU,EACR,yEAAyE;IAC3E,WAAW,EACT,2FAA2F;IAC7F,KAAK,EACH,6DAA6D;IAC/D,QAAQ,EACN,gEAAgE;IAClE,EAAE,EAAE,gEAAgE;IACpE,SAAS,EACP,gEAAgE;IAClE,OAAO,EACL,gEAAgE;CACnE,CAAC;AAEF,MAAM,cAAc,GAA2B;IAC7C,OAAO,EAAE,yCAAyC;IAClD,OAAO,EAAE,+BAA+B;IACxC,IAAI,EAAE,oBAAoB;IAC1B,KAAK,EAAE,sBAAsB;CAC9B,CAAC;AAEF,SAAS,mBAAmB,CAAC,IAAc;IACzC,OAAO,CACL,cAAK,SAAS,EAAC,qFAAqF,YACjG,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,GAC1B,CACP,CAAC;AACJ,CAAC;AAED,SAAS,qBAAqB,CAAC,MAAkB;IAC/C,MAAM,KAAK,GAAsB,EAAE,CAAC;IACpC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,KAAK,CAAC,IAAI,CACR,cAAe,SAAS,EAAC,+BAA+B,YACrD,MAAM,CAAC,OAAO,IADR,KAAK,CAER,CACP,CAAC;IACJ,CAAC;IACD,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,KAAK,CAAC,IAAI,CACR,cAAe,SAAS,EAAC,gCAAgC,YACtD,MAAM,CAAC,KAAK,IADN,KAAK,CAER,CACP,CAAC;IACJ,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QAChB,KAAK,CAAC,IAAI,CACR,cAEE,SAAS,EAAC,0FAA0F,YAEnG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,IAHvB,MAAM,CAIN,CACP,CAAC;IACJ,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CACR,cAAc,SAAS,EAAC,qCAAqC,oBAApD,IAAI,CAEP,CACP,CAAC;IACJ,CAAC;IACD,OAAO,cAAK,SAAS,EAAC,WAAW,YAAE,KAAK,GAAO,CAAC;AAClD,CAAC;AAED,SAAS,aAAa,CAAC,KAAc;IACnC,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAA4B;IAC3D,MAAM,EACJ,IAAI,EACJ,MAAM,EACN,IAAI,EACJ,WAAW,EACX,SAAS,EACT,QAAQ,EACR,SAAS,EACT,UAAU,GAAG,mBAAmB,EAChC,YAAY,GAAG,qBAAqB,EACpC,eAAe,GAAG,KAAK,GACxB,GAAG,KAAK,CAAC;IACV,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CAAC,eAAe,CAAC,CAAC;IAE1D,MAAM,MAAM,GAAG,iBAAiB,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;IAEtE,OAAO,CACL,8BACe,MAAM,CAAC,MAAM,eACf,MAAM,CAAC,IAAI,EACtB,SAAS,EAAE,EAAE,CACX,yEAAyE,EACzE,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,6BAA6B,CAAC,CAAC,CAAC,qBAAqB,EAC5E,SAAS,CACV,aAED,kBACE,IAAI,EAAC,QAAQ,EACb,SAAS,EAAC,0DAA0D,EACpE,OAAO,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,mBACtB,QAAQ,aAEvB,gBAAM,SAAS,EAAC,iCAAiC,aAC/C,eACE,SAAS,EAAE,EAAE,CAAC,sBAAsB,EAAE,cAAc,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,wBAEpE,EACF,eAAM,SAAS,EAAC,wCAAwC,YACrD,IAAI,CAAC,IAAI,GACL,EACP,eACE,SAAS,EAAE,EAAE,CACX,8FAA8F,EAC9F,cAAc,CAAC,MAAM,CAAC,IAAI,CAAC,CAC5B,YAEA,MAAM,CAAC,IAAI,GACP,IACF,EACP,eAAM,SAAS,EAAC,0EAA0E,YACvF,MAAM,CAAC,MAAM,GACT,IACA,EACR,MAAM,CAAC,gBAAgB,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CACpC,eAAK,SAAS,EAAC,8BAA8B,aAC3C,eAAM,SAAS,EAAC,qCAAqC,mDAE9C,EACN,SAAS,CAAC,CAAC,CAAC,CACX,iBACE,IAAI,EAAC,QAAQ,EACb,SAAS,EAAC,6FAA6F,EACvG,OAAO,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,wBAGvB,CACV,CAAC,CAAC,CAAC,IAAI,EACP,QAAQ,CAAC,CAAC,CAAC,CACV,iBACE,IAAI,EAAC,QAAQ,EACb,SAAS,EAAC,iGAAiG,EAC3G,OAAO,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,uBAGtB,CACV,CAAC,CAAC,CAAC,IAAI,IACJ,CACP,CAAC,CAAC,CAAC,IAAI,EACP,QAAQ,CAAC,CAAC,CAAC,CACV,eAAK,SAAS,EAAC,kDAAkD,aAC9D,UAAU,CAAC,IAAI,CAAC,EAChB,MAAM,CAAC,CAAC,CAAC,CACR,cAAK,SAAS,EAAC,iDAAiD,YAC7D,YAAY,CAAC,MAAM,CAAC,GACjB,CACP,CAAC,CAAC,CAAC,IAAI,IACJ,CACP,CAAC,CAAC,CAAC,IAAI,IACJ,CACP,CAAC;AACJ,CAAC"}

package/dist/components/ToolCallRenderer.stories.d.ts

@@ -0,0 +1,13 @@
+import type { Meta, StoryObj } from '@storybook/react';
+import { ToolCallRenderer } from './ToolCallRenderer.js';
+declare const meta: Meta<typeof ToolCallRenderer>;
+export default meta;
+type Story = StoryObj<typeof ToolCallRenderer>;
+export declare const ReadModePending: Story;
+export declare const ReadModeSuccess: Story;
+export declare const SafeWriteRunning: Story;
+export declare const SafeWriteError: Story;
+export declare const DestructivePending: Story;
+export declare const LocalAwaitingApproval: Story;
+export declare const CustomRenderers: Story;
+//# sourceMappingURL=ToolCallRenderer.stories.d.ts.map

package/dist/components/ToolCallRenderer.stories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolCallRenderer.stories.d.ts","sourceRoot":"","sources":["../../src/components/ToolCallRenderer.stories.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,QAAA,MAAM,IAAI,EAAE,IAAI,CAAC,OAAO,gBAAgB,CAoBvC,CAAC;AAEF,eAAe,IAAI,CAAC;AACpB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,gBAAgB,CAAC,CAAC;AA8C/C,eAAO,MAAM,eAAe,EAAE,KAK7B,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,KAO7B,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,KAM9B,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,KAO5B,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,KAMhC,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,KAOnC,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,KA4B7B,CAAC"}

package/dist/components/ToolCallRenderer.stories.js

@@ -0,0 +1,112 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { ToolCallRenderer } from './ToolCallRenderer.js';
+const meta = {
+    title: 'Components/ToolCallRenderer',
+    component: ToolCallRenderer,
+    parameters: {
+        layout: 'centered',
+        actions: { argTypesRegex: '^on[A-Z].*' },
+        docs: {
+            description: {
+                component: 'Single tool-call card. Computes its display state from `useToolCallStatus` (call + optional result + mode hint). Pass `mode="local"` and `onApprove` / `onReject` to render an approval prompt for local-execution tools.',
+            },
+        },
+    },
+    decorators: [
+        (Story) => (_jsx("div", { className: "w-[520px]", children: _jsx(Story, {}) })),
+    ],
+};
+export default meta;
+const readCall = {
+    id: 'call_read_1',
+    name: 'web_search',
+    arguments: { query: 'tokyo vegetarian restaurants 2026' },
+};
+const writeCall = {
+    id: 'call_write_1',
+    name: 'create_calendar_event',
+    arguments: {
+        title: 'Team retro',
+        startTime: '2026-05-20T14:00:00Z',
+        durationMinutes: 60,
+    },
+};
+const destructiveCall = {
+    id: 'call_destructive_1',
+    name: 'shell_exec',
+    arguments: { command: 'rm -rf /tmp/build-cache' },
+};
+const localCall = {
+    id: 'call_local_1',
+    name: 'cflog_open_workspace',
+    arguments: { path: '/Users/me/projects/cflog/case-2024-001' },
+};
+const successResult = {
+    success: true,
+    message: 'Found 12 results.',
+    data: {
+        hits: [
+            { title: 'T\u2019s Tantan', url: 'https://example.com/1' },
+            { title: 'AIN SOPH. Soar', url: 'https://example.com/2' },
+        ],
+    },
+};
+const errorResult = {
+    success: false,
+    error: 'TimeRangeConflict: another event already occupies 14:00–15:00 on 2026-05-20',
+};
+export const ReadModePending = {
+    args: {
+        call: readCall,
+        mode: 'read',
+    },
+};
+export const ReadModeSuccess = {
+    args: {
+        call: readCall,
+        result: successResult,
+        mode: 'read',
+        defaultExpanded: true,
+    },
+};
+export const SafeWriteRunning = {
+    args: {
+        call: writeCall,
+        mode: 'safe_write',
+        runningHint: true,
+    },
+};
+export const SafeWriteError = {
+    args: {
+        call: writeCall,
+        result: errorResult,
+        mode: 'safe_write',
+        defaultExpanded: true,
+    },
+};
+export const DestructivePending = {
+    args: {
+        call: destructiveCall,
+        mode: 'destructive',
+        defaultExpanded: true,
+    },
+};
+export const LocalAwaitingApproval = {
+    args: {
+        call: localCall,
+        mode: 'local',
+        onApprove: () => { },
+        onReject: () => { },
+    },
+};
+export const CustomRenderers = {
+    args: {
+        call: readCall,
+        result: successResult,
+        mode: 'read',
+        defaultExpanded: true,
+        renderArgs: (call) => (_jsxs("div", { className: "text-xs", children: [_jsx("span", { className: "font-medium text-agent-foreground", children: "Query:" }), ' ', _jsx("span", { className: "text-agent-muted-foreground", children: String(call.arguments.query ?? '') })] })),
+        renderResult: (result) => (_jsx("ul", { className: "space-y-1 text-xs text-agent-muted-foreground", children: (result.data?.hits ?? []).map((hit) => (_jsx("li", { children: _jsx("a", { className: "text-agent-accent underline", href: hit.url, children: hit.title }) }, hit.url))) })),
+    },
+};
+//# sourceMappingURL=ToolCallRenderer.stories.js.map

package/dist/components/ToolCallRenderer.stories.js.map

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

package/dist/components/cn.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Tiny class-name combiner. We intentionally don't depend on `clsx` /
+ * `tailwind-merge` to keep the package's runtime footprint near zero — those
+ * niceties belong in the consumer app.
+ */
+export declare function cn(...values: Array<string | false | null | undefined>): string;
+//# sourceMappingURL=cn.d.ts.map

package/dist/components/cn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cn.d.ts","sourceRoot":"","sources":["../../src/components/cn.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,EAAE,CAChB,GAAG,MAAM,EAAE,KAAK,CAAC,MAAM,GAAG,KAAK,GAAG,IAAI,GAAG,SAAS,CAAC,GAClD,MAAM,CAER"}

package/dist/components/cn.js

@@ -0,0 +1,9 @@
+/**
+ * Tiny class-name combiner. We intentionally don't depend on `clsx` /
+ * `tailwind-merge` to keep the package's runtime footprint near zero — those
+ * niceties belong in the consumer app.
+ */
+export function cn(...values) {
+    return values.filter(Boolean).join(' ');
+}
+//# sourceMappingURL=cn.js.map

package/dist/components/cn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cn.js","sourceRoot":"","sources":["../../src/components/cn.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,UAAU,EAAE,CAChB,GAAG,MAAgD;IAEnD,OAAO,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC1C,CAAC"}

package/dist/components/index.d.ts

@@ -0,0 +1,11 @@
+export { MessageList } from './MessageList.js';
+export type { MessageListProps, MessageRendererProps } from './MessageList.js';
+export { ChatPanel } from './ChatPanel.js';
+export type { ChatPanelProps } from './ChatPanel.js';
+export { OrchestrationPlanCard } from './OrchestrationPlanCard.js';
+export type { OrchestrationPlanCardProps, OrchestrationStep, OrchestrationStepStatus, } from './OrchestrationPlanCard.js';
+export { ToolCallRenderer } from './ToolCallRenderer.js';
+export type { ToolCallRendererProps } from './ToolCallRenderer.js';
+export { SSEStreamView } from './SSEStreamView.js';
+export type { SSEStreamViewProps } from './SSEStreamView.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,YAAY,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAE/E,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,YAAY,EACV,0BAA0B,EAC1B,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,YAAY,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAEnE,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,YAAY,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/components/index.js

@@ -0,0 +1,6 @@
+export { MessageList } from './MessageList.js';
+export { ChatPanel } from './ChatPanel.js';
+export { OrchestrationPlanCard } from './OrchestrationPlanCard.js';
+export { ToolCallRenderer } from './ToolCallRenderer.js';
+export { SSEStreamView } from './SSEStreamView.js';
+//# sourceMappingURL=index.js.map

package/dist/components/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAG/C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAG3C,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAOnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAGzD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/hooks/index.d.ts

@@ -0,0 +1,7 @@
+export { useChatStream } from './useChatStream.js';
+export type { UseChatStreamOptions, UseChatStreamReturn, ChatStreamTransport, ChatStreamSendInput, } from './useChatStream.js';
+export { useToolCallStatus } from './useToolCallStatus.js';
+export type { ToolCallStatus, UseToolCallStatusOptions, UseToolCallStatusReturn, } from './useToolCallStatus.js';
+export { useAgentSession } from './useAgentSession.js';
+export type { UseAgentSessionOptions, UseAgentSessionReturn, AgentSessionTransport, } from './useAgentSession.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/hooks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,YAAY,EACV,oBAAoB,EACpB,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,YAAY,EACV,cAAc,EACd,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,YAAY,EACV,sBAAsB,EACtB,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,sBAAsB,CAAC"}

package/dist/hooks/index.js

@@ -0,0 +1,4 @@
+export { useChatStream } from './useChatStream.js';
+export { useToolCallStatus } from './useToolCallStatus.js';
+export { useAgentSession } from './useAgentSession.js';
+//# sourceMappingURL=index.js.map

package/dist/hooks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAQnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAO3D,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/hooks/useAgentSession.d.ts

@@ -0,0 +1,56 @@
+/**
+ * `useAgentSession` — light-weight wrapper around the session lifecycle.
+ *
+ * Sessions are created lazily on first message in most production setups, but
+ * the desktop / web clients still need a deterministic handle to fetch /
+ * resume / list. The hook exposes a transport-agnostic API matching the
+ * methods on the framework's storage adapter (`InMemoryStorage`,
+ * `SqlAlchemyStorage`) so consumers can wire any backend.
+ *
+ * Stability contract:
+ *   The hook tolerates inline-object literals for `autoLoad`. We re-run the
+ *   `list` effect only when the **values** in `autoLoad` change, not when the
+ *   object identity changes (otherwise an unmemoised consumer would loop).
+ *   `transport` is held by ref so swapping the implementation mid-session
+ *   doesn't trigger a refetch — call `refresh()` explicitly if you need that.
+ */
+import type { AgentSession } from '@steerable/agent-protocol';
+export interface AgentSessionTransport {
+    create: (input: {
+        chatId: string;
+        userId: string;
+        projectId?: string | null;
+        scenario?: string;
+        stageData?: Record<string, unknown> | null;
+    }) => Promise<AgentSession>;
+    resume: (sessionId: string) => Promise<AgentSession>;
+    list: (filter: {
+        userId?: string;
+        chatId?: string;
+        activeOnly?: boolean;
+    }) => Promise<AgentSession[]>;
+}
+export interface UseAgentSessionOptions {
+    transport: AgentSessionTransport;
+    /** Optional auto-load filter; when set the hook calls `list` on mount. */
+    autoLoad?: {
+        userId?: string;
+        chatId?: string;
+        activeOnly?: boolean;
+    };
+}
+export interface UseAgentSessionReturn {
+    /** Active sessions for the current filter. */
+    sessions: AgentSession[];
+    /** The session created/resumed most recently via this hook. */
+    current: AgentSession | null;
+    isLoading: boolean;
+    error: Error | null;
+    create: AgentSessionTransport['create'];
+    resume: AgentSessionTransport['resume'];
+    refresh: () => Promise<void>;
+    /** Set the current session pointer without re-fetching. */
+    setCurrent: (session: AgentSession | null) => void;
+}
+export declare function useAgentSession(options: UseAgentSessionOptions): UseAgentSessionReturn;
+//# sourceMappingURL=useAgentSession.d.ts.map

package/dist/hooks/useAgentSession.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAgentSession.d.ts","sourceRoot":"","sources":["../../src/hooks/useAgentSession.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AASH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAE9D,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,CAAC,KAAK,EAAE;QACd,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;KAC5C,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;IAC5B,MAAM,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;IACrD,IAAI,EAAE,CAAC,MAAM,EAAE;QACb,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,UAAU,CAAC,EAAE,OAAO,CAAC;KACtB,KAAK,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,qBAAqB,CAAC;IACjC,0EAA0E;IAC1E,QAAQ,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CACvE;AAED,MAAM,WAAW,qBAAqB;IACpC,8CAA8C;IAC9C,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,+DAA+D;IAC/D,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;IAC7B,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,MAAM,EAAE,qBAAqB,CAAC,QAAQ,CAAC,CAAC;IACxC,MAAM,EAAE,qBAAqB,CAAC,QAAQ,CAAC,CAAC;IACxC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,2DAA2D;IAC3D,UAAU,EAAE,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,KAAK,IAAI,CAAC;CACpD;AAcD,wBAAgB,eAAe,CAC7B,OAAO,EAAE,sBAAsB,GAC9B,qBAAqB,CAwGvB"}

package/dist/hooks/useAgentSession.js

@@ -0,0 +1,128 @@
+/**
+ * `useAgentSession` — light-weight wrapper around the session lifecycle.
+ *
+ * Sessions are created lazily on first message in most production setups, but
+ * the desktop / web clients still need a deterministic handle to fetch /
+ * resume / list. The hook exposes a transport-agnostic API matching the
+ * methods on the framework's storage adapter (`InMemoryStorage`,
+ * `SqlAlchemyStorage`) so consumers can wire any backend.
+ *
+ * Stability contract:
+ *   The hook tolerates inline-object literals for `autoLoad`. We re-run the
+ *   `list` effect only when the **values** in `autoLoad` change, not when the
+ *   object identity changes (otherwise an unmemoised consumer would loop).
+ *   `transport` is held by ref so swapping the implementation mid-session
+ *   doesn't trigger a refetch — call `refresh()` explicitly if you need that.
+ */
+import { useCallback, useEffect, useMemo, useRef, useState, } from 'react';
+function autoLoadKey(autoLoad) {
+    if (!autoLoad)
+        return null;
+    // Stable, deterministic key — values are primitives so JSON.stringify is fine.
+    return JSON.stringify({
+        userId: autoLoad.userId ?? null,
+        chatId: autoLoad.chatId ?? null,
+        activeOnly: autoLoad.activeOnly ?? null,
+    });
+}
+export function useAgentSession(options) {
+    const [sessions, setSessions] = useState([]);
+    const [current, setCurrent] = useState(null);
+    const [isLoading, setLoading] = useState(false);
+    const [error, setError] = useState(null);
+    const mountedRef = useRef(true);
+    const transportRef = useRef(options.transport);
+    transportRef.current = options.transport;
+    useEffect(() => {
+        mountedRef.current = true;
+        return () => {
+            mountedRef.current = false;
+        };
+    }, []);
+    const autoLoadKeyVal = autoLoadKey(options.autoLoad);
+    const refresh = useCallback(async () => {
+        if (!options.autoLoad)
+            return;
+        setLoading(true);
+        try {
+            const list = await transportRef.current.list(options.autoLoad);
+            if (mountedRef.current) {
+                setSessions(list);
+                setError(null);
+            }
+        }
+        catch (err) {
+            if (mountedRef.current) {
+                setError(err instanceof Error ? err : new Error(String(err)));
+            }
+        }
+        finally {
+            if (mountedRef.current)
+                setLoading(false);
+        }
+        // We intentionally key on the serialised filter, not the object identity.
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [autoLoadKeyVal]);
+    useEffect(() => {
+        if (autoLoadKeyVal === null)
+            return;
+        void refresh();
+    }, [autoLoadKeyVal, refresh]);
+    const create = useCallback(async (input) => {
+        setLoading(true);
+        try {
+            const session = await transportRef.current.create(input);
+            if (mountedRef.current) {
+                setCurrent(session);
+                setSessions((prev) => [
+                    session,
+                    ...prev.filter((s) => s.sessionId !== session.sessionId),
+                ]);
+                setError(null);
+            }
+            return session;
+        }
+        catch (err) {
+            if (mountedRef.current) {
+                setError(err instanceof Error ? err : new Error(String(err)));
+            }
+            throw err;
+        }
+        finally {
+            if (mountedRef.current)
+                setLoading(false);
+        }
+    }, []);
+    const resume = useCallback(async (sessionId) => {
+        setLoading(true);
+        try {
+            const session = await transportRef.current.resume(sessionId);
+            if (mountedRef.current) {
+                setCurrent(session);
+                setError(null);
+            }
+            return session;
+        }
+        catch (err) {
+            if (mountedRef.current) {
+                setError(err instanceof Error ? err : new Error(String(err)));
+            }
+            throw err;
+        }
+        finally {
+            if (mountedRef.current)
+                setLoading(false);
+        }
+    }, []);
+    return useMemo(() => ({
+        sessions,
+        current,
+        isLoading,
+        error,
+        create,
+        resume,
+        refresh,
+        setCurrent,
+    }), [sessions, current, isLoading, error, create, resume, refresh]);
+}
+//# sourceMappingURL=useAgentSession.js.map

package/dist/hooks/useAgentSession.js.map

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

package/dist/hooks/useChatStream.d.ts

@@ -0,0 +1,59 @@
+/**
+ * `useChatStream` — own the in-flight chat lifecycle.
+ *
+ * Caller plugs in a transport (fetch+SSE, IPC bridge, sidecar, …) that yields
+ * `SSEEvent` instances; the hook turns those into the local `ChatMessage[]`
+ * that `<MessageList>` and `<ChatPanel>` render. The hook is intentionally
+ * unaware of HTTP, of which provider serves the events, and of any specific
+ * sequencing rules — those live in the framework spec and the caller's
+ * transport.
+ */
+import type { ChatMessage, SSEEvent, ToolResult } from '@steerable/agent-protocol';
+export interface ChatStreamSendInput {
+    /** The user's free-text message. */
+    content: string;
+    /** Optional structured metadata (mention list, tools requested, etc.). */
+    metadata?: Record<string, unknown>;
+}
+export interface ChatStreamTransport {
+    /**
+     * Called when the user submits a message. The transport is expected to:
+     *   1. POST/IPC the message to the backend,
+     *   2. consume the SSE stream and call `onEvent` for each parsed event,
+     *   3. resolve when the stream terminates (or reject on error).
+     *
+     * Returning a function from the promise is a `cancel` handle the hook will
+     * call on unmount or when the user clicks "stop".
+     */
+    stream: (input: ChatStreamSendInput, onEvent: (event: SSEEvent) => void) => Promise<void | (() => void)>;
+}
+export interface UseChatStreamOptions {
+    /** Required transport handle; see `ChatStreamTransport`. */
+    transport: ChatStreamTransport;
+    /** Initial message history (persisted from previous turns). */
+    initialMessages?: ChatMessage[];
+    /**
+     * Map a tool-result event to a standalone `tool` ChatMessage. Default
+     * returns null, which keeps tool results inline on the assistant message
+     * that owns the corresponding call.
+     */
+    toolResultToMessage?: (result: ToolResult) => ChatMessage | null;
+    /**
+     * Called for every event that doesn't have a built-in handler — useful for
+     * `loader-hint`, `agent`, `orchestration`, automation, search-source, etc.
+     * Receivers can stash these into their own state.
+     */
+    onUnknownEvent?: (event: SSEEvent) => void;
+}
+export interface UseChatStreamReturn {
+    messages: ChatMessage[];
+    isStreaming: boolean;
+    sendUserMessage: (input: ChatStreamSendInput) => Promise<void>;
+    cancel: () => void;
+    /** Replace the message buffer (e.g. when switching chat). */
+    setMessages: (messages: ChatMessage[]) => void;
+    /** Append a single message without going through the transport. */
+    appendMessage: (message: ChatMessage) => void;
+}
+export declare function useChatStream(options: UseChatStreamOptions): UseChatStreamReturn;
+//# sourceMappingURL=useChatStream.d.ts.map

package/dist/hooks/useChatStream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useChatStream.d.ts","sourceRoot":"","sources":["../../src/hooks/useChatStream.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EACV,WAAW,EACX,QAAQ,EAER,UAAU,EACX,MAAM,2BAA2B,CAAC;AAEnC,MAAM,WAAW,mBAAmB;IAClC,oCAAoC;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,mBAAmB;IAClC;;;;;;;;OAQG;IACH,MAAM,EAAE,CACN,KAAK,EAAE,mBAAmB,EAC1B,OAAO,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,KAC/B,OAAO,CAAC,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,oBAAoB;IACnC,4DAA4D;IAC5D,SAAS,EAAE,mBAAmB,CAAC;IAC/B,+DAA+D;IAC/D,eAAe,CAAC,EAAE,WAAW,EAAE,CAAC;IAChC;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,WAAW,GAAG,IAAI,CAAC;IACjE;;;;OAIG;IACH,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAC;CAC5C;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,WAAW,EAAE,OAAO,CAAC;IACrB,eAAe,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/D,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,6DAA6D;IAC7D,WAAW,EAAE,CAAC,QAAQ,EAAE,WAAW,EAAE,KAAK,IAAI,CAAC;IAC/C,mEAAmE;IACnE,aAAa,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,CAAC;CAC/C;AAsID,wBAAgB,aAAa,CAC3B,OAAO,EAAE,oBAAoB,GAC5B,mBAAmB,CAsIrB"}