@rudderjs/ai 1.17.3 → 1.18.1

package/dist/queue-job.js

@@ -1,185 +0,0 @@
-/**
- * Queued AI prompt builder.
- * Created via `agent.queue('prompt')`.
- *
- * @example
- * await agent.queue('Analyze this report')
- *   .onQueue('ai')
- *   .then(response => console.log(response.text))
- *   .catch(err => console.error(err))
- *   .send()
- *
- * @example  Broadcast progress to a channel as the job runs
- * await new SupportAgent()
- *   .queue('Help with refund request')
- *   .broadcast(`user.${userId}.support`)
- *   .send()
- *
- * // Subscribers on `user.${userId}.support` receive:
- * //   { event: 'chunk', data: <StreamChunk> }   // one per stream chunk
- * //   { event: 'done',  data: <AgentResponse> } // final result
- * //   { event: 'error', data: { message } }     // on failure
- */
-export class QueuedPromptBuilder {
-    agentRef;
-    input;
-    options;
-    _queue = 'default';
-    _delay = 0;
-    _thenFn;
-    _catchFn;
-    _broadcastChannel;
-    _broadcastEventPrefix = '';
-    constructor(agentRef, input, options) {
-        this.agentRef = agentRef;
-        this.input = input;
-        this.options = options;
-    }
-    /** Set the queue name */
-    onQueue(name) {
-        this._queue = name;
-        return this;
-    }
-    /** Set a delay before the job runs */
-    delay(ms) {
-        this._delay = ms;
-        return this;
-    }
-    /** Callback when the prompt succeeds */
-    then(fn) {
-        this._thenFn = fn;
-        return this;
-    }
-    /** Callback when the prompt fails */
-    catch(fn) {
-        this._catchFn = fn;
-        return this;
-    }
-    /**
-     * Stream the agent's progress to a broadcast channel as the job runs.
-     *
-     * When set, the queued job uses `agent.stream()` instead of `prompt()` and
-     * pushes each chunk to `channel` via `@rudderjs/broadcast`. Events:
-     *
-     *   - `chunk` (per `StreamChunk` from the agent)
-     *   - `done`  (the final `AgentResponse`)
-     *   - `error` (`{ message }` if the run fails)
-     *
-     * Requires `@rudderjs/broadcast` installed and its WS server running in the
-     * worker process. In the typical Rudder dev setup (single process running
-     * both web + queue:work) this works out of the box. If your queue worker is
-     * a separate process from the broadcast WS server, you'll need a pub/sub
-     * bridge (Redis, Reverb, etc.) — outside the scope of v1.
-     */
-    broadcast(channel, opts = {}) {
-        this._broadcastChannel = channel;
-        if (opts.eventPrefix !== undefined)
-            this._broadcastEventPrefix = opts.eventPrefix;
-        return this;
-    }
-    /** Dispatch the job to the queue */
-    async send() {
-        const dispatchFn = await loadDispatch();
-        const agentRef = this.agentRef;
-        const input = this.input;
-        const promptOptions = this.options;
-        const thenFn = this._thenFn;
-        const catchFn = this._catchFn;
-        const broadcastChannel = this._broadcastChannel;
-        const eventPrefix = this._broadcastEventPrefix;
-        await dispatchFn(async () => {
-            try {
-                const response = broadcastChannel !== undefined
-                    ? await runStreamingAndBroadcast(agentRef, input, promptOptions, broadcastChannel, eventPrefix)
-                    : await agentRef.prompt(input, promptOptions);
-                if (thenFn)
-                    await thenFn(response);
-            }
-            catch (error) {
-                if (broadcastChannel !== undefined) {
-                    await safeBroadcast(broadcastChannel, eventPrefix + 'error', {
-                        message: error instanceof Error ? error.message : String(error),
-                    });
-                }
-                if (catchFn) {
-                    await catchFn(error);
-                }
-                else {
-                    throw error;
-                }
-            }
-        }, {
-            queue: this._queue,
-            delay: this._delay,
-        });
-    }
-}
-let _dispatchLoader = defaultLoadDispatch;
-let _broadcastLoader = defaultLoadBroadcast;
-async function loadDispatch() { return _dispatchLoader(); }
-async function loadBroadcast() { return _broadcastLoader(); }
-async function defaultLoadDispatch() {
-    try {
-        const specifier = '@rudderjs/queue';
-        const mod = await import(/* @vite-ignore */ specifier);
-        return mod['dispatch'];
-    }
-    catch {
-        throw new Error('[Rudder AI] @rudderjs/queue is required for agent.queue(). Install it: pnpm add @rudderjs/queue');
-    }
-}
-async function defaultLoadBroadcast() {
-    try {
-        const specifier = '@rudderjs/broadcast';
-        const mod = await import(/* @vite-ignore */ specifier);
-        const fn = mod['broadcast'];
-        return typeof fn === 'function' ? fn : null;
-    }
-    catch {
-        return null;
-    }
-}
-/**
- * Test-only seam — swap the dispatch + broadcast loaders for fakes so tests can
- * exercise the queued-job flow without booting Queue / Broadcast providers.
- *
- * The `_` prefix and explicit `ForTests` suffix are deliberate: these hooks
- * exist for `src/queue-job.test.ts`, not for app code. Production callers
- * should never import these.
- */
-export function _setQueueJobLoadersForTests(opts) {
-    const prevDispatch = _dispatchLoader;
-    const prevBroadcast = _broadcastLoader;
-    if (opts.dispatch)
-        _dispatchLoader = opts.dispatch;
-    if (opts.broadcast)
-        _broadcastLoader = opts.broadcast;
-    return () => {
-        _dispatchLoader = prevDispatch;
-        _broadcastLoader = prevBroadcast;
-    };
-}
-async function runStreamingAndBroadcast(agentRef, input, options, channel, eventPrefix) {
-    const broadcastFn = await loadBroadcast();
-    if (broadcastFn === null) {
-        throw new Error('[Rudder AI] @rudderjs/broadcast is required for .broadcast(). Install it: pnpm add @rudderjs/broadcast');
-    }
-    if (typeof agentRef.stream !== 'function') {
-        throw new Error('[Rudder AI] .broadcast() requires an agent with .stream(); the wrapper passed to QueuedPromptBuilder is missing it.');
-    }
-    const { stream, response } = agentRef.stream(input, options);
-    for await (const chunk of stream) {
-        await broadcastFn(channel, eventPrefix + 'chunk', chunk);
-    }
-    const final = await response;
-    await broadcastFn(channel, eventPrefix + 'done', final);
-    return final;
-}
-async function safeBroadcast(channel, event, data) {
-    try {
-        const broadcastFn = await loadBroadcast();
-        await broadcastFn?.(channel, event, data);
-    }
-    catch { /* best-effort — don't let broadcast errors mask the original failure */ }
-}
-//# sourceMappingURL=queue-job.js.map

package/dist/queue-job.js.map

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

package/dist/react/agent-run.d.ts

@@ -1,111 +0,0 @@
-/**
- * Framework-free core of the `useAgentRun` React hook.
- *
- * The React hook (`useAgentRun.ts`) is a thin wrapper around the pieces here —
- * same posture as `@rudderjs/sync`'s `CollabRoomManager` vs `useCollabRoom`:
- * keeping the state machine and the stream-driving loop out of React lets us
- * exhaustively unit-test the client-tool round-trip and the approval resume
- * without a React testing harness (the framework intentionally ships none).
- *
- * Builds on the named-event agent-SSE protocol in `../agent-sse.ts`
- * (`readAgentStream` + the `AgentStreamTurn` it accumulates). No `react` and no
- * `node:` imports — safe in any `fetch`-capable runtime.
- */
-import type { AgentStreamCallbacks, AgentStreamTurn } from '../agent-sse.js';
-import type { ToolCall } from '../types.js';
-/** One renderable entry in a run's transcript, in arrival order. */
-export type AgentRunOutput = {
-    type: 'text';
-    text: string;
-} | {
-    type: 'tool_call';
-    id?: string;
-    tool: string;
-    input?: Record<string, unknown>;
-} | {
-    type: 'tool_update';
-    id?: string;
-    tool?: string;
-    update: unknown;
-} | {
-    type: 'tool_result';
-    id?: string;
-    tool?: string;
-    content: string;
-} | {
-    type: 'approval_request';
-    toolCall: ToolCall;
-    isClientTool: boolean;
-} | {
-    type: 'handoff';
-    from: string;
-    to: string;
-    message?: string;
-} | {
-    type: 'error';
-    message: string;
-};
-/**
- * Append one decoded SSE event to the output transcript, returning a NEW array
- * (so a React consumer can use it as immutable state). Consecutive `text`
- * deltas coalesce into the trailing text entry so streamed text renders as one
- * growing block. `complete` and `pending_client_tools` produce no transcript
- * entry — they drive run status / pending-action state instead.
- */
-export declare function appendAgentOutput(outputs: AgentRunOutput[], event: string, data: unknown): AgentRunOutput[];
-/** A client-executed tool result, keyed to its originating tool call. */
-export interface AgentToolResult {
-    toolCallId: string;
-    result: unknown;
-}
-/**
- * Run each pending client-tool call through the resolver, in order, collecting
- * results keyed by `toolCallId`. A resolver that throws yields an
- * `{ error }` result rather than aborting the batch — the model sees the
- * failure as that tool's result and can recover, matching the server-side
- * tool-error posture.
- */
-export declare function executeClientTools(calls: ToolCall[], resolver: (call: ToolCall) => unknown | Promise<unknown>): Promise<AgentToolResult[]>;
-/**
- * The intent the consumer's `request` function turns into an SSE `Response`.
- * The hook owns the run/resume state machine; the app owns the endpoint and
- * the request body shape (only the app's route knows how to reconstruct the
- * server-side message history), so the driver hands it a typed intent and
- * expects a streaming `Response` back.
- */
-export type AgentRunRequest<TInput = unknown> = {
-    type: 'run';
-    input: TInput;
-} | {
-    type: 'resume';
-    /** The accumulated turn the resume continues from. */
-    turn: AgentStreamTurn;
-    /** Results from client-tool calls executed in the browser. */
-    clientToolResults: AgentToolResult[];
-    /** Tool-call ids the user approved. */
-    approved: string[];
-    /** Tool-call ids the user rejected. */
-    rejected: string[];
-};
-export interface AgentRunDriverOptions<TInput = unknown> {
-    /** Turn a run/resume intent into the streaming SSE `Response`. */
-    request: (req: AgentRunRequest<TInput>, signal: AbortSignal) => Promise<Response>;
-    /**
-     * Optional client-tool resolver. When provided, a run that pauses awaiting
-     * client tools auto-executes them and resumes — no manual `respond`. Omit it
-     * to surface the pending calls and resume by hand.
-     */
-    clientTools?: (call: ToolCall) => unknown | Promise<unknown>;
-    /** Forwarded to `readAgentStream` so the consumer sees events as they arrive. */
-    callbacks?: AgentStreamCallbacks;
-    signal: AbortSignal;
-}
-/**
- * Drive one logical agent run to a settling point: stream the response,
- * accumulate the turn, and — when a client-tool resolver is configured —
- * auto-resume across client-tool pauses until the run completes or parks on an
- * approval gate / manual client-tool round-trip. Returns the final
- * {@link AgentStreamTurn}. Framework-free; the hook wires `callbacks` to state.
- */
-export declare function driveAgentRun<TInput = unknown>(initial: AgentRunRequest<TInput>, opts: AgentRunDriverOptions<TInput>): Promise<AgentStreamTurn>;
-//# sourceMappingURL=agent-run.d.ts.map

package/dist/react/agent-run.d.ts.map

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

package/dist/react/agent-run.js

@@ -1,107 +0,0 @@
-/**
- * Framework-free core of the `useAgentRun` React hook.
- *
- * The React hook (`useAgentRun.ts`) is a thin wrapper around the pieces here —
- * same posture as `@rudderjs/sync`'s `CollabRoomManager` vs `useCollabRoom`:
- * keeping the state machine and the stream-driving loop out of React lets us
- * exhaustively unit-test the client-tool round-trip and the approval resume
- * without a React testing harness (the framework intentionally ships none).
- *
- * Builds on the named-event agent-SSE protocol in `../agent-sse.ts`
- * (`readAgentStream` + the `AgentStreamTurn` it accumulates). No `react` and no
- * `node:` imports — safe in any `fetch`-capable runtime.
- */
-import { readAgentStream } from '../agent-sse.js';
-/**
- * Append one decoded SSE event to the output transcript, returning a NEW array
- * (so a React consumer can use it as immutable state). Consecutive `text`
- * deltas coalesce into the trailing text entry so streamed text renders as one
- * growing block. `complete` and `pending_client_tools` produce no transcript
- * entry — they drive run status / pending-action state instead.
- */
-export function appendAgentOutput(outputs, event, data) {
-    switch (event) {
-        case 'text': {
-            const text = data.text ?? '';
-            if (!text)
-                return outputs;
-            const last = outputs[outputs.length - 1];
-            if (last && last.type === 'text') {
-                return [...outputs.slice(0, -1), { type: 'text', text: last.text + text }];
-            }
-            return [...outputs, { type: 'text', text }];
-        }
-        case 'tool_call': {
-            const d = data;
-            return [...outputs, { type: 'tool_call', ...(d.id ? { id: d.id } : {}), tool: d.tool, ...(d.input ? { input: d.input } : {}) }];
-        }
-        case 'tool_update': {
-            const d = data;
-            return [...outputs, { type: 'tool_update', ...(d.id ? { id: d.id } : {}), ...(d.tool ? { tool: d.tool } : {}), update: d.update }];
-        }
-        case 'tool_result': {
-            const d = data;
-            const id = d.toolCallId ?? d.id;
-            return [...outputs, { type: 'tool_result', ...(id ? { id } : {}), ...(d.tool ? { tool: d.tool } : {}), content: d.content }];
-        }
-        case 'tool_approval_required': {
-            const d = data;
-            return [...outputs, { type: 'approval_request', toolCall: d.toolCall, isClientTool: d.isClientTool }];
-        }
-        case 'handoff': {
-            const d = data;
-            return [...outputs, { type: 'handoff', from: d.from, to: d.to, ...(d.message ? { message: d.message } : {}) }];
-        }
-        case 'error': {
-            const d = data;
-            return [...outputs, { type: 'error', message: d.message ?? 'Unknown error' }];
-        }
-        default:
-            return outputs;
-    }
-}
-/**
- * Run each pending client-tool call through the resolver, in order, collecting
- * results keyed by `toolCallId`. A resolver that throws yields an
- * `{ error }` result rather than aborting the batch — the model sees the
- * failure as that tool's result and can recover, matching the server-side
- * tool-error posture.
- */
-export async function executeClientTools(calls, resolver) {
-    const results = [];
-    for (const call of calls) {
-        try {
-            results.push({ toolCallId: call.id, result: await resolver(call) });
-        }
-        catch (err) {
-            results.push({ toolCallId: call.id, result: { error: err instanceof Error ? err.message : String(err) } });
-        }
-    }
-    return results;
-}
-/**
- * Drive one logical agent run to a settling point: stream the response,
- * accumulate the turn, and — when a client-tool resolver is configured —
- * auto-resume across client-tool pauses until the run completes or parks on an
- * approval gate / manual client-tool round-trip. Returns the final
- * {@link AgentStreamTurn}. Framework-free; the hook wires `callbacks` to state.
- */
-export async function driveAgentRun(initial, opts) {
-    let req = initial;
-    for (;;) {
-        const resp = await opts.request(req, opts.signal);
-        if (!resp.ok) {
-            throw new Error(`Agent stream request failed with status ${resp.status}.`);
-        }
-        const turn = await readAgentStream(resp, opts.callbacks);
-        // Auto-resume only across client-tool pauses, and only with a resolver.
-        // Approval pauses always park for an explicit approve/reject decision.
-        if (turn.awaiting === 'client_tools' && opts.clientTools && turn.pendingClientTools.length > 0) {
-            const clientToolResults = await executeClientTools(turn.pendingClientTools, opts.clientTools);
-            req = { type: 'resume', turn, clientToolResults, approved: [], rejected: [] };
-            continue;
-        }
-        return turn;
-    }
-}
-//# sourceMappingURL=agent-run.js.map

package/dist/react/agent-run.js.map

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

package/dist/react/useAgentRun.d.ts

@@ -1,68 +0,0 @@
-import type { AgentSseApprovalPayload, AgentSseCompletePayload } from '../agent-sse.js';
-import type { ToolCall } from '../types.js';
-import { type AgentRunOutput, type AgentRunRequest, type AgentToolResult } from './agent-run.js';
-/**
- * Run status. While the run is paused awaiting client tools (no resolver) or an
- * approval decision, status stays `'running'` and `pendingClientTools` /
- * `pendingApproval` are populated — the UI renders the prompt and calls
- * `respond` / `approve` / `reject` to continue the same logical run.
- */
-export type AgentRunStatus = 'idle' | 'running' | 'complete' | 'error';
-export interface UseAgentRunOptions<TInput = unknown> {
-    /**
-     * Turn a run/resume intent into the streaming SSE `Response`. The app owns
-     * the endpoint and request-body shape (only its route can reconstruct the
-     * server-side message history); typically `fetch(endpoint, { ..., signal })`.
-     */
-    request: (req: AgentRunRequest<TInput>, signal: AbortSignal) => Promise<Response>;
-    /**
-     * Optional client-tool resolver. When set, a run that pauses awaiting client
-     * tools auto-executes them and resumes; omit it to surface
-     * `pendingClientTools` and resume manually via `respond`.
-     */
-    clientTools?: (call: ToolCall) => unknown | Promise<unknown>;
-    onComplete?: (data: AgentSseCompletePayload) => void;
-    onError?: (message: string) => void;
-    /** Fired for any SSE event outside the standard protocol vocabulary (e.g. a
-     *  server-issued `run_started` carrying a correlation `runId`). Forwarded
-     *  directly to `readAgentStream`'s `onAppEvent` callback. */
-    onAppEvent?: (event: string, data: unknown) => void;
-}
-export interface UseAgentRunResult<TInput = unknown> {
-    status: AgentRunStatus;
-    /** Renderable transcript, accumulated across the run and every resume. */
-    outputs: AgentRunOutput[];
-    /** Client-tool calls awaiting a browser round-trip (empty when auto-resolved). */
-    pendingClientTools: ToolCall[];
-    /** The approval gate the run parked on, or `null`. */
-    pendingApproval: AgentSseApprovalPayload | null;
-    error: string | null;
-    /** Start a fresh run, resetting the transcript. */
-    run: (input: TInput) => Promise<void>;
-    /** Resume a client-tool pause with results gathered by hand. */
-    respond: (results: AgentToolResult[]) => Promise<void>;
-    /** Approve the pending approval gate and resume. */
-    approve: (toolCallId: string) => Promise<void>;
-    /** Reject the pending approval gate and resume. */
-    reject: (toolCallId: string) => Promise<void>;
-    /** Abort any in-flight stream and return to `idle`. */
-    reset: () => void;
-}
-/**
- * React client runtime for the named-event agent-SSE protocol. Drives
- * `readAgentStream` (via the framework-free `driveAgentRun`), accumulates the
- * transcript, tracks run status, and surfaces pending client-tool calls and
- * approval requests with imperative `run` / `respond` / `approve` / `reject`.
- *
- * Lives behind the `@rudderjs/ai/react` subpath so the main entry stays
- * runtime-agnostic (same split as `@rudderjs/sync/react`).
- *
- * @example
- * const { status, outputs, run } = useAgentRun({
- *   request: (req, signal) =>
- *     fetch('/api/agent', { method: 'POST', body: JSON.stringify(req), signal }),
- * })
- * // <button onClick={() => run('Summarize the latest report')}>Ask</button>
- */
-export declare function useAgentRun<TInput = unknown>(options: UseAgentRunOptions<TInput>): UseAgentRunResult<TInput>;
-//# sourceMappingURL=useAgentRun.d.ts.map

package/dist/react/useAgentRun.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"useAgentRun.d.ts","sourceRoot":"","sources":["../../src/react/useAgentRun.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,uBAAuB,EACvB,uBAAuB,EAGxB,MAAM,iBAAiB,CAAA;AACxB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAC3C,OAAO,EAGL,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,eAAe,EACrB,MAAM,gBAAgB,CAAA;AAEvB;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,SAAS,GAAG,UAAU,GAAG,OAAO,CAAA;AAEtE,MAAM,WAAW,kBAAkB,CAAC,MAAM,GAAG,OAAO;IAClD;;;;OAIG;IACH,OAAO,EAAO,CAAC,GAAG,EAAE,eAAe,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAA;IACtF;;;;OAIG;IACH,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAC5D,UAAU,CAAC,EAAG,CAAC,IAAI,EAAE,uBAAuB,KAAK,IAAI,CAAA;IACrD,OAAO,CAAC,EAAM,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;IACvC;;iEAE6D;IAC7D,UAAU,CAAC,EAAG,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,KAAK,IAAI,CAAA;CACrD;AAED,MAAM,WAAW,iBAAiB,CAAC,MAAM,GAAG,OAAO;IACjD,MAAM,EAAc,cAAc,CAAA;IAClC,0EAA0E;IAC1E,OAAO,EAAa,cAAc,EAAE,CAAA;IACpC,kFAAkF;IAClF,kBAAkB,EAAE,QAAQ,EAAE,CAAA;IAC9B,sDAAsD;IACtD,eAAe,EAAK,uBAAuB,GAAG,IAAI,CAAA;IAClD,KAAK,EAAe,MAAM,GAAG,IAAI,CAAA;IACjC,mDAAmD;IACnD,GAAG,EAAiB,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACpD,gEAAgE;IAChE,OAAO,EAAa,CAAC,OAAO,EAAE,eAAe,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACjE,oDAAoD;IACpD,OAAO,EAAa,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACzD,mDAAmD;IACnD,MAAM,EAAc,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACzD,uDAAuD;IACvD,KAAK,EAAe,MAAM,IAAI,CAAA;CAC/B;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,WAAW,CAAC,MAAM,GAAG,OAAO,EAC1C,OAAO,EAAE,kBAAkB,CAAC,MAAM,CAAC,GAClC,iBAAiB,CAAC,MAAM,CAAC,CA+G3B"}

package/dist/react/useAgentRun.js

@@ -1,125 +0,0 @@
-import { useCallback, useRef, useState } from 'react';
-import { appendAgentOutput, driveAgentRun, } from './agent-run.js';
-/**
- * React client runtime for the named-event agent-SSE protocol. Drives
- * `readAgentStream` (via the framework-free `driveAgentRun`), accumulates the
- * transcript, tracks run status, and surfaces pending client-tool calls and
- * approval requests with imperative `run` / `respond` / `approve` / `reject`.
- *
- * Lives behind the `@rudderjs/ai/react` subpath so the main entry stays
- * runtime-agnostic (same split as `@rudderjs/sync/react`).
- *
- * @example
- * const { status, outputs, run } = useAgentRun({
- *   request: (req, signal) =>
- *     fetch('/api/agent', { method: 'POST', body: JSON.stringify(req), signal }),
- * })
- * // <button onClick={() => run('Summarize the latest report')}>Ask</button>
- */
-export function useAgentRun(options) {
-    const [status, setStatus] = useState('idle');
-    const [outputs, setOutputs] = useState([]);
-    const [pendingClientTools, setPendingClientTools] = useState([]);
-    const [pendingApproval, setPendingApproval] = useState(null);
-    const [error, setError] = useState(null);
-    // Latest values needed by the async driver / resume actions, kept in refs so
-    // the imperative callbacks don't go stale between renders.
-    const optionsRef = useRef(options);
-    optionsRef.current = options;
-    const turnRef = useRef(null);
-    const abortRef = useRef(null);
-    // Shared loop body for both the initial run and every resume.
-    const drive = useCallback(async (req) => {
-        const opts = optionsRef.current;
-        abortRef.current?.abort();
-        const controller = new AbortController();
-        abortRef.current = controller;
-        setStatus('running');
-        setPendingClientTools([]);
-        setPendingApproval(null);
-        setError(null);
-        let sawError = null;
-        const callbacks = {
-            onText: t => setOutputs(o => appendAgentOutput(o, 'text', { text: t })),
-            onToolCall: d => setOutputs(o => appendAgentOutput(o, 'tool_call', d)),
-            onToolUpdate: d => setOutputs(o => appendAgentOutput(o, 'tool_update', d)),
-            onToolResult: d => setOutputs(o => appendAgentOutput(o, 'tool_result', d)),
-            onToolApprovalRequired: d => setOutputs(o => appendAgentOutput(o, 'tool_approval_required', d)),
-            onHandoff: d => setOutputs(o => appendAgentOutput(o, 'handoff', d)),
-            onError: d => { sawError = d.message; setOutputs(o => appendAgentOutput(o, 'error', d)); },
-            onComplete: d => opts.onComplete?.(d),
-            ...(opts.onAppEvent ? { onAppEvent: opts.onAppEvent } : {}),
-        };
-        try {
-            const turn = await driveAgentRun(req, {
-                request: opts.request,
-                callbacks,
-                signal: controller.signal,
-                ...(opts.clientTools ? { clientTools: opts.clientTools } : {}),
-            });
-            if (controller.signal.aborted)
-                return;
-            turnRef.current = turn;
-            if (sawError !== null) {
-                setStatus('error');
-                setError(sawError);
-                opts.onError?.(sawError);
-                return;
-            }
-            // Parked on an approval gate, or on client tools with no resolver:
-            // surface the prompt and keep the run logically open.
-            if (turn.awaiting === 'approval' && turn.pendingApproval) {
-                setPendingApproval(turn.pendingApproval);
-                return;
-            }
-            if (turn.awaiting === 'client_tools' && turn.pendingClientTools.length > 0) {
-                setPendingClientTools(turn.pendingClientTools);
-                return;
-            }
-            setStatus('complete');
-        }
-        catch (err) {
-            if (controller.signal.aborted)
-                return;
-            const message = err instanceof Error ? err.message : String(err);
-            setStatus('error');
-            setError(message);
-            optionsRef.current.onError?.(message);
-        }
-    }, []);
-    const run = useCallback(async (input) => {
-        turnRef.current = null;
-        setOutputs([]);
-        await drive({ type: 'run', input });
-    }, [drive]);
-    const respond = useCallback(async (results) => {
-        const turn = turnRef.current;
-        if (!turn)
-            return;
-        await drive({ type: 'resume', turn, clientToolResults: results, approved: [], rejected: [] });
-    }, [drive]);
-    const approve = useCallback(async (toolCallId) => {
-        const turn = turnRef.current;
-        if (!turn)
-            return;
-        await drive({ type: 'resume', turn, clientToolResults: [], approved: [toolCallId], rejected: [] });
-    }, [drive]);
-    const reject = useCallback(async (toolCallId) => {
-        const turn = turnRef.current;
-        if (!turn)
-            return;
-        await drive({ type: 'resume', turn, clientToolResults: [], approved: [], rejected: [toolCallId] });
-    }, [drive]);
-    const reset = useCallback(() => {
-        abortRef.current?.abort();
-        abortRef.current = null;
-        turnRef.current = null;
-        setStatus('idle');
-        setOutputs([]);
-        setPendingClientTools([]);
-        setPendingApproval(null);
-        setError(null);
-    }, []);
-    return { status, outputs, pendingClientTools, pendingApproval, error, run, respond, approve, reject, reset };
-}
-//# sourceMappingURL=useAgentRun.js.map

package/dist/react/useAgentRun.js.map

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