@beeuni/sdk 0.2.0 → 0.3.0

package/dist/react/use-session.js

@@ -1,6 +1,6 @@
 'use client';
 import { useMutation, useQuery, useQueryClient } from '@tanstack/react-query';
-import { useEffect, useLayoutEffect, useMemo, useRef, useState } from 'react';
+import { useCallback, useEffect, useLayoutEffect, useMemo, useRef, useState } from 'react';
 import { useOpenCodeCompactionStore } from '../browser/stores/opencode-compaction-store.js';
 import { useSessionWorkingStore } from '../browser/stores/session-working-store.js';
 import { compactionExpiryAtMs, projectCompacting, serverCompactionRevalidateAtMs, } from '../core/session/compaction.js';
@@ -29,7 +29,7 @@ import { useCanonicalRuntimeSession } from './use-canonical-opencode-session.js'
 import { useRuntimeEventStream } from './use-opencode-events/index.js';
 import { useSessionStream } from './use-session-stream.js';
 import { sessionStreamConnected } from '../core/session/control-stream.js';
-import { presenceReporter, watchHumanPresence } from './human-presence.js';
+import { PRESENCE_AWAKE_REFRESH_MS, presenceAwakeFrom, presenceReporter, watchHumanPresence, } from './human-presence.js';
 import { formatModelString } from './use-opencode-local.js';
 import { runtimeKeys, rejectQuestion as rejectQuestionApi, replyToPermission, replyToQuestion, useAbortRuntimeSession, useExecuteRuntimeCommand, useRuntimeSession, } from './use-opencode-sessions/index.js';
 import { mintSessionWireMessageId } from './use-opencode-sessions/messages.js';
@@ -46,8 +46,9 @@ import { useSessionLogSync } from './use-session-log.js';
 import { useSessionSync } from './use-session-sync.js';
 import { selectTranscriptShapeKey } from './session-transcript-subscription.js';
 import { useSessionStartGiveUp } from './use-session-start-give-up.js';
-import { useSessionTurnOutcome, useSessionWorking } from './use-session-working.js';
+import { useSessionCanStop, useSessionTurnOutcome, useSessionWorking } from './use-session-working.js';
 import { cancelSessionTurn } from './session-stop.js';
+import { useTurnEndHandoff } from './turn-end-handoff.js';
 import { useVisibleAgents } from './use-visible-agents.js';
 import { createBeeuni } from '../core/client/beeuni.js';
 import { platformConfig } from '../core/http/config.js';
@@ -60,6 +61,9 @@ export function shouldRetrySessionStart(failureCount, error, sessionId) {
     }
     return !isSessionStartError(error) && failureCount < 3;
 }
+export function presenceReturnReopensSession(heldByThisTab, cachedStage) {
+    return heldByThisTab || cachedStage === 'stopped';
+}
 export const SESSION_START_POLL_MS = 1_500;
 export function resolveSessionRuntimeUrl(start) {
     if (!start || start.stage !== 'ready')
@@ -408,22 +412,53 @@ export function useSession(projectId, sessionId, options = {}) {
     const presenceAlertsRef = useRef(presenceAlerts);
     const presencePageExitRef = useRef(presencePageExit);
     const presenceReporterRef = useRef(null);
+    const lastPresenceActiveRef = useRef(null);
+    const [presenceAwake, setPresenceAwakeState] = useState(null);
+    const presenceAwakeRef = useRef(presenceAwake);
+    const setPresenceAwake = useCallback((next) => {
+        if (next === null && presenceAwakeRef.current === null)
+            return;
+        presenceAwakeRef.current = next;
+        setPresenceAwakeState(next);
+    }, []);
+    const presenceReportRef = useRef(0);
     useEffect(() => {
         if (!browserPresence || !presenceTabId || !projectId || !sessionId)
             return;
         const tab_id = presenceTabId;
         const handle = createBeeuni(platformConfig()).session(projectId, sessionId);
         const reporter = presenceReporter(({ active, alerts }) => {
+            if (active &&
+                lastPresenceActiveRef.current === false &&
+                presenceReturnReopensSession(stoppedByUserRef.current === sessionId, queryClient.getQueryData(sessionStartKey(projectId, sessionId))
+                    ?.stage)) {
+                stoppedByUserRef.current = null;
+                openedAtRef.current = { sessionId, at: Date.now() };
+                void queryClient.invalidateQueries({ queryKey: sessionStartKey(projectId, sessionId) });
+            }
+            lastPresenceActiveRef.current = active;
+            const report = ++presenceReportRef.current;
+            if (!active)
+                setPresenceAwake(null);
             const keepalive = !active && presencePageExitRef.current;
-            void handle.presence({ tab_id, active, alerts }, { keepalive }).catch(() => { });
+            void handle
+                .presence({ tab_id, active, alerts }, { keepalive })
+                .then((res) => {
+                if (active && report === presenceReportRef.current && res.data) {
+                    setPresenceAwake(presenceAwakeFrom(res.data));
+                }
+            })
+                .catch(() => { });
         }, presenceAlertsRef.current);
         presenceReporterRef.current = reporter;
         const stop = watchHumanPresence({ doc: document, win: window }, reporter.report, () => sessionStreamConnected(projectId, sessionId), () => presencePageExitRef.current);
+        const refresh = window.setInterval(reporter.refresh, PRESENCE_AWAKE_REFRESH_MS);
         return () => {
+            window.clearInterval(refresh);
             presenceReporterRef.current = null;
             stop();
         };
-    }, [browserPresence, presenceTabId, projectId, sessionId]);
+    }, [browserPresence, presenceTabId, projectId, sessionId, queryClient]);
     useEffect(() => {
         presenceAlertsRef.current = presenceAlerts;
         presenceReporterRef.current?.setAlerts(presenceAlerts);
@@ -486,6 +521,17 @@ export function useSession(projectId, sessionId, options = {}) {
     const sandbox = startData?.sandbox ?? null;
     const startReady = stage === 'ready';
     const terminal = stage === 'failed' || stage === 'stopped';
+    const startReadyRef = useRef(startReady);
+    useEffect(() => {
+        if (startReady && !startReadyRef.current) {
+            presenceReporterRef.current?.refresh();
+        }
+        else if (!startReady && startReadyRef.current) {
+            presenceReportRef.current += 1;
+            setPresenceAwake(null);
+        }
+        startReadyRef.current = startReady;
+    }, [startReady]);
     useIsomorphicLayoutEffect(() => {
         if (!startEnabled)
             return;
@@ -550,7 +596,7 @@ export function useSession(projectId, sessionId, options = {}) {
     }, [startEnabled, switchedBoxId, refetchStart]);
     useRuntimeEventStream({ enabled: switched, projectId, sessionId });
     const transcriptHistoryEnabled = startEnabled && chatEngine;
-    useSessionLogSync(projectId, sessionId, { enabled: transcriptHistoryEnabled });
+    useSessionLogSync(projectId, sessionId, { enabled: startEnabled });
     const transcriptHistory = useSessionTranscriptHistory(projectId, sessionId, transcriptHistoryEnabled);
     const canonicalSession = useCanonicalRuntimeSession({
         projectId,
@@ -569,11 +615,24 @@ export function useSession(projectId, sessionId, options = {}) {
         enabled,
         runtimeSessionId: ocSessionId,
     });
+    const canStop = useSessionCanStop(projectId, sessionId);
+    const turnRunning = working.state === 'working';
+    const turnRanRef = useRef(turnRunning);
+    useEffect(() => {
+        if (turnRunning) {
+            presenceReportRef.current += 1;
+            setPresenceAwake(null);
+        }
+        else if (turnRanRef.current) {
+            presenceReporterRef.current?.refresh();
+        }
+        turnRanRef.current = turnRunning;
+    }, [turnRunning]);
     const { noteSendReceipt, acceptSendReceipt, clearSendReceipt } = useSessionWorkingStore.getState();
     const rawSync = useSessionSync(chatEngine ? ocSessionId : '', {
         beeuniSessionScope: `${projectId}/${sessionId}`,
         streamConnected,
-        mirror: transcriptHistory.envelope ?? undefined,
+        mirror: transcriptHistory.envelope,
         networkEnabled: switched,
         working: working.state === 'working',
         serverHoldsTurn: working.serverOpenTurnToken !== null,
@@ -591,6 +650,25 @@ export function useSession(projectId, sessionId, options = {}) {
     const messages = useMemo(() => messagesBeforeRewind(sync.messages, restRewind), [sync.messages, restRewind]);
     const turnOutcome = useSessionTurnOutcome(projectId, sessionId);
     const turnRead = typeof turnOutcome.atMs === 'number';
+    const lastEndedToken = turnOutcome.last_ended?.turn_token ?? null;
+    const lastEndedSeenRef = useRef(undefined);
+    useEffect(() => {
+        if (!turnRead)
+            return;
+        const seen = lastEndedSeenRef.current;
+        lastEndedSeenRef.current = lastEndedToken;
+        if (seen !== undefined && seen !== lastEndedToken)
+            presenceReporterRef.current?.refresh();
+    }, [turnRead, lastEndedToken]);
+    useTurnEndHandoff({
+        enabled,
+        projectId,
+        sessionId,
+        runtimeSessionId: ocSessionId || null,
+        working: turnRunning,
+        openTurnToken: working.serverOpenTurnToken,
+        lastEndedToken,
+    });
     const savedEmptyRoot = transcriptHistoryEnabled ? transcriptHistory.emptyRootSessionId : null;
     const emptyProvenForRoot = savedEmptyRoot !== null && savedEmptyRoot === ocSessionId;
     const savedTranscript = resolveSavedTranscript({
@@ -857,6 +935,8 @@ export function useSession(projectId, sessionId, options = {}) {
         runtimePhase,
         working,
         isBusy: working.state === 'working',
+        canStop,
+        presenceAwake,
         isCompacting,
         isLoading: sync.isLoading,
         savedTranscript,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@beeuni/sdk",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Official Beeuni TypeScript SDK. Connect your product to Beeuni Computer with typed projects, sessions, tools, files, and live agent streaming.",
   "type": "module",
   "license": "Elastic-2.0",
@@ -14,19 +14,27 @@
   ],
   "sideEffects": false,
   "dependencies": {
-    "@beeuni/llm-catalog": "0.2.0",
+    "@beeuni/llm-catalog": "0.3.0",
     "zustand": "^5.0.3"
   },
   "peerDependencies": {
+    "@openuidev/lang-core": "0.3.1",
     "@tanstack/react-query": "^5.75.2",
-    "react": ">=18"
+    "react": ">=18",
+    "zod": "^3.25.0 || ^4.0.0"
   },
   "peerDependenciesMeta": {
+    "@openuidev/lang-core": {
+      "optional": true
+    },
     "@tanstack/react-query": {
       "optional": true
     },
     "react": {
       "optional": true
+    },
+    "zod": {
+      "optional": true
     }
   },
   "main": "./dist/index.js",
@@ -40,6 +48,18 @@
       "types": "./dist/react/index.d.ts",
       "import": "./dist/react/index.js"
     },
+    "./genui": {
+      "types": "./dist/genui/index.d.ts",
+      "import": "./dist/genui/index.js"
+    },
+    "./genui/fence": {
+      "types": "./dist/genui/fence-entry.d.ts",
+      "import": "./dist/genui/fence-entry.js"
+    },
+    "./genui/react": {
+      "types": "./dist/genui/react/index.d.ts",
+      "import": "./dist/genui/react/index.js"
+    },
     "./server": {
       "types": "./dist/node/server.d.ts",
       "import": "./dist/node/server.js"
@@ -108,6 +128,10 @@
       "types": "./dist/deprecated/feature-flags.d.ts",
       "import": "./dist/deprecated/feature-flags.js"
     },
+    "./capture-rules": {
+      "types": "./dist/core/capture/rules.d.ts",
+      "import": "./dist/core/capture/rules.js"
+    },
     "./fresh-sessions": {
       "types": "./dist/deprecated/fresh-sessions.d.ts",
       "import": "./dist/deprecated/fresh-sessions.js"
@@ -180,6 +204,28 @@
     "dist",
     "README.md"
   ],
+  "scripts": {
+    "typecheck": "tsc --noEmit && tsc --noEmit -p examples/tsconfig.json",
+    "test": "find src \\( -name '*.test.ts' -o -name '*.test.tsx' \\) -print0 | sort -z | xargs -0 -n1 -P4 bun test --isolate",
+    "build": "tsc -p tsconfig.build.json && tsc-alias -p tsconfig.build.json --resolve-full-paths",
+    "build:bundles": "pnpm run build && tsup",
+    "prepublishOnly": "tsc -p tsconfig.build.json && tsc-alias -p tsconfig.build.json --resolve-full-paths && tsup",
+    "smoke:install": "node scripts/smoke-install.mjs"
+  },
+  "devDependencies": {
+    "@openuidev/lang-core": "0.3.1",
+    "@tanstack/react-query": "^5.75.2",
+    "@types/react": "^19.2.0",
+    "@types/react-dom": "^19.2.3",
+    "@types/react-test-renderer": "^19.1.0",
+    "react": "^19.2.0",
+    "react-dom": "^19.2.0",
+    "react-test-renderer": "^19.2.0",
+    "tsc-alias": "^1.8.17",
+    "tsup": "^8.5.1",
+    "typescript": "^5.4.0",
+    "zod": "3.25.76"
+  },
   "browser": "./dist/beeuni.esm.min.js",
   "unpkg": "./dist/beeuni.global.js",
   "jsdelivr": "./dist/beeuni.global.js"