takomi 2.1.29 → 2.1.31

package/.pi/agents/coder.md

@@ -42,6 +42,12 @@ If scope is unclear, ask a focused question instead of guessing.
 - handle errors and edge cases deliberately
 - avoid broad refactors unless requested or required
 
+## Tool-Use Safety
+- Keep `bash` commands short; use them for filesystem operations, running scripts, inspections, and verification.
+- Do not embed large generated files or long scripts directly in `bash` heredocs.
+- Use `write` for large files, or `write` a small generator script to disk and then run it.
+- If a command fails with `ENAMETOOLONG`, stop using the oversized inline command and switch to file-based writes or a written script.
+
 ## Phase 4: Verification
 After edits, run the strongest practical checks for the repo.
 For TypeScript/TSX work, prefer `npx tsc --noEmit` or the project equivalent.

package/.pi/agents/orchestrator.md

@@ -90,6 +90,22 @@ Task packets should be self-contained enough for a subagent to execute without g
 
 Keep human-readable markdown meaningful; keep JSON as tracking/continuity metadata.
 
+### Tool-Use Safety for Authored Plans
+- Do not pack large markdown plans, task packets, or generator scripts into one oversized `bash` command.
+- Prefer direct markdown authorship through the appropriate file-writing path, then register the same content with `takomi_board`.
+- If repeated files are needed, write a small generator script to disk first and run it with a short shell command.
+- If `ENAMETOOLONG` occurs, switch immediately to file-based writes or a written generator script instead of retrying the inline command.
+
+### Stage Expansion Quality Gate
+Before calling `takomi_board expand_stage`:
+- Write or provide full `taskMarkdown` for every expanded task.
+- Ensure each task has real Scope, Definition of Done, Expected Artifacts, Dependencies, and Verification/Review checkpoint.
+- Include exact prime-agent context paths and relevant FR/mockup/design docs.
+- For Build, decompose by implementation slice and FR coverage, not just broad labels like “school workflows.”
+- If a detailed subagent prompt is needed, the task packet should contain the same level of detail before launch.
+- Do not leave generated task files with `Scope: None specified`, `Definition Of Done: None specified`, or `Expected Artifacts: None specified`.
+- If `takomi_board` produced generic task packets, immediately repair them with detailed markdown before dispatching more work.
+
 ## Phase 4: Delegation
 When delegating:
 - send self-contained task instructions

package/.pi/extensions/notify-sound/index.ts

@@ -1,262 +1,262 @@
-import type { ExtensionAPI, ExtensionCommandContext, ExtensionContext } from "@mariozechner/pi-coding-agent";
-import { mkdir, readFile, writeFile } from "node:fs/promises";
-import { dirname, join } from "node:path";
-import { homedir, platform } from "node:os";
-import { spawn } from "node:child_process";
-
-type NotifySoundConfig = {
-  enabled: boolean;
-};
-
-type NotifyMethod = "auto" | "wav";
-
-const GLOBAL_NOTIFY_DIR = join(homedir(), ".pi", "agent", "notify-sound");
-const CONFIG_PATH = join(GLOBAL_NOTIFY_DIR, "notify-sound.json");
-const WAV_PATH = join(GLOBAL_NOTIFY_DIR, "notify-sound.wav");
-const PS1_PATH = join(GLOBAL_NOTIFY_DIR, "notify-sound.ps1");
-const VBS_PATH = join(GLOBAL_NOTIFY_DIR, "notify-sound.vbs");
-const STALE_AGENT_START_MS = 24 * 60 * 60 * 1000;
-
-let config: NotifySoundConfig = { enabled: true };
-let lastAgentStartedAt = 0;
-
-export default async function notifySoundExtension(pi: ExtensionAPI) {
-  await loadConfig();
-  await ensureTuneWav();
-
-  pi.on("session_start", async (_event, ctx) => {
-    updateStatus(ctx);
-  });
-
-  pi.on("agent_start", async () => {
-    lastAgentStartedAt = Date.now();
-  });
-
-  pi.on("agent_end", async (_event, ctx) => {
-    updateStatus(ctx);
-
-    if (!config.enabled) return;
-    if (!lastAgentStartedAt) return;
-    if (Date.now() - lastAgentStartedAt > STALE_AGENT_START_MS) return;
-
-    playCompletionTune();
-  });
-
-  const command = {
-    description: "Toggle or test the agent completion tune notification",
-    getArgumentCompletions: (argumentPrefix: string) => {
-      const token = argumentPrefix.trim().toLowerCase();
-      return [
-        { value: "status", label: "status", description: "Show whether the completion tune is on" },
-        { value: "test", label: "test", description: "Play the completion tune" },
-        { value: "test wav", label: "test wav", description: "Play the generated WAV completion tune" },
-        { value: "on", label: "on", description: "Enable the completion tune" },
-        { value: "off", label: "off", description: "Disable the completion tune" },
-        { value: "toggle", label: "toggle", description: "Toggle the completion tune" },
-      ].filter((completion) => !token || completion.value.startsWith(token));
-    },
-    handler: async (args: string, ctx: ExtensionCommandContext) => {
-      const action = args.trim().toLowerCase() || "toggle";
-
-      if (action === "test") {
-        playCompletionTune("wav");
-        ctx.ui.notify("Played completion tune using WAV mode. This is the default reliable Windows path.", "info");
-        return;
-      }
-
-      if (action === "test wav") {
-        playCompletionTune("wav");
-        ctx.ui.notify("Played completion tune using WAV mode.", "info");
-        return;
-      }
-
-      if (action.startsWith("test ")) {
-        ctx.ui.notify("Usage: /notify test", "warning");
-        return;
-      }
-
-      if (action === "status") {
-        updateStatus(ctx);
-        ctx.ui.notify(`Completion tune is ${config.enabled ? "ON" : "OFF"}.`, "info");
-        return;
-      }
-
-      if (action === "on") {
-        await setEnabled(true, ctx);
-        return;
-      }
-
-      if (action === "off") {
-        await setEnabled(false, ctx);
-        return;
-      }
-
-      if (action === "toggle") {
-        await setEnabled(!config.enabled, ctx);
-        return;
-      }
-
-      ctx.ui.notify("Usage: /notify [test|status|on|off|toggle]", "warning");
-    },
-  };
-
-  pi.registerCommand("notify-sound", command);
-  pi.registerCommand("notify", {
-    ...command,
-    description: "Alias for /notify-sound",
-  });
-}
-
-async function loadConfig(): Promise<void> {
-  try {
-    const raw = await readFile(CONFIG_PATH, "utf8");
-    const parsed = JSON.parse(raw) as Partial<NotifySoundConfig>;
-    config = { enabled: parsed.enabled !== false };
-  } catch {
-    config = { enabled: true };
-    await saveConfig();
-  }
-}
-
-async function saveConfig(): Promise<void> {
-  await mkdir(dirname(CONFIG_PATH), { recursive: true });
-  await writeFile(CONFIG_PATH, `${JSON.stringify(config, null, 2)}\n`, "utf8");
-}
-
-async function setEnabled(enabled: boolean, ctx: ExtensionContext): Promise<void> {
-  config.enabled = enabled;
-  await saveConfig();
-  updateStatus(ctx);
-  ctx.ui.notify(`Completion tune ${enabled ? "enabled" : "disabled"}.`, "info");
-}
-
-async function ensureTuneWav(): Promise<void> {
-  await mkdir(dirname(WAV_PATH), { recursive: true });
-  await writeFile(WAV_PATH, createTuneWav(), "binary");
-  const wav = WAV_PATH.replace(/'/g, "''");
-  await writeFile(PS1_PATH, [
-    "$ErrorActionPreference = 'SilentlyContinue'",
-    `if (Test-Path '${wav}') {`,
-    `  $p = New-Object System.Media.SoundPlayer '${wav}'`,
-    "  $p.Load()",
-    "  $p.PlaySync()",
-    "}",
-    "[System.Media.SystemSounds]::Asterisk.Play()",
-    "Start-Sleep -Milliseconds 250",
-    "",
-  ].join("\n"), "utf8");
-  const ps1 = PS1_PATH.replace(/"/g, "\"\"");
-  await writeFile(VBS_PATH, [
-    "Set shell = CreateObject(\"WScript.Shell\")",
-    `shell.Run "powershell.exe -NoProfile -ExecutionPolicy Bypass -File ""${ps1}""", 0, False`,
-    "",
-  ].join("\r\n"), "utf8");
-}
-
-function createTuneWav(): Buffer {
-  const sampleRate = 44100;
-  const notes = [
-    [659, 0.11],
-    [784, 0.11],
-    [988, 0.15],
-    [1319, 0.21],
-    [1175, 0.12],
-    [1319, 0.26],
-  ];
-  const gapSeconds = 0.035;
-  const samples: number[] = [];
-
-  for (const [freq, seconds] of notes) {
-    const count = Math.floor(sampleRate * seconds);
-    for (let i = 0; i < count; i++) {
-      const t = i / sampleRate;
-      const fadeIn = Math.min(1, i / 120);
-      const fadeOut = Math.min(1, (count - i) / 300);
-      const env = Math.min(fadeIn, fadeOut) * 0.28;
-      samples.push(Math.sin(2 * Math.PI * freq * t) * env);
-    }
-    for (let i = 0; i < Math.floor(sampleRate * gapSeconds); i++) samples.push(0);
-  }
-
-  const dataSize = samples.length * 2;
-  const buffer = Buffer.alloc(44 + dataSize);
-  buffer.write("RIFF", 0);
-  buffer.writeUInt32LE(36 + dataSize, 4);
-  buffer.write("WAVE", 8);
-  buffer.write("fmt ", 12);
-  buffer.writeUInt32LE(16, 16);
-  buffer.writeUInt16LE(1, 20);
-  buffer.writeUInt16LE(1, 22);
-  buffer.writeUInt32LE(sampleRate, 24);
-  buffer.writeUInt32LE(sampleRate * 2, 28);
-  buffer.writeUInt16LE(2, 32);
-  buffer.writeUInt16LE(16, 34);
-  buffer.write("data", 36);
-  buffer.writeUInt32LE(dataSize, 40);
-
-  let offset = 44;
-  for (const sample of samples) {
-    const value = Math.max(-1, Math.min(1, sample));
-    buffer.writeInt16LE(Math.round(value * 32767), offset);
-    offset += 2;
-  }
-  return buffer;
-}
-
-function updateStatus(ctx: ExtensionContext): void {
-  if (!ctx.hasUI) return;
-  ctx.ui.setStatus("notify-sound", ctx.ui.theme.fg("dim", `tune:${config.enabled ? "on" : "off"}`));
-}
-
-function playCompletionTune(method: NotifyMethod = "auto"): void {
-  const os = platform();
-
-  if (os === "win32") {
-    playWindowsTune(method);
-    return;
-  }
-
-  if (os === "darwin") {
-    runDetached("osascript", ["-e", "beep 1", "-e", "delay 0.12", "-e", "beep 1", "-e", "delay 0.12", "-e", "beep 2"]);
-    return;
-  }
-
-  playLinuxTune();
-}
-
-function playWindowsTune(method: NotifyMethod): void {
-  // Windows uses the generated WAV path because Console.Beep, system sounds,
-  // and terminal bells are silent on many modern Windows machines.
-  playWindowsWav();
-}
-
-function playWindowsWav(): void {
-  // WScript launches the PowerShell player hidden without stealing focus. This
-  // is more reliable than spawning hidden PowerShell directly from Pi's TUI.
-  runDetached("wscript.exe", [VBS_PATH]);
-}
-
-function playLinuxTune(): void {
-  // Prefer shell printf bells for broad compatibility; terminal may silence them.
-  // If paplay/aplay exists, play the freedesktop complete sound as an additional fallback.
-  runDetached("sh", [
-    "-c",
-    "(command -v paplay >/dev/null 2>&1 && paplay /usr/share/sounds/freedesktop/stereo/complete.oga >/dev/null 2>&1) || " +
-      "(command -v aplay >/dev/null 2>&1 && aplay /usr/share/sounds/alsa/Front_Center.wav >/dev/null 2>&1) || " +
-      "printf '\\a'; sleep 0.12; printf '\\a'; sleep 0.12; printf '\\a'",
-  ]);
-}
-
-function runDetached(command: string, args: string[]): void {
-  try {
-    const child = spawn(command, args, {
-      detached: true,
-      stdio: "ignore",
-      windowsHide: true,
-      shell: false,
-    });
-    child.unref();
-  } catch {
-    // Notification failures should never interrupt pi.
-  }
-}
+import type { ExtensionAPI, ExtensionCommandContext, ExtensionContext } from "@earendil-works/pi-coding-agent";
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { homedir, platform } from "node:os";
+import { spawn } from "node:child_process";
+
+type NotifySoundConfig = {
+  enabled: boolean;
+};
+
+type NotifyMethod = "auto" | "wav";
+
+const GLOBAL_NOTIFY_DIR = join(homedir(), ".pi", "agent", "notify-sound");
+const CONFIG_PATH = join(GLOBAL_NOTIFY_DIR, "notify-sound.json");
+const WAV_PATH = join(GLOBAL_NOTIFY_DIR, "notify-sound.wav");
+const PS1_PATH = join(GLOBAL_NOTIFY_DIR, "notify-sound.ps1");
+const VBS_PATH = join(GLOBAL_NOTIFY_DIR, "notify-sound.vbs");
+const STALE_AGENT_START_MS = 24 * 60 * 60 * 1000;
+
+let config: NotifySoundConfig = { enabled: true };
+let lastAgentStartedAt = 0;
+
+export default async function notifySoundExtension(pi: ExtensionAPI) {
+  await loadConfig();
+  await ensureTuneWav();
+
+  pi.on("session_start", async (_event, ctx) => {
+    updateStatus(ctx);
+  });
+
+  pi.on("agent_start", async () => {
+    lastAgentStartedAt = Date.now();
+  });
+
+  pi.on("agent_end", async (_event, ctx) => {
+    updateStatus(ctx);
+
+    if (!config.enabled) return;
+    if (!lastAgentStartedAt) return;
+    if (Date.now() - lastAgentStartedAt > STALE_AGENT_START_MS) return;
+
+    playCompletionTune();
+  });
+
+  const command = {
+    description: "Toggle or test the agent completion tune notification",
+    getArgumentCompletions: (argumentPrefix: string) => {
+      const token = argumentPrefix.trim().toLowerCase();
+      return [
+        { value: "status", label: "status", description: "Show whether the completion tune is on" },
+        { value: "test", label: "test", description: "Play the completion tune" },
+        { value: "test wav", label: "test wav", description: "Play the generated WAV completion tune" },
+        { value: "on", label: "on", description: "Enable the completion tune" },
+        { value: "off", label: "off", description: "Disable the completion tune" },
+        { value: "toggle", label: "toggle", description: "Toggle the completion tune" },
+      ].filter((completion) => !token || completion.value.startsWith(token));
+    },
+    handler: async (args: string, ctx: ExtensionCommandContext) => {
+      const action = args.trim().toLowerCase() || "toggle";
+
+      if (action === "test") {
+        playCompletionTune("wav");
+        ctx.ui.notify("Played completion tune using WAV mode. This is the default reliable Windows path.", "info");
+        return;
+      }
+
+      if (action === "test wav") {
+        playCompletionTune("wav");
+        ctx.ui.notify("Played completion tune using WAV mode.", "info");
+        return;
+      }
+
+      if (action.startsWith("test ")) {
+        ctx.ui.notify("Usage: /notify test", "warning");
+        return;
+      }
+
+      if (action === "status") {
+        updateStatus(ctx);
+        ctx.ui.notify(`Completion tune is ${config.enabled ? "ON" : "OFF"}.`, "info");
+        return;
+      }
+
+      if (action === "on") {
+        await setEnabled(true, ctx);
+        return;
+      }
+
+      if (action === "off") {
+        await setEnabled(false, ctx);
+        return;
+      }
+
+      if (action === "toggle") {
+        await setEnabled(!config.enabled, ctx);
+        return;
+      }
+
+      ctx.ui.notify("Usage: /notify [test|status|on|off|toggle]", "warning");
+    },
+  };
+
+  pi.registerCommand("notify-sound", command);
+  pi.registerCommand("notify", {
+    ...command,
+    description: "Alias for /notify-sound",
+  });
+}
+
+async function loadConfig(): Promise<void> {
+  try {
+    const raw = await readFile(CONFIG_PATH, "utf8");
+    const parsed = JSON.parse(raw) as Partial<NotifySoundConfig>;
+    config = { enabled: parsed.enabled !== false };
+  } catch {
+    config = { enabled: true };
+    await saveConfig();
+  }
+}
+
+async function saveConfig(): Promise<void> {
+  await mkdir(dirname(CONFIG_PATH), { recursive: true });
+  await writeFile(CONFIG_PATH, `${JSON.stringify(config, null, 2)}\n`, "utf8");
+}
+
+async function setEnabled(enabled: boolean, ctx: ExtensionContext): Promise<void> {
+  config.enabled = enabled;
+  await saveConfig();
+  updateStatus(ctx);
+  ctx.ui.notify(`Completion tune ${enabled ? "enabled" : "disabled"}.`, "info");
+}
+
+async function ensureTuneWav(): Promise<void> {
+  await mkdir(dirname(WAV_PATH), { recursive: true });
+  await writeFile(WAV_PATH, createTuneWav(), "binary");
+  const wav = WAV_PATH.replace(/'/g, "''");
+  await writeFile(PS1_PATH, [
+    "$ErrorActionPreference = 'SilentlyContinue'",
+    `if (Test-Path '${wav}') {`,
+    `  $p = New-Object System.Media.SoundPlayer '${wav}'`,
+    "  $p.Load()",
+    "  $p.PlaySync()",
+    "}",
+    "[System.Media.SystemSounds]::Asterisk.Play()",
+    "Start-Sleep -Milliseconds 250",
+    "",
+  ].join("\n"), "utf8");
+  const ps1 = PS1_PATH.replace(/"/g, "\"\"");
+  await writeFile(VBS_PATH, [
+    "Set shell = CreateObject(\"WScript.Shell\")",
+    `shell.Run "powershell.exe -NoProfile -ExecutionPolicy Bypass -File ""${ps1}""", 0, False`,
+    "",
+  ].join("\r\n"), "utf8");
+}
+
+function createTuneWav(): Buffer {
+  const sampleRate = 44100;
+  const notes = [
+    [659, 0.11],
+    [784, 0.11],
+    [988, 0.15],
+    [1319, 0.21],
+    [1175, 0.12],
+    [1319, 0.26],
+  ];
+  const gapSeconds = 0.035;
+  const samples: number[] = [];
+
+  for (const [freq, seconds] of notes) {
+    const count = Math.floor(sampleRate * seconds);
+    for (let i = 0; i < count; i++) {
+      const t = i / sampleRate;
+      const fadeIn = Math.min(1, i / 120);
+      const fadeOut = Math.min(1, (count - i) / 300);
+      const env = Math.min(fadeIn, fadeOut) * 0.28;
+      samples.push(Math.sin(2 * Math.PI * freq * t) * env);
+    }
+    for (let i = 0; i < Math.floor(sampleRate * gapSeconds); i++) samples.push(0);
+  }
+
+  const dataSize = samples.length * 2;
+  const buffer = Buffer.alloc(44 + dataSize);
+  buffer.write("RIFF", 0);
+  buffer.writeUInt32LE(36 + dataSize, 4);
+  buffer.write("WAVE", 8);
+  buffer.write("fmt ", 12);
+  buffer.writeUInt32LE(16, 16);
+  buffer.writeUInt16LE(1, 20);
+  buffer.writeUInt16LE(1, 22);
+  buffer.writeUInt32LE(sampleRate, 24);
+  buffer.writeUInt32LE(sampleRate * 2, 28);
+  buffer.writeUInt16LE(2, 32);
+  buffer.writeUInt16LE(16, 34);
+  buffer.write("data", 36);
+  buffer.writeUInt32LE(dataSize, 40);
+
+  let offset = 44;
+  for (const sample of samples) {
+    const value = Math.max(-1, Math.min(1, sample));
+    buffer.writeInt16LE(Math.round(value * 32767), offset);
+    offset += 2;
+  }
+  return buffer;
+}
+
+function updateStatus(ctx: ExtensionContext): void {
+  if (!ctx.hasUI) return;
+  ctx.ui.setStatus("notify-sound", ctx.ui.theme.fg("dim", `tune:${config.enabled ? "on" : "off"}`));
+}
+
+function playCompletionTune(method: NotifyMethod = "auto"): void {
+  const os = platform();
+
+  if (os === "win32") {
+    playWindowsTune(method);
+    return;
+  }
+
+  if (os === "darwin") {
+    runDetached("osascript", ["-e", "beep 1", "-e", "delay 0.12", "-e", "beep 1", "-e", "delay 0.12", "-e", "beep 2"]);
+    return;
+  }
+
+  playLinuxTune();
+}
+
+function playWindowsTune(method: NotifyMethod): void {
+  // Windows uses the generated WAV path because Console.Beep, system sounds,
+  // and terminal bells are silent on many modern Windows machines.
+  playWindowsWav();
+}
+
+function playWindowsWav(): void {
+  // WScript launches the PowerShell player hidden without stealing focus. This
+  // is more reliable than spawning hidden PowerShell directly from Pi's TUI.
+  runDetached("wscript.exe", [VBS_PATH]);
+}
+
+function playLinuxTune(): void {
+  // Prefer shell printf bells for broad compatibility; terminal may silence them.
+  // If paplay/aplay exists, play the freedesktop complete sound as an additional fallback.
+  runDetached("sh", [
+    "-c",
+    "(command -v paplay >/dev/null 2>&1 && paplay /usr/share/sounds/freedesktop/stereo/complete.oga >/dev/null 2>&1) || " +
+      "(command -v aplay >/dev/null 2>&1 && aplay /usr/share/sounds/alsa/Front_Center.wav >/dev/null 2>&1) || " +
+      "printf '\\a'; sleep 0.12; printf '\\a'; sleep 0.12; printf '\\a'",
+  ]);
+}
+
+function runDetached(command: string, args: string[]): void {
+  try {
+    const child = spawn(command, args, {
+      detached: true,
+      stdio: "ignore",
+      windowsHide: true,
+      shell: false,
+    });
+    child.unref();
+  } catch {
+    // Notification failures should never interrupt pi.
+  }
+}

package/.pi/extensions/oauth-router/README.md

@@ -27,6 +27,8 @@ Pi extension that auto-loads and registers an `oauth-router` provider with multi
   - weighted round robin
   - 429 cooldowns
   - transient failure penalties
+  - client/network transport failure tracking without default account cooldown
+  - 5 router-level client/network retries by default before pre-output failover, starting at 5s and doubling
   - auth failure quarantine
   - safe pre-output failover
 
@@ -45,7 +47,7 @@ The extension ships with two default upstream profiles:
    - api: `openai-responses`
    - default models: `gpt-4o`, `gpt-4.1`, `o4-mini`
 
-Edit `~/.pi/agent/oauth-router/config.json` to add more upstreams, swap endpoints, or change model catalogs.
+Edit `~/.pi/agent/oauth-router/config.json` to add more upstreams, swap endpoints, change model catalogs, or tune retry behavior. By default client-side transport failures such as `Codex SSE response headers timed out after 10000ms` retry the same account 5 times with exponential backoff (`5s`, `10s`, `20s`, `40s`, then capped at `60s`) before router failover. These failures are recorded but do not cool down an account unless `clientNetworkPenaltyMs` is set above `0`.
 
 ## Setup
 
@@ -98,7 +100,7 @@ Health and local usage state live separately in:
 
 - `~/.pi/agent/oauth-router/state.json`
 
-The router records successful request usage per account for rolling local 5-hour and weekly windows. These are router-observed counters only. `/router-refresh-usage [id|all]` now also probes configured authenticated provider endpoints for ChatGPT/Codex quota windows, then falls back to safe token claims such as account id, token expiry, issuer, subject, and available claim keys. `/router-usage` shows a compact visual quota view; `/router-usage-raw [id]` shows detailed/raw provider data. Provider-side quota counters depend on undocumented upstream endpoints and may change; they are not normally present in the OAuth token itself.
+The router records successful request usage per account for rolling local 5-hour and weekly windows. These are router-observed counters only. `/router-refresh-usage [id|all]` probes ChatGPT/Codex provider quota from `/backend-api/wham/usage` first and treats `rate_limit.primary_window.used_percent` as the 5-hour window and `rate_limit.secondary_window.used_percent` as the weekly window. It then falls back to safe token claims such as account id, token expiry, issuer, subject, and available claim keys. `/router-usage` shows a compact visual quota view; `/router-usage-raw [id]` shows detailed/raw provider data. Provider-side quota counters depend on undocumented upstream endpoints and may change; they are not normally present in the OAuth token itself.
 
 Most account commands accept an optional account ID. When run in the Pi UI without an ID, the extension opens an account picker instead of dumping the same account list repeatedly.