@agent-os-sdk/client 0.3.15 → 0.4.1

package/dist/errors/index.js

@@ -0,0 +1,283 @@
+/**
+ * Agent OS SDK - Typed Errors
+ *
+ * Enterprise-grade error classification for predictable error handling.
+ * All errors extend AgentOsError and include semantic information.
+ */
+/**
+ * Base class for all Agent OS SDK errors.
+ * Provides consistent structure for error handling and classification.
+ */
+export class AgentOsError extends Error {
+    /** Request ID from x-request-id header */
+    requestId;
+    /** Original error code from backend (preserves backend semantics) */
+    backendCode;
+    /** Raw details object from backend response */
+    details;
+    /** Timestamp when error occurred */
+    timestamp = new Date().toISOString();
+    constructor(message, options) {
+        super(message);
+        this.name = this.constructor.name;
+        this.requestId = options?.requestId;
+        this.backendCode = options?.backendCode;
+        this.details = options?.details;
+        // Maintains proper stack trace (V8 engines only)
+        if ("captureStackTrace" in Error && typeof Error.captureStackTrace === "function") {
+            Error.captureStackTrace(this, this.constructor);
+        }
+    }
+    /**
+     * Whether this error is retryable with the same request.
+     * Override in subclasses for specific behavior.
+     */
+    isRetryable() {
+        return false;
+    }
+    /** Convert to JSON for logging/serialization */
+    toJSON() {
+        return {
+            name: this.name,
+            code: this.code,
+            status: this.status,
+            message: this.message,
+            requestId: this.requestId,
+            backendCode: this.backendCode,
+            details: this.details,
+            timestamp: this.timestamp,
+        };
+    }
+}
+// ============================================================================
+// Authentication & Authorization Errors
+// ============================================================================
+/**
+ * 401 Unauthorized - Invalid or missing authentication.
+ *
+ * @example
+ * if (error instanceof UnauthorizedError) {
+ *     // Redirect to login
+ * }
+ */
+export class UnauthorizedError extends AgentOsError {
+    code = "UNAUTHORIZED";
+    status = 401;
+    constructor(message = "Authentication required", options) {
+        super(message, options);
+    }
+}
+/**
+ * 403 Forbidden - Valid auth but insufficient permissions.
+ *
+ * @example
+ * if (error instanceof ForbiddenError) {
+ *     showToast("You don't have permission to perform this action");
+ * }
+ */
+export class ForbiddenError extends AgentOsError {
+    code = "FORBIDDEN";
+    status = 403;
+    constructor(message = "Access denied", options) {
+        super(message, options);
+    }
+}
+// ============================================================================
+// Resource Errors
+// ============================================================================
+/**
+ * 404 Not Found - Resource does not exist.
+ *
+ * @example
+ * if (error instanceof NotFoundError) {
+ *     console.log(`Not found at: ${error.path}`);
+ * }
+ */
+export class NotFoundError extends AgentOsError {
+    path;
+    code = "NOT_FOUND";
+    status = 404;
+    constructor(message = "Resource not found", 
+    /** The request path that returned 404 */
+    path, options) {
+        super(message, options);
+        this.path = path;
+    }
+}
+/**
+ * 409 Conflict - Resource already exists or state conflict.
+ *
+ * @example
+ * if (error instanceof ConflictError) {
+ *     // Handle duplicate or version mismatch
+ * }
+ */
+export class ConflictError extends AgentOsError {
+    code = "CONFLICT";
+    status = 409;
+    constructor(message = "Resource conflict", options) {
+        super(message, options);
+    }
+}
+/**
+ * 400/422 Validation Error - Invalid request data.
+ *
+ * @example
+ * if (error instanceof ValidationError) {
+ *     error.fieldErrors?.forEach(fe => {
+ *         showFieldError(fe.field, fe.message);
+ *     });
+ * }
+ */
+export class ValidationError extends AgentOsError {
+    fieldErrors;
+    code = "VALIDATION_ERROR";
+    status;
+    constructor(message = "Validation failed", status = 400, fieldErrors, options) {
+        super(message, options);
+        this.fieldErrors = fieldErrors;
+        this.status = status;
+    }
+    /** Get error message for a specific field */
+    getFieldError(field) {
+        return this.fieldErrors?.find(fe => fe.field === field)?.message;
+    }
+    /** Check if a specific field has an error */
+    hasFieldError(field) {
+        return this.fieldErrors?.some(fe => fe.field === field) ?? false;
+    }
+}
+// ============================================================================
+// Rate Limiting
+// ============================================================================
+/**
+ * 429 Too Many Requests - Rate limit exceeded.
+ *
+ * @example
+ * if (error instanceof RateLimitError) {
+ *     if (error.retryAfterMs) {
+ *         await sleep(error.retryAfterMs);
+ *         // Retry request
+ *     }
+ * }
+ */
+export class RateLimitError extends AgentOsError {
+    retryAfterMs;
+    code = "RATE_LIMITED";
+    status = 429;
+    constructor(message = "Rate limit exceeded", 
+    /** Time to wait before retrying (milliseconds) */
+    retryAfterMs, options) {
+        super(message, options);
+        this.retryAfterMs = retryAfterMs;
+    }
+    isRetryable() {
+        return true;
+    }
+    /** Get retry delay or default */
+    getRetryDelay(defaultMs = 1000) {
+        return this.retryAfterMs ?? defaultMs;
+    }
+}
+// ============================================================================
+// Server Errors
+// ============================================================================
+/**
+ * 5xx Server Error - Backend failure.
+ *
+ * @example
+ * if (error instanceof ServerError) {
+ *     if (error.isRetryable()) {
+ *         // Retry with backoff
+ *     }
+ * }
+ */
+export class ServerError extends AgentOsError {
+    status;
+    code = "SERVER_ERROR";
+    constructor(message = "Internal server error", status = 500, options) {
+        super(message, options);
+        this.status = status;
+    }
+    isRetryable() {
+        // 500, 502, 503, 504 are typically retryable
+        return [500, 502, 503, 504].includes(this.status);
+    }
+}
+// ============================================================================
+// Network & Timeout Errors
+// ============================================================================
+/**
+ * Network Error - Fetch failed (no response received).
+ *
+ * @example
+ * if (error instanceof NetworkError) {
+ *     showToast("Network connection failed. Check your internet.");
+ * }
+ */
+export class NetworkError extends AgentOsError {
+    cause;
+    code = "NETWORK_ERROR";
+    status = 0;
+    constructor(message = "Network request failed", cause) {
+        super(message);
+        this.cause = cause;
+    }
+    isRetryable() {
+        return true;
+    }
+}
+/**
+ * Timeout Error - Request exceeded time limit.
+ *
+ * @example
+ * if (error instanceof TimeoutError) {
+ *     console.log(`Request timed out after ${error.timeoutMs}ms`);
+ * }
+ */
+export class TimeoutError extends AgentOsError {
+    timeoutMs;
+    code = "TIMEOUT";
+    status = 0;
+    constructor(
+    /** Timeout duration in milliseconds */
+    timeoutMs) {
+        super(`Request timed out after ${timeoutMs}ms`);
+        this.timeoutMs = timeoutMs;
+    }
+    isRetryable() {
+        return true;
+    }
+}
+// ============================================================================
+// Error Type Guards
+// ============================================================================
+/** Check if error is any Agent OS SDK error */
+export function isAgentOsError(error) {
+    return error instanceof AgentOsError;
+}
+/** Check if error is retryable */
+export function isRetryableError(error) {
+    if (error instanceof AgentOsError) {
+        return error.isRetryable();
+    }
+    return false;
+}
+/** Check if error is an auth error (401 or 403) */
+export function isAuthError(error) {
+    return error instanceof UnauthorizedError || error instanceof ForbiddenError;
+}
+/** Check if error is a client error (4xx) */
+export function isClientError(error) {
+    if (error instanceof AgentOsError) {
+        return error.status >= 400 && error.status < 500;
+    }
+    return false;
+}
+/** Check if error is a server error (5xx) */
+export function isServerError(error) {
+    if (error instanceof AgentOsError) {
+        return error.status >= 500 && error.status < 600;
+    }
+    return false;
+}

package/dist/index.d.ts

@@ -35,41 +35,49 @@
  * ```
  */
 export { AgentOsClient, type AgentOsClientOptions, type AuthProvider } from "./client/AgentOsClient.js";
-export { type ApiTokenAuth, type JwtAuth, isApiTokenAuth, isJwtAuth, isBrowser, isApiToken, isJwtToken, } from "./client/auth.js";
-export { unwrap, toResult, SDKError, type PaginationParams, type PaginatedResponse, type Result, type Unwrapped, } from "./client/helpers.js";
-export { createRawClient, createTypedClient, type RawClient, type TypedClient, type ClientOptions, type APIResponse, } from "./client/raw.js";
-export type { paths, components } from "./client/raw.js";
-export { AgentsModule, type Agent, type AgentVersion, type AgentListResponse, type AgentGraphResponse } from "./modules/agents.js";
-export { RunsModule, type Run, type RunStatus, type RunEvent, type RunListResponse, type RunEventsResponse, type CreateRunResponse, type RunEventsPollResponse, type RunEventDto } from "./modules/runs.js";
-export { ThreadsModule, type Thread, type ThreadState, type ThreadMessage, type ThreadRun, type ThreadListResponse, type ThreadMessagesResponse } from "./modules/threads.js";
-export { ToolsModule, type Tool, type ToolListResponse } from "./modules/tools.js";
-export { KnowledgeModule, type KnowledgeDataset, type KnowledgeSearchResponse } from "./modules/knowledge.js";
-export { TriggersModule, type Trigger, type TriggerListResponse } from "./modules/triggers.js";
-export { CredentialsModule, type Credential, type CredentialListResponse, type CredentialType } from "./modules/credentials.js";
+export { isApiToken, isApiTokenAuth, isBrowser, isJwtAuth, isJwtToken, type ApiTokenAuth, type JwtAuth } from "./client/auth.js";
+export { SDKError, toResult, unwrap, type PaginatedResponse, type PaginationParams, type Result, type Unwrapped } from "./client/helpers.js";
+export { AgentOsError, ConflictError, ForbiddenError, NetworkError, NotFoundError, RateLimitError, ServerError, TimeoutError, UnauthorizedError, ValidationError, isAgentOsError, isAuthError, isClientError, isRetryableError, isServerError, type ErrorOptions, type FieldError } from "./errors/index.js";
+export { createErrorFromResponse } from "./errors/factory.js";
+export { BACKGROUND_NETWORK_CONFIG, DEFAULT_NETWORK_CONFIG, INTERACTIVE_NETWORK_CONFIG, mergeNetworkConfig, type NetworkConfig, type RetryConfig } from "./client/config.js";
+export { sleep, withRetry, type RetryContext } from "./client/retry.js";
+export { createTimeoutController, withTimeout } from "./client/timeout.js";
+export { collectAll, getFirst, paginate, type CursorPaginatedResponse, type CursorParams, type OffsetPaginatedResponse, type OffsetParams, type PaginateOptions } from "./client/pagination.js";
+export { createRawClient, createTypedClient, type APIResponse, type ClientOptions, type HookErrorContext, type HookRequestContext, type HookResponseContext, type RawClient, type SDKHooks, type TypedClient } from "./client/raw.js";
+export type { components, paths } from "./client/raw.js";
+export { AgentsModule, type Agent, type AgentGraphResponse, type AgentListResponse, type AgentVersion } from "./modules/agents.js";
 export { BuilderModule, type BuilderChatRequest, type BuilderChatResponse, type BuilderStreamEvent, type GraphUpdateAction } from "./modules/builder.js";
-export { MembersModule, type Member, type MemberListResponse } from "./modules/members.js";
+export { CredentialsModule, type Credential, type CredentialListResponse, type CredentialType } from "./modules/credentials.js";
+export { KnowledgeModule, type KnowledgeDataset, type KnowledgeSearchResponse } from "./modules/knowledge.js";
+export { MembersModule, type Member, type MemberListResponse, type Role } from "./modules/members.js";
+export { RunsModule, type CreateRunResponse, type FollowEvent, type FollowOptions, type Run, type RunEvent, type RunEventDto, type RunEventsPollResponse, type RunEventsResponse, type RunListResponse, type RunStatus } from "./modules/runs.js";
 export { TenantsModule, type Tenant } from "./modules/tenants.js";
+export { ThreadsModule, type Thread, type ThreadListResponse, type ThreadMessage, type ThreadMessagesResponse, type ThreadRun, type ThreadState } from "./modules/threads.js";
+export { ToolsModule, type Tool, type ToolListResponse } from "./modules/tools.js";
+export { TriggersModule, type Trigger, type TriggerListResponse } from "./modules/triggers.js";
 export { WorkspacesModule, type Workspace, type WorkspaceListResponse } from "./modules/workspaces.js";
-export { PromptsModule, type Prompt, type PromptVersion, type PromptListResponse } from "./modules/prompts.js";
-export { TracesModule, type Trace, type Span, type TraceListResponse, type SpanData, type FeedbackRequest } from "./modules/traces.js";
-export { FilesModule, type StoredFile, type FileListResponse, type PresignedUpload } from "./modules/files.js";
-export { VectorStoresModule, type VectorStore, type VectorStoreListResponse, type VectorQueryResult } from "./modules/vectorStores.js";
-export { EvaluationModule, type EvalDataset, type Experiment, type ExampleData } from "./modules/evaluation.js";
+export { A2aModule, type A2aAgentCard, type JsonRpcRequest, type JsonRpcResponse } from "./modules/a2a.js";
+export { AuditModule, type AuditListResponse, type AuditLogEntry } from "./modules/audit.js";
+export { CatalogModule, type CatalogVersions, type NodeCatalogResponse, type NodeDefinition, type ToolCatalogResponse, type ToolDefinition, type TriggerCatalogResponse, type TriggerTemplate } from "./modules/catalog.js";
 export { CheckpointsModule, type Checkpoint, type CheckpointsResponse } from "./modules/checkpoints.js";
-export { PlaygroundModule, type PlaygroundSession } from "./modules/playground.js";
 export { CronsModule, type CronJob, type CronJobListResponse } from "./modules/crons.js";
-export { DlqModule, type DlqMessage, type DlqListResponse } from "./modules/dlq.js";
-export { StoreModule, type StoreValue } from "./modules/store.js";
-export { AuditModule, type AuditLogEntry, type AuditListResponse } from "./modules/audit.js";
-export { UsageModule, type UsageResponse, type UsageQuota } from "./modules/usage.js";
+export { DlqModule, type DlqListResponse, type DlqMessage } from "./modules/dlq.js";
+export { EvaluationModule, type EvalDataset, type ExampleData, type Experiment } from "./modules/evaluation.js";
+export { FilesModule, type FileListResponse, type PresignedUpload, type StoredFile } from "./modules/files.js";
+export { GraphsModule, type GraphIntrospectionResult, type GraphValidationResult } from "./modules/graphs.js";
+export { InfoModule, type ServerCapabilities, type ServerInfo } from "./modules/info.js";
 export { McpModule, type McpServer } from "./modules/mcp.js";
-export { A2aModule, type JsonRpcRequest, type JsonRpcResponse, type A2aAgentCard } from "./modules/a2a.js";
 export { MeModule, type MeResponse } from "./modules/me.js";
-export { InfoModule, type ServerInfo } from "./modules/info.js";
 export { MetricsModule, type MetricsResponse } from "./modules/metrics.js";
-export { GraphsModule, type GraphValidationResult, type GraphIntrospectionResult } from "./modules/graphs.js";
-export { CatalogModule, type CatalogVersions, type NodeCatalogResponse, type ToolCatalogResponse, type TriggerCatalogResponse, type NodeDefinition, type ToolDefinition, type TriggerTemplate } from "./modules/catalog.js";
-export { ApprovalsModule, type Approval, type ApprovalStatus, type ApprovalDecision, type ApprovalListResponse, type ApprovalStatusResponse } from "./modules/approvals.js";
-export { streamSSE, parseSSE, type SSEEvent, type SSEOptions, type RunStreamEvent, type RunSSEEvent, type RunEventDto as SSERunEventDto } from "./sse/client.js";
-export type { Agent as AgentSchema, CreateAgentRequest, UpdateAgentRequest, AgentBundle, CreateAgentVersionRequest, RunResponse, RunDetailResponse, WaitRunResponse, BatchRunResponse, CancelRunResponse, ReplayRequest, ThreadRequest, ThreadSearchRequest, AddMessageRequest, CheckpointDetail, CheckpointListResponse, CreateCredentialRequest, UpdateCredentialRequest, CreateCronJobRequest, UpdateCronJobRequest, InviteMemberRequest, UpdateMemberRequest, CreatePromptRequest, CreatePromptVersionRequest, CreatePresignedUploadRequest, PresignedUploadResponse, VectorStoreResponse, VectorQueryRequest, VectorQueryResponse, CreateDatasetRequest, CreateExperimentRequest, ProblemDetails, } from "./client/raw.js";
+export { PlaygroundModule, type PlaygroundSession } from "./modules/playground.js";
+export { PromptsModule, type Prompt, type PromptListResponse, type PromptVersion } from "./modules/prompts.js";
+export { StoreModule, type StoreValue } from "./modules/store.js";
+export { TracesModule, type FeedbackRequest, type Span, type SpanData, type Trace, type TraceListResponse } from "./modules/traces.js";
+export { UsageModule, type UsageQuota, type UsageResponse } from "./modules/usage.js";
+export { VectorStoresModule, type VectorQueryResult, type VectorStore, type VectorStoreListResponse } from "./modules/vectorStores.js";
+export { ApprovalsModule, type Approval, type ApprovalDecision, type ApprovalListResponse, type ApprovalStatus, type ApprovalStatusResponse } from "./modules/approvals.js";
+export { ApiTokensModule, type ApiToken, type ApiTokenSecret, type CreateTokenRequest, type RotateTokenResponse } from "./modules/apiTokens.js";
+export { MembershipsModule, type EnsureMembershipRequest, type MembershipResponse } from "./modules/memberships.js";
+export { parseSSE, streamSSE, type RunSSEEvent, type RunStreamEvent, type SSEEvent, type SSEOptions, type RunEventDto as SSERunEventDto } from "./sse/client.js";
+export type { AddMessageRequest, AgentBundle, Agent as AgentSchema, BatchRunResponse, CancelRunResponse, CheckpointDetail, CheckpointListResponse, CreateAgentRequest, CreateAgentVersionRequest, CreateCredentialRequest, CreateCronJobRequest, CreateDatasetRequest, CreateExperimentRequest, CreatePresignedUploadRequest, CreatePromptRequest, CreatePromptVersionRequest, InviteMemberRequest, PresignedUploadResponse, ProblemDetails, ReplayRequest, RunDetailResponse, RunResponse, ThreadRequest, ThreadSearchRequest, UpdateAgentRequest, UpdateCredentialRequest, UpdateCronJobRequest, UpdateMemberRequest, VectorQueryRequest, VectorQueryResponse, VectorStoreResponse, WaitRunResponse } from "./client/raw.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -39,53 +39,79 @@
 // ============================================================================
 export { AgentOsClient } from "./client/AgentOsClient.js";
 // Auth Provider Types
-export { isApiTokenAuth, isJwtAuth, isBrowser, isApiToken, isJwtToken, } from "./client/auth.js";
+export { isApiToken, isApiTokenAuth, isBrowser, isJwtAuth, isJwtToken } from "./client/auth.js";
 // ============================================================================
 // Helpers & Utilities
 // ============================================================================
-export { unwrap, toResult, SDKError, } from "./client/helpers.js";
+export { SDKError, toResult, unwrap } from "./client/helpers.js";
+// ============================================================================
+// Typed Errors (Enterprise)
+// ============================================================================
+export { 
+// Base class
+AgentOsError, ConflictError, ForbiddenError, NetworkError, NotFoundError, RateLimitError, ServerError, TimeoutError, 
+// Error classes
+UnauthorizedError, ValidationError, 
+// Type guards
+isAgentOsError, isAuthError, isClientError, isRetryableError, isServerError } from "./errors/index.js";
+export { createErrorFromResponse } from "./errors/factory.js";
+// ============================================================================
+// Network Configuration
+// ============================================================================
+export { BACKGROUND_NETWORK_CONFIG, DEFAULT_NETWORK_CONFIG, INTERACTIVE_NETWORK_CONFIG, mergeNetworkConfig } from "./client/config.js";
+// ============================================================================
+// Retry & Timeout Utilities
+// ============================================================================
+export { sleep, withRetry } from "./client/retry.js";
+export { createTimeoutController, withTimeout } from "./client/timeout.js";
+// ============================================================================
+// Pagination Utilities
+// ============================================================================
+export { collectAll, getFirst, paginate } from "./client/pagination.js";
 // ============================================================================
 // Raw Client & Core Types
 // ============================================================================
-export { createRawClient, createTypedClient, } from "./client/raw.js";
+export { createRawClient, createTypedClient } from "./client/raw.js";
 // ============================================================================
 // Module Classes
 // ============================================================================
 // Core modules
 export { AgentsModule } from "./modules/agents.js";
+export { BuilderModule } from "./modules/builder.js";
+export { CredentialsModule } from "./modules/credentials.js";
+export { KnowledgeModule } from "./modules/knowledge.js";
+export { MembersModule } from "./modules/members.js";
 export { RunsModule } from "./modules/runs.js";
+export { TenantsModule } from "./modules/tenants.js";
 export { ThreadsModule } from "./modules/threads.js";
 export { ToolsModule } from "./modules/tools.js";
-export { KnowledgeModule } from "./modules/knowledge.js";
 export { TriggersModule } from "./modules/triggers.js";
-export { CredentialsModule } from "./modules/credentials.js";
-export { BuilderModule } from "./modules/builder.js";
-export { MembersModule } from "./modules/members.js";
-export { TenantsModule } from "./modules/tenants.js";
 export { WorkspacesModule } from "./modules/workspaces.js";
 // Platform modules
-export { PromptsModule } from "./modules/prompts.js";
-export { TracesModule } from "./modules/traces.js";
-export { FilesModule } from "./modules/files.js";
-export { VectorStoresModule } from "./modules/vectorStores.js";
-export { EvaluationModule } from "./modules/evaluation.js";
+export { A2aModule } from "./modules/a2a.js";
+export { AuditModule } from "./modules/audit.js";
+export { CatalogModule } from "./modules/catalog.js";
 export { CheckpointsModule } from "./modules/checkpoints.js";
-export { PlaygroundModule } from "./modules/playground.js";
 export { CronsModule } from "./modules/crons.js";
 export { DlqModule } from "./modules/dlq.js";
-export { StoreModule } from "./modules/store.js";
-export { AuditModule } from "./modules/audit.js";
-export { UsageModule } from "./modules/usage.js";
+export { EvaluationModule } from "./modules/evaluation.js";
+export { FilesModule } from "./modules/files.js";
+export { GraphsModule } from "./modules/graphs.js";
+export { InfoModule } from "./modules/info.js";
 export { McpModule } from "./modules/mcp.js";
-export { A2aModule } from "./modules/a2a.js";
 export { MeModule } from "./modules/me.js";
-export { InfoModule } from "./modules/info.js";
 export { MetricsModule } from "./modules/metrics.js";
-export { GraphsModule } from "./modules/graphs.js";
-export { CatalogModule } from "./modules/catalog.js";
+export { PlaygroundModule } from "./modules/playground.js";
+export { PromptsModule } from "./modules/prompts.js";
+export { StoreModule } from "./modules/store.js";
+export { TracesModule } from "./modules/traces.js";
+export { UsageModule } from "./modules/usage.js";
+export { VectorStoresModule } from "./modules/vectorStores.js";
 // Approvals is real (has backend implementation)
 export { ApprovalsModule } from "./modules/approvals.js";
+export { ApiTokensModule } from "./modules/apiTokens.js";
+export { MembershipsModule } from "./modules/memberships.js";
 // ============================================================================
 // SSE Streaming
 // ============================================================================
-export { streamSSE, parseSSE } from "./sse/client.js";
+export { parseSSE, streamSSE } from "./sse/client.js";

package/dist/modules/audit.d.ts

@@ -34,8 +34,8 @@ export declare class AuditModule {
         workspace_id?: string;
         from?: string;
         to?: string;
-        skip?: number;
-        take?: number;
+        limit?: number;
+        offset?: number;
     }): Promise<APIResponse<AuditListResponse>>;
     /**
      * Get a specific audit log entry.
@@ -48,8 +48,31 @@ export declare class AuditModule {
         query?: string;
         from?: string;
         to?: string;
-        skip?: number;
-        take?: number;
+        limit?: number;
+        offset?: number;
     }): Promise<APIResponse<AuditListResponse>>;
+    /**
+     * Iterate through all audit logs with automatic pagination.
+     *
+     * @example
+     * ```ts
+     * // Get all audit logs for a specific action
+     * for await (const entry of client.audit.iterate({ action: "agent.created" })) {
+     *     console.log(entry.actor, entry.action);
+     * }
+     * ```
+     */
+    iterate(filters?: {
+        actor?: string;
+        action?: string;
+        resource?: string;
+        workspace_id?: string;
+        from?: string;
+        to?: string;
+    }, options?: {
+        pageSize?: number;
+        maxItems?: number;
+        signal?: AbortSignal;
+    }): AsyncGenerator<AuditLogEntry, void, unknown>;
 }
 //# sourceMappingURL=audit.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"audit.d.ts","sourceRoot":"","sources":["../../src/modules/audit.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/D,MAAM,WAAW,aAAa;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,WAAW,CAAC;IAC5C,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAC9B,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,WAAW;IACR,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,CAAC,MAAM,CAAC,EAAE;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;KACjB,GAAG,OAAO,CAAC,WAAW,CAAC,iBAAiB,CAAC,CAAC;IAO3C;;OAEG;IACG,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC;IAO/D;;OAEG;IACG,MAAM,CAAC,MAAM,CAAC,EAAE;QAClB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;KACjB,GAAG,OAAO,CAAC,WAAW,CAAC,iBAAiB,CAAC,CAAC;CAM9C"}
+{"version":3,"file":"audit.d.ts","sourceRoot":"","sources":["../../src/modules/audit.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/D,MAAM,WAAW,aAAa;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,WAAW,CAAC;IAC5C,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAC9B,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,WAAW;IACR,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,CAAC,MAAM,CAAC,EAAE;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;KACnB,GAAG,OAAO,CAAC,WAAW,CAAC,iBAAiB,CAAC,CAAC;IAiB3C;;OAEG;IACG,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC;IAO/D;;OAEG;IACG,MAAM,CAAC,MAAM,CAAC,EAAE;QAClB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;KACnB,GAAG,OAAO,CAAC,WAAW,CAAC,iBAAiB,CAAC,CAAC;IAiB3C;;;;;;;;;;OAUG;IACI,OAAO,CACV,OAAO,CAAC,EAAE;QACN,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,EAAE,CAAC,EAAE,MAAM,CAAC;KACf,EACD,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,aAAa,EAAE,IAAI,EAAE,OAAO,CAAC;CA6BlD"}

package/dist/modules/audit.js

@@ -12,8 +12,17 @@ export class AuditModule {
      * List audit log entries.
      */
     async list(params) {
+        const queryParams = { ...params };
+        if (params?.limit !== undefined) {
+            queryParams.take = params.limit;
+            delete queryParams.limit;
+        }
+        if (params?.offset !== undefined) {
+            queryParams.skip = params.offset;
+            delete queryParams.offset;
+        }
         return this.client.GET("/v1/api/audit", {
-            params: { query: params },
+            params: { query: queryParams },
             headers: this.headers(),
         });
     }
@@ -30,9 +39,56 @@ export class AuditModule {
      * Search audit logs by action pattern.
      */
     async search(params) {
+        const queryParams = { ...params };
+        if (params?.limit !== undefined) {
+            queryParams.take = params.limit;
+            delete queryParams.limit;
+        }
+        if (params?.offset !== undefined) {
+            queryParams.skip = params.offset;
+            delete queryParams.offset;
+        }
         return this.client.GET("/v1/api/audit/search", {
-            params: { query: params },
+            params: { query: queryParams },
             headers: this.headers(),
         });
     }
+    /**
+     * Iterate through all audit logs with automatic pagination.
+     *
+     * @example
+     * ```ts
+     * // Get all audit logs for a specific action
+     * for await (const entry of client.audit.iterate({ action: "agent.created" })) {
+     *     console.log(entry.actor, entry.action);
+     * }
+     * ```
+     */
+    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 entry of data.items) {
+                if (yielded >= maxItems)
+                    return;
+                yield entry;
+                yielded++;
+            }
+            offset += data.items.length;
+            hasMore = offset < data.total && data.items.length > 0;
+        }
+    }
 }