@dotsetlabs/dotclaw 1.2.0 → 1.4.0

package/README.md

@@ -45,6 +45,8 @@ After installation, use the `dotclaw` CLI:
 ```bash
 dotclaw setup        # Full setup (init + configure + build + install service)
 dotclaw configure    # Re-configure API keys and model
+dotclaw add-instance # Create and start an isolated instance
+dotclaw instances    # List discovered instances
 dotclaw build        # Build the Docker container image
 dotclaw start        # Start the service
 dotclaw stop         # Stop the service
@@ -55,6 +57,13 @@ dotclaw doctor       # Run diagnostics
 dotclaw register     # Register a new Telegram chat
 ```
 
+Instance flags:
+
+```bash
+dotclaw status --id dev   # Run against a specific instance (~/.dotclaw-dev)
+dotclaw restart --all     # Restart all instances
+```
+
 ## Configuration
 
 All configuration and data is stored in `~/.dotclaw/`:

package/config-examples/runtime.json

@@ -2,7 +2,8 @@
   "host": {
     "logLevel": "info",
     "container": {
-      "mode": "daemon"
+      "mode": "daemon",
+      "instanceId": ""
     },
     "metrics": {
       "port": 3001,
@@ -19,7 +20,109 @@
     "backgroundJobs": {
       "enabled": true,
       "maxConcurrent": 2,
-      "maxRuntimeMs": 2400000
+      "maxRuntimeMs": 2400000,
+      "progress": {
+        "enabled": true,
+        "startDelayMs": 30000,
+        "intervalMs": 120000,
+        "maxUpdates": 3
+      },
+      "autoSpawn": {
+        "enabled": true,
+        "foregroundTimeoutMs": 90000,
+        "onTimeout": true,
+        "onToolLimit": true,
+        "classifier": {
+          "enabled": true,
+          "model": "openai/gpt-5-nano",
+          "timeoutMs": 3000,
+          "maxOutputTokens": 32,
+          "temperature": 0,
+          "confidenceThreshold": 0.6,
+          "adaptive": {
+            "enabled": true,
+            "minThreshold": 0.55,
+            "maxThreshold": 0.65,
+            "queueDepthLow": 0,
+            "queueDepthHigh": 4
+          }
+        }
+      }
+    },
+    "routing": {
+      "enabled": true,
+      "maxFastChars": 200,
+      "maxStandardChars": 1200,
+      "backgroundMinChars": 2000,
+      "fastKeywords": ["hi", "hello", "hey", "who are you", "what can you do"],
+      "deepKeywords": ["research", "analysis", "report", "dashboard", "refactor", "architecture", "design"],
+      "backgroundKeywords": ["background", "long-running", "research", "dashboard", "refactor", "report"],
+      "classifierFallback": {
+        "enabled": true,
+        "minChars": 600
+      },
+      "plannerProbe": {
+        "enabled": true,
+        "model": "openai/gpt-5-nano",
+        "timeoutMs": 3000,
+        "maxOutputTokens": 120,
+        "temperature": 0,
+        "minChars": 700,
+        "minSteps": 4,
+        "minTools": 3
+      },
+      "profiles": {
+        "fast": {
+          "model": "openai/gpt-5-nano",
+          "maxOutputTokens": 256,
+          "maxToolSteps": 6,
+          "recallMaxResults": 0,
+          "recallMaxTokens": 0,
+          "enablePlanner": false,
+          "enableValidation": false,
+          "responseValidationMaxRetries": 0,
+          "enableMemoryRecall": false,
+          "enableMemoryExtraction": false,
+          "progress": { "enabled": false }
+        },
+        "standard": {
+          "model": "openai/gpt-5-mini",
+          "maxOutputTokens": 768,
+          "maxToolSteps": 16,
+          "recallMaxResults": 6,
+          "recallMaxTokens": 1500,
+          "enablePlanner": true,
+          "enableValidation": true,
+          "responseValidationMaxRetries": 1,
+          "enableMemoryRecall": true,
+          "enableMemoryExtraction": true
+        },
+        "deep": {
+          "model": "moonshotai/kimi-k2.5",
+          "maxOutputTokens": 1536,
+          "maxToolSteps": 32,
+          "recallMaxResults": 12,
+          "recallMaxTokens": 2500,
+          "enablePlanner": true,
+          "enableValidation": true,
+          "responseValidationMaxRetries": 2,
+          "enableMemoryRecall": true,
+          "enableMemoryExtraction": true
+        },
+        "background": {
+          "model": "moonshotai/kimi-k2.5",
+          "maxOutputTokens": 2048,
+          "maxToolSteps": 64,
+          "recallMaxResults": 16,
+          "recallMaxTokens": 4000,
+          "enablePlanner": true,
+          "enableValidation": true,
+          "responseValidationMaxRetries": 2,
+          "enableMemoryRecall": true,
+          "enableMemoryExtraction": true,
+          "progress": { "enabled": true, "initialMs": 15000, "intervalMs": 60000, "maxUpdates": 3 }
+        }
+      }
     }
   },
   "agent": {
@@ -30,6 +133,20 @@
     "planner": {
       "enabled": true,
       "mode": "auto"
+    },
+    "responseValidation": {
+      "enabled": true,
+      "minPromptTokens": 400,
+      "minResponseTokens": 160
+    },
+    "tools": {
+      "progress": {
+        "enabled": true,
+        "minIntervalMs": 30000,
+        "notifyTools": ["WebSearch", "WebFetch", "Bash", "GitClone", "NpmInstall"],
+        "notifyOnStart": true,
+        "notifyOnError": true
+      }
     }
   }
 }

package/container/agent-runner/src/agent-config.ts

@@ -60,6 +60,8 @@ export type AgentRuntimeConfig = {
       temperature: number;
       maxRetries: number;
       allowToolCalls: boolean;
+      minPromptTokens: number;
+      minResponseTokens: number;
     };
     tools: {
       maxToolSteps: number;
@@ -87,6 +89,13 @@ export type AgentRuntimeConfig = {
         maxBytes: number;
         httpTimeoutMs: number;
       };
+      progress: {
+        enabled: boolean;
+        minIntervalMs: number;
+        notifyTools: string[];
+        notifyOnStart: boolean;
+        notifyOnError: boolean;
+      };
       toolSummary: {
         enabled: boolean;
         maxBytes: number;
@@ -160,7 +169,7 @@ const DEFAULT_AGENT_CONFIG: AgentRuntimeConfig['agent'] = {
   planner: {
     enabled: true,
     mode: 'auto',
-    minTokens: 600,
+    minTokens: 800,
     triggerRegex: '(plan|steps|roadmap|research|design|architecture|spec|strategy)',
     maxOutputTokens: 200,
     temperature: 0.2
@@ -170,7 +179,9 @@ const DEFAULT_AGENT_CONFIG: AgentRuntimeConfig['agent'] = {
     maxOutputTokens: 120,
     temperature: 0,
     maxRetries: 1,
-    allowToolCalls: false
+    allowToolCalls: false,
+    minPromptTokens: 400,
+    minResponseTokens: 160
   },
   tools: {
     maxToolSteps: 24,
@@ -198,6 +209,13 @@ const DEFAULT_AGENT_CONFIG: AgentRuntimeConfig['agent'] = {
       maxBytes: 800_000,
       httpTimeoutMs: 20_000
     },
+    progress: {
+      enabled: true,
+      minIntervalMs: 30_000,
+      notifyTools: ['WebSearch', 'WebFetch', 'Bash', 'GitClone', 'NpmInstall'],
+      notifyOnStart: true,
+      notifyOnError: true
+    },
     toolSummary: {
       enabled: true,
       maxBytes: 60_000,

package/container/agent-runner/src/container-protocol.ts

@@ -40,6 +40,11 @@ export interface ContainerInput {
   modelContextTokens?: number;
   modelMaxOutputTokens?: number;
   modelTemperature?: number;
+  timezone?: string;
+  disablePlanner?: boolean;
+  disableResponseValidation?: boolean;
+  responseValidationMaxRetries?: number;
+  disableMemoryExtraction?: boolean;
   streaming?: {
     enabled?: boolean;
     draftId?: number;
@@ -63,6 +68,12 @@ export interface ContainerOutput {
   session_recall_count?: number;
   memory_items_upserted?: number;
   memory_items_extracted?: number;
+  timings?: {
+    planner_ms?: number;
+    response_validation_ms?: number;
+    memory_extraction_ms?: number;
+    tool_ms?: number;
+  };
   tool_calls?: Array<{
     name: string;
     args?: unknown;

package/container/agent-runner/src/index.ts

@@ -318,6 +318,7 @@ function buildSystemInstructions(params: {
   taskId?: string;
   isBackgroundJob: boolean;
   jobId?: string;
+  timezone?: string;
   planBlock?: string;
   taskExtractionPack?: PromptPack | null;
   responseQualityPack?: PromptPack | null;
@@ -342,7 +343,7 @@ function buildSystemInstructions(params: {
     '- `mcp__dotclaw__spawn_job`: start a background job.',
     '- `mcp__dotclaw__job_status`, `mcp__dotclaw__list_jobs`, `mcp__dotclaw__cancel_job`.',
     '- `mcp__dotclaw__job_update`: log job progress or notify the user.',
-    'Tip: For long-running work (multi-step coding, large research), prefer `mcp__dotclaw__spawn_job` and report back when done.',
+    'Rule: If the task is likely to take more than ~2 minutes or needs multi-step research/coding, you MUST call `mcp__dotclaw__spawn_job` immediately and tell the user you queued it. Do not run long tasks in the foreground.',
     '- `mcp__dotclaw__register_group`: main group only.',
     '- `mcp__dotclaw__remove_group`, `mcp__dotclaw__list_groups`: main group only.',
     '- `mcp__dotclaw__set_model`: main group only.',
@@ -425,6 +426,10 @@ function buildSystemInstructions(params: {
     ? `Behavior overrides:\n${JSON.stringify(params.behaviorConfig, null, 2)}`
     : '';
 
+  const timezoneNote = params.timezone
+    ? `Timezone: ${params.timezone}. Use this timezone when interpreting or presenting timestamps unless the user specifies another.`
+    : '';
+
   const scheduledNote = params.isScheduledTask
     ? `You are running as a scheduled task${params.taskId ? ` (task id: ${params.taskId})` : ''}. If you need to communicate, use \`mcp__dotclaw__send_message\`.`
     : '';
@@ -432,7 +437,7 @@ function buildSystemInstructions(params: {
     ? 'You are running in the background for a user request. Focus on completing the task and return a complete response without asking follow-up questions unless strictly necessary.'
     : '';
   const jobNote = params.isBackgroundJob
-    ? `You are running as a background job${params.jobId ? ` (job id: ${params.jobId})` : ''}. Return a complete result. Use \`mcp__dotclaw__job_update\` for progress if needed. Prefer writing large outputs to the job artifacts directory.`
+    ? `You are running as a background job${params.jobId ? ` (job id: ${params.jobId})` : ''}. Return a complete result. If the task will take more than a few minutes, send periodic \`mcp__dotclaw__job_update\` messages with milestones or intermediate findings (roughly every ~5 minutes or after major steps). Prefer writing large outputs to the job artifacts directory.`
     : '';
   const jobArtifactsNote = params.isBackgroundJob && params.jobId
     ? `Job artifacts directory: /workspace/group/jobs/${params.jobId}`
@@ -496,6 +501,7 @@ function buildSystemInstructions(params: {
     browserAutomation,
     groupNotes,
     globalNotes,
+    timezoneNote,
     params.planBlock || '',
     toolCallingBlock,
     toolOutcomeBlock,
@@ -835,26 +841,30 @@ export async function runAgentOnce(input: ContainerInput): Promise<ContainerOutp
   const maxToolSteps = Number.isFinite(input.maxToolSteps)
     ? Math.max(1, Math.floor(input.maxToolSteps as number))
     : agent.tools.maxToolSteps;
-  const memoryExtractionEnabled = agent.memory.extraction.enabled;
+  const memoryExtractionEnabled = agent.memory.extraction.enabled && !input.disableMemoryExtraction;
   const isDaemon = process.env.DOTCLAW_DAEMON === '1';
   const memoryExtractionAsync = agent.memory.extraction.async;
   const memoryExtractionMaxMessages = agent.memory.extraction.maxMessages;
   const memoryExtractionMaxOutputTokens = agent.memory.extraction.maxOutputTokens;
   const memoryExtractScheduled = agent.memory.extractScheduled;
   const memoryArchiveSync = agent.memory.archiveSync;
-  const plannerEnabled = agent.planner.enabled;
+  const plannerEnabled = agent.planner.enabled && !input.disablePlanner;
   const plannerMode = String(agent.planner.mode || 'auto').toLowerCase();
   const plannerMinTokens = agent.planner.minTokens;
   const plannerTrigger = buildPlannerTrigger(agent.planner.triggerRegex);
   const plannerModel = agent.models.planner;
   const plannerMaxOutputTokens = agent.planner.maxOutputTokens;
   const plannerTemperature = agent.planner.temperature;
-  const responseValidateEnabled = agent.responseValidation.enabled;
+  const responseValidateEnabled = agent.responseValidation.enabled && !input.disableResponseValidation;
   const responseValidateModel = agent.models.responseValidation;
   const responseValidateMaxOutputTokens = agent.responseValidation.maxOutputTokens;
   const responseValidateTemperature = agent.responseValidation.temperature;
-  const responseValidateMaxRetries = agent.responseValidation.maxRetries;
+  const responseValidateMaxRetries = Number.isFinite(input.responseValidationMaxRetries)
+    ? Math.max(0, Math.floor(input.responseValidationMaxRetries as number))
+    : agent.responseValidation.maxRetries;
   const responseValidateAllowToolCalls = agent.responseValidation.allowToolCalls;
+  const responseValidateMinPromptTokens = agent.responseValidation.minPromptTokens || 0;
+  const responseValidateMinResponseTokens = agent.responseValidation.minResponseTokens || 0;
   const maxContextMessageTokens = agent.context.maxContextMessageTokens;
   const streamingEnabled = Boolean(input.streaming?.enabled && typeof input.streaming?.draftId === 'number');
   const streamingDraftId = streamingEnabled ? input.streaming?.draftId : undefined;
@@ -884,6 +894,7 @@ export async function runAgentOnce(input: ContainerInput): Promise<ContainerOutp
   const toolCalls: ToolCallRecord[] = [];
   let memoryItemsUpserted = 0;
   let memoryItemsExtracted = 0;
+  const timings: { planner_ms?: number; response_validation_ms?: number; memory_extraction_ms?: number; tool_ms?: number } = {};
   const ipc = createIpcHandlers({
     chatJid: input.chatJid,
     groupFolder: input.groupFolder,
@@ -897,7 +908,11 @@ export async function runAgentOnce(input: ContainerInput): Promise<ContainerOutp
     onToolCall: (call) => {
       toolCalls.push(call);
     },
-    policy: input.toolPolicy
+    policy: input.toolPolicy,
+    jobProgress: {
+      jobId: input.jobId,
+      enabled: Boolean(input.isBackgroundJob)
+    }
   });
 
   let streamLastSentAt = 0;
@@ -1083,6 +1098,7 @@ export async function runAgentOnce(input: ContainerInput): Promise<ContainerOutp
     taskId: input.taskId,
     isBackgroundJob: !!input.isBackgroundJob,
     jobId: input.jobId,
+    timezone: typeof input.timezone === 'string' ? input.timezone : undefined,
     planBlock: planBlockValue,
     taskExtractionPack: taskPackResult?.pack || null,
     responseQualityPack: responseQualityResult?.pack || null,
@@ -1109,6 +1125,7 @@ export async function runAgentOnce(input: ContainerInput): Promise<ContainerOutp
     trigger: plannerTrigger
   })) {
     try {
+      const plannerStartedAt = Date.now();
       const plannerPrompt = buildPlannerPrompt(plannerContextMessages);
       const plannerResult = await openrouter.callModel({
         model: plannerModel,
@@ -1122,6 +1139,7 @@ export async function runAgentOnce(input: ContainerInput): Promise<ContainerOutp
       if (plan) {
         planBlock = formatPlanBlock(plan);
       }
+      timings.planner_ms = Date.now() - plannerStartedAt;
     } catch (err) {
       log(`Planner failed: ${err instanceof Error ? err.message : String(err)}`);
     }
@@ -1245,6 +1263,8 @@ export async function runAgentOnce(input: ContainerInput): Promise<ContainerOutp
     modelToolCalls = firstAttempt.modelToolCalls;
 
     const shouldValidate = responseValidateEnabled
+      && promptTokens >= responseValidateMinPromptTokens
+      && completionTokens >= responseValidateMinResponseTokens
       && (responseValidateAllowToolCalls || modelToolCalls.length === 0);
     if (shouldValidate) {
       let retriesLeft = responseValidateMaxRetries;
@@ -1257,6 +1277,7 @@ export async function runAgentOnce(input: ContainerInput): Promise<ContainerOutp
           validationResult = { verdict: 'fail', issues: ['Response was empty.'], missing: [] };
         } else {
           try {
+            const validationStartedAt = Date.now();
             validationResult = await validateResponseQuality({
               openrouter,
               model: responseValidateModel,
@@ -1265,6 +1286,7 @@ export async function runAgentOnce(input: ContainerInput): Promise<ContainerOutp
               maxOutputTokens: responseValidateMaxOutputTokens,
               temperature: responseValidateTemperature
             });
+            timings.response_validation_ms = (timings.response_validation_ms ?? 0) + (Date.now() - validationStartedAt);
           } catch (err) {
             log(`Response validation failed: ${err instanceof Error ? err.message : String(err)}`);
           }
@@ -1306,6 +1328,7 @@ export async function runAgentOnce(input: ContainerInput): Promise<ContainerOutp
       session_recall_count: sessionRecallCount,
       memory_items_upserted: memoryItemsUpserted,
       memory_items_extracted: memoryItemsExtracted,
+      timings: Object.keys(timings).length > 0 ? timings : undefined,
       tool_calls: toolCalls.length > 0 ? toolCalls : undefined,
       latency_ms: latencyMs
     };
@@ -1335,6 +1358,7 @@ export async function runAgentOnce(input: ContainerInput): Promise<ContainerOutp
   const runMemoryExtraction = async () => {
     const extractionMessages = history.slice(-memoryExtractionMaxMessages);
     if (extractionMessages.length === 0) return;
+    const extractionStartedAt = Date.now();
     const extractionPrompt = buildMemoryExtractionPrompt({
       assistantName,
       userId: input.userId,
@@ -1380,6 +1404,7 @@ export async function runAgentOnce(input: ContainerInput): Promise<ContainerOutp
       memoryItemsExtracted += normalizedItems.length;
       memoryItemsUpserted += normalizedItems.length;
     }
+    timings.memory_extraction_ms = (timings.memory_extraction_ms ?? 0) + (Date.now() - extractionStartedAt);
   };
 
   if (memoryExtractionEnabled && (!input.isScheduledTask || memoryExtractScheduled)) {
@@ -1398,6 +1423,12 @@ export async function runAgentOnce(input: ContainerInput): Promise<ContainerOutp
 
   // Normalize empty/whitespace-only responses to null
   const finalResult = responseText && responseText.trim() ? responseText : null;
+  if (toolCalls.length > 0) {
+    const totalToolMs = toolCalls.reduce((sum, call) => sum + (call.duration_ms || 0), 0);
+    if (totalToolMs > 0) {
+      timings.tool_ms = totalToolMs;
+    }
+  }
 
   return {
     status: 'success',
@@ -1413,6 +1444,7 @@ export async function runAgentOnce(input: ContainerInput): Promise<ContainerOutp
     session_recall_count: sessionRecallCount,
     memory_items_upserted: memoryItemsUpserted,
     memory_items_extracted: memoryItemsExtracted,
+    timings: Object.keys(timings).length > 0 ? timings : undefined,
     tool_calls: toolCalls.length > 0 ? toolCalls : undefined,
     latency_ms: latencyMs
   };

package/container/agent-runner/src/tools.ts

@@ -39,6 +39,13 @@ type ToolRuntime = {
     tools: string[];
     timeoutMs: number;
   };
+  progress: {
+    enabled: boolean;
+    minIntervalMs: number;
+    notifyTools: string[];
+    notifyOnStart: boolean;
+    notifyOnError: boolean;
+  };
   openrouter: {
     siteUrl: string;
     siteName: string;
@@ -86,6 +93,13 @@ function buildToolRuntime(config: AgentRuntimeConfig['agent']): ToolRuntime {
       tools: toolSummaryTools,
       timeoutMs: toolSummaryTimeoutMs
     },
+    progress: {
+      enabled: config.tools.progress.enabled,
+      minIntervalMs: config.tools.progress.minIntervalMs,
+      notifyTools: config.tools.progress.notifyTools,
+      notifyOnStart: config.tools.progress.notifyOnStart,
+      notifyOnError: config.tools.progress.notifyOnError
+    },
     openrouter: {
       siteUrl: config.openrouter.siteUrl,
       siteName: config.openrouter.siteName
@@ -824,12 +838,23 @@ async function maybeSummarizeToolResult<T>(name: string, result: T, runtime: Too
   return payload.apply(limited.text) as T;
 }
 
-export function createTools(ctx: IpcContext, config: AgentRuntimeConfig['agent'], options?: { onToolCall?: ToolCallLogger; policy?: ToolPolicy }) {
+export function createTools(
+  ctx: IpcContext,
+  config: AgentRuntimeConfig['agent'],
+  options?: { onToolCall?: ToolCallLogger; policy?: ToolPolicy; jobProgress?: { jobId?: string; enabled?: boolean } }
+) {
   const runtime = buildToolRuntime(config);
   const ipc = createIpcHandlers(ctx, config.ipc);
   const isMain = ctx.isMain;
   const onToolCall = options?.onToolCall;
   const policy = options?.policy;
+  const progressConfig = runtime.progress;
+  const progressJobId = options?.jobProgress?.jobId;
+  const progressEnabled = Boolean(progressJobId && progressConfig.enabled && options?.jobProgress?.enabled !== false);
+  const progressNotifyTools = new Set(
+    (progressConfig.notifyTools || []).map(item => item.trim().toLowerCase()).filter(Boolean)
+  );
+  let lastProgressNotifyAt = 0;
   const allowList = (policy?.allow || []).map(item => item.toLowerCase());
   const denyList = (policy?.deny || []).map(item => item.toLowerCase());
   const maxPerRunConfig = policy?.max_per_run || {};
@@ -849,24 +874,62 @@ export function createTools(ctx: IpcContext, config: AgentRuntimeConfig['agent']
   const webFetchAllowlist = runtime.webfetchAllowlist;
   const webFetchBlocklist = runtime.webfetchBlocklist;
 
+  const shouldNotifyTool = (name: string) => {
+    if (!progressEnabled) return false;
+    if (!progressNotifyTools || progressNotifyTools.size === 0) return false;
+    return progressNotifyTools.has(name.toLowerCase());
+  };
+
+  const sendJobUpdate = (payload: { message: string; level?: 'info' | 'progress' | 'warn' | 'error'; notify?: boolean; data?: Record<string, unknown> }) => {
+    if (!progressEnabled || !progressJobId) return;
+    void ipc.jobUpdate({
+      job_id: progressJobId,
+      message: payload.message,
+      level: payload.level,
+      notify: payload.notify,
+      data: payload.data
+    }).catch(() => undefined);
+  };
+
   const wrapExecute = <TInput, TOutput>(name: string, execute: (args: TInput) => Promise<TOutput>) => {
     return async (args: TInput): Promise<TOutput> => {
       const start = Date.now();
+      const normalizedName = name.toLowerCase();
+      const isSystemTool = normalizedName.startsWith('mcp__');
       try {
-        const normalized = name.toLowerCase();
-        if (denyList.includes(normalized)) {
+        if (denyList.includes(normalizedName)) {
           throw new Error(`Tool is disabled by policy: ${name}`);
         }
-        if (allowList.length > 0 && !allowList.includes(normalized)) {
+        if (allowList.length > 0 && !allowList.includes(normalizedName)) {
           throw new Error(`Tool not allowed by policy: ${name}`);
         }
         const currentCount = usageCounts.get(name) || 0;
-        const maxAllowed = maxPerRun.get(normalized) ?? defaultMax;
+        const maxAllowed = maxPerRun.get(normalizedName) ?? defaultMax;
         if (Number.isFinite(maxAllowed) && maxAllowed > 0 && currentCount >= maxAllowed) {
           throw new Error(`Tool usage limit reached for ${name} (max ${maxAllowed} per run)`);
         }
         usageCounts.set(name, currentCount + 1);
 
+        if (!isSystemTool && shouldNotifyTool(name) && progressConfig.notifyOnStart) {
+          const now = Date.now();
+          if (now - lastProgressNotifyAt >= progressConfig.minIntervalMs) {
+            lastProgressNotifyAt = now;
+            sendJobUpdate({
+              message: `Running ${name}...`,
+              level: 'progress',
+              notify: true,
+              data: { tool: name, stage: 'start' }
+            });
+          } else {
+            sendJobUpdate({
+              message: `Running ${name}...`,
+              level: 'progress',
+              notify: false,
+              data: { tool: name, stage: 'start' }
+            });
+          }
+        }
+
         const rawResult = await execute(args);
         const result = await maybeSummarizeToolResult(name, rawResult, runtime);
         let outputBytes: number | undefined;
@@ -888,6 +951,14 @@ export function createTools(ctx: IpcContext, config: AgentRuntimeConfig['agent']
           output_bytes: outputBytes,
           output_truncated: outputTruncated
         });
+        if (!isSystemTool && shouldNotifyTool(name)) {
+          sendJobUpdate({
+            message: `${name} finished.`,
+            level: 'info',
+            notify: false,
+            data: { tool: name, stage: 'end', ok: true, duration_ms: Date.now() - start }
+          });
+        }
         return result;
       } catch (err) {
         onToolCall?.({
@@ -897,6 +968,14 @@ export function createTools(ctx: IpcContext, config: AgentRuntimeConfig['agent']
           duration_ms: Date.now() - start,
           error: err instanceof Error ? err.message : String(err)
         });
+        if (!isSystemTool && shouldNotifyTool(name) && progressConfig.notifyOnError) {
+          sendJobUpdate({
+            message: `${name} failed: ${err instanceof Error ? err.message : String(err)}`,
+            level: 'error',
+            notify: true,
+            data: { tool: name, stage: 'end', ok: false, duration_ms: Date.now() - start }
+          });
+        }
         throw err;
       }
     };

package/dist/agent-context.d.ts

@@ -30,6 +30,10 @@ export type AgentContext = {
     tokenEstimate: ReturnType<typeof getTokenEstimateConfig>;
     modelCapabilities: ModelCapabilities;
     dynamicMemoryBudget: number;
+    timings: {
+        context_build_ms?: number;
+        memory_recall_ms?: number;
+    };
 };
 export declare function buildAgentContext(params: {
     groupFolder: string;
@@ -39,5 +43,6 @@ export declare function buildAgentContext(params: {
     recallMaxTokens: number;
     toolAllow?: string[];
     toolDeny?: string[];
+    recallEnabled?: boolean;
 }): Promise<AgentContext>;
 //# sourceMappingURL=agent-context.d.ts.map

package/dist/agent-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-context.d.ts","sourceRoot":"","sources":["../src/agent-context.ts"],"names":[],"mappings":"AAGA,OAAO,EAA+C,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAG3F,OAAO,EAAgB,iBAAiB,EAAE,sBAAsB,EAAE,eAAe,EAAwB,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAGxJ,MAAM,MAAM,YAAY,GAAG;IACzB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,WAAW,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5E,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,UAAU,EAAE,UAAU,CAAC;IACvB,eAAe,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC,CAAC;IAC9G,aAAa,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE;YAAE,cAAc,CAAC,EAAE,MAAM,CAAC;YAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;YAAC,WAAW,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC;IAC3H,aAAa,EAAE,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC;IACpD,YAAY,EAAE,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC;IACjD,aAAa,EAAE,UAAU,CAAC,OAAO,sBAAsB,CAAC,CAAC;IACzD,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,mBAAmB,EAAE,MAAM,CAAC;CAC7B,CAAC;AA4BF,wBAAsB,iBAAiB,CAAC,MAAM,EAAE;IAC9C,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB,GAAG,OAAO,CAAC,YAAY,CAAC,CAwFxB"}
+{"version":3,"file":"agent-context.d.ts","sourceRoot":"","sources":["../src/agent-context.ts"],"names":[],"mappings":"AAGA,OAAO,EAA+C,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAG3F,OAAO,EAAgB,iBAAiB,EAAE,sBAAsB,EAAE,eAAe,EAAwB,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAGxJ,MAAM,MAAM,YAAY,GAAG;IACzB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,WAAW,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5E,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,UAAU,EAAE,UAAU,CAAC;IACvB,eAAe,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC,CAAC;IAC9G,aAAa,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE;YAAE,cAAc,CAAC,EAAE,MAAM,CAAC;YAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;YAAC,WAAW,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC;IAC3H,aAAa,EAAE,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC;IACpD,YAAY,EAAE,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC;IACjD,aAAa,EAAE,UAAU,CAAC,OAAO,sBAAsB,CAAC,CAAC;IACzD,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,OAAO,EAAE;QACP,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;KAC3B,CAAC;CACH,CAAC;AA4BF,wBAAsB,iBAAiB,CAAC,MAAM,EAAE;IAC9C,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB,GAAG,OAAO,CAAC,YAAY,CAAC,CAmGxB"}

package/dist/agent-context.js

@@ -22,6 +22,7 @@ function calculateMemoryBudget(modelCapabilities, maxOutputTokens, configuredMax
     return Math.min(Math.max(800, Math.min(4000, calculatedBudget)), configuredMax);
 }
 export async function buildAgentContext(params) {
+    const startedAt = Date.now();
     const runtime = loadRuntimeConfig();
     const defaultModel = runtime.host.defaultModel;
     const modelRegistry = loadModelRegistry(defaultModel);
@@ -36,13 +37,19 @@ export async function buildAgentContext(params) {
     const modelCapabilities = await getModelCapabilities(resolvedModel.model);
     // Calculate dynamic memory budget based on model context window
     const dynamicMemoryBudget = calculateMemoryBudget(modelCapabilities, runtime.agent.context.maxOutputTokens, params.recallMaxTokens);
-    const memoryRecall = await buildHybridMemoryRecall({
-        groupFolder: params.groupFolder,
-        userId: params.userId ?? null,
-        query: params.recallQuery,
-        maxResults: params.recallMaxResults,
-        maxTokens: dynamicMemoryBudget
-    });
+    let memoryRecall = [];
+    let memoryRecallMs;
+    if (params.recallEnabled !== false && params.recallMaxResults > 0 && params.recallMaxTokens > 0) {
+        const recallStart = Date.now();
+        memoryRecall = await buildHybridMemoryRecall({
+            groupFolder: params.groupFolder,
+            userId: params.userId ?? null,
+            query: params.recallQuery,
+            maxResults: params.recallMaxResults,
+            maxTokens: dynamicMemoryBudget
+        });
+        memoryRecallMs = Date.now() - recallStart;
+    }
     const userProfile = buildUserProfile({
         groupFolder: params.groupFolder,
         userId: params.userId ?? null
@@ -93,7 +100,11 @@ export async function buildAgentContext(params) {
         modelPricing,
         tokenEstimate,
         modelCapabilities,
-        dynamicMemoryBudget
+        dynamicMemoryBudget,
+        timings: {
+            context_build_ms: Date.now() - startedAt,
+            memory_recall_ms: memoryRecallMs
+        }
     };
 }
 //# sourceMappingURL=agent-context.js.map