@agntk/core 0.3.5 → 1.1.0

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"}

package/dist/types/agent-v2.js

@@ -0,0 +1,8 @@
+/**
+ * @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.
+ */
+export {};
+//# sourceMappingURL=agent-v2.js.map

package/dist/types/agent-v2.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-v2.js","sourceRoot":"","sources":["../../src/types/agent-v2.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/types/agent.d.ts

@@ -1,98 +1,35 @@
-/**
- * @fileoverview Core type definitions for the agent API.
- *
- * The agent is a fully-equipped worker. You give it a name, instructions,
- * and a prompt. Everything else is auto-detected from the environment.
- */
 import type { LanguageModel, LanguageModelUsage, Tool } from 'ai';
 import type { UsageLimits } from '../usage-limits.js';
 import type { ApprovalConfig } from '../tools/approval.js';
-/**
- * Configuration for creating an agent.
- *
- * Only `name` is required. Everything else has sensible defaults or
- * is auto-detected from the environment.
- */
+import type { SubAgentActivityHandler } from '../tools/spawn-agent/index.js';
 export interface AgentOptions {
-    /**
-     * 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;
-    /**
-     * Additional tools to merge with the agent's built-in tools.
-     * Useful for testing with mock tools or adding custom capabilities.
-     */
     tools?: Record<string, Tool>;
-    /**
-     * Enable human-in-the-loop approval for dangerous tools.
-     *
-     * - `true` — use defaults (shell, browser, file_write, file_edit, file_create require approval)
-     * - `ApprovalConfig` — full control over which tools require approval, timeout behaviour, etc.
-     *
-     * @default false (no approval required)
-     */
     approval?: boolean | ApprovalConfig;
+    onSubAgentActivity?: SubAgentActivityHandler;
 }
-/**
- * An agent instance. Stream-only — no generate().
- */
 export interface Agent {
-    /** 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 an agent.
-     * Returns the AI SDK stream result.
-     */
     stream(input: {
         prompt: string;
     }): Promise<AgentStreamResult>;
-    /** 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[];
+    getModelId(): string;
 }
-/**
- * Stream result from an agent.
- * Wraps the AI SDK ToolLoopAgent stream result with additional metadata.
- */
 export interface AgentStreamResult {
-    /** 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.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/types/agent.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAClE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAMxD;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;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;IAE1B;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAE7B;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,OAAO,GAAG,cAAc,CAAC;CACrC;AAMD;;GAEG;AACH,MAAM,WAAW,KAAK;IACpB,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,iBAAiB,CAAC,CAAC;IAE9D,+EAA+E;IAC/E,eAAe,IAAI,MAAM,CAAC;IAE1B,8DAA8D;IAC9D,YAAY,IAAI,MAAM,EAAE,CAAC;CAC1B;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,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"}
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/types/agent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAClE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAEpE,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IAEb,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,KAAK,CAAC,EAAE,aAAa,CAAC;IAEtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,WAAW,CAAC,EAAE,WAAW,CAAC;IAE1B,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAE7B,QAAQ,CAAC,EAAE,OAAO,GAAG,cAAc,CAAC;IAEpC,kBAAkB,CAAC,EAAE,uBAAuB,CAAC;CAC9C;AAED,MAAM,WAAW,KAAK;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtB,MAAM,CAAC,KAAK,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAE9D,eAAe,IAAI,MAAM,CAAC;IAE1B,YAAY,IAAI,MAAM,EAAE,CAAC;IAEzB,UAAU,IAAI,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,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;IAEnF,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAE1B,KAAK,EAAE,WAAW,CAAC,kBAAkB,CAAC,CAAC;CACxC"}

package/dist/types/agent.js

@@ -1,8 +1,2 @@
-/**
- * @fileoverview Core type definitions for the agent API.
- *
- * The agent is a fully-equipped worker. You give it a name, instructions,
- * and a prompt. Everything else is auto-detected from the environment.
- */
 export {};
 //# sourceMappingURL=agent.js.map

package/dist/types/agent.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent.js","sourceRoot":"","sources":["../../src/types/agent.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../../src/types/agent.ts"],"names":[],"mappings":""}

package/dist/types/index.d.ts

@@ -1,7 +1,8 @@
 /**
- * @fileoverview Type exports for @agntk/core
+ * @fileoverview SDK public type definitions.
+ * Exports core types for agents, tools, and lifecycle management.
  */
-export type { AgentOptions, Agent, AgentStreamResult, } from './agent.js';
-export { ToolErrorType, ToolError, } from './lifecycle.js';
+export type { AgentOptions, Agent, AgentStreamResult } from './agent.js';
+export { ToolErrorType, ToolError } from './lifecycle.js';
 export type { ToolLifecycle, ToolContext, ValidationResult, BypassResult, DurabilityConfig, LifecycleToolConfig, ToolExecuteFn, InferToolInput, InferToolOutput, StreamWriter, } from './lifecycle.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,YAAY,EACV,YAAY,EACZ,KAAK,EACL,iBAAiB,GAClB,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,aAAa,EACb,SAAS,GACV,MAAM,aAAa,CAAC;AAErB,YAAY,EACV,aAAa,EACb,WAAW,EACX,gBAAgB,EAChB,YAAY,EACZ,gBAAgB,EAChB,mBAAmB,EACnB,aAAa,EACb,cAAc,EACd,eAAe,EACf,YAAY,GACb,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,YAAY,EAAE,YAAY,EAAE,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEtE,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAEvD,YAAY,EACV,aAAa,EACb,WAAW,EACX,gBAAgB,EAChB,YAAY,EACZ,gBAAgB,EAChB,mBAAmB,EACnB,aAAa,EACb,cAAc,EACd,eAAe,EACf,YAAY,GACb,MAAM,aAAa,CAAC"}

package/dist/types/index.js

@@ -1,6 +1,6 @@
 /**
- * @fileoverview Type exports for @agntk/core
+ * @fileoverview SDK public type definitions.
+ * Exports core types for agents, tools, and lifecycle management.
  */
-// Tool lifecycle types
-export { ToolErrorType, ToolError, } from './lifecycle.js';
+export { ToolErrorType, ToolError } from './lifecycle.js';
 //# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AASH,uBAAuB;AACvB,OAAO,EACL,aAAa,EACb,SAAS,GACV,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC"}

package/dist/types/lifecycle.d.ts

@@ -1,218 +1,77 @@
-/**
- * @fileoverview Tool lifecycle types for hook-based tool execution.
- * Extends patterns from packages/core/src/tools/middleware/lifecycle.ts with
- * new streaming and durability features.
- *
- * Hook execution order:
- * 1. shouldBypass → If returns { bypass: true }, skip execution and return cached result
- * 2. beforeExecute → Transform/enrich input before validation
- * 3. validate → Validate transformed input, throw on failure
- * 4. execute → Core tool logic (with onStream callbacks)
- * 5. afterExecute → Transform output before returning
- * 6. cleanup → Always runs (finally block), regardless of success/failure
- *
- * Error handling:
- * - onError is called if execute or any step before it throws
- * - cleanup always runs
- */
-/**
- * Interface for stream writers that can write typed data parts.
- * Compatible with AI SDK's various stream writer types.
- */
 export interface StreamWriter {
     write(data: unknown): void;
     writeData?(data: unknown): void;
 }
-/**
- * Lifecycle hooks for tool execution.
- * @template TInput - Input parameter type for the tool
- * @template TOutput - Output/return type for the tool
- */
 export interface ToolLifecycle<TInput, TOutput> {
-    /**
-     * Transform input before validation.
-     * Use for normalization, defaults, or enrichment.
-     */
     beforeExecute?: (input: TInput, ctx: ToolContext) => Promise<TInput> | TInput;
-    /**
-     * Validate input after beforeExecute.
-     * Return { valid: false } to reject execution.
-     */
     validate?: (input: TInput, ctx: ToolContext) => Promise<ValidationResult> | ValidationResult;
-    /**
-     * Transform output after successful execution.
-     * Use for formatting, sanitization, or enrichment.
-     */
     afterExecute?: (input: TInput, output: TOutput, ctx: ToolContext) => Promise<TOutput> | TOutput;
-    /**
-     * Handle errors during execution.
-     * Return a fallback value or 'throw' to re-throw.
-     */
     onError?: (error: ToolError, input: TInput, ctx: ToolContext) => Promise<TOutput | 'throw'> | TOutput | 'throw';
-    /**
-     * Cleanup after execution (always called).
-     * Runs in finally block regardless of success/failure.
-     */
     cleanup?: (input: TInput, didSucceed: boolean, ctx: ToolContext) => Promise<void> | void;
-    /**
-     * Stream data during execution for transient display.
-     * Called periodically during long-running operations.
-     */
     onStream?: (data: unknown, ctx: ToolContext) => void;
-    /**
-     * Check if execution can be bypassed (caching, memoization).
-     * Return { bypass: true, result: cachedValue } to skip execution.
-     */
     shouldBypass?: (input: TInput, ctx: ToolContext) => Promise<BypassResult<TOutput>> | BypassResult<TOutput>;
-    /**
-     * Configuration for workflow durability.
-     * When enabled, tool execution is wrapped in a "use step" directive.
-     */
     durability?: DurabilityConfig;
 }
-/**
- * Context passed to lifecycle hooks.
- */
 export interface ToolContext {
-    /** Stream writer for transient data streaming. */
     writer?: StreamWriter;
-    /** Unique identifier for the current agent instance. */
     agentId: string;
-    /** Current step number in the agent execution. */
     stepNumber: number;
-    /** ID of parent agent if this is a sub-agent tool. */
     parentAgentId?: string;
-    /** Workflow run ID for resumable executions. */
     workflowRunId?: string;
-    /** Workspace root directory for path resolution. */
     workspaceRoot?: string;
-    /** Additional metadata passed from agent options. */
     metadata?: Record<string, unknown>;
 }
-/**
- * Result of input validation.
- */
 export interface ValidationResult {
-    /** Whether validation passed. */
     valid: boolean;
-    /** Error message if validation failed. */
     error?: string;
-    /** Error type for categorization. */
     errorType?: ToolErrorType;
 }
-/**
- * Result of bypass check.
- */
 export interface BypassResult<TOutput> {
-    /** Whether to bypass execution. */
     bypass: boolean;
-    /** Cached result to return if bypassing. */
     result?: TOutput;
-    /** Reason for bypass (for logging/debugging). */
     reason?: string;
 }
-/**
- * Configuration for workflow durability.
- */
 export interface DurabilityConfig {
-    /** Enable durable execution for this tool. Default: true */
     enabled: boolean;
-    /**
-     * Whether this tool is independent (can run in parallel with other independent tools).
-     * If true, uses "use step" without blocking.
-     */
     independent: boolean;
-    /** Number of retry attempts on failure. Default: 3 */
     retryCount?: number;
-    /** Timeout for execution. Format: "30s", "5m", "1h". Default: "5m" */
     timeout?: string;
-    /** Custom step name for workflow state. */
     stepName?: string;
 }
-/**
- * Error types for tool execution failures.
- */
 export declare enum ToolErrorType {
-    /** Requested file or directory not found. */
     FILE_NOT_FOUND = "FILE_NOT_FOUND",
-    /** Path is outside allowed workspace. */
     PATH_NOT_IN_WORKSPACE = "PATH_NOT_IN_WORKSPACE",
-    /** Expected directory but found file. */
     PATH_IS_NOT_A_DIRECTORY = "PATH_IS_NOT_A_DIRECTORY",
-    /** Expected file but found directory. */
     PATH_IS_NOT_A_FILE = "PATH_IS_NOT_A_FILE",
-    /** Insufficient permissions. */
     PERMISSION_DENIED = "PERMISSION_DENIED",
-    /** Operation exceeded timeout. */
     TIMEOUT = "TIMEOUT",
-    /** Input validation failed. */
     INVALID_INPUT = "INVALID_INPUT",
-    /** Shell command blocked by security filter. */
     COMMAND_BLOCKED = "COMMAND_BLOCKED",
-    /** Content exceeds size limit. */
     CONTENT_TOO_LARGE = "CONTENT_TOO_LARGE",
-    /** General operation failure. */
     OPERATION_FAILED = "OPERATION_FAILED",
-    /** Network/HTTP request failed. */
     NETWORK_ERROR = "NETWORK_ERROR",
-    /** Rate limit exceeded. */
     RATE_LIMITED = "RATE_LIMITED"
 }
-/**
- * Structured error class for tool failures.
- */
 export declare class ToolError extends Error {
     readonly type: ToolErrorType;
     readonly details?: Record<string, unknown>;
     constructor(message: string, type: ToolErrorType, details?: Record<string, unknown>);
-    /**
-     * Serialize error for tool response.
-     */
     toJSON(): Record<string, unknown>;
-    /**
-     * Create a FILE_NOT_FOUND error.
-     */
     static fileNotFound(path: string): ToolError;
-    /**
-     * Create a PATH_NOT_IN_WORKSPACE error.
-     */
     static pathNotInWorkspace(path: string, workspaceRoot: string): ToolError;
-    /**
-     * Create an INVALID_INPUT error.
-     */
     static invalidInput(message: string, details?: Record<string, unknown>): ToolError;
-    /**
-     * Create a TIMEOUT error.
-     */
     static timeout(operation: string, timeoutMs: number): ToolError;
 }
 import type { z } from 'zod';
-/**
- * Configuration for creating a lifecycle-enabled tool.
- */
 export interface LifecycleToolConfig<TSchema extends z.ZodType, TOutput> {
-    /** Tool name for logging and identification. */
     name: string;
-    /** Description shown to the LLM. */
     description: string;
-    /** Zod schema for input validation. */
     inputSchema: TSchema;
-    /** Lifecycle hooks including the core execute function. */
     lifecycle: ToolLifecycle<z.infer<TSchema>, TOutput> & {
-        /** Core execution logic (required). */
         execute: (input: z.infer<TSchema>, ctx: ToolContext) => Promise<TOutput>;
     };
 }
-/**
- * Type for a tool execute function with context.
- */
 export type ToolExecuteFn<TInput, TOutput> = (input: TInput, ctx: ToolContext) => Promise<TOutput>;
-/**
- * Infer the input type from a LifecycleToolConfig.
- */
 export type InferToolInput<T> = T extends LifecycleToolConfig<infer TSchema, unknown> ? z.infer<TSchema> : never;
-/**
- * Infer the output type from a LifecycleToolConfig.
- */
 export type InferToolOutput<T> = T extends LifecycleToolConfig<z.ZodType, infer TOutput> ? TOutput : never;
 //# sourceMappingURL=lifecycle.d.ts.map

package/dist/types/lifecycle.d.ts.map

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

package/dist/types/lifecycle.js

@@ -1,56 +1,18 @@
-/**
- * @fileoverview Tool lifecycle types for hook-based tool execution.
- * Extends patterns from packages/core/src/tools/middleware/lifecycle.ts with
- * new streaming and durability features.
- *
- * Hook execution order:
- * 1. shouldBypass → If returns { bypass: true }, skip execution and return cached result
- * 2. beforeExecute → Transform/enrich input before validation
- * 3. validate → Validate transformed input, throw on failure
- * 4. execute → Core tool logic (with onStream callbacks)
- * 5. afterExecute → Transform output before returning
- * 6. cleanup → Always runs (finally block), regardless of success/failure
- *
- * Error handling:
- * - onError is called if execute or any step before it throws
- * - cleanup always runs
- */
-// ═══════════════════════════════════════════════════════════════════════════════
-// Error Types
-// ═══════════════════════════════════════════════════════════════════════════════
-/**
- * Error types for tool execution failures.
- */
 export var ToolErrorType;
 (function (ToolErrorType) {
-    /** Requested file or directory not found. */
     ToolErrorType["FILE_NOT_FOUND"] = "FILE_NOT_FOUND";
-    /** Path is outside allowed workspace. */
     ToolErrorType["PATH_NOT_IN_WORKSPACE"] = "PATH_NOT_IN_WORKSPACE";
-    /** Expected directory but found file. */
     ToolErrorType["PATH_IS_NOT_A_DIRECTORY"] = "PATH_IS_NOT_A_DIRECTORY";
-    /** Expected file but found directory. */
     ToolErrorType["PATH_IS_NOT_A_FILE"] = "PATH_IS_NOT_A_FILE";
-    /** Insufficient permissions. */
     ToolErrorType["PERMISSION_DENIED"] = "PERMISSION_DENIED";
-    /** Operation exceeded timeout. */
     ToolErrorType["TIMEOUT"] = "TIMEOUT";
-    /** Input validation failed. */
     ToolErrorType["INVALID_INPUT"] = "INVALID_INPUT";
-    /** Shell command blocked by security filter. */
     ToolErrorType["COMMAND_BLOCKED"] = "COMMAND_BLOCKED";
-    /** Content exceeds size limit. */
     ToolErrorType["CONTENT_TOO_LARGE"] = "CONTENT_TOO_LARGE";
-    /** General operation failure. */
     ToolErrorType["OPERATION_FAILED"] = "OPERATION_FAILED";
-    /** Network/HTTP request failed. */
     ToolErrorType["NETWORK_ERROR"] = "NETWORK_ERROR";
-    /** Rate limit exceeded. */
     ToolErrorType["RATE_LIMITED"] = "RATE_LIMITED";
 })(ToolErrorType || (ToolErrorType = {}));
-/**
- * Structured error class for tool failures.
- */
 export class ToolError extends Error {
     type;
     details;
@@ -60,9 +22,6 @@ export class ToolError extends Error {
         this.type = type;
         this.details = details;
     }
-    /**
-     * Serialize error for tool response.
-     */
     toJSON() {
         return {
             success: false,
@@ -71,29 +30,20 @@ export class ToolError extends Error {
             ...this.details,
         };
     }
-    /**
-     * Create a FILE_NOT_FOUND error.
-     */
     static fileNotFound(path) {
         return new ToolError(`File not found: ${path}`, ToolErrorType.FILE_NOT_FOUND, { path });
     }
-    /**
-     * Create a PATH_NOT_IN_WORKSPACE error.
-     */
     static pathNotInWorkspace(path, workspaceRoot) {
         return new ToolError(`Path is outside workspace: ${path}`, ToolErrorType.PATH_NOT_IN_WORKSPACE, { path, workspaceRoot });
     }
-    /**
-     * Create an INVALID_INPUT error.
-     */
     static invalidInput(message, details) {
         return new ToolError(message, ToolErrorType.INVALID_INPUT, details);
     }
-    /**
-     * Create a TIMEOUT error.
-     */
     static timeout(operation, timeoutMs) {
-        return new ToolError(`Operation timed out: ${operation}`, ToolErrorType.TIMEOUT, { operation, timeoutMs });
+        return new ToolError(`Operation timed out: ${operation}`, ToolErrorType.TIMEOUT, {
+            operation,
+            timeoutMs,
+        });
     }
 }
 //# sourceMappingURL=lifecycle.js.map

package/dist/types/lifecycle.js.map

@@ -1 +1 @@
-{"version":3,"file":"lifecycle.js","sourceRoot":"","sources":["../../src/types/lifecycle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AA0LH,kFAAkF;AAClF,cAAc;AACd,kFAAkF;AAElF;;GAEG;AACH,MAAM,CAAN,IAAY,aAoCX;AApCD,WAAY,aAAa;IACvB,6CAA6C;IAC7C,kDAAiC,CAAA;IAEjC,yCAAyC;IACzC,gEAA+C,CAAA;IAE/C,yCAAyC;IACzC,oEAAmD,CAAA;IAEnD,yCAAyC;IACzC,0DAAyC,CAAA;IAEzC,gCAAgC;IAChC,wDAAuC,CAAA;IAEvC,kCAAkC;IAClC,oCAAmB,CAAA;IAEnB,+BAA+B;IAC/B,gDAA+B,CAAA;IAE/B,gDAAgD;IAChD,oDAAmC,CAAA;IAEnC,kCAAkC;IAClC,wDAAuC,CAAA;IAEvC,iCAAiC;IACjC,sDAAqC,CAAA;IAErC,mCAAmC;IACnC,gDAA+B,CAAA;IAE/B,2BAA2B;IAC3B,8CAA6B,CAAA;AAC/B,CAAC,EApCW,aAAa,KAAb,aAAa,QAoCxB;AAED;;GAEG;AACH,MAAM,OAAO,SAAU,SAAQ,KAAK;IAClB,IAAI,CAAgB;IACpB,OAAO,CAA2B;IAElD,YACE,OAAe,EACf,IAAmB,EACnB,OAAiC;QAEjC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,MAAM;QACJ,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,IAAI,CAAC,OAAO;YACnB,SAAS,EAAE,IAAI,CAAC,IAAI;YACpB,GAAG,IAAI,CAAC,OAAO;SAChB,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,IAAY;QAC9B,OAAO,IAAI,SAAS,CAAC,mBAAmB,IAAI,EAAE,EAAE,aAAa,CAAC,cAAc,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1F,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,kBAAkB,CAAC,IAAY,EAAE,aAAqB;QAC3D,OAAO,IAAI,SAAS,CAClB,8BAA8B,IAAI,EAAE,EACpC,aAAa,CAAC,qBAAqB,EACnC,EAAE,IAAI,EAAE,aAAa,EAAE,CACxB,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,OAAe,EAAE,OAAiC;QACpE,OAAO,IAAI,SAAS,CAAC,OAAO,EAAE,aAAa,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;IACtE,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,SAAiB,EAAE,SAAiB;QACjD,OAAO,IAAI,SAAS,CAClB,wBAAwB,SAAS,EAAE,EACnC,aAAa,CAAC,OAAO,EACrB,EAAE,SAAS,EAAE,SAAS,EAAE,CACzB,CAAC;IACJ,CAAC;CACF"}
+{"version":3,"file":"lifecycle.js","sourceRoot":"","sources":["../../src/types/lifecycle.ts"],"names":[],"mappings":"AA0EA,MAAM,CAAN,IAAY,aAwBX;AAxBD,WAAY,aAAa;IACvB,kDAAiC,CAAA;IAEjC,gEAA+C,CAAA;IAE/C,oEAAmD,CAAA;IAEnD,0DAAyC,CAAA;IAEzC,wDAAuC,CAAA;IAEvC,oCAAmB,CAAA;IAEnB,gDAA+B,CAAA;IAE/B,oDAAmC,CAAA;IAEnC,wDAAuC,CAAA;IAEvC,sDAAqC,CAAA;IAErC,gDAA+B,CAAA;IAE/B,8CAA6B,CAAA;AAC/B,CAAC,EAxBW,aAAa,KAAb,aAAa,QAwBxB;AAED,MAAM,OAAO,SAAU,SAAQ,KAAK;IAClB,IAAI,CAAgB;IACpB,OAAO,CAA2B;IAElD,YAAY,OAAe,EAAE,IAAmB,EAAE,OAAiC;QACjF,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,MAAM;QACJ,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,IAAI,CAAC,OAAO;YACnB,SAAS,EAAE,IAAI,CAAC,IAAI;YACpB,GAAG,IAAI,CAAC,OAAO;SAChB,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,YAAY,CAAC,IAAY;QAC9B,OAAO,IAAI,SAAS,CAAC,mBAAmB,IAAI,EAAE,EAAE,aAAa,CAAC,cAAc,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1F,CAAC;IAED,MAAM,CAAC,kBAAkB,CAAC,IAAY,EAAE,aAAqB;QAC3D,OAAO,IAAI,SAAS,CAClB,8BAA8B,IAAI,EAAE,EACpC,aAAa,CAAC,qBAAqB,EACnC,EAAE,IAAI,EAAE,aAAa,EAAE,CACxB,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,YAAY,CAAC,OAAe,EAAE,OAAiC;QACpE,OAAO,IAAI,SAAS,CAAC,OAAO,EAAE,aAAa,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;IACtE,CAAC;IAED,MAAM,CAAC,OAAO,CAAC,SAAiB,EAAE,SAAiB;QACjD,OAAO,IAAI,SAAS,CAAC,wBAAwB,SAAS,EAAE,EAAE,aAAa,CAAC,OAAO,EAAE;YAC/E,SAAS;YACT,SAAS;SACV,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/types/streaming.d.ts

@@ -1,7 +1,3 @@
-/**
- * @agntk/core - Streaming Types
- * Standalone streaming event types for agent communication
- */
 export type StreamEventType = 'session:start' | 'step:start' | 'step:finish' | 'text:delta' | 'text:finish' | 'reasoning:delta' | 'reasoning:finish' | 'tool:call' | 'tool:result' | 'sources:add' | 'error' | 'complete';
 export interface SessionStartData {
     sessionId: string;

package/dist/types/streaming.d.ts.map

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

package/dist/types/streaming.js

@@ -1,6 +1,2 @@
-/**
- * @agntk/core - Streaming Types
- * Standalone streaming event types for agent communication
- */
 export {};
 //# sourceMappingURL=streaming.js.map

package/dist/types/streaming.js.map

@@ -1 +1 @@
-{"version":3,"file":"streaming.js","sourceRoot":"","sources":["../../src/types/streaming.ts"],"names":[],"mappings":"AAAA;;;GAGG"}
+{"version":3,"file":"streaming.js","sourceRoot":"","sources":["../../src/types/streaming.ts"],"names":[],"mappings":""}