@zakstam/codex-local-component 0.9.0 → 0.10.0

package/dist/react/threadActivity.d.ts

@@ -1,35 +1,4 @@
-export type CodexThreadActivityPhase = "idle" | "streaming" | "awaiting_approval" | "failed" | "interrupted";
-export type CodexThreadActivity = {
-    phase: CodexThreadActivityPhase;
-    activeTurnId?: string;
-    activeMessageId?: string;
-};
-export type CodexThreadActivityMessageLike = {
-    messageId?: string;
-    turnId?: string;
-    status?: "streaming" | "completed" | "failed" | "interrupted" | string;
-    createdAt?: number;
-};
-export type CodexThreadActivityDispatchLike = {
-    turnId?: string;
-    status?: "queued" | "claimed" | "started" | "completed" | "failed" | "cancelled" | string;
-    updatedAt?: number;
-    createdAt?: number;
-};
-export type CodexThreadActivityStreamStatLike = {
-    state?: "streaming" | "finished" | "aborted" | string;
-};
-export type CodexThreadActivityTurnLike = {
-    turnId?: string;
-    status?: string;
-    startedAt?: number;
-};
-export type CodexThreadActivityThreadState = {
-    pendingApprovals?: unknown[] | null;
-    recentMessages?: CodexThreadActivityMessageLike[] | null;
-    dispatches?: CodexThreadActivityDispatchLike[] | null;
-    streamStats?: CodexThreadActivityStreamStatLike[] | null;
-    turns?: CodexThreadActivityTurnLike[] | null;
-};
+import { type CodexThreadActivity, type CodexThreadActivityActiveStreamLike, type CodexThreadActivityDispatchLike, type CodexThreadActivityLifecycleMarkerLike, type CodexThreadActivityMessageLike, type CodexThreadActivityPhase, type CodexThreadActivityStreamStatLike, type CodexThreadActivityThreadState, type CodexThreadActivityTurnLike } from "./activityAuthority.js";
+export type { CodexThreadActivity, CodexThreadActivityPhase, CodexThreadActivityMessageLike, CodexThreadActivityDispatchLike, CodexThreadActivityStreamStatLike, CodexThreadActivityTurnLike, CodexThreadActivityActiveStreamLike, CodexThreadActivityLifecycleMarkerLike, CodexThreadActivityThreadState, };
 export declare function deriveCodexThreadActivity(state: CodexThreadActivityThreadState | null | undefined): CodexThreadActivity;
 //# sourceMappingURL=threadActivity.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"threadActivity.d.ts","sourceRoot":"","sources":["../../src/react/threadActivity.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,wBAAwB,GAChC,MAAM,GACN,WAAW,GACX,mBAAmB,GACnB,QAAQ,GACR,aAAa,CAAC;AAElB,MAAM,MAAM,mBAAmB,GAAG;IAChC,KAAK,EAAE,wBAAwB,CAAC;IAChC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,8BAA8B,GAAG;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,WAAW,GAAG,WAAW,GAAG,QAAQ,GAAG,aAAa,GAAG,MAAM,CAAC;IACvE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,+BAA+B,GAAG;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,GAAG,MAAM,CAAC;IAC1F,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,iCAAiC,GAAG;IAC9C,KAAK,CAAC,EAAE,WAAW,GAAG,UAAU,GAAG,SAAS,GAAG,MAAM,CAAC;CACvD,CAAC;AAEF,MAAM,MAAM,2BAA2B,GAAG;IACxC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,8BAA8B,GAAG;IAC3C,gBAAgB,CAAC,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IACpC,cAAc,CAAC,EAAE,8BAA8B,EAAE,GAAG,IAAI,CAAC;IACzD,UAAU,CAAC,EAAE,+BAA+B,EAAE,GAAG,IAAI,CAAC;IACtD,WAAW,CAAC,EAAE,iCAAiC,EAAE,GAAG,IAAI,CAAC;IACzD,KAAK,CAAC,EAAE,2BAA2B,EAAE,GAAG,IAAI,CAAC;CAC9C,CAAC;AAwGF,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,8BAA8B,GAAG,IAAI,GAAG,SAAS,GACvD,mBAAmB,CAgFrB"}
+{"version":3,"file":"threadActivity.d.ts","sourceRoot":"","sources":["../../src/react/threadActivity.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,mCAAmC,EACxC,KAAK,+BAA+B,EACpC,KAAK,sCAAsC,EAC3C,KAAK,8BAA8B,EACnC,KAAK,wBAAwB,EAC7B,KAAK,iCAAiC,EACtC,KAAK,8BAA8B,EACnC,KAAK,2BAA2B,EACjC,MAAM,wBAAwB,CAAC;AAEhC,YAAY,EACV,mBAAmB,EACnB,wBAAwB,EACxB,8BAA8B,EAC9B,+BAA+B,EAC/B,iCAAiC,EACjC,2BAA2B,EAC3B,mCAAmC,EACnC,sCAAsC,EACtC,8BAA8B,GAC/B,CAAC;AAEF,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,8BAA8B,GAAG,IAAI,GAAG,SAAS,GACvD,mBAAmB,CAErB"}

package/dist/react/threadActivity.js

@@ -1,148 +1,6 @@
 "use client";
-const IN_FLIGHT_DISPATCH_STATUSES = new Set(["queued", "claimed", "started"]);
-const IN_FLIGHT_TURN_STATUSES = new Set(["queued", "inProgress", "started", "streaming"]);
-const FAILED_TURN_STATUSES = new Set(["failed"]);
-const INTERRUPTED_TURN_STATUSES = new Set(["interrupted", "cancelled"]);
-function candidateTimestamp(input) {
-    return typeof input === "number" ? input : 0;
-}
-function pickLatest(candidates) {
-    let latest = null;
-    for (const candidate of candidates) {
-        if (!candidate) {
-            continue;
-        }
-        if (!latest || candidate.timestamp > latest.timestamp) {
-            latest = candidate;
-        }
-    }
-    return latest;
-}
-function latestMessageByStatus(messages, status) {
-    let latest = null;
-    for (const message of messages) {
-        if (message.status !== status) {
-            continue;
-        }
-        const candidate = {
-            timestamp: candidateTimestamp(message.createdAt),
-            ...(message.turnId !== undefined ? { activeTurnId: message.turnId } : {}),
-            ...(message.messageId !== undefined ? { activeMessageId: message.messageId } : {}),
-        };
-        if (!latest || candidate.timestamp > latest.timestamp) {
-            latest = candidate;
-        }
-    }
-    return latest;
-}
-function latestDispatchByStatus(dispatches, predicate) {
-    let latest = null;
-    for (const dispatch of dispatches) {
-        if (typeof dispatch.status !== "string" || !predicate(dispatch.status)) {
-            continue;
-        }
-        const candidate = {
-            timestamp: candidateTimestamp(dispatch.updatedAt ?? dispatch.createdAt),
-            ...(dispatch.turnId !== undefined ? { activeTurnId: dispatch.turnId } : {}),
-        };
-        if (!latest || candidate.timestamp > latest.timestamp) {
-            latest = candidate;
-        }
-    }
-    return latest;
-}
-function latestTurnByStatus(turns, predicate) {
-    let latest = null;
-    for (const turn of turns) {
-        if (typeof turn.status !== "string" || !predicate(turn.status)) {
-            continue;
-        }
-        const candidate = {
-            timestamp: candidateTimestamp(turn.startedAt),
-            ...(turn.turnId !== undefined ? { activeTurnId: turn.turnId } : {}),
-        };
-        if (!latest || candidate.timestamp > latest.timestamp) {
-            latest = candidate;
-        }
-    }
-    return latest;
-}
-function activeFromInFlightState(input) {
-    return pickLatest([
-        latestMessageByStatus(input.messages, "streaming"),
-        latestDispatchByStatus(input.dispatches, (status) => IN_FLIGHT_DISPATCH_STATUSES.has(status)),
-        latestTurnByStatus(input.turns, (status) => IN_FLIGHT_TURN_STATUSES.has(status)),
-    ]);
-}
+import { deriveCodexActivityByAuthorityRules, } from "./activityAuthority.js";
 export function deriveCodexThreadActivity(state) {
-    const messages = state?.recentMessages ?? [];
-    const dispatches = state?.dispatches ?? [];
-    const turns = state?.turns ?? [];
-    const pendingApprovals = state?.pendingApprovals ?? [];
-    const streamStats = state?.streamStats ?? [];
-    if (pendingApprovals.length > 0) {
-        const active = activeFromInFlightState({ messages, dispatches, turns });
-        return {
-            phase: "awaiting_approval",
-            ...(active?.activeTurnId !== undefined ? { activeTurnId: active.activeTurnId } : {}),
-            ...(active?.activeMessageId !== undefined ? { activeMessageId: active.activeMessageId } : {}),
-        };
-    }
-    const activeStreamingMessage = latestMessageByStatus(messages, "streaming");
-    if (activeStreamingMessage) {
-        return {
-            phase: "streaming",
-            ...(activeStreamingMessage.activeTurnId !== undefined
-                ? { activeTurnId: activeStreamingMessage.activeTurnId }
-                : {}),
-            ...(activeStreamingMessage.activeMessageId !== undefined
-                ? { activeMessageId: activeStreamingMessage.activeMessageId }
-                : {}),
-        };
-    }
-    const hasStreamingStat = streamStats.some((stat) => stat.state === "streaming");
-    if (hasStreamingStat) {
-        const inFlight = activeFromInFlightState({ messages, dispatches, turns });
-        return {
-            phase: "streaming",
-            ...(inFlight?.activeTurnId !== undefined ? { activeTurnId: inFlight.activeTurnId } : {}),
-            ...(inFlight?.activeMessageId !== undefined ? { activeMessageId: inFlight.activeMessageId } : {}),
-        };
-    }
-    const inFlightDispatch = latestDispatchByStatus(dispatches, (status) => IN_FLIGHT_DISPATCH_STATUSES.has(status));
-    if (inFlightDispatch) {
-        return {
-            phase: "streaming",
-            ...(inFlightDispatch.activeTurnId !== undefined ? { activeTurnId: inFlightDispatch.activeTurnId } : {}),
-        };
-    }
-    const inFlightTurn = latestTurnByStatus(turns, (status) => IN_FLIGHT_TURN_STATUSES.has(status));
-    if (inFlightTurn) {
-        return {
-            phase: "streaming",
-            ...(inFlightTurn.activeTurnId !== undefined ? { activeTurnId: inFlightTurn.activeTurnId } : {}),
-        };
-    }
-    const failed = pickLatest([
-        latestMessageByStatus(messages, "failed"),
-        latestDispatchByStatus(dispatches, (status) => status === "failed"),
-        latestTurnByStatus(turns, (status) => FAILED_TURN_STATUSES.has(status)),
-    ]);
-    const interrupted = pickLatest([
-        latestMessageByStatus(messages, "interrupted"),
-        latestTurnByStatus(turns, (status) => INTERRUPTED_TURN_STATUSES.has(status)),
-    ]);
-    const terminal = pickLatest([
-        failed ? { ...failed, phase: "failed" } : null,
-        interrupted ? { ...interrupted, phase: "interrupted" } : null,
-    ]);
-    if (terminal?.phase) {
-        return {
-            phase: terminal.phase,
-            ...(terminal.activeTurnId !== undefined ? { activeTurnId: terminal.activeTurnId } : {}),
-            ...(terminal.activeMessageId !== undefined ? { activeMessageId: terminal.activeMessageId } : {}),
-        };
-    }
-    return { phase: "idle" };
+    return deriveCodexActivityByAuthorityRules(state);
 }
 //# sourceMappingURL=threadActivity.js.map

package/dist/react/threadActivity.js.map

@@ -1 +1 @@
-{"version":3,"file":"threadActivity.js","sourceRoot":"","sources":["../../src/react/threadActivity.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"threadActivity.js","sourceRoot":"","sources":["../../src/react/threadActivity.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EACL,mCAAmC,GAUpC,MAAM,wBAAwB,CAAC;AAchC,MAAM,UAAU,yBAAyB,CACvC,KAAwD;IAExD,OAAO,mCAAmC,CAAC,KAAK,CAAC,CAAC;AACpD,CAAC"}

package/dist/react/tokenUsage.d.ts

@@ -0,0 +1,32 @@
+export type CodexTokenUsageBreakdown = {
+    totalTokens: number;
+    inputTokens: number;
+    cachedInputTokens: number;
+    outputTokens: number;
+    reasoningOutputTokens: number;
+};
+export type CodexTurnTokenUsage = {
+    turnId: string;
+    total: CodexTokenUsageBreakdown;
+    last: CodexTokenUsageBreakdown;
+    modelContextWindow?: number;
+    updatedAt: number;
+};
+export type CodexTokenUsage = {
+    status: "loading";
+    turns: [];
+    cumulative: null;
+    modelContextWindow: null;
+} | {
+    status: "empty";
+    turns: [];
+    cumulative: null;
+    modelContextWindow: null;
+} | {
+    status: "ready";
+    turns: CodexTurnTokenUsage[];
+    cumulative: CodexTokenUsageBreakdown;
+    modelContextWindow: number | null;
+};
+export declare function deriveCodexTokenUsage(rawTurns: CodexTurnTokenUsage[] | null | undefined): CodexTokenUsage;
+//# sourceMappingURL=tokenUsage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tokenUsage.d.ts","sourceRoot":"","sources":["../../src/react/tokenUsage.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,wBAAwB,GAAG;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,qBAAqB,EAAE,MAAM,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,wBAAwB,CAAC;IAChC,IAAI,EAAE,wBAAwB,CAAC;IAC/B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,eAAe,GACvB;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,EAAE,CAAC;IAAC,UAAU,EAAE,IAAI,CAAC;IAAC,kBAAkB,EAAE,IAAI,CAAA;CAAE,GAC5E;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,EAAE,CAAC;IAAC,UAAU,EAAE,IAAI,CAAC;IAAC,kBAAkB,EAAE,IAAI,CAAA;CAAE,GAC1E;IACE,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,mBAAmB,EAAE,CAAC;IAC7B,UAAU,EAAE,wBAAwB,CAAC;IACrC,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC,CAAC;AAEN,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,mBAAmB,EAAE,GAAG,IAAI,GAAG,SAAS,GACjD,eAAe,CAgBjB"}

package/dist/react/tokenUsage.js

@@ -0,0 +1,17 @@
+"use client";
+export function deriveCodexTokenUsage(rawTurns) {
+    if (rawTurns === undefined) {
+        return { status: "loading", turns: [], cumulative: null, modelContextWindow: null };
+    }
+    if (rawTurns === null || rawTurns.length === 0) {
+        return { status: "empty", turns: [], cumulative: null, modelContextWindow: null };
+    }
+    const latest = rawTurns[rawTurns.length - 1];
+    return {
+        status: "ready",
+        turns: rawTurns,
+        cumulative: latest.total,
+        modelContextWindow: latest.modelContextWindow ?? null,
+    };
+}
+//# sourceMappingURL=tokenUsage.js.map

package/dist/react/tokenUsage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenUsage.js","sourceRoot":"","sources":["../../src/react/tokenUsage.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AA4Bb,MAAM,UAAU,qBAAqB,CACnC,QAAkD;IAElD,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE,CAAC;IACtF,CAAC;IACD,IAAI,QAAQ,KAAK,IAAI,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/C,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE,CAAC;IACpF,CAAC;IAED,MAAM,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC;IAE9C,OAAO;QACL,MAAM,EAAE,OAAO;QACf,KAAK,EAAE,QAAQ;QACf,UAAU,EAAE,MAAM,CAAC,KAAK;QACxB,kBAAkB,EAAE,MAAM,CAAC,kBAAkB,IAAI,IAAI;KACtD,CAAC;AACJ,CAAC"}

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

@@ -1 +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;;;;;kBAiCc,SAAS;;;qBAyBT,QAAQ;;EA+BxB"}
+{"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

@@ -1,9 +1,13 @@
 "use client";
-import { useCallback, useMemo, useState } from "react";
+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);
@@ -22,12 +26,12 @@ export function useCodexRuntimeBridge(controls, options) {
     }, []);
     const refresh = useCallback(async () => {
         if (!controls.getState) {
-            return state;
+            return stateRef.current;
         }
         const next = await runAction("refresh", controls.getState);
         setState(next);
         return next;
-    }, [controls.getState, runAction, state]);
+    }, [controls.getState, runAction]);
     const start = useCallback(async (args) => {
         const result = await runAction("start", () => controls.start(args));
         if (controls.getState) {

package/dist/react/useCodexRuntimeBridge.js.map

@@ -1 +1 @@
-{"version":3,"file":"useCodexRuntimeBridge.js","sourceRoot":"","sources":["../../src/react/useCodexRuntimeBridge.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAkBvD,MAAM,UAAU,qBAAqB,CACnC,QAAyD,EACzD,OAEC;IAED,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAChC,OAAO,EAAE,YAAY,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAC3F,CAAC;IACF,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,GAAG,QAAQ,CAA6D,IAAI,CAAC,CAAC;IAC/G,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAgB,IAAI,CAAC,CAAC;IAExD,MAAM,SAAS,GAAG,WAAW,CAAC,KAAK,EAAM,MAAyB,EAAE,EAAoB,EAAc,EAAE;QACtG,aAAa,CAAC,MAAM,CAAC,CAAC;QACtB,QAAQ,CAAC,IAAI,CAAC,CAAC;QACf,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,EAAE,EAAE,CAAC;YAC1B,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,SAAS,EAAE,CAAC;YACnB,MAAM,OAAO,GAAG,SAAS,YAAY,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YACnF,QAAQ,CAAC,OAAO,CAAC,CAAC;YAClB,MAAM,SAAS,CAAC;QAClB,CAAC;gBAAS,CAAC;YACT,aAAa,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;QACpE,CAAC;IACH,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,OAAO,GAAG,WAAW,CAAC,KAAK,IAAI,EAAE;QACrC,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC;YACvB,OAAO,KAAK,CAAC;QACf,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,SAAS,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAC3D,QAAQ,CAAC,IAAI,CAAC,CAAC;QACf,OAAO,IAAI,CAAC;IACd,CAAC,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC;IAE1C,MAAM,KAAK,GAAG,WAAW,CACvB,KAAK,EAAE,IAAe,EAAE,EAAE;QACxB,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;QACpE,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;YACtB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,CAAC;YACvC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACjB,CAAC;aAAM,CAAC;YACN,QAAQ,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QACzD,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC,EACD,CAAC,QAAQ,EAAE,SAAS,CAAC,CACtB,CAAC;IAEF,MAAM,IAAI,GAAG,WAAW,CAAC,KAAK,IAAI,EAAE;QAClC,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;QACtD,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;YACtB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,CAAC;YACvC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACjB,CAAC;aAAM,CAAC;YACN,QAAQ,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;QAC1D,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC,EAAE,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC;IAE1B,MAAM,QAAQ,GAAG,WAAW,CAC1B,KAAK,EAAE,IAAc,EAAE,EAAE;QACvB,MAAM,eAAe,GAAG,QAAQ,CAAC,QAAQ,CAAC;QAC1C,IAAI,CAAC,eAAe,EAAE,CAAC;YACrB,OAAO;QACT,CAAC;QACD,OAAO,SAAS,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC;IACxD,CAAC,EACD,CAAC,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC,CAC/B,CAAC;IAEF,MAAM,SAAS,GAAG,WAAW,CAAC,KAAK,IAAI,EAAE;QACvC,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC;YACxB,OAAO;QACT,CAAC;QACD,OAAO,SAAS,CAAC,WAAW,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC,EAAE,CAAC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC;IAEpC,OAAO,OAAO,CACZ,GAAG,EAAE,CAAC,CAAC;QACL,KAAK;QACL,KAAK;QACL,UAAU;QACV,MAAM,EAAE,UAAU,KAAK,IAAI;QAC3B,KAAK;QACL,IAAI;QACJ,OAAO;QACP,QAAQ;QACR,SAAS;KACV,CAAC,EACF,CAAC,UAAU,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,CACtE,CAAC;AACJ,CAAC"}
+{"version":3,"file":"useCodexRuntimeBridge.js","sourceRoot":"","sources":["../../src/react/useCodexRuntimeBridge.ts"],"names":[],"mappings":"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"}

package/dist/react/useCodexTokenUsage.d.ts

@@ -0,0 +1,7 @@
+import type { FunctionArgs, FunctionReference } from "convex/server";
+import { type CodexTokenUsage, type CodexTurnTokenUsage } from "./tokenUsage.js";
+export type CodexTokenUsageQuery<Args = Record<string, unknown>> = FunctionReference<"query", "public", {
+    threadId: string;
+} & Args, CodexTurnTokenUsage[]>;
+export declare function useCodexTokenUsage<Query extends CodexTokenUsageQuery<unknown>>(query: Query, args: FunctionArgs<Query> | "skip"): CodexTokenUsage;
+//# sourceMappingURL=useCodexTokenUsage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useCodexTokenUsage.d.ts","sourceRoot":"","sources":["../../src/react/useCodexTokenUsage.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACrE,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACzB,MAAM,iBAAiB,CAAC;AAEzB,MAAM,MAAM,oBAAoB,CAC9B,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAC5B,iBAAiB,CACnB,OAAO,EACP,QAAQ,EACR;IACE,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,IAAI,EACR,mBAAmB,EAAE,CACtB,CAAC;AAEF,wBAAgB,kBAAkB,CAAC,KAAK,SAAS,oBAAoB,CAAC,OAAO,CAAC,EAC5E,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,YAAY,CAAC,KAAK,CAAC,GAAG,MAAM,GACjC,eAAe,CAIjB"}

package/dist/react/useCodexTokenUsage.js

@@ -0,0 +1,10 @@
+"use client";
+import { useMemo } from "react";
+import { useQuery } from "convex/react";
+import { deriveCodexTokenUsage, } from "./tokenUsage.js";
+export function useCodexTokenUsage(query, args) {
+    const queryArgs = (args === "skip" ? ["skip"] : [args]);
+    const rawTurns = useQuery(query, ...queryArgs);
+    return useMemo(() => deriveCodexTokenUsage(rawTurns), [rawTurns]);
+}
+//# sourceMappingURL=useCodexTokenUsage.js.map

package/dist/react/useCodexTokenUsage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCodexTokenUsage.js","sourceRoot":"","sources":["../../src/react/useCodexTokenUsage.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAChC,OAAO,EAAE,QAAQ,EAA+B,MAAM,cAAc,CAAC;AAErE,OAAO,EACL,qBAAqB,GAGtB,MAAM,iBAAiB,CAAC;AAazB,MAAM,UAAU,kBAAkB,CAChC,KAAY,EACZ,IAAkC;IAElC,MAAM,SAAS,GAAG,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAA6C,CAAC;IACpG,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,EAAE,GAAG,SAAS,CAAC,CAAC;IAC/C,OAAO,OAAO,CAAC,GAAG,EAAE,CAAC,qBAAqB,CAAC,QAAQ,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;AACpE,CAAC"}

package/dist/shared/streamLifecycle.d.ts

@@ -0,0 +1,2 @@
+export declare const STREAM_DRAIN_COMPLETE_KIND = "stream/drain_complete";
+//# sourceMappingURL=streamLifecycle.d.ts.map

package/dist/shared/streamLifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streamLifecycle.d.ts","sourceRoot":"","sources":["../../src/shared/streamLifecycle.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,0BAA0B,0BAA0B,CAAC"}

package/dist/shared/streamLifecycle.js

@@ -0,0 +1,2 @@
+export const STREAM_DRAIN_COMPLETE_KIND = "stream/drain_complete";
+//# sourceMappingURL=streamLifecycle.js.map

package/dist/shared/streamLifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"streamLifecycle.js","sourceRoot":"","sources":["../../src/shared/streamLifecycle.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,0BAA0B,GAAG,uBAAuB,CAAC"}

package/docs/CLIENT_AND_REACT_HOOKS.md

@@ -60,6 +60,7 @@ Common helpers used by consumers:
 - `useCodexInterruptTurn`
 - `useCodexAutoResume`
 - `useCodexComposer`
+- `useCodexTokenUsage`
 - `optimisticallySendCodexMessage`
 
 ## `useCodexMessages` Host Query Contract
@@ -93,6 +94,7 @@ Return shape:
 - `useCodexThreads` -> app thread-list query + thread lifecycle mutations
 - `useCodexInterruptTurn` -> `chat.interruptTurnForHooks`
 - `useCodexComposer` -> `chat.enqueueTurnDispatch`
+- `useCodexTokenUsage` -> `chat.listTokenUsageForHooks`
 
 ## Reference React Integration Adapter
 
@@ -136,7 +138,7 @@ It demonstrates generated host wrappers plus React-first hook composition (`useC
 
 | UI Signal | Source of truth | Ignore for this signal | Why |
 | --- | --- | --- | --- |
-| Thread activity badge (`idle/streaming/awaiting_approval/failed/interrupted`) | `useCodexThreadActivity(chat.threadSnapshotSafe, ...)` | Raw `messages`, `dispatches`, `turns`, `streamStats` stitching in app code | Prevents precedence bugs and "stuck streaming" regressions. |
+| Thread activity badge (`idle/streaming/awaiting_approval/failed/interrupted`) | `useCodexThreadActivity(chat.threadSnapshotSafe, ...)` | Raw `messages`, `dispatches`, `turns`, `streamStats`, `activeStreams` stitching in app code | Uses canonical precedence: `pending approvals > streaming message > active stream > in-flight newer than terminal > terminal > idle`, including stream-drain lifecycle markers to prevent stuck streaming. |
 | Show "needs approval" UI | `activity.phase === "awaiting_approval"` (or `pendingApprovals` count if not using activity hook) | Dispatch status alone | Dispatch lifecycle does not encode approval waits. |
 | Render assistant text deltas | `useCodexMessages(..., { stream: true })` | `dispatches` and `turns` | Dispatch/turn state tracks orchestration, not message text continuity. |
 | Enable cancel/interruption affordance | `activity.phase === "streaming"` with `activity.activeTurnId` | `threadStatus`, `dispatches` alone | Active turn identity should come from normalized activity. |

package/docs/HOST_PRESET_MATRIX.md

@@ -25,6 +25,7 @@ All focused preset builders include:
 - `listThreadMessagesForHooks`
 - `listTurnMessagesForHooks`
 - `listPendingApprovalsForHooks`
+- `listTokenUsageForHooks`
 
 Additional query endpoints:
 
@@ -46,6 +47,7 @@ All focused preset builders include:
 - `ingestEvent`
 - `ingestBatch`
 - `respondApprovalForHooks`
+- `upsertTokenUsageForHooks`
 - `interruptTurnForHooks`
 
 Dispatch-managed additionally includes:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zakstam/codex-local-component",
-  "version": "0.9.0",
+  "version": "0.10.0",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",