@dotsetlabs/dotclaw 2.4.0 → 2.6.0

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

@@ -180,6 +180,22 @@ export type ToolPolicy = {
   default_max_per_run?: number;
 };
 
+function applyPolicyToolFilter(tools: Tool[], policy?: ToolPolicy): Tool[] {
+  if (!policy) return tools;
+  const allowSet = Array.isArray(policy.allow)
+    ? new Set(policy.allow.map(name => String(name || '').trim().toLowerCase()).filter(Boolean))
+    : null;
+  const denySet = new Set((policy.deny || []).map(name => String(name || '').trim().toLowerCase()).filter(Boolean));
+  return tools.filter((entry) => {
+    const name = entry?.function?.name;
+    if (!name) return false;
+    const normalized = name.toLowerCase();
+    if (denySet.has(normalized)) return false;
+    if (allowSet && !allowSet.has(normalized)) return false;
+    return true;
+  });
+}
+
 const TOOL_OUTPUT_PREVIEW_BYTES = 6000;
 
 function getAllowedRoots(isMain: boolean): string[] {
@@ -449,7 +465,188 @@ async function assertUrlAllowed(params: {
   }
 }
 
+function parseLooseJson(value: string): unknown {
+  let parsed: unknown = value;
+  for (let i = 0; i < 2 && typeof parsed === 'string'; i += 1) {
+    parsed = JSON.parse(parsed);
+  }
+  return parsed;
+}
+
+function toPositiveInt(value: unknown): number | undefined {
+  if (typeof value === 'number' && Number.isFinite(value)) {
+    const rounded = Math.floor(value);
+    return rounded > 0 ? rounded : undefined;
+  }
+  if (typeof value === 'string') {
+    const parsed = Number(value.trim());
+    if (!Number.isFinite(parsed)) return undefined;
+    const rounded = Math.floor(parsed);
+    return rounded > 0 ? rounded : undefined;
+  }
+  return undefined;
+}
+
+function toNonNegativeInt(value: unknown): number | undefined {
+  if (typeof value === 'number' && Number.isFinite(value)) {
+    const rounded = Math.floor(value);
+    return rounded >= 0 ? rounded : undefined;
+  }
+  if (typeof value === 'string') {
+    const parsed = Number(value.trim());
+    if (!Number.isFinite(parsed)) return undefined;
+    const rounded = Math.floor(parsed);
+    return rounded >= 0 ? rounded : undefined;
+  }
+  return undefined;
+}
+
+function setAlias(record: Record<string, unknown>, canonical: string, aliases: string[]): void {
+  const existing = record[canonical];
+  if (typeof existing === 'string' && existing.trim()) return;
+  for (const alias of aliases) {
+    const value = record[alias];
+    if (typeof value === 'string' && value.trim()) {
+      record[canonical] = value;
+      return;
+    }
+  }
+}
+
+function sanitizeNumericField(
+  record: Record<string, unknown>,
+  field: string,
+  mode: 'positive' | 'nonnegative'
+): void {
+  if (!(field in record)) return;
+  const coerced = mode === 'positive'
+    ? toPositiveInt(record[field])
+    : toNonNegativeInt(record[field]);
+  if (coerced === undefined) {
+    delete record[field];
+    return;
+  }
+  record[field] = coerced;
+}
+
+function normalizeToolArgs(name: string, args: unknown): unknown {
+  const normalizedName = name.trim().toLowerCase();
+  let value = args;
+
+  if (typeof value === 'string') {
+    const trimmed = value.trim();
+    if (!trimmed) return value;
+    if (trimmed.startsWith('{') || trimmed.startsWith('[') || trimmed.startsWith('"')) {
+      try {
+        value = parseLooseJson(trimmed);
+      } catch {
+        // Keep the original string if JSON is malformed/truncated.
+      }
+    }
+    if (typeof value === 'string') {
+      switch (normalizedName) {
+        case 'bash':
+        case 'process':
+          return { command: value };
+        case 'python':
+          return { code: value };
+        case 'webfetch':
+          return { url: value.trim() };
+        case 'websearch':
+          return { query: value };
+        case 'read':
+          return { path: value };
+        case 'glob':
+          return { pattern: value };
+        case 'grep':
+          return { pattern: value };
+        default:
+          return value;
+      }
+    }
+  }
+
+  if (!value || typeof value !== 'object' || Array.isArray(value)) {
+    return value;
+  }
+
+  const record = { ...(value as Record<string, unknown>) };
+  const pathAliases = ['file', 'filePath', 'filepath', 'file_path', 'targetPath', 'target_path'];
+
+  switch (normalizedName) {
+    case 'read':
+    case 'write':
+    case 'edit':
+    case 'analyzeimage':
+      setAlias(record, 'path', pathAliases);
+      break;
+    case 'bash':
+    case 'process':
+      setAlias(record, 'command', ['cmd', 'shell', 'script', 'input']);
+      break;
+    case 'python':
+      setAlias(record, 'code', ['script', 'input', 'content', 'text']);
+      break;
+    case 'glob':
+      setAlias(record, 'pattern', ['glob', 'path']);
+      break;
+    case 'grep':
+      setAlias(record, 'pattern', ['query', 'search', 'text']);
+      setAlias(record, 'path', pathAliases);
+      break;
+    case 'websearch':
+      setAlias(record, 'query', ['q', 'search', 'text', 'input']);
+      break;
+    case 'webfetch':
+      setAlias(record, 'url', ['uri', 'href', 'link']);
+      break;
+    case 'sendfile':
+    case 'sendphoto':
+    case 'sendvoice':
+    case 'sendaudio':
+      setAlias(record, 'path', pathAliases);
+      break;
+    default:
+      break;
+  }
+
+  if (normalizedName === 'write') {
+    setAlias(record, 'content', ['text', 'body', 'data', 'value']);
+  }
+
+  if (normalizedName === 'python' && typeof record.code !== 'string' && record.code !== undefined) {
+    record.code = String(record.code);
+  }
+  if ((normalizedName === 'bash' || normalizedName === 'process') && typeof record.command !== 'string' && record.command !== undefined) {
+    record.command = String(record.command);
+  }
+  if (normalizedName === 'write' && typeof record.content !== 'string' && record.content !== undefined) {
+    record.content = String(record.content);
+  }
+
+  const positiveFields = [
+    'maxBytes', 'maxResults', 'timeoutMs', 'count', 'depth', 'duration', 'reply_to_message_id', 'message_id', 'limit'
+  ];
+  for (const field of positiveFields) {
+    sanitizeNumericField(record, field, 'positive');
+  }
+  sanitizeNumericField(record, 'offset', 'nonnegative');
+
+  return record;
+}
+
 function sanitizeToolArgs(args: unknown): unknown {
+  if (typeof args === 'string') {
+    const trimmed = args.trim();
+    if ((trimmed.startsWith('{') || trimmed.startsWith('[') || trimmed.startsWith('"')) && trimmed.length <= 64_000) {
+      try {
+        return sanitizeToolArgs(parseLooseJson(trimmed));
+      } catch {
+        // Fall through to length-limited string handling.
+      }
+    }
+    return args.length > 512 ? `${args.slice(0, 512)}…` : args;
+  }
   if (!args || typeof args !== 'object') return args;
   const record = { ...(args as Record<string, unknown>) };
 
@@ -713,13 +910,14 @@ async function runCommand(command: string, timeoutMs: number, outputLimit: numbe
 }
 
 async function readFileSafe(filePath: string, maxBytes: number) {
+  const safeMaxBytes = Math.max(1, Math.floor(Number.isFinite(maxBytes) ? maxBytes : 1));
   const stat = fs.statSync(filePath);
-  if (stat.size <= maxBytes) {
+  if (stat.size <= safeMaxBytes) {
     return { content: fs.readFileSync(filePath, 'utf-8'), truncated: false, size: stat.size };
   }
   const fd = fs.openSync(filePath, 'r');
-  const buffer = Buffer.allocUnsafe(maxBytes);
-  const bytesRead = fs.readSync(fd, buffer, 0, maxBytes, 0);
+  const buffer = Buffer.allocUnsafe(safeMaxBytes);
+  const bytesRead = fs.readSync(fd, buffer, 0, safeMaxBytes, 0);
   fs.closeSync(fd);
   return { content: buffer.subarray(0, bytesRead).toString('utf-8'), truncated: true, size: stat.size };
 }
@@ -972,6 +1170,7 @@ export function createTools(
     return async (args: TInput): Promise<TOutput> => {
       const start = Date.now();
       const normalizedName = name.toLowerCase();
+      const normalizedArgs = normalizeToolArgs(name, args) as TInput;
       try {
         if (denyList.includes(normalizedName)) {
           throw new Error(`Tool is disabled by policy: ${name}`);
@@ -986,7 +1185,7 @@ export function createTools(
         }
         usageCounts.set(name, currentCount + 1);
 
-        const rawResult = await execute(args);
+        const rawResult = await execute(normalizedArgs);
         const result = await maybeSummarizeToolResult(name, rawResult, runtime);
         if (onToolResult) {
           const preview = extractToolOutputText(result);
@@ -1015,7 +1214,7 @@ export function createTools(
         }
         onToolCall?.({
           name,
-          args: sanitizeToolArgs(args),
+          args: sanitizeToolArgs(normalizedArgs),
           ok: true,
           duration_ms: Date.now() - start,
           output_bytes: outputBytes,
@@ -1025,7 +1224,7 @@ export function createTools(
       } catch (err) {
         onToolCall?.({
           name,
-          args: sanitizeToolArgs(args),
+          args: sanitizeToolArgs(normalizedArgs),
           ok: false,
           duration_ms: Date.now() - start,
           error: err instanceof Error ? err.message : String(err)
@@ -1173,7 +1372,11 @@ export function createTools(
     }),
     execute: wrapExecute('Read', async ({ path: inputPath, maxBytes }: { path: string; maxBytes?: number }) => {
       const resolved = resolvePath(inputPath, isMain, true);
-      const { content, truncated, size } = await readFileSafe(resolved, Math.min(maxBytes || runtime.outputLimitBytes, runtime.outputLimitBytes));
+      const requestedMaxBytes = Number.isFinite(maxBytes)
+        ? Math.floor(maxBytes as number)
+        : runtime.outputLimitBytes;
+      const clampedMaxBytes = Math.max(1, Math.min(requestedMaxBytes, runtime.outputLimitBytes));
+      const { content, truncated, size } = await readFileSafe(resolved, clampedMaxBytes);
       return { path: resolved, content, truncated, size };
     })
   });
@@ -2603,7 +2806,7 @@ export function createTools(
   }
   tools.push(analyzeImageTool as Tool);
 
-  return tools;
+  return applyPolicyToolFilter(tools, policy);
 }
 
 /**

package/dist/agent-context.d.ts

@@ -2,6 +2,7 @@ import { ToolPolicy } from './tool-policy.js';
 import { loadModelRegistry, getTokenEstimateConfig, getModelPricing, ModelCapabilities } from './model-registry.js';
 export type AgentContext = {
     memoryRecall: string[];
+    memoryRecallAttempted: boolean;
     userProfile: string | null;
     memoryStats: {
         total: number;

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;IAC5B,OAAO,EAAE;QACP,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;KAC3B,CAAC;CACH,CAAC;AA4BF,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,UAAU,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,GAAG,UAAU,CAiB3F;AAED,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;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,GAAG,OAAO,CAAC,YAAY,CAAC,CAgGxB"}
+{"version":3,"file":"agent-context.d.ts","sourceRoot":"","sources":["../src/agent-context.ts"],"names":[],"mappings":"AAEA,OAAO,EAA+C,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAG3F,OAAO,EAAgB,iBAAiB,EAAE,sBAAsB,EAAE,eAAe,EAAwB,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAIxJ,MAAM,MAAM,YAAY,GAAG;IACzB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,qBAAqB,EAAE,OAAO,CAAC;IAC/B,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,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,UAAU,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,GAAG,UAAU,CAiB3F;AAED,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;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,GAAG,OAAO,CAAC,YAAY,CAAC,CA4GxB"}

package/dist/agent-context.js

@@ -1,11 +1,11 @@
-import { buildHybridMemoryRecall } from './memory-recall.js';
-import { buildUserProfile, getMemoryStats } from './memory-store.js';
+import { resolveMemoryBackend } from './memory-backend.js';
 import { loadPersonalizedBehaviorConfig } from './personalization.js';
 import { getEffectiveToolPolicy, mergeToolPolicyDeny } from './tool-policy.js';
 import { applyToolBudgets } from './tool-budgets.js';
 import { getToolReliability } from './db.js';
 import { resolveModel, loadModelRegistry, getTokenEstimateConfig, getModelPricing, getModelCapabilities } from './model-registry.js';
 import { loadRuntimeConfig } from './runtime-config.js';
+import { optimizeRecallQuery, resolveRecallBudget, shouldRunMemoryRecall } from './recall-policy.js';
 /**
  * Calculate dynamic memory token budget based on model capabilities
  * Reserves 15% of available context for memories (min 800, max 4000)
@@ -38,6 +38,7 @@ export function applyToolAllowOverride(policy, toolAllow) {
 export async function buildAgentContext(params) {
     const startedAt = Date.now();
     const runtime = loadRuntimeConfig();
+    const memoryBackend = await resolveMemoryBackend();
     // Use routing.model as the base — model.json per_user/per_group overrides take priority
     const defaultModel = runtime.host.routing.model || runtime.host.defaultModel;
     const modelRegistry = loadModelRegistry(defaultModel);
@@ -55,23 +56,33 @@ export async function buildAgentContext(params) {
     const dynamicMemoryBudget = calculateMemoryBudget(modelCapabilities, runtime.agent.context.maxOutputTokens, params.recallMaxTokens);
     let memoryRecall = [];
     let memoryRecallMs;
-    if (params.recallEnabled !== false && params.recallMaxResults > 0 && params.recallMaxTokens > 0) {
+    const optimizedRecallQuery = optimizeRecallQuery(params.recallQuery, params.messageText || '');
+    const recallBudget = resolveRecallBudget({
+        query: optimizedRecallQuery,
+        maxResults: params.recallMaxResults,
+        maxTokens: params.recallMaxTokens
+    });
+    const recallEnabled = params.recallEnabled !== false
+        && recallBudget.maxResults > 0
+        && recallBudget.maxTokens > 0
+        && shouldRunMemoryRecall(optimizedRecallQuery);
+    if (recallEnabled) {
         const recallStart = Date.now();
-        memoryRecall = await buildHybridMemoryRecall({
+        memoryRecall = await memoryBackend.buildRecall({
             groupFolder: params.groupFolder,
             userId: params.userId ?? null,
-            query: params.recallQuery,
-            maxResults: params.recallMaxResults,
-            maxTokens: dynamicMemoryBudget,
+            query: optimizedRecallQuery,
+            maxResults: recallBudget.maxResults,
+            maxTokens: Math.min(dynamicMemoryBudget, recallBudget.maxTokens),
             minScore: runtime.host.memory.recall.minScore
         });
         memoryRecallMs = Date.now() - recallStart;
     }
-    const userProfile = buildUserProfile({
+    const userProfile = memoryBackend.buildUserProfile({
         groupFolder: params.groupFolder,
         userId: params.userId ?? null
     });
-    const memoryStats = getMemoryStats({
+    const memoryStats = memoryBackend.getStats({
         groupFolder: params.groupFolder,
         userId: params.userId ?? null
     });
@@ -101,6 +112,7 @@ export async function buildAgentContext(params) {
     }));
     return {
         memoryRecall,
+        memoryRecallAttempted: recallEnabled,
         userProfile,
         memoryStats,
         behaviorConfig,

package/dist/agent-context.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent-context.js","sourceRoot":"","sources":["../src/agent-context.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"agent-context.js","sourceRoot":"","sources":["../src/agent-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,8BAA8B,EAAE,MAAM,sBAAsB,CAAC;AACtE,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAc,MAAM,kBAAkB,CAAC;AAC3F,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,eAAe,EAAE,oBAAoB,EAAqB,MAAM,qBAAqB,CAAC;AACxJ,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAsBrG;;;GAGG;AACH,SAAS,qBAAqB,CAC5B,iBAAoC,EACpC,eAAuB,EACvB,aAAqB;IAErB,MAAM,aAAa,GAAG,iBAAiB,CAAC,cAAc,CAAC;IACvD,MAAM,aAAa,GAAG,iBAAiB,CAAC,qBAAqB,IAAI,eAAe,CAAC;IAEjF,gDAAgD;IAChD,MAAM,eAAe,GAAG,aAAa,GAAG,aAAa,CAAC;IAEtD,2BAA2B;IAC3B,MAAM,WAAW,GAAG,IAAI,CAAC;IACzB,MAAM,gBAAgB,GAAG,IAAI,CAAC,KAAK,CAAC,eAAe,GAAG,WAAW,CAAC,CAAC;IAEnE,8DAA8D;IAC9D,OAAO,IAAI,CAAC,GAAG,CACb,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAAC,EAC/C,aAAa,CACd,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,MAAkB,EAAE,SAAoB;IAC7E,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC;IAEvE,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAClC,SAAS;SACN,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;SACxB,MAAM,CAAC,OAAO,CAAC,CACnB,CAAC,CAAC;IACH,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;IAE1E,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QAChC,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;QACrF,OAAO,EAAE,GAAG,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;IACxC,CAAC;IAED,wEAAwE;IACxE,OAAO,EAAE,GAAG,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;AACzC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,MAUvC;IACC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,MAAM,OAAO,GAAG,iBAAiB,EAAE,CAAC;IACpC,MAAM,aAAa,GAAG,MAAM,oBAAoB,EAAE,CAAC;IACnD,wFAAwF;IACxF,MAAM,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC;IAC7E,MAAM,aAAa,GAAG,iBAAiB,CAAC,YAAY,CAAC,CAAC;IACtD,MAAM,aAAa,GAAG,YAAY,CAAC;QACjC,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,IAAI;QAC7B,YAAY;QACZ,WAAW,EAAE,MAAM,CAAC,WAAW;KAChC,CAAC,CAAC;IACH,MAAM,aAAa,GAAG,sBAAsB,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;IACrE,MAAM,YAAY,GAAG,eAAe,CAAC,aAAa,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC;IAEzE,qEAAqE;IACrE,MAAM,iBAAiB,GAAG,MAAM,oBAAoB,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;IAE1E,gEAAgE;IAChE,MAAM,mBAAmB,GAAG,qBAAqB,CAC/C,iBAAiB,EACjB,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,eAAe,EACrC,MAAM,CAAC,eAAe,CACvB,CAAC;IAEF,IAAI,YAAY,GAAa,EAAE,CAAC;IAChC,IAAI,cAAkC,CAAC;IACvC,MAAM,oBAAoB,GAAG,mBAAmB,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC;IAC/F,MAAM,YAAY,GAAG,mBAAmB,CAAC;QACvC,KAAK,EAAE,oBAAoB;QAC3B,UAAU,EAAE,MAAM,CAAC,gBAAgB;QACnC,SAAS,EAAE,MAAM,CAAC,eAAe;KAClC,CAAC,CAAC;IACH,MAAM,aAAa,GAAG,MAAM,CAAC,aAAa,KAAK,KAAK;WAC/C,YAAY,CAAC,UAAU,GAAG,CAAC;WAC3B,YAAY,CAAC,SAAS,GAAG,CAAC;WAC1B,qBAAqB,CAAC,oBAAoB,CAAC,CAAC;IACjD,IAAI,aAAa,EAAE,CAAC;QAClB,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC/B,YAAY,GAAG,MAAM,aAAa,CAAC,WAAW,CAAC;YAC7C,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,IAAI;YAC7B,KAAK,EAAE,oBAAoB;YAC3B,UAAU,EAAE,YAAY,CAAC,UAAU;YACnC,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,mBAAmB,EAAE,YAAY,CAAC,SAAS,CAAC;YAChE,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ;SAC9C,CAAC,CAAC;QACH,cAAc,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,WAAW,CAAC;IAC5C,CAAC;IAED,MAAM,WAAW,GAAG,aAAa,CAAC,gBAAgB,CAAC;QACjD,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,IAAI;KAC9B,CAAC,CAAC;IAEH,MAAM,WAAW,GAAG,aAAa,CAAC,QAAQ,CAAC;QACzC,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,IAAI;KAC9B,CAAC,CAAC;IAEH,MAAM,cAAc,GAAG,8BAA8B,CAAC;QACpD,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,IAAI;KAC9B,CAAuC,CAAC;IAEzC,MAAM,cAAc,GAAG,sBAAsB,CAAC;QAC5C,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,IAAI;KAC9B,CAAC,CAAC;IACH,MAAM,kBAAkB,GAAG,gBAAgB,CAAC;QAC1C,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,IAAI;QAC7B,UAAU,EAAE,cAAc;KAC3B,CAAC,CAAC;IACH,IAAI,UAAU,GAAG,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC;QAC5D,CAAC,CAAC,mBAAmB,CAAC,kBAAkB,EAAE,MAAM,CAAC,QAAQ,CAAC;QAC1D,CAAC,CAAC,kBAAkB,CAAC;IAEvB,UAAU,GAAG,sBAAsB,CAAC,UAAU,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;IAElE,MAAM,eAAe,GAAG,kBAAkB,CAAC,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;SACxF,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACX,IAAI,EAAE,GAAG,CAAC,SAAS;QACnB,YAAY,EAAE,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC1D,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,eAAe,EAAE,GAAG,CAAC,eAAe;KACrC,CAAC,CAAC,CAAC;IAEN,OAAO;QACL,YAAY;QACZ,qBAAqB,EAAE,aAAa;QACpC,WAAW;QACX,WAAW;QACX,cAAc;QACd,UAAU;QACV,eAAe;QACf,aAAa;QACb,aAAa;QACb,YAAY;QACZ,aAAa;QACb,iBAAiB;QACjB,mBAAmB;QACnB,OAAO,EAAE;YACP,gBAAgB,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;YACxC,gBAAgB,EAAE,cAAc;SACjC;KACF,CAAC;AACJ,CAAC"}

package/dist/agent-execution.d.ts

@@ -1,4 +1,5 @@
 import { AgentContext } from './agent-context.js';
+import { AgentExecutionLane } from './agent-semaphore.js';
 import type { ContainerOutput } from './container-protocol.js';
 import type { RegisteredGroup } from './types.js';
 export type TraceBase = {
@@ -54,6 +55,7 @@ export declare function executeAgentRun(params: {
     maxToolSteps?: number;
     timeoutMs?: number;
     timezone?: string;
+    lane?: AgentExecutionLane;
     streamDir?: string;
     attachments?: Array<{
         type: 'photo' | 'document' | 'voice' | 'video' | 'audio';

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

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

package/dist/agent-execution.js

@@ -8,7 +8,9 @@ import { withGroupLock } from './locks.js';
 import { getModelPricing } from './model-registry.js';
 import { computeCostUSD } from './cost.js';
 import { writeTrace } from './trace-writer.js';
-import { recordLatency, recordTokenUsage, recordCost, recordMemoryRecall, recordMemoryUpsert, recordMemoryExtract, recordToolCall, recordError, recordStageLatency } from './metrics.js';
+import { recordLatency, recordTokenUsage, recordCost, recordMemoryRecall, recordMemoryUpsert, recordMemoryExtract, recordToolCall, recordError, recordStageLatency, recordFailover } from './metrics.js';
+import { loadRuntimeConfig } from './runtime-config.js';
+import { buildFailoverEnvelope, chooseNextHostModelChain, downgradeReasoningEffort, reduceToolStepBudget, registerModelFailureCooldown } from './failover-policy.js';
 import { emitHook } from './hooks.js';
 import { logger } from './logger.js';
 export class AgentExecutionError extends Error {
@@ -46,7 +48,20 @@ function buildTaskSnapshot() {
         last_error: t.last_error ?? null
     }));
 }
+function buildModelChain(primary, fallbacks) {
+    const deduped = [];
+    const seen = new Set();
+    for (const candidate of [primary, ...(fallbacks || [])]) {
+        const normalized = (candidate || '').trim();
+        if (!normalized || seen.has(normalized))
+            continue;
+        deduped.push(normalized);
+        seen.add(normalized);
+    }
+    return deduped;
+}
 export async function executeAgentRun(params) {
+    const runStartedAt = Date.now();
     const group = params.group;
     const isMain = group.folder === MAIN_GROUP_FOLDER;
     const persistSession = params.persistSession !== false;
@@ -80,7 +95,65 @@ export async function executeAgentRun(params) {
     const resolvedMaxOutputTokens = outputCandidates.length > 0
         ? Math.min(...outputCandidates)
         : Infinity;
-    const runContainer = () => runContainerAgent(group, {
+    const runtime = loadRuntimeConfig();
+    const hostFailover = runtime.host.routing.hostFailover;
+    const maxHostRetries = hostFailover.enabled ? Math.max(0, hostFailover.maxRetries) : 0;
+    const lane = params.lane || (params.isScheduledTask ? 'scheduled' : 'interactive');
+    const initialModelChain = buildModelChain(params.modelOverride || context.resolvedModel.model, params.modelFallbacks);
+    const initialChainSelection = chooseNextHostModelChain({
+        modelChain: initialModelChain,
+        attemptedPrimaryModels: new Set()
+    });
+    const initialPrimary = initialModelChain[0] || context.resolvedModel.model;
+    if (initialChainSelection && initialChainSelection.model !== initialPrimary) {
+        logger.info({
+            chatJid: params.chatJid,
+            groupFolder: group.folder,
+            skippedModel: initialPrimary,
+            selectedModel: initialChainSelection.model
+        }, 'Skipping primary model due to active host cooldown');
+    }
+    const attemptedPrimaryModels = new Set();
+    let activeModelChain = initialChainSelection
+        ? [initialChainSelection.model, ...initialChainSelection.fallbacks]
+        : [...initialModelChain];
+    let activeReasoningEffort = params.reasoningEffort;
+    let activeMaxToolSteps = params.maxToolSteps;
+    let hostAttempts = 0;
+    let hostRecovered = false;
+    let lastFailoverCategory;
+    let lastFailoverEnvelope;
+    const failoverEnvelopes = [];
+    const markFailoverExhaustedIfNeeded = () => {
+        if (hostAttempts > 1 && lastFailoverCategory) {
+            recordFailover('exhausted', lastFailoverCategory);
+        }
+    };
+    const planHostRetry = (hostAttempt, envelope) => {
+        const canRetry = hostAttempt < maxHostRetries && envelope.retryable;
+        if (!canRetry)
+            return null;
+        return chooseNextHostModelChain({
+            modelChain: initialModelChain,
+            attemptedPrimaryModels
+        });
+    };
+    const applyHostRetry = (hostAttempt, envelope, nextChain, message) => {
+        recordFailover('attempt', envelope.category);
+        activeModelChain = [nextChain.model, ...nextChain.fallbacks];
+        activeReasoningEffort = downgradeReasoningEffort(activeReasoningEffort);
+        activeMaxToolSteps = reduceToolStepBudget(activeMaxToolSteps);
+        logger.warn({
+            chatJid: params.chatJid,
+            groupFolder: group.folder,
+            attempt: hostAttempt + 1,
+            category: envelope.category,
+            source: envelope.source,
+            statusCode: envelope.statusCode,
+            retryModel: nextChain.model
+        }, message);
+    };
+    const runContainer = (modelOverride, modelFallbacks) => runContainerAgent(group, {
         prompt: params.prompt,
         sessionId: params.sessionId,
         groupFolder: group.folder,
@@ -91,15 +164,16 @@ export async function executeAgentRun(params) {
         userId: params.userId ?? undefined,
         userName: params.userName,
         memoryRecall: context.memoryRecall,
+        memoryRecallAttempted: context.memoryRecallAttempted,
         userProfile: context.userProfile,
         memoryStats: context.memoryStats,
         tokenEstimate: context.tokenEstimate,
         toolReliability: context.toolReliability,
         behaviorConfig: context.behaviorConfig,
         toolPolicy: context.toolPolicy,
-        modelOverride: params.modelOverride || context.resolvedModel.model,
-        modelFallbacks: params.modelFallbacks,
-        reasoningEffort: params.reasoningEffort,
+        modelOverride,
+        modelFallbacks,
+        reasoningEffort: activeReasoningEffort,
         modelCapabilities: {
             context_length: context.modelCapabilities.context_length,
             max_completion_tokens: context.modelCapabilities.max_completion_tokens,
@@ -109,7 +183,7 @@ export async function executeAgentRun(params) {
         modelTemperature: context.resolvedModel.override?.temperature,
         timezone: params.timezone || TIMEZONE,
         hostPlatform: `${process.platform}/${process.arch}`,
-        maxToolSteps: params.maxToolSteps,
+        maxToolSteps: activeMaxToolSteps,
         streamDir: params.streamDir,
         attachments: params.attachments
     }, { abortSignal: params.abortSignal, timeoutMs: params.timeoutMs });
@@ -121,17 +195,81 @@ export async function executeAgentRun(params) {
         model: params.modelOverride || context.resolvedModel.model,
         source: params.isScheduledTask ? 'scheduler' : 'message'
     });
-    let output;
-    try {
-        const runner = () => (useGroupLock ? withGroupLock(group.folder, () => runContainer()) : runContainer());
-        output = useSemaphore
-            ? await runWithAgentSemaphore(runner)
-            : await runner();
-    }
-    catch (err) {
-        const message = err instanceof Error ? err.message : String(err);
+    let output = null;
+    let lastException = null;
+    for (let hostAttempt = 0; hostAttempt <= maxHostRetries; hostAttempt += 1) {
+        const nextPrimary = activeModelChain[0] || context.resolvedModel.model;
+        const nextFallbacks = activeModelChain.slice(1);
+        attemptedPrimaryModels.add(nextPrimary);
+        hostAttempts = hostAttempt + 1;
+        try {
+            const runner = () => (useGroupLock
+                ? withGroupLock(group.folder, () => runContainer(nextPrimary, nextFallbacks))
+                : runContainer(nextPrimary, nextFallbacks));
+            const attemptOutput = useSemaphore
+                ? await runWithAgentSemaphore(runner, { lane })
+                : await runner();
+            if (attemptOutput.status !== 'error') {
+                output = attemptOutput;
+                hostRecovered = hostAttempts > 1;
+                if (hostRecovered && lastFailoverCategory) {
+                    recordFailover('recovered', lastFailoverCategory);
+                }
+                break;
+            }
+            const envelope = buildFailoverEnvelope({
+                error: attemptOutput.error || 'Unknown error',
+                source: 'container_output',
+                attempt: hostAttempts,
+                model: attemptOutput.model || nextPrimary
+            });
+            failoverEnvelopes.push(envelope);
+            lastFailoverEnvelope = envelope;
+            lastFailoverCategory = envelope.category;
+            registerModelFailureCooldown(envelope.model || nextPrimary, envelope.category, hostFailover);
+            const nextChain = planHostRetry(hostAttempt, envelope);
+            if (!nextChain) {
+                markFailoverExhaustedIfNeeded();
+                output = attemptOutput;
+                break;
+            }
+            applyHostRetry(hostAttempt, envelope, nextChain, 'Host-level failover retry');
+            continue;
+        }
+        catch (err) {
+            lastException = err;
+            const envelope = buildFailoverEnvelope({
+                error: err instanceof Error ? err.message : String(err),
+                source: 'runtime_exception',
+                attempt: hostAttempts,
+                model: nextPrimary
+            });
+            failoverEnvelopes.push(envelope);
+            lastFailoverEnvelope = envelope;
+            lastFailoverCategory = envelope.category;
+            registerModelFailureCooldown(nextPrimary, envelope.category, hostFailover);
+            const nextChain = planHostRetry(hostAttempt, envelope);
+            if (!nextChain) {
+                markFailoverExhaustedIfNeeded();
+                break;
+            }
+            applyHostRetry(hostAttempt, envelope, nextChain, 'Host-level failover retry after runtime error');
+        }
+    }
+    if (!output && lastException) {
+        const message = lastException instanceof Error ? lastException.message : String(lastException);
         throw new AgentExecutionError(message, context);
     }
+    if (!output) {
+        throw new AgentExecutionError('No output from agent run', context);
+    }
+    output.host_failover_attempts = hostAttempts;
+    output.host_failover_recovered = hostRecovered;
+    output.host_failover_category = lastFailoverCategory;
+    output.host_failover_source = lastFailoverEnvelope?.source;
+    output.host_failover_status_code = lastFailoverEnvelope?.statusCode;
+    output.host_failover_envelopes = failoverEnvelopes.length > 0 ? failoverEnvelopes : undefined;
+    output.latency_ms = Math.max(1, Date.now() - runStartedAt);
     void emitHook('agent:complete', {
         group_folder: group.folder,
         chat_jid: params.chatJid,
@@ -189,6 +327,17 @@ export function recordAgentTelemetry(params) {
         session_recall_count: output?.session_recall_count,
         memory_items_upserted: output?.memory_items_upserted,
         memory_items_extracted: output?.memory_items_extracted,
+        host_failover_attempts: output?.host_failover_attempts,
+        host_failover_recovered: output?.host_failover_recovered,
+        host_failover_category: output?.host_failover_category,
+        host_failover_source: output?.host_failover_source,
+        host_failover_status_code: output?.host_failover_status_code,
+        host_failover_envelopes: output?.host_failover_envelopes,
+        tool_retry_attempts: output?.tool_retry_attempts,
+        tool_outcome_verification_forced: output?.tool_outcome_verification_forced,
+        tool_loop_breaker_triggered: output?.tool_loop_breaker_triggered,
+        tool_loop_breaker_reason: output?.tool_loop_breaker_reason,
+        memory_extraction_error: output?.memory_extraction_error,
         timings: Object.keys(timingBundle).length > 0 ? timingBundle : undefined,
         error_code: params.errorMessage || (output?.status === 'error' ? output?.error : undefined)
     });