joonecli 0.1.0 → 0.1.1

package/dist/core/contextGuard.js

@@ -0,0 +1,95 @@
+/**
+ * Context Guard
+ *
+ * Proactively monitors token usage during the agent loop and triggers auto-compaction
+ * before the model's context window is exceeded.
+ *
+ * Thresholds:
+ * - 80% (WARN): Triggers standard LLM-powered context compaction
+ * - 95% (CRITICAL): Forces emergency truncation if compaction fails
+ */
+import { SystemMessage } from "@langchain/core/messages";
+import { CacheOptimizedPromptBuilder } from "./promptBuilder.js";
+import { countMessageTokens } from "./tokenCounter.js";
+import { createHandoffPrompt } from "./compactor.js";
+export class ContextGuard {
+    promptBuilder;
+    llm;
+    maxTokens;
+    constructor(llm, maxTokens, promptBuilder = new CacheOptimizedPromptBuilder()) {
+        this.llm = llm;
+        this.maxTokens = maxTokens;
+        this.promptBuilder = promptBuilder;
+    }
+    /**
+     * Checks the token usage of the current state and compacts if necessary.
+     * Returns updated state and metrics about the action taken.
+     */
+    async ensureCapacity(state, warnThreshold = 0.8, criticalThreshold = 0.95) {
+        const fullPrompt = this.promptBuilder.buildPrompt(state);
+        const tokenCount = countMessageTokens(fullPrompt);
+        // 1. Under limit — do nothing
+        if (tokenCount < this.maxTokens * warnThreshold) {
+            return {
+                state,
+                metrics: {
+                    originalTokens: tokenCount,
+                    newTokens: tokenCount,
+                    messagesEvicted: 0,
+                    actionTaken: "none",
+                },
+            };
+        }
+        // 2. Over WARN but below CRITICAL — try standard LLM compaction
+        if (tokenCount < this.maxTokens * criticalThreshold) {
+            const result = await this.promptBuilder.compactHistoryWithLLM(state.conversationHistory, this.llm, 8 // keep last 8 messages
+            );
+            return {
+                state: {
+                    ...state,
+                    conversationHistory: result.compactedHistory,
+                },
+                metrics: {
+                    originalTokens: tokenCount,
+                    newTokens: result.tokensAfter,
+                    messagesEvicted: result.evictedCount,
+                    actionTaken: "compacted",
+                },
+            };
+        }
+        // 3. CRITICAL overflow (or standard compaction didn't free enough space)
+        // Emergency truncation: drop everything except the last 4 messages and inject an emergency handoff
+        const keepLast = 4;
+        // If we're already at or below 4 messages, we literally can't truncate more
+        if (state.conversationHistory.length <= keepLast) {
+            return {
+                state,
+                metrics: { originalTokens: tokenCount, newTokens: tokenCount, messagesEvicted: 0, actionTaken: "none" }
+            };
+        }
+        const recentMsgs = state.conversationHistory.slice(-keepLast);
+        const evictedCount = state.conversationHistory.length - keepLast;
+        const emergencySystemMsg = new SystemMessage(`[EMERGENCY CONTEXT TRUNCATION]\n` +
+            `The conversation exceeded the maximum context window (${this.maxTokens} tokens). ` +
+            `Older messages were aggressively deleted without summarization to prevent an immediate crash.\n` +
+            `You are the same agent. ` + createHandoffPrompt(new Date().toISOString()));
+        const newHistory = [emergencySystemMsg, ...recentMsgs];
+        const newTokens = countMessageTokens(this.promptBuilder.buildPrompt({
+            ...state,
+            conversationHistory: newHistory
+        }));
+        return {
+            state: {
+                ...state,
+                conversationHistory: newHistory,
+            },
+            metrics: {
+                originalTokens: tokenCount,
+                newTokens,
+                messagesEvicted: evictedCount,
+                actionTaken: "emergency_truncated",
+            },
+        };
+    }
+}
+//# sourceMappingURL=contextGuard.js.map

package/dist/core/contextGuard.js.map

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

package/dist/core/promptBuilder.d.ts

@@ -1,4 +1,7 @@
 import { BaseMessage } from "@langchain/core/messages";
+import { BaseChatModel } from "@langchain/core/language_models/chat_models";
+import { Runnable } from "@langchain/core/runnables";
+import { CompactionResult } from "./compactor.js";
 export interface ContextState {
     globalSystemInstructions: string;
     projectMemory: string;
@@ -29,7 +32,7 @@ export declare class CacheOptimizedPromptBuilder {
      */
     injectSystemReminder(history: BaseMessage[], reminder: string): BaseMessage[];
     /**
-     * Cache-Safe Compaction
+     * Cache-Safe Compaction (string-based fallback)
      * When history gets too long, we preserve the last N messages (recent context)
      * and replace older messages with a summary. The static system prefix is untouched.
      *
@@ -38,6 +41,18 @@ export declare class CacheOptimizedPromptBuilder {
      * @param keepLastN - Number of recent messages to preserve (default: 6).
      */
     compactHistory(history: BaseMessage[], summary: string, keepLastN?: number): BaseMessage[];
+    /**
+     * LLM-Powered Compaction with Handoff
+     * Uses a dedicated LLM call to generate a structured summary, then injects
+     * a handoff prompt to orient the agent. Falls back to string-based compaction
+     * if the LLM call fails.
+     *
+     * @param history - The full conversation history.
+     * @param llm - The LLM to use for summarization (should be a fast/cheap model).
+     * @param keepLastN - Number of recent messages to preserve (default: 8).
+     * @returns CompactionResult with the new history and metrics.
+     */
+    compactHistoryWithLLM(history: BaseMessage[], llm: Runnable | BaseChatModel, keepLastN?: number): Promise<CompactionResult>;
     /**
      * Checks if the conversation should be compacted based on token usage.
      *

package/dist/core/promptBuilder.js

@@ -1,5 +1,6 @@
 import { SystemMessage, HumanMessage, } from "@langchain/core/messages";
 import { countMessageTokens } from "./tokenCounter.js";
+import { ConversationCompactor } from "./compactor.js";
 /**
  * CacheOptimizedPromptBuilder
  *
@@ -20,18 +21,15 @@ export class CacheOptimizedPromptBuilder {
         // We use SystemMessages for the static prefix.
         // In @langchain/anthropic, to use cache_control, we can inject it into the final message of each tier if needed,
         // but preserving the exact order of the system prompts is the main requirement.
+        const unifiedContent = [
+            state.globalSystemInstructions,
+            `--- Project Context ---\n${state.projectMemory}`,
+            `--- Session Rules ---\n${state.sessionContext}`,
+        ].join("\n\n");
         const systemMessages = [
             new SystemMessage({
-                content: state.globalSystemInstructions,
-                name: "global_instructions",
-            }),
-            new SystemMessage({
-                content: `--- Project Context ---\n${state.projectMemory}`,
-                name: "project_context",
-            }),
-            new SystemMessage({
-                content: `--- Session Rules ---\n${state.sessionContext}`,
-                name: "session_context",
+                content: unifiedContent,
+                name: "global_context",
             }),
         ];
         // Combine the static prefix with the dynamic conversation history
@@ -49,7 +47,7 @@ export class CacheOptimizedPromptBuilder {
         return [...history, reminderMsg];
     }
     /**
-     * Cache-Safe Compaction
+     * Cache-Safe Compaction (string-based fallback)
      * When history gets too long, we preserve the last N messages (recent context)
      * and replace older messages with a summary. The static system prefix is untouched.
      *
@@ -61,13 +59,28 @@ export class CacheOptimizedPromptBuilder {
         if (history.length === 0) {
             return history;
         }
-        // Use SystemMessage (not AIMessage) to avoid breaking user/assistant
-        // alternation rules enforced by some providers (e.g. Anthropic).
-        const compactedMessage = new SystemMessage(`[The previous conversation history has been compacted.]\nSummary:\n${summary}`);
+        // Use HumanMessage formatted as a system update to avoid breaking Google's validation
+        // and maintaining proper user/assistant flow.
+        const compactedMessage = new HumanMessage(`<system-update>\n[The previous conversation history has been compacted.]\nSummary:\n${summary}\n</system-update>`);
         // Preserve recent messages for continuity
         const recentMessages = history.slice(-keepLastN);
         return [compactedMessage, ...recentMessages];
     }
+    /**
+     * LLM-Powered Compaction with Handoff
+     * Uses a dedicated LLM call to generate a structured summary, then injects
+     * a handoff prompt to orient the agent. Falls back to string-based compaction
+     * if the LLM call fails.
+     *
+     * @param history - The full conversation history.
+     * @param llm - The LLM to use for summarization (should be a fast/cheap model).
+     * @param keepLastN - Number of recent messages to preserve (default: 8).
+     * @returns CompactionResult with the new history and metrics.
+     */
+    async compactHistoryWithLLM(history, llm, keepLastN = 8) {
+        const compactor = new ConversationCompactor();
+        return compactor.compact(history, llm, { keepLastN });
+    }
     /**
      * Checks if the conversation should be compacted based on token usage.
      *

package/dist/core/promptBuilder.js.map

@@ -1 +1 @@
-{"version":3,"file":"promptBuilder.js","sourceRoot":"","sources":["../../src/core/promptBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,aAAa,EACb,YAAY,GAEb,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AASvD;;;;;;;;;;GAUG;AACH,MAAM,OAAO,2BAA2B;IACtC;;;OAGG;IACI,WAAW,CAAC,KAAmB;QACpC,+CAA+C;QAC/C,iHAAiH;QACjH,gFAAgF;QAEhF,MAAM,cAAc,GAAkB;YACpC,IAAI,aAAa,CAAC;gBAChB,OAAO,EAAE,KAAK,CAAC,wBAAwB;gBACvC,IAAI,EAAE,qBAAqB;aAC5B,CAAC;YACF,IAAI,aAAa,CAAC;gBAChB,OAAO,EAAE,4BAA4B,KAAK,CAAC,aAAa,EAAE;gBAC1D,IAAI,EAAE,iBAAiB;aACxB,CAAC;YACF,IAAI,aAAa,CAAC;gBAChB,OAAO,EAAE,0BAA0B,KAAK,CAAC,cAAc,EAAE;gBACzD,IAAI,EAAE,iBAAiB;aACxB,CAAC;SACH,CAAC;QAEF,kEAAkE;QAClE,OAAO,CAAC,GAAG,cAAc,EAAE,GAAG,KAAK,CAAC,mBAAmB,CAAC,CAAC;IAC3D,CAAC;IAED;;;;OAIG;IACI,oBAAoB,CACzB,OAAsB,EACtB,QAAgB;QAEhB,MAAM,WAAW,GAAG,IAAI,YAAY,CAAC;YACnC,OAAO,EAAE,sBAAsB,QAAQ,sBAAsB;SAC9D,CAAC,CAAC;QACH,OAAO,CAAC,GAAG,OAAO,EAAE,WAAW,CAAC,CAAC;IACnC,CAAC;IAED;;;;;;;;OAQG;IACI,cAAc,CACnB,OAAsB,EACtB,OAAe,EACf,SAAS,GAAG,CAAC;QAEb,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,OAAO,CAAC;QACjB,CAAC;QAED,qEAAqE;QACrE,iEAAiE;QACjE,MAAM,gBAAgB,GAAG,IAAI,aAAa,CACxC,sEAAsE,OAAO,EAAE,CAChF,CAAC;QAEF,0CAA0C;QAC1C,MAAM,cAAc,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,CAAC;QAEjD,OAAO,CAAC,gBAAgB,EAAE,GAAG,cAAc,CAAC,CAAC;IAC/C,CAAC;IAED;;;;;;OAMG;IACI,aAAa,CAClB,KAAmB,EACnB,SAAiB,EACjB,SAAS,GAAG,GAAG;QAEf,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QAC5C,MAAM,KAAK,GAAG,kBAAkB,CAAC,WAAW,CAAC,CAAC;QAC9C,OAAO,KAAK,IAAI,SAAS,GAAG,SAAS,CAAC;IACxC,CAAC;CACF"}
+{"version":3,"file":"promptBuilder.js","sourceRoot":"","sources":["../../src/core/promptBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,aAAa,EACb,YAAY,GAEb,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAoB,MAAM,gBAAgB,CAAC;AASzE;;;;;;;;;;GAUG;AACH,MAAM,OAAO,2BAA2B;IACtC;;;OAGG;IACI,WAAW,CAAC,KAAmB;QACpC,+CAA+C;QAC/C,iHAAiH;QACjH,gFAAgF;QAEhF,MAAM,cAAc,GAAG;YACrB,KAAK,CAAC,wBAAwB;YAC9B,4BAA4B,KAAK,CAAC,aAAa,EAAE;YACjD,0BAA0B,KAAK,CAAC,cAAc,EAAE;SACjD,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAEf,MAAM,cAAc,GAAkB;YACpC,IAAI,aAAa,CAAC;gBAChB,OAAO,EAAE,cAAc;gBACvB,IAAI,EAAE,gBAAgB;aACvB,CAAC;SACH,CAAC;QAEF,kEAAkE;QAClE,OAAO,CAAC,GAAG,cAAc,EAAE,GAAG,KAAK,CAAC,mBAAmB,CAAC,CAAC;IAC3D,CAAC;IAED;;;;OAIG;IACI,oBAAoB,CACzB,OAAsB,EACtB,QAAgB;QAEhB,MAAM,WAAW,GAAG,IAAI,YAAY,CAAC;YACnC,OAAO,EAAE,sBAAsB,QAAQ,sBAAsB;SAC9D,CAAC,CAAC;QACH,OAAO,CAAC,GAAG,OAAO,EAAE,WAAW,CAAC,CAAC;IACnC,CAAC;IAED;;;;;;;;OAQG;IACI,cAAc,CACnB,OAAsB,EACtB,OAAe,EACf,SAAS,GAAG,CAAC;QAEb,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,OAAO,CAAC;QACjB,CAAC;QAED,sFAAsF;QACtF,8CAA8C;QAC9C,MAAM,gBAAgB,GAAG,IAAI,YAAY,CACvC,uFAAuF,OAAO,oBAAoB,CACnH,CAAC;QAEF,0CAA0C;QAC1C,MAAM,cAAc,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,CAAC;QAEjD,OAAO,CAAC,gBAAgB,EAAE,GAAG,cAAc,CAAC,CAAC;IAC/C,CAAC;IAED;;;;;;;;;;OAUG;IACI,KAAK,CAAC,qBAAqB,CAChC,OAAsB,EACtB,GAA6B,EAC7B,SAAS,GAAG,CAAC;QAEb,MAAM,SAAS,GAAG,IAAI,qBAAqB,EAAE,CAAC;QAC9C,OAAO,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;IACxD,CAAC;IAED;;;;;;OAMG;IACI,aAAa,CAClB,KAAmB,EACnB,SAAiB,EACjB,SAAS,GAAG,GAAG;QAEf,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QAC5C,MAAM,KAAK,GAAG,kBAAkB,CAAC,WAAW,CAAC,CAAC;QAC9C,OAAO,KAAK,IAAI,SAAS,GAAG,SAAS,CAAC;IACxC,CAAC;CACF"}

package/dist/core/sessionResumer.js

@@ -1,6 +1,6 @@
 import * as fs from "node:fs";
 import * as path from "node:path";
-import { AIMessage, SystemMessage } from "@langchain/core/messages";
+import { AIMessage, HumanMessage } from "@langchain/core/messages";
 export class SessionResumer {
     workspaceDir;
     constructor(workspaceDir) {
@@ -29,9 +29,9 @@ export class SessionResumer {
         else {
             wakeupPrompt += `- No files in your active context appear to have been edited on the host while you were paused.\n`;
         }
-        // Inject as a System Message at the very end of the history
+        // Inject as a Human Message at the very end of the history
         // so it acts as an immediate reminder before the next LLM generation.
-        state.conversationHistory.push(new SystemMessage(wakeupPrompt));
+        state.conversationHistory.push(new HumanMessage(`<system-wakeup>\n${wakeupPrompt}\n</system-wakeup>`));
         return state;
     }
     /**

package/dist/core/sessionResumer.js.map

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

package/dist/core/subAgent.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Sub-Agent Manager
+ *
+ * Spawns and orchestrates isolated sub-agents for scoped tasks.
+ * Each sub-agent gets its own ExecutionHarness with a separate conversation
+ * history. Only the final SubAgentResult is returned to the main agent,
+ * discarding the sub-agent's internal conversation to save context.
+ *
+ * Supports both synchronous (blocking) and asynchronous (non-blocking) modes.
+ *
+ * Safety:
+ * - Depth limit of 1: sub-agents cannot spawn other sub-agents
+ * - maxTurns cap per agent prevents doom-loops
+ * - Concurrent async agent cap of 3 prevents resource exhaustion
+ * - Per-agent token budget tracking
+ */
+import { SubAgentResult } from "../agents/agentSpec.js";
+import { AgentRegistry } from "../agents/agentRegistry.js";
+import { DynamicToolInterface } from "../tools/index.js";
+import { BaseChatModel } from "@langchain/core/language_models/chat_models";
+import { Runnable } from "@langchain/core/runnables";
+export declare class SubAgentManager {
+    private registry;
+    private allTools;
+    private llm;
+    private asyncTasks;
+    private taskCounter;
+    constructor(registry: AgentRegistry, tools: DynamicToolInterface[], llm: Runnable | BaseChatModel);
+    /**
+     * Synchronous spawn — blocks until the sub-agent finishes.
+     */
+    spawn(agentName: string, task: string, maxTurnsOverride?: number): Promise<SubAgentResult>;
+    /**
+     * Asynchronous spawn — returns immediately with a taskId.
+     * The main agent can poll with getResult(taskId).
+     */
+    spawnAsync(agentName: string, task: string, maxTurnsOverride?: number): Promise<string>;
+    /**
+     * Check the status or get the result of an async task.
+     * Returns the result if completed, or a status message if still running.
+     */
+    getResult(taskId: string): Promise<SubAgentResult | string>;
+    /**
+     * Core execution loop for a sub-agent.
+     * Creates an isolated conversation and runs a multi-turn loop.
+     */
+    private runAgent;
+    /**
+     * Creates an error SubAgentResult.
+     */
+    private makeErrorResult;
+    /**
+     * Clean up expired async tasks.
+     */
+    private cleanupExpired;
+}

package/dist/core/subAgent.js

@@ -0,0 +1,240 @@
+/**
+ * Sub-Agent Manager
+ *
+ * Spawns and orchestrates isolated sub-agents for scoped tasks.
+ * Each sub-agent gets its own ExecutionHarness with a separate conversation
+ * history. Only the final SubAgentResult is returned to the main agent,
+ * discarding the sub-agent's internal conversation to save context.
+ *
+ * Supports both synchronous (blocking) and asynchronous (non-blocking) modes.
+ *
+ * Safety:
+ * - Depth limit of 1: sub-agents cannot spawn other sub-agents
+ * - maxTurns cap per agent prevents doom-loops
+ * - Concurrent async agent cap of 3 prevents resource exhaustion
+ * - Per-agent token budget tracking
+ */
+import { countMessageTokens } from "../core/tokenCounter.js";
+import { HumanMessage, SystemMessage, ToolMessage } from "@langchain/core/messages";
+// ─── Constants ──────────────────────────────────────────────────────────────────
+const DEFAULT_MAX_TURNS = 10;
+const MAX_CONCURRENT_ASYNC = 3;
+const ASYNC_EXPIRY_MS = 5 * 60 * 1000; // 5 minutes
+// ─── SubAgentManager ────────────────────────────────────────────────────────────
+export class SubAgentManager {
+    registry;
+    allTools;
+    llm;
+    asyncTasks = new Map();
+    taskCounter = 0;
+    constructor(registry, tools, llm) {
+        this.registry = registry;
+        // Filter out spawn_agent and check_agent to prevent recursive nesting (depth-1 limit)
+        this.allTools = tools.filter((t) => t.name !== "spawn_agent" && t.name !== "check_agent");
+        this.llm = llm;
+    }
+    /**
+     * Synchronous spawn — blocks until the sub-agent finishes.
+     */
+    async spawn(agentName, task, maxTurnsOverride) {
+        const spec = this.registry.get(agentName);
+        if (!spec) {
+            return this.makeErrorResult(agentName, task, `Unknown agent "${agentName}". Available: ${this.registry.getNames().join(", ")}`);
+        }
+        return this.runAgent(spec, task, maxTurnsOverride);
+    }
+    /**
+     * Asynchronous spawn — returns immediately with a taskId.
+     * The main agent can poll with getResult(taskId).
+     */
+    async spawnAsync(agentName, task, maxTurnsOverride) {
+        // Cap concurrent async agents
+        this.cleanupExpired();
+        const activeCount = Array.from(this.asyncTasks.values())
+            .filter((t) => !t.completed).length;
+        if (activeCount >= MAX_CONCURRENT_ASYNC) {
+            throw new Error(`Maximum concurrent async agents reached (${MAX_CONCURRENT_ASYNC}). ` +
+                `Wait for existing tasks to complete or check them with check_agent.`);
+        }
+        const spec = this.registry.get(agentName);
+        if (!spec) {
+            throw new Error(`Unknown agent "${agentName}". Available: ${this.registry.getNames().join(", ")}`);
+        }
+        const taskId = `task_${++this.taskCounter}_${Date.now()}`;
+        const promise = this.runAgent(spec, task, maxTurnsOverride).then((result) => {
+            const asyncTask = this.asyncTasks.get(taskId);
+            if (asyncTask) {
+                asyncTask.result = result;
+                asyncTask.completed = true;
+            }
+            return result;
+        });
+        this.asyncTasks.set(taskId, {
+            taskId,
+            agentName,
+            taskDescription: task,
+            promise,
+            startedAt: Date.now(),
+            completed: false,
+        });
+        return taskId;
+    }
+    /**
+     * Check the status or get the result of an async task.
+     * Returns the result if completed, or a status message if still running.
+     */
+    async getResult(taskId) {
+        const asyncTask = this.asyncTasks.get(taskId);
+        if (!asyncTask) {
+            return `Unknown task ID: ${taskId}. No such async task exists.`;
+        }
+        if (asyncTask.completed && asyncTask.result) {
+            // Clean up the task
+            this.asyncTasks.delete(taskId);
+            return asyncTask.result;
+        }
+        const elapsed = Math.round((Date.now() - asyncTask.startedAt) / 1000);
+        return `Task "${asyncTask.taskDescription}" (agent: ${asyncTask.agentName}) ` +
+            `is still running (${elapsed}s elapsed).`;
+    }
+    /**
+     * Core execution loop for a sub-agent.
+     * Creates an isolated conversation and runs a multi-turn loop.
+     */
+    async runAgent(spec, task, maxTurnsOverride) {
+        const startTime = Date.now();
+        const maxTurns = maxTurnsOverride ?? spec.maxTurns ?? DEFAULT_MAX_TURNS;
+        // Resolve available tools for this agent
+        const agentTools = spec.tools
+            ? this.allTools.filter((t) => spec.tools.includes(t.name))
+            : this.allTools;
+        // Create isolated conversation history
+        const systemPrompt = new SystemMessage(`${spec.systemPrompt}\n\n--- Current Task ---\n${task}`);
+        const history = [
+            new HumanMessage(task),
+        ];
+        let promptTokens = 0;
+        let completionTokens = 0;
+        let toolCallCount = 0;
+        let turnsUsed = 0;
+        let lastResponse = "";
+        const filesModified = new Set();
+        // Build LangChain tool declarations for binding
+        const toolDeclarations = agentTools.map((t) => ({
+            name: t.name,
+            description: t.description,
+            schema: t.schema,
+        }));
+        try {
+            // Bind tools to the LLM for this sub-agent session
+            let boundLlm;
+            if ("bindTools" in this.llm && typeof this.llm.bindTools === "function") {
+                boundLlm = this.llm.bindTools(toolDeclarations);
+            }
+            else {
+                boundLlm = this.llm;
+            }
+            for (let turn = 0; turn < maxTurns; turn++) {
+                turnsUsed++;
+                // Build the full message array
+                const messages = [systemPrompt, ...history];
+                const stepPromptTokens = countMessageTokens(messages);
+                promptTokens += stepPromptTokens;
+                // Invoke the LLM
+                const response = await boundLlm.invoke(messages);
+                const responseTokens = countMessageTokens([response]);
+                completionTokens += responseTokens;
+                const aiMessage = response;
+                history.push(aiMessage);
+                // Extract text content
+                if (typeof aiMessage.content === "string" && aiMessage.content.length > 0) {
+                    lastResponse = aiMessage.content;
+                }
+                // Check for tool calls
+                if (!aiMessage.tool_calls || aiMessage.tool_calls.length === 0) {
+                    // No tool calls — agent is done
+                    break;
+                }
+                // Execute tool calls
+                for (const call of aiMessage.tool_calls) {
+                    if (!call.id)
+                        continue;
+                    const tool = agentTools.find((t) => t.name === call.name);
+                    if (!tool) {
+                        history.push(new ToolMessage({
+                            content: `Error: Tool "${call.name}" is not available to this sub-agent.`,
+                            tool_call_id: call.id,
+                        }));
+                        continue;
+                    }
+                    toolCallCount++;
+                    try {
+                        const result = await tool.execute(call.args);
+                        const output = typeof result === "string" ? result : result.content;
+                        // Track file modifications
+                        if (call.name === "write_file" && call.args?.path) {
+                            filesModified.add(call.args.path);
+                        }
+                        history.push(new ToolMessage({
+                            content: output,
+                            tool_call_id: call.id,
+                        }));
+                    }
+                    catch (err) {
+                        history.push(new ToolMessage({
+                            content: `Tool error: ${err.message}`,
+                            tool_call_id: call.id,
+                        }));
+                    }
+                }
+            }
+            // Determine outcome
+            const outcome = turnsUsed >= maxTurns ? "partial" : "success";
+            return {
+                agentName: spec.name,
+                taskDescription: task,
+                outcome,
+                result: lastResponse || "(Sub-agent produced no text output)",
+                filesModified: Array.from(filesModified),
+                toolCallCount,
+                tokenUsage: { prompt: promptTokens, completion: completionTokens },
+                duration: Date.now() - startTime,
+                turnsUsed,
+            };
+        }
+        catch (error) {
+            return this.makeErrorResult(spec.name, task, `Sub-agent error: ${error.message}`, { promptTokens, completionTokens, toolCallCount, turnsUsed, startTime, filesModified });
+        }
+    }
+    /**
+     * Creates an error SubAgentResult.
+     */
+    makeErrorResult(agentName, task, errorMsg, partial) {
+        return {
+            agentName,
+            taskDescription: task,
+            outcome: "failure",
+            result: errorMsg,
+            filesModified: partial ? Array.from(partial.filesModified) : [],
+            toolCallCount: partial?.toolCallCount ?? 0,
+            tokenUsage: {
+                prompt: partial?.promptTokens ?? 0,
+                completion: partial?.completionTokens ?? 0,
+            },
+            duration: partial ? Date.now() - partial.startTime : 0,
+            turnsUsed: partial?.turnsUsed ?? 0,
+        };
+    }
+    /**
+     * Clean up expired async tasks.
+     */
+    cleanupExpired() {
+        const now = Date.now();
+        for (const [taskId, task] of this.asyncTasks.entries()) {
+            if (now - task.startedAt > ASYNC_EXPIRY_MS) {
+                this.asyncTasks.delete(taskId);
+            }
+        }
+    }
+}
+//# sourceMappingURL=subAgent.js.map

package/dist/core/subAgent.js.map

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

package/dist/debug_google.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/debug_google.js

@@ -0,0 +1,23 @@
+import { ExecutionHarness } from "./core/agentLoop.js";
+import { ChatGoogleGenerativeAI } from "@langchain/google-genai";
+import { HumanMessage } from "@langchain/core/messages";
+async function run() {
+    const llm = new ChatGoogleGenerativeAI({ apiKey: "dummy-key", modelName: "gemini-1.5-pro" });
+    const harness = new ExecutionHarness(llm, [], undefined, undefined, "google", "gemini-1.5-pro");
+    const state = {
+        globalSystemInstructions: `You are Joone...`,
+        projectMemory: "No project context loaded yet.",
+        sessionContext: `Environment: test\nCWD: test`,
+        conversationHistory: [
+            new HumanMessage("Hello Google AI")
+        ]
+    };
+    try {
+        await harness.step(state);
+    }
+    catch (e) {
+        console.error("Caught in harness:", e.message);
+    }
+}
+run();
+//# sourceMappingURL=debug_google.js.map

package/dist/debug_google.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug_google.js","sourceRoot":"","sources":["../src/debug_google.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAExD,KAAK,UAAU,GAAG;IAChB,MAAM,GAAG,GAAG,IAAI,sBAAsB,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,gBAAgB,EAAE,CAAC,CAAC;IAC7F,MAAM,OAAO,GAAG,IAAI,gBAAgB,CAAC,GAAG,EAAE,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,gBAAgB,CAAC,CAAC;IAEhG,MAAM,KAAK,GAAG;QACZ,wBAAwB,EAAE,kBAAkB;QAC5C,aAAa,EAAE,gCAAgC;QAC/C,cAAc,EAAE,8BAA8B;QAC9C,mBAAmB,EAAE;YACnB,IAAI,YAAY,CAAC,iBAAiB,CAAC;SACpC;KACF,CAAC;IAEF,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC5B,CAAC;IAAC,OAAO,CAAM,EAAE,CAAC;QAChB,OAAO,CAAC,KAAK,CAAC,oBAAoB,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;IACjD,CAAC;AACH,CAAC;AAED,GAAG,EAAE,CAAC"}

package/dist/test_google.d.ts

@@ -0,0 +1 @@
+export {};