@halo-sdk/react 1.0.0 → 2.0.0

package/dist/hooks.js

@@ -0,0 +1,48 @@
+import { useEffect, useRef, useState } from "react";
+import { approvalsReducer, cacheStatsReducer, costReducer, initialApprovals, initialCacheStats, initialCost, initialLoopState, loopStateReducer, } from "./reducers.js";
+/**
+ * Generic hook: fold the {@link HaloEvent} stream into derived state via a pure
+ * reducer. The building block for all the specific hooks below.
+ */
+export function useHaloState(subscribe, reducer, initial) {
+    const [state, setState] = useState(initial);
+    const reducerRef = useRef(reducer);
+    reducerRef.current = reducer;
+    useEffect(() => {
+        return subscribe((event) => setState((prev) => reducerRef.current(prev, event)));
+    }, [subscribe]);
+    return state;
+}
+/** Live prefix-cache hit/miss/write tokens + hit rate. */
+export function useCacheStats(subscribe) {
+    return useHaloState(subscribe, cacheStatsReducer, initialCacheStats);
+}
+/** Cumulative turns, tokens, and estimated USD spend. */
+export function useCost(subscribe) {
+    return useHaloState(subscribe, costReducer, initialCost);
+}
+/** Current agent-loop step + status (idle/running/paused/error). */
+export function useLoopState(subscribe) {
+    return useHaloState(subscribe, loopStateReducer, initialLoopState);
+}
+/** Pending human-in-the-loop tool approvals (for an approval UI). */
+export function useApprovals(subscribe) {
+    return useHaloState(subscribe, approvalsReducer, initialApprovals);
+}
+/** A cacheability grade derived live from the hit rate (A–F). */
+export function useCacheProfile(subscribe) {
+    const stats = useCacheStats(subscribe);
+    return { ...stats, grade: gradeFor(stats.hitRate) };
+}
+function gradeFor(hitRate) {
+    if (hitRate >= 0.9)
+        return "A";
+    if (hitRate >= 0.75)
+        return "B";
+    if (hitRate >= 0.5)
+        return "C";
+    if (hitRate >= 0.25)
+        return "D";
+    return "F";
+}
+//# sourceMappingURL=hooks.js.map

package/dist/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAEpD,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,WAAW,EACX,gBAAgB,EAChB,iBAAiB,EACjB,WAAW,EACX,gBAAgB,EAChB,gBAAgB,GAKjB,MAAM,eAAe,CAAC;AAQvB;;;GAGG;AACH,MAAM,UAAU,YAAY,CAC1B,SAAoB,EACpB,OAA0C,EAC1C,OAAgB;IAEhB,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAI,OAAO,CAAC,CAAC;IAC/C,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IACnC,UAAU,CAAC,OAAO,GAAG,OAAO,CAAC;IAE7B,SAAS,CAAC,GAAG,EAAE;QACb,OAAO,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IACnF,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;IAEhB,OAAO,KAAK,CAAC;AACf,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,aAAa,CAAC,SAAoB;IAChD,OAAO,YAAY,CAAC,SAAS,EAAE,iBAAiB,EAAE,iBAAiB,CAAC,CAAC;AACvE,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,OAAO,CAAC,SAAoB;IAC1C,OAAO,YAAY,CAAC,SAAS,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC;AAC3D,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,YAAY,CAAC,SAAoB;IAC/C,OAAO,YAAY,CAAC,SAAS,EAAE,gBAAgB,EAAE,gBAAgB,CAAC,CAAC;AACrE,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,YAAY,CAAC,SAAoB;IAC/C,OAAO,YAAY,CAAC,SAAS,EAAE,gBAAgB,EAAE,gBAAgB,CAAC,CAAC;AACrE,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,eAAe,CAAC,SAAoB;IAGlD,MAAM,KAAK,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC;IACvC,OAAO,EAAE,GAAG,KAAK,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;AACtD,CAAC;AAED,SAAS,QAAQ,CAAC,OAAe;IAC/B,IAAI,OAAO,IAAI,GAAG;QAAE,OAAO,GAAG,CAAC;IAC/B,IAAI,OAAO,IAAI,IAAI;QAAE,OAAO,GAAG,CAAC;IAChC,IAAI,OAAO,IAAI,GAAG;QAAE,OAAO,GAAG,CAAC;IAC/B,IAAI,OAAO,IAAI,IAAI;QAAE,OAAO,GAAG,CAAC;IAChC,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/reducers.js

@@ -0,0 +1,69 @@
+export const initialCacheStats = () => ({
+    hitTokens: 0,
+    missTokens: 0,
+    writeTokens: 0,
+    hitRate: 0,
+});
+export function cacheStatsReducer(state, event) {
+    if (event.type !== "cache:hit")
+        return state;
+    const hitTokens = state.hitTokens + event.hitTokens;
+    const missTokens = state.missTokens + event.missTokens;
+    const total = hitTokens + missTokens;
+    return {
+        hitTokens,
+        missTokens,
+        writeTokens: state.writeTokens,
+        hitRate: total > 0 ? hitTokens / total : 0,
+    };
+}
+export const initialCost = () => ({
+    turns: 0,
+    promptTokens: 0,
+    completionTokens: 0,
+    estimatedUsd: 0,
+});
+export function costReducer(state, event) {
+    switch (event.type) {
+        case "turn:end":
+            return { ...state, turns: state.turns + 1 };
+        case "cost":
+            return {
+                ...state,
+                promptTokens: state.promptTokens + event.promptTokens,
+                completionTokens: state.completionTokens + event.completionTokens,
+                estimatedUsd: state.estimatedUsd + (event.estimatedUsd ?? 0),
+            };
+        default:
+            return state;
+    }
+}
+export const initialLoopState = () => ({ step: 0, status: "idle", lastError: null });
+export function loopStateReducer(state, event) {
+    switch (event.type) {
+        case "loop:step":
+            return { ...state, step: event.step, status: "running" };
+        case "loop:paused":
+            return { ...state, status: "paused" };
+        case "loop:resumed":
+            return { ...state, status: "running" };
+        case "loop:error":
+            return { ...state, status: "error", lastError: event.error };
+        case "turn:end":
+            return state.status === "error" ? state : { ...state, status: "idle" };
+        default:
+            return state;
+    }
+}
+export const initialApprovals = () => [];
+export function approvalsReducer(state, event) {
+    switch (event.type) {
+        case "hitl:pending":
+            return [...state, { toolCallId: event.call.id, call: event.call }];
+        case "hitl:resolved":
+            return state.filter((a) => a.toolCallId !== event.toolCallId);
+        default:
+            return state;
+    }
+}
+//# sourceMappingURL=reducers.js.map

package/dist/reducers.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@halo-sdk/react",
-  "version": "1.0.0",
+  "version": "2.0.0",
   "description": "Lightweight, strongly-typed React hooks for Halo SDK — observe cache, cost, loop, and HITL state in the UI",
   "keywords": [
     "ai",
@@ -37,10 +37,10 @@
     "react": "^19.0.0",
     "typescript": "^5.8.0",
     "vitest": "^3.0.0",
-    "@halo-sdk/core": "1.1.0"
+    "@halo-sdk/core": "1.2.0"
   },
   "peerDependencies": {
-    "@halo-sdk/core": ">=1.1.0",
+    "@halo-sdk/core": ">=1.2.0",
     "react": "^18.0.0 || ^19.0.0"
   },
   "scripts": {