@agent-api/sdk 1.1.5 → 1.2.1

package/dist-cjs/local/tools.js

@@ -1,40 +1,40 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.LocalWorkspaceDriver = void 0;
-exports.createLocalWorkspaceToolRegistry = createLocalWorkspaceToolRegistry;
-exports.localWorkspaceToolDefinition = localWorkspaceToolDefinition;
-exports.localWorkspaceToolInstructions = localWorkspaceToolInstructions;
+exports.LocalWorkdirDriver = void 0;
+exports.createLocalWorkdirToolRegistry = createLocalWorkdirToolRegistry;
+exports.localWorkdirToolDefinition = localWorkdirToolDefinition;
+exports.localWorkdirToolInstructions = localWorkdirToolInstructions;
 const context_js_1 = require("./context.js");
-class LocalWorkspaceDriver {
-    workspace;
+class LocalWorkdirDriver {
+    workdir;
     accessMode;
-    constructor(workspace, options = {}) {
-        this.workspace = workspace;
+    constructor(workdir, options = {}) {
+        this.workdir = workdir;
         this.accessMode = options.accessMode ?? "approval";
     }
     async dispatch(args) {
-        const action = workspaceAction(args);
+        const action = workdirAction(args);
         switch (action) {
             case "summarize":
-                return localToolResult(action, localSummaryResult(await this.workspace.summarize(summaryArgs(args))));
+                return localToolResult(action, localSummaryResult(await this.workdir.summarize(summaryArgs(args))));
             case "list":
-                return localToolResult(action, await this.workspace.listEntries(optionalStringArg(args, "path") ?? ".", listArgs(args)));
+                return localToolResult(action, await this.workdir.listEntries(optionalStringArg(args, "path") ?? ".", listArgs(args)));
             case "search":
-                return localToolResult(action, await this.workspace.searchEntries(searchEntriesArgs(args)));
+                return localToolResult(action, await this.workdir.searchEntries(searchEntriesArgs(args)));
             case "grep":
-                return localToolResult(action, await this.workspace.grep(grepArgs(args)));
+                return localToolResult(action, await this.workdir.grep(grepArgs(args)));
             case "read":
-                return localToolResult(action, await this.workspace.readFile(stringArg(args, "path"), readFileArgs(args)));
+                return localToolResult(action, await this.workdir.readFile(stringArg(args, "path"), readFileArgs(args)));
             case "read_lines":
-                return localToolResult(action, await this.workspace.readLines(stringArg(args, "path"), readLinesArgs(args)));
+                return localToolResult(action, await this.workdir.readLines(stringArg(args, "path"), readLinesArgs(args)));
             case "context":
-                return localToolResult(action, await (0, context_js_1.createLocalContextPackage)(this.workspace, contextPackageArgs(args)));
+                return localToolResult(action, await (0, context_js_1.createLocalContextPackage)(this.workdir, contextPackageArgs(args)));
             case "snapshot":
-                return localToolResult(action, await this.workspace.snapshot(snapshotArgs(args)));
+                return localToolResult(action, await this.workdir.snapshot(snapshotArgs(args)));
             case "classify_path":
-                return localToolResult(action, this.workspace.classifyPath(stringArg(args, "path")));
+                return localToolResult(action, this.workdir.classifyPath(stringArg(args, "path")));
             case "preview_edits":
-                return localToolResult(action, await this.workspace.previewEdits(editsArg(args)));
+                return localToolResult(action, await this.workdir.previewEdits(editsArg(args)));
             case "apply_edits":
                 return await this.dispatchApplyEdits(args);
             case "write":
@@ -44,74 +44,74 @@ class LocalWorkspaceDriver {
             case "delete":
                 return await this.dispatchDelete(args);
             default:
-                throw new Error(`unsupported local_workspace action: ${action}`);
+                throw new Error(`unsupported local_workdir action: ${action}`);
         }
     }
     requiresApproval(args) {
         if (this.accessMode === "full") {
             return false;
         }
-        return mutatingLocalWorkspaceActions.has(workspaceAction(args));
+        return mutatingLocalWorkdirActions.has(workdirAction(args));
     }
     async dispatchApplyEdits(args) {
         const edits = editsArg(args);
         if (this.accessMode !== "full") {
-            return approvalRequired("apply_edits", args, await this.workspace.previewEdits(edits));
+            return approvalRequired("apply_edits", args, await this.workdir.previewEdits(edits));
         }
-        return localToolResult("apply_edits", await this.workspace.applyEdits(edits));
+        return localToolResult("apply_edits", await this.workdir.applyEdits(edits));
     }
     async dispatchWrite(args) {
         if (this.accessMode !== "full") {
             return approvalRequired("write", args);
         }
-        return localToolResult("write", await this.workspace.writeText(stringArg(args, "path"), stringArg(args, "content")));
+        return localToolResult("write", await this.workdir.writeText(stringArg(args, "path"), stringArg(args, "content")));
     }
     async dispatchMkdir(args) {
         if (this.accessMode !== "full") {
             return approvalRequired("mkdir", args);
         }
-        return localToolResult("mkdir", await this.workspace.createDirectory(stringArg(args, "path")));
+        return localToolResult("mkdir", await this.workdir.createDirectory(stringArg(args, "path")));
     }
     async dispatchDelete(args) {
         if (this.accessMode !== "full") {
             return approvalRequired("delete", args);
         }
-        return localToolResult("delete", await this.workspace.deletePath(stringArg(args, "path")));
+        return localToolResult("delete", await this.workdir.deletePath(stringArg(args, "path")));
     }
 }
-exports.LocalWorkspaceDriver = LocalWorkspaceDriver;
-function createLocalWorkspaceToolRegistry(workspace, options = {}) {
-    const toolName = options.toolName ?? "local_workspace";
-    const driver = new LocalWorkspaceDriver(workspace, { accessMode: options.accessMode });
-    const definition = localWorkspaceToolDefinition(toolName);
+exports.LocalWorkdirDriver = LocalWorkdirDriver;
+function createLocalWorkdirToolRegistry(workdir, options = {}) {
+    const toolName = options.toolName ?? "local_workdir";
+    const driver = new LocalWorkdirDriver(workdir, { accessMode: options.accessMode });
+    const definition = localWorkdirToolDefinition(toolName);
     return {
-        workspace,
+        workdir,
         accessMode: driver.accessMode,
         toolName,
         definitions: () => [{ ...definition }],
         handlers: () => ({ [toolName]: (args) => driver.dispatch(args) }),
         execute: async (name, args) => {
             if (name !== toolName) {
-                throw new Error(`unknown local workspace tool: ${name}`);
+                throw new Error(`unknown local workdir tool: ${name}`);
             }
             return await driver.dispatch(args);
         },
         requiresApproval: (name, args = {}) => name === toolName && driver.requiresApproval(args),
     };
 }
-function localWorkspaceToolDefinition(name = "local_workspace") {
+function localWorkdirToolDefinition(name = "local_workdir") {
     return {
         type: "function",
         name,
-        description: localWorkspaceToolDescription,
-        parameters: localWorkspaceToolParameters(),
+        description: localWorkdirToolDescription,
+        parameters: localWorkdirToolParameters(),
         strict: false,
     };
 }
-function localWorkspaceToolInstructions() {
-    return localWorkspaceToolDescription;
+function localWorkdirToolInstructions() {
+    return localWorkdirToolDescription;
 }
-const localWorkspaceActions = [
+const localWorkdirActions = [
     "summarize",
     "list",
     "search",
@@ -127,24 +127,24 @@ const localWorkspaceActions = [
     "mkdir",
     "delete",
 ];
-const mutatingLocalWorkspaceActions = new Set([
+const mutatingLocalWorkdirActions = new Set([
     "apply_edits",
     "write",
     "mkdir",
     "delete",
 ]);
-const localWorkspaceToolDescription = [
-    "Inspect and modify the selected local workspace through one model-facing primitive.",
+const localWorkdirToolDescription = [
+    "Inspect and modify the selected local workdir through one model-facing primitive.",
     "Use action=list/search/grep/summarize/context to discover files, read/read_lines for file content, preview_edits before edits, and apply_edits/write/mkdir/delete only when mutation is intended.",
     "In approval mode, mutating actions return requires_approval with a safe preview instead of changing files. In full mode, mutating actions execute immediately.",
-    "Paths are relative to the selected local workspace; never use absolute paths.",
+    "Paths are relative to the selected local workdir; never use absolute paths.",
 ].join(" ");
-function localWorkspaceToolParameters() {
+function localWorkdirToolParameters() {
     return objectSchema({
         action: {
             type: "string",
-            enum: localWorkspaceActions,
-            description: "Workspace operation. Prefer summarize/list/search/grep before reading or editing. Prefer read_lines and apply_edits for source changes.",
+            enum: localWorkdirActions,
+            description: "Workdir operation. Prefer summarize/list/search/grep before reading or editing. Prefer read_lines and apply_edits for source changes.",
         },
         path: stringSchema("Relative path. File path for read/write/delete/edit actions; directory base for list/search/grep/summarize/context/snapshot."),
         query: stringSchema("Path/name query for search, or optional context query."),
@@ -175,17 +175,17 @@ function localWorkspaceToolParameters() {
             max_bytes_per_file: integerSchema("Maximum bytes per file."),
             max_previews: integerSchema("Maximum summary previews."),
             include_content: booleanSchema("Include file contents in context packages."),
-            include_summary: booleanSchema("Include workspace summary in context packages."),
+            include_summary: booleanSchema("Include workdir summary in context packages."),
             include_search: booleanSchema("Include grep results in context packages when query is set."),
             include_secrets: booleanSchema("Include likely secret file contents in context packages."),
             hash: booleanSchema("Include SHA-256 hashes in snapshots."),
         }),
     }, ["action"]);
 }
-function workspaceAction(args) {
+function workdirAction(args) {
     const value = stringArg(args, "action").trim().toLowerCase();
-    if (!localWorkspaceActions.includes(value)) {
-        throw new Error(`unsupported local_workspace action: ${value}`);
+    if (!localWorkdirActions.includes(value)) {
+        throw new Error(`unsupported local_workdir action: ${value}`);
     }
     return value;
 }
@@ -352,7 +352,7 @@ function approvalRequired(action, args, preview) {
         requires_approval: true,
         arguments: args,
         preview,
-        message: `local_workspace action ${action} requires approval`,
+        message: `local_workdir action ${action} requires approval`,
     };
 }
 function objectSchema(properties, required = []) {

package/dist-cjs/node.js

@@ -14,17 +14,22 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.runLocalSkillHandlers = exports.pendingLocalSkillCalls = exports.localSkillFromDirectory = exports.localWorkspaceToolInstructions = exports.localWorkspaceToolDefinition = exports.createLocalWorkspaceToolRegistry = exports.LocalWorkspaceDriver = exports.NodeSkillsResource = exports.NodeAgentAPI = void 0;
+exports.runLocalSkillHandlers = exports.pendingLocalSkillCalls = exports.localSkillFromDirectory = exports.localWorkdirToolInstructions = exports.localWorkdirToolDefinition = exports.createLocalWorkdirToolRegistry = exports.localShellToolInstructions = exports.localShellToolDefinition = exports.LocalShellDriver = exports.HostLocalShellRunner = exports.LocalWorkdirDriver = exports.createLocalShellToolRegistry = exports.NodeSkillsResource = exports.NodeAgentAPI = void 0;
 __exportStar(require("./index.js"), exports);
 var node_client_js_1 = require("./node-client.js");
 Object.defineProperty(exports, "NodeAgentAPI", { enumerable: true, get: function () { return node_client_js_1.NodeAgentAPI; } });
 var skills_node_js_1 = require("./resources/skills-node.js");
 Object.defineProperty(exports, "NodeSkillsResource", { enumerable: true, get: function () { return skills_node_js_1.NodeSkillsResource; } });
-var tools_js_1 = require("./local/tools.js");
-Object.defineProperty(exports, "LocalWorkspaceDriver", { enumerable: true, get: function () { return tools_js_1.LocalWorkspaceDriver; } });
-Object.defineProperty(exports, "createLocalWorkspaceToolRegistry", { enumerable: true, get: function () { return tools_js_1.createLocalWorkspaceToolRegistry; } });
-Object.defineProperty(exports, "localWorkspaceToolDefinition", { enumerable: true, get: function () { return tools_js_1.localWorkspaceToolDefinition; } });
-Object.defineProperty(exports, "localWorkspaceToolInstructions", { enumerable: true, get: function () { return tools_js_1.localWorkspaceToolInstructions; } });
+var index_js_1 = require("./local/index.js");
+Object.defineProperty(exports, "createLocalShellToolRegistry", { enumerable: true, get: function () { return index_js_1.createLocalShellToolRegistry; } });
+Object.defineProperty(exports, "LocalWorkdirDriver", { enumerable: true, get: function () { return index_js_1.LocalWorkdirDriver; } });
+Object.defineProperty(exports, "HostLocalShellRunner", { enumerable: true, get: function () { return index_js_1.HostLocalShellRunner; } });
+Object.defineProperty(exports, "LocalShellDriver", { enumerable: true, get: function () { return index_js_1.LocalShellDriver; } });
+Object.defineProperty(exports, "localShellToolDefinition", { enumerable: true, get: function () { return index_js_1.localShellToolDefinition; } });
+Object.defineProperty(exports, "localShellToolInstructions", { enumerable: true, get: function () { return index_js_1.localShellToolInstructions; } });
+Object.defineProperty(exports, "createLocalWorkdirToolRegistry", { enumerable: true, get: function () { return index_js_1.createLocalWorkdirToolRegistry; } });
+Object.defineProperty(exports, "localWorkdirToolDefinition", { enumerable: true, get: function () { return index_js_1.localWorkdirToolDefinition; } });
+Object.defineProperty(exports, "localWorkdirToolInstructions", { enumerable: true, get: function () { return index_js_1.localWorkdirToolInstructions; } });
 var local_skills_js_1 = require("./local-skills.js");
 Object.defineProperty(exports, "localSkillFromDirectory", { enumerable: true, get: function () { return local_skills_js_1.localSkillFromDirectory; } });
 Object.defineProperty(exports, "pendingLocalSkillCalls", { enumerable: true, get: function () { return local_skills_js_1.pendingLocalSkillCalls; } });

package/dist-cjs/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.USER_AGENT = exports.VERSION = void 0;
-exports.VERSION = "1.1.5";
+exports.VERSION = "1.2.1";
 exports.USER_AGENT = `@agent-api/sdk/${exports.VERSION}`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-api/sdk",
-  "version": "1.1.5",
+  "version": "1.2.1",
   "description": "Production JavaScript SDK for the Managed Agent API",
   "license": "MIT",
   "repository": {