@lleverage-ai/agent-sdk 0.0.1

package/dist/hooks.js

@@ -0,0 +1,352 @@
+/**
+ * Hook system for observing agent lifecycle events.
+ *
+ * @packageDocumentation
+ */
+// =============================================================================
+// Unified Hook System with Matchers
+// =============================================================================
+/**
+ * Checks if a tool name matches a HookMatcher pattern.
+ *
+ * @param toolName - The tool name to test
+ * @param matcher - The matcher pattern (undefined matches all)
+ * @returns true if the tool name matches the pattern
+ *
+ * @internal
+ */
+export function matchesToolName(toolName, matcher) {
+    if (matcher === undefined) {
+        return true; // No matcher = match all tools
+    }
+    try {
+        const regex = new RegExp(matcher);
+        return regex.test(toolName);
+    }
+    catch (_error) {
+        // Invalid regex - treat as literal string match
+        return toolName === matcher;
+    }
+}
+/**
+ * Error thrown when a hook times out.
+ *
+ * @category Hooks
+ */
+export class HookTimeoutError extends Error {
+    constructor(timeout) {
+        super(`Hook execution timed out after ${timeout}ms`);
+        this.name = "HookTimeoutError";
+    }
+}
+/**
+ * Invokes hook callbacks with timeout support.
+ *
+ * This function enforces a hard timeout using `Promise.race`. If a hook does not complete
+ * within the specified timeout, it will be treated as returning an empty result `{}`.
+ * The abort signal is also set when the timeout is reached, allowing cooperative hooks
+ * to clean up resources.
+ *
+ * @param hooks - Array of hook callbacks to invoke
+ * @param input - The hook input data
+ * @param toolUseId - The tool use ID (null for non-tool hooks)
+ * @param agent - The agent instance
+ * @param timeout - Timeout in milliseconds (default: 60000). Each hook must complete within this time.
+ * @param retryAttempt - Current retry attempt number (default: 0)
+ * @returns Array of hook outputs. Timed out hooks return empty objects `{}`.
+ *
+ * @example
+ * ```typescript
+ * // Hook that respects the abort signal for cooperative cancellation
+ * const cooperativeHook: HookCallback = async (input, toolUseId, ctx) => {
+ *   for (const item of items) {
+ *     if (ctx.signal.aborted) {
+ *       return {}; // Early exit on abort
+ *     }
+ *     await processItem(item);
+ *   }
+ *   return { hookSpecificOutput: { ... } };
+ * };
+ *
+ * // Even if a hook doesn't check the signal, it will be timed out
+ * const results = await invokeHooksWithTimeout(
+ *   [cooperativeHook, slowHook],
+ *   input,
+ *   toolUseId,
+ *   agent,
+ *   5000 // 5 second timeout
+ * );
+ * ```
+ *
+ * @internal
+ */
+export async function invokeHooksWithTimeout(hooks, input, toolUseId, agent, timeout = 60000, retryAttempt = 0) {
+    const abortController = new AbortController();
+    const timeoutId = setTimeout(() => abortController.abort(), timeout);
+    try {
+        const context = {
+            signal: abortController.signal,
+            agent,
+            retryAttempt,
+        };
+        const results = await Promise.all(hooks.map(async (hook) => {
+            try {
+                // Create a timeout promise that rejects after the specified time
+                const timeoutPromise = new Promise((_, reject) => {
+                    const hookTimeoutId = setTimeout(() => {
+                        reject(new HookTimeoutError(timeout));
+                    }, timeout);
+                    // Clean up timeout if signal is aborted (parent timeout reached)
+                    abortController.signal.addEventListener("abort", () => {
+                        clearTimeout(hookTimeoutId);
+                        reject(new HookTimeoutError(timeout));
+                    });
+                });
+                // Race between hook execution and timeout
+                const result = await Promise.race([hook(input, toolUseId, context), timeoutPromise]);
+                return result;
+            }
+            catch (error) {
+                // If hook throws or times out, treat as allowing with no modifications
+                if (error instanceof HookTimeoutError) {
+                    console.error(`Hook timed out after ${timeout}ms`);
+                }
+                else {
+                    console.error("Hook execution error:", error);
+                }
+                return {};
+            }
+        }));
+        return results;
+    }
+    finally {
+        clearTimeout(timeoutId);
+    }
+}
+/**
+ * Filters and invokes matching hooks for a tool use event.
+ *
+ * @param matchers - Array of HookMatcher configurations
+ * @param toolName - The name of the tool being used
+ * @param input - The hook input data
+ * @param toolUseId - The tool use ID
+ * @param agent - The agent instance
+ * @returns Array of hook outputs from all matching hooks
+ *
+ * @example
+ * ```typescript
+ * const matchers: HookMatcher[] = [
+ *   { matcher: 'Write|Edit', hooks: [protectFiles], timeout: 30000 },
+ *   { hooks: [auditLogger] }  // Matches all tools
+ * ];
+ *
+ * const outputs = await invokeMatchingHooks(
+ *   matchers,
+ *   'Write',
+ *   input,
+ *   toolUseId,
+ *   agent
+ * );
+ * ```
+ *
+ * @category Hooks
+ */
+export async function invokeMatchingHooks(matchers, toolName, input, toolUseId, agent) {
+    const allOutputs = [];
+    for (const matcher of matchers) {
+        if (matchesToolName(toolName, matcher.matcher)) {
+            const timeout = matcher.timeout ?? 60000;
+            const outputs = await invokeHooksWithTimeout(matcher.hooks, input, toolUseId, agent, timeout);
+            allOutputs.push(...outputs);
+        }
+    }
+    return allOutputs;
+}
+/**
+ * Aggregates permission decisions from multiple hook outputs.
+ *
+ * Follows the hierarchy: deny > ask > allow > default
+ *
+ * @param hookOutputs - Array of hook outputs to aggregate
+ * @param defaultDecision - Default decision if no hooks provide one (default: 'allow')
+ * @returns The aggregated permission decision
+ *
+ * @example
+ * ```typescript
+ * const outputs: HookOutput[] = [
+ *   { hookSpecificOutput: { hookEventName: 'PreToolUse', permissionDecision: 'allow' } },
+ *   { hookSpecificOutput: { hookEventName: 'PreToolUse', permissionDecision: 'deny' } },
+ * ];
+ *
+ * const decision = aggregatePermissionDecisions(outputs);
+ * // Returns 'deny' because deny wins over allow
+ * ```
+ *
+ * @category Hooks
+ */
+export function aggregatePermissionDecisions(hookOutputs, defaultDecision = "allow") {
+    let hasDeny = false;
+    let hasAsk = false;
+    let hasAllow = false;
+    for (const output of hookOutputs) {
+        const decision = output.hookSpecificOutput?.permissionDecision;
+        if (decision === "deny") {
+            hasDeny = true;
+        }
+        else if (decision === "ask") {
+            hasAsk = true;
+        }
+        else if (decision === "allow") {
+            hasAllow = true;
+        }
+    }
+    // Priority: deny > ask > allow > default
+    if (hasDeny)
+        return "deny";
+    if (hasAsk)
+        return "ask";
+    if (hasAllow)
+        return "allow";
+    return defaultDecision;
+}
+/**
+ * Extracts a cached/mock result from hook outputs for short-circuit execution.
+ *
+ * Returns the first non-undefined `respondWith` value found in the hook outputs.
+ * This enables cache hooks to return cached results without executing the actual operation.
+ *
+ * @param hookOutputs - Array of hook outputs to scan
+ * @returns The cached result if found, undefined otherwise
+ *
+ * @example
+ * ```typescript
+ * const outputs: HookOutput[] = [
+ *   { hookSpecificOutput: { hookEventName: 'PreGenerate' } },
+ *   { hookSpecificOutput: { hookEventName: 'PreGenerate', respondWith: cachedResult } },
+ * ];
+ *
+ * const result = extractRespondWith(outputs);
+ * // Returns cachedResult
+ * ```
+ *
+ * @category Hooks
+ */
+export function extractRespondWith(hookOutputs) {
+    for (const output of hookOutputs) {
+        const respondWith = output.hookSpecificOutput?.respondWith;
+        if (respondWith !== undefined) {
+            return respondWith;
+        }
+    }
+    return undefined;
+}
+/**
+ * Extracts transformed input from hook outputs.
+ *
+ * Returns the first non-undefined `updatedInput` value found in the hook outputs.
+ * This enables hooks to modify inputs before they are used (e.g., redirect file paths,
+ * add rate limit headers, sanitize user input).
+ *
+ * @param hookOutputs - Array of hook outputs to scan
+ * @returns The transformed input if found, undefined otherwise
+ *
+ * @example
+ * ```typescript
+ * const outputs: HookOutput[] = [
+ *   { hookSpecificOutput: { hookEventName: 'PreToolUse' } },
+ *   { hookSpecificOutput: {
+ *       hookEventName: 'PreToolUse',
+ *       updatedInput: { file_path: '/sandbox/file.txt' }
+ *     }
+ *   },
+ * ];
+ *
+ * const transformed = extractUpdatedInput(outputs);
+ * // Returns { file_path: '/sandbox/file.txt' }
+ * ```
+ *
+ * @category Hooks
+ */
+export function extractUpdatedInput(hookOutputs) {
+    for (const output of hookOutputs) {
+        const updatedInput = output.hookSpecificOutput?.updatedInput;
+        if (updatedInput !== undefined) {
+            return updatedInput;
+        }
+    }
+    return undefined;
+}
+/**
+ * Extracts transformed result from hook outputs.
+ *
+ * Returns the first non-undefined `updatedResult` value found in the hook outputs.
+ * This enables hooks to modify outputs after execution (e.g., filter sensitive data,
+ * add metadata, transform format, apply post-processing).
+ *
+ * @param hookOutputs - Array of hook outputs to scan
+ * @returns The transformed result if found, undefined otherwise
+ *
+ * @example
+ * ```typescript
+ * const outputs: HookOutput[] = [
+ *   { hookSpecificOutput: { hookEventName: 'PostGenerate' } },
+ *   { hookSpecificOutput: {
+ *       hookEventName: 'PostGenerate',
+ *       updatedResult: { ...originalResult, filtered: true }
+ *     }
+ *   },
+ * ];
+ *
+ * const transformed = extractUpdatedResult(outputs);
+ * // Returns { ...originalResult, filtered: true }
+ * ```
+ *
+ * @category Hooks
+ */
+export function extractUpdatedResult(hookOutputs) {
+    for (const output of hookOutputs) {
+        const updatedResult = output.hookSpecificOutput?.updatedResult;
+        if (updatedResult !== undefined) {
+            return updatedResult;
+        }
+    }
+    return undefined;
+}
+/**
+ * Extracts retry decision from PostGenerateFailure or PostToolUseFailure hook outputs.
+ *
+ * Returns the first retry decision found in the hook outputs. If any hook requests a retry,
+ * the operation will be retried after the specified delay (or 0ms if no delay specified).
+ *
+ * @param hookOutputs - Array of hook outputs to scan
+ * @returns Object with retry flag and delay, or undefined if no retry requested
+ *
+ * @example
+ * ```typescript
+ * const outputs: HookOutput[] = [
+ *   { hookSpecificOutput: { hookEventName: 'PostGenerateFailure' } },
+ *   { hookSpecificOutput: {
+ *       hookEventName: 'PostGenerateFailure',
+ *       retry: true,
+ *       retryDelayMs: 1000  // Wait 1s before retrying
+ *     }
+ *   },
+ * ];
+ *
+ * const retryDecision = extractRetryDecision(outputs);
+ * // Returns { retry: true, retryDelayMs: 1000 }
+ * ```
+ *
+ * @category Hooks
+ */
+export function extractRetryDecision(hookOutputs) {
+    for (const output of hookOutputs) {
+        const retry = output.hookSpecificOutput?.retry;
+        if (retry === true) {
+            const retryDelayMs = output.hookSpecificOutput?.retryDelayMs ?? 0;
+            return { retry: true, retryDelayMs };
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=hooks.js.map

package/dist/hooks.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,97 @@
+/**
+ * @lleverage-ai/agent-sdk - A TypeScript framework for building AI agents.
+ *
+ * Built on top of Vercel AI SDK, this library provides a comprehensive toolkit
+ * for creating intelligent agents that can use tools, respond to hooks, and
+ * delegate tasks to specialized subagents.
+ *
+ * ## Quick Start
+ *
+ * ```typescript
+ * import { createAgent } from "@lleverage-ai/agent-sdk";
+ * import { anthropic } from "@ai-sdk/anthropic";
+ * import { tool } from "ai";
+ * import { z } from "zod";
+ *
+ * // Create an agent with tools
+ * const agent = createAgent({
+ *   model: anthropic("claude-sonnet-4-20250514"),
+ *   systemPrompt: "You are a friendly assistant.",
+ *   tools: {
+ *     greet: tool({
+ *       description: "Greet a person by name",
+ *       inputSchema: z.object({ name: z.string() }),
+ *       execute: async ({ name }) => `Hello, ${name}!`,
+ *     }),
+ *   },
+ * });
+ *
+ * // Generate a response
+ * const result = await agent.generate({
+ *   prompt: "Say hello to Alice",
+ * });
+ *
+ * // Or use with Next.js API routes and useChat
+ * export async function POST(req: Request) {
+ *   const { messages } = await req.json();
+ *   return agent.streamResponse({ messages });
+ * }
+ * ```
+ *
+ * ## Key Concepts
+ *
+ * - **Agents** - The main abstraction combining a model with tools and plugins
+ * - **Tools** - Use AI SDK's `tool()` function directly for full compatibility
+ * - **Plugins** - Bundles of tools, skills, and hooks for reusability
+ * - **Skills** - User-invocable slash commands
+ * - **Hooks** - Lifecycle event handlers for observing agent behavior
+ * - **Subagents** - Specialized agents for task delegation
+ *
+ * ## AI SDK Compatibility
+ *
+ * This SDK is built on Vercel AI SDK and maintains full compatibility:
+ * - Use `tool()` from 'ai' to define tools
+ * - Use `CoreMessage` and `UIMessage` types directly
+ * - `streamResponse()` returns a Response compatible with `useChat`
+ * - `streamRaw()` returns the raw AI SDK `streamText` result
+ *
+ * @packageDocumentation
+ */
+export { createAgent } from "./agent.js";
+export type { BackendProtocol, EditResult, ExecuteResponse, FileData, FileInfo, FileUploadResponse, GrepMatch, SandboxBackendProtocol, WriteResult, } from "./backend.js";
+export { isBackend, isSandboxBackend } from "./backend.js";
+export type { AgentState, CompositeBackendOptions, FilesystemBackendOptions, KeyValueStore, LocalSandboxOptions, PersistentBackendOptions, RouteConfig, TodoItem, TodoStatus, } from "./backends/index.js";
+export { BaseSandbox, CommandBlockedError, CommandTimeoutError, CompositeBackend, createAgentState, createCompositeBackend, createFilesystemBackend, createLocalSandbox, createPersistentBackend, createStateBackend, FileSizeLimitError, FilesystemBackend, InMemoryStore, LocalSandbox, PathTraversalError, PersistentBackend, StateBackend, SymlinkError, } from "./backends/index.js";
+export type { ApprovalInterrupt, ApprovalRequest, ApprovalResponse, BaseCheckpointSaver, Checkpoint, CheckpointEvent, CheckpointLoadedEvent, CheckpointSavedEvent, CheckpointSaverOptions, FileSaverOptions, Interrupt, KeyValueStoreSaverOptions, MemorySaverOptions, } from "./checkpointer/index.js";
+export { createApprovalInterrupt, createCheckpoint, createFileSaver, createInterrupt, createKeyValueStoreSaver, createMemorySaver, FileSaver, isApprovalInterrupt, isCheckpoint, isInterrupt, KeyValueStoreSaver, MemorySaver, updateCheckpoint, } from "./checkpointer/index.js";
+export { createContext } from "./context.js";
+export type { CompactionPolicy, CompactionResult, CompactionScheduler, CompactionSchedulerOptions, CompactionStrategy, CompactionTask, CompactionTaskStatus, CompactionTrigger, ContextManager, ContextManagerOptions, CustomTokenCounterOptions, PinnedMessageMetadata, StructuredSummary, SummarizationConfig, TokenBudget, TokenCounter, } from "./context-manager.js";
+export type { AgentErrorCode, ErrorSeverity, FallbackOptions, WrapErrorOptions, } from "./errors/index.js";
+export { AbortError, AgentError, AuthenticationError, AuthorizationError, BackendError, CheckpointError, ConfigurationError, ContextError, createCircuitBreaker, createErrorHandler, formatErrorForLogging, GeneratePermissionDeniedError, getUserMessage, isRetryable, MemoryError, ModelError, NetworkError, RateLimitError, SubagentError, TimeoutError, ToolExecutionError, ToolPermissionDeniedError, tryOperations, ValidationError, withFallback, withFallbackFn, wrapError, } from "./errors/index.js";
+export type { AuditEvent, AuditEventCategory, AuditEventHandler, AuditHooksOptions, BufferedGuardrailState, CacheEntry as CacheEntryHook, CacheHooksOptions, CacheStore as CacheStoreHook, Guardrail, GuardrailCheckResult, GuardrailsHooksOptions, LoggingHooksOptions as GenerationLoggingHooksOptions, OutputGuardrailConfig, RaceGuardrailsOptions, RateLimitHooksOptions, RetryHooksOptions, SecretsFilterHooksOptions, ServerRateLimitInfo, } from "./hooks/index.js";
+export { BufferedOutputGuardrail, COMMON_SECRET_PATTERNS, createAuditHooks, createBufferedOutputGuardrail, createCacheHooks, createComprehensiveLoggingHooks, createGuardrailsHooks, createInMemoryAuditStore, createLoggingHooks as createGenerationLoggingHooks, createManagedCacheHooks, createManagedGuardrailsHooks, createManagedRateLimitHooks, createManagedRetryHooks, createManagedSecretsFilterHooks, createRateLimitHooks, createRegexGuardrail, createRetryHooks, createSecretsFilterHooks, createToolLoggingHooks, exportAuditEventsJSONLines, extractTextFromMessages, findLastUserMessageId, InMemoryCacheStore as InMemoryCacheStoreHook, raceGuardrails, runWithGuardrails, TokenBucketRateLimiter, withTimeout, wrapStreamWithOutputGuardrail, } from "./hooks/index.js";
+export { aggregatePermissionDecisions, extractRespondWith, extractRetryDecision, extractUpdatedInput, extractUpdatedResult, HookTimeoutError, invokeHooksWithTimeout, invokeMatchingHooks, matchesToolName, } from "./hooks.js";
+export type { MCPManagerOptions, MCPToolLoadResult, MCPToolMetadata, MCPToolSource, } from "./mcp/index.js";
+export { expandEnvVars, isSchemaEmpty, MCPInputValidationError, MCPInputValidator, MCPManager, VirtualMCPServer, } from "./mcp/index.js";
+export type { AdditionalMemoryFile, BuildMemorySectionOptions, BuildPathMemoryContextOptions, FileMemoryPermissionStoreOptions, FilesystemMemoryStoreOptions, LoadAdditionalMemoryOptions, LoadAgentMemoryOptions, LoadAllMemoryOptions, LoadAllMemoryResult, MemoryApproval, MemoryAuditEvent, MemoryDocument, MemoryMetadata, MemoryPermissionStore, MemoryStore, ParsedMarkdown, PathMemoryContext, } from "./memory/index.js";
+export { buildMemorySection, buildPathMemoryContext, computeContentHash, computeFileHash, createFilesystemMemoryStore, createInMemoryMemoryStore, createInMemoryPermissionStore, createMemoryPermissionStore, FileMemoryPermissionStore, FilesystemMemoryStore, filterAdditionalFilesByPath, filterAutoLoadAdditionalFiles, filterAutoLoadMemories, filterMemoriesByAllTags, filterMemoriesByPath, filterMemoriesByTags, findGitRoot, getProjectMemoryPath, getUserAgentDir, getUserMemoryPath, InMemoryMemoryStore, InMemoryPermissionStore, loadAdditionalMemoryFiles, loadAgentMemory, loadAllMemory, matchesAnyPathPattern, matchesPathPattern, parseMarkdownWithFrontmatter, parseSimpleYaml, serializeMarkdownWithFrontmatter, } from "./memory/index.js";
+export type { AgentMiddleware, LoggingMiddlewareOptions, MiddlewareContext, MiddlewareContextResult, } from "./middleware/index.js";
+export { applyMiddleware, createLoggingMiddleware, createMiddlewareContext, mergeHooks, setupMiddleware, teardownMiddleware, } from "./middleware/index.js";
+export type { AgentMetrics, Counter, EventExporterOptions, EventSeverity, Gauge, Histogram, HistogramBucket, HistogramData, LogEntry, LogFormatter, Logger, LoggerOptions, LogLevel, LogTimer, LogTransport, MetricLabels, MetricPoint, MetricsExporter, MetricsRegistry, MetricsRegistryOptions, MetricType, ObservabilityEvent, ObservabilityEventStore, ObservabilityEventStoreOptions, ObservabilityPreset, ObservabilityPresetOptions, Span, SpanAttributes, SpanContext, SpanData, SpanEvent, SpanExporter, SpanKind, SpanLink, SpanStatus, SpanStatusCode, StartSpanOptions, StructuredEvent, Tracer, TracerOptions, } from "./observability/index.js";
+export { createAgentMetrics, createCallbackMetricsExporter, createCallbackSpanExporter, createCallbackTransport, createConsoleMetricsExporter, createConsoleSpanExporter, createConsoleTransport, createFilteredTransport, createJsonFormatter, createLogger, createMemoryMetricsExporter, createMemorySpanExporter, createMemoryTransport, createMetricsRegistry, createObservabilityEventHooks, createObservabilityEventStore, createObservabilityPreset, createOTLPSpanExporter, createPrettyFormatter, createTracer, DEFAULT_LATENCY_BUCKETS, DEFAULT_TOKEN_BUCKETS, defaultLogger, defaultMetricsRegistry, defaultTracer, exportEventsJSONLines, exportEventsPrometheus, LOG_LEVEL_VALUES, SemanticAttributes, setDefaultLogger, setDefaultMetricsRegistry, setDefaultTracer, toStructuredEvent, } from "./observability/index.js";
+export { definePlugin } from "./plugins.js";
+export type { ProductionAgentOptions, ProductionAgentResult, SecureProductionAgentOptions, } from "./presets/index.js";
+export { createProductionAgent, createSecureProductionAgent, DEFAULT_BLOCKED_INPUT_PATTERNS, DEFAULT_BLOCKED_OUTPUT_PATTERNS, } from "./presets/index.js";
+export type { SecurityPolicy, SecurityPolicyPreset } from "./security/index.js";
+export { applySecurityPolicy } from "./security/index.js";
+export type { EnhancedSubagentDefinition, ParallelExecutionResult, ParallelTask, SubagentContext, SubagentContextOptions, SubagentErrorEvent, SubagentEvent, SubagentEventEmitter, SubagentExecutionOptions, SubagentExecutionResult, SubagentFinishEvent, SubagentStartEvent, SubagentStepEvent, } from "./subagents/index.js";
+export { createSubagentContext, createSubagentEventEmitter, executeSubagent, executeSubagentsParallel, mergeSubagentContext, } from "./subagents/index.js";
+export { createSubagent } from "./subagents.js";
+export type { BackgroundTask, BackgroundTaskStatus, BaseTaskStore, KeyValueStore as KVStore, TaskStoreOptions, } from "./task-store/index.js";
+export { createBackgroundTask, FileTaskStore, isBackgroundTask, KVTaskStore, MemoryTaskStore, shouldExpireTask, updateBackgroundTask, } from "./task-store/index.js";
+export type { AskUserCallback, BashResult, BashToolOptions, CoreTools, CoreToolsOptions, FilesystemTools, FilesystemToolsOptions, LoadableSkillDefinition, OnTodosChanged, QuestionOption, SearchToolsOptions, SkillLoadResult, SkillRegistryOptions, SkillToolOptions, TaskStatus, TaskToolOptions as TaskToolOptions_Tool, TodoChangeType, TodoInput, TodosChangedData, TodoWriteToolOptions, ToolLoadResult, ToolMetadata, ToolReference, ToolRegistryOptions, ToolSearchOptions, UseToolsToolOptions, } from "./tools/index.js";
+export { cleanupStaleTasks, clearCompletedTasks, createAskUserQuestionTool, createBashTool, createCoreTools, createEditTool, createFilesystemTools, createFilesystemToolsOnly, createGlobTool, createGrepTool, createReadTool, createSearchToolsTool, createSkillRegistry, createSkillTool, createTaskTool, createTodoWriteTool, createToolRegistry, createUseToolsTool, createWriteTool, defineLoadableSkill, getBackgroundTask, listBackgroundTasks, mcpTools, mcpToolsFor, recoverFailedTasks, recoverRunningTasks, SkillRegistry, ToolRegistry, toolsFrom, toolsFromPlugin, } from "./tools/index.js";
+export { defineSkill } from "./tools.js";
+export type { Agent, AgentContext, AgentDataTypes, AgentOptions, AgentPlugin, AgentUIMessage, BackendFactory, CoreToolName, ExtendedToolExecutionOptions, FinishReason, GenerateOptions, GenerateResult, GenerateResultComplete, GenerateResultInterrupted, GenerateStep, HookCallback, HookCallbackContext, HookEvent, HookInput, HookMatcher, HookOutput, HookRegistration, HookSpecificOutput, HttpMCPServerConfig, InterruptFunction, InterruptRequestedInput, InterruptResolvedInput, LanguageModel, LanguageModelUsage, MCPConnectionFailedInput, MCPConnectionRestoredInput, MCPServerConfig, ModelMessage, PartialGenerateResult, PermissionDecision, PermissionMode, PluginLoadingMode, PluginOptions, PostCompactInput, PostGenerateFailureInput, PostGenerateInput, PostToolUseFailureInput, PostToolUseInput, PreCompactInput, PreGenerateInput, PreToolUseInput, SkillDefinition, SkillOptions, SseMCPServerConfig, StdioMCPServerConfig, StreamingContext, StreamingMetadata, StreamingToolsFactory, StreamPart, SubagentCreateContext, SubagentDefinition, SubagentOptions, SubagentStartInput, SubagentStopInput, TaskToolOptions, Tool, ToolCallResult, ToolExecutionOptions, ToolLoadErrorInput, ToolRegisteredInput, ToolResultPart, ToolSet, UIMessage, } from "./types.js";
+export { isCompleteResult, isInterruptedResult, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,182 @@
+/**
+ * @lleverage-ai/agent-sdk - A TypeScript framework for building AI agents.
+ *
+ * Built on top of Vercel AI SDK, this library provides a comprehensive toolkit
+ * for creating intelligent agents that can use tools, respond to hooks, and
+ * delegate tasks to specialized subagents.
+ *
+ * ## Quick Start
+ *
+ * ```typescript
+ * import { createAgent } from "@lleverage-ai/agent-sdk";
+ * import { anthropic } from "@ai-sdk/anthropic";
+ * import { tool } from "ai";
+ * import { z } from "zod";
+ *
+ * // Create an agent with tools
+ * const agent = createAgent({
+ *   model: anthropic("claude-sonnet-4-20250514"),
+ *   systemPrompt: "You are a friendly assistant.",
+ *   tools: {
+ *     greet: tool({
+ *       description: "Greet a person by name",
+ *       inputSchema: z.object({ name: z.string() }),
+ *       execute: async ({ name }) => `Hello, ${name}!`,
+ *     }),
+ *   },
+ * });
+ *
+ * // Generate a response
+ * const result = await agent.generate({
+ *   prompt: "Say hello to Alice",
+ * });
+ *
+ * // Or use with Next.js API routes and useChat
+ * export async function POST(req: Request) {
+ *   const { messages } = await req.json();
+ *   return agent.streamResponse({ messages });
+ * }
+ * ```
+ *
+ * ## Key Concepts
+ *
+ * - **Agents** - The main abstraction combining a model with tools and plugins
+ * - **Tools** - Use AI SDK's `tool()` function directly for full compatibility
+ * - **Plugins** - Bundles of tools, skills, and hooks for reusability
+ * - **Skills** - User-invocable slash commands
+ * - **Hooks** - Lifecycle event handlers for observing agent behavior
+ * - **Subagents** - Specialized agents for task delegation
+ *
+ * ## AI SDK Compatibility
+ *
+ * This SDK is built on Vercel AI SDK and maintains full compatibility:
+ * - Use `tool()` from 'ai' to define tools
+ * - Use `CoreMessage` and `UIMessage` types directly
+ * - `streamResponse()` returns a Response compatible with `useChat`
+ * - `streamRaw()` returns the raw AI SDK `streamText` result
+ *
+ * @packageDocumentation
+ */
+// Core agent
+export { createAgent } from "./agent.js";
+// Backend
+export { isBackend, isSandboxBackend } from "./backend.js";
+export { BaseSandbox, CommandBlockedError, CommandTimeoutError, CompositeBackend, createAgentState, createCompositeBackend, createFilesystemBackend, createLocalSandbox, createPersistentBackend, createStateBackend, FileSizeLimitError, FilesystemBackend, InMemoryStore, LocalSandbox, PathTraversalError, PersistentBackend, StateBackend, SymlinkError, } from "./backends/index.js";
+// Checkpointer System
+export { createApprovalInterrupt, 
+// Types and helpers
+createCheckpoint, createFileSaver, createInterrupt, createKeyValueStoreSaver, createMemorySaver, 
+// File Saver
+FileSaver, isApprovalInterrupt, isCheckpoint, isInterrupt, 
+// KeyValueStore Saver
+KeyValueStoreSaver, 
+// Memory Saver
+MemorySaver, updateCheckpoint, } from "./checkpointer/index.js";
+// Context
+export { createContext } from "./context.js";
+// Error Handling System
+export { AbortError, 
+// Base error class
+AgentError, AuthenticationError, AuthorizationError, BackendError, CheckpointError, 
+// Specific error classes
+ConfigurationError, ContextError, createCircuitBreaker, createErrorHandler, formatErrorForLogging, GeneratePermissionDeniedError, getUserMessage, isRetryable, MemoryError, ModelError, NetworkError, RateLimitError, SubagentError, TimeoutError, ToolExecutionError, ToolPermissionDeniedError, tryOperations, ValidationError, 
+// Graceful degradation
+withFallback, withFallbackFn, 
+// Utilities
+wrapError, } from "./errors/index.js";
+// Hook Utilities (factories for common patterns)
+export { BufferedOutputGuardrail, COMMON_SECRET_PATTERNS, 
+// Audit hooks
+createAuditHooks, 
+// Buffered output guardrails
+createBufferedOutputGuardrail, 
+// Cache hooks
+createCacheHooks, createComprehensiveLoggingHooks, 
+// Guardrails hooks
+createGuardrailsHooks, createInMemoryAuditStore, 
+// Logging hooks
+createLoggingHooks as createGenerationLoggingHooks, createManagedCacheHooks, createManagedGuardrailsHooks, createManagedRateLimitHooks, createManagedRetryHooks, createManagedSecretsFilterHooks, 
+// Rate limit hooks
+createRateLimitHooks, createRegexGuardrail, 
+// Retry hooks
+createRetryHooks, 
+// Secrets filter hooks
+createSecretsFilterHooks, createToolLoggingHooks, exportAuditEventsJSONLines, extractTextFromMessages, findLastUserMessageId, InMemoryCacheStore as InMemoryCacheStoreHook, 
+// Composable guardrails (race pattern)
+raceGuardrails, runWithGuardrails, TokenBucketRateLimiter, withTimeout, wrapStreamWithOutputGuardrail, } from "./hooks/index.js";
+// Hooks
+export { aggregatePermissionDecisions, extractRespondWith, extractRetryDecision, extractUpdatedInput, extractUpdatedResult, HookTimeoutError, invokeHooksWithTimeout, invokeMatchingHooks, matchesToolName, } from "./hooks.js";
+// MCP (Model Context Protocol)
+export { expandEnvVars, isSchemaEmpty, MCPInputValidationError, MCPInputValidator, MCPManager, VirtualMCPServer, } from "./mcp/index.js";
+// Memory System
+export { buildMemorySection, buildPathMemoryContext, computeContentHash, computeFileHash, createFilesystemMemoryStore, createInMemoryMemoryStore, createInMemoryPermissionStore, createMemoryPermissionStore, 
+// Permission store
+FileMemoryPermissionStore, 
+// Filesystem store
+FilesystemMemoryStore, filterAdditionalFilesByPath, filterAutoLoadAdditionalFiles, filterAutoLoadMemories, filterMemoriesByAllTags, filterMemoriesByPath, filterMemoriesByTags, findGitRoot, getProjectMemoryPath, getUserAgentDir, getUserMemoryPath, InMemoryMemoryStore, InMemoryPermissionStore, loadAdditionalMemoryFiles, 
+// Loading functions
+loadAgentMemory, loadAllMemory, matchesAnyPathPattern, 
+// Path-based rules
+matchesPathPattern, 
+// Store and parsing
+parseMarkdownWithFrontmatter, parseSimpleYaml, serializeMarkdownWithFrontmatter, } from "./memory/index.js";
+// Middleware System
+export { 
+// Application utilities
+applyMiddleware, 
+// Built-in middleware
+createLoggingMiddleware, 
+// Context creation (for custom middleware)
+createMiddlewareContext, mergeHooks, setupMiddleware, teardownMiddleware, } from "./middleware/index.js";
+// Observability presets
+// Observability System
+export { createAgentMetrics, createCallbackMetricsExporter, createCallbackSpanExporter, createCallbackTransport, createConsoleMetricsExporter, createConsoleSpanExporter, createConsoleTransport, createFilteredTransport, createJsonFormatter, createLogger, createMemoryMetricsExporter, createMemorySpanExporter, createMemoryTransport, createMetricsRegistry, createObservabilityEventHooks, createObservabilityEventStore, createObservabilityPreset, createOTLPSpanExporter, createPrettyFormatter, 
+// Tracing
+createTracer, 
+// Metrics
+DEFAULT_LATENCY_BUCKETS, DEFAULT_TOKEN_BUCKETS, defaultLogger, defaultMetricsRegistry, defaultTracer, exportEventsJSONLines, exportEventsPrometheus, 
+// Logger
+LOG_LEVEL_VALUES, SemanticAttributes, setDefaultLogger, setDefaultMetricsRegistry, setDefaultTracer, 
+// Events
+toStructuredEvent, } from "./observability/index.js";
+// Plugins
+export { definePlugin } from "./plugins.js";
+// Presets (convenience bundles for quick setup)
+export { createProductionAgent, createSecureProductionAgent, DEFAULT_BLOCKED_INPUT_PATTERNS, DEFAULT_BLOCKED_OUTPUT_PATTERNS, } from "./presets/index.js";
+// Security (security policy presets)
+export { applySecurityPolicy } from "./security/index.js";
+// Advanced Subagents
+export { createSubagentContext, createSubagentEventEmitter, executeSubagent, executeSubagentsParallel, mergeSubagentContext, } from "./subagents/index.js";
+// Subagents
+export { createSubagent } from "./subagents.js";
+// Task Store (background task persistence)
+export { createBackgroundTask, FileTaskStore, isBackgroundTask, KVTaskStore, MemoryTaskStore, shouldExpireTask, updateBackgroundTask, } from "./task-store/index.js";
+// Core Tools
+export { cleanupStaleTasks, clearCompletedTasks, 
+// User interaction tools
+createAskUserQuestionTool, 
+// Bash tool
+createBashTool, 
+// Tool factory (unified tool creation)
+createCoreTools, createEditTool, createFilesystemTools, createFilesystemToolsOnly, createGlobTool, createGrepTool, 
+// Filesystem tools
+createReadTool, 
+// Search tools (MCP integration)
+createSearchToolsTool, createSkillRegistry, createSkillTool, 
+// Task tool (subagent delegation)
+createTaskTool, 
+// Todo tool
+createTodoWriteTool, createToolRegistry, createUseToolsTool, createWriteTool, defineLoadableSkill, getBackgroundTask, listBackgroundTasks, 
+// Tool utilities (DX helpers)
+mcpTools, mcpToolsFor, recoverFailedTasks, recoverRunningTasks, 
+// Skill tool (progressive disclosure)
+SkillRegistry, 
+// Tool registry (deferred tool loading)
+ToolRegistry, toolsFrom, toolsFromPlugin, } from "./tools/index.js";
+// Skills (tools use AI SDK's tool() directly)
+export { defineSkill } from "./tools.js";
+// Types - Re-export AI SDK types for convenience
+export { 
+// Result type guards
+isCompleteResult, isInterruptedResult, } from "./types.js";
+//# sourceMappingURL=index.js.map