@cadraos/sdk 0.1.10 → 0.1.12

package/dist/index.d.cts

@@ -1115,6 +1115,8 @@ interface ExecutionStreamControllerOptions {
     getExecution: (executionId: string) => Promise<AgentExecution>;
     /** Streaming configuration */
     config?: Partial<StreamingConfig>;
+    /** Whether polling fallback is enabled (default: true) */
+    pollingEnabled?: boolean;
 }
 /**
  * Execution Stream Controller
@@ -1901,17 +1903,17 @@ declare class SessionsAPI extends BaseResourceAPI {
 }
 
 /**
- * AI SaaS Client
+ * Cadra Client
  *
  * Main entry point for the SDK. Provides access to all resource APIs.
  *
  * @example
  * ```typescript
- * import { AISaaSClient } from '@cadraos/sdk';
+ * import { CadraClient } from '@cadraos/sdk';
  *
- * const client = new AISaaSClient({
- *   apiKey: process.env.AISAAS_API_KEY,
- *   orgId: Number(process.env.AISAAS_ORG_ID),
+ * const client = new CadraClient({
+ *   apiKey: process.env.CADRA_API_KEY,
+ *   orgId: Number(process.env.CADRA_ORG_ID),
  * });
  *
  * // List agents
@@ -1937,12 +1939,12 @@ declare class SessionsAPI extends BaseResourceAPI {
 /**
  * Client options for API key authentication
  */
-interface AISaaSClientOptionsApiKey {
+interface CadraClientOptionsApiKey {
     /** API key for authentication */
     apiKey: string;
     /** Organization ID */
     orgId: number;
-    /** Base URL for API (default: https://api.aisaas.com/v1) */
+    /** Base URL for API (default: https://api.cadraos.com) */
     baseUrl?: string;
     /** Request timeout in milliseconds (default: 30000) */
     timeout?: number;
@@ -1954,12 +1956,12 @@ interface AISaaSClientOptionsApiKey {
 /**
  * Client options for OAuth token authentication
  */
-interface AISaaSClientOptionsToken {
+interface CadraClientOptionsToken {
     /** OAuth token for authentication */
     token: string;
     /** Organization ID */
     orgId: number;
-    /** Base URL for API (default: https://api.aisaas.com/v1) */
+    /** Base URL for API (default: https://api.cadraos.com) */
     baseUrl?: string;
     /** Request timeout in milliseconds (default: 30000) */
     timeout?: number;
@@ -1971,12 +1973,12 @@ interface AISaaSClientOptionsToken {
 /**
  * Client options for token provider authentication
  */
-interface AISaaSClientOptionsTokenProvider {
+interface CadraClientOptionsTokenProvider {
     /** Token provider callback (called before each request) */
     tokenProvider: () => Promise<string>;
     /** Organization ID */
     orgId: number;
-    /** Base URL for API (default: https://api.aisaas.com/v1) */
+    /** Base URL for API (default: https://api.cadraos.com) */
     baseUrl?: string;
     /** Request timeout in milliseconds (default: 30000) */
     timeout?: number;
@@ -1988,14 +1990,14 @@ interface AISaaSClientOptionsTokenProvider {
 /**
  * All client options
  */
-type AISaaSClientOptions = AISaaSClientOptionsApiKey | AISaaSClientOptionsToken | AISaaSClientOptionsTokenProvider;
+type CadraClientOptions = CadraClientOptionsApiKey | CadraClientOptionsToken | CadraClientOptionsTokenProvider;
 /**
  * AI SaaS Client
  *
  * Main class for interacting with the AI SaaS API.
  * Provides access to all resource APIs (agents, skills, tools, artifacts, sessions).
  */
-declare class AISaaSClient {
+declare class CadraClient {
     private readonly httpClient;
     private readonly config;
     /**
@@ -2026,25 +2028,25 @@ declare class AISaaSClient {
      * @example
      * ```typescript
      * // API key authentication
-     * const client = new AISaaSClient({
+     * const client = new CadraClient({
      *   apiKey: 'sk_...',
      *   orgId: 123,
      * });
      *
      * // OAuth token authentication
-     * const client = new AISaaSClient({
+     * const client = new CadraClient({
      *   token: 'eyJ...',
      *   orgId: 123,
      * });
      *
      * // Token provider (for automatic refresh)
-     * const client = new AISaaSClient({
+     * const client = new CadraClient({
      *   tokenProvider: async () => myAuth.getAccessToken(),
      *   orgId: 123,
      * });
      * ```
      */
-    constructor(options: AISaaSClientOptions);
+    constructor(options: CadraClientOptions);
     /**
      * Validate client options
      */
@@ -2055,12 +2057,12 @@ declare class AISaaSClient {
  * SDK Error Classes
  *
  * Typed error hierarchy for all SDK operations.
- * All errors extend AISaaSError and include code, status, and optional details.
+ * All errors extend CadraError and include code, status, and optional details.
  */
 /**
  * Base error class for all SDK errors
  */
-declare class AISaaSError extends Error {
+declare class CadraError extends Error {
     /** Error code */
     readonly code: string;
     /** HTTP status code */
@@ -2075,28 +2077,28 @@ declare class AISaaSError extends Error {
  * Authentication error (401)
  * Thrown when API key is invalid, expired, or missing
  */
-declare class AuthenticationError extends AISaaSError {
+declare class AuthenticationError extends CadraError {
     constructor(message?: string, code?: string, details?: Record<string, unknown>, requestId?: string);
 }
 /**
  * Authorization error (403)
  * Thrown when user lacks permission for the requested operation
  */
-declare class AuthorizationError extends AISaaSError {
+declare class AuthorizationError extends CadraError {
     constructor(message?: string, code?: string, details?: Record<string, unknown>, requestId?: string);
 }
 /**
  * Not found error (404)
  * Thrown when requested resource does not exist
  */
-declare class NotFoundError extends AISaaSError {
+declare class NotFoundError extends CadraError {
     constructor(message?: string, code?: string, details?: Record<string, unknown>, requestId?: string);
 }
 /**
  * Validation error (400/422)
  * Thrown when request input is invalid
  */
-declare class ValidationError extends AISaaSError {
+declare class ValidationError extends CadraError {
     /** Field-level validation errors */
     readonly errors: Array<{
         field: string;
@@ -2111,7 +2113,7 @@ declare class ValidationError extends AISaaSError {
  * Rate limit error (429)
  * Thrown when rate limit is exceeded
  */
-declare class RateLimitError extends AISaaSError {
+declare class RateLimitError extends CadraError {
     /** Seconds until rate limit resets */
     readonly retryAfter?: number;
     constructor(message?: string, retryAfter?: number, details?: Record<string, unknown>, requestId?: string);
@@ -2120,29 +2122,29 @@ declare class RateLimitError extends AISaaSError {
  * Server error (5xx)
  * Thrown for server-side errors
  */
-declare class ServerError extends AISaaSError {
+declare class ServerError extends CadraError {
     constructor(message?: string, status?: number, details?: Record<string, unknown>, requestId?: string);
 }
 /**
  * Conflict error (409)
  * Thrown when there is a resource conflict
  */
-declare class ConflictError extends AISaaSError {
+declare class ConflictError extends CadraError {
     constructor(message?: string, details?: Record<string, unknown>, requestId?: string);
 }
 /**
  * Timeout error
  * Thrown when a request or operation times out
  */
-declare class TimeoutError extends AISaaSError {
+declare class TimeoutError extends CadraError {
     constructor(message?: string, details?: Record<string, unknown>, requestId?: string);
 }
 /**
  * Network error
  * Thrown when there is a network connectivity issue
  */
-declare class NetworkError extends AISaaSError {
+declare class NetworkError extends CadraError {
     constructor(message?: string, details?: Record<string, unknown>);
 }
 
-export { AISaaSClient, type AISaaSClientOptions, AISaaSError, type Agent, type AgentConfig, type AgentConfigUpdateInput, type AgentExecution, type AgentListOptions, type AgentStatus, type AgentType, type AgentUpdateInput, type Artifact, type ArtifactDownloadOptions, type ArtifactListOptions, type ArtifactType, type ArtifactUploadInput, AuthenticationError, AuthorizationError, type CompleteEvent, ConflictError, type ConnectionChangeEvent, type DelegationCompletedEvent, type DelegationStartedEvent, type ErrorEvent, type ExecuteInput, type ExecuteOptions, type ExecuteResponse, type ExecuteToolDirectRequest, type ExecuteToolDirectResponse, type ExecutionLog, type ExecutionStatus, type ExecutionStreamController, type ExecutionStreamControllerOptions, type JSONSchema, type ListOptions, NetworkError, NotFoundError, type PaginatedResponse, type PaginationInfo, type PausedEvent, type PlanEvent, type ProgressEvent, RateLimitError, type SendMessageInput, ServerError, type Session, type SessionArtifact, type SessionArtifactListOptions, type SessionArtifactType, type SessionArtifactVariantType, type SessionCreateInput, type SessionHistory, type SessionListOptions, type SessionMessage, type SignedUrlResponse, type Skill, type SkillDetails, type SkillExecuteInput, type SkillExecution, type SkillListOptions, type SkillTool, type SkillUpdateInput, type SkillVariable, type StartedEvent, type StreamController, type StreamEventMap, type TextDeltaEvent, TimeoutError, type TokenUsage, type Tool, type ToolCallEvent, type ToolConfigUpdateInput, type ToolExecution, type ToolListOptions, type ToolResultEvent, type ToolUpdateInput, type ToolValidationResult, ValidationError };
+export { CadraClient as AISaaSClient, type CadraClientOptions as AISaaSClientOptions, CadraError as AISaaSError, type Agent, type AgentConfig, type AgentConfigUpdateInput, type AgentExecution, type AgentListOptions, type AgentStatus, type AgentType, type AgentUpdateInput, type Artifact, type ArtifactDownloadOptions, type ArtifactListOptions, type ArtifactType, type ArtifactUploadInput, AuthenticationError, AuthorizationError, CadraClient, type CadraClientOptions, CadraError, type CompleteEvent, ConflictError, type ConnectionChangeEvent, type DelegationCompletedEvent, type DelegationStartedEvent, type ErrorEvent, type ExecuteInput, type ExecuteOptions, type ExecuteResponse, type ExecuteToolDirectRequest, type ExecuteToolDirectResponse, type ExecutionLog, type ExecutionStatus, type ExecutionStreamController, type ExecutionStreamControllerOptions, type JSONSchema, type ListOptions, NetworkError, NotFoundError, type PaginatedResponse, type PaginationInfo, type PausedEvent, type PlanEvent, type ProgressEvent, RateLimitError, type SendMessageInput, ServerError, type Session, type SessionArtifact, type SessionArtifactListOptions, type SessionArtifactType, type SessionArtifactVariantType, type SessionCreateInput, type SessionHistory, type SessionListOptions, type SessionMessage, type SignedUrlResponse, type Skill, type SkillDetails, type SkillExecuteInput, type SkillExecution, type SkillListOptions, type SkillTool, type SkillUpdateInput, type SkillVariable, type StartedEvent, type StreamController, type StreamEventMap, type TextDeltaEvent, TimeoutError, type TokenUsage, type Tool, type ToolCallEvent, type ToolConfigUpdateInput, type ToolExecution, type ToolListOptions, type ToolResultEvent, type ToolUpdateInput, type ToolValidationResult, ValidationError };

package/dist/index.d.ts

@@ -1115,6 +1115,8 @@ interface ExecutionStreamControllerOptions {
     getExecution: (executionId: string) => Promise<AgentExecution>;
     /** Streaming configuration */
     config?: Partial<StreamingConfig>;
+    /** Whether polling fallback is enabled (default: true) */
+    pollingEnabled?: boolean;
 }
 /**
  * Execution Stream Controller
@@ -1901,17 +1903,17 @@ declare class SessionsAPI extends BaseResourceAPI {
 }
 
 /**
- * AI SaaS Client
+ * Cadra Client
  *
  * Main entry point for the SDK. Provides access to all resource APIs.
  *
  * @example
  * ```typescript
- * import { AISaaSClient } from '@cadraos/sdk';
+ * import { CadraClient } from '@cadraos/sdk';
  *
- * const client = new AISaaSClient({
- *   apiKey: process.env.AISAAS_API_KEY,
- *   orgId: Number(process.env.AISAAS_ORG_ID),
+ * const client = new CadraClient({
+ *   apiKey: process.env.CADRA_API_KEY,
+ *   orgId: Number(process.env.CADRA_ORG_ID),
  * });
  *
  * // List agents
@@ -1937,12 +1939,12 @@ declare class SessionsAPI extends BaseResourceAPI {
 /**
  * Client options for API key authentication
  */
-interface AISaaSClientOptionsApiKey {
+interface CadraClientOptionsApiKey {
     /** API key for authentication */
     apiKey: string;
     /** Organization ID */
     orgId: number;
-    /** Base URL for API (default: https://api.aisaas.com/v1) */
+    /** Base URL for API (default: https://api.cadraos.com) */
     baseUrl?: string;
     /** Request timeout in milliseconds (default: 30000) */
     timeout?: number;
@@ -1954,12 +1956,12 @@ interface AISaaSClientOptionsApiKey {
 /**
  * Client options for OAuth token authentication
  */
-interface AISaaSClientOptionsToken {
+interface CadraClientOptionsToken {
     /** OAuth token for authentication */
     token: string;
     /** Organization ID */
     orgId: number;
-    /** Base URL for API (default: https://api.aisaas.com/v1) */
+    /** Base URL for API (default: https://api.cadraos.com) */
     baseUrl?: string;
     /** Request timeout in milliseconds (default: 30000) */
     timeout?: number;
@@ -1971,12 +1973,12 @@ interface AISaaSClientOptionsToken {
 /**
  * Client options for token provider authentication
  */
-interface AISaaSClientOptionsTokenProvider {
+interface CadraClientOptionsTokenProvider {
     /** Token provider callback (called before each request) */
     tokenProvider: () => Promise<string>;
     /** Organization ID */
     orgId: number;
-    /** Base URL for API (default: https://api.aisaas.com/v1) */
+    /** Base URL for API (default: https://api.cadraos.com) */
     baseUrl?: string;
     /** Request timeout in milliseconds (default: 30000) */
     timeout?: number;
@@ -1988,14 +1990,14 @@ interface AISaaSClientOptionsTokenProvider {
 /**
  * All client options
  */
-type AISaaSClientOptions = AISaaSClientOptionsApiKey | AISaaSClientOptionsToken | AISaaSClientOptionsTokenProvider;
+type CadraClientOptions = CadraClientOptionsApiKey | CadraClientOptionsToken | CadraClientOptionsTokenProvider;
 /**
  * AI SaaS Client
  *
  * Main class for interacting with the AI SaaS API.
  * Provides access to all resource APIs (agents, skills, tools, artifacts, sessions).
  */
-declare class AISaaSClient {
+declare class CadraClient {
     private readonly httpClient;
     private readonly config;
     /**
@@ -2026,25 +2028,25 @@ declare class AISaaSClient {
      * @example
      * ```typescript
      * // API key authentication
-     * const client = new AISaaSClient({
+     * const client = new CadraClient({
      *   apiKey: 'sk_...',
      *   orgId: 123,
      * });
      *
      * // OAuth token authentication
-     * const client = new AISaaSClient({
+     * const client = new CadraClient({
      *   token: 'eyJ...',
      *   orgId: 123,
      * });
      *
      * // Token provider (for automatic refresh)
-     * const client = new AISaaSClient({
+     * const client = new CadraClient({
      *   tokenProvider: async () => myAuth.getAccessToken(),
      *   orgId: 123,
      * });
      * ```
      */
-    constructor(options: AISaaSClientOptions);
+    constructor(options: CadraClientOptions);
     /**
      * Validate client options
      */
@@ -2055,12 +2057,12 @@ declare class AISaaSClient {
  * SDK Error Classes
  *
  * Typed error hierarchy for all SDK operations.
- * All errors extend AISaaSError and include code, status, and optional details.
+ * All errors extend CadraError and include code, status, and optional details.
  */
 /**
  * Base error class for all SDK errors
  */
-declare class AISaaSError extends Error {
+declare class CadraError extends Error {
     /** Error code */
     readonly code: string;
     /** HTTP status code */
@@ -2075,28 +2077,28 @@ declare class AISaaSError extends Error {
  * Authentication error (401)
  * Thrown when API key is invalid, expired, or missing
  */
-declare class AuthenticationError extends AISaaSError {
+declare class AuthenticationError extends CadraError {
     constructor(message?: string, code?: string, details?: Record<string, unknown>, requestId?: string);
 }
 /**
  * Authorization error (403)
  * Thrown when user lacks permission for the requested operation
  */
-declare class AuthorizationError extends AISaaSError {
+declare class AuthorizationError extends CadraError {
     constructor(message?: string, code?: string, details?: Record<string, unknown>, requestId?: string);
 }
 /**
  * Not found error (404)
  * Thrown when requested resource does not exist
  */
-declare class NotFoundError extends AISaaSError {
+declare class NotFoundError extends CadraError {
     constructor(message?: string, code?: string, details?: Record<string, unknown>, requestId?: string);
 }
 /**
  * Validation error (400/422)
  * Thrown when request input is invalid
  */
-declare class ValidationError extends AISaaSError {
+declare class ValidationError extends CadraError {
     /** Field-level validation errors */
     readonly errors: Array<{
         field: string;
@@ -2111,7 +2113,7 @@ declare class ValidationError extends AISaaSError {
  * Rate limit error (429)
  * Thrown when rate limit is exceeded
  */
-declare class RateLimitError extends AISaaSError {
+declare class RateLimitError extends CadraError {
     /** Seconds until rate limit resets */
     readonly retryAfter?: number;
     constructor(message?: string, retryAfter?: number, details?: Record<string, unknown>, requestId?: string);
@@ -2120,29 +2122,29 @@ declare class RateLimitError extends AISaaSError {
  * Server error (5xx)
  * Thrown for server-side errors
  */
-declare class ServerError extends AISaaSError {
+declare class ServerError extends CadraError {
     constructor(message?: string, status?: number, details?: Record<string, unknown>, requestId?: string);
 }
 /**
  * Conflict error (409)
  * Thrown when there is a resource conflict
  */
-declare class ConflictError extends AISaaSError {
+declare class ConflictError extends CadraError {
     constructor(message?: string, details?: Record<string, unknown>, requestId?: string);
 }
 /**
  * Timeout error
  * Thrown when a request or operation times out
  */
-declare class TimeoutError extends AISaaSError {
+declare class TimeoutError extends CadraError {
     constructor(message?: string, details?: Record<string, unknown>, requestId?: string);
 }
 /**
  * Network error
  * Thrown when there is a network connectivity issue
  */
-declare class NetworkError extends AISaaSError {
+declare class NetworkError extends CadraError {
     constructor(message?: string, details?: Record<string, unknown>);
 }
 
-export { AISaaSClient, type AISaaSClientOptions, AISaaSError, type Agent, type AgentConfig, type AgentConfigUpdateInput, type AgentExecution, type AgentListOptions, type AgentStatus, type AgentType, type AgentUpdateInput, type Artifact, type ArtifactDownloadOptions, type ArtifactListOptions, type ArtifactType, type ArtifactUploadInput, AuthenticationError, AuthorizationError, type CompleteEvent, ConflictError, type ConnectionChangeEvent, type DelegationCompletedEvent, type DelegationStartedEvent, type ErrorEvent, type ExecuteInput, type ExecuteOptions, type ExecuteResponse, type ExecuteToolDirectRequest, type ExecuteToolDirectResponse, type ExecutionLog, type ExecutionStatus, type ExecutionStreamController, type ExecutionStreamControllerOptions, type JSONSchema, type ListOptions, NetworkError, NotFoundError, type PaginatedResponse, type PaginationInfo, type PausedEvent, type PlanEvent, type ProgressEvent, RateLimitError, type SendMessageInput, ServerError, type Session, type SessionArtifact, type SessionArtifactListOptions, type SessionArtifactType, type SessionArtifactVariantType, type SessionCreateInput, type SessionHistory, type SessionListOptions, type SessionMessage, type SignedUrlResponse, type Skill, type SkillDetails, type SkillExecuteInput, type SkillExecution, type SkillListOptions, type SkillTool, type SkillUpdateInput, type SkillVariable, type StartedEvent, type StreamController, type StreamEventMap, type TextDeltaEvent, TimeoutError, type TokenUsage, type Tool, type ToolCallEvent, type ToolConfigUpdateInput, type ToolExecution, type ToolListOptions, type ToolResultEvent, type ToolUpdateInput, type ToolValidationResult, ValidationError };
+export { CadraClient as AISaaSClient, type CadraClientOptions as AISaaSClientOptions, CadraError as AISaaSError, type Agent, type AgentConfig, type AgentConfigUpdateInput, type AgentExecution, type AgentListOptions, type AgentStatus, type AgentType, type AgentUpdateInput, type Artifact, type ArtifactDownloadOptions, type ArtifactListOptions, type ArtifactType, type ArtifactUploadInput, AuthenticationError, AuthorizationError, CadraClient, type CadraClientOptions, CadraError, type CompleteEvent, ConflictError, type ConnectionChangeEvent, type DelegationCompletedEvent, type DelegationStartedEvent, type ErrorEvent, type ExecuteInput, type ExecuteOptions, type ExecuteResponse, type ExecuteToolDirectRequest, type ExecuteToolDirectResponse, type ExecutionLog, type ExecutionStatus, type ExecutionStreamController, type ExecutionStreamControllerOptions, type JSONSchema, type ListOptions, NetworkError, NotFoundError, type PaginatedResponse, type PaginationInfo, type PausedEvent, type PlanEvent, type ProgressEvent, RateLimitError, type SendMessageInput, ServerError, type Session, type SessionArtifact, type SessionArtifactListOptions, type SessionArtifactType, type SessionArtifactVariantType, type SessionCreateInput, type SessionHistory, type SessionListOptions, type SessionMessage, type SignedUrlResponse, type Skill, type SkillDetails, type SkillExecuteInput, type SkillExecution, type SkillListOptions, type SkillTool, type SkillUpdateInput, type SkillVariable, type StartedEvent, type StreamController, type StreamEventMap, type TextDeltaEvent, TimeoutError, type TokenUsage, type Tool, type ToolCallEvent, type ToolConfigUpdateInput, type ToolExecution, type ToolListOptions, type ToolResultEvent, type ToolUpdateInput, type ToolValidationResult, ValidationError };