careervivid 2.1.21 → 2.1.22

package/dist/commands/agent/repl/toolHandlers.js

@@ -0,0 +1,185 @@
+/**
+ * repl/toolHandlers.ts
+ *
+ * Tool call confirmation, spinner lifecycle, mutation budgets,
+ * circuit breaker, and audit logging for the REPL.
+ */
+import chalk from "chalk";
+import ora from "ora";
+import pkg from "enquirer";
+import { isSafeCommand } from "../../../agent/tools/coding.js";
+import { auditLog, SESSION_ID } from "../../../agent/agentAuditLog.js";
+const { prompt } = pkg;
+// ── Mutation budget constants ──────────────────────────────────────────────────
+export const WRITE_TOOLS = new Set([
+    "tracker_add_job", "tracker_update_job", "kanban_add_job", "kanban_update_status",
+    "save_cover_letter", "delete_cover_letter", "write_file", "patch_file",
+    "tracker_recheck_urls", "openings_apply",
+]);
+export const SESSION_MAX_MUTATIONS = 25;
+export const TURN_MAX_MUTATIONS = 10;
+// ── Tool label map ─────────────────────────────────────────────────────────────
+const TOOL_LABELS = {
+    list_directory: "🔍 Scanning workspace...",
+    read_file: "📖 Reading file...",
+    run_command: "⚙️  Running command...",
+    write_file: "✏️  Writing file...",
+    patch_file: "✏️  Patching file...",
+    tracker_list_jobs: "📊 Checking job pipeline...",
+    tracker_add_job: "➕ Adding job to pipeline...",
+    tracker_update_job: "🔄 Updating job record...",
+    tracker_rank_priority: "📈 Ranking pipeline...",
+    tracker_dashboard: "📊 Fetching pipeline analytics...",
+    tracker_find_stale: "🚩 Checking stale jobs...",
+    tracker_inspect_quality: "🔍 Inspecting data quality...",
+    kanban_add_job: "📌 Saving to Kanban board...",
+    kanban_list_jobs: "📋 Loading Kanban board...",
+    kanban_update_status: "🔄 Updating Kanban status...",
+    list_cover_letters: "📄 Loading cover letters...",
+    get_cover_letter: "📄 Reading cover letter...",
+    save_cover_letter: "💾 Saving cover letter...",
+    delete_cover_letter: "🗑️  Deleting cover letter...",
+    browser_navigate: "🌐 Navigating to page...",
+    browser_click: "🖱️  Clicking element...",
+    browser_type: "⌨️  Typing input...",
+    browser_state: "🌐 Reading browser state...",
+    browser_screenshot: "📸 Taking screenshot...",
+    browser_scroll: "📜 Scrolling page...",
+    browser_wait: "⏳ Waiting...",
+    browser_close: "🔒 Closing browser...",
+    browser_select: "🖱️  Selecting option...",
+    tracker_recheck_urls: "🔗 Re-checking job URLs...",
+    browser_autofill_application: "📝 Auto-filling application...",
+    verify_url: "🔍 Verifying URL...",
+    verify_job_urls: "🔍 Verifying job URLs...",
+    search_jobs: "🔍 Searching jobs...",
+    openings_scan: "🎯 Scanning companies for open roles...",
+    openings_list: "📋 Loading saved openings...",
+    openings_apply: "✅ Marking opening as applied...",
+    get_resume: "📄 Loading resume...",
+    list_resumes: "📄 Loading resumes...",
+    get_profile: "👤 Loading profile...",
+};
+export function createToolHandlerState() {
+    return {
+        sessionMutations: 0,
+        turnMutations: 0,
+        trustAllCommands: false,
+        trustAllWrites: false,
+        currentSpinner: null,
+        lastToolCall: { name: "", argsHash: "", count: 0 },
+    };
+}
+/**
+ * Called before a tool executes. Returns true to allow, false to deny.
+ * Manages confirmation prompts, spinner start, and mutation budgets.
+ */
+export async function onToolCall(name, args, thinkingSpinner, state) {
+    // Stop thinking spinner on first tool call
+    if (thinkingSpinner.isSpinning) {
+        thinkingSpinner.stop();
+        process.stdout.write("\r\x1b[K");
+    }
+    // ── Circuit breaker ──────────────────────────────────────────────────────
+    const argsHash = JSON.stringify(args).slice(0, 100);
+    if (state.lastToolCall.name === name && state.lastToolCall.argsHash === argsHash) {
+        state.lastToolCall.count++;
+        if (state.lastToolCall.count >= 5) {
+            console.log(chalk.red(`\n⛔ Loop detected: "${name}" called ${state.lastToolCall.count} times with identical args. Aborting turn.`));
+            return false;
+        }
+    }
+    else {
+        state.lastToolCall = { name, argsHash, count: 1 };
+    }
+    // ── Mutation budget ───────────────────────────────────────────────────────
+    if (WRITE_TOOLS.has(name)) {
+        state.turnMutations++;
+        if (state.turnMutations > TURN_MAX_MUTATIONS) {
+            console.log(chalk.red(`\n⛔ Turn mutation limit (${TURN_MAX_MUTATIONS}) reached. The agent has made ${state.turnMutations} writes this turn.`));
+            return false;
+        }
+        state.sessionMutations++;
+        if (state.sessionMutations >= SESSION_MAX_MUTATIONS) {
+            console.log(chalk.yellow(`\n⚠️  Session mutation budget exhausted (${SESSION_MAX_MUTATIONS} writes). Restart the agent to continue writing.`));
+            return false;
+        }
+        else if (state.sessionMutations === SESSION_MAX_MUTATIONS - 5) {
+            console.log(chalk.yellow(`\n💡 Heads up: ${SESSION_MAX_MUTATIONS - state.sessionMutations} writes remaining this session.`));
+        }
+    }
+    // Print compact tool label
+    process.stdout.write(chalk.dim(`  ${TOOL_LABELS[name] ?? "⚙️  Working..."}\n`));
+    // ── Per-tool confirmations ────────────────────────────────────────────────
+    if (name === "run_command") {
+        if (state.trustAllCommands || isSafeCommand(args.command))
+            return true;
+        const confirm = await prompt({
+            type: "select",
+            name: "ok",
+            message: `Allow running: ${chalk.bold(args.command)}?`,
+            choices: ["Yes, run it", "Yes, and trust all commands this session", "No, skip it"],
+        });
+        if (confirm.ok === "Yes, and trust all commands this session") {
+            state.trustAllCommands = true;
+            console.log(chalk.dim("   ✅ All commands will run automatically for the rest of this session."));
+            return true;
+        }
+        return confirm.ok === "Yes, run it";
+    }
+    if (name === "write_file" || name === "patch_file") {
+        if (state.trustAllWrites)
+            return true;
+        const target = args.path || "(unknown path)";
+        const confirm = await prompt({
+            type: "select",
+            name: "ok",
+            message: `Allow writing to: ${chalk.bold(target)}?`,
+            choices: ["Yes, write it", "Yes, and trust all writes this session", "No, skip it"],
+        });
+        if (confirm.ok === "Yes, and trust all writes this session") {
+            state.trustAllWrites = true;
+            console.log(chalk.dim("   ✅ All file writes will run automatically for the rest of this session."));
+            return true;
+        }
+        if (confirm.ok !== "Yes, write it")
+            return false;
+    }
+    if (name === "browser_close") {
+        const confirm = await prompt({
+            type: "select",
+            name: "ok",
+            message: "Close the browser?",
+            choices: ["Yes, close it", "No, keep it open"],
+        });
+        if (confirm.ok !== "Yes, close it")
+            return false;
+    }
+    // Interview tool takes over the terminal — stop spinner, yield cleanly
+    if (name === "start_interview") {
+        process.stdout.write("\r\x1b[K");
+        return true;
+    }
+    // All other tools: start a generic spinner
+    state.currentSpinner = ora(`Running ${chalk.bold(name)}...`).start();
+    return true;
+}
+/**
+ * Called after a tool completes. Stops spinner, logs audit entry.
+ */
+export function onToolResult(name, result, state) {
+    if (state.currentSpinner) {
+        state.currentSpinner.succeed(chalk.dim("Done"));
+        state.currentSpinner = null;
+    }
+    if (name === "start_interview") {
+        console.log(chalk.dim("─".repeat(50)));
+    }
+    auditLog({
+        sessionId: SESSION_ID,
+        tool: name,
+        args: typeof result?._args === "object" ? result._args : {},
+        result: typeof result === "string" ? result : JSON.stringify(result ?? ""),
+        durationMs: 0,
+    });
+}

package/dist/commands/agent/repl.d.ts

@@ -1,3 +1,13 @@
+/**
+ * repl.ts — REPL orchestrator for the CareerVivid agent
+ *
+ * This file is intentionally thin. Each concern lives in its own module:
+ *
+ *   repl/input.ts          — User input: first-turn menu, paste buffer, <<<
+ *   repl/slashCommands.ts  — /help, /voice, /speak, /models, /model
+ *   repl/toolHandlers.ts   — Tool confirmation, spinner, mutation budget, audit
+ *   repl/engineLoop.ts     — CareerVivid & BYO provider run loops
+ */
 import { CareerVividProxyEngine } from "../../agent/CareerVividProxyEngine.js";
 import { QueryEngine } from "../../agent/QueryEngine.js";
 import { type LLMProvider } from "../../config.js";

package/dist/commands/agent/repl.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"repl.d.ts","sourceRoot":"","sources":["../../../src/commands/agent/repl.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAC;AAC/E,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAEzD,OAAO,EAA4D,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAS7G,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,EAAE,KAAK,GAAE,MAAM,GAAG,IAAW,QAwBtF;AAED,wBAAsB,OAAO,CAC3B,MAAM,EAAE,WAAW,GAAG,sBAAsB,GAAG,IAAI,EACnD,OAAO,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,EAC9K,gBAAgB,EAAE,WAAW,EAC7B,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,iBAAiB,EAAE,MAAM,EACzB,KAAK,EAAE,GAAG,EAAE,GACX,OAAO,CAAC,IAAI,CAAC,CAkwBf"}
+{"version":3,"file":"repl.d.ts","sourceRoot":"","sources":["../../../src/commands/agent/repl.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAC;AAC/E,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAanD,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,EAAE,KAAK,GAAE,MAAM,GAAG,IAAW,QAsBtF;AA+DD,wBAAsB,OAAO,CAC3B,MAAM,EAAE,WAAW,GAAG,sBAAsB,GAAG,IAAI,EACnD,OAAO,EAAE;IACP,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,EACD,gBAAgB,EAAE,WAAW,EAC7B,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,iBAAiB,EAAE,MAAM,EACzB,KAAK,EAAE,GAAG,EAAE,GACX,OAAO,CAAC,IAAI,CAAC,CA4Kf"}