@agntk/core 0.3.0 → 0.3.1

package/dist/streaming/transient.js.map

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

package/dist/tools/factory.d.ts

@@ -0,0 +1,109 @@
+/**
+ * @agntk/core - Tool Factory
+ *
+ * Factory pattern for creating tool sets with dependency injection.
+ * Adapted from packages/core/src/tools/factory.ts
+ */
+import type { Tool } from 'ai';
+/**
+ * Dependencies that can be injected into tool creators.
+ */
+export interface ToolDependencies {
+    /** Workspace root directory for file operations */
+    workspaceRoot?: string;
+    /** Directories the agent is allowed to access */
+    allowedDirectories?: string[];
+    /** Optional UI stream writer for transient data */
+    streamWriter?: unknown;
+    /** Optional memory store instance */
+    memoryStore?: unknown;
+    /** Custom context data */
+    context?: Record<string, unknown>;
+}
+/**
+ * A set of tools keyed by name.
+ */
+export type ToolSet = Record<string, Tool>;
+/**
+ * Function that creates a set of tools given dependencies.
+ */
+export type ToolCreator = (deps: ToolDependencies) => ToolSet;
+/**
+ * Factory for registering and creating tools with dependency injection.
+ *
+ * @example
+ * ```typescript
+ * const factory = new ToolFactory();
+ *
+ * factory.register('search', (deps) => ({
+ *   glob: createGlobTool({ defaultCwd: deps.workspaceRoot }),
+ *   grep: createGrepTool({ defaultCwd: deps.workspaceRoot }),
+ * }));
+ *
+ * const tools = factory.createAll({ workspaceRoot: '/my/project' });
+ * ```
+ */
+export declare class ToolFactory {
+    private factories;
+    private creationErrors;
+    /**
+     * Register a tool creator function.
+     */
+    register(name: string, creator: ToolCreator): void;
+    /**
+     * Unregister a tool creator.
+     */
+    unregister(name: string): boolean;
+    /**
+     * Check if a tool creator is registered.
+     */
+    has(name: string): boolean;
+    /**
+     * Get all registered tool creator names.
+     */
+    getRegisteredNames(): string[];
+    /**
+     * Create tools from a single registered creator.
+     */
+    create(name: string, deps: ToolDependencies): ToolSet | null;
+    /**
+     * Create all registered tools.
+     */
+    createAll(deps: ToolDependencies): ToolSet;
+    /**
+     * Create selected tools by name.
+     */
+    createSelected(names: string[], deps: ToolDependencies): ToolSet;
+    /**
+     * Get errors from the last creation operation.
+     */
+    getLastErrors(): Array<{
+        name: string;
+        error: string;
+    }>;
+    /**
+     * Clear all registered factories.
+     */
+    clear(): void;
+}
+/**
+ * Default tool factory instance for convenience.
+ */
+export declare const defaultToolFactory: ToolFactory;
+/**
+ * Merge multiple tool sets into one.
+ */
+export declare function mergeToolSets(...toolSets: ToolSet[]): ToolSet;
+/**
+ * Filter a tool set to only include specified tools.
+ */
+export declare function filterTools(tools: ToolSet, include: string[]): ToolSet;
+/**
+ * Exclude specified tools from a tool set.
+ */
+export declare function excludeTools(tools: ToolSet, exclude: string[]): ToolSet;
+/**
+ * Get tool names from a tool set.
+ */
+export declare function getToolNames(tools: ToolSet): string[];
+//# sourceMappingURL=factory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/tools/factory.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAM/B;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,mDAAmD;IACnD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iDAAiD;IACjD,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,mDAAmD;IACnD,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,qCAAqC;IACrC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,0BAA0B;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;AAE3C;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,IAAI,EAAE,gBAAgB,KAAK,OAAO,CAAC;AAM9D;;;;;;;;;;;;;;GAcG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,SAAS,CAAkC;IACnD,OAAO,CAAC,cAAc,CAA8C;IAEpE;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,IAAI;IAIlD;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIjC;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B;;OAEG;IACH,kBAAkB,IAAI,MAAM,EAAE;IAI9B;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,GAAG,OAAO,GAAG,IAAI;IAgB5D;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO;IAoB1C;;OAEG;IACH,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,gBAAgB,GAAG,OAAO;IAuBhE;;OAEG;IACH,aAAa,IAAI,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAIvD;;OAEG;IACH,KAAK,IAAI,IAAI;CAId;AAMD;;GAEG;AACH,eAAO,MAAM,kBAAkB,aAAoB,CAAC;AAMpD;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,CAE7D;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAKtE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAKvE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,EAAE,CAErD"}

package/dist/tools/factory.js

@@ -0,0 +1,166 @@
+/**
+ * @agntk/core - Tool Factory
+ *
+ * Factory pattern for creating tool sets with dependency injection.
+ * Adapted from packages/core/src/tools/factory.ts
+ */
+// ============================================================================
+// Tool Factory Class
+// ============================================================================
+/**
+ * Factory for registering and creating tools with dependency injection.
+ *
+ * @example
+ * ```typescript
+ * const factory = new ToolFactory();
+ *
+ * factory.register('search', (deps) => ({
+ *   glob: createGlobTool({ defaultCwd: deps.workspaceRoot }),
+ *   grep: createGrepTool({ defaultCwd: deps.workspaceRoot }),
+ * }));
+ *
+ * const tools = factory.createAll({ workspaceRoot: '/my/project' });
+ * ```
+ */
+export class ToolFactory {
+    factories = new Map();
+    creationErrors = [];
+    /**
+     * Register a tool creator function.
+     */
+    register(name, creator) {
+        this.factories.set(name, creator);
+    }
+    /**
+     * Unregister a tool creator.
+     */
+    unregister(name) {
+        return this.factories.delete(name);
+    }
+    /**
+     * Check if a tool creator is registered.
+     */
+    has(name) {
+        return this.factories.has(name);
+    }
+    /**
+     * Get all registered tool creator names.
+     */
+    getRegisteredNames() {
+        return Array.from(this.factories.keys());
+    }
+    /**
+     * Create tools from a single registered creator.
+     */
+    create(name, deps) {
+        const creator = this.factories.get(name);
+        if (!creator) {
+            return null;
+        }
+        try {
+            return creator(deps);
+        }
+        catch (error) {
+            this.creationErrors.push({
+                name,
+                error: String(error),
+            });
+            return null;
+        }
+    }
+    /**
+     * Create all registered tools.
+     */
+    createAll(deps) {
+        const allTools = {};
+        this.creationErrors = [];
+        for (const [name, creator] of this.factories.entries()) {
+            try {
+                const tools = creator(deps);
+                Object.assign(allTools, tools);
+            }
+            catch (error) {
+                this.creationErrors.push({
+                    name,
+                    error: String(error),
+                });
+                // Continue creating other tools even if one fails
+            }
+        }
+        return allTools;
+    }
+    /**
+     * Create selected tools by name.
+     */
+    createSelected(names, deps) {
+        const allTools = {};
+        this.creationErrors = [];
+        for (const name of names) {
+            const creator = this.factories.get(name);
+            if (!creator) {
+                continue;
+            }
+            try {
+                const tools = creator(deps);
+                Object.assign(allTools, tools);
+            }
+            catch (error) {
+                this.creationErrors.push({
+                    name,
+                    error: String(error),
+                });
+            }
+        }
+        return allTools;
+    }
+    /**
+     * Get errors from the last creation operation.
+     */
+    getLastErrors() {
+        return [...this.creationErrors];
+    }
+    /**
+     * Clear all registered factories.
+     */
+    clear() {
+        this.factories.clear();
+        this.creationErrors = [];
+    }
+}
+// ============================================================================
+// Default Factory Instance
+// ============================================================================
+/**
+ * Default tool factory instance for convenience.
+ */
+export const defaultToolFactory = new ToolFactory();
+// ============================================================================
+// Helper Functions
+// ============================================================================
+/**
+ * Merge multiple tool sets into one.
+ */
+export function mergeToolSets(...toolSets) {
+    return Object.assign({}, ...toolSets);
+}
+/**
+ * Filter a tool set to only include specified tools.
+ */
+export function filterTools(tools, include) {
+    const includeSet = new Set(include);
+    return Object.fromEntries(Object.entries(tools).filter(([name]) => includeSet.has(name)));
+}
+/**
+ * Exclude specified tools from a tool set.
+ */
+export function excludeTools(tools, exclude) {
+    const excludeSet = new Set(exclude);
+    return Object.fromEntries(Object.entries(tools).filter(([name]) => !excludeSet.has(name)));
+}
+/**
+ * Get tool names from a tool set.
+ */
+export function getToolNames(tools) {
+    return Object.keys(tools);
+}
+//# sourceMappingURL=factory.js.map

package/dist/tools/factory.js.map

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

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":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,WAAW,EAAuC,MAAM,WAAW,CAAC;AAE7E,+EAA+E;AAC/E,kBAAkB;AAClB,+EAA+E;AAE/E;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,IAAI;IACJ,OAAO;IACP,KAAK;IACL,QAAQ;IACR,UAAU;IACV,MAAM;IACN,MAAM;IACN,UAAU;IACV,WAAW;CACH,CAAC;AA2CX;;GAEG;AACH,MAAM,UAAU,2BAA2B;IACzC,MAAM,WAAW,GAAG,IAAI,GAAG,EAAU,CAAC;IACtC,MAAM,cAAc,GAAG,IAAI,GAAG,EAAU,CAAC;IAEzC,OAAO;QACL,WAAW;QACX,cAAc;QAEd,QAAQ,CAAC,IAAY;YACnB,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC9B,OAAO,KAAK,CAAC;YACf,CAAC;YACD,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACtB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,UAAU,CAAC,IAAY;YACrB,OAAO,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAClC,CAAC;QAED,QAAQ,CAAC,IAAY;YACnB,OAAO,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC/B,CAAC;QAED,cAAc;YACZ,OAAO,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACjC,CAAC;QAED,iBAAiB,CAAC,KAAe;YAC/B,cAAc,CAAC,KAAK,EAAE,CAAC;YACvB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;gBACzB,0BAA0B;gBAC1B,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACxB,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC;AAuBD;;GAEG;AACH,MAAM,UAAU,kBAAkB;IAChC,MAAM,OAAO,GAAG,IAAI,GAAG,EAA6B,CAAC;IAErD,OAAO;QACL,OAAO;QAEP,QAAQ,CAAC,KAAwB;YAC/B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACjC,CAAC;QAED,UAAU,CAAC,IAAY;YACrB,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC9B,CAAC;QAED,GAAG,CAAC,IAAY;YACd,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC3B,CAAC;QAED,MAAM,CAAC,KAAa;YAClB,MAAM,UAAU,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;YACvC,OAAO,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CACxC,CAAC,KAAK,EAAE,EAAE,CACR,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC;gBAC7C,KAAK,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC;gBACpD,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CACnE,CAAC;QACJ,CAAC;QAED,cAAc,CAAC,QAAgB;YAC7B,OAAO,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CACxC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,KAAK,QAAQ,CACvC,CAAC;QACJ,CAAC;QAED,OAAO;YACL,OAAO,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QACtC,CAAC;KACF,CAAC;AACJ,CAAC;AAmBD,+EAA+E;AAC/E,uBAAuB;AACvB,+EAA+E;AAE/E;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,MAAM,YAAY,GAAY,EAAE,CAAC;IAEjC,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACjD,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,YAAY,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;YAC1B,SAAS;QACX,CAAC;QAED,MAAM,eAAe,GAAG,IAAI,CAAC,OAAO,CAAC;QACrC,YAAY,CAAC,IAAI,CAAC,GAAG;YACnB,GAAG,IAAI;YACP,OAAO,EAAE,KAAK,EAAE,KAAc,EAAE,OAAgB,EAAE,EAAE;gBAClD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;gBAC7B,IAAI,CAAC;oBACH,MAAM,MAAM,GAAG,MAAM,eAAgB,CAAC,KAAK,EAAE,OAAgB,CAAC,CAAC;oBAC/D,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;oBACxC,OAAO,CAAC,KAAK,CAAC,SAAS,IAAI,kBAAkB,QAAQ,IAAI,CAAC,CAAC;oBAC3D,OAAO,MAAM,CAAC;gBAChB,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;oBACxC,OAAO,CAAC,KAAK,CAAC,SAAS,IAAI,kBAAkB,QAAQ,IAAI,EAAE,KAAK,CAAC,CAAC;oBAClE,MAAM,KAAK,CAAC;gBACd,CAAC;YACH,CAAC;SACM,CAAC;IACZ,CAAC;IAED,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,+EAA+E;AAC/E,mBAAmB;AACnB,+EAA+E;AAE/E;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,SAA6B,EAAE;IAE/B,MAAM,EACJ,aAAa,GAAG,OAAO,CAAC,GAAG,EAAE,EAC7B,kBAAkB,GAAG,CAAC,aAAa,CAAC,EACpC,qBAAqB,GAAG,IAAI,EAC5B,gBAAgB,GAAG,KAAK,EACxB,kBAAkB,GAAG,EAAE,GACxB,GAAG,MAAM,CAAC;IAEX,MAAM,IAAI,GAAqB;QAC7B,aAAa;QACb,kBAAkB;QAClB,OAAO,EAAE,kBAAkB;KAC5B,CAAC;IAEF,MAAM,iBAAiB,GAAG,2BAA2B,EAAE,CAAC;IACxD,MAAM,QAAQ,GAAG,kBAAkB,EAAE,CAAC;IACtC,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;IAElC,4EAA4E;IAC5E,yEAAyE;IACzE,qCAAqC;IACrC,IAAI,KAAK,GAAG,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAEpC,4CAA4C;IAC5C,iBAAiB,CAAC,iBAAiB,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IAExD,mCAAmC;IACnC,IAAI,qBAAqB,EAAE,CAAC;QAC1B,KAAK,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;IACjC,CAAC;IAED,MAAM,OAAO,GAAG,KAAK,IAAI,EAAE;QACzB,6DAA6D;QAC7D,OAAO,CAAC,KAAK,EAAE,CAAC;IAClB,CAAC,CAAC;IAEF,OAAO;QACL,KAAK;QACL,aAAa,EAAE,eAAe;QAC9B,iBAAiB;QACjB,QAAQ;QACR,OAAO;KACR,CAAC;AACJ,CAAC;AAED,+EAA+E;AAC/E,UAAU;AACV,+EAA+E;AAE/E,OAAO,EAAE,WAAW,EAAuC,MAAM,WAAW,CAAC"}

package/dist/types/agent-v2.d.ts

@@ -0,0 +1,83 @@
+/**
+ * @fileoverview V2 Agent types — minimal, zero-config interface.
+ *
+ * An agent is a fully-equipped worker. You give it a name, instructions,
+ * and a prompt. Everything else is auto-detected.
+ */
+import type { LanguageModel, LanguageModelUsage } from 'ai';
+import type { UsageLimits } from '../usage-limits.js';
+/**
+ * Configuration for creating a v2 agent.
+ *
+ * Only `name` is required. Everything else has sensible defaults or
+ * is auto-detected from the environment.
+ */
+export interface AgentOptionsV2 {
+    /**
+     * Display name for this agent.
+     * Used in logs, traces, multi-agent coordination, and persistent state.
+     * Persistent agent state is stored at `~/.agntk/agents/{name}/`.
+     */
+    name: string;
+    /**
+     * What this agent does. Natural language context injected as the system prompt.
+     * This is NOT a role — it's the agent's understanding of its job.
+     */
+    instructions?: string;
+    /**
+     * Where the agent operates. Root for file tools, skill discovery, memory.
+     * Default: process.cwd()
+     */
+    workspaceRoot?: string;
+    /**
+     * Override the auto-selected model.
+     * Most users should never touch this — the agent picks the best
+     * available model from your API keys.
+     */
+    model?: LanguageModel;
+    /**
+     * Safety limit on tool-loop iterations. Default: 25
+     */
+    maxSteps?: number;
+    /**
+     * Token/request caps. Throws UsageLimitExceeded when hit.
+     */
+    usageLimits?: UsageLimits;
+}
+/**
+ * A v2 agent instance. Stream-only — no generate().
+ */
+export interface AgentV2 {
+    /** The agent's name. */
+    readonly name: string;
+    /** Initialize async resources (memory, telemetry). Called automatically by stream(). */
+    init(): Promise<void>;
+    /**
+     * Stream a response. This is the only way to run a v2 agent.
+     * Returns the AI SDK stream result.
+     */
+    stream(input: {
+        prompt: string;
+    }): Promise<AgentV2StreamResult>;
+    /** Get the current system prompt (includes auto-injected context + memory). */
+    getSystemPrompt(): string;
+    /** Get the list of all tool names available to this agent. */
+    getToolNames(): string[];
+}
+/**
+ * Stream result from a v2 agent.
+ * Wraps the AI SDK ToolLoopAgent stream result with additional metadata.
+ */
+export interface AgentV2StreamResult {
+    /** Async iterable of stream chunks (text deltas, tool calls, tool results, etc.) */
+    fullStream: AsyncIterable<{
+        type: string;
+        text?: string;
+        [key: string]: unknown;
+    }>;
+    /** Promise-like that resolves to the final text output. */
+    text: PromiseLike<string>;
+    /** Promise-like that resolves to token usage. */
+    usage: PromiseLike<LanguageModelUsage>;
+}
+//# sourceMappingURL=agent-v2.d.ts.map

package/dist/types/agent-v2.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-v2.d.ts","sourceRoot":"","sources":["../../src/types/agent-v2.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,IAAI,CAAC;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAMnD;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;OAIG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAIvB;;;;OAIG;IACH,KAAK,CAAC,EAAE,aAAa,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B;AAMD;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,wBAAwB;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,wFAAwF;IACxF,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtB;;;OAGG;IACH,MAAM,CAAC,KAAK,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAEhE,+EAA+E;IAC/E,eAAe,IAAI,MAAM,CAAC;IAE1B,8DAA8D;IAC9D,YAAY,IAAI,MAAM,EAAE,CAAC;CAC1B;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,oFAAoF;IACpF,UAAU,EAAE,aAAa,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC,CAAC;IACnF,2DAA2D;IAC3D,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC1B,iDAAiD;IACjD,KAAK,EAAE,WAAW,CAAC,kBAAkB,CAAC,CAAC;CACxC"}