@nac3/forge-cli 0.2.0-alpha.9 → 0.2.1-alpha.60

package/dist/chat/claude_cli.d.ts

@@ -0,0 +1,145 @@
+/**
+ * Yujin Forge -- Claude Code CLI subprocess client.
+ *
+ * Drop-in alternative to `ClaudeClient` that routes every chat turn
+ * through the `claude -p` binary instead of the Anthropic HTTP API.
+ * Billing flows against the user's Claude Code subscription
+ * (`apiKeySource: "none"`) instead of the Console balance.
+ *
+ * Trade-offs vs ClaudeClient (the HTTP path):
+ *
+ *  * The `claude -p` subprocess owns the tool-use loop. The caller's
+ *    `tools` + `runTool` are ignored; the subprocess uses Claude
+ *    Code's native tool surface (Read, Edit, Write, Bash, Glob, Grep,
+ *    Task, plus any MCP servers configured in the user's
+ *    `~/.claude/config`). This is intentional: for build-side
+ *    workflows (the redesign/sumi-forge target), the native tools are
+ *    strictly more efficient than text-routed NAC3 invokes.
+ *
+ *  * Each `chat()` call spawns one subprocess. Latency is dominated
+ *    by the subprocess startup (~500 ms-1 s) on top of the LLM turn.
+ *    The output is parsed from the JSONL stream the binary writes to
+ *    stdout when invoked with `--output-format stream-json --verbose`.
+ *
+ *  * Token + cost accounting comes from the `result` event the binary
+ *    emits at the end of the run. Those values reflect what the user
+ *    subscription consumed; they are reported back as `tokensIn` /
+ *    `tokensOut` for parity with ClaudeClient, with the qualification
+ *    that under subscription billing the marginal $ cost is zero.
+ *
+ *  * Multi-turn conversation history is concatenated into a single
+ *    prompt the subprocess sees on stdin. The subprocess does not
+ *    receive a structured `messages[]` array; the convention is the
+ *    same role-tagged format the Anthropic SDK uses internally
+ *    (User: / Assistant:).
+ *
+ *  * No truncation detection: the subprocess does not report stop
+ *    reasons in a comparable way. The `truncation` field of the
+ *    response is left undefined.
+ *
+ * ASCII-only.
+ */
+import { type ChildProcess } from 'node:child_process';
+import { type SupportedLanguage } from '../i18n/index.js';
+import { type ChatLLMClient, type ClaudeChatRequest, type ClaudeChatResponse } from './claude.js';
+export interface ClaudeCliClientOptions {
+    /** Override the `claude` binary path. Defaults to "claude" (PATH-resolved). */
+    binary?: string;
+    /** Additional directories to grant tool access to via --add-dir. */
+    addDirs?: string[];
+    /** Allow-list of tools (passed verbatim to --allowed-tools). When
+     *  unset, all default tools are allowed (bypassPermissions is on). */
+    allowedTools?: string[];
+    /** Permission mode: 'bypassPermissions' (default, autopilot) |
+     *  'default' (interactive). */
+    permissionMode?: 'bypassPermissions' | 'default';
+    /** Default model: 'sonnet' | 'opus' | 'haiku' | model ID. */
+    model?: string;
+    /** Hard cap on total subprocess wall-clock. Default 30 min. */
+    timeoutMs?: number;
+    /** PND-064 slice B -- panel bridge. When set, the subprocess gets
+     *  the forge_panel MCP server so `claude -p` can create pizarron
+     *  tabs (the only way to reach the panel in CLI mode). The token
+     *  + port are handed to the MCP server via its env so it can
+     *  POST /api/forge/panel-push back to this chat server. */
+    panelBridge?: {
+        port: number;
+        token: string;
+    };
+    /** Test seam: injectable spawn for unit tests that need to feed
+     *  a canned stdout JSONL stream without running the real binary. */
+    spawnImpl?: (cmd: string, args: string[], opts: Record<string, unknown>) => ChildProcess;
+}
+export declare class ClaudeCliClient implements ChatLLMClient {
+    private readonly opts;
+    /** Cache of the generated mcp-config path (written once). */
+    private mcpConfigPath;
+    /** Path of the temp system-prompt file (rewritten per turn). */
+    private systemPromptPath;
+    /** Dogfood 2026-06-10 -- write the system prompt to a temp file so
+     *  it goes via --append-system-prompt-file instead of a CLI arg
+     *  (Windows ~32 KB command-line limit -> spawn ENAMETOOLONG). The
+     *  same path is reused (overwritten) each turn. */
+    private writeSystemPromptFile;
+    constructor(opts?: ClaudeCliClientOptions);
+    /** PND-064 slice B -- write (once) the mcp-config that points
+     *  `claude -p` at the forge_panel MCP server, with the port +
+     *  token in the server's env block so it can POST back to us.
+     *  Returns null when no panel bridge is configured. */
+    private ensureMcpConfig;
+    /** Convenience for callers (and tests) that want to know what
+     *  binary + flags will run before spawning. */
+    buildArgs(req: ClaudeChatRequest): string[];
+    chat(req: ClaudeChatRequest): Promise<ClaudeChatResponse>;
+}
+/** Granularidad de actividad (dogfood 2026-06-10) -- traduce un
+ *  tool_use del subproceso claude -p a una linea humana de "que
+ *  esta haciendo ahora", para el feed en vivo del pizarron. Best
+ *  effort: si no reconoce la herramienta, cae al nombre. */
+/** Human one-liner for a tool_use, shown live in the Coding canvas.
+ *  i18n: the EXPERIENCE phrases ("Reading X", "Running: cmd") follow
+ *  the app language (PND -- Pablo); the PROTOCOL identifiers (NAC3
+ *  verb ids, mcp server.tool) stay neutral ("traduci la experiencia,
+ *  no el protocolo"). lang defaults to the current app language. */
+export declare function summarizeToolUse(name: string, input: unknown, lang?: SupportedLanguage | string): string;
+/** Structured detail of a tool_use for the "codewrapper" (detailed)
+ *  mode of the Coding tab: the file it touches, a diff for edits, the
+ *  command/pattern for the rest. Bounded so the SSE payload stays
+ *  small. Language-neutral (the panel renders + labels it). */
+export interface ToolDetail {
+    kind: 'edit' | 'write' | 'bash' | 'read' | 'search' | 'task' | 'todo' | 'verb' | 'other';
+    path: string | null;
+    /** A one-line target/headline (basename, command head, pattern). */
+    target: string;
+    /** Edit/MultiEdit: the before/after to render a diff. */
+    diff: {
+        old: string;
+        new: string;
+    } | null;
+    /** Write: new content preview; Bash: full command; else null. */
+    body: string | null;
+}
+export declare function extractToolDetail(name: string, input: unknown): ToolDetail;
+/** Console / managed / other-brain path: the server runs NAC3 verbs
+ *  (yujin.*) instead of Claude's native tools, so the codewrapper
+ *  detail comes from a parallel adapter that maps verbs -> the same
+ *  ToolDetail shape. write-project-file carries full content (no
+ *  old/new), so it surfaces as a body, not a diff. */
+export declare function extractVerbDetail(verbId: string, input: unknown): ToolDetail;
+/** Probe `claude -p` once with a trivial prompt. Useful as a
+ *  pre-flight before launching a long-running orchestration: a fresh
+ *  failure here (binary missing, not logged in, rate limit window
+ *  exhausted) is much cheaper to detect than to discover mid-sprint.
+ *
+ *  Returns the rate-limit info from the system init event so the
+ *  caller can decide whether the 5-hour window has room for the
+ *  upcoming workload. */
+export declare function probeClaudeCli(opts?: ClaudeCliClientOptions): Promise<{
+    ok: boolean;
+    apiKeySource?: string;
+    model?: string;
+    rateLimitStatus?: string;
+    resetsAt?: number;
+    error?: string;
+}>;
+//# sourceMappingURL=claude_cli.d.ts.map

package/dist/chat/claude_cli.d.ts.map

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