@keystrokehq/cli 0.0.30 → 0.0.32

package/README.md

@@ -89,8 +89,10 @@ keystroke --api-key sk_... --server-url https://api.example.com workflows list
 | `keystroke test` | Test agent-callable tools. |
 | `keystroke connect` | Connect official integrations through OAuth. |
 | `keystroke listen` | Create a temporary URL and print the first captured request body. |
-| `keystroke integrations` | List available integrations and registration metadata. |
-| `keystroke credentials` | List credential sets, inspect requirements, and upload credential values. |
+| `keystroke search` | Ranked discovery across operations, integrations, or credential definitions. |
+| `keystroke operations` | List and show operations (catalog metadata, including JSON schemas). |
+| `keystroke integrations` | List integrations; `integrations show` returns one integration and its operations. |
+| `keystroke credentials` | Per-org credential sets, requirements, and upload. Use `credentials definitions` for catalog auth shapes. |
 | `keystroke org` | View and switch organization context. |
 | `keystroke projects` | List or clear locally tracked projects. |
 | `keystroke runs inspect` | Inspect workflow and agent runs. |
@@ -174,6 +176,37 @@ The relevant configuration sources are:
 
 Use `--debug` on any command to show diagnostic output.
 
+## Catalog discovery
+
+Discovery commands call the server catalog API via `@keystroke/workflow-sdk`. They require the same auth as deploy: API key plus organization context.
+
+```bash
+export KEYSTROKE_API_KEY=sk_...
+export KEYSTROKE_ORG_ID=<your-org-uuid>
+export SERVER_URL=http://localhost:3001   # local API (port 3001, not the web app on 3000)
+
+keystroke search "put object"
+keystroke search "slack" --type integrations
+keystroke search "oauth" --type credentials --integration keystroke:slack
+
+keystroke operations list --integration aws-s3
+keystroke operations show aws-s3.put-object
+keystroke operations show aws-s3.put-object --schema --json
+
+keystroke integrations list
+keystroke integrations show keystroke:slack   # bare `slack` also works today
+
+keystroke credentials definitions list --role connection
+keystroke credentials definitions show keystroke:aws-s3
+```
+
+Flags shared across discovery commands:
+
+- `--json` — machine-readable output (field names match shared-types schemas).
+- `--full` on `search`, `operations list`, and `credentials definitions list` — pass `include=full` for schemas and extended fields in one round-trip.
+
+`keystroke credentials list` lists **your organization's credential sets**, not catalog definitions.
+
 ## Integrations And Credentials
 
 Connect an OAuth integration:
@@ -188,6 +221,7 @@ Inspect integration and credential state:
 
 ```bash
 keystroke integrations list
+keystroke credentials definitions list --role connection
 keystroke credentials requirements --path .
 keystroke credentials list
 ```

package/dist/{credentials-LmhgE-Co.mjs → credentials-CsncZ52a.mjs}

@@ -279,7 +279,7 @@ function createCredentialsDefinitionsCommand() {
 			optionsConfig: DEFINITION_SHOW_OPTIONS_CONFIG,
 			argument: {
 				name: "id",
-				description: "Credential definition id, e.g. official.aws-s3",
+				description: "Credential definition id, e.g. keystroke:aws-s3",
 				key: "id"
 			},
 			loadHandler: async () => (await import("./show.handler-CsidInW8.mjs")).handleCredentialDefinitionShow

package/dist/{init-DX08T87c.mjs → init-BOCDwqKR.mjs}

@@ -9,6 +9,7 @@ const InitOptionsSchema = z.object({
 	name: z.string().optional().describe("Project name (skips prompt; default: directory basename)"),
 	description: z.string().optional().describe("Project description for the API (skips prompt when creating a new project)"),
 	scaffold: z.boolean().default(true).describe("Scaffold project files (package.json, vitest.config.ts, etc.)"),
+	install: z.boolean().default(true).describe("Install scaffold dependencies after writing project files"),
 	agent: z.array(z.string()).optional().describe("Agent target to install Keystroke skills for. Repeat for multiple agents; '*' selects all."),
 	method: z.enum(SKILL_INSTALL_METHODS).optional().describe("Skill install method for agent-specific targets")
 });
@@ -29,6 +30,10 @@ const INIT_OPTIONS_CONFIG = {
 		flag: "--no-scaffold",
 		description: "Skip scaffolding project files (package.json, vitest.config.ts, etc.)"
 	},
+	install: {
+		flag: "--no-install",
+		description: "Skip installing scaffold dependencies after writing project files"
+	},
 	agent: {
 		flag: "--agent <agent>",
 		description: "Install Keystroke skills for an agent target. Repeat for multiple agents; '*' selects all.",
@@ -45,7 +50,7 @@ function createInitCommand() {
 		description: "Initialize a Keystroke project (creates keystroke.config.ts)",
 		schema: InitOptionsSchema,
 		optionsConfig: INIT_OPTIONS_CONFIG,
-		loadHandler: async () => (await import("./init.handler-CzlmkNXi.mjs")).handleInit
+		loadHandler: async () => (await import("./init.handler-B3T4J6u_.mjs")).handleInit
 	});
 }
 //#endregion

package/dist/{init.handler-CzlmkNXi.mjs → init.handler-B3T4J6u_.mjs}

@@ -1,10 +1,11 @@
 #!/usr/bin/env node
 
-import { D as CliExitError, a as ui, i as fetchLatestNpmPackageVersion } from "./keystroke.mjs";
+import { D as CliExitError, a as ui, i as fetchLatestNpmPackageVersion, j as throwReportedCliExit } from "./keystroke.mjs";
 import { i as projects } from "./dist-Dw7gCE7y.mjs";
 import { a as writeProjectConfig, i as readProjectConfig, r as getProjectConfigPath } from "./project-config-DudGRFPO.mjs";
 import { i as requireClient } from "./context-sgKhRc5v.mjs";
-import { i as UnknownSkillAgentError, n as resolveSkillInstallChoices, r as installKeystrokeAgentSkills, t as summarizeSkillInstall } from "./skill-installer-D6j9IA3Z.mjs";
+import { a as runProjectInstall, i as resolvePackageManagerResolution, t as buildProjectInstallCommand } from "./package-manager-CvY4IW7X.mjs";
+import { i as UnknownSkillAgentError, n as resolveSkillInstallChoices, r as installKeystrokeAgentSkills, t as summarizeSkillInstall } from "./skill-installer-DG8kTaQR.mjs";
 import { createRequire } from "node:module";
 import path from "node:path";
 import { access, mkdir, readFile, writeFile } from "node:fs/promises";
@@ -14,6 +15,7 @@ import { cancel, isCancel, text } from "@clack/prompts";
 const WORKFLOW_CORE_PACKAGE_NAME = "@keystrokehq/core";
 const CONFIG_PACKAGE_NAME = "@keystrokehq/config";
 const RUNTIME_PACKAGE_NAME = "@keystrokehq/runtime";
+const TESTING_PACKAGE_NAME = "@keystrokehq/testing";
 const FALLBACK_SCAFFOLD_VERSION_RANGE = "latest";
 const DEFAULT_TIMEOUT_MS = 750;
 /**
@@ -41,6 +43,13 @@ async function runtimeScaffoldVersionRange(options = {}) {
 		readLocalVersion: options.readLocalRuntimeVersion ?? readLocalRuntimeVersion
 	});
 }
+async function testingScaffoldVersionRange(options = {}) {
+	return packageScaffoldVersionRange({
+		packageName: TESTING_PACKAGE_NAME,
+		timeoutMs: options.timeoutMs,
+		readLocalVersion: options.readLocalTestingVersion ?? readLocalTestingVersion
+	});
+}
 async function packageScaffoldVersionRange(options) {
 	const latestVersion = await fetchLatestNpmPackageVersion({
 		packageName: options.packageName,
@@ -75,6 +84,14 @@ function readLocalRuntimeVersion() {
 	} catch {}
 	return null;
 }
+function readLocalTestingVersion() {
+	try {
+		const raw = readFileSync(createRequire(import.meta.url).resolve(`${TESTING_PACKAGE_NAME}/package.json`), "utf-8");
+		const version = JSON.parse(raw).version?.trim();
+		if (version) return version;
+	} catch {}
+	return null;
+}
 //#endregion
 //#region src/commands/init/templates/biome-config.ts
 /**
@@ -206,6 +223,8 @@ describe('hello workflow', () => {
 }
 //#endregion
 //#region src/commands/init/templates/package-json.ts
+/** Matches the Keystroke monorepo; Corepack uses this for `pnpm install`. */
+const SCAFFOLD_PNPM_PACKAGE_MANAGER = "pnpm@11.1.1";
 /**
 * Template for generating a package.json for a new Keystroke project.
 */
@@ -214,6 +233,7 @@ function createPackageJsonContent(projectName, options) {
 		name: projectName,
 		private: true,
 		type: "module",
+		...options.packageManagerField ? { packageManager: options.packageManagerField } : {},
 		scripts: {
 			test: "vitest run",
 			typecheck: "tsc --noEmit",
@@ -227,7 +247,7 @@ function createPackageJsonContent(projectName, options) {
 		devDependencies: {
 			"@biomejs/biome": "2.4.13",
 			"@keystrokehq/runtime": options.runtimeVersionRange,
-			"@keystrokehq/testing": options.workflowCoreVersionRange,
+			"@keystrokehq/testing": options.testingVersionRange,
 			vitest: "^4.0.18",
 			typescript: "^5.9.3"
 		}
@@ -329,7 +349,7 @@ async function promptProjectDescription(options) {
 	const t = typeof answer === "string" ? answer.trim() : "";
 	return t.length > 0 ? t : void 0;
 }
-async function ensureScaffoldPackageJson(targetDir, projectName, workflowCoreRange, configRange, runtimeRange) {
+async function ensureScaffoldPackageJson(targetDir, projectName, workflowCoreRange, configRange, runtimeRange, testingRange, packageManagerField) {
 	const pkgPath = path.join(targetDir, "package.json");
 	try {
 		const raw = await readFile(pkgPath, "utf-8");
@@ -340,7 +360,7 @@ async function ensureScaffoldPackageJson(targetDir, projectName, workflowCoreRan
 		pkg.dependencies.zod = pkg.dependencies.zod ?? "^4.3.6";
 		pkg.devDependencies = pkg.devDependencies ?? {};
 		pkg.devDependencies["@keystrokehq/runtime"] = runtimeRange;
-		pkg.devDependencies["@keystrokehq/testing"] = workflowCoreRange;
+		pkg.devDependencies["@keystrokehq/testing"] = testingRange;
 		pkg.devDependencies.vitest = pkg.devDependencies.vitest ?? "^4.0.18";
 		pkg.devDependencies.typescript = pkg.devDependencies.typescript ?? "^5.9.3";
 		if (!pkg.name) pkg.name = projectName;
@@ -349,7 +369,9 @@ async function ensureScaffoldPackageJson(targetDir, projectName, workflowCoreRan
 	} catch {
 		await writeFile(pkgPath, `${createPackageJsonContent(projectName, {
 			configVersionRange: configRange,
+			packageManagerField,
 			runtimeVersionRange: runtimeRange,
+			testingVersionRange: testingRange,
 			workflowCoreVersionRange: workflowCoreRange
 		})}\n`, "utf-8");
 		return "created";
@@ -427,12 +449,13 @@ async function handleInit(options, ctx) {
 	await projects.track(targetDir, { name: projectName });
 	await installAgentSkillsForInit(targetDir, options);
 	if (options.scaffold) {
-		const [workflowCoreVersionRange, configVersionRange, runtimeVersionRange] = await Promise.all([
+		const [workflowCoreVersionRange, configVersionRange, runtimeVersionRange, testingVersionRange] = await Promise.all([
 			workflowCoreScaffoldVersionRange(),
 			configScaffoldVersionRange(),
-			runtimeScaffoldVersionRange()
+			runtimeScaffoldVersionRange(),
+			testingScaffoldVersionRange()
 		]);
-		await scaffoldProject(targetDir, projectName, workflowCoreVersionRange, configVersionRange, runtimeVersionRange);
+		await scaffoldProject(targetDir, projectName, workflowCoreVersionRange, configVersionRange, runtimeVersionRange, testingVersionRange, options.install !== false);
 	}
 }
 /** Write a file only if it does not already exist. Returns true if written. */
@@ -445,9 +468,11 @@ async function writeIfMissing(filePath, content) {
 		return true;
 	}
 }
-async function scaffoldProject(targetDir, projectName, workflowCoreVersionRange, configVersionRange, runtimeVersionRange) {
-	const pkgAction = await ensureScaffoldPackageJson(targetDir, projectName, workflowCoreVersionRange, configVersionRange, runtimeVersionRange);
-	ui.success(pkgAction === "created" ? `Created package.json (@keystrokehq/core ${workflowCoreVersionRange}, @keystrokehq/config ${configVersionRange}, @keystrokehq/runtime ${runtimeVersionRange})` : `Updated package.json (Keystroke deps -> core ${workflowCoreVersionRange}, config ${configVersionRange}, runtime ${runtimeVersionRange})`);
+async function scaffoldProject(targetDir, projectName, workflowCoreVersionRange, configVersionRange, runtimeVersionRange, testingVersionRange, shouldInstall) {
+	const packageManagerResolution = await resolvePackageManagerResolution({ cwd: targetDir });
+	const { packageManager } = packageManagerResolution;
+	const pkgAction = await ensureScaffoldPackageJson(targetDir, projectName, workflowCoreVersionRange, configVersionRange, runtimeVersionRange, testingVersionRange, packageManager === "pnpm" && packageManagerResolution.source === "preferred" ? SCAFFOLD_PNPM_PACKAGE_MANAGER : void 0);
+	ui.success(pkgAction === "created" ? `Created package.json (@keystrokehq/core ${workflowCoreVersionRange}, @keystrokehq/config ${configVersionRange}, @keystrokehq/runtime ${runtimeVersionRange}, @keystrokehq/testing ${testingVersionRange})` : `Updated package.json (Keystroke deps -> core ${workflowCoreVersionRange}, config ${configVersionRange}, runtime ${runtimeVersionRange}, testing ${testingVersionRange})`);
 	const files = [
 		{
 			rel: "vitest.config.ts",
@@ -498,7 +523,25 @@ async function scaffoldProject(targetDir, projectName, workflowCoreVersionRange,
 	}
 	if (created.length > 0) ui.success(`Scaffolded ${created.length} file(s): ${created.join(", ")}`);
 	else ui.hint("Scaffold files already exist — skipped (package.json was still updated).");
-	ui.hint("Run `pnpm install` to install dependencies, then `pnpm test` to run tests (or use your lockfile's package manager).");
+	if (shouldInstall) await installScaffoldDependencies(targetDir, packageManager);
+	else {
+		const installCommand = buildProjectInstallCommand(packageManager);
+		const renderedCommand = [installCommand.command, ...installCommand.args].join(" ");
+		ui.hint(`Skipped dependency install. Run \`${renderedCommand}\` when ready.`);
+	}
+}
+async function installScaffoldDependencies(targetDir, packageManager) {
+	const installCommand = buildProjectInstallCommand(packageManager);
+	const renderedCommand = [installCommand.command, ...installCommand.args].join(" ");
+	ui.header(`Installing dependencies with ${packageManager}...`);
+	ui.hint(renderedCommand);
+	const exitCode = await runProjectInstall({
+		cwd: targetDir,
+		packageManager
+	});
+	if (exitCode !== 0) throwReportedCliExit(`Dependency install failed with exit code ${exitCode}.`);
+	ui.success("Dependencies installed.");
+	ui.hint(`Run \`${packageManager} test\` to run the scaffolded workflow tests.`);
 }
 //#endregion
 export { handleInit };

package/dist/{integrations-MEExmqcg.mjs → integrations-m7_tb3GV.mjs}

@@ -158,14 +158,14 @@ function createIntegrationsCommand() {
 		description: "List Keystroke integrations available to your organization",
 		schema: IntegrationsListOptionsSchema,
 		optionsConfig: INTEGRATIONS_LIST_OPTIONS_CONFIG,
-		loadHandler: async () => (await import("./list.handler-Jk_vK66s.mjs")).handleIntegrationsList,
+		loadHandler: async () => (await import("./list.handler-CMRQKH4b.mjs")).handleIntegrationsList,
 		subcommands: [
 			createTypedCommand({
 				name: "list",
 				description: "List Keystroke integrations available to your organization",
 				schema: IntegrationsListOptionsSchema,
 				optionsConfig: INTEGRATIONS_LIST_OPTIONS_CONFIG,
-				loadHandler: async () => (await import("./list.handler-Jk_vK66s.mjs")).handleIntegrationsList
+				loadHandler: async () => (await import("./list.handler-CMRQKH4b.mjs")).handleIntegrationsList
 			}),
 			createTypedCommand({
 				name: "show",
@@ -177,7 +177,7 @@ function createIntegrationsCommand() {
 					description: "Integration id, e.g. aws-s3",
 					key: "id"
 				},
-				loadHandler: async () => (await import("./show.handler-C_VDYU91.mjs")).handleIntegrationShow
+				loadHandler: async () => (await import("./show.handler-nkK6Erbb.mjs")).handleIntegrationShow
 			}),
 			createTypedCommand({
 				name: "register",
@@ -185,7 +185,7 @@ function createIntegrationsCommand() {
 				schema: IntegrationsRegisterOptionsSchema,
 				optionsConfig: INTEGRATIONS_REGISTER_OPTIONS_CONFIG,
 				handler: async (opts, ctx) => {
-					const { handleIntegrationsRegister } = await import("./register.handler-CePNU3sP.mjs");
+					const { handleIntegrationsRegister } = await import("./register.handler-CKMZ2WmD.mjs");
 					await handleIntegrationsRegister({
 						integrationId: opts.integrationId,
 						clientAppCredentialSetId: opts.clientApp,

package/dist/keystroke.mjs

@@ -521,7 +521,7 @@ const logger = {
 };
 //#endregion
 //#region package.json
-var version = "0.0.30";
+var version = "0.0.32";
 //#endregion
 //#region src/command-registry.ts
 const ROOT_OPTIONS_WITH_VALUES$1 = new Set([
@@ -553,7 +553,7 @@ const lazyCommandDefinitions = [
 	},
 	{
 		name: "credentials",
-		loadCommand: async () => (await import("./credentials-LmhgE-Co.mjs")).createCredentialsCommand(),
+		loadCommand: async () => (await import("./credentials-CsncZ52a.mjs")).createCredentialsCommand(),
 		copyInheritedSettings: true
 	},
 	{
@@ -566,11 +566,11 @@ const lazyCommandDefinitions = [
 	},
 	{
 		name: "init",
-		loadCommand: async () => (await import("./init-DX08T87c.mjs")).createInitCommand()
+		loadCommand: async () => (await import("./init-BOCDwqKR.mjs")).createInitCommand()
 	},
 	{
 		name: "integrations",
-		loadCommand: async () => (await import("./integrations-MEExmqcg.mjs")).createIntegrationsCommand()
+		loadCommand: async () => (await import("./integrations-m7_tb3GV.mjs")).createIntegrationsCommand()
 	},
 	{
 		name: "invites",
@@ -586,7 +586,7 @@ const lazyCommandDefinitions = [
 	},
 	{
 		name: "operations",
-		loadCommand: async () => (await import("./operations-wXS1s3du.mjs")).createOperationsCommand()
+		loadCommand: async () => (await import("./operations-CF2nUiBs.mjs")).createOperationsCommand()
 	},
 	{
 		name: "projects",
@@ -598,11 +598,11 @@ const lazyCommandDefinitions = [
 	},
 	{
 		name: "search",
-		loadCommand: async () => (await import("./search-BEfy2fG9.mjs")).createSearchCommand()
+		loadCommand: async () => (await import("./search-CA0J5NOY.mjs")).createSearchCommand()
 	},
 	{
 		name: "skills",
-		loadCommand: async () => (await import("./skills.command-0-E8mcYE.mjs")).createSkillsCommand()
+		loadCommand: async () => (await import("./skills.command-COYd3k4Z.mjs")).createSkillsCommand()
 	},
 	{
 		name: "sync",

package/dist/{list.handler-BKfGLkFu.mjs → list.handler-DbYUk6ko.mjs}

@@ -3,8 +3,8 @@
 import { a as ui } from "./keystroke.mjs";
 import { i as writeJson } from "./output-BWcVRt-T.mjs";
 import { i as requireClient } from "./context-sgKhRc5v.mjs";
-import { t as detectPackageManager } from "./package-manager-DT1EhOkS.mjs";
-import { t as renderOperation } from "./render-operation-Bc7Wu1sP.mjs";
+import { n as detectPackageManager } from "./package-manager-CvY4IW7X.mjs";
+import { t as renderOperation } from "./render-operation-DWbMwhfc.mjs";
 //#region src/commands/operations/list.handler.ts
 async function handleOperationsList(options, ctx) {
 	const result = await requireClient(ctx).operations.list({

package/dist/{operations-wXS1s3du.mjs → operations-CF2nUiBs.mjs}

@@ -56,13 +56,13 @@ function createOperationsCommand() {
 		description: "Browse and inspect operations across all integrations",
 		schema: OperationsListOptionsSchema,
 		optionsConfig: OPERATIONS_LIST_OPTIONS_CONFIG,
-		loadHandler: async () => (await import("./list.handler-BKfGLkFu.mjs")).handleOperationsList,
+		loadHandler: async () => (await import("./list.handler-DbYUk6ko.mjs")).handleOperationsList,
 		subcommands: [createTypedCommand({
 			name: "list",
 			description: "List operations, optionally scoped to one integration",
 			schema: OperationsListOptionsSchema,
 			optionsConfig: OPERATIONS_LIST_OPTIONS_CONFIG,
-			loadHandler: async () => (await import("./list.handler-BKfGLkFu.mjs")).handleOperationsList
+			loadHandler: async () => (await import("./list.handler-DbYUk6ko.mjs")).handleOperationsList
 		}), createTypedCommand({
 			name: "show",
 			description: "Show full details for one operation, including input/output schemas",
@@ -70,10 +70,10 @@ function createOperationsCommand() {
 			optionsConfig: OPERATION_SHOW_OPTIONS_CONFIG,
 			argument: {
 				name: "id",
-				description: "Operation id, e.g. aws-s3.upload-object",
+				description: "Operation id, e.g. aws-s3.put-object",
 				key: "id"
 			},
-			loadHandler: async () => (await import("./show.handler-Wmv0tkxx.mjs")).handleOperationShow
+			loadHandler: async () => (await import("./show.handler-CwwnCmbp.mjs")).handleOperationShow
 		})]
 	});
 }

package/dist/package-manager-CvY4IW7X.mjs

@@ -0,0 +1,137 @@
+#!/usr/bin/env node
+
+import { y as toErrorMessage } from "./keystroke.mjs";
+import { dirname, join } from "node:path";
+import { existsSync, readFileSync } from "node:fs";
+import { spawn } from "node:child_process";
+//#region src/lib/package-manager.ts
+const PackageManagerValues = [
+	"npm",
+	"pnpm",
+	"yarn",
+	"bun"
+];
+function parsePackageManagerField(value) {
+	if (typeof value !== "string" || value.length === 0) return null;
+	const name = value.split("@")[0]?.trim();
+	if (name && PackageManagerValues.includes(name)) return name;
+	return null;
+}
+function detectFromLockfiles(directory) {
+	if (existsSync(join(directory, "bun.lockb")) || existsSync(join(directory, "bun.lock"))) return "bun";
+	if (existsSync(join(directory, "pnpm-lock.yaml"))) return "pnpm";
+	if (existsSync(join(directory, "yarn.lock"))) return "yarn";
+	if (existsSync(join(directory, "package-lock.json")) || existsSync(join(directory, "npm-shrinkwrap.json"))) return "npm";
+	return null;
+}
+function readPackageManagerField(directory) {
+	const packageJsonPath = join(directory, "package.json");
+	if (!existsSync(packageJsonPath)) return null;
+	try {
+		return parsePackageManagerField(JSON.parse(readFileSync(packageJsonPath, "utf8")).packageManager);
+	} catch {
+		return null;
+	}
+}
+function walkProjectDirectories(startDir) {
+	const directories = [];
+	let directory = startDir;
+	while (true) {
+		directories.push(directory);
+		const parent = dirname(directory);
+		if (parent === directory) break;
+		directory = parent;
+	}
+	return directories;
+}
+function hasPackageManagerSignal(cwd) {
+	for (const directory of walkProjectDirectories(cwd)) {
+		if (detectFromLockfiles(directory)) return true;
+		if (readPackageManagerField(directory)) return true;
+	}
+	return false;
+}
+/**
+* Infers the package manager for the current working directory by walking up
+* from `cwd` and preferring lockfiles (monorepo roots) over nested package.json
+* files without lockfiles.
+*/
+function detectPackageManager(options = {}) {
+	let packageManagerFromField = null;
+	for (const directory of walkProjectDirectories(options.cwd ?? process.cwd())) {
+		const fromLockfiles = detectFromLockfiles(directory);
+		if (fromLockfiles) return fromLockfiles;
+		const fromField = readPackageManagerField(directory);
+		if (fromField && !packageManagerFromField) packageManagerFromField = fromField;
+	}
+	return packageManagerFromField ?? "npm";
+}
+async function resolvePackageManagerResolution(options = {}) {
+	const cwd = options.cwd ?? process.cwd();
+	if (hasPackageManagerSignal(cwd)) return {
+		packageManager: detectPackageManager({ cwd }),
+		source: "project"
+	};
+	if (await (options.isPackageManagerAvailable ?? isPackageManagerOnPath)("pnpm")) return {
+		packageManager: "pnpm",
+		source: "preferred"
+	};
+	return {
+		packageManager: "npm",
+		source: "fallback"
+	};
+}
+function formatPackageInstallCommand(packageName, options = {}) {
+	const packageManager = options.packageManager ?? detectPackageManager({ cwd: options.cwd });
+	if (packageManager === "npm") return `npm install ${packageName}`;
+	if (packageManager === "pnpm") return `pnpm add ${packageName}`;
+	if (packageManager === "yarn") return `yarn add ${packageName}`;
+	return `bun add ${packageName}`;
+}
+function buildProjectInstallCommand(packageManager) {
+	if (packageManager === "pnpm") return {
+		command: "pnpm",
+		args: ["install"]
+	};
+	if (packageManager === "yarn") return {
+		command: "yarn",
+		args: ["install"]
+	};
+	if (packageManager === "bun") return {
+		command: "bun",
+		args: ["install"]
+	};
+	return {
+		command: "npm",
+		args: ["install"]
+	};
+}
+function isPackageManagerOnPath(packageManager) {
+	return new Promise((resolve) => {
+		const child = spawn(packageManager, ["--version"], {
+			stdio: "ignore",
+			shell: process.platform === "win32"
+		});
+		child.on("error", () => resolve(false));
+		child.on("close", (code) => resolve(code === 0));
+	});
+}
+async function runProjectInstall(options) {
+	const installCommand = buildProjectInstallCommand(options.packageManager);
+	return (options.runCommand ?? runPackageManagerCommand)(installCommand, { cwd: options.cwd });
+}
+function runPackageManagerCommand({ command, args }, options) {
+	return new Promise((resolve, reject) => {
+		const child = spawn(command, args, {
+			cwd: options.cwd,
+			stdio: "inherit",
+			shell: process.platform === "win32"
+		});
+		child.on("error", (error) => {
+			reject(new Error(`Failed to start ${command}: ${toErrorMessage(error)}`, { cause: error }));
+		});
+		child.on("close", (code) => resolve(code ?? 1));
+	});
+}
+//#endregion
+export { runProjectInstall as a, resolvePackageManagerResolution as i, detectPackageManager as n, formatPackageInstallCommand as r, buildProjectInstallCommand as t };

package/dist/{render-operation-Bc7Wu1sP.mjs → render-operation-DWbMwhfc.mjs}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 import { a as ui } from "./keystroke.mjs";
-import { n as formatPackageInstallCommand } from "./package-manager-DT1EhOkS.mjs";
+import { r as formatPackageInstallCommand } from "./package-manager-CvY4IW7X.mjs";
 //#region src/lib/render-operation.ts
 function isFull(op) {
 	return "inputSchemaJson" in op;

package/dist/{search-BEfy2fG9.mjs → search-CA0J5NOY.mjs}

@@ -46,7 +46,7 @@ function createSearchCommand() {
 			description: "Search query (matches name and related fields per --type)",
 			key: "query"
 		},
-		loadHandler: async () => (await import("./search.handler-V7ObLGjN.mjs")).handleSearch
+		loadHandler: async () => (await import("./search.handler-BVDsYZlJ.mjs")).handleSearch
 	});
 }
 //#endregion

package/dist/{search.handler-V7ObLGjN.mjs → search.handler-BVDsYZlJ.mjs}

@@ -4,8 +4,8 @@ import { a as ui } from "./keystroke.mjs";
 import { i as writeJson } from "./output-BWcVRt-T.mjs";
 import { i as requireClient } from "./context-sgKhRc5v.mjs";
 import { t as renderCredential } from "./render-credential-Bn15FEUC.mjs";
-import { n as formatPackageInstallCommand, t as detectPackageManager } from "./package-manager-DT1EhOkS.mjs";
-import { t as renderOperation } from "./render-operation-Bc7Wu1sP.mjs";
+import { n as detectPackageManager, r as formatPackageInstallCommand } from "./package-manager-CvY4IW7X.mjs";
+import { t as renderOperation } from "./render-operation-DWbMwhfc.mjs";
 //#region src/lib/render-integration.ts
 function renderIntegration(i, { full = false, packageManager } = {}) {
 	ui.br();

package/dist/{show.handler-Wmv0tkxx.mjs → show.handler-CwwnCmbp.mjs}

@@ -4,8 +4,8 @@ import { a as ui } from "./keystroke.mjs";
 import { i as writeJson } from "./output-BWcVRt-T.mjs";
 import { i as requireClient } from "./context-sgKhRc5v.mjs";
 import { i as renderJsonSchema } from "./schema-display-FvI8QjOQ.mjs";
-import { t as detectPackageManager } from "./package-manager-DT1EhOkS.mjs";
-import { t as renderOperation } from "./render-operation-Bc7Wu1sP.mjs";
+import { n as detectPackageManager } from "./package-manager-CvY4IW7X.mjs";
+import { t as renderOperation } from "./render-operation-DWbMwhfc.mjs";
 //#region src/commands/operations/show.handler.ts
 async function handleOperationShow(options, ctx) {
 	const { operation } = await requireClient(ctx).operations.get(options.id);

package/dist/{show.handler-C_VDYU91.mjs → show.handler-nkK6Erbb.mjs}

@@ -3,7 +3,7 @@
 import { a as ui } from "./keystroke.mjs";
 import { i as writeJson } from "./output-BWcVRt-T.mjs";
 import { i as requireClient } from "./context-sgKhRc5v.mjs";
-import { n as formatPackageInstallCommand, t as detectPackageManager } from "./package-manager-DT1EhOkS.mjs";
+import { n as detectPackageManager, r as formatPackageInstallCommand } from "./package-manager-CvY4IW7X.mjs";
 //#region src/commands/integrations/show.handler.ts
 async function handleIntegrationShow(options, ctx) {
 	const client = requireClient(ctx);

package/dist/{skills-sync.handler-BAATdT6N.mjs → skills-sync.handler-yRmi3OgP.mjs}

@@ -2,7 +2,7 @@
 
 import { D as CliExitError, a as ui } from "./keystroke.mjs";
 import { i as writeJson, r as isJsonMode } from "./output-BWcVRt-T.mjs";
-import { i as UnknownSkillAgentError, n as resolveSkillInstallChoices, r as installKeystrokeAgentSkills, t as summarizeSkillInstall } from "./skill-installer-D6j9IA3Z.mjs";
+import { i as UnknownSkillAgentError, n as resolveSkillInstallChoices, r as installKeystrokeAgentSkills, t as summarizeSkillInstall } from "./skill-installer-DG8kTaQR.mjs";
 import path from "node:path";
 //#region src/commands/skills/skills-sync.handler.ts
 async function handleSkillsSync(options, _ctx) {

package/dist/{skills.command-0-E8mcYE.mjs → skills.command-COYd3k4Z.mjs}

@@ -38,7 +38,7 @@ function createSkillsCommand() {
 			description: "Install bundled Keystroke skills into selected agent skill directories",
 			schema: SkillsCommandOptionsSchema,
 			optionsConfig: SKILLS_OPTIONS_CONFIG,
-			loadHandler: async () => (await import("./skills-sync.handler-BAATdT6N.mjs")).handleSkillsSync
+			loadHandler: async () => (await import("./skills-sync.handler-yRmi3OgP.mjs")).handleSkillsSync
 		})]
 	});
 	cmd.enablePositionalOptions();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@keystrokehq/cli",
-  "version": "0.0.30",
+  "version": "0.0.32",
   "private": false,
   "description": "Command-line interface for creating, managing, and deploying Keystroke automations.",
   "type": "module",
@@ -32,19 +32,19 @@
     "rolldown": "1.0.0",
     "tsx": "^4.21.0",
     "zod": "4.4.3",
-    "@keystrokehq/skills": "0.0.8"
+    "@keystrokehq/skills": "0.0.9"
   },
   "devDependencies": {
     "tsdown": "0.21.10",
     "typescript": "^5.9.3",
     "vitest": "^4.1.5",
+    "@keystroke/env-utils": "0.0.0",
     "@keystroke/local-memory": "0.0.2",
-    "@keystrokehq/config": "0.0.2",
     "@keystroke/shared-types": "0.0.11",
+    "@keystrokehq/config": "0.0.2",
     "@keystroke/typescript-config": "0.0.0",
-    "@keystroke/env-utils": "0.0.0",
-    "@keystroke/utils": "0.0.0",
     "@keystroke/test-utils": "0.0.6",
+    "@keystroke/utils": "0.0.0",
     "@keystroke/workflow-builder": "0.0.15",
     "@keystrokehq/core": "0.0.10",
     "@keystrokehq/runtime": "0.0.7",

package/dist/package-manager-DT1EhOkS.mjs

@@ -1,61 +0,0 @@
-#!/usr/bin/env node
-
-import { dirname, join } from "node:path";
-import { existsSync, readFileSync } from "node:fs";
-//#region src/lib/package-manager.ts
-const PackageManagerValues = [
-	"npm",
-	"pnpm",
-	"yarn",
-	"bun"
-];
-function parsePackageManagerField(value) {
-	if (typeof value !== "string" || value.length === 0) return null;
-	const name = value.split("@")[0]?.trim();
-	if (name && PackageManagerValues.includes(name)) return name;
-	return null;
-}
-function detectFromLockfiles(directory) {
-	if (existsSync(join(directory, "bun.lockb")) || existsSync(join(directory, "bun.lock"))) return "bun";
-	if (existsSync(join(directory, "pnpm-lock.yaml"))) return "pnpm";
-	if (existsSync(join(directory, "yarn.lock"))) return "yarn";
-	if (existsSync(join(directory, "package-lock.json")) || existsSync(join(directory, "npm-shrinkwrap.json"))) return "npm";
-	return null;
-}
-function readPackageManagerField(directory) {
-	const packageJsonPath = join(directory, "package.json");
-	if (!existsSync(packageJsonPath)) return null;
-	try {
-		return parsePackageManagerField(JSON.parse(readFileSync(packageJsonPath, "utf8")).packageManager);
-	} catch {
-		return null;
-	}
-}
-/**
-* Infers the package manager for the current working directory by walking up
-* from `cwd` and preferring lockfiles (monorepo roots) over nested package.json
-* files without lockfiles.
-*/
-function detectPackageManager(options = {}) {
-	let directory = options.cwd ?? process.cwd();
-	let packageManagerFromField = null;
-	while (true) {
-		const fromLockfiles = detectFromLockfiles(directory);
-		if (fromLockfiles) return fromLockfiles;
-		const fromField = readPackageManagerField(directory);
-		if (fromField && !packageManagerFromField) packageManagerFromField = fromField;
-		const parent = dirname(directory);
-		if (parent === directory) break;
-		directory = parent;
-	}
-	return packageManagerFromField ?? "npm";
-}
-function formatPackageInstallCommand(packageName, options = {}) {
-	const packageManager = options.packageManager ?? detectPackageManager({ cwd: options.cwd });
-	if (packageManager === "npm") return `npm install ${packageName}`;
-	if (packageManager === "pnpm") return `pnpm add ${packageName}`;
-	if (packageManager === "yarn") return `yarn add ${packageName}`;
-	return `bun add ${packageName}`;
-}
-//#endregion
-export { formatPackageInstallCommand as n, detectPackageManager as t };