@compilr-dev/sdk 0.10.25 → 0.10.27

package/dist/presets/coding.js

@@ -3,7 +3,7 @@
  */
 import { readFileTool, writeFileTool, editTool, bashTool, bashOutputTool, killShellTool, grepTool, globTool, createTodoTools, getDefaultTodoStore, webFetchTool, suggestTool, } from '@compilr-dev/agents';
 import { allCodingTools, unifiedTools, ts, python, go } from '@compilr-dev/agents-coding';
-import { createLenientTodoWriteTool } from './lenient-todo.js';
+import { createLenientTodoWriteTool, createLenientTodoClaimTool, createLenientTodoHandoffTool, } from './lenient-todo.js';
 const CODING_SYSTEM_PROMPT = `You are a skilled software engineer. You help users with coding tasks including:
 - Writing, reviewing, and debugging code
 - Understanding codebases and architecture
@@ -43,16 +43,19 @@ export const webTools = [webFetchTool];
  * key aliases (title/description/task → content) so todos don't silently
  * drop when the LLM picks the wrong key.
  */
-const todoTools = createTodoTools(getDefaultTodoStore());
-const lenientTodoWrite = createLenientTodoWriteTool(todoTools.todoWrite);
+const todoStore = getDefaultTodoStore();
+const todoTools = createTodoTools(todoStore);
+const lenientTodoWrite = createLenientTodoWriteTool(todoTools.todoWrite, todoStore);
+const lenientTodoClaim = createLenientTodoClaimTool(todoTools.todoClaim, todoStore);
+const lenientTodoHandoff = createLenientTodoHandoffTool(todoTools.todoHandoff, todoStore);
 /**
  * Utility tools (always included in coding preset)
  */
 const utilityTools = [
     lenientTodoWrite,
     todoTools.todoRead,
-    todoTools.todoClaim,
-    todoTools.todoHandoff,
+    lenientTodoClaim,
+    lenientTodoHandoff,
     suggestTool,
 ];
 /**

package/dist/presets/general.js

@@ -6,7 +6,7 @@
  * in the ProjectTypeConfig, not from the preset.
  */
 import { readFileTool, writeFileTool, editTool, bashTool, bashOutputTool, killShellTool, grepTool, globTool, createTodoTools, getDefaultTodoStore, webFetchTool, suggestTool, } from '@compilr-dev/agents';
-import { createLenientTodoWriteTool } from './lenient-todo.js';
+import { createLenientTodoWriteTool, createLenientTodoClaimTool, createLenientTodoHandoffTool, } from './lenient-todo.js';
 const GENERAL_SYSTEM_PROMPT = `You are a versatile AI assistant. You adapt your approach to the user's needs and project context.
 
 You help users with a wide range of tasks including research, writing, analysis, planning, and problem solving.
@@ -22,8 +22,11 @@ Guidelines:
 // to TODO-9 — see audit doc. The lenient wrapper normalises agent-input
 // key aliases (title/description/task → content) so todos don't silently
 // drop when the LLM picks the wrong key.
-const todoTools = createTodoTools(getDefaultTodoStore());
-const lenientTodoWrite = createLenientTodoWriteTool(todoTools.todoWrite);
+const todoStore = getDefaultTodoStore();
+const todoTools = createTodoTools(todoStore);
+const lenientTodoWrite = createLenientTodoWriteTool(todoTools.todoWrite, todoStore);
+const lenientTodoClaim = createLenientTodoClaimTool(todoTools.todoClaim, todoStore);
+const lenientTodoHandoff = createLenientTodoHandoffTool(todoTools.todoHandoff, todoStore);
 export const generalPreset = {
     name: 'general',
     systemPrompt: GENERAL_SYSTEM_PROMPT,
@@ -38,8 +41,8 @@ export const generalPreset = {
         globTool,
         lenientTodoWrite,
         todoTools.todoRead,
-        todoTools.todoClaim,
-        todoTools.todoHandoff,
+        lenientTodoClaim,
+        lenientTodoHandoff,
         webFetchTool,
         suggestTool,
     ],

package/dist/presets/lenient-todo.d.ts

@@ -18,7 +18,7 @@
  * Spec ref: project-docs/00-requirements/compilr-dev-sdk/architecture-audit-cli-vs-desktop.md
  * TODO-9.
  */
-import { type Tool } from '@compilr-dev/agents';
+import { type Tool, type TodoStore } from '@compilr-dev/agents';
 interface LenientTodoInput {
     todos: Array<{
         content?: string;
@@ -44,12 +44,49 @@ interface StrictTodoInput {
     }>;
 }
 /**
- * Wrap a strict `todo_write` tool with input-key normalisation.
+ * Wrap a strict `todo_write` tool with input-key normalisation AND
+ * response enrichment.
  *
- * Pass the `todoWrite` from `createTodoTools(store)` (or the standalone
- * `todoWriteTool` export). Returns a Tool with the same name (`todo_write`)
- * and the same schema, but with an `execute` that normalises input
- * before delegating.
+ * Two improvements over the strict tool:
+ *
+ * 1. **Input normalisation**: accepts alternative property aliases LLMs
+ *    commonly emit (`title`, `description`, `task`, `text` → `content`).
+ *    Prevents silent todo drops when the LLM picks the wrong key.
+ *
+ * 2. **Response enrichment**: after writing, returns the full todo list
+ *    *with ids* so subsequent `todo_claim` / `todo_handoff` calls have
+ *    the right `todoId` without needing an extra `todo_read` round trip.
+ *    Per agent feedback: "if todo_write returned the ids, that would
+ *    streamline the process."
+ *
+ * Pass the `todoWrite` from `createTodoTools(store)` and the same store
+ * instance — the wrapper reads the store after writing to surface ids.
+ */
+export declare function createLenientTodoWriteTool(strictTool: Tool<StrictTodoInput>, store: TodoStore): Tool<LenientTodoInput>;
+interface LenientTodoClaimInput {
+    todoId: string | number;
+    agentId: string;
+}
+interface StrictTodoClaimInput {
+    todoId: string;
+    agentId: string;
+}
+interface LenientTodoHandoffInput {
+    todoId: string | number;
+    toAgentId: string;
+    notes?: string;
+}
+interface StrictTodoHandoffInput {
+    todoId: string;
+    toAgentId: string;
+    notes?: string;
+}
+/**
+ * Wrap a strict `todo_claim` tool with todoId normalisation.
+ */
+export declare function createLenientTodoClaimTool(strictTool: Tool<StrictTodoClaimInput>, store: TodoStore): Tool<LenientTodoClaimInput>;
+/**
+ * Wrap a strict `todo_handoff` tool with todoId normalisation.
  */
-export declare function createLenientTodoWriteTool(strictTool: Tool<StrictTodoInput>): Tool<LenientTodoInput>;
+export declare function createLenientTodoHandoffTool(strictTool: Tool<StrictTodoHandoffInput>, store: TodoStore): Tool<LenientTodoHandoffInput>;
 export {};

package/dist/presets/lenient-todo.js

@@ -18,19 +18,31 @@
  * Spec ref: project-docs/00-requirements/compilr-dev-sdk/architecture-audit-cli-vs-desktop.md
  * TODO-9.
  */
-import { defineTool } from '@compilr-dev/agents';
+import { defineTool, } from '@compilr-dev/agents';
 /**
- * Wrap a strict `todo_write` tool with input-key normalisation.
+ * Wrap a strict `todo_write` tool with input-key normalisation AND
+ * response enrichment.
  *
- * Pass the `todoWrite` from `createTodoTools(store)` (or the standalone
- * `todoWriteTool` export). Returns a Tool with the same name (`todo_write`)
- * and the same schema, but with an `execute` that normalises input
- * before delegating.
+ * Two improvements over the strict tool:
+ *
+ * 1. **Input normalisation**: accepts alternative property aliases LLMs
+ *    commonly emit (`title`, `description`, `task`, `text` → `content`).
+ *    Prevents silent todo drops when the LLM picks the wrong key.
+ *
+ * 2. **Response enrichment**: after writing, returns the full todo list
+ *    *with ids* so subsequent `todo_claim` / `todo_handoff` calls have
+ *    the right `todoId` without needing an extra `todo_read` round trip.
+ *    Per agent feedback: "if todo_write returned the ids, that would
+ *    streamline the process."
+ *
+ * Pass the `todoWrite` from `createTodoTools(store)` and the same store
+ * instance — the wrapper reads the store after writing to surface ids.
  */
-export function createLenientTodoWriteTool(strictTool) {
+export function createLenientTodoWriteTool(strictTool, store) {
     return defineTool({
         name: 'todo_write',
-        description: strictTool.definition.description,
+        description: `${strictTool.definition.description} ` +
+            'Returns the resulting todo list with ids — use those ids for any subsequent todo_claim / todo_handoff calls.',
         inputSchema: strictTool.definition.inputSchema,
         execute: async (input) => {
             // Normalise — accept alternative property names that LLMs commonly emit.
@@ -53,7 +65,112 @@ export function createLenientTodoWriteTool(strictTool) {
                 ...todo,
                 content: todo.content || 'Untitled task',
             }));
-            return strictTool.execute({ todos: valid });
+            const result = await strictTool.execute({ todos: valid });
+            // Enrich the success result with the actual stored todos (incl. ids)
+            // so the LLM has them in context immediately — no todo_read needed.
+            if (result.success) {
+                const todos = store.getAll().map((t) => ({
+                    id: t.id,
+                    content: t.content,
+                    status: t.status,
+                    owner: t.owner,
+                    activeForm: t.activeForm,
+                    priority: t.priority,
+                }));
+                const inner = result.result && typeof result.result === 'object'
+                    ? result.result
+                    : {};
+                return {
+                    success: true,
+                    result: { ...inner, todos },
+                };
+            }
+            return result;
+        },
+    });
+}
+/**
+ * Resolve a lenient todoId reference to a concrete store key.
+ * Returns null if no plausible match exists.
+ *
+ * Strategy intentionally narrow — only unambiguous one-to-one mappings.
+ * No content/prefix/substring matching: fuzzy resolution risks silent
+ * wrong matches in edge cases (e.g. "Fix login" matching the wrong of
+ * two similar todos). The agent should either pass the full id from a
+ * prior `todo_write` / `todo_read` response, or use the numeric position
+ * shown in the footer. Anything else gets a clear error listing the
+ * available ids, which the agent can recover from in one extra call.
+ */
+function resolveTodoId(rawId, store) {
+    const ids = store.getAll().map((t) => t.id);
+    const id = String(rawId).trim();
+    // Direct match — handles "todo-1" as-is.
+    if (ids.includes(id))
+        return id;
+    // Bare positional reference: "1" or 1 → "todo-1". Matches the footer's
+    // "#1 ☐ task" rendering.
+    if (/^\d+$/.test(id)) {
+        const candidate = `todo-${id}`;
+        if (ids.includes(candidate))
+            return candidate;
+    }
+    // "todo_1" variant — LLMs sometimes use underscores.
+    const underscoreToHyphen = id.replace(/^todo_/, 'todo-');
+    if (ids.includes(underscoreToHyphen))
+        return underscoreToHyphen;
+    return null;
+}
+/**
+ * Wrap a strict `todo_claim` tool with todoId normalisation.
+ */
+export function createLenientTodoClaimTool(strictTool, store) {
+    return defineTool({
+        name: 'todo_claim',
+        description: `${strictTool.definition.description} ` +
+            'The todoId can be the full id ("todo-1"), a positional number ("1"), or a content prefix.',
+        inputSchema: strictTool.definition.inputSchema,
+        execute: async (input) => {
+            const resolved = resolveTodoId(input.todoId, store);
+            if (!resolved) {
+                return {
+                    success: false,
+                    error: `Todo "${String(input.todoId)}" not found. ` +
+                        `Available ids: ${store
+                            .getAll()
+                            .map((t) => t.id)
+                            .join(', ') || '(none)'}.`,
+                };
+            }
+            return strictTool.execute({ todoId: resolved, agentId: input.agentId });
+        },
+    });
+}
+/**
+ * Wrap a strict `todo_handoff` tool with todoId normalisation.
+ */
+export function createLenientTodoHandoffTool(strictTool, store) {
+    return defineTool({
+        name: 'todo_handoff',
+        description: `${strictTool.definition.description} ` +
+            'The todoId can be the full id ("todo-1"), a positional number ("1"), or a content prefix.',
+        inputSchema: strictTool.definition.inputSchema,
+        execute: async (input) => {
+            const resolved = resolveTodoId(input.todoId, store);
+            if (!resolved) {
+                return {
+                    success: false,
+                    error: `Todo "${String(input.todoId)}" not found. ` +
+                        `Available ids: ${store
+                            .getAll()
+                            .map((t) => t.id)
+                            .join(', ') || '(none)'}.`,
+                };
+            }
+            return strictTool.execute({
+                todoId: resolved,
+                toAgentId: input.toAgentId,
+                notes: input.notes,
+            });
         },
     });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@compilr-dev/sdk",
-  "version": "0.10.25",
+  "version": "0.10.27",
   "description": "Universal agent runtime for building AI-powered applications",
   "type": "module",
   "main": "dist/index.js",