@lleverage-ai/agent-sdk 0.0.1 → 0.0.2-alpha.0

package/dist/tools/factory.d.ts

@@ -7,7 +7,7 @@
  * @packageDocumentation
  */
 import type { LanguageModel, Tool, ToolSet } from "ai";
-import type { BackendProtocol, SandboxBackendProtocol } from "../backend.js";
+import type { BackendProtocol } from "../backend.js";
 import type { AgentState } from "../backends/state.js";
 import type { MCPManager } from "../mcp/manager.js";
 import type { Agent, CoreToolName, SkillDefinition, SubagentDefinition } from "../types.js";
@@ -27,12 +27,9 @@ import { createTodoWriteTool, type TodoWriteToolOptions } from "./todos.js";
  * @example
  * ```typescript
  * const tools = createCoreTools({
- *   backend: new FilesystemBackend({ rootDir: process.cwd() }),
+ *   backend: new FilesystemBackend({ rootDir: process.cwd(), enableBash: true }),
  *   state: createAgentState(),
  *
- *   // Enable shell execution
- *   sandbox: new LocalSandbox({ cwd: process.cwd() }),
- *
  *   // Enable skill loading
  *   skillRegistry: createSkillRegistry([gitSkill, dockerSkill]),
  *
@@ -84,12 +81,14 @@ export interface CoreToolsOptions {
      */
     onTodosChanged?: TodoWriteToolOptions["onTodosChanged"];
     /**
-     * Sandbox backend for command execution.
-     * If provided, bash tool is included.
+     * Whether to include the bash tool if the backend has execute capability.
+     * When true (default), bash tool is automatically included if `hasExecuteCapability(backend)` is true.
+     * Set to false to explicitly disable bash even if backend supports it.
+     * @defaultValue true
      */
-    sandbox?: SandboxBackendProtocol;
-    /** Options for the bash tool */
-    bashOptions?: Omit<BashToolOptions, "sandbox">;
+    includeBash?: boolean;
+    /** Options for the bash tool (excluding backend) */
+    bashOptions?: Omit<BashToolOptions, "backend">;
     /**
      * Skill registry for progressive disclosure.
      * If provided, the skill tool is included.
@@ -138,7 +137,10 @@ export interface CoreToolsOptions {
     searchToolsOptions?: Omit<SearchToolsOptions, "manager">;
 }
 /**
- * Result from createCoreTools containing all created tools and registries.
+ * Core tools created by createCoreTools.
+ *
+ * This is a clean ToolSet containing only the tools, without registries.
+ * Each tool is optional depending on the configuration provided.
  *
  * @category Tools
  */
@@ -155,7 +157,7 @@ export interface CoreTools {
     grep?: Tool;
     /** Write/update todo list (if enabled) */
     todo_write?: Tool;
-    /** Shell execution (if sandbox provided) */
+    /** Shell execution (if backend has execute capability or sandbox provided) */
     bash?: Tool;
     /** Load skill tool (if registry provided) */
     skill?: Tool;
@@ -163,7 +165,16 @@ export interface CoreTools {
     task?: Tool;
     /** Tool search/discovery (if mcpManager provided) */
     search_tools?: Tool;
-    /** The skill registry (if provided) */
+}
+/**
+ * Result from createCoreTools containing tools and optional registries.
+ *
+ * @category Tools
+ */
+export interface CreateCoreToolsResult {
+    /** The created core tools */
+    tools: CoreTools;
+    /** The skill registry (if skills were provided) */
     skillRegistry?: SkillRegistry;
 }
 /**
@@ -171,27 +182,30 @@ export interface CoreTools {
  *
  * This is the recommended way to create agent tools. The minimal tool set is:
  * - `read`, `write`, `edit`, `glob`, `grep` - filesystem operations
- * - `bash` - shell command execution (optional, requires sandbox)
+ * - `bash` - shell command execution (if backend has execute capability)
  * - `todo_write` - task tracking (optional)
  * - `task` - subagent delegation (optional, requires subagents)
  * - `skill` - progressive capability loading (optional, requires registry)
  *
  * @param options - Configuration options
- * @returns Object containing all created tools and registries
+ * @returns Object containing tools and optional registries
  *
  * @example
  * ```typescript
  * import { createAgent, createCoreTools, createAgentState } from "@lleverage-ai/agent-sdk";
- * import { FilesystemBackend, LocalSandbox } from "@lleverage-ai/agent-sdk";
+ * import { FilesystemBackend } from "@lleverage-ai/agent-sdk";
  *
  * const state = createAgentState();
- * const backend = new FilesystemBackend({ rootDir: process.cwd() });
- * const sandbox = new LocalSandbox({ cwd: process.cwd() });
  *
- * const tools = createCoreTools({
+ * // Backend with bash enabled - bash tool is automatically included
+ * const backend = new FilesystemBackend({
+ *   rootDir: process.cwd(),
+ *   enableBash: true,
+ * });
+ *
+ * const { tools } = createCoreTools({
  *   backend,
  *   state,
- *   sandbox,
  * });
  *
  * const agent = createAgent({
@@ -202,9 +216,10 @@ export interface CoreTools {
  *
  * @example
  * ```typescript
- * // Minimal: just filesystem tools
- * const tools = createCoreTools({
- *   backend: new StateBackend(state),
+ * // Minimal: just filesystem tools (no bash)
+ * const backend = new FilesystemBackend({ rootDir: process.cwd() });
+ * const { tools } = createCoreTools({
+ *   backend,
  *   state,
  *   includeTodoWrite: false,
  * });
@@ -212,20 +227,19 @@ export interface CoreTools {
  *
  * @category Tools
  */
-export declare function createCoreTools(options: CoreToolsOptions): CoreTools;
+export declare function createCoreTools(options: CoreToolsOptions): CreateCoreToolsResult;
 /**
  * Converts CoreTools to a ToolSet for direct use with AI SDK.
  *
- * This extracts only the tool properties (excluding skillRegistry)
- * and filters out undefined tools.
+ * Filters out undefined tools and returns a clean ToolSet.
  *
  * @param coreTools - The core tools object from createCoreTools
  * @returns A ToolSet compatible with AI SDK
  *
  * @example
  * ```typescript
- * const coreTools = createCoreTools({ backend, state });
- * const toolSet = coreToolsToToolSet(coreTools);
+ * const { tools } = createCoreTools({ backend, state });
+ * const toolSet = coreToolsToToolSet(tools);
  *
  * const result = await generateText({
  *   model,

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

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

package/dist/tools/factory.js

@@ -6,6 +6,7 @@
  *
  * @packageDocumentation
  */
+import { hasExecuteCapability } from "../backend.js";
 import { createBashTool } from "./execute.js";
 // Tool creators
 import { createEditTool, createFilesystemTools, createGlobTool, createGrepTool, createReadTool, createWriteTool, } from "./filesystem.js";
@@ -21,27 +22,30 @@ import { createTodoWriteTool } from "./todos.js";
  *
  * This is the recommended way to create agent tools. The minimal tool set is:
  * - `read`, `write`, `edit`, `glob`, `grep` - filesystem operations
- * - `bash` - shell command execution (optional, requires sandbox)
+ * - `bash` - shell command execution (if backend has execute capability)
  * - `todo_write` - task tracking (optional)
  * - `task` - subagent delegation (optional, requires subagents)
  * - `skill` - progressive capability loading (optional, requires registry)
  *
  * @param options - Configuration options
- * @returns Object containing all created tools and registries
+ * @returns Object containing tools and optional registries
  *
  * @example
  * ```typescript
  * import { createAgent, createCoreTools, createAgentState } from "@lleverage-ai/agent-sdk";
- * import { FilesystemBackend, LocalSandbox } from "@lleverage-ai/agent-sdk";
+ * import { FilesystemBackend } from "@lleverage-ai/agent-sdk";
  *
  * const state = createAgentState();
- * const backend = new FilesystemBackend({ rootDir: process.cwd() });
- * const sandbox = new LocalSandbox({ cwd: process.cwd() });
  *
- * const tools = createCoreTools({
+ * // Backend with bash enabled - bash tool is automatically included
+ * const backend = new FilesystemBackend({
+ *   rootDir: process.cwd(),
+ *   enableBash: true,
+ * });
+ *
+ * const { tools } = createCoreTools({
  *   backend,
  *   state,
- *   sandbox,
  * });
  *
  * const agent = createAgent({
@@ -52,9 +56,10 @@ import { createTodoWriteTool } from "./todos.js";
  *
  * @example
  * ```typescript
- * // Minimal: just filesystem tools
- * const tools = createCoreTools({
- *   backend: new StateBackend(state),
+ * // Minimal: just filesystem tools (no bash)
+ * const backend = new FilesystemBackend({ rootDir: process.cwd() });
+ * const { tools } = createCoreTools({
+ *   backend,
  *   state,
  *   includeTodoWrite: false,
  * });
@@ -71,7 +76,7 @@ export function createCoreTools(options) {
     // Todos
     includeTodoWrite = true, onTodosChanged, 
     // Bash
-    sandbox, bashOptions = {}, 
+    includeBash = true, bashOptions = {}, 
     // Skills
     skillRegistry: providedSkillRegistry, skills = [], skillToolOptions = {}, 
     // Tasks
@@ -82,31 +87,33 @@ export function createCoreTools(options) {
     const disabledSet = new Set(disabled);
     // Helper to check if a tool is disabled
     const isDisabled = (name) => disabledSet.has(name);
-    // Create result object
-    const result = {};
+    // Create tools object
+    const tools = {};
+    // Track skill registry separately
+    let resultSkillRegistry;
     // =========================================================================
     // Filesystem Tools
     // =========================================================================
     if (!isDisabled("read")) {
-        result.read = createReadTool(backend);
+        tools.read = createReadTool(backend);
     }
     if (!isDisabled("glob")) {
-        result.glob = createGlobTool(backend);
+        tools.glob = createGlobTool(backend);
     }
     if (!isDisabled("grep")) {
-        result.grep = createGrepTool(backend);
+        tools.grep = createGrepTool(backend);
     }
     if (!isDisabled("write") && includeWrite) {
-        result.write = createWriteTool(backend);
+        tools.write = createWriteTool(backend);
     }
     if (!isDisabled("edit") && includeEdit) {
-        result.edit = createEditTool(backend);
+        tools.edit = createEditTool(backend);
     }
     // =========================================================================
     // Todo Tool
     // =========================================================================
     if (!isDisabled("todo_write") && includeTodoWrite) {
-        result.todo_write = createTodoWriteTool({
+        tools.todo_write = createTodoWriteTool({
             state,
             onTodosChanged,
         });
@@ -114,8 +121,8 @@ export function createCoreTools(options) {
     // =========================================================================
     // Bash Tool
     // =========================================================================
-    if (!isDisabled("bash") && sandbox) {
-        result.bash = createBashTool({ sandbox, ...bashOptions });
+    if (!isDisabled("bash") && includeBash && hasExecuteCapability(backend)) {
+        tools.bash = createBashTool({ backend, ...bashOptions });
     }
     // =========================================================================
     // Skill Tool
@@ -136,18 +143,18 @@ export function createCoreTools(options) {
             }
         }
         if (skillRegistry) {
-            result.skill = createSkillTool({
+            tools.skill = createSkillTool({
                 registry: skillRegistry,
                 ...skillToolOptions,
             });
-            result.skillRegistry = skillRegistry;
+            resultSkillRegistry = skillRegistry;
         }
     }
     // =========================================================================
     // Task Tool
     // =========================================================================
     if (!isDisabled("task") && subagents && subagents.length > 0 && parentAgent && defaultModel) {
-        result.task = createTaskTool({
+        tools.task = createTaskTool({
             subagents,
             defaultModel,
             parentAgent,
@@ -159,26 +166,28 @@ export function createCoreTools(options) {
     // Search Tools (MCP)
     // =========================================================================
     if (!isDisabled("search_tools") && mcpManager) {
-        result.search_tools = createSearchToolsTool({
+        tools.search_tools = createSearchToolsTool({
             manager: mcpManager,
             ...searchToolsOptions,
         });
     }
-    return result;
+    return {
+        tools,
+        skillRegistry: resultSkillRegistry,
+    };
 }
 /**
  * Converts CoreTools to a ToolSet for direct use with AI SDK.
  *
- * This extracts only the tool properties (excluding skillRegistry)
- * and filters out undefined tools.
+ * Filters out undefined tools and returns a clean ToolSet.
  *
  * @param coreTools - The core tools object from createCoreTools
  * @returns A ToolSet compatible with AI SDK
  *
  * @example
  * ```typescript
- * const coreTools = createCoreTools({ backend, state });
- * const toolSet = coreToolsToToolSet(coreTools);
+ * const { tools } = createCoreTools({ backend, state });
+ * const toolSet = coreToolsToToolSet(tools);
  *
  * const result = await generateText({
  *   model,
@@ -190,16 +199,13 @@ export function createCoreTools(options) {
  * @category Tools
  */
 export function coreToolsToToolSet(coreTools) {
-    const { skillRegistry: _registry, // Exclude non-tool property
-    ...tools } = coreTools;
-    // Filter out undefined tools
-    const result = {};
-    for (const [name, tool] of Object.entries(tools)) {
-        if (tool !== undefined) {
-            result[name] = tool;
+    const toolsOnly = {};
+    for (const [key, value] of Object.entries(coreTools)) {
+        if (value !== undefined) {
+            toolsOnly[key] = value;
         }
     }
-    return result;
+    return toolsOnly;
 }
 // =============================================================================
 // Convenience Exports

package/dist/tools/factory.js.map

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

package/dist/tools/index.d.ts

@@ -12,7 +12,7 @@
  */
 export type { BashResult, BashToolOptions } from "./execute.js";
 export { createBashTool } from "./execute.js";
-export type { CoreTools, CoreToolsOptions } from "./factory.js";
+export type { CoreTools, CoreToolsOptions, CreateCoreToolsResult, } from "./factory.js";
 export { coreToolsToToolSet, createCoreTools, createFilesystemToolsOnly, } from "./factory.js";
 export type { FilesystemTools, FilesystemToolsOptions } from "./filesystem.js";
 export { createEditTool, createFilesystemTools, createGlobTool, createGrepTool, createReadTool, createWriteTool, } from "./filesystem.js";
@@ -26,8 +26,6 @@ export type { OnTodosChanged, TodoChangeType, TodoInput, TodosChangedData, TodoW
 export { createTodoWriteTool } from "./todos.js";
 export type { ToolLoadResult, ToolMetadata, ToolRegistryOptions, ToolSearchOptions, UseToolsToolOptions, } from "./tool-registry.js";
 export { createToolRegistry, createUseToolsTool, ToolRegistry, } from "./tool-registry.js";
-export type { AskUserCallback, QuestionOption, } from "./user-interaction.js";
-export { createAskUserQuestionTool } from "./user-interaction.js";
 export type { ToolReference } from "./utils.js";
 export { mcpTools, mcpToolsFor, toolsFrom, toolsFromPlugin } from "./utils.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEhE,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,YAAY,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEhE,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,yBAAyB,GAC1B,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAE/E,OAAO,EACL,cAAc,EACd,qBAAqB,EACrB,cAAc,EACd,cAAc,EACd,cAAc,EACd,eAAe,GAChB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtD,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,YAAY,EACV,uBAAuB,EACvB,eAAe,EACf,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,mBAAmB,EACnB,aAAa,GACd,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,UAAU,EACV,eAAe,GAChB,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,cAAc,EACd,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,WAAW,CAAC;AACnB,YAAY,EACV,cAAc,EACd,cAAc,EACd,SAAS,EACT,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,YAAY,EACV,cAAc,EACd,YAAY,EACZ,mBAAmB,EACnB,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,YAAY,GACb,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,eAAe,EACf,cAAc,GACf,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAClE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEhE,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,YAAY,EACV,SAAS,EACT,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,yBAAyB,GAC1B,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAE/E,OAAO,EACL,cAAc,EACd,qBAAqB,EACrB,cAAc,EACd,cAAc,EACd,cAAc,EACd,eAAe,GAChB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtD,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,YAAY,EACV,uBAAuB,EACvB,eAAe,EACf,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,mBAAmB,EACnB,aAAa,GACd,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,UAAU,EACV,eAAe,GAChB,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,cAAc,EACd,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,WAAW,CAAC;AACnB,YAAY,EACV,cAAc,EACd,cAAc,EACd,SAAS,EACT,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,YAAY,EACV,cAAc,EACd,YAAY,EACZ,mBAAmB,EACnB,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,YAAY,GACb,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC"}

package/dist/tools/index.js

@@ -26,8 +26,6 @@ export { cleanupStaleTasks, clearCompletedTasks, createTaskTool, getBackgroundTa
 export { createTodoWriteTool } from "./todos.js";
 // Tool registry (deferred tool loading)
 export { createToolRegistry, createUseToolsTool, ToolRegistry, } from "./tool-registry.js";
-// User interaction tools
-export { createAskUserQuestionTool } from "./user-interaction.js";
 // Tool utilities (DX helpers)
 export { mcpTools, mcpToolsFor, toolsFrom, toolsFromPlugin } from "./utils.js";
 //# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,YAAY;AACZ,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,uCAAuC;AACvC,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,yBAAyB,GAC1B,MAAM,cAAc,CAAC;AAEtB,mBAAmB;AACnB,OAAO,EACL,cAAc,EACd,qBAAqB,EACrB,cAAc,EACd,cAAc,EACd,cAAc,EACd,eAAe,GAChB,MAAM,iBAAiB,CAAC;AAEzB,iCAAiC;AACjC,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAOpD,sCAAsC;AACtC,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,mBAAmB,EACnB,aAAa,GACd,MAAM,aAAa,CAAC;AAKrB,kCAAkC;AAClC,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,cAAc,EACd,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,WAAW,CAAC;AAQnB,YAAY;AACZ,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAQjD,wCAAwC;AACxC,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,YAAY,GACb,MAAM,oBAAoB,CAAC;AAK5B,yBAAyB;AACzB,OAAO,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAElE,8BAA8B;AAC9B,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,YAAY;AACZ,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAM9C,uCAAuC;AACvC,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,yBAAyB,GAC1B,MAAM,cAAc,CAAC;AAEtB,mBAAmB;AACnB,OAAO,EACL,cAAc,EACd,qBAAqB,EACrB,cAAc,EACd,cAAc,EACd,cAAc,EACd,eAAe,GAChB,MAAM,iBAAiB,CAAC;AAEzB,iCAAiC;AACjC,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAOpD,sCAAsC;AACtC,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,mBAAmB,EACnB,aAAa,GACd,MAAM,aAAa,CAAC;AAKrB,kCAAkC;AAClC,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,cAAc,EACd,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,WAAW,CAAC;AAQnB,YAAY;AACZ,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAQjD,wCAAwC;AACxC,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,YAAY,GACb,MAAM,oBAAoB,CAAC;AAE5B,8BAA8B;AAC9B,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC"}

package/dist/types.d.ts

@@ -627,7 +627,7 @@ export interface AgentOptions {
      *
      * This option only has an effect when:
      * - `permissionMode` is set to `"acceptEdits"`
-     * - The `backend` is a sandbox backend (e.g., `LocalSandbox`)
+     * - The `backend` has execute capability (e.g., `FilesystemBackend` with `enableBash: true`)
      *
      * @defaultValue true
      *
@@ -636,7 +636,7 @@ export interface AgentOptions {
      * // Default: shell file ops are blocked in acceptEdits mode
      * const agent = createAgent({
      *   model,
-     *   backend: new LocalSandbox({ cwd: process.cwd() }),
+     *   backend: new FilesystemBackend({ rootDir: process.cwd(), enableBash: true }),
      *   permissionMode: "acceptEdits",
      *   // blockShellFileOps: true is the default
      * });
@@ -644,7 +644,7 @@ export interface AgentOptions {
      * // Explicitly allow shell file ops (not recommended)
      * const agent = createAgent({
      *   model,
-     *   backend: new LocalSandbox({ cwd: process.cwd() }),
+     *   backend: new FilesystemBackend({ rootDir: process.cwd(), enableBash: true }),
      *   permissionMode: "acceptEdits",
      *   blockShellFileOps: false, // Warning will be logged
      * });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lleverage-ai/agent-sdk",
-  "version": "0.0.1",
+  "version": "0.0.2-alpha.0",
   "description": "A TypeScript framework for building AI agents using the Vercel AI SDK v6",
   "type": "module",
   "license": "MIT",
@@ -56,14 +56,12 @@
     "format:check": "biome format .",
     "check": "biome check .",
     "check:fix": "biome check --write .",
-    "docs": "typedoc",
-    "docs:watch": "typedoc --watch",
     "clean": "rm -rf dist coverage docs",
     "prepublishOnly": "npm run clean && npm run check && npm run test && npm run build"
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.25.3",
-    "ai": "^6.0.0",
+    "@modelcontextprotocol/sdk": "^1.26.0",
+    "ai": "^6.0.70",
     "ajv": "^8.17.1",
     "zod": "^4.3.6"
   },
@@ -73,9 +71,7 @@
     "@tsconfig/node18": "^18.2.4",
     "@types/json-schema": "^7.0.15",
     "@types/node": "^25.1.0",
-    "typedoc": "^0.28.0",
-    "typedoc-plugin-markdown": "^4.6.0",
     "typescript": "^5.9.2",
-    "vitest": "^3.2.0"
+    "vitest": "^4.0.18"
   }
 }