@prisma/cli 3.0.0-dev.104.1 → 3.0.0-dev.105.1

package/dist/adapters/local-state.js

@@ -1,5 +1,5 @@
-import { mkdir, readFile, writeFile } from "node:fs/promises";
 import path from "node:path";
+import { mkdir, readFile, writeFile } from "node:fs/promises";
 //#region src/adapters/local-state.ts
 const DEFAULT_STATE = {
 	auth: null,
@@ -12,7 +12,8 @@ const DEFAULT_STATE = {
 	app: {
 		selectedByProject: {},
 		knownLiveDeploymentByProject: {}
-	}
+	},
+	agent: { setupPromptDismissedAt: null }
 };
 const DEFAULT_STATE_FILE_NAME = "state.json";
 function resolveLocalStateFilePath(stateDir) {
@@ -43,7 +44,8 @@ var LocalStateStore = class {
 				app: {
 					selectedByProject: parsed.app?.selectedByProject ?? {},
 					knownLiveDeploymentByProject: parsed.app?.knownLiveDeploymentByProject ?? {}
-				}
+				},
+				agent: { setupPromptDismissedAt: parsed.agent?.setupPromptDismissedAt ?? null }
 			};
 		} catch (error) {
 			if (error.code === "ENOENT") return structuredClone(DEFAULT_STATE);
@@ -139,6 +141,15 @@ var LocalStateStore = class {
 		await this.write(state);
 		return state;
 	}
+	async readAgentSetupPromptDismissedAt() {
+		return (await this.read()).agent.setupPromptDismissedAt;
+	}
+	async setAgentSetupPromptDismissedAt(dismissedAt) {
+		const state = await this.read();
+		state.agent.setupPromptDismissedAt = dismissedAt;
+		await this.write(state);
+		return state;
+	}
 };
 //#endregion
 export { LocalStateStore, resolveLocalStateFilePath };

package/dist/adapters/token-storage.js

@@ -1,6 +1,6 @@
 import { getAuthFilePath } from "../lib/auth/client.js";
-import fs from "node:fs/promises";
 import path from "node:path";
+import fs from "node:fs/promises";
 import { randomUUID } from "node:crypto";
 import { CredentialsStore } from "@prisma/credentials-store";
 //#region src/adapters/token-storage.ts

package/dist/cli2.js

@@ -1,10 +1,11 @@
 import { CliError } from "./shell/errors.js";
-import "./shell/prompt.js";
 import { attachCommandDescriptor } from "./shell/command-meta.js";
-import { addCompactGlobalFlags } from "./shell/global-flags.js";
 import { createShellUi } from "./shell/ui.js";
+import { addCompactGlobalFlags } from "./shell/global-flags.js";
 import { configureRuntimeCommand, createCommandContext } from "./shell/runtime.js";
 import { formatUnexpectedError, writeHumanError, writeJsonError, writeJsonSuccess } from "./shell/output.js";
+import { createAgentCommand } from "./commands/agent/index.js";
+import "./shell/prompt.js";
 import { createAppCommand } from "./commands/app/index.js";
 import { createAuthCommand } from "./commands/auth/index.js";
 import { createBranchCommand } from "./commands/branch/index.js";
@@ -46,6 +47,7 @@ function createProgram(runtime) {
 	program.addOption(new Option("--version", "Print the CLI version and exit."));
 	program.name("prisma").showSuggestionAfterError();
 	program.addCommand(createVersionCommand(runtime));
+	program.addCommand(createAgentCommand(runtime));
 	program.addCommand(createAuthCommand(runtime));
 	program.addCommand(createProjectCommand(runtime));
 	program.addCommand(createGitCommand(runtime));

package/dist/commands/agent/index.js

@@ -0,0 +1,60 @@
+import { runAgentInstall, runAgentStatus } from "../../controllers/agent.js";
+import { attachCommandDescriptor } from "../../shell/command-meta.js";
+import { renderAgentInstall, renderAgentStatus, serializeAgentInstall, serializeAgentStatus } from "../../presenters/agent.js";
+import { addCompactGlobalFlags, addGlobalFlags } from "../../shell/global-flags.js";
+import { configureRuntimeCommand } from "../../shell/runtime.js";
+import { runCommand } from "../../shell/command-runner.js";
+import { Command, Option } from "commander";
+//#region src/commands/agent/index.ts
+function createAgentCommand(runtime) {
+	const command = attachCommandDescriptor(configureRuntimeCommand(new Command("agent"), runtime), "agent");
+	addCompactGlobalFlags(command);
+	command.addCommand(createAgentInstallCommand(runtime));
+	command.addCommand(createAgentUpdateCommand(runtime));
+	command.addCommand(createAgentStatusCommand(runtime));
+	return command;
+}
+function createAgentInstallCommand(runtime) {
+	const command = attachCommandDescriptor(configureRuntimeCommand(new Command("install"), runtime), "agent.install");
+	addAgentInstallOptions(command);
+	addGlobalFlags(command);
+	command.action(async (options) => {
+		await runCommand(runtime, "agent.install", options, (context) => runAgentInstall(context, options, "install"), {
+			renderHuman: (context, descriptor, result) => renderAgentInstall(context, descriptor, result),
+			renderJson: (result) => serializeAgentInstall(result)
+		});
+	});
+	return command;
+}
+function createAgentUpdateCommand(runtime) {
+	const command = attachCommandDescriptor(configureRuntimeCommand(new Command("update"), runtime), "agent.update");
+	addAgentInstallOptions(command);
+	addGlobalFlags(command);
+	command.action(async (options) => {
+		await runCommand(runtime, "agent.update", options, (context) => runAgentInstall(context, options, "update"), {
+			renderHuman: (context, descriptor, result) => renderAgentInstall(context, descriptor, result),
+			renderJson: (result) => serializeAgentInstall(result)
+		});
+	});
+	return command;
+}
+function createAgentStatusCommand(runtime) {
+	const command = attachCommandDescriptor(configureRuntimeCommand(new Command("status"), runtime), "agent.status");
+	command.addOption(new Option("--global", "Check globally installed Prisma skills instead of project skills"));
+	addGlobalFlags(command);
+	command.action(async (options) => {
+		await runCommand(runtime, "agent.status", options, (context) => runAgentStatus(context, options), {
+			renderHuman: (context, descriptor, result) => renderAgentStatus(context, descriptor, result),
+			renderJson: (result) => serializeAgentStatus(result)
+		});
+	});
+	return command;
+}
+function addAgentInstallOptions(command) {
+	command.addOption(new Option("--agent <agent>", "Agent target for Prisma skills; repeat for multiple agents").argParser(collectValues)).addOption(new Option("--all-agents", "Install Prisma skills for every agent supported by the skills CLI")).addOption(new Option("--skill <skill>", "Prisma skill to install; repeat for multiple skills").argParser(collectValues)).addOption(new Option("--global", "Install skills into the user directory instead of the project")).addOption(new Option("--copy", "Ask the skills CLI to copy files instead of symlinking them")).addOption(new Option("--dry-run", "Show changes without writing files"));
+}
+function collectValues(value, previous) {
+	return [...previous ?? [], value];
+}
+//#endregion
+export { createAgentCommand };

package/dist/commands/app/index.js

@@ -1,11 +1,11 @@
 import { usageError } from "../../shell/errors.js";
-import { APP_BUILD_TYPES } from "../../lib/app/build.js";
 import { attachCommandDescriptor } from "../../shell/command-meta.js";
 import { addCompactGlobalFlags, addGlobalFlags } from "../../shell/global-flags.js";
 import { configureRuntimeCommand } from "../../shell/runtime.js";
+import { runCommand, runStreamingCommand } from "../../shell/command-runner.js";
+import { APP_BUILD_TYPES } from "../../lib/app/build.js";
 import { runAppBuild, runAppDeploy, runAppDomainAdd, runAppDomainRemove, runAppDomainRetry, runAppDomainShow, runAppDomainWait, runAppListDeploys, runAppLogs, runAppOpen, runAppPromote, runAppRemove, runAppRollback, runAppRun, runAppShow, runAppShowDeploy } from "../../controllers/app.js";
 import { isAppDeployAllResult, renderAppBuild, renderAppDeploy, renderAppDeployAll, renderAppDomainAdd, renderAppDomainRemove, renderAppDomainRetry, renderAppDomainShow, renderAppListDeploys, renderAppOpen, renderAppPromote, renderAppRemove, renderAppRollback, renderAppRun, renderAppShow, renderAppShowDeploy, serializeAppBuild, serializeAppDeploy, serializeAppDeployAll, serializeAppDomainAdd, serializeAppDomainRemove, serializeAppDomainRetry, serializeAppDomainShow, serializeAppListDeploys, serializeAppOpen, serializeAppPromote, serializeAppRemove, serializeAppRollback, serializeAppRun, serializeAppShow, serializeAppShowDeploy } from "../../presenters/app.js";
-import { runCommand, runStreamingCommand } from "../../shell/command-runner.js";
 import { Command, Option } from "commander";
 import { FRAMEWORK_KEYS, LOCAL_DEV_BUILD_TYPES } from "@prisma/compute-sdk/config";
 //#region src/commands/app/index.ts

package/dist/commands/auth/index.js

@@ -1,8 +1,8 @@
 import { attachCommandDescriptor } from "../../shell/command-meta.js";
 import { addCompactGlobalFlags, addGlobalFlags } from "../../shell/global-flags.js";
 import { configureRuntimeCommand } from "../../shell/runtime.js";
-import { runAuthLogin, runAuthLogout, runAuthWhoAmI, runAuthWorkspaceList, runAuthWorkspaceLogout, runAuthWorkspaceUse } from "../../controllers/auth.js";
 import { runCommand } from "../../shell/command-runner.js";
+import { runAuthLogin, runAuthLogout, runAuthWhoAmI, runAuthWorkspaceList, runAuthWorkspaceLogout, runAuthWorkspaceUse } from "../../controllers/auth.js";
 import { renderAuthSuccess, renderAuthWorkspaceList, renderAuthWorkspaceLogout, renderAuthWorkspaceUse, serializeAuthWorkspaceList, serializeAuthWorkspaceLogout, serializeAuthWorkspaceUse } from "../../presenters/auth.js";
 import { Command, Option } from "commander";
 //#region src/commands/auth/index.ts

package/dist/commands/git/index.js

@@ -1,8 +1,8 @@
 import { attachCommandDescriptor } from "../../shell/command-meta.js";
 import { addCompactGlobalFlags, addGlobalFlags } from "../../shell/global-flags.js";
 import { configureRuntimeCommand } from "../../shell/runtime.js";
-import { runGitConnect, runGitDisconnect } from "../../controllers/project.js";
 import { runCommand } from "../../shell/command-runner.js";
+import { runGitConnect, runGitDisconnect } from "../../controllers/project.js";
 import { renderGitConnect, renderGitDisconnect } from "../../presenters/project.js";
 import { Command } from "commander";
 //#region src/commands/git/index.ts

package/dist/commands/project/index.js

@@ -1,8 +1,8 @@
 import { attachCommandDescriptor } from "../../shell/command-meta.js";
 import { addCompactGlobalFlags, addGlobalFlags } from "../../shell/global-flags.js";
 import { configureRuntimeCommand } from "../../shell/runtime.js";
-import { runProjectCreate, runProjectLink, runProjectList, runProjectShow } from "../../controllers/project.js";
 import { runCommand } from "../../shell/command-runner.js";
+import { runProjectCreate, runProjectLink, runProjectList, runProjectShow } from "../../controllers/project.js";
 import { renderProjectList, renderProjectSetup, renderProjectShow, serializeProjectList, serializeProjectSetup, serializeProjectShow } from "../../presenters/project.js";
 import { createEnvCommand } from "../env.js";
 import { Command } from "commander";

package/dist/controllers/agent.js

@@ -0,0 +1,228 @@
+import { resolveSkillsPackageRunner } from "../lib/agent/package-manager.js";
+import { resolvePrismaCliPackageCommand } from "../lib/agent/cli-command.js";
+import { DEFAULT_PRISMA_AGENT_SKILLS, DEFAULT_PRISMA_AGENT_TARGETS, PRISMA_AGENT_INSTALL_ARGS, PRISMA_AGENT_STATUS_ARGS, PRISMA_SKILLS_SOURCE, SKILLS_CLI_PACKAGE } from "../lib/agent/constants.js";
+import { readPrismaAgentSetupStatus, resolvePrismaAgentSetupCwd } from "../lib/agent/setup-status.js";
+import { formatShellCommand } from "../shell/command-arguments.js";
+import { CliError } from "../shell/errors.js";
+import { execa } from "execa";
+//#region src/controllers/agent.ts
+async function runAgentInstall(context, options, operation = "install", runOptions = {}) {
+	const dryRun = options.dryRun === true;
+	const cwd = await resolvePrismaAgentSetupCwd({
+		cwd: runOptions.cwd ?? context.runtime.cwd,
+		signal: context.runtime.signal
+	});
+	const skills = await installSkills(context, {
+		command: await buildSkillsInstallCommand(context, options, cwd),
+		cwd,
+		dryRun
+	});
+	const nextSteps = await resolveAgentInstallNextSteps(context, {
+		cwd,
+		dryRun,
+		global: options.global === true
+	});
+	return {
+		command: `agent.${operation}`,
+		result: {
+			operation,
+			skills
+		},
+		warnings: [],
+		nextSteps
+	};
+}
+async function resolveAgentInstallNextSteps(context, options) {
+	if (options.dryRun) return [];
+	return [`Run ${await resolvePrismaCliPackageCommand({
+		cwd: options.cwd,
+		signal: context.runtime.signal,
+		args: options.global ? [...PRISMA_AGENT_STATUS_ARGS, "--global"] : PRISMA_AGENT_STATUS_ARGS
+	})} to verify the installed Prisma skills.`];
+}
+async function runAgentStatus(context, options = {}) {
+	const statusScope = options.global ? "global" : "project";
+	const cwd = await resolvePrismaAgentSetupCwd({
+		cwd: context.runtime.cwd,
+		signal: context.runtime.signal
+	});
+	const status = await readPrismaAgentSetupStatus({
+		cwd,
+		stateStore: context.stateStore,
+		signal: context.runtime.signal
+	});
+	const installCommand = await resolvePrismaCliPackageCommand({
+		cwd,
+		signal: context.runtime.signal,
+		args: options.global ? [...PRISMA_AGENT_INSTALL_ARGS, "--global"] : PRISMA_AGENT_INSTALL_ARGS
+	});
+	const skillsList = await listInstalledPrismaSkills(context, cwd, statusScope);
+	const skillsInstalled = skillsList.status === "ok" ? skillsList.skills.length > 0 : statusScope === "project" && status.skillsInstalled;
+	const warnings = skillsList.status === "ok" ? [] : [statusScope === "project" ? `Could not read installed skills with ${formatShellCommand(skillsList.command)}: ${skillsList.message}. Falling back to ${status.skillsLockPath}.` : `Could not read globally installed skills with ${formatShellCommand(skillsList.command)}: ${skillsList.message}.`];
+	const statusSource = resolveStatusSource(skillsList, statusScope);
+	return {
+		command: "agent.status",
+		result: {
+			skills: skillsList.status === "ok" ? skillsList.skills : [],
+			skillsListCommand: skillsList.command,
+			statusScope,
+			skillsLockPath: status.skillsLockPath,
+			skillsLockInstalled: status.skillsInstalled,
+			skillsInstalled,
+			statusSource,
+			promptDismissedAt: status.promptDismissedAt
+		},
+		warnings,
+		nextSteps: skillsInstalled ? [] : [`Run ${installCommand} to install or refresh Prisma skills.`]
+	};
+}
+async function buildSkillsInstallCommand(context, options, cwd) {
+	const command = [
+		...await resolveSkillsPackageRunner({
+			cwd,
+			signal: context.runtime.signal
+		}),
+		SKILLS_CLI_PACKAGE,
+		"add",
+		PRISMA_SKILLS_SOURCE
+	];
+	const skills = options.skill && options.skill.length > 0 ? options.skill : DEFAULT_PRISMA_AGENT_SKILLS;
+	const agents = resolveTargetAgents(options);
+	for (const skill of skills) command.push("--skill", skill);
+	for (const agent of agents) command.push("--agent", agent);
+	if (options.global) command.push("--global");
+	if (options.copy || process.platform === "win32") command.push("--copy");
+	command.push("--yes");
+	return command;
+}
+function resolveTargetAgents(options) {
+	if (options.allAgents) return ["*"];
+	if (options.agent && options.agent.length > 0) return options.agent;
+	return DEFAULT_PRISMA_AGENT_TARGETS;
+}
+async function installSkills(context, options) {
+	if (options.dryRun) return {
+		status: "would-install",
+		command: options.command
+	};
+	await runChildProcess(context, options.command, options.cwd);
+	return {
+		status: "installed",
+		command: options.command
+	};
+}
+async function listInstalledPrismaSkills(context, cwd, scope) {
+	const command = [
+		...await resolveSkillsPackageRunner({
+			cwd,
+			signal: context.runtime.signal
+		}),
+		SKILLS_CLI_PACKAGE,
+		"list",
+		...scope === "global" ? ["-g"] : [],
+		"--json"
+	];
+	try {
+		const { stdout } = await runChildProcessCapture(context, command, cwd);
+		return {
+			status: "ok",
+			command,
+			skills: parseSkillsListOutput(stdout).filter((skill) => isPrismaSkillName(skill.name))
+		};
+	} catch (error) {
+		if (isAbortError(error) || context.runtime.signal.aborted) throw error;
+		return {
+			status: "failed",
+			command,
+			message: error instanceof Error ? error.message : String(error)
+		};
+	}
+}
+async function runChildProcess(context, command, cwd) {
+	const [executable, args] = splitCommand(command);
+	try {
+		await execa(executable, args, {
+			cwd,
+			env: context.runtime.env,
+			cancelSignal: context.runtime.signal,
+			stdin: "ignore"
+		});
+	} catch (error) {
+		if (isAbortError(error)) throw error;
+		throw skillsInstallFailed(command, exitCodeFromError(error), error);
+	}
+}
+async function runChildProcessCapture(context, command, cwd) {
+	const [executable, args] = splitCommand(command);
+	const result = await execa(executable, args, {
+		cwd,
+		env: context.runtime.env,
+		cancelSignal: context.runtime.signal,
+		stdin: "ignore"
+	});
+	return {
+		stdout: result.stdout ?? "",
+		stderr: result.stderr ?? ""
+	};
+}
+function splitCommand(command) {
+	const [executable, ...args] = command;
+	if (!executable) throw new Error("Cannot run an empty command.");
+	return [executable, args];
+}
+function isAbortError(error) {
+	return error instanceof Error && error.name === "AbortError" || isObject(error) && error.isCanceled === true;
+}
+function exitCodeFromError(error) {
+	if (!isObject(error) || typeof error.exitCode !== "number") return null;
+	return error.exitCode;
+}
+function isObject(value) {
+	return typeof value === "object" && value !== null;
+}
+function resolveStatusSource(skillsList, statusScope) {
+	if (skillsList.status === "ok") return "skills-cli";
+	return statusScope === "project" ? "skills-lock" : "unavailable";
+}
+function parseSkillsListOutput(output) {
+	const parsed = JSON.parse(output);
+	if (!Array.isArray(parsed)) throw new Error("skills list did not return a JSON array");
+	return parsed.flatMap((item) => {
+		const skill = parseInstalledSkill(item);
+		return skill ? [skill] : [];
+	});
+}
+function parseInstalledSkill(value) {
+	if (typeof value !== "object" || value === null) return null;
+	const candidate = value;
+	if (typeof candidate.name !== "string" || typeof candidate.path !== "string" || typeof candidate.scope !== "string" || !Array.isArray(candidate.agents)) return null;
+	return {
+		name: candidate.name,
+		path: candidate.path,
+		scope: candidate.scope,
+		agents: candidate.agents.filter((agent) => typeof agent === "string")
+	};
+}
+function isPrismaSkillName(name) {
+	return name === "prisma" || name.startsWith("prisma-");
+}
+function skillsInstallFailed(command, code, error) {
+	const commandText = formatShellCommand(command);
+	return new CliError({
+		code: "AGENT_SKILLS_INSTALL_FAILED",
+		domain: "cli",
+		summary: "Prisma skills install failed",
+		why: `The skills installer exited with code ${code ?? "unknown"}.`,
+		fix: "Run the command below to retry the installer directly.",
+		debug: formatErrorDebug(error),
+		exitCode: 1,
+		nextSteps: [commandText]
+	});
+}
+function formatErrorDebug(error) {
+	if (error instanceof Error) return error.stack ?? error.message;
+	if (error === void 0) return;
+	return String(error);
+}
+//#endregion
+export { runAgentInstall, runAgentStatus };

package/dist/controllers/app.js

@@ -1,16 +1,21 @@
+import { resolvePrismaCliPackageCommand } from "../lib/agent/cli-command.js";
+import { PRISMA_AGENT_INSTALL_ARGS, PRISMA_COMPUTE_AGENT_SKILL } from "../lib/agent/constants.js";
+import { readPrismaAgentSetupStatus, shouldOfferPrismaAgentSetup } from "../lib/agent/setup-status.js";
+import { formatCommandArgument } from "../shell/command-arguments.js";
+import { CliError, authRequiredError, featureUnavailableError, usageError, workspaceRequiredError } from "../shell/errors.js";
+import { runAgentInstall } from "./agent.js";
+import { renderCommandHeader, renderSummaryLine } from "../shell/ui.js";
+import { canPrompt } from "../shell/runtime.js";
+import { writeJsonEvent } from "../shell/output.js";
 import { SERVICE_TOKEN_ENV_VAR, getApiBaseUrl } from "../lib/auth/client.js";
 import { FileTokenStorage } from "../adapters/token-storage.js";
-import { CliError, authRequiredError, featureUnavailableError, usageError, workspaceRequiredError } from "../shell/errors.js";
 import { confirmPrompt, selectPrompt, textPrompt } from "../shell/prompt.js";
 import "../lib/app/app-interaction.js";
 import { PRISMA_APP_CONFIG_FILENAME, detectLegacyBuildSettings, resolveConfiguredAppBuildSettings, resolveInferredAppBuildSettings } from "../lib/app/build-settings.js";
 import { APP_BUILD_TYPES, APP_BUILD_TYPE_LABELS, RESOLVED_APP_BUILD_TYPES, executeAppBuild } from "../lib/app/build.js";
 import { envVarNames, parseEnvInputs } from "../lib/app/env-vars.js";
 import { DomainApiError, createAppProvider } from "../lib/app/app-provider.js";
-import { renderCommandHeader } from "../shell/ui.js";
-import { canPrompt } from "../shell/runtime.js";
 import { LOCAL_RESOLUTION_PIN_RELATIVE_PATH, readLocalResolutionPin } from "../lib/project/local-pin.js";
-import { formatCommandArgument } from "../shell/command-arguments.js";
 import { buildProjectSetupNextActions, inferTargetName, localProjectWorkspaceMismatchError, projectNotFoundError, projectResolutionErrorToCliError, resolveDurablePlatformMapping, resolveProjectTarget, sortProjects } from "../lib/project/resolution.js";
 import { bindProjectToDirectory, projectCreateFailedError, projectDirectoryBindingErrorToCliError, projectSetupNameRequiredError, resolveProjectForSetup, toProjectSummary } from "../lib/project/setup.js";
 import { maybeSetupBranchDatabase } from "../lib/app/branch-database-deploy.js";
@@ -27,13 +32,12 @@ import { requireComputeAuth } from "../lib/auth/guard.js";
 import { readAuthState } from "../lib/auth/auth-ops.js";
 import { readLocalGitBranch } from "../lib/git/local-branch.js";
 import { promptForProjectSetupChoice } from "../lib/project/interactive-setup.js";
-import { writeJsonEvent } from "../shell/output.js";
 import { createSelectPromptPort } from "./select-prompt-port.js";
 import { requireAuthenticatedAuthState } from "./auth.js";
 import { listRealWorkspaceProjects } from "./project.js";
-import { COMPUTE_REGIONS, ENTRYPOINT_BUILD_TYPES, FRAMEWORKS, LOCAL_DEV_BUILD_TYPES, frameworkByKey, frameworkFromAlias, isConfigBackedBuildType } from "@prisma/compute-sdk/config";
-import { access, readFile } from "node:fs/promises";
 import path from "node:path";
+import { access, readFile } from "node:fs/promises";
+import { COMPUTE_REGIONS, ENTRYPOINT_BUILD_TYPES, FRAMEWORKS, LOCAL_DEV_BUILD_TYPES, frameworkByKey, frameworkFromAlias, isConfigBackedBuildType } from "@prisma/compute-sdk/config";
 import { Result, matchError } from "better-result";
 import open from "open";
 //#region src/controllers/app.ts
@@ -265,6 +269,7 @@ async function runSingleAppDeploy(context, appName, options, preloadedConfig) {
 	});
 	const appDir = await resolveComputeAppDir(context, computeConfig);
 	const projectDir = computeConfig.config?.configDir ?? context.runtime.cwd;
+	const agentSetupWarnings = await maybePromptForAgentSetup(context, projectDir);
 	const localPinReadResult = Boolean(envProjectId || options?.projectRef || options?.createProjectName) ? Result.ok({ kind: "missing" }) : await readLocalResolutionPin(projectDir, context.runtime.signal);
 	if (localPinReadResult.isErr()) throw localPinReadErrorToDeployError(localPinReadResult.error);
 	const localPin = localPinReadResult.value;
@@ -414,7 +419,11 @@ async function runSingleAppDeploy(context, appName, options, preloadedConfig) {
 			durationMs: deployDurationMs,
 			localPin: localPinResult
 		},
-		warnings: [...legacyWarnings, ...branchDatabaseSetup.warnings],
+		warnings: [
+			...agentSetupWarnings,
+			...legacyWarnings,
+			...branchDatabaseSetup.warnings
+		],
 		nextSteps: ["prisma-cli app list-deploys", `prisma-cli app show-deploy ${deployResult.deployment.id}`]
 	};
 }
@@ -1117,6 +1126,7 @@ async function confirmDomainRemoval(context, target, hostname) {
 	if (!await confirmPrompt({
 		input: context.runtime.stdin,
 		output: context.output.stderr,
+		signal: context.runtime.signal,
 		message: `Detach ${hostname} from App "${target.app.name}"?`,
 		initialValue: false
 	})) throw usageError("Custom domain removal canceled", "The command was canceled before the domain was detached.", "Rerun the command and confirm removal, or pass --yes.", [`prisma-cli app domain remove ${hostname} --app ${target.app.name} --yes`], "app");
@@ -1456,6 +1466,7 @@ async function confirmAppRemoval(context, app) {
 	await textPrompt({
 		input: context.runtime.stdin,
 		output: context.output.stderr,
+		signal: context.runtime.signal,
 		message: `Type ${app.name} to confirm app removal`,
 		placeholder: app.name,
 		validate: (value) => value === app.name ? void 0 : `Type "${app.name}" to confirm removal.`
@@ -2080,6 +2091,42 @@ function maybeRenderProjectLinked(context, directory, projectName, localPinPath)
 	if (context.flags.json || context.flags.quiet) return;
 	context.output.stderr.write(`${context.ui.success("✔")} Linked "${directory}" to Project "${projectName}"\nSaved ${localPinPath}\n\n`);
 }
+async function maybePromptForAgentSetup(context, projectDir) {
+	if (!canPrompt(context) || context.flags.yes) return [];
+	if (!shouldOfferPrismaAgentSetup(await readPrismaAgentSetupStatus({
+		cwd: projectDir,
+		stateStore: context.stateStore,
+		signal: context.runtime.signal,
+		requiredSkill: "prisma-compute"
+	}))) return [];
+	if (!await confirmPrompt({
+		input: context.runtime.stdin,
+		output: context.runtime.stderr,
+		signal: context.runtime.signal,
+		message: "Install the Prisma Compute skill for this project?",
+		initialValue: true
+	})) {
+		await context.stateStore.setAgentSetupPromptDismissedAt((/* @__PURE__ */ new Date()).toISOString());
+		return [];
+	}
+	try {
+		await runAgentInstall(context, { skill: [PRISMA_COMPUTE_AGENT_SKILL] }, "install", { cwd: projectDir });
+		if (!context.flags.quiet && !context.flags.json) context.output.stderr.write(`${renderSummaryLine(context.ui, "success", "Installed the Prisma Compute skill for this project.")}\n\n`);
+		return [];
+	} catch (error) {
+		const message = error instanceof Error ? error.message : "Prisma skill install failed.";
+		if (!context.flags.quiet && !context.flags.json) context.output.stderr.write(`${renderSummaryLine(context.ui, "warning", `Skipped Prisma skill install: ${message}`)}\n\n`);
+		return [`The Prisma Compute skill was not installed. Run ${await resolvePrismaCliPackageCommand({
+			cwd: projectDir,
+			signal: context.runtime.signal,
+			args: [
+				...PRISMA_AGENT_INSTALL_ARGS,
+				"--skill",
+				PRISMA_COMPUTE_AGENT_SKILL
+			]
+		})} to try again.`];
+	}
+}
 async function maybeCustomizeDeploySettings(context, options) {
 	if (!options.firstDeploy || context.flags.yes || options.explicitFramework || options.explicitEntrypoint || options.explicitHttpPort || !canPrompt(context)) return {
 		framework: options.framework,
@@ -2092,6 +2139,7 @@ async function maybeCustomizeDeploySettings(context, options) {
 	if (!await confirmPrompt({
 		input: context.runtime.stdin,
 		output: context.runtime.stderr,
+		signal: context.runtime.signal,
 		message: "Customize build settings?",
 		initialValue: false
 	})) return {
@@ -2101,6 +2149,7 @@ async function maybeCustomizeDeploySettings(context, options) {
 	const framework = frameworkFromUserFacingValue(await selectPrompt({
 		input: context.runtime.stdin,
 		output: context.runtime.stderr,
+		signal: context.runtime.signal,
 		message: `Framework (${options.framework.displayName})`,
 		choices: FRAMEWORKS.map((framework) => ({
 			label: framework.displayName,
@@ -2110,6 +2159,7 @@ async function maybeCustomizeDeploySettings(context, options) {
 	const requestedPort = await textPrompt({
 		input: context.runtime.stdin,
 		output: context.runtime.stderr,
+		signal: context.runtime.signal,
 		message: `HTTP port (${options.runtime.port})`,
 		placeholder: String(options.runtime.port),
 		validate: validateDeployHttpPortText

package/dist/controllers/auth.js

@@ -1,7 +1,10 @@
-import { CLIENT_ID, SERVICE_TOKEN_ENV_VAR, getApiBaseUrl } from "../lib/auth/client.js";
-import { FileTokenStorage, WorkspaceSelectionError } from "../adapters/token-storage.js";
+import { resolvePrismaCliPackageCommand } from "../lib/agent/cli-command.js";
+import { PRISMA_AGENT_INSTALL_ARGS } from "../lib/agent/constants.js";
+import { isLikelyProjectDirectory, readPrismaAgentSetupStatus, resolvePrismaAgentSetupCwd, shouldOfferPrismaAgentSetup } from "../lib/agent/setup-status.js";
 import { authRequiredError, usageError, workspaceAmbiguousError, workspaceNotAuthenticatedError, workspaceSwitchUnavailableError } from "../shell/errors.js";
 import { canPrompt } from "../shell/runtime.js";
+import { CLIENT_ID, SERVICE_TOKEN_ENV_VAR, getApiBaseUrl } from "../lib/auth/client.js";
+import { FileTokenStorage, WorkspaceSelectionError } from "../adapters/token-storage.js";
 import { performLogin, performLogout, readAuthState } from "../lib/auth/auth-ops.js";
 import { createAuthUseCases } from "../use-cases/auth.js";
 import { createCliUseCaseGateways } from "../use-cases/create-cli-gateways.js";
@@ -17,7 +20,16 @@ async function runAuthLogin(context, options) {
 		await performLogin(context.runtime.env, context.runtime.signal);
 		result = await readAuthState(context.runtime.env, context.runtime.signal);
 	} else result = await loginWithSelectionFlow(context, createAuthUseCases(createCliUseCaseGateways(context)), options);
-	return createAuthSuccess("auth.login", result, ["prisma-cli auth whoami", "prisma-cli project list"]);
+	const agentSetupTipCommand = await resolveAgentSetupTipCommand(context);
+	if (agentSetupTipCommand) result = {
+		...result,
+		agentSetupTip: { command: agentSetupTipCommand }
+	};
+	return createAuthSuccess("auth.login", result, [
+		"prisma-cli auth whoami",
+		"prisma-cli project list",
+		...result.agentSetupTip ? [result.agentSetupTip.command] : []
+	]);
 }
 async function runAuthLogout(context) {
 	let result;
@@ -312,5 +324,28 @@ function createAuthSuccess(command, result, nextSteps) {
 		nextSteps
 	};
 }
+async function resolveAgentSetupTipCommand(context) {
+	if (context.flags.json || context.flags.quiet) return null;
+	if (context.runtime.env.CI && context.flags.interactive !== true) return null;
+	if (!context.runtime.stderr.isTTY && context.flags.interactive !== true) return null;
+	const setupCwd = await resolvePrismaAgentSetupCwd({
+		cwd: context.runtime.cwd,
+		signal: context.runtime.signal
+	});
+	if (!await isLikelyProjectDirectory({
+		cwd: setupCwd,
+		signal: context.runtime.signal
+	})) return null;
+	if (!shouldOfferPrismaAgentSetup(await readPrismaAgentSetupStatus({
+		cwd: setupCwd,
+		stateStore: context.stateStore,
+		signal: context.runtime.signal
+	}))) return null;
+	return await resolvePrismaCliPackageCommand({
+		cwd: setupCwd,
+		signal: context.runtime.signal,
+		args: PRISMA_AGENT_INSTALL_ARGS
+	});
+}
 //#endregion
 export { requireAuthenticatedAuthState, runAuthLogin, runAuthLogout, runAuthWhoAmI, runAuthWorkspaceList, runAuthWorkspaceLogout, runAuthWorkspaceUse };

package/dist/controllers/project.js

@@ -1,9 +1,9 @@
+import { formatCommandArgument } from "../shell/command-arguments.js";
 import { CliError, authRequiredError, featureUnavailableError, usageError, workspaceRequiredError } from "../shell/errors.js";
-import { createAppProvider } from "../lib/app/app-provider.js";
 import { renderSummaryLine } from "../shell/ui.js";
 import { canPrompt } from "../shell/runtime.js";
+import { createAppProvider } from "../lib/app/app-provider.js";
 import { readLocalResolutionPin } from "../lib/project/local-pin.js";
-import { formatCommandArgument } from "../shell/command-arguments.js";
 import { buildProjectSetupNextActions, inferTargetName, inspectProjectBinding, projectResolutionErrorToCliError, resolveProjectTarget, sortProjects } from "../lib/project/resolution.js";
 import { bindProjectToDirectory, isValidProjectSetupName, projectCreateFailedError, projectDirectoryBindingErrorToCliError, projectSetupNameRequiredError, resolveProjectForSetup, toProjectSummary } from "../lib/project/setup.js";
 import { requireComputeAuth } from "../lib/auth/guard.js";

package/dist/controllers/select-prompt-port.js

@@ -4,6 +4,7 @@ function createSelectPromptPort(context) {
 	return { select: ({ message, choices }) => selectPrompt({
 		input: context.runtime.stdin,
 		output: context.runtime.stderr,
+		signal: context.runtime.signal,
 		message,
 		choices
 	}) };

package/dist/lib/agent/cli-command.js

@@ -0,0 +1,17 @@
+import { formatPrismaCliCommand } from "../../shell/cli-command.js";
+import { resolvePackageRunner, resolvePackageRunnerSync } from "./package-manager.js";
+//#region src/lib/agent/cli-command.ts
+async function resolvePrismaCliPackageCommandFormatter(options) {
+	return createPrismaCliPackageCommandFormatter(await resolvePackageRunner(options));
+}
+async function resolvePrismaCliPackageCommand(options) {
+	return (await resolvePrismaCliPackageCommandFormatter(options))(options.args);
+}
+function resolvePrismaCliPackageCommandFormatterSync(cwd) {
+	return createPrismaCliPackageCommandFormatter(resolvePackageRunnerSync(cwd));
+}
+function createPrismaCliPackageCommandFormatter(packageRunner) {
+	return (args) => formatPrismaCliCommand(args, { packageRunner });
+}
+//#endregion
+export { resolvePrismaCliPackageCommand, resolvePrismaCliPackageCommandFormatterSync };