@specstream/openclaw-plugin 0.1.0 → 0.1.2

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.2",
   "configSchema": {
     "type": "object",
     "properties": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@specstream/openclaw-plugin",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "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",

package/skills/specstream-continue-work/SKILL.md

@@ -12,7 +12,7 @@ Read `list_find_rows` and follow each `next_cursor` through the `cursor` argumen
 
 When the person asks, `send_to_destination` sends selected results to Google Sheets, Excel, Notion, Airtable, HubSpot, Salesforce or an Outlook draft. An Outlook draft lands in the person's own Drafts folder and is never sent. `export_find` makes a download link as CSV, Excel, JSON or HTML. Reading, exporting and sharing cost nothing.
 
-Finding more, adding facts or rechecking is new work with its own reviewed price. Rechecks cost half.
+Finding more, adding facts or rechecking is new work with its own reviewed price. A recheck costs half the rate for a row that changed and 1 cent for a row that did not.
 
 `create_capacity_schedule` sets up a monitor and is a write. It needs a scope, a cadence, a validity period and limits per run and per period. A monitor reruns on its schedule and labels each change: still matches, no longer matches, unresolved or unavailable. Creating one does not fund it. A blocked or missed run is not an unchanged result and is not bought later. Pause or revoke a monitor when the owner says so.
 

package/skills/specstream-review-work/SKILL.md

@@ -10,6 +10,6 @@ SpecStream is the live web data engine for teams and agents. Use the configured
 
 Call `quote_capacity_work` with the `ast_hash` from `compile`, the operation, the number of results wanted, the useful minimum, and the original `parent_find_id`, `project_id` or `revision_id` when one applies. Asking for more uses `extend`, adding facts uses `add_facts` and rechecking uses `refresh`.
 
-Say the scope, the conditions, the maximum price and the expiry in text. Results cost 10 cents, 30 cents or $1 each, plus 10 cents for a person's email and 25 cents for a phone, and nothing when nothing matches. A price lasts 30 minutes. The price does not spend any balance and does not start a job.
+Say the scope, the conditions, the maximum price and the expiry in text. Results cost 5 cents, 15 cents or $1 each, plus 5 cents for a person's email and 15 cents for a phone, and nothing when nothing matches. A price lasts 30 minutes. The price does not spend any balance and does not start a job.
 
 Use `get_capacity_balance` to read the balance. A balance is not permission to spend. Do not copy the maximum into an approval unless the person said to, or an existing bounded task already allows it. Plans and top-ups live in the person's account, not in chat.