@agent-os-sdk/client 0.9.26 → 0.9.27

package/{src/client/helpers.ts → dist/client/helpers.js}

@@ -1,47 +1,19 @@
 /**
  * SDK Helper Types and Functions
- * 
+ *
  * Provides utilities for working with API responses.
  */
-
-import type { APIResponse } from "./raw.js";
-
-// ============================================================================
-// Pagination
-// ============================================================================
-
-/**
- * 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;
-}
-
 // ============================================================================
 // Error Handling
 // ============================================================================
-
 /**
  * SDK-specific error class with structured error data.
  */
 export class SDKError extends Error {
-    readonly code: string;
-    readonly status: number;
-    readonly details?: unknown;
-
-    constructor(response: APIResponse<unknown>) {
+    code;
+    status;
+    details;
+    constructor(response) {
         const message = response.error?.message || `HTTP ${response.response.status}`;
         super(message);
         this.name = "SDKError";
@@ -50,46 +22,31 @@ export class SDKError extends Error {
         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<T>(promise: Promise<APIResponse<T>>): Promise<T> {
+export async function unwrap(promise) {
     const result = await promise;
     if (result.error || !result.data) {
         throw new SDKError(result);
     }
     return result.data;
 }
-
-/**
- * Type helper for unwrapped responses.
- */
-export type Unwrapped<T> = T extends APIResponse<infer U> ? U : never;
-
-// ============================================================================
-// Result Pattern (Alternative to exceptions)
-// ============================================================================
-
-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 async function toResult<T>(promise: Promise<APIResponse<T>>): Promise<Result<T>> {
+export async function toResult(promise) {
     const result = await promise;
     if (result.error || !result.data) {
         return { success: false, error: new SDKError(result) };

package/dist/client/pagination.d.ts

@@ -0,0 +1,105 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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/{src/client/pagination.ts → dist/client/pagination.js}

@@ -1,100 +1,22 @@
 /**
  * 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> {
+function isCursorResponse(response) {
     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(
@@ -103,7 +25,7 @@ export interface PaginateOptions {
  * )) {
  *     console.log(run.id);
  * }
- * 
+ *
  * @example
  * // With options
  * for await (const agent of paginate(
@@ -114,41 +36,30 @@ export interface PaginateOptions {
  *     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> {
+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: string | undefined;
+    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 }),
-        } as P;
-
+        };
         const response = await fetchPage(params);
-
         if (response.error) {
             throw response.error;
         }
-
-        const data = response.data!;
-
+        const data = response.data;
         for (const item of data.items) {
             if (yielded >= maxItems) {
                 return;
@@ -156,26 +67,24 @@ export async function* paginate<T, P extends PaginationParams>(
             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 {
+        }
+        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),
@@ -183,34 +92,24 @@ export async function* paginate<T, P extends PaginationParams>(
  *     { 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[] = [];
-
+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<T, P extends PaginationParams>(
-    fetchPage: (params: P) => Promise<APIResponse<PaginatedResponse<T>>>,
-    baseParams: Omit<P, "limit" | "offset" | "after">
-): Promise<T | undefined> {
+export async function getFirst(fetchPage, baseParams) {
     for await (const item of paginate(fetchPage, baseParams, { pageSize: 1, maxItems: 1 })) {
         return item;
     }