@cadraos/sdk 0.1.10 → 0.1.12

package/dist/index.js

@@ -52,7 +52,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 */
@@ -63,7 +63,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;
@@ -73,25 +73,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) {
@@ -100,7 +100,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) {
@@ -109,25 +109,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";
@@ -169,7 +169,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);
   }
 }
 
@@ -257,15 +257,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
@@ -569,9 +575,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;
@@ -605,6 +613,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)
@@ -665,7 +674,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
@@ -684,7 +693,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();
@@ -919,7 +929,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
@@ -944,15 +954,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);
     }
   }
   /**
@@ -1037,7 +1093,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 =====
@@ -1313,7 +1369,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 =====
   /**
@@ -1457,7 +1513,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 =====
   /**
@@ -1620,7 +1676,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 =====
   /**
@@ -1816,7 +1872,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 =====
@@ -2047,9 +2103,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;
   /**
@@ -2080,19 +2136,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,
    * });
@@ -2100,6 +2156,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,
@@ -2162,6 +2231,6 @@ var AISaaSClient = class {
   }
 };
 
-export { AISaaSClient, AISaaSError, AuthenticationError, AuthorizationError, ConflictError, NetworkError, NotFoundError, RateLimitError, ServerError, TimeoutError, ValidationError };
+export { CadraClient as AISaaSClient, CadraError as AISaaSError, AuthenticationError, AuthorizationError, CadraClient, CadraError, ConflictError, NetworkError, NotFoundError, RateLimitError, ServerError, TimeoutError, ValidationError };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map