@agentuity/cli 3.0.0-alpha.7 → 3.0.0-beta.0

package/dist/cmd/cloud/deploy/discover.js

@@ -0,0 +1,85 @@
+/**
+ * Discover phase
+ * --------------
+ *
+ * Validates that the current directory looks like something we can deploy
+ * and runs framework detection up front.
+ *
+ * Why up front, before we touch the cloud:
+ *   - We can fail fast on "this is not a JS project" with a useful message,
+ *     before creating a deployment, registering a project, or asking the
+ *     user any questions.
+ *   - The detection result feeds the build phase later, so we only run
+ *     framework detection once per deploy.
+ *   - Showing the user "Detected: Next.js v15 (Node)" early gives instant
+ *     feedback that the CLI understood their project.
+ *
+ * Failure modes are user-actionable: missing package.json, missing build
+ * script, etc. We deliberately do NOT call the generic adapter or run
+ * `npm run build` here — that's the build phase's job.
+ */
+import { detectFrameworkWithPackageJson } from "../../build/detect/index.js";
+import { stepError, stepSkipped, stepSuccess, } from "../../../steps.js";
+/**
+ * Builds the "Detect Project" step.
+ *
+ * The step is async-friendly and mutates `state.discover` in place when it
+ * succeeds, so subsequent steps in the same `runSteps()` call can read the
+ * detection result. Returning it via mutation keeps the `Step` interface
+ * (just `label` + `run`) unchanged.
+ */
+export function buildDiscoverStep(projectDir, logger, state) {
+    return {
+        label: 'Detect Project',
+        run: async () => {
+            try {
+                const { framework, packageJson } = await detectFrameworkWithPackageJson(projectDir);
+                if (!packageJson) {
+                    return stepError('No package.json found. `agentuity deploy` works on any JS/TS project — ensure you are running it from the project root.');
+                }
+                if (!framework) {
+                    // detectFrameworkWithPackageJson already falls through to a
+                    // generic detector; if even that returns null it means the
+                    // package.json has no usable build script.
+                    return stepError('Could not determine how to build this project. Add a `build` script to package.json (e.g. "build": "next build") and try again.');
+                }
+                logger.debug('Discover: framework=%s version=%s runtime=%s buildCommand=%s buildOutput=%s staticDir=%s', framework.name, framework.version ?? '(unknown)', framework.runtime, framework.buildCommand, framework.buildOutput, framework.staticDir ?? '(none)');
+                state.discover = { framework, packageJson };
+                const versionLabel = framework.version ? ` v${framework.version}` : '';
+                const summary = [
+                    `Framework:    ${framework.name}${versionLabel} (${framework.runtime})`,
+                    `Build:        ${framework.buildCommand}`,
+                    `Output:       ${framework.buildOutput}`,
+                ];
+                if (framework.staticDir && framework.staticDir !== framework.buildOutput) {
+                    summary.push(`Static:       ${framework.staticDir}`);
+                }
+                summary.push(`Pkg manager:  ${framework.packageManager}`);
+                return stepSuccess(summary);
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                return stepError(`Failed to inspect project: ${message}`, err);
+            }
+        },
+    };
+}
+/**
+ * Standalone discover used by paths that don't run inside `runSteps()`
+ * (e.g. tests, or future entrypoints that want the result without the
+ * step UI). Throws on the same failure modes as the step's `stepError`.
+ */
+export async function runDiscover(projectDir, logger) {
+    const { framework, packageJson } = await detectFrameworkWithPackageJson(projectDir);
+    if (!packageJson) {
+        throw new Error('No package.json found. `agentuity deploy` works on any JS/TS project — ensure you are running it from the project root.');
+    }
+    if (!framework) {
+        throw new Error('Could not determine how to build this project. Add a `build` script to package.json (e.g. "build": "next build") and try again.');
+    }
+    logger.debug('Discover: framework=%s version=%s runtime=%s', framework.name, framework.version ?? '(unknown)', framework.runtime);
+    return { framework, packageJson };
+}
+// Re-export the helper so consumers can build their own outcomes if needed.
+export { stepSkipped };
+//# sourceMappingURL=discover.js.map

package/dist/cmd/cloud/deploy/discover.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discover.js","sourceRoot":"","sources":["../../../../src/cmd/cloud/deploy/discover.ts"],"names":[],"mappings":"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"}

package/dist/cmd/cloud/deploy/preflight.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Preflight phase
+ * ---------------
+ *
+ * The "before we touch anything heavy" phase. Runs in the parent process
+ * only (the forked child re-enters deploy with `AGENTUITY_DEPLOYMENT`
+ * already set, skipping this phase entirely).
+ *
+ * Responsibilities:
+ *   1. Validate the deployment config in agentuity.json:
+ *        - resource limits (`validateResources`)
+ *        - apt dependencies (`validateAptDependencies`)
+ *      Any failure is fatal: we deliberately surface it before creating a
+ *      cloud deployment so we don't leave half-finished records lying
+ *      around server-side.
+ *   2. Create the deployment record on the server. The returned
+ *      `Deployment` carries the deploy id, the public key for client-side
+ *      encryption, and the stream URL the child process will tail logs
+ *      from.
+ *
+ * Forking the child process is intentionally NOT in this phase. That
+ * concern belongs in `deploy-fork.ts` which knows how to spawn, wire
+ * stdio, capture diagnostics, and report cancellation. Preflight just
+ * produces the inputs the fork module needs.
+ */
+import type { Logger } from '@agentuity/core';
+import { type Deployment } from '@agentuity/server';
+import type { APIClient } from '../../../api.ts';
+import type { Config, Project } from '../../../types.ts';
+type DeploymentConfigShape = NonNullable<Project['deployment']>;
+export interface PreflightParams {
+    /** Resolved project (output of the Register phase). */
+    project: Project;
+    /** API client for deployment creation. */
+    apiClient: APIClient;
+    /** CLI config for region resolution / overrides used by apt validation. */
+    config: Config | null | undefined;
+    /** Logger to thread through. */
+    logger: Logger;
+    /**
+     * Whether the caller wants JSON output. Apt validation failures format
+     * differently in JSON mode (so callers can render `errors[]` themselves
+     * before we exit). When set, we throw `PreflightAptValidationError`
+     * carrying the structured payload instead of fatal-rendering.
+     */
+    json: boolean;
+}
+export interface PreflightResult {
+    /** Newly-created deployment record. */
+    deployment: Deployment;
+    /** The exact deployment config we sent to the server (echoed for callers). */
+    deploymentConfig: DeploymentConfigShape;
+}
+/**
+ * Thrown when apt validation fails AND the caller asked for JSON output.
+ * The `payload` field is the structured error envelope the deploy command
+ * returns from its handler; callers should serialize and exit.
+ */
+export declare class PreflightAptValidationError extends Error {
+    readonly payload: {
+        success: false;
+        deploymentId: '';
+        projectId: string;
+        errors: Array<{
+            type: 'invalid-apt-dependency';
+            package: string;
+            error: string;
+            searchUrl: string;
+            availableVersions?: string[];
+        }>;
+    };
+    constructor(payload: PreflightAptValidationError['payload']);
+}
+/**
+ * Run the preflight phase in the parent process. Fatals on validation
+ * failure (or throws `PreflightAptValidationError` when `json: true`).
+ * On success, returns the new `Deployment` and the config that produced it.
+ */
+export declare function runPreflight(params: PreflightParams): Promise<PreflightResult>;
+export {};
+//# sourceMappingURL=preflight.d.ts.map

package/dist/cmd/cloud/deploy/preflight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preflight.d.ts","sourceRoot":"","sources":["../../../../src/cmd/cloud/deploy/preflight.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,KAAK,UAAU,EAA8C,MAAM,mBAAmB,CAAC;AAChG,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAGjD,OAAO,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAOzD,KAAK,qBAAqB,GAAG,WAAW,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC;AAEhE,MAAM,WAAW,eAAe;IAC/B,uDAAuD;IACvD,OAAO,EAAE,OAAO,CAAC;IACjB,0CAA0C;IAC1C,SAAS,EAAE,SAAS,CAAC;IACrB,2EAA2E;IAC3E,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAClC,gCAAgC;IAChC,MAAM,EAAE,MAAM,CAAC;IACf;;;;;OAKG;IACH,IAAI,EAAE,OAAO,CAAC;CACd;AAED,MAAM,WAAW,eAAe;IAC/B,uCAAuC;IACvC,UAAU,EAAE,UAAU,CAAC;IACvB,8EAA8E;IAC9E,gBAAgB,EAAE,qBAAqB,CAAC;CACxC;AAED;;;;GAIG;AACH,qBAAa,2BAA4B,SAAQ,KAAK;IACrD,QAAQ,CAAC,OAAO,EAAE;QACjB,OAAO,EAAE,KAAK,CAAC;QACf,YAAY,EAAE,EAAE,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,KAAK,CAAC;YACb,IAAI,EAAE,wBAAwB,CAAC;YAC/B,OAAO,EAAE,MAAM,CAAC;YAChB,KAAK,EAAE,MAAM,CAAC;YACd,SAAS,EAAE,MAAM,CAAC;YAClB,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;SAC7B,CAAC,CAAC;KACH,CAAC;gBAEU,OAAO,EAAE,2BAA2B,CAAC,SAAS,CAAC;CAK3D;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC,CAkFpF"}

package/dist/cmd/cloud/deploy/preflight.js

@@ -0,0 +1,116 @@
+/**
+ * Preflight phase
+ * ---------------
+ *
+ * The "before we touch anything heavy" phase. Runs in the parent process
+ * only (the forked child re-enters deploy with `AGENTUITY_DEPLOYMENT`
+ * already set, skipping this phase entirely).
+ *
+ * Responsibilities:
+ *   1. Validate the deployment config in agentuity.json:
+ *        - resource limits (`validateResources`)
+ *        - apt dependencies (`validateAptDependencies`)
+ *      Any failure is fatal: we deliberately surface it before creating a
+ *      cloud deployment so we don't leave half-finished records lying
+ *      around server-side.
+ *   2. Create the deployment record on the server. The returned
+ *      `Deployment` carries the deploy id, the public key for client-side
+ *      encryption, and the stream URL the child process will tail logs
+ *      from.
+ *
+ * Forking the child process is intentionally NOT in this phase. That
+ * concern belongs in `deploy-fork.ts` which knows how to spawn, wire
+ * stdio, capture diagnostics, and report cancellation. Preflight just
+ * produces the inputs the fork module needs.
+ */
+import { projectDeploymentCreate, validateResources } from '@agentuity/server';
+import { ErrorCode } from "../../../errors.js";
+import * as tui from "../../../tui.js";
+import { validateAptDependencies } from "../../../utils/apt-validator.js";
+/**
+ * Thrown when apt validation fails AND the caller asked for JSON output.
+ * The `payload` field is the structured error envelope the deploy command
+ * returns from its handler; callers should serialize and exit.
+ */
+export class PreflightAptValidationError extends Error {
+    payload;
+    constructor(payload) {
+        super('Apt validation failed');
+        this.name = 'PreflightAptValidationError';
+        this.payload = payload;
+    }
+}
+/**
+ * Run the preflight phase in the parent process. Fatals on validation
+ * failure (or throws `PreflightAptValidationError` when `json: true`).
+ * On success, returns the new `Deployment` and the config that produced it.
+ */
+export async function runPreflight(params) {
+    const { project, apiClient, config, logger, json } = params;
+    // `project.deployment` is the user-controlled deploy section of
+    // agentuity.json (resources, dependencies, domains, etc.). It's
+    // optional; an absent block means "use server defaults".
+    const deploymentConfig = (project.deployment ??
+        {});
+    // Resource limits validation — local-only, no API calls. Fatals on
+    // invalid config so we never create a deployment we can't run.
+    if (deploymentConfig.resources) {
+        const validation = validateResources(deploymentConfig.resources);
+        if (!validation.valid) {
+            tui.error('Invalid resource configuration in agentuity.json:');
+            for (const error of validation.errors) {
+                tui.error(`  ${error}`);
+            }
+            tui.fatal('Fix the resource configuration and try again.', ErrorCode.CONFIG_INVALID);
+        }
+    }
+    // Apt dependency validation — needs network access (queries the apt
+    // registry per region). Wrapped in a spinner because it can take a
+    // few seconds for projects with many packages.
+    if (deploymentConfig.dependencies && deploymentConfig.dependencies.length > 0) {
+        const aptValidation = await tui.spinner({
+            message: 'Validating apt dependencies...',
+            type: 'simple',
+            callback: async () => {
+                return await validateAptDependencies(deploymentConfig.dependencies, project.region, config ?? null, logger);
+            },
+        });
+        if (aptValidation.invalid.length > 0) {
+            // JSON callers (e.g. CI integrations) want the structured error
+            // envelope back through their own renderer rather than the
+            // pretty TUI box. Throw a typed error so the caller can wire it
+            // to their JSON exit path.
+            if (json) {
+                throw new PreflightAptValidationError({
+                    success: false,
+                    deploymentId: '',
+                    projectId: project.projectId,
+                    errors: aptValidation.invalid.map((pkg) => ({
+                        type: 'invalid-apt-dependency',
+                        package: pkg.package,
+                        error: pkg.error,
+                        searchUrl: pkg.searchUrl,
+                        availableVersions: pkg.availableVersions,
+                    })),
+                });
+            }
+            tui.error('Invalid apt dependencies in agentuity.json:');
+            tui.newline();
+            for (const pkg of aptValidation.invalid) {
+                tui.bullet(`${tui.bold(pkg.package)}: ${pkg.error}`);
+                if (pkg.availableVersions && pkg.availableVersions.length > 0) {
+                    tui.muted(`    Available versions: ${pkg.availableVersions.join(', ')}`);
+                }
+                tui.muted(`    Search: ${tui.link(pkg.searchUrl)}`);
+            }
+            tui.newline();
+            tui.fatal('Fix the apt dependencies and try again. Search for valid packages at: https://packages.debian.org/stable/', ErrorCode.CONFIG_INVALID);
+        }
+    }
+    // Server-side: create the deployment record. Returns id + publicKey
+    // + stream URLs that the child build process needs.
+    const deployment = await projectDeploymentCreate(apiClient, project.projectId, deploymentConfig);
+    logger.debug('Created deployment: %s', deployment.id);
+    return { deployment, deploymentConfig };
+}
+//# sourceMappingURL=preflight.js.map

package/dist/cmd/cloud/deploy/preflight.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preflight.js","sourceRoot":"","sources":["../../../../src/cmd/cloud/deploy/preflight.ts"],"names":[],"mappings":"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"}

package/dist/cmd/cloud/deploy/register.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Register phase
+ * --------------
+ *
+ * Resolves and verifies the cloud project that will receive this deployment.
+ *
+ * Responsibilities:
+ *   - Run `reconcileProject` to either confirm access to an existing
+ *     `agentuity.json` project or register/import a new one (writes
+ *     agentuity.json + .env, syncs env vars to the cloud).
+ *   - Handle the region-mismatch case: if local agentuity.json says one
+ *     region but the cloud project lives in another, confirm with the user
+ *     and update the server.
+ *
+ * Failure modes are surfaced via `tui.fatal()` so the rest of the deploy
+ * pipeline never runs without a real, accessible project. That matches the
+ * old behavior under `requires.project: true`, just with the resolution
+ * moved into the handler so it can also create a project from scratch in a
+ * vanilla JS/TS directory.
+ *
+ * GitHub auto-deploy linking is intentionally NOT done here — that prompt
+ * lives later in the deploy pipeline (after the SDK key check and the
+ * abort/handle setup) so it can be cleanly cancelled by the existing
+ * DeploymentCancelledError flow.
+ */
+import type { Logger } from '@agentuity/core';
+import type { APIClient } from '../../../api.ts';
+import type { AuthData, Config, Project } from '../../../types.ts';
+export interface RegisterParams {
+    /** Project as resolved by cli.ts (may be undefined if no agentuity.json). */
+    project: Project | undefined;
+    /** Absolute path to the project root. */
+    projectDir: string;
+    /** API client (auth resolved). */
+    apiClient: APIClient;
+    /** Auth data for reconcile (which may need to call listOrganizations etc.). */
+    auth: AuthData;
+    /** Loaded CLI config (profile, overrides). */
+    config: Config;
+    /** Logger to thread through. */
+    logger: Logger;
+    /** Whether the user passed `--confirm` (used in non-TTY region change). */
+    confirm: boolean;
+    /** Resolved by `isTTY()` at the call site so we don't import auth here. */
+    interactive: boolean;
+}
+export interface RegisterResult {
+    /** Project guaranteed to be registered and accessible. */
+    project: Project;
+    /** Whether the project was freshly registered/imported by this call. */
+    imported: boolean;
+}
+/**
+ * Run the register phase. Either resolves an existing project or
+ * creates/imports one, then ensures the local region matches the server.
+ *
+ * The function fatals (via `tui.fatal`) on any unrecoverable problem
+ * because deploy cannot continue without a registered project. Callers
+ * therefore don't need to handle a `null`/error return.
+ */
+export declare function runRegister(params: RegisterParams): Promise<RegisterResult>;
+//# sourceMappingURL=register.d.ts.map

package/dist/cmd/cloud/deploy/register.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../../../../src/cmd/cloud/deploy/register.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAE9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAIjD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAEnE,MAAM,WAAW,cAAc;IAC9B,6EAA6E;IAC7E,OAAO,EAAE,OAAO,GAAG,SAAS,CAAC;IAC7B,yCAAyC;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,kCAAkC;IAClC,SAAS,EAAE,SAAS,CAAC;IACrB,+EAA+E;IAC/E,IAAI,EAAE,QAAQ,CAAC;IACf,8CAA8C;IAC9C,MAAM,EAAE,MAAM,CAAC;IACf,gCAAgC;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,2EAA2E;IAC3E,OAAO,EAAE,OAAO,CAAC;IACjB,2EAA2E;IAC3E,WAAW,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC9B,0DAA0D;IAC1D,OAAO,EAAE,OAAO,CAAC;IACjB,wEAAwE;IACxE,QAAQ,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,CAoIjF"}

package/dist/cmd/cloud/deploy/register.js

@@ -0,0 +1,135 @@
+/**
+ * Register phase
+ * --------------
+ *
+ * Resolves and verifies the cloud project that will receive this deployment.
+ *
+ * Responsibilities:
+ *   - Run `reconcileProject` to either confirm access to an existing
+ *     `agentuity.json` project or register/import a new one (writes
+ *     agentuity.json + .env, syncs env vars to the cloud).
+ *   - Handle the region-mismatch case: if local agentuity.json says one
+ *     region but the cloud project lives in another, confirm with the user
+ *     and update the server.
+ *
+ * Failure modes are surfaced via `tui.fatal()` so the rest of the deploy
+ * pipeline never runs without a real, accessible project. That matches the
+ * old behavior under `requires.project: true`, just with the resolution
+ * moved into the handler so it can also create a project from scratch in a
+ * vanilla JS/TS directory.
+ *
+ * GitHub auto-deploy linking is intentionally NOT done here — that prompt
+ * lives later in the deploy pipeline (after the SDK key check and the
+ * abort/handle setup) so it can be cleanly cancelled by the existing
+ * DeploymentCancelledError flow.
+ */
+import { projectGet, projectUpdateRegion } from '@agentuity/server';
+import { getCachedProject, setCachedProject } from "../../../cache/index.js";
+import { ErrorCode } from "../../../errors.js";
+import * as tui from "../../../tui.js";
+/**
+ * Run the register phase. Either resolves an existing project or
+ * creates/imports one, then ensures the local region matches the server.
+ *
+ * The function fatals (via `tui.fatal`) on any unrecoverable problem
+ * because deploy cannot continue without a registered project. Callers
+ * therefore don't need to handle a `null`/error return.
+ */
+export async function runRegister(params) {
+    const { projectDir, apiClient, auth, config, logger, confirm, interactive } = params;
+    // Lazy-load reconcile to keep the deploy command's startup cost low
+    // (this matches what deploy.ts used to do inline).
+    const { reconcileProject } = await import("../../project/reconcile.js");
+    const reconcileResult = await reconcileProject({
+        dir: projectDir,
+        auth,
+        apiClient,
+        config,
+        logger,
+        interactive,
+    });
+    if (reconcileResult.status === 'error') {
+        // `tui.fatal` calls process.exit. Use `as never` so callers see a
+        // non-undefined return type from runRegister.
+        tui.fatal(reconcileResult.message ?? 'Project reconciliation failed.', ErrorCode.PROJECT_NOT_FOUND);
+    }
+    if (reconcileResult.status === 'skipped') {
+        tui.fatal('Project must be registered with Agentuity Cloud to deploy.', ErrorCode.PROJECT_NOT_FOUND);
+    }
+    let project = params.project;
+    let imported = false;
+    if (reconcileResult.status === 'imported' && reconcileResult.project) {
+        project = reconcileResult.project;
+        imported = true;
+        // The reconcile flow already prints a success line; add a blank
+        // line so the next phase's output isn't crammed against it.
+        tui.newline();
+    }
+    if (reconcileResult.status === 'valid' && reconcileResult.project) {
+        project = reconcileResult.project;
+    }
+    if (!project) {
+        // Reconcile reported success but didn't return a project config and
+        // the caller didn't have one to start with. Treat this as a hard
+        // error — never attempt to deploy without a registered project.
+        tui.fatal('Could not resolve a registered project for this directory.', ErrorCode.PROJECT_NOT_FOUND);
+    }
+    // Region reconciliation: if the local agentuity.json points at a
+    // different region than the server thinks the project lives in, ask
+    // the user (or require --confirm in non-TTY) before pushing the
+    // region change. Failures fetching the server project are non-fatal:
+    // we trace and continue with the local region.
+    if (project.region) {
+        try {
+            const profile = config.name ?? 'default';
+            let serverProject = getCachedProject(profile, project.projectId);
+            if (!serverProject) {
+                serverProject = await projectGet(apiClient, {
+                    id: project.projectId,
+                    keys: false,
+                });
+                setCachedProject(profile, project.projectId, serverProject);
+            }
+            const serverRegion = serverProject.cloudRegion;
+            if (serverRegion && serverRegion !== project.region) {
+                logger.debug('Region mismatch detected: local=%s, server=%s', project.region, serverRegion);
+                if (interactive) {
+                    tui.newline();
+                    tui.warning(`Region change detected: ${tui.bold(serverRegion)} → ${tui.bold(project.region)}`);
+                    const confirmChange = await tui.confirm('Do you want to update the project region?', false);
+                    if (!confirmChange) {
+                        tui.newline();
+                        tui.fatal('Deployment cancelled. Update the region in agentuity.json or keep the current region.', ErrorCode.CONFIG_INVALID);
+                    }
+                }
+                else {
+                    // Non-interactive: require --confirm
+                    if (!confirm) {
+                        tui.fatal(`Region change detected (${serverRegion} → ${project.region}). Use --confirm flag to proceed with region change in non-interactive mode.`, ErrorCode.CONFIG_INVALID);
+                    }
+                    logger.debug('Region change confirmed via --confirm flag');
+                }
+                await tui.spinner({
+                    message: 'Updating project region...',
+                    type: 'simple',
+                    callback: async () => {
+                        await projectUpdateRegion(apiClient, project.projectId, project.region);
+                    },
+                });
+                tui.success(`Project region updated to ${tui.bold(project.region)}`);
+                tui.newline();
+            }
+        }
+        catch (err) {
+            // Re-throw region-change fatals (they bubble up through
+            // tui.fatal already, but we keep the explicit guard for
+            // any future thrown error in this block).
+            if (err instanceof Error && err.message.includes('Region change detected')) {
+                throw err;
+            }
+            logger.trace('Failed to check project region: %s', err);
+        }
+    }
+    return { project, imported };
+}
+//# sourceMappingURL=register.js.map

package/dist/cmd/cloud/deploy/register.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.js","sourceRoot":"","sources":["../../../../src/cmd/cloud/deploy/register.ts"],"names":[],"mappings":"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"}

package/dist/cmd/cloud/deploy/types.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Shared types for the deploy command pipeline.
+ *
+ * The deploy command runs as a phased pipeline:
+ *   discover  -> register -> preflight -> build -> upload -> wait
+ *
+ * Each phase produces a small, well-typed output that the next phase
+ * consumes. Putting the shared shapes here keeps each phase module
+ * focused on its own responsibility.
+ */
+import type { BuildMetadata, DeploymentInstructions } from '@agentuity/server';
+import type { DetectedFramework, PackageJsonData } from '../../build/detect/types.ts';
+/**
+ * Output of the discover phase.
+ *
+ * The phase validates that the directory looks like a JS/TS project we can
+ * build, runs framework detection once, and hands the result down the
+ * pipeline so later phases (notably build) don't have to re-detect.
+ */
+export interface DiscoverResult {
+    /** The detected framework (with runtime, build command, output dir, etc.). */
+    framework: DetectedFramework;
+    /** The parsed package.json that produced the detection. */
+    packageJson: PackageJsonData;
+}
+/**
+ * Mutable, shared accumulator passed through the deploy pipeline.
+ *
+ * Phases write their outputs here so subsequent steps can read them
+ * without threading dozens of arguments through the runSteps array.
+ * Each phase only writes the fields it owns.
+ */
+export interface DeployPipelineState {
+    /** Set by the Discover step. */
+    discover?: DiscoverResult;
+    /** Set by the Build step — read by the Upload step. */
+    build?: BuildMetadata;
+    /** Build output directory (where the zip is sourced from). */
+    buildOutputDir?: string;
+    /** Upload instructions returned by the server (signed PUT URLs). */
+    instructions?: DeploymentInstructions;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/cmd/cloud/deploy/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/cmd/cloud/deploy/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAC/E,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAEtF;;;;;;GAMG;AACH,MAAM,WAAW,cAAc;IAC9B,8EAA8E;IAC9E,SAAS,EAAE,iBAAiB,CAAC;IAC7B,2DAA2D;IAC3D,WAAW,EAAE,eAAe,CAAC;CAC7B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IACnC,gCAAgC;IAChC,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,uDAAuD;IACvD,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,8DAA8D;IAC9D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,oEAAoE;IACpE,YAAY,CAAC,EAAE,sBAAsB,CAAC;CACtC"}

package/dist/cmd/cloud/deploy/types.js

@@ -0,0 +1,12 @@
+/**
+ * Shared types for the deploy command pipeline.
+ *
+ * The deploy command runs as a phased pipeline:
+ *   discover  -> register -> preflight -> build -> upload -> wait
+ *
+ * Each phase produces a small, well-typed output that the next phase
+ * consumes. Putting the shared shapes here keeps each phase module
+ * focused on its own responsibility.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/cmd/cloud/deploy/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/cmd/cloud/deploy/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

package/dist/cmd/cloud/deploy/upload.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Upload phase
+ * ------------
+ *
+ * Takes the build artifacts produced by the Build phase, encrypts the
+ * code zip with the deployment's public key, and uploads everything
+ * (encrypted zip + static assets) to the URLs the server handed back in
+ * the build phase's `DeploymentInstructions`.
+ *
+ * Two `Step` factories are exposed so the deploy command's `runSteps()`
+ * pipeline keeps its existing visual progression:
+ *   - `buildEncryptUploadStep`  — zips, encrypts, uploads code + assets.
+ *   - `buildProvisionStep`      — calls `projectDeploymentComplete` and
+ *                                 stashes the result on pipelineState so
+ *                                 the wait phase can read the stream id.
+ *
+ * Failure modes flush the build report (when `--report-file` is set) so
+ * CI always gets the diagnostics on disk before we abort.
+ */
+import { type Deployment, type DeploymentComplete } from '@agentuity/server';
+import type { APIClient } from '../../../api.ts';
+import type { BuildReportCollector } from '../../../build-report.ts';
+import { type Step } from '../../../steps.ts';
+import type { DeployPipelineState } from './types.ts';
+export interface UploadStepParams {
+    projectDir: string;
+    collector: BuildReportCollector;
+    deployment: Deployment | undefined;
+    hasReportFile: boolean;
+    state: DeployPipelineState;
+    /** Logger to thread through. */
+    logger: {
+        trace: (msg: string) => void;
+        debug: (msg: string) => void;
+    };
+}
+/**
+ * Render the final "Uploaded N assets ..." line after a successful CDN
+ * upload pass. Reports both the original and on-the-wire totals when gzip
+ * compressed at least one file, so the user can see the real transfer cost.
+ *
+ * Exported so the deploy command can reuse the same formatting if needed.
+ */
+export declare function formatUploadSummary(count: number, rawBytes: number, transferredBytes: number): string;
+/**
+ * Build the "Encrypt and Upload Deployment" step.
+ *
+ * Reads the Build phase's outputs (`build`, `buildOutputDir`,
+ * `instructions`) from `state`, zips the build output dir, encrypts it
+ * with the deployment public key, uploads the encrypted zip to the
+ * server-provided URL, then fans out parallel uploads of every static
+ * asset (gzipping compressible types on the fly).
+ */
+export declare function buildEncryptUploadStep(params: UploadStepParams): Step;
+export interface ProvisionStepParams {
+    apiClient: APIClient;
+    deployment: Deployment | undefined;
+    /** Mutable: written to once `projectDeploymentComplete` returns. */
+    completeRef: {
+        current?: DeploymentComplete;
+    };
+}
+/**
+ * Build the "Provision Deployment" step.
+ *
+ * Tells the server we're done uploading; the server then schedules the
+ * deployment for warmup and returns the stream id we'll use to tail
+ * build/run logs in the wait phase.
+ *
+ * The result is stashed via a small `completeRef` ref-cell instead of
+ * being returned, so the surrounding handler still has access to it
+ * after `runSteps()` returns. We use a ref-cell rather than the shared
+ * `DeployPipelineState` because `complete` is consumed by the wait phase
+ * which lives outside the step pipeline today.
+ */
+export declare function buildProvisionStep(params: ProvisionStepParams): Step;
+//# sourceMappingURL=upload.d.ts.map