@yuaone/cli 0.1.0

package/dist/oneshot.d.ts

@@ -0,0 +1,17 @@
+/**
+ * YUAN CLI — One-shot Mode
+ *
+ * Executes a single coding task and exits.
+ * Usage: yuan code "Add error handling to auth.ts"
+ */
+/**
+ * Run a one-shot coding task.
+ *
+ * @param prompt - The coding task prompt
+ * @param options - Command options (model override, etc.)
+ * @returns Exit code (0 = success, 1 = failure)
+ */
+export declare function runOneshot(prompt: string, options?: {
+    model?: string;
+}): Promise<number>;
+//# sourceMappingURL=oneshot.d.ts.map

package/dist/oneshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oneshot.d.ts","sourceRoot":"","sources":["../src/oneshot.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAqBH;;;;;;GAMG;AACH,wBAAsB,UAAU,CAC9B,MAAM,EAAE,MAAM,EACd,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GAC/B,OAAO,CAAC,MAAM,CAAC,CAqLjB"}

package/dist/oneshot.js

@@ -0,0 +1,281 @@
+/**
+ * YUAN CLI — One-shot Mode
+ *
+ * Executes a single coding task and exits.
+ * Usage: yuan code "Add error handling to auth.ts"
+ */
+import { TerminalRenderer } from "./renderer.js";
+import { SessionManager } from "./session.js";
+import { ConfigManager } from "./config.js";
+import { AgentLoop, DEFAULT_LOOP_CONFIG, } from "@yuaone/core";
+import { createDefaultRegistry } from "@yuaone/tools";
+import { CloudClient } from "./cloud-client.js";
+const ESC = "\x1b[";
+function c(color, text) {
+    return `${color}${text}${ESC}0m`;
+}
+/**
+ * Run a one-shot coding task.
+ *
+ * @param prompt - The coding task prompt
+ * @param options - Command options (model override, etc.)
+ * @returns Exit code (0 = success, 1 = failure)
+ */
+export async function runOneshot(prompt, options = {}) {
+    const renderer = new TerminalRenderer();
+    const configManager = new ConfigManager();
+    const sessionManager = new SessionManager();
+    // Check if API key is configured
+    if (!configManager.isConfigured()) {
+        renderer.error("No API key configured. Run `yuan config` to set up.");
+        return 1;
+    }
+    const config = configManager.get();
+    const model = options.model ?? configManager.getModel();
+    renderer.banner();
+    renderer.info(`Provider: ${config.provider} | Model: ${model}`);
+    renderer.info(`Task: ${prompt}`);
+    renderer.separator();
+    // Cloud mode — delegate to remote server
+    if (configManager.isCloudMode()) {
+        return runOneshotCloud(prompt, config, renderer, options);
+    }
+    // Create a session for this one-shot
+    const session = sessionManager.create(process.cwd(), config.provider, model);
+    sessionManager.addMessage(session, "user", prompt);
+    // Build BYOK config
+    const byokConfig = {
+        provider: config.provider,
+        apiKey: config.apiKey,
+        model: options.model ?? config.model,
+        baseUrl: config.baseUrl,
+    };
+    // Create tool registry and executor
+    const registry = createDefaultRegistry();
+    const workDir = process.cwd();
+    const toolExecutor = registry.toExecutor(workDir);
+    // Build agent config
+    const agentConfig = {
+        byok: byokConfig,
+        loop: {
+            model: "coding",
+            maxIterations: DEFAULT_LOOP_CONFIG.maxIterations,
+            maxTokensPerIteration: DEFAULT_LOOP_CONFIG.maxTokensPerIteration,
+            totalTokenBudget: DEFAULT_LOOP_CONFIG.totalTokenBudget,
+            tools: toolExecutor.definitions,
+            systemPrompt: "You are YUAN, an autonomous coding agent. " +
+                "You have access to tools for reading, writing, editing files, running shell commands, and searching code. " +
+                "Complete the user's coding task efficiently and correctly, then stop.",
+            projectPath: workDir,
+        },
+    };
+    // Create and run AgentLoop
+    const loop = new AgentLoop({
+        config: agentConfig,
+        toolExecutor,
+        governorConfig: { planTier: "FREE" },
+    });
+    // Handle SIGINT gracefully — restore cursor and exit
+    const sigintHandler = () => {
+        process.stdout.write("\x1b[?25h"); // restore cursor
+        renderer.info("\nInterrupted.");
+        process.exit(130);
+    };
+    process.on("SIGINT", sigintHandler);
+    const spinner = renderer.thinking();
+    let isStreaming = false;
+    loop.on("event", (event) => {
+        switch (event.kind) {
+            case "agent:thinking":
+                if (!isStreaming) {
+                    spinner.update(event.content);
+                }
+                break;
+            case "agent:text_delta":
+                if (!isStreaming) {
+                    spinner.stop();
+                    isStreaming = true;
+                    console.log();
+                }
+                renderer.streamToken(event.text);
+                break;
+            case "agent:tool_call":
+                if (isStreaming) {
+                    renderer.endStream();
+                    isStreaming = false;
+                }
+                else {
+                    spinner.stop();
+                }
+                renderer.toolCall(event.tool, typeof event.input === "string"
+                    ? event.input.slice(0, 100)
+                    : JSON.stringify(event.input, null, 0).slice(0, 100));
+                break;
+            case "agent:tool_result":
+                renderer.toolResult(event.output);
+                break;
+            case "agent:error":
+                if (isStreaming) {
+                    renderer.endStream();
+                    isStreaming = false;
+                }
+                else {
+                    spinner.stop();
+                }
+                renderer.error(event.message);
+                break;
+            case "agent:completed": {
+                const wasStreaming = isStreaming;
+                if (isStreaming) {
+                    renderer.endStream();
+                    isStreaming = false;
+                }
+                else {
+                    spinner.stop();
+                }
+                if (!wasStreaming) {
+                    console.log();
+                }
+                break;
+            }
+            default:
+                break;
+        }
+    });
+    try {
+        const result = await loop.run(prompt);
+        if (isStreaming) {
+            renderer.endStream();
+            isStreaming = false;
+        }
+        spinner.stop();
+        if (result.reason === "GOAL_ACHIEVED") {
+            renderer.success("Task completed.");
+            sessionManager.addMessage(session, "assistant", result.summary);
+            return 0;
+        }
+        // Non-success termination
+        switch (result.reason) {
+            case "MAX_ITERATIONS":
+                renderer.warn(`Reached iteration limit: ${result.lastState}`);
+                break;
+            case "BUDGET_EXHAUSTED":
+                renderer.warn(`Token budget exhausted: ${result.tokensUsed} tokens used`);
+                break;
+            case "ERROR":
+                renderer.error(`Agent error: ${result.error}`);
+                break;
+            default:
+                renderer.warn(`Agent terminated: ${result.reason}`);
+        }
+        renderer.info(`Session ${session.id.slice(0, 8)} saved. Run \`yuan resume\` to continue.`);
+        return 1;
+    }
+    catch (err) {
+        if (isStreaming) {
+            renderer.endStream();
+        }
+        spinner.stop();
+        const errorMsg = err instanceof Error ? err.message : String(err);
+        renderer.error(`Unexpected error: ${errorMsg}`);
+        return 1;
+    }
+}
+/**
+ * Run a one-shot task via CloudClient (cloud mode).
+ */
+async function runOneshotCloud(prompt, config, renderer, options) {
+    const client = new CloudClient(config.serverUrl, config.apiKey);
+    const abortController = new AbortController();
+    const sigintHandler = () => {
+        abortController.abort();
+    };
+    process.on("SIGINT", sigintHandler);
+    const spinner = renderer.thinking();
+    let isStreaming = false;
+    let cloudSessionId;
+    let hasError = false;
+    try {
+        const { sessionId } = await client.startSession(prompt, {
+            workDir: process.cwd(),
+            model: options.model ?? config.model,
+        });
+        cloudSessionId = sessionId;
+        await client.streamEvents(sessionId, (event) => {
+            switch (event.kind) {
+                case "thinking":
+                    if (!isStreaming)
+                        spinner.update(event.content);
+                    break;
+                case "text_delta":
+                    if (!isStreaming) {
+                        spinner.stop();
+                        isStreaming = true;
+                        console.log();
+                    }
+                    renderer.streamToken(event.text);
+                    break;
+                case "tool_call":
+                    if (isStreaming) {
+                        renderer.endStream();
+                        isStreaming = false;
+                    }
+                    else
+                        spinner.stop();
+                    renderer.toolCall(event.tool, typeof event.input === "string"
+                        ? event.input.slice(0, 100)
+                        : JSON.stringify(event.input, null, 0).slice(0, 100));
+                    break;
+                case "tool_result":
+                    renderer.toolResult(event.output);
+                    break;
+                case "error":
+                    if (isStreaming) {
+                        renderer.endStream();
+                        isStreaming = false;
+                    }
+                    else
+                        spinner.stop();
+                    renderer.error(event.message);
+                    hasError = true;
+                    break;
+                case "done":
+                    if (isStreaming) {
+                        renderer.endStream();
+                        isStreaming = false;
+                    }
+                    else
+                        spinner.stop();
+                    break;
+                default:
+                    break;
+            }
+        }, { signal: abortController.signal });
+        spinner.stop();
+        if (isStreaming)
+            renderer.endStream();
+        if (!hasError) {
+            renderer.success("Task completed.");
+            return 0;
+        }
+        return 1;
+    }
+    catch (err) {
+        spinner.stop();
+        if (isStreaming)
+            renderer.endStream();
+        if (err instanceof DOMException && err.name === "AbortError") {
+            if (cloudSessionId)
+                await client.stop(cloudSessionId).catch(() => { });
+            renderer.info("Interrupted.");
+            return 130;
+        }
+        const errorMsg = err instanceof Error ? err.message : String(err);
+        renderer.error(`Cloud error: ${errorMsg}`);
+        return 1;
+    }
+    finally {
+        process.removeListener("SIGINT", sigintHandler);
+    }
+}
+//# sourceMappingURL=oneshot.js.map

package/dist/oneshot.js.map

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

package/dist/progress-renderer.d.ts

@@ -0,0 +1,116 @@
+/**
+ * @module progress-renderer
+ * @description Real-time agent execution progress display for CLI.
+ *
+ * Shows:
+ * - Agent status (planning/coding/reviewing/testing)
+ * - Current tool execution (file, command, etc.)
+ * - Token usage bar
+ * - Iteration progress
+ * - Thinking stream (reasoning deltas)
+ */
+/** Agent execution phase. */
+export type AgentPhase = "planning" | "coding" | "reviewing" | "testing" | "waiting";
+/** Status change event consumed by `onStatus`. */
+export interface StatusEvent {
+    phase: AgentPhase;
+    detail?: string;
+}
+/** Tool call event consumed by `onToolCall`. */
+export interface ToolCallEvent {
+    tool: string;
+    input: string;
+}
+/** Tool result event consumed by `onToolResult`. */
+export interface ToolResultEvent {
+    tool: string;
+    success: boolean;
+    summary: string;
+}
+/** Approval request shown by `onApprovalNeeded`. */
+export interface ApprovalEvent {
+    id: string;
+    tool: string;
+    description: string;
+    risk: "low" | "medium" | "high";
+}
+/** Completion summary shown by `onDone`. */
+export interface DoneResult {
+    filesChanged: string[];
+    iterations: number;
+    tokensUsed: number;
+    durationMs: number;
+    summary: string;
+}
+/** Configuration for `ProgressRenderer`. */
+export interface ProgressRendererConfig {
+    /** Maximum iterations the agent will attempt. */
+    maxIterations: number;
+    /** Maximum token budget for the run. */
+    maxTokens: number;
+    /** Whether to display the thinking (reasoning) stream. */
+    showThinking: boolean;
+}
+/**
+ * Render a Unicode progress bar.
+ *
+ * @param current - Current value.
+ * @param max     - Maximum value.
+ * @param width   - Character width of the bar (filled + empty).
+ * @returns Colored bar string, e.g. `████████░░░░░░░░`.
+ */
+export declare function renderBar(current: number, max: number, width?: number): string;
+/**
+ * Real-time CLI renderer for agent execution progress.
+ *
+ * Usage:
+ * ```ts
+ * const pr = new ProgressRenderer({ maxIterations: 25, maxTokens: 200_000, showThinking: true });
+ * pr.onStatus({ phase: "planning", detail: "analyzing codebase" });
+ * pr.onToolCall({ tool: "file_read", input: "src/index.ts" });
+ * pr.onToolResult({ tool: "file_read", success: true, summary: "42 lines" });
+ * pr.onIterationEnd(3, 25, 12400, 200000);
+ * pr.onDone({ filesChanged: ["a.ts"], iterations: 3, tokensUsed: 12400, durationMs: 8200, summary: "Done" });
+ * ```
+ */
+export declare class ProgressRenderer {
+    private readonly config;
+    private thinkingBuffer;
+    private thinkingTimer;
+    private currentPhase;
+    constructor(config: ProgressRendererConfig);
+    /** Display an agent phase transition. */
+    onStatus(event: StatusEvent): void;
+    /** Display a tool invocation line. */
+    onToolCall(event: ToolCallEvent): void;
+    /** Display a tool result line (success or error). */
+    onToolResult(event: ToolResultEvent): void;
+    /**
+     * Stream a reasoning delta.
+     * Output is debounced (200 ms) and rendered in dim gray,
+     * word-wrapped to the terminal width.
+     */
+    onThinking(delta: string): void;
+    /** Flush any buffered thinking text to stdout. */
+    private flushThinking;
+    /** Word-wrap text to a given width. */
+    private wrapText;
+    /**
+     * Render an iteration progress line with bar and token usage.
+     *
+     * Example output:
+     * ```
+     * [3/25] ████████░░░░░░░░ 32% | tokens: 12.4k/200k
+     * ```
+     */
+    onIterationEnd(iteration: number, maxIteration: number, tokensUsed: number, maxTokens: number): void;
+    /** Display an approval-needed prompt box. */
+    onApprovalNeeded(approval: ApprovalEvent): void;
+    /** Display a completion summary. */
+    onDone(result: DoneResult): void;
+    /** Display an error message in red. */
+    onError(error: string): void;
+    /** Clear the current progress display area. */
+    clear(): void;
+}
+//# sourceMappingURL=progress-renderer.d.ts.map

package/dist/progress-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress-renderer.d.ts","sourceRoot":"","sources":["../src/progress-renderer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AA6BH,6BAA6B;AAC7B,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,QAAQ,GAAG,WAAW,GAAG,SAAS,GAAG,SAAS,CAAC;AAErF,kDAAkD;AAClD,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,UAAU,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,gDAAgD;AAChD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,oDAAoD;AACpD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,oDAAoD;AACpD,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;CACjC;AAED,4CAA4C;AAC5C,MAAM,WAAW,UAAU;IACzB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,4CAA4C;AAC5C,MAAM,WAAW,sBAAsB;IACrC,iDAAiD;IACjD,aAAa,EAAE,MAAM,CAAC;IACtB,wCAAwC;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,0DAA0D;IAC1D,YAAY,EAAE,OAAO,CAAC;CACvB;AAcD;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,MAAM,CAY1E;AAID;;;;;;;;;;;;GAYG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyB;IAChD,OAAO,CAAC,cAAc,CAAM;IAC5B,OAAO,CAAC,aAAa,CAA8C;IACnE,OAAO,CAAC,YAAY,CAA2B;gBAEnC,MAAM,EAAE,sBAAsB;IAM1C,yCAAyC;IACzC,QAAQ,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IASlC,sCAAsC;IACtC,UAAU,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI;IAWtC,qDAAqD;IACrD,YAAY,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI;IAmB1C;;;;OAIG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAW/B,kDAAkD;IAClD,OAAO,CAAC,aAAa;IAarB,uCAAuC;IACvC,OAAO,CAAC,QAAQ;IAoBhB;;;;;;;OAOG;IACH,cAAc,CACZ,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB,IAAI;IAiBP,6CAA6C;IAC7C,gBAAgB,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI;IA4C/C,oCAAoC;IACpC,MAAM,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAgChC,uCAAuC;IACvC,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAO5B,+CAA+C;IAC/C,KAAK,IAAI,IAAI;CAId"}