careervivid 1.12.3 → 1.12.4

package/dist/agent/CareerVividProxyEngine.d.ts

@@ -0,0 +1,73 @@
+/**
+ * CareerVividProxyEngine
+ *
+ * A drop-in replacement for QueryEngine that routes all Gemini API calls
+ * through the CareerVivid `agentProxy` Firebase function instead of calling
+ * Gemini directly. This allows users without a personal Gemini key to use
+ * the AI agent via their CareerVivid account credits.
+ *
+ * The proxy handles:
+ *  - Authentication (via cv_live_... API key)
+ *  - Credit deduction (atomically with each Gemini call)
+ *  - Gemini API call (server-side, using the CareerVivid Gemini secret)
+ *
+ * The engine handles:
+ *  - History management
+ *  - Tool execution (locally, in the CLI)
+ *  - Agentic loop (multi-turn tool calls)
+ *  - Context compaction
+ */
+import type { Content } from "@google/genai";
+import { Tool } from "./Tool.js";
+export interface ProxyEngineOptions {
+    cvApiKey: string;
+    model?: string;
+    systemInstruction?: string;
+    tools?: Tool[];
+    thinkingBudget?: number;
+    includeThoughts?: boolean;
+    maxHistoryLength?: number;
+}
+export interface ProxyIterationHook {
+    onStart?: () => void;
+    onResponse?: (creditInfo: {
+        creditsUsed: number;
+        creditsRemaining: number;
+        monthlyLimit: number;
+    }) => void | Promise<void>;
+    onToolCall?: (toolName: string, args: any) => Promise<boolean | void>;
+    onToolResult?: (toolName: string, result: any) => void;
+    onError?: (error: Error) => void;
+    onChunk?: (text: string) => void;
+    onThinking?: (thought: string) => void;
+    onCompacting?: () => void;
+    /** Fired when credit limit is reached — engine will stop the loop */
+    onCreditLimitReached?: (remaining: number) => void;
+}
+export declare class CareerVividProxyEngine {
+    private cvApiKey;
+    private model;
+    private systemInstruction;
+    private tools;
+    private toolMap;
+    private thinkingBudget;
+    private includeThoughts;
+    private maxHistoryLength;
+    private history;
+    private sessionCreditsUsed;
+    private lastKnownRemaining;
+    private monthlyLimit;
+    constructor(options: ProxyEngineOptions);
+    getHistory(): Content[];
+    setHistory(history: Content[]): void;
+    /** Credits used in this session */
+    get sessionUsed(): number;
+    /** Last known remaining credits */
+    get remaining(): number | null;
+    private callProxy;
+    private compactHistory;
+    private executeToolCalls;
+    runLoopStreaming(prompt: string, hooks?: ProxyIterationHook): Promise<string>;
+    runLoop(prompt: string, hooks?: ProxyIterationHook): Promise<string>;
+}
+//# sourceMappingURL=CareerVividProxyEngine.d.ts.map

package/dist/agent/CareerVividProxyEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CareerVividProxyEngine.d.ts","sourceRoot":"","sources":["../../src/agent/CareerVividProxyEngine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAQ,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,IAAI,EAAsB,MAAM,WAAW,CAAC;AAcrD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,UAAU,CAAC,EAAE,CAAC,UAAU,EAAE;QACxB,WAAW,EAAE,MAAM,CAAC;QACpB,gBAAgB,EAAE,MAAM,CAAC;QACzB,YAAY,EAAE,MAAM,CAAC;KACtB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,KAAK,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IACtE,YAAY,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,KAAK,IAAI,CAAC;IACvD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;IAC1B,qEAAqE;IACrE,oBAAoB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;CACpD;AAoCD,qBAAa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,OAAO,CAAoB;IACnC,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,eAAe,CAAU;IACjC,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,OAAO,CAAiB;IAGhC,OAAO,CAAC,kBAAkB,CAAK;IAC/B,OAAO,CAAC,kBAAkB,CAAuB;IACjD,OAAO,CAAC,YAAY,CAAuB;gBAE/B,OAAO,EAAE,kBAAkB;IAWhC,UAAU,IAAI,OAAO,EAAE;IAIvB,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE;IAIpC,mCAAmC;IACnC,IAAI,WAAW,IAAI,MAAM,CAExB;IAED,mCAAmC;IACnC,IAAI,SAAS,IAAI,MAAM,GAAG,IAAI,CAE7B;YAMa,SAAS;YAqDT,cAAc;YAed,gBAAgB;IA6DjB,gBAAgB,CAC3B,MAAM,EAAE,MAAM,EACd,KAAK,CAAC,EAAE,kBAAkB,GACzB,OAAO,CAAC,MAAM,CAAC;IAQL,OAAO,CAClB,MAAM,EAAE,MAAM,EACd,KAAK,CAAC,EAAE,kBAAkB,GACzB,OAAO,CAAC,MAAM,CAAC;CAwInB"}

package/dist/agent/CareerVividProxyEngine.js

@@ -0,0 +1,320 @@
+/**
+ * CareerVividProxyEngine
+ *
+ * A drop-in replacement for QueryEngine that routes all Gemini API calls
+ * through the CareerVivid `agentProxy` Firebase function instead of calling
+ * Gemini directly. This allows users without a personal Gemini key to use
+ * the AI agent via their CareerVivid account credits.
+ *
+ * The proxy handles:
+ *  - Authentication (via cv_live_... API key)
+ *  - Credit deduction (atomically with each Gemini call)
+ *  - Gemini API call (server-side, using the CareerVivid Gemini secret)
+ *
+ * The engine handles:
+ *  - History management
+ *  - Tool execution (locally, in the CLI)
+ *  - Agentic loop (multi-turn tool calls)
+ *  - Context compaction
+ */
+import { convertToGenAITool } from "./Tool.js";
+// ─────────────────────────────────────────────────────────────────────────────
+// Constants
+// ─────────────────────────────────────────────────────────────────────────────
+const FIREBASE_REGION = "us-west1";
+const FIREBASE_PROJECT_ID = "jastalk-firebase";
+const PROXY_URL = `https://${FIREBASE_REGION}-${FIREBASE_PROJECT_ID}.cloudfunctions.net/agentProxy`;
+// ─────────────────────────────────────────────────────────────────────────────
+// Retry utility
+// ─────────────────────────────────────────────────────────────────────────────
+async function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+async function retryWithBackoff(fn, maxRetries = 3, baseDelayMs = 1000) {
+    for (let attempt = 0; attempt <= maxRetries; attempt++) {
+        try {
+            return await fn();
+        }
+        catch (e) {
+            const isRetryable = e?.status === 429 ||
+                e?.status === 503 ||
+                /rate.?limit|quota|too.?many.?requests|service.?unavailable/i.test(e?.message || "");
+            if (attempt === maxRetries || !isRetryable)
+                throw e;
+            await sleep(baseDelayMs * Math.pow(2, attempt));
+        }
+    }
+    throw new Error("retryWithBackoff: unreachable");
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// CareerVividProxyEngine
+// ─────────────────────────────────────────────────────────────────────────────
+export class CareerVividProxyEngine {
+    cvApiKey;
+    model;
+    systemInstruction;
+    tools;
+    toolMap;
+    thinkingBudget;
+    includeThoughts;
+    maxHistoryLength;
+    history = [];
+    // Running credit totals for the session
+    sessionCreditsUsed = 0;
+    lastKnownRemaining = null;
+    monthlyLimit = null;
+    constructor(options) {
+        this.cvApiKey = options.cvApiKey;
+        this.model = options.model ?? "gemini-2.5-flash";
+        this.systemInstruction = options.systemInstruction ?? "";
+        this.tools = options.tools ?? [];
+        this.toolMap = new Map(this.tools.map((t) => [t.name, t]));
+        this.thinkingBudget = options.thinkingBudget ?? 0;
+        this.includeThoughts = options.includeThoughts ?? false;
+        this.maxHistoryLength = options.maxHistoryLength ?? 40;
+    }
+    getHistory() {
+        return this.history;
+    }
+    setHistory(history) {
+        this.history = history;
+    }
+    /** Credits used in this session */
+    get sessionUsed() {
+        return this.sessionCreditsUsed;
+    }
+    /** Last known remaining credits */
+    get remaining() {
+        return this.lastKnownRemaining;
+    }
+    // ─────────────────────────────────────────────────────────────────────────
+    // Private helpers
+    // ─────────────────────────────────────────────────────────────────────────
+    async callProxy(contents) {
+        const genAITools = this.tools.map(convertToGenAITool);
+        const body = {
+            apiKey: this.cvApiKey,
+            model: this.model,
+            contents,
+            systemInstruction: this.systemInstruction || undefined,
+        };
+        if (genAITools.length > 0) {
+            // @google/generative-ai format: { functionDeclarations: [...] }
+            body.tools = [{ functionDeclarations: genAITools.flatMap((t) => t.functionDeclarations ?? [t]) }];
+        }
+        if (this.thinkingBudget > 0) {
+            body.thinkingBudget = this.thinkingBudget;
+            body.includeThoughts = this.includeThoughts;
+        }
+        const response = await fetch(PROXY_URL, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify(body),
+        });
+        if (response.status === 402) {
+            const data = await response.json();
+            return {
+                creditsUsed: 0,
+                creditsRemaining: data.creditsRemaining ?? 0,
+                monthlyLimit: data.monthlyLimit ?? 100,
+                reason: "limit_reached",
+            };
+        }
+        if (!response.ok) {
+            const data = await response.json().catch(() => ({}));
+            throw new Error(data.error || `Proxy error: HTTP ${response.status}`);
+        }
+        return response.json();
+    }
+    async compactHistory() {
+        // Simple compaction: keep the last 20 turns
+        if (this.history.length > this.maxHistoryLength) {
+            const summary = {
+                role: "user",
+                parts: [
+                    {
+                        text: `[Context compacted — ${this.history.length} prior turns summarized to save context space. Continue the conversation normally.]`,
+                    },
+                ],
+            };
+            this.history = [summary, ...this.history.slice(-20)];
+        }
+    }
+    async executeToolCalls(functionCalls, hooks) {
+        const functionResponses = [];
+        for (const call of functionCalls) {
+            const toolName = call.name || "";
+            const args = call.args || {};
+            const tool = this.toolMap.get(toolName);
+            if (!tool) {
+                functionResponses.push({
+                    functionResponse: {
+                        name: toolName,
+                        response: {
+                            error: `Tool "${toolName}" not found. Available: ${[...this.toolMap.keys()].join(", ")}`,
+                        },
+                    },
+                });
+                continue;
+            }
+            if (hooks?.onToolCall) {
+                const allow = await hooks.onToolCall(toolName, args);
+                if (allow === false) {
+                    functionResponses.push({
+                        functionResponse: {
+                            name: toolName,
+                            response: { error: "User denied tool execution." },
+                        },
+                    });
+                    continue;
+                }
+            }
+            try {
+                const result = await tool.execute(args);
+                if (hooks?.onToolResult)
+                    hooks.onToolResult(toolName, result);
+                functionResponses.push({
+                    functionResponse: { name: toolName, response: { result } },
+                });
+            }
+            catch (err) {
+                functionResponses.push({
+                    functionResponse: {
+                        name: toolName,
+                        response: { error: String(err.message || err) },
+                    },
+                });
+            }
+        }
+        return functionResponses;
+    }
+    // ─────────────────────────────────────────────────────────────────────────
+    // Public: runLoopStreaming (interface-compatible with QueryEngine)
+    // Note: The proxy does not stream — text is printed all at once after each
+    // proxy call. True streaming requires a different proxy endpoint.
+    // ─────────────────────────────────────────────────────────────────────────
+    async runLoopStreaming(prompt, hooks) {
+        return this.runLoop(prompt, hooks);
+    }
+    // ─────────────────────────────────────────────────────────────────────────
+    // Public: runLoop
+    // ─────────────────────────────────────────────────────────────────────────
+    async runLoop(prompt, hooks) {
+        this.history.push({ role: "user", parts: [{ text: prompt }] });
+        let maxIterations = 30;
+        let iterations = 0;
+        let finalAnswer = "";
+        while (iterations < maxIterations) {
+            iterations++;
+            if (hooks?.onStart)
+                hooks.onStart();
+            // Compact if needed
+            if (this.history.length > this.maxHistoryLength) {
+                if (hooks?.onCompacting)
+                    hooks.onCompacting();
+                await this.compactHistory();
+            }
+            try {
+                const proxyResult = await retryWithBackoff(() => this.callProxy(this.history));
+                // Credit limit reached
+                if (proxyResult.reason === "limit_reached") {
+                    this.lastKnownRemaining = proxyResult.creditsRemaining;
+                    if (hooks?.onCreditLimitReached) {
+                        hooks.onCreditLimitReached(proxyResult.creditsRemaining);
+                    }
+                    finalAnswer = "❌ Credit limit reached. Please upgrade or top up at careervivid.app/developer";
+                    break;
+                }
+                // Update credit tracking
+                this.sessionCreditsUsed += proxyResult.creditsUsed ?? 0;
+                this.lastKnownRemaining = proxyResult.creditsRemaining;
+                this.monthlyLimit = proxyResult.monthlyLimit;
+                if (hooks?.onResponse) {
+                    await hooks.onResponse({
+                        creditsUsed: proxyResult.creditsUsed,
+                        creditsRemaining: proxyResult.creditsRemaining,
+                        monthlyLimit: proxyResult.monthlyLimit,
+                    });
+                }
+                // Parse Gemini response
+                const candidate = proxyResult.candidates?.[0];
+                if (!candidate) {
+                    finalAnswer = "No response from Gemini.";
+                    break;
+                }
+                const parts = candidate.content?.parts ?? [];
+                // Add model response to history
+                this.history.push({
+                    role: "model",
+                    parts: parts.length > 0 ? parts : [{ text: "" }],
+                });
+                // Extract thinking text
+                if (this.includeThoughts && hooks?.onThinking) {
+                    const thoughtParts = parts.filter((p) => p.thought);
+                    for (const part of thoughtParts) {
+                        if (part.text)
+                            hooks.onThinking(part.text);
+                    }
+                }
+                // Extract function calls
+                const functionCalls = parts
+                    .filter((p) => p.functionCall)
+                    .map((p) => ({
+                    name: p.functionCall.name,
+                    args: p.functionCall.args ?? {},
+                }));
+                if (functionCalls.length > 0) {
+                    // Tool call turn — execute tools and loop
+                    const functionResponses = await this.executeToolCalls(functionCalls, hooks);
+                    this.history.push({ role: "user", parts: functionResponses });
+                    continue;
+                }
+                // Text response — emit chunks and break
+                const textParts = parts
+                    .filter((p) => p.text && !p.thought)
+                    .map((p) => p.text);
+                const fullText = textParts.join("");
+                // [Harness Engineering] Prevent lazy conversational exits for Jobs Agent
+                if (this.systemInstruction && this.systemInstruction.includes("DO NOT ASK FOR PERMISSION")) {
+                    const textOut = fullText;
+                    const lowerText = textOut.toLowerCase();
+                    const askingPermission = lowerText.includes("would you like me to") ||
+                        lowerText.includes("how would you like to proceed") ||
+                        lowerText.includes("should i go ahead") ||
+                        lowerText.includes("shall i") ||
+                        lowerText.includes("could you please provide") ||
+                        lowerText.includes("i need your permission") ||
+                        lowerText.includes("please provide") ||
+                        lowerText.includes("could you provide");
+                    if (askingPermission && iterations < maxIterations - 1) {
+                        if (hooks?.onThinking)
+                            hooks.onThinking("Harness intercepted permission seeking. Auto-correcting...");
+                        this.history.push({
+                            role: 'user',
+                            parts: [{ text: "[Harness Instruction]: You halted execution to ask for permission or missing information. RE-READ YOUR HARNESS DIRECTIVES. You must autonomously execute the mutation (e.g., update_local_job or add_local_job) using defaults for missing fields. Do not wait for confirmation. Do it now." }]
+                        });
+                        continue;
+                    }
+                }
+                // Emit as a "chunk" so the caller's onChunk handler can print it
+                if (hooks?.onChunk && fullText) {
+                    hooks.onChunk(fullText);
+                }
+                finalAnswer = fullText;
+                break;
+            }
+            catch (e) {
+                if (hooks?.onError)
+                    hooks.onError(e);
+                finalAnswer = `Generation Error: ${e.message}`;
+                break;
+            }
+        }
+        if (iterations >= maxIterations) {
+            finalAnswer =
+                finalAnswer ||
+                    "Max iterations (30) exceeded without a final answer.";
+        }
+        return finalAnswer;
+    }
+}

package/dist/agent/QueryEngine.d.ts

@@ -1,6 +1,7 @@
 import { GenerateContentResponse, Content } from '@google/genai';
 import { Tool } from './Tool.js';
 export declare const CODING_AGENT_SYSTEM_PROMPT: string;
+export declare const JOBS_SYSTEM_PROMPT: string;
 export interface QueryEngineOptions {
     model?: string;
     systemInstruction?: string;

package/dist/agent/QueryEngine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"QueryEngine.d.ts","sourceRoot":"","sources":["../../src/agent/QueryEngine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,uBAAuB,EAAE,OAAO,EAAQ,MAAM,eAAe,CAAC;AACpF,OAAO,EAAE,IAAI,EAAsB,MAAM,WAAW,CAAC;AAMrD,eAAO,MAAM,0BAA0B,QA8B/B,CAAC;AAMT,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8EAA8E;IAC9E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qDAAqD;IACrD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8EAA8E;IAC9E,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gEAAgE;IAChE,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,wEAAwE;IACxE,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,0FAA0F;IAC1F,UAAU,CAAC,EAAE,CAAC,QAAQ,CAAC,EAAE,uBAAuB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1E,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,KAAK,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IACtE,YAAY,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,KAAK,IAAI,CAAC;IACvD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,kDAAkD;IAClD,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,wEAAwE;IACxE,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,gDAAgD;IAChD,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;CAC3B;AAyCD;;;;GAIG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,EAAE,CAAc;IACxB,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,OAAO,CAAoB;IACnC,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,eAAe,CAAU;IACjC,OAAO,CAAC,gBAAgB,CAAS;gBAErB,OAAO,GAAE,kBAAuB;IAyBrC,UAAU,IAAI,OAAO,EAAE;IAIvB,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE;IAIpC,8CAA8C;IACvC,QAAQ,CAAC,KAAK,EAAE,IAAI,EAAE;IAW7B,OAAO,CAAC,mBAAmB;YAcb,YAAY;YAOZ,gBAAgB;IA6DjB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC;IAgF5E;;;;OAIG;IACU,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC;CA+FtF"}
+{"version":3,"file":"QueryEngine.d.ts","sourceRoot":"","sources":["../../src/agent/QueryEngine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,uBAAuB,EAAE,OAAO,EAAQ,MAAM,eAAe,CAAC;AACpF,OAAO,EAAE,IAAI,EAAsB,MAAM,WAAW,CAAC;AAMrD,eAAO,MAAM,0BAA0B,QA8B/B,CAAC;AAKT,eAAO,MAAM,kBAAkB,QAgFI,CAAC;AAMpC,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8EAA8E;IAC9E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qDAAqD;IACrD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8EAA8E;IAC9E,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gEAAgE;IAChE,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,wEAAwE;IACxE,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,0FAA0F;IAC1F,UAAU,CAAC,EAAE,CAAC,QAAQ,CAAC,EAAE,uBAAuB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1E,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,KAAK,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IACtE,YAAY,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,KAAK,IAAI,CAAC;IACvD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,kDAAkD;IAClD,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,wEAAwE;IACxE,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,gDAAgD;IAChD,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;CAC3B;AAyCD;;;;GAIG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,EAAE,CAAc;IACxB,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,OAAO,CAAoB;IACnC,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,eAAe,CAAU;IACjC,OAAO,CAAC,gBAAgB,CAAS;gBAErB,OAAO,GAAE,kBAAuB;IAyBrC,UAAU,IAAI,OAAO,EAAE;IAIvB,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE;IAIpC,8CAA8C;IACvC,QAAQ,CAAC,KAAK,EAAE,IAAI,EAAE;IAW7B,OAAO,CAAC,mBAAmB;YAcb,YAAY;YAOZ,gBAAgB;IA6DjB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC;IAqG5E;;;;OAIG;IACU,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC;CAoHtF"}

package/dist/agent/QueryEngine.js

@@ -36,6 +36,90 @@ For every coding task, follow this loop:
 - Keep functions short and focused on a single responsibility.
 `.trim();
 // ---------------------------------------------------------------------------
+// Elite Jobs System Prompt
+// ---------------------------------------------------------------------------
+export const JOBS_SYSTEM_PROMPT = `You are the CareerVivid elite jobs agent — a proactive career strategist.
+
+## CRITICAL: TOOL-FIRST POLICY (MANDATORY — NO EXCEPTIONS)
+You MUST call a tool BEFORE writing any response text when the user's message concerns their job pipeline or search.
+NEVER answer pipeline questions from memory or general knowledge. ALWAYS fetch fresh data from tools first.
+
+### Mandatory Tool Dispatch Table
+| If the user asks about... | You MUST call... |
+|---|---|
+| pipeline, jobs list, tracker, companies | list_local_jobs |
+| priority, what to work on, best ROI, what next | score_pipeline |
+| how is my search, dashboard, stats, metrics, apply rate | get_pipeline_metrics |
+| neglecting, stale, cold, going dark, need attention | flag_stale_jobs |
+| adding a company, tracking a new job | add_local_job |
+| updating status, marking applied, setting follow-up | update_local_job |
+| resume, background, skills, experience | get_resume |
+| job search, find jobs, search for roles | get_resume THEN search_jobs |
+
+This table is NON-NEGOTIABLE. Do not skip tools. Do not describe what you "would" do. CALL THE TOOL.
+
+## Core Tools
+- list_local_jobs       → Show the pipeline (supports tier/status filters and sort_by)
+- update_local_job      → Update any field on a job entry (status, attention, excitement, notes, follow-up)
+- add_local_job         → Add a new company to the tracker (auto-generates ID + priority score)
+- score_pipeline        → 📊 Priority-ranked view using attention formula (use for "what next?" questions)
+- get_pipeline_metrics  → 📈 Full analytics dashboard (apply rate, avg scores, salary, stale count)
+- flag_stale_jobs       → ⚠️  Surface companies going cold with next-action recommendations
+- get_resume            → Load the user's CareerVivid resume to personalize advice
+- search_jobs           → Search for newly posted jobs scored against the user's resume
+- list_jobs             → Show online Kanban board (separate from local CSV)
+
+## Attention Matrix (v2 Schema)
+Every company in the tracker has 8 attention/effort metrics:
+- attention_score (1–10): How top-of-mind is this company right now?
+- excitement (1–10): Pure enthusiasm for the role/company
+- apply_effort (Low/Medium/High): How much work is this application?
+- prep_time_hours: Estimated research hours needed
+- company_stage: Seed / Series A-C / Public / Enterprise
+- open_roles_count: How many roles are open
+- interview_rounds: Known interview process length
+- last_activity_date: Auto-stamped on every update (staleness detection)
+
+Priority Score formula: 40% attention + 30% excitement + 20% fit + 10% recency
+
+## Behavioral Rules
+1. ALWAYS call a tool first before giving any information about the user's pipeline
+2. ALWAYS call score_pipeline for "what should I work on?", "highest priority?", "what next?"
+3. ALWAYS call get_pipeline_metrics for "how is my search?", "stats", "dashboard", "apply rate"
+4. ALWAYS call flag_stale_jobs for "what am I neglecting?", "stale", "cold", "need attention"
+5. When marking a job Applied, AUTOMATICALLY suggest setting a follow-up date 7 days out
+6. Surface quick-apply opportunities (Low effort + To Apply) whenever user has limited time
+7. NEVER fabricate job data — only reference data returned by tools
+
+## Harness Directives: Autonomous Execution & Anti-Rationalization
+1. DO NOT ASK FOR PERMISSION. If the user's context clearly implies an action, you MUST autonomously use 'update_local_job', 'add_local_job', or other mutative tools to advance their pipeline without waiting for approval.
+2. If the user asks you to add or modify a job but doesn't provide all possible details (e.g., date, role, url), DO NOT ask them for the missing details. Use defaults like 'TBD', today's date, or empty strings and execute the tool immediately.
+3. If you catch yourself explaining what you are going to do instead of calling the tool, STOP. Call the tool.
+4. Complete the workflow entirely in a single turn. Do not use conversational handoffs (e.g. "Would you like me to...", "Could you provide...", "I need your permission") unless performing a destructive action.
+5. "Ask for forgiveness, not permission." Execute the action automatically.
+
+## Response Style
+- Format pipeline views as clean tables or bulleted lists with icons
+- Always show [ID], company, role, status, and priority score when discussing specific jobs
+- Be proactive: if you notice stale jobs or low apply velocity, mention it unprompted
+
+## Greeting Protocol
+When the user sends a generic greeting (e.g., "hey", "hello", "hi", "start"), you MUST return exactly this standardized routing menu, word-for-word, and do not call any tools:
+
+"Hello! How can I help you today? Are you looking to:
+
+View your job pipeline?
+
+Find new job opportunities?
+
+Update a job's status?
+
+Tailor your resume?
+
+Get an overview of your job search progress?
+
+Let me know what you need!"`.trim();
+// ---------------------------------------------------------------------------
 // Retry utility
 // ---------------------------------------------------------------------------
 const RETRYABLE_STATUS_CODES = new Set([429, 500, 502, 503, 504]);
@@ -240,7 +324,29 @@ export class QueryEngine {
                         : [{ text: response.text || '' }],
                 });
                 if (!hasToolCalls) {
-                    finalAnswer = response.text || '';
+                    const textOut = response.text || '';
+                    // [Harness Engineering] Prevent lazy conversational exits for Jobs Agent
+                    if (this.systemInstruction.includes("DO NOT ASK FOR PERMISSION")) {
+                        const lowerText = textOut.toLowerCase();
+                        const askingPermission = lowerText.includes("would you like me to") ||
+                            lowerText.includes("how would you like to proceed") ||
+                            lowerText.includes("should i go ahead") ||
+                            lowerText.includes("shall i") ||
+                            lowerText.includes("could you please provide") ||
+                            lowerText.includes("i need your permission") ||
+                            lowerText.includes("please provide") ||
+                            lowerText.includes("could you provide");
+                        if (askingPermission && iterations < maxIterations - 1) {
+                            if (hooks?.onThinking)
+                                hooks.onThinking("Harness intercepted permission seeking. Auto-correcting...");
+                            this.history.push({
+                                role: 'user',
+                                parts: [{ text: "[Harness Instruction]: You halted execution to ask for permission or missing information. RE-READ YOUR HARNESS DIRECTIVES. You must autonomously execute the mutation (e.g., update_local_job or add_local_job) using defaults for missing fields. Do not wait for confirmation. Do it now." }]
+                            });
+                            continue;
+                        }
+                    }
+                    finalAnswer = textOut;
                     break;
                 }
                 const functionResponses = await this.executeToolCalls(functionCalls, hooks);
@@ -331,7 +437,29 @@ export class QueryEngine {
                 if (hooks?.onResponse)
                     await hooks.onResponse(undefined);
                 if (!hasToolCalls) {
-                    finalAnswer = accumulatedText;
+                    const textOut = accumulatedText;
+                    // [Harness Engineering] Prevent lazy conversational exits for Jobs Agent
+                    if (this.systemInstruction.includes("DO NOT ASK FOR PERMISSION")) {
+                        const lowerText = textOut.toLowerCase();
+                        const askingPermission = lowerText.includes("would you like me to") ||
+                            lowerText.includes("how would you like to proceed") ||
+                            lowerText.includes("should i go ahead") ||
+                            lowerText.includes("shall i") ||
+                            lowerText.includes("could you please provide") ||
+                            lowerText.includes("i need your permission") ||
+                            lowerText.includes("please provide") ||
+                            lowerText.includes("could you provide");
+                        if (askingPermission && iterations < maxIterations - 1) {
+                            if (hooks?.onThinking)
+                                hooks.onThinking("Harness intercepted permission seeking. Auto-correcting...");
+                            this.history.push({
+                                role: 'user',
+                                parts: [{ text: "[Harness Instruction]: You halted execution to ask for permission or missing information. RE-READ YOUR HARNESS DIRECTIVES. You must autonomously execute the mutation (e.g., update_local_job or add_local_job) using defaults for missing fields. Do not wait for confirmation. Do it now." }]
+                            });
+                            continue;
+                        }
+                    }
+                    finalAnswer = textOut;
                     break;
                 }
                 const functionResponses = await this.executeToolCalls(accumulatedFunctionCalls, hooks);

package/dist/agent/providers/AnthropicProvider.js

@@ -83,7 +83,7 @@ export class AnthropicProvider {
         const messages = this.toAnthropicMessages(history, userTurn);
         const anthropicTools = tools.length > 0 ? this.toAnthropicTools(tools) : undefined;
         const body = {
-            model: "", // set by caller
+            model: request.model || "", // set by caller
             max_tokens: 8192,
             system: systemInstruction,
             messages,
@@ -136,7 +136,7 @@ export class AnthropicProvider {
         const messages = this.toAnthropicMessages(history, userTurn);
         const anthropicTools = tools.length > 0 ? this.toAnthropicTools(tools) : undefined;
         const body = {
-            model: "",
+            model: request.model || "",
             max_tokens: 8192,
             system: systemInstruction,
             messages,

package/dist/agent/providers/LLMProvider.d.ts

@@ -21,6 +21,8 @@ export interface LLMRequest {
     thinkingBudget?: number;
     /** Whether to include thinking text */
     includeThoughts?: boolean;
+    /** Optional model override for BYO providers */
+    model?: string;
 }
 export interface LLMResponse {
     /** Text response parts from the model */

package/dist/agent/providers/LLMProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"LLMProvider.d.ts","sourceRoot":"","sources":["../../../src/agent/providers/LLMProvider.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEvC,MAAM,WAAW,UAAU;IACzB,yEAAyE;IACzE,OAAO,EAAE,OAAO,EAAE,CAAC;IACnB,iEAAiE;IACjE,QAAQ,EAAE,OAAO,CAAC;IAClB,uCAAuC;IACvC,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,yBAAyB;IACzB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gEAAgE;IAChE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,uCAAuC;IACvC,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,WAAW;IAC1B,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,aAAa,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,GAAG,CAAA;KAAE,CAAC,CAAC;IAClD,+EAA+E;IAC/E,QAAQ,EAAE,IAAI,EAAE,CAAC;IACjB,kBAAkB;IAClB,UAAU,EAAE,MAAM,GAAG,YAAY,GAAG,YAAY,GAAG,OAAO,CAAC;CAC5D;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,GAAG,CAAA;KAAE,CAAC,CAAC;IACnD,QAAQ,CAAC,EAAE,IAAI,EAAE,CAAC;IAClB,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,WAAW;IAC1B;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAEpD;;;OAGG;IACH,cAAc,CACZ,OAAO,EAAE,UAAU,EACnB,OAAO,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,GACvC,OAAO,CAAC,WAAW,CAAC,CAAC;CACzB"}
+{"version":3,"file":"LLMProvider.d.ts","sourceRoot":"","sources":["../../../src/agent/providers/LLMProvider.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEvC,MAAM,WAAW,UAAU;IACzB,yEAAyE;IACzE,OAAO,EAAE,OAAO,EAAE,CAAC;IACnB,iEAAiE;IACjE,QAAQ,EAAE,OAAO,CAAC;IAClB,uCAAuC;IACvC,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,yBAAyB;IACzB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gEAAgE;IAChE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,uCAAuC;IACvC,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,gDAAgD;IAChD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,aAAa,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,GAAG,CAAA;KAAE,CAAC,CAAC;IAClD,+EAA+E;IAC/E,QAAQ,EAAE,IAAI,EAAE,CAAC;IACjB,kBAAkB;IAClB,UAAU,EAAE,MAAM,GAAG,YAAY,GAAG,YAAY,GAAG,OAAO,CAAC;CAC5D;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,GAAG,CAAA;KAAE,CAAC,CAAC;IACnD,QAAQ,CAAC,EAAE,IAAI,EAAE,CAAC;IAClB,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,WAAW;IAC1B;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAEpD;;;OAGG;IACH,cAAc,CACZ,OAAO,EAAE,UAAU,EACnB,OAAO,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,GACvC,OAAO,CAAC,WAAW,CAAC,CAAC;CACzB"}

package/dist/agent/providers/OpenAIProvider.js

@@ -97,7 +97,7 @@ export class OpenAIProvider {
         const messages = this.toOpenAIMessages(history, userTurn, systemInstruction);
         const openAITools = tools.length > 0 ? this.toOpenAITools(tools) : undefined;
         const body = {
-            model: "", // caller sets via fetch; we don't store model here
+            model: request.model || "", // fallback to empty if missing
             messages,
             ...(openAITools ? { tools: openAITools, tool_choice: "auto" } : {}),
         };
@@ -147,7 +147,7 @@ export class OpenAIProvider {
         const messages = this.toOpenAIMessages(history, userTurn, systemInstruction);
         const openAITools = tools.length > 0 ? this.toOpenAITools(tools) : undefined;
         const body = {
-            model: "",
+            model: request.model || "",
             messages,
             stream: true,
             ...(openAITools ? { tools: openAITools, tool_choice: "auto" } : {}),

package/dist/agent/tools/browser.d.ts

@@ -0,0 +1,22 @@
+/**
+ * browser.ts — Browser control tools for the CareerVivid Agent.
+ *
+ * These tools give the Gemini agent interactive browser control, enabling it
+ * to navigate pages, read interactive elements, fill forms, click buttons,
+ * and handle multi-page application workflows — just like Antigravity or
+ * Claude Desktop's Computer Use.
+ *
+ * Architecture:
+ * - Uses a DEDICATED automation Chromium profile (never conflicts with real Chrome)
+ * - Sessions persist via ~/.careervivid/browser-session/ between agent runs
+ * - Each tool is a standard Tool object that plugs into QueryEngine's tool loop
+ * - DOM is simplified to a numbered Accessibility Object Model (AOM) for the LLM
+ *
+ * Why NOT the real Chrome profile:
+ *   Chrome locks its profile while running. Attempting launchPersistentContext
+ *   on the real profile while Chrome is open causes a SIGTRAP crash.
+ *   The dedicated profile avoids this entirely and is always available.
+ */
+import { Tool } from "../Tool.js";
+export declare const ALL_BROWSER_TOOLS: Tool[];
+//# sourceMappingURL=browser.d.ts.map

package/dist/agent/tools/browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../../../src/agent/tools/browser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAysBlC,eAAO,MAAM,iBAAiB,EAAE,IAAI,EAanC,CAAC"}