veryfront 0.1.1276-rc.24311 → 0.1.1276

package/esm/cli/auth/login.d.ts

@@ -52,8 +52,8 @@ type OAuthBrowserLauncher = (url: string, options?: BrowserLaunchOptions) => Pro
 /** Test seam for the OAuth default opener. */
 export declare function __setOAuthBrowserLauncherForTests(launcher?: OAuthBrowserLauncher): void;
 export declare function openOAuthLogin(authUrl: string, spinner: SpinnerController, opener?: (url: string) => Promise<void>): Promise<boolean>;
-export declare function login(method?: AuthMethod, env?: EnvironmentConfig, projectDir?: string): Promise<AuthIdentity | null>;
-export declare function ensureAuthenticated(env?: EnvironmentConfig, projectDir?: string): Promise<AuthIdentity | null>;
+export declare function login(method?: AuthMethod, env?: EnvironmentConfig, projectDir?: string, validationOptions?: CredentialValidationOptions): Promise<AuthIdentity | null>;
+export declare function ensureAuthenticated(env?: EnvironmentConfig, projectDir?: string, validationOptions?: CredentialValidationOptions): Promise<AuthIdentity | null>;
 export declare function logout(env?: EnvironmentConfig): Promise<void>;
 export declare function whoami(env?: EnvironmentConfig): Promise<AuthIdentity | null>;
 export { deleteToken, hasToken, readToken, saveToken };

package/esm/cli/auth/login.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"login.d.ts","sourceRoot":"","sources":["../../../src/cli/auth/login.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"login.d.ts","sourceRoot":"","sources":["../../../src/cli/auth/login.ts"],"names":[],"mappings":"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"}

package/esm/cli/auth/login.js

@@ -94,7 +94,7 @@ class CredentialValidationUnavailableError extends Error {
     status;
     name = "CredentialValidationUnavailableError";
     constructor(kind, status) {
-        super("Could not validate existing login credentials");
+        super(`Veryfront API is unavailable (${kind}${status ? `, HTTP ${status}` : ""}). Check the API URL and service, then retry. Your login was retained.`);
         this.kind = kind;
         this.status = status;
     }
@@ -467,7 +467,7 @@ function writeAuthoritativeCredentialUnavailableMessage(source, failure, hasConf
  * must stop instead of falling through to lower-priority credentials or a new
  * login that later commands will not use.
  */
-async function describeExistingSession(env, projectDir = cwd()) {
+async function describeExistingSession(env, projectDir = cwd(), validationOptions = {}) {
     const candidates = await resolveApiCredentialCandidatesForAuth(env, projectDir);
     if (candidates.length === 0)
         return null;
@@ -488,6 +488,7 @@ async function describeExistingSession(env, projectDir = cwd()) {
             // checked must still stop, because later commands will resolve it ahead
             // of any replacement login.
             identity = await validateCredential(apiToken, validationEnv, {
+                ...validationOptions,
                 signal,
                 throwOnCredentialValidationUnavailable: true,
             });
@@ -565,7 +566,7 @@ async function describeExistingSession(env, projectDir = cwd()) {
     }
     return null;
 }
-export async function login(method, env = getEnvironmentConfig(), projectDir = cwd()) {
+export async function login(method, env = getEnvironmentConfig(), projectDir = cwd(), validationOptions = {}) {
     if (isJsonMode() && method !== undefined) {
         await outputLoginExplicitMethodJson();
         return null;
@@ -576,7 +577,7 @@ export async function login(method, env = getEnvironmentConfig(), projectDir = c
     // intent to sign in again, so account switching still works — and a session
     // that no longer validates falls through to the normal flow.
     if (method === undefined) {
-        const existing = await describeExistingSession(env, projectDir);
+        const existing = await describeExistingSession(env, projectDir, validationOptions);
         if (existing === "failure-output")
             return null;
         if (existing)
@@ -605,7 +606,10 @@ export async function login(method, env = getEnvironmentConfig(), projectDir = c
         spinner.update("Validating token...");
         let identity;
         try {
-            identity = await validateCredential(token, env, { throwOnNetworkError: true });
+            identity = await validateCredential(token, env, {
+                ...validationOptions,
+                throwOnNetworkError: true,
+            });
         }
         catch (e) {
             if (e instanceof NetworkError) {
@@ -634,7 +638,10 @@ export async function login(method, env = getEnvironmentConfig(), projectDir = c
     console.log("  " + dim("Validating token..."));
     let identity;
     try {
-        identity = await validateCredential(token, env, { throwOnNetworkError: true });
+        identity = await validateCredential(token, env, {
+            ...validationOptions,
+            throwOnNetworkError: true,
+        });
     }
     catch (e) {
         if (e instanceof NetworkError) {
@@ -657,19 +664,23 @@ export async function login(method, env = getEnvironmentConfig(), projectDir = c
         : "  ✓ Logged in as " + brand(identity.email));
     return identity;
 }
-export async function ensureAuthenticated(env = getEnvironmentConfig(), projectDir = cwd()) {
+export async function ensureAuthenticated(env = getEnvironmentConfig(), projectDir = cwd(), validationOptions = {}) {
     const humanOutput = !isJsonMode();
     const candidates = await resolveApiCredentialCandidatesForAuth(env, projectDir);
     for (const candidate of candidates) {
         let credential;
         try {
-            credential = await validateCredential(candidate.apiToken, candidate.validationEnv, candidate.apiTokenSource === "token-store"
-                ? { throwOnCredentialValidationUnavailable: true }
-                : undefined);
+            credential = await validateCredential(candidate.apiToken, candidate.validationEnv, {
+                ...(candidate.apiTokenSource === "token-store"
+                    ? { throwOnCredentialValidationUnavailable: true }
+                    : {}),
+                ...validationOptions,
+            });
         }
         catch (error) {
             if (candidate.apiTokenSource === "token-store" &&
-                error instanceof CredentialValidationUnavailableError) {
+                error instanceof CredentialValidationUnavailableError &&
+                !validationOptions.throwOnCredentialValidationUnavailable) {
                 return null;
             }
             throw error;
@@ -697,7 +708,7 @@ export async function ensureAuthenticated(env = getEnvironmentConfig(), projectD
         cliLogger.error("Not logged in. Set VERYFRONT_API_TOKEN or run in interactive mode.");
         return null;
     }
-    return login(undefined, env, projectDir);
+    return login(undefined, env, projectDir, validationOptions);
 }
 const CREDENTIAL_VALIDATION_UNAVAILABLE = Symbol("credential-validation-unavailable");
 export async function logout(env = getEnvironmentConfig()) {

package/esm/cli/commands/dev/command-help.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command-help.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/dev/command-help.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,eAAO,MAAM,OAAO,EAAE,WA0CrB,CAAC"}
+{"version":3,"file":"command-help.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/dev/command-help.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,eAAO,MAAM,OAAO,EAAE,WA+CrB,CAAC"}

package/esm/cli/commands/dev/command-help.js

@@ -13,6 +13,10 @@ export const devHelp = {
             flag: "--project <directory>",
             description: "Run a local project directory (defaults to the current directory)",
         },
+        {
+            flag: "--env <name>",
+            description: "Shared Cloud environment for local execution (default: preview)",
+        },
         {
             flag: "--no-hmr",
             description: "Disable hot module replacement",
@@ -28,6 +32,7 @@ export const devHelp = {
         "veryfront dev --project ./my-app",
         "PORT=3001 veryfront dev",
         "veryfront dev --open",
+        "veryfront dev --env preview",
         "veryfront dev --no-hmr",
     ],
     notes: [

package/esm/cli/commands/dev/command.d.ts

@@ -15,6 +15,8 @@ export interface DevOptions {
      */
     portExplicit?: boolean;
     projectDir: string;
+    /** Shared Cloud environment used by this local runtime. */
+    environment?: string;
     hmr?: boolean;
     open?: boolean;
     /** Demo mode: don't exit process on shutdown, resolve done promise instead */
@@ -40,6 +42,14 @@ export interface DevCommandResult {
     /** Stop the dev server programmatically (for demo mode) */
     stop: () => Promise<void>;
 }
+/** Authentication options used after executable project configuration has loaded. */
+export declare function createConnectedDevAuthenticationOptions(apiBaseUrl: string, timeoutMs?: number): {
+    throwOnCredentialValidationUnavailable: boolean;
+    transport: typeof fetch;
+    timeoutMs: number;
+};
+/** Host transport for source sync; responses remain streaming for large files. */
+export declare function createConnectedDevSyncTransport(apiBaseUrl: string): typeof fetch;
 export declare function preloadDevAuth(apiToken?: string, projectDir?: string): Promise<{
     identity: AuthIdentity | null;
     projects: RemoteProject[];

package/esm/cli/commands/dev/command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/dev/command.ts"],"names":[],"mappings":"AAAA;;GAEG;AAqBH,OAAO,EAAE,KAAK,YAAY,EAA2B,MAAM,qBAAqB,CAAC;AACjF,OAAO,EAAuB,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAE9E,OAAO,EAAwC,KAAK,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAS1F,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,MAAM,iBAAiB,GAAG,UAAU,CAAC;AAE3C,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACrB,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACpB;;;;;OAKG;IACH,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAQD,wBAAsB,cAAc,CAClC,QAAQ,CAAC,EAAE,MAAM,EACjB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC;IAAE,QAAQ,EAAE,YAAY,GAAG,IAAI,CAAC;IAAC,QAAQ,EAAE,aAAa,EAAE,CAAA;CAAE,CAAC,CA4BvE;AAED;;;;;;;;GAQG;AACH,wBAAsB,mBAAmB,CACvC,YAAY,GAAE,MAAM,OAAO,CAAC,YAAY,GAAG,IAAI,CAAS,GACvD,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAO9B;AAED,wBAAgB,gCAAgC,CAC9C,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,aAAa,GACrB,WAAW,CAEb;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,wBAAwB,CAAC,CAAC,EAC9C,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,GAClC,OAAO,CAAC;IAAE,MAAM,EAAE,CAAC,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAqBtC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,0BAA0B,CAC9C,aAAa,EAAE,MAAM,EACrB,KAAK,GAAE,MAAM,OAAO,CAAC,IAAI,CAAuB,EAChD,KAAK,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAmB,EAC3D,QAAQ,GAAE,MAAM,OAAuC,GACtD,OAAO,CAAC,OAAO,CAAC,CAKlB;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA8TzE"}
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/dev/command.ts"],"names":[],"mappings":"AAAA;;GAEG;AAqBH,OAAO,EACL,KAAK,YAAY,EAIlB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAuB,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAE9E,OAAO,EAAwC,KAAK,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAgC1F,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,2DAA2D;IAC3D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,MAAM,iBAAiB,GAAG,UAAU,CAAC;AAE3C,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACrB,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACpB;;;;;OAKG;IACH,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAYD,qFAAqF;AACrF,wBAAgB,uCAAuC,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,SAAS;;;;EAM7F;AAED,kFAAkF;AAClF,wBAAgB,+BAA+B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,KAAK,CAEhF;AAED,wBAAsB,cAAc,CAClC,QAAQ,CAAC,EAAE,MAAM,EACjB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC;IAAE,QAAQ,EAAE,YAAY,GAAG,IAAI,CAAC;IAAC,QAAQ,EAAE,aAAa,EAAE,CAAA;CAAE,CAAC,CA4BvE;AAED;;;;;;;;GAQG;AACH,wBAAsB,mBAAmB,CACvC,YAAY,GAAE,MAAM,OAAO,CAAC,YAAY,GAAG,IAAI,CAAS,GACvD,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAO9B;AAED,wBAAgB,gCAAgC,CAC9C,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,aAAa,GACrB,WAAW,CAEb;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,wBAAwB,CAAC,CAAC,EAC9C,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,GAClC,OAAO,CAAC;IAAE,MAAM,EAAE,CAAC,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAqBtC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,0BAA0B,CAC9C,aAAa,EAAE,MAAM,EACrB,KAAK,GAAE,MAAM,OAAO,CAAC,IAAI,CAAuB,EAChD,KAAK,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAmB,EAC3D,QAAQ,GAAE,MAAM,OAAuC,GACtD,OAAO,CAAC,OAAO,CAAC,CAKlB;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAmdzE"}

package/esm/cli/commands/dev/command.js

@@ -12,7 +12,7 @@ import { startDevServer } from "../../../src/server/index.js";
 import { clearAllLocalCaches } from "../../../src/transforms/mdx/esm-module-loader/cache/index.js";
 import { isPersistentLocalCacheEnabled } from "../../../src/cache/index.js";
 import { validateProviderConfig } from "../../../src/discovery/index.js";
-import { brand, devShortcuts, dim, error as errorColor, formatDuration, warning } from "../../ui/index.js";
+import { brand, dim, error as errorColor, warning } from "../../ui/index.js";
 import { exitProcess, isTTY, isVerbose, registerTerminationSignals } from "../../utils/index.js";
 import { DEV_SHORTCUTS, shortcutsBlock } from "../../ui/components/shortcuts.js";
 import { applyQualifiedRuntimeAuth, resolveLinkedProjectSlug } from "../../shared/runtime-auth.js";
@@ -20,7 +20,7 @@ import { createKeyboardHandler } from "../../ui/keyboard.js";
 import { openBrowser } from "../../auth/browser.js";
 import { createMCPServer } from "../../mcp/server.js";
 import { withSpan } from "../../../src/observability/tracing/otlp-setup.js";
-import { isApiKeyIdentity, login } from "../../auth/login.js";
+import { ensureAuthenticated, isApiKeyIdentity, login, } from "../../auth/login.js";
 import { fetchRemoteProjects } from "../../sync/index.js";
 import { pullCommand } from "../pull/index.js";
 import { createStagedPushOptions, pushCommand } from "../push/index.js";
@@ -30,12 +30,36 @@ import { findAvailablePort, isPortAvailable, isPortInUseError } from "./port-fal
 import { advertisesCloudGateway, listInferenceOptions } from "./inference-status.js";
 import { captureHostApiEnvironment } from "../../../src/platform/compat/process/env.js";
 import { resolveApiCredentialCandidatesForAuth, resolveApiUrlTrust } from "../../shared/config.js";
-import { trustOperatorConfiguredVeryfrontApiOrigins } from "../../../src/security/http/outbound-fetch.js";
+import { captureDevDisplayOptions } from "./display-options.js";
+import { captureLocalWorkerName } from "./worker-name.js";
+import { devReadinessLines, veryfrontServiceName } from "./readiness-output.js";
+import { applyConnectedDevProjectSlug, connectedDevApiBaseUrl, connectedDevStudioBaseUrl, createConnectedDevControlPlane, prepareConnectedDev, resolveConnectedDevProject, stopDevServices, } from "./connected-dev.js";
+import { saveSharedProjectAssociation } from "../../shared/project-link.js";
+import { chooseCloudProject } from "../../shared/cloud-project.js";
+import { createCloudOnboardingTransport } from "../../shared/cloud-onboarding-transport.js";
+import { isInteractive } from "../../shared/interactive.js";
+import { getConnectedLocalRuntime, installConnectedLocalRuntime, } from "../../../src/agent/ag-ui/connected-local-runtime.js";
+import { createVeryfrontApiOriginBoundOutboundFetch, trustOperatorConfiguredVeryfrontApiOrigins, } from "../../../src/security/http/outbound-fetch.js";
+function authDisplayName(identity) {
+    return isApiKeyIdentity(identity) ? "API key" : identity.email;
+}
 function authStatus(identity) {
     return isApiKeyIdentity(identity)
         ? "Authenticated with an API key"
         : `Logged in as ${identity.email}`;
 }
+/** Authentication options used after executable project configuration has loaded. */
+export function createConnectedDevAuthenticationOptions(apiBaseUrl, timeoutMs = 10_000) {
+    return {
+        throwOnCredentialValidationUnavailable: true,
+        transport: createCloudOnboardingTransport(apiBaseUrl, timeoutMs),
+        timeoutMs,
+    };
+}
+/** Host transport for source sync; responses remain streaming for large files. */
+export function createConnectedDevSyncTransport(apiBaseUrl) {
+    return createVeryfrontApiOriginBoundOutboundFetch(apiBaseUrl);
+}
 export async function preloadDevAuth(apiToken, projectDir) {
     const env = getEnvironmentConfig();
     const trust = resolveApiUrlTrust(env, null);
@@ -143,7 +167,8 @@ export async function clearLocalCachesIfPortFree(requestedPort, clear = clearAll
 export function devCommand(options) {
     return withSpan("cli.command.dev", async () => {
         const { port, portExplicit, projectDir, hmr = true, open = false, demoMode = false, clearLocalCaches = false, } = options;
-        const startTime = Date.now();
+        const displayOptions = captureDevDisplayOptions();
+        const workerDisplayName = captureLocalWorkerName();
         captureHostApiEnvironment();
         trustOperatorConfiguredVeryfrontApiOrigins();
         let doneResolve;
@@ -178,8 +203,63 @@ export function devCommand(options) {
             await clearLocalCachesIfPortFree(finalPort);
         const env = getEnvironmentConfig();
         const isProxyMode = config?.fs?.veryfront?.proxyMode === true;
-        const linkedProjectSlug = await resolveLinkedProjectSlug(projectDir, config?.projectSlug ?? config?.fs?.veryfront?.projectSlug ?? env.projectSlug);
-        const runtimeAuth = await applyQualifiedRuntimeAuth(projectDir, linkedProjectSlug);
+        let linkedProjectSlug = await resolveLinkedProjectSlug(projectDir, config?.projectSlug ?? config?.fs?.veryfront?.projectSlug ?? env.projectSlug);
+        if (!linkedProjectSlug && !isProxyMode && isTTY() && isInteractive()) {
+            await chooseCloudProject(projectDir);
+            linkedProjectSlug = await resolveLinkedProjectSlug(projectDir);
+        }
+        let preflightIdentity = null;
+        let runtimeAuth = await applyQualifiedRuntimeAuth(projectDir, linkedProjectSlug);
+        const connectedTarget = await prepareConnectedDev(linkedProjectSlug, options.environment ?? "preview", {
+            authenticate: async () => {
+                preflightIdentity = await ensureAuthenticated(getEnvironmentConfig(), projectDir, createConnectedDevAuthenticationOptions(connectedDevApiBaseUrl(runtimeAuth.apiBaseUrl)));
+                return Boolean(preflightIdentity);
+            },
+            resolve: async (projectSlug, environmentName) => {
+                runtimeAuth = await applyQualifiedRuntimeAuth(projectDir, projectSlug);
+                runtimeAuth.apiBaseUrl = connectedDevApiBaseUrl(runtimeAuth.apiBaseUrl);
+                if (!runtimeAuth.apiToken || !runtimeAuth.apiBaseUrl) {
+                    throw new Error("Veryfront Cloud credentials are unavailable. Run veryfront login and retry.");
+                }
+                const controlPlane = createConnectedDevControlPlane({
+                    apiUrl: runtimeAuth.apiBaseUrl,
+                    apiToken: runtimeAuth.apiToken,
+                    apiTokenSource: runtimeAuth.apiTokenSource,
+                    projectSlug,
+                });
+                const project = await resolveConnectedDevProject(controlPlane, projectDir, {
+                    apiUrl: runtimeAuth.apiBaseUrl,
+                    apiToken: runtimeAuth.apiToken,
+                    apiTokenSource: runtimeAuth.apiTokenSource,
+                    projectSlug,
+                });
+                const environment = await controlPlane.getEnvironment(project.id, environmentName);
+                if (!environment) {
+                    throw new Error(`Environment "${environmentName}" does not exist in project "${project.slug}". Choose an existing environment with --env <name>.`);
+                }
+                await saveSharedProjectAssociation(projectDir, project.slug, runtimeAuth.apiBaseUrl);
+                runtimeAuth = applyConnectedDevProjectSlug(runtimeAuth, project.slug);
+                linkedProjectSlug = project.slug;
+                return {
+                    projectId: project.id,
+                    projectSlug: project.slug,
+                    environmentId: environment.id,
+                    environmentName: environment.name,
+                };
+            },
+        }, isProxyMode);
+        const studioBase = connectedTarget
+            ? connectedDevStudioBaseUrl(connectedDevApiBaseUrl(runtimeAuth.apiBaseUrl), displayOptions.studioUrl)
+            : "";
+        const disposeConnectedRuntime = connectedTarget && runtimeAuth.apiToken && runtimeAuth.apiBaseUrl
+            ? installConnectedLocalRuntime({
+                ...connectedTarget,
+                workerDisplayName,
+                apiToken: runtimeAuth.apiToken,
+                apiBaseUrl: runtimeAuth.apiBaseUrl,
+                studioUrl: studioBase,
+            })
+            : undefined;
         const initialAuthPromise = preloadDevAuth(runtimeAuth.apiToken, projectDir).catch(() => ({
             identity: null,
             projects: [],
@@ -210,13 +290,20 @@ export function devCommand(options) {
         let identity = null;
         let projects = [];
         let selectedProject = null;
-        const started = await startDevServerOnFreePort(finalPort, (port) => startDevServer({
-            port,
-            projectDir,
-            enableHMR,
-            enableFastRefresh: true,
-            signal: shutdownController.signal,
-        }));
+        let started;
+        try {
+            started = await startDevServerOnFreePort(finalPort, (port) => startDevServer({
+                port,
+                projectDir,
+                enableHMR,
+                enableFastRefresh: true,
+                signal: shutdownController.signal,
+            }));
+        }
+        catch (error) {
+            await disposeConnectedRuntime?.();
+            throw error;
+        }
         devServer = started.server;
         const boundPort = started.port;
         const DEV_MCP_PORT_OFFSET = 2;
@@ -263,30 +350,38 @@ export function devCommand(options) {
         }
         async function shutdown() {
             if (shuttingDown) {
-                if (!demoMode)
-                    exitProcess(0);
+                if (!demoMode) {
+                    console.log("  ! Stopping immediately. Run cancellation may not have been saved.");
+                    exitProcess(1);
+                }
                 return;
             }
             shuttingDown = true;
-            const timeout = demoMode ? null : setTimeout(() => exitProcess(0), 3000);
+            let shutdownExitCode = 0;
             try {
                 keyboardHandler?.stop();
                 shutdownController.abort();
-                await mcpServer?.stop();
-                await devServer?.stop();
+                await stopDevServices([
+                    () => disposeConnectedRuntime?.(),
+                    () => mcpServer?.stop(),
+                    () => devServer?.stop(),
+                ], demoMode ? undefined : {
+                    connected: Boolean(disposeConnectedRuntime),
+                    forceExit: () => {
+                        console.log("  ! Shutdown timed out. Run cancellation may not have been saved.");
+                        exitProcess(1);
+                    },
+                });
             }
             catch {
-                // ignore
-            }
-            finally {
-                if (timeout)
-                    clearTimeout(timeout);
+                shutdownExitCode = 1;
+                console.log("  ! Cleanup failed. Run cancellation may not have been saved.");
             }
             if (demoMode) {
                 doneResolve?.();
                 return;
             }
-            exitProcess(0);
+            exitProcess(shutdownExitCode);
         }
         registerTerminationSignals(() => void shutdown());
         if (isProxyMode) {
@@ -298,10 +393,25 @@ export function devCommand(options) {
             };
         }
         const serverUrl = `http://localhost:${boundPort}`;
-        const elapsed = Date.now() - startTime;
         console.log();
-        console.log(`  ✓ Ready in ${formatDuration(elapsed)}`);
-        console.log(`  ${brand(serverUrl)}`);
+        for (const line of devReadinessLines({
+            appUrl: serverUrl,
+            connection: connectedTarget
+                ? {
+                    apiUrl: connectedDevApiBaseUrl(runtimeAuth.apiBaseUrl),
+                    project: connectedTarget.projectSlug,
+                    environment: connectedTarget.environmentName,
+                    signedIn: preflightIdentity ? authDisplayName(preflightIdentity) : undefined,
+                    studioUrl: `${studioBase.replace(/\/$/, "")}/projects/${encodeURIComponent(connectedTarget.projectSlug)}?panels=runs`,
+                }
+                : undefined,
+        }))
+            console.log(line);
+        if (isVerbose()) {
+            const runtimeId = getConnectedLocalRuntime()?.runtimeId;
+            if (runtimeId)
+                console.log(`    ${dim("Runtime")} ${runtimeId}`);
+        }
         const inferenceOptions = listInferenceOptions({
             apiToken: runtimeAuth.apiToken,
             projectSlug: runtimeAuth.projectSlug,
@@ -312,7 +422,10 @@ export function devCommand(options) {
             mistralApiKey: getEnv("MISTRAL_API_KEY"),
         });
         if (inferenceOptions.length > 0) {
-            console.log(`  ${dim("Inference")} ${brand(inferenceOptions.join(", "))}`);
+            console.log(`  ${dim("Inference")} ${brand(inferenceOptions.map((option) => option.replace("Veryfront Cloud AI Gateway", `${veryfrontServiceName(connectedDevApiBaseUrl(runtimeAuth.apiBaseUrl))} AI Gateway`)).join(", "))}`);
+            if (displayOptions.defaultModel) {
+                console.log(`  ${dim("Default model")} ${brand(displayOptions.defaultModel)} (configured)`);
+            }
         }
         // The banner reports configured paths, and it must not block Ready on a
         // network round-trip (see `void authReady` above). But an expired stored
@@ -330,9 +443,7 @@ export function devCommand(options) {
         if (mcpServer && isVerbose()) {
             console.log(`  ${dim("MCP")} ${brand(`http://localhost:${mcpPort}/mcp`)}`);
         }
-        if (isTTY()) {
-            console.log(devShortcuts());
-        }
+        console.log(`  Waiting for requests…${isTTY() ? "  Press ? for shortcuts." : ""}`);
         console.log();
         if (open) {
             try {
@@ -364,7 +475,7 @@ export function devCommand(options) {
                         return;
                     }
                     console.log(`  ${dim("Opening browser...")}`);
-                    const result = await loginForDevShortcut();
+                    const result = await loginForDevShortcut(() => login(undefined, getEnvironmentConfig(), projectDir, createConnectedDevAuthenticationOptions(connectedDevApiBaseUrl(runtimeAuth.apiBaseUrl))));
                     if (!result)
                         return;
                     identity = result;
@@ -380,7 +491,13 @@ export function devCommand(options) {
                         return;
                     }
                     console.log(`  ${dim("Pulling...")}`);
-                    await runSyncAction(() => pullCommand({ projectSlug: project.slug, projectDir, force: true, quiet: true }), "Pulled");
+                    await runSyncAction(() => pullCommand({
+                        projectSlug: project.slug,
+                        projectDir,
+                        force: true,
+                        quiet: true,
+                        transport: createConnectedDevSyncTransport(connectedDevApiBaseUrl(runtimeAuth.apiBaseUrl)),
+                    }), "Pulled");
                 },
                 onPush: async () => {
                     const project = selectedProject;
@@ -390,7 +507,10 @@ export function devCommand(options) {
                     }
                     console.log(`  ${dim("Pushing...")}`);
                     const pushOptions = createSelectedProjectPushOptions(projectDir, project);
-                    await runSyncAction(() => pushCommand(pushOptions), `Pushed to ${pushOptions.branch} ${dim("- merge in Studio")}`);
+                    await runSyncAction(() => pushCommand({
+                        ...pushOptions,
+                        transport: createConnectedDevSyncTransport(connectedDevApiBaseUrl(runtimeAuth.apiBaseUrl)),
+                    }), `Pushed to ${pushOptions.branch} ${dim("- merge in Studio")}`);
                 },
             });
             keyboardHandler.start();

package/esm/cli/commands/dev/connected-dev.d.ts

@@ -0,0 +1,32 @@
+import type { DeployControlPlane } from "../../shared/deployment/control-plane.js";
+import { type ResolvedConfig } from "../../shared/config.js";
+/** Admission preflight for a directory that explicitly names a Cloud project. */
+export interface ConnectedDevTarget {
+    projectId: string;
+    projectSlug: string;
+    environmentId: string;
+    environmentName: string;
+}
+export declare function prepareConnectedDev(projectSlug: string | undefined, environmentName: string, dependencies: {
+    authenticate(): Promise<boolean>;
+    resolve(projectSlug: string, environmentName: string): Promise<ConnectedDevTarget>;
+}, proxyMode?: boolean): Promise<ConnectedDevTarget | undefined>;
+/** Qualified credentials without an override target the official API. */
+export declare function connectedDevApiBaseUrl(apiBaseUrl?: string): string;
+/** Release every owned service even if one cleanup fails. */
+export declare function stopDevServices(cleanups: Array<() => void | Promise<void>>, shutdown?: {
+    connected: boolean;
+    forceExit(): void;
+}): Promise<void>;
+/** Keep connected preflight on the host transport after project config executes. */
+export declare function createConnectedDevControlPlane(config: ResolvedConfig, options?: {
+    timeoutMs?: number;
+}): DeployControlPlane;
+/** Keep the local runtime and readiness link on the connected API's Studio. */
+export declare function connectedDevStudioBaseUrl(apiBaseUrl: string, studioUrl?: string): string;
+/** Resolve directory-owned identity before accepting a mutable Cloud slug. */
+export declare function resolveConnectedDevProject(controlPlane: Pick<DeployControlPlane, "getProject">, projectDir: string, config: ResolvedConfig): Promise<import("../../shared/deployment/control-plane.js").DeployProjectRecord>;
+export declare function applyConnectedDevProjectSlug<T extends {
+    projectSlug?: string;
+}>(context: T, projectSlug: string): T;
+//# sourceMappingURL=connected-dev.d.ts.map

package/esm/cli/commands/dev/connected-dev.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connected-dev.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/dev/connected-dev.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0CAA0C,CAAC;AAInF,OAAO,EAAmB,KAAK,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAK9E,iFAAiF;AACjF,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,eAAe,EAAE,MAAM,EACvB,YAAY,EAAE;IACZ,YAAY,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IACjC,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;CACpF,EACD,SAAS,UAAQ,GAChB,OAAO,CAAC,kBAAkB,GAAG,SAAS,CAAC,CAQzC;AAED,yEAAyE;AACzE,wBAAgB,sBAAsB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAElE;AAED,6DAA6D;AAC7D,wBAAsB,eAAe,CACnC,QAAQ,EAAE,KAAK,CAAC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,EAC3C,QAAQ,CAAC,EAAE;IAAE,SAAS,EAAE,OAAO,CAAC;IAAC,SAAS,IAAI,IAAI,CAAA;CAAE,GACnD,OAAO,CAAC,IAAI,CAAC,CAuBf;AAED,oFAAoF;AACpF,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,cAAc,EACtB,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,sBAMrC;AAED,+EAA+E;AAC/E,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAWxF;AAED,8EAA8E;AAC9E,wBAAsB,0BAA0B,CAC9C,YAAY,EAAE,IAAI,CAAC,kBAAkB,EAAE,YAAY,CAAC,EACpD,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,cAAc,mFAgBvB;AAED,wBAAgB,4BAA4B,CAAC,CAAC,SAAS;IAAE,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,EAC7E,OAAO,EAAE,CAAC,EACV,WAAW,EAAE,MAAM,GAClB,CAAC,CAIH"}

package/esm/cli/commands/dev/connected-dev.js

@@ -0,0 +1,81 @@
+import { setEnv } from "../../../src/platform/compat/process/env.js";
+import { refreshEnvironmentConfig } from "../../../src/config/environment-config.js";
+import { readProjectLinkForControlPlane, writeProjectLink } from "../../shared/project-link.js";
+import { projectApiReference } from "../../shared/project-resolution.js";
+import { createHttpDeployControlPlane } from "../../shared/deployment/control-plane.js";
+import { createApiClient } from "../../shared/config.js";
+import { createCloudOnboardingTransport } from "../../shared/cloud-onboarding-transport.js";
+import { DEFAULT_API_URL } from "../../shared/constants.js";
+const CONNECTED_DEV_SHUTDOWN_TIMEOUT_MS = 75_000;
+export async function prepareConnectedDev(projectSlug, environmentName, dependencies, proxyMode = false) {
+    if (proxyMode || !projectSlug)
+        return undefined;
+    if (!await dependencies.authenticate()) {
+        throw new Error("Veryfront Cloud login is required for this linked project. Run veryfront login, then npm run dev again.");
+    }
+    return await dependencies.resolve(projectSlug, environmentName);
+}
+/** Qualified credentials without an override target the official API. */
+export function connectedDevApiBaseUrl(apiBaseUrl) {
+    return apiBaseUrl ?? DEFAULT_API_URL;
+}
+/** Release every owned service even if one cleanup fails. */
+export async function stopDevServices(cleanups, shutdown) {
+    // Connected cleanup drains pending admission/events before terminal persistence;
+    // renewal, pending append, final flush and completion can each take 15 seconds.
+    // Leave additional time for scheduling before reporting an incomplete shutdown.
+    const timeout = shutdown
+        ? setTimeout(() => shutdown.forceExit(), shutdown.connected ? CONNECTED_DEV_SHUTDOWN_TIMEOUT_MS : 3_000)
+        : undefined;
+    try {
+        const results = await Promise.allSettled(cleanups.map((cleanup) => Promise.resolve().then(cleanup)));
+        const errors = results.filter((result) => result.status === "rejected").map((result) => result.reason);
+        if (errors.length) {
+            throw new AggregateError(errors, "Some local development services could not stop cleanly.");
+        }
+    }
+    finally {
+        if (timeout !== undefined)
+            clearTimeout(timeout);
+    }
+}
+/** Keep connected preflight on the host transport after project config executes. */
+export function createConnectedDevControlPlane(config, options = {}) {
+    return createHttpDeployControlPlane(config, createApiClient(config, createCloudOnboardingTransport(config.apiUrl, options.timeoutMs)));
+}
+/** Keep the local runtime and readiness link on the connected API's Studio. */
+export function connectedDevStudioBaseUrl(apiBaseUrl, studioUrl) {
+    if (studioUrl)
+        return studioUrl;
+    const hostname = new URL(apiBaseUrl).hostname;
+    if (["localhost", "127.0.0.1", "[::1]"].includes(hostname)) {
+        return "http://localhost:3000";
+    }
+    if (hostname === "api.veryfront.com")
+        return "https://veryfront.com";
+    if (hostname === "api.veryfront.org")
+        return "https://veryfront.org";
+    throw new Error(`Cannot determine Studio for connected API "${apiBaseUrl}". Set STUDIO_URL to your Studio origin and run npm run dev again.`);
+}
+/** Resolve directory-owned identity before accepting a mutable Cloud slug. */
+export async function resolveConnectedDevProject(controlPlane, projectDir, config) {
+    const link = await readProjectLinkForControlPlane(projectDir, config.apiUrl);
+    const matchesLink = link && (link.projectSlug === config.projectSlug ||
+        link.previousProjectSlugs?.includes(config.projectSlug));
+    const projectId = matchesLink ? link.projectId : config.projectId;
+    const project = await controlPlane.getProject(projectApiReference({ ...config, projectId }));
+    if (matchesLink && link.projectSlug !== project.slug) {
+        await writeProjectLink(projectDir, {
+            controlPlane: link.controlPlane,
+            projectId: link.projectId,
+            projectSlug: project.slug,
+            previousProjectSlugs: [...new Set([...(link.previousProjectSlugs ?? []), link.projectSlug])],
+        });
+    }
+    return project;
+}
+export function applyConnectedDevProjectSlug(context, projectSlug) {
+    setEnv("VERYFRONT_PROJECT_SLUG", projectSlug);
+    refreshEnvironmentConfig();
+    return { ...context, projectSlug };
+}

package/esm/cli/commands/dev/display-options.d.ts

@@ -0,0 +1,6 @@
+/** Capture operator display choices before importing the local project. */
+export declare function captureDevDisplayOptions(): {
+    studioUrl?: string;
+    defaultModel?: string;
+};
+//# sourceMappingURL=display-options.d.ts.map

package/esm/cli/commands/dev/display-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"display-options.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/dev/display-options.ts"],"names":[],"mappings":"AAGA,2EAA2E;AAC3E,wBAAgB,wBAAwB,IAAI;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,CAQxF"}

package/esm/cli/commands/dev/display-options.js

@@ -0,0 +1,11 @@
+import { getHostEnvExcludingEnvFile } from "../../../src/platform/compat/process.js";
+import { getEnvSource } from "../../../src/utils/env-loader.js";
+/** Capture operator display choices before importing the local project. */
+export function captureDevDisplayOptions() {
+    const processValue = (key) => getEnvSource(key).source === "process"
+        ? getHostEnvExcludingEnvFile(key)?.trim() || undefined
+        : undefined;
+    const studioUrl = processValue("STUDIO_URL");
+    const defaultModel = processValue("VERYFRONT_DEFAULT_MODEL");
+    return { ...(studioUrl ? { studioUrl } : {}), ...(defaultModel ? { defaultModel } : {}) };
+}

package/esm/cli/commands/dev/handler.d.ts

@@ -6,6 +6,7 @@ import type { ParsedArgs } from "../../shared/types.js";
 declare const parseDevArgsBase: (args: ParsedArgs) => import("../../shared/args.js").SafeParseResult<import("../../../src/extensions/schema/schema-validator.js").InferShape<{
     port: import("../../../src/internal-agents/schema.js").Schema<number>;
     project: import("../../../src/internal-agents/schema.js").Schema<string | undefined>;
+    env: import("../../../src/internal-agents/schema.js").Schema<string | undefined>;
     hmr: import("../../../src/internal-agents/schema.js").Schema<boolean>;
     noHmr: import("../../../src/internal-agents/schema.js").Schema<boolean>;
     open: import("../../../src/internal-agents/schema.js").Schema<boolean>;