@agntk/core 0.1.0

package/dist/types/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @fileoverview Type exports for @agntk/core
+ */
+export type { AgentOptions, AgentRole, ModelProvider, ToolPreset, StopFunction, StopContext, AskUserHandler, StepFinishCallback, StreamEventCallback, StreamEvent, SubAgentConfig, WorkflowOptions, MemoryOptions, } 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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,YAAY,EACV,YAAY,EACZ,SAAS,EACT,aAAa,EACb,UAAU,EACV,YAAY,EACZ,WAAW,EACX,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,WAAW,EACX,cAAc,EACd,eAAe,EACf,aAAa,GACd,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"}

package/dist/types/index.js

@@ -0,0 +1,6 @@
+/**
+ * @fileoverview Type exports for @agntk/core
+ */
+// Tool lifecycle types
+export { ToolErrorType, ToolError, } from './lifecycle.js';
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

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

package/dist/types/lifecycle.d.ts

@@ -0,0 +1,218 @@
+/**
+ * @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

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

package/dist/types/lifecycle.js

@@ -0,0 +1,99 @@
+/**
+ * @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;
+    constructor(message, type, details) {
+        super(message);
+        this.name = 'ToolError';
+        this.type = type;
+        this.details = details;
+    }
+    /**
+     * Serialize error for tool response.
+     */
+    toJSON() {
+        return {
+            success: false,
+            error: this.message,
+            errorType: this.type,
+            ...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 });
+    }
+}
+//# sourceMappingURL=lifecycle.js.map

package/dist/types/lifecycle.js.map

@@ -0,0 +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"}

package/dist/types/streaming.d.ts

@@ -0,0 +1,120 @@
+/**
+ * @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;
+}
+export interface StepStartData {
+    stepIndex: number;
+}
+export interface StepFinishData {
+    stepIndex: number;
+    durationMs: number;
+}
+export interface TextDeltaData {
+    delta: string;
+    stepIndex: number;
+}
+export interface TextFinishData {
+    text: string;
+    stepIndex: number;
+}
+export interface ReasoningDeltaData {
+    delta: string;
+    stepIndex: number;
+}
+export interface ReasoningFinishData {
+    reasoning: string;
+    durationMs: number;
+    stepIndex: number;
+}
+export interface ToolCallData {
+    toolCallId: string;
+    toolName: string;
+    args: Record<string, unknown>;
+    stepIndex: number;
+}
+export interface ToolResultData {
+    toolCallId: string;
+    toolName: string;
+    result: unknown;
+    durationMs: number;
+    stepIndex: number;
+}
+export interface SourceData {
+    id: string;
+    title: string;
+    url?: string;
+    snippet?: string;
+}
+export interface ErrorData {
+    message: string;
+    code?: string;
+    stepIndex?: number;
+}
+export interface CompleteData {
+    text: string;
+    completed: boolean;
+    needsInput: boolean;
+    pendingQuestion?: string;
+    stepsUsed: number;
+    toolsUsed: string[];
+}
+export type StreamEventDataMap = {
+    'session:start': SessionStartData;
+    'step:start': StepStartData;
+    'step:finish': StepFinishData;
+    'text:delta': TextDeltaData;
+    'text:finish': TextFinishData;
+    'reasoning:delta': ReasoningDeltaData;
+    'reasoning:finish': ReasoningFinishData;
+    'tool:call': ToolCallData;
+    'tool:result': ToolResultData;
+    'sources:add': SourceData;
+    error: ErrorData;
+    complete: CompleteData;
+};
+export interface StreamEvent<T extends StreamEventType = StreamEventType> {
+    type: T;
+    data: StreamEventDataMap[T];
+    timestamp: number;
+}
+export type StreamEventCallback = (event: StreamEvent) => void | Promise<void>;
+export type MessagePartType = 'text' | 'reasoning' | 'tool-call' | 'tool-result' | 'source';
+export interface MessagePart {
+    type: MessagePartType;
+    content: string;
+    metadata?: Record<string, unknown>;
+}
+export interface ToolCallInfo {
+    toolCallId: string;
+    toolName: string;
+    args: Record<string, unknown>;
+    status: 'pending' | 'running' | 'complete' | 'error';
+    result?: unknown;
+    durationMs?: number;
+    stepIndex?: number;
+}
+export interface SourceInfo {
+    id: string;
+    title: string;
+    url?: string;
+    snippet?: string;
+}
+export interface StreamingMessage {
+    id: string;
+    role: 'assistant';
+    parts: MessagePart[];
+    status: 'streaming' | 'complete';
+    stepIndex: number;
+    text: string;
+    reasoning?: {
+        content: string;
+        durationMs?: number;
+    };
+    toolCalls: ToolCallInfo[];
+    sources: SourceInfo[];
+}
+//# sourceMappingURL=streaming.d.ts.map

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

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

package/dist/types/streaming.js

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

package/dist/types/streaming.js.map

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

package/dist/usage-limits.d.ts

@@ -0,0 +1,63 @@
+/**
+ * @agntk/core - Usage Limits
+ *
+ * Token and request caps for agents. Prevents runaway loops from
+ * burning API budget by enforcing maxRequests, maxInputTokens,
+ * maxOutputTokens, and maxTotalTokens.
+ */
+import type { ToolSet, StepResult } from 'ai';
+/** Usage limits for an agent run. All fields are optional — only set limits are enforced. */
+export interface UsageLimits {
+    /** Maximum number of LLM round-trips (steps). */
+    maxRequests?: number;
+    /** Maximum cumulative input tokens across all steps. */
+    maxInputTokens?: number;
+    /** Maximum cumulative output tokens across all steps. */
+    maxOutputTokens?: number;
+    /** Maximum cumulative total tokens (input + output) across all steps. */
+    maxTotalTokens?: number;
+}
+/** Which limit was exceeded. */
+export type UsageLimitType = 'maxRequests' | 'maxInputTokens' | 'maxOutputTokens' | 'maxTotalTokens';
+/** Current usage snapshot at the time a limit was exceeded. */
+export interface UsageSnapshot {
+    requests: number;
+    inputTokens: number;
+    outputTokens: number;
+    totalTokens: number;
+}
+/**
+ * Thrown when an agent exceeds a configured usage limit.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await agent.generate({ prompt: 'do something' });
+ * } catch (error) {
+ *   if (error instanceof UsageLimitExceeded) {
+ *     console.log(`Hit ${error.limitType}: ${error.currentValue}/${error.limitValue}`);
+ *   }
+ * }
+ * ```
+ */
+export declare class UsageLimitExceeded extends Error {
+    readonly name = "UsageLimitExceeded";
+    readonly limitType: UsageLimitType;
+    readonly limitValue: number;
+    readonly currentValue: number;
+    readonly usage: UsageSnapshot;
+    constructor(limitType: UsageLimitType, limitValue: number, currentValue: number, usage: UsageSnapshot);
+}
+/**
+ * Create a StopCondition that checks usage limits after each step.
+ *
+ * Compatible with AI SDK's `stopWhen` array — combine with `stepCountIs()`.
+ *
+ * When a limit is exceeded, the condition throws `UsageLimitExceeded`
+ * rather than returning `true`, because returning `true` would silently
+ * stop the agent. Throwing gives the caller a clear signal with details.
+ */
+export declare function usageLimitStop<TOOLS extends ToolSet>(limits: UsageLimits): (options: {
+    steps: Array<StepResult<TOOLS>>;
+}) => boolean;
+//# sourceMappingURL=usage-limits.d.ts.map

package/dist/usage-limits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-limits.d.ts","sourceRoot":"","sources":["../src/usage-limits.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAM9C,6FAA6F;AAC7F,MAAM,WAAW,WAAW;IAC1B,iDAAiD;IACjD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wDAAwD;IACxD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,yDAAyD;IACzD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,yEAAyE;IACzE,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,gCAAgC;AAChC,MAAM,MAAM,cAAc,GAAG,aAAa,GAAG,gBAAgB,GAAG,iBAAiB,GAAG,gBAAgB,CAAC;AAErG,+DAA+D;AAC/D,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB;AAMD;;;;;;;;;;;;;GAaG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,SAAkB,IAAI,wBAAwB;IAC9C,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAC;IACnC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;gBAG5B,SAAS,EAAE,cAAc,EACzB,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,aAAa;CAUvB;AAMD;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,KAAK,SAAS,OAAO,EAClD,MAAM,EAAE,WAAW,GAClB,CAAC,OAAO,EAAE;IAAE,KAAK,EAAE,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAA;CAAE,KAAK,OAAO,CAsB3D"}

package/dist/usage-limits.js

@@ -0,0 +1,88 @@
+/**
+ * @agntk/core - Usage Limits
+ *
+ * Token and request caps for agents. Prevents runaway loops from
+ * burning API budget by enforcing maxRequests, maxInputTokens,
+ * maxOutputTokens, and maxTotalTokens.
+ */
+// ============================================================================
+// Error
+// ============================================================================
+/**
+ * Thrown when an agent exceeds a configured usage limit.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await agent.generate({ prompt: 'do something' });
+ * } catch (error) {
+ *   if (error instanceof UsageLimitExceeded) {
+ *     console.log(`Hit ${error.limitType}: ${error.currentValue}/${error.limitValue}`);
+ *   }
+ * }
+ * ```
+ */
+export class UsageLimitExceeded extends Error {
+    name = 'UsageLimitExceeded';
+    limitType;
+    limitValue;
+    currentValue;
+    usage;
+    constructor(limitType, limitValue, currentValue, usage) {
+        super(`Usage limit exceeded: ${limitType} = ${currentValue} (limit: ${limitValue})`);
+        this.limitType = limitType;
+        this.limitValue = limitValue;
+        this.currentValue = currentValue;
+        this.usage = usage;
+    }
+}
+// ============================================================================
+// Stop Condition Factory
+// ============================================================================
+/**
+ * Create a StopCondition that checks usage limits after each step.
+ *
+ * Compatible with AI SDK's `stopWhen` array — combine with `stepCountIs()`.
+ *
+ * When a limit is exceeded, the condition throws `UsageLimitExceeded`
+ * rather than returning `true`, because returning `true` would silently
+ * stop the agent. Throwing gives the caller a clear signal with details.
+ */
+export function usageLimitStop(limits) {
+    return ({ steps }) => {
+        const usage = computeUsage(steps);
+        if (limits.maxRequests !== undefined && usage.requests > limits.maxRequests) {
+            throw new UsageLimitExceeded('maxRequests', limits.maxRequests, usage.requests, usage);
+        }
+        if (limits.maxInputTokens !== undefined && usage.inputTokens > limits.maxInputTokens) {
+            throw new UsageLimitExceeded('maxInputTokens', limits.maxInputTokens, usage.inputTokens, usage);
+        }
+        if (limits.maxOutputTokens !== undefined && usage.outputTokens > limits.maxOutputTokens) {
+            throw new UsageLimitExceeded('maxOutputTokens', limits.maxOutputTokens, usage.outputTokens, usage);
+        }
+        if (limits.maxTotalTokens !== undefined && usage.totalTokens > limits.maxTotalTokens) {
+            throw new UsageLimitExceeded('maxTotalTokens', limits.maxTotalTokens, usage.totalTokens, usage);
+        }
+        return false; // Don't stop — limits not reached
+    };
+}
+// ============================================================================
+// Helpers
+// ============================================================================
+function computeUsage(steps) {
+    let inputTokens = 0;
+    let outputTokens = 0;
+    let totalTokens = 0;
+    for (const step of steps) {
+        inputTokens += step.usage?.inputTokens ?? 0;
+        outputTokens += step.usage?.outputTokens ?? 0;
+        totalTokens += step.usage?.totalTokens ?? 0;
+    }
+    return {
+        requests: steps.length,
+        inputTokens,
+        outputTokens,
+        totalTokens,
+    };
+}
+//# sourceMappingURL=usage-limits.js.map

package/dist/usage-limits.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-limits.js","sourceRoot":"","sources":["../src/usage-limits.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA+BH,+EAA+E;AAC/E,QAAQ;AACR,+EAA+E;AAE/E;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IACzB,IAAI,GAAG,oBAAoB,CAAC;IACrC,SAAS,CAAiB;IAC1B,UAAU,CAAS;IACnB,YAAY,CAAS;IACrB,KAAK,CAAgB;IAE9B,YACE,SAAyB,EACzB,UAAkB,EAClB,YAAoB,EACpB,KAAoB;QAEpB,KAAK,CACH,yBAAyB,SAAS,MAAM,YAAY,YAAY,UAAU,GAAG,CAC9E,CAAC;QACF,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QACjC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CACF;AAED,+EAA+E;AAC/E,yBAAyB;AACzB,+EAA+E;AAE/E;;;;;;;;GAQG;AACH,MAAM,UAAU,cAAc,CAC5B,MAAmB;IAEnB,OAAO,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE;QACnB,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;QAElC,IAAI,MAAM,CAAC,WAAW,KAAK,SAAS,IAAI,KAAK,CAAC,QAAQ,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;YAC5E,MAAM,IAAI,kBAAkB,CAAC,aAAa,EAAE,MAAM,CAAC,WAAW,EAAE,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QACzF,CAAC;QAED,IAAI,MAAM,CAAC,cAAc,KAAK,SAAS,IAAI,KAAK,CAAC,WAAW,GAAG,MAAM,CAAC,cAAc,EAAE,CAAC;YACrF,MAAM,IAAI,kBAAkB,CAAC,gBAAgB,EAAE,MAAM,CAAC,cAAc,EAAE,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;QAClG,CAAC;QAED,IAAI,MAAM,CAAC,eAAe,KAAK,SAAS,IAAI,KAAK,CAAC,YAAY,GAAG,MAAM,CAAC,eAAe,EAAE,CAAC;YACxF,MAAM,IAAI,kBAAkB,CAAC,iBAAiB,EAAE,MAAM,CAAC,eAAe,EAAE,KAAK,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;QACrG,CAAC;QAED,IAAI,MAAM,CAAC,cAAc,KAAK,SAAS,IAAI,KAAK,CAAC,WAAW,GAAG,MAAM,CAAC,cAAc,EAAE,CAAC;YACrF,MAAM,IAAI,kBAAkB,CAAC,gBAAgB,EAAE,MAAM,CAAC,cAAc,EAAE,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;QAClG,CAAC;QAED,OAAO,KAAK,CAAC,CAAC,kCAAkC;IAClD,CAAC,CAAC;AACJ,CAAC;AAED,+EAA+E;AAC/E,UAAU;AACV,+EAA+E;AAE/E,SAAS,YAAY,CAAwB,KAA+B;IAC1E,IAAI,WAAW,GAAG,CAAC,CAAC;IACpB,IAAI,YAAY,GAAG,CAAC,CAAC;IACrB,IAAI,WAAW,GAAG,CAAC,CAAC;IAEpB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,WAAW,IAAI,IAAI,CAAC,KAAK,EAAE,WAAW,IAAI,CAAC,CAAC;QAC5C,YAAY,IAAI,IAAI,CAAC,KAAK,EAAE,YAAY,IAAI,CAAC,CAAC;QAC9C,WAAW,IAAI,IAAI,CAAC,KAAK,EAAE,WAAW,IAAI,CAAC,CAAC;IAC9C,CAAC;IAED,OAAO;QACL,QAAQ,EAAE,KAAK,CAAC,MAAM;QACtB,WAAW;QACX,YAAY;QACZ,WAAW;KACZ,CAAC;AACJ,CAAC"}