@agent-api/sdk 1.1.4 → 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

@@ -68,7 +68,7 @@ src/
 | `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`, `listFiles`, `readFile`, `writeFile`, `deleteFile` |
-| `client.auth` | `startDeviceAuth`, `pollDeviceAuth`, `waitForDeviceAuth` |
+| `client.auth` | `startDeviceAuth`, `pollDeviceAuth`, `waitForDeviceAuth`, `refreshBrowserSession` |
 
 `NodeAgentAPI` from `@agent-api/sdk/node` extends `client.skills` with Node-only `pushDirectory` and `pullDirectory`.
 
@@ -90,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

package/dist/client.d.ts

@@ -31,6 +31,7 @@ export declare class AgentAPI {
     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

@@ -62,6 +62,7 @@ export 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);
 }
 export { VERSION };

package/dist/index.d.ts

@@ -7,4 +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 { AuthResource, DeviceAuthFlowError } from "./resources/auth.js";
+export { AuthResource, DeviceAuthFlowError, browserAuthSessionExpiresWithin } from "./resources/auth.js";

package/dist/index.js

@@ -4,4 +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 { 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/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.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.4";
+export const VERSION = "1.1.5";
 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-skills.js

@@ -69,7 +69,19 @@ async function localSkillFromDirectory(rootDir, options = {}) {
     };
 }
 function pendingLocalSkillCalls(response) {
-    return (0, local_functions_js_1.pendingFunctionCalls)(response).filter((call) => call.name === "skill_focus");
+    return (0, local_functions_js_1.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;
+    }
 }
 async function runLocalSkillHandlers(response, localSkills) {
     const byRef = await localSkillsByRef(localSkills);

package/dist-cjs/resources/auth.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DeviceAuthFlowError = exports.AuthResource = void 0;
+exports.browserAuthSessionExpiresWithin = browserAuthSessionExpiresWithin;
 const defaultDevicePollIntervalSeconds = 5;
 class AuthResource {
     http;
@@ -14,6 +15,16 @@ 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();
@@ -36,6 +47,9 @@ class AuthResource {
     }
 }
 exports.AuthResource = AuthResource;
+function browserAuthSessionExpiresWithin(session, windowMs = 60_000, nowMs = Date.now()) {
+    return session.access_token_expires_at * 1000 - nowMs <= windowMs;
+}
 class DeviceAuthFlowError extends Error {
     result;
     constructor(message, result) {
@@ -51,6 +65,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-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.4";
+exports.VERSION = "1.1.5";
 exports.USER_AGENT = `@agent-api/sdk/${exports.VERSION}`;

package/package.json

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