@pentoshi/clai 1.2.5 → 1.2.7

package/dist/agent/classic-renderer.d.ts

@@ -0,0 +1,5 @@
+import type { AgentEvent } from "./events.js";
+export interface ClassicRenderer {
+    onEvent: (event: AgentEvent) => void;
+}
+export declare function attachClassicRenderer(write?: (chunk: string) => void): ClassicRenderer;

package/dist/agent/classic-renderer.js

@@ -0,0 +1,124 @@
+import chalk from "chalk";
+import { styleToolChatter } from "./runner.js";
+import { indentAndWrapText, renderMarkdown } from "../ui/markdown.js";
+import { renderPlanChecklist } from "../ui/plan-pane.js";
+import { startThinkingSpinner } from "../ui/spinner.js";
+import { renderThinkingSummary } from "../ui/thinking.js";
+export function attachClassicRenderer(write = (chunk) => {
+    process.stdout.write(chunk);
+}) {
+    const toolCalls = new Map();
+    let spinner;
+    const callFor = (id) => toolCalls.get(id) ?? { name: "tool", args: {} };
+    const stopSpinner = () => {
+        spinner?.stop();
+        spinner = undefined;
+    };
+    const setSpinnerLabel = (label) => {
+        if (!spinner) {
+            spinner = startThinkingSpinner(label);
+        }
+        else {
+            spinner.setLabel(label);
+        }
+    };
+    const onEvent = (event) => {
+        switch (event.type) {
+            case "turn-start":
+            case "assistant-delta":
+            case "confirm-request":
+                return;
+            case "thinking-delta":
+                setSpinnerLabel("thinking");
+                spinner?.pushPreview(event.text);
+                return;
+            case "status":
+                if (event.text === "waiting for model" ||
+                    event.text === "thinking" ||
+                    /^step \d+$/.test(event.text)) {
+                    setSpinnerLabel(event.text);
+                    return;
+                }
+                stopSpinner();
+                write(chalk.dim(event.text));
+                return;
+            case "notice": {
+                stopSpinner();
+                const prefix = event.level === "warn" ? "  ⚠ " : "  ℹ ";
+                const color = event.level === "warn" ? chalk.yellow : chalk.dim;
+                write(color(`${prefix}${event.text}\n`));
+                return;
+            }
+            case "thinking-block":
+                stopSpinner();
+                write(`${renderThinkingSummary(event.content)}\n`);
+                return;
+            case "assistant-message": {
+                stopSpinner();
+                write(renderMarkdown(event.text));
+                if (!event.text.endsWith("\n"))
+                    write("\n");
+                return;
+            }
+            case "tool-call": {
+                stopSpinner();
+                const call = { name: event.name, args: {} };
+                toolCalls.set(event.id, call);
+                const line = chalk.cyan(`  ▶ ${event.name}`) + chalk.gray(` ${event.argsDisplay}`);
+                write(styleToolChatter(call, line) + "\n");
+                return;
+            }
+            case "tool-output": {
+                stopSpinner();
+                if (!event.chunk)
+                    return;
+                if (event.chunk === "ok\n") {
+                    write(chalk.green("  ✓") + "\n");
+                    return;
+                }
+                if (event.chunk === "failed\n") {
+                    write(chalk.red("  ✗") + "\n");
+                    return;
+                }
+                const call = callFor(event.id);
+                const body = event.chunk.startsWith("\n")
+                    ? event.chunk
+                    : indentAndWrapText(event.chunk);
+                write(styleToolChatter(call, body.endsWith("\n") ? body : `${body}\n`));
+                return;
+            }
+            case "tool-result":
+                return;
+            case "tool-blocked":
+                stopSpinner();
+                write(chalk.red(`  ✗ blocked: ${event.reason}`) + "\n");
+                return;
+            case "plan-update":
+                stopSpinner();
+                if (event.plan.status === "draft") {
+                    write(chalk.cyan("  ● planning\n") +
+                        renderPlanChecklist(event.plan) +
+                        "\n" +
+                        chalk.dim("  ✦ plan created — press Ctrl+P to view it, /implement to approve and run it,\n" +
+                            "    or /discard to cancel it. Any other message refines this plan.\n"));
+                }
+                else {
+                    write(renderPlanChecklist(event.plan) + "\n");
+                }
+                return;
+            case "turn-end":
+                stopSpinner();
+                return;
+            case "turn-aborted":
+                stopSpinner();
+                write(chalk.yellow("  ⏹ Aborted.\n"));
+                return;
+            case "turn-error":
+                stopSpinner();
+                write(chalk.red(`  ✗ ${event.message}\n`));
+                return;
+        }
+    };
+    return { onEvent };
+}
+//# sourceMappingURL=classic-renderer.js.map

package/dist/agent/classic-renderer.js.map

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

package/dist/agent/events.d.ts

@@ -0,0 +1,62 @@
+import type { SessionPlan } from "../store/plan.js";
+export type AgentEvent = {
+    type: "turn-start";
+    prompt: string;
+} | {
+    type: "status";
+    text: string;
+} | {
+    type: "thinking-delta";
+    text: string;
+} | {
+    type: "thinking-block";
+    content: string;
+} | {
+    type: "assistant-delta";
+    text: string;
+} | {
+    type: "assistant-message";
+    text: string;
+} | {
+    type: "notice";
+    level: "info" | "warn";
+    text: string;
+} | {
+    type: "tool-call";
+    id: string;
+    name: string;
+    argsDisplay: string;
+} | {
+    type: "tool-output";
+    id: string;
+    chunk: string;
+} | {
+    type: "tool-result";
+    id: string;
+    ok: boolean;
+    exitCode?: number;
+    summary: string;
+    artifactPath?: string;
+} | {
+    type: "tool-blocked";
+    id: string;
+    name: string;
+    reason: string;
+} | {
+    type: "plan-update";
+    plan: SessionPlan;
+} | {
+    type: "confirm-request";
+    id: string;
+    kind: "tool" | "pentest";
+    prompt: string;
+} | {
+    type: "turn-end";
+    finalAnswer: string;
+    steps: number;
+} | {
+    type: "turn-aborted";
+} | {
+    type: "turn-error";
+    message: string;
+};

package/dist/agent/events.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=events.js.map

package/dist/agent/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/agent/events.ts"],"names":[],"mappings":""}

package/dist/agent/runner.d.ts

@@ -1,4 +1,5 @@
 import type { ChatMessage, ChatImage, ProviderId, ToolCall, ToolResult } from "../types.js";
+import type { AgentEvent } from "./events.js";
 export interface SessionPolicy {
     /** Tools the user authorized once during this REPL session. Not persisted. */
     allow: Set<string>;
@@ -14,6 +15,10 @@ export interface SessionPolicy {
     };
 }
 export declare function createSessionPolicy(): SessionPolicy;
+export interface ConfirmPort {
+    confirmTool(call: ToolCall): Promise<boolean>;
+    confirmPentest(): Promise<boolean>;
+}
 export interface AgentRunOptions {
     provider?: ProviderId | undefined;
     model?: string | undefined;
@@ -24,6 +29,8 @@ export interface AgentRunOptions {
     images?: ChatImage[] | undefined;
     onToolStart?: ((call: ToolCall) => void) | undefined;
     onToolResult?: ((call: ToolCall, result: ToolResult) => void) | undefined;
+    onEvent?: ((event: AgentEvent) => void) | undefined;
+    confirm?: ConfirmPort | undefined;
     session?: SessionPolicy | undefined;
 }
 export interface ParseToolCallOptions {
@@ -106,10 +113,10 @@ export declare function sameToolCall(a: ToolCall, b: ToolCall): boolean;
  */
 export declare function collapseRepeatedText(text: string): string;
 /**
- * Decide whether this turn should get a generous step budget because it is
- * a multi-file build, a continuation of one, or a "it's not done yet" nudge.
- * Looks at the current prompt first, then falls back to the most recent
- * user/assistant turns so a terse follow-up inherits the build context.
+ * Decide whether this turn should get the build workflow (explore → plan →
+ * implement) and a generous step budget. Looks at the current prompt first,
+ * then falls back to recent USER turns so a terse follow-up inherits an
+ * ongoing build — but NOT the agent's own (possibly mistaken) plan narration.
  */
 export declare function looksLikeBuildTask(prompt: string, history?: ChatMessage[] | undefined): boolean;
 /**
@@ -137,4 +144,5 @@ export declare function requiresFreshWebSearch(prompt: string): boolean;
 export declare function isLumpedSingleTask(taskTitles: string[]): boolean;
 export declare function shouldDimToolChatter(call: ToolCall): boolean;
 export declare function isPreApprovalAllowedTool(name: string): boolean;
+export declare function styleToolChatter(call: ToolCall, text: string): string;
 export declare function runAgentLoop(prompt: string, options?: AgentRunOptions): Promise<string>;