govon 1.2.2 → 1.4.0

package/dist/hooks/useSSE.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSSE.d.ts","sourceRoot":"","sources":["../../src/hooks/useSSE.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,KAAK,EAA0B,MAAM,EAAE,MAAM,aAAa,CAAC;AAOlE,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,WAAW,CAAC;IACpB,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACjC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,YAAY;IAC3B,8EAA8E;IAC9E,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,+CAA+C;IAC/C,MAAM,EAAE,MAAM,IAAI,CAAC;CACpB;AAMD,wBAAgB,MAAM,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE,aAAa,GAAG,YAAY,CAiJnF"}

package/dist/hooks/useSSE.js

@@ -0,0 +1,341 @@
+/**
+ * useSSE — React hook managing the SSE streaming lifecycle.
+ *
+ * Mirrors the fallback chain in src/cli/shell.py _try_process_query (lines 164-202):
+ *   1. Try v3 fine-grained streaming  (client.streamV3)
+ *   2. On failure → try v2 node-level streaming  (client.stream)
+ *   3. On failure → try blocking run  (client.run)
+ *
+ * Cancellation is handled via an AbortController stored in a ref.
+ * The controller.signal is forwarded to every client call so that aborting the
+ * controller immediately cancels the underlying fetch (no zombie requests).
+ *
+ * An unmount guard (mountedRef) prevents dispatching into unmounted components.
+ */
+import { useCallback, useEffect, useRef } from 'react';
+import { NODE_STATUS_MESSAGES } from '../types.js';
+// ---------------------------------------------------------------------------
+// Hook implementation
+// ---------------------------------------------------------------------------
+export function useSSE({ client, dispatch, sessionId }) {
+    /** Holds the AbortController for the current in-flight request. */
+    const abortRef = useRef(null);
+    /**
+     * Unmount guard — set to false when the component unmounts.
+     * All async callbacks check this before dispatching to avoid state updates
+     * on unmounted components (which would leak memory and produce React warnings).
+     */
+    const mountedRef = useRef(true);
+    useEffect(() => {
+        mountedRef.current = true;
+        return () => {
+            mountedRef.current = false;
+        };
+    }, []);
+    /**
+     * Safe dispatch — drops the action if the component has already unmounted.
+     * All internal helpers receive this wrapper instead of the raw dispatch.
+     */
+    const safeDispatch = useCallback((action) => {
+        if (mountedRef.current)
+            dispatch(action);
+    }, [dispatch]);
+    // -------------------------------------------------------------------------
+    // cancel — abort the current streaming request
+    // -------------------------------------------------------------------------
+    const cancel = useCallback(() => {
+        if (abortRef.current) {
+            abortRef.current.abort();
+            abortRef.current = null;
+        }
+    }, []);
+    // -------------------------------------------------------------------------
+    // submit — attempt v3 → v2 → blocking, dispatch actions along the way
+    // -------------------------------------------------------------------------
+    const submit = useCallback(async (query) => {
+        // Cancel any previous in-flight request before starting a new one.
+        cancel();
+        const controller = new AbortController();
+        abortRef.current = controller;
+        // Guard against stale cleanup: if a newer submit() starts while this
+        // one is still unwinding, we must not null out the newer controller.
+        const isCurrentRun = () => abortRef.current === controller;
+        // Stable message ID for the assistant slot opened before streaming begins.
+        const assistantMsgId = crypto.randomUUID();
+        const timestamp = new Date().toISOString();
+        const sid = sessionId ?? undefined;
+        safeDispatch({ type: 'SET_LOADING', payload: true });
+        safeDispatch({ type: 'SET_ERROR', payload: null });
+        safeDispatch({
+            type: 'START_ASSISTANT_MESSAGE',
+            payload: { id: assistantMsgId, timestamp },
+        });
+        // ------------------------------------------------------------------
+        // Path 1: v3 fine-grained streaming
+        // ------------------------------------------------------------------
+        const { success: v3Success, contentDispatched: v3ContentDispatched } = await _tryV3(client, query, sid, assistantMsgId, controller, safeDispatch);
+        if (v3Success) {
+            safeDispatch({ type: 'SET_API_VERSION', payload: 'v3' });
+            safeDispatch({ type: 'SET_LOADING', payload: false });
+            if (isCurrentRun())
+                abortRef.current = null;
+            return;
+        }
+        // Bail out immediately if the user cancelled.
+        if (controller.signal.aborted) {
+            safeDispatch({ type: 'SET_LOADING', payload: false });
+            if (isCurrentRun())
+                abortRef.current = null;
+            return;
+        }
+        // If v3 emitted content tokens before failing, the message buffer is
+        // already partially written. Falling through to v2 would corrupt it by
+        // appending v2 content on top of the partial v3 content. Treat this as
+        // a terminal error instead.
+        if (v3ContentDispatched) {
+            safeDispatch({
+                type: 'SET_ERROR',
+                payload: 'Streaming interrupted after partial response — please retry.',
+            });
+            safeDispatch({ type: 'SET_LOADING', payload: false });
+            if (isCurrentRun())
+                abortRef.current = null;
+            return;
+        }
+        // ------------------------------------------------------------------
+        // Path 2: v2 node-level streaming
+        // ------------------------------------------------------------------
+        const v2Success = await _tryV2(client, query, sid, assistantMsgId, controller, safeDispatch);
+        if (v2Success) {
+            safeDispatch({ type: 'SET_API_VERSION', payload: 'v2' });
+            safeDispatch({ type: 'SET_LOADING', payload: false });
+            if (isCurrentRun())
+                abortRef.current = null;
+            return;
+        }
+        if (controller.signal.aborted) {
+            safeDispatch({ type: 'SET_LOADING', payload: false });
+            if (isCurrentRun())
+                abortRef.current = null;
+            return;
+        }
+        // ------------------------------------------------------------------
+        // Path 3: blocking run
+        // ------------------------------------------------------------------
+        await _tryBlocking(client, query, sid, assistantMsgId, controller, safeDispatch);
+        safeDispatch({ type: 'SET_LOADING', payload: false });
+        if (isCurrentRun())
+            abortRef.current = null;
+    }, [client, safeDispatch, sessionId, cancel]);
+    return { submit, cancel };
+}
+/**
+ * Attempt v3 SSE streaming. Returns a V3Result describing the outcome.
+ *
+ * Returns success=true only on a clean run_complete event.
+ * Returns success=false, contentDispatched=false on network/HTTP exceptions
+ *   (safe to fall through to v2).
+ * Returns success=false, contentDispatched=false when an explicit `error`
+ *   event is received — the error is already dispatched and the caller
+ *   should NOT fall through (the event is a terminal server-side error).
+ *   We signal this by returning success=false but we still set contentDispatched
+ *   to true so the caller surfaces the error rather than trying v2.
+ */
+async function _tryV3(client, query, sessionId, assistantMsgId, controller, dispatch) {
+    let contentDispatched = false;
+    try {
+        for await (const raw of client.streamV3(query, sessionId, undefined, controller.signal)) {
+            // Respect cancellation mid-stream.
+            if (controller.signal.aborted)
+                return { success: false, contentDispatched };
+            const event = raw;
+            switch (event.type) {
+                case 'thinking_start':
+                    dispatch({
+                        type: 'START_THINKING_STEP',
+                        payload: { iteration: event.iteration },
+                    });
+                    break;
+                case 'thinking_delta':
+                    contentDispatched = true;
+                    dispatch({
+                        type: 'APPEND_STREAMING_THINKING',
+                        payload: event.content,
+                    });
+                    break;
+                case 'thinking_end':
+                    dispatch({
+                        type: 'END_THINKING_STEP',
+                        payload: { iteration: event.iteration, tool_calls: event.tool_calls },
+                    });
+                    break;
+                case 'tool_start':
+                    dispatch({
+                        type: 'MARK_TOOL_START',
+                        payload: { tool: event.tool },
+                    });
+                    break;
+                case 'tool_end':
+                    dispatch({
+                        type: 'MARK_TOOL_END',
+                        payload: { tool: event.tool, success: event.success },
+                    });
+                    break;
+                case 'response_delta':
+                    contentDispatched = true;
+                    dispatch({
+                        type: 'APPEND_STREAMING_CONTENT',
+                        payload: event.content,
+                    });
+                    break;
+                case 'run_complete':
+                    dispatch({
+                        type: 'FINALIZE_ASSISTANT_MESSAGE',
+                        payload: {
+                            messageId: assistantMsgId,
+                            content: event.text,
+                            evidence: event.evidence_items,
+                            metadata: event.metadata,
+                            sessionId: event.session_id,
+                            threadId: event.thread_id,
+                        },
+                    });
+                    // run_complete signals a clean finish — return success immediately.
+                    return { success: true, contentDispatched };
+                case 'error':
+                    // An explicit server-side error event is a terminal state.
+                    // Dispatch the error and signal the caller NOT to fall through by
+                    // returning contentDispatched=true (treated as "buffer tainted").
+                    dispatch({ type: 'SET_ERROR', payload: event.error });
+                    return { success: false, contentDispatched: true };
+                default:
+                    // Unknown event type — ignore and continue streaming.
+                    break;
+            }
+        }
+        // Generator exhausted without a run_complete event — treat as failure.
+        // contentDispatched reflects whether any tokens were written.
+        return { success: false, contentDispatched };
+    }
+    catch (_err) {
+        // Network error, HTTP non-2xx, abort, or JSON parse failure from the client.
+        return { success: false, contentDispatched };
+    }
+}
+/**
+ * Attempt v2 node-level SSE streaming. Returns true on clean completion,
+ * false on error so the caller can fall through to the blocking path.
+ */
+async function _tryV2(client, query, sessionId, assistantMsgId, controller, dispatch) {
+    try {
+        for await (const raw of client.stream(query, sessionId, controller.signal)) {
+            if (controller.signal.aborted)
+                return false;
+            const event = raw;
+            const { node, status } = event;
+            // Update the status bar label for recognised node transitions.
+            const statusMsg = NODE_STATUS_MESSAGES[node];
+            if (statusMsg !== undefined) {
+                dispatch({ type: 'SET_STATUS_LABEL', payload: statusMsg });
+            }
+            if (node === 'agent' && status === 'completed') {
+                if (event.planned_tools && event.planned_tools.length > 0) {
+                    // Agent has decided which tools to call next.
+                    dispatch({
+                        type: 'SET_STATUS_LABEL',
+                        payload: `도구 실행 예정: ${event.planned_tools.join(', ')}`,
+                    });
+                }
+                // When final_text is present, the agent run finished on this node.
+                if (event.final_text !== undefined) {
+                    dispatch({
+                        type: 'FINALIZE_ASSISTANT_MESSAGE',
+                        payload: {
+                            messageId: assistantMsgId,
+                            content: event.final_text,
+                            evidence: event.evidence_items ?? [],
+                            metadata: {},
+                            sessionId: event.session_id ?? '',
+                            threadId: event.thread_id ?? '',
+                        },
+                    });
+                    return true;
+                }
+            }
+            if (node === 'tools' && status === 'completed') {
+                // Tool node finished — update status label; individual tool tracking
+                // is not available at v2 granularity so we only set the label.
+                dispatch({ type: 'SET_STATUS_LABEL', payload: '도구 실행 완료' });
+            }
+            if (node === 'approval_wait' && status === 'awaiting_approval') {
+                if (event.approval_request !== undefined) {
+                    dispatch({
+                        type: 'SET_PENDING_APPROVAL',
+                        payload: event.approval_request,
+                    });
+                }
+            }
+            if (node === 'persist' && status === 'completed') {
+                if (event.final_text !== undefined) {
+                    dispatch({
+                        type: 'FINALIZE_ASSISTANT_MESSAGE',
+                        payload: {
+                            messageId: assistantMsgId,
+                            content: event.final_text,
+                            evidence: event.evidence_items ?? [],
+                            metadata: {},
+                            sessionId: event.session_id ?? '',
+                            threadId: event.thread_id ?? '',
+                        },
+                    });
+                    return true;
+                }
+            }
+            if (node === 'error') {
+                dispatch({
+                    type: 'SET_ERROR',
+                    payload: event.error ?? 'Unknown error from v2 stream',
+                });
+                return false;
+            }
+        }
+        // Generator exhausted without a persist/agent run_complete event.
+        return false;
+    }
+    catch (_err) {
+        // Network/HTTP error or abort — try next path.
+        return false;
+    }
+}
+/**
+ * Attempt the blocking /v2/agent/run endpoint as a last resort.
+ * Dispatches FINALIZE on success, SET_ERROR on failure.
+ */
+async function _tryBlocking(client, query, sessionId, assistantMsgId, controller, dispatch) {
+    if (controller.signal.aborted)
+        return;
+    try {
+        const result = await client.run(query, sessionId, controller.signal);
+        if (controller.signal.aborted)
+            return;
+        dispatch({
+            type: 'FINALIZE_ASSISTANT_MESSAGE',
+            payload: {
+                messageId: assistantMsgId,
+                content: result.text,
+                evidence: result.evidence_items ?? [],
+                metadata: result.metadata ?? {},
+                sessionId: result.session_id,
+                threadId: result.thread_id ?? '',
+            },
+        });
+        dispatch({ type: 'SET_API_VERSION', payload: 'v2' });
+    }
+    catch (err) {
+        if (controller.signal.aborted)
+            return;
+        const msg = err instanceof Error ? err.message : String(err);
+        dispatch({ type: 'SET_ERROR', payload: msg });
+    }
+}
+//# sourceMappingURL=useSSE.js.map

package/dist/hooks/useSSE.js.map

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

package/dist/hooks/useTheme.d.ts

@@ -0,0 +1,39 @@
+/**
+ * useTheme — resolves brand color tokens from the runtime environment.
+ *
+ * Respects the NO_COLOR convention (https://no-color.org/):
+ * when NO_COLOR is set to any value (including empty string), all color
+ * tokens are returned as empty strings so callers can safely pass them
+ * to Ink's <Text color="..."> prop without emitting ANSI sequences.
+ *
+ * RESOLVED_THEME is computed once at module load time because
+ * process.env values never change at runtime.
+ */
+/** Brand color tokens used throughout the TUI. */
+export interface ThemeTokens {
+    /** Primary brand green — main interactive elements. */
+    primary: string;
+    /** Accent warm sand — highlights and callouts. */
+    accent: string;
+    /** Muted sage — secondary text and borders. */
+    muted: string;
+    /** Error red — destructive actions and error messages. */
+    error: string;
+    /** Warning amber — non-critical warnings. */
+    warning: string;
+    /** Success green — confirmation and done states. */
+    success: string;
+    /** Info blue — informational badges and labels. */
+    info: string;
+    /** Dimmed grey — disabled states and placeholders. */
+    dimmed: string;
+}
+/**
+ * Returns resolved theme color tokens for the current runtime environment.
+ *
+ * Usage:
+ *   const theme = useTheme();
+ *   <Text color={theme.primary}>Hello</Text>
+ */
+export declare function useTheme(): ThemeTokens;
+//# sourceMappingURL=useTheme.d.ts.map

package/dist/hooks/useTheme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTheme.d.ts","sourceRoot":"","sources":["../../src/hooks/useTheme.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAQH,kDAAkD;AAClD,MAAM,WAAW,WAAW;IAC1B,uDAAuD;IACvD,OAAO,EAAE,MAAM,CAAC;IAChB,kDAAkD;IAClD,MAAM,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,KAAK,EAAE,MAAM,CAAC;IACd,0DAA0D;IAC1D,KAAK,EAAE,MAAM,CAAC;IACd,6CAA6C;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,oDAAoD;IACpD,OAAO,EAAE,MAAM,CAAC;IAChB,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,sDAAsD;IACtD,MAAM,EAAE,MAAM,CAAC;CAChB;AAmBD;;;;;;GAMG;AACH,wBAAgB,QAAQ,IAAI,WAAW,CAEtC"}

package/dist/hooks/useTheme.js

@@ -0,0 +1,36 @@
+/**
+ * useTheme — resolves brand color tokens from the runtime environment.
+ *
+ * Respects the NO_COLOR convention (https://no-color.org/):
+ * when NO_COLOR is set to any value (including empty string), all color
+ * tokens are returned as empty strings so callers can safely pass them
+ * to Ink's <Text color="..."> prop without emitting ANSI sequences.
+ *
+ * RESOLVED_THEME is computed once at module load time because
+ * process.env values never change at runtime.
+ */
+import { THEME_COLORS } from '../config.js';
+// ---------------------------------------------------------------------------
+// Module-level constants (computed once, never re-evaluated)
+// ---------------------------------------------------------------------------
+const EMPTY_TOKENS = {
+    primary: '', accent: '', muted: '', error: '',
+    warning: '', success: '', info: '', dimmed: '',
+};
+const RESOLVED_THEME = process.env.NO_COLOR !== undefined
+    ? EMPTY_TOKENS
+    : { ...THEME_COLORS };
+// ---------------------------------------------------------------------------
+// Hook
+// ---------------------------------------------------------------------------
+/**
+ * Returns resolved theme color tokens for the current runtime environment.
+ *
+ * Usage:
+ *   const theme = useTheme();
+ *   <Text color={theme.primary}>Hello</Text>
+ */
+export function useTheme() {
+    return RESOLVED_THEME;
+}
+//# sourceMappingURL=useTheme.js.map

package/dist/hooks/useTheme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTheme.js","sourceRoot":"","sources":["../../src/hooks/useTheme.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AA0B5C,8EAA8E;AAC9E,6DAA6D;AAC7D,8EAA8E;AAE9E,MAAM,YAAY,GAAgB;IAChC,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE;IAC7C,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE;CAC/C,CAAC;AAEF,MAAM,cAAc,GAAgB,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,SAAS;IACpE,CAAC,CAAC,YAAY;IACd,CAAC,CAAC,EAAE,GAAG,YAAY,EAAE,CAAC;AAExB,8EAA8E;AAC9E,OAAO;AACP,8EAA8E;AAE9E;;;;;;GAMG;AACH,MAAM,UAAU,QAAQ;IACtB,OAAO,cAAc,CAAC;AACxB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * index.tsx — CLI entry point for the GovOn npm TUI.
+ *
+ * Parses CLI arguments with yargs and renders the <App /> component via Ink.
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.tsx"],"names":[],"mappings":"AAAA;;;;GAIG"}