agent-yes 1.232.0 → 1.233.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,8 +1,8 @@
1
- import { t as CLIS_CONFIG } from "./ts-Bb3CeS6-.js";
1
+ import { t as CLIS_CONFIG } from "./ts-DFQbSTC9.js";
2
2
 
3
3
  //#region ts/SUPPORTED_CLIS.ts
4
4
  const SUPPORTED_CLIS = Object.keys(CLIS_CONFIG);
5
5
 
6
6
  //#endregion
7
7
  export { SUPPORTED_CLIS as t };
8
- //# sourceMappingURL=SUPPORTED_CLIS-D6J7QvLL.js.map
8
+ //# sourceMappingURL=SUPPORTED_CLIS-RkOZNL1b.js.map
@@ -1,11 +1,11 @@
1
- import "./ts-Bb3CeS6-.js";
1
+ import "./ts-DFQbSTC9.js";
2
2
  import "./logger-CDIsZ-Pp.js";
3
- import "./versionChecker-SHk3Fuvm.js";
3
+ import "./versionChecker-B2jX7H2o.js";
4
4
  import "./todoAutomation-x6guaQXc.js";
5
5
  import "./JsonlStore-CWOA3aDH.js";
6
6
  import "./globalPidIndex-Ca4sTr1b.js";
7
7
  import "./pidStore-Hjba3K6Q.js";
8
8
  import "./messageLog-zVGWLX7w.js";
9
- import { t as SUPPORTED_CLIS } from "./SUPPORTED_CLIS-D6J7QvLL.js";
9
+ import { t as SUPPORTED_CLIS } from "./SUPPORTED_CLIS-RkOZNL1b.js";
10
10
 
11
11
  export { SUPPORTED_CLIS };
@@ -3,7 +3,7 @@ import "./globalPidIndex-Ca4sTr1b.js";
3
3
  import "./messageLog-zVGWLX7w.js";
4
4
  import "./e2e-CYlKpfxa.js";
5
5
  import "./configShared-BXz2vi4Q.js";
6
- import { N as resolveOne } from "./subcommands-CXCoOuN6.js";
6
+ import { N as resolveOne } from "./subcommands-BtMmBJnC.js";
7
7
  import "./webrtcLink-CEYNs0pt.js";
8
8
  import "./remotes-BM3Zm8Wh.js";
9
9
  import { a as startShare } from "./share-D4K0JnHg.js";
@@ -229,4 +229,4 @@ function transformEvent(rawEvent, agentId, forwarded) {
229
229
 
230
230
  //#endregion
231
231
  export { createScopedShare, listShares, revokeAllShares, revokeShare };
232
- //# sourceMappingURL=agentShare-CDMFg0Rj.js.map
232
+ //# sourceMappingURL=agentShare-CRCyd-8k.js.map
@@ -3,10 +3,10 @@ import "./globalPidIndex-Ca4sTr1b.js";
3
3
  import "./messageLog-zVGWLX7w.js";
4
4
  import "./e2e-CYlKpfxa.js";
5
5
  import "./configShared-BXz2vi4Q.js";
6
- import "./subcommands-CXCoOuN6.js";
6
+ import "./subcommands-BtMmBJnC.js";
7
7
  import "./webrtcLink-CEYNs0pt.js";
8
8
  import "./remotes-BM3Zm8Wh.js";
9
9
  import "./callbackCore-Me97qn68.js";
10
- import { i as loadOrCreateCallbackSecret, n as isCallbackRevoked, r as loadCallbackSecretReadOnly, t as cmdCallback } from "./callback-B1kcLI1k.js";
10
+ import { i as loadOrCreateCallbackSecret, n as isCallbackRevoked, r as loadCallbackSecretReadOnly, t as cmdCallback } from "./callback-uKj5PzZf.js";
11
11
 
12
12
  export { cmdCallback };
@@ -1,5 +1,5 @@
1
1
  import { t as agentYesHome } from "./agentYesHome-CtHb5b71.js";
2
- import { N as resolveOne } from "./subcommands-CXCoOuN6.js";
2
+ import { N as resolveOne } from "./subcommands-BtMmBJnC.js";
3
3
  import { a as mintCapability, o as parseExpires } from "./callbackCore-Me97qn68.js";
4
4
  import { randomBytes } from "node:crypto";
5
5
  import { mkdir, readFile, writeFile } from "node:fs/promises";
@@ -72,7 +72,7 @@ async function resolveBase(flag) {
72
72
  if (flag) return flag;
73
73
  if (process.env.AGENT_YES_CALLBACK_BASE) return process.env.AGENT_YES_CALLBACK_BASE;
74
74
  try {
75
- const { resolveLocalServeUrl } = await import("./serve-Bv_twI1k.js");
75
+ const { resolveLocalServeUrl } = await import("./serve-BIVtKYUa.js");
76
76
  const url = await resolveLocalServeUrl();
77
77
  if (url) return url;
78
78
  } catch {}
@@ -187,4 +187,4 @@ async function cmdCallback(rest) {
187
187
 
188
188
  //#endregion
189
189
  export { loadOrCreateCallbackSecret as i, isCallbackRevoked as n, loadCallbackSecretReadOnly as r, cmdCallback as t };
190
- //# sourceMappingURL=callback-B1kcLI1k.js.map
190
+ //# sourceMappingURL=callback-uKj5PzZf.js.map
@@ -467,19 +467,49 @@ async function cmdChPipe(cwd, args) {
467
467
  rl.close();
468
468
  return 0;
469
469
  }
470
+ /**
471
+ * The embed `<script>` snippet — a script (NOT an iframe) that loads the AyChannel
472
+ * browser lib and mounts the floating widget in the page, so the console's
473
+ * `frame-ancestors` CSP is irrelevant. Three modes trade off where the secret lives:
474
+ * baked in (`live`), injected at runtime (`placeholder`), or never present because
475
+ * the channel is derived from the (public) page URL (`from-url`) — the last is the
476
+ * safe default for a STATIC public page, since no token ever lands in the file.
477
+ */
478
+ function buildEmbedSnippet(host, topic, mode) {
479
+ const imp = ` import AyChannel from "https://${host}/w/channels.js";\n`;
480
+ if (mode.kind === "from-url") return `<!-- ay channel: ${topic} — channel derived from the page URL; no secret in this file -->\n<script type="module">\n${imp} AyChannel.fromTopic(location.href).then((c) => c.mount());\n<\/script>\n`;
481
+ if (mode.kind === "placeholder") return `<!-- ay channel: ${topic} — set window.AY_CH_LINK to the invite at runtime; do NOT commit the secret -->\n<script type="module">\n${imp} new AyChannel(window.AY_CH_LINK).mount();\n<\/script>\n`;
482
+ return `<!-- ay channel: ${topic} — this snippet contains a LIVE secret; anyone who reads it can join -->\n<script type="module">\n${imp} new AyChannel(${JSON.stringify(mode.link)}).mount();\n<\/script>\n`;
483
+ }
470
484
  async function cmdChEmbed(cwd, args) {
471
- const { flags, positional } = parseFlags(args, { host: "value" });
485
+ const { flags, positional } = parseFlags(args, {
486
+ host: "value",
487
+ placeholder: "bool",
488
+ "from-url": "bool"
489
+ });
472
490
  const topic = positional[0];
473
- if (!topic || positional.length > 1) throw new Error("usage: ay ch embed <topic> [--host <console-host>]");
491
+ if (!topic || positional.length > 1) throw new Error("usage: ay ch embed <topic> [--host H] [--placeholder | --from-url]");
492
+ if (flags.placeholder && flags["from-url"]) throw new Error("--placeholder and --from-url are mutually exclusive");
474
493
  const { entry } = await resolveChannel(await readRegistry(cwd), topic);
475
494
  if (!entry) throw new Error(`join "${topic}" before embedding: ay ch join <link>`);
476
- const consoleHost = typeof flags.host === "string" ? flags.host : "agent-yes.com";
477
- const link = formatChannelLink({
495
+ const host = typeof flags.host === "string" ? flags.host : "agent-yes.com";
496
+ const invite = formatChannelLink({
478
497
  sighost: entry.sighost,
479
498
  room: entry.room,
480
499
  s: entry.s
481
500
  });
482
- process.stdout.write(`<!-- ay channel: ${topic} anyone who can read this snippet can join -->\n<script type="module">\n import AyChannel from "https://${consoleHost}/w/channels.js";\n new AyChannel(${JSON.stringify(link)}).mount();\n<\/script>\n`);
501
+ const mode = flags["from-url"] ? { kind: "from-url" } : flags.placeholder ? { kind: "placeholder" } : {
502
+ kind: "live",
503
+ link: invite
504
+ };
505
+ process.stdout.write(buildEmbedSnippet(host, topic, mode));
506
+ if (mode.kind === "from-url") process.stderr.write("\n URL-derived: no secret in the snippet — the channel is computed from the page URL,\n so a committed/static file carries no token (ideal for static public pages like\n Cloudflare Pages). Anyone who opens the same URL joins — that IS the membership.\n");
507
+ else if (mode.kind === "placeholder") process.stderr.write(`
508
+ Placeholder: the invite is NOT in the snippet — set window.AY_CH_LINK at runtime
509
+ (server-rendered / env), so a committed file carries no secret. This needs a
510
+ runtime; on a STATIC host use --from-url instead. Invite to inject: ${invite}\n`);
511
+ else process.stderr.write("\n ⚠ This snippet embeds a LIVE channel secret (read+write). Anyone who can read the\n page source can join. Do NOT commit it to a public or deploy-bound file. For a\n static public page use --from-url (no secret in the file); for a server-rendered\n page use --placeholder. Prefer a dedicated random-secret channel you can abandon.\n");
512
+ process.stderr.write(` channels.js must load from https://${host}/w/channels.js — if it 404s (not yet on the\n CDN), self-host the bundle (lab/ui/cf/public/w/channels.js) and pass --host <origin>,\n pinning a version. The embed is a <script>, not an iframe.\n`);
483
513
  return 0;
484
514
  }
485
515
  /** The page bookmarklet: derive a channel from the page URL and mount the widget. */
@@ -499,7 +529,7 @@ async function cmdChBookmarklet(_cwd, args) {
499
529
  return 0;
500
530
  }
501
531
  function chHelp() {
502
- process.stdout.write("ay ch - local-first E2E channels for AI ↔ humans (per-cwd, no server storage)\n\n ay ch mk <topic> [--name N] [--role R] create a channel, print an invite link\n ay ch join <link> [--as <topic>] join a channel from an invite link\n ay ch ls [--json] list channels in this project (+message counts)\n ay ch rm <topic> delete the local replica (peers unaffected)\n ay ch send <topic> <text…> post a message\n ay ch read <topic> [-n N] [--json] print the thread (last N)\n ay ch head <topic> [-n N] first N messages\n ay ch tail <topic> [-n N] [-f] last N (96), -f to follow\n ay ch sync <topic> [--quiet] hold the WebRTC mesh: live send/receive (Ctrl-C to stop)\n ay ch pipe <topic> sync + bridge stdin→send and inbound→stdout\n ay ch embed <topic> [--host H] print an HTML snippet embedding a floating chat widget\n ay ch bookmarklet [--host H] print a bookmarklet: any page joins a channel by its URL\n\n URL-topic: 'ay ch mk <name> --topic <string>' derives the SAME channel a\n bookmarklet on that URL joins (topic = public membership)\n identity: --name defaults to $AY_CH_NAME/OS user; --role to agent (in an agent) or human\n storage: <cwd>/.agent-yes/ch-<id>.jsonl (a full CRDT replica; cwd-scoped)\n live: run 'ay ch sync <topic>' (foreground/backgrounded) to join the mesh; then\n 'ay ch send/tail' compose with it through the shared replica file — no daemon\n");
532
+ process.stdout.write("ay ch - local-first E2E channels for AI ↔ humans (per-cwd, no server storage)\n\n ay ch mk <topic> [--name N] [--role R] create a channel, print an invite link\n ay ch join <link> [--as <topic>] join a channel from an invite link\n ay ch ls [--json] list channels in this project (+message counts)\n ay ch rm <topic> delete the local replica (peers unaffected)\n ay ch send <topic> <text…> post a message\n ay ch read <topic> [-n N] [--json] print the thread (last N)\n ay ch head <topic> [-n N] first N messages\n ay ch tail <topic> [-n N] [-f] last N (96), -f to follow\n ay ch sync <topic> [--quiet] hold the WebRTC mesh: live send/receive (Ctrl-C to stop)\n ay ch pipe <topic> sync + bridge stdin→send and inbound→stdout\n ay ch embed <topic> [--host H] [--from-url|--placeholder] HTML snippet for a chat widget\n (--from-url keeps NO secret in the file — best for static pages)\n ay ch bookmarklet [--host H] print a bookmarklet: any page joins a channel by its URL\n\n URL-topic: 'ay ch mk <name> --topic <string>' derives the SAME channel a\n bookmarklet on that URL joins (topic = public membership)\n identity: --name defaults to $AY_CH_NAME/OS user; --role to agent (in an agent) or human\n storage: <cwd>/.agent-yes/ch-<id>.jsonl (a full CRDT replica; cwd-scoped)\n live: run 'ay ch sync <topic>' (foreground/backgrounded) to join the mesh; then\n 'ay ch send/tail' compose with it through the shared replica file — no daemon\n");
503
533
  return 0;
504
534
  }
505
535
  /** `ay ch <sub> …` dispatcher (called from runSubcommand). */
@@ -537,4 +567,4 @@ async function cmdCh(args) {
537
567
 
538
568
  //#endregion
539
569
  export { cmdCh };
540
- //# sourceMappingURL=channels-Boi4aNiY.js.map
570
+ //# sourceMappingURL=channels-Ddj0hWZB.js.map
package/dist/cli.js CHANGED
@@ -1,8 +1,8 @@
1
1
  #!/usr/bin/env bun
2
2
  import { t as invokedCliName } from "./invokedCli-uqM2YYA7.js";
3
3
  import { n as logger } from "./logger-CDIsZ-Pp.js";
4
- import { i as versionString, n as displayVersion, t as checkAndAutoUpdate } from "./versionChecker-SHk3Fuvm.js";
5
- import { n as getRustBinary } from "./rustBinary-D8_DgkiI.js";
4
+ import { i as versionString, n as displayVersion, t as checkAndAutoUpdate } from "./versionChecker-B2jX7H2o.js";
5
+ import { n as getRustBinary } from "./rustBinary-C1_q6UMV.js";
6
6
  import { argv } from "process";
7
7
  import { spawn } from "child_process";
8
8
  import ms from "ms";
@@ -285,7 +285,7 @@ function buildRustArgs(argv, cliFromScript, supportedClis) {
285
285
  const rawArg = process.argv[2];
286
286
  const managerCommands = !invokedCliName(process.argv);
287
287
  const isHelpFlag = rawArg === "-h" || rawArg === "--help";
288
- const { isSubcommand, runSubcommand, cmdHelp } = await import("./subcommands-CFC5HMmx.js");
288
+ const { isSubcommand, runSubcommand, cmdHelp } = await import("./subcommands-BGio-axk.js");
289
289
  if (isHelpFlag && process.argv.length === 3) {
290
290
  await cmdHelp(managerCommands);
291
291
  process.exit(0);
@@ -331,7 +331,7 @@ if (config.useRust) {
331
331
  }
332
332
  }
333
333
  if (rustBinary) {
334
- const { SUPPORTED_CLIS } = await import("./SUPPORTED_CLIS-BP1BBtWO.js");
334
+ const { SUPPORTED_CLIS } = await import("./SUPPORTED_CLIS-buOGuqV8.js");
335
335
  const rustArgs = buildRustArgs(process.argv, config.cli, SUPPORTED_CLIS);
336
336
  if (config.verbose) {
337
337
  console.log(`[rust] Using binary: ${rustBinary}`);
package/dist/index.js CHANGED
@@ -1,6 +1,6 @@
1
- import { a as hasTodoStore, c as AgentContext, i as answerAsk, n as agentYes, o as listAsks, r as config, s as listAsksForProject, t as CLIS_CONFIG } from "./ts-Bb3CeS6-.js";
1
+ import { a as hasTodoStore, c as AgentContext, i as answerAsk, n as agentYes, o as listAsks, r as config, s as listAsksForProject, t as CLIS_CONFIG } from "./ts-DFQbSTC9.js";
2
2
  import "./logger-CDIsZ-Pp.js";
3
- import "./versionChecker-SHk3Fuvm.js";
3
+ import "./versionChecker-B2jX7H2o.js";
4
4
  import { _ as isKnownKind, a as renderTree, b as statesOf, c as monitorHint, d as openStore, f as DONE_STATE, g as initialState, h as canTransition, i as renderDigest, l as CycleError, m as ORPHANED_STATE, o as unblockedTasks, p as LIFECYCLES, r as openBlockers, s as describeBlock, t as reconcileTodos, u as TodoStore, v as nextStates, x as removeControlCharacters, y as requiredGate } from "./todoAutomation-x6guaQXc.js";
5
5
  import "./JsonlStore-CWOA3aDH.js";
6
6
  import "./globalPidIndex-Ca4sTr1b.js";
@@ -3,7 +3,7 @@ import "./globalPidIndex-Ca4sTr1b.js";
3
3
  import "./messageLog-zVGWLX7w.js";
4
4
  import "./e2e-CYlKpfxa.js";
5
5
  import "./configShared-BXz2vi4Q.js";
6
- import { $ as daemonLockDir, A as renderLogTailLines, G as appendEvent, K as gcInboxes, Q as shouldStealLock, S as listRecords, X as liveWatchers, Y as listInboxParents, Z as readInbox, _ as isPidAlive, c as deriveLiveState, et as daemonLockOwnerPath, q as hostId, tt as notifyDir } from "./subcommands-CXCoOuN6.js";
6
+ import { $ as daemonLockDir, A as renderLogTailLines, G as appendEvent, K as gcInboxes, Q as shouldStealLock, S as listRecords, X as liveWatchers, Y as listInboxParents, Z as readInbox, _ as isPidAlive, c as deriveLiveState, et as daemonLockOwnerPath, q as hostId, tt as notifyDir } from "./subcommands-BtMmBJnC.js";
7
7
  import "./webrtcLink-CEYNs0pt.js";
8
8
  import "./remotes-BM3Zm8Wh.js";
9
9
  import { mkdir, readFile, rename, rm, stat, writeFile } from "fs/promises";
@@ -589,4 +589,4 @@ async function ensureDaemon() {
589
589
 
590
590
  //#endregion
591
591
  export { daemonStatus, ensureDaemon, requestDaemonStop, runDaemon };
592
- //# sourceMappingURL=notifyDaemon-BNCj9i2N.js.map
592
+ //# sourceMappingURL=notifyDaemon-mfrH4egL.js.map
@@ -1,4 +1,4 @@
1
- import { r as getInstalledPackage } from "./versionChecker-SHk3Fuvm.js";
1
+ import { r as getInstalledPackage } from "./versionChecker-B2jX7H2o.js";
2
2
  import { execFileSync } from "child_process";
3
3
  import { existsSync, mkdirSync, unlinkSync } from "fs";
4
4
  import { chmod, copyFile } from "fs/promises";
@@ -225,4 +225,4 @@ async function getRustBinary(options = {}) {
225
225
 
226
226
  //#endregion
227
227
  export { getRustBinary as n, findSpawnHiddenLauncher as t };
228
- //# sourceMappingURL=rustBinary-D8_DgkiI.js.map
228
+ //# sourceMappingURL=rustBinary-C1_q6UMV.js.map
@@ -1,12 +1,12 @@
1
- import "./ts-Bb3CeS6-.js";
1
+ import "./ts-DFQbSTC9.js";
2
2
  import "./logger-CDIsZ-Pp.js";
3
- import "./versionChecker-SHk3Fuvm.js";
3
+ import "./versionChecker-B2jX7H2o.js";
4
4
  import "./todoAutomation-x6guaQXc.js";
5
5
  import "./JsonlStore-CWOA3aDH.js";
6
6
  import "./globalPidIndex-Ca4sTr1b.js";
7
7
  import "./pidStore-Hjba3K6Q.js";
8
8
  import "./messageLog-zVGWLX7w.js";
9
- import { t as SUPPORTED_CLIS } from "./SUPPORTED_CLIS-D6J7QvLL.js";
9
+ import { t as SUPPORTED_CLIS } from "./SUPPORTED_CLIS-RkOZNL1b.js";
10
10
  import { d as resolveSpawnCwd } from "./workspaceConfig-DWLYPDdx.js";
11
11
  import { n as liveEnv, t as ensureNodeRuntime } from "./nodeRuntime-BF_kAOwO.js";
12
12
  import { createHash } from "node:crypto";
@@ -153,4 +153,4 @@ async function cmdSchedule(rest) {
153
153
 
154
154
  //#endregion
155
155
  export { cmdSchedule };
156
- //# sourceMappingURL=schedule-BVVQtiaS.js.map
156
+ //# sourceMappingURL=schedule-C2uGzgPW.js.map
@@ -1,7 +1,7 @@
1
- import { i as answerAsk, l as CLAUDE_SESSION_PIN_ENV, o as listAsks } from "./ts-Bb3CeS6-.js";
1
+ import { i as answerAsk, l as CLAUDE_SESSION_PIN_ENV, o as listAsks } from "./ts-DFQbSTC9.js";
2
2
  import "./logger-CDIsZ-Pp.js";
3
- import { r as getInstalledPackage } from "./versionChecker-SHk3Fuvm.js";
4
- import { t as findSpawnHiddenLauncher } from "./rustBinary-D8_DgkiI.js";
3
+ import { r as getInstalledPackage } from "./versionChecker-B2jX7H2o.js";
4
+ import { t as findSpawnHiddenLauncher } from "./rustBinary-C1_q6UMV.js";
5
5
  import { t as agentYesHome$1 } from "./agentYesHome-CtHb5b71.js";
6
6
  import { x as removeControlCharacters } from "./todoAutomation-x6guaQXc.js";
7
7
  import "./JsonlStore-CWOA3aDH.js";
@@ -11,12 +11,12 @@ import { r as recordInbox } from "./messageLog-zVGWLX7w.js";
11
11
  import { t as pgidForWrapper } from "./reaper-iQXyufgp.js";
12
12
  import "./e2e-CYlKpfxa.js";
13
13
  import "./configShared-BXz2vi4Q.js";
14
- import { t as SUPPORTED_CLIS } from "./SUPPORTED_CLIS-D6J7QvLL.js";
15
- import { A as renderLogTailLines, D as readPtysize, E as readNotes, J as isTransientLockMkdirError, M as renderRawLogLines, N as resolveOne, O as recentMessageEdges, R as snapshotStatus, S as listRecords, W as writeToIpc, b as isUserTyping, f as extractNeedsInput, j as renderRawLog, k as recentReadEdges, l as deriveLiveStatus, nt as TYPING_BADGE, o as controlCodeFromName, p as extractTaskCounts, u as extractBadges } from "./subcommands-CXCoOuN6.js";
14
+ import { t as SUPPORTED_CLIS } from "./SUPPORTED_CLIS-RkOZNL1b.js";
15
+ import { A as renderLogTailLines, D as readPtysize, E as readNotes, J as isTransientLockMkdirError, M as renderRawLogLines, N as resolveOne, O as recentMessageEdges, R as snapshotStatus, S as listRecords, W as writeToIpc, b as isUserTyping, f as extractNeedsInput, j as renderRawLog, k as recentReadEdges, l as deriveLiveStatus, nt as TYPING_BADGE, o as controlCodeFromName, p as extractTaskCounts, u as extractBadges } from "./subcommands-BtMmBJnC.js";
16
16
  import "./webrtcLink-CEYNs0pt.js";
17
17
  import "./remotes-BM3Zm8Wh.js";
18
18
  import { i as frameVisitorMessage, s as verifyCapability, t as MAX_CALLBACK_MSG_BYTES } from "./callbackCore-Me97qn68.js";
19
- import { n as isCallbackRevoked, r as loadCallbackSecretReadOnly } from "./callback-B1kcLI1k.js";
19
+ import { n as isCallbackRevoked, r as loadCallbackSecretReadOnly } from "./callback-uKj5PzZf.js";
20
20
  import { a as getSpawnHook, c as hasProvisionHook, d as resolveSpawnCwd, i as getProvisionRoot, l as hasSpawnHook, r as getProvisionHook, u as isProvisionAllowed } from "./workspaceConfig-DWLYPDdx.js";
21
21
  import { n as liveEnv, t as ensureNodeRuntime } from "./nodeRuntime-BF_kAOwO.js";
22
22
  import { r as spawnRejectionReason } from "./spawnGate-CRMR19Ql.js";
@@ -2038,7 +2038,7 @@ Options:
2038
2038
  }
2039
2039
  });
2040
2040
  if (req.method === "GET" && p === "/api/ws") {
2041
- const ws = await import("./ws-DDYVVQwl.js");
2041
+ const ws = await import("./ws-BfqIvOJs.js");
2042
2042
  try {
2043
2043
  await ws.loadProvision();
2044
2044
  } catch (e) {
@@ -2058,7 +2058,7 @@ Options:
2058
2058
  if (req.method === "GET" && p === "/api/ws/status") {
2059
2059
  const dirRaw = url.searchParams.get("path");
2060
2060
  if (!dirRaw) return new Response("missing ?path=<workspace dir>", { status: 400 });
2061
- const ws = await import("./ws-DDYVVQwl.js");
2061
+ const ws = await import("./ws-BfqIvOJs.js");
2062
2062
  let prov;
2063
2063
  try {
2064
2064
  prov = await ws.loadProvision();
@@ -2647,7 +2647,7 @@ Options:
2647
2647
  const perm = body.perm ?? "r";
2648
2648
  if (perm !== "r" && perm !== "rw") return new Response(`invalid perm ${perm} (want r or rw)`, { status: 400 });
2649
2649
  try {
2650
- const { createScopedShare } = await import("./agentShare-CDMFg0Rj.js");
2650
+ const { createScopedShare } = await import("./agentShare-CRCyd-8k.js");
2651
2651
  const share = await createScopedShare({
2652
2652
  agent: body.agent,
2653
2653
  perm,
@@ -2662,12 +2662,12 @@ Options:
2662
2662
  }
2663
2663
  }
2664
2664
  if (req.method === "GET" && p === "/api/shares") {
2665
- const { listShares } = await import("./agentShare-CDMFg0Rj.js");
2665
+ const { listShares } = await import("./agentShare-CRCyd-8k.js");
2666
2666
  return Response.json(listShares());
2667
2667
  }
2668
2668
  const revokeM = /^\/api\/share\/([^/]+)$/.exec(p);
2669
2669
  if (req.method === "DELETE" && revokeM) {
2670
- const { revokeShare } = await import("./agentShare-CDMFg0Rj.js");
2670
+ const { revokeShare } = await import("./agentShare-CRCyd-8k.js");
2671
2671
  const ok = revokeShare(decodeURIComponent(revokeM[1]));
2672
2672
  return new Response(ok ? "revoked" : "no such share", { status: ok ? 200 : 404 });
2673
2673
  }
@@ -2969,7 +2969,7 @@ Options:
2969
2969
  const shutdown = (resolve) => {
2970
2970
  if (heartbeat) clearInterval(heartbeat);
2971
2971
  closeShare?.();
2972
- import("./agentShare-CDMFg0Rj.js").then((m) => m.revokeAllShares()).catch(() => {});
2972
+ import("./agentShare-CRCyd-8k.js").then((m) => m.revokeAllShares()).catch(() => {});
2973
2973
  server?.stop();
2974
2974
  Promise.resolve(releaseHostLock?.()).catch(() => {}).then(resolve);
2975
2975
  };
@@ -2982,4 +2982,4 @@ Options:
2982
2982
 
2983
2983
  //#endregion
2984
2984
  export { cmdServe, resolveLocalServeUrl };
2985
- //# sourceMappingURL=serve-Bv_twI1k.js.map
2985
+ //# sourceMappingURL=serve-BIVtKYUa.js.map
@@ -32,7 +32,7 @@ async function cmdSetup(rest) {
32
32
  if (!existsSync(abs)) process.stderr.write(` note: that directory doesn't exist yet — create it, or agents spawned there will fail\n`);
33
33
  if (noShare) return 0;
34
34
  process.stdout.write(`\nsharing this machine to agent-yes.com…\n`);
35
- const { cmdServe } = await import("./serve-Bv_twI1k.js");
35
+ const { cmdServe } = await import("./serve-BIVtKYUa.js");
36
36
  return cmdServe([
37
37
  "install",
38
38
  "--share",
@@ -42,4 +42,4 @@ async function cmdSetup(rest) {
42
42
 
43
43
  //#endregion
44
44
  export { cmdSetup };
45
- //# sourceMappingURL=setup-BmoiDPZn.js.map
45
+ //# sourceMappingURL=setup-QTTCy8Mg.js.map
@@ -3,7 +3,7 @@ import "./globalPidIndex-Ca4sTr1b.js";
3
3
  import "./messageLog-zVGWLX7w.js";
4
4
  import "./e2e-CYlKpfxa.js";
5
5
  import "./configShared-BXz2vi4Q.js";
6
- import { A as renderLogTailLines, B as stopTipForCli, C as matchKeyword, D as readPtysize, E as readNotes, F as resolveResumeArgs, H as waitForLogQuiet, I as restartHintLines, L as runSubcommand, M as renderRawLogLines, N as resolveOne, O as recentMessageEdges, P as resolveReadWindow, R as snapshotStatus, S as listRecords, T as readAgentPtysize, U as writeKeysPaced, V as submitAndConfirm, W as writeToIpc, _ as isPidAlive, a as cmdHelp, b as isUserTyping, c as deriveLiveState, d as extractMenu, f as extractNeedsInput, g as isExitRequest, h as isAgentStuck, i as backoffWhileTyping, j as renderRawLog, k as recentReadEdges, l as deriveLiveStatus, m as finalizedLines, n as READ_PAGE_DEFAULT, o as controlCodeFromName, p as extractTaskCounts, r as TYPING_WINDOW_MS, s as cursorAbs, t as GRACEFUL_EXIT_COMMANDS, u as extractBadges, v as isSlashCommand, w as menuSelectKeys, x as lastStdinAt, y as isSubcommand, z as stdinActivityPath } from "./subcommands-CXCoOuN6.js";
6
+ import { A as renderLogTailLines, B as stopTipForCli, C as matchKeyword, D as readPtysize, E as readNotes, F as resolveResumeArgs, H as waitForLogQuiet, I as restartHintLines, L as runSubcommand, M as renderRawLogLines, N as resolveOne, O as recentMessageEdges, P as resolveReadWindow, R as snapshotStatus, S as listRecords, T as readAgentPtysize, U as writeKeysPaced, V as submitAndConfirm, W as writeToIpc, _ as isPidAlive, a as cmdHelp, b as isUserTyping, c as deriveLiveState, d as extractMenu, f as extractNeedsInput, g as isExitRequest, h as isAgentStuck, i as backoffWhileTyping, j as renderRawLog, k as recentReadEdges, l as deriveLiveStatus, m as finalizedLines, n as READ_PAGE_DEFAULT, o as controlCodeFromName, p as extractTaskCounts, r as TYPING_WINDOW_MS, s as cursorAbs, t as GRACEFUL_EXIT_COMMANDS, u as extractBadges, v as isSlashCommand, w as menuSelectKeys, x as lastStdinAt, y as isSubcommand, z as stdinActivityPath } from "./subcommands-BtMmBJnC.js";
7
7
  import "./webrtcLink-CEYNs0pt.js";
8
8
  import "./remotes-BM3Zm8Wh.js";
9
9
 
@@ -1246,23 +1246,23 @@ async function runSubcommand(argv) {
1246
1246
  }
1247
1247
  case "ch":
1248
1248
  case "channels": {
1249
- const { cmdCh } = await import("./channels-Boi4aNiY.js");
1249
+ const { cmdCh } = await import("./channels-Ddj0hWZB.js");
1250
1250
  return cmdCh(rest);
1251
1251
  }
1252
1252
  case "serve": {
1253
- const { cmdServe } = await import("./serve-Bv_twI1k.js");
1253
+ const { cmdServe } = await import("./serve-BIVtKYUa.js");
1254
1254
  return cmdServe(rest);
1255
1255
  }
1256
1256
  case "setup": {
1257
- const { cmdSetup } = await import("./setup-BmoiDPZn.js");
1257
+ const { cmdSetup } = await import("./setup-QTTCy8Mg.js");
1258
1258
  return cmdSetup(rest);
1259
1259
  }
1260
1260
  case "ws": {
1261
- const { cmdWs } = await import("./ws-DDYVVQwl.js");
1261
+ const { cmdWs } = await import("./ws-BfqIvOJs.js");
1262
1262
  return cmdWs(rest);
1263
1263
  }
1264
1264
  case "schedule": {
1265
- const { cmdSchedule } = await import("./schedule-BVVQtiaS.js");
1265
+ const { cmdSchedule } = await import("./schedule-C2uGzgPW.js");
1266
1266
  return cmdSchedule(rest);
1267
1267
  }
1268
1268
  case "remote": {
@@ -1274,7 +1274,7 @@ async function runSubcommand(argv) {
1274
1274
  return cmdExpose(rest);
1275
1275
  }
1276
1276
  case "callback": {
1277
- const { cmdCallback } = await import("./callback-sBpq-n_6.js");
1277
+ const { cmdCallback } = await import("./callback-l6t5RRxK.js");
1278
1278
  return cmdCallback(rest);
1279
1279
  }
1280
1280
  case "reap":
@@ -4312,7 +4312,7 @@ async function cmdNotify(rest) {
4312
4312
  }
4313
4313
  const ensure = async () => {
4314
4314
  if (!argv["ensure-daemon"]) return;
4315
- const { ensureDaemon } = await import("./notifyDaemon-BNCj9i2N.js");
4315
+ const { ensureDaemon } = await import("./notifyDaemon-mfrH4egL.js");
4316
4316
  await ensureDaemon().catch(() => null);
4317
4317
  };
4318
4318
  await heartbeatWatcher(parent, selfStartedAt);
@@ -4386,7 +4386,7 @@ async function cmdNotifyCursor(args) {
4386
4386
  }
4387
4387
  async function cmdNotifyd(rest) {
4388
4388
  const sub = rest[0] ?? "status";
4389
- const daemon = await import("./notifyDaemon-BNCj9i2N.js");
4389
+ const daemon = await import("./notifyDaemon-mfrH4egL.js");
4390
4390
  switch (sub) {
4391
4391
  case "run": return daemon.runDaemon();
4392
4392
  case "once": return daemon.runDaemon({ once: true });
@@ -4413,4 +4413,4 @@ async function cmdNotifyd(rest) {
4413
4413
 
4414
4414
  //#endregion
4415
4415
  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 };
4416
- //# sourceMappingURL=subcommands-CXCoOuN6.js.map
4416
+ //# sourceMappingURL=subcommands-BtMmBJnC.js.map
@@ -1,5 +1,5 @@
1
1
  import { n as logger, t as addTransport } from "./logger-CDIsZ-Pp.js";
2
- import { r as getInstalledPackage } from "./versionChecker-SHk3Fuvm.js";
2
+ import { r as getInstalledPackage } from "./versionChecker-B2jX7H2o.js";
3
3
  import { t as agentYesHome } from "./agentYesHome-CtHb5b71.js";
4
4
  import { d as openStore, p as LIFECYCLES, x as removeControlCharacters } from "./todoAutomation-x6guaQXc.js";
5
5
  import { i as shouldUseLock, r as releaseLock, t as acquireLock } from "./runningLock-BFk3Mo8K.js";
@@ -2044,4 +2044,4 @@ function sleep(ms) {
2044
2044
 
2045
2045
  //#endregion
2046
2046
  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 };
2047
- //# sourceMappingURL=ts-Bb3CeS6-.js.map
2047
+ //# sourceMappingURL=ts-DFQbSTC9.js.map
@@ -7,7 +7,7 @@ import { fileURLToPath } from "url";
7
7
 
8
8
  //#region package.json
9
9
  var name = "agent-yes";
10
- var version = "1.232.0";
10
+ var version = "1.233.0";
11
11
 
12
12
  //#endregion
13
13
  //#region ts/versionChecker.ts
@@ -215,4 +215,4 @@ async function displayVersion() {
215
215
 
216
216
  //#endregion
217
217
  export { versionString as i, displayVersion as n, getInstalledPackage as r, checkAndAutoUpdate as t };
218
- //# sourceMappingURL=versionChecker-SHk3Fuvm.js.map
218
+ //# sourceMappingURL=versionChecker-B2jX7H2o.js.map
@@ -3,7 +3,7 @@ import "./globalPidIndex-Ca4sTr1b.js";
3
3
  import "./messageLog-zVGWLX7w.js";
4
4
  import "./e2e-CYlKpfxa.js";
5
5
  import "./configShared-BXz2vi4Q.js";
6
- import { S as listRecords } from "./subcommands-CXCoOuN6.js";
6
+ import { S as listRecords } from "./subcommands-BtMmBJnC.js";
7
7
  import "./webrtcLink-CEYNs0pt.js";
8
8
  import "./remotes-BM3Zm8Wh.js";
9
9
  import { i as getProvisionRoot } from "./workspaceConfig-DWLYPDdx.js";
@@ -418,4 +418,4 @@ async function cmdWs(args) {
418
418
 
419
419
  //#endregion
420
420
  export { WS_JSON_SCHEMA, cmdWs, collectWorkspaces, isPathInside, loadProvision, workspaceStatus };
421
- //# sourceMappingURL=ws-DDYVVQwl.js.map
421
+ //# sourceMappingURL=ws-BfqIvOJs.js.map
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "agent-yes",
3
- "version": "1.232.0",
3
+ "version": "1.233.0",
4
4
  "description": "A wrapper tool that automates interactions with various AI CLI tools by automatically handling common prompts and responses.",
5
5
  "keywords": [
6
6
  "ai",
@@ -4,6 +4,7 @@ import path from "path";
4
4
  import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
5
5
  import {
6
6
  buildBookmarklet,
7
+ buildEmbedSnippet,
7
8
  cmdCh,
8
9
  defaultName,
9
10
  defaultRole,
@@ -65,7 +66,9 @@ describe("formatMessage", () => {
65
66
  });
66
67
  it("shows (deleted) and reaction counts", () => {
67
68
  expect(formatMessage({ ...base, deleted: true, text: "" })).toContain("(deleted)");
68
- expect(formatMessage({ ...base, reactions: [{ emoji: "👍", by: ["a", "b"] }] })).toContain("👍2");
69
+ expect(formatMessage({ ...base, reactions: [{ emoji: "👍", by: ["a", "b"] }] })).toContain(
70
+ "👍2",
71
+ );
69
72
  expect(formatMessage({ ...base, reactions: [{ emoji: "🎉", by: ["a"] }] })).toContain("🎉");
70
73
  });
71
74
  });
@@ -168,6 +171,39 @@ describe("ay ch CLI (local-only)", () => {
168
171
  expect(bm).toContain("location.href"); // default topic = full page URL
169
172
  });
170
173
 
174
+ it("embed modes trade off where the secret lives", async () => {
175
+ await capture(() => cmdCh(["mk", "pub"]));
176
+ // default (live): the secret IS in the file
177
+ expect((await capture(() => cmdCh(["embed", "pub"]))).out).toContain("e1.");
178
+ // --placeholder: no secret; runtime-injected global
179
+ const ph = (await capture(() => cmdCh(["embed", "pub", "--placeholder"]))).out;
180
+ expect(ph).not.toContain("e1.");
181
+ expect(ph).toContain("window.AY_CH_LINK");
182
+ // --from-url: no secret; derived from the page URL (safe for static pages)
183
+ const fu = (await capture(() => cmdCh(["embed", "pub", "--from-url"]))).out;
184
+ expect(fu).not.toContain("e1.");
185
+ expect(fu).toContain("AyChannel.fromTopic(location.href)");
186
+ // the two secret-less modes are mutually exclusive
187
+ await expect(cmdCh(["embed", "pub", "--from-url", "--placeholder"])).rejects.toThrow(
188
+ /mutually/,
189
+ );
190
+ });
191
+
192
+ it("buildEmbedSnippet: always a <script> (never an iframe), across modes", () => {
193
+ const live = buildEmbedSnippet("agent-yes.com", "t", {
194
+ kind: "live",
195
+ link: "ay://ch/h/r#e1.dead",
196
+ });
197
+ expect(live).toContain("<script");
198
+ expect(live).not.toContain("<iframe");
199
+ expect(live).toContain("ay://ch/h/r#e1.dead");
200
+ const fu = buildEmbedSnippet("self.example", "t", { kind: "from-url" });
201
+ expect(fu).toContain("self.example/w/channels.js");
202
+ expect(fu).toContain("fromTopic(location.href)");
203
+ expect(fu).not.toContain("e1.");
204
+ expect(buildEmbedSnippet("h", "t", { kind: "placeholder" })).toContain("window.AY_CH_LINK");
205
+ });
206
+
171
207
  it("prints help for no subcommand and rejects unknown ones", async () => {
172
208
  expect((await capture(() => cmdCh([]))).out).toContain("ay ch -");
173
209
  const bad = await capture(() => cmdCh(["frobnicate"]));
package/ts/channels.ts CHANGED
@@ -541,26 +541,94 @@ async function cmdChPipe(cwd: string, args: string[]): Promise<number> {
541
541
  return 0;
542
542
  }
543
543
 
544
+ export type EmbedMode =
545
+ | { kind: "live"; link: string } // the invite (with secret) is baked into the file
546
+ | { kind: "placeholder" } // page injects window.AY_CH_LINK at runtime (server-rendered)
547
+ | { kind: "from-url" }; // channel derived from the page URL — NO secret in the file
548
+
549
+ /**
550
+ * The embed `<script>` snippet — a script (NOT an iframe) that loads the AyChannel
551
+ * browser lib and mounts the floating widget in the page, so the console's
552
+ * `frame-ancestors` CSP is irrelevant. Three modes trade off where the secret lives:
553
+ * baked in (`live`), injected at runtime (`placeholder`), or never present because
554
+ * the channel is derived from the (public) page URL (`from-url`) — the last is the
555
+ * safe default for a STATIC public page, since no token ever lands in the file.
556
+ */
557
+ export function buildEmbedSnippet(host: string, topic: string, mode: EmbedMode): string {
558
+ const imp = ` import AyChannel from "https://${host}/w/channels.js";\n`;
559
+ if (mode.kind === "from-url") {
560
+ return (
561
+ `<!-- ay channel: ${topic} — channel derived from the page URL; no secret in this file -->\n` +
562
+ `<script type="module">\n${imp}` +
563
+ ` AyChannel.fromTopic(location.href).then((c) => c.mount());\n` +
564
+ `</script>\n`
565
+ );
566
+ }
567
+ if (mode.kind === "placeholder") {
568
+ return (
569
+ `<!-- ay channel: ${topic} — set window.AY_CH_LINK to the invite at runtime; do NOT commit the secret -->\n` +
570
+ `<script type="module">\n${imp}` +
571
+ ` new AyChannel(window.AY_CH_LINK).mount();\n` +
572
+ `</script>\n`
573
+ );
574
+ }
575
+ return (
576
+ `<!-- ay channel: ${topic} — this snippet contains a LIVE secret; anyone who reads it can join -->\n` +
577
+ `<script type="module">\n${imp}` +
578
+ ` new AyChannel(${JSON.stringify(mode.link)}).mount();\n` +
579
+ `</script>\n`
580
+ );
581
+ }
582
+
544
583
  async function cmdChEmbed(cwd: string, args: string[]): Promise<number> {
545
- const { flags, positional } = parseFlags(args, { host: "value" });
584
+ const { flags, positional } = parseFlags(args, {
585
+ host: "value",
586
+ placeholder: "bool",
587
+ "from-url": "bool",
588
+ });
546
589
  const topic = positional[0];
547
590
  if (!topic || positional.length > 1)
548
- throw new Error("usage: ay ch embed <topic> [--host <console-host>]");
591
+ throw new Error("usage: ay ch embed <topic> [--host H] [--placeholder | --from-url]");
592
+ if (flags.placeholder && flags["from-url"])
593
+ throw new Error("--placeholder and --from-url are mutually exclusive");
549
594
  const reg = await readRegistry(cwd);
550
595
  const { entry } = await resolveChannel(reg, topic);
551
596
  if (!entry) throw new Error(`join "${topic}" before embedding: ay ch join <link>`);
552
- const consoleHost = typeof flags.host === "string" ? flags.host : "agent-yes.com";
553
- const link = formatChannelLink({ sighost: entry.sighost, room: entry.room, s: entry.s });
554
- // A self-contained snippet: loads the AyChannel browser lib and mounts the
555
- // floating chat widget. Anyone who can read the page source holds the secret S
556
- // and can therefore join — that IS the channel's membership model (secret =
557
- // access), so only embed on a page whose audience you mean to let in.
558
- process.stdout.write(
559
- `<!-- ay channel: ${topic} — anyone who can read this snippet can join -->\n` +
560
- `<script type="module">\n` +
561
- ` import AyChannel from "https://${consoleHost}/w/channels.js";\n` +
562
- ` new AyChannel(${JSON.stringify(link)}).mount();\n` +
563
- `</script>\n`,
597
+ const host = typeof flags.host === "string" ? flags.host : "agent-yes.com";
598
+ const invite = formatChannelLink({ sighost: entry.sighost, room: entry.room, s: entry.s });
599
+ const mode: EmbedMode = flags["from-url"]
600
+ ? { kind: "from-url" }
601
+ : flags.placeholder
602
+ ? { kind: "placeholder" }
603
+ : { kind: "live", link: invite };
604
+
605
+ // stdout: only the snippet (safe to pipe/paste). stderr: the guidance.
606
+ process.stdout.write(buildEmbedSnippet(host, topic, mode));
607
+
608
+ if (mode.kind === "from-url") {
609
+ process.stderr.write(
610
+ `\n URL-derived: no secret in the snippet — the channel is computed from the page URL,\n` +
611
+ ` so a committed/static file carries no token (ideal for static public pages like\n` +
612
+ ` Cloudflare Pages). Anyone who opens the same URL joins — that IS the membership.\n`,
613
+ );
614
+ } else if (mode.kind === "placeholder") {
615
+ process.stderr.write(
616
+ `\n Placeholder: the invite is NOT in the snippet — set window.AY_CH_LINK at runtime\n` +
617
+ ` (server-rendered / env), so a committed file carries no secret. This needs a\n` +
618
+ ` runtime; on a STATIC host use --from-url instead. Invite to inject: ${invite}\n`,
619
+ );
620
+ } else {
621
+ process.stderr.write(
622
+ `\n ⚠ This snippet embeds a LIVE channel secret (read+write). Anyone who can read the\n` +
623
+ ` page source can join. Do NOT commit it to a public or deploy-bound file. For a\n` +
624
+ ` static public page use --from-url (no secret in the file); for a server-rendered\n` +
625
+ ` page use --placeholder. Prefer a dedicated random-secret channel you can abandon.\n`,
626
+ );
627
+ }
628
+ process.stderr.write(
629
+ ` channels.js must load from https://${host}/w/channels.js — if it 404s (not yet on the\n` +
630
+ ` CDN), self-host the bundle (lab/ui/cf/public/w/channels.js) and pass --host <origin>,\n` +
631
+ ` pinning a version. The embed is a <script>, not an iframe.\n`,
564
632
  );
565
633
  return 0;
566
634
  }
@@ -611,7 +679,8 @@ function chHelp(): number {
611
679
  ` ay ch tail <topic> [-n N] [-f] last N (96), -f to follow\n` +
612
680
  ` ay ch sync <topic> [--quiet] hold the WebRTC mesh: live send/receive (Ctrl-C to stop)\n` +
613
681
  ` ay ch pipe <topic> sync + bridge stdin→send and inbound→stdout\n` +
614
- ` ay ch embed <topic> [--host H] print an HTML snippet embedding a floating chat widget\n` +
682
+ ` ay ch embed <topic> [--host H] [--from-url|--placeholder] HTML snippet for a chat widget\n` +
683
+ ` (--from-url keeps NO secret in the file — best for static pages)\n` +
615
684
  ` ay ch bookmarklet [--host H] print a bookmarklet: any page joins a channel by its URL\n` +
616
685
  `\n` +
617
686
  ` URL-topic: 'ay ch mk <name> --topic <string>' derives the SAME channel a\n` +