use-agentenkit 0.1.0

package/dist/format.js

@@ -0,0 +1,101 @@
+const json = (value) => {
+    try {
+        return JSON.stringify(value);
+    }
+    catch {
+        return String(value);
+    }
+};
+/** Flatten AI-SDK message content into something a bubble can render. */
+export function contentToText(content, format) {
+    if (typeof content === 'string')
+        return content;
+    if (!Array.isArray(content))
+        return json(content);
+    return content
+        .map((part) => {
+        if (part?.type === 'text')
+            return part.text ?? '';
+        // Reasoning is deliberately NOT folded in here — `messageToEntries`
+        // lifts it into its own entry so the answer stays clean.
+        if (part?.type === 'tool-call') {
+            return format.toolCall(part.toolName ?? 'tool', part.args ?? {});
+        }
+        if (part?.type === 'tool-result')
+            return format.toolResult(undefined, part.result);
+        return '';
+    })
+        .filter(Boolean)
+        .join('\n');
+}
+/** One durable message → one entry, or null when it carries nothing to show.
+ *  A message that is only tool activity is marked `kind: 'tool'` so a UI can
+ *  style it apart from conversation. */
+export function messageToEntry(message, format) {
+    const text = contentToText(message.content, format);
+    if (!text)
+        return null;
+    const parts = Array.isArray(message.content) ? message.content : [];
+    const containsText = parts.some((part) => part?.type === 'text' && part.text);
+    const containsToolActivity = parts.some((part) => part?.type === 'tool-call' || part?.type === 'tool-result');
+    return {
+        id: message.id,
+        kind: message.role === 'tool' ||
+            message.role === 'system' ||
+            (containsToolActivity && !containsText)
+            ? 'tool'
+            : 'text',
+        role: message.role,
+        text,
+        agentId: message.agentId ?? null,
+    };
+}
+/** The model's thinking, as persisted on a message. Providers that do not
+ *  expose it simply have no such parts, and this returns ''. */
+export function reasoningText(content) {
+    if (!Array.isArray(content))
+        return '';
+    return content
+        .filter((part) => part?.type === 'reasoning')
+        .map((part) => part?.text ?? part?.reasoning ?? '')
+        .join('');
+}
+/** One durable message → the entries it renders as: its thinking first, then
+ *  the answer. Split because they stream separately and a UI folds thinking
+ *  away, so keeping them in one bubble would make a reload look different from
+ *  the live run. */
+export function messageToEntries(message, format) {
+    const out = [];
+    const thought = reasoningText(message.content);
+    if (thought) {
+        out.push({
+            id: `${message.id}:reasoning`,
+            kind: 'reasoning',
+            role: message.role,
+            text: thought,
+            agentId: message.agentId ?? null,
+        });
+    }
+    const entry = messageToEntry(message, format);
+    if (entry)
+        out.push(entry);
+    return out;
+}
+/** The activity a thread state implies when nothing more specific is happening. */
+export function stateActivity(state, labels) {
+    switch (state) {
+        case 'RUNNING':
+            return { phase: 'thinking', label: labels.thinking };
+        case 'WAITING_FOR_INPUT':
+            return { phase: 'waiting-input', label: labels.waitingApproval };
+        case 'COMPLETED':
+            return { phase: 'completed', label: labels.completed };
+        case 'CANCELLED':
+            return { phase: 'stopped', label: labels.stopped };
+        case 'FAILED':
+            return { phase: 'failed', label: labels.failed };
+        default:
+            return { phase: 'idle', label: labels.idle };
+    }
+}
+//# sourceMappingURL=format.js.map

package/dist/format.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export { useAgentThread } from './useAgentThread.js';
+export type { UseAgentThread, UseAgentThreadOptions, RunOptions } from './useAgentThread.js';
+export { AgentRunProvider } from './provider.js';
+export type { AgentRunProviderProps } from './provider.js';
+export { useAgentRunConfig, mergeConfig } from './context.js';
+export { defaultRoutes, defaultLabels, defaultFormat, browserPersistence, browserEventStream, resolveConfig, withQuery, routeUrl, } from './config.js';
+export type { AgentRunConfig, ResolvedConfig, AgentRoutes, Route, ActivityLabels, EntryFormat, ThreadPersistence, FetchLike, OpenStream, StreamHandlers, StreamSubscription, } from './config.js';
+export { contentToText, messageToEntry, messageToEntries, reasoningText, stateActivity, } from './format.js';
+export type { AgentState, AgentActivity, ActivityPhase, ChatEntry, MessageRole, PendingInput, RunResult, SnapshotMessage, SnapshotRun, StreamEvent, SubagentStatus, SubagentView, ThreadListItem, ThreadSnapshot, ThreadUsage, UsageTotals, ContextUsage, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,YAAY,EAAE,cAAc,EAAE,qBAAqB,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAE7F,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,YAAY,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE9D,OAAO,EACL,aAAa,EACb,aAAa,EACb,aAAa,EACb,kBAAkB,EAClB,kBAAkB,EAClB,aAAa,EACb,SAAS,EACT,QAAQ,GACT,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,cAAc,EACd,cAAc,EACd,WAAW,EACX,KAAK,EACL,cAAc,EACd,WAAW,EACX,iBAAiB,EACjB,SAAS,EACT,UAAU,EACV,cAAc,EACd,kBAAkB,GACnB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,aAAa,EACb,aAAa,GACd,MAAM,aAAa,CAAC;AAErB,YAAY,EACV,UAAU,EACV,aAAa,EACb,aAAa,EACb,SAAS,EACT,WAAW,EACX,YAAY,EACZ,SAAS,EACT,eAAe,EACf,WAAW,EACX,WAAW,EACX,cAAc,EACd,YAAY,EACZ,cAAc,EACd,cAAc,EACd,WAAW,EACX,WAAW,EACX,YAAY,GACb,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+export { useAgentThread } from './useAgentThread.js';
+export { AgentRunProvider } from './provider.js';
+export { useAgentRunConfig, mergeConfig } from './context.js';
+export { defaultRoutes, defaultLabels, defaultFormat, browserPersistence, browserEventStream, resolveConfig, withQuery, routeUrl, } from './config.js';
+export { contentToText, messageToEntry, messageToEntries, reasoningText, stateActivity, } from './format.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAGrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEjD,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE9D,OAAO,EACL,aAAa,EACb,aAAa,EACb,aAAa,EACb,kBAAkB,EAClB,kBAAkB,EAClB,aAAa,EACb,SAAS,EACT,QAAQ,GACT,MAAM,aAAa,CAAC;AAerB,OAAO,EACL,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,aAAa,EACb,aAAa,GACd,MAAM,aAAa,CAAC"}

package/dist/provider.d.ts

@@ -0,0 +1,12 @@
+import type { ReactNode } from 'react';
+import type { AgentRunConfig } from './config.js';
+export interface AgentRunProviderProps {
+    /** Applied to every `useAgentThread` below it. A hook's own options still
+     *  win, section by section. */
+    config?: AgentRunConfig;
+    children: ReactNode;
+}
+/** Set the routes, labels and transport once for the whole app instead of at
+ *  every call site. */
+export declare function AgentRunProvider({ config, children }: AgentRunProviderProps): import("react").JSX.Element;
+//# sourceMappingURL=provider.d.ts.map

package/dist/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,MAAM,WAAW,qBAAqB;IACpC;mCAC+B;IAC/B,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED;uBACuB;AACvB,wBAAgB,gBAAgB,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,qBAAqB,+BAE3E"}

package/dist/provider.js

@@ -0,0 +1,9 @@
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+import { AgentRunContext } from './context.js';
+/** Set the routes, labels and transport once for the whole app instead of at
+ *  every call site. */
+export function AgentRunProvider({ config, children }) {
+    return _jsx(AgentRunContext.Provider, { value: config ?? null, children: children });
+}
+//# sourceMappingURL=provider.js.map

package/dist/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../src/provider.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAGb,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAU/C;uBACuB;AACvB,MAAM,UAAU,gBAAgB,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAyB;IAC1E,OAAO,KAAC,eAAe,CAAC,QAAQ,IAAC,KAAK,EAAE,MAAM,IAAI,IAAI,YAAG,QAAQ,GAA4B,CAAC;AAChG,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,101 @@
+/** The shapes a UI renders. Nothing here knows how the data arrived — the
+ *  transport lives in `config.ts`, so an app can move every endpoint without
+ *  touching a component. */
+export type AgentState = 'IDLE' | 'RUNNING' | 'WAITING_FOR_INPUT' | 'CANCELLED' | 'COMPLETED' | 'FAILED';
+export type MessageRole = 'user' | 'assistant' | 'system' | 'tool';
+export interface ChatEntry {
+    id: string;
+    /** `reasoning` is the model's thinking, which arrives as its own stream and
+     *  is kept apart from the answer so a UI can fold it away. */
+    kind: 'text' | 'tool' | 'reasoning';
+    role: MessageRole;
+    text: string;
+    agentId?: string | null;
+}
+export type ActivityPhase = 'idle' | 'loading' | 'thinking' | 'responding' | 'tool-call' | 'tool-result' | 'waiting-input' | 'completed' | 'stopped' | 'failed';
+export interface AgentActivity {
+    phase: ActivityPhase;
+    label: string;
+    detail?: string;
+}
+export type SubagentStatus = 'RUNNING' | 'WAITING_FOR_INPUT' | 'COMPLETED' | 'FAILED' | 'CANCELLED';
+export interface SubagentView {
+    agentId: string;
+    name: string;
+    /** 1 = spawned by the main agent; deeper runs nest further. */
+    depth: number;
+    status: SubagentStatus;
+    text: string;
+    /** Why it died — SUBAGENT_FAILED carries the reason. */
+    error?: string;
+}
+export interface UsageTotals {
+    inputTokens: number;
+    cachedInputTokens: number;
+    outputTokens: number;
+    totalTokens: number;
+}
+export interface ContextUsage {
+    usedTokens: number;
+    budgetTokens: number;
+    compactAtTokens: number;
+    messages: number;
+}
+export interface ThreadUsage {
+    tokens: UsageTotals;
+    context: ContextUsage;
+    model: string;
+}
+export interface PendingInput {
+    toolCallId: string;
+    toolName: string;
+    /** The stream that asked — null when the main agent did. */
+    agentId?: string | null;
+    /** The nested run's own name and depth, straight off the park, so a card can
+     *  say "mailer" rather than an opaque id. */
+    agentName?: string;
+    depth?: number;
+    arguments: unknown;
+}
+export interface ThreadListItem {
+    id: string;
+    title: string;
+    state: AgentState;
+    model: string;
+    updatedAt: string;
+}
+export interface SnapshotMessage {
+    id: string;
+    role: MessageRole;
+    content: unknown;
+    agentId?: string | null;
+}
+export interface StreamEvent {
+    seq: number;
+    type: string;
+    payload: any;
+}
+export interface SnapshotRun {
+    id: string;
+    agent: string;
+    /** 0 is the dispatched run itself; nested runs are 1+. */
+    depth: number;
+    state: SubagentStatus;
+}
+export interface ThreadSnapshot {
+    thread: {
+        id: string;
+        state: AgentState;
+    };
+    messages: SnapshotMessage[];
+    runs: SnapshotRun[];
+    lastEventSeq: number;
+    activeEvents: StreamEvent[];
+}
+export interface RunResult {
+    accepted: boolean;
+    threadId?: string;
+    runId?: string;
+    error?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,5 @@
+/** The shapes a UI renders. Nothing here knows how the data arrived — the
+ *  transport lives in `config.ts`, so an app can move every endpoint without
+ *  touching a component. */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;4BAE4B"}

package/dist/useAgentThread.d.ts

@@ -0,0 +1,42 @@
+import { withQuery, type AgentRunConfig } from './config.js';
+import type { AgentActivity, AgentState, ChatEntry, PendingInput, RunResult, SubagentView, ThreadListItem, ThreadUsage } from './types.js';
+export interface UseAgentThreadOptions extends AgentRunConfig {
+    /** Open this thread instead of whatever persistence remembers. */
+    initialThreadId?: string;
+}
+export interface UseAgentThread {
+    threadId: string | undefined;
+    entries: ChatEntry[];
+    agentState: AgentState;
+    activity: AgentActivity;
+    historyLoading: boolean;
+    pendingInputs: PendingInput[];
+    subagents: SubagentView[];
+    threads: ThreadListItem[];
+    threadsLoading: boolean;
+    usage: ThreadUsage | null;
+    loadThreads: () => Promise<void>;
+    loadUsage: (threadId?: string) => Promise<void>;
+    newThread: () => void;
+    selectThread: (threadId: string) => void;
+    deleteThread: (threadId: string) => Promise<boolean>;
+    run: (prompt: string, options?: RunOptions) => Promise<RunResult>;
+    stop: () => Promise<void>;
+    respondToInput: (toolCallId: string, approved: boolean, payload?: unknown) => Promise<void>;
+}
+export interface RunOptions {
+    model?: string;
+    /** Replace this user turn and everything it led to, then answer again. */
+    editMessageId?: string;
+    /** Anything else the run route accepts — merged into the request body. */
+    [key: string]: unknown;
+}
+/** Hydrates durable messages first, then resumes the canonical event stream at
+ *  the snapshot cursor, so a reload — or a second tab — rebuilds the same
+ *  conversation with the server as the only source of truth.
+ *
+ *  Every endpoint, label and formatter is replaceable through the options or a
+ *  surrounding provider; see `AgentRunConfig`. */
+export declare function useAgentThread(options?: UseAgentThreadOptions): UseAgentThread;
+export { withQuery };
+//# sourceMappingURL=useAgentThread.d.ts.map

package/dist/useAgentThread.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAgentThread.d.ts","sourceRoot":"","sources":["../src/useAgentThread.ts"],"names":[],"mappings":"AAGA,OAAO,EAGL,SAAS,EACT,KAAK,cAAc,EAEpB,MAAM,aAAa,CAAC;AAGrB,OAAO,KAAK,EACV,aAAa,EACb,UAAU,EACV,SAAS,EAET,YAAY,EACZ,SAAS,EAGT,YAAY,EACZ,cAAc,EAEd,WAAW,EACZ,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,qBAAsB,SAAQ,cAAc;IAC3D,kEAAkE;IAClE,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,UAAU,EAAE,UAAU,CAAC;IACvB,QAAQ,EAAE,aAAa,CAAC;IACxB,cAAc,EAAE,OAAO,CAAC;IACxB,aAAa,EAAE,YAAY,EAAE,CAAC;IAC9B,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,cAAc,EAAE,OAAO,CAAC;IACxB,KAAK,EAAE,WAAW,GAAG,IAAI,CAAC;IAC1B,WAAW,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,SAAS,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,YAAY,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC,YAAY,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACrD,GAAG,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;IAClE,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,cAAc,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7F;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0EAA0E;IAC1E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,0EAA0E;IAC1E,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;;;kDAKkD;AAClD,wBAAgB,cAAc,CAAC,OAAO,GAAE,qBAA0B,GAAG,cAAc,CA6mBlF;AAED,OAAO,EAAE,SAAS,EAAE,CAAC"}