@agntk/core 0.1.0

package/dist/tools/provider.d.ts

@@ -0,0 +1,97 @@
+/**
+ * @agntk/core - Tool Provider
+ *
+ * Central provider for creating and managing tool sets.
+ * Adapted from packages/core/src/tools/provider.ts
+ */
+import { type ToolSet } from './factory.js';
+/**
+ * Names of core tools that are always available.
+ */
+export declare const CORE_TOOL_NAMES: readonly ["fs", "shell", "web", "memory", "delegate", "task", "plan", "validate", "reasoning"];
+export type CoreToolName = (typeof CORE_TOOL_NAMES)[number];
+export interface ToolProviderConfig {
+    /** Workspace root directory */
+    workspaceRoot?: string;
+    /** Allowed directories for file operations */
+    allowedDirectories?: string[];
+    /** Enable tool execution instrumentation/logging */
+    enableInstrumentation?: boolean;
+    /** Enable dynamic tool activation/deactivation */
+    enableActivation?: boolean;
+    /** Custom tool dependencies */
+    customDependencies?: Record<string, unknown>;
+}
+export interface ToolActivationManager {
+    /** Currently active tool names */
+    activeTools: Set<string>;
+    /** All available tool names */
+    availableTools: Set<string>;
+    /** Activate a tool */
+    activate(name: string): boolean;
+    /** Deactivate a tool */
+    deactivate(name: string): boolean;
+    /** Check if a tool is active */
+    isActive(name: string): boolean;
+    /** Get all active tools */
+    getActiveTools(): string[];
+    /** Set available tools */
+    setAvailableTools(names: string[]): void;
+}
+/**
+ * Create a tool activation manager.
+ */
+export declare function createToolActivationManager(): ToolActivationManager;
+export interface ToolRegistryEntry {
+    name: string;
+    description: string;
+    category: string;
+    tags: string[];
+}
+export interface ToolRegistry {
+    entries: Map<string, ToolRegistryEntry>;
+    register(entry: ToolRegistryEntry): void;
+    unregister(name: string): boolean;
+    get(name: string): ToolRegistryEntry | undefined;
+    search(query: string): ToolRegistryEntry[];
+    listByCategory(category: string): ToolRegistryEntry[];
+    listAll(): ToolRegistryEntry[];
+}
+/**
+ * Create a tool registry for metadata and search.
+ */
+export declare function createToolRegistry(): ToolRegistry;
+export interface ToolProviderResult {
+    /** All created tools */
+    tools: ToolSet;
+    /** Core tool names */
+    coreToolNames: readonly string[];
+    /** Activation manager instance */
+    activationManager: ToolActivationManager;
+    /** Registry instance */
+    registry: ToolRegistry;
+    /** Cleanup function */
+    cleanup: () => Promise<void>;
+}
+/**
+ * Wrap tools with instrumentation for logging and metrics.
+ */
+export declare function instrumentTools(tools: ToolSet): ToolSet;
+/**
+ * Create all tools with the given configuration.
+ *
+ * @example
+ * ```typescript
+ * const { tools, cleanup } = await createAllTools({
+ *   workspaceRoot: process.cwd(),
+ *   enableInstrumentation: true,
+ * });
+ *
+ * // Use tools...
+ *
+ * await cleanup();
+ * ```
+ */
+export declare function createAllTools(config?: ToolProviderConfig): Promise<ToolProviderResult>;
+export { ToolFactory, type ToolDependencies, type ToolSet } from './factory.js';
+//# sourceMappingURL=provider.d.ts.map

package/dist/tools/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../src/tools/provider.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAsC,KAAK,OAAO,EAAE,MAAM,WAAW,CAAC;AAM7E;;GAEG;AACH,eAAO,MAAM,eAAe,gGAUlB,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAM5D,MAAM,WAAW,kBAAkB;IACjC,+BAA+B;IAC/B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,8CAA8C;IAC9C,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,oDAAoD;IACpD,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,kDAAkD;IAClD,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,+BAA+B;IAC/B,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC9C;AAMD,MAAM,WAAW,qBAAqB;IACpC,kCAAkC;IAClC,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACzB,+BAA+B;IAC/B,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAE5B,sBAAsB;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAChC,wBAAwB;IACxB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAClC,gCAAgC;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAChC,2BAA2B;IAC3B,cAAc,IAAI,MAAM,EAAE,CAAC;IAC3B,0BAA0B;IAC1B,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;CAC1C;AAED;;GAEG;AACH,wBAAgB,2BAA2B,IAAI,qBAAqB,CAqCnE;AAMD,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IACxC,QAAQ,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACzC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAClC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAAC;IACjD,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAAC;IAC3C,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAAC;IACtD,OAAO,IAAI,iBAAiB,EAAE,CAAC;CAChC;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,YAAY,CAsCjD;AAMD,MAAM,WAAW,kBAAkB;IACjC,wBAAwB;IACxB,KAAK,EAAE,OAAO,CAAC;IACf,sBAAsB;IACtB,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,kCAAkC;IAClC,iBAAiB,EAAE,qBAAqB,CAAC;IACzC,wBAAwB;IACxB,QAAQ,EAAE,YAAY,CAAC;IACvB,uBAAuB;IACvB,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAMD;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CA6BvD;AAMD;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,cAAc,CAClC,MAAM,GAAE,kBAAuB,GAC9B,OAAO,CAAC,kBAAkB,CAAC,CA4C7B;AAMD,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,KAAK,OAAO,EAAE,MAAM,WAAW,CAAC"}

package/dist/tools/provider.js

@@ -0,0 +1,178 @@
+/**
+ * @agntk/core - Tool Provider
+ *
+ * Central provider for creating and managing tool sets.
+ * Adapted from packages/core/src/tools/provider.ts
+ */
+import { ToolFactory } from './factory.js';
+// ============================================================================
+// Core Tool Names
+// ============================================================================
+/**
+ * Names of core tools that are always available.
+ */
+export const CORE_TOOL_NAMES = [
+    'fs',
+    'shell',
+    'web',
+    'memory',
+    'delegate',
+    'task',
+    'plan',
+    'validate',
+    'reasoning',
+];
+/**
+ * Create a tool activation manager.
+ */
+export function createToolActivationManager() {
+    const activeTools = new Set();
+    const availableTools = new Set();
+    return {
+        activeTools,
+        availableTools,
+        activate(name) {
+            if (!availableTools.has(name)) {
+                return false;
+            }
+            activeTools.add(name);
+            return true;
+        },
+        deactivate(name) {
+            return activeTools.delete(name);
+        },
+        isActive(name) {
+            return activeTools.has(name);
+        },
+        getActiveTools() {
+            return Array.from(activeTools);
+        },
+        setAvailableTools(names) {
+            availableTools.clear();
+            for (const name of names) {
+                availableTools.add(name);
+                // Activate all by default
+                activeTools.add(name);
+            }
+        },
+    };
+}
+/**
+ * Create a tool registry for metadata and search.
+ */
+export function createToolRegistry() {
+    const entries = new Map();
+    return {
+        entries,
+        register(entry) {
+            entries.set(entry.name, entry);
+        },
+        unregister(name) {
+            return entries.delete(name);
+        },
+        get(name) {
+            return entries.get(name);
+        },
+        search(query) {
+            const lowerQuery = query.toLowerCase();
+            return Array.from(entries.values()).filter((entry) => entry.name.toLowerCase().includes(lowerQuery) ||
+                entry.description.toLowerCase().includes(lowerQuery) ||
+                entry.tags.some((tag) => tag.toLowerCase().includes(lowerQuery)));
+        },
+        listByCategory(category) {
+            return Array.from(entries.values()).filter((entry) => entry.category === category);
+        },
+        listAll() {
+            return Array.from(entries.values());
+        },
+    };
+}
+// ============================================================================
+// Tool Instrumentation
+// ============================================================================
+/**
+ * Wrap tools with instrumentation for logging and metrics.
+ */
+export function instrumentTools(tools) {
+    const instrumented = {};
+    for (const [name, tool] of Object.entries(tools)) {
+        if (!tool.execute) {
+            instrumented[name] = tool;
+            continue;
+        }
+        const originalExecute = tool.execute;
+        instrumented[name] = {
+            ...tool,
+            execute: async (input, options) => {
+                const startTime = Date.now();
+                try {
+                    const result = await originalExecute(input, options);
+                    const duration = Date.now() - startTime;
+                    console.debug(`[tool:${name}] completed in ${duration}ms`);
+                    return result;
+                }
+                catch (error) {
+                    const duration = Date.now() - startTime;
+                    console.error(`[tool:${name}] failed after ${duration}ms`, error);
+                    throw error;
+                }
+            },
+        };
+    }
+    return instrumented;
+}
+// ============================================================================
+// Create All Tools
+// ============================================================================
+/**
+ * Create all tools with the given configuration.
+ *
+ * @example
+ * ```typescript
+ * const { tools, cleanup } = await createAllTools({
+ *   workspaceRoot: process.cwd(),
+ *   enableInstrumentation: true,
+ * });
+ *
+ * // Use tools...
+ *
+ * await cleanup();
+ * ```
+ */
+export async function createAllTools(config = {}) {
+    const { workspaceRoot = process.cwd(), allowedDirectories = [workspaceRoot], enableInstrumentation = true, enableActivation = false, customDependencies = {}, } = config;
+    const deps = {
+        workspaceRoot,
+        allowedDirectories,
+        context: customDependencies,
+    };
+    const activationManager = createToolActivationManager();
+    const registry = createToolRegistry();
+    const factory = new ToolFactory();
+    // Note: Individual tool creators will be registered by the tools themselves
+    // when they are imported. For now, return an empty tool set that will be
+    // populated when tools are migrated.
+    let tools = factory.createAll(deps);
+    // Set available tools in activation manager
+    activationManager.setAvailableTools(Object.keys(tools));
+    // Apply instrumentation if enabled
+    if (enableInstrumentation) {
+        tools = instrumentTools(tools);
+    }
+    const cleanup = async () => {
+        // Cleanup logic (close connections, release resources, etc.)
+        factory.clear();
+    };
+    return {
+        tools,
+        coreToolNames: CORE_TOOL_NAMES,
+        activationManager,
+        registry,
+        cleanup,
+    };
+}
+// ============================================================================
+// Exports
+// ============================================================================
+export { ToolFactory } from './factory.js';
+//# sourceMappingURL=provider.js.map

package/dist/tools/provider.js.map

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

package/dist/tools/search-skills.d.ts

@@ -0,0 +1,44 @@
+/**
+ * @agntk/core - Search Skills Tool
+ *
+ * AI SDK tool that allows agents to dynamically search for skills by keyword.
+ * Backed by cached frontmatter metadata with file-change invalidation.
+ */
+import type { SkillMeta } from '../skills/types.js';
+interface SkillCache {
+    skills: SkillMeta[];
+    /** Map of skill path → mtime at load time */
+    mtimes: Map<string, number>;
+    loadedAt: number;
+}
+/**
+ * Clear the skills cache. Useful for testing.
+ */
+export declare function clearSkillsCache(): void;
+/**
+ * Get the current cache for testing inspection.
+ */
+export declare function getSkillsCache(): SkillCache | null;
+export interface SearchSkillsToolConfig {
+    /** Directories to scan for skills. */
+    directories?: string[];
+    /** Base path for resolving relative directories. */
+    basePath?: string;
+    /** Maximum results to return. Default: 5 */
+    maxResults?: number;
+}
+/**
+ * Create a search_skills tool for agent skill discovery.
+ *
+ * The tool searches cached skill metadata by keyword, returning
+ * top matches ranked by relevance. Results include name, description,
+ * tags, and when_to_use for the supervisor LLM to pick from.
+ */
+export declare function createSearchSkillsTool(config?: SearchSkillsToolConfig): {
+    search_skills: import("ai").Tool<{
+        query: string;
+        limit?: number | undefined;
+    }, string>;
+};
+export {};
+//# sourceMappingURL=search-skills.d.ts.map

package/dist/tools/search-skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-skills.d.ts","sourceRoot":"","sources":["../../src/tools/search-skills.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAQjD,UAAU,UAAU;IAClB,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,6CAA6C;IAC7C,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAqDD;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,UAAU,GAAG,IAAI,CAElD;AAMD,MAAM,WAAW,sBAAsB;IACrC,sCAAsC;IACtC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,oDAAoD;IACpD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4CAA4C;IAC5C,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,GAAE,sBAA2B;;;;;EA8DzE"}

package/dist/tools/search-skills.js

@@ -0,0 +1,134 @@
+/**
+ * @agntk/core - Search Skills Tool
+ *
+ * AI SDK tool that allows agents to dynamically search for skills by keyword.
+ * Backed by cached frontmatter metadata with file-change invalidation.
+ */
+import { tool } from 'ai';
+import { z } from 'zod';
+import * as fs from 'node:fs';
+import { createLogger } from '@agntk/logger';
+import { discoverSkills, searchSkills } from '../skills/loader.js';
+const log = createLogger('@agntk/core:search-skills');
+let cache = null;
+/** Maximum age before a full re-scan (5 minutes). */
+const MAX_CACHE_AGE_MS = 5 * 60 * 1000;
+/**
+ * Check if cached skill files have changed on disk.
+ */
+function isCacheStale(c) {
+    // Time-based expiry
+    if (Date.now() - c.loadedAt > MAX_CACHE_AGE_MS)
+        return true;
+    // Check mtimes of known files
+    for (const [filePath, cachedMtime] of c.mtimes) {
+        try {
+            const stat = fs.statSync(filePath);
+            if (stat.mtimeMs !== cachedMtime)
+                return true;
+        }
+        catch (_e) {
+            // File deleted → stale
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * Get skills from cache or re-scan from disk.
+ */
+function getCachedSkills(directories, basePath) {
+    if (cache && !isCacheStale(cache)) {
+        return cache.skills;
+    }
+    log.debug('Refreshing skills cache');
+    const skills = discoverSkills(directories, basePath);
+    const mtimes = new Map();
+    for (const skill of skills) {
+        try {
+            const stat = fs.statSync(skill.path);
+            mtimes.set(skill.path, stat.mtimeMs);
+        }
+        catch (_e) {
+            // Skip if stat fails
+        }
+    }
+    cache = { skills, mtimes, loadedAt: Date.now() };
+    return skills;
+}
+/**
+ * Clear the skills cache. Useful for testing.
+ */
+export function clearSkillsCache() {
+    cache = null;
+}
+/**
+ * Get the current cache for testing inspection.
+ */
+export function getSkillsCache() {
+    return cache;
+}
+/**
+ * Create a search_skills tool for agent skill discovery.
+ *
+ * The tool searches cached skill metadata by keyword, returning
+ * top matches ranked by relevance. Results include name, description,
+ * tags, and when_to_use for the supervisor LLM to pick from.
+ */
+export function createSearchSkillsTool(config = {}) {
+    const { directories, basePath, maxResults = 5 } = config;
+    return {
+        search_skills: tool({
+            description: 'Search for available skills by keyword. Returns ranked matches ' +
+                'with name, description, tags, and when_to_use guidance. ' +
+                'Use this to find the right skill for a subtask.',
+            inputSchema: z.object({
+                query: z.string().describe('Search keywords (e.g. "deploy docker", "code review")'),
+                limit: z
+                    .number()
+                    .min(1)
+                    .max(10)
+                    .optional()
+                    .describe('Maximum results to return. Default: 5'),
+            }),
+            execute: async ({ query, limit }) => {
+                const effectiveLimit = limit ?? maxResults;
+                try {
+                    const skills = getCachedSkills(directories, basePath);
+                    if (skills.length === 0) {
+                        return JSON.stringify({
+                            success: true,
+                            count: 0,
+                            results: [],
+                            message: 'No skills found. Add SKILL.md files to your skills directory.',
+                        });
+                    }
+                    const matches = searchSkills(skills, query, effectiveLimit);
+                    const results = matches.map((m) => ({
+                        name: m.skill.name,
+                        description: m.skill.description,
+                        tags: m.skill.tags ?? [],
+                        whenToUse: m.skill.whenToUse ?? '',
+                        model: m.skill.model,
+                        score: Math.round(m.score * 100) / 100,
+                    }));
+                    log.debug('Skills search', { query, found: results.length, total: skills.length });
+                    return JSON.stringify({
+                        success: true,
+                        count: results.length,
+                        totalSkills: skills.length,
+                        results,
+                    });
+                }
+                catch (error) {
+                    log.error('Skills search failed', { query, error: String(error) });
+                    return JSON.stringify({
+                        success: false,
+                        error: `Search failed: ${error instanceof Error ? error.message : String(error)}`,
+                    });
+                }
+            },
+        }),
+    };
+}
+//# sourceMappingURL=search-skills.js.map

package/dist/tools/search-skills.js.map

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

package/dist/tools/shell/background.d.ts

@@ -0,0 +1,38 @@
+/**
+ * @agntk/core - Background Process Management Tool
+ *
+ * Manages long-running background processes with session tracking.
+ * Ported from @agntk/brain shell to consolidate shell tools.
+ */
+import { type ChildProcess } from 'node:child_process';
+export interface BackgroundSession {
+    id: string;
+    command: string;
+    process: ChildProcess;
+    stdout: string;
+    stderr: string;
+    startedAt: number;
+    status: 'running' | 'completed' | 'failed' | 'stopped';
+    exitCode?: number;
+    cwd?: string;
+}
+/** Get all sessions (for testing). */
+export declare function getBackgroundSessions(): Map<string, BackgroundSession>;
+/** Clear all sessions (for testing). */
+export declare function clearBackgroundSessions(): void;
+/**
+ * Create a background process management tool.
+ *
+ * @example
+ * ```typescript
+ * const tools = { shell: createShellTool('/my/project'), background: createBackgroundTool() };
+ * ```
+ */
+export declare function createBackgroundTool(): import("ai").Tool<{
+    operation: "status" | "output" | "start" | "stop" | "list";
+    cwd?: string | undefined;
+    env?: Record<string, string> | undefined;
+    command?: string | undefined;
+    sessionId?: string | undefined;
+}, string>;
+//# sourceMappingURL=background.d.ts.map

package/dist/tools/shell/background.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"background.d.ts","sourceRoot":"","sources":["../../../src/tools/shell/background.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAS,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAQ9D,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,YAAY,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;IACvD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAeD,sCAAsC;AACtC,wBAAgB,qBAAqB,IAAI,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAEtE;AAED,wCAAwC;AACxC,wBAAgB,uBAAuB,IAAI,IAAI,CAO9C;AAuED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB;;;;;;WAoInC"}