@zakstam/codex-local-component 0.8.0 → 0.9.1

package/dist/react/useCodexDynamicTools.js

@@ -0,0 +1,91 @@
+"use client";
+import { useQuery } from "convex/react";
+import { useCallback, useEffect, useMemo, useRef, useState } from "react";
+import { deriveCodexDynamicToolCalls, } from "./dynamicTools.js";
+function requestKey(requestId) {
+    return `${typeof requestId}:${String(requestId)}`;
+}
+export function useCodexDynamicTools(query, args, options) {
+    const queryArgs = (args === "skip" ? ["skip"] : [args]);
+    const requests = useQuery(query, ...queryArgs);
+    const calls = useMemo(() => deriveCodexDynamicToolCalls(requests ?? []), [requests]);
+    const [runningRequestIds, setRunningRequestIds] = useState([]);
+    const [lastError, setLastError] = useState(null);
+    const handledRequestIdsRef = useRef(new Set());
+    const respond = useCallback(async (call, result) => {
+        if (!options.respond) {
+            throw new Error("Dynamic tool response handler is not configured.");
+        }
+        await options.respond({
+            requestId: call.requestId,
+            success: result.success,
+            contentItems: result.contentItems,
+        });
+        handledRequestIdsRef.current.add(requestKey(call.requestId));
+    }, [options]);
+    const runCall = useCallback(async (call) => {
+        const handler = options.handlers?.[call.toolName];
+        if (!handler) {
+            return false;
+        }
+        const key = requestKey(call.requestId);
+        if (handledRequestIdsRef.current.has(key)) {
+            return true;
+        }
+        setRunningRequestIds((current) => (current.includes(key) ? current : [...current, key]));
+        setLastError(null);
+        try {
+            const result = await handler(call);
+            await respond(call, result);
+            return true;
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            setLastError(message);
+            throw error;
+        }
+        finally {
+            setRunningRequestIds((current) => current.filter((id) => id !== key));
+        }
+    }, [options.handlers, respond]);
+    useEffect(() => {
+        if ((options.enabled ?? true) !== true) {
+            return;
+        }
+        if ((options.autoHandle ?? true) !== true) {
+            return;
+        }
+        if (!options.respond) {
+            return;
+        }
+        if (!options.handlers || Object.keys(options.handlers).length === 0) {
+            return;
+        }
+        void (async () => {
+            for (const call of calls) {
+                const key = requestKey(call.requestId);
+                if (handledRequestIdsRef.current.has(key) || runningRequestIds.includes(key)) {
+                    continue;
+                }
+                const handler = options.handlers?.[call.toolName];
+                if (!handler) {
+                    continue;
+                }
+                await runCall(call);
+            }
+        })().catch((error) => {
+            const message = error instanceof Error ? error.message : String(error);
+            setLastError(message);
+        });
+    }, [calls, options.autoHandle, options.enabled, options.handlers, runCall, runningRequestIds]);
+    return useMemo(() => ({
+        requests: requests ?? [],
+        calls,
+        pendingCount: calls.length,
+        runningRequestIds,
+        lastError,
+        runCall,
+        respond,
+    }), [calls, lastError, requests, respond, runCall, runningRequestIds]);
+}
+//# sourceMappingURL=useCodexDynamicTools.js.map

package/dist/react/useCodexDynamicTools.js.map

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

package/dist/react/useCodexIngestHealth.d.ts

@@ -0,0 +1,6 @@
+import type { FunctionArgs } from "convex/server";
+import { type CodexThreadStateQuery } from "./useCodexThreadState.js";
+import { type CodexIngestHealth, type CodexIngestHealthThreadState } from "./ingestHealth.js";
+export type CodexIngestHealthQuery<Args = Record<string, unknown>, Result extends CodexIngestHealthThreadState = CodexIngestHealthThreadState> = CodexThreadStateQuery<Args, Result>;
+export declare function useCodexIngestHealth<Query extends CodexIngestHealthQuery<unknown, CodexIngestHealthThreadState>>(query: Query, args: FunctionArgs<Query> | "skip"): CodexIngestHealth;
+//# sourceMappingURL=useCodexIngestHealth.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useCodexIngestHealth.d.ts","sourceRoot":"","sources":["../../src/react/useCodexIngestHealth.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAuB,KAAK,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAC3F,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,4BAA4B,EAClC,MAAM,mBAAmB,CAAC;AAE3B,MAAM,MAAM,sBAAsB,CAChC,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,MAAM,SAAS,4BAA4B,GAAG,4BAA4B,IACxE,qBAAqB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AAExC,wBAAgB,oBAAoB,CAAC,KAAK,SAAS,sBAAsB,CAAC,OAAO,EAAE,4BAA4B,CAAC,EAC9G,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,YAAY,CAAC,KAAK,CAAC,GAAG,MAAM,GACjC,iBAAiB,CAGnB"}

package/dist/react/useCodexIngestHealth.js

@@ -0,0 +1,9 @@
+"use client";
+import { useMemo } from "react";
+import { useCodexThreadState } from "./useCodexThreadState.js";
+import { deriveCodexIngestHealth, } from "./ingestHealth.js";
+export function useCodexIngestHealth(query, args) {
+    const threadState = useCodexThreadState(query, args);
+    return useMemo(() => deriveCodexIngestHealth(threadState), [threadState]);
+}
+//# sourceMappingURL=useCodexIngestHealth.js.map

package/dist/react/useCodexIngestHealth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCodexIngestHealth.js","sourceRoot":"","sources":["../../src/react/useCodexIngestHealth.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAEhC,OAAO,EAAE,mBAAmB,EAA8B,MAAM,0BAA0B,CAAC;AAC3F,OAAO,EACL,uBAAuB,GAGxB,MAAM,mBAAmB,CAAC;AAO3B,MAAM,UAAU,oBAAoB,CAClC,KAAY,EACZ,IAAkC;IAElC,MAAM,WAAW,GAAG,mBAAmB,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACrD,OAAO,OAAO,CAAC,GAAG,EAAE,CAAC,uBAAuB,CAAC,WAAW,CAAC,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC;AAC5E,CAAC"}

package/dist/react/useCodexRuntimeBridge.d.ts

@@ -0,0 +1,28 @@
+export type CodexRuntimeBridgeState = {
+    running: boolean;
+    threadId?: string | null;
+    turnId?: string | null;
+    lastError?: string | null;
+    [key: string]: unknown;
+};
+export type CodexRuntimeBridgeControls<StartArgs, SendArgs = string> = {
+    start: (args: StartArgs) => Promise<unknown>;
+    stop: () => Promise<unknown>;
+    getState?: () => Promise<CodexRuntimeBridgeState>;
+    sendTurn?: (args: SendArgs) => Promise<unknown>;
+    interrupt?: () => Promise<unknown>;
+};
+export declare function useCodexRuntimeBridge<StartArgs, SendArgs = string>(controls: CodexRuntimeBridgeControls<StartArgs, SendArgs>, options?: {
+    initialState?: CodexRuntimeBridgeState;
+}): {
+    state: CodexRuntimeBridgeState;
+    error: string | null;
+    busyAction: "start" | "interrupt" | "stop" | "refresh" | "send" | null;
+    isBusy: boolean;
+    start: (args: StartArgs) => Promise<unknown>;
+    stop: () => Promise<unknown>;
+    refresh: () => Promise<CodexRuntimeBridgeState>;
+    sendTurn: (args: SendArgs) => Promise<unknown>;
+    interrupt: () => Promise<unknown>;
+};
+//# sourceMappingURL=useCodexRuntimeBridge.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useCodexRuntimeBridge.d.ts","sourceRoot":"","sources":["../../src/react/useCodexRuntimeBridge.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,uBAAuB,GAAG;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,0BAA0B,CAAC,SAAS,EAAE,QAAQ,GAAG,MAAM,IAAI;IACrE,KAAK,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7C,IAAI,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7B,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC,uBAAuB,CAAC,CAAC;IAClD,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAChD,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;CACpC,CAAC;AAEF,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,QAAQ,GAAG,MAAM,EAChE,QAAQ,EAAE,0BAA0B,CAAC,SAAS,EAAE,QAAQ,CAAC,EACzD,OAAO,CAAC,EAAE;IACR,YAAY,CAAC,EAAE,uBAAuB,CAAC;CACxC;;;;;kBAsCc,SAAS;;;qBAyBT,QAAQ;;EA+BxB"}

package/dist/react/useCodexRuntimeBridge.js

@@ -0,0 +1,82 @@
+"use client";
+import { useCallback, useEffect, useMemo, useRef, useState } from "react";
+export function useCodexRuntimeBridge(controls, options) {
+    const [state, setState] = useState(options?.initialState ?? { running: false, threadId: null, turnId: null, lastError: null });
+    const stateRef = useRef(state);
+    const [busyAction, setBusyAction] = useState(null);
+    const [error, setError] = useState(null);
+    useEffect(() => {
+        stateRef.current = state;
+    }, [state]);
+    const runAction = useCallback(async (action, fn) => {
+        setBusyAction(action);
+        setError(null);
+        try {
+            const result = await fn();
+            return result;
+        }
+        catch (nextError) {
+            const message = nextError instanceof Error ? nextError.message : String(nextError);
+            setError(message);
+            throw nextError;
+        }
+        finally {
+            setBusyAction((current) => (current === action ? null : current));
+        }
+    }, []);
+    const refresh = useCallback(async () => {
+        if (!controls.getState) {
+            return stateRef.current;
+        }
+        const next = await runAction("refresh", controls.getState);
+        setState(next);
+        return next;
+    }, [controls.getState, runAction]);
+    const start = useCallback(async (args) => {
+        const result = await runAction("start", () => controls.start(args));
+        if (controls.getState) {
+            const next = await controls.getState();
+            setState(next);
+        }
+        else {
+            setState((current) => ({ ...current, running: true }));
+        }
+        return result;
+    }, [controls, runAction]);
+    const stop = useCallback(async () => {
+        const result = await runAction("stop", controls.stop);
+        if (controls.getState) {
+            const next = await controls.getState();
+            setState(next);
+        }
+        else {
+            setState((current) => ({ ...current, running: false }));
+        }
+        return result;
+    }, [controls, runAction]);
+    const sendTurn = useCallback(async (args) => {
+        const sendTurnControl = controls.sendTurn;
+        if (!sendTurnControl) {
+            return;
+        }
+        return runAction("send", () => sendTurnControl(args));
+    }, [controls.sendTurn, runAction]);
+    const interrupt = useCallback(async () => {
+        if (!controls.interrupt) {
+            return;
+        }
+        return runAction("interrupt", controls.interrupt);
+    }, [controls.interrupt, runAction]);
+    return useMemo(() => ({
+        state,
+        error,
+        busyAction,
+        isBusy: busyAction !== null,
+        start,
+        stop,
+        refresh,
+        sendTurn,
+        interrupt,
+    }), [busyAction, error, interrupt, refresh, sendTurn, start, state, stop]);
+}
+//# sourceMappingURL=useCodexRuntimeBridge.js.map

package/dist/react/useCodexRuntimeBridge.js.map

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

package/dist/react/useCodexThreadActivity.d.ts

@@ -0,0 +1,6 @@
+import type { FunctionArgs } from "convex/server";
+import { type CodexThreadStateQuery } from "./useCodexThreadState.js";
+import { type CodexThreadActivity, type CodexThreadActivityThreadState } from "./threadActivity.js";
+export type CodexThreadActivityQuery<Args = Record<string, unknown>, Result extends CodexThreadActivityThreadState = CodexThreadActivityThreadState> = CodexThreadStateQuery<Args, Result>;
+export declare function useCodexThreadActivity<Query extends CodexThreadActivityQuery<unknown, CodexThreadActivityThreadState>>(query: Query, args: FunctionArgs<Query> | "skip"): CodexThreadActivity;
+//# sourceMappingURL=useCodexThreadActivity.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useCodexThreadActivity.d.ts","sourceRoot":"","sources":["../../src/react/useCodexThreadActivity.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAuB,KAAK,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAC3F,OAAO,EAA6B,KAAK,mBAAmB,EAAE,KAAK,8BAA8B,EAAE,MAAM,qBAAqB,CAAC;AAE/H,MAAM,MAAM,wBAAwB,CAClC,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,MAAM,SAAS,8BAA8B,GAAG,8BAA8B,IAC5E,qBAAqB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AAExC,wBAAgB,sBAAsB,CAAC,KAAK,SAAS,wBAAwB,CAAC,OAAO,EAAE,8BAA8B,CAAC,EACpH,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,YAAY,CAAC,KAAK,CAAC,GAAG,MAAM,GACjC,mBAAmB,CAGrB"}

package/dist/react/useCodexThreadActivity.js

@@ -0,0 +1,9 @@
+"use client";
+import { useMemo } from "react";
+import { useCodexThreadState } from "./useCodexThreadState.js";
+import { deriveCodexThreadActivity } from "./threadActivity.js";
+export function useCodexThreadActivity(query, args) {
+    const threadState = useCodexThreadState(query, args);
+    return useMemo(() => deriveCodexThreadActivity(threadState), [threadState]);
+}
+//# sourceMappingURL=useCodexThreadActivity.js.map

package/dist/react/useCodexThreadActivity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCodexThreadActivity.js","sourceRoot":"","sources":["../../src/react/useCodexThreadActivity.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAEhC,OAAO,EAAE,mBAAmB,EAA8B,MAAM,0BAA0B,CAAC;AAC3F,OAAO,EAAE,yBAAyB,EAAiE,MAAM,qBAAqB,CAAC;AAO/H,MAAM,UAAU,sBAAsB,CACpC,KAAY,EACZ,IAAkC;IAElC,MAAM,WAAW,GAAG,mBAAmB,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACrD,OAAO,OAAO,CAAC,GAAG,EAAE,CAAC,yBAAyB,CAAC,WAAW,CAAC,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC;AAC9E,CAAC"}

package/dist/react/useCodexThreads.d.ts

@@ -0,0 +1,30 @@
+import type { FunctionArgs, FunctionReference } from "convex/server";
+export type CodexThreadsListQuery<Args extends Record<string, unknown> = Record<string, unknown>, Result = unknown> = FunctionReference<"query", "public", Args, Result>;
+export type CodexThreadsControls = {
+    createThread?: (args?: Record<string, unknown>) => Promise<unknown>;
+    resolveThread?: (args: {
+        localThreadId: string;
+    }) => Promise<unknown>;
+    resumeThread?: (args: {
+        threadId: string;
+    }) => Promise<unknown>;
+};
+export declare function useCodexThreads<Query extends CodexThreadsListQuery<Record<string, unknown>, unknown>>(config: {
+    list: {
+        query: Query;
+        args: FunctionArgs<Query> | "skip";
+    };
+    controls?: CodexThreadsControls;
+    initialSelectedThreadId?: string | null;
+}): {
+    threads: Query["_returnType"] | undefined;
+    selectedThreadId: string | null;
+    setSelectedThreadId: import("react").Dispatch<import("react").SetStateAction<string | null>>;
+    busyAction: "resolve" | "create" | "resume" | null;
+    isBusy: boolean;
+    error: string | null;
+    create: (args?: Record<string, unknown>) => Promise<unknown>;
+    resolve: (localThreadId: string) => Promise<unknown>;
+    resume: (threadId: string) => Promise<unknown>;
+};
+//# sourceMappingURL=useCodexThreads.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useCodexThreads.d.ts","sourceRoot":"","sources":["../../src/react/useCodexThreads.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAGrE,MAAM,MAAM,qBAAqB,CAC/B,IAAI,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9D,MAAM,GAAG,OAAO,IACd,iBAAiB,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;AAEvD,MAAM,MAAM,oBAAoB,GAAG;IACjC,YAAY,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACpE,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,aAAa,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACtE,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CACjE,CAAC;AAEF,wBAAgB,eAAe,CAAC,KAAK,SAAS,qBAAqB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,EACnG,MAAM,EAAE;IACN,IAAI,EAAE;QACJ,KAAK,EAAE,KAAK,CAAC;QACb,IAAI,EAAE,YAAY,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC;KACpC,CAAC;IACF,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAChC,uBAAuB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACzC;;;;;;;oBA6Be,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;6BAWf,MAAM;uBAaX,MAAM;EA0B1B"}

package/dist/react/useCodexThreads.js

@@ -0,0 +1,65 @@
+"use client";
+import { useQuery } from "convex/react";
+import { useCallback, useMemo, useState } from "react";
+export function useCodexThreads(config) {
+    const listQueryArgs = config.list.args === "skip"
+        ? ["skip"]
+        : [config.list.args];
+    const listArgs = listQueryArgs;
+    const listed = useQuery(config.list.query, ...listArgs);
+    const [selectedThreadId, setSelectedThreadId] = useState(config.initialSelectedThreadId ?? null);
+    const [busyAction, setBusyAction] = useState(null);
+    const [error, setError] = useState(null);
+    const run = useCallback(async (action, fn) => {
+        setBusyAction(action);
+        setError(null);
+        try {
+            return await fn();
+        }
+        catch (nextError) {
+            const message = nextError instanceof Error ? nextError.message : String(nextError);
+            setError(message);
+            throw nextError;
+        }
+        finally {
+            setBusyAction((current) => (current === action ? null : current));
+        }
+    }, []);
+    const create = useCallback(async (args) => {
+        const createThread = config.controls?.createThread;
+        if (!createThread) {
+            return null;
+        }
+        return run("create", () => createThread(args));
+    }, [config.controls, run]);
+    const resolve = useCallback(async (localThreadId) => {
+        const resolveThread = config.controls?.resolveThread;
+        if (!resolveThread) {
+            return null;
+        }
+        const result = await run("resolve", () => resolveThread({ localThreadId }));
+        setSelectedThreadId(localThreadId);
+        return result;
+    }, [config.controls, run]);
+    const resume = useCallback(async (threadId) => {
+        const resumeThread = config.controls?.resumeThread;
+        if (!resumeThread) {
+            return null;
+        }
+        const result = await run("resume", () => resumeThread({ threadId }));
+        setSelectedThreadId(threadId);
+        return result;
+    }, [config.controls, run]);
+    return useMemo(() => ({
+        threads: listed,
+        selectedThreadId,
+        setSelectedThreadId,
+        busyAction,
+        isBusy: busyAction !== null,
+        error,
+        create,
+        resolve,
+        resume,
+    }), [busyAction, create, error, listed, resolve, resume, selectedThreadId]);
+}
+//# sourceMappingURL=useCodexThreads.js.map

package/dist/react/useCodexThreads.js.map

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

package/dist/react-integration/index.d.ts

@@ -0,0 +1,101 @@
+import type { CodexDynamicToolHandler, CodexDynamicToolsQuery, CodexDynamicToolsRespond } from "../react/useCodexDynamicTools.js";
+import type { CodexMessagesQuery } from "../react/types.js";
+import type { CodexThreadActivityQuery } from "../react/useCodexThreadActivity.js";
+import type { CodexThreadActivity, CodexThreadActivityThreadState } from "../react/threadActivity.js";
+import type { CodexBranchActivityOptions } from "../react/branchActivity.js";
+import type { CodexConversationApprovalDecision, CodexConversationApprovalItem } from "../react/useCodexConversationController.js";
+export type CodexThreadScopeArgs<Actor extends Record<string, unknown>> = {
+    actor: Actor;
+    threadId: string;
+};
+export type CodexThreadTurnScopeArgs<Actor extends Record<string, unknown>> = CodexThreadScopeArgs<Actor> & {
+    turnId: string;
+};
+export type CodexReactHostHooks<Actor extends Record<string, unknown>> = {
+    listThreadMessagesForHooks: CodexMessagesQuery<{
+        actor: Actor;
+    }>;
+    threadSnapshotSafe: CodexThreadActivityQuery<{
+        actor: Actor;
+    }, CodexThreadActivityThreadState>;
+    listPendingServerRequestsForHooks?: CodexDynamicToolsQuery<{
+        actor: Actor;
+        threadId: string;
+        limit?: number;
+    }>;
+};
+export type CodexReactConversationControllerOptions = {
+    initialNumItems: number;
+    stream?: boolean;
+    branchOptions?: CodexBranchActivityOptions;
+    composer?: {
+        initialValue?: string;
+        onSend: (text: string) => Promise<unknown>;
+    };
+    approvals?: {
+        onResolve: (approval: CodexConversationApprovalItem, decision: CodexConversationApprovalDecision) => Promise<unknown>;
+    };
+    dynamicTools?: {
+        respond?: CodexDynamicToolsRespond;
+        handlers?: Record<string, CodexDynamicToolHandler>;
+        autoHandle?: boolean;
+        enabled?: boolean;
+        limit?: number;
+    };
+    interrupt?: {
+        onInterrupt: (activity: CodexThreadActivity) => Promise<unknown>;
+    };
+};
+export declare function codexThreadScopeArgs<Actor extends Record<string, unknown>>(actor: Actor, threadId: string | null | undefined): CodexThreadScopeArgs<Actor> | "skip";
+export declare function codexThreadTurnScopeArgs<Actor extends Record<string, unknown>>(actor: Actor, threadId: string | null | undefined, turnId: string | null | undefined): CodexThreadTurnScopeArgs<Actor> | "skip";
+export declare function createCodexReactConvexAdapter<Actor extends Record<string, unknown>>(config: {
+    actor: Actor;
+    hooks: CodexReactHostHooks<Actor>;
+}): {
+    threadArgs: (threadId: string | null | undefined) => "skip" | CodexThreadScopeArgs<Actor>;
+    threadTurnArgs: (threadId: string | null | undefined, turnId: string | null | undefined) => "skip" | CodexThreadTurnScopeArgs<Actor>;
+    useThreadMessages: (threadId: string | null | undefined, options: {
+        initialNumItems: number;
+        stream?: boolean;
+    }) => import("convex/react").UsePaginatedQueryResult<import("../index.js").CodexUIMessage>;
+    useThreadActivity: (threadId: string | null | undefined) => CodexThreadActivity;
+    useBranchActivity: (threadId: string | null | undefined, options?: CodexBranchActivityOptions) => CodexThreadActivity;
+    useIngestHealth: (threadId: string | null | undefined) => import("../react/ingestHealth.js").CodexIngestHealth;
+    useConversationController: (threadId: string | null | undefined, options: CodexReactConversationControllerOptions) => {
+        messages: import("convex/react").UsePaginatedQueryResult<import("../index.js").CodexUIMessage>;
+        activity: CodexThreadActivity;
+        ingestHealth: import("../react/ingestHealth.js").CodexIngestHealth;
+        branchActivity: CodexThreadActivity;
+        approvals: {
+            pending: CodexConversationApprovalItem[];
+            pendingCount: number;
+            approvingItemId: string | null;
+            error: string | null;
+            canResolve: boolean;
+            resolve: (approval: CodexConversationApprovalItem, decision: CodexConversationApprovalDecision) => Promise<void>;
+            accept: (approval: CodexConversationApprovalItem) => Promise<void>;
+            decline: (approval: CodexConversationApprovalItem) => Promise<void>;
+        };
+        dynamicTools: {
+            requests: never[] | import("../react/dynamicTools.js").CodexDynamicToolServerRequest[];
+            calls: import("../react/dynamicTools.js").CodexDynamicToolCall[];
+            pendingCount: number;
+            runningRequestIds: string[];
+            lastError: string | null;
+            runCall: (call: import("../react/dynamicTools.js").CodexDynamicToolCall) => Promise<boolean>;
+            respond: (call: import("../react/dynamicTools.js").CodexDynamicToolCall, result: import("../react/dynamicTools.js").CodexDynamicToolResponse) => Promise<void>;
+        };
+        composer: {
+            value: string;
+            setValue: import("react").Dispatch<import("react").SetStateAction<string>>;
+            error: string | null;
+            isSending: boolean;
+            canSend: boolean;
+            send: (overrideText?: string) => Promise<void>;
+        };
+        interrupt: () => Promise<void>;
+        canInterrupt: boolean;
+        isInterrupting: boolean;
+    };
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/react-integration/index.d.ts.map

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

package/dist/react-integration/index.js

@@ -0,0 +1,62 @@
+"use client";
+import { useCodexMessages } from "../react/useCodexMessages.js";
+import { useCodexBranchActivity } from "../react/useCodexBranchActivity.js";
+import { useCodexConversationController } from "../react/useCodexConversationController.js";
+import { useCodexIngestHealth } from "../react/useCodexIngestHealth.js";
+import { useCodexThreadActivity } from "../react/useCodexThreadActivity.js";
+export function codexThreadScopeArgs(actor, threadId) {
+    if (!threadId) {
+        return "skip";
+    }
+    return { actor, threadId };
+}
+export function codexThreadTurnScopeArgs(actor, threadId, turnId) {
+    if (!threadId || !turnId) {
+        return "skip";
+    }
+    return { actor, threadId, turnId };
+}
+export function createCodexReactConvexAdapter(config) {
+    return {
+        threadArgs: (threadId) => codexThreadScopeArgs(config.actor, threadId),
+        threadTurnArgs: (threadId, turnId) => codexThreadTurnScopeArgs(config.actor, threadId, turnId),
+        useThreadMessages: (threadId, options) => {
+            const args = codexThreadScopeArgs(config.actor, threadId);
+            return useCodexMessages(config.hooks.listThreadMessagesForHooks, args, options);
+        },
+        useThreadActivity: (threadId) => useCodexThreadActivity(config.hooks.threadSnapshotSafe, codexThreadScopeArgs(config.actor, threadId)),
+        useBranchActivity: (threadId, options) => useCodexBranchActivity(config.hooks.threadSnapshotSafe, codexThreadScopeArgs(config.actor, threadId), options),
+        useIngestHealth: (threadId) => useCodexIngestHealth(config.hooks.threadSnapshotSafe, codexThreadScopeArgs(config.actor, threadId)),
+        useConversationController: (threadId, options) => useCodexConversationController({
+            messages: {
+                query: config.hooks.listThreadMessagesForHooks,
+                args: codexThreadScopeArgs(config.actor, threadId),
+                initialNumItems: options.initialNumItems,
+                ...(options.stream !== undefined ? { stream: options.stream } : {}),
+            },
+            threadState: {
+                query: config.hooks.threadSnapshotSafe,
+                args: codexThreadScopeArgs(config.actor, threadId),
+                ...(options.branchOptions !== undefined ? { branchOptions: options.branchOptions } : {}),
+            },
+            ...(options.approvals !== undefined ? { approvals: options.approvals } : {}),
+            ...(options.dynamicTools !== undefined && config.hooks.listPendingServerRequestsForHooks !== undefined
+                ? {
+                    dynamicTools: {
+                        query: config.hooks.listPendingServerRequestsForHooks,
+                        args: threadId
+                            ? { actor: config.actor, threadId, ...(options.dynamicTools.limit !== undefined ? { limit: options.dynamicTools.limit } : {}) }
+                            : "skip",
+                        ...(options.dynamicTools.respond !== undefined ? { respond: options.dynamicTools.respond } : {}),
+                        ...(options.dynamicTools.handlers !== undefined ? { handlers: options.dynamicTools.handlers } : {}),
+                        ...(options.dynamicTools.autoHandle !== undefined ? { autoHandle: options.dynamicTools.autoHandle } : {}),
+                        ...(options.dynamicTools.enabled !== undefined ? { enabled: options.dynamicTools.enabled } : {}),
+                    },
+                }
+                : {}),
+            ...(options.composer !== undefined ? { composer: options.composer } : {}),
+            ...(options.interrupt !== undefined ? { interrupt: options.interrupt } : {}),
+        }),
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/react-integration/index.js.map

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