@compilr-dev/sdk 0.10.23 → 0.10.25

package/dist/index.d.ts

@@ -85,7 +85,7 @@ export { readMCPConfigFile, writeMCPConfigFile, resolveServerEntry, loadMCPServe
 export type { MCPServerEntry, MCPConfigFile, ResolvedMCPServer } from './mcp-config.js';
 export { generateProject, isGitConfigured, generateCompilrMd, generateConfigJson, generateReadmeMd, generateCodingStandardsMd, generatePackageJson, generateTsconfig, generateGitignore, generateCompilrMdForImport, detectProjectInfo, detectGitInfo, prettifyName, getLanguageLabel, getFrameworkLabel, validateImportPath, isValidProjectName, projectExists, TECH_STACK_LABELS, CODING_STANDARDS_LABELS, REPO_PATTERN_LABELS, WORKFLOW_VERSION, } from './project-generator/index.js';
 export type { TechStack, CodingStandards, GeneratorRepoPattern, ProjectConfig, GenerationResult, CompilrConfig, DetectedProject, GitInfo, ImportProjectConfig, } from './project-generator/index.js';
-export { readFileTool, writeFileTool, createBashTool, bashTool, bashOutputTool, killShellTool, grepTool, globTool, editTool, todoWriteTool, todoReadTool, createTodoTools, TodoStore, webFetchTool, suggestTool, } from '@compilr-dev/agents';
+export { readFileTool, writeFileTool, createBashTool, bashTool, bashOutputTool, killShellTool, grepTool, globTool, editTool, todoWriteTool, todoReadTool, createTodoTools, getDefaultTodoStore, TodoStore, webFetchTool, suggestTool, } from '@compilr-dev/agents';
 export { gitStatusTool, gitDiffTool, gitLogTool, gitCommitTool, gitBranchTool, gitStashTool, gitBlameTool, gitFileHistoryTool, detectProjectTool, findProjectRootTool, runTestsTool, runLintTool, runBuildTool, runFormatTool, findDefinitionTool, findReferencesTool, findTodosTool, checkOutdatedTool, findVulnerabilitiesTool, analyzeTestCoverageTool, getFileStructureTool, getComplexityTool, allCodingTools, unifiedTools, } from '@compilr-dev/agents-coding';
 export { createLogger, createSilentLogger } from '@compilr-dev/logger';
 export type { Logger, LoggerOptions, LogLevel } from '@compilr-dev/logger';

package/dist/index.js

@@ -217,7 +217,7 @@ TECH_STACK_LABELS, CODING_STANDARDS_LABELS, REPO_PATTERN_LABELS, WORKFLOW_VERSIO
 // Individual Tool Re-exports (for consumers that build custom tool registries)
 // =============================================================================
 // Base tools from @compilr-dev/agents
-export { readFileTool, writeFileTool, createBashTool, bashTool, bashOutputTool, killShellTool, grepTool, globTool, editTool, todoWriteTool, todoReadTool, createTodoTools, TodoStore, webFetchTool, suggestTool, } from '@compilr-dev/agents';
+export { readFileTool, writeFileTool, createBashTool, bashTool, bashOutputTool, killShellTool, grepTool, globTool, editTool, todoWriteTool, todoReadTool, createTodoTools, getDefaultTodoStore, TodoStore, webFetchTool, suggestTool, } from '@compilr-dev/agents';
 // Coding tools from @compilr-dev/agents-coding
 export { 
 // Git

package/dist/presets/coding.js

@@ -1,8 +1,9 @@
 /**
  * Coding preset — batteries-included for software development
  */
-import { readFileTool, writeFileTool, editTool, bashTool, bashOutputTool, killShellTool, grepTool, globTool, todoWriteTool, todoReadTool, webFetchTool, suggestTool, } from '@compilr-dev/agents';
+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';
 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
@@ -35,10 +36,25 @@ export const shellTools = [bashTool, bashOutputTool, killShellTool];
  * Web tools
  */
 export const webTools = [webFetchTool];
+/**
+ * Build the full todo tool set (write/read/claim/handoff) bound to the
+ * shared `defaultStore`. claim/handoff were missing from this preset prior
+ * 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);
 /**
  * Utility tools (always included in coding preset)
  */
-const utilityTools = [todoWriteTool, todoReadTool, suggestTool];
+const utilityTools = [
+    lenientTodoWrite,
+    todoTools.todoRead,
+    todoTools.todoClaim,
+    todoTools.todoHandoff,
+    suggestTool,
+];
 /**
  * All coding preset tools combined
  */

package/dist/presets/general.js

@@ -5,7 +5,8 @@
  * The project-type-specific identity comes from the systemPromptSection
  * in the ProjectTypeConfig, not from the preset.
  */
-import { readFileTool, writeFileTool, editTool, bashTool, bashOutputTool, killShellTool, grepTool, globTool, todoWriteTool, todoReadTool, webFetchTool, suggestTool, } from '@compilr-dev/agents';
+import { readFileTool, writeFileTool, editTool, bashTool, bashOutputTool, killShellTool, grepTool, globTool, createTodoTools, getDefaultTodoStore, webFetchTool, suggestTool, } from '@compilr-dev/agents';
+import { createLenientTodoWriteTool } 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.
@@ -16,6 +17,13 @@ Guidelines:
 - Follow the project's conventions and style
 - Follow any project-specific guidance provided in the system prompt
 - When uncertain, ask the user for clarification`;
+// Build the full todo tool set (write/read/claim/handoff) bound to the
+// shared defaultStore. claim/handoff were missing from this preset prior
+// 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);
 export const generalPreset = {
     name: 'general',
     systemPrompt: GENERAL_SYSTEM_PROMPT,
@@ -28,8 +36,10 @@ export const generalPreset = {
         killShellTool,
         grepTool,
         globTool,
-        todoWriteTool,
-        todoReadTool,
+        lenientTodoWrite,
+        todoTools.todoRead,
+        todoTools.todoClaim,
+        todoTools.todoHandoff,
         webFetchTool,
         suggestTool,
     ],

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

@@ -0,0 +1,55 @@
+/**
+ * Lenient todo_write wrapper.
+ *
+ * LLMs frequently emit the wrong key for the todo's content field —
+ * `title`, `description`, `task`, or `text` instead of `content`. The
+ * strict builtin tool errors on those, which silently drops the todo
+ * (the LLM rarely retries with the right key — it just moves on). The
+ * lenient wrapper normalises the input before delegating to the strict
+ * tool, so the todo lands in the store regardless of which alias the
+ * LLM picked.
+ *
+ * History: this wrapper originated in `compilr-dev-cli/src/tools.ts:81`
+ * (commit 90c7fd5, 2026-02). It was lost from CLI's runtime when the
+ * SDK migration moved tool registration to the preset (commit af880c7,
+ * 2026-04). Moved to the SDK in commit ?? (TODO-9 fix) so every host
+ * benefits.
+ *
+ * Spec ref: project-docs/00-requirements/compilr-dev-sdk/architecture-audit-cli-vs-desktop.md
+ * TODO-9.
+ */
+import { type Tool } from '@compilr-dev/agents';
+interface LenientTodoInput {
+    todos: Array<{
+        content?: string;
+        title?: string;
+        description?: string;
+        task?: string;
+        text?: string;
+        status: 'pending' | 'in_progress' | 'completed';
+        activeForm?: string;
+        priority?: number;
+        owner?: string;
+        blockedBy?: number[];
+    }>;
+}
+interface StrictTodoInput {
+    todos: Array<{
+        content: string;
+        status: 'pending' | 'in_progress' | 'completed';
+        activeForm?: string;
+        priority?: number;
+        owner?: string;
+        blockedBy?: number[];
+    }>;
+}
+/**
+ * Wrap a strict `todo_write` tool with input-key normalisation.
+ *
+ * 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.
+ */
+export declare function createLenientTodoWriteTool(strictTool: Tool<StrictTodoInput>): Tool<LenientTodoInput>;
+export {};

package/dist/presets/lenient-todo.js

@@ -0,0 +1,59 @@
+/**
+ * Lenient todo_write wrapper.
+ *
+ * LLMs frequently emit the wrong key for the todo's content field —
+ * `title`, `description`, `task`, or `text` instead of `content`. The
+ * strict builtin tool errors on those, which silently drops the todo
+ * (the LLM rarely retries with the right key — it just moves on). The
+ * lenient wrapper normalises the input before delegating to the strict
+ * tool, so the todo lands in the store regardless of which alias the
+ * LLM picked.
+ *
+ * History: this wrapper originated in `compilr-dev-cli/src/tools.ts:81`
+ * (commit 90c7fd5, 2026-02). It was lost from CLI's runtime when the
+ * SDK migration moved tool registration to the preset (commit af880c7,
+ * 2026-04). Moved to the SDK in commit ?? (TODO-9 fix) so every host
+ * benefits.
+ *
+ * Spec ref: project-docs/00-requirements/compilr-dev-sdk/architecture-audit-cli-vs-desktop.md
+ * TODO-9.
+ */
+import { defineTool } from '@compilr-dev/agents';
+/**
+ * Wrap a strict `todo_write` tool with input-key normalisation.
+ *
+ * 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.
+ */
+export function createLenientTodoWriteTool(strictTool) {
+    return defineTool({
+        name: 'todo_write',
+        description: strictTool.definition.description,
+        inputSchema: strictTool.definition.inputSchema,
+        execute: async (input) => {
+            // Normalise — accept alternative property names that LLMs commonly emit.
+            const normalised = input.todos.map((todo) => ({
+                content: (todo.content ||
+                    todo.title ||
+                    todo.description ||
+                    todo.task ||
+                    todo.text ||
+                    '').trim(),
+                status: todo.status,
+                activeForm: todo.activeForm,
+                priority: todo.priority,
+                owner: todo.owner,
+                blockedBy: todo.blockedBy,
+            }));
+            // Last-resort fallback so an empty content doesn't make the
+            // strict tool reject the entire array.
+            const valid = normalised.map((todo) => ({
+                ...todo,
+                content: todo.content || 'Untitled task',
+            }));
+            return strictTool.execute({ todos: valid });
+        },
+    });
+}

package/package.json

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