@cadraos/sdk 0.1.10 → 0.1.12

package/dist/index.cjs

@@ -54,7 +54,7 @@ var BaseResourceAPI = class {
 };
 
 // src/errors/sdk-errors.ts
-var AISaaSError = class extends Error {
+var CadraError = class extends Error {
   /** Error code */
   code;
   /** HTTP status code */
@@ -65,7 +65,7 @@ var AISaaSError = class extends Error {
   requestId;
   constructor(message, code, status, details, requestId) {
     super(message);
-    this.name = "AISaaSError";
+    this.name = "CadraError";
     this.code = code;
     this.status = status;
     this.details = details;
@@ -75,25 +75,25 @@ var AISaaSError = class extends Error {
     }
   }
 };
-var AuthenticationError = class extends AISaaSError {
+var AuthenticationError = class extends CadraError {
   constructor(message = "Authentication failed", code = "authentication_error", details, requestId) {
     super(message, code, 401, details, requestId);
     this.name = "AuthenticationError";
   }
 };
-var AuthorizationError = class extends AISaaSError {
+var AuthorizationError = class extends CadraError {
   constructor(message = "Access denied", code = "authorization_error", details, requestId) {
     super(message, code, 403, details, requestId);
     this.name = "AuthorizationError";
   }
 };
-var NotFoundError = class extends AISaaSError {
+var NotFoundError = class extends CadraError {
   constructor(message = "Resource not found", code = "not_found", details, requestId) {
     super(message, code, 404, details, requestId);
     this.name = "NotFoundError";
   }
 };
-var ValidationError = class extends AISaaSError {
+var ValidationError = class extends CadraError {
   /** Field-level validation errors */
   errors;
   constructor(message = "Validation failed", errors = [], details, requestId) {
@@ -102,7 +102,7 @@ var ValidationError = class extends AISaaSError {
     this.errors = errors;
   }
 };
-var RateLimitError = class extends AISaaSError {
+var RateLimitError = class extends CadraError {
   /** Seconds until rate limit resets */
   retryAfter;
   constructor(message = "Rate limit exceeded", retryAfter, details, requestId) {
@@ -111,25 +111,25 @@ var RateLimitError = class extends AISaaSError {
     this.retryAfter = retryAfter;
   }
 };
-var ServerError = class extends AISaaSError {
+var ServerError = class extends CadraError {
   constructor(message = "Server error", status = 500, details, requestId) {
     super(message, "server_error", status, details, requestId);
     this.name = "ServerError";
   }
 };
-var ConflictError = class extends AISaaSError {
+var ConflictError = class extends CadraError {
   constructor(message = "Resource conflict", details, requestId) {
     super(message, "conflict", 409, details, requestId);
     this.name = "ConflictError";
   }
 };
-var TimeoutError = class extends AISaaSError {
+var TimeoutError = class extends CadraError {
   constructor(message = "Request timed out", details, requestId) {
     super(message, "timeout", 408, details, requestId);
     this.name = "TimeoutError";
   }
 };
-var NetworkError = class extends AISaaSError {
+var NetworkError = class extends CadraError {
   constructor(message = "Network error", details) {
     super(message, "network_error", 0, details);
     this.name = "NetworkError";
@@ -171,7 +171,7 @@ function parseApiError(status, body, requestId) {
       if (status >= 500) {
         return new ServerError(message, status, details, requestId);
       }
-      return new AISaaSError(message, code, status, details, requestId);
+      return new CadraError(message, code, status, details, requestId);
   }
 }
 
@@ -259,15 +259,21 @@ var HttpClient = class {
    * Build full URL with query parameters
    */
   buildUrl(path, query) {
-    const url = new URL(path, this.config.baseUrl);
+    const base = this.config.baseUrl.replace(/\/+$/, "");
+    let url = `${base}${path}`;
     if (query) {
+      const params = new URLSearchParams();
       for (const [key, value] of Object.entries(query)) {
         if (value !== void 0) {
-          url.searchParams.set(key, String(value));
+          params.set(key, String(value));
         }
       }
+      const qs = params.toString();
+      if (qs) {
+        url += `?${qs}`;
+      }
     }
-    return url.toString();
+    return url;
   }
   /**
    * Make an HTTP request
@@ -571,9 +577,11 @@ var DEFAULT_STREAMING_CONFIG = {
   activityTimeoutMs: 3e4,
   pollingIntervalMs: 2e3
 };
+var DEFAULT_POLLING_ENABLED = true;
 var ExecutionStreamControllerImpl = class {
   options;
   config;
+  pollingEnabled;
   sseClient = null;
   status = "connecting";
   reconnectAttempts = 0;
@@ -607,6 +615,7 @@ var ExecutionStreamControllerImpl = class {
   constructor(options) {
     this.options = options;
     this.config = { ...DEFAULT_STREAMING_CONFIG, ...options.config };
+    this.pollingEnabled = options.pollingEnabled ?? DEFAULT_POLLING_ENABLED;
   }
   /**
    * Get the last event ID (for resume support)
@@ -667,7 +676,7 @@ var ExecutionStreamControllerImpl = class {
       return Promise.resolve(this.finalExecution);
     }
     if (this.finalError) {
-      return Promise.reject(new AISaaSError(
+      return Promise.reject(new CadraError(
         this.finalError.error,
         this.finalError.errorCode ?? "execution_error",
         500
@@ -686,7 +695,8 @@ var ExecutionStreamControllerImpl = class {
    * Connect to SSE endpoint
    */
   async connectSSE() {
-    const url = `${this.options.baseUrl}/agents/runs/${this.options.executionId}/stream`;
+    const base = this.options.baseUrl.replace(/\/+$/, "");
+    const url = `${base}/api/v1/agents/runs/${this.options.executionId}/stream`;
     let authToken = this.options.apiKey;
     if (!authToken && this.options.tokenProvider) {
       authToken = await this.options.tokenProvider();
@@ -921,7 +931,7 @@ var ExecutionStreamControllerImpl = class {
     this.finalError = error;
     this.emit("error", error);
     if (this.waitReject) {
-      this.waitReject(new AISaaSError(
+      this.waitReject(new CadraError(
         error.error,
         error.errorCode ?? "execution_error",
         500
@@ -946,15 +956,61 @@ var ExecutionStreamControllerImpl = class {
       if (this.status === "closed") {
         return;
       }
+      await this.recoverState();
+      if (this.status === "closed") {
+        return;
+      }
       try {
         await this.connectSSE();
       } catch {
         await this.handleConnectionError(error);
       }
     } else {
-      this.status = "fallback_polling";
-      this.emit("connectionChange", { connected: false, usingFallback: true });
-      this.startPolling();
+      if (this.pollingEnabled) {
+        this.status = "fallback_polling";
+        this.emit("connectionChange", { connected: false, usingFallback: true });
+        this.startPolling();
+      } else {
+        this.handleError({
+          error: "SSE connection failed and polling is disabled",
+          errorCode: "connection_failed"
+        });
+      }
+    }
+  }
+  /**
+   * Recover state by checking execution status.
+   *
+   * Called during reconnection to catch any events missed while SSE was down.
+   * If the execution completed while disconnected, emits completion immediately.
+   * Otherwise, emits any new logs that weren't seen via SSE.
+   */
+  async recoverState() {
+    try {
+      const execution = await this.options.getExecution(this.options.executionId);
+      if (execution.logs) {
+        for (const log of execution.logs) {
+          if (!this.seenEventIds.has(log.uuid)) {
+            this.seenEventIds.add(log.uuid);
+            this.emit("log", log);
+          }
+        }
+      }
+      if (execution.status === "completed") {
+        this.stopPolling();
+        this.handleComplete(execution);
+        return;
+      }
+      if (execution.status === "failed" || execution.status === "cancelled") {
+        this.stopPolling();
+        this.handleError({
+          error: execution.error ?? `Execution ${execution.status}`,
+          errorCode: execution.status
+        });
+        return;
+      }
+    } catch (err) {
+      console.warn("[SDK:StreamController] State recovery failed (non-fatal):", err);
     }
   }
   /**
@@ -1039,7 +1095,7 @@ function createExecutionStreamController(options) {
 // src/resources/agents.ts
 var AgentsAPI = class extends BaseResourceAPI {
   constructor(http, getStreamConfig) {
-    super(http, "/agents");
+    super(http, "/api/v1/agents");
     this.getStreamConfig = getStreamConfig;
   }
   // ===== LIST Operations =====
@@ -1315,7 +1371,7 @@ var AgentsAPI = class extends BaseResourceAPI {
 // src/resources/skills.ts
 var SkillsAPI = class extends BaseResourceAPI {
   constructor(http) {
-    super(http, "/skills");
+    super(http, "/api/v1/skills");
   }
   // ===== LIST Operations =====
   /**
@@ -1459,7 +1515,7 @@ var SkillsAPI = class extends BaseResourceAPI {
 // src/resources/tools.ts
 var ToolsAPI = class extends BaseResourceAPI {
   constructor(http) {
-    super(http, "/tools");
+    super(http, "/api/v1/tools");
   }
   // ===== LIST Operations =====
   /**
@@ -1622,7 +1678,7 @@ var ToolsAPI = class extends BaseResourceAPI {
 // src/resources/artifacts.ts
 var ArtifactsAPI = class extends BaseResourceAPI {
   constructor(http) {
-    super(http, "/artifacts");
+    super(http, "/api/v1/artifacts");
   }
   // ===== LIST Operations =====
   /**
@@ -1818,7 +1874,7 @@ var ArtifactsAPI = class extends BaseResourceAPI {
 // src/resources/sessions.ts
 var SessionsAPI = class extends BaseResourceAPI {
   constructor(http, getStreamConfig) {
-    super(http, "/sessions");
+    super(http, "/api/v1/sessions");
     this.getStreamConfig = getStreamConfig;
   }
   // ===== LIST Operations =====
@@ -2049,9 +2105,9 @@ var SessionsAPI = class extends BaseResourceAPI {
 };
 
 // src/client.ts
-var DEFAULT_BASE_URL = "https://api.aisaas.com/v1";
+var DEFAULT_BASE_URL = "https://api.cadraos.com";
 var DEFAULT_TIMEOUT = 3e4;
-var AISaaSClient = class {
+var CadraClient = class {
   httpClient;
   config;
   /**
@@ -2082,19 +2138,19 @@ var AISaaSClient = class {
    * @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,
    * });
@@ -2102,6 +2158,19 @@ var AISaaSClient = class {
    */
   constructor(options) {
     this.validateOptions(options);
+    if (options.baseUrl) {
+      try {
+        const parsed = new URL(options.baseUrl);
+        if (/\/(api|v\d)/.test(parsed.pathname)) {
+          if (typeof process !== "undefined" && process.env?.NODE_ENV !== "production") {
+            console.warn(
+              `[CadraOS SDK] baseUrl should be the origin only (e.g., "https://api.cadraos.com" or "http://localhost:3000"). The SDK automatically prepends "/api/v1/" to all requests. Received: "${options.baseUrl}"`
+            );
+          }
+        }
+      } catch {
+      }
+    }
     this.config = {
       baseUrl: options.baseUrl ?? DEFAULT_BASE_URL,
       orgId: options.orgId,
@@ -2164,10 +2233,12 @@ var AISaaSClient = class {
   }
 };
 
-exports.AISaaSClient = AISaaSClient;
-exports.AISaaSError = AISaaSError;
+exports.AISaaSClient = CadraClient;
+exports.AISaaSError = CadraError;
 exports.AuthenticationError = AuthenticationError;
 exports.AuthorizationError = AuthorizationError;
+exports.CadraClient = CadraClient;
+exports.CadraError = CadraError;
 exports.ConflictError = ConflictError;
 exports.NetworkError = NetworkError;
 exports.NotFoundError = NotFoundError;