@agent-os-sdk/client 0.3.15 → 0.4.0

package/dist/modules/info.js

@@ -1,6 +1,8 @@
 /**
  * Info Module - Fully Typed
  */
+// SDK version from package (will be replaced at build time or use constant)
+const SDK_VERSION = "0.4.0";
 export class InfoModule {
     client;
     headers;
@@ -24,4 +26,68 @@ export class InfoModule {
             headers: this.headers(),
         });
     }
+    /**
+     * Get normalized server capabilities for feature detection.
+     *
+     * This method never assumes feature availability - all features
+     * default to false unless explicitly enabled by the server.
+     *
+     * @example
+     * ```ts
+     * const caps = await client.info.capabilities();
+     * if (caps.data?.features.sseResume) {
+     *     // Use follow() with resume
+     * } else {
+     *     // Fall back to polling
+     * }
+     * ```
+     */
+    async capabilities() {
+        const response = await this.get();
+        if (response.error || !response.data) {
+            // Pass through error - construct proper response without data
+            return {
+                error: response.error,
+                response: response.response,
+                meta: response.meta,
+            };
+        }
+        const info = response.data;
+        // Transform snake_case features array to camelCase object
+        // CRITICAL: Never assume true - default everything to false
+        const featureArray = info.features ?? [];
+        const features = {
+            sseResume: featureArray.includes("sse_resume"),
+            cronTriggers: featureArray.includes("cron_triggers"),
+            batchRuns: featureArray.includes("batch_runs"),
+            hitl: featureArray.includes("hitl"),
+            traces: featureArray.includes("traces"),
+            vectorStores: featureArray.includes("vector_stores"),
+            evaluations: featureArray.includes("evaluations"),
+        };
+        // Add any other features from array as snake_case → camelCase
+        for (const feature of featureArray) {
+            const camelCase = snakeToCamel(feature);
+            if (!(camelCase in features)) {
+                features[camelCase] = true;
+            }
+        }
+        const capabilities = {
+            version: info.version,
+            commitHash: info.commit_hash,
+            apiVersion: info.api_version,
+            environment: info.environment,
+            features,
+            sdkVersion: SDK_VERSION,
+        };
+        return {
+            data: capabilities,
+            response: response.response,
+            meta: response.meta,
+        };
+    }
+}
+/** Convert snake_case to camelCase */
+function snakeToCamel(str) {
+    return str.replace(/_([a-z])/g, (_, letter) => letter.toUpperCase());
 }

package/dist/modules/runs.d.ts

@@ -78,6 +78,13 @@ export declare class RunsModule {
      *   agent_id: "agent-uuid",
      *   input: { message: "Hello" }
      * });
+     *
+     * // With idempotency (safe to retry)
+     * const { data } = await client.runs.create({
+     *   agent_id: "agent-uuid",
+     *   input: { message: "Hello" },
+     *   idempotency_key: "my-unique-key"
+     * });
      * ```
      */
     create(body: {
@@ -88,6 +95,7 @@ export declare class RunsModule {
             new_thread: true;
         };
         input?: unknown;
+        /** Idempotency key for safe retries. When set, duplicate requests with the same key return the original response. */
         idempotency_key?: string;
     }): Promise<APIResponse<CreateRunResponse>>;
     /**
@@ -102,6 +110,31 @@ export declare class RunsModule {
         agent_id?: string;
         status?: string;
     }): Promise<APIResponse<RunListResponse>>;
+    /**
+     * Iterate through all runs with automatic pagination.
+     *
+     * @example
+     * ```ts
+     * // Stream all completed runs
+     * for await (const run of client.runs.iterate({ status: "completed" })) {
+     *     console.log(run.run_id, run.status);
+     * }
+     *
+     * // With limit
+     * for await (const run of client.runs.iterate({ agent_id: "..." }, { maxItems: 100 })) {
+     *     processRun(run);
+     * }
+     * ```
+     */
+    iterate(filters?: {
+        thread_id?: string;
+        agent_id?: string;
+        status?: string;
+    }, options?: {
+        pageSize?: number;
+        maxItems?: number;
+        signal?: AbortSignal;
+    }): AsyncGenerator<Run, void, unknown>;
     /**
      * Wait for run completion synchronously.
      */
@@ -260,6 +293,76 @@ export declare class RunsModule {
      * Join an existing run's stream (resume watching).
      */
     join(runId: string, options?: SSEOptions): AsyncGenerator<SSEEvent<RunStreamEvent>>;
+    /**
+     * Follow a run's event stream with automatic reconnection and resume.
+     *
+     * This is the enterprise-grade streaming method that:
+     * - Reconnects automatically on connection drops
+     * - Resumes from last received event using Last-Event-ID
+     * - Never duplicates or loses events
+     * - Terminates cleanly on 'close' event
+     *
+     * @example
+     * ```ts
+     * for await (const event of client.runs.follow(runId)) {
+     *     if (event.type === "run_event") {
+     *         console.log(event.payload);
+     *     } else if (event.type === "close") {
+     *         console.log("Run completed");
+     *     }
+     * }
+     * ```
+     */
+    follow(runId: string, options?: FollowOptions): AsyncGenerator<FollowEvent, void, unknown>;
+    /**
+     * Wait for a specific event that matches a predicate.
+     *
+     * @example
+     * ```ts
+     * // Wait for run completion
+     * const event = await client.runs.waitFor(runId, (e) => e.type === "close", {
+     *     timeoutMs: 60000
+     * });
+     *
+     * // Wait for specific node execution
+     * const nodeEvent = await client.runs.waitFor(runId, (e) =>
+     *     e.type === "run_event" && e.payload?.node === "my_node"
+     * );
+     * ```
+     */
+    waitFor(runId: string, predicate: (event: FollowEvent) => boolean, options?: {
+        timeoutMs?: number;
+        signal?: AbortSignal;
+        startSeq?: number;
+    }): Promise<FollowEvent>;
+}
+/** Options for runs.follow() */
+export interface FollowOptions {
+    /** Starting sequence number (default: 0 = from beginning) */
+    startSeq?: number;
+    /** AbortSignal for cancellation */
+    signal?: AbortSignal;
+    /** Max reconnection attempts (default: 10) */
+    maxReconnects?: number;
+    /** Base delay for backoff in ms (default: 1000) */
+    baseDelayMs?: number;
+    /** Max delay for backoff in ms (default: 30000) */
+    maxDelayMs?: number;
+    /** Called when initially connected */
+    onConnect?: () => void;
+    /** Called when reconnecting (with attempt number) */
+    onReconnect?: (attempt: number) => void;
+    /** Called when disconnected (with reason) */
+    onDisconnect?: (reason: "eof" | "error") => void;
+}
+/** Event emitted by runs.follow() */
+export interface FollowEvent {
+    type: "run_event" | "heartbeat" | "close" | "error";
+    seq: number;
+    timestamp: string;
+    payload?: Record<string, unknown> | null;
+    /** For run_event: the node that emitted this event */
+    node?: string;
 }
 export {};
 //# sourceMappingURL=runs.d.ts.map

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

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

package/dist/modules/runs.js

@@ -21,11 +21,24 @@ export class RunsModule {
      *   agent_id: "agent-uuid",
      *   input: { message: "Hello" }
      * });
+     *
+     * // With idempotency (safe to retry)
+     * const { data } = await client.runs.create({
+     *   agent_id: "agent-uuid",
+     *   input: { message: "Hello" },
+     *   idempotency_key: "my-unique-key"
+     * });
      * ```
      */
     async create(body) {
+        // Send Idempotency-Key in HEADER (enterprise standard) + body (backend compat)
+        const headers = {};
+        if (body.idempotency_key) {
+            headers["Idempotency-Key"] = body.idempotency_key;
+        }
         return this.client.POST("/v1/api/runs", {
             body,
+            headers,
         });
     }
     /**
@@ -44,6 +57,49 @@ export class RunsModule {
             params: { query: params },
         });
     }
+    /**
+     * Iterate through all runs with automatic pagination.
+     *
+     * @example
+     * ```ts
+     * // Stream all completed runs
+     * for await (const run of client.runs.iterate({ status: "completed" })) {
+     *     console.log(run.run_id, run.status);
+     * }
+     *
+     * // With limit
+     * for await (const run of client.runs.iterate({ agent_id: "..." }, { maxItems: 100 })) {
+     *     processRun(run);
+     * }
+     * ```
+     */
+    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 run of data.items) {
+                if (yielded >= maxItems)
+                    return;
+                yield run;
+                yielded++;
+            }
+            offset += data.items.length;
+            hasMore = offset < data.total && data.items.length > 0;
+        }
+    }
     // ======================== Execution ========================
     /**
      * Wait for run completion synchronously.
@@ -239,4 +295,206 @@ export class RunsModule {
         });
         yield* parseSSE(response, { onOpen: options?.onOpen });
     }
+    // ======================== FOLLOW (Enterprise SSE) ========================
+    /**
+     * Follow a run's event stream with automatic reconnection and resume.
+     *
+     * This is the enterprise-grade streaming method that:
+     * - Reconnects automatically on connection drops
+     * - Resumes from last received event using Last-Event-ID
+     * - Never duplicates or loses events
+     * - Terminates cleanly on 'close' event
+     *
+     * @example
+     * ```ts
+     * for await (const event of client.runs.follow(runId)) {
+     *     if (event.type === "run_event") {
+     *         console.log(event.payload);
+     *     } else if (event.type === "close") {
+     *         console.log("Run completed");
+     *     }
+     * }
+     * ```
+     */
+    async *follow(runId, options) {
+        const signal = options?.signal;
+        const maxReconnects = options?.maxReconnects ?? 10;
+        const baseDelayMs = options?.baseDelayMs ?? 1000;
+        const maxDelayMs = options?.maxDelayMs ?? 30000;
+        // nextSeq = next seq we expect to receive (or 0 at start)
+        let nextSeq = options?.startSeq ?? 0;
+        let reconnectCount = 0;
+        let receivedTerminal = false;
+        options?.onConnect?.();
+        while (!receivedTerminal && reconnectCount <= maxReconnects) {
+            if (signal?.aborted)
+                return;
+            try {
+                // Build headers - Last-Event-ID is the LAST seq we received (nextSeq - 1)
+                const headers = {};
+                if (nextSeq > 0) {
+                    headers["Last-Event-ID"] = String(nextSeq - 1);
+                }
+                const response = await this.client.streamGet("/v1/api/runs/{runId}/stream", {
+                    params: {
+                        path: { runId },
+                        query: nextSeq > 0 ? { seq: nextSeq } : undefined // Also send as query for backends that support it
+                    },
+                    headers,
+                });
+                // Check for auth errors - don't reconnect on these
+                if (response.status === 401 || response.status === 403) {
+                    const errorEvent = {
+                        type: "error",
+                        payload: { code: `HTTP_${response.status}`, message: response.statusText },
+                        seq: -1,
+                        timestamp: new Date().toISOString(),
+                    };
+                    yield errorEvent;
+                    return; // Don't reconnect on auth errors
+                }
+                if (!response.ok) {
+                    throw new Error(`SSE connection failed: ${response.status}`);
+                }
+                // Reset reconnect count on successful connection
+                if (reconnectCount > 0) {
+                    options?.onReconnect?.(reconnectCount);
+                }
+                reconnectCount = 0;
+                // Parse SSE stream
+                for await (const rawEvent of parseSSE(response)) {
+                    if (signal?.aborted)
+                        return;
+                    // Narrow to known event types
+                    const event = narrowFollowEvent(rawEvent);
+                    if (!event)
+                        continue; // Skip unknown event types
+                    // Update seq tracking if event has seq
+                    if (typeof event.seq === "number" && event.seq >= 0) {
+                        nextSeq = event.seq + 1;
+                    }
+                    // Check for terminal events
+                    if (event.type === "close") {
+                        receivedTerminal = true;
+                        yield event;
+                        return;
+                    }
+                    if (event.type === "error") {
+                        // Error event from server - yield but continue (might reconnect)
+                        yield event;
+                        // If it's a fatal error, break and try reconnect
+                        break;
+                    }
+                    yield event;
+                }
+                // Stream ended without close event - this is unexpected EOF
+                // Reconnect unless we already received terminal
+                if (!receivedTerminal && !signal?.aborted) {
+                    options?.onDisconnect?.("eof");
+                    reconnectCount++;
+                    if (reconnectCount <= maxReconnects) {
+                        await sleep(calculateBackoff(reconnectCount, baseDelayMs, maxDelayMs));
+                    }
+                }
+            }
+            catch (err) {
+                if (signal?.aborted)
+                    return;
+                options?.onDisconnect?.("error");
+                reconnectCount++;
+                if (reconnectCount <= maxReconnects) {
+                    await sleep(calculateBackoff(reconnectCount, baseDelayMs, maxDelayMs));
+                }
+                else {
+                    // Max reconnects exceeded - yield error and stop
+                    yield {
+                        type: "error",
+                        payload: { code: "MAX_RECONNECTS", message: `Max reconnects (${maxReconnects}) exceeded` },
+                        seq: -1,
+                        timestamp: new Date().toISOString(),
+                    };
+                    return;
+                }
+            }
+        }
+    }
+    /**
+     * Wait for a specific event that matches a predicate.
+     *
+     * @example
+     * ```ts
+     * // Wait for run completion
+     * const event = await client.runs.waitFor(runId, (e) => e.type === "close", {
+     *     timeoutMs: 60000
+     * });
+     *
+     * // Wait for specific node execution
+     * const nodeEvent = await client.runs.waitFor(runId, (e) =>
+     *     e.type === "run_event" && e.payload?.node === "my_node"
+     * );
+     * ```
+     */
+    async waitFor(runId, predicate, options) {
+        const timeoutMs = options?.timeoutMs ?? 300_000; // 5 min default
+        const controller = new AbortController();
+        // Combine parent signal with our timeout
+        const onAbort = () => controller.abort();
+        options?.signal?.addEventListener("abort", onAbort, { once: true });
+        const timeoutId = setTimeout(() => controller.abort(), timeoutMs);
+        try {
+            for await (const event of this.follow(runId, {
+                signal: controller.signal,
+                startSeq: options?.startSeq,
+            })) {
+                if (predicate(event)) {
+                    return event;
+                }
+                // If we got close without matching predicate, error
+                if (event.type === "close") {
+                    throw new Error("Run completed without matching event");
+                }
+            }
+            // Stream ended without match or terminal
+            throw new Error("Stream ended without matching event");
+        }
+        catch (err) {
+            if (controller.signal.aborted && !options?.signal?.aborted) {
+                // Our timeout triggered the abort
+                const { TimeoutError } = await import("../errors/index.js");
+                throw new TimeoutError(timeoutMs);
+            }
+            throw err;
+        }
+        finally {
+            clearTimeout(timeoutId);
+            options?.signal?.removeEventListener("abort", onAbort);
+        }
+    }
+}
+/** Narrow raw SSE event to FollowEvent */
+function narrowFollowEvent(raw) {
+    const eventType = raw.event ?? "message";
+    const validTypes = ["run_event", "heartbeat", "close", "error"];
+    if (!validTypes.includes(eventType)) {
+        return null;
+    }
+    const data = raw.data;
+    return {
+        type: eventType,
+        seq: typeof data?.seq === "number" ? data.seq : (raw.id ? parseInt(raw.id, 10) : -1),
+        timestamp: typeof data?.timestamp === "string" ? data.timestamp : new Date().toISOString(),
+        payload: data,
+        node: typeof data?.node === "string" ? data.node : undefined,
+    };
+}
+/** Calculate exponential backoff with jitter */
+function calculateBackoff(attempt, baseMs, maxMs) {
+    const exponential = baseMs * Math.pow(2, attempt - 1);
+    const capped = Math.min(exponential, maxMs);
+    const jitter = capped * 0.2 * Math.random();
+    return Math.floor(capped + jitter);
+}
+/** Sleep utility */
+function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
 }

package/dist/modules/tenants.d.ts

@@ -22,7 +22,10 @@ export declare class TenantsModule {
     /**
      * List all tenants the user has access to.
      */
-    list(): Promise<APIResponse<Tenant[]>>;
+    /**
+     * List all tenants the user has access to.
+     */
+    list(): Promise<APIResponse<TenantListResponse>>;
     /**
      * Get the current tenant.
      */

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

@@ -1 +1 @@
-{"version":3,"file":"tenants.d.ts","sourceRoot":"","sources":["../../src/modules/tenants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAc,MAAM,kBAAkB,CAAC;AAI3E,MAAM,WAAW,MAAM;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB;IAC/B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACjB;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;IAEpF;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC;IAM5C;;OAEG;IACG,GAAG,IAAI,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAMzC;;OAEG;IACG,MAAM,CAAC,IAAI,EAAE;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;KACjB,GAAG,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAOhC;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAMlE;;OAEG;IACG,cAAc,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;CAMtF"}
+{"version":3,"file":"tenants.d.ts","sourceRoot":"","sources":["../../src/modules/tenants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAc,MAAM,kBAAkB,CAAC;AAI3E,MAAM,WAAW,MAAM;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB;IAC/B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACjB;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;IAEpF;;OAEG;IACH;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,WAAW,CAAC,kBAAkB,CAAC,CAAC;IAMtD;;OAEG;IACG,GAAG,IAAI,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAMzC;;OAEG;IACG,MAAM,CAAC,IAAI,EAAE;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;KACjB,GAAG,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAOhC;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAMlE;;OAEG;IACG,cAAc,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;CAMtF"}

package/dist/modules/tenants.js

@@ -8,6 +8,9 @@ export class TenantsModule {
         this.client = client;
         this.headers = headers;
     }
+    /**
+     * List all tenants the user has access to.
+     */
     /**
      * List all tenants the user has access to.
      */

package/dist/modules/threads.d.ts

@@ -67,12 +67,19 @@ export declare 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"
+     * });
      * ```
      */
     create(body?: {
         channel?: string;
         external_conversation_id?: string;
         metadata?: Record<string, unknown>;
+        /** Idempotency key for safe retries. When set, duplicate requests with the same key return the original response. */
+        idempotency_key?: string;
     }): Promise<APIResponse<Thread>>;
     /**
      * Get a thread by ID.
@@ -92,6 +99,23 @@ export declare class ThreadsModule {
     list(params?: PaginationParams & {
         workspace_id?: string;
     }): Promise<APIResponse<ThreadListResponse>>;
+    /**
+     * Iterate through all threads with automatic pagination.
+     *
+     * @example
+     * ```ts
+     * for await (const thread of client.threads.iterate()) {
+     *     console.log(thread.id);
+     * }
+     * ```
+     */
+    iterate(filters?: {
+        workspace_id?: string;
+    }, options?: {
+        pageSize?: number;
+        maxItems?: number;
+        signal?: AbortSignal;
+    }): AsyncGenerator<Thread, void, unknown>;
     /**
      * Delete a thread.
      */

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":"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"}

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.
      */