@withandeo/cli 0.19.21 → 0.19.23

package/dist/main.js

@@ -116,8 +116,20 @@ async function execute(topic, options, cwd, runtime) {
     }
     if (topic.startsWith("workflows "))
         return { value: await workflowCommand(topic.slice(10), cwd, options, runtime) };
-    if (topic.startsWith("email "))
-        return { value: await emailCommand(topic.slice(6), cwd, options, runtime) };
+    if (topic.startsWith("email ")) {
+        const action = topic.slice(6), value = await emailCommand(action, cwd, options, runtime);
+        if (!options.json && action === "list" && isRecord(value) && Array.isArray(value.inboxes)) {
+            const inboxes = value.inboxes.filter(isRecord);
+            const safeText = (value) => typeof value === "string" ? value.replace(/\r\n?/gu, "\n").replace(/\t/gu, " ")
+                .split("\n").map(line => line.replace(/[\p{Cc}\p{Cf}\p{Zl}\p{Zp}]/gu, "")).join("\n") : "";
+            const lines = inboxes.map(inbox => {
+                const note = safeText(inbox.usageNote);
+                return `${safeText(inbox.address)} (${safeText(inbox.id)})${note ? `\n  ${note.replaceAll("\n", "\n  ")}` : ""}`;
+            });
+            return { raw: lines.length ? lines.join("\n") : "No active inboxes available." };
+        }
+        return { value };
+    }
     if (topic.startsWith("agents "))
         return { value: await agentsCommand(topic.slice(7), cwd, options, runtime) };
     if (topic.startsWith("flagship "))
@@ -409,7 +421,7 @@ async function execute(topic, options, cwd, runtime) {
         case "delivery retry":
             return { value: await deliveryRetry(cwd, options, runtime) };
         default:
-            throw new CliError("command_unknown", `Unknown command: ${topic}.`, "tender-accounts --help");
+            throw new CliError("command_unknown", `Unknown command: ${topic}.`, "andeo --help");
     }
 }
 async function agentsCommand(action, cwd, options, runtime) {
@@ -476,7 +488,13 @@ async function emailCommand(action, cwd, options, runtime) {
     }
     if (action === "capabilities")
         return client.email(tenantId, ["capabilities"]);
-    if (!principal.projects.some(p => p.role === "developer"))
+    const persistent = principal.actorKind === "persistent_agent";
+    if (action === "default") {
+        if (!persistent)
+            throw new CliError("email_default_run_required", "Only persistent agent runs have a default inbox.", "Use andeo email list --json.");
+        return client.email(tenantId, ["default"]);
+    }
+    if (!persistent && !principal.projects.some(p => p.role === "developer"))
         throw new CliError("developer_required", "Developer access to an app in this merchant is required to access email.");
     if (action === "create")
         return client.email(tenantId, [], { body: {
@@ -495,7 +513,15 @@ async function emailCommand(action, cwd, options, runtime) {
         return client.email(tenantId, [inboxId, "messages", "list"], { query: {
                 ...filters, ...Object.fromEntries(["after", "limit"].flatMap(key => options.flags.has(key) ? [[key, options.flags.get(key)]] : [])),
             } });
-    return waitForEmail(client, tenantId, inboxId, after, timeout, runtime, Date.now, filters);
+    try {
+        return await waitForEmail(client, tenantId, inboxId, after, timeout, runtime, Date.now, filters);
+    }
+    catch (error) {
+        if (persistent && error instanceof CliError && ["email_inbox_not_found", "email_inbox_inactive"].includes(error.code)) {
+            throw new CliError(error.code, error.message, "Run andeo email default --json. If the inbox changed, capture a new cursor and restart sign-in.");
+        }
+        throw error;
+    }
 }
 async function workflowCommand(action, cwd, options, runtime) {
     const context = await optionalContext(cwd);
@@ -1010,7 +1036,7 @@ async function sourcePull(cwd, options, runtime) {
 async function compatibleManagedSourceContext(appRoot, projectId, apiUrl) {
     const context = await loadProjectContext(appRoot).catch((error) => {
         if (error instanceof CliError && error.code === "file_missing") {
-            throw new CliError("source_checkout_config_missing", `The connected repository does not contain tender-accounts.json at ${appRoot}.`, "Ask a merchant administrator to repair the managed source working directory before continuing.");
+            throw new CliError("source_checkout_config_missing", `The connected repository does not contain andeo.json or legacy tender-accounts.json at ${appRoot}.`, "Ask a merchant administrator to repair the managed source working directory before continuing.");
         }
         throw error;
     });
@@ -1678,7 +1704,7 @@ function assertGitBranchName(branch) {
 }
 function safeRepositoryName(value) {
     const normalized = value.replaceAll(/[^A-Za-z0-9._-]+/gu, "-").replace(/^-+|-+$/gu, "");
-    return normalized.length >= 2 ? normalized.slice(0, 100) : "tender-app";
+    return normalized.length >= 2 ? normalized.slice(0, 100) : "andeo-app";
 }
 async function tail(cwd, options, runtime) {
     const context = await loadProjectContext(cwd);
@@ -1968,7 +1994,7 @@ function assertNoEnvironmentCredentialForProfileManagement(environment) {
     }
     if (!environment.TENDER_ACCOUNTS_TOKEN)
         return;
-    throw new CliError("auth_profile_environment_override", "TENDER_ACCOUNTS_TOKEN overrides local auth profiles, so profile management is disabled for this command.", "Unset TENDER_ACCOUNTS_TOKEN, then retry the auth profile command.");
+    throw new CliError("auth_profile_environment_override", "ANDEO_TOKEN (or legacy TENDER_ACCOUNTS_TOKEN) overrides local auth profiles, so profile management is disabled for this command.", "Unset ANDEO_TOKEN and TENDER_ACCOUNTS_TOKEN, then retry the auth profile command.");
 }
 async function authLogout(_cwd, options, runtime) {
     if (runtime.environment.ANDEO_NETWORK_TOKEN !== undefined || runtime.environment.ANDEO_CLOUD_BOOTSTRAP !== undefined) {
@@ -2131,7 +2157,7 @@ async function runDev(cwd, options, runtime) {
         return { value: { status: "stopped", workflowExecution: "local" } };
     }
     if (!context.config.commands.dev) {
-        throw new CliError("dev_command_missing", "This app does not declare commands.dev in tender-accounts.json.");
+        throw new CliError("dev_command_missing", "This app does not declare commands.dev in its Andeo configuration.");
     }
     await runtime.runProjectCommand({
         command: context.config.commands.dev,
@@ -2144,7 +2170,7 @@ async function runDev(cwd, options, runtime) {
 async function runBuildStage(cwd, options, runtime, stage, extraEnvironment = {}) {
     const context = await loadProjectContext(cwd);
     const command = context.config.commands[stage];
-    runtime.stderr.write(`tender-accounts: ${stage}\n`);
+    runtime.stderr.write(`andeo: ${stage}\n`);
     await runtime.runProjectCommand({
         command,
         cwd: context.root,
@@ -2755,7 +2781,7 @@ function exampleConfig() {
         commands: {
             dev: "npm run dev",
             check: "npm run check",
-            package: "npm run pack:tender",
+            package: "npm run pack:andeo",
         },
         artifactDirectory: ".tender/artifacts/current",
         returnPath: "/account",
@@ -2959,6 +2985,7 @@ function assertAllowedOptions(topic, options) {
         docs: common,
         capabilities: [...common, ...authentication, "project"],
         "email capabilities": [...common, ...authentication, "tenant", "project"],
+        "email default": [...common, ...authentication, "tenant", "project"],
         "email create": [...common, ...authentication, "tenant", "project", "name", "expires-in"],
         "email list": [...common, ...authentication, "tenant", "project"],
         "email cursor": [...common, ...authentication, "tenant", "project", "inbox"],
@@ -3113,7 +3140,7 @@ function assertAllowedOptions(topic, options) {
     const provided = [...options.flags.keys(), ...options.booleans];
     const unexpected = provided.find((name) => !accepted.has(name));
     if (unexpected) {
-        throw new CliError("argument_unknown", `Option --${unexpected} is not valid for ${topic}.`, `tender-accounts ${topic} --help`);
+        throw new CliError("argument_unknown", `Option --${unexpected} is not valid for ${topic}.`, `andeo ${topic} --help`);
     }
     const positionalLimits = {
         docs: { minimum: 0, maximum: 1 },
@@ -3132,10 +3159,10 @@ function assertAllowedOptions(topic, options) {
     };
     const limit = positionalLimits[topic] ?? { minimum: 0, maximum: 0 };
     if (options.positionals.length < limit.minimum) {
-        throw new CliError("argument_required", `Missing ${topic.startsWith("auth ") ? "profile name" : "argument"}.`, `tender-accounts ${topic} --help`);
+        throw new CliError("argument_required", `Missing ${topic.startsWith("auth ") ? "profile name" : "argument"}.`, `andeo ${topic} --help`);
     }
     if (options.positionals.length > limit.maximum) {
-        throw new CliError("argument_unexpected", `Unexpected argument: ${options.positionals[limit.maximum] ?? ""}.`, `tender-accounts ${topic} --help`);
+        throw new CliError("argument_unexpected", `Unexpected argument: ${options.positionals[limit.maximum] ?? ""}.`, `andeo ${topic} --help`);
     }
 }
 function requiredPositional(options, index, label) {
@@ -3234,7 +3261,7 @@ Agents are separate from human login profiles; agent task credentials cannot man
         return `Usage: andeo agent <status|complete|cancel> [--json]
 
 Inspect or end this Cloud task's exact admitted run. Complete and cancel remove local task keys only after Andeo confirms the outcome. A completed, cancelled or expired task cannot re-admit with the same state directory.
-Requires the Cloud bootstrap placeholder, dedicated admission origin, private task state directory, explicit scope and run duration. Human profiles and legacy tokens cannot be combined with Cloud mode.`;
+Requires the Cloud bootstrap placeholder and a private task state directory. Task scope and run duration are optional. Set ANDEO_AGENT_QA_EMAIL=on or off before admission to override assigned inbox eligibility. Human profiles and legacy tokens cannot be combined with Cloud mode.`;
     if (topic?.startsWith("config autoupgrade "))
         topic = "config autoupgrade";
     if (topic === "flagship")
@@ -3255,11 +3282,12 @@ Flag deletion requires a disabled saved flag and exact --confirm KEY after clean
     if (topic === "artifact" || topic === "artifact finalize")
         return "Usage: andeo artifact finalize --artifact-directory DIR [--json]\n\nFinalize workflow coordinators and native Flagship declarations after producer packaging, retaining the attested source revision. Runs offline in the build checkout.";
     if (topic === "email" || topic?.startsWith("email "))
-        return `Usage: andeo email <capabilities|create|list|cursor|wait|read|messages|retire> [options]
+        return `Usage: andeo email <capabilities|default|create|list|cursor|wait|read|messages|retire> [options]
 
 Create: [--name shop-test] [--expires-in 1h]. Without expiration the address is persistent.
-List: discover active inboxes shared across the selected merchant's apps.
-Capabilities: inspect merchant email availability, permissions, and limits.
+Default: find this persistent run's assigned QA inbox and usage note.
+List: discover the active inboxes and usage notes this login or run can read.
+Capabilities: inspect email availability, read scope, permissions, and limits.
 Cursor: --inbox INBOX_ID. Capture this BEFORE triggering the external email.
 Wait: --inbox INBOX_ID --after CURSOR [--timeout 120s]. Maximum wait: 10 minutes.
 Read: --inbox INBOX_ID --message MESSAGE_ID.
@@ -3377,7 +3405,7 @@ Account workflow entitlement is required for new starts. Run status is authorita
         "skills get": "Usage: andeo skills get SKILL_ID [--profile NAME] [--api-url URL] [--json]\n\nRead one skill entrypoint for the current invocation.\n\nExample:\n  andeo skills get guardrailed-design-system",
         "skills file": "Usage: andeo skills file SKILL_ID --path PATH [--profile NAME] [--api-url URL] [--json]\n\nRead one catalog-listed supporting file for the current invocation.\n\nExample:\n  andeo skills file recharge-customer-operations --path references/subscriptions.md",
         config: "Usage: andeo config example [--json]\n       andeo config autoupgrade <on|off|status> [--json]",
-        "config example": "Usage: andeo config example [--json]\n\nPrint the committed tender-accounts.json contract.",
+        "config example": "Usage: andeo config example [--json]\n\nPrint the andeo.json contract (legacy tender-accounts.json is also supported).",
     };
     if (topic && topics[topic])
         return topics[topic];