@agent-api/sdk 1.2.3 → 1.3.1

package/dist-cjs/local/tools.js

@@ -13,6 +13,15 @@ class LocalWorkdirDriver {
         this.accessMode = options.accessMode ?? "approval";
     }
     async dispatch(args) {
+        const action = safeWorkdirAction(args);
+        try {
+            return await this.dispatchUnsafe(args);
+        }
+        catch (error) {
+            return localToolErrorResult(action, error);
+        }
+    }
+    async dispatchUnsafe(args) {
         const action = workdirAction(args);
         switch (action) {
             case "summarize":
@@ -51,7 +60,8 @@ class LocalWorkdirDriver {
         if (this.accessMode === "full") {
             return false;
         }
-        return mutatingLocalWorkdirActions.has(workdirAction(args));
+        const action = safeWorkdirAction(args);
+        return action !== "unknown" && mutatingLocalWorkdirActions.has(action);
     }
     async dispatchApplyEdits(args) {
         const edits = editsArg(args);
@@ -136,6 +146,7 @@ const mutatingLocalWorkdirActions = new Set([
 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.",
+    "grep searches file contents for a literal substring; path may be omitted, a file path, or a directory subtree.",
     "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 workdir; never use absolute paths.",
 ].join(" ");
@@ -146,7 +157,7 @@ function localWorkdirToolParameters() {
             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."),
+        path: stringSchema("Relative path. File path for read/write/delete/edit actions. For grep, path may be a file or a directory subtree. For list/search/summarize/context/snapshot, path is a directory base."),
         query: stringSchema("Path/name query for search, or optional context query."),
         pattern: stringSchema("Literal text pattern for grep."),
         content: stringSchema("Text content for write."),
@@ -189,6 +200,10 @@ function workdirAction(args) {
     }
     return value;
 }
+function safeWorkdirAction(args) {
+    const value = typeof args.action === "string" ? args.action.trim().toLowerCase() : "";
+    return localWorkdirActions.includes(value) ? value : "unknown";
+}
 function summaryArgs(args) {
     return {
         path: optionalStringArg(args, "path"),
@@ -284,6 +299,27 @@ function localToolResult(action, value) {
     }
     return { ok: true, action, result };
 }
+function localToolErrorResult(action, error) {
+    const details = errorDetails(error);
+    return {
+        ok: false,
+        action,
+        error: details.message,
+        code: details.code,
+        path: details.path,
+    };
+}
+function errorDetails(error) {
+    if (error instanceof Error) {
+        const record = error;
+        return {
+            code: typeof record.code === "string" ? record.code : undefined,
+            message: error.message || "local_workdir action failed",
+            path: typeof record.path === "string" ? record.path : undefined,
+        };
+    }
+    return { message: String(error || "local_workdir action failed") };
+}
 function stringArg(args, key, alternateKey) {
     const direct = args[key] ?? (alternateKey ? args[alternateKey] : undefined);
     const fromOptions = args.options && typeof args.options === "object"

package/dist-cjs/node.js

@@ -14,7 +14,7 @@ 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.localWorkdirToolInstructions = exports.localWorkdirToolDefinition = exports.createLocalWorkdirToolRegistry = exports.localShellToolInstructions = exports.localShellToolDefinition = exports.LocalShellDriver = exports.HostLocalShellRunner = exports.LocalWorkdirDriver = exports.createLocalShellToolRegistry = 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.IsolatorLocalShellRunner = 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; } });
@@ -24,6 +24,7 @@ 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, "IsolatorLocalShellRunner", { enumerable: true, get: function () { return index_js_1.IsolatorLocalShellRunner; } });
 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; } });

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.2.3";
+exports.VERSION = "1.3.1";
 exports.USER_AGENT = `@agent-api/sdk/${exports.VERSION}`;

package/package.json

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