@openagents-org/agent-launcher 0.2.151 → 0.2.152

package/src/workspace-client.js

@@ -192,26 +192,29 @@ class WorkspaceClient {
   }
 
   /**
-   * Fetch the most recent N messages in a channel, returned oldest-to-newest.
-   * Used by adapters to rebuild context for a fresh Claude Code session
-   * when --resume of the previous session fails (the channel's chat history
-   * is the only thing that survives a session-storage rotation).
+   * Fetch N messages in a channel, returned oldest-to-newest. `sort` picks
+   * which end of the channel the window comes from: 'desc' (default) takes
+   * the most recent N, 'asc' takes the channel's opening N. Used by adapters
+   * to rebuild context for a fresh Claude Code session when --resume of the
+   * previous session fails (the channel's chat history is the only thing
+   * that survives a session-storage rotation).
    */
-  async getRecentMessages(workspaceId, channelName, token, limit = 30) {
+  async getRecentMessages(workspaceId, channelName, token, limit = 30, { sort = 'desc' } = {}) {
     try {
       const params = new URLSearchParams({
         network: workspaceId,
         channel: channelName,
         type: 'workspace.message',
-        sort: 'desc',
+        sort,
         limit: String(limit),
       });
       const data = await this._get(`/v1/events?${params}`, this._wsHeaders(token));
       const result = data.data || data;
       const events = (result && result.events) || [];
-      // Server returned newest-first; reverse so the caller can present them
-      // in chronological order without further fiddling.
-      return events.slice().reverse().map((e) => this._eventToMessage(e));
+      // A desc window arrives newest-first; reverse so the caller always gets
+      // chronological order. An asc window is already chronological.
+      const ordered = sort === 'asc' ? events.slice() : events.slice().reverse();
+      return ordered.map((e) => this._eventToMessage(e));
     } catch {
       return [];
     }
@@ -471,6 +474,31 @@ class WorkspaceClient {
     return data.data || data;
   }
 
+  /**
+   * Search the web for images via POST /v1/search/images.
+   */
+  async searchImages(workspaceId, token, query, { count = 10 } = {}) {
+    const body = { query, network: workspaceId, count };
+    const data = await this._post('/v1/search/images', body, this._wsHeaders(token), 30000);
+    return data.data || data;
+  }
+
+  /**
+   * Download a URL into workspace storage via POST /v1/files/from_url.
+   * With postToChannel, the file is also posted into the chat as an
+   * inline attachment.
+   */
+  async uploadFileFromUrl(workspaceId, token, url, {
+    filename, channelName, source = 'human:user', postToChannel = false, caption,
+  } = {}) {
+    const body = { url, network: workspaceId, source, post_to_channel: postToChannel };
+    if (filename) body.filename = filename;
+    if (channelName) body.channel_name = channelName;
+    if (caption) body.caption = caption;
+    const data = await this._post('/v1/files/from_url', body, this._wsHeaders(token), 90000);
+    return data.data || data;
+  }
+
   /**
    * List files via GET /v1/files.
    */
@@ -583,6 +611,19 @@ class WorkspaceClient {
     return data.data || data;
   }
 
+  /**
+   * Server-side fetch chain via POST /v1/fetch — reads a page WITHOUT
+   * holding a shared browser tab. Static HTTP first; JS-heavy pages are
+   * rendered in an ephemeral browser session that is closed immediately.
+   */
+  async fetchUrl(workspaceId, token, url, { mode = 'auto', maxChars, source } = {}) {
+    const body = { url, network: workspaceId, mode };
+    if (maxChars) body.max_chars = maxChars;
+    if (source) body.source = source;
+    const data = await this._post('/v1/fetch', body, this._wsHeaders(token), 90000);
+    return data.data || data;
+  }
+
   /**
    * List persistent browser contexts via GET /v1/browser/contexts.
    */
@@ -699,18 +740,18 @@ class WorkspaceClient {
 
   // ── Knowledge Base ──
 
-  async listKnowledge(workspaceId, token, { limit = 100 } = {}) {
+  async listKnowledge(workspaceId, token, { limit = 100, timeout } = {}) {
     const params = new URLSearchParams({
       network: workspaceId,
       limit: String(limit),
     });
-    const data = await this._get(`/v1/knowledge?${params}`, this._wsHeaders(token));
+    const data = await this._get(`/v1/knowledge?${params}`, this._wsHeaders(token), timeout);
     return data.data || data;
   }
 
-  async getKnowledge(workspaceId, token, entryId) {
+  async getKnowledge(workspaceId, token, entryId, { timeout } = {}) {
     const params = new URLSearchParams({ network: workspaceId });
-    const data = await this._get(`/v1/knowledge/${entryId}?${params}`, this._wsHeaders(token));
+    const data = await this._get(`/v1/knowledge/${entryId}?${params}`, this._wsHeaders(token), timeout);
     return data.data || data;
   }
 
@@ -878,7 +919,11 @@ class WorkspaceClient {
               if (typeof msg === 'string' && msg.toLowerCase().includes('session_revoked')) {
                 reject(new SessionRevokedError(msg));
               } else {
-                reject(new Error(msg));
+                const err = new Error(msg);
+                // Preserve structured error details (error_code, hint,
+                // quota occupancy, ...) so tool handlers can surface them.
+                if (parsed.data && typeof parsed.data === 'object') err.data = parsed.data;
+                reject(err);
               }
             } else {
               resolve(parsed);