@run402/sdk 4.93.2 → 4.95.0

package/dist/node/actions-node.js

@@ -157,10 +157,10 @@ export class NodeActions {
     }
     async #runTierSet(input, run) {
         if (this.#targetKind() === "core") {
-            throw run.error("Tier subscriptions are a Run402 Cloud capability and are skipped on Run402 Core targets.", "RUN402_CLOUD_ACTION_UNAVAILABLE", { action: input.type, target: this.#targetKind() });
+            throw run.error("Tier leases are a Run402 Cloud capability and are skipped on Run402 Core targets.", "RUN402_CLOUD_ACTION_UNAVAILABLE", { action: input.type, target: this.#targetKind() });
         }
         if (run.autoPrerequisites) {
-            await this.#ensureAllowance(run);
+            await this.#ensureWallet(run);
         }
         const idempotencyKey = input.idempotencyKey ?? run.rootIdempotencyKey;
         const step = run.addStep({
@@ -170,7 +170,7 @@ export class NodeActions {
             auto: false,
             details: { tier: input.tier, idempotency_key: idempotencyKey ?? null },
         });
-        await run.approve(step, ["tier.set"], `Subscribe, renew, or upgrade the ${input.tier} tier.`);
+        await run.approve(step, ["tier.set"], `Set the ${input.tier} tier (start, renew, or upgrade).`);
         if (run.dryRun) {
             run.setState(step, "planned");
             return run.result({});
@@ -190,7 +190,7 @@ export class NodeActions {
         // exactly this purpose and NOTHING read it, so every `run402 up <git-url>`
         // left its full checkout in the OS temp dir — silently, on success and on
         // failure alike. An agent looping deploys (CI, retries) grows /tmp without
-        // bound, and on a fixed-allowance container that eventually fails writes
+        // bound, and on a fixed-wallet container that eventually fails writes
         // with no hint at the cause.
         // Local-directory sources set no cleanupDir and are never touched here.
         try {
@@ -264,7 +264,7 @@ export class NodeActions {
                 manifest_path: manifest.manifestPath,
                 preflight: describeLocalPreflight({ appRoot: workspaceDir, manifestPath: manifest.manifestPath, target: target, authoring: manifest.loaded?.manifest, spec: manifest.releaseSpec, apiBase: this.sdk.apiBase, profile: this.opts.profile }),
                 ...(run.executionMode === "printManifest" ? { manifest: serializeDeployManifest(manifest.loaded, workspaceDir, input.projectId) } : {}),
-                ...(run.executionMode === "printSpec" ? { spec: { ...manifest.releaseSpec, project: target?.project_id ?? undefined } } : {}),
+                ...(run.executionMode === "printSpec" ? { spec: { ...manifest.releaseSpec, project_id: target?.project_id ?? undefined } } : {}),
             });
         }
         if (run.executionMode === "plan") {
@@ -282,7 +282,7 @@ export class NodeActions {
         else {
             run.skipStep({
                 action: Run402Action.TierSet,
-                description: "Skip Cloud allowance and tier prerequisites for Run402 Core",
+                description: "Skip Cloud wallet and tier prerequisites for Run402 Core",
                 mutation: false,
                 auto: true,
                 details: { target: this.#targetKind() },
@@ -499,7 +499,7 @@ export class NodeActions {
                 }
                 run.skipStep({
                     action: "identity.name.set",
-                    description: "No display name is known for this principal; nothing was written (set RUN402_AGENT_NAME=<name>, RUN402_CLIENT=<client>, or run `run402 org whoami --set-name <name>`)",
+                    description: "No display name is known for this principal; nothing was written (set RUN402_AGENT_NAME=<name>, RUN402_CLIENT=<client>, or run `run402 whoami --set-name <name>`)",
                     mutation: false,
                     auto: true,
                     details: { source: "undetected", detected: null },
@@ -514,7 +514,7 @@ export class NodeActions {
                 auto: true,
                 details: { display_name: desired, source, detected: detectedName },
             });
-            await run.approve(step, ["identity.name.set"], `Name this principal "${desired}" (promotion credit and room presence use it; change any time with run402 org whoami --set-name).`);
+            await run.approve(step, ["identity.name.set"], `Name this principal "${desired}" (promotion credit and room presence use it; change any time with run402 whoami --set-name).`);
             run.setState(step, "running");
             try {
                 const updated = await this.sdk.orgs.setDisplayName(desired);
@@ -531,7 +531,7 @@ export class NodeActions {
             // so, write nothing (an existing name is never overwritten by a guess).
             run.skipStep({
                 action: "identity.name.set",
-                description: `Detected client "${detectedName}" but the principal is already named "${displayName}"; nothing written — set RUN402_AGENT_NAME=<name> or run \`run402 org whoami --set-name <name>\` to rename`,
+                description: `Detected client "${detectedName}" but the principal is already named "${displayName}"; nothing written — set RUN402_AGENT_NAME=<name> or run \`run402 whoami --set-name <name>\` to rename`,
                 mutation: false,
                 auto: true,
                 details: { source: "existing", display_name: displayName, detected: detectedName, reason: "name_already_set" },
@@ -760,7 +760,7 @@ export class NodeActions {
         run.setState(step, "succeeded", {
             manifest_kind: "release",
             manifest_path: manifestPath,
-            project_id: loaded.spec.project === "prj_up_preflight_placeholder" ? null : loaded.spec.project,
+            project_id: loaded.spec.project_id === "prj_up_preflight_placeholder" ? null : loaded.spec.project_id,
             idempotency_key: loaded.idempotencyKey ?? null,
         });
         return {
@@ -769,9 +769,9 @@ export class NodeActions {
             releaseSpec: loaded.spec,
             loaded,
             idempotencyKey: loaded.idempotencyKey,
-            manifestProjectId: loaded.spec.project === "prj_up_preflight_placeholder"
+            manifestProjectId: loaded.spec.project_id === "prj_up_preflight_placeholder"
                 ? undefined
-                : loaded.spec.project,
+                : loaded.spec.project_id,
             ...(loaded.verify ? { verify: loaded.verify } : {}),
         };
     }
@@ -1583,7 +1583,7 @@ export class NodeActions {
                     diagnostic: {
                         error: "missing_public_origin",
                         message,
-                        hint: "Path checks resolve against the project's public origin. Use an absolute `url` in the check, or deploy/claim a subdomain so the project has a site URL.",
+                        hint: "Path checks resolve against the project's public origin. Use an absolute `url` in the check, or deploy/add a subdomain so the project has a site URL.",
                     },
                 });
                 diagnostics.push({
@@ -1592,7 +1592,7 @@ export class NodeActions {
                     node_id: `verify.http.${check.id}`,
                     message,
                 });
-                nextAction ??= claimSubdomainNextAction(context.projectName ?? null, check.id);
+                nextAction ??= addSubdomainNextAction(context.projectName ?? null, check.id);
                 continue;
             }
             const retries = Math.max(1, check.retries ?? 1);
@@ -1717,12 +1717,12 @@ export class NodeActions {
             propagationWaitMs,
         };
     }
-    async #ensureAllowance(run, opts = { fund: false }) {
-        const status = await this.sdk.allowance.status();
+    async #ensureWallet(run, opts = { fund: false }) {
+        const status = await this.sdk.wallets.status();
         if (status.configured) {
             run.skipStep({
-                action: "allowance.create",
-                description: "Local allowance already exists",
+                action: "wallets.create",
+                description: "Local wallet already exists",
                 mutation: false,
                 auto: true,
                 details: { address: status.address, path: status.path ?? null },
@@ -1732,8 +1732,8 @@ export class NodeActions {
             const balance = await prototypeBalance(status.address);
             if (balance > 0n) {
                 run.skipStep({
-                    action: "allowance.faucet",
-                    description: "Allowance already has Base Sepolia USDC",
+                    action: "wallets.faucet",
+                    description: "Wallet already has Base Sepolia USDC",
                     mutation: false,
                     auto: true,
                     details: { address: status.address, balance_usd_micros: balance.toString() },
@@ -1743,18 +1743,18 @@ export class NodeActions {
         }
         else {
             const createStep = run.addStep({
-                action: "allowance.create",
-                description: "Create local allowance",
+                action: "wallets.create",
+                description: "Create local wallet",
                 mutation: true,
                 auto: true,
             });
-            await run.approve(createStep, ["allowance.create"], "Create a local allowance wallet.");
+            await run.approve(createStep, ["wallets.create"], "Create a local wallet.");
             if (run.dryRun) {
                 run.setState(createStep, "planned");
                 return false;
             }
             run.setState(createStep, "running");
-            const created = await this.sdk.allowance.create();
+            const created = await this.sdk.wallets.create();
             run.setState(createStep, "succeeded", {
                 address: created.address,
                 path: created.path ?? null,
@@ -1763,20 +1763,20 @@ export class NodeActions {
                 return false;
         }
         const faucetStep = run.addStep({
-            action: "allowance.faucet",
-            description: "Request testnet faucet funds for allowance",
+            action: "wallets.faucet",
+            description: "Request testnet faucet funds for wallet",
             mutation: true,
             auto: true,
-            details: { idempotency_key: run.childKey("allowance.faucet") },
+            details: { idempotency_key: run.childKey("wallets.faucet") },
         });
-        await run.approve(faucetStep, ["allowance.faucet"], "Request testnet USDC for the local allowance.");
+        await run.approve(faucetStep, ["wallets.faucet"], "Request testnet USDC for the local wallet.");
         if (run.dryRun) {
             run.setState(faucetStep, "planned");
             return false;
         }
         run.setState(faucetStep, "running");
-        const faucet = await this.sdk.allowance.faucet({
-            idempotencyKey: run.childKey("allowance.faucet"),
+        const faucet = await this.sdk.wallets.faucet({
+            idempotencyKey: run.childKey("wallets.faucet"),
         });
         run.setState(faucetStep, "succeeded", {
             transaction_hash: faucet.transactionHash,
@@ -1786,15 +1786,15 @@ export class NodeActions {
         return true;
     }
     async #ensureCloudTier(run, desiredTier) {
-        await this.#ensureAllowance(run, { fund: false });
+        await this.#ensureWallet(run, { fund: false });
         if (run.dryRun) {
             const faucetStep = run.addStep({
-                action: "allowance.faucet",
+                action: "wallets.faucet",
                 description: "Request testnet faucet funds if tier payment is needed",
                 mutation: true,
                 auto: true,
             });
-            await run.approve(faucetStep, ["allowance.faucet"], "Request testnet USDC if tier bootstrap needs payment.");
+            await run.approve(faucetStep, ["wallets.faucet"], "Request testnet USDC if tier bootstrap needs payment.");
             run.setState(faucetStep, "planned");
             const step = run.addStep({
                 action: Run402Action.TierSet,
@@ -1807,7 +1807,7 @@ export class NodeActions {
                     reason: "dry_run",
                 },
             });
-            await run.approve(step, ["tier.set"], `Subscribe to ${desiredTier} if no active tier exists.`);
+            await run.approve(step, ["tier.set"], `Set the ${desiredTier} tier if no active tier exists.`);
             run.setState(step, "planned");
             return;
         }
@@ -1840,7 +1840,7 @@ export class NodeActions {
             return;
         }
         const idempotencyKey = run.childKey("tier.set");
-        const justFunded = await this.#ensureAllowance(run, { fund: true });
+        const justFunded = await this.#ensureWallet(run, { fund: true });
         const step = run.addStep({
             action: Run402Action.TierSet,
             description: `Ensure active ${desiredTier} tier`,
@@ -1853,7 +1853,7 @@ export class NodeActions {
                 idempotency_key: idempotencyKey,
             },
         });
-        await run.approve(step, ["tier.set"], `Subscribe, renew, or upgrade to ${desiredTier}.`);
+        await run.approve(step, ["tier.set"], `Set the ${desiredTier} tier (start, renew, or upgrade).`);
         run.setState(step, "running");
         const pay = () => this.sdk.tier.set(desiredTier, { idempotencyKey });
         const result = await (justFunded ? afterFaucet(pay) : pay());
@@ -2469,7 +2469,7 @@ function propagationWarning(checkId, url, classification, remainingMs) {
     };
 }
 /**
- * Slug a human project name into a claimable `<name>.run402.com` label
+ * Slug a human project name into an addable `<name>.run402.com` label
  * (3-63 chars, lowercase alphanumeric + hyphens), or null when it cannot be.
  */
 export function subdomainSlugFromProjectName(name) {
@@ -2487,18 +2487,18 @@ export function subdomainSlugFromProjectName(name) {
 /**
  * The `missing_public_origin` remedy: a path check cannot resolve without a
  * public origin, and the fix is to bind a subdomain — either right now via
- * `run402 subdomains claim <name>` (which binds the live release with no
+ * `run402 subdomains add <name>` (which binds the live release with no
  * further flags) or declaratively in the manifest's `subdomains.set`.
  */
-export function claimSubdomainNextAction(projectName, checkId) {
+export function addSubdomainNextAction(projectName, checkId) {
     const name = subdomainSlugFromProjectName(projectName) ?? "<name>";
     return {
-        type: "claim_subdomain",
+        type: "add_subdomain",
         code: "VERIFY_FAILED",
         node_id: `verify.http.${checkId}`,
-        message: `The project has no public origin, so path checks cannot resolve. Claim a subdomain with \`run402 subdomains claim ${name}\` (binds the live release), or add \`"subdomains": { "set": ["${name}"] }\` to the deploy manifest and redeploy; then rerun \`run402 up verify\`.`,
-        command: `run402 subdomains claim ${name}`,
-        argv: ["run402", "subdomains", "claim", name],
+        message: `The project has no public origin, so path checks cannot resolve. Claim a subdomain with \`run402 subdomains add ${name}\` (binds the live release), or add \`"subdomains": { "set": ["${name}"] }\` to the deploy manifest and redeploy; then rerun \`run402 up verify\`.`,
+        command: `run402 subdomains add ${name}`,
+        argv: ["run402", "subdomains", "add", name],
     };
 }
 function verifyNextAction() {
@@ -3055,7 +3055,7 @@ async function nearbyBinding(manifestPath) {
     try {
         const manifest = JSON.parse(await readFile(manifestPath, "utf-8"));
         const link = await readWorkspaceProjectLink(join(dirname(manifestPath), ".run402", "project.json"));
-        return { app_name: manifest.app?.name ?? manifest.app?.id ?? null, manifest_project_id: typeof manifest.project === "string" ? manifest.project : manifest.project_id ?? manifest.project?.id ?? null, linked_project_id: link?.project_id ?? null, target: link?.target ?? null };
+        return { app_name: manifest.app?.name ?? manifest.app?.id ?? null, manifest_project_id: manifest.project_id ?? manifest.project?.id ?? null, linked_project_id: link?.project_id ?? null, target: link?.target ?? null };
     }
     catch {
         return { status: "unknown", reason: "Local binding could not be read; select the application and run its check." };