@agent-os-sdk/client 0.3.14 → 0.4.0

package/dist/modules/threads.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"threads.d.ts","sourceRoot":"","sources":["../../src/modules/threads.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"threads.d.ts","sourceRoot":"","sources":["../../src/modules/threads.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAGhF,MAAM,WAAW,MAAM;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,aAAa;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,OAAO,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,aAAa;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,OAAO,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;IACrD,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,UAAU,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,SAAS;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,MAAM,kBAAkB,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;AAC3D,MAAM,MAAM,sBAAsB,GAAG,iBAAiB,CAAC,aAAa,CAAC,CAAC;AACtE,MAAM,MAAM,kBAAkB,GAAG,iBAAiB,CAAC,SAAS,CAAC,CAAC;AAE9D,MAAM,WAAW,oBAAoB;IACjC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,qBAAa,aAAa;IACV,OAAO,CAAC,MAAM;IAAa,OAAO,CAAC,OAAO;gBAAlC,MAAM,EAAE,SAAS,EAAU,OAAO,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAIpF;;;;;;;;;;;OAWG;IACG,MAAM,CAAC,IAAI,CAAC,EAAE;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,wBAAwB,CAAC,EAAE,MAAM,CAAC;QAClC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACnC,qHAAqH;QACrH,eAAe,CAAC,EAAE,MAAM,CAAC;KAC5B,GAAG,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAahC;;;;;;OAMG;IACG,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAOzD;;;;;;OAMG;IACG,IAAI,CAAC,MAAM,CAAC,EAAE,gBAAgB,GAAG;QACnC,YAAY,CAAC,EAAE,MAAM,CAAC;KACzB,GAAG,OAAO,CAAC,WAAW,CAAC,kBAAkB,CAAC,CAAC;IAO5C;;;;;;;;;OASG;IACI,OAAO,CACV,OAAO,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,EACnC,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GACzE,cAAc,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC;IA8BxC;;OAEG;IACG,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IAS1D;;;;;;OAMG;IACG,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;IAOnE,mDAAmD;IACnD,KAAK,GAAI,UAAU,MAAM,uCAA6B;IAItD;;OAEG;IACG,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC;IAOvE,uDAAuD;IACvD,OAAO,GAAI,UAAU,MAAM,yCAA+B;IAI1D;;;;;;OAMG;IACG,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,gBAAgB,GAAG;QACxD,MAAM,CAAC,EAAE,MAAM,CAAA;KAClB,GAAG,OAAO,CAAC,WAAW,CAAC,kBAAkB,CAAC,CAAC;IAO5C,iDAAiD;IACjD,IAAI,GAAI,UAAU,MAAM,EAAE,SAAS,gBAAgB,GAAG;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,8CACtC;IAEnC;;OAEG;IACG,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE;QACpC,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,eAAe,CAAC,EAAE,MAAM,CAAC;KAC5B,GAAG,OAAO,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;IAUnC;;;;;;OAMG;IACG,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,WAAW,CAAC,sBAAsB,CAAC,CAAC;IAO5G,yDAAyD;IACzD,QAAQ,GAAI,UAAU,MAAM,EAAE,SAAS,gBAAgB,kDAAwC;IAE/F;;OAEG;IACG,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE;QACrC,IAAI,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,WAAW,CAAC;QACxC,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACtC,GAAG,OAAO,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC;IAUvC;;OAEG;IACG,MAAM,CAAC,IAAI,EAAE;QACf,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,OAAO,CAAC;KACvB,GAAG,gBAAgB,GAAG,OAAO,CAAC,WAAW,CAAC,oBAAoB,CAAC,CAAC;IASjE;;OAEG;IACG,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAUhG;;OAEG;IACG,KAAK,CAAC,IAAI,EAAE;QACd,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,OAAO,CAAC,EAAE,OAAO,CAAC;KACrB,GAAG,gBAAgB,GAAG,OAAO,CAAC,WAAW,CAAC,mBAAmB,CAAC,CAAC;CAMnE"}

package/dist/modules/threads.js

@@ -21,12 +21,22 @@ export class ThreadsModule {
      * @example
      * ```ts
      * const { data: thread } = await client.threads.create();
+     *
+     * // With idempotency (safe to retry)
+     * const { data: thread } = await client.threads.create({
+     *   idempotency_key: "my-unique-key"
+     * });
      * ```
      */
     async create(body) {
+        // Send Idempotency-Key in HEADER (enterprise standard) + body (backend compat)
+        const headers = { ...this.headers() };
+        if (body?.idempotency_key) {
+            headers["Idempotency-Key"] = body.idempotency_key;
+        }
         return this.client.POST("/v1/api/threads", {
             body: body ?? {},
-            headers: this.headers(),
+            headers,
         });
     }
     /**
@@ -55,6 +65,43 @@ export class ThreadsModule {
             headers: this.headers(),
         });
     }
+    /**
+     * Iterate through all threads with automatic pagination.
+     *
+     * @example
+     * ```ts
+     * for await (const thread of client.threads.iterate()) {
+     *     console.log(thread.id);
+     * }
+     * ```
+     */
+    async *iterate(filters, options) {
+        const pageSize = options?.pageSize ?? 100;
+        const maxItems = options?.maxItems ?? Infinity;
+        let offset = 0;
+        let yielded = 0;
+        let hasMore = true;
+        while (hasMore && yielded < maxItems) {
+            if (options?.signal?.aborted)
+                return;
+            const response = await this.list({
+                ...filters,
+                limit: Math.min(pageSize, maxItems - yielded),
+                offset,
+            });
+            if (response.error)
+                throw response.error;
+            const data = response.data;
+            for (const thread of data.items) {
+                if (yielded >= maxItems)
+                    return;
+                yield thread;
+                yielded++;
+            }
+            offset += data.items.length;
+            hasMore = offset < data.total && data.items.length > 0;
+        }
+    }
     /**
      * Delete a thread.
      */

package/dist/sse/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/sse/client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/sse/client.ts"],"names":[],"mappings":"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"}

package/dist/sse/client.js

@@ -31,6 +31,8 @@ export async function* parseSSE(response, options) {
     const reader = response.body.getReader();
     const decoder = new TextDecoder();
     let buffer = "";
+    // State must be maintained across chunks
+    let currentEvent = { event: "message" };
     try {
         while (true) {
             const { done, value } = await reader.read();
@@ -38,15 +40,29 @@ export async function* parseSSE(response, options) {
                 break;
             buffer += decoder.decode(value, { stream: true });
             const lines = buffer.split("\n");
+            // Keep the last partial line in the buffer
             buffer = lines.pop() ?? "";
-            let currentEvent = { event: "message" };
             for (const line of lines) {
+                const trimmed = line.trim();
+                if (trimmed === "") {
+                    // Empty line triggers event dispatch if we have data
+                    if (currentEvent.data !== undefined) {
+                        yield currentEvent;
+                    }
+                    // Reset for next event
+                    currentEvent = { event: "message" };
+                    continue;
+                }
                 if (line.startsWith("event:")) {
                     currentEvent.event = line.slice(6).trim();
                 }
                 else if (line.startsWith("data:")) {
                     const dataStr = line.slice(5).trim();
                     try {
+                        // Accumulate data if meaningful (though standard SSE usually has one data line per event, 
+                        // multiline data is possible but rare in this specific protocol. 
+                        // For simplicity and matching current backend, we overwrite or concatenation check could be stricter).
+                        // Given strict JSON protocol, we assume valid info per data line or single data line.
                         currentEvent.data = JSON.parse(dataStr);
                     }
                     catch {
@@ -59,10 +75,6 @@ export async function* parseSSE(response, options) {
                 else if (line.startsWith("retry:")) {
                     currentEvent.retry = parseInt(line.slice(6).trim(), 10);
                 }
-                else if (line === "" && currentEvent.data !== undefined) {
-                    yield currentEvent;
-                    currentEvent = { event: "message" };
-                }
             }
         }
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-os-sdk/client",
-  "version": "0.3.14",
+  "version": "0.4.0",
   "description": "Official TypeScript SDK for Agent OS platform",
   "type": "module",
   "main": "./dist/index.js",

package/src/client/AgentOsClient.ts

@@ -264,14 +264,11 @@ export class AgentOsClient {
                 headers["Authorization"] = `Bearer ${token}`;
             }
 
-            // CRITICAL: Workspace ID is REQUIRED for JWT auth
-            if (!workspaceId) {
-                throw new Error(
-                    "[AgentOS SDK] No active workspace selected. " +
-                    "Call getWorkspaceId() must return a valid workspace ID."
-                );
+            // Workspace ID is optional for bootstrap endpoints (e.g., /me)
+            // Most endpoints require it, but the header provider allows empty strings
+            if (workspaceId) {
+                headers["X-Workspace-Id"] = workspaceId;
             }
-            headers["X-Workspace-Id"] = workspaceId;
             // NO X-Tenant-Id (backend derives from workspace membership)
         }
 

package/src/client/config.ts

@@ -0,0 +1,100 @@
+/**
+ * Agent OS SDK - Network Configuration
+ * 
+ * Centralized configuration for timeouts, retries, and network policies.
+ */
+
+/**
+ * Retry configuration for network requests.
+ */
+export interface RetryConfig {
+    /** Maximum retry attempts (default: 3) */
+    maxRetries: number;
+
+    /** Base delay between retries in ms (default: 1000) */
+    baseDelayMs: number;
+
+    /** Maximum delay between retries in ms (default: 30000) */
+    maxDelayMs: number;
+
+    /** Jitter factor to prevent thundering herd (0-1, default: 0.2) */
+    jitterFactor: number;
+
+    /** HTTP status codes that trigger retry (default: [408, 429, 500, 502, 503, 504]) */
+    retryableStatuses: number[];
+}
+
+/**
+ * Full network configuration for the SDK client.
+ */
+export interface NetworkConfig {
+    /** Timeout per request attempt in milliseconds (default: 30000) */
+    timeoutMs: number;
+
+    /** Retry configuration */
+    retry: RetryConfig;
+}
+
+/**
+ * Default network configuration.
+ * Balanced for most use cases - 30s timeout, 3 retries with exponential backoff.
+ */
+export const DEFAULT_NETWORK_CONFIG: NetworkConfig = {
+    timeoutMs: 30_000,
+    retry: {
+        maxRetries: 3,
+        baseDelayMs: 1_000,
+        maxDelayMs: 30_000,
+        jitterFactor: 0.2,
+        retryableStatuses: [408, 429, 500, 502, 503, 504],
+    },
+};
+
+/**
+ * Aggressive configuration for interactive UIs.
+ * Shorter timeouts, fewer retries.
+ */
+export const INTERACTIVE_NETWORK_CONFIG: NetworkConfig = {
+    timeoutMs: 10_000,
+    retry: {
+        maxRetries: 1,
+        baseDelayMs: 500,
+        maxDelayMs: 5_000,
+        jitterFactor: 0.1,
+        retryableStatuses: [429, 503, 504],
+    },
+};
+
+/**
+ * Patient configuration for background jobs.
+ * Longer timeouts, more retries.
+ */
+export const BACKGROUND_NETWORK_CONFIG: NetworkConfig = {
+    timeoutMs: 120_000,
+    retry: {
+        maxRetries: 5,
+        baseDelayMs: 2_000,
+        maxDelayMs: 60_000,
+        jitterFactor: 0.3,
+        retryableStatuses: [408, 429, 500, 502, 503, 504],
+    },
+};
+
+/**
+ * Merges user config with defaults.
+ */
+export function mergeNetworkConfig(
+    userConfig?: Partial<NetworkConfig>
+): NetworkConfig {
+    if (!userConfig) {
+        return DEFAULT_NETWORK_CONFIG;
+    }
+
+    return {
+        timeoutMs: userConfig.timeoutMs ?? DEFAULT_NETWORK_CONFIG.timeoutMs,
+        retry: {
+            ...DEFAULT_NETWORK_CONFIG.retry,
+            ...userConfig.retry,
+        },
+    };
+}

package/src/client/pagination.ts

@@ -0,0 +1,218 @@
+/**
+ * Agent OS SDK - Pagination Utilities
+ * 
+ * Auto-paginating iterators that support both offset and cursor pagination.
+ * Designed to work with any list endpoint.
+ */
+
+import type { APIResponse } from "./raw.js";
+
+// ============================================================================
+// Response Types
+// ============================================================================
+
+/**
+ * Offset-based paginated response.
+ * Most common format for list endpoints.
+ */
+export interface OffsetPaginatedResponse<T> {
+    items: T[];
+    total: number;
+}
+
+/**
+ * Cursor-based paginated response.
+ * Better for large datasets and real-time consistency.
+ */
+export interface CursorPaginatedResponse<T> {
+    items: T[];
+    next_cursor?: string;
+    has_more: boolean;
+}
+
+/**
+ * Union type for both pagination styles.
+ */
+export type PaginatedResponse<T> =
+    | OffsetPaginatedResponse<T>
+    | CursorPaginatedResponse<T>;
+
+// ============================================================================
+// Parameter Types
+// ============================================================================
+
+/**
+ * Offset pagination parameters.
+ */
+export interface OffsetParams {
+    limit?: number;
+    offset?: number;
+}
+
+/**
+ * Cursor pagination parameters.
+ */
+export interface CursorParams {
+    limit?: number;
+    after?: string;
+}
+
+/**
+ * Combined pagination parameters.
+ */
+export type PaginationParams = OffsetParams | CursorParams;
+
+// ============================================================================
+// Type Guards
+// ============================================================================
+
+/**
+ * Checks if response uses cursor pagination.
+ */
+function isCursorResponse<T>(response: PaginatedResponse<T>): response is CursorPaginatedResponse<T> {
+    return "has_more" in response;
+}
+
+// ============================================================================
+// Paginate Function
+// ============================================================================
+
+/**
+ * Options for pagination behavior.
+ */
+export interface PaginateOptions {
+    /** Number of items per page (default: 100) */
+    pageSize?: number;
+
+    /** Maximum total items to fetch (default: unlimited) */
+    maxItems?: number;
+
+    /** AbortSignal for cancellation */
+    signal?: AbortSignal;
+}
+
+/**
+ * Creates an async iterator that automatically paginates through results.
+ * Supports both offset and cursor pagination transparently.
+ * 
+ * @example
+ * // Basic usage
+ * for await (const run of paginate(
+ *     (p) => client.runs.list(p),
+ *     { status: "completed" }
+ * )) {
+ *     console.log(run.id);
+ * }
+ * 
+ * @example
+ * // With options
+ * for await (const agent of paginate(
+ *     (p) => client.agents.list(p),
+ *     { workspace_id: "ws_123" },
+ *     { pageSize: 50, maxItems: 200 }
+ * )) {
+ *     console.log(agent.name);
+ * }
+ */
+export async function* paginate<T, P extends PaginationParams>(
+    fetchPage: (params: P) => Promise<APIResponse<PaginatedResponse<T>>>,
+    baseParams: Omit<P, "limit" | "offset" | "after">,
+    options?: PaginateOptions
+): AsyncGenerator<T, void, unknown> {
+    const pageSize = options?.pageSize ?? 100;
+    const maxItems = options?.maxItems ?? Infinity;
+    const signal = options?.signal;
+
+    let offset = 0;
+    let cursor: string | undefined;
+    let hasMore = true;
+    let yielded = 0;
+
+    while (hasMore && yielded < maxItems) {
+        // Check for cancellation
+        if (signal?.aborted) {
+            return;
+        }
+
+        // Build params based on pagination style
+        const params = {
+            ...baseParams,
+            limit: Math.min(pageSize, maxItems - yielded),
+            ...(cursor !== undefined ? { after: cursor } : { offset }),
+        } as P;
+
+        const response = await fetchPage(params);
+
+        if (response.error) {
+            throw response.error;
+        }
+
+        const data = response.data!;
+
+        for (const item of data.items) {
+            if (yielded >= maxItems) {
+                return;
+            }
+            yield item;
+            yielded++;
+        }
+
+        // Update pagination state based on response type
+        if (isCursorResponse(data)) {
+            cursor = data.next_cursor;
+            hasMore = data.has_more && data.items.length > 0;
+        } else {
+            offset += data.items.length;
+            hasMore = offset < data.total && data.items.length > 0;
+        }
+    }
+}
+
+// ============================================================================
+// Collect Utility
+// ============================================================================
+
+/**
+ * Collects all items from a paginated endpoint into an array.
+ * Useful when you need all items at once.
+ * 
+ * @example
+ * const allRuns = await collectAll(
+ *     (p) => client.runs.list(p),
+ *     { status: "completed" },
+ *     { maxItems: 1000 }
+ * );
+ */
+export async function collectAll<T, P extends PaginationParams>(
+    fetchPage: (params: P) => Promise<APIResponse<PaginatedResponse<T>>>,
+    baseParams: Omit<P, "limit" | "offset" | "after">,
+    options?: PaginateOptions
+): Promise<T[]> {
+    const items: T[] = [];
+
+    for await (const item of paginate(fetchPage, baseParams, options)) {
+        items.push(item);
+    }
+
+    return items;
+}
+
+/**
+ * Gets the first item from a paginated endpoint.
+ * More efficient than collecting all items when you only need one.
+ * 
+ * @example
+ * const latestRun = await getFirst(
+ *     (p) => client.runs.list({ ...p, order: "desc" }),
+ *     { agent_id: "agent_123" }
+ * );
+ */
+export async function getFirst<T, P extends PaginationParams>(
+    fetchPage: (params: P) => Promise<APIResponse<PaginatedResponse<T>>>,
+    baseParams: Omit<P, "limit" | "offset" | "after">
+): Promise<T | undefined> {
+    for await (const item of paginate(fetchPage, baseParams, { pageSize: 1, maxItems: 1 })) {
+        return item;
+    }
+    return undefined;
+}