@canaryai/cli 0.2.9 → 0.2.12

package/dist/{chunk-C2PGZRYK.js → chunk-CEW4BDXD.js}

@@ -3,6 +3,7 @@ import { createRequire as __cr } from "module"; const require = __cr(import.meta
 // src/session/daemon-client.ts
 import { spawn } from "child_process";
 import fs from "fs/promises";
+import { existsSync } from "fs";
 import path from "path";
 import os from "os";
 var PIDFILE_DIR = path.join(os.homedir(), ".config", "canary-cli");
@@ -45,12 +46,20 @@ async function healthCheck(port) {
   }
 }
 async function spawnDaemon() {
-  const cliEntry = path.resolve(
-    path.dirname(new URL(import.meta.url).pathname),
-    "..",
-    "index.ts"
-  );
-  const child = spawn(process.execPath, ["--bun", cliEntry, "session", "daemon"], {
+  const dir = path.dirname(new URL(import.meta.url).pathname);
+  const candidates = [
+    path.resolve(dir, "..", "index.ts"),
+    // source layout
+    path.resolve(dir, "index.js"),
+    // dist layout (flat)
+    path.resolve(dir, "..", "index.js")
+    // fallback
+  ];
+  const cliEntry = candidates.find((p) => existsSync(p));
+  if (!cliEntry) {
+    throw new Error(`Cannot find CLI entry point. Searched: ${candidates.join(", ")}`);
+  }
+  const child = spawn(process.execPath, [cliEntry, "session", "daemon"], {
     detached: true,
     stdio: ["ignore", "pipe", "ignore"],
     env: { ...process.env }
@@ -122,6 +131,14 @@ async function deleteAllSessions() {
   const port = await ensureDaemon();
   return daemonFetch(port, "DELETE", "/sessions");
 }
+async function swapSessionContext(sessionId, params) {
+  const port = await ensureDaemon();
+  return daemonFetch(port, "POST", `/sessions/${sessionId}/swap-context`, params);
+}
+async function getSessionStorageState(sessionId) {
+  const port = await ensureDaemon();
+  return daemonFetch(port, "GET", `/sessions/${sessionId}/storage-state`);
+}
 async function callTool(sessionId, toolName, args) {
   const port = await ensureDaemon();
   return daemonFetch(port, "POST", `/sessions/${sessionId}/tools/${toolName}`, args);
@@ -161,7 +178,9 @@ export {
   getSession,
   deleteSession,
   deleteAllSessions,
+  swapSessionContext,
+  getSessionStorageState,
   callTool,
   resolveTargetSession
 };
-//# sourceMappingURL=chunk-C2PGZRYK.js.map
+//# sourceMappingURL=chunk-CEW4BDXD.js.map

package/dist/chunk-CEW4BDXD.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/session/daemon-client.ts"],"sourcesContent":["/**\n * Daemon client — HTTP client for the session daemon.\n *\n * Handles pidfile read/write, stale PID detection, auto-start,\n * and provides typed HTTP helpers for daemon communication.\n *\n * @module\n */\n\nimport { spawn } from 'node:child_process';\nimport fs from 'node:fs/promises';\nimport { existsSync } from 'node:fs';\nimport path from 'node:path';\nimport os from 'node:os';\nimport type {\n  DaemonState,\n  DaemonResponse,\n  SessionInfo,\n  CreateSessionRequest,\n  SwapContextRequest,\n  ToolResponse,\n  StorageStateResponse,\n} from './types.js';\n\nconst PIDFILE_DIR = path.join(os.homedir(), '.config', 'canary-cli');\nconst PIDFILE_PATH = path.join(PIDFILE_DIR, 'daemon.json');\nconst HEALTH_POLL_INTERVAL_MS = 100;\nconst HEALTH_POLL_TIMEOUT_MS = 15_000;\n\n/* ── Pidfile helpers ─────────────────────────────────────────────────── */\n\nasync function readPidfile(): Promise<DaemonState | null> {\n  try {\n    const content = await fs.readFile(PIDFILE_PATH, 'utf-8');\n    return JSON.parse(content) as DaemonState;\n  } catch {\n    return null;\n  }\n}\n\nfunction isProcessAlive(pid: number): boolean {\n  try {\n    process.kill(pid, 0);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n/* ── HTTP helpers ────────────────────────────────────────────────────── */\n\nasync function daemonFetch(\n  port: number,\n  method: string,\n  path: string,\n  body?: unknown\n): Promise<unknown> {\n  const url = `http://127.0.0.1:${port}${path}`;\n  const res = await fetch(url, {\n    method,\n    headers: body ? { 'Content-Type': 'application/json' } : undefined,\n    body: body ? JSON.stringify(body) : undefined,\n  });\n  return res.json();\n}\n\nasync function healthCheck(port: number): Promise<boolean> {\n  try {\n    const res = await fetch(`http://127.0.0.1:${port}/health`, {\n      signal: AbortSignal.timeout(2000),\n    });\n    return res.ok;\n  } catch {\n    return false;\n  }\n}\n\n/* ── Auto-start ──────────────────────────────────────────────────────── */\n\nasync function spawnDaemon(): Promise<number> {\n  // Resolve the canary CLI entry point\n  // In source: this file is src/session/daemon-client.ts → ../index.ts\n  // In dist:   this file is dist/chunk-*.js → ./index.js (flat)\n  const dir = path.dirname(new URL(import.meta.url).pathname);\n  const candidates = [\n    path.resolve(dir, '..', 'index.ts'),  // source layout\n    path.resolve(dir, 'index.js'),         // dist layout (flat)\n    path.resolve(dir, '..', 'index.js'),   // fallback\n  ];\n  const cliEntry = candidates.find((p) => existsSync(p));\n  if (!cliEntry) {\n    throw new Error(`Cannot find CLI entry point. Searched: ${candidates.join(', ')}`);\n  }\n\n  const child = spawn(process.execPath, [cliEntry, 'session', 'daemon'], {\n    detached: true,\n    stdio: ['ignore', 'pipe', 'ignore'],\n    env: { ...process.env },\n  });\n\n  child.unref();\n\n  // Wait for \"DAEMON_READY:<port>\" on stdout\n  return new Promise<number>((resolve, reject) => {\n    let output = '';\n    const timeout = setTimeout(() => {\n      reject(new Error('Daemon startup timed out'));\n    }, HEALTH_POLL_TIMEOUT_MS);\n\n    child.stdout!.on('data', (data: Buffer) => {\n      output += data.toString();\n      const match = output.match(/DAEMON_READY:(\\d+)/);\n      if (match) {\n        clearTimeout(timeout);\n        resolve(parseInt(match[1], 10));\n      }\n    });\n\n    child.on('error', (err) => {\n      clearTimeout(timeout);\n      reject(err);\n    });\n\n    child.on('exit', (code) => {\n      clearTimeout(timeout);\n      if (!output.includes('DAEMON_READY')) {\n        reject(new Error(`Daemon exited with code ${code} before becoming ready`));\n      }\n    });\n  });\n}\n\n/* ── Public API ──────────────────────────────────────────────────────── */\n\n/**\n * Ensure the daemon is running and return its port.\n * Starts the daemon if needed, cleans up stale pidfiles.\n */\nexport async function ensureDaemon(): Promise<number> {\n  const state = await readPidfile();\n\n  if (state) {\n    if (isProcessAlive(state.pid)) {\n      // Verify it actually responds\n      if (await healthCheck(state.port)) {\n        return state.port;\n      }\n    }\n    // Stale pidfile — clean up\n    try {\n      await fs.unlink(PIDFILE_PATH);\n    } catch {\n      // ignore\n    }\n  }\n\n  // Spawn new daemon\n  const port = await spawnDaemon();\n\n  // Poll until healthy\n  const deadline = Date.now() + HEALTH_POLL_TIMEOUT_MS;\n  while (Date.now() < deadline) {\n    if (await healthCheck(port)) return port;\n    await new Promise((r) => setTimeout(r, HEALTH_POLL_INTERVAL_MS));\n  }\n\n  throw new Error('Daemon failed to become healthy after spawn');\n}\n\n/**\n * Get daemon port if running, null otherwise.\n */\nexport async function getDaemonPort(): Promise<number | null> {\n  const state = await readPidfile();\n  if (!state) return null;\n  if (!isProcessAlive(state.pid)) return null;\n  if (!(await healthCheck(state.port))) return null;\n  return state.port;\n}\n\n/* ── Session operations ──────────────────────────────────────────────── */\n\nexport async function createSession(params: CreateSessionRequest): Promise<DaemonResponse<SessionInfo>> {\n  const port = await ensureDaemon();\n  return daemonFetch(port, 'POST', '/sessions', params) as Promise<DaemonResponse<SessionInfo>>;\n}\n\nexport async function listSessions(): Promise<DaemonResponse<SessionInfo[]>> {\n  const port = await ensureDaemon();\n  return daemonFetch(port, 'GET', '/sessions') as Promise<DaemonResponse<SessionInfo[]>>;\n}\n\nexport async function getSession(sessionId: string): Promise<DaemonResponse<SessionInfo>> {\n  const port = await ensureDaemon();\n  return daemonFetch(port, 'GET', `/sessions/${sessionId}`) as Promise<DaemonResponse<SessionInfo>>;\n}\n\nexport async function deleteSession(sessionId: string): Promise<DaemonResponse> {\n  const port = await ensureDaemon();\n  return daemonFetch(port, 'DELETE', `/sessions/${sessionId}`) as Promise<DaemonResponse>;\n}\n\nexport async function deleteAllSessions(): Promise<DaemonResponse> {\n  const port = await ensureDaemon();\n  return daemonFetch(port, 'DELETE', '/sessions') as Promise<DaemonResponse>;\n}\n\nexport async function swapSessionContext(\n  sessionId: string,\n  params: SwapContextRequest\n): Promise<DaemonResponse<SessionInfo>> {\n  const port = await ensureDaemon();\n  return daemonFetch(port, 'POST', `/sessions/${sessionId}/swap-context`, params) as Promise<\n    DaemonResponse<SessionInfo>\n  >;\n}\n\nexport async function getSessionStorageState(sessionId: string): Promise<StorageStateResponse> {\n  const port = await ensureDaemon();\n  return daemonFetch(port, 'GET', `/sessions/${sessionId}/storage-state`) as Promise<StorageStateResponse>;\n}\n\nexport async function callTool(\n  sessionId: string,\n  toolName: string,\n  args: Record<string, unknown>\n): Promise<ToolResponse> {\n  const port = await ensureDaemon();\n  return daemonFetch(port, 'POST', `/sessions/${sessionId}/tools/${toolName}`, args) as Promise<ToolResponse>;\n}\n\n/**\n * Resolve the target session for a command.\n * If there's exactly one session, auto-targets it.\n * If a sessionId or name is provided, looks it up.\n */\nexport async function resolveTargetSession(sessionIdOrName?: string): Promise<SessionInfo> {\n  const result = await listSessions();\n  if (!result.ok || !result.data) {\n    throw new Error('Failed to list sessions');\n  }\n  const sessions = result.data;\n\n  if (sessions.length === 0) {\n    throw new Error('No active sessions. Start one with: canary session start');\n  }\n\n  if (sessionIdOrName) {\n    const match = sessions.find(\n      (s) => s.id === sessionIdOrName || s.name === sessionIdOrName\n    );\n    if (!match) {\n      throw new Error(\n        `Session \"${sessionIdOrName}\" not found. Active sessions: ${sessions.map((s) => s.id).join(', ')}`\n      );\n    }\n    return match;\n  }\n\n  if (sessions.length === 1) {\n    return sessions[0];\n  }\n\n  throw new Error(\n    `Multiple sessions active. Specify one with --session:\\n${sessions.map((s) => `  ${s.id} (${s.name})`).join('\\n')}`\n  );\n}\n"],"mappings":"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","names":["path"]}

package/dist/chunk-ERSNYLMZ.js

@@ -0,0 +1,229 @@
+import { createRequire as __cr } from "module"; const require = __cr(import.meta.url);
+import {
+  getArgValue
+} from "./chunk-PWWQGYFG.js";
+import {
+  getCanaryTmpDir
+} from "./chunk-XAA5VQ5N.js";
+
+// src/cli-helpers.ts
+import fs from "fs/promises";
+import path from "path";
+import process from "process";
+function toLifecycleLabel(stage) {
+  switch (stage) {
+    case "deprecated":
+      return "deprecated";
+    case "ready_for_cleanup":
+      return "ready_for_cleanup";
+    default:
+      return "active";
+  }
+}
+function parseLifecycleStage(argv) {
+  const stage = getArgValue(argv, "--stage");
+  if (!stage || !["active", "deprecated", "ready_for_cleanup"].includes(stage)) {
+    console.error("Error: --stage is required and must be one of: active, deprecated, ready_for_cleanup");
+    process.exit(1);
+  }
+  return stage;
+}
+async function apiRequest(apiUrl, token, method, path2, body) {
+  const res = await fetch(`${apiUrl}${path2}`, {
+    method,
+    headers: {
+      Authorization: `Bearer ${token}`,
+      "Content-Type": "application/json"
+    },
+    ...body ? { body: JSON.stringify(body) } : {}
+  });
+  if (res.status === 401) {
+    console.error("Error: Unauthorized. Your session may have expired.");
+    console.error("Run: canary login");
+    process.exit(1);
+  }
+  return await res.json();
+}
+async function downloadStorageState(opts) {
+  const tmpFile = path.join(
+    getCanaryTmpDir(),
+    `${opts.prefix ?? "canary-ss"}-${Date.now()}.json`
+  );
+  try {
+    const res = await fetch(
+      `${opts.apiUrl}/org/properties/${opts.propertyId}/credentials/${opts.credentialId}/storage-state/download`,
+      {
+        headers: { Authorization: `Bearer ${opts.token}` },
+        redirect: "follow"
+      }
+    );
+    if (res.ok) {
+      const body = await res.text();
+      await fs.writeFile(tmpFile, body, "utf-8");
+      return tmpFile;
+    }
+  } catch {
+  }
+  return void 0;
+}
+async function selectCredential(apiUrl, token, credentialArg) {
+  const credentials = await fetchList(apiUrl, token, "/org/credentials", "items");
+  if (credentials.length === 0) {
+    console.error("No credentials found. Create one first in the web app.");
+    return null;
+  }
+  if (credentialArg) {
+    const match = credentials.find(
+      (c) => c.id === credentialArg || c.name.toLowerCase() === credentialArg.toLowerCase()
+    );
+    if (!match) {
+      console.error(`Credential "${credentialArg}" not found.`);
+      console.error("Available credentials:");
+      for (const c of credentials) {
+        const baseUrl = c.propertyBaseUrl ? ` \u2014 ${c.propertyBaseUrl}` : "";
+        console.error(`  - ${c.name} [${c.propertyName ?? c.propertyId}${baseUrl}]`);
+      }
+      return null;
+    }
+    return match;
+  }
+  console.log("\nSelect a credential:\n");
+  const labels = credentials.map((c) => {
+    const property = c.propertyName ?? c.propertyId;
+    const baseUrl = c.propertyBaseUrl ? ` \u2014 ${c.propertyBaseUrl}` : "";
+    return `${c.name} [${property}${baseUrl}]`;
+  });
+  const readline = await import("readline");
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+  const answer = await new Promise((resolve) => {
+    for (let i = 0; i < labels.length; i++) {
+      console.log(`  ${i + 1}. ${labels[i]}`);
+    }
+    rl.question("\nEnter number: ", (ans) => {
+      rl.close();
+      resolve(ans.trim());
+    });
+  });
+  const idx = parseInt(answer, 10) - 1;
+  if (isNaN(idx) || idx < 0 || idx >= credentials.length) {
+    console.error("Invalid selection.");
+    return null;
+  }
+  return credentials[idx];
+}
+async function fetchProperties(apiUrl, token) {
+  return fetchList(apiUrl, token, "/org/properties", "data");
+}
+async function selectProperty(apiUrl, token, hint) {
+  const properties = await fetchProperties(apiUrl, token);
+  if (properties.length === 0) {
+    console.error("No properties found. Create one first in the web app.");
+    return null;
+  }
+  if (hint) {
+    const match = properties.find(
+      (p) => p.id === hint || p.name.toLowerCase() === hint.toLowerCase()
+    );
+    if (!match) {
+      console.error(`Property "${hint}" not found.`);
+      console.error("Available properties:");
+      for (const p of properties) {
+        console.error(`  - ${p.name} (${p.baseUrl})`);
+      }
+      return null;
+    }
+    return match;
+  }
+  if (properties.length === 1) {
+    console.log(`Auto-selected property: ${properties[0].name}`);
+    return properties[0];
+  }
+  return promptChoice(
+    "Select a property:",
+    properties.map((p) => ({ label: `${p.name} \u2014 ${p.baseUrl}`, value: p }))
+  );
+}
+async function promptInput(question, defaultValue) {
+  const readline = await import("readline");
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+  const prompt = defaultValue ? `${question} [${defaultValue}]: ` : `${question}: `;
+  const answer = await new Promise((resolve) => {
+    rl.question(prompt, (ans) => {
+      rl.close();
+      resolve(ans.trim());
+    });
+  });
+  return answer || defaultValue || "";
+}
+async function promptChoice(question, options) {
+  console.log(`
+${question}
+`);
+  for (let i = 0; i < options.length; i++) {
+    console.log(`  ${i + 1}. ${options[i].label}`);
+  }
+  const readline = await import("readline");
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+  const answer = await new Promise((resolve) => {
+    rl.question("\nEnter number: ", (ans) => {
+      rl.close();
+      resolve(ans.trim());
+    });
+  });
+  const idx = parseInt(answer, 10) - 1;
+  if (isNaN(idx) || idx < 0 || idx >= options.length) {
+    console.error("Invalid selection.");
+    return null;
+  }
+  return options[idx].value;
+}
+async function uploadStorageState(opts) {
+  const res = await fetch(
+    `${opts.apiUrl}/org/properties/${opts.propertyId}/credentials/${opts.credentialId}/storage-state/upload`,
+    {
+      method: "PUT",
+      headers: {
+        Authorization: `Bearer ${opts.token}`,
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify({ storageState: opts.storageState })
+    }
+  );
+  if (res.status === 401) {
+    console.error("Error: Unauthorized. Your session may have expired.");
+    console.error("Run: canary login");
+    process.exit(1);
+  }
+  return await res.json();
+}
+async function fetchList(apiUrl, token, path2, listKey) {
+  const res = await fetch(`${apiUrl}${path2}`, {
+    headers: { Authorization: `Bearer ${token}` }
+  });
+  if (res.status === 401) {
+    console.error("Error: Unauthorized. Your session may have expired.");
+    console.error("Run: canary login");
+    process.exit(1);
+  }
+  const json = await res.json();
+  if (!json.ok) {
+    console.error(`Error: ${json.error}`);
+    process.exit(1);
+  }
+  return json[listKey] ?? [];
+}
+
+export {
+  toLifecycleLabel,
+  parseLifecycleStage,
+  apiRequest,
+  downloadStorageState,
+  selectCredential,
+  fetchProperties,
+  selectProperty,
+  promptInput,
+  promptChoice,
+  uploadStorageState,
+  fetchList
+};
+//# sourceMappingURL=chunk-ERSNYLMZ.js.map

package/dist/chunk-ERSNYLMZ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli-helpers.ts"],"sourcesContent":["/**\n * Shared CLI helpers for superadmin management commands (knobs, feature-flags).\n */\n\nimport fs from \"node:fs/promises\";\nimport path from \"node:path\";\nimport process from \"node:process\";\nimport { getCanaryTmpDir } from \"@chatsdet/tmp\";\nimport { getArgValue } from \"./auth.js\";\n\nexport type LifecycleStage = \"active\" | \"deprecated\" | \"ready_for_cleanup\";\n\nexport function toLifecycleLabel(stage: LifecycleStage): string {\n  switch (stage) {\n    case \"deprecated\":\n      return \"deprecated\";\n    case \"ready_for_cleanup\":\n      return \"ready_for_cleanup\";\n    default:\n      return \"active\";\n  }\n}\n\nexport function parseLifecycleStage(argv: string[]): LifecycleStage {\n  const stage = getArgValue(argv, \"--stage\");\n  if (!stage || ![\"active\", \"deprecated\", \"ready_for_cleanup\"].includes(stage)) {\n    console.error(\"Error: --stage is required and must be one of: active, deprecated, ready_for_cleanup\");\n    process.exit(1);\n  }\n  return stage as LifecycleStage;\n}\n\nexport async function apiRequest<T extends { ok: boolean; error?: string }>(\n  apiUrl: string,\n  token: string,\n  method: string,\n  path: string,\n  body?: Record<string, unknown>\n): Promise<T> {\n  const res = await fetch(`${apiUrl}${path}`, {\n    method,\n    headers: {\n      Authorization: `Bearer ${token}`,\n      \"Content-Type\": \"application/json\",\n    },\n    ...(body ? { body: JSON.stringify(body) } : {}),\n  });\n\n  if (res.status === 401) {\n    console.error(\"Error: Unauthorized. Your session may have expired.\");\n    console.error(\"Run: canary login\");\n    process.exit(1);\n  }\n\n  return (await res.json()) as T;\n}\n\nexport async function downloadStorageState(opts: {\n  apiUrl: string;\n  token: string;\n  propertyId: string;\n  credentialId: string;\n  prefix?: string;\n}): Promise<string | undefined> {\n  const tmpFile = path.join(\n    getCanaryTmpDir(),\n    `${opts.prefix ?? \"canary-ss\"}-${Date.now()}.json`\n  );\n  try {\n    const res = await fetch(\n      `${opts.apiUrl}/org/properties/${opts.propertyId}/credentials/${opts.credentialId}/storage-state/download`,\n      {\n        headers: { Authorization: `Bearer ${opts.token}` },\n        redirect: \"follow\",\n      }\n    );\n    if (res.ok) {\n      const body = await res.text();\n      await fs.writeFile(tmpFile, body, \"utf-8\");\n      return tmpFile;\n    }\n  } catch {\n    // Caller handles missing storage state\n  }\n  return undefined;\n}\n\n/* ── Credential selection ─────────────────────────────────────────────── */\n\nexport interface CredentialListItem {\n  id: string;\n  name: string;\n  propertyId: string;\n  propertyName?: string;\n  propertyBaseUrl?: string;\n  loginUrl?: string;\n  storageStateS3Key?: string | null;\n}\n\n/**\n * Fetch org credentials and let the user pick one interactively.\n *\n * @param credentialArg - Credential name or ID to auto-select, or undefined for interactive\n * @returns The selected credential, or null if none found / invalid selection\n */\nexport async function selectCredential(\n  apiUrl: string,\n  token: string,\n  credentialArg?: string\n): Promise<CredentialListItem | null> {\n  const credentials = await fetchList<CredentialListItem>(apiUrl, token, \"/org/credentials\", \"items\");\n\n  if (credentials.length === 0) {\n    console.error(\"No credentials found. Create one first in the web app.\");\n    return null;\n  }\n\n  if (credentialArg) {\n    const match = credentials.find(\n      (c) =>\n        c.id === credentialArg ||\n        c.name.toLowerCase() === credentialArg.toLowerCase()\n    );\n    if (!match) {\n      console.error(`Credential \"${credentialArg}\" not found.`);\n      console.error(\"Available credentials:\");\n      for (const c of credentials) {\n        const baseUrl = c.propertyBaseUrl ? ` — ${c.propertyBaseUrl}` : '';\n        console.error(`  - ${c.name} [${c.propertyName ?? c.propertyId}${baseUrl}]`);\n      }\n      return null;\n    }\n    return match;\n  }\n\n  // Interactive selection\n  console.log(\"\\nSelect a credential:\\n\");\n  const labels = credentials.map((c) => {\n    const property = c.propertyName ?? c.propertyId;\n    const baseUrl = c.propertyBaseUrl ? ` — ${c.propertyBaseUrl}` : '';\n    return `${c.name} [${property}${baseUrl}]`;\n  });\n\n  const readline = await import(\"node:readline\");\n  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });\n  const answer = await new Promise<string>((resolve) => {\n    for (let i = 0; i < labels.length; i++) {\n      console.log(`  ${i + 1}. ${labels[i]}`);\n    }\n    rl.question(\"\\nEnter number: \", (ans) => {\n      rl.close();\n      resolve(ans.trim());\n    });\n  });\n\n  const idx = parseInt(answer, 10) - 1;\n  if (isNaN(idx) || idx < 0 || idx >= credentials.length) {\n    console.error(\"Invalid selection.\");\n    return null;\n  }\n\n  return credentials[idx];\n}\n\n/* ── Property selection ──────────────────────────────────────────────── */\n\nexport interface PropertyListItem {\n  id: string;\n  name: string;\n  baseUrl: string;\n}\n\nexport async function fetchProperties(\n  apiUrl: string,\n  token: string\n): Promise<PropertyListItem[]> {\n  return fetchList<PropertyListItem>(apiUrl, token, \"/org/properties\", \"data\");\n}\n\nexport async function selectProperty(\n  apiUrl: string,\n  token: string,\n  hint?: string\n): Promise<PropertyListItem | null> {\n  const properties = await fetchProperties(apiUrl, token);\n\n  if (properties.length === 0) {\n    console.error(\"No properties found. Create one first in the web app.\");\n    return null;\n  }\n\n  if (hint) {\n    const match = properties.find(\n      (p) =>\n        p.id === hint ||\n        p.name.toLowerCase() === hint.toLowerCase()\n    );\n    if (!match) {\n      console.error(`Property \"${hint}\" not found.`);\n      console.error(\"Available properties:\");\n      for (const p of properties) {\n        console.error(`  - ${p.name} (${p.baseUrl})`);\n      }\n      return null;\n    }\n    return match;\n  }\n\n  if (properties.length === 1) {\n    console.log(`Auto-selected property: ${properties[0].name}`);\n    return properties[0];\n  }\n\n  return promptChoice(\n    \"Select a property:\",\n    properties.map((p) => ({ label: `${p.name} — ${p.baseUrl}`, value: p }))\n  );\n}\n\n/* ── Interactive prompt helpers ──────────────────────────────────────── */\n\nexport async function promptInput(question: string, defaultValue?: string): Promise<string> {\n  const readline = await import(\"node:readline\");\n  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });\n  const prompt = defaultValue ? `${question} [${defaultValue}]: ` : `${question}: `;\n  const answer = await new Promise<string>((resolve) => {\n    rl.question(prompt, (ans) => {\n      rl.close();\n      resolve(ans.trim());\n    });\n  });\n  return answer || defaultValue || \"\";\n}\n\nexport async function promptChoice<T>(\n  question: string,\n  options: Array<{ label: string; value: T }>\n): Promise<T | null> {\n  console.log(`\\n${question}\\n`);\n  for (let i = 0; i < options.length; i++) {\n    console.log(`  ${i + 1}. ${options[i].label}`);\n  }\n  const readline = await import(\"node:readline\");\n  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });\n  const answer = await new Promise<string>((resolve) => {\n    rl.question(\"\\nEnter number: \", (ans) => {\n      rl.close();\n      resolve(ans.trim());\n    });\n  });\n\n  const idx = parseInt(answer, 10) - 1;\n  if (isNaN(idx) || idx < 0 || idx >= options.length) {\n    console.error(\"Invalid selection.\");\n    return null;\n  }\n  return options[idx].value;\n}\n\nexport async function promptConfirm(question: string): Promise<boolean> {\n  const answer = await promptInput(`${question} (y/n)`, \"n\");\n  return answer.toLowerCase() === \"y\" || answer.toLowerCase() === \"yes\";\n}\n\nexport async function uploadStorageState(opts: {\n  apiUrl: string;\n  token: string;\n  propertyId: string;\n  credentialId: string;\n  storageState: unknown;\n}): Promise<{ ok: boolean; s3Key?: string; error?: string }> {\n  const res = await fetch(\n    `${opts.apiUrl}/org/properties/${opts.propertyId}/credentials/${opts.credentialId}/storage-state/upload`,\n    {\n      method: \"PUT\",\n      headers: {\n        Authorization: `Bearer ${opts.token}`,\n        \"Content-Type\": \"application/json\",\n      },\n      body: JSON.stringify({ storageState: opts.storageState }),\n    }\n  );\n\n  if (res.status === 401) {\n    console.error(\"Error: Unauthorized. Your session may have expired.\");\n    console.error(\"Run: canary login\");\n    process.exit(1);\n  }\n\n  return (await res.json()) as { ok: boolean; s3Key?: string; error?: string };\n}\n\nexport async function fetchList<T>(\n  apiUrl: string,\n  token: string,\n  path: string,\n  listKey: string\n): Promise<T[]> {\n  const res = await fetch(`${apiUrl}${path}`, {\n    headers: { Authorization: `Bearer ${token}` },\n  });\n\n  if (res.status === 401) {\n    console.error(\"Error: Unauthorized. Your session may have expired.\");\n    console.error(\"Run: canary login\");\n    process.exit(1);\n  }\n\n  const json = (await res.json()) as Record<string, unknown>;\n\n  if (!json.ok) {\n    console.error(`Error: ${json.error}`);\n    process.exit(1);\n  }\n\n  return (json[listKey] as T[]) ?? [];\n}\n"],"mappings":"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","names":["path","path"]}

package/dist/{chunk-XGO62PO2.js → chunk-MSMC6UXW.js}

@@ -38537,6 +38537,18 @@ function normalizeIconLabelText(role, text) {
   }
   return ICON_ONLY_ROLES.has(role) ? "(icon)" : "";
 }
+var STYLED_WRAPPER_RE = /^Styled\(\w+\)$/;
+var MUI_CLASS_RE = /^Mui\w+-[\w-]+$/;
+var HAS_ASCII_ALNUM_RE = /[A-Za-z0-9]/;
+function isNoisyLabel(text) {
+  const trimmed = text.trim();
+  if (!trimmed) return false;
+  if (STYLED_WRAPPER_RE.test(trimmed)) return true;
+  if (MUI_CLASS_RE.test(trimmed)) return true;
+  if (HAS_PRIVATE_USE_GLYPH_RE.test(trimmed)) return false;
+  if (!HAS_ASCII_ALNUM_RE.test(trimmed)) return true;
+  return false;
+}
 
 // ../browser-core/src/snapshot-formatter-shared.ts
 var MAX_SEARCH_MATCHES = 10;
@@ -38651,9 +38663,34 @@ function composeLabel(element) {
   }
   return textParts.join(" | ") || element.role;
 }
+function composeChildLabel(element) {
+  const textParts = [];
+  function collectText(el, depth) {
+    if (depth > 3) return;
+    const text = getElementText(el);
+    if (text && TEXT_CARRYING_ROLES.has(el.role)) {
+      textParts.push(text);
+    }
+    for (const child of el.children) {
+      if (!INTERACTIVE_LEAF_ROLES.has(child.role)) {
+        collectText(child, depth + 1);
+      }
+    }
+  }
+  for (const child of element.children) {
+    if (!INTERACTIVE_LEAF_ROLES.has(child.role)) {
+      collectText(child, 0);
+    }
+  }
+  return textParts.length > 0 ? textParts.join(" | ") : null;
+}
 function getDisplayText(element, options) {
   const isClickable = isActionableClickableGeneric(element);
-  const rawTextSource = options?.overrideLabel ?? (isClickable ? composeLabel(element) : element.text ?? "");
+  let rawTextSource = options?.overrideLabel ?? (isClickable ? composeLabel(element) : element.text ?? "");
+  if (rawTextSource && isNoisyLabel(rawTextSource) && INTERACTIVE_LEAF_ROLES.has(element.role)) {
+    const childText = composeChildLabel(element);
+    rawTextSource = childText ?? "";
+  }
   return normalizeIconLabelText(element.role, rawTextSource);
 }
 function hasInteractiveDescendants(element) {
@@ -38852,7 +38889,7 @@ function extractGridCell(cellEl) {
   findInteractive(cellEl);
   if (interactiveElements.length === 0) {
     const textValue = extractCellText(cellEl);
-    if (textValue) {
+    if (textValue && !isNoisyLabel(textValue)) {
       return {
         ref: cellEl.ref,
         column: cellEl.text || "",
@@ -38866,7 +38903,8 @@ function extractGridCell(cellEl) {
     (best, current) => gridCellPriority(current) > gridCellPriority(best) ? current : best
   );
   const column = stripBlankPatterns(found.column);
-  const value = isBlankValue(found.value) ? "" : stripBlankPatterns(found.value).trim();
+  const rawValue = isBlankValue(found.value) ? "" : stripBlankPatterns(found.value).trim();
+  const value = isNoisyLabel(rawValue) ? "" : rawValue;
   const gridcellLabel = cellEl.text ? stripBlankPatterns(cellEl.text).trim() : void 0;
   return {
     ref: found.ref,
@@ -39821,6 +39859,24 @@ function markBackgroundSections(sections) {
     markBackgroundSections(section.subsections);
   }
 }
+function mergeFilterDropdownPairs(elements) {
+  for (let i = elements.length - 2; i >= 0; i--) {
+    const current = elements[i];
+    const next = elements[i + 1];
+    if (current.role === "generic" && current.isClickable && next.role === "img" && next.isClickable && (!next.label || next.label === "img")) {
+      if (!current.fieldLabel && next.fieldLabel) {
+        current.fieldLabel = next.fieldLabel;
+      }
+      elements.splice(i + 1, 1);
+    }
+  }
+}
+function applyFilterMerge(sections) {
+  for (const section of sections) {
+    mergeFilterDropdownPairs(section.elements);
+    applyFilterMerge(section.subsections);
+  }
+}
 function buildSectionTree(elements) {
   const sections = [];
   for (const element of elements) {
@@ -39830,6 +39886,7 @@ function buildSectionTree(elements) {
     }
   }
   markBackgroundSections(sections);
+  applyFilterMerge(sections);
   return sections;
 }
 function markMatchingSections(sections, matchedRefs) {
@@ -40146,6 +40203,60 @@ ACTIONS:
   - Use bash or python_execute on the FULL TREE FILE for detailed element analysis
 ---`;
 }
+function disambiguateDuplicateLabels(sections) {
+  const elementEntries = [];
+  function collectElements(section) {
+    for (const el of section.elements) {
+      elementEntries.push({ el, sectionHeading: section.heading });
+    }
+    for (const sub of section.subsections) {
+      collectElements(sub);
+    }
+  }
+  for (const section of sections) {
+    collectElements(section);
+  }
+  const SKIP_LABELS = /* @__PURE__ */ new Set(["(icon)", "button", "link", "generic"]);
+  const byLabel = /* @__PURE__ */ new Map();
+  for (const entry of elementEntries) {
+    const label = entry.el.label || entry.el.name;
+    if (!label || label.length === 0) continue;
+    if (SKIP_LABELS.has(label)) continue;
+    if (!entry.el.ref) continue;
+    const existing = byLabel.get(label);
+    if (existing) {
+      existing.push(entry);
+    } else {
+      byLabel.set(label, [entry]);
+    }
+  }
+  for (const [, entries] of byLabel) {
+    if (entries.length < 2) continue;
+    const distinctSections = new Set(entries.map((e) => e.sectionHeading));
+    if (distinctSections.size > 1) {
+      for (const entry of entries) {
+        const currentLabel = entry.el.label || entry.el.name || "";
+        if (entry.el.label) {
+          entry.el.label = `${currentLabel} (in ${entry.sectionHeading})`;
+        } else if (entry.el.name) {
+          entry.el.name = `${currentLabel} (in ${entry.sectionHeading})`;
+        }
+      }
+    } else {
+      const ordinals = ["1st", "2nd", "3rd", "4th", "5th", "6th", "7th", "8th"];
+      for (let i = 0; i < entries.length; i++) {
+        const entry = entries[i];
+        const ordinal = i < ordinals.length ? ordinals[i] : `${i + 1}th`;
+        const currentLabel = entry.el.label || entry.el.name || "";
+        if (entry.el.label) {
+          entry.el.label = `${currentLabel} (${ordinal})`;
+        } else if (entry.el.name) {
+          entry.el.name = `${currentLabel} (${ordinal})`;
+        }
+      }
+    }
+  }
+}
 function formatSemanticSnapshot(yaml, options) {
   if (!yaml || yaml.trim() === "") {
     return "---\nSEMANTIC SNAPSHOT - 0 elements\nPage appears empty or not loaded.\n---";
@@ -40179,6 +40290,7 @@ function formatSemanticSnapshot(yaml, options) {
   if (options?.probeResult?.ref) {
     markMatchingSections(sortedSections, /* @__PURE__ */ new Set([options.probeResult.ref]));
   }
+  disambiguateDuplicateLabels(sortedSections);
   const elementCount = countRenderedElements(sortedSections);
   const sectionCount = countTotalSections(sortedSections);
   const lines = [];
@@ -40204,7 +40316,11 @@ function formatSemanticSnapshot(yaml, options) {
       lines.push("");
     }
   }
-  return lines.join("\n").trim();
+  let result = lines.join("\n").trim();
+  if (options?.offScreenRefs && options.offScreenRefs.size > 0) {
+    result = markOffScreenElements(result, options.offScreenRefs);
+  }
+  return result;
 }
 function expandSection(yaml, sectionRef) {
   if (!yaml || yaml.trim() === "") {
@@ -40278,6 +40394,15 @@ Section with ref="${sectionRef}" not found in snapshot.
   targetSection.collapsed = false;
   return formatExpandedSectionOutput(targetSection);
 }
+function markOffScreenElements(text, offScreenRefs) {
+  if (offScreenRefs.size === 0) return text;
+  return text.replace(/\[(e\d+)\](?! \[off-screen\])/g, (match, ref) => {
+    if (offScreenRefs.has(ref)) {
+      return `[${ref}] [off-screen]`;
+    }
+    return match;
+  });
+}
 
 // ../browser-core/src/table-extractor.ts
 function extractTablesFromSnapshot(yamlOrResponse, options) {
@@ -41458,6 +41583,42 @@ ${effectiveShowCoordinateGrid ? "Coordinate grid enabled - read coordinates from
       await fs2.writeFile(snapshotFilePath, yaml, "utf-8");
     } catch {
     }
+    let offScreenRefs;
+    try {
+      const viewportSize = this.client.getViewportSize();
+      const offScreen = await this.client.evaluate(
+        `() => {
+          const vw = ${viewportSize.width};
+          const vh = ${viewportSize.height};
+          const offscreen = [];
+          const els = document.querySelectorAll('[aria-ref]');
+          for (const el of els) {
+            const ref = el.getAttribute('aria-ref');
+            if (!ref) continue;
+            const r = el.getBoundingClientRect();
+            if (r.width === 0 && r.height === 0) continue;
+            if (r.right < 0 || r.left > vw || r.bottom < 0 || r.top > vh) {
+              offscreen.push(ref);
+            }
+          }
+          return offscreen;
+        }`,
+        { signal: this.signal }
+      );
+      if (typeof offScreen === "string") {
+        try {
+          const parsed = JSON.parse(offScreen);
+          if (Array.isArray(parsed) && parsed.length > 0) {
+            offScreenRefs = new Set(parsed);
+          }
+        } catch {
+        }
+      }
+    } catch (e) {
+      this.logger?.debug?.("[browser_snapshot] Off-screen detection failed", {
+        error: e instanceof Error ? e.message : String(e)
+      });
+    }
     const now = (/* @__PURE__ */ new Date()).toISOString();
     const semanticText = formatSemanticSnapshot(yaml, {
       searchMatches: searchMatches.length > 0 ? searchMatches : void 0,
@@ -41465,7 +41626,8 @@ ${effectiveShowCoordinateGrid ? "Coordinate grid enabled - read coordinates from
       snapshotFilePath,
       probeResult,
       currentTime: now,
-      capturedToasts: this.client.getCapturedToasts?.() ?? []
+      capturedToasts: this.client.getCapturedToasts?.() ?? [],
+      offScreenRefs
     });
     if (hasImages) {
       const resolutionNote = buildResolutionNote(
@@ -42179,7 +42341,7 @@ function getBrowserToolDefinitions() {
           },
           toRef: {
             type: "string",
-            description: "Scroll the page so this element is centered vertically in the viewport."
+            description: "Scroll the page so this element is centered in the viewport. Handles both vertical and horizontal scrolling automatically \u2014 works for grid columns that are horizontally off-screen."
           },
           x: {
             type: "number",
@@ -46149,17 +46311,42 @@ Use coordinate-based clicking (x, y) to interact with elements visible in the sc
         const locator = await this.resolveRef(toRef);
         const box = await locator.boundingBox();
         if (box) {
+          const viewportSize = this.getViewportSize();
           const elementCenterY = box.y + box.height / 2;
-          const viewportHeight = 1080;
-          const viewportCenterY = viewportHeight / 2;
+          const viewportCenterY = viewportSize.height / 2;
           const scrollY = elementCenterY - viewportCenterY;
+          const elementCenterX = box.x + box.width / 2;
+          const viewportCenterX = viewportSize.width / 2;
+          const boxRight = box.x + box.width;
+          const needsHorizontalScroll = boxRight < 0 || box.x > viewportSize.width || elementCenterX < 0 || elementCenterX > viewportSize.width;
+          const scrollX = needsHorizontalScroll ? elementCenterX - viewportCenterX : 0;
           this.logger.debug("[DirectPlaywright] Scrolling to center element", {
             toRef,
             elementCenterY,
             viewportCenterY,
-            scrollY
+            scrollY,
+            elementCenterX,
+            scrollX,
+            needsHorizontalScroll
           });
-          await page.evaluate(`window.scrollBy(0, ${scrollY})`);
+          await page.evaluate(`window.scrollBy(${scrollX}, ${scrollY})`);
+          if (needsHorizontalScroll) {
+            await page.evaluate((ref) => {
+              const el = document.querySelector(`[aria-ref="${ref}"]`);
+              if (!el) return;
+              let parent = el.parentElement;
+              for (let i = 0; i < 10 && parent; i++) {
+                if (parent.scrollWidth > parent.clientWidth) {
+                  const elRect = el.getBoundingClientRect();
+                  const parentRect = parent.getBoundingClientRect();
+                  const targetScrollLeft = parent.scrollLeft + (elRect.left - parentRect.left) - parentRect.width / 2 + elRect.width / 2;
+                  parent.scrollLeft = Math.max(0, targetScrollLeft);
+                  break;
+                }
+                parent = parent.parentElement;
+              }
+            }, toRef);
+          }
         } else {
           this.logger.warn("[DirectPlaywright] No bounding box, using scrollIntoViewIfNeeded", {
             toRef
@@ -48285,4 +48472,4 @@ playwright-extra/dist/index.esm.js:
    * @license MIT
    *)
 */
-//# sourceMappingURL=chunk-XGO62PO2.js.map
+//# sourceMappingURL=chunk-MSMC6UXW.js.map