@canaryai/cli 0.2.8 → 0.2.9

package/dist/{debug-workflow-55G4Y6YT.js → debug-workflow-I3F36JBL.js}

@@ -1,18 +1,22 @@
 import { createRequire as __cr } from "module"; const require = __cr(import.meta.url);
+import {
+  downloadStorageState
+} from "./chunk-QLFSJG5O.js";
 import {
   LocalBrowserHost
-} from "./chunk-K2OB72B6.js";
+} from "./chunk-LC7ZVXPH.js";
 import {
   getArgValue,
   hasFlag,
   resolveConfig
 } from "./chunk-PWWQGYFG.js";
-import "./chunk-FK3EZADZ.js";
+import "./chunk-XGO62PO2.js";
 import "./chunk-XAA5VQ5N.js";
 import "./chunk-P5Z2Y5VV.js";
 import "./chunk-VKVL7WBN.js";
 
 // src/debug-workflow.ts
+import fs from "fs/promises";
 import process from "process";
 import { createParser } from "eventsource-parser";
 async function runDebugWorkflow(argv) {
@@ -54,6 +58,51 @@ async function runDebugWorkflow(argv) {
     console.error(`Failed to connect to API: ${err}`);
     process.exit(1);
   }
+  console.log("Loading workflow...");
+  let debugSession;
+  try {
+    const res = await fetch(`${apiUrl}/cli/debug/sessions`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        Authorization: `Bearer ${token}`
+      },
+      body: JSON.stringify({
+        workflowId,
+        localBrowserSessionId: localSession.sessionId
+      })
+    });
+    if (!res.ok) {
+      const text = await res.text();
+      console.error(`Failed to create debug session: ${res.status} ${text}`);
+      process.exit(1);
+    }
+    debugSession = await res.json();
+    if (!debugSession.ok || !debugSession.sessionId) {
+      console.error(`Failed to create debug session: ${debugSession.error}`);
+      process.exit(1);
+    }
+  } catch (err) {
+    console.error(`Failed to create debug session: ${err}`);
+    process.exit(1);
+  }
+  let debugSessionId = debugSession.sessionId;
+  let storageStatePath;
+  if (debugSession.isAuthenticated && debugSession.credential) {
+    console.log("Downloading storage state...");
+    storageStatePath = await downloadStorageState({
+      apiUrl,
+      token,
+      propertyId: debugSession.credential.propertyId,
+      credentialId: debugSession.credential.credentialId,
+      prefix: "canary-debug-ss"
+    });
+    if (storageStatePath) {
+      console.log("Storage state loaded.");
+    } else {
+      console.warn("Could not download storage state, continuing without it.");
+    }
+  }
   console.log("Launching headed browser...");
   const host = new LocalBrowserHost({
     apiUrl,
@@ -61,6 +110,7 @@ async function runDebugWorkflow(argv) {
     sessionId: localSession.sessionId,
     browserMode: "playwright",
     headless: false,
+    storageStatePath,
     onLog: (level, message, data) => {
       if (verbose) {
         const prefix = `[${level.toUpperCase()}]`;
@@ -72,7 +122,6 @@ async function runDebugWorkflow(argv) {
       }
     }
   });
-  let debugSessionId = null;
   const cleanup = async () => {
     console.log("\nShutting down...");
     if (debugSessionId) {
@@ -84,6 +133,10 @@ async function runDebugWorkflow(argv) {
       } catch {
       }
     }
+    if (storageStatePath) {
+      await fs.unlink(storageStatePath).catch(() => {
+      });
+    }
     await host.stop();
     process.exit(0);
   };
@@ -98,38 +151,6 @@ async function runDebugWorkflow(argv) {
   }
   console.log("Browser connected.");
   console.log();
-  console.log("Loading workflow...");
-  let debugSession;
-  try {
-    const res = await fetch(`${apiUrl}/cli/debug/sessions`, {
-      method: "POST",
-      headers: {
-        "Content-Type": "application/json",
-        Authorization: `Bearer ${token}`
-      },
-      body: JSON.stringify({
-        workflowId,
-        localBrowserSessionId: localSession.sessionId
-      })
-    });
-    if (!res.ok) {
-      const text = await res.text();
-      console.error(`Failed to create debug session: ${res.status} ${text}`);
-      await host.stop();
-      process.exit(1);
-    }
-    debugSession = await res.json();
-    if (!debugSession.ok || !debugSession.sessionId) {
-      console.error(`Failed to create debug session: ${debugSession.error}`);
-      await host.stop();
-      process.exit(1);
-    }
-  } catch (err) {
-    console.error(`Failed to create debug session: ${err}`);
-    await host.stop();
-    process.exit(1);
-  }
-  debugSessionId = debugSession.sessionId;
   const nodes = debugSession.nodes ?? [];
   const totalSteps = nodes.length;
   const effectiveToStep = toStep ? Math.min(toStep, totalSteps) : totalSteps;
@@ -241,4 +262,4 @@ async function runDebugWorkflow(argv) {
 export {
   runDebugWorkflow
 };
-//# sourceMappingURL=debug-workflow-55G4Y6YT.js.map
+//# sourceMappingURL=debug-workflow-I3F36JBL.js.map

package/dist/debug-workflow-I3F36JBL.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/debug-workflow.ts"],"sourcesContent":["/**\n * Debug Workflow Command\n *\n * Runs a workflow in a local headed browser for debugging. Replays cached\n * actions where possible and falls back to the agent for uncached steps.\n * The browser stays open after execution so the user can inspect page state.\n *\n * Usage:\n *   canary debug <workflowId> [--to-step N] [--api-url URL] [--env local|dev|prod]\n *\n * @module debug-workflow\n */\n\nimport fs from \"node:fs/promises\";\nimport process from \"node:process\";\nimport { createParser, type EventSourceMessage } from \"eventsource-parser\";\nimport { resolveConfig, getArgValue, hasFlag } from \"./auth\";\nimport { downloadStorageState } from \"./cli-helpers.js\";\nimport { LocalBrowserHost } from \"./local-browser/host\";\n\ninterface CreateSessionResponse {\n  ok: boolean;\n  sessionId: string;\n  wsToken: string;\n  wsUrl: string;\n  expiresAt: string;\n  error?: string;\n}\n\ninterface DebugSessionResponse {\n  ok: boolean;\n  sessionId?: string;\n  workflowName?: string;\n  nodes?: Array<{\n    index: number;\n    id: string;\n    name: string;\n    type: string;\n  }>;\n  isAuthenticated?: boolean;\n  credential?: { credentialId: string; propertyId: string } | null;\n  error?: string;\n}\n\ninterface StepStartedEvent {\n  type: \"step-started\";\n  stepIndex: number;\n  totalSteps: number;\n  stepName: string;\n  nodeType: string;\n  nodeId: string;\n}\n\ninterface NodeCompletedEvent {\n  type: \"completed\";\n  stepIndex?: number;\n  result: { success: boolean; errorMessage?: string; source?: string };\n}\n\ninterface RunCompleteEvent {\n  type: \"run-complete\";\n  stepsExecuted: number;\n  totalSteps: number;\n  stoppedEarly: boolean;\n  reason?: string;\n}\n\ntype DebugEvent =\n  | StepStartedEvent\n  | NodeCompletedEvent\n  | RunCompleteEvent\n  | { type: string; [key: string]: unknown };\n\nexport async function runDebugWorkflow(argv: string[]): Promise<void> {\n  const workflowId = argv.find((arg) => !arg.startsWith(\"-\"));\n\n  if (!workflowId) {\n    console.error(\"Usage: canary debug <workflowId> [--to-step N] [--env local|dev|prod]\");\n    process.exit(1);\n  }\n\n  const toStepStr = getArgValue(argv, \"--to-step\");\n  const toStep = toStepStr ? parseInt(toStepStr, 10) : undefined;\n  const verbose = hasFlag(argv, \"--verbose\", \"-v\");\n\n  if (toStep !== undefined && (isNaN(toStep) || toStep < 1)) {\n    console.error(\"Error: --to-step must be a positive integer\");\n    process.exit(1);\n  }\n\n  const { apiUrl, token } = await resolveConfig(argv);\n\n  // 1. Create local browser session\n  console.log(\"Creating local browser session...\");\n\n  let localSession: CreateSessionResponse;\n  try {\n    const res = await fetch(`${apiUrl}/local-browser/sessions`, {\n      method: \"POST\",\n      headers: {\n        \"Content-Type\": \"application/json\",\n        Authorization: `Bearer ${token}`,\n      },\n      body: JSON.stringify({ browserMode: \"playwright\" }),\n    });\n\n    if (!res.ok) {\n      const text = await res.text();\n      console.error(`Failed to create local browser session: ${res.status} ${text}`);\n      process.exit(1);\n    }\n\n    localSession = (await res.json()) as CreateSessionResponse;\n    if (!localSession.ok) {\n      console.error(`Failed to create session: ${localSession.error}`);\n      process.exit(1);\n    }\n  } catch (err) {\n    console.error(`Failed to connect to API: ${err}`);\n    process.exit(1);\n  }\n\n  // 2. Create debug session (before browser launch so we can download storage state)\n  console.log(\"Loading workflow...\");\n\n  let debugSession: DebugSessionResponse;\n  try {\n    const res = await fetch(`${apiUrl}/cli/debug/sessions`, {\n      method: \"POST\",\n      headers: {\n        \"Content-Type\": \"application/json\",\n        Authorization: `Bearer ${token}`,\n      },\n      body: JSON.stringify({\n        workflowId,\n        localBrowserSessionId: localSession.sessionId,\n      }),\n    });\n\n    if (!res.ok) {\n      const text = await res.text();\n      console.error(`Failed to create debug session: ${res.status} ${text}`);\n      process.exit(1);\n    }\n\n    debugSession = (await res.json()) as DebugSessionResponse;\n    if (!debugSession.ok || !debugSession.sessionId) {\n      console.error(`Failed to create debug session: ${debugSession.error}`);\n      process.exit(1);\n    }\n  } catch (err) {\n    console.error(`Failed to create debug session: ${err}`);\n    process.exit(1);\n  }\n\n  let debugSessionId: string | null = debugSession.sessionId;\n\n  // 3. Download storage state if the workflow has valid credentials\n  let storageStatePath: string | undefined;\n  if (debugSession.isAuthenticated && debugSession.credential) {\n    console.log(\"Downloading storage state...\");\n    storageStatePath = await downloadStorageState({\n      apiUrl,\n      token,\n      propertyId: debugSession.credential.propertyId,\n      credentialId: debugSession.credential.credentialId,\n      prefix: \"canary-debug-ss\",\n    });\n    if (storageStatePath) {\n      console.log(\"Storage state loaded.\");\n    } else {\n      console.warn(\"Could not download storage state, continuing without it.\");\n    }\n  }\n\n  // 4. Launch headed browser with storage state\n  console.log(\"Launching headed browser...\");\n\n  const host = new LocalBrowserHost({\n    apiUrl,\n    wsToken: localSession.wsToken,\n    sessionId: localSession.sessionId,\n    browserMode: \"playwright\",\n    headless: false,\n    storageStatePath,\n    onLog: (level, message, data) => {\n      if (verbose) {\n        const prefix = `[${level.toUpperCase()}]`;\n        if (data) {\n          console.log(prefix, message, data);\n        } else {\n          console.log(prefix, message);\n        }\n      }\n    },\n  });\n\n  // Set up cleanup\n  const cleanup = async () => {\n    console.log(\"\\nShutting down...\");\n\n    if (debugSessionId) {\n      try {\n        await fetch(`${apiUrl}/cli/debug/sessions/${debugSessionId}`, {\n          method: \"DELETE\",\n          headers: { Authorization: `Bearer ${token}` },\n        });\n      } catch {\n        // Ignore cleanup errors\n      }\n    }\n\n    if (storageStatePath) {\n      await fs.unlink(storageStatePath).catch(() => {});\n    }\n\n    await host.stop();\n    process.exit(0);\n  };\n\n  process.on(\"SIGINT\", () => void cleanup());\n  process.on(\"SIGTERM\", () => void cleanup());\n\n  try {\n    await host.start();\n  } catch (err) {\n    console.error(`Failed to start local browser: ${err}`);\n    await host.stop();\n    process.exit(1);\n  }\n\n  console.log(\"Browser connected.\");\n  console.log();\n\n  const nodes = debugSession.nodes ?? [];\n  const totalSteps = nodes.length;\n  const effectiveToStep = toStep ? Math.min(toStep, totalSteps) : totalSteps;\n\n  console.log(`Debugging: \"${debugSession.workflowName}\" (${totalSteps} steps)`);\n  if (toStep) {\n    console.log(`Running steps 1-${effectiveToStep} of ${totalSteps}`);\n  }\n  console.log();\n\n  // 5. Run steps via SSE\n  let runRes: Response;\n  try {\n    runRes = await fetch(`${apiUrl}/cli/debug/sessions/${debugSessionId}/run`, {\n      method: \"POST\",\n      headers: {\n        \"Content-Type\": \"application/json\",\n        Authorization: `Bearer ${token}`,\n        Accept: \"text/event-stream\",\n      },\n      body: JSON.stringify({ toStep: effectiveToStep }),\n    });\n  } catch (err) {\n    console.error(`Failed to start execution: ${err}`);\n    await cleanup();\n    return;\n  }\n\n  if (!runRes.ok || !runRes.body) {\n    console.error(`Failed to start execution: ${runRes.status}`);\n    await cleanup();\n    return;\n  }\n\n  // Track execution state\n  let currentStep = 0;\n  let hasError = false;\n  const stepResults = new Map<number, { name: string; success: boolean; source?: string }>();\n\n  const parser = createParser({\n    onEvent: (event: EventSourceMessage) => {\n      if (!event.data) return;\n\n      try {\n        const data = JSON.parse(event.data) as DebugEvent;\n\n        if (verbose) {\n          console.log(`[SSE] ${JSON.stringify(data)}`);\n        }\n\n        if (data.type === \"step-started\") {\n          const e = data as StepStartedEvent;\n          currentStep = e.stepIndex;\n          process.stdout.write(`[${e.stepIndex}/${e.totalSteps}] ${e.stepName} `);\n        }\n\n        if (data.type === \"completed\") {\n          const e = data as NodeCompletedEvent;\n          const stepIndex = e.stepIndex ?? currentStep;\n          const success = e.result.success;\n          const source = e.result.source;\n\n          if (success) {\n            const sourceLabel = source === \"cache\" ? \"(cache)\" : source === \"agent\" ? \"(agent)\" : \"\";\n            console.log(`\\u2713 ${sourceLabel}`);\n          } else {\n            console.log(\"\\u2717\");\n            if (e.result.errorMessage) {\n              console.log(`    Error: ${e.result.errorMessage.slice(0, 200)}`);\n            }\n            hasError = true;\n          }\n\n          stepResults.set(stepIndex, {\n            name: `Step ${stepIndex}`,\n            success,\n            source,\n          });\n        }\n\n        if (data.type === \"run-complete\") {\n          const e = data as RunCompleteEvent;\n          console.log();\n          if (e.stoppedEarly) {\n            console.log(\n              `Stopped at step ${e.stepsExecuted} of ${e.totalSteps}. ${e.reason === \"step-failed\" ? \"Step failed.\" : \"Error occurred.\"}`\n            );\n          } else {\n            console.log(\n              `All ${e.stepsExecuted} step(s) completed.`\n            );\n          }\n        }\n\n        if (data.type === \"run-error\") {\n          const errorData = data as { error?: string };\n          console.log(`\\u2717`);\n          if (errorData.error) {\n            console.log(`    Error: ${String(errorData.error).slice(0, 200)}`);\n          }\n          hasError = true;\n        }\n      } catch {\n        // Ignore parse errors\n      }\n    },\n  });\n\n  const reader = runRes.body.getReader();\n  const decoder = new TextDecoder();\n\n  try {\n    while (true) {\n      const { done, value } = await reader.read();\n      if (done) break;\n      parser.feed(decoder.decode(value, { stream: true }));\n    }\n  } finally {\n    reader.releaseLock();\n  }\n\n  // 6. Keep browser open for inspection\n  console.log();\n  console.log(\"Browser is open for inspection.\");\n  console.log(\"Press Ctrl+C to close.\");\n\n  // Keep the process running until Ctrl+C\n  await new Promise(() => {});\n}\n"],"mappings":"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","names":[]}

package/dist/{docs-RPFT7ZJB.js → docs-REHST3YB.js}

@@ -2,7 +2,7 @@ import { createRequire as __cr } from "module"; const require = __cr(import.meta
 import {
   apiRequest,
   fetchList
-} from "./chunk-6WWHXWCS.js";
+} from "./chunk-QLFSJG5O.js";
 import {
   getArgValue,
   hasFlag,
@@ -270,4 +270,4 @@ async function runDocs(argv) {
 export {
   runDocs
 };
-//# sourceMappingURL=docs-RPFT7ZJB.js.map
+//# sourceMappingURL=docs-REHST3YB.js.map

package/dist/{feature-flag-2FDSKOVX.js → feature-flag-3HB5NTMY.js}

@@ -4,12 +4,13 @@ import {
   fetchList,
   parseLifecycleStage,
   toLifecycleLabel
-} from "./chunk-6WWHXWCS.js";
+} from "./chunk-QLFSJG5O.js";
 import {
   getArgValue,
   hasFlag,
   resolveConfig
 } from "./chunk-PWWQGYFG.js";
+import "./chunk-XAA5VQ5N.js";
 import "./chunk-VKVL7WBN.js";
 
 // src/feature-flag.ts
@@ -276,4 +277,4 @@ async function runFeatureFlag(argv) {
 export {
   runFeatureFlag
 };
-//# sourceMappingURL=feature-flag-2FDSKOVX.js.map
+//# sourceMappingURL=feature-flag-3HB5NTMY.js.map

package/dist/{feature-flag-2FDSKOVX.js.map → feature-flag-3HB5NTMY.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/feature-flag.ts"],"sourcesContent":["/**\n * CLI Feature Flag Management\n *\n * Allows superadmins to manage feature flags via the CLI.\n */\n\nimport process from \"node:process\";\nimport { resolveConfig, getArgValue, hasFlag } from \"./auth.js\";\nimport {\n  type LifecycleStage,\n  toLifecycleLabel,\n  parseLifecycleStage,\n  apiRequest,\n  fetchList,\n} from \"./cli-helpers.js\";\n\ntype FeatureFlag = {\n  id: string;\n  name: string;\n  description: string | null;\n  lifecycleStage: LifecycleStage;\n  finalValue: boolean | null;\n  createdAt: string;\n  organizations?: Array<{\n    gateId: string;\n    orgId: string;\n    orgName: string;\n    createdAt: string;\n  }>;\n  users?: Array<{\n    gateId: string;\n    userId: string;\n    userEmail: string | null;\n    createdAt: string;\n  }>;\n};\n\ntype FlagApiResponse = {\n  ok: boolean;\n  error?: string;\n  flag?: FeatureFlag;\n};\n\nfunction fetchFlags(apiUrl: string, token: string): Promise<FeatureFlag[]> {\n  return fetchList<FeatureFlag>(apiUrl, token, \"/superadmin/feature-flags\", \"flags\");\n}\n\nasync function handleList(argv: string[], apiUrl: string, token: string): Promise<void> {\n  const jsonOutput = hasFlag(argv, \"--json\");\n  const flags = await fetchFlags(apiUrl, token);\n\n  if (jsonOutput) {\n    console.log(JSON.stringify(flags, null, 2));\n    return;\n  }\n\n  if (flags.length === 0) {\n    console.log(\"No feature flags found.\");\n    return;\n  }\n\n  for (const flag of flags) {\n    const orgCount = flag.organizations?.length ?? 0;\n    const userCount = flag.users?.length ?? 0;\n    const lifecycle = `lifecycle=${toLifecycleLabel(flag.lifecycleStage)}`;\n    const finalValue =\n      flag.lifecycleStage === \"active\" ? \"\" : ` final=${flag.finalValue === true ? \"true\" : \"false\"}`;\n    console.log(`  ${flag.name}  ${flag.description ?? \"\"}  (${lifecycle}${finalValue})  [orgs=${orgCount}, users=${userCount}]`);\n  }\n}\n\nasync function handleCreate(argv: string[], apiUrl: string, token: string): Promise<void> {\n  const name = argv[0];\n  if (!name || name.startsWith(\"--\")) {\n    console.error(\"Error: Missing flag name.\");\n    console.error(\"Usage: canary feature-flag create <name> [--description <text>]\");\n    process.exit(1);\n  }\n\n  const description = getArgValue(argv, \"--description\") ?? null;\n  const result = await apiRequest<FlagApiResponse>(apiUrl, token, \"POST\", \"/superadmin/feature-flags\", {\n    name,\n    description,\n  });\n\n  if (!result.ok) {\n    console.error(`Error: ${result.error}`);\n    process.exit(1);\n  }\n\n  console.log(`Created feature flag: ${name}`);\n}\n\nasync function handleDelete(argv: string[], apiUrl: string, token: string): Promise<void> {\n  const name = argv[0];\n  if (!name || name.startsWith(\"--\")) {\n    console.error(\"Error: Missing flag name.\");\n    console.error(\"Usage: canary feature-flag delete <name>\");\n    process.exit(1);\n  }\n\n  const result = await apiRequest<FlagApiResponse>(\n    apiUrl, token, \"DELETE\", `/superadmin/feature-flags/${encodeURIComponent(name)}`\n  );\n\n  if (!result.ok) {\n    console.error(`Error: ${result.error}`);\n    process.exit(1);\n  }\n\n  console.log(`Deleted feature flag: ${name}`);\n}\n\nasync function handleEnable(argv: string[], apiUrl: string, token: string): Promise<void> {\n  const name = argv[0];\n  const orgId = getArgValue(argv, \"--org\");\n  const userId = getArgValue(argv, \"--user\");\n\n  if (!name || name.startsWith(\"--\")) {\n    console.error(\"Error: Missing flag name.\");\n    console.error(\"Usage: canary feature-flag enable <name> (--org <orgId> | --user <userId>)\");\n    process.exit(1);\n  }\n\n  if (orgId && userId) {\n    console.error(\"Error: Provide either --org or --user, not both.\");\n    process.exit(1);\n  }\n\n  if (!orgId && !userId) {\n    console.error(\"Error: Provide either --org <orgId> or --user <userId>.\");\n    console.error(\"Usage: canary feature-flag enable <name> (--org <orgId> | --user <userId>)\");\n    process.exit(1);\n  }\n\n  if (orgId) {\n    const result = await apiRequest<FlagApiResponse>(\n      apiUrl, token, \"POST\",\n      `/superadmin/feature-flags/${encodeURIComponent(name)}/organizations/${encodeURIComponent(orgId)}`\n    );\n\n    if (!result.ok) {\n      console.error(`Error: ${result.error}`);\n      process.exit(1);\n    }\n\n    console.log(`Enabled ${name} for org ${orgId}`);\n  } else {\n    const result = await apiRequest<FlagApiResponse>(\n      apiUrl, token, \"POST\",\n      `/superadmin/feature-flags/${encodeURIComponent(name)}/users/${encodeURIComponent(userId!)}`\n    );\n\n    if (!result.ok) {\n      console.error(`Error: ${result.error}`);\n      process.exit(1);\n    }\n\n    console.log(`Enabled ${name} for user ${userId}`);\n  }\n}\n\nasync function handleDisable(argv: string[], apiUrl: string, token: string): Promise<void> {\n  const name = argv[0];\n  const orgId = getArgValue(argv, \"--org\");\n  const userId = getArgValue(argv, \"--user\");\n\n  if (!name || name.startsWith(\"--\")) {\n    console.error(\"Error: Missing flag name.\");\n    console.error(\"Usage: canary feature-flag disable <name> (--org <orgId> | --user <userId>)\");\n    process.exit(1);\n  }\n\n  if (orgId && userId) {\n    console.error(\"Error: Provide either --org or --user, not both.\");\n    process.exit(1);\n  }\n\n  if (!orgId && !userId) {\n    console.error(\"Error: Provide either --org <orgId> or --user <userId>.\");\n    console.error(\"Usage: canary feature-flag disable <name> (--org <orgId> | --user <userId>)\");\n    process.exit(1);\n  }\n\n  if (orgId) {\n    const result = await apiRequest<FlagApiResponse>(\n      apiUrl, token, \"DELETE\",\n      `/superadmin/feature-flags/${encodeURIComponent(name)}/organizations/${encodeURIComponent(orgId)}`\n    );\n\n    if (!result.ok) {\n      console.error(`Error: ${result.error}`);\n      process.exit(1);\n    }\n\n    console.log(`Disabled ${name} for org ${orgId}`);\n  } else {\n    const result = await apiRequest<FlagApiResponse>(\n      apiUrl, token, \"DELETE\",\n      `/superadmin/feature-flags/${encodeURIComponent(name)}/users/${encodeURIComponent(userId!)}`\n    );\n\n    if (!result.ok) {\n      console.error(`Error: ${result.error}`);\n      process.exit(1);\n    }\n\n    console.log(`Disabled ${name} for user ${userId}`);\n  }\n}\n\nasync function handleLifecycle(argv: string[], apiUrl: string, token: string): Promise<void> {\n  const name = argv[0];\n\n  if (!name || name.startsWith(\"--\")) {\n    console.error(\"Error: Missing flag name.\");\n    console.error(\"Usage: canary feature-flag lifecycle <name> --stage <active|deprecated|ready_for_cleanup> [--final-value true|false]\");\n    process.exit(1);\n  }\n\n  const stage = parseLifecycleStage(argv);\n  const rawFinalValue = getArgValue(argv, \"--final-value\");\n  const clearFinalValue = hasFlag(argv, \"--clear-final-value\");\n\n  if (rawFinalValue !== undefined && clearFinalValue) {\n    console.error(\"Error: use either --final-value or --clear-final-value, not both.\");\n    process.exit(1);\n  }\n\n  let finalValue: boolean | undefined = undefined;\n\n  if (stage === \"active\") {\n    if (rawFinalValue !== undefined) {\n      console.error(\"Error: active stage does not accept --final-value.\");\n      process.exit(1);\n    }\n    finalValue = undefined;\n  } else {\n    if (clearFinalValue) {\n      console.error(\"Error: --clear-final-value can only be used with --stage active.\");\n      process.exit(1);\n    }\n    if (!rawFinalValue) {\n      console.error(\"Error: --final-value true|false is required for deprecated or ready_for_cleanup.\");\n      process.exit(1);\n    }\n    if (rawFinalValue !== \"true\" && rawFinalValue !== \"false\") {\n      console.error(\"Error: --final-value must be true or false.\");\n      process.exit(1);\n    }\n    finalValue = rawFinalValue === \"true\";\n  }\n\n  const result = await apiRequest<FlagApiResponse>(\n    apiUrl, token, \"POST\",\n    `/superadmin/feature-flags/${encodeURIComponent(name)}/lifecycle`,\n    { stage, finalValue }\n  );\n\n  if (!result.ok || !result.flag) {\n    console.error(`Error: ${result.error ?? \"Failed to update lifecycle\"}`);\n    process.exit(1);\n  }\n\n  const final =\n    result.flag.lifecycleStage === \"active\"\n      ? \"(none)\"\n      : result.flag.finalValue === true\n        ? \"true\"\n        : \"false\";\n  console.log(`Updated lifecycle for ${name}: stage=${toLifecycleLabel(result.flag.lifecycleStage)}, final=${final}`);\n}\n\nfunction printFeatureFlagHelp(): void {\n  console.log(\n    [\n      \"Usage: canary feature-flag <sub-command> [options]\",\n      \"\",\n      \"Sub-commands:\",\n      \"  list                                          List all feature flags\",\n      \"  create <name> [--description <text>]         Create a new flag\",\n      \"  delete <name>                                 Delete a flag and all its gates\",\n      \"  enable <name> (--org <orgId> | --user <userId>)\",\n      \"                                                Enable a flag for an org or user\",\n      \"  disable <name> (--org <orgId> | --user <userId>)\",\n      \"                                                Disable a flag for an org or user\",\n      \"  lifecycle <name> --stage <stage> [--final-value true|false]\",\n      \"                                                Mark lifecycle + final value\",\n      \"\",\n      \"Stages: active, deprecated, ready_for_cleanup\",\n      \"\",\n      \"Options:\",\n      \"  --org <orgId>              Target organization\",\n      \"  --user <userId>            Target user\",\n      \"  --final-value <true|false>  Final value for deprecated/ready_for_cleanup\",\n      \"  --clear-final-value         Clear final value (only valid with --stage active)\",\n      \"  --env <env>                 Target environment (prod, dev, local)\",\n      \"  --json                      Output as JSON (list only)\",\n      \"  --api-url <url>             API URL override (takes precedence over --env)\",\n      \"  --token <key>               API token override\",\n    ].join(\"\\n\")\n  );\n}\n\nexport async function runFeatureFlag(argv: string[]): Promise<void> {\n  const [subCommand, ...rest] = argv;\n\n  if (!subCommand || subCommand === \"help\" || hasFlag(argv, \"--help\", \"-h\")) {\n    printFeatureFlagHelp();\n    return;\n  }\n\n  const { apiUrl, token } = await resolveConfig(argv);\n\n  switch (subCommand) {\n    case \"list\":\n      await handleList(rest, apiUrl, token);\n      break;\n    case \"create\":\n      await handleCreate(rest, apiUrl, token);\n      break;\n    case \"delete\":\n      await handleDelete(rest, apiUrl, token);\n      break;\n    case \"enable\":\n      await handleEnable(rest, apiUrl, token);\n      break;\n    case \"disable\":\n      await handleDisable(rest, apiUrl, token);\n      break;\n    case \"lifecycle\":\n      await handleLifecycle(rest, apiUrl, token);\n      break;\n    default:\n      console.error(`Unknown sub-command: ${subCommand}`);\n      printFeatureFlagHelp();\n      process.exit(1);\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/feature-flag.ts"],"sourcesContent":["/**\n * CLI Feature Flag Management\n *\n * Allows superadmins to manage feature flags via the CLI.\n */\n\nimport process from \"node:process\";\nimport { resolveConfig, getArgValue, hasFlag } from \"./auth.js\";\nimport {\n  type LifecycleStage,\n  toLifecycleLabel,\n  parseLifecycleStage,\n  apiRequest,\n  fetchList,\n} from \"./cli-helpers.js\";\n\ntype FeatureFlag = {\n  id: string;\n  name: string;\n  description: string | null;\n  lifecycleStage: LifecycleStage;\n  finalValue: boolean | null;\n  createdAt: string;\n  organizations?: Array<{\n    gateId: string;\n    orgId: string;\n    orgName: string;\n    createdAt: string;\n  }>;\n  users?: Array<{\n    gateId: string;\n    userId: string;\n    userEmail: string | null;\n    createdAt: string;\n  }>;\n};\n\ntype FlagApiResponse = {\n  ok: boolean;\n  error?: string;\n  flag?: FeatureFlag;\n};\n\nfunction fetchFlags(apiUrl: string, token: string): Promise<FeatureFlag[]> {\n  return fetchList<FeatureFlag>(apiUrl, token, \"/superadmin/feature-flags\", \"flags\");\n}\n\nasync function handleList(argv: string[], apiUrl: string, token: string): Promise<void> {\n  const jsonOutput = hasFlag(argv, \"--json\");\n  const flags = await fetchFlags(apiUrl, token);\n\n  if (jsonOutput) {\n    console.log(JSON.stringify(flags, null, 2));\n    return;\n  }\n\n  if (flags.length === 0) {\n    console.log(\"No feature flags found.\");\n    return;\n  }\n\n  for (const flag of flags) {\n    const orgCount = flag.organizations?.length ?? 0;\n    const userCount = flag.users?.length ?? 0;\n    const lifecycle = `lifecycle=${toLifecycleLabel(flag.lifecycleStage)}`;\n    const finalValue =\n      flag.lifecycleStage === \"active\" ? \"\" : ` final=${flag.finalValue === true ? \"true\" : \"false\"}`;\n    console.log(`  ${flag.name}  ${flag.description ?? \"\"}  (${lifecycle}${finalValue})  [orgs=${orgCount}, users=${userCount}]`);\n  }\n}\n\nasync function handleCreate(argv: string[], apiUrl: string, token: string): Promise<void> {\n  const name = argv[0];\n  if (!name || name.startsWith(\"--\")) {\n    console.error(\"Error: Missing flag name.\");\n    console.error(\"Usage: canary feature-flag create <name> [--description <text>]\");\n    process.exit(1);\n  }\n\n  const description = getArgValue(argv, \"--description\") ?? null;\n  const result = await apiRequest<FlagApiResponse>(apiUrl, token, \"POST\", \"/superadmin/feature-flags\", {\n    name,\n    description,\n  });\n\n  if (!result.ok) {\n    console.error(`Error: ${result.error}`);\n    process.exit(1);\n  }\n\n  console.log(`Created feature flag: ${name}`);\n}\n\nasync function handleDelete(argv: string[], apiUrl: string, token: string): Promise<void> {\n  const name = argv[0];\n  if (!name || name.startsWith(\"--\")) {\n    console.error(\"Error: Missing flag name.\");\n    console.error(\"Usage: canary feature-flag delete <name>\");\n    process.exit(1);\n  }\n\n  const result = await apiRequest<FlagApiResponse>(\n    apiUrl, token, \"DELETE\", `/superadmin/feature-flags/${encodeURIComponent(name)}`\n  );\n\n  if (!result.ok) {\n    console.error(`Error: ${result.error}`);\n    process.exit(1);\n  }\n\n  console.log(`Deleted feature flag: ${name}`);\n}\n\nasync function handleEnable(argv: string[], apiUrl: string, token: string): Promise<void> {\n  const name = argv[0];\n  const orgId = getArgValue(argv, \"--org\");\n  const userId = getArgValue(argv, \"--user\");\n\n  if (!name || name.startsWith(\"--\")) {\n    console.error(\"Error: Missing flag name.\");\n    console.error(\"Usage: canary feature-flag enable <name> (--org <orgId> | --user <userId>)\");\n    process.exit(1);\n  }\n\n  if (orgId && userId) {\n    console.error(\"Error: Provide either --org or --user, not both.\");\n    process.exit(1);\n  }\n\n  if (!orgId && !userId) {\n    console.error(\"Error: Provide either --org <orgId> or --user <userId>.\");\n    console.error(\"Usage: canary feature-flag enable <name> (--org <orgId> | --user <userId>)\");\n    process.exit(1);\n  }\n\n  if (orgId) {\n    const result = await apiRequest<FlagApiResponse>(\n      apiUrl, token, \"POST\",\n      `/superadmin/feature-flags/${encodeURIComponent(name)}/organizations/${encodeURIComponent(orgId)}`\n    );\n\n    if (!result.ok) {\n      console.error(`Error: ${result.error}`);\n      process.exit(1);\n    }\n\n    console.log(`Enabled ${name} for org ${orgId}`);\n  } else {\n    const result = await apiRequest<FlagApiResponse>(\n      apiUrl, token, \"POST\",\n      `/superadmin/feature-flags/${encodeURIComponent(name)}/users/${encodeURIComponent(userId!)}`\n    );\n\n    if (!result.ok) {\n      console.error(`Error: ${result.error}`);\n      process.exit(1);\n    }\n\n    console.log(`Enabled ${name} for user ${userId}`);\n  }\n}\n\nasync function handleDisable(argv: string[], apiUrl: string, token: string): Promise<void> {\n  const name = argv[0];\n  const orgId = getArgValue(argv, \"--org\");\n  const userId = getArgValue(argv, \"--user\");\n\n  if (!name || name.startsWith(\"--\")) {\n    console.error(\"Error: Missing flag name.\");\n    console.error(\"Usage: canary feature-flag disable <name> (--org <orgId> | --user <userId>)\");\n    process.exit(1);\n  }\n\n  if (orgId && userId) {\n    console.error(\"Error: Provide either --org or --user, not both.\");\n    process.exit(1);\n  }\n\n  if (!orgId && !userId) {\n    console.error(\"Error: Provide either --org <orgId> or --user <userId>.\");\n    console.error(\"Usage: canary feature-flag disable <name> (--org <orgId> | --user <userId>)\");\n    process.exit(1);\n  }\n\n  if (orgId) {\n    const result = await apiRequest<FlagApiResponse>(\n      apiUrl, token, \"DELETE\",\n      `/superadmin/feature-flags/${encodeURIComponent(name)}/organizations/${encodeURIComponent(orgId)}`\n    );\n\n    if (!result.ok) {\n      console.error(`Error: ${result.error}`);\n      process.exit(1);\n    }\n\n    console.log(`Disabled ${name} for org ${orgId}`);\n  } else {\n    const result = await apiRequest<FlagApiResponse>(\n      apiUrl, token, \"DELETE\",\n      `/superadmin/feature-flags/${encodeURIComponent(name)}/users/${encodeURIComponent(userId!)}`\n    );\n\n    if (!result.ok) {\n      console.error(`Error: ${result.error}`);\n      process.exit(1);\n    }\n\n    console.log(`Disabled ${name} for user ${userId}`);\n  }\n}\n\nasync function handleLifecycle(argv: string[], apiUrl: string, token: string): Promise<void> {\n  const name = argv[0];\n\n  if (!name || name.startsWith(\"--\")) {\n    console.error(\"Error: Missing flag name.\");\n    console.error(\"Usage: canary feature-flag lifecycle <name> --stage <active|deprecated|ready_for_cleanup> [--final-value true|false]\");\n    process.exit(1);\n  }\n\n  const stage = parseLifecycleStage(argv);\n  const rawFinalValue = getArgValue(argv, \"--final-value\");\n  const clearFinalValue = hasFlag(argv, \"--clear-final-value\");\n\n  if (rawFinalValue !== undefined && clearFinalValue) {\n    console.error(\"Error: use either --final-value or --clear-final-value, not both.\");\n    process.exit(1);\n  }\n\n  let finalValue: boolean | undefined = undefined;\n\n  if (stage === \"active\") {\n    if (rawFinalValue !== undefined) {\n      console.error(\"Error: active stage does not accept --final-value.\");\n      process.exit(1);\n    }\n    finalValue = undefined;\n  } else {\n    if (clearFinalValue) {\n      console.error(\"Error: --clear-final-value can only be used with --stage active.\");\n      process.exit(1);\n    }\n    if (!rawFinalValue) {\n      console.error(\"Error: --final-value true|false is required for deprecated or ready_for_cleanup.\");\n      process.exit(1);\n    }\n    if (rawFinalValue !== \"true\" && rawFinalValue !== \"false\") {\n      console.error(\"Error: --final-value must be true or false.\");\n      process.exit(1);\n    }\n    finalValue = rawFinalValue === \"true\";\n  }\n\n  const result = await apiRequest<FlagApiResponse>(\n    apiUrl, token, \"POST\",\n    `/superadmin/feature-flags/${encodeURIComponent(name)}/lifecycle`,\n    { stage, finalValue }\n  );\n\n  if (!result.ok || !result.flag) {\n    console.error(`Error: ${result.error ?? \"Failed to update lifecycle\"}`);\n    process.exit(1);\n  }\n\n  const final =\n    result.flag.lifecycleStage === \"active\"\n      ? \"(none)\"\n      : result.flag.finalValue === true\n        ? \"true\"\n        : \"false\";\n  console.log(`Updated lifecycle for ${name}: stage=${toLifecycleLabel(result.flag.lifecycleStage)}, final=${final}`);\n}\n\nfunction printFeatureFlagHelp(): void {\n  console.log(\n    [\n      \"Usage: canary feature-flag <sub-command> [options]\",\n      \"\",\n      \"Sub-commands:\",\n      \"  list                                          List all feature flags\",\n      \"  create <name> [--description <text>]         Create a new flag\",\n      \"  delete <name>                                 Delete a flag and all its gates\",\n      \"  enable <name> (--org <orgId> | --user <userId>)\",\n      \"                                                Enable a flag for an org or user\",\n      \"  disable <name> (--org <orgId> | --user <userId>)\",\n      \"                                                Disable a flag for an org or user\",\n      \"  lifecycle <name> --stage <stage> [--final-value true|false]\",\n      \"                                                Mark lifecycle + final value\",\n      \"\",\n      \"Stages: active, deprecated, ready_for_cleanup\",\n      \"\",\n      \"Options:\",\n      \"  --org <orgId>              Target organization\",\n      \"  --user <userId>            Target user\",\n      \"  --final-value <true|false>  Final value for deprecated/ready_for_cleanup\",\n      \"  --clear-final-value         Clear final value (only valid with --stage active)\",\n      \"  --env <env>                 Target environment (prod, dev, local)\",\n      \"  --json                      Output as JSON (list only)\",\n      \"  --api-url <url>             API URL override (takes precedence over --env)\",\n      \"  --token <key>               API token override\",\n    ].join(\"\\n\")\n  );\n}\n\nexport async function runFeatureFlag(argv: string[]): Promise<void> {\n  const [subCommand, ...rest] = argv;\n\n  if (!subCommand || subCommand === \"help\" || hasFlag(argv, \"--help\", \"-h\")) {\n    printFeatureFlagHelp();\n    return;\n  }\n\n  const { apiUrl, token } = await resolveConfig(argv);\n\n  switch (subCommand) {\n    case \"list\":\n      await handleList(rest, apiUrl, token);\n      break;\n    case \"create\":\n      await handleCreate(rest, apiUrl, token);\n      break;\n    case \"delete\":\n      await handleDelete(rest, apiUrl, token);\n      break;\n    case \"enable\":\n      await handleEnable(rest, apiUrl, token);\n      break;\n    case \"disable\":\n      await handleDisable(rest, apiUrl, token);\n      break;\n    case \"lifecycle\":\n      await handleLifecycle(rest, apiUrl, token);\n      break;\n    default:\n      console.error(`Unknown sub-command: ${subCommand}`);\n      printFeatureFlagHelp();\n      process.exit(1);\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/index.js

@@ -1000,10 +1000,11 @@ function isSuperadminToken(token) {
 // src/index.ts
 var require2 = createRequire2(import.meta.url);
 var pkg = require2("../package.json");
-var loadMcp = () => import("./mcp-4JVLADZL.js").then((m) => m.runMcp);
-var loadLocalBrowser = () => import("./local-browser-X7J27IGS.js").then((m) => m.runLocalBrowser);
-var loadDebugWorkflow = () => import("./debug-workflow-55G4Y6YT.js").then((m) => m.runDebugWorkflow);
-var loadRecord = () => import("./record-4OX7HXWQ.js").then((m) => m.runRecord);
+var loadMcp = () => import("./mcp-ZOKM2AUE.js").then((m) => m.runMcp);
+var loadLocalBrowser = () => import("./local-browser-MKTJ36KY.js").then((m) => m.runLocalBrowser);
+var loadDebugWorkflow = () => import("./debug-workflow-I3F36JBL.js").then((m) => m.runDebugWorkflow);
+var loadRecord = () => import("./record-TNDBT3NY.js").then((m) => m.runRecord);
+var loadSession = () => import("./session-RNLKFS2Z.js").then((m) => m.runSession);
 var canary = { run };
 var baseDir = typeof __dirname !== "undefined" ? __dirname : path4.dirname(fileURLToPath2(import.meta.url));
 var preloadPath = path4.join(baseDir, "runner", "preload.js");
@@ -1048,7 +1049,9 @@ function printHelp({ isSuperadmin }) {
     "  canary orgs                            List organizations",
     "  canary debug <workflowId> [options]    Debug workflow in local headed browser",
     "  canary record [options]                 Record browser interactions",
-    "  canary issues <sub-command>            Search and view issues"
+    "  canary session <sub-command>           Manage local browser sessions",
+    "  canary issues <sub-command>            Search and view issues",
+    "  canary skill <name>                    Output an AI agent skill template"
   ];
   lines.push(
     "  canary release <sub-command>            Release QA gate (CI/CD)"
@@ -1280,6 +1283,11 @@ async function main(argv) {
     await runRecord(rest);
     return;
   }
+  if (command === "session") {
+    const runSession = await loadSession();
+    await runSession(rest);
+    return;
+  }
   if (command === "debug-session") {
     await runDebugSession(rest);
     return;
@@ -1300,25 +1308,30 @@ async function main(argv) {
     return;
   }
   if (command === "docs") {
-    const { runDocs } = await import("./docs-RPFT7ZJB.js");
+    const { runDocs } = await import("./docs-REHST3YB.js");
     await runDocs(rest);
     return;
   }
   if (command === "feature-flag") {
-    const { runFeatureFlag } = await import("./feature-flag-2FDSKOVX.js");
+    const { runFeatureFlag } = await import("./feature-flag-3HB5NTMY.js");
     await runFeatureFlag(rest);
     return;
   }
   if (command === "knobs") {
-    const { runKnobs } = await import("./knobs-MZRTYS3P.js");
+    const { runKnobs } = await import("./knobs-QJ4IBLCT.js");
     await runKnobs(rest);
     return;
   }
   if (command === "issues") {
-    const { runIssues } = await import("./issues-6ZDNDSD6.js");
+    const { runIssues } = await import("./issues-YU57CHXS.js");
     await runIssues(rest);
     return;
   }
+  if (command === "skill" || command === "skills") {
+    const { runSkill } = await import("./skill-CZ7SHI3P.js");
+    await runSkill(rest);
+    return;
+  }
   console.log(`Unknown command "${command}".`);
   printHelp({ isSuperadmin: await resolveIsSuperadmin() });
   process7.exit(1);