govon 1.2.2 → 1.4.0

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.tsx"],"names":[],"mappings":";AAOA,OAAO,EAAE,MAAM,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAE/B,4EAA4E;AAC5E,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,GAAG,GAAG,OAAO,CAAC,iBAAiB,CAAwB,CAAC;AAE9D,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;KACtC,UAAU,CAAC,OAAO,CAAC;KACnB,KAAK,CAAC,YAAY,EAAE,kDAAkD,CAAC;KACvE,UAAU,CAAC,OAAO,EAAE;IACnB,IAAI,EAAE,QAAQ;IACd,QAAQ,EAAE,qCAAqC;CAChD,CAAC;KACD,MAAM,CAAC,SAAS,EAAE;IACjB,KAAK,EAAE,GAAG;IACV,IAAI,EAAE,SAAS;IACf,QAAQ,EAAE,cAAc;CACzB,CAAC;KACD,IAAI,EAAE;KACN,SAAS,EAAE,CAAC;AAEf,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;IACjB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IACzC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,6DAA6D;AAC7D,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAuB,CAAC;AAE9C,MAAM,CAAC,KAAC,GAAG,IAAC,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,YAAY,EAAE,KAAK,GAAI,CAAC,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,356 @@
+/**
+ * types.ts — All shared TypeScript types for the GovOn npm TUI.
+ *
+ * Covers:
+ *  - V3 SSE event discriminated union (fine-grained streaming)
+ *  - V2 SSE event interface (coarse node-level streaming)
+ *  - Chat message model (user / assistant with thinking & tools)
+ *  - ApprovalRequest / ApprovalResponse
+ *  - EvidenceItem / RunMetadata
+ *  - AgentRunRequest / AgentRunResponse / AgentTrace / ToolResult
+ *  - Theme
+ *  - AppState + Action discriminated union for the reducer
+ *  - Exported const maps: NODE_STATUS_MESSAGES, TASK_TYPE_LABELS,
+ *    TASK_TYPE_STYLES, TOOL_DISPLAY_NAMES
+ */
+/** A single piece of evidence returned by the agent after a run. */
+export interface EvidenceItem {
+    /** Origin of the evidence. */
+    source_type: "rag" | "api" | "llm_generated";
+    /** Human-readable content excerpt or summary. */
+    content: string;
+    /** Relevance / confidence score in [0, 1]. */
+    score?: number;
+    /** Arbitrary extra fields from the backend (e.g. chunk_id, url). */
+    metadata?: Record<string, unknown>;
+}
+/** Metadata attached to a completed agent run (v3 run_complete event). */
+export interface RunMetadata {
+    total_iterations?: number;
+    total_tool_calls?: number;
+    total_latency_ms?: number;
+    node_latencies?: Record<string, number>;
+}
+/** A single tool call record embedded in a thinking_end event. */
+export interface ToolCall {
+    name: string;
+    args: Record<string, unknown>;
+}
+export interface V3ThinkingStartEvent {
+    type: "thinking_start";
+    /** ReAct loop iteration number (1-based). */
+    iteration: number;
+}
+export interface V3ThinkingDeltaEvent {
+    type: "thinking_delta";
+    /** Partial LLM token chunk emitted during tool-call reasoning. */
+    content: string;
+}
+export interface V3ThinkingEndEvent {
+    type: "thinking_end";
+    /** Tool calls the agent decided to make after this reasoning step. */
+    tool_calls: ToolCall[];
+    /** ReAct loop iteration number (1-based). */
+    iteration: number;
+}
+export interface V3ToolStartEvent {
+    type: "tool_start";
+    /** Name of the tool being invoked. */
+    tool: string;
+}
+export interface V3ToolEndEvent {
+    type: "tool_end";
+    /** Name of the tool that finished. */
+    tool: string;
+    /** Whether the tool call succeeded. */
+    success?: boolean;
+}
+export interface V3ResponseDeltaEvent {
+    type: "response_delta";
+    /** Partial final-answer token chunk (no tool_calls in flight). */
+    content: string;
+}
+export interface V3RunCompleteEvent {
+    type: "run_complete";
+    thread_id: string;
+    session_id: string;
+    /** Full final answer text. */
+    text: string;
+    evidence_items: EvidenceItem[];
+    metadata: RunMetadata;
+}
+export interface V3ErrorEvent {
+    type: "error";
+    error: string;
+}
+/** Discriminated union of all V3 SSE event shapes. */
+export type V3SSEEvent = V3ThinkingStartEvent | V3ThinkingDeltaEvent | V3ThinkingEndEvent | V3ToolStartEvent | V3ToolEndEvent | V3ResponseDeltaEvent | V3RunCompleteEvent | V3ErrorEvent;
+/** A pending human-approval request embedded in a V2 event. */
+export interface ApprovalRequest {
+    /** Unique identifier for this approval gate. */
+    approval_id: string;
+    /** Task type key (see TASK_TYPE_LABELS for human-readable label). */
+    task_type: string;
+    /** Short description of what the agent wants to do. */
+    description?: string;
+    /** Tools the agent plans to call if approved. */
+    planned_tools?: string[];
+    /** Arbitrary structured context the UI may render. */
+    context?: Record<string, unknown>;
+}
+/** Coarse node-level event emitted by the V2 streaming endpoint. */
+export interface V2SSEEvent {
+    /** Graph node name (e.g. "agent", "tools", "approval_wait"). */
+    node: string;
+    status: "completed" | "awaiting_approval" | "error" | (string & {});
+    /** Full answer text, present when node === "agent" and run is done. */
+    final_text?: string;
+    evidence_items?: EvidenceItem[];
+    /** Task type key for display purposes. */
+    task_type?: string;
+    approval_request?: ApprovalRequest;
+    thread_id?: string;
+    session_id?: string;
+    error?: string;
+    /** Raw tool outputs keyed by tool name. */
+    tool_results?: Record<string, unknown>;
+    /** Tools the agent plans to call next. */
+    planned_tools?: string[];
+}
+/** Request body sent to both /v2/agent/stream and /v3/agent/stream. */
+export interface AgentRunRequest {
+    /** User query (1–10 000 chars). */
+    query: string;
+    /** Existing session to continue; omit to start a new session. */
+    session_id?: string;
+    /** Whether to stream the response via SSE (default: true). */
+    stream?: boolean;
+    /** Force specific tools to be called. */
+    force_tools?: string[];
+    /** Max tokens for the LLM response (default 512, max 4096). */
+    max_tokens?: number;
+    /** Sampling temperature (default 0.7, range 0–2). */
+    temperature?: number;
+    /** Max ReAct iterations (default 10, range 1–20). */
+    max_iterations?: number;
+}
+/** A single tool invocation record inside an AgentTrace. Matches backend ToolResultSchema. */
+export interface ToolResult {
+    tool: string;
+    success: boolean;
+    latency_ms: number;
+    data: Record<string, unknown>;
+    error?: string;
+}
+/** Full reasoning trace for a single agent run. Matches backend AgentTraceSchema. */
+export interface AgentTrace {
+    request_id: string;
+    session_id: string;
+    plan: string[];
+    plan_reason: string;
+    tool_results: ToolResult[];
+    total_latency_ms: number;
+    error?: string;
+}
+/** Non-streaming response returned by the agent endpoint. */
+export interface AgentRunResponse {
+    request_id: string;
+    session_id: string;
+    text: string;
+    trace: AgentTrace;
+    /** Present in v2 stream approval events, absent in blocking run. */
+    thread_id?: string;
+    /** Present in v2 blocking run responses. */
+    graph_run_id?: string;
+    evidence_items?: EvidenceItem[];
+    metadata?: RunMetadata;
+}
+/** Response from POST /v2/agent/approve. */
+export interface ApprovalResponse {
+    status: "approved" | "rejected" | "error";
+    thread_id: string;
+    session_id: string;
+    graph_run_id?: string;
+    text?: string;
+    evidence_items?: EvidenceItem[];
+    /** "approved" | "rejected" mirroring top-level status. */
+    approval_status?: string;
+    error?: string;
+}
+/** A reasoning/thinking step displayed inside an assistant message. */
+export interface ThinkingStep {
+    /** Which ReAct iteration this step belongs to. */
+    iteration: number;
+    /** Accumulated thinking text for this step. */
+    content: string;
+    /** Tool calls decided at the end of this step. */
+    tool_calls?: ToolCall[];
+}
+/** A single tool invocation displayed inside an assistant message. */
+export interface ToolInvocation {
+    tool: string;
+    /** Whether the tool call is still running. */
+    pending: boolean;
+    success?: boolean;
+}
+/** A single message in the chat history. */
+export interface Message {
+    id: string;
+    role: "user" | "assistant";
+    /** Main text content (may be partial while streaming). */
+    content: string;
+    /** Thinking steps shown in a collapsible section. */
+    thinking?: ThinkingStep[];
+    /** Tool invocations shown inline. */
+    tools?: ToolInvocation[];
+    /** Evidence items shown after the answer. */
+    evidence?: EvidenceItem[];
+    /** Run metadata shown after the answer. */
+    metadata?: RunMetadata;
+    /** ISO-8601 timestamp. */
+    timestamp: string;
+    /** Whether streaming is still in progress. */
+    streaming?: boolean;
+    /** Error text, if this message represents a failure. */
+    error?: string;
+}
+export type Theme = "light" | "dark" | "system";
+/** Global application state managed by the reducer. */
+export interface AppState {
+    /** All messages in the current session. */
+    messages: Message[];
+    /** Whether the agent is currently processing a request. */
+    isLoading: boolean;
+    /** Current streaming text buffer (partial assistant response). */
+    streamingContent: string;
+    /** Current streaming thinking buffer. */
+    streamingThinking: string;
+    /** Pending thinking steps in the current run. */
+    pendingThinking: ThinkingStep[];
+    /** Active tool invocations in the current run. */
+    activeTools: ToolInvocation[];
+    /** Session ID from the backend (null until first run). */
+    sessionId: string | null;
+    /** Thread ID from the backend (null until first run). */
+    threadId: string | null;
+    /** Pending approval request, if any. */
+    pendingApproval: ApprovalRequest | null;
+    /** Current node/phase label shown in the status bar. */
+    statusLabel: string | null;
+    /** Last error message to surface in the UI. */
+    error: string | null;
+    /** Active color theme. */
+    theme: Theme;
+    /** Base URL of the GovOn backend. */
+    apiBase: string;
+    /** SSE protocol version in use. */
+    apiVersion: "v2" | "v3";
+}
+export interface SetLoadingAction {
+    type: "SET_LOADING";
+    payload: boolean;
+}
+export interface AddUserMessageAction {
+    type: "ADD_USER_MESSAGE";
+    payload: Pick<Message, "id" | "content" | "timestamp">;
+}
+/** Start a new assistant message slot for streaming. */
+export interface StartAssistantMessageAction {
+    type: "START_ASSISTANT_MESSAGE";
+    payload: Pick<Message, "id" | "timestamp">;
+}
+export interface AppendStreamingContentAction {
+    type: "APPEND_STREAMING_CONTENT";
+    payload: string;
+}
+export interface AppendStreamingThinkingAction {
+    type: "APPEND_STREAMING_THINKING";
+    payload: string;
+}
+export interface StartThinkingStepAction {
+    type: "START_THINKING_STEP";
+    payload: {
+        iteration: number;
+    };
+}
+export interface EndThinkingStepAction {
+    type: "END_THINKING_STEP";
+    payload: {
+        iteration: number;
+        tool_calls: ToolCall[];
+    };
+}
+export interface MarkToolStartAction {
+    type: "MARK_TOOL_START";
+    payload: {
+        tool: string;
+    };
+}
+export interface MarkToolEndAction {
+    type: "MARK_TOOL_END";
+    payload: {
+        tool: string;
+        success?: boolean;
+    };
+}
+export interface FinalizeAssistantMessageAction {
+    type: "FINALIZE_ASSISTANT_MESSAGE";
+    payload: {
+        messageId: string;
+        content: string;
+        evidence: EvidenceItem[];
+        metadata: RunMetadata;
+        sessionId: string;
+        threadId: string;
+    };
+}
+export interface SetPendingApprovalAction {
+    type: "SET_PENDING_APPROVAL";
+    payload: ApprovalRequest | null;
+}
+export interface SetStatusLabelAction {
+    type: "SET_STATUS_LABEL";
+    payload: string | null;
+}
+export interface SetErrorAction {
+    type: "SET_ERROR";
+    payload: string | null;
+}
+export interface SetThemeAction {
+    type: "SET_THEME";
+    payload: Theme;
+}
+export interface SetApiBaseAction {
+    type: "SET_API_BASE";
+    payload: string;
+}
+export interface SetApiVersionAction {
+    type: "SET_API_VERSION";
+    payload: "v2" | "v3";
+}
+export interface ResetSessionAction {
+    type: "RESET_SESSION";
+}
+/** Discriminated union of all reducer actions. */
+export type Action = SetLoadingAction | AddUserMessageAction | StartAssistantMessageAction | AppendStreamingContentAction | AppendStreamingThinkingAction | StartThinkingStepAction | EndThinkingStepAction | MarkToolStartAction | MarkToolEndAction | FinalizeAssistantMessageAction | SetPendingApprovalAction | SetStatusLabelAction | SetErrorAction | SetThemeAction | SetApiBaseAction | SetApiVersionAction | ResetSessionAction;
+/**
+ * Human-readable status messages for each V2 graph node.
+ * Displayed in the status bar while the corresponding node is active.
+ */
+export declare const NODE_STATUS_MESSAGES: Readonly<Record<string, string>>;
+/**
+ * Korean display labels for each task type key.
+ * Used in approval dialogs and history views.
+ */
+export declare const TASK_TYPE_LABELS: Readonly<Record<string, string>>;
+/**
+ * Terminal / Ink color name for each task type's badge.
+ * Values correspond to Ink's `<Text color="...">` prop.
+ */
+export declare const TASK_TYPE_STYLES: Readonly<Record<string, string>>;
+/**
+ * Human-readable display names for each tool identifier.
+ * Used in the tool-call inline UI within assistant messages.
+ */
+export declare const TOOL_DISPLAY_NAMES: Readonly<Record<string, string>>;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,67 @@
+/**
+ * types.ts — All shared TypeScript types for the GovOn npm TUI.
+ *
+ * Covers:
+ *  - V3 SSE event discriminated union (fine-grained streaming)
+ *  - V2 SSE event interface (coarse node-level streaming)
+ *  - Chat message model (user / assistant with thinking & tools)
+ *  - ApprovalRequest / ApprovalResponse
+ *  - EvidenceItem / RunMetadata
+ *  - AgentRunRequest / AgentRunResponse / AgentTrace / ToolResult
+ *  - Theme
+ *  - AppState + Action discriminated union for the reducer
+ *  - Exported const maps: NODE_STATUS_MESSAGES, TASK_TYPE_LABELS,
+ *    TASK_TYPE_STYLES, TOOL_DISPLAY_NAMES
+ */
+// ---------------------------------------------------------------------------
+// 8. Exported const maps  (sourced from renderer.py and approval_ui.py)
+// ---------------------------------------------------------------------------
+/**
+ * Human-readable status messages for each V2 graph node.
+ * Displayed in the status bar while the corresponding node is active.
+ */
+export const NODE_STATUS_MESSAGES = {
+    session_load: "세션 로드 중…",
+    agent: "에이전트 추론 중…",
+    approval_wait: "승인 대기 중…",
+    tools: "도구 실행 중…",
+    persist: "저장 중…",
+};
+/**
+ * Korean display labels for each task type key.
+ * Used in approval dialogs and history views.
+ */
+export const TASK_TYPE_LABELS = {
+    draft_response: "답변 초안 작성",
+    revise_response: "답변 수정",
+    lookup_stats: "통계 조회",
+    issue_detection: "이슈 탐지",
+    stats_query: "통계 조회",
+    keyword_analysis: "키워드 분석",
+    demographics_query: "인구통계 조회",
+    default: "일반 작업",
+};
+/**
+ * Terminal / Ink color name for each task type's badge.
+ * Values correspond to Ink's `<Text color="...">` prop.
+ */
+export const TASK_TYPE_STYLES = {
+    draft_response: "cyan",
+    revise_response: "blue",
+    lookup_stats: "magenta",
+    issue_detection: "yellow",
+    stats_query: "magenta",
+    keyword_analysis: "yellow",
+    demographics_query: "blueBright",
+    default: "cyan",
+};
+/**
+ * Human-readable display names for each tool identifier.
+ * Used in the tool-call inline UI within assistant messages.
+ */
+export const TOOL_DISPLAY_NAMES = {
+    stats_lookup: "민원 통계",
+    keyword_analyzer: "키워드 분석",
+    demographics_lookup: "인구통계",
+};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAyZH,8EAA8E;AAC9E,wEAAwE;AACxE,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAqC;IACpE,YAAY,EAAE,UAAU;IACxB,KAAK,EAAE,YAAY;IACnB,aAAa,EAAE,UAAU;IACzB,KAAK,EAAE,UAAU;IACjB,OAAO,EAAE,OAAO;CACR,CAAC;AAEX;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAqC;IAChE,cAAc,EAAE,UAAU;IAC1B,eAAe,EAAE,OAAO;IACxB,YAAY,EAAE,OAAO;IACrB,eAAe,EAAE,OAAO;IACxB,WAAW,EAAE,OAAO;IACpB,gBAAgB,EAAE,QAAQ;IAC1B,kBAAkB,EAAE,SAAS;IAC7B,OAAO,EAAE,OAAO;CACR,CAAC;AAEX;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAqC;IAChE,cAAc,EAAE,MAAM;IACtB,eAAe,EAAE,MAAM;IACvB,YAAY,EAAE,SAAS;IACvB,eAAe,EAAE,QAAQ;IACzB,WAAW,EAAE,SAAS;IACtB,gBAAgB,EAAE,QAAQ;IAC1B,kBAAkB,EAAE,YAAY;IAChC,OAAO,EAAE,MAAM;CACP,CAAC;AAEX;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAqC;IAClE,YAAY,EAAE,OAAO;IACrB,gBAAgB,EAAE,QAAQ;IAC1B,mBAAmB,EAAE,MAAM;CACnB,CAAC"}

package/package.json

@@ -1,14 +1,33 @@
 {
   "name": "govon",
-  "version": "1.2.2",
-  "description": "npm wrapper for the GovOn CLI — Shell-first local agentic runtime for administrative assistance and civil complaint workflows",
+  "version": "1.4.0",
+  "description": "GovOn CLI — Agentic TUI for Korean civil complaint assistance powered by React + Ink",
+  "type": "module",
+  "bin": {
+    "govon": "./bin/govon.js"
+  },
+  "scripts": {
+    "build": "tsc && node esbuild.config.mjs",
+    "dev": "tsc --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "files": [
+    "bin/",
+    "dist/",
+    "README.md"
+  ],
   "keywords": [
     "govon",
-    "agentic-shell",
-    "local-runtime",
-    "civil-complaint",
+    "agentic-tui",
+    "cli",
     "korean-nlp",
-    "cli"
+    "civil-complaint",
+    "react-ink"
   ],
   "homepage": "https://github.com/GovOn-Org/GovOn#readme",
   "bugs": {
@@ -20,18 +39,25 @@
     "directory": "packages/npm"
   },
   "license": "MIT",
-  "bin": {
-    "govon": "./bin/govon.js"
-  },
-  "scripts": {
-    "postinstall": "node ./bin/govon.js --check-install || true"
+  "dependencies": {
+    "cli-highlight": "^2.1.11",
+    "eventsource-parser": "^3.0.0",
+    "ink": "^5.2.0",
+    "ink-spinner": "^5.0.0",
+    "ink-text-input": "^6.0.0",
+    "marked": "^15.0.0",
+    "marked-terminal": "^7.3.0",
+    "react": "^18.3.1",
+    "yargs": "^17.7.2"
   },
-  "engines": {
-    "node": ">=18"
-  },
-  "files": [
-    "bin/",
-    "lib/",
-    "README.md"
-  ]
+  "devDependencies": {
+    "@types/node": "^25.5.2",
+    "@types/react": "^18.3.0",
+    "@types/yargs": "^17.0.33",
+    "esbuild": "^0.25.0",
+    "ink-testing-library": "^4.0.0",
+    "postject": "^1.0.0-alpha.6",
+    "typescript": "^5.7.0",
+    "vitest": "^3.1.0"
+  }
 }

package/README.md

@@ -1,45 +0,0 @@
-# govon (npm)
-
-npm wrapper for the [GovOn](https://github.com/umyunsang/GovOn) CLI.
-
-GovOn is a shell-first local agent runtime for administrative support and civil complaint processing workflows.
-
-## Requirements
-
-- **Node.js** 18 or later
-- **Python** 3.10 or later
-- **pip** (Python package manager)
-
-## Installation
-
-```bash
-npm install -g govon
-```
-
-After installation the Python environment is automatically verified.  
-If the `govon` Python package is not installed, install it with:
-
-```bash
-pip install govon
-```
-
-## Usage
-
-```bash
-govon --help
-```
-
-## How It Works
-
-This package is a thin wrapper around the Python CLI (`govon`).
-
-1. When the `govon` command is run, it checks whether Python 3.10+ is installed.
-2. It verifies that the `govon` CLI (`pip install govon`) is installed.
-3. If all conditions are met, execution is delegated to the Python CLI via `child_process.spawn`.
-4. If conditions are not met, a clear installation guide message is printed and the process exits.
-
-> Automatic Python installation is not supported due to security and permission concerns.
-
-## License
-
-MIT