@agent-api/sdk 1.1.3 → 1.1.5

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # Changelog — @agent-api/sdk
 
+## 1.1.5
+
+### Added
+
+- Added browser-session refresh helpers for long-running CLI and desktop integrations: `client.auth.refreshBrowserSession()` and `browserAuthSessionExpiresWithin()`.
+- Added unified local skill tool-call handling for both local skill and function-call response items.
+
+### Changed
+
+- Extended response input types so tool-call continuations can carry function-call metadata consistently.
+
 ## 1.1.2
 
 ### Added

package/README.md

@@ -2,7 +2,7 @@
 
 Production JavaScript/TypeScript SDK for the Managed Agent API.
 
-**Published on npm:** [`@agent-api/sdk`](https://www.npmjs.com/package/@agent-api/sdk) (v1.1.3)
+**Published on npm:** [`@agent-api/sdk`](https://www.npmjs.com/package/@agent-api/sdk) (v1.1.4)
 
 ## Install
 
@@ -40,6 +40,13 @@ The default base URL is `https://api.agentsway.dev` when neither option nor env
 
 ## Package layout
 
+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/node`: Node aggregate entry for local helpers such as `localSkillFromDirectory()` plus `NodeAgentAPI`.
+
 ```
 src/
   client.ts           # AgentAPI entrypoint
@@ -60,8 +67,10 @@ src/
 | `client.presets` | `list` |
 | `client.tools` | `list` |
 | `client.volumes` | `list`, `create`, `retrieve`, `update`, `delete`, `listEntries`, `searchEntries`, `readFile`, `writeFile`, `deletePath`, `reconcileUsage`, `createDirectory`, `downloadArchive`, `summarize`, `readLines`, `patchLines`, `grep` |
-| `client.skills` | `list`, `create`, `discover`, `focus`, `createDev`, `updateFile`, `retrieve`, `update`, `archive`, `delete`, `diff`, `acceptDev`, `discardDev`, `exportArchive`, `importArchive`, `pushDirectory`, `pullDirectory`, `listFiles`, `readFile`, `writeFile`, `deleteFile` |
-| `client.auth` | `startDeviceAuth`, `pollDeviceAuth`, `waitForDeviceAuth` |
+| `client.skills` | `list`, `create`, `discover`, `focus`, `createDev`, `updateFile`, `retrieve`, `update`, `archive`, `delete`, `diff`, `acceptDev`, `discardDev`, `exportArchive`, `importArchive`, `listFiles`, `readFile`, `writeFile`, `deleteFile` |
+| `client.auth` | `startDeviceAuth`, `pollDeviceAuth`, `waitForDeviceAuth`, `refreshBrowserSession` |
+
+`NodeAgentAPI` from `@agent-api/sdk/node` extends `client.skills` with Node-only `pushDirectory` and `pullDirectory`.
 
 ## Browser Device Login
 
@@ -81,6 +90,19 @@ console.log(session.access_token);
 
 The SDK returns URLs and polling helpers only. Opening the browser belongs to the CLI, Electron, Tauri, or native host app.
 
+Long-running local apps can keep browser sessions fresh explicitly:
+
+```typescript
+import { browserAuthSessionExpiresWithin } from "@agent-api/sdk";
+
+if (browserAuthSessionExpiresWithin(session, 5 * 60_000)) {
+  session = await client.auth.refreshBrowserSession({
+    refresh_token: session.refresh_token,
+  });
+  // Persist the refreshed session in your app's secure profile store.
+}
+```
+
 ## Durable Volumes
 
 ```typescript
@@ -127,7 +149,7 @@ For long-running apps, cache `client.presets.list()` and `client.tools.list()` a
 `localSkillFromDirectory()` reads `SKILL.md` into the descriptor for initial local-skill auto-focus; later focused reads still use the local skill tool bridge.
 
 ```typescript
-import { localSkillFromDirectory } from "@agent-api/sdk";
+import { localSkillFromDirectory } from "@agent-api/sdk/node";
 
 const skill = await client.skills.create({ name: "research-helper" });
 await client.skills.writeFile(skill.skill_id, "SKILL.md", "# Research helper\n");

package/dist/client.d.ts

@@ -1,3 +1,4 @@
+import { HTTPClient } from "./internal/http.js";
 import { AuthResource } from "./resources/auth.js";
 import { ModelsResource } from "./resources/models.js";
 import { PresetsResource } from "./resources/presets.js";
@@ -25,10 +26,12 @@ export declare class AgentAPI {
     readonly volumes: VolumesResource;
     readonly skills: SkillsResource;
     readonly auth: AuthResource;
-    private readonly http;
+    protected readonly http: HTTPClient;
     constructor(options?: ClientOptions);
+    protected createSkillsResource(): SkillsResource;
     startDeviceAuth: (...args: Parameters<AuthResource["startDeviceAuth"]>) => Promise<import("./index.js").DeviceAuthStart>;
     pollDeviceAuth: (...args: Parameters<AuthResource["pollDeviceAuth"]>) => Promise<import("./index.js").DeviceAuthPollResult>;
+    refreshBrowserSession: (...args: Parameters<AuthResource["refreshBrowserSession"]>) => Promise<import("./index.js").AuthSession>;
     waitForDeviceAuth: (...args: Parameters<AuthResource["waitForDeviceAuth"]>) => Promise<import("./index.js").ApprovedDeviceAuth>;
 }
 export { VERSION };

package/dist/client.js

@@ -54,11 +54,15 @@ export class AgentAPI {
         this.presets = new PresetsResource(this.http);
         this.tools = new ToolsResource(this.http);
         this.volumes = new VolumesResource(this.http);
-        this.skills = new SkillsResource(this.http);
+        this.skills = this.createSkillsResource();
         this.auth = new AuthResource(this.http);
     }
+    createSkillsResource() {
+        return new SkillsResource(this.http);
+    }
     startDeviceAuth = (...args) => this.auth.startDeviceAuth(...args);
     pollDeviceAuth = (...args) => this.auth.pollDeviceAuth(...args);
+    refreshBrowserSession = (...args) => this.auth.refreshBrowserSession(...args);
     waitForDeviceAuth = (...args) => this.auth.waitForDeviceAuth(...args);
 }
 export { VERSION };

package/dist/index.d.ts

@@ -7,8 +7,4 @@ export { functionCallOutputInput, pendingFunctionCalls, runLocalFunctionHandlers
 export type { LocalFunctionHandler, LocalFunctionHandlers } from "./local-functions.js";
 export { mergeTools, publicToolToRequestTool, resolvePresetTools, resolvePresetToolsFromCatalog, } from "./preset-tools.js";
 export type { PresetToolCatalogClient, ResolvePresetToolsOptions, ResolvePresetToolsResult, UnknownPresetToolBehavior, } from "./preset-tools.js";
-export { LocalWorkspaceDriver, createLocalWorkspaceToolRegistry, localWorkspaceToolDefinition, localWorkspaceToolInstructions, } from "./local/tools.js";
-export type { LocalWorkspaceAction, LocalWorkspaceAccessMode, LocalWorkspaceToolRegistry, LocalWorkspaceToolRegistryOptions, } from "./local/tools.js";
-export { localSkillFromDirectory, pendingLocalSkillCalls, runLocalSkillHandlers } from "./local-skills.js";
-export type { LocalSkillDirectoryOptions } from "./local-skills.js";
-export { AuthResource, DeviceAuthFlowError } from "./resources/auth.js";
+export { AuthResource, DeviceAuthFlowError, browserAuthSessionExpiresWithin } from "./resources/auth.js";

package/dist/index.js

@@ -4,6 +4,4 @@ export { APIError, APIConnectionError, APIStatusError, AuthenticationError, BadR
 export * from "./types/index.js";
 export { functionCallOutputInput, pendingFunctionCalls, runLocalFunctionHandlers, } from "./local-functions.js";
 export { mergeTools, publicToolToRequestTool, resolvePresetTools, resolvePresetToolsFromCatalog, } from "./preset-tools.js";
-export { LocalWorkspaceDriver, createLocalWorkspaceToolRegistry, localWorkspaceToolDefinition, localWorkspaceToolInstructions, } from "./local/tools.js";
-export { localSkillFromDirectory, pendingLocalSkillCalls, runLocalSkillHandlers } from "./local-skills.js";
-export { AuthResource, DeviceAuthFlowError } from "./resources/auth.js";
+export { AuthResource, DeviceAuthFlowError, browserAuthSessionExpiresWithin } from "./resources/auth.js";

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-client.d.ts

@@ -0,0 +1,6 @@
+import { AgentAPI } from "./client.js";
+import { NodeSkillsResource } from "./resources/skills-node.js";
+export declare class NodeAgentAPI extends AgentAPI {
+    readonly skills: NodeSkillsResource;
+    protected createSkillsResource(): NodeSkillsResource;
+}

package/dist/node-client.js

@@ -0,0 +1,7 @@
+import { AgentAPI } from "./client.js";
+import { NodeSkillsResource } from "./resources/skills-node.js";
+export class NodeAgentAPI extends AgentAPI {
+    createSkillsResource() {
+        return new NodeSkillsResource(this.http);
+    }
+}

package/dist/node.d.ts

@@ -0,0 +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 { localSkillFromDirectory, pendingLocalSkillCalls, runLocalSkillHandlers } from "./local-skills.js";
+export type { LocalSkillDirectoryOptions } from "./local-skills.js";
+export * from "./local/index.js";

package/dist/node.js

@@ -0,0 +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 { 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/resources/skills-node.d.ts

@@ -0,0 +1,7 @@
+import { SkillsResource } from "./skills.js";
+import type { RequestOptions } from "../types/common.js";
+import type { PullSkillDirectoryParams, PushSkillDirectoryParams, SkillDirectoryPullResult, SkillImportResponse } from "../types/skills.js";
+export declare class NodeSkillsResource extends SkillsResource {
+    pushDirectory(skillID: string, rootDir: string, params?: PushSkillDirectoryParams, options?: RequestOptions): Promise<SkillImportResponse>;
+    pullDirectory(skillID: string, targetDir: string, params?: PullSkillDirectoryParams, options?: RequestOptions): Promise<SkillDirectoryPullResult>;
+}

package/dist/resources/skills-node.js

@@ -0,0 +1,156 @@
+import { SkillsResource } from "./skills.js";
+export class NodeSkillsResource extends SkillsResource {
+    async pushDirectory(skillID, rootDir, params = {}, options) {
+        const archive = await zipDirectory(rootDir);
+        return this.importArchive(skillID, archive, params, options);
+    }
+    async pullDirectory(skillID, targetDir, params = {}, options) {
+        const archive = await this.exportArchive(skillID, params, options);
+        return extractStoredZipToDirectory(archive.content, targetDir, { replace: params.replace === true });
+    }
+}
+async function zipDirectory(rootDir) {
+    const fs = await import("node:fs/promises");
+    const path = await import("node:path");
+    const root = path.resolve(rootDir);
+    const files = await walkArchiveFiles(fs, path, root, root);
+    const entries = [];
+    for (const rel of files.sort()) {
+        const content = await fs.readFile(path.join(root, rel));
+        entries.push({ path: rel, data: new Uint8Array(content.buffer, content.byteOffset, content.byteLength) });
+    }
+    return createStoredZip(entries);
+}
+async function walkArchiveFiles(fs, path, root, dir) {
+    const entries = await fs.readdir(dir, { withFileTypes: true });
+    const out = [];
+    for (const entry of entries) {
+        if (entry.name === ".git" || entry.name === "__pycache__" || entry.name === "node_modules") {
+            continue;
+        }
+        const full = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            out.push(...await walkArchiveFiles(fs, path, root, full));
+        }
+        else if (entry.isFile()) {
+            out.push(path.relative(root, full).split(path.sep).join("/"));
+        }
+    }
+    return out;
+}
+async function extractStoredZipToDirectory(archive, targetDir, opts) {
+    const fs = await import("node:fs/promises");
+    const path = await import("node:path");
+    const root = path.resolve(targetDir);
+    if (opts.replace) {
+        await fs.rm(root, { recursive: true, force: true });
+    }
+    await fs.mkdir(root, { recursive: true });
+    let fileCount = 0;
+    let byteCount = 0;
+    for (const entry of parseStoredZip(archive)) {
+        const dest = path.resolve(root, entry.path);
+        const rel = path.relative(root, dest);
+        if (rel.startsWith("..") || path.isAbsolute(rel)) {
+            throw new Error(`archive entry escapes target directory: ${entry.path}`);
+        }
+        await fs.mkdir(path.dirname(dest), { recursive: true });
+        await fs.writeFile(dest, entry.data);
+        fileCount += 1;
+        byteCount += entry.data.byteLength;
+    }
+    return { path: root, file_count: fileCount, byte_count: byteCount };
+}
+function createStoredZip(entries) {
+    const encoder = new TextEncoder();
+    const localParts = [];
+    const centralParts = [];
+    let offset = 0;
+    for (const entry of entries) {
+        const name = encoder.encode(entry.path);
+        const crc = crc32(entry.data);
+        const local = new Uint8Array(30 + name.length);
+        const lv = new DataView(local.buffer);
+        lv.setUint32(0, 0x04034b50, true);
+        lv.setUint16(4, 20, true);
+        lv.setUint16(8, 0, true);
+        lv.setUint32(14, crc, true);
+        lv.setUint32(18, entry.data.byteLength, true);
+        lv.setUint32(22, entry.data.byteLength, true);
+        lv.setUint16(26, name.length, true);
+        local.set(name, 30);
+        localParts.push(local, entry.data);
+        const central = new Uint8Array(46 + name.length);
+        const cv = new DataView(central.buffer);
+        cv.setUint32(0, 0x02014b50, true);
+        cv.setUint16(4, 20, true);
+        cv.setUint16(6, 20, true);
+        cv.setUint32(16, crc, true);
+        cv.setUint32(20, entry.data.byteLength, true);
+        cv.setUint32(24, entry.data.byteLength, true);
+        cv.setUint16(28, name.length, true);
+        cv.setUint32(42, offset, true);
+        central.set(name, 46);
+        centralParts.push(central);
+        offset += local.byteLength + entry.data.byteLength;
+    }
+    const centralOffset = offset;
+    const centralSize = centralParts.reduce((sum, part) => sum + part.byteLength, 0);
+    const end = new Uint8Array(22);
+    const ev = new DataView(end.buffer);
+    ev.setUint32(0, 0x06054b50, true);
+    ev.setUint16(8, entries.length, true);
+    ev.setUint16(10, entries.length, true);
+    ev.setUint32(12, centralSize, true);
+    ev.setUint32(16, centralOffset, true);
+    const zip = concatUint8([...localParts, ...centralParts, end]);
+    return zip.buffer.slice(zip.byteOffset, zip.byteOffset + zip.byteLength);
+}
+function parseStoredZip(archive) {
+    const data = new Uint8Array(archive);
+    const view = new DataView(data.buffer, data.byteOffset, data.byteLength);
+    const entries = [];
+    let pos = 0;
+    const decoder = new TextDecoder();
+    while (pos + 4 <= data.byteLength && view.getUint32(pos, true) === 0x04034b50) {
+        const method = view.getUint16(pos + 8, true);
+        if (method !== 0) {
+            throw new Error("Only stored ZIP entries are supported by pullDirectory");
+        }
+        const compressedSize = view.getUint32(pos + 18, true);
+        const fileNameLength = view.getUint16(pos + 26, true);
+        const extraLength = view.getUint16(pos + 28, true);
+        const nameStart = pos + 30;
+        const contentStart = nameStart + fileNameLength + extraLength;
+        const contentEnd = contentStart + compressedSize;
+        if (contentEnd > data.byteLength) {
+            throw new Error("Invalid ZIP archive");
+        }
+        const name = decoder.decode(data.slice(nameStart, nameStart + fileNameLength)).replace(/\\/g, "/");
+        if (name && !name.endsWith("/") && !name.startsWith("__MACOSX/") && !name.split("/").includes("..")) {
+            entries.push({ path: name.replace(/^\/+/, ""), data: data.slice(contentStart, contentEnd) });
+        }
+        pos = contentEnd;
+    }
+    return entries;
+}
+function concatUint8(parts) {
+    const total = parts.reduce((sum, part) => sum + part.byteLength, 0);
+    const out = new Uint8Array(total);
+    let offset = 0;
+    for (const part of parts) {
+        out.set(part, offset);
+        offset += part.byteLength;
+    }
+    return out;
+}
+function crc32(data) {
+    let crc = 0xffffffff;
+    for (const byte of data) {
+        crc ^= byte;
+        for (let i = 0; i < 8; i += 1) {
+            crc = (crc >>> 1) ^ (0xedb88320 & -(crc & 1));
+        }
+    }
+    return (crc ^ 0xffffffff) >>> 0;
+}

package/dist/resources/skills.d.ts

@@ -1,6 +1,6 @@
 import type { HTTPClient } from "../internal/http.js";
 import type { RequestOptions } from "../types/common.js";
-import type { CreateSkillParams, CreateSkillDevParams, CreateSkillDevResponse, DiscoverSkillsParams, FocusSkillParams, ImportSkillArchiveParams, ListSkillFilesParams, ListSkillFilesResponse, ListSkillsParams, ListSkillsResponse, ListSkillSummariesResponse, PullSkillDirectoryParams, PushSkillDirectoryParams, Skill, SkillAcceptStrategy, SkillArchive, SkillArchiveParams, SkillBranchDiff, SkillBranchDiffParams, SkillDirectoryPullResult, SkillFile, SkillBranch, SkillFocusResponse, SkillImportResponse, UpdateSkillFilePrimitiveParams, UpdateSkillFilePrimitiveResponse, UpdateSkillParams } from "../types/skills.js";
+import type { CreateSkillParams, CreateSkillDevParams, CreateSkillDevResponse, DiscoverSkillsParams, FocusSkillParams, ImportSkillArchiveParams, ListSkillFilesParams, ListSkillFilesResponse, ListSkillsParams, ListSkillsResponse, ListSkillSummariesResponse, Skill, SkillAcceptStrategy, SkillArchive, SkillArchiveParams, SkillBranchDiff, SkillBranchDiffParams, SkillFile, SkillBranch, SkillFocusResponse, SkillImportResponse, UpdateSkillFilePrimitiveParams, UpdateSkillFilePrimitiveResponse, UpdateSkillParams } from "../types/skills.js";
 export declare class SkillsResource {
     private readonly http;
     constructor(http: HTTPClient);
@@ -35,6 +35,4 @@ export declare class SkillsResource {
     exportArchive(skillID: string, params?: SkillArchiveParams, options?: RequestOptions): Promise<SkillArchive>;
     importArchive(skillID: string, archive: ArrayBuffer | Blob, params?: ImportSkillArchiveParams, options?: RequestOptions): Promise<SkillImportResponse>;
     diff(skillID: string, params?: SkillBranchDiffParams, options?: RequestOptions): Promise<SkillBranchDiff>;
-    pushDirectory(skillID: string, rootDir: string, params?: PushSkillDirectoryParams, options?: RequestOptions): Promise<SkillImportResponse>;
-    pullDirectory(skillID: string, targetDir: string, params?: PullSkillDirectoryParams, options?: RequestOptions): Promise<SkillDirectoryPullResult>;
 }

package/dist/resources/skills.js

@@ -95,14 +95,6 @@ export class SkillsResource {
             include_unchanged: params.include_unchanged ? "true" : undefined,
         })}`, undefined, options);
     }
-    async pushDirectory(skillID, rootDir, params = {}, options) {
-        const archive = await zipDirectory(rootDir);
-        return this.importArchive(skillID, archive, params, options);
-    }
-    async pullDirectory(skillID, targetDir, params = {}, options) {
-        const archive = await this.exportArchive(skillID, params, options);
-        return extractStoredZipToDirectory(archive.content, targetDir, { replace: params.replace === true });
-    }
 }
 function skillPath(path) {
     return path
@@ -114,148 +106,3 @@ function skillPath(path) {
 function normalizeArchivePath(path) {
     return (path ?? "").trim().replace(/^\/+|\/+$/g, "");
 }
-async function zipDirectory(rootDir) {
-    const fs = await import("node:fs/promises");
-    const path = await import("node:path");
-    const root = path.resolve(rootDir);
-    const files = await walkArchiveFiles(fs, path, root, root);
-    const entries = [];
-    for (const rel of files.sort()) {
-        const content = await fs.readFile(path.join(root, rel));
-        entries.push({ path: rel, data: new Uint8Array(content.buffer, content.byteOffset, content.byteLength) });
-    }
-    return createStoredZip(entries);
-}
-async function walkArchiveFiles(fs, path, root, dir) {
-    const entries = await fs.readdir(dir, { withFileTypes: true });
-    const out = [];
-    for (const entry of entries) {
-        if (entry.name === ".git" || entry.name === "__pycache__" || entry.name === "node_modules") {
-            continue;
-        }
-        const full = path.join(dir, entry.name);
-        if (entry.isDirectory()) {
-            out.push(...await walkArchiveFiles(fs, path, root, full));
-        }
-        else if (entry.isFile()) {
-            out.push(path.relative(root, full).split(path.sep).join("/"));
-        }
-    }
-    return out;
-}
-async function extractStoredZipToDirectory(archive, targetDir, opts) {
-    const fs = await import("node:fs/promises");
-    const path = await import("node:path");
-    const root = path.resolve(targetDir);
-    if (opts.replace) {
-        await fs.rm(root, { recursive: true, force: true });
-    }
-    await fs.mkdir(root, { recursive: true });
-    let fileCount = 0;
-    let byteCount = 0;
-    for (const entry of parseStoredZip(archive)) {
-        const dest = path.resolve(root, entry.path);
-        const rel = path.relative(root, dest);
-        if (rel.startsWith("..") || path.isAbsolute(rel)) {
-            throw new Error(`archive entry escapes target directory: ${entry.path}`);
-        }
-        await fs.mkdir(path.dirname(dest), { recursive: true });
-        await fs.writeFile(dest, entry.data);
-        fileCount += 1;
-        byteCount += entry.data.byteLength;
-    }
-    return { path: root, file_count: fileCount, byte_count: byteCount };
-}
-function createStoredZip(entries) {
-    const encoder = new TextEncoder();
-    const localParts = [];
-    const centralParts = [];
-    let offset = 0;
-    for (const entry of entries) {
-        const name = encoder.encode(entry.path);
-        const crc = crc32(entry.data);
-        const local = new Uint8Array(30 + name.length);
-        const lv = new DataView(local.buffer);
-        lv.setUint32(0, 0x04034b50, true);
-        lv.setUint16(4, 20, true);
-        lv.setUint16(8, 0, true);
-        lv.setUint32(14, crc, true);
-        lv.setUint32(18, entry.data.byteLength, true);
-        lv.setUint32(22, entry.data.byteLength, true);
-        lv.setUint16(26, name.length, true);
-        local.set(name, 30);
-        localParts.push(local, entry.data);
-        const central = new Uint8Array(46 + name.length);
-        const cv = new DataView(central.buffer);
-        cv.setUint32(0, 0x02014b50, true);
-        cv.setUint16(4, 20, true);
-        cv.setUint16(6, 20, true);
-        cv.setUint32(16, crc, true);
-        cv.setUint32(20, entry.data.byteLength, true);
-        cv.setUint32(24, entry.data.byteLength, true);
-        cv.setUint16(28, name.length, true);
-        cv.setUint32(42, offset, true);
-        central.set(name, 46);
-        centralParts.push(central);
-        offset += local.byteLength + entry.data.byteLength;
-    }
-    const centralOffset = offset;
-    const centralSize = centralParts.reduce((sum, part) => sum + part.byteLength, 0);
-    const end = new Uint8Array(22);
-    const ev = new DataView(end.buffer);
-    ev.setUint32(0, 0x06054b50, true);
-    ev.setUint16(8, entries.length, true);
-    ev.setUint16(10, entries.length, true);
-    ev.setUint32(12, centralSize, true);
-    ev.setUint32(16, centralOffset, true);
-    const zip = concatUint8([...localParts, ...centralParts, end]);
-    return zip.buffer.slice(zip.byteOffset, zip.byteOffset + zip.byteLength);
-}
-function parseStoredZip(archive) {
-    const data = new Uint8Array(archive);
-    const view = new DataView(data.buffer, data.byteOffset, data.byteLength);
-    const entries = [];
-    let pos = 0;
-    const decoder = new TextDecoder();
-    while (pos + 4 <= data.byteLength && view.getUint32(pos, true) === 0x04034b50) {
-        const method = view.getUint16(pos + 8, true);
-        if (method !== 0) {
-            throw new Error("Only stored ZIP entries are supported by pullDirectory");
-        }
-        const compressedSize = view.getUint32(pos + 18, true);
-        const fileNameLength = view.getUint16(pos + 26, true);
-        const extraLength = view.getUint16(pos + 28, true);
-        const nameStart = pos + 30;
-        const contentStart = nameStart + fileNameLength + extraLength;
-        const contentEnd = contentStart + compressedSize;
-        if (contentEnd > data.byteLength) {
-            throw new Error("Invalid ZIP archive");
-        }
-        const name = decoder.decode(data.slice(nameStart, nameStart + fileNameLength)).replace(/\\/g, "/");
-        if (name && !name.endsWith("/") && !name.startsWith("__MACOSX/") && !name.split("/").includes("..")) {
-            entries.push({ path: name.replace(/^\/+/, ""), data: data.slice(contentStart, contentEnd) });
-        }
-        pos = contentEnd;
-    }
-    return entries;
-}
-function concatUint8(parts) {
-    const total = parts.reduce((sum, part) => sum + part.byteLength, 0);
-    const out = new Uint8Array(total);
-    let offset = 0;
-    for (const part of parts) {
-        out.set(part, offset);
-        offset += part.byteLength;
-    }
-    return out;
-}
-function crc32(data) {
-    let crc = 0xffffffff;
-    for (const byte of data) {
-        crc ^= byte;
-        for (let i = 0; i < 8; i += 1) {
-            crc = (crc >>> 1) ^ (0xedb88320 & -(crc & 1));
-        }
-    }
-    return (crc ^ 0xffffffff) >>> 0;
-}

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.3";
-export declare const USER_AGENT = "@agent-api/sdk/1.1.3";
+export declare const VERSION = "1.1.5";
+export declare const USER_AGENT = "@agent-api/sdk/1.1.5";

package/dist/version.js

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