@agent-os-sdk/client 0.9.24 → 0.9.26

package/dist/client/OperationContextProvider.js

@@ -1,71 +0,0 @@
-/**
- * OperationContextProvider — Flow lifecycle management
- *
- * Provider defines the lifecycle of a flow context.
- * Implementations can use AsyncLocalStorage or manual context passing.
- *
- * @see sdk-upgrade.md Section 1.2
- */
-/**
- * Default provider that always returns undefined.
- * Used when no flow context is established.
- */
-export class DefaultContextProvider {
-    get() {
-        return undefined;
-    }
-}
-/**
- * AsyncLocalStorage-based provider for Node.js environments.
- * Automatically propagates context through async call chains.
- *
- * Note: This class requires Node.js async_hooks module.
- * Import and use only in Node.js environments.
- */
-export class AsyncLocalStorageContextProvider {
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    storage;
-    constructor() {
-        // Dynamic import to avoid browser errors
-        try {
-            // eslint-disable-next-line @typescript-eslint/no-require-imports
-            const asyncHooks = require("async_hooks");
-            this.storage = new asyncHooks.AsyncLocalStorage();
-        }
-        catch {
-            throw new Error("AsyncLocalStorage requires Node.js environment");
-        }
-    }
-    get() {
-        return this.storage?.getStore();
-    }
-    /**
-     * Run a function within a context.
-     * The context is automatically available to all async operations within.
-     */
-    run(context, fn) {
-        return this.storage.run(context, fn);
-    }
-    /**
-     * Run an async function within a context.
-     */
-    runAsync(context, fn) {
-        return this.storage.run(context, fn);
-    }
-}
-/**
- * Manual provider for environments without AsyncLocalStorage.
- * Context must be explicitly set and cleared.
- */
-export class ManualContextProvider {
-    context;
-    get() {
-        return this.context;
-    }
-    set(context) {
-        this.context = context;
-    }
-    clear() {
-        this.context = undefined;
-    }
-}

package/dist/client/auth.d.ts

@@ -1,100 +0,0 @@
-/**
- * Auth Provider Types for Agent OS SDK
- *
- * Two modes only:
- * - JWT (browser): Uses Supabase JWT + X-Workspace-Id header
- * - API Token (server): Uses aosk_* token with embedded claims
- */
-import type { NetworkConfig } from "./config.js";
-import type { SDKHooks } from "./raw.js";
-import type { OperationContextProvider } from "./OperationContextProvider.js";
-/**
- * API Token authentication for server-to-server integrations.
- * Token format: aosk_live_* or aosk_test_*
- *
- * SECURITY: API tokens contain embedded workspace/tenant claims.
- * The SDK sends ONLY Authorization header (no X-Workspace-Id, no X-Tenant-Id).
- *
- * @example
- * ```ts
- * const client = new AgentOsClient({
- *   baseUrl: "https://api.example.com",
- *   auth: { type: "api_token", apiKey: "aosk_live_xxx" }
- * })
- * ```
- */
-export type ApiTokenAuth = {
-    type: "api_token";
-    /** API key (aosk_*) or function that returns one */
-    apiKey: string | (() => string | Promise<string>);
-};
-/**
- * JWT authentication for browser/frontend clients.
- * Uses Supabase JWT with X-Workspace-Id header.
- *
- * SECURITY:
- * - X-Workspace-Id is REQUIRED (throws if missing)
- * - X-Tenant-Id is NEVER sent (backend derives from workspace membership)
- *
- * @example
- * ```ts
- * const client = new AgentOsClient({
- *   baseUrl: "https://api.example.com",
- *   auth: {
- *     type: "jwt",
- *     getToken: async () => (await supabase.auth.getSession()).data.session?.access_token,
- *     getWorkspaceId: () => localStorage.getItem("agentos.workspaceId")!,
- *   }
- * })
- * ```
- */
-export type JwtAuth = {
-    type: "jwt";
-    /** Function to get the JWT access token */
-    getToken: () => string | Promise<string>;
-    /** Function to get the current workspace ID (REQUIRED) */
-    getWorkspaceId: () => string | Promise<string>;
-};
-/**
- * Auth provider union type - only two modes supported
- */
-export type AuthProvider = ApiTokenAuth | JwtAuth;
-/**
- * Options for AgentOsClient - auth is REQUIRED
- */
-export type AgentOsClientOptions = {
-    /** Base URL of the Agent OS Control Plane */
-    baseUrl: string;
-    /** Authentication provider (REQUIRED) */
-    auth: AuthProvider;
-    /**
-     * Allow API token in browser environment.
-     * Default: false (throws error to prevent accidental exposure)
-     * Only set to true if you understand the security implications.
-     */
-    allowApiTokenInBrowser?: boolean;
-    /** Network policy (timeouts/retries). */
-    network?: Partial<NetworkConfig>;
-    /** Optional request lifecycle hooks for observability */
-    hooks?: SDKHooks;
-    /** Optional flow context provider (ALS/manual) for sticky correlation per operation. */
-    /** Recommended for long-lived server clients to avoid process-wide sticky fallback correlation. */
-    contextProvider?: OperationContextProvider;
-    /** Custom headers to add to all requests */
-    headers?: Record<string, string>;
-};
-export declare function isApiTokenAuth(auth: AuthProvider): auth is ApiTokenAuth;
-export declare function isJwtAuth(auth: AuthProvider): auth is JwtAuth;
-/**
- * Detect browser environment
- */
-export declare function isBrowser(): boolean;
-/**
- * Check if token looks like an API token (aosk_*)
- */
-export declare function isApiToken(token: string): boolean;
-/**
- * Check if token looks like a JWT (three base64 segments)
- */
-export declare function isJwtToken(token: string): boolean;
-//# sourceMappingURL=auth.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/client/auth.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAM9E;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,YAAY,GAAG;IACvB,IAAI,EAAE,WAAW,CAAA;IACjB,oDAAoD;IACpD,MAAM,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAA;CACpD,CAAA;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,MAAM,OAAO,GAAG;IAClB,IAAI,EAAE,KAAK,CAAA;IACX,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IACxC,0DAA0D;IAC1D,cAAc,EAAE,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;CACjD,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,YAAY,GAAG,OAAO,CAAA;AAMjD;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG;IAC/B,6CAA6C;IAC7C,OAAO,EAAE,MAAM,CAAA;IACf,yCAAyC;IACzC,IAAI,EAAE,YAAY,CAAA;IAClB;;;;OAIG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAA;IAChC,yCAAyC;IACzC,OAAO,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;IAChC,yDAAyD;IACzD,KAAK,CAAC,EAAE,QAAQ,CAAA;IAChB,wFAAwF;IACxF,mGAAmG;IACnG,eAAe,CAAC,EAAE,wBAAwB,CAAA;IAC1C,4CAA4C;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACnC,CAAA;AAMD,wBAAgB,cAAc,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,IAAI,YAAY,CAEvE;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,IAAI,OAAO,CAE7D;AAMD;;GAEG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAEnC;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEjD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAGjD"}

package/dist/client/auth.js

@@ -1,38 +0,0 @@
-/**
- * Auth Provider Types for Agent OS SDK
- *
- * Two modes only:
- * - JWT (browser): Uses Supabase JWT + X-Workspace-Id header
- * - API Token (server): Uses aosk_* token with embedded claims
- */
-// ============================================================================
-// Type Guards
-// ============================================================================
-export function isApiTokenAuth(auth) {
-    return auth.type === "api_token";
-}
-export function isJwtAuth(auth) {
-    return auth.type === "jwt";
-}
-// ============================================================================
-// Helpers
-// ============================================================================
-/**
- * Detect browser environment
- */
-export function isBrowser() {
-    return typeof window !== "undefined" && typeof document !== "undefined";
-}
-/**
- * Check if token looks like an API token (aosk_*)
- */
-export function isApiToken(token) {
-    return token.startsWith("aosk_");
-}
-/**
- * Check if token looks like a JWT (three base64 segments)
- */
-export function isJwtToken(token) {
-    const parts = token.split(".");
-    return parts.length === 3 && parts.every(p => p.length > 0);
-}

package/dist/client/config.d.ts

@@ -1,49 +0,0 @@
-/**
- * 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 declare const DEFAULT_NETWORK_CONFIG: NetworkConfig;
-/**
- * Aggressive configuration for interactive UIs.
- * Shorter timeouts, fewer retries.
- */
-export declare const INTERACTIVE_NETWORK_CONFIG: NetworkConfig;
-/**
- * Patient configuration for background jobs.
- * Longer timeouts, more retries.
- */
-export declare const BACKGROUND_NETWORK_CONFIG: NetworkConfig;
-/**
- * Merges user config with defaults.
- */
-export declare function mergeNetworkConfig(userConfig?: Partial<NetworkConfig>): NetworkConfig;
-//# sourceMappingURL=config.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/client/config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB,0CAA0C;IAC1C,UAAU,EAAE,MAAM,CAAC;IAEnB,uDAAuD;IACvD,WAAW,EAAE,MAAM,CAAC;IAEpB,2DAA2D;IAC3D,UAAU,EAAE,MAAM,CAAC;IAEnB,mEAAmE;IACnE,YAAY,EAAE,MAAM,CAAC;IAErB,qFAAqF;IACrF,iBAAiB,EAAE,MAAM,EAAE,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC1B,mEAAmE;IACnE,SAAS,EAAE,MAAM,CAAC;IAElB,0BAA0B;IAC1B,KAAK,EAAE,WAAW,CAAC;CACtB;AAED;;;GAGG;AACH,eAAO,MAAM,sBAAsB,EAAE,aASpC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,0BAA0B,EAAE,aASxC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,yBAAyB,EAAE,aASvC,CAAC;AAEF;;GAEG;AACH,wBAAgB,kBAAkB,CAC9B,UAAU,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,GACpC,aAAa,CAYf"}

package/dist/client/config.js

@@ -1,62 +0,0 @@
-/**
- * Agent OS SDK - Network Configuration
- *
- * Centralized configuration for timeouts, retries, and network policies.
- */
-/**
- * Default network configuration.
- * Balanced for most use cases - 30s timeout, 3 retries with exponential backoff.
- */
-export const DEFAULT_NETWORK_CONFIG = {
-    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 = {
-    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 = {
-    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) {
-    if (!userConfig) {
-        return DEFAULT_NETWORK_CONFIG;
-    }
-    return {
-        timeoutMs: userConfig.timeoutMs ?? DEFAULT_NETWORK_CONFIG.timeoutMs,
-        retry: {
-            ...DEFAULT_NETWORK_CONFIG.retry,
-            ...userConfig.retry,
-        },
-    };
-}

package/dist/client/helpers.d.ts

@@ -1,63 +0,0 @@
-/**
- * SDK Helper Types and Functions
- *
- * Provides utilities for working with API responses.
- */
-import type { APIResponse } from "./raw.js";
-/**
- * Standard pagination parameters used across all list endpoints.
- * Extends Record to be compatible with query parameter types.
- */
-export interface PaginationParams extends Record<string, unknown> {
-    /** Maximum number of items to return (default: 20) */
-    limit?: number;
-    /** Number of items to skip (default: 0) */
-    offset?: number;
-}
-/**
- * Paginated list response wrapper.
- */
-export interface PaginatedResponse<T> {
-    items: T[];
-    total: number;
-}
-/**
- * SDK-specific error class with structured error data.
- */
-export declare class SDKError extends Error {
-    readonly code: string;
-    readonly status: number;
-    readonly details?: unknown;
-    constructor(response: APIResponse<unknown>);
-}
-/**
- * Unwraps an APIResponse, returning the data directly or throwing on error.
- * Use this when you want the cleaner "throws on error" pattern.
- *
- * @example
- * ```ts
- * // Instead of:
- * const { data, error } = await client.agents.list();
- * if (error) throw new Error(error.message);
- *
- * // Use:
- * const agents = await unwrap(client.agents.list());
- * ```
- */
-export declare function unwrap<T>(promise: Promise<APIResponse<T>>): Promise<T>;
-/**
- * Type helper for unwrapped responses.
- */
-export type Unwrapped<T> = T extends APIResponse<infer U> ? U : never;
-export type Result<T, E = SDKError> = {
-    success: true;
-    data: T;
-} | {
-    success: false;
-    error: E;
-};
-/**
- * Converts an APIResponse to a Result type for pattern matching.
- */
-export declare function toResult<T>(promise: Promise<APIResponse<T>>): Promise<Result<T>>;
-//# sourceMappingURL=helpers.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/client/helpers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAM5C;;;GAGG;AACH,MAAM,WAAW,gBAAiB,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC7D,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2CAA2C;IAC3C,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB,CAAC,CAAC;IAChC,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;CACjB;AAMD;;GAEG;AACH,qBAAa,QAAS,SAAQ,KAAK;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;gBAEf,QAAQ,EAAE,WAAW,CAAC,OAAO,CAAC;CAQ7C;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAM5E;AAED;;GAEG;AACH,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI,CAAC,SAAS,WAAW,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;AAMtE,MAAM,MAAM,MAAM,CAAC,CAAC,EAAE,CAAC,GAAG,QAAQ,IAC5B;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,CAAA;CAAE,GAC1B;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,CAAC;AAEnC;;GAEG;AACH,wBAAsB,QAAQ,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAMtF"}

package/dist/client/helpers.js

@@ -1,55 +0,0 @@
-/**
- * SDK Helper Types and Functions
- *
- * Provides utilities for working with API responses.
- */
-// ============================================================================
-// Error Handling
-// ============================================================================
-/**
- * SDK-specific error class with structured error data.
- */
-export class SDKError extends Error {
-    code;
-    status;
-    details;
-    constructor(response) {
-        const message = response.error?.message || `HTTP ${response.response.status}`;
-        super(message);
-        this.name = "SDKError";
-        this.code = response.error?.code || `HTTP_${response.response.status}`;
-        this.status = response.response.status;
-        this.details = response.error?.details;
-    }
-}
-/**
- * Unwraps an APIResponse, returning the data directly or throwing on error.
- * Use this when you want the cleaner "throws on error" pattern.
- *
- * @example
- * ```ts
- * // Instead of:
- * const { data, error } = await client.agents.list();
- * if (error) throw new Error(error.message);
- *
- * // Use:
- * const agents = await unwrap(client.agents.list());
- * ```
- */
-export async function unwrap(promise) {
-    const result = await promise;
-    if (result.error || !result.data) {
-        throw new SDKError(result);
-    }
-    return result.data;
-}
-/**
- * Converts an APIResponse to a Result type for pattern matching.
- */
-export async function toResult(promise) {
-    const result = await promise;
-    if (result.error || !result.data) {
-        return { success: false, error: new SDKError(result) };
-    }
-    return { success: true, data: result.data };
-}

package/dist/client/pagination.d.ts

@@ -1,105 +0,0 @@
-/**
- * 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";
-/**
- * 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>;
-/**
- * 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;
-/**
- * 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 declare 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>;
-/**
- * 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 declare function collectAll<T, P extends PaginationParams>(fetchPage: (params: P) => Promise<APIResponse<PaginatedResponse<T>>>, baseParams: Omit<P, "limit" | "offset" | "after">, options?: PaginateOptions): Promise<T[]>;
-/**
- * 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 declare function getFirst<T, P extends PaginationParams>(fetchPage: (params: P) => Promise<APIResponse<PaginatedResponse<T>>>, baseParams: Omit<P, "limit" | "offset" | "after">): Promise<T | undefined>;
-//# sourceMappingURL=pagination.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"pagination.d.ts","sourceRoot":"","sources":["../../src/client/pagination.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAM5C;;;GAGG;AACH,MAAM,WAAW,uBAAuB,CAAC,CAAC;IACtC,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,uBAAuB,CAAC,CAAC;IACtC,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,OAAO,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,MAAM,iBAAiB,CAAC,CAAC,IACzB,uBAAuB,CAAC,CAAC,CAAC,GAC1B,uBAAuB,CAAC,CAAC,CAAC,CAAC;AAMjC;;GAEG;AACH,MAAM,WAAW,YAAY;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,YAAY,GAAG,YAAY,CAAC;AAiB3D;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,wDAAwD;IACxD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,mCAAmC;IACnC,MAAM,CAAC,EAAE,WAAW,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAuB,QAAQ,CAAC,CAAC,EAAE,CAAC,SAAS,gBAAgB,EACzD,SAAS,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,OAAO,CAAC,WAAW,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC,EACpE,UAAU,EAAE,IAAI,CAAC,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC,EACjD,OAAO,CAAC,EAAE,eAAe,GAC1B,cAAc,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,CAgDlC;AAMD;;;;;;;;;;GAUG;AACH,wBAAsB,UAAU,CAAC,CAAC,EAAE,CAAC,SAAS,gBAAgB,EAC1D,SAAS,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,OAAO,CAAC,WAAW,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC,EACpE,UAAU,EAAE,IAAI,CAAC,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC,EACjD,OAAO,CAAC,EAAE,eAAe,GAC1B,OAAO,CAAC,CAAC,EAAE,CAAC,CAQd;AAED;;;;;;;;;GASG;AACH,wBAAsB,QAAQ,CAAC,CAAC,EAAE,CAAC,SAAS,gBAAgB,EACxD,SAAS,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,OAAO,CAAC,WAAW,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC,EACpE,UAAU,EAAE,IAAI,CAAC,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC,GAClD,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAKxB"}

package/dist/client/pagination.js

@@ -1,117 +0,0 @@
-/**
- * Agent OS SDK - Pagination Utilities
- *
- * Auto-paginating iterators that support both offset and cursor pagination.
- * Designed to work with any list endpoint.
- */
-// ============================================================================
-// Type Guards
-// ============================================================================
-/**
- * Checks if response uses cursor pagination.
- */
-function isCursorResponse(response) {
-    return "has_more" in response;
-}
-/**
- * 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(fetchPage, baseParams, options) {
-    const pageSize = options?.pageSize ?? 100;
-    const maxItems = options?.maxItems ?? Infinity;
-    const signal = options?.signal;
-    let offset = 0;
-    let cursor;
-    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 }),
-        };
-        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(fetchPage, baseParams, options) {
-    const items = [];
-    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(fetchPage, baseParams) {
-    for await (const item of paginate(fetchPage, baseParams, { pageSize: 1, maxItems: 1 })) {
-        return item;
-    }
-    return undefined;
-}