@specstream/openclaw-plugin 0.1.0 → 0.1.1

package/README.md

@@ -1,6 +1,6 @@
 # @specstream/openclaw-plugin
 
-Ask your OpenClaw agent for a list and get the whole list back. "Dental clinics in Lisbon with online booking, with their website and phone." Every row comes from the live web with the page it was read from, so you can open it and look. You pay per match, and a search that finds nothing costs nothing.
+Ask your OpenClaw agent for a list and get the whole list back. "Dental clinics in Lisbon with online booking, with their website and phone." Every row comes from the live web with the page it was read from, so you can open it and look. You pay for each result delivered, and a search that finds nothing costs nothing.
 
 [SpecStream](https://specstream.ai) is the live web data engine for teams and agents. This plugin gives OpenClaw two tools for it and, if you want the full conversation with SpecStream, four skills.
 

package/dist/client.js

@@ -1,6 +1,6 @@
 /** The SpecStream REST calls the tools share: read a request, price it, start it within a maximum, read its rows. */
 export const BASE_URL = "https://api.specstream.ai";
-export const USER_AGENT = "@specstream/openclaw-plugin/0.1.0";
+export const USER_AGENT = "@specstream/openclaw-plugin/0.1.1";
 /** A list runs for up to about five minutes, so the default wait is just under that. */
 export const DEFAULT_WAIT_SECONDS = 300;
 export const DEFAULT_POLL_INTERVAL_SECONDS = 3;
@@ -25,16 +25,29 @@ function dollars(cents) {
 export function listLink(findId) {
     return `https://specstream.ai/workspace/collections/${encodeURIComponent(findId)}`;
 }
-/** Flattens one record into a row: each column label maps to what the list shows, plus where the row was read. */
-export function flattenRow(findId, record) {
+/** Each value's page in the API's flat row: <field>_source beside the <field> it belongs to. */
+function sourcesOf(flat) {
+    const sources = {};
+    for (const [key, value] of Object.entries(flat ?? {})) {
+        if (key.endsWith("_source") && Object.prototype.hasOwnProperty.call(flat, key.slice(0, -7)))
+            sources[key] = value;
+    }
+    return sources;
+}
+/**
+ * One row as flat fields: each column's label holds what the list shows. The page of each value (<field>_source)
+ * and of the fact that put the row in the list (source_url, checked_at) come from the API's flat row, so every
+ * tool shows the same pages.
+ */
+export function flattenRow(findId, record, flat) {
     const row = { list_id: findId, position: record.ordinal ?? null };
-    let source = null;
+    const sources = sourcesOf(flat);
     const cells = record.details?.length ? record.details : (record.cells ?? []);
     for (const cell of cells) {
         let label = String(cell.label || cell.column_id || "").trim();
         if (!label)
             continue;
-        if (RESERVED.has(label))
+        if (RESERVED.has(label) || label in sources)
             label = `${label} (column)`;
         if (cell.absence)
             row[label] = "";
@@ -42,12 +55,10 @@ export function flattenRow(findId, record) {
             row[label] = cell.display;
         else
             row[label] = cell.value ?? "";
-        const provenance = cell.provenance || {};
-        if (source === null && String(provenance.source_url || "").startsWith("http"))
-            source = provenance;
     }
-    row.source_url = source ? (source.source_url ?? "") : "";
-    row.checked_at = source ? (source.observed_at ?? "") : "";
+    Object.assign(row, sources);
+    row.source_url = flat?.source_url ?? "";
+    row.checked_at = flat?.checked_at ?? "";
     row.list_link = listLink(findId);
     return row;
 }
@@ -144,8 +155,10 @@ export class SpecStreamClient {
             const query = new URLSearchParams({ limit: "100", ...(cursor ? { cursor } : {}) });
             const page = (await this.request("GET", `/v1/finds/${encodeURIComponent(findId)}/rows?${query}`, undefined, { abortSignal })) ?? {};
             state = typeof page.status === "string" && page.status ? page.status : state;
-            for (const record of Array.isArray(page.rows) ? page.rows : [])
-                rows.push(flattenRow(findId, record));
+            const flat = new Map((Array.isArray(page.flat_rows) ? page.flat_rows : []).map((item) => [String(item.id), item]));
+            for (const record of Array.isArray(page.rows) ? page.rows : []) {
+                rows.push(flattenRow(findId, record, flat.get(`${findId}:${String(record.entity_id)}`)));
+            }
             const next = typeof page.next_cursor === "string" && page.next_cursor ? page.next_cursor : null;
             if (!next || next === cursor)
                 break;

package/openclaw.plugin.json

@@ -5,7 +5,7 @@
   "categories": [
     "data-analytics"
   ],
-  "version": "0.1.0",
+  "version": "0.1.1",
   "configSchema": {
     "type": "object",
     "properties": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@specstream/openclaw-plugin",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "SpecStream plugin for OpenClaw: ask for any list in plain words and get every matching row from the live web, each with its source page, priced per match.",
   "type": "module",
   "files": [
@@ -24,7 +24,7 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/Specstreamai/specstream-tools.git",
+    "url": "git+https://github.com/specstream/specstream-tools.git",
     "directory": "integrations/openclaw"
   },
   "homepage": "https://specstream.ai/docs/mcp",