@realtimex/sdk 1.7.28 → 2.0.2

package/dist/chunk-DZUAP6FW.mjs

@@ -0,0 +1,598 @@
+// src/v1/errors.ts
+var DeveloperApiError = class extends Error {
+  constructor(status, code, message) {
+    super(message);
+    this.status = status;
+    this.code = code;
+    this.name = "DeveloperApiError";
+  }
+};
+var AuthenticationError = class extends DeveloperApiError {
+  constructor(message = "Invalid or missing API key") {
+    super(403, "AUTHENTICATION_ERROR", message);
+    this.name = "AuthenticationError";
+  }
+};
+var NotFoundError = class extends DeveloperApiError {
+  constructor(message = "Resource not found") {
+    super(404, "NOT_FOUND", message);
+    this.name = "NotFoundError";
+  }
+};
+var ValidationError = class extends DeveloperApiError {
+  constructor(message) {
+    super(400, "VALIDATION_ERROR", message);
+    this.name = "ValidationError";
+  }
+};
+var ServerError = class extends DeveloperApiError {
+  constructor(message = "Internal server error") {
+    super(500, "SERVER_ERROR", message);
+    this.name = "ServerError";
+  }
+};
+
+// src/v1/client.ts
+var DeveloperApiClient = class {
+  constructor(baseUrl, apiKey, appId) {
+    this.baseUrl = baseUrl.replace(/\/$/, "");
+    this.apiKey = apiKey;
+    this.appId = appId;
+  }
+  getHeaders(extra) {
+    const headers = {
+      "Content-Type": "application/json",
+      "Authorization": `Bearer ${this.apiKey}`
+    };
+    if (this.appId) headers["x-app-id"] = this.appId;
+    return { ...headers, ...extra };
+  }
+  async handleResponse(response) {
+    let data;
+    try {
+      data = await response.json();
+    } catch {
+      data = {};
+    }
+    if (response.ok) return data;
+    const message = data?.message || data?.error || response.statusText || "Request failed";
+    switch (response.status) {
+      case 400:
+        throw new ValidationError(message);
+      case 401:
+      case 403:
+        throw new AuthenticationError(message);
+      case 404:
+        throw new NotFoundError(message);
+      case 500:
+      case 502:
+      case 503:
+        throw new ServerError(message);
+      default:
+        throw new DeveloperApiError(response.status, "API_ERROR", message);
+    }
+  }
+  /**
+   * Make a JSON request to the v1 API.
+   */
+  async request(method, path, body) {
+    const url = `${this.baseUrl}/api${path}`;
+    const response = await fetch(url, {
+      method,
+      headers: this.getHeaders(),
+      body: body !== void 0 ? JSON.stringify(body) : void 0
+    });
+    return this.handleResponse(response);
+  }
+  /**
+   * Make a multipart/form-data request (e.g. file uploads).
+   * Do NOT set Content-Type — browser/fetch will set it with the boundary.
+   */
+  async requestMultipart(method, path, form) {
+    const url = `${this.baseUrl}/api${path}`;
+    const authHeaders = { "Authorization": `Bearer ${this.apiKey}` };
+    if (this.appId) authHeaders["x-app-id"] = this.appId;
+    const response = await fetch(url, {
+      method,
+      headers: authHeaders,
+      body: form
+    });
+    return this.handleResponse(response);
+  }
+  /**
+   * Make a raw request and return the Response object directly.
+   * Used for streaming (SSE) endpoints.
+   */
+  async requestRaw(method, path, body) {
+    const url = `${this.baseUrl}/api${path}`;
+    return fetch(url, {
+      method,
+      headers: this.getHeaders(),
+      body: body !== void 0 ? JSON.stringify(body) : void 0
+    });
+  }
+};
+
+// src/v1/modules/v1Chat.ts
+var V1ChatModule = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * Stream a chat response for a workspace default thread.
+   * @see POST /v1/workspace/{slug}/stream-chat
+   */
+  // @streaming-stub — implement SSE parsing in overrides/v1ChatStreaming.ts
+  async streamWorkspaceChat(slug, body) {
+    return this.client.requestRaw("POST", `/v1/workspace/${slug}/stream-chat`, body);
+  }
+  /**
+   * Stream a chat response for a workspace thread.
+   * @see POST /v1/workspace/{slug}/thread/{threadSlug}/stream-chat
+   */
+  // @streaming-stub — implement SSE parsing in overrides/v1ChatStreaming.ts
+  async streamThreadChat(slug, threadSlug, body) {
+    return this.client.requestRaw("POST", `/v1/workspace/${slug}/thread/${threadSlug}/stream-chat`, body);
+  }
+};
+
+// src/v1/modules/v1Workspace.ts
+var V1WorkspaceModule = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * List workspaces using the app workspace list behavior.
+   * @see GET /v1/workspaces
+   */
+  async listWorkspaces() {
+    return this.client.request("GET", `/v1/workspaces`);
+  }
+  /**
+   * Create a workspace using the app workspace creation behavior.
+   * @see POST /v1/workspace/new
+   */
+  async createWorkspace(body) {
+    return this.client.request("POST", `/v1/workspace/new`, body);
+  }
+  /**
+   * Search workspaces and threads.
+   * @see POST /v1/workspace/search
+   */
+  async searchWorkspaces(body) {
+    return this.client.request("POST", `/v1/workspace/search`, body);
+  }
+  /**
+   * Get a workspace by slug.
+   * @see GET /v1/workspace/{slug}
+   */
+  async getWorkspace(slug) {
+    return this.client.request("GET", `/v1/workspace/${slug}`);
+  }
+  /**
+   * Delete a workspace.
+   * @see DELETE /v1/workspace/{slug}
+   */
+  async deleteWorkspace(slug) {
+    return this.client.request("DELETE", `/v1/workspace/${slug}`);
+  }
+  /**
+   * Get document content for a workspace document.
+   * @see GET /v1/workspace/{slug}/document/{docPath}
+   */
+  async getWorkspaceDocument(slug, docPath) {
+    return this.client.request("GET", `/v1/workspace/${slug}/document/${docPath}`);
+  }
+  /**
+   * Get or create workspace config.
+   * @see GET /v1/workspace/{slug}/config
+   */
+  async getWorkspaceConfig(slug) {
+    return this.client.request("GET", `/v1/workspace/${slug}/config`);
+  }
+  /**
+   * Update workspace config.
+   * @see POST /v1/workspace/{slug}/config
+   */
+  async updateWorkspaceConfig(slug, body) {
+    return this.client.request("POST", `/v1/workspace/${slug}/config`, body);
+  }
+  /**
+   * Update workspace settings by slug.
+   * @see POST /v1/workspace/{slug}/update
+   */
+  async updateWorkspace(slug, body) {
+    return this.client.request("POST", `/v1/workspace/${slug}/update`, body);
+  }
+  /**
+   * Generate a local LLM tuning suggestion.
+   * @see POST /v1/workspace/{slug}/local-llm-tuning-suggestion
+   */
+  async suggestWorkspaceLocalLlmTuning(slug, body) {
+    return this.client.request("POST", `/v1/workspace/${slug}/local-llm-tuning-suggestion`, body);
+  }
+  /**
+   * Upload a document to workspace documents.
+   * @see POST /v1/workspace/{slug}/upload
+   */
+  // @upload-stub — multipart upload; wire form manually or use helper
+  async uploadWorkspaceDocument(slug, form) {
+    return this.client.requestMultipart("POST", `/v1/workspace/${slug}/upload`, form);
+  }
+  /**
+   * Upload a link to workspace documents.
+   * @see POST /v1/workspace/{slug}/upload-link
+   */
+  async uploadWorkspaceLink(slug, body) {
+    return this.client.request("POST", `/v1/workspace/${slug}/upload-link`, body);
+  }
+  /**
+   * Update workspace document embeddings.
+   * @see POST /v1/workspace/{slug}/update-embeddings
+   */
+  async updateWorkspaceEmbeddings(slug, body) {
+    return this.client.request("POST", `/v1/workspace/${slug}/update-embeddings`, body);
+  }
+  /**
+   * Reset workspace vector database records.
+   * @see DELETE /v1/workspace/{slug}/reset-vector-db
+   */
+  async resetWorkspaceVectorDb(slug) {
+    return this.client.request("DELETE", `/v1/workspace/${slug}/reset-vector-db`);
+  }
+  /**
+   * Get workspace LLM provider metadata.
+   * @see GET /v1/workspace/{slug}/llm-provider
+   */
+  async getWorkspaceLlmProvider(slug) {
+    return this.client.request("GET", `/v1/workspace/${slug}/llm-provider`);
+  }
+  /**
+   * Get workspace vision availability.
+   * @see GET /v1/workspace/{slug}/vision-availability
+   */
+  async getWorkspaceVisionAvailability(slug) {
+    return this.client.request("GET", `/v1/workspace/${slug}/vision-availability`);
+  }
+  /**
+   * Get workspace chats.
+   * @see GET /v1/workspace/{slug}/chats
+   */
+  async getWorkspaceChats(slug) {
+    return this.client.request("GET", `/v1/workspace/${slug}/chats`);
+  }
+  /**
+   * Get workspace terminal session details.
+   * @see GET /v1/workspace/{slug}/terminal-session-details
+   */
+  async getWorkspaceTerminalSessionDetails(slug) {
+    return this.client.request("GET", `/v1/workspace/${slug}/terminal-session-details`);
+  }
+  /**
+   * Persist terminal UI events.
+   * @see POST /v1/workspace/{slug}/terminal-ui-events
+   */
+  async persistWorkspaceTerminalUiEvents(slug, body) {
+    return this.client.request("POST", `/v1/workspace/${slug}/terminal-ui-events`, body);
+  }
+  /**
+   * Persist a linked terminal message.
+   * @see POST /v1/workspace/{slug}/linked-terminal-message
+   */
+  async createWorkspaceLinkedTerminalMessage(slug, body) {
+    return this.client.request("POST", `/v1/workspace/${slug}/linked-terminal-message`, body);
+  }
+  /**
+   * Delete selected workspace chats.
+   * @see DELETE /v1/workspace/{slug}/delete-chats
+   */
+  async deleteWorkspaceChats(slug, body) {
+    return this.client.request("DELETE", `/v1/workspace/${slug}/delete-chats`, body);
+  }
+  /**
+   * Delete edited workspace chats from a starting id.
+   * @see DELETE /v1/workspace/{slug}/delete-edited-chats
+   */
+  async deleteEditedWorkspaceChats(slug, body) {
+    return this.client.request("DELETE", `/v1/workspace/${slug}/delete-edited-chats`, body);
+  }
+  /**
+   * Update a workspace chat response.
+   * @see POST /v1/workspace/{slug}/update-chat
+   */
+  async updateWorkspaceChat(slug, body) {
+    return this.client.request("POST", `/v1/workspace/${slug}/update-chat`, body);
+  }
+  /**
+   * Update workspace chat feedback.
+   * @see POST /v1/workspace/{slug}/chat-feedback/{chatId}
+   */
+  async updateWorkspaceChatFeedback(slug, chatId, body) {
+    return this.client.request("POST", `/v1/workspace/${slug}/chat-feedback/${chatId}`, body);
+  }
+  /**
+   * Get suggested messages for a workspace.
+   * @see GET /v1/workspace/{slug}/suggested-messages
+   */
+  async getWorkspaceSuggestedMessages(slug) {
+    return this.client.request("GET", `/v1/workspace/${slug}/suggested-messages`);
+  }
+  /**
+   * Save suggested messages for a workspace.
+   * @see POST /v1/workspace/{slug}/suggested-messages
+   */
+  async saveWorkspaceSuggestedMessages(slug, body) {
+    return this.client.request("POST", `/v1/workspace/${slug}/suggested-messages`, body);
+  }
+  /**
+   * Update workspace document pin status.
+   * @see POST /v1/workspace/{slug}/update-pin
+   */
+  async updateWorkspaceDocumentPin(slug, body) {
+    return this.client.request("POST", `/v1/workspace/${slug}/update-pin`, body);
+  }
+  /**
+   * Generate text-to-speech audio for a workspace chat.
+   * @see GET /v1/workspace/{slug}/tts/{chatId}
+   */
+  async getWorkspaceChatTts(slug, chatId) {
+    return this.client.request("GET", `/v1/workspace/${slug}/tts/${chatId}`);
+  }
+  /**
+   * Get a workspace profile picture.
+   * @see GET /v1/workspace/{slug}/pfp
+   */
+  async getWorkspaceProfilePicture(slug) {
+    return this.client.request("GET", `/v1/workspace/${slug}/pfp`);
+  }
+  /**
+   * Upload a workspace profile picture.
+   * @see POST /v1/workspace/{slug}/upload-pfp
+   */
+  // @upload-stub — multipart upload; wire form manually or use helper
+  async uploadWorkspaceProfilePicture(slug, form) {
+    return this.client.requestMultipart("POST", `/v1/workspace/${slug}/upload-pfp`, form);
+  }
+  /**
+   * Remove a workspace profile picture.
+   * @see DELETE /v1/workspace/{slug}/remove-pfp
+   */
+  async removeWorkspaceProfilePicture(slug) {
+    return this.client.request("DELETE", `/v1/workspace/${slug}/remove-pfp`);
+  }
+  /**
+   * Fork the workspace default thread.
+   * @see POST /v1/workspace/{slug}/thread/fork
+   */
+  async forkThread(slug, body) {
+    return this.client.request("POST", `/v1/workspace/${slug}/thread/fork`, body);
+  }
+  /**
+   * Hide a workspace chat.
+   * @see PUT /v1/workspace/workspace-chats/{id}
+   */
+  async hideWorkspaceChat(id) {
+    return this.client.request("PUT", `/v1/workspace/workspace-chats/${id}`);
+  }
+  /**
+   * Upload and embed a document.
+   * @see POST /v1/workspace/{slug}/upload-and-embed
+   */
+  // @upload-stub — multipart upload; wire form manually or use helper
+  async uploadAndEmbedWorkspaceDocument(slug, form) {
+    return this.client.requestMultipart("POST", `/v1/workspace/${slug}/upload-and-embed`, form);
+  }
+  /**
+   * Remove and unembed a document.
+   * @see DELETE /v1/workspace/{slug}/remove-and-unembed
+   */
+  async removeAndUnembedWorkspaceDocument(slug, body) {
+    return this.client.request("DELETE", `/v1/workspace/${slug}/remove-and-unembed`, body);
+  }
+  /**
+   * Get workspace prompt history.
+   * @see GET /v1/workspace/{slug}/prompt-history
+   */
+  async getWorkspacePromptHistory(slug) {
+    return this.client.request("GET", `/v1/workspace/${slug}/prompt-history`);
+  }
+  /**
+   * Clear workspace prompt history.
+   * @see DELETE /v1/workspace/{slug}/prompt-history
+   */
+  async deleteWorkspacePromptHistory(slug) {
+    return this.client.request("DELETE", `/v1/workspace/${slug}/prompt-history`);
+  }
+  /**
+   * Delete a workspace prompt history entry.
+   * @see DELETE /v1/workspace/{slug}/prompt-history/{id}
+   */
+  async deleteWorkspacePromptHistoryEntry(slug, id) {
+    return this.client.request("DELETE", `/v1/workspace/${slug}/prompt-history/${id}`);
+  }
+  /**
+   * Validate search provider configuration.
+   * @see POST /v1/workspace/{slug}/search/validate
+   */
+  async validateWorkspaceSearchProvider(slug, body) {
+    return this.client.request("POST", `/v1/workspace/${slug}/search/validate`, body);
+  }
+};
+
+// src/v1/modules/v1Thread.ts
+var V1ThreadModule = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * Create a workspace thread.
+   * @see POST /v1/workspace/{slug}/thread/new
+   */
+  async createThread(slug) {
+    return this.client.request("POST", `/v1/workspace/${slug}/thread/new`);
+  }
+  /**
+   * List workspace threads.
+   * @see GET /v1/workspace/{slug}/threads
+   */
+  async listThreads(slug) {
+    return this.client.request("GET", `/v1/workspace/${slug}/threads`);
+  }
+  /**
+   * Open an SSE stream for workspace thread events.
+   * @see GET /v1/workspace/{slug}/thread-events
+   */
+  async openThreadEventsStream(slug) {
+    return this.client.request("GET", `/v1/workspace/${slug}/thread-events`);
+  }
+  /**
+   * Get a workspace thread.
+   * @see GET /v1/workspace/{slug}/thread/{threadSlug}
+   */
+  async getThread(slug, threadSlug) {
+    return this.client.request("GET", `/v1/workspace/${slug}/thread/${threadSlug}`);
+  }
+  /**
+   * Delete a workspace thread.
+   * @see DELETE /v1/workspace/{slug}/thread/{threadSlug}
+   */
+  async deleteThread(slug, threadSlug) {
+    return this.client.request("DELETE", `/v1/workspace/${slug}/thread/${threadSlug}`);
+  }
+  /**
+   * Get thread vision availability.
+   * @see GET /v1/workspace/{slug}/thread/{threadSlug}/vision-availability
+   */
+  async getThreadVisionAvailability(slug, threadSlug) {
+    return this.client.request("GET", `/v1/workspace/${slug}/thread/${threadSlug}/vision-availability`);
+  }
+  /**
+   * Promote a thread into a tracked goal.
+   * @see POST /v1/workspace/{slug}/thread/{threadSlug}/goal
+   */
+  async createThreadGoal(slug, threadSlug, body) {
+    return this.client.request("POST", `/v1/workspace/${slug}/thread/${threadSlug}/goal`, body);
+  }
+  /**
+   * Draft a terminal goal for a workspace.
+   * @see POST /v1/workspace/{slug}/terminal-goal-draft
+   */
+  async draftWorkspaceTerminalGoal(slug, body) {
+    return this.client.request("POST", `/v1/workspace/${slug}/terminal-goal-draft`, body);
+  }
+  /**
+   * Create a terminal goal for a workspace.
+   * @see POST /v1/workspace/{slug}/terminal-goal
+   */
+  async createWorkspaceTerminalGoal(slug, body) {
+    return this.client.request("POST", `/v1/workspace/${slug}/terminal-goal`, body);
+  }
+  /**
+   * Draft a terminal goal for a workspace thread.
+   * @see POST /v1/workspace/{slug}/thread/{threadSlug}/terminal-goal-draft
+   */
+  async draftThreadTerminalGoal(slug, threadSlug, body) {
+    return this.client.request("POST", `/v1/workspace/${slug}/thread/${threadSlug}/terminal-goal-draft`, body);
+  }
+  /**
+   * Create a terminal goal for a workspace thread.
+   * @see POST /v1/workspace/{slug}/thread/{threadSlug}/terminal-goal
+   */
+  async createThreadTerminalGoal(slug, threadSlug, body) {
+    return this.client.request("POST", `/v1/workspace/${slug}/thread/${threadSlug}/terminal-goal`, body);
+  }
+  /**
+   * Bulk delete workspace threads.
+   * @see DELETE /v1/workspace/{slug}/thread-bulk-delete
+   */
+  async bulkDeleteThreads(slug, body) {
+    return this.client.request("DELETE", `/v1/workspace/${slug}/thread-bulk-delete`, body);
+  }
+  /**
+   * Get workspace thread chats.
+   * @see GET /v1/workspace/{slug}/thread/{threadSlug}/chats
+   */
+  async getThreadChats(slug, threadSlug) {
+    return this.client.request("GET", `/v1/workspace/${slug}/thread/${threadSlug}/chats`);
+  }
+  /**
+   * Get thread terminal session details.
+   * @see GET /v1/workspace/{slug}/thread/{threadSlug}/terminal-session-details
+   */
+  async getThreadTerminalSessionDetails(slug, threadSlug) {
+    return this.client.request("GET", `/v1/workspace/${slug}/thread/${threadSlug}/terminal-session-details`);
+  }
+  /**
+   * Update a workspace thread.
+   * @see POST /v1/workspace/{slug}/thread/{threadSlug}/update
+   */
+  async updateThread(slug, threadSlug, body) {
+    return this.client.request("POST", `/v1/workspace/${slug}/thread/${threadSlug}/update`, body);
+  }
+  /**
+   * Delete edited chats from a thread.
+   * @see DELETE /v1/workspace/{slug}/thread/{threadSlug}/delete-edited-chats
+   */
+  async deleteEditedThreadChats(slug, threadSlug, body) {
+    return this.client.request("DELETE", `/v1/workspace/${slug}/thread/${threadSlug}/delete-edited-chats`, body);
+  }
+  /**
+   * Update a thread chat response.
+   * @see POST /v1/workspace/{slug}/thread/{threadSlug}/update-chat
+   */
+  async updateThreadChat(slug, threadSlug, body) {
+    return this.client.request("POST", `/v1/workspace/${slug}/thread/${threadSlug}/update-chat`, body);
+  }
+  /**
+   * Persist terminal UI events for a workspace thread.
+   * @see POST /v1/workspace/{slug}/thread/{threadSlug}/terminal-ui-events
+   */
+  async persistThreadTerminalUiEvents(slug, threadSlug, body) {
+    return this.client.request("POST", `/v1/workspace/${slug}/thread/${threadSlug}/terminal-ui-events`, body);
+  }
+  /**
+   * Persist a linked terminal message for a workspace thread.
+   * @see POST /v1/workspace/{slug}/thread/{threadSlug}/linked-terminal-message
+   */
+  async createThreadLinkedTerminalMessage(slug, threadSlug, body) {
+    return this.client.request("POST", `/v1/workspace/${slug}/thread/${threadSlug}/linked-terminal-message`, body);
+  }
+  /**
+   * Coordinate a task into a workspace thread.
+   * @see POST /v1/workspace/{slug}/thread/coordinate-task
+   */
+  async coordinateThreadTask(slug, body) {
+    return this.client.request("POST", `/v1/workspace/${slug}/thread/coordinate-task`, body);
+  }
+  /**
+   * Open an SSE stream for external workspace thread chat events.
+   * @see GET /v1/workspace/{slug}/thread/{threadSlug}/chat-stream
+   */
+  async openThreadChatStream(slug, threadSlug) {
+    return this.client.request("GET", `/v1/workspace/${slug}/thread/${threadSlug}/chat-stream`);
+  }
+};
+
+// src/v1/namespace.ts
+var V1ApiNamespace = class {
+  // [GENERATED-PROPS-END]
+  constructor(baseUrl, apiKey, appId) {
+    this._client = new DeveloperApiClient(baseUrl, apiKey, appId);
+    this.chat = new V1ChatModule(this._client);
+    this.workspace = new V1WorkspaceModule(this._client);
+    this.thread = new V1ThreadModule(this._client);
+  }
+};
+
+export {
+  DeveloperApiError,
+  AuthenticationError,
+  NotFoundError,
+  ValidationError,
+  ServerError,
+  DeveloperApiClient,
+  V1ChatModule,
+  V1WorkspaceModule,
+  V1ThreadModule,
+  V1ApiNamespace
+};