mixdog 0.9.19 → 0.9.20

package/src/rules/lead/02-channels.md

@@ -1,3 +1,3 @@
-# Channels
-
-- Channel features are handled by the runtime.
+# Channels
+
+- Channel features are handled by the runtime.

package/src/runtime/agent/orchestrator/context/collect.mjs

@@ -319,16 +319,34 @@ export function bp1HasDeferredToolManifestBlock(text) {
 }
 
 /**
- * Names-only manifest for tools in the deferred pool (catalog minus active wire tools).
+ * Skill-style manifest for tools in the deferred pool (catalog minus active
+ * wire tools). Each entry is either a bare name string or `{ name, description }`;
+ * output lines are `- name: description` (description omitted when absent),
+ * mirroring the available-skills manifest so the model calls deferred tools
+ * directly. Descriptions are compacted and stripped of `<`/`>`.
  * Empty pool → '' (caller omits the block).
  */
-export function buildDeferredToolManifest(names) {
-    const list = [...new Set((Array.isArray(names) ? names : [])
-        .map((name) => sanitizeDeferredToolManifestName(name))
-        .filter(Boolean))]
-        .sort((a, b) => a.localeCompare(b));
+export function buildDeferredToolManifest(entries) {
+    const list = [];
+    const seen = new Set();
+    for (const entry of Array.isArray(entries) ? entries : []) {
+        const rawName = typeof entry === 'string' ? entry : entry?.name;
+        const name = sanitizeDeferredToolManifestName(rawName);
+        if (!name || seen.has(name)) continue;
+        seen.add(name);
+        const description = typeof entry === 'string'
+            ? ''
+            : compactSkillManifestText(String(entry?.description || '').replace(/[<>]/g, ''));
+        list.push({ name, description });
+    }
     if (!list.length) return '';
-    return ['<available-deferred-tools>', ...list, '</available-deferred-tools>'].join('\n');
+    list.sort((a, b) => a.name.localeCompare(b.name));
+    return [
+        '<available-deferred-tools>',
+        'You may call any tool listed below directly by name with its arguments; it auto-loads on first call.',
+        ...list.map((entry) => (entry.description ? `- ${entry.name}: ${entry.description}` : `- ${entry.name}`)),
+        '</available-deferred-tools>',
+    ].join('\n');
 }
 
 function sanitizeMcpManifestServerName(name) {
@@ -389,12 +407,18 @@ export function stripDeferredToolManifestBlock(text) {
         .trimEnd();
 }
 
-/** Inject names-only deferred pool into BP1 once at session start; never rewrite BP1 after. */
+/** Inject the skill-style deferred pool (name + description) into BP1 once at session start; never rewrite BP1 after. */
 export function applyInitialDeferredToolManifestToBp1(session, poolNames) {
     if (!session || !Array.isArray(session.messages) || session.deferredToolBp1Applied) return false;
     const pool = Array.isArray(poolNames) ? poolNames : [];
+    const descByName = new Map();
+    for (const tool of Array.isArray(session?.deferredToolCatalog) ? session.deferredToolCatalog : []) {
+        const name = String(tool?.name || '').trim();
+        if (name && !descByName.has(name)) descByName.set(name, String(tool?.description || ''));
+    }
+    const entries = pool.map((name) => ({ name, description: descByName.get(String(name).trim()) || '' }));
     const parts = [];
-    const deferredManifest = buildDeferredToolManifest(pool);
+    const deferredManifest = buildDeferredToolManifest(entries);
     if (deferredManifest) parts.push(deferredManifest);
     const mcpManifest = buildMcpInstructionsManifest(session.mcpServerInstructions, pool);
     if (mcpManifest) parts.push(mcpManifest);