@phuetz/code-buddy 0.1.25 → 0.1.26

package/dist/tools/registry/index.d.ts

@@ -19,9 +19,17 @@ export { KubernetesOperationTool, createKubernetesTools, resetKubernetesInstance
 export { GitOperationTool, createGitTools, resetGitInstance, } from './git-tools.js';
 export { BrowserExecuteTool, ReasoningExecuteTool, createMiscTools, resetMiscInstances, } from './misc-tools.js';
 export { ProcessOperationTool, createProcessTools, resetProcessInstance, } from './process-tools.js';
+export { createScriptTools, } from './script-tools.js';
+export { createPlanTools, } from './plan-tools.js';
+export { KnowledgeSearchTool, KnowledgeAddTool, AskHumanExecuteTool, CreateSkillExecuteTool, createKnowledgeTools, } from './knowledge-tools.js';
+export { TodoAttentionTool, RestoreContextTool, createAttentionTools, } from './attention-tools.js';
+export { LessonsAddTool, LessonsSearchTool, LessonsListTool, TaskVerifyTool, createLessonsTools, } from './lessons-tools.js';
+export { createAliasTools, toCanonicalName, toLegacyName, TOOL_ALIASES, CANONICAL_NAME, } from './tool-aliases.js';
 export type { JsonSchema, JsonSchemaProperty, ToolSchema, ToolCategoryType, ITool, IToolMetadata, IValidationResult, ToolExecutorFn, IToolExecutionContext, IToolExecutionResult, IToolRegistrationOptions, IRegisteredTool, IToolQueryOptions, IToolRegistry, IRegistryStats, IToolRegistryEvents, ToolRegistryEventHandler, } from './types.js';
 /**
- * Create all tool instances for registration (async for lazy loading)
+ * Create all tool instances for registration (async for lazy loading).
+ * Also registers canonical-prefix alias tools (shell_*, file_*, browser_*, etc.)
+ * for Codex-style tool naming convention.
  */
 export declare function createAllToolsAsync(): Promise<ITool[]>;
 import type { ITool } from './types.js';

package/dist/tools/registry/index.js

@@ -30,8 +30,22 @@ export { GitOperationTool, createGitTools, resetGitInstance, } from './git-tools
 export { BrowserExecuteTool, ReasoningExecuteTool, createMiscTools, resetMiscInstances, } from './misc-tools.js';
 // Tool Adapters - Process
 export { ProcessOperationTool, createProcessTools, resetProcessInstance, } from './process-tools.js';
+// Tool Adapters - Script
+export { createScriptTools, } from './script-tools.js';
+// Tool Adapters - Plan
+export { createPlanTools, } from './plan-tools.js';
+// Tool Adapters - Knowledge, AskHuman, CreateSkill
+export { KnowledgeSearchTool, KnowledgeAddTool, AskHumanExecuteTool, CreateSkillExecuteTool, createKnowledgeTools, } from './knowledge-tools.js';
+// Tool Adapters - Attention (Todo + RestoreContext)
+export { TodoAttentionTool, RestoreContextTool, createAttentionTools, } from './attention-tools.js';
+// Tool Adapters - Lessons (self-improvement loop + verification contract)
+export { LessonsAddTool, LessonsSearchTool, LessonsListTool, TaskVerifyTool, createLessonsTools, } from './lessons-tools.js';
+// Tool Prefix Naming Convention — Codex-inspired canonical aliases
+export { createAliasTools, toCanonicalName, toLegacyName, TOOL_ALIASES, CANONICAL_NAME, } from './tool-aliases.js';
 /**
- * Create all tool instances for registration (async for lazy loading)
+ * Create all tool instances for registration (async for lazy loading).
+ * Also registers canonical-prefix alias tools (shell_*, file_*, browser_*, etc.)
+ * for Codex-style tool naming convention.
  */
 export async function createAllToolsAsync() {
     const { createTextEditorTools } = await import('./text-editor-tools.js');
@@ -44,7 +58,13 @@ export async function createAllToolsAsync() {
     const { createGitTools } = await import('./git-tools.js');
     const { createMiscTools } = await import('./misc-tools.js');
     const { createProcessTools } = await import('./process-tools.js');
-    return [
+    const { createKnowledgeTools } = await import('./knowledge-tools.js');
+    const { createScriptTools } = await import('./script-tools.js');
+    const { createPlanTools } = await import('./plan-tools.js');
+    const { createAttentionTools } = await import('./attention-tools.js');
+    const { createAliasTools } = await import('./tool-aliases.js');
+    const { createLessonsTools } = await import('./lessons-tools.js');
+    const primaryTools = [
         ...createTextEditorTools(),
         ...createBashTools(),
         ...createSearchTools(),
@@ -55,6 +75,14 @@ export async function createAllToolsAsync() {
         ...createGitTools(),
         ...createMiscTools(),
         ...createProcessTools(),
+        ...createKnowledgeTools(),
+        ...createScriptTools(),
+        ...createPlanTools(),
+        ...createAttentionTools(),
+        ...createLessonsTools(),
     ];
+    // Register backward-compat canonical-prefix aliases (shell_exec, file_read, etc.)
+    const aliasTools = createAliasTools(primaryTools);
+    return [...primaryTools, ...aliasTools];
 }
 //# sourceMappingURL=index.js.map

package/dist/tools/registry/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/registry/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,WAAW;AACX,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAEvG,8BAA8B;AAC9B,OAAO,EACL,YAAY,EACZ,cAAc,EACd,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,wBAAwB,CAAC;AAEhC,uBAAuB;AACvB,OAAO,EACL,eAAe,EACf,eAAe,EACf,iBAAiB,GAClB,MAAM,iBAAiB,CAAC;AAEzB,yBAAyB;AACzB,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,mBAAmB,CAAC;AAE3B,sBAAsB;AACtB,OAAO,EACL,oBAAoB,EACpB,YAAY,EACZ,cAAc,EACd,sBAAsB,GACvB,MAAM,gBAAgB,CAAC;AAExB,uBAAuB;AACvB,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,EACf,iBAAiB,GAClB,MAAM,iBAAiB,CAAC;AAEzB,yBAAyB;AACzB,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,mBAAmB,CAAC;AAE3B,6BAA6B;AAC7B,OAAO,EACL,uBAAuB,EACvB,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,uBAAuB,CAAC;AAE/B,sBAAsB;AACtB,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,gBAAgB,GACjB,MAAM,gBAAgB,CAAC;AAExB,4CAA4C;AAC5C,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,eAAe,EACf,kBAAkB,GACnB,MAAM,iBAAiB,CAAC;AAEzB,0BAA0B;AAC1B,OAAO,EACL,oBAAoB,EACpB,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AA4B5B;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB;IACvC,MAAM,EAAE,qBAAqB,EAAE,GAAG,MAAM,MAAM,CAAC,wBAAwB,CAAC,CAAC;IACzE,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAC;IAC5D,MAAM,EAAE,iBAAiB,EAAE,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC,CAAC;IAChE,MAAM,EAAE,cAAc,EAAE,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,CAAC;IAC1D,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAC;IAC5D,MAAM,EAAE,iBAAiB,EAAE,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC,CAAC;IAChE,MAAM,EAAE,qBAAqB,EAAE,GAAG,MAAM,MAAM,CAAC,uBAAuB,CAAC,CAAC;IACxE,MAAM,EAAE,cAAc,EAAE,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,CAAC;IAC1D,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAC;IAC5D,MAAM,EAAE,kBAAkB,EAAE,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;IAElE,OAAO;QACL,GAAG,qBAAqB,EAAE;QAC1B,GAAG,eAAe,EAAE;QACpB,GAAG,iBAAiB,EAAE;QACtB,GAAG,cAAc,EAAE;QACnB,GAAG,eAAe,EAAE;QACpB,GAAG,iBAAiB,EAAE;QACtB,GAAG,qBAAqB,EAAE;QAC1B,GAAG,cAAc,EAAE;QACnB,GAAG,eAAe,EAAE;QACpB,GAAG,kBAAkB,EAAE;KACxB,CAAC;AACJ,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/registry/index.ts"],"names":[],"mappings":"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"}

package/dist/tools/registry/knowledge-tools.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Knowledge Tool Adapters
+ *
+ * ITool-compliant adapters exposing the KnowledgeManager to the agent:
+ *  - knowledge_search: semantic keyword search across loaded knowledge bases
+ *  - knowledge_add: create a new knowledge entry from within a session
+ */
+import type { ToolResult } from '../../types/index.js';
+import type { ITool, ToolSchema, IToolMetadata, IValidationResult } from './types.js';
+export declare class KnowledgeSearchTool implements ITool {
+    readonly name = "knowledge_search";
+    readonly description = "Search the agent knowledge base for domain knowledge, conventions, or procedures. Returns ranked excerpts from loaded Knowledge.md files.";
+    execute(input: Record<string, unknown>): Promise<ToolResult>;
+    getSchema(): ToolSchema;
+    validate(input: unknown): IValidationResult;
+    getMetadata(): IToolMetadata;
+    isAvailable(): boolean;
+}
+export declare class KnowledgeAddTool implements ITool {
+    readonly name = "knowledge_add";
+    readonly description = "Add a new entry to the user-level knowledge base (~/.codebuddy/knowledge/). Use this to persist learned conventions, procedures, or domain knowledge across sessions.";
+    execute(input: Record<string, unknown>): Promise<ToolResult>;
+    getSchema(): ToolSchema;
+    validate(input: unknown): IValidationResult;
+    getMetadata(): IToolMetadata;
+    isAvailable(): boolean;
+}
+export declare class AskHumanExecuteTool implements ITool {
+    readonly name = "ask_human";
+    readonly description = "Pause execution and ask the user a clarifying question. Use when you need information that cannot be inferred from context, or when multiple interpretations exist. Returns the user's response.";
+    execute(input: Record<string, unknown>): Promise<ToolResult>;
+    getSchema(): ToolSchema;
+    validate(input: unknown): IValidationResult;
+    getMetadata(): IToolMetadata;
+    isAvailable(): boolean;
+}
+export declare class CreateSkillExecuteTool implements ITool {
+    readonly name = "create_skill";
+    readonly description = "Create a new SKILL.md file in the workspace skills directory. Use this to codify reusable workflows or procedures for future sessions. Skills are hot-reloaded immediately.";
+    execute(input: Record<string, unknown>): Promise<ToolResult>;
+    getSchema(): ToolSchema;
+    validate(input: unknown): IValidationResult;
+    getMetadata(): IToolMetadata;
+    isAvailable(): boolean;
+}
+export declare function createKnowledgeTools(): ITool[];

package/dist/tools/registry/knowledge-tools.js

@@ -0,0 +1,293 @@
+/**
+ * Knowledge Tool Adapters
+ *
+ * ITool-compliant adapters exposing the KnowledgeManager to the agent:
+ *  - knowledge_search: semantic keyword search across loaded knowledge bases
+ *  - knowledge_add: create a new knowledge entry from within a session
+ */
+import { getKnowledgeManager } from '../../knowledge/knowledge-manager.js';
+// ============================================================================
+// knowledge_search
+// ============================================================================
+export class KnowledgeSearchTool {
+    name = 'knowledge_search';
+    description = 'Search the agent knowledge base for domain knowledge, conventions, or procedures. Returns ranked excerpts from loaded Knowledge.md files.';
+    async execute(input) {
+        const km = getKnowledgeManager();
+        if (!km.isLoaded) {
+            await km.load();
+        }
+        const query = input.query;
+        const limit = input.limit ?? 5;
+        const scope = input.scope;
+        const results = km.search(query, limit);
+        if (results.length === 0) {
+            // Try to give context about what's loaded
+            const all = km.list();
+            if (all.length === 0) {
+                return {
+                    success: true,
+                    output: 'No knowledge entries loaded. Create a Knowledge.md file in the project root or ~/.codebuddy/knowledge/ to add domain knowledge.',
+                };
+            }
+            return {
+                success: true,
+                output: `No matches found for "${query}". Available knowledge entries: ${all.map(e => e.title).join(', ')}`,
+            };
+        }
+        const lines = [`Found ${results.length} knowledge entries for "${query}":\n`];
+        for (const { entry, score, excerpt } of results) {
+            lines.push(`### ${entry.title} (score: ${score.toFixed(2)}, source: ${entry.source})`);
+            if (entry.tags.length > 0) {
+                lines.push(`Tags: ${entry.tags.join(', ')}`);
+            }
+            lines.push('');
+            lines.push(excerpt);
+            lines.push('');
+        }
+        return { success: true, output: lines.join('\n') };
+    }
+    getSchema() {
+        return {
+            name: this.name,
+            description: this.description,
+            parameters: {
+                type: 'object',
+                properties: {
+                    query: {
+                        type: 'string',
+                        description: 'Keywords or phrase to search for in knowledge bases',
+                    },
+                    limit: {
+                        type: 'number',
+                        description: 'Maximum number of results to return (default: 5)',
+                    },
+                    scope: {
+                        type: 'string',
+                        description: 'Filter by agent mode scope (e.g. "code", "review")',
+                    },
+                },
+                required: ['query'],
+            },
+        };
+    }
+    validate(input) {
+        if (typeof input !== 'object' || input === null) {
+            return { valid: false, errors: ['Input must be an object'] };
+        }
+        const data = input;
+        if (typeof data.query !== 'string' || !data.query.trim()) {
+            return { valid: false, errors: ['query must be a non-empty string'] };
+        }
+        return { valid: true };
+    }
+    getMetadata() {
+        return {
+            name: this.name,
+            description: this.description,
+            category: 'utility',
+            keywords: ['knowledge', 'search', 'conventions', 'docs', 'domain'],
+            priority: 4,
+            requiresConfirmation: false,
+            modifiesFiles: false,
+            makesNetworkRequests: false,
+        };
+    }
+    isAvailable() {
+        return true;
+    }
+}
+// ============================================================================
+// knowledge_add
+// ============================================================================
+export class KnowledgeAddTool {
+    name = 'knowledge_add';
+    description = 'Add a new entry to the user-level knowledge base (~/.codebuddy/knowledge/). Use this to persist learned conventions, procedures, or domain knowledge across sessions.';
+    async execute(input) {
+        const km = getKnowledgeManager();
+        const title = input.title;
+        const content = input.content;
+        const tags = input.tags ?? [];
+        const scope = input.scope ?? [];
+        try {
+            const filePath = await km.add(title, content, tags, scope);
+            return {
+                success: true,
+                output: `Knowledge entry "${title}" saved to ${filePath}`,
+            };
+        }
+        catch (err) {
+            return {
+                success: false,
+                error: `Failed to save knowledge: ${err instanceof Error ? err.message : String(err)}`,
+            };
+        }
+    }
+    getSchema() {
+        return {
+            name: this.name,
+            description: this.description,
+            parameters: {
+                type: 'object',
+                properties: {
+                    title: {
+                        type: 'string',
+                        description: 'Title for this knowledge entry (becomes the filename)',
+                    },
+                    content: {
+                        type: 'string',
+                        description: 'Markdown content of the knowledge entry',
+                    },
+                    tags: {
+                        type: 'array',
+                        items: { type: 'string' },
+                        description: 'Tags for discovery',
+                    },
+                    scope: {
+                        type: 'array',
+                        items: { type: 'string' },
+                        description: 'Agent modes this applies to (e.g. ["code", "review"])',
+                    },
+                },
+                required: ['title', 'content'],
+            },
+        };
+    }
+    validate(input) {
+        if (typeof input !== 'object' || input === null) {
+            return { valid: false, errors: ['Input must be an object'] };
+        }
+        const data = input;
+        if (typeof data.title !== 'string' || !data.title.trim()) {
+            return { valid: false, errors: ['title must be a non-empty string'] };
+        }
+        if (typeof data.content !== 'string' || !data.content.trim()) {
+            return { valid: false, errors: ['content must be a non-empty string'] };
+        }
+        return { valid: true };
+    }
+    getMetadata() {
+        return {
+            name: this.name,
+            description: this.description,
+            category: 'utility',
+            keywords: ['knowledge', 'add', 'save', 'persist', 'conventions'],
+            priority: 3,
+            requiresConfirmation: false,
+            modifiesFiles: true,
+            makesNetworkRequests: false,
+        };
+    }
+    isAvailable() {
+        return true;
+    }
+}
+// ============================================================================
+// AskHuman ITool adapter
+// ============================================================================
+import { getAskHumanTool } from '../ask-human-tool.js';
+export class AskHumanExecuteTool {
+    name = 'ask_human';
+    description = "Pause execution and ask the user a clarifying question. Use when you need information that cannot be inferred from context, or when multiple interpretations exist. Returns the user's response.";
+    async execute(input) {
+        return await getAskHumanTool().execute({
+            question: input.question,
+            options: input.options,
+            timeout: input.timeout,
+            default: input.default,
+        });
+    }
+    getSchema() {
+        return getAskHumanTool().getSchema();
+    }
+    validate(input) {
+        if (typeof input !== 'object' || input === null) {
+            return { valid: false, errors: ['Input must be an object'] };
+        }
+        const data = input;
+        if (typeof data.question !== 'string' || !data.question.trim()) {
+            return { valid: false, errors: ['question must be a non-empty string'] };
+        }
+        return { valid: true };
+    }
+    getMetadata() {
+        return {
+            name: this.name,
+            description: this.description,
+            category: 'utility',
+            keywords: ['ask', 'human', 'input', 'clarify', 'pause', 'question'],
+            priority: 6,
+            requiresConfirmation: false,
+            modifiesFiles: false,
+            makesNetworkRequests: false,
+        };
+    }
+    isAvailable() {
+        return true;
+    }
+}
+// ============================================================================
+// CreateSkill ITool adapter
+// ============================================================================
+import { getCreateSkillTool } from '../create-skill-tool.js';
+export class CreateSkillExecuteTool {
+    name = 'create_skill';
+    description = 'Create a new SKILL.md file in the workspace skills directory. Use this to codify reusable workflows or procedures for future sessions. Skills are hot-reloaded immediately.';
+    async execute(input) {
+        return await getCreateSkillTool().execute({
+            name: input.name,
+            description: input.description,
+            body: input.body,
+            tags: input.tags,
+            env: input.env,
+            requires: input.requires,
+            overwrite: input.overwrite,
+        });
+    }
+    getSchema() {
+        return getCreateSkillTool().getSchema();
+    }
+    validate(input) {
+        if (typeof input !== 'object' || input === null) {
+            return { valid: false, errors: ['Input must be an object'] };
+        }
+        const data = input;
+        if (typeof data.name !== 'string' || !data.name.trim()) {
+            return { valid: false, errors: ['name is required'] };
+        }
+        if (typeof data.description !== 'string' || !data.description.trim()) {
+            return { valid: false, errors: ['description is required'] };
+        }
+        if (typeof data.body !== 'string' || !data.body.trim()) {
+            return { valid: false, errors: ['body is required'] };
+        }
+        return { valid: true };
+    }
+    getMetadata() {
+        return {
+            name: this.name,
+            description: this.description,
+            category: 'utility',
+            keywords: ['skill', 'create', 'write', 'self-author', 'extension', 'workflow'],
+            priority: 3,
+            requiresConfirmation: false,
+            modifiesFiles: true,
+            makesNetworkRequests: false,
+        };
+    }
+    isAvailable() {
+        return true;
+    }
+}
+// ============================================================================
+// Factory
+// ============================================================================
+export function createKnowledgeTools() {
+    return [
+        new KnowledgeSearchTool(),
+        new KnowledgeAddTool(),
+        new AskHumanExecuteTool(),
+        new CreateSkillExecuteTool(),
+    ];
+}
+//# sourceMappingURL=knowledge-tools.js.map

package/dist/tools/registry/knowledge-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-tools.js","sourceRoot":"","sources":["../../../src/tools/registry/knowledge-tools.ts"],"names":[],"mappings":"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"}

package/dist/tools/registry/lessons-tools.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Lessons Tool Adapters
+ *
+ * ITool-compliant adapters for the self-improvement loop:
+ * - LessonsAddTool    (`lessons_add`)    — capture a lesson after a correction
+ * - LessonsSearchTool (`lessons_search`) — find relevant lessons before a task
+ * - LessonsListTool   (`lessons_list`)   — list all lessons (with optional filter)
+ * - TaskVerifyTool    (`task_verify`)    — run tsc/tests/lint verification contract
+ */
+import type { ToolResult } from '../../types/index.js';
+import type { ITool, ToolSchema, IToolMetadata, IValidationResult } from './types.js';
+export declare class LessonsAddTool implements ITool {
+    readonly name = "lessons_add";
+    readonly description: string;
+    execute(input: Record<string, unknown>): Promise<ToolResult>;
+    getSchema(): ToolSchema;
+    validate(input: Record<string, unknown>): IValidationResult;
+    getMetadata(): IToolMetadata;
+    isAvailable(): Promise<boolean>;
+}
+export declare class LessonsSearchTool implements ITool {
+    readonly name = "lessons_search";
+    readonly description: string;
+    execute(input: Record<string, unknown>): Promise<ToolResult>;
+    getSchema(): ToolSchema;
+    validate(input: Record<string, unknown>): IValidationResult;
+    getMetadata(): IToolMetadata;
+    isAvailable(): Promise<boolean>;
+}
+export declare class LessonsListTool implements ITool {
+    readonly name = "lessons_list";
+    readonly description = "List all lessons learned, optionally filtered by category (PATTERN|RULE|CONTEXT|INSIGHT).";
+    execute(input: Record<string, unknown>): Promise<ToolResult>;
+    getSchema(): ToolSchema;
+    validate(_input: Record<string, unknown>): IValidationResult;
+    getMetadata(): IToolMetadata;
+    isAvailable(): Promise<boolean>;
+}
+export declare class TaskVerifyTool implements ITool {
+    readonly name = "task_verify";
+    readonly description: string;
+    execute(input: Record<string, unknown>): Promise<ToolResult>;
+    getSchema(): ToolSchema;
+    validate(_input: Record<string, unknown>): IValidationResult;
+    getMetadata(): IToolMetadata;
+    isAvailable(): Promise<boolean>;
+}
+export declare function createLessonsTools(): ITool[];