@instafy/cli 0.4.0 → 0.5.0

package/README.md

@@ -59,6 +59,8 @@ Run Instafy spaces locally and connect them back to Instafy Studio — from any
 - `instafy web read <url…> --json` — read up to 6 public pages over plain HTTP and get their text, links and structured data with provenance, wrapped as untrusted page content. robots.txt (including AI-agent user agents), the web-research skill's `no-agents` link-only sites (built in, plus the space's additions) and translators', caches' and archives' copies of them, private-address checks at every redirect, stop rules and per-turn caps are enforced; a `no-reuse` site is read and marked `noReuse`; see [docs/CLI.md](https://github.com/instafy-dev/instafy/blob/main/docs/CLI.md#reading-web-pages-instafy-web-read).
 - `instafy web search "<query>" --json` — find links to read, in Octo's turns only, with the space's own search key (the web-research skill's providers: Brave, then Kagi). Results are untrusted leads: a link-only site's result keeps only its link and site name, keys go only to their provider's host, nothing is cached, and the room keeps only the query and the count; see [docs/CLI.md](https://github.com/instafy-dev/instafy/blob/main/docs/CLI.md#searching-for-links-instafy-web-search).
 - `instafy web link <site> [name=value…] --json` — the link the person opens in their own tab for a `no-agents` site (guided mode): the site's search template from the web-research skill's list, filled with checked, URL-encoded values, or its home page and what to type there when it bars deep links. Reads nothing.
+- `instafy web budget --json` — inspect remaining fresh-page reads shared by the current task and its helpers. Cached pages are free.
+- `instafy web settings --interactive` — space managers configure total and per-site page allowances for new tasks; running tasks retain their original budget. Use `--max-page-loads` and `--max-page-loads-per-site` for scripts.
 - `instafy secrets list` — list space secret metadata (names/descriptions, never values).
 - `instafy secrets get <name-or-id>` — inspect one space secret metadata entry.
 - `instafy secrets put <name> --value ...` — create/update a space secret.

package/dist/bind/bin/instafy-bind.mjs

@@ -48,7 +48,8 @@ serve      Serve the site (or every subfolder with a bound.json) with the binder
            given). --agent-conversation <id> uses an existing conversation instead. --agent-budget caps Octo
            turns per site per hour (repairs included). --dry-run prints those prompts instead.
            --detach: start the binder in the background (its own session, output to --log, default
-           <tmp>/instafy-bind-<port>.log), wait until it answers, print where it serves and exit. A server
+           <tmp>/instafy-bind-<port>.log), wait until it answers as itself, print where it serves and exit. A
+           binder of this folder already serving on the port is kept; another server there is refused. A server
            started in an agent turn without it stops when the turn ends.
            In a folder of an Instafy space, the binder saves the data files it writes for clicks (records,
            data/version.json): it commits them to the space's checkout a few seconds after the last write, and
@@ -119,6 +120,15 @@ function detachedServeArgs(argv) {
   return out;
 }
 
+/** The folder's real path, or the path itself when it cannot be resolved. */
+function realOr(dir) {
+  try {
+    return fs.realpathSync(path.resolve(String(dir)));
+  } catch {
+    return path.resolve(String(dir));
+  }
+}
+
 async function serveDetached(dir, flags) {
   const port = flags.port === undefined ? 4180 : Number(flags.port);
   if (!Number.isInteger(port) || port < 1 || port > 65535) fail("--detach needs a fixed --port");
@@ -132,16 +142,39 @@ async function serveDetached(dir, flags) {
   fs.closeSync(fd);
   child.unref();
   const host = flags.host || "127.0.0.1";
+  const folder = realOr(dir);
+  // A gallery answers under each site's folder: ask the first one.
+  let prefix = "";
+  try {
+    prefix = discoverSites(dir, { plain: true })[0]?.prefix ?? "";
+  } catch {
+    // the binder says why in its log
+  }
+  const running = () => child.exitCode === null && child.signalCode === null;
   const deadline = Date.now() + 20_000;
   let up = false;
-  while (Date.now() < deadline) {
-    if (child.exitCode !== null) break;
+  // Whether something else answered on the port: another site's server, or another binder.
+  let other = false;
+  // A binder of this same folder that was already serving on the port (an earlier --detach): it is kept.
+  let earlier = null;
+  while (Date.now() < deadline && running()) {
     try {
-      const response = await fetch(`http://${host.includes(":") ? `[${host}]` : host}:${port}/__bind/health`);
-      if (response.status < 500) {
-        up = true;
-        break;
+      const response = await fetch(`http://${host.includes(":") ? `[${host}]` : host}:${port}${prefix}/__bind/health`, { signal: AbortSignal.timeout(2_000) });
+      // Only this site's own binder counts: the folder it serves and the process it runs in. The child started here
+      // while it still runs, or a binder of this same folder that already held the port, whose answer is never taken
+      // for the child's. Any other answer on the port is another server, never this site being served.
+      const binder = (await response.json().catch(() => null))?.binder;
+      if (response.ok && binder && realOr(binder.root) === folder && Number.isInteger(binder.pid)) {
+        if (binder.pid === child.pid && running()) {
+          up = true;
+          break;
+        }
+        if (binder.pid !== child.pid) {
+          earlier = binder.pid;
+          break;
+        }
       }
+      other = true;
     } catch {
       // not listening yet
     }
@@ -154,7 +187,22 @@ async function serveDetached(dir, flags) {
       return "";
     }
   };
-  if (!up) fail(`the background binder did not start (log ${logFile}):\n${tail()}`);
+  if (!up) {
+    // A binder that never answered as itself is not left running in the background.
+    if (running()) {
+      try {
+        process.kill(child.pid, "SIGTERM");
+      } catch {
+        // already gone
+      }
+    }
+    if (earlier !== null) {
+      process.stdout.write(`instafy-bind already serves ${dir} on port ${port} in the background (pid ${earlier}); it keeps running after this turn.\n`);
+      return;
+    }
+    if (other) fail(`port ${port} is in use by another server, so ${dir} is not served there; pick another --port (log ${logFile}):\n${tail()}`);
+    fail(`the background binder did not start (log ${logFile}):\n${tail()}`);
+  }
   process.stdout.write(`instafy-bind serving ${dir} on port ${port} in the background (pid ${child.pid}; log ${logFile}); it keeps running after this turn.\n`);
   const shown = tail().split("\n").filter((line) => /show it in Studio|public link|agent executor|intents:/.test(line));
   for (const line of shown) process.stdout.write(`${line}\n`);

package/dist/bind/src/server.mjs

@@ -698,6 +698,10 @@ export function createBinder(options) {
           site: { title: site.title }, token: tokenNeeded(site, req),
           viewer: viewerOk(site, req, url), parentOrigins: parentOriginsFor(site, req),
           executors: { script: "ready", agent: agentState },
+          // Which folder this binder serves and its process, told only to this machine (a loopback socket and name, no
+          // proxy; a tunnel's client connects from here but keeps the viewer's host): `serve --detach` checks that the
+          // answer on the port is its own binder's, not another server's.
+          ...(adminLocal(req) ? { binder: { root, pid: process.pid } } : {}),
         });
       case "session": {
         // The client trades #k= for an HttpOnly cookie once, so EventSource, polling and the page's own fetches

package/dist/bind/src/starters/compare/app.js

@@ -15,6 +15,8 @@
  *                          unknown is never listed as under $160; it is listed apart, under "Price unknown".
  *   items: [{ref: "option:a", name, why (one short line), badge?: "Previous model", note?, facts: {key: fact},
  *            store: {name, url, readable}, more?: [{label, fact}], sources?: [{name, url}]}]
+ *                          every candidate a page you read named, also one nothing could be read for: its cells say
+ *                          "Unknown" (a table of unknowns). Empty only when no page named any: it reads "No options yet".
  *   unchecked: ["what was not checked", …]     listed once in the footer
  *   fact: {"v": "$145", "src": "Example Store", "url": "https://…", "date": "2026-10-17", "asof"?: "2026-08-05", "est": false}
  *   Each value cites its page and day ("checked 17 Oct on maker.com ↗"), and no cell is blank: a source you read that