@agent-api/sdk 1.1.5 → 1.2.0

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Changelog — @agent-api/sdk
 
-## 1.1.5
+## 1.2.0
 
 ### Added
 
@@ -9,18 +9,19 @@
 
 ### Changed
 
+- Renamed local SDK concepts from workspace to workdir to avoid confusion with platform identity workspaces.
 - Extended response input types so tool-call continuations can carry function-call metadata consistently.
 
 ## 1.1.2
 
 ### Added
 
-- Added a model-facing `local_workspace` driver/tool primitive for local workspace operations.
-- Added approval-aware dispatch for mutating local workspace actions.
+- Added a model-facing `local_workdir` driver/tool primitive for local workdir operations.
+- Added approval-aware dispatch for mutating local workdir actions.
 
 ### Changed
 
-- Replaced fragmented local workspace tool presentation with an action-based adapter over the low-level local APIs.
+- Replaced fragmented local workdir tool presentation with an action-based adapter over the low-level local APIs.
 
 ## 1.1.1
 
@@ -38,9 +39,9 @@
 - Cross-platform app directory resolution for data, config, cache, logs, and temp files.
 - Root-scoped local file stores with path traversal protection, atomic writes, JSON helpers, recursive listing, and local skill discovery.
 - Local workdir operations for entry search, file delivery, line-range reads and edits, literal grep, and directory summaries.
-- `LocalWorkspace` and `LocalWorkspaceManager` for project roots, default ignore rules, patch previews, snapshots, diffs, and file-watch handles.
+- `LocalWorkdir` and `LocalWorkdirManager` for project roots, default ignore rules, patch previews, snapshots, diffs, and file-watch handles.
 - Typed local errors, `.gitignore` loading, sensitivity classification for likely secret paths, and multi-file line-edit plans with conflict detection and rollback.
-- `createLocalContextPackage()` for bounded, secret-aware local workspace manifests that app integrations can hand to agent workflows.
+- `createLocalContextPackage()` for bounded, secret-aware local workdir manifests that app integrations can hand to agent workflows.
 
 ### Changed
 

package/README.md

@@ -44,7 +44,7 @@ Public package entrypoints:
 
 - `@agent-api/sdk`: browser-safe REST client, public types, auth, responses, models, presets, tools, volumes, and skills HTTP APIs.
 - `@agent-api/sdk/browser`: explicit alias of the browser-safe REST client entry.
-- `@agent-api/sdk/local`: Node-only local runtime, workspace, context, and local workspace tool support.
+- `@agent-api/sdk/local`: Node-only local runtime, workdir, context, and local workdir tool support.
 - `@agent-api/sdk/node`: Node aggregate entry for local helpers such as `localSkillFromDirectory()` plus `NodeAgentAPI`.
 
 ```
@@ -114,7 +114,7 @@ const binary = await client.volumes.readFile(volume.volume_id, "assets/logo.png"
 
 const response = await client.agent.create({
   preset: "pro-search",
-  input: "Use the attached workspace volume.",
+  input: "Use the attached agent volume.",
   volume_id: volume.volume_id,
 });
 ```
@@ -125,10 +125,10 @@ const response = await client.agent.create({
 
 ```typescript
 import { resolvePresetTools } from "@agent-api/sdk";
-import { createLocalWorkspaceToolRegistry, LocalWorkspace } from "@agent-api/sdk/local";
+import { createLocalWorkdirToolRegistry, LocalWorkdir } from "@agent-api/sdk/local";
 
-const workspace = new LocalWorkspace("/path/to/project", { trusted: true });
-const registry = createLocalWorkspaceToolRegistry(workspace);
+const workdir = new LocalWorkdir("/path/to/project", { trusted: true });
+const registry = createLocalWorkdirToolRegistry(workdir);
 
 const { tools } = await resolvePresetTools(client, {
   preset: "pro-search",
@@ -188,7 +188,7 @@ The runtime provides:
 - Root-scoped file stores with path traversal protection.
 - Atomic text/JSON writes, byte reads/writes, recursive listing, copy, remove, and stat helpers.
 - Local workdir operations inspired by platform volumes: `listEntries`, `searchEntries`, `readFile`, `writeFile`, `deletePath`, `createDirectory`, `readLines`, `patchLines`, `grep`, and `summarize`.
-- First-class local workspaces with default ignore rules, scoped workbench operations, patch previews, snapshots, diffs, file-watch handles, and budgeted context packaging.
+- First-class local workdirs with default ignore rules, scoped workbench operations, patch previews, snapshots, diffs, file-watch handles, and budgeted context packaging.
 - Typed local errors, `.gitignore` loading, sensitivity classification, and multi-file edit plans with rollback on failure.
 - JSON config helpers for typed app settings.
 - Local skill discovery built on `localSkillFromDirectory()`.
@@ -196,24 +196,24 @@ The runtime provides:
 Keep UI and OS interaction policy in your host framework. Electron, Tauri, Qt, or native apps should call this layer from their trusted local process and expose only the capabilities their UI needs.
 
 ```typescript
-const workspace = local.data.child("workspaces/demo");
+const workdir = local.data.child("workdirs/demo");
 
-await workspace.writeText("src/index.ts", "console.log('hello');\n");
+await workdir.writeText("src/index.ts", "console.log('hello');\n");
 
-const matches = await workspace.grep({ pattern: "hello", path: "src" });
-const lines = await workspace.readLines("src/index.ts", { startLine: 1, endLine: 20 });
-await workspace.patchLines("src/index.ts", {
+const matches = await workdir.grep({ pattern: "hello", path: "src" });
+const lines = await workdir.readLines("src/index.ts", { startLine: 1, endLine: 20 });
+await workdir.patchLines("src/index.ts", {
   startLine: 1,
   replacement: "console.log('patched');",
 });
 
-const summary = await workspace.summarize();
+const summary = await workdir.summarize();
 ```
 
-For project/workspace roots, prefer `local.workspace()` so SDK defaults protect common generated directories such as `.git`, `node_modules`, `dist`, and build caches.
+For project/workdir roots, prefer `local.workdir()` so SDK defaults protect common generated directories such as `.git`, `node_modules`, `dist`, and build caches.
 
 ```typescript
-const project = local.workspace("/path/to/project", {
+const project = local.workdir("/path/to/project", {
   name: "my-project",
   trusted: true,
   ignore: ["vendor", /^tmp\//],
@@ -236,7 +236,7 @@ const diff = project.diff(before, after);
 const sensitivity = project.classifyPath(".env");
 ```
 
-Use `createLocalContextPackage()` when a local app needs to prepare bounded workspace context for an agent request. The package includes a manifest, selected file previews, optional search matches, hashes, sensitivity labels, and secret-aware omission by default.
+Use `createLocalContextPackage()` when a local app needs to prepare bounded workdir context for an agent request. The package includes a manifest, selected file previews, optional search matches, hashes, sensitivity labels, and secret-aware omission by default.
 
 ```typescript
 import { createLocalContextPackage } from "@agent-api/sdk/local";

package/dist/local/context.d.ts

@@ -1,4 +1,4 @@
-import { type LocalFileDeliver, type LocalGrepResponse, type LocalPathSensitivity, type LocalPathSensitivityInfo, type LocalSummary, type LocalWorkspace, type LocalWorkspaceSnapshotFile } from "./core.js";
+import { type LocalFileDeliver, type LocalGrepResponse, type LocalPathSensitivity, type LocalPathSensitivityInfo, type LocalSummary, type LocalWorkdir, type LocalWorkdirSnapshotFile } from "./core.js";
 export interface LocalContextPackageParams {
     path?: string;
     include?: string[];
@@ -30,7 +30,7 @@ export interface LocalContextFile {
 export interface LocalContextManifest {
     object: "local_context_manifest";
     root: string;
-    workspace_name: string;
+    workdir_name: string;
     generated_at_unix: number;
     base_path: string;
     file_count: number;
@@ -41,9 +41,9 @@ export interface LocalContextManifest {
     summary?: LocalSummary;
     search?: LocalGrepResponse;
 }
-export declare function createLocalContextPackage(workspace: LocalWorkspace, params?: LocalContextPackageParams): Promise<LocalContextManifest>;
+export declare function createLocalContextPackage(workdir: LocalWorkdir, params?: LocalContextPackageParams): Promise<LocalContextManifest>;
 export declare function summarizeLocalContextSensitivity(files: Array<Pick<LocalContextFile, "path" | "sensitivity" | "sensitivity_reason">>): {
     highest: LocalPathSensitivity;
     files: LocalPathSensitivityInfo[];
 };
-export type LocalContextSnapshotFile = LocalWorkspaceSnapshotFile;
+export type LocalContextSnapshotFile = LocalWorkdirSnapshotFile;

package/dist/local/context.js

@@ -1,7 +1,7 @@
 import { createHash } from "node:crypto";
 import { readFile } from "node:fs/promises";
 import { classifyLocalPathSensitivity, } from "./core.js";
-export async function createLocalContextPackage(workspace, params = {}) {
+export async function createLocalContextPackage(workdir, params = {}) {
     const basePath = params.path ?? ".";
     const maxFiles = positiveInt(params.maxFiles, 80);
     const maxBytes = positiveInt(params.maxBytes, 256 * 1024);
@@ -12,7 +12,7 @@ export async function createLocalContextPackage(workspace, params = {}) {
     const includeSummary = params.includeSummary ?? true;
     const includeSearch = Boolean(params.includeSearch && params.query?.trim());
     const includeSecrets = params.includeSecrets ?? false;
-    const stats = await workspace.list(basePath, { recursive: true });
+    const stats = await workdir.list(basePath, { recursive: true });
     const fileStats = stats
         .filter((item) => item.type === "file")
         .filter((item) => matchesPathFilters(item.path, params.include, params.exclude))
@@ -49,7 +49,7 @@ export async function createLocalContextPackage(workspace, params = {}) {
             truncated = true;
             continue;
         }
-        const delivered = await workspace.readFile(item.path, { maxBytes: readBudget });
+        const delivered = await workdir.readFile(item.path, { maxBytes: readBudget });
         includedBytes += delivered.encoding === "text"
             ? Buffer.byteLength(delivered.content ?? "", "utf8")
             : Buffer.byteLength(delivered.content_base64 ?? "", "base64");
@@ -64,7 +64,7 @@ export async function createLocalContextPackage(workspace, params = {}) {
             packaged.content_base64 = delivered.content_base64;
         }
         if (includeHashes) {
-            packaged.sha256 = await sha256File(workspace, item.path);
+            packaged.sha256 = await sha256File(workdir, item.path);
         }
         if (delivered.truncated) {
             truncated = true;
@@ -72,7 +72,7 @@ export async function createLocalContextPackage(workspace, params = {}) {
         files.push(packaged);
     }
     const summary = includeSummary
-        ? await workspace.summarize({
+        ? await workdir.summarize({
             path: basePath,
             maxFiles,
             previewBytes,
@@ -80,7 +80,7 @@ export async function createLocalContextPackage(workspace, params = {}) {
         })
         : undefined;
     const search = includeSearch
-        ? await workspace.grep({
+        ? await workdir.grep({
             pattern: params.query,
             path: basePath,
             limit: maxFiles,
@@ -90,8 +90,8 @@ export async function createLocalContextPackage(workspace, params = {}) {
         : undefined;
     return {
         object: "local_context_manifest",
-        root: workspace.root,
-        workspace_name: workspace.name,
+        root: workdir.root,
+        workdir_name: workdir.name,
         generated_at_unix: Math.floor(Date.now() / 1000),
         base_path: basePath,
         file_count: fileStats.length,
@@ -148,7 +148,7 @@ function positiveInt(value, fallback) {
     const parsed = Number(value);
     return Number.isFinite(parsed) && parsed > 0 ? Math.trunc(parsed) : fallback;
 }
-async function sha256File(workspace, relativePath) {
-    const fullPath = workspace.files.resolvePath(relativePath);
+async function sha256File(workdir, relativePath) {
+    const fullPath = workdir.files.resolvePath(relativePath);
     return createHash("sha256").update(await readFile(fullPath)).digest("hex");
 }

package/dist/local/core.d.ts

@@ -174,7 +174,7 @@ export interface LocalSummary {
     generated_at_unix: number;
     scan_truncated: boolean;
 }
-export interface LocalWorkspaceOptions {
+export interface LocalWorkdirOptions {
     name?: string;
     metadata?: Record<string, unknown>;
     trusted?: boolean;
@@ -182,31 +182,31 @@ export interface LocalWorkspaceOptions {
     gitignore?: boolean;
     maxFileBytes?: number;
 }
-export interface LocalWorkspaceSnapshotParams {
+export interface LocalWorkdirSnapshotParams {
     path?: string;
     hash?: boolean;
     maxBytesPerFile?: number;
 }
-export interface LocalWorkspaceSnapshotFile {
+export interface LocalWorkdirSnapshotFile {
     path: string;
     size: number;
     modified_at_unix?: number;
     sha256?: string;
 }
-export interface LocalWorkspaceSnapshot {
+export interface LocalWorkdirSnapshot {
     root: string;
     name: string;
     generated_at_unix: number;
-    files: LocalWorkspaceSnapshotFile[];
+    files: LocalWorkdirSnapshotFile[];
 }
-export interface LocalWorkspaceDiff {
-    added: LocalWorkspaceSnapshotFile[];
+export interface LocalWorkdirDiff {
+    added: LocalWorkdirSnapshotFile[];
     modified: Array<{
-        before: LocalWorkspaceSnapshotFile;
-        after: LocalWorkspaceSnapshotFile;
+        before: LocalWorkdirSnapshotFile;
+        after: LocalWorkdirSnapshotFile;
     }>;
-    deleted: LocalWorkspaceSnapshotFile[];
-    unchanged: LocalWorkspaceSnapshotFile[];
+    deleted: LocalWorkdirSnapshotFile[];
+    unchanged: LocalWorkdirSnapshotFile[];
 }
 export interface LocalLinePatchPreview {
     path: string;
@@ -216,18 +216,18 @@ export interface LocalLinePatchPreview {
     before: string[];
     after: string[];
 }
-export interface LocalWorkspaceLineEdit {
+export interface LocalWorkdirLineEdit {
     path: string;
     startLine: number;
     endLine?: number;
     replacement?: string;
     expectedSha256?: string;
 }
-export interface LocalWorkspaceEditPlan {
-    edits: LocalWorkspaceLineEdit[];
+export interface LocalWorkdirEditPlan {
+    edits: LocalWorkdirLineEdit[];
     previews: LocalLinePatchPreview[];
 }
-export interface LocalWorkspaceEditResult {
+export interface LocalWorkdirEditResult {
     applied: LocalFileLinesPatch[];
     backups: Array<{
         path: string;
@@ -240,11 +240,11 @@ export interface LocalPathSensitivityInfo {
     sensitivity: LocalPathSensitivity;
     reason?: string;
 }
-export interface LocalWorkspaceWatchEvent {
+export interface LocalWorkdirWatchEvent {
     type: "change" | "rename";
     path: string;
 }
-export interface LocalWorkspaceWatcher {
+export interface LocalWorkdirWatcher {
     close(): void;
 }
 export interface LocalSkillDiscoveryOptions extends LocalSkillDirectoryOptions {
@@ -262,8 +262,8 @@ export interface LocalRuntime {
     temp: LocalFileStore;
     config: LocalConfigStore;
     skills: LocalSkillStore;
-    workspaces: LocalWorkspaceManager;
-    workspace(root: string, options?: LocalWorkspaceOptions): LocalWorkspace;
+    workdirs: LocalWorkdirManager;
+    workdir(root: string, options?: LocalWorkdirOptions): LocalWorkdir;
     ensure(): Promise<void>;
 }
 export declare function createLocalRuntime(options: LocalRuntimeOptions): LocalRuntime;
@@ -322,10 +322,10 @@ export declare class LocalConfigStore {
     delete(name: string, key: string): Promise<string>;
     private readRecord;
 }
-export declare class LocalWorkspaceManager {
-    open(root: string, options?: LocalWorkspaceOptions): LocalWorkspace;
+export declare class LocalWorkdirManager {
+    open(root: string, options?: LocalWorkdirOptions): LocalWorkdir;
 }
-export declare class LocalWorkspace {
+export declare class LocalWorkdir {
     readonly root: string;
     readonly name: string;
     readonly metadata: Record<string, unknown>;
@@ -334,10 +334,10 @@ export declare class LocalWorkspace {
     readonly ignore: LocalIgnoreRule[];
     readonly gitignore: boolean;
     readonly maxFileBytes: number;
-    constructor(root: string, options?: LocalWorkspaceOptions);
+    constructor(root: string, options?: LocalWorkdirOptions);
     ensure(): Promise<void>;
     loadIgnoreFiles(files?: string[]): Promise<LocalIgnoreRule[]>;
-    child(relativePath: string, options?: LocalWorkspaceOptions): LocalWorkspace;
+    child(relativePath: string, options?: LocalWorkdirOptions): LocalWorkdir;
     resolvePath(relativePath?: string): string;
     list(relativePath?: string, options?: LocalListOptions): Promise<LocalFileStat[]>;
     listEntries(relativePath?: string, options?: LocalListOptions): Promise<LocalEntryList>;
@@ -358,16 +358,16 @@ export declare class LocalWorkspace {
     readLines(relativePath: string, params: LocalReadLinesParams): Promise<LocalFileLines>;
     previewPatchLines(relativePath: string, params: LocalPatchLinesParams): Promise<LocalLinePatchPreview>;
     patchLines(relativePath: string, params: LocalPatchLinesParams): Promise<LocalFileLinesPatch>;
-    previewEdits(edits: LocalWorkspaceLineEdit[]): Promise<LocalWorkspaceEditPlan>;
-    applyEdits(edits: LocalWorkspaceLineEdit[]): Promise<LocalWorkspaceEditResult>;
+    previewEdits(edits: LocalWorkdirLineEdit[]): Promise<LocalWorkdirEditPlan>;
+    applyEdits(edits: LocalWorkdirLineEdit[]): Promise<LocalWorkdirEditResult>;
     classifyPath(relativePath: string): LocalPathSensitivityInfo;
     grep(params: LocalGrepParams): Promise<LocalGrepResponse>;
     summarize(params?: LocalSummarizeParams): Promise<LocalSummary>;
-    snapshot(params?: LocalWorkspaceSnapshotParams): Promise<LocalWorkspaceSnapshot>;
-    diff(before: LocalWorkspaceSnapshot, after: LocalWorkspaceSnapshot): LocalWorkspaceDiff;
-    watch(onEvent: (event: LocalWorkspaceWatchEvent) => void, options?: {
+    snapshot(params?: LocalWorkdirSnapshotParams): Promise<LocalWorkdirSnapshot>;
+    diff(before: LocalWorkdirSnapshot, after: LocalWorkdirSnapshot): LocalWorkdirDiff;
+    watch(onEvent: (event: LocalWorkdirWatchEvent) => void, options?: {
         recursive?: boolean;
-    }): LocalWorkspaceWatcher;
+    }): LocalWorkdirWatcher;
     private scopedListOptions;
     private mergeIgnore;
     private assertAllowed;

package/dist/local/core.js

@@ -22,7 +22,7 @@ export class LocalPathError extends LocalError {
 }
 export class LocalIgnoredPathError extends LocalError {
     constructor(path) {
-        super("local_ignored_path", `local workspace path is ignored: ${path}`, { path });
+        super("local_ignored_path", `local workdir path is ignored: ${path}`, { path });
         this.name = "LocalIgnoredPathError";
     }
 }
@@ -62,9 +62,9 @@ export function createLocalRuntime(options) {
         temp,
         config: new LocalConfigStore(configFiles),
         skills: new LocalSkillStore(data.child("skills")),
-        workspaces: new LocalWorkspaceManager(),
-        workspace(root, workspaceOptions = {}) {
-            return new LocalWorkspace(root, workspaceOptions);
+        workdirs: new LocalWorkdirManager(),
+        workdir(root, workdirOptions = {}) {
+            return new LocalWorkdir(root, workdirOptions);
         },
         async ensure() {
             await Promise.all([data.ensure(), cache.ensure(), logs.ensure(), temp.ensure(), configFiles.ensure()]);
@@ -456,12 +456,12 @@ export class LocalConfigStore {
         return value;
     }
 }
-export class LocalWorkspaceManager {
+export class LocalWorkdirManager {
     open(root, options = {}) {
-        return new LocalWorkspace(root, options);
+        return new LocalWorkdir(root, options);
     }
 }
-export class LocalWorkspace {
+export class LocalWorkdir {
     root;
     name;
     metadata;
@@ -472,11 +472,11 @@ export class LocalWorkspace {
     maxFileBytes;
     constructor(root, options = {}) {
         this.root = path.resolve(root);
-        this.name = options.name?.trim() || path.basename(this.root) || "workspace";
+        this.name = options.name?.trim() || path.basename(this.root) || "workdir";
         this.metadata = { ...(options.metadata ?? {}) };
         this.trusted = options.trusted ?? false;
-        this.files = new LocalFileStore(this.root, { label: "workspace" });
-        this.ignore = [...defaultWorkspaceIgnoreRules(), ...(options.ignore ?? [])];
+        this.files = new LocalFileStore(this.root, { label: "workdir" });
+        this.ignore = [...defaultWorkdirIgnoreRules(), ...(options.ignore ?? [])];
         this.gitignore = options.gitignore ?? true;
         this.maxFileBytes = positiveInt(options.maxFileBytes, 10 * 1024 * 1024);
     }
@@ -503,7 +503,7 @@ export class LocalWorkspace {
         return loaded;
     }
     child(relativePath, options = {}) {
-        return new LocalWorkspace(this.files.resolvePath(relativePath), {
+        return new LocalWorkdir(this.files.resolvePath(relativePath), {
             name: options.name,
             metadata: options.metadata ?? this.metadata,
             trusted: options.trusted ?? this.trusted,
@@ -884,7 +884,7 @@ function ignored(relativePath, ignore) {
 function ignoredDirectoryName(name) {
     return name === ".git" || name === "node_modules" || name === "__pycache__";
 }
-function defaultWorkspaceIgnoreRules() {
+function defaultWorkdirIgnoreRules() {
     return [
         ".git",
         "node_modules",

package/dist/local/tools.d.ts

@@ -1,27 +1,27 @@
 import type { FunctionTool } from "../types/tools.js";
-import type { LocalWorkspace } from "./core.js";
-export type LocalWorkspaceAccessMode = "approval" | "full";
-export type LocalWorkspaceAction = "summarize" | "list" | "search" | "grep" | "read" | "read_lines" | "context" | "snapshot" | "classify_path" | "preview_edits" | "apply_edits" | "write" | "mkdir" | "delete";
-export interface LocalWorkspaceToolRegistryOptions {
-    accessMode?: LocalWorkspaceAccessMode;
+import type { LocalWorkdir } from "./core.js";
+export type LocalWorkdirAccessMode = "approval" | "full";
+export type LocalWorkdirAction = "summarize" | "list" | "search" | "grep" | "read" | "read_lines" | "context" | "snapshot" | "classify_path" | "preview_edits" | "apply_edits" | "write" | "mkdir" | "delete";
+export interface LocalWorkdirToolRegistryOptions {
+    accessMode?: LocalWorkdirAccessMode;
     toolName?: string;
 }
-export interface LocalWorkspaceToolRegistry {
-    readonly workspace: LocalWorkspace;
-    readonly accessMode: LocalWorkspaceAccessMode;
+export interface LocalWorkdirToolRegistry {
+    readonly workdir: LocalWorkdir;
+    readonly accessMode: LocalWorkdirAccessMode;
     readonly toolName: string;
     definitions(): FunctionTool[];
     handlers(): Record<string, (args: Record<string, unknown>) => Promise<Record<string, unknown>>>;
     execute(name: string, args: Record<string, unknown>): Promise<Record<string, unknown>>;
     requiresApproval(name: string, args?: Record<string, unknown>): boolean;
 }
-export interface LocalWorkspaceDriverOptions {
-    accessMode?: LocalWorkspaceAccessMode;
+export interface LocalWorkdirDriverOptions {
+    accessMode?: LocalWorkdirAccessMode;
 }
-export declare class LocalWorkspaceDriver {
-    readonly workspace: LocalWorkspace;
-    readonly accessMode: LocalWorkspaceAccessMode;
-    constructor(workspace: LocalWorkspace, options?: LocalWorkspaceDriverOptions);
+export declare class LocalWorkdirDriver {
+    readonly workdir: LocalWorkdir;
+    readonly accessMode: LocalWorkdirAccessMode;
+    constructor(workdir: LocalWorkdir, options?: LocalWorkdirDriverOptions);
     dispatch(args: Record<string, unknown>): Promise<Record<string, unknown>>;
     requiresApproval(args: Record<string, unknown>): boolean;
     private dispatchApplyEdits;
@@ -29,6 +29,6 @@ export declare class LocalWorkspaceDriver {
     private dispatchMkdir;
     private dispatchDelete;
 }
-export declare function createLocalWorkspaceToolRegistry(workspace: LocalWorkspace, options?: LocalWorkspaceToolRegistryOptions): LocalWorkspaceToolRegistry;
-export declare function localWorkspaceToolDefinition(name?: string): FunctionTool;
-export declare function localWorkspaceToolInstructions(): string;
+export declare function createLocalWorkdirToolRegistry(workdir: LocalWorkdir, options?: LocalWorkdirToolRegistryOptions): LocalWorkdirToolRegistry;
+export declare function localWorkdirToolDefinition(name?: string): FunctionTool;
+export declare function localWorkdirToolInstructions(): string;

package/dist/local/tools.js

@@ -1,34 +1,34 @@
 import { createLocalContextPackage } from "./context.js";
-export class LocalWorkspaceDriver {
-    workspace;
+export 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 createLocalContextPackage(this.workspace, contextPackageArgs(args)));
+                return localToolResult(action, await 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":
@@ -38,73 +38,73 @@ export 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")));
     }
 }
-export function createLocalWorkspaceToolRegistry(workspace, options = {}) {
-    const toolName = options.toolName ?? "local_workspace";
-    const driver = new LocalWorkspaceDriver(workspace, { accessMode: options.accessMode });
-    const definition = localWorkspaceToolDefinition(toolName);
+export 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),
     };
 }
-export function localWorkspaceToolDefinition(name = "local_workspace") {
+export function localWorkdirToolDefinition(name = "local_workdir") {
     return {
         type: "function",
         name,
-        description: localWorkspaceToolDescription,
-        parameters: localWorkspaceToolParameters(),
+        description: localWorkdirToolDescription,
+        parameters: localWorkdirToolParameters(),
         strict: false,
     };
 }
-export function localWorkspaceToolInstructions() {
-    return localWorkspaceToolDescription;
+export function localWorkdirToolInstructions() {
+    return localWorkdirToolDescription;
 }
-const localWorkspaceActions = [
+const localWorkdirActions = [
     "summarize",
     "list",
     "search",
@@ -120,24 +120,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."),
@@ -168,17 +168,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;
 }
@@ -345,7 +345,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/node.d.ts

@@ -1,8 +1,8 @@
 export * from "./index.js";
 export { NodeAgentAPI } from "./node-client.js";
 export { NodeSkillsResource } from "./resources/skills-node.js";
-export { LocalWorkspaceDriver, createLocalWorkspaceToolRegistry, localWorkspaceToolDefinition, localWorkspaceToolInstructions, } from "./local/tools.js";
-export type { LocalWorkspaceAction, LocalWorkspaceAccessMode, LocalWorkspaceToolRegistry, LocalWorkspaceToolRegistryOptions, } from "./local/tools.js";
+export { LocalWorkdirDriver, createLocalWorkdirToolRegistry, localWorkdirToolDefinition, localWorkdirToolInstructions, } from "./local/tools.js";
+export type { LocalWorkdirAction, LocalWorkdirAccessMode, LocalWorkdirToolRegistry, LocalWorkdirToolRegistryOptions, } from "./local/tools.js";
 export { localSkillFromDirectory, pendingLocalSkillCalls, runLocalSkillHandlers } from "./local-skills.js";
 export type { LocalSkillDirectoryOptions } from "./local-skills.js";
 export * from "./local/index.js";

package/dist/node.js

@@ -1,6 +1,6 @@
 export * from "./index.js";
 export { NodeAgentAPI } from "./node-client.js";
 export { NodeSkillsResource } from "./resources/skills-node.js";
-export { LocalWorkspaceDriver, createLocalWorkspaceToolRegistry, localWorkspaceToolDefinition, localWorkspaceToolInstructions, } from "./local/tools.js";
+export { LocalWorkdirDriver, createLocalWorkdirToolRegistry, localWorkdirToolDefinition, localWorkdirToolInstructions, } from "./local/tools.js";
 export { localSkillFromDirectory, pendingLocalSkillCalls, runLocalSkillHandlers } from "./local-skills.js";
 export * from "./local/index.js";

package/dist/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "1.1.5";
-export declare const USER_AGENT = "@agent-api/sdk/1.1.5";
+export declare const VERSION = "1.2.0";
+export declare const USER_AGENT = "@agent-api/sdk/1.2.0";

package/dist/version.js

@@ -1,2 +1,2 @@
-export const VERSION = "1.1.5";
+export const VERSION = "1.2.0";
 export const USER_AGENT = `@agent-api/sdk/${VERSION}`;

package/dist-cjs/local/context.js

@@ -5,7 +5,7 @@ exports.summarizeLocalContextSensitivity = summarizeLocalContextSensitivity;
 const node_crypto_1 = require("node:crypto");
 const promises_1 = require("node:fs/promises");
 const core_js_1 = require("./core.js");
-async function createLocalContextPackage(workspace, params = {}) {
+async function createLocalContextPackage(workdir, params = {}) {
     const basePath = params.path ?? ".";
     const maxFiles = positiveInt(params.maxFiles, 80);
     const maxBytes = positiveInt(params.maxBytes, 256 * 1024);
@@ -16,7 +16,7 @@ async function createLocalContextPackage(workspace, params = {}) {
     const includeSummary = params.includeSummary ?? true;
     const includeSearch = Boolean(params.includeSearch && params.query?.trim());
     const includeSecrets = params.includeSecrets ?? false;
-    const stats = await workspace.list(basePath, { recursive: true });
+    const stats = await workdir.list(basePath, { recursive: true });
     const fileStats = stats
         .filter((item) => item.type === "file")
         .filter((item) => matchesPathFilters(item.path, params.include, params.exclude))
@@ -53,7 +53,7 @@ async function createLocalContextPackage(workspace, params = {}) {
             truncated = true;
             continue;
         }
-        const delivered = await workspace.readFile(item.path, { maxBytes: readBudget });
+        const delivered = await workdir.readFile(item.path, { maxBytes: readBudget });
         includedBytes += delivered.encoding === "text"
             ? Buffer.byteLength(delivered.content ?? "", "utf8")
             : Buffer.byteLength(delivered.content_base64 ?? "", "base64");
@@ -68,7 +68,7 @@ async function createLocalContextPackage(workspace, params = {}) {
             packaged.content_base64 = delivered.content_base64;
         }
         if (includeHashes) {
-            packaged.sha256 = await sha256File(workspace, item.path);
+            packaged.sha256 = await sha256File(workdir, item.path);
         }
         if (delivered.truncated) {
             truncated = true;
@@ -76,7 +76,7 @@ async function createLocalContextPackage(workspace, params = {}) {
         files.push(packaged);
     }
     const summary = includeSummary
-        ? await workspace.summarize({
+        ? await workdir.summarize({
             path: basePath,
             maxFiles,
             previewBytes,
@@ -84,7 +84,7 @@ async function createLocalContextPackage(workspace, params = {}) {
         })
         : undefined;
     const search = includeSearch
-        ? await workspace.grep({
+        ? await workdir.grep({
             pattern: params.query,
             path: basePath,
             limit: maxFiles,
@@ -94,8 +94,8 @@ async function createLocalContextPackage(workspace, params = {}) {
         : undefined;
     return {
         object: "local_context_manifest",
-        root: workspace.root,
-        workspace_name: workspace.name,
+        root: workdir.root,
+        workdir_name: workdir.name,
         generated_at_unix: Math.floor(Date.now() / 1000),
         base_path: basePath,
         file_count: fileStats.length,
@@ -152,7 +152,7 @@ function positiveInt(value, fallback) {
     const parsed = Number(value);
     return Number.isFinite(parsed) && parsed > 0 ? Math.trunc(parsed) : fallback;
 }
-async function sha256File(workspace, relativePath) {
-    const fullPath = workspace.files.resolvePath(relativePath);
+async function sha256File(workdir, relativePath) {
+    const fullPath = workdir.files.resolvePath(relativePath);
     return (0, node_crypto_1.createHash)("sha256").update(await (0, promises_1.readFile)(fullPath)).digest("hex");
 }

package/dist-cjs/local/core.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.LocalSkillStore = exports.LocalWorkspace = exports.LocalWorkspaceManager = exports.LocalConfigStore = exports.LocalFileStore = exports.LocalConfigError = exports.LocalNotTextFileError = exports.LocalFileTooLargeError = exports.LocalIgnoredPathError = exports.LocalPathError = exports.LocalError = void 0;
+exports.LocalSkillStore = exports.LocalWorkdir = exports.LocalWorkdirManager = exports.LocalConfigStore = exports.LocalFileStore = exports.LocalConfigError = exports.LocalNotTextFileError = exports.LocalFileTooLargeError = exports.LocalIgnoredPathError = exports.LocalPathError = exports.LocalError = void 0;
 exports.createLocalRuntime = createLocalRuntime;
 exports.localAppDirs = localAppDirs;
 exports.classifyLocalPathSensitivity = classifyLocalPathSensitivity;
@@ -33,7 +33,7 @@ class LocalPathError extends LocalError {
 exports.LocalPathError = LocalPathError;
 class LocalIgnoredPathError extends LocalError {
     constructor(path) {
-        super("local_ignored_path", `local workspace path is ignored: ${path}`, { path });
+        super("local_ignored_path", `local workdir path is ignored: ${path}`, { path });
         this.name = "LocalIgnoredPathError";
     }
 }
@@ -77,9 +77,9 @@ function createLocalRuntime(options) {
         temp,
         config: new LocalConfigStore(configFiles),
         skills: new LocalSkillStore(data.child("skills")),
-        workspaces: new LocalWorkspaceManager(),
-        workspace(root, workspaceOptions = {}) {
-            return new LocalWorkspace(root, workspaceOptions);
+        workdirs: new LocalWorkdirManager(),
+        workdir(root, workdirOptions = {}) {
+            return new LocalWorkdir(root, workdirOptions);
         },
         async ensure() {
             await Promise.all([data.ensure(), cache.ensure(), logs.ensure(), temp.ensure(), configFiles.ensure()]);
@@ -473,13 +473,13 @@ class LocalConfigStore {
     }
 }
 exports.LocalConfigStore = LocalConfigStore;
-class LocalWorkspaceManager {
+class LocalWorkdirManager {
     open(root, options = {}) {
-        return new LocalWorkspace(root, options);
+        return new LocalWorkdir(root, options);
     }
 }
-exports.LocalWorkspaceManager = LocalWorkspaceManager;
-class LocalWorkspace {
+exports.LocalWorkdirManager = LocalWorkdirManager;
+class LocalWorkdir {
     root;
     name;
     metadata;
@@ -490,11 +490,11 @@ class LocalWorkspace {
     maxFileBytes;
     constructor(root, options = {}) {
         this.root = node_path_1.default.resolve(root);
-        this.name = options.name?.trim() || node_path_1.default.basename(this.root) || "workspace";
+        this.name = options.name?.trim() || node_path_1.default.basename(this.root) || "workdir";
         this.metadata = { ...(options.metadata ?? {}) };
         this.trusted = options.trusted ?? false;
-        this.files = new LocalFileStore(this.root, { label: "workspace" });
-        this.ignore = [...defaultWorkspaceIgnoreRules(), ...(options.ignore ?? [])];
+        this.files = new LocalFileStore(this.root, { label: "workdir" });
+        this.ignore = [...defaultWorkdirIgnoreRules(), ...(options.ignore ?? [])];
         this.gitignore = options.gitignore ?? true;
         this.maxFileBytes = positiveInt(options.maxFileBytes, 10 * 1024 * 1024);
     }
@@ -521,7 +521,7 @@ class LocalWorkspace {
         return loaded;
     }
     child(relativePath, options = {}) {
-        return new LocalWorkspace(this.files.resolvePath(relativePath), {
+        return new LocalWorkdir(this.files.resolvePath(relativePath), {
             name: options.name,
             metadata: options.metadata ?? this.metadata,
             trusted: options.trusted ?? this.trusted,
@@ -731,7 +731,7 @@ class LocalWorkspace {
         }
     }
 }
-exports.LocalWorkspace = LocalWorkspace;
+exports.LocalWorkdir = LocalWorkdir;
 class LocalSkillStore {
     files;
     constructor(files) {
@@ -904,7 +904,7 @@ function ignored(relativePath, ignore) {
 function ignoredDirectoryName(name) {
     return name === ".git" || name === "node_modules" || name === "__pycache__";
 }
-function defaultWorkspaceIgnoreRules() {
+function defaultWorkdirIgnoreRules() {
     return [
         ".git",
         "node_modules",

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,17 @@ 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.LocalWorkdirDriver = 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; } });
+Object.defineProperty(exports, "LocalWorkdirDriver", { enumerable: true, get: function () { return tools_js_1.LocalWorkdirDriver; } });
+Object.defineProperty(exports, "createLocalWorkdirToolRegistry", { enumerable: true, get: function () { return tools_js_1.createLocalWorkdirToolRegistry; } });
+Object.defineProperty(exports, "localWorkdirToolDefinition", { enumerable: true, get: function () { return tools_js_1.localWorkdirToolDefinition; } });
+Object.defineProperty(exports, "localWorkdirToolInstructions", { enumerable: true, get: function () { return tools_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.0";
 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.0",
   "description": "Production JavaScript SDK for the Managed Agent API",
   "license": "MIT",
   "repository": {