agent-yes 1.237.0 → 1.238.0

package/dist/{subcommands-DFr-5FOL.js → subcommands-BdBCxZVu.js}

@@ -1177,6 +1177,8 @@ const SUBCOMMANDS = new Set([
 	"ch",
 	"channels",
 	"term",
+	"widget",
+	"mint",
 	"serve",
 	"schedule",
 	"remote",
@@ -1251,23 +1253,31 @@ async function runSubcommand(argv) {
 				return cmdCh(rest);
 			}
 			case "term": {
-				const { cmdTerm } = await import("./terminal-vNeFNLT8.js");
+				const { cmdTerm } = await import("./terminal-w7drEaJc.js");
 				return cmdTerm(rest);
 			}
+			case "widget": {
+				const { cmdWidget } = await import("./widget-Coav85Lx.js");
+				return cmdWidget(rest);
+			}
+			case "mint": {
+				const { cmdMint } = await import("./widget-Coav85Lx.js");
+				return cmdMint(rest);
+			}
 			case "serve": {
-				const { cmdServe } = await import("./serve-QejbNTr-.js");
+				const { cmdServe } = await import("./serve-BLxmap1e.js");
 				return cmdServe(rest);
 			}
 			case "setup": {
-				const { cmdSetup } = await import("./setup-Dzi5Cc3g.js");
+				const { cmdSetup } = await import("./setup-DlFVw_1n.js");
 				return cmdSetup(rest);
 			}
 			case "ws": {
-				const { cmdWs } = await import("./ws-Dun8gGiV.js");
+				const { cmdWs } = await import("./ws-3prv2in5.js");
 				return cmdWs(rest);
 			}
 			case "schedule": {
-				const { cmdSchedule } = await import("./schedule-B8Erb3y6.js");
+				const { cmdSchedule } = await import("./schedule-Bw3SL5Hv.js");
 				return cmdSchedule(rest);
 			}
 			case "remote": {
@@ -1279,7 +1289,7 @@ async function runSubcommand(argv) {
 				return cmdExpose(rest);
 			}
 			case "callback": {
-				const { cmdCallback } = await import("./callback-CFbkvqTh.js");
+				const { cmdCallback } = await import("./callback-B-ojDckO.js");
 				return cmdCallback(rest);
 			}
 			case "reap":
@@ -1317,7 +1327,7 @@ async function cmdHelp(managerCommands = true) {
 	const wsLines = managerCommands ? "  ay ws ls [--status]                 list <owner>/<repo>/tree/<branch> workspaces\n  ay ws new <owner>/<repo>[@branch]   clone/refresh a workspace (ay ws help for more)\n" : ``;
 	const self = process.env.AGENT_YES_PID ? await resolveSender() : null;
 	const agentSection = self ? await buildAgentContextSection(self) : "";
-	process.stdout.write(agentSection + "ay - agent-yes CLI\n\nManagement:\n  ay ls [keyword]                     list running agents\n  ay tail [-f] [-n N] <keyword>       last N lines (96), -f to follow\n  ay read <keyword> [page opts]       paginate: --last/--head N, --range A:B,\n                                        --before-line L [--limit N]\n  ay cat <keyword>                    full log\n  ay head <keyword>                   first N lines\n  ay send <keyword> <msg>             send a message (keyword '.' = agent in this cwd)\n  ay msgs [keyword] [--in|--out]      inter-agent message log (sent + received)\n  ay ch mk|join|send|read|tail <topic>  local-first E2E channels: AI ↔ humans on a topic (ay ch help)\n  ay term embed <pid>                 <script> to embed a live read-only agent terminal in a page (ay term help)\n  ay key <keyword> <key...>           send raw keystrokes (down/up/enter/esc/…) — drives menus\n  ay select <keyword> <N>             pick option N of a needs_input selection menu\n  ay attach <keyword>                 interactive attach (detach: Ctrl-\\)\n  ay stop <keyword>                   graceful shutdown (/exit for claude/codex)\n  ay exit <keyword> [reason]          graceful shutdown, recording who/why (= 'ay send <kw> exit')\n  ay restart <keyword> [--fresh]      stop (if live) + relaunch resuming the session; --fresh replays the prompt\n  ay status <keyword>                 agent status snapshot\n  ay result <keyword> [--wait]        pull an agent's structured result envelope\n  ay result set '<json>'              (inside an agent) deposit your result envelope\n  ay reap                             kill process groups leaked by dead agents\n" + wsLines + "\nRemote:\n" + setupLine + "  ay schedule <when> <cli> -- <msg>   run an agent on a schedule (HH:MM or cron)\n  ay serve [--port N]                 start HTTP API server (prints token)\n  ay serve status                     show serve daemon/server status\n  ay remote add <alias> http://<token>@<host>:<port>\n  ay remote ls / rm <alias>           manage saved remotes\n  ay expose <port>                    share localhost:<port> at https://<id>.agent-yes.com (private link)\n  ay callback --expires 7d           mint an embeddable message-me widget for one agent\n  ay ls   <token>@<host>:<port>       connect inline (no alias needed)\n  ay send <token>@<host>:<port>:<kw> <msg>\n\nRun an agent:\n  ay [claude|codex|gemini|...] [options] -- [prompt]\n  ay claude -- \"fix the bug in auth.ts\"\n  ay claude --help                    full agent-runner options\n\nLabs (examples at https://github.com/snomiao/agent-yes/tree/main/lab):\n  local-role-play/   designer + builder on one machine\n  http-remote/       ay serve remote access demo\n  p2p-pairing/       libp2p P2P  (needs: cargo build --features swarm)\n");
+	process.stdout.write(agentSection + "ay - agent-yes CLI\n\nManagement:\n  ay ls [keyword]                     list running agents\n  ay tail [-f] [-n N] <keyword>       last N lines (96), -f to follow\n  ay read <keyword> [page opts]       paginate: --last/--head N, --range A:B,\n                                        --before-line L [--limit N]\n  ay cat <keyword>                    full log\n  ay head <keyword>                   first N lines\n  ay send <keyword> <msg>             send a message (keyword '.' = agent in this cwd)\n  ay msgs [keyword] [--in|--out]      inter-agent message log (sent + received)\n  ay ch mk|join|send|read|tail <topic>  local-first E2E channels: AI ↔ humans on a topic (ay ch help)\n  ay term embed <pid>                 <script> to embed a live read-only agent terminal in a page (ay term help)\n  ay widget ls | read selection|dom   read an opted-in page widget's context (selection/DOM) (ay widget help)\n  ay mint <target> --caps ...         mint a scoped, short-TTL capability token (embeddable in a page)\n  ay key <keyword> <key...>           send raw keystrokes (down/up/enter/esc/…) — drives menus\n  ay select <keyword> <N>             pick option N of a needs_input selection menu\n  ay attach <keyword>                 interactive attach (detach: Ctrl-\\)\n  ay stop <keyword>                   graceful shutdown (/exit for claude/codex)\n  ay exit <keyword> [reason]          graceful shutdown, recording who/why (= 'ay send <kw> exit')\n  ay restart <keyword> [--fresh]      stop (if live) + relaunch resuming the session; --fresh replays the prompt\n  ay status <keyword>                 agent status snapshot\n  ay result <keyword> [--wait]        pull an agent's structured result envelope\n  ay result set '<json>'              (inside an agent) deposit your result envelope\n  ay reap                             kill process groups leaked by dead agents\n" + wsLines + "\nRemote:\n" + setupLine + "  ay schedule <when> <cli> -- <msg>   run an agent on a schedule (HH:MM or cron)\n  ay serve [--port N]                 start HTTP API server (prints token)\n  ay serve status                     show serve daemon/server status\n  ay remote add <alias> http://<token>@<host>:<port>\n  ay remote ls / rm <alias>           manage saved remotes\n  ay expose <port>                    share localhost:<port> at https://<id>.agent-yes.com (private link)\n  ay callback --expires 7d           mint an embeddable message-me widget for one agent\n  ay ls   <token>@<host>:<port>       connect inline (no alias needed)\n  ay send <token>@<host>:<port>:<kw> <msg>\n\nRun an agent:\n  ay [claude|codex|gemini|...] [options] -- [prompt]\n  ay claude -- \"fix the bug in auth.ts\"\n  ay claude --help                    full agent-runner options\n\nLabs (examples at https://github.com/snomiao/agent-yes/tree/main/lab):\n  local-role-play/   designer + builder on one machine\n  http-remote/       ay serve remote access demo\n  p2p-pairing/       libp2p P2P  (needs: cargo build --features swarm)\n");
 	return 0;
 }
 function matchKeyword(record, keyword) {
@@ -4317,7 +4327,7 @@ async function cmdNotify(rest) {
 	}
 	const ensure = async () => {
 		if (!argv["ensure-daemon"]) return;
-		const { ensureDaemon } = await import("./notifyDaemon-D_8TRVHt.js");
+		const { ensureDaemon } = await import("./notifyDaemon-CjBVeWRg.js");
 		await ensureDaemon().catch(() => null);
 	};
 	await heartbeatWatcher(parent, selfStartedAt);
@@ -4391,7 +4401,7 @@ async function cmdNotifyCursor(args) {
 }
 async function cmdNotifyd(rest) {
 	const sub = rest[0] ?? "status";
-	const daemon = await import("./notifyDaemon-D_8TRVHt.js");
+	const daemon = await import("./notifyDaemon-CjBVeWRg.js");
 	switch (sub) {
 		case "run": return daemon.runDaemon();
 		case "once": return daemon.runDaemon({ once: true });
@@ -4418,4 +4428,4 @@ async function cmdNotifyd(rest) {
 
 //#endregion
 export { daemonLockDir as $, renderLogTailLines as A, stopTipForCli as B, matchKeyword as C, readPtysize as D, readNotes as E, resolveResumeArgs as F, appendEvent as G, waitForLogQuiet as H, restartHintLines as I, isTransientLockMkdirError as J, gcInboxes as K, runSubcommand as L, renderRawLogLines as M, resolveOne as N, recentMessageEdges as O, resolveReadWindow as P, shouldStealLock as Q, snapshotStatus as R, listRecords as S, readAgentPtysize as T, writeKeysPaced as U, submitAndConfirm as V, writeToIpc as W, liveWatchers as X, listInboxParents as Y, readInbox as Z, isPidAlive as _, cmdHelp as a, isUserTyping as b, deriveLiveState as c, extractMenu as d, daemonLockOwnerPath as et, extractNeedsInput as f, isExitRequest as g, isAgentStuck as h, backoffWhileTyping as i, renderRawLog as j, recentReadEdges as k, deriveLiveStatus as l, finalizedLines as m, READ_PAGE_DEFAULT as n, TYPING_BADGE as nt, controlCodeFromName as o, extractTaskCounts as p, hostId as q, TYPING_WINDOW_MS as r, cursorAbs as s, GRACEFUL_EXIT_COMMANDS as t, notifyDir as tt, extractBadges as u, isSlashCommand as v, menuSelectKeys as w, lastStdinAt as x, isSubcommand as y, stdinActivityPath as z };
-//# sourceMappingURL=subcommands-DFr-5FOL.js.map
+//# sourceMappingURL=subcommands-BdBCxZVu.js.map

package/dist/{terminal-vNeFNLT8.js → terminal-w7drEaJc.js}

@@ -98,7 +98,7 @@ async function cmdTermMint(args) {
 	if (flags.ro && flags.interactive) throw new Error("--ro and --interactive are mutually exclusive");
 	const ttlSec = parseTtlSec(typeof flags.ttl === "string" ? flags.ttl : "15m");
 	const canSend = flags.interactive === true;
-	const { mintScopedTermToken } = await import("./serve-QejbNTr-.js");
+	const { mintScopedTermToken } = await import("./serve-BLxmap1e.js");
 	const r = await mintScopedTermToken(pid, {
 		ttlSec,
 		canSend
@@ -135,4 +135,4 @@ async function cmdTerm(args) {
 
 //#endregion
 export { cmdTerm };
-//# sourceMappingURL=terminal-vNeFNLT8.js.map
+//# sourceMappingURL=terminal-w7drEaJc.js.map

package/dist/{ts-Dd1FK7sR.js → ts-EvHuyNA9.js}

@@ -1,6 +1,6 @@
 import { n as __esmMin, r as __exportAll } from "./chunk-cZBX9HZv.js";
 import { n as logger, t as addTransport } from "./logger-CDIsZ-Pp.js";
-import { r as getInstalledPackage } from "./versionChecker-XfEBINhH.js";
+import { r as getInstalledPackage } from "./versionChecker-DNLNn_SL.js";
 import { t as agentYesHome } from "./agentYesHome-CtmsY6I-.js";
 import { d as openStore, p as LIFECYCLES, x as removeControlCharacters } from "./todoAutomation-Buo457VO.js";
 import { i as shouldUseLock, r as releaseLock, t as acquireLock } from "./runningLock-DBoONoM-.js";
@@ -2027,4 +2027,4 @@ function sleep(ms) {
 
 //#endregion
 export { hasTodoStore as a, AgentContext as c, answerAsk as i, CLAUDE_SESSION_PIN_ENV as l, agentYes as n, listAsks as o, config as r, listAsksForProject as s, CLIS_CONFIG as t };
-//# sourceMappingURL=ts-Dd1FK7sR.js.map
+//# sourceMappingURL=ts-EvHuyNA9.js.map

package/dist/{versionChecker-XfEBINhH.js → versionChecker-DNLNn_SL.js}

@@ -7,7 +7,7 @@ import { fileURLToPath } from "url";
 
 //#region package.json
 var name = "agent-yes";
-var version = "1.237.0";
+var version = "1.238.0";
 
 //#endregion
 //#region ts/versionChecker.ts
@@ -215,4 +215,4 @@ async function displayVersion() {
 
 //#endregion
 export { versionString as i, displayVersion as n, getInstalledPackage as r, checkAndAutoUpdate as t };
-//# sourceMappingURL=versionChecker-XfEBINhH.js.map
+//# sourceMappingURL=versionChecker-DNLNn_SL.js.map

package/dist/widget-Coav85Lx.js

@@ -0,0 +1,172 @@
+//#region ts/widget.ts
+function parseFlags(args, known) {
+	const flags = {};
+	const positional = [];
+	for (let i = 0; i < args.length; i++) {
+		const a = args[i];
+		if (!a.startsWith("-") || a === "-") {
+			positional.push(a);
+			continue;
+		}
+		const eq = a.indexOf("=");
+		const name = eq === -1 ? a.replace(/^--?/, "") : a.slice(a.startsWith("--") ? 2 : 1, eq);
+		const kind = known[name];
+		if (!kind) throw new Error(`unknown flag ${a}`);
+		if (kind === "bool") {
+			if (eq !== -1) throw new Error(`--${name} takes no value`);
+			flags[name] = true;
+		} else {
+			const v = eq !== -1 ? a.slice(eq + 1) : args[++i];
+			if (v === void 0) throw new Error(`${a} requires a value`);
+			flags[name] = v;
+		}
+	}
+	return {
+		flags,
+		positional
+	};
+}
+/** Resolve the local daemon base URL + token (flags override discovery). */
+async function daemonTarget(flags) {
+	const { resolveLocalServeUrl, loadTokenReadOnly } = await import("./serve-BLxmap1e.js");
+	const base = typeof flags.base === "string" ? flags.base : await resolveLocalServeUrl();
+	if (!base) throw new Error("no running ay serve daemon found — start `ay serve` or pass --base <url> (e.g. http://127.0.0.1:PORT)");
+	const token = typeof flags.token === "string" ? flags.token : await loadTokenReadOnly() ?? "";
+	if (!token) throw new Error("no serve token — pass --token or run `ay serve` once");
+	return {
+		base: base.replace(/\/+$/, ""),
+		token
+	};
+}
+function withTok(url, token) {
+	return `${url}${url.includes("?") ? "&" : "?"}token=${encodeURIComponent(token)}`;
+}
+async function cmdWidgetLs(args) {
+	const { flags } = parseFlags(args, {
+		json: "bool",
+		base: "value",
+		token: "value"
+	});
+	const { base, token } = await daemonTarget(flags);
+	const res = await fetch(withTok(`${base}/api/widget/list`, token), { headers: { accept: "application/json" } });
+	if (!res.ok) throw new Error(`widget list failed: ${res.status} ${await res.text()}`);
+	const list = await res.json();
+	if (flags.json) {
+		process.stdout.write(JSON.stringify(list, null, 2) + "\n");
+		return 0;
+	}
+	if (!list.length) {
+		process.stderr.write("no online widgets (a page must embed AyWidget and start() it)\n");
+		return 0;
+	}
+	for (const v of list) process.stdout.write(`${v.id.padEnd(12)}  ${(v.title || "(untitled)").slice(0, 28).padEnd(28)}  caps:${v.caps.join(",") || "-"}  ${v.age}s  ${v.url}\n`);
+	return 0;
+}
+async function cmdWidgetRead(args) {
+	const { flags, positional } = parseFlags(args, {
+		selector: "value",
+		all: "bool",
+		text: "bool",
+		html: "bool",
+		json: "bool",
+		base: "value",
+		token: "value"
+	});
+	const kind = positional[0];
+	const viewer = positional[1];
+	if (!kind || !viewer) throw new Error("usage: ay widget read <selection|dom> <viewer> [--selector <css>] [--all] [--text|--html]");
+	const cmdArgs = {};
+	if (kind === "dom") {
+		if (typeof flags.selector !== "string") throw new Error("dom read needs --selector <css>");
+		cmdArgs.selector = flags.selector;
+		cmdArgs.all = flags.all === true;
+	}
+	const { base, token } = await daemonTarget(flags);
+	const res = await fetch(withTok(`${base}/api/widget/read`, token), {
+		method: "POST",
+		headers: { "content-type": "application/json" },
+		body: JSON.stringify({
+			viewer,
+			kind,
+			args: cmdArgs
+		})
+	});
+	const body = await res.json().catch(() => ({}));
+	if (!res.ok) throw new Error(`widget read failed: ${res.status} ${JSON.stringify(body)}`);
+	if (body.error) {
+		process.stderr.write(`read ${kind} @ ${body.viewer ?? viewer}: ${body.error}\n`);
+		return 1;
+	}
+	if (kind === "selection" && !flags.json) {
+		process.stdout.write((flags.html ? body.data?.html : body.data?.text) ?? "");
+		process.stdout.write("\n");
+		return 0;
+	}
+	process.stdout.write(JSON.stringify(flags.json ? body : body.data, null, 2) + "\n");
+	return 0;
+}
+function widgetHelp() {
+	process.stdout.write("ay widget — read an opted-in page widget's context (selection / DOM)\n\nUsage:\n  ay widget ls [--json]\n  ay widget read selection <viewer> [--text|--html|--json]\n  ay widget read dom <viewer> --selector <css> [--all] [--json]\n\n  <viewer> = an id, or a url/title substring (see `ay widget ls`).\n  Common flags: --base <daemon-url>  --token <tok>  (default: the local daemon).\n  The page must embed `new AyWidget({sensors:[...]}).start()` and the token must\n  carry the 'read' cap (ay mint <viewer> --caps read) — or use the master token.\n");
+	return 0;
+}
+async function cmdWidget(args) {
+	const sub = args[0];
+	const rest = args.slice(1);
+	switch (sub) {
+		case "ls":
+		case "list": return cmdWidgetLs(rest);
+		case "read": return cmdWidgetRead(rest);
+		case void 0:
+		case "help":
+		case "--help":
+		case "-h": return widgetHelp();
+		default:
+			process.stderr.write(`ay widget: unknown subcommand "${sub}"\n\n`);
+			widgetHelp();
+			return 1;
+	}
+}
+function parseTtlSec(s) {
+	const m = /^(\d+)(s|m|h)?$/.exec(s.trim());
+	if (!m) throw new Error(`bad --ttl "${s}" (use e.g. 900, 30s, 15m, 2h)`);
+	const mult = m[2] === "h" ? 3600 : m[2] === "m" ? 60 : 1;
+	return Number(m[1]) * mult;
+}
+const KNOWN_CAPS = new Set([
+	"tail",
+	"size",
+	"send",
+	"resize",
+	"read",
+	"screenshot"
+]);
+async function cmdMint(args) {
+	const { flags, positional } = parseFlags(args, {
+		caps: "value",
+		ttl: "value",
+		json: "bool"
+	});
+	const target = positional[0];
+	if (!target || positional.length > 1) throw new Error("usage: ay mint <pid|viewer|url|*> --caps tail,send,read,screenshot [--ttl 15m] [--json]");
+	if (typeof flags.caps !== "string") throw new Error("--caps is required, e.g. --caps read  or  --caps tail,send");
+	const caps = flags.caps.split(",").map((c) => c.trim()).filter(Boolean);
+	const bad = caps.filter((c) => !KNOWN_CAPS.has(c));
+	if (bad.length) throw new Error(`unknown cap(s): ${bad.join(", ")} (valid: ${[...KNOWN_CAPS].join(", ")})`);
+	const ttlSec = parseTtlSec(typeof flags.ttl === "string" ? flags.ttl : "15m");
+	const { mintScopedTermToken } = await import("./serve-BLxmap1e.js");
+	const r = await mintScopedTermToken(target, {
+		ttlSec,
+		caps
+	});
+	if (flags.json === true) {
+		process.stdout.write(JSON.stringify(r) + "\n");
+		return 0;
+	}
+	process.stdout.write(r.token + "\n");
+	process.stderr.write(`\n  Scoped token for ${r.sub === "*" ? "ANY subject" : r.sub}, caps [${r.caps.join(", ")}], expires ${(/* @__PURE__ */ new Date(r.exp * 1e3)).toISOString()}.\n  It grants ONLY those caps for that subject — safe to embed in a page (not the master token).\n`);
+	return 0;
+}
+
+//#endregion
+export { cmdMint, cmdWidget };
+//# sourceMappingURL=widget-Coav85Lx.js.map

package/dist/widget.js

@@ -0,0 +1,162 @@
+//#region ts/widget/browser.ts
+var AyWidget = class {
+	origin;
+	token;
+	wantId;
+	viewerId = "";
+	sensors;
+	snapshots;
+	es;
+	started = false;
+	handlers = /* @__PURE__ */ new Map();
+	indicator;
+	constructor(info = {}) {
+		this.origin = (info.origin ?? "").replace(/\/+$/, "");
+		this.token = info.token ?? discoverToken();
+		this.wantId = info.id;
+		this.sensors = new Set(info.sensors ?? []);
+		this.snapshots = info.snapshots ?? {};
+		this.handlers.set("ping", async () => ({
+			caps: [...this.sensors],
+			id: this.viewerId
+		}));
+		this.handlers.set("selection", readSelection);
+		this.handlers.set("dom", readDom);
+	}
+	url(path) {
+		const p = this.token ? `${path}${path.includes("?") ? "&" : "?"}token=${encodeURIComponent(this.token)}` : path;
+		return this.origin + p;
+	}
+	/** Register with the daemon and open the command channel. Idempotent. */
+	async start() {
+		if (this.started) return this.viewerId;
+		this.started = true;
+		const g = globalThis;
+		const doc = g.document;
+		const res = await g.fetch(this.url("/api/widget/register"), {
+			method: "POST",
+			headers: { "content-type": "application/json" },
+			body: JSON.stringify({
+				id: this.wantId,
+				url: g.location?.href ?? "",
+				title: doc?.title ?? "",
+				caps: [...this.sensors]
+			})
+		});
+		if (!res.ok) throw new Error(`widget register failed: ${res.status}`);
+		this.viewerId = (await res.json()).viewerId;
+		this.openPoll();
+		return this.viewerId;
+	}
+	openPoll() {
+		const es = new globalThis.EventSource(this.url(`/api/widget/poll/${encodeURIComponent(this.viewerId)}`));
+		es.onmessage = (e) => {
+			let cmd;
+			try {
+				cmd = JSON.parse(e.data);
+			} catch {
+				return;
+			}
+			if (cmd.cmdId && cmd.kind) this.dispatch(cmd.cmdId, cmd.kind, cmd.args ?? {});
+		};
+		this.es = es;
+	}
+	async dispatch(cmdId, kind, args) {
+		this.flash();
+		const handler = this.handlers.get(kind);
+		if (!handler || kind !== "ping" && !this.sensors.has(kind)) return this.postResult(cmdId, {
+			ok: false,
+			error: `kind '${kind}' not enabled on this widget`
+		});
+		try {
+			const data = await handler(args);
+			await this.postResult(cmdId, {
+				ok: true,
+				data
+			});
+		} catch (e) {
+			await this.postResult(cmdId, {
+				ok: false,
+				error: String(e?.message ?? e)
+			});
+		}
+	}
+	async postResult(cmdId, r) {
+		const g = globalThis;
+		try {
+			await g.fetch(this.url("/api/widget/result"), {
+				method: "POST",
+				headers: { "content-type": "application/json" },
+				body: JSON.stringify({
+					cmdId,
+					...r
+				})
+			});
+		} catch {}
+	}
+	/** A brief visible pulse so the viewer always sees a collection happen. */
+	flash() {
+		const doc = globalThis.document;
+		if (!doc) return;
+		if (!this.indicator) {
+			const el = doc.createElement("div");
+			el.setAttribute("data-aywidget-indicator", this.viewerId || "1");
+			el.style.cssText = "position:fixed;right:14px;bottom:14px;width:12px;height:12px;border-radius:50%;background:#1f6feb;box-shadow:0 0 0 0 rgba(31,111,235,.6);z-index:2147483000;opacity:0;transition:opacity .15s;pointer-events:none";
+			(doc.body ?? doc.documentElement).appendChild(el);
+			this.indicator = el;
+		}
+		const el = this.indicator;
+		el.style.opacity = "1";
+		el.animate?.([{ boxShadow: "0 0 0 0 rgba(31,111,235,.6)" }, { boxShadow: "0 0 0 10px rgba(31,111,235,0)" }], { duration: 600 });
+		clearTimeout(el._t);
+		el._t = setTimeout(() => el.style.opacity = "0", 500);
+	}
+	stop() {
+		this.es?.close?.();
+		this.es = void 0;
+		this.indicator?.remove?.();
+		this.indicator = void 0;
+		this.started = false;
+	}
+};
+async function readSelection() {
+	const g = globalThis;
+	const sel = g.getSelection?.();
+	const text = sel ? String(sel) : "";
+	let html = "";
+	if (sel && sel.rangeCount) {
+		const div = g.document.createElement("div");
+		for (let i = 0; i < sel.rangeCount; i++) div.appendChild(sel.getRangeAt(i).cloneContents());
+		html = div.innerHTML;
+	}
+	return {
+		text,
+		html
+	};
+}
+async function readDom(args) {
+	const g = globalThis;
+	const selector = args?.selector;
+	if (!selector) throw new Error("dom read needs a --selector");
+	const nodes = args?.all ? [...g.document.querySelectorAll(selector)] : [g.document.querySelector(selector)].filter(Boolean);
+	return {
+		matches: nodes.length,
+		outerHTML: nodes.map((n) => String(n.outerHTML ?? ""))
+	};
+}
+/** window.AY_TERM_TOKEN → page `#k=` hash → localStorage["ay.localToken"]. */
+function discoverToken() {
+	const g = globalThis;
+	if (g.AY_TERM_TOKEN) return String(g.AY_TERM_TOKEN);
+	try {
+		const k = (g.location?.hash ?? "").slice(1).split("&").find((s) => s.startsWith("k="));
+		if (k) return decodeURIComponent(k.slice(2));
+		const stored = g.localStorage?.getItem("ay.localToken");
+		if (stored) return stored;
+	} catch {}
+	return "";
+}
+
+//#endregion
+export { AyWidget, AyWidget as default };
+//# sourceMappingURL=widget.js.map

package/dist/widgets.js

@@ -3,5 +3,6 @@ import "./channels-BiGUYTuz.js";
 import "./peer-B5JKF4BP.js";
 import { t as AyChannel } from "./browser-B3dOptjL.js";
 import { t as AyTerminal } from "./browser-BRMyG4JA.js";
+import { AyWidget } from "./widget.js";
 
-export { AyChannel, AyTerminal };
+export { AyChannel, AyTerminal, AyWidget };

package/dist/{ws-Dun8gGiV.js → ws-3prv2in5.js}

@@ -3,7 +3,7 @@ import "./globalPidIndex-D9DOSd-c.js";
 import "./messageLog-C-YIzhRj.js";
 import "./e2e-CEIdJGZ7.js";
 import "./configShared-9wVlbPyC.js";
-import { S as listRecords } from "./subcommands-DFr-5FOL.js";
+import { S as listRecords } from "./subcommands-BdBCxZVu.js";
 import "./webrtcLink-VQhWmKOw.js";
 import "./remotes-Bem6WIyU.js";
 import { i as getProvisionRoot } from "./workspaceConfig-B7HaQ-MI.js";
@@ -418,4 +418,4 @@ async function cmdWs(args) {
 
 //#endregion
 export { WS_JSON_SCHEMA, cmdWs, collectWorkspaces, isPathInside, loadProvision, workspaceStatus };
-//# sourceMappingURL=ws-Dun8gGiV.js.map
+//# sourceMappingURL=ws-3prv2in5.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-yes",
-  "version": "1.237.0",
+  "version": "1.238.0",
   "description": "A wrapper tool that automates interactions with various AI CLI tools by automatically handling common prompts and responses.",
   "keywords": [
     "ai",
@@ -94,6 +94,10 @@
       "types": "./ts/terminal/browser.ts",
       "import": "./dist/terminal.js"
     },
+    "./widget": {
+      "types": "./ts/widget/browser.ts",
+      "import": "./dist/widget.js"
+    },
     "./widgets": {
       "types": "./ts/widgets.ts",
       "import": "./dist/widgets.js"