@keystrokehq/cli 0.0.8 → 0.0.9

package/dist/try-deploy.handler-Lq69ON02.mjs

@@ -0,0 +1,169 @@
+#!/usr/bin/env node
+
+import { n as __exportAll } from "./chunk-CH6r78ws.mjs";
+import { O as CliExitError, a as isLocalMode, b as toErrorMessage, t as ui } from "./keystroke.mjs";
+import { d as trackProject } from "./dist-BF6r1hfv.mjs";
+import { t as assertWorkflowProjectRoot } from "./project-config-D9eFU8Jk.mjs";
+import { i as requireClient, t as assertProjectConfigMatchesAuthenticatedOrg } from "./context-DT06adrn.mjs";
+import { o as readWorkflowsFromDisk, s as uploadTestBundle } from "./dist-DvO0q6Fo.mjs";
+import { t as requireWorkflowsDir } from "./resolve-project-BREjwFKO.mjs";
+import { a as runWorkflowBuild, t as WorkflowNotFoundError } from "./workflow-build-Be6RMTb2.mjs";
+import { r as isUnknownSchema } from "./schema-display-DuWBmkwk.mjs";
+import { t as createBuildProgress } from "./build-progress-Mzsk4RKr.mjs";
+import { t as withErrorBoundary } from "./error-boundary-D6KTx1HL.mjs";
+import { a as tryReadExistingInputSchema, n as resolveInput, o as validateInputOrExit, t as pollForCompletion } from "./run-polling-BLT-uS2e.mjs";
+//#region src/lib/format.ts
+function formatBytes(bytes) {
+	if (bytes < 1024) return `${bytes} B`;
+	if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)} KB`;
+	return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+}
+//#endregion
+//#region src/commands/workflows/_shared/run-helpers.ts
+/**
+* Resolve input and validate against existing schema if available.
+* Returns input and workflowsDir for downstream use.
+*/
+async function resolveAndValidateInputForRun(options) {
+	const input = await resolveInput(options);
+	const workflowsDir = await requireWorkflowsDir(options.path);
+	trackProject(workflowsDir);
+	const existingSchema = await tryReadExistingInputSchema(workflowsDir, options.workflow);
+	if (existingSchema && !isUnknownSchema(existingSchema)) validateInputOrExit(options.workflow, input, existingSchema);
+	return {
+		input,
+		workflowsDir
+	};
+}
+/**
+* Build workflow(s) for run using the standard build pipeline, then read
+* prepared artifacts from disk filtered by workflow ref.
+*/
+async function buildWorkflowsForRun(options) {
+	const progress = createBuildProgress(options.workflow);
+	try {
+		const { result, outDir } = await runWorkflowBuild({
+			workflowsDir: options.workflowsDir,
+			workflowRef: options.workflow,
+			verbose: options.verbose,
+			onProgressEvent: progress.handleEvent
+		});
+		const filtered = (await readWorkflowsFromDisk(outDir)).filter((wf) => wf.manifestData.id === options.workflow || wf.name === options.workflow);
+		if (filtered.length === 0) {
+			const availableNames = result.artifacts.map((a) => a.manifest.name);
+			throw new WorkflowNotFoundError(options.workflow, availableNames);
+		}
+		return filtered;
+	} finally {
+		progress.stop();
+	}
+}
+/**
+* Validate input against the first build's input schema if available.
+*/
+function validateInputWithFirstBuild(options, input, builds) {
+	const inputSchema = builds[0]?.manifestData.workflowSchemas.input;
+	if (inputSchema && typeof inputSchema === "object" && !isUnknownSchema(inputSchema)) validateInputOrExit(options.workflow, input, inputSchema);
+}
+/**
+* Render success message after build.
+*/
+function renderBuildSuccessMessage(builds) {
+	const first = builds[0];
+	if (!first) return;
+	if (builds.length > 1) ui.success(`Built ${builds.length} workflow(s) with name "${first.name}"`);
+	else ui.success(`Built ${first.name} (${formatBytes(first.bundleSize)})`);
+}
+/**
+* Render completion success message (single or multi).
+*/
+function renderRunCompletionSuccessMessage(builds, elapsedSeconds) {
+	if (builds.length === 0) return;
+	if (builds.length > 1) ui.success(`All ${builds.length} workflow(s) completed in ${elapsedSeconds}s`);
+	else ui.success(`Workflow completed in ${elapsedSeconds}s`);
+}
+//#endregion
+//#region src/commands/workflows/try-deploy.handler/index.ts
+var try_deploy_handler_exports = /* @__PURE__ */ __exportAll({ handleWorkflowsTryDeploy: () => handleWorkflowsTryDeploy });
+async function handleWorkflowsTryDeploy(options, ctx) {
+	return withErrorBoundary("Try-deploy", async () => {
+		const client = requireClient(ctx);
+		const startTime = Date.now();
+		const local = isLocalMode();
+		const { input, workflowsDir } = await resolveAndValidateInputForRun(options);
+		const storagePaths = [];
+		let runError;
+		try {
+			const builds = await buildWorkflowsForRun({
+				...options,
+				workflowsDir
+			});
+			renderBuildSuccessMessage(builds);
+			validateInputWithFirstBuild(options, input, builds);
+			const projectConfig = await assertWorkflowProjectRoot(workflowsDir);
+			await assertProjectConfigMatchesAuthenticatedOrg(client, projectConfig);
+			for (const [i, build] of builds.entries()) {
+				if (builds.length > 1) ui.header(`Running "${build.name}" (${i + 1}/${builds.length})...`);
+				let storagePath;
+				if (local) {
+					storagePath = build.bundlePath;
+					if (i === 0) ui.hint("Local mode: using bundle from build output (skipping upload)");
+				} else {
+					ui.header("Uploading test bundle...");
+					storagePath = (await uploadTestBundle(client, build, false)).storagePath;
+					storagePaths.push(storagePath);
+					ui.success("Upload complete");
+				}
+				ui.header("Executing workflow...");
+				const { runId } = await client.workflows.testById({
+					workflowName: build.name,
+					storagePath,
+					exportName: build.exportName,
+					manifest: build.manifestData,
+					flowJson: build.flowData,
+					triggers: build.triggers,
+					bundleHash: build.bundleHash,
+					bundleSize: build.bundleSize,
+					args: [input],
+					organizationId: projectConfig.organizationId,
+					projectId: projectConfig.projectId
+				});
+				ui.hint(`Run ID: ${runId}`);
+				const snapshot = await pollForCompletion(client, runId, options.timeout, options.verbose);
+				const elapsed = ((Date.now() - startTime) / 1e3).toFixed(1);
+				if (snapshot.run.status === "completed") {
+					if (snapshot.run.output !== void 0 && snapshot.run.output !== null) {
+						ui.br();
+						ui.header("Output:");
+						ui.text(JSON.stringify(snapshot.run.output, null, 2));
+					}
+					continue;
+				}
+				if (snapshot.run.status === "failed") {
+					ui.br();
+					ui.error(`Workflow failed after ${elapsed}s`);
+					if (snapshot.run.error) ui.error(toErrorMessage(snapshot.run.error));
+					runError = snapshot.run.error ?? /* @__PURE__ */ new Error("Workflow failed");
+					break;
+				}
+				ui.br();
+				ui.warn(`Workflow still ${snapshot.run.status} after ${elapsed}s (timeout: ${options.timeout}s)`);
+				ui.hint(`Check status: keystroke runs get ${runId}`);
+				runError = /* @__PURE__ */ new Error(`Workflow still ${snapshot.run.status} after timeout`);
+				break;
+			}
+			if (!runError) {
+				ui.br();
+				renderRunCompletionSuccessMessage(builds, ((Date.now() - startTime) / 1e3).toFixed(1));
+			}
+		} finally {
+			if (!local) for (const sp of storagePaths) try {
+				await client.workflows.deleteTestBundle({ storagePath: sp });
+				if (options.verbose) ui.hint("Test bundle cleaned up");
+			} catch {}
+		}
+		if (runError) throw new CliExitError("Workflow execution failed");
+	}, { json: ctx.jsonMode });
+}
+//#endregion
+export { try_deploy_handler_exports as n, handleWorkflowsTryDeploy as t };

package/dist/{upgrade-Bp9gnslY.mjs → upgrade-DQrHCNR8.mjs}

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 
-import { t as createTypedCommand } from "./commander-Wr7RrODw.mjs";
+import { t as createTypedCommand } from "./commander-B6_tg5_w.mjs";
 import { z } from "zod";
 //#region src/commands/upgrade/upgrade.command.ts
 const PackageManagerSchema = z.enum([
@@ -34,7 +34,7 @@ function createUpgradeCommand() {
 		description: "Upgrade the Keystroke CLI to the latest published version",
 		schema: UpgradeOptionsSchema,
 		optionsConfig: UPGRADE_OPTIONS_CONFIG,
-		loadHandler: async () => (await import("./upgrade.handler-D82k9CHa.mjs")).handleUpgrade
+		loadHandler: async () => (await import("./upgrade.handler-B0NxKINA.mjs")).handleUpgrade
 	});
 }
 //#endregion

package/dist/{validate.handler-BiToUknO.mjs → validate.handler-BUga7Umz.mjs}

@@ -4,7 +4,7 @@ import { M as throwReportedCliExit, b as toErrorMessage, t as ui } from "./keyst
 import { d as trackProject } from "./dist-BF6r1hfv.mjs";
 import { i as writeJson } from "./output-BCDZb3Gy.mjs";
 import { t as requireWorkflowsDir } from "./resolve-project-BREjwFKO.mjs";
-import { s as build, t as WorkflowNotFoundError } from "./workflow-build-KCdasPyU.mjs";
+import { s as build, t as WorkflowNotFoundError } from "./workflow-build-Be6RMTb2.mjs";
 import { t as createBuildProgress } from "./build-progress-Mzsk4RKr.mjs";
 import { mkdtemp, rm } from "node:fs/promises";
 import * as os from "node:os";

package/dist/{workflow-build-KCdasPyU.mjs → workflow-build-Be6RMTb2.mjs}

@@ -978,7 +978,7 @@ async function buildDiscoveredWorkflows(options) {
 	const failures = [...buildPlan.failures];
 	const warnings = [];
 	if (buildPlan.workflows.length > 0) {
-		const { buildWorkflowArtifacts } = await import("./build-workflows-3fdvdHHf-DnDmsKuG.mjs");
+		const { buildWorkflowArtifacts } = await import("./build-workflows-3fdvdHHf-BDTy9QgT.mjs");
 		const result = await buildWorkflowArtifacts({
 			entries: buildPlan.workflows,
 			workflowsByKey,
@@ -993,7 +993,7 @@ async function buildDiscoveredWorkflows(options) {
 		warnings.push(...result.warnings);
 	}
 	if (buildPlan.agents.length > 0) {
-		const { buildAgentArtifacts } = await import("./build-agents-DfbiMZ_e-CLHxZKOg.mjs");
+		const { buildAgentArtifacts } = await import("./build-agents-DfbiMZ_e-CgnKa9A6.mjs");
 		const result = await buildAgentArtifacts({
 			entries: buildPlan.agents,
 			projectRoot: options.projectRoot
@@ -1002,7 +1002,7 @@ async function buildDiscoveredWorkflows(options) {
 		failures.push(...result.failures);
 	}
 	if (buildPlan.tasks.length > 0) {
-		const { buildTaskArtifacts } = await import("./build-tasks-O1jYtlv1-Cr7vs_B_.mjs");
+		const { buildTaskArtifacts } = await import("./build-tasks-O1jYtlv1-Bkw0w1r3.mjs");
 		const result = await buildTaskArtifacts({
 			entries: buildPlan.tasks,
 			projectRoot: options.projectRoot,
@@ -1110,7 +1110,7 @@ async function createBuildPlan(options) {
 		const currentWorkflowIndex = workflowProgressIndex;
 		workflowProgressIndex += 1;
 		if (!loadResult?.ok) {
-			const { createWorkflowMetadataFailure } = await import("./build-workflows-3fdvdHHf-DnDmsKuG.mjs");
+			const { createWorkflowMetadataFailure } = await import("./build-workflows-3fdvdHHf-BDTy9QgT.mjs");
 			plan.failures.push(createWorkflowMetadataFailure(discoveredWorkflow, loadResult?.error));
 			continue;
 		}
@@ -1333,7 +1333,7 @@ async function runBuild(config, initialTargetBindingKeys, metadataRebuildDecisio
 			elapsedMs: performance.now() - writeStartedAt,
 			...writeResult.skippedWriteCount !== void 0 && writeResult.skippedWriteCount > 0 ? { skippedWriteCount: writeResult.skippedWriteCount } : {}
 		});
-		const { buildMetadataArtifacts } = await import("./build-metadata-zidV9Cai-BNC_-zub.mjs");
+		const { buildMetadataArtifacts } = await import("./build-metadata-zidV9Cai-Bq37kBOM.mjs");
 		const metadata = await buildMetadataArtifacts({
 			projectRoot: config.projectRoot,
 			outputDir,

package/dist/{workflow-bundler-BzHk73PM-C1NWDEju.mjs → workflow-bundler-BzHk73PM-tt09RbIA.mjs}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 import { n as identifierName, o as parseSourceFile, r as isNode } from "./oxc-B3KI3rf_-ghZc3xZ5.mjs";
-import { r as formatEnvAccessError, t as createEnvAccessPlugin } from "./detect-env-access-CwkOYeYM-KtEle6I3.mjs";
+import { r as formatEnvAccessError, t as createEnvAccessPlugin } from "./detect-env-access-CwkOYeYM-D4o8gRZs.mjs";
 import { existsSync, readFileSync, realpathSync } from "node:fs";
 import * as path$1 from "node:path";
 import { createHash } from "node:crypto";

package/dist/{workflows-Bhd_vuCI.mjs → workflows-Cdo-AgjV.mjs}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 import { n as JsonOptionSchema, t as JSON_OPTION_CONFIG } from "./output-BCDZb3Gy.mjs";
-import { t as createTypedCommand } from "./commander-Wr7RrODw.mjs";
+import { t as createTypedCommand } from "./commander-B6_tg5_w.mjs";
 import { r as SHA256HashSchema, t as JsonSchemaSchema } from "./common-B3bLe3Mk.mjs";
 import { l as TriggerUploadDataSchema } from "./credential-requirements-BCW8aQWS.mjs";
 import { a as FlowGraphSchema, i as WorkflowManifestSchema } from "./workflow-manifest-BfL74mjp.mjs";
@@ -321,7 +321,7 @@ function createWorkflowsBuildCommand() {
 		description: "Build workflows locally",
 		schema: WorkflowsBuildOptionsSchema,
 		optionsConfig: BUILD_OPTIONS_CONFIG,
-		loadHandler: async () => (await import("./build.handler-CXqfqwho.mjs")).handleWorkflowsBuild
+		loadHandler: async () => (await import("./build.handler-D15NjKkT.mjs")).handleWorkflowsBuild
 	});
 }
 //#endregion
@@ -348,7 +348,7 @@ function createWorkflowsDiffCommand() {
 			description: "Authored workflow id (preferred) or workflow name",
 			key: "workflow"
 		},
-		loadHandler: async () => (await import("./diff.handler-zVbHzE1Q.mjs")).handleWorkflowsDiff
+		loadHandler: async () => (await import("./diff.handler-Dtjc7Y4O.mjs")).handleWorkflowsDiff
 	});
 }
 //#endregion
@@ -381,7 +381,7 @@ function createWorkflowsEnvCommand() {
 			key: "workflow",
 			required: false
 		},
-		loadHandler: async () => (await import("./env.handler-CqfOZEou.mjs")).handleWorkflowsEnv
+		loadHandler: async () => (await import("./env.handler-DbxnyBYf.mjs")).handleWorkflowsEnv
 	});
 }
 //#endregion
@@ -413,7 +413,7 @@ function createWorkflowsInspectCommand() {
 			description: "Authored workflow id (preferred) or workflow name",
 			key: "workflow"
 		},
-		loadHandler: async () => (await import("./inspect.handler-CcyFNUJP.mjs")).handleWorkflowsInspect
+		loadHandler: async () => (await import("./inspect.handler-Buv68Vm9.mjs")).handleWorkflowsInspect
 	});
 }
 //#endregion
@@ -509,7 +509,7 @@ function createWorkflowsLogsCommand() {
 			key: "workflow",
 			required: false
 		},
-		loadHandler: async () => (await import("./logs.handler-BNFUmakA.mjs")).handleWorkflowsLogs
+		loadHandler: async () => (await import("./logs.handler-COtiXeqn.mjs")).handleWorkflowsLogs
 	});
 }
 //#endregion
@@ -700,7 +700,101 @@ function createWorkflowsPausedCommand() {
 			key: "workflow",
 			required: false
 		},
-		loadHandler: async () => (await import("./paused.handler-wgaf8sse.mjs")).handleWorkflowsPaused
+		loadHandler: async () => (await import("./paused.handler-BX_71fzx.mjs")).handleWorkflowsPaused
+	});
+}
+//#endregion
+//#region src/commands/workflows/run.command.ts
+const WorkflowsRunCommandOptionsSchema = JsonOptionSchema.extend({
+	workflow: z.string().min(1),
+	payload: z.string().optional(),
+	projectId: z.uuid().optional(),
+	input: z.string().optional(),
+	inputFile: z.string().optional(),
+	workflowGlobals: z.string().optional(),
+	workflowGlobalsFile: z.string().optional(),
+	path: z.string().optional(),
+	wait: z.boolean().default(false),
+	follow: z.boolean().default(false),
+	timeout: z.coerce.number().int().min(1).default(120),
+	verbose: z.boolean().default(false)
+}).superRefine((value, ctx) => {
+	const inputSources = [
+		value.payload ? "positional payload" : null,
+		value.input ? "--input" : null,
+		value.inputFile ? "--input-file" : null
+	].filter((source) => source !== null);
+	if (inputSources.length > 1) ctx.addIssue({
+		code: z.ZodIssueCode.custom,
+		path: ["input"],
+		message: `Use only one workflow input source: ${inputSources.join(", ")}.`
+	});
+	if (value.workflowGlobals && value.workflowGlobalsFile) ctx.addIssue({
+		code: z.ZodIssueCode.custom,
+		path: ["workflowGlobals"],
+		message: "Use either --workflow-globals or --workflow-globals-file, not both."
+	});
+});
+const WORKFLOWS_RUN_OPTIONS_CONFIG = {
+	...JSON_OPTION_CONFIG,
+	projectId: {
+		flag: "--project-id <uuid>",
+		description: "Project override. If omitted, read keystroke.config.ts from --path/CWD"
+	},
+	input: {
+		flag: "--input <json>",
+		description: "Workflow input as inline JSON object"
+	},
+	inputFile: {
+		flag: "--input-file <path>",
+		description: "Path to a JSON file containing workflow input"
+	},
+	workflowGlobals: {
+		flag: "--workflow-globals <json>",
+		description: "Workflow globals as inline JSON object"
+	},
+	workflowGlobalsFile: {
+		flag: "--workflow-globals-file <path>",
+		description: "Path to a JSON file containing workflow globals"
+	},
+	path: {
+		flag: "--path <dir>",
+		description: "Path to project root (directory containing keystroke.config.ts); auto-discovered from CWD if omitted"
+	},
+	wait: {
+		flag: "--wait",
+		description: "Poll until the run reaches a terminal status"
+	},
+	follow: {
+		flag: "--follow",
+		description: "Poll logs/events while waiting; implies --wait"
+	},
+	timeout: {
+		flag: "--timeout <seconds>",
+		description: "Max seconds to wait for workflow completion (default: 120)"
+	},
+	verbose: {
+		flag: "--verbose",
+		description: "Show detailed runtime events and logs while waiting"
+	}
+};
+function createWorkflowsRunCommand() {
+	return createTypedCommand({
+		name: "run",
+		description: "Run a workflow from the current deployment",
+		schema: WorkflowsRunCommandOptionsSchema,
+		optionsConfig: WORKFLOWS_RUN_OPTIONS_CONFIG,
+		arguments: [{
+			name: "workflow",
+			description: "Authored workflow id",
+			key: "workflow"
+		}, {
+			name: "payload",
+			description: "Workflow input as inline JSON object",
+			key: "payload",
+			required: false
+		}],
+		loadHandler: async () => (await import("./run.handler-B5NodlNi.mjs")).handleWorkflowsRun
 	});
 }
 //#endregion
@@ -716,7 +810,7 @@ function createWorkflowsTryDeployCommand() {
 			description: "Authored workflow id (preferred) or workflow name. Multiple workflows with the same name run sequentially.",
 			key: "workflow"
 		},
-		loadHandler: async () => (await import("./try-deploy.handler-BCvwi1jc.mjs").then((n) => n.n)).handleWorkflowsTryDeploy
+		loadHandler: async () => (await import("./try-deploy.handler-Lq69ON02.mjs").then((n) => n.n)).handleWorkflowsTryDeploy
 	});
 }
 //#endregion
@@ -754,7 +848,7 @@ function createWorkflowsValidateCommand() {
 			key: "workflow",
 			required: false
 		},
-		loadHandler: async () => (await import("./validate.handler-BiToUknO.mjs")).handleWorkflowsValidate
+		loadHandler: async () => (await import("./validate.handler-BUga7Umz.mjs")).handleWorkflowsValidate
 	});
 }
 //#endregion
@@ -773,16 +867,17 @@ function createWorkflowsCommand() {
 		description: "Manage, run, inspect, and debug workflows",
 		schema: WorkflowsOptionsSchema,
 		optionsConfig: WORKFLOWS_OPTIONS_CONFIG,
-		loadHandler: async () => (await import("./list.handler-Val6EmGK.mjs")).handleWorkflowsList,
+		loadHandler: async () => (await import("./list.handler-Bi28Gsee.mjs")).handleWorkflowsList,
 		subcommands: [
 			createTypedCommand({
 				name: "list",
 				description: "List all workflows in the project",
 				schema: WorkflowsOptionsSchema,
 				optionsConfig: WORKFLOWS_OPTIONS_CONFIG,
-				loadHandler: async () => (await import("./list.handler-Val6EmGK.mjs")).handleWorkflowsList
+				loadHandler: async () => (await import("./list.handler-Bi28Gsee.mjs")).handleWorkflowsList
 			}),
 			createWorkflowsBuildCommand(),
+			createWorkflowsRunCommand(),
 			createWorkflowsTryDeployCommand(),
 			createWorkflowsInspectCommand(),
 			createWorkflowsValidateCommand(),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@keystrokehq/cli",
-  "version": "0.0.8",
+  "version": "0.0.9",
   "private": false,
   "description": "Command-line interface for creating, managing, and deploying Keystroke automations.",
   "type": "module",
@@ -33,7 +33,7 @@
     "rolldown": "1.0.0-rc.17",
     "tsx": "^4.21.0",
     "zod": "^4.3.6",
-    "@keystrokehq/skills": "0.0.1"
+    "@keystrokehq/skills": "0.0.2"
   },
   "devDependencies": {
     "tsdown": "0.21.10",
@@ -43,13 +43,13 @@
     "@keystroke/local-memory": "0.0.0",
     "@keystroke/project-config": "0.0.1",
     "@keystroke/shared-types": "0.0.1",
-    "@keystroke/test-utils": "0.0.0",
     "@keystroke/typescript-config": "0.0.0",
     "@keystroke/utils": "0.0.0",
     "@keystroke/workflow-builder": "0.0.2",
     "@keystrokehq/core": "0.0.4",
     "@keystroke/workflow-deploy": "0.0.1",
-    "@keystroke/workflow-sdk": "0.0.0"
+    "@keystroke/workflow-sdk": "0.0.0",
+    "@keystroke/test-utils": "0.0.0"
   },
   "keywords": [
     "automation",