typebulb 0.44.2 → 0.45.0

package/dist/agents/pi/matchu-patchu.ts

@@ -2440,7 +2440,7 @@ var Patcher = class {
 
 // cli/agents/pi/server/piPatcherExtension.ts
 var DESCRIPTION = true ? "Apply unified diffs to files \u2014 tolerant of form, strict about intent. Repairs sloppy AI-generated diffs (mangled headers, whitespace drift, missing prefixes; line numbers can be wrong or absent \u2014 hunks anchor by fuzzy-matched context lines) and applies all hunks atomically when the intent is unambiguous; fails with a precise, typed error when it isn't. Use for multi-hunk edits in one step, or when exact string-replacement editing fails on whitespace or invisible characters." : "Apply unified diffs to files.";
-var BUILD_TAG = true ? "matchu-patchu-pi 0.3.5, built 2026-07-30 15:13:29" : "matchu-patchu-pi dev";
+var BUILD_TAG = true ? "matchu-patchu-pi 0.3.5, built 2026-07-30 17:52:54" : "matchu-patchu-pi dev";
 var errorBlocks = (errors) => {
   const parts = [`Patch failed with ${errors.length} error(s):`];
   for (const e of errors) parts.push("", e.toString());

package/dist/agents/pi/styles.css

@@ -229,25 +229,55 @@ body {
   border-radius: 10px;
   box-shadow: 0 8px 30px rgba(0, 0, 0, .45);
 }
-/* Owned scrollbars: no arrow buttons, transparent track, a floating thumb only when the surface
-   actually overflows. On the menu lists the channel is ALWAYS reserved (overflow-y: scroll on the
-   three lists); the diff doc joins them so its thumb track matches the overview ruler (.diff-ruler).
-   Native auto scrollbars made a row band's right inset depend on list length: a
+/* Menu-list scrollbars: the channel is ALWAYS reserved (overflow-y: scroll on all three lists) and
+   the scrollbar is owned — no arrow buttons, transparent track, a floating thumb only when the list
+   actually overflows. Native auto scrollbars made a row band's right inset depend on list length: a
    project with no bulbs of its own (one collapsed fold row) ran its band 15px nearer the popover
    edge than the filter box under it, and bare overflow:scroll parked a vestigial arrow-stub beside
    the short list. Width stays 15px, the native width .model-head's alignment padding hardcodes.
    Chromium pseudos on purpose: setting the standard scrollbar-color would disable them. */
-:is(.picker-list, .bulb-list, .gitdiff-list, .diff-doc-body)::-webkit-scrollbar { width: 15px; }
-:is(.picker-list, .bulb-list, .gitdiff-list, .diff-doc-body)::-webkit-scrollbar-button { display: none; }
-:is(.picker-list, .bulb-list, .gitdiff-list, .diff-doc-body)::-webkit-scrollbar-track { background: transparent; }
-:is(.picker-list, .bulb-list, .gitdiff-list, .diff-doc-body)::-webkit-scrollbar-thumb {
+:is(.picker-list, .bulb-list, .gitdiff-list)::-webkit-scrollbar { width: 15px; }
+:is(.picker-list, .bulb-list, .gitdiff-list)::-webkit-scrollbar-button { display: none; }
+:is(.picker-list, .bulb-list, .gitdiff-list)::-webkit-scrollbar-track { background: transparent; }
+:is(.picker-list, .bulb-list, .gitdiff-list)::-webkit-scrollbar-thumb {
   background-color: color-mix(in srgb, var(--fg) 28%, transparent);
   border-radius: 8px;
   /* Transparent border + padding-box clip floats a slim pill in the 15px channel. */
   border: 4px solid transparent;
   background-clip: padding-box;
 }
-:is(.picker-list, .bulb-list, .gitdiff-list, .diff-doc-body)::-webkit-scrollbar-thumb:hover { background-color: color-mix(in srgb, var(--fg) 45%, transparent); }
+:is(.picker-list, .bulb-list, .gitdiff-list)::-webkit-scrollbar-thumb:hover { background-color: color-mix(in srgb, var(--fg) 45%, transparent); }
+
+/* The overview ruler (overviewRuler.ts): a scroll container's bar, replaced. .oruler-host is applied
+   by the widget at mount — never statically — so the native bar only disappears once its replacement
+   is painted. BOTH hiding routes: the standard property covers Gecko, the pseudo covers WebKit, and
+   Blink honours either, so no engine is left showing two scrollbars. Window and marks are % of a track
+   that spans the pane, so they share the container's content space. Marks are pointer-inert; the track
+   takes the press, the drag and the wheel. Colour and the track's inset are the host's (.diff-ruler).
+   Cursor stays the plain arrow — that's what a scrollbar shows, and `grab` would claim otherwise. */
+.oruler-host { scrollbar-width: none; }
+.oruler-host::-webkit-scrollbar { width: 0; height: 0; }
+.oruler { position: absolute; inset-block: 0; width: 6px; z-index: 5; cursor: default; touch-action: none; }
+.oruler-mark { position: absolute; left: 0; right: 0; min-height: 3px; border-radius: 1px; pointer-events: none; }
+/* Wider than the track and above the marks, so what's on screen reads as a thumb laid over the map. */
+.oruler-win {
+  position: absolute; left: -3px; right: -3px; z-index: 1; min-height: 6px; border-radius: 3px;
+  pointer-events: none; background: color-mix(in srgb, var(--fg) 28%, transparent);
+}
+/* The menu thumbs' own two steps (28/45) — same surface, same weights. Still a wash rather than a
+   solid fill: the marks it covers are the ones you're about to read. */
+.oruler:hover .oruler-win { background: color-mix(in srgb, var(--fg) 45%, transparent); }
+/* A finger needs a target a 6px track can't give; the map is worth more widened than dropped. */
+@media (pointer: coarse) {
+  .oruler { width: 14px; }
+  .oruler-win { left: -2px; right: -2px; }
+}
+/* Forced colours drop our tints — the window would vanish outright, and the marks' red/green IS the
+   information, so it keeps its own palette rather than collapsing to one system colour. */
+@media (forced-colors: active) {
+  .oruler-win { background: transparent; border: 1px solid Highlight; }
+  .oruler-mark { forced-color-adjust: none; }
+}
 /* Popover alignment — which edge of the pill the menu aligns to (floating-UI's start/center/end
    vocabulary; "end", right edges flush and growing left, is the unnamed default above). Tagged on
    the pill's WRAP, not each popover root: a menu with several drilled-in views (the model pill's
@@ -1082,11 +1112,17 @@ a.server-port:hover { text-decoration: underline; }
 .diff-doc { flex: 1; min-height: 0; display: flex; flex-direction: column; outline: none; }
 .diff-doc-body {
   flex: 1; min-height: 0; overflow: auto;
-  scrollbar-gutter: stable both-edges;
-  padding: .75rem 1.75rem 2.5rem;
+  /* No scrollbar-gutter: the native bar is hidden (.oruler-host), so the 15px it used to reserve on
+     each edge rides in the padding instead — same metrics, and the right one is the ruler's channel. */
+  padding: .75rem calc(1.75rem + 15px) 2.5rem;
   font: .78rem/1.5 ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;
   white-space: pre-wrap; word-break: break-word;
 }
+/* The scroller is the focusable element (it owns the paging keys), but a ring round a full-bleed pane
+   is a box round the whole screen. Keyboard focus shows on the ruler's window instead — the thing the
+   paging keys actually move, and a real indicator rather than none at all. */
+.diff-doc-body:focus { outline: none; }
+.diff-doc-body:focus-visible ~ .diff-ruler .oruler-win { background: color-mix(in srgb, var(--accent) 55%, transparent); }
 .diff-doc-empty, .diff-doc-trunc { color: var(--muted); padding: .4rem 0; }
 /* The wrong-cwd empty state (Root.#cwdHint): centered over the empty transcript. */
 .cwd-hint { position: absolute; inset: 0; display: grid; place-content: center; text-align: center; gap: .5rem; padding: 2rem; color: var(--muted); font-size: .9rem; max-width: 40rem; margin-inline: auto; }
@@ -1099,19 +1135,13 @@ a.server-port:hover { text-decoration: underline; }
    camouflage against red tint more than anything does against green. */
 .diff-doc-body .udiff-add { background: color-mix(in srgb, var(--diff-add) 15%, transparent); }
 .diff-doc-body .udiff-del { background: color-mix(in srgb, var(--err) 18%, transparent); }
-/* The overview ruler — VS Code's scrollbar change-marks, owned since the native scrollbar can't be
-   painted: a thin track beside the scrollbar (15px = the owned channel's width — plain px on a
-   desktop-only surface, the menus' own stance), red/green marks at each change run's fractional
-   position, min-height so a one-line change stays visible. It spans the pane edge to edge, which is
-   the thumb's track exactly once the arrow buttons are gone — that's why the doc's bar is owned.
-   What drift is left on a tall doc is Chromium clamping the thumb to a minimum height, shortening
-   its travel; a static ruler can't follow that. The wrapper keeps it overlaid rather than scrolling
-   with the body. Marks are pointer-inert so a click anywhere on the track jumps. */
+/* The ruler's diff clothing — red/green per change run; it rides in the channel the body's right
+   padding reserves, where the scrollbar it replaces used to be. Geometry, the window and the click
+   are the shared widget's. The wrapper keeps it overlaid rather than scrolling with the body. */
 .diff-doc-scroll { position: relative; flex: 1; min-height: 0; display: flex; flex-direction: column; }
-.diff-ruler { position: absolute; inset-block: 0; right: 15px; width: 6px; cursor: pointer; z-index: 5; }
-.diff-ruler-mark { position: absolute; left: 0; right: 0; min-height: 3px; border-radius: 1px; pointer-events: none; }
-.diff-ruler-mark.add { background: var(--diff-add); opacity: .8; }
-.diff-ruler-mark.del { background: var(--err); opacity: .8; }
+.diff-ruler { right: 4px; }
+.diff-ruler .oruler-mark.add { background: var(--diff-add); opacity: .8; }
+.diff-ruler .oruler-mark.del { background: var(--err); opacity: .8; }
 /* messages */
 .messages {
   flex: 1;

package/dist/index.js

@@ -894,9 +894,20 @@ ${gE(t)}`)}var gh=v(()=>{Bi()});var wt,Fn,Nl,qn=v(()=>{wt="https://esm.sh",Fn="h
     if (lines.length > MAX_LINES) { lines.length = MAX_LINES; lines.push('- \u2026 (truncated)'); }
     return { lines, targets };
   };
+  // The scrolling element's client box is the usable area minus scrollbars \u2014 the only basis on
+  // which "content \u2264 viewport" is the same verdict the scrollbar's presence gives the user.
+  const pageGeometry = () => {
+    const de = document.scrollingElement || document.documentElement;
+    const over = [];
+    if (de.scrollHeight > de.clientHeight) over.push('vertically by ' + (de.scrollHeight - de.clientHeight) + 'px');
+    if (de.scrollWidth > de.clientWidth) over.push('horizontally by ' + (de.scrollWidth - de.clientWidth) + 'px');
+    return '- page: viewport ' + de.clientWidth + '\xD7' + de.clientHeight
+      + ', content ' + de.scrollWidth + '\xD7' + de.scrollHeight
+      + ' \u2014 ' + (over.length ? 'overflows ' + over.join(', ') : 'fits');
+  };
   const snapshot = () => {
     const { lines } = collectOutline();
-    return lines.length ? lines.join('\\n') : '(empty page)';
+    return pageGeometry() + '\\n' + (lines.length ? lines.join('\\n') : '(empty page)');
   };
 
   // tb:click / tb:set (TB-Interrogation-Actuation.md). A target is role + name exactly as the
@@ -968,6 +979,20 @@ ${gE(t)}`)}var gh=v(()=>{Bi()});var wt,Fn,Nl,qn=v(()=>{wt="https://esm.sh",Fn="h
     }
     return postFrameSnapshot();
   };
+  // tb:rect \u2014 a read in the actuation grammar: the named control's viewport-relative rect plus the
+  // viewport itself, so the reply is self-interpreting. No scrollIntoView \u2014 a read disturbs nothing.
+  const readRect = (rest) => {
+    const t = parseActuation('tb:rect <role> "<name>"', rest);
+    if (t.rest) throw new Error('usage: tb:rect <role> "<name>"');
+    const el = resolveTarget(t.role, t.name);
+    const r = el.getBoundingClientRect();
+    const de = document.scrollingElement || document.documentElement;
+    return {
+      x: Math.round(r.x), y: Math.round(r.y),
+      width: Math.round(r.width), height: Math.round(r.height),
+      viewport: { width: de.clientWidth, height: de.clientHeight }
+    };
+  };
   const actSet = (rest) => {
     const t = parseActuation('tb:set <role> "<name>" = <value>', rest);
     const vm = /^=\\s*([\\s\\S]*)$/.exec(t.rest.trim());
@@ -1024,7 +1049,8 @@ ${Gi}
         if (p === 'tb:snapshot') return snapshot();
         if (p === 'tb:click' || p.indexOf('tb:click ') === 0) return actClick(p.slice(9));
         if (p === 'tb:set' || p.indexOf('tb:set ') === 0) return actSet(p.slice(7));
-        throw new Error('unknown reserved message: ' + p + ' (known: tb:snapshot, tb:click, tb:set)');
+        if (p === 'tb:rect' || p.indexOf('tb:rect ') === 0) return readRect(p.slice(8));
+        throw new Error('unknown reserved message: ' + p + ' (known: tb:snapshot, tb:rect, tb:click, tb:set)');
       };
       const value = parseMsg(env.payload);
       const calls = typeof env.payload === 'string' && env.payload.indexOf('tb:') === 0
@@ -1444,11 +1470,14 @@ Usage:
                                  With --wait, a handler's non-undefined return
                                  prints on stdout (JSON; a bare string raw).
                                  msg 'tb:snapshot' instead prints the page's
-                                 rendered outline (roles, names, visible text).
+                                 rendered outline (roles, names, visible text),
+                                 headed by a viewport/content fit line.
+                                 'tb:rect <role> "<name>"' prints that control's
+                                 rect ({x,y,width,height} + viewport).
                                  'tb:click <role> "<name>"' clicks the control
-                                 that outline names; 'tb:set \u2026 = <value>' fills
-                                 a form control. Both reply with a fresh
-                                 snapshot and need exactly one page open.
+                                 the outline names; 'tb:set \u2026 = <value>' fills
+                                 a form control. Both gestures reply with a
+                                 fresh snapshot and need exactly one page open.
   typebulb get <file> <kind>     Print one block's content to stdout (kind: code,
                                  css, html, data, infer, insight, config, notes).
                                  No content (absent or empty): exit 2;
@@ -2171,5 +2200,5 @@ ${AC}
 `);let c=0,l=Promise.resolve();Nt({target:r,onChange:()=>{let d=++c;l=l.then(async()=>{if(d===c)try{console.log("Re-running..."),await a()}catch(u){console.error("Error:",u)}})}})}}Ot();Ke();import{Console as RC}from"node:console";Ie();async function rw(r,e,t,n,s){LC();try{let p=kr(await Q(),r)[0];p&&(Ni(p.pid,Je(p.pid).offset),console.error(`note: 'call' boots a fresh server.ts instance; the running server (${p.url}) is not contacted \u2014 state shared with it must live on disk.`))}catch{}let i=Ae(t),{bulb:o,config:a}=await De(r);o.server||ws("This bulb has no **server.ts** block; nothing to call."),Tt(i,r,o.server),s&&await Mr(r,s);let c;try{c=await es(o.server,r,n,a.dependencies,s)}catch(p){ws(p instanceof Error?p.message:String(p))}let l=ca(c,e.fn);if(!l){let p=[...Object.keys(c).filter(h=>typeof c[h]=="function"),...Object.keys(aa)];ws(`Function '${e.fn}' not found. Available: ${p.length?p.join(", "):"(none)"}.`)}let d=await _C(e);if(la(l)){try{for await(let p of l(...d))await tw(JSON.stringify(p,nw)+`
 `)}catch(p){ws(p instanceof Error?p.stack??p.message:String(p))}return ew(0)}let u;try{u=await l(...d)}catch(p){ws(p instanceof Error?p.stack??p.message:String(p))}let f=$C(u);f!==void 0&&await tw(f+`
 `),ew(0)}function ew(r){process.exitCode=r,setTimeout(()=>process.exit(r),2e3).unref?.()}async function _C(r){if(r.hasArgsFlag){let e=r.argsJson??"";return e==="-"&&(e=await MC()),IC(e)}return NC(r.positional)}function NC(r){return r.map(e=>{try{return JSON.parse(e)}catch{return e}})}function IC(r){let e;try{e=JSON.parse(r)}catch(t){throw new Error(`--args must be a JSON array: ${t instanceof Error?t.message:String(t)}`)}if(!Array.isArray(e))throw new Error(`--args must be a JSON array, got ${e===null?"null":typeof e}`);return e}function $C(r){if(r!==void 0)return JSON.stringify(r,nw,2)}function nw(r,e){return typeof e=="bigint"?e.toString():e}function ws(r){process.stderr.write(r+`
-`),process.exit(1)}function LC(){let r=new RC(process.stderr,process.stderr);console.log=r.log.bind(r),console.info=r.info.bind(r),console.debug=r.debug.bind(r),console.dir=r.dir.bind(r)}function tw(r){return new Promise((e,t)=>{process.stdout.write(r,n=>n?t(n):e())})}async function MC(){let r=[];for await(let e of process.stdin)r.push(e);return Buffer.concat(r).toString("utf-8")}var sw="0.44.2";for(let r of[process.stdout,process.stderr])r.on("error",e=>{if(e?.code!=="EPIPE")throw e});function iw(r,e){r||(console.error(`This bulb runs server-side Node code (server.ts), which --trust must authorize:
+`),process.exit(1)}function LC(){let r=new RC(process.stderr,process.stderr);console.log=r.log.bind(r),console.info=r.info.bind(r),console.debug=r.debug.bind(r),console.dir=r.dir.bind(r)}function tw(r){return new Promise((e,t)=>{process.stdout.write(r,n=>n?t(n):e())})}async function MC(){let r=[];for await(let e of process.stdin)r.push(e);return Buffer.concat(r).toString("utf-8")}var sw="0.45.0";for(let r of[process.stdout,process.stderr])r.on("error",e=>{if(e?.code!=="EPIPE")throw e});function iw(r,e){r||(console.error(`This bulb runs server-side Node code (server.ts), which --trust must authorize:
   ${e}`),process.exit(1))}async function BC(){let r=Zy(process.argv.slice(2));if(r.version&&(console.log(`typebulb ${sw}`),process.exit(0)),r.help&&(eb(),process.exit(0)),Xy(),r.subcommand==="logs"){await Pb(r.file||void 0,{follow:r.follow,clear:r.clear,run:r.run,lines:r.lines});return}if(r.subcommand==="wait"){await Cb(r.file||void 0,{match:r.match,timeoutSec:r.timeoutSec});return}if(r.subcommand==="stop"){r.stopScope?await _b(r.stopScope):await Rb(r.file||void 0);return}if(r.subcommand==="send"){await $b(r.file,r.sendMessage,r.sendWaitMs??0);return}if(r.subcommand==="models"){await Eb(r.mode);return}if(r.subcommand==="slug"){Ab(r.slugName);return}if(r.subcommand==="pull"){await kg(r.file||void 0,{force:r.force,mode:r.mode});return}if(r.subcommand==="push"){await Eg(r.file||void 0,{force:r.force,mode:r.mode});return}if(r.subcommand==="agent"){await(r.agentTarget?Xb(r):xb(sw));return}if(r.subcommand==="trust"||r.subcommand==="untrust"){await vb(r.file||void 0,r.subcommand==="trust");return}let e;if(!r.file||r.file==="."){let c=await eg(process.cwd());c||(console.error("No .bulb.md file found in current directory"),process.exit(1)),e=c}else e=ir.resolve(r.file);if(await ow.access(e).then(()=>!0,()=>!1)||(Vr().includes(r.file)&&(console.error(`To open the ${r.file} agent mirror, run: npx typebulb agent:${r.file}`),process.exit(1)),console.error(`File not found: ${e}`),process.exit(1)),e.endsWith(".bulb.md")||(console.error("File must have .bulb.md extension"),process.exit(1)),r.subcommand==="get"){await Mb(e,r.blockKind);return}if(r.subcommand==="put"){await jb(e,r.blockPairs);return}let n=r.file&&r.file!=="."?r.file:ir.relative(process.cwd(),e)||ir.basename(e),s=`npx typebulb --trust ${n.includes(" ")?`"${n}"`:n}`;if(r.subcommand==="predict"){await wb(e,s);return}let i=!r.noTrust&&Qt(e);i&&!r.trust&&console.error("trust: granted from memory (run `typebulb untrust` to revoke)"),r.trust=r.noTrust?!1:r.trust||i;let o;try{o=await De(e)}catch{}let a;if(r.local){o&&!(r.local.name in(o.config.dependencies??{}))&&(console.error(`--replace: '${r.local.name}' is not a dependency in this bulb's config.json; nothing to replace.`),process.exit(1)),o&&r.subcommand!=="call"&&(!o.bulb.code||r.server)&&console.warn("warning: --replace has no effect in server mode (the override is client-only).");try{a=await bd(r.local)}catch(c){console.error(c instanceof Error?c.message:String(c)),process.exit(1)}console.error(`replace: ${a.name} \u2192 ${ir.relative(process.cwd(),a.dir)||"."}`)}if(r.subcommand==="check"){await bb(e,a);return}if(r.subcommand==="call"){iw(r.trust,s),await rw(e,{fn:r.fn,positional:r.callArgs,argsJson:r.argsJson,hasArgsFlag:r.hasArgsFlag},r.mode,a,r.batch);return}if(o&&o.bulb.server&&(Li(o.bulb)||r.server)){iw(r.trust,s),await Zb(e,r.watch,r.mode,a,r.batch);return}await Yb(e,r,s,a)}BC().catch(r=>{console.error("Error:",r.message),process.exit(1)});