@llmsafespaces/sdk 0.22.0 → 0.23.0

package/dist/index.cjs

@@ -205,6 +205,52 @@ var LLMSafeSpaces = class {
     if (text === "") return void 0;
     return JSON.parse(text);
   }
+  /**
+   * Internal: like {@link request}, but also returns the response headers
+   * (e.g. pagination cursors). Body decoding follows the same contract.
+   */
+  async requestWithHeaders(method, path, body, timeout) {
+    const url = `${this.baseUrl}/api/v1${path}`;
+    const headers = { "Content-Type": "application/json" };
+    if (this.apiKey) {
+      headers["Authorization"] = `Bearer ${this.apiKey}`;
+    } else if (this.token) {
+      headers["Authorization"] = `Bearer ${this.token}`;
+    }
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeout ?? this.timeout);
+    let res;
+    try {
+      res = await this.fetchFn(url, {
+        method,
+        headers,
+        body: body ? JSON.stringify(body) : void 0,
+        signal: controller.signal
+      });
+    } catch (e) {
+      clearTimeout(timer);
+      if (e instanceof Error && e.name === "AbortError") {
+        throw new TimeoutError();
+      }
+      throw e;
+    }
+    clearTimeout(timer);
+    if (!res.ok) {
+      const errBody = await res.json().catch(() => ({ error: res.statusText }));
+      const msg = errBody.error ?? res.statusText;
+      if (res.status === 401 || res.status === 403) throw new AuthError(msg, res.status);
+      if (res.status === 404) throw new NotFoundError(msg);
+      throw new LLMSafeSpacesError(msg, res.status);
+    }
+    let data;
+    if (res.status === 204) {
+      data = void 0;
+    } else {
+      const text = await res.text();
+      data = text === "" ? void 0 : JSON.parse(text);
+    }
+    return { data, headers: res.headers };
+  }
   async login() {
     if (!this.credentials) throw new AuthError("No credentials configured");
     this.loggingIn = true;
@@ -327,6 +373,20 @@ var SessionsAPI = class {
   getHistory(workspaceId, sessionId) {
     return this.client.request("GET", `/workspaces/${workspaceId}/sessions/${sessionId}/message`);
   }
+  /**
+   * Returns one page of session history with cursor pagination.
+   * nextCursor is "" when the beginning of the session was reached
+   * (no X-Next-Cursor response header).
+   */
+  async getHistoryPage(workspaceId, sessionId, opts) {
+    const q = new URLSearchParams();
+    if (opts?.limit && opts.limit > 0) q.set("limit", String(opts.limit));
+    if (opts?.before) q.set("before", opts.before);
+    const qs = q.toString();
+    const path = `/workspaces/${workspaceId}/sessions/${sessionId}/message${qs ? `?${qs}` : ""}`;
+    const { data, headers } = await this.client.requestWithHeaders("GET", path);
+    return { messages: data ?? [], nextCursor: headers.get("X-Next-Cursor") ?? "" };
+  }
   abort(workspaceId, sessionId) {
     return this.client.request("POST", `/workspaces/${workspaceId}/sessions/${sessionId}/abort`);
   }

package/dist/index.d.cts

@@ -322,6 +322,14 @@ declare class LLMSafeSpaces {
     constructor(options: ClientOptions);
     /** Internal: make an authenticated request. */
     request<T>(method: string, path: string, body?: unknown, timeout?: number): Promise<T>;
+    /**
+     * Internal: like {@link request}, but also returns the response headers
+     * (e.g. pagination cursors). Body decoding follows the same contract.
+     */
+    requestWithHeaders<T>(method: string, path: string, body?: unknown, timeout?: number): Promise<{
+        data: T;
+        headers: Headers;
+    }>;
     private login;
 }
 declare class WorkspacesAPI {
@@ -378,6 +386,18 @@ declare class SessionsAPI {
     sendMessage(workspaceId: string, sessionId: string, content: string): Promise<Message>;
     /** Returns the session transcript in contract shape. */
     getHistory(workspaceId: string, sessionId: string): Promise<Message[]>;
+    /**
+     * Returns one page of session history with cursor pagination.
+     * nextCursor is "" when the beginning of the session was reached
+     * (no X-Next-Cursor response header).
+     */
+    getHistoryPage(workspaceId: string, sessionId: string, opts?: {
+        limit?: number;
+        before?: string;
+    }): Promise<{
+        messages: Message[];
+        nextCursor: string;
+    }>;
     abort(workspaceId: string, sessionId: string): Promise<void>;
     get(workspaceId: string, sessionId: string): Promise<Record<string, unknown>>;
     sendPromptAsync(workspaceId: string, sessionId: string, message: string): Promise<void>;

package/dist/index.d.ts

@@ -322,6 +322,14 @@ declare class LLMSafeSpaces {
     constructor(options: ClientOptions);
     /** Internal: make an authenticated request. */
     request<T>(method: string, path: string, body?: unknown, timeout?: number): Promise<T>;
+    /**
+     * Internal: like {@link request}, but also returns the response headers
+     * (e.g. pagination cursors). Body decoding follows the same contract.
+     */
+    requestWithHeaders<T>(method: string, path: string, body?: unknown, timeout?: number): Promise<{
+        data: T;
+        headers: Headers;
+    }>;
     private login;
 }
 declare class WorkspacesAPI {
@@ -378,6 +386,18 @@ declare class SessionsAPI {
     sendMessage(workspaceId: string, sessionId: string, content: string): Promise<Message>;
     /** Returns the session transcript in contract shape. */
     getHistory(workspaceId: string, sessionId: string): Promise<Message[]>;
+    /**
+     * Returns one page of session history with cursor pagination.
+     * nextCursor is "" when the beginning of the session was reached
+     * (no X-Next-Cursor response header).
+     */
+    getHistoryPage(workspaceId: string, sessionId: string, opts?: {
+        limit?: number;
+        before?: string;
+    }): Promise<{
+        messages: Message[];
+        nextCursor: string;
+    }>;
     abort(workspaceId: string, sessionId: string): Promise<void>;
     get(workspaceId: string, sessionId: string): Promise<Record<string, unknown>>;
     sendPromptAsync(workspaceId: string, sessionId: string, message: string): Promise<void>;

package/dist/index.js

@@ -171,6 +171,52 @@ var LLMSafeSpaces = class {
     if (text === "") return void 0;
     return JSON.parse(text);
   }
+  /**
+   * Internal: like {@link request}, but also returns the response headers
+   * (e.g. pagination cursors). Body decoding follows the same contract.
+   */
+  async requestWithHeaders(method, path, body, timeout) {
+    const url = `${this.baseUrl}/api/v1${path}`;
+    const headers = { "Content-Type": "application/json" };
+    if (this.apiKey) {
+      headers["Authorization"] = `Bearer ${this.apiKey}`;
+    } else if (this.token) {
+      headers["Authorization"] = `Bearer ${this.token}`;
+    }
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeout ?? this.timeout);
+    let res;
+    try {
+      res = await this.fetchFn(url, {
+        method,
+        headers,
+        body: body ? JSON.stringify(body) : void 0,
+        signal: controller.signal
+      });
+    } catch (e) {
+      clearTimeout(timer);
+      if (e instanceof Error && e.name === "AbortError") {
+        throw new TimeoutError();
+      }
+      throw e;
+    }
+    clearTimeout(timer);
+    if (!res.ok) {
+      const errBody = await res.json().catch(() => ({ error: res.statusText }));
+      const msg = errBody.error ?? res.statusText;
+      if (res.status === 401 || res.status === 403) throw new AuthError(msg, res.status);
+      if (res.status === 404) throw new NotFoundError(msg);
+      throw new LLMSafeSpacesError(msg, res.status);
+    }
+    let data;
+    if (res.status === 204) {
+      data = void 0;
+    } else {
+      const text = await res.text();
+      data = text === "" ? void 0 : JSON.parse(text);
+    }
+    return { data, headers: res.headers };
+  }
   async login() {
     if (!this.credentials) throw new AuthError("No credentials configured");
     this.loggingIn = true;
@@ -293,6 +339,20 @@ var SessionsAPI = class {
   getHistory(workspaceId, sessionId) {
     return this.client.request("GET", `/workspaces/${workspaceId}/sessions/${sessionId}/message`);
   }
+  /**
+   * Returns one page of session history with cursor pagination.
+   * nextCursor is "" when the beginning of the session was reached
+   * (no X-Next-Cursor response header).
+   */
+  async getHistoryPage(workspaceId, sessionId, opts) {
+    const q = new URLSearchParams();
+    if (opts?.limit && opts.limit > 0) q.set("limit", String(opts.limit));
+    if (opts?.before) q.set("before", opts.before);
+    const qs = q.toString();
+    const path = `/workspaces/${workspaceId}/sessions/${sessionId}/message${qs ? `?${qs}` : ""}`;
+    const { data, headers } = await this.client.requestWithHeaders("GET", path);
+    return { messages: data ?? [], nextCursor: headers.get("X-Next-Cursor") ?? "" };
+  }
   abort(workspaceId, sessionId) {
     return this.client.request("POST", `/workspaces/${workspaceId}/sessions/${sessionId}/abort`);
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@llmsafespaces/sdk",
-  "version": "0.22.0",
+  "version": "0.23.0",
   "description": "TypeScript SDK for LLMSafeSpaces API",
   "type": "module",
   "main": "./dist/index.cjs",