@compilr-dev/agents 0.3.11 → 0.3.13

package/dist/index.d.ts

@@ -31,16 +31,16 @@ export { PerplexityProvider, createPerplexityProvider } from './providers/index.
 export type { PerplexityProviderConfig } from './providers/index.js';
 export { OpenRouterProvider, createOpenRouterProvider } from './providers/index.js';
 export type { OpenRouterProviderConfig } from './providers/index.js';
-export type { Tool, ToolHandler, ToolRegistry, ToolInputSchema, ToolExecutionResult, ToolRegistryOptions, ToolFallbackHandler, DefineToolOptions, ReadFileInput, WriteFileInput, BashInput, BashResult, FifoDetectionResult, GrepInput, GlobInput, EditInput, TodoWriteInput, TodoReadInput, TodoItem, TodoStatus, TodoContextCleanupOptions, TaskInput, TaskResult, AgentTypeConfig, TaskToolOptions, ContextMode, ThoroughnessLevel, SubAgentEventInfo, SuggestInput, SuggestToolOptions, } from './tools/index.js';
+export type { Tool, ToolHandler, ToolRegistry, ToolInputSchema, ToolExecutionResult, ToolRegistryOptions, ToolFallbackHandler, DefineToolOptions, ReadFileInput, WriteFileInput, BashInput, BashResult, FifoDetectionResult, GrepInput, GlobInput, EditInput, TodoWriteInput, TodoReadInput, TodoItem, TodoStatus, TodoContextCleanupOptions, TaskInput, TaskResult, AgentTypeConfig, TaskToolOptions, ContextMode, ThoroughnessLevel, SubAgentEventInfo, SuggestInput, SuggestToolOptions, RecallResultInput, RecallResultToolOptions, } from './tools/index.js';
 export { defineTool, createSuccessResult, createErrorResult, wrapToolExecute, DefaultToolRegistry, createToolRegistry, } from './tools/index.js';
-export { readFileTool, createReadFileTool, writeFileTool, createWriteFileTool, bashTool, createBashTool, execStream, detectFifoUsage, bashOutputTool, createBashOutputTool, killShellTool, createKillShellTool, ShellManager, getDefaultShellManager, setDefaultShellManager, grepTool, createGrepTool, globTool, createGlobTool, editTool, createEditTool, todoWriteTool, todoReadTool, createTodoTools, TodoStore, resetDefaultTodoStore, getDefaultTodoStore, createIsolatedTodoStore, cleanupTodoContextMessages, getTodoContextStats, webFetchTool, createWebFetchTool, createTaskTool, defaultAgentTypes, suggestTool, createSuggestTool, builtinTools, allBuiltinTools, TOOL_NAMES, TOOL_SETS, } from './tools/index.js';
+export { readFileTool, createReadFileTool, writeFileTool, createWriteFileTool, bashTool, createBashTool, execStream, detectFifoUsage, bashOutputTool, createBashOutputTool, killShellTool, createKillShellTool, ShellManager, getDefaultShellManager, setDefaultShellManager, grepTool, createGrepTool, globTool, createGlobTool, editTool, createEditTool, todoWriteTool, todoReadTool, createTodoTools, TodoStore, resetDefaultTodoStore, getDefaultTodoStore, createIsolatedTodoStore, cleanupTodoContextMessages, getTodoContextStats, webFetchTool, createWebFetchTool, createTaskTool, defaultAgentTypes, suggestTool, createSuggestTool, createRecallResultTool, builtinTools, allBuiltinTools, TOOL_NAMES, TOOL_SETS, } from './tools/index.js';
 export { userMessage, assistantMessage, systemMessage, textBlock, toolUseBlock, toolResultBlock, getTextContent, getToolUses, getToolResults, hasToolUses, validateToolUseResultPairing, repairToolPairing, ensureMessageContent, normalizeMessages, } from './messages/index.js';
 export type { ToolPairingValidation } from './messages/index.js';
-export { generateId, sleep, retry, truncate, withRetryGenerator, calculateBackoffDelay, DEFAULT_RETRY_CONFIG, } from './utils/index.js';
+export { generateId, sleep, retry, truncate, withRetryGenerator, calculateBackoffDelay, DEFAULT_RETRY_CONFIG, countTokens, countMessageTokens, } from './utils/index.js';
 export type { RetryConfig as LLMRetryConfig, WithRetryOptions } from './utils/index.js';
 export { AgentError, ProviderError, ToolError, ToolTimeoutError, ToolLoopError, ValidationError, MaxIterationsError, AbortError, ContextOverflowError, isAgentError, isProviderError, isToolError, isToolTimeoutError, isToolLoopError, isContextOverflowError, wrapError, } from './errors.js';
-export { ContextManager, DEFAULT_CONTEXT_CONFIG, FileAccessTracker, createFileTrackingHook, TRACKED_TOOLS, } from './context/index.js';
-export type { ContextManagerOptions, ContextCategory, BudgetAllocation, CategoryBudgetInfo, PreflightResult, VerbosityLevel, VerbosityConfig, ContextConfig, FilteringConfig, CompactionConfig, SummarizationConfig, CompactionResult, SummarizationResult, FilteringResult, ContextEvent, ContextEventHandler, ContextStats, FileAccessType, FileAccess, FileAccessTrackerOptions, FormatHintsOptions, FileAccessStats, } from './context/index.js';
+export { ContextManager, DEFAULT_CONTEXT_CONFIG, FileAccessTracker, createFileTrackingHook, TRACKED_TOOLS, DelegatedResultStore, ToolResultDelegator, DELEGATION_SYSTEM_PROMPT, DEFAULT_DELEGATION_CONFIG, } from './context/index.js';
+export type { ContextManagerOptions, ContextCategory, BudgetAllocation, CategoryBudgetInfo, PreflightResult, VerbosityLevel, VerbosityConfig, ContextConfig, FilteringConfig, CompactionConfig, SummarizationConfig, CompactionResult, SummarizationResult, FilteringResult, ContextEvent, ContextEventHandler, ContextStats, FileAccessType, FileAccess, FileAccessTrackerOptions, FormatHintsOptions, FileAccessStats, RestorationHintMessage, DelegatedResultStoreStats, ToolResultDelegatorOptions, DelegationConfig, StoredResult, DelegationEvent, } from './context/index.js';
 export { SkillRegistry, defineSkill, createSkillRegistry, builtinSkills, getDefaultSkillRegistry, resetDefaultSkillRegistry, } from './skills/index.js';
 export type { Skill, SkillInvocationResult, SkillInvokeOptions } from './skills/index.js';
 export { JsonSerializer, CompactJsonSerializer, defaultSerializer, MemoryCheckpointer, FileCheckpointer, StateError, StateErrorCode, CURRENT_STATE_VERSION, } from './state/index.js';

package/dist/index.js

@@ -29,7 +29,9 @@ export { readFileTool, createReadFileTool, writeFileTool, createWriteFileTool, b
 // Task tool (sub-agent spawning)
 createTaskTool, defaultAgentTypes, 
 // Suggest tool (next action suggestions)
-suggestTool, createSuggestTool, builtinTools, allBuiltinTools, 
+suggestTool, createSuggestTool, 
+// Recall result tool (delegation)
+createRecallResultTool, builtinTools, allBuiltinTools, 
 // Tool names - single source of truth
 TOOL_NAMES, TOOL_SETS, } from './tools/index.js';
 // Message utilities
@@ -37,11 +39,15 @@ export { userMessage, assistantMessage, systemMessage, textBlock, toolUseBlock,
 // Utilities
 export { generateId, sleep, 
 // eslint-disable-next-line @typescript-eslint/no-deprecated -- Kept for backward compatibility
-retry, truncate, withRetryGenerator, calculateBackoffDelay, DEFAULT_RETRY_CONFIG, } from './utils/index.js';
+retry, truncate, withRetryGenerator, calculateBackoffDelay, DEFAULT_RETRY_CONFIG, 
+// Token counting (tiktoken-based)
+countTokens, countMessageTokens, } from './utils/index.js';
 // Errors
 export { AgentError, ProviderError, ToolError, ToolTimeoutError, ToolLoopError, ValidationError, MaxIterationsError, AbortError, ContextOverflowError, isAgentError, isProviderError, isToolError, isToolTimeoutError, isToolLoopError, isContextOverflowError, wrapError, } from './errors.js';
 // Context management
-export { ContextManager, DEFAULT_CONTEXT_CONFIG, FileAccessTracker, createFileTrackingHook, TRACKED_TOOLS, } from './context/index.js';
+export { ContextManager, DEFAULT_CONTEXT_CONFIG, FileAccessTracker, createFileTrackingHook, TRACKED_TOOLS, 
+// Tool result delegation
+DelegatedResultStore, ToolResultDelegator, DELEGATION_SYSTEM_PROMPT, DEFAULT_DELEGATION_CONFIG, } from './context/index.js';
 // Skills system
 export { SkillRegistry, defineSkill, createSkillRegistry, builtinSkills, getDefaultSkillRegistry, resetDefaultSkillRegistry, } from './skills/index.js';
 // State management

package/dist/memory/loader.js

@@ -25,6 +25,7 @@
  */
 import * as fs from 'fs/promises';
 import * as path from 'path';
+import { countTokens } from '../utils/tokenizer.js';
 /**
  * Built-in patterns for various LLM providers
  */
@@ -268,7 +269,7 @@ export class ProjectMemoryLoader {
             files,
             content,
             rootDir: absoluteRoot,
-            estimatedTokens: Math.ceil(content.length / 4),
+            estimatedTokens: countTokens(content),
         };
         this.emit({ type: 'memory:search_complete', memory });
         return memory;

package/dist/memory/types.d.ts

@@ -41,7 +41,7 @@ export interface ProjectMemory {
     content: string;
     /** The root directory where search started */
     rootDir: string;
-    /** Total token estimate (rough: chars / 4) */
+    /** Total token estimate (tiktoken cl100k_base) */
     estimatedTokens: number;
 }
 /**

package/dist/providers/claude.d.ts

@@ -61,11 +61,7 @@ export declare class ClaudeProvider implements LLMProvider {
      */
     chat(messages: Message[], options?: ChatOptions): AsyncIterable<StreamChunk>;
     /**
-     * Count tokens in messages (not yet available in SDK v0.30)
-     *
-     * Note: Token counting API is available via Anthropic's beta endpoints
-     * but not yet exposed in the stable SDK. For now, this provides an
-     * approximation based on character count.
+     * Count tokens in messages using tiktoken (cl100k_base encoding)
      */
     countTokens(messages: Message[]): Promise<number>;
     /**

package/dist/providers/claude.js

@@ -11,6 +11,7 @@
  * ```
  */
 import Anthropic from '@anthropic-ai/sdk';
+import { countMessageTokens } from '../utils/tokenizer.js';
 import { ProviderError } from '../errors.js';
 /**
  * Default model for Claude API
@@ -73,7 +74,9 @@ export class ClaudeProvider {
             if (thinking) {
                 Object.assign(params, { thinking });
             }
-            const stream = this.client.messages.stream(params);
+            // Pass abort signal to SDK for immediate cancellation
+            const requestOptions = options?.signal ? { signal: options.signal } : undefined;
+            const stream = this.client.messages.stream(params, requestOptions);
             const model = options?.model ?? this.defaultModel;
             let currentToolId = '';
             let currentToolName = '';
@@ -122,36 +125,10 @@ export class ClaudeProvider {
         }
     }
     /**
-     * Count tokens in messages (not yet available in SDK v0.30)
-     *
-     * Note: Token counting API is available via Anthropic's beta endpoints
-     * but not yet exposed in the stable SDK. For now, this provides an
-     * approximation based on character count.
+     * Count tokens in messages using tiktoken (cl100k_base encoding)
      */
     countTokens(messages) {
-        // Approximation: ~4 characters per token (rough estimate)
-        let charCount = 0;
-        for (const msg of messages) {
-            if (typeof msg.content === 'string') {
-                charCount += msg.content.length;
-            }
-            else {
-                for (const block of msg.content) {
-                    switch (block.type) {
-                        case 'text':
-                            charCount += block.text.length;
-                            break;
-                        case 'tool_use':
-                            charCount += JSON.stringify(block.input).length;
-                            break;
-                        case 'tool_result':
-                            charCount += block.content.length;
-                            break;
-                    }
-                }
-            }
-        }
-        return Promise.resolve(Math.ceil(charCount / 4));
+        return Promise.resolve(countMessageTokens(messages));
     }
     /**
      * Convert our Message format to Anthropic's format

package/dist/providers/gemini-native.d.ts

@@ -52,7 +52,7 @@ export declare class GeminiNativeProvider implements LLMProvider {
      */
     chat(messages: Message[], options?: ChatOptions): AsyncIterable<StreamChunk>;
     /**
-     * Count tokens in messages (approximation)
+     * Count tokens in messages using tiktoken (cl100k_base encoding)
      */
     countTokens(messages: Message[]): Promise<number>;
     /**

package/dist/providers/gemini-native.js

@@ -15,6 +15,7 @@
  */
 import { GoogleGenAI } from '@google/genai';
 import { ProviderError } from '../errors.js';
+import { countMessageTokens } from '../utils/tokenizer.js';
 /**
  * Default model for Gemini API
  */
@@ -66,6 +67,10 @@ export class GeminiNativeProvider {
             if (tools.length > 0) {
                 config.tools = [{ functionDeclarations: tools }];
             }
+            // Check abort before starting the request
+            if (options?.signal?.aborted) {
+                throw new Error('Aborted');
+            }
             // Request streaming response
             const streamResponse = await this.client.models.generateContentStream({
                 model,
@@ -81,6 +86,9 @@ export class GeminiNativeProvider {
             let lastUsageMetadata;
             // Process stream chunks
             for await (const chunk of streamResponse) {
+                // Check abort between chunks
+                if (options?.signal?.aborted)
+                    break;
                 const streamChunks = this.processChunk(chunk, currentToolId, currentToolName, toolInputJson, inThinkingBlock);
                 for (const streamChunk of streamChunks) {
                     // Update tracking state
@@ -137,32 +145,10 @@ export class GeminiNativeProvider {
         }
     }
     /**
-     * Count tokens in messages (approximation)
+     * Count tokens in messages using tiktoken (cl100k_base encoding)
      */
     countTokens(messages) {
-        // Approximation: ~4 characters per token
-        let charCount = 0;
-        for (const msg of messages) {
-            if (typeof msg.content === 'string') {
-                charCount += msg.content.length;
-            }
-            else {
-                for (const block of msg.content) {
-                    switch (block.type) {
-                        case 'text':
-                            charCount += block.text.length;
-                            break;
-                        case 'tool_use':
-                            charCount += JSON.stringify(block.input).length;
-                            break;
-                        case 'tool_result':
-                            charCount += block.content.length;
-                            break;
-                    }
-                }
-            }
-        }
-        return Promise.resolve(Math.ceil(charCount / 4));
+        return Promise.resolve(countMessageTokens(messages));
     }
     /**
      * Convert our Message format to Google's format

package/dist/providers/mock.d.ts

@@ -122,7 +122,7 @@ export declare class MockProvider implements LLMProvider {
      */
     chat(messages: Message[], options?: ChatOptions): AsyncIterable<StreamChunk>;
     /**
-     * Count tokens (mock implementation)
+     * Count tokens using tiktoken (cl100k_base encoding)
      */
     countTokens(messages: Message[]): Promise<number>;
     private sleep;

package/dist/providers/mock.js

@@ -25,6 +25,7 @@
  * ```
  */
 import { ProviderError } from '../errors.js';
+import { countMessageTokens } from '../utils/tokenizer.js';
 /**
  * MockProvider for testing agents without API calls.
  *
@@ -171,32 +172,10 @@ export class MockProvider {
         yield { type: 'done' };
     }
     /**
-     * Count tokens (mock implementation)
+     * Count tokens using tiktoken (cl100k_base encoding)
      */
     countTokens(messages) {
-        // Simple approximation: ~4 chars per token
-        let charCount = 0;
-        for (const msg of messages) {
-            if (typeof msg.content === 'string') {
-                charCount += msg.content.length;
-            }
-            else {
-                for (const block of msg.content) {
-                    if (block.type === 'text') {
-                        charCount += block.text.length;
-                    }
-                    else if (block.type === 'tool_result') {
-                        // Count tool result content (always a string per our type definition)
-                        charCount += block.content.length;
-                    }
-                    else if (block.type === 'tool_use') {
-                        // Count tool use input
-                        charCount += JSON.stringify(block.input).length;
-                    }
-                }
-            }
-        }
-        return Promise.resolve(Math.ceil(charCount / 4));
+        return Promise.resolve(countMessageTokens(messages));
     }
     sleep(ms) {
         return new Promise((resolve) => setTimeout(resolve, ms));

package/dist/providers/openai-compatible.d.ts

@@ -186,11 +186,7 @@ export declare abstract class OpenAICompatibleProvider implements LLMProvider {
         arguments: string;
     }>): StreamChunk[];
     /**
-     * Estimate token count (rough approximation)
-     *
-     * @remarks
-     * Most providers don't have a native token counting endpoint.
-     * This uses a rough approximation of ~4 characters per token.
+     * Count tokens in messages using tiktoken (cl100k_base encoding)
      */
     countTokens(messages: Message[]): Promise<number>;
 }

package/dist/providers/openai-compatible.js

@@ -22,6 +22,7 @@
  * ```
  */
 import { ProviderError } from '../errors.js';
+import { countMessageTokens } from '../utils/tokenizer.js';
 // Default configuration
 const DEFAULT_MAX_TOKENS = 4096;
 const DEFAULT_TIMEOUT = 120000;
@@ -98,6 +99,17 @@ export class OpenAICompatibleProvider {
         let usage;
         try {
             const controller = new AbortController();
+            // Chain user abort signal to our controller
+            if (options?.signal) {
+                if (options.signal.aborted) {
+                    controller.abort();
+                }
+                else {
+                    options.signal.addEventListener('abort', () => {
+                        controller.abort();
+                    }, { once: true });
+                }
+            }
             const timeoutId = setTimeout(() => {
                 controller.abort();
             }, this.timeout);
@@ -349,35 +361,9 @@ export class OpenAICompatibleProvider {
         return results;
     }
     /**
-     * Estimate token count (rough approximation)
-     *
-     * @remarks
-     * Most providers don't have a native token counting endpoint.
-     * This uses a rough approximation of ~4 characters per token.
+     * Count tokens in messages using tiktoken (cl100k_base encoding)
      */
     countTokens(messages) {
-        let charCount = 0;
-        for (const msg of messages) {
-            if (typeof msg.content === 'string') {
-                charCount += msg.content.length;
-            }
-            else if (Array.isArray(msg.content)) {
-                for (const block of msg.content) {
-                    if (block.type === 'text') {
-                        charCount += block.text.length;
-                    }
-                    else if (block.type === 'tool_use') {
-                        charCount += JSON.stringify(block.input).length;
-                    }
-                    else if (block.type === 'tool_result') {
-                        charCount +=
-                            typeof block.content === 'string'
-                                ? block.content.length
-                                : JSON.stringify(block.content).length;
-                    }
-                }
-            }
-        }
-        return Promise.resolve(Math.ceil(charCount / 4));
+        return Promise.resolve(countMessageTokens(messages));
     }
 }

package/dist/providers/types.d.ts

@@ -147,6 +147,11 @@ export interface ChatOptions {
      * ```
      */
     thinking?: ThinkingConfig;
+    /**
+     * AbortSignal for cancelling the LLM request.
+     * When aborted, the provider should stop streaming and throw/return immediately.
+     */
+    signal?: AbortSignal;
     /**
      * Enable prompt caching for system prompt and tools (Claude-specific)
      *

package/dist/rate-limit/provider-wrapper.d.ts

@@ -45,7 +45,7 @@ export declare class RateLimitedProvider implements LLMProvider {
      */
     countTokens(messages: Message[]): Promise<number>;
     /**
-     * Estimate tokens from messages (rough approximation)
+     * Estimate tokens from messages using tiktoken
      */
     private estimateTokens;
 }

package/dist/rate-limit/provider-wrapper.js

@@ -5,6 +5,7 @@
  */
 import { createRateLimiter } from './limiter.js';
 import { withRetry } from './retry.js';
+import { countMessageTokens } from '../utils/tokenizer.js';
 /**
  * Wrapper that adds rate limiting and retry to any LLMProvider
  *
@@ -105,35 +106,10 @@ export class RateLimitedProvider {
         return withRetry(() => countTokensFn(messages), this.retryConfig);
     }
     /**
-     * Estimate tokens from messages (rough approximation)
+     * Estimate tokens from messages using tiktoken
      */
     estimateTokens(messages) {
-        let charCount = 0;
-        for (const msg of messages) {
-            if (typeof msg.content === 'string') {
-                charCount += msg.content.length;
-            }
-            else {
-                for (const block of msg.content) {
-                    switch (block.type) {
-                        case 'text':
-                            charCount += block.text.length;
-                            break;
-                        case 'tool_use':
-                            charCount += JSON.stringify(block.input).length;
-                            break;
-                        case 'tool_result':
-                            charCount += block.content.length;
-                            break;
-                        case 'thinking':
-                            charCount += block.thinking.length;
-                            break;
-                    }
-                }
-            }
-        }
-        // Rough estimate: 4 characters per token
-        return Math.ceil(charCount / 4);
+        return countMessageTokens(messages);
     }
 }
 /**

package/dist/tools/builtin/index.d.ts

@@ -33,6 +33,8 @@ export { askUserTool, createAskUserTool } from './ask-user.js';
 export type { AskUserInput, AskUserResult, AskUserQuestion, AskUserOption, AskUserToolOptions, } from './ask-user.js';
 export { askUserSimpleTool, createAskUserSimpleTool } from './ask-user-simple.js';
 export type { AskUserSimpleInput, AskUserSimpleResult, AskUserSimpleToolOptions, } from './ask-user-simple.js';
+export { createRecallResultTool } from './recall-result.js';
+export type { RecallResultInput, RecallResultToolOptions } from './recall-result.js';
 export { backlogReadTool, backlogWriteTool, createBacklogTools } from './backlog.js';
 export type { BacklogItem, BacklogStatus, BacklogItemType, BacklogPriority, BacklogReadInput, BacklogReadResult, BacklogWriteInput, BacklogWriteResult, BacklogToolOptions, } from './backlog.js';
 export declare const builtinTools: {

package/dist/tools/builtin/index.js

@@ -32,6 +32,8 @@ export { suggestTool, createSuggestTool } from './suggest.js';
 // Ask user tools (user interaction)
 export { askUserTool, createAskUserTool } from './ask-user.js';
 export { askUserSimpleTool, createAskUserSimpleTool } from './ask-user-simple.js';
+// Recall result tool (tool result delegation)
+export { createRecallResultTool } from './recall-result.js';
 // Backlog tools (file-based project backlog)
 export { backlogReadTool, backlogWriteTool, createBacklogTools } from './backlog.js';
 /**

package/dist/tools/builtin/recall-result.d.ts

@@ -0,0 +1,29 @@
+/**
+ * recall_full_result tool
+ *
+ * Retrieves the full output of a previously delegated tool result.
+ * Use when a summary is insufficient and you need the complete data.
+ */
+import type { Tool } from '../types.js';
+import type { DelegatedResultStore } from '../../context/delegated-result-store.js';
+import type { DelegationEvent } from '../../context/delegation-types.js';
+/**
+ * Input for the recall_full_result tool.
+ */
+export interface RecallResultInput {
+    /** Delegation ID from a previously delegated result (e.g., "dr_1707900000_0") */
+    id: string;
+}
+/**
+ * Options for creating the recall_full_result tool.
+ */
+export interface RecallResultToolOptions {
+    /** The delegation store to retrieve results from */
+    store: DelegatedResultStore;
+    /** Optional event callback for recall events */
+    onEvent?: (event: DelegationEvent) => void;
+}
+/**
+ * Create a recall_full_result tool that retrieves delegated results from the store.
+ */
+export declare function createRecallResultTool(options: RecallResultToolOptions): Tool<RecallResultInput>;

package/dist/tools/builtin/recall-result.js

@@ -0,0 +1,48 @@
+/**
+ * recall_full_result tool
+ *
+ * Retrieves the full output of a previously delegated tool result.
+ * Use when a summary is insufficient and you need the complete data.
+ */
+import { defineTool, createSuccessResult, createErrorResult } from '../define.js';
+/**
+ * Create a recall_full_result tool that retrieves delegated results from the store.
+ */
+export function createRecallResultTool(options) {
+    const { store, onEvent } = options;
+    return defineTool({
+        name: 'recall_full_result',
+        description: 'Retrieve the full output of a previously delegated tool result. ' +
+            'Use when a summary is insufficient and you need the complete data. ' +
+            'Results expire after 10 minutes.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: {
+                    type: 'string',
+                    description: 'Delegation ID (e.g., "dr_1707900000_0")',
+                },
+            },
+            required: ['id'],
+        },
+        execute: (input) => {
+            const stored = store.get(input.id);
+            onEvent?.({
+                type: 'delegation:recall',
+                delegationId: input.id,
+                found: stored !== undefined,
+            });
+            if (!stored) {
+                return Promise.resolve(createErrorResult('Delegation ID not found or expired. Re-run the original tool to get the result.'));
+            }
+            return Promise.resolve(createSuccessResult({
+                delegationId: stored.id,
+                toolName: stored.toolName,
+                fullContent: stored.fullContent,
+                fullTokens: stored.fullTokens,
+            }));
+        },
+        parallel: true,
+        silent: true,
+    });
+}

package/dist/tools/builtin/task.js

@@ -183,6 +183,7 @@ export function createTaskTool(options) {
                     };
                 }
                 const resultPromise = parentAgent.runSubAgent(subAgentName, prompt, {
+                    signal: context?.abortSignal,
                     onEvent: eventHandler,
                 });
                 const result = await Promise.race([resultPromise, timeoutPromise]);

package/dist/tools/index.d.ts

@@ -6,5 +6,5 @@ export { defineTool, createSuccessResult, createErrorResult, wrapToolExecute } f
 export type { DefineToolOptions } from './define.js';
 export { DefaultToolRegistry, createToolRegistry } from './registry.js';
 export type { ToolRegistryOptions } from './registry.js';
-export { readFileTool, createReadFileTool, writeFileTool, createWriteFileTool, bashTool, createBashTool, execStream, detectFifoUsage, bashOutputTool, createBashOutputTool, killShellTool, createKillShellTool, ShellManager, getDefaultShellManager, setDefaultShellManager, grepTool, createGrepTool, globTool, createGlobTool, editTool, createEditTool, todoWriteTool, todoReadTool, createTodoTools, TodoStore, resetDefaultTodoStore, getDefaultTodoStore, createIsolatedTodoStore, cleanupTodoContextMessages, getTodoContextStats, webFetchTool, createWebFetchTool, createTaskTool, defaultAgentTypes, suggestTool, createSuggestTool, builtinTools, allBuiltinTools, TOOL_NAMES, TOOL_SETS, } from './builtin/index.js';
-export type { ReadFileInput, WriteFileInput, BashInput, BashResult, FifoDetectionResult, BashOutputInput, BashOutputResult, KillShellInput, KillShellResult, ShellStatus, BackgroundShell, ShellOutput, ShellManagerOptions, GrepInput, GlobInput, EditInput, TodoWriteInput, TodoReadInput, TodoItem, TodoStatus, TodoContextCleanupOptions, WebFetchInput, WebFetchResult, WebFetchOptions, TaskInput, TaskResult, AgentTypeConfig, TaskToolOptions, ContextMode, ThoroughnessLevel, SubAgentEventInfo, SuggestInput, SuggestToolOptions, } from './builtin/index.js';
+export { readFileTool, createReadFileTool, writeFileTool, createWriteFileTool, bashTool, createBashTool, execStream, detectFifoUsage, bashOutputTool, createBashOutputTool, killShellTool, createKillShellTool, ShellManager, getDefaultShellManager, setDefaultShellManager, grepTool, createGrepTool, globTool, createGlobTool, editTool, createEditTool, todoWriteTool, todoReadTool, createTodoTools, TodoStore, resetDefaultTodoStore, getDefaultTodoStore, createIsolatedTodoStore, cleanupTodoContextMessages, getTodoContextStats, webFetchTool, createWebFetchTool, createTaskTool, defaultAgentTypes, suggestTool, createSuggestTool, createRecallResultTool, builtinTools, allBuiltinTools, TOOL_NAMES, TOOL_SETS, } from './builtin/index.js';
+export type { ReadFileInput, WriteFileInput, BashInput, BashResult, FifoDetectionResult, BashOutputInput, BashOutputResult, KillShellInput, KillShellResult, ShellStatus, BackgroundShell, ShellOutput, ShellManagerOptions, GrepInput, GlobInput, EditInput, TodoWriteInput, TodoReadInput, TodoItem, TodoStatus, TodoContextCleanupOptions, WebFetchInput, WebFetchResult, WebFetchOptions, TaskInput, TaskResult, AgentTypeConfig, TaskToolOptions, ContextMode, ThoroughnessLevel, SubAgentEventInfo, SuggestInput, SuggestToolOptions, RecallResultInput, RecallResultToolOptions, } from './builtin/index.js';

package/dist/tools/index.js

@@ -35,6 +35,8 @@ webFetchTool, createWebFetchTool,
 createTaskTool, defaultAgentTypes, 
 // Suggest (next action suggestions)
 suggestTool, createSuggestTool, 
+// Recall result (delegation)
+createRecallResultTool, 
 // Collections
 builtinTools, allBuiltinTools, 
 // Tool names - single source of truth

package/dist/utils/index.d.ts

@@ -1,6 +1,7 @@
 /**
  * Utility functions for @compilr-dev/agents
  */
+export { countTokens, countMessageTokens } from './tokenizer.js';
 /**
  * Generate a unique ID for tool uses
  */

package/dist/utils/index.js

@@ -1,6 +1,8 @@
 /**
  * Utility functions for @compilr-dev/agents
  */
+// Token counting
+export { countTokens, countMessageTokens } from './tokenizer.js';
 /**
  * Generate a unique ID for tool uses
  */

package/dist/utils/tokenizer.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Token counting utility using tiktoken (cl100k_base encoding)
+ *
+ * Replaces the rough `Math.ceil(charCount / 4)` heuristic with actual
+ * BPE tokenization for accurate context window management.
+ */
+import type { Message } from '../providers/types.js';
+/**
+ * Count tokens in a text string using tiktoken.
+ * Falls back to chars/4 heuristic for very large or pathologically repetitive strings.
+ */
+export declare function countTokens(text: string): number;
+/**
+ * Count tokens across an array of messages
+ *
+ * Extracts all text content from messages (text blocks, tool inputs/results,
+ * thinking blocks) and counts tokens using tiktoken.
+ */
+export declare function countMessageTokens(messages: Message[]): number;