@agent-api/sdk 1.0.8 → 1.1.1

package/dist/local/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./core.js";
+export * from "./context.js";

package/dist/local/index.js

@@ -0,0 +1,2 @@
+export * from "./core.js";
+export * from "./context.js";

package/dist/resources/auth.d.ts

@@ -0,0 +1,14 @@
+import type { HTTPClient } from "../internal/http.js";
+import type { ApprovedDeviceAuth, DeviceAuthPollResult, DeviceAuthStart, PollDeviceAuthParams, 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>;
+    waitForDeviceAuth(params: WaitForDeviceAuthParams, options?: RequestOptions): Promise<ApprovedDeviceAuth>;
+}
+export declare class DeviceAuthFlowError extends Error {
+    readonly result?: DeviceAuthPollResult;
+    constructor(message: string, result?: DeviceAuthPollResult);
+}

package/dist/resources/auth.js

@@ -0,0 +1,87 @@
+const defaultDevicePollIntervalSeconds = 5;
+export class AuthResource {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    startDeviceAuth(params = {}, options = {}) {
+        return this.http.request("POST", "/v1/auth/device/start", params, options);
+    }
+    pollDeviceAuth(params, options = {}) {
+        requireDeviceCode(params.device_code);
+        return this.http.request("POST", "/v1/auth/device/poll", params, options);
+    }
+    async waitForDeviceAuth(params, options = {}) {
+        requireDeviceCode(params.device_code);
+        const startedAt = Date.now();
+        for (;;) {
+            throwIfAborted(params.signal);
+            const result = await this.pollDeviceAuth({ device_code: params.device_code }, options);
+            params.on_poll?.(result);
+            if (result.status === "approved" && result.access_token && result.refresh_token) {
+                return result;
+            }
+            if (result.status === "expired" || result.status === "consumed") {
+                throw new DeviceAuthFlowError(result.message || `Device auth ${result.status}`, result);
+            }
+            const timeoutMs = effectiveTimeoutMs(params, result);
+            if (timeoutMs !== undefined && Date.now() - startedAt >= timeoutMs) {
+                throw new DeviceAuthFlowError("Device auth timed out", result);
+            }
+            await sleep(pollDelayMs(params, result), params.signal);
+        }
+    }
+}
+export class DeviceAuthFlowError extends Error {
+    result;
+    constructor(message, result) {
+        super(message);
+        this.name = "DeviceAuthFlowError";
+        this.result = result;
+        Object.setPrototypeOf(this, DeviceAuthFlowError.prototype);
+    }
+}
+function requireDeviceCode(deviceCode) {
+    if (!deviceCode || !deviceCode.trim()) {
+        throw new TypeError("device_code is required");
+    }
+}
+function pollDelayMs(params, result) {
+    const seconds = params.interval_seconds ?? result.interval_seconds ?? defaultDevicePollIntervalSeconds;
+    return Math.max(1, seconds) * 1000;
+}
+function effectiveTimeoutMs(params, result) {
+    if (params.timeout_ms !== undefined) {
+        return Math.max(0, params.timeout_ms);
+    }
+    const expiresAt = result.expires_at;
+    if (!expiresAt)
+        return undefined;
+    return Math.max(0, expiresAt * 1000 - Date.now());
+}
+function sleep(ms, signal) {
+    if (!signal) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+    throwIfAborted(signal);
+    return new Promise((resolve, reject) => {
+        const timeout = setTimeout(cleanupResolve, ms);
+        signal.addEventListener("abort", cleanupReject, { once: true });
+        function cleanupResolve() {
+            signal?.removeEventListener("abort", cleanupReject);
+            resolve();
+        }
+        function cleanupReject() {
+            clearTimeout(timeout);
+            reject(abortError());
+        }
+    });
+}
+function throwIfAborted(signal) {
+    if (signal?.aborted) {
+        throw abortError();
+    }
+}
+function abortError() {
+    return new DOMException("Device auth wait aborted", "AbortError");
+}

package/dist/types/auth.d.ts

@@ -0,0 +1,63 @@
+export type DeviceAuthStatus = "pending" | "approved" | "expired" | "consumed" | string;
+export interface DeviceAuthStart {
+    device_code: string;
+    user_code: string;
+    verification_uri: string;
+    verification_uri_complete: string;
+    expires_at: number;
+    interval_seconds: number;
+}
+export interface AuthSession {
+    access_token: string;
+    refresh_token: string;
+    token_type?: string;
+    access_token_expires_at: number;
+    refresh_token_expires_at?: number;
+    user_id: string;
+    workspace_id: string;
+    workspace_name?: string;
+    workspace_role: string;
+    scopes: string[];
+}
+export interface DeviceAuthPollResult {
+    status: DeviceAuthStatus;
+    message?: string;
+    interval_seconds?: number;
+    expires_at?: number;
+    access_token?: string;
+    refresh_token?: string;
+    token_type?: string;
+    access_token_expires_at?: number;
+    refresh_token_expires_at?: number;
+    user_id?: string;
+    workspace_id?: string;
+    workspace_name?: string;
+    workspace_role?: string;
+    scopes?: string[];
+}
+export type ApprovedDeviceAuth = DeviceAuthPollResult & {
+    status: "approved";
+    access_token: string;
+    refresh_token: string;
+    access_token_expires_at: number;
+    user_id: string;
+    workspace_id: string;
+    workspace_role: string;
+    scopes: string[];
+};
+export interface StartDeviceAuthParams {
+    client_name?: string;
+}
+export interface PollDeviceAuthParams {
+    device_code: string;
+}
+export interface WaitForDeviceAuthParams extends PollDeviceAuthParams {
+    /** Polling interval in seconds. Defaults to the server interval or 5 seconds. */
+    interval_seconds?: number;
+    /** Overall wait timeout in milliseconds. Defaults to the challenge expiry when present. */
+    timeout_ms?: number;
+    /** Optional cancellation signal for CLI/Desktop integrations. */
+    signal?: AbortSignal;
+    /** Called after every poll response, including pending responses. */
+    on_poll?: (result: DeviceAuthPollResult) => void;
+}

package/dist/types/auth.js

@@ -0,0 +1 @@
+export {};

package/dist/types/index.d.ts

@@ -6,3 +6,4 @@ export * from "./streaming.js";
 export * from "./catalog.js";
 export * from "./volumes.js";
 export * from "./skills.js";
+export * from "./auth.js";

package/dist/types/index.js

@@ -6,3 +6,4 @@ export * from "./streaming.js";
 export * from "./catalog.js";
 export * from "./volumes.js";
 export * from "./skills.js";
+export * from "./auth.js";

package/dist/types/responses.d.ts

@@ -2,10 +2,17 @@ import type { AgentCapabilityPreference, ErrorInfo, ModelRoutingMode, ModelRouti
 import type { ContentPart, Input, MemoryOptions, ReasoningConfig, ResponseFormat } from "./input.js";
 import type { LocalSkillDescriptor, SkillReference } from "./skills.js";
 import type { Tool } from "./tools.js";
+export interface CallerContext {
+    timezone?: string;
+    locale?: string;
+    locality?: string;
+    extra?: unknown;
+}
 export interface ResponseCreateParamsBase {
     input: Input;
     instructions?: string;
     language_preference?: string;
+    caller_context?: CallerContext;
     model?: string;
     models?: string[];
     model_routing?: ModelRoutingMode;

package/dist/version.d.ts

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

package/dist/version.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-api/sdk",
-  "version": "1.0.8",
+  "version": "1.1.1",
   "description": "Production JavaScript SDK for the Managed Agent API",
   "license": "MIT",
   "repository": {
@@ -26,6 +26,10 @@
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
+    },
+    "./local": {
+      "types": "./dist/local/index.d.ts",
+      "import": "./dist/local/index.js"
     }
   },
   "files": [
@@ -42,7 +46,7 @@
     "build": "tsc -p tsconfig.json",
     "sync-version": "node scripts/sync-version.mjs",
     "prepack": "npm run sync-version && npm run build",
-    "test": "npm run sync-version && npm run build && node --test test/index.test.mjs test/local-function-integration.test.mjs",
+    "test": "npm run sync-version && npm run build && node --test test/index.test.mjs test/local-function-integration.test.mjs test/local-runtime.test.mjs",
     "test:integration": "npm run sync-version && npm run build && node --test test/integration.test.mjs",
     "test:integration:local-functions": "npm run sync-version && npm run build && node --test test/local-function-integration.test.mjs",
     "check:routes": "node scripts/check-routes.mjs"
@@ -51,6 +55,7 @@
     "node": ">=18"
   },
   "devDependencies": {
+    "@types/node": "^24.0.0",
     "typescript": "^5.0.0"
   }
 }