@agent-api/sdk 1.1.4 → 1.2.0

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/local-skills.js

@@ -31,7 +31,19 @@ export async function localSkillFromDirectory(rootDir, options = {}) {
     };
 }
 export function pendingLocalSkillCalls(response) {
-    return pendingFunctionCalls(response).filter((call) => call.name === "skill_focus");
+    return pendingFunctionCalls(response).filter((call) => isLocalSkillFocusCall(call));
+}
+function isLocalSkillFocusCall(call) {
+    if (call.name !== "skill") {
+        return false;
+    }
+    try {
+        const args = call.arguments ? JSON.parse(call.arguments) : {};
+        return String(args.action || "").trim().toLowerCase() === "focus";
+    }
+    catch {
+        return false;
+    }
 }
 export async function runLocalSkillHandlers(response, localSkills) {
     const byRef = await localSkillsByRef(localSkills);

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/resources/auth.d.ts

@@ -1,13 +1,15 @@
 import type { HTTPClient } from "../internal/http.js";
-import type { ApprovedDeviceAuth, DeviceAuthPollResult, DeviceAuthStart, PollDeviceAuthParams, StartDeviceAuthParams, WaitForDeviceAuthParams } from "../types/auth.js";
+import type { ApprovedDeviceAuth, AuthSession, DeviceAuthPollResult, DeviceAuthStart, PollDeviceAuthParams, RefreshBrowserSessionParams, StartDeviceAuthParams, WaitForDeviceAuthParams } from "../types/auth.js";
 import type { RequestOptions } from "../types/common.js";
 export declare class AuthResource {
     private readonly http;
     constructor(http: HTTPClient);
     startDeviceAuth(params?: StartDeviceAuthParams, options?: RequestOptions): Promise<DeviceAuthStart>;
     pollDeviceAuth(params: PollDeviceAuthParams, options?: RequestOptions): Promise<DeviceAuthPollResult>;
+    refreshBrowserSession(params: RefreshBrowserSessionParams, options?: RequestOptions): Promise<AuthSession>;
     waitForDeviceAuth(params: WaitForDeviceAuthParams, options?: RequestOptions): Promise<ApprovedDeviceAuth>;
 }
+export declare function browserAuthSessionExpiresWithin(session: Pick<AuthSession, "access_token_expires_at">, windowMs?: number, nowMs?: number): boolean;
 export declare class DeviceAuthFlowError extends Error {
     readonly result?: DeviceAuthPollResult;
     constructor(message: string, result?: DeviceAuthPollResult);

package/dist/resources/auth.js

@@ -11,6 +11,16 @@ export class AuthResource {
         requireDeviceCode(params.device_code);
         return this.http.request("POST", "/v1/auth/device/poll", params, options);
     }
+    refreshBrowserSession(params, options = {}) {
+        requireRefreshToken(params.refresh_token);
+        return this.http.request("POST", "/v1/auth/refresh", {}, {
+            ...options,
+            headers: {
+                ...options.headers,
+                Cookie: `agent_api_refresh=${encodeURIComponent(params.refresh_token)}`,
+            },
+        });
+    }
     async waitForDeviceAuth(params, options = {}) {
         requireDeviceCode(params.device_code);
         const startedAt = Date.now();
@@ -32,6 +42,9 @@ export class AuthResource {
         }
     }
 }
+export function browserAuthSessionExpiresWithin(session, windowMs = 60_000, nowMs = Date.now()) {
+    return session.access_token_expires_at * 1000 - nowMs <= windowMs;
+}
 export class DeviceAuthFlowError extends Error {
     result;
     constructor(message, result) {
@@ -46,6 +59,11 @@ function requireDeviceCode(deviceCode) {
         throw new TypeError("device_code is required");
     }
 }
+function requireRefreshToken(refreshToken) {
+    if (!refreshToken || !refreshToken.trim()) {
+        throw new TypeError("refresh_token is required");
+    }
+}
 function pollDelayMs(params, result) {
     const seconds = params.interval_seconds ?? result.interval_seconds ?? defaultDevicePollIntervalSeconds;
     return Math.max(1, seconds) * 1000;

package/dist/types/auth.d.ts

@@ -19,6 +19,9 @@ export interface AuthSession {
     workspace_role: string;
     scopes: string[];
 }
+export interface RefreshBrowserSessionParams {
+    refresh_token: string;
+}
 export interface DeviceAuthPollResult {
     status: DeviceAuthStatus;
     message?: string;

package/dist/types/responses.d.ts

@@ -8,6 +8,9 @@ export interface CallerContext {
     locality?: string;
     extra?: unknown;
 }
+export interface SkillToolOptions {
+    enabled?: boolean;
+}
 export interface ResponseCreateParamsBase {
     input: Input;
     instructions?: string;
@@ -32,6 +35,7 @@ export interface ResponseCreateParamsBase {
     preferred_sites?: string[];
     skills?: SkillReference[];
     local_skills?: LocalSkillDescriptor[];
+    skill_tool?: SkillToolOptions;
     prompt_cache_key?: string;
     memory?: MemoryOptions;
     plan_mode_preference?: AgentCapabilityPreference;

package/dist/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "1.1.4";
-export declare const USER_AGENT = "@agent-api/sdk/1.1.4";
+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.4";
+export const VERSION = "1.2.0";
 export const USER_AGENT = `@agent-api/sdk/${VERSION}`;

package/dist-cjs/client.js

@@ -66,6 +66,7 @@ class AgentAPI {
     }
     startDeviceAuth = (...args) => this.auth.startDeviceAuth(...args);
     pollDeviceAuth = (...args) => this.auth.pollDeviceAuth(...args);
+    refreshBrowserSession = (...args) => this.auth.refreshBrowserSession(...args);
     waitForDeviceAuth = (...args) => this.auth.waitForDeviceAuth(...args);
 }
 exports.AgentAPI = AgentAPI;

package/dist-cjs/index.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.DeviceAuthFlowError = exports.AuthResource = exports.resolvePresetToolsFromCatalog = exports.resolvePresetTools = exports.publicToolToRequestTool = exports.mergeTools = exports.runLocalFunctionHandlers = exports.pendingFunctionCalls = exports.functionCallOutputInput = exports.parseResponseError = exports.isRetryableStatus = exports.RateLimitError = exports.PermissionDeniedError = exports.NotFoundError = exports.InternalServerError = exports.BadRequestError = exports.AuthenticationError = exports.APIStatusError = exports.APIConnectionError = exports.APIError = exports.collectPage = exports.Page = exports.VERSION = exports.DEFAULT_TIMEOUT_MS = exports.DEFAULT_STREAM_TIMEOUT_MS = exports.DEFAULT_MAX_RETRIES = exports.AgentAPI = void 0;
+exports.browserAuthSessionExpiresWithin = exports.DeviceAuthFlowError = exports.AuthResource = exports.resolvePresetToolsFromCatalog = exports.resolvePresetTools = exports.publicToolToRequestTool = exports.mergeTools = exports.runLocalFunctionHandlers = exports.pendingFunctionCalls = exports.functionCallOutputInput = exports.parseResponseError = exports.isRetryableStatus = exports.RateLimitError = exports.PermissionDeniedError = exports.NotFoundError = exports.InternalServerError = exports.BadRequestError = exports.AuthenticationError = exports.APIStatusError = exports.APIConnectionError = exports.APIError = exports.collectPage = exports.Page = exports.VERSION = exports.DEFAULT_TIMEOUT_MS = exports.DEFAULT_STREAM_TIMEOUT_MS = exports.DEFAULT_MAX_RETRIES = exports.AgentAPI = void 0;
 var client_js_1 = require("./client.js");
 Object.defineProperty(exports, "AgentAPI", { enumerable: true, get: function () { return client_js_1.AgentAPI; } });
 Object.defineProperty(exports, "DEFAULT_MAX_RETRIES", { enumerable: true, get: function () { return client_js_1.DEFAULT_MAX_RETRIES; } });
@@ -49,3 +49,4 @@ Object.defineProperty(exports, "resolvePresetToolsFromCatalog", { enumerable: tr
 var auth_js_1 = require("./resources/auth.js");
 Object.defineProperty(exports, "AuthResource", { enumerable: true, get: function () { return auth_js_1.AuthResource; } });
 Object.defineProperty(exports, "DeviceAuthFlowError", { enumerable: true, get: function () { return auth_js_1.DeviceAuthFlowError; } });
+Object.defineProperty(exports, "browserAuthSessionExpiresWithin", { enumerable: true, get: function () { return auth_js_1.browserAuthSessionExpiresWithin; } });

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",