@keystrokehq/cli 0.0.32 → 0.0.37

package/dist/{resolve-project-E9mrh_el.mjs → resolve-project-DLKlAy0z.mjs}

@@ -1,9 +1,10 @@
 #!/usr/bin/env node
 
-import { a as ui, k as ProjectNotFoundError } from "./keystroke.mjs";
-import { i as projects } from "./dist-Dw7gCE7y.mjs";
-import { n as findProjectRoot } from "./project-config-DudGRFPO.mjs";
+import { j as ProjectNotFoundError, p as ui } from "./keystroke.mjs";
+import { i as projects } from "./dist-B5jy238v.mjs";
+import { n as findProjectRoot, r as getProjectConfigPath } from "./project-config-DudGRFPO.mjs";
 import path from "node:path";
+import { access } from "node:fs/promises";
 //#region src/lib/resolve-project.ts
 /**
 * Resolve the project root from an explicit `--path` flag or by
@@ -19,17 +20,32 @@ async function resolveWorkflowsDir(explicitPath) {
 * Like `resolveWorkflowsDir` but throws a `ProjectNotFoundError`
 * when no project is found.
 */
-async function requireWorkflowsDir(explicitPath) {
-	const dir = await resolveWorkflowsDir(explicitPath);
-	if (dir) return dir;
-	ui.warn("No keystroke.config.ts found in this directory or any parent directory.");
+async function renderProjectNotFoundHints(fromCwd) {
+	if (fromCwd) ui.warn("No keystroke.config.ts found in this directory or any parent directory.");
+	else ui.warn("No keystroke.config.ts found at the provided project path.");
 	const lastProject = await projects.getLast();
 	if (lastProject) {
 		ui.hint(`Last used project: ${lastProject}`);
 		ui.hint(`  cd ${lastProject}`);
 	}
 	ui.hint("Run `keystroke init` to initialize a project, or use --path.");
-	throw new ProjectNotFoundError("No keystroke.config.ts found");
+}
+async function assertProjectConfigExists(projectRoot) {
+	try {
+		await access(getProjectConfigPath(projectRoot));
+	} catch {
+		await renderProjectNotFoundHints(false);
+		throw new ProjectNotFoundError("No keystroke.config.ts found");
+	}
+}
+async function requireWorkflowsDir(explicitPath) {
+	const dir = await resolveWorkflowsDir(explicitPath);
+	if (!dir) {
+		await renderProjectNotFoundHints(true);
+		throw new ProjectNotFoundError("No keystroke.config.ts found");
+	}
+	if (explicitPath) await assertProjectConfigExists(dir);
+	return dir;
 }
 //#endregion
 export { resolveWorkflowsDir as n, requireWorkflowsDir as t };

package/dist/{run-polling-DawiBus-.mjs → run-polling-C5fI7xTp.mjs}

@@ -1,9 +1,9 @@
 #!/usr/bin/env node
 
-import { O as InputValidationError, a as ui, y as toErrorMessage } from "./keystroke.mjs";
-import { a as readManifestsFromOutDir } from "./dist-CTEtWDW4.mjs";
-import { n as formatValidationError, o as validateRequiredFields, t as formatMissingInputError } from "./schema-display-FvI8QjOQ.mjs";
-import { n as sleep, t as TERMINAL_STATUSES } from "./run-polling-fBouPjJ2.mjs";
+import { A as InputValidationError, p as ui, x as toErrorMessage } from "./keystroke.mjs";
+import { a as readManifestsFromOutDir } from "./dist-BmbFJq8U.mjs";
+import { c as validateRequiredFields, n as formatMissingInputError, r as formatValidationError } from "./schema-display-sZ6ConJd.mjs";
+import { n as sleep, t as TERMINAL_STATUSES } from "./run-polling-1c0ckC1A.mjs";
 import * as path$1 from "node:path";
 import * as fs from "node:fs/promises";
 import { z } from "zod";
@@ -224,6 +224,17 @@ async function tryReadExistingInputSchema(workflowsDir, workflowName) {
 }
 //#endregion
 //#region src/commands/workflows/_shared/run-polling-render.ts
+/**
+* Live progress rendering for workflow runs (`workflows run --wait`, `--follow`, test polling).
+*
+* `pollForCompletion` fetches a full snapshot each tick (run status + all events + logs). This
+* module turns each snapshot into CLI hints; it does not affect execution or JSON output.
+*/
+const CORRELATION_ID_COLLATOR = new Intl.Collator("en", {
+	numeric: true,
+	sensitivity: "base"
+});
+const LOG_DISPLAY_ORDER = 35;
 function createRuntimeRenderState() {
 	return {
 		seenEventIds: /* @__PURE__ */ new Set(),
@@ -232,21 +243,92 @@ function createRuntimeRenderState() {
 		lastStatus: void 0
 	};
 }
+/**
+* Print any new logs, events, and run-status lines from one poll snapshot.
+*
+* Render order within a snapshot is intentional:
+* 1. Logs and events are facts observed during the run.
+* 2. Run status is a summary and must come last.
+*
+* On the final poll, `run.status` is often already `completed` while `events` still
+* contains step history we have not printed yet. Printing status first made it look like
+* the workflow finished before steps ran.
+*/
 function renderRunSnapshot(snapshot, state, verbose) {
+	const renderItems = buildNewRenderItems(snapshot, state);
+	for (const item of sortRenderItemsChronologically(renderItems)) if (item.kind === "log") {
+		state.seenLogIds.add(item.log.id);
+		renderRunLog(item.log, verbose);
+	} else {
+		state.seenEventIds.add(item.event.id);
+		renderRuntimeEvent(item.event, state.stepStates, verbose);
+	}
 	if (snapshot.run.status !== state.lastStatus) {
 		ui.hint(`Run status: ${snapshot.run.status}`);
 		state.lastStatus = snapshot.run.status;
 	}
-	for (const log of snapshot.logs) {
-		if (state.seenLogIds.has(log.id)) continue;
-		state.seenLogIds.add(log.id);
-		renderRunLog(log, verbose);
-	}
-	for (const event of snapshot.events) {
-		if (state.seenEventIds.has(event.id)) continue;
-		state.seenEventIds.add(event.id);
-		renderRuntimeEvent(event, state.stepStates, verbose);
-	}
+}
+function buildNewRenderItems(snapshot, state) {
+	const logs = snapshot.logs.filter((log) => !state.seenLogIds.has(log.id)).map((log) => ({
+		kind: "log",
+		log,
+		timestamp: log.timestamp,
+		correlationId: log.correlationId ?? "",
+		displayOrder: LOG_DISPLAY_ORDER,
+		id: log.id
+	}));
+	const events = snapshot.events.filter((event) => !state.seenEventIds.has(event.id)).map((event) => ({
+		kind: "event",
+		event,
+		timestamp: event.createdAt,
+		correlationId: event.correlationId,
+		displayOrder: eventTypeDisplayOrder(event.eventType),
+		id: event.id
+	}));
+	return [...logs, ...events];
+}
+function sortRenderItemsChronologically(items) {
+	return [...items].sort(compareRenderItemsChronologically);
+}
+/**
+* Display order for events that share a `createdAt` (common when the executor
+* persists a batch with one timestamp). Sorting by `id` alone is unsafe because
+* microsandbox event ids embed the type (`…:step_completed:1` < `…:step_started:1`).
+*/
+const EVENT_TYPE_DISPLAY_ORDER = {
+	trigger_transform: 5,
+	step_created: 10,
+	step_started: 20,
+	step_retrying: 30,
+	step_completed: 40,
+	step_failed: 50,
+	hook_created: 10,
+	hook_resumed: 40,
+	hook_cancelled: 50,
+	wait_created: 10,
+	wait_completed: 40,
+	stream_chunk: 35,
+	child_workflow_created: 10,
+	child_workflow_completed: 40,
+	child_workflow_failed: 50,
+	agent_created: 10,
+	agent_started: 20,
+	agent_completed: 40,
+	agent_failed: 50,
+	agent_cancelled: 50
+};
+function eventTypeDisplayOrder(eventType) {
+	return EVENT_TYPE_DISPLAY_ORDER[eventType];
+}
+/** Ascending timestamp, then correlation, lifecycle/log position, then id. */
+function compareRenderItemsChronologically(a, b) {
+	const timeDiff = Date.parse(a.timestamp) - Date.parse(b.timestamp);
+	if (timeDiff !== 0) return timeDiff;
+	const correlationDiff = CORRELATION_ID_COLLATOR.compare(a.correlationId, b.correlationId);
+	if (correlationDiff !== 0) return correlationDiff;
+	const displayOrderDiff = a.displayOrder - b.displayOrder;
+	if (displayOrderDiff !== 0) return displayOrderDiff;
+	return a.id.localeCompare(b.id);
 }
 function renderRunLog(log, verbose) {
 	const message = `${`log[${log.source}:${log.level}]`} ${log.message}`;
@@ -339,6 +421,7 @@ function toObject(value) {
 //#endregion
 //#region src/commands/workflows/_shared/run-polling.ts
 const POLL_INTERVAL_MS = 1e3;
+/** Poll until the run reaches a terminal status. When `render` is true, see `renderRunSnapshot`. */
 async function pollForCompletion(client, runId, timeoutSeconds, verbose, render = true) {
 	const deadline = Date.now() + timeoutSeconds * 1e3;
 	const renderState = createRuntimeRenderState();

package/dist/{run.handler-BG7xitEK.mjs → run.handler-BKD5Xu0A.mjs}

@@ -1,30 +1,32 @@
 #!/usr/bin/env node
 
-import { D as CliExitError, a as ui, j as throwReportedCliExit, y as toErrorMessage } from "./keystroke.mjs";
-import { i as projects } from "./dist-Dw7gCE7y.mjs";
+import { N as throwReportedCliExit, k as CliExitError, p as ui, x as toErrorMessage } from "./keystroke.mjs";
+import { i as projects } from "./dist-B5jy238v.mjs";
 import { t as assertWorkflowProjectRoot } from "./project-config-DudGRFPO.mjs";
-import { i as writeJson } from "./output-BWcVRt-T.mjs";
-import { i as requireClient, t as assertProjectConfigMatchesAuthenticatedOrg } from "./context-sgKhRc5v.mjs";
-import { n as resolveWorkflowsDir } from "./resolve-project-E9mrh_el.mjs";
-import { t as lookupCurrentDeploymentWorkflow } from "./current-deployment-workflow-B1VQCYC-.mjs";
-import { i as resolveWorkflowGlobals, o as validateInputOrExit, r as resolveRunInput, s as validateWorkflowGlobalsOrExit, t as pollForCompletion } from "./run-polling-DawiBus-.mjs";
+import { i as writeJson } from "./output-DnIFEmi5.mjs";
+import { i as requireClient, t as assertProjectConfigMatchesAuthenticatedOrg } from "./context-ebZssGCY.mjs";
+import { n as resolveWorkflowsDir } from "./resolve-project-DLKlAy0z.mjs";
+import { t as lookupCurrentDeploymentWorkflow } from "./current-deployment-workflow-C6x65imE.mjs";
+import { i as resolveWorkflowGlobals, o as validateInputOrExit, r as resolveRunInput, s as validateWorkflowGlobalsOrExit, t as pollForCompletion } from "./run-polling-C5fI7xTp.mjs";
+import { n as assertAuthoredWorkflowId, t as WORKFLOW_ID_COMMANDS } from "./authored-workflow-ref-fkHEEVnd.mjs";
 //#region src/commands/workflows/run.handler.ts
 async function handleWorkflowsRun(options, ctx) {
 	const client = requireClient(ctx);
-	const projectId = await resolveProjectId(options, ctx);
+	const { projectId, authoredWorkflowId, workflowsDir } = await resolveRunWorkflowTarget(options, ctx);
 	const input = await resolveRunInput(options);
 	const globals = await resolveWorkflowGlobals(options);
-	const deploymentLookup = await loadCurrentDeploymentWorkflow(client, {
+	const workflow = (await requireDeploymentWorkflowFound(await loadCurrentDeploymentWorkflow(client, {
 		projectId,
-		authoredWorkflowId: options.workflow
-	});
-	assertDeploymentWorkflowFound(deploymentLookup, options.workflow);
-	const workflow = deploymentLookup.workflow;
+		authoredWorkflowId
+	}), {
+		authoredWorkflowId,
+		workflowsDir
+	})).workflow;
 	const inputSchema = workflow.manifest.workflowSchemas.input;
-	const validatedInput = isJsonObjectSchema(inputSchema) && inputSchema.type !== "unknown" ? validateInputOrExit(workflow.workflowName, input, inputSchema) : input;
+	const validatedInput = isJsonObjectSchema(inputSchema) && inputSchema.type !== "unknown" ? validateInputOrExit(authoredWorkflowId, input, inputSchema) : input;
 	const globalsSchema = workflow.manifest.workflowGlobals;
 	const validatedGlobals = resolveValidatedWorkflowGlobals({
-		workflowName: workflow.workflowName,
+		authoredWorkflowId,
 		schema: globalsSchema,
 		globals
 	});
@@ -62,18 +64,27 @@ async function handleWorkflowsRun(options, ctx) {
 	}
 	renderWaitResult(runId, snapshot, options.timeout);
 }
-async function resolveProjectId(options, ctx) {
-	if (options.projectId) return options.projectId;
+async function resolveRunWorkflowTarget(options, ctx) {
+	const authoredWorkflowId = options.workflow;
 	const workflowsDir = await resolveWorkflowsDir(options.path);
-	if (!workflowsDir) {
-		ui.error("No keystroke.config.ts found in this directory or any parent directory.");
-		ui.hint("Run inside a Keystroke project or pass --project-id <uuid>.");
-		throwReportedCliExit("No keystroke.config.ts found");
+	if (workflowsDir) {
+		await assertAuthoredWorkflowId(authoredWorkflowId, workflowsDir, WORKFLOW_ID_COMMANDS.run);
+		const projectConfig = await assertWorkflowProjectRoot(workflowsDir);
+		await assertProjectConfigMatchesAuthenticatedOrg(requireClient(ctx), projectConfig);
+		projects.track(workflowsDir);
+		return {
+			projectId: options.projectId ?? projectConfig.projectId,
+			authoredWorkflowId,
+			workflowsDir
+		};
 	}
-	const projectConfig = await assertWorkflowProjectRoot(workflowsDir);
-	await assertProjectConfigMatchesAuthenticatedOrg(requireClient(ctx), projectConfig);
-	projects.track(workflowsDir);
-	return projectConfig.projectId;
+	if (options.projectId) return {
+		projectId: options.projectId,
+		authoredWorkflowId
+	};
+	ui.error("No keystroke.config.ts found in this directory or any parent directory.");
+	ui.hint("Run inside a Keystroke project or pass --project-id <uuid>.");
+	throwReportedCliExit("No keystroke.config.ts found");
 }
 async function loadCurrentDeploymentWorkflow(client, params) {
 	try {
@@ -83,17 +94,18 @@ async function loadCurrentDeploymentWorkflow(client, params) {
 		throwReportedCliExit(`Failed to load current deployment workflow: ${toErrorMessage(error)}`, { cause: error });
 	}
 }
-function assertDeploymentWorkflowFound(deploymentLookup, workflowRef) {
-	if (deploymentLookup.status === "found") return;
+async function requireDeploymentWorkflowFound(deploymentLookup, options) {
+	if (deploymentLookup.status === "found") return deploymentLookup;
 	if (deploymentLookup.status === "missingCurrentDeployment") {
 		ui.error("This project has no current deployment.");
 		ui.hint("Run `keystroke deploy` to create the current deployment, then try again.");
 		throwReportedCliExit("This project has no current deployment.");
 	}
 	if (deploymentLookup.status === "missingWorkflow") {
-		ui.error(`Workflow "${workflowRef}" is not part of the current deployment.`);
+		if (options.workflowsDir) await assertAuthoredWorkflowId(options.authoredWorkflowId, options.workflowsDir, WORKFLOW_ID_COMMANDS.run, { refreshManifests: true });
+		ui.error(`Workflow "${options.authoredWorkflowId}" is not part of the current deployment.`);
 		ui.hint("Run `keystroke deploy` to include it in the current deployment, then try again.");
-		throwReportedCliExit(`Workflow "${workflowRef}" is not part of the current deployment.`);
+		throwReportedCliExit(`Workflow "${options.authoredWorkflowId}" is not part of the current deployment.`);
 	}
 	throw new Error(`Unhandled deployment lookup status: ${JSON.stringify(deploymentLookup)}`);
 }
@@ -103,7 +115,7 @@ function resolveValidatedWorkflowGlobals(params) {
 		value: params.globals.value
 	} : { shouldSend: false };
 	const candidate = params.globals.value ?? {};
-	const validated = validateWorkflowGlobalsOrExit(params.workflowName, candidate, params.schema);
+	const validated = validateWorkflowGlobalsOrExit(params.authoredWorkflowId, candidate, params.schema);
 	if (params.globals.provided || Object.keys(validated).length > 0) return {
 		shouldSend: true,
 		value: validated

package/dist/{runs-swYYBT6C.mjs → runs-CT31dczt.mjs}

@@ -1,9 +1,9 @@
 #!/usr/bin/env node
 
-import { a as ui, j as throwReportedCliExit, n as style, t as ANSI, y as toErrorMessage } from "./keystroke.mjs";
-import { i as writeJson, n as JsonOptionSchema, t as JSON_OPTION_CONFIG } from "./output-BWcVRt-T.mjs";
-import { t as createTypedCommand } from "./commander-BlrSdFcu.mjs";
-import { i as requireClient } from "./context-sgKhRc5v.mjs";
+import { N as throwReportedCliExit, n as style, p as ui, t as ANSI, x as toErrorMessage } from "./keystroke.mjs";
+import { i as writeJson, n as JsonOptionSchema, t as JSON_OPTION_CONFIG } from "./output-DnIFEmi5.mjs";
+import { t as createTypedCommand } from "./commander-C6SSTQJ2.mjs";
+import { i as requireClient } from "./context-ebZssGCY.mjs";
 import { z } from "zod";
 //#region src/commands/runs/inspect-display.ts
 function renderRunInspect(input) {

package/dist/{schema-display-FvI8QjOQ.mjs → schema-display-sZ6ConJd.mjs}

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 
-import { a as ui } from "./keystroke.mjs";
+import { p as ui } from "./keystroke.mjs";
 //#region src/lib/schema-display.ts
 /**
 * Returns true when the schema is the fallback "unknown" sentinel emitted
@@ -11,8 +11,9 @@ function isUnknownSchema(schema) {
 }
 /**
 * Generates a minimal placeholder JSON object for a given JSON Schema.
-* Walks `properties` recursively to produce sensible default values so the
-* user has a copy-pasteable `--input` example.
+* Walks `properties` recursively to produce structural `--input` examples
+* (required keys and rough types). Examples are not guaranteed to pass
+* validation (e.g. minLength, format, unions, or const constraints).
 *
 * Examples:
 *   { type: "number" }           => 0
@@ -26,6 +27,26 @@ function generateExampleJson(schema) {
 	if (schema == null || typeof schema !== "object") return null;
 	return generateValue(schema);
 }
+/**
+* JSON string for a workflow `--input` value derived from the input schema.
+* See {@link generateExampleJson} for placeholder semantics.
+*/
+function formatExampleInputJson(inputSchema) {
+	if (inputSchema == null || typeof inputSchema !== "object" || isUnknownSchema(inputSchema)) return "{}";
+	const example = generateExampleJson(inputSchema);
+	return JSON.stringify(example ?? {});
+}
+/** Wraps a string in single quotes with POSIX-safe `'` escaping for shell snippets. */
+function shellEscapeSingleQuoted(value) {
+	return `'${value.replace(/'/g, "'\"'\"'")}'`;
+}
+/** Shell-safe `--input '...'` flag generated from a workflow input JSON Schema. */
+function formatWorkflowInputFlag(inputSchema) {
+	return `--input ${shellEscapeSingleQuoted(formatExampleInputJson(inputSchema))}`;
+}
+function formatWorkflowTestExampleCommand(authoredWorkflowId, inputSchema) {
+	return `$ keystroke workflows test ${authoredWorkflowId} ${formatWorkflowInputFlag(inputSchema)}`;
+}
 function generateValue(schema) {
 	if (Array.isArray(schema.enum) && schema.enum.length > 0) return schema.enum[0];
 	switch (Array.isArray(schema.type) ? schema.type[0] : schema.type) {
@@ -105,12 +126,12 @@ function resolveTypeHint(fieldSchema) {
 /**
 * Formats a missing-required-fields error into a descriptive CLI message.
 */
-function formatMissingInputError(workflowName, missingFields, inputSchema) {
+function formatMissingInputError(authoredWorkflowId, missingFields, inputSchema) {
 	const lines = [];
-	lines.push(`Missing required input for workflow "${workflowName}"\n`);
+	lines.push(`Missing required input for workflow "${authoredWorkflowId}"\n`);
 	if (inputSchema == null || typeof inputSchema !== "object") {
 		lines.push("  (input schema unavailable)\n");
-		lines.push(`  $ keystroke workflows test "${workflowName}" --input '{}'`);
+		lines.push(`  ${formatWorkflowTestExampleCommand(authoredWorkflowId)}`);
 		return lines.join("\n");
 	}
 	const properties = inputSchema.properties && typeof inputSchema.properties === "object" ? inputSchema.properties : {};
@@ -120,38 +141,24 @@ function formatMissingInputError(workflowName, missingFields, inputSchema) {
 		lines.push(`  ${field} (${typeHint}): Required`);
 	}
 	lines.push("");
-	const exampleValue = generateExampleJson(inputSchema);
-	const exampleJson = JSON.stringify(exampleValue);
 	lines.push("Expected input:");
-	lines.push(`  $ keystroke workflows test "${workflowName}" --input '${exampleJson}'`);
+	lines.push(`  ${formatWorkflowTestExampleCommand(authoredWorkflowId, inputSchema)}`);
 	return lines.join("\n");
 }
 /**
 * Formats validation issues into a descriptive CLI message.
-*
-* Example output:
-*
-*   Invalid input for workflow "Addition"
-*
-*     num: Required
-*     num2: Required
-*
-*   Expected input:
-*     $ keystroke workflows test "Addition" --input '{"num":0,"num2":0}'
 */
-function formatValidationError(workflowName, issues, inputSchema) {
+function formatValidationError(authoredWorkflowId, issues, inputSchema) {
 	const lines = [];
-	lines.push(`Invalid input for workflow "${workflowName}"\n`);
+	lines.push(`Invalid input for workflow "${authoredWorkflowId}"\n`);
 	for (const issue of issues) {
 		const fieldPath = issue.path.length === 0 || issue.path.length === 1 && issue.path[0] === "" ? "(root)" : issue.path.join(".");
 		lines.push(`  ${fieldPath}: ${issue.message}`);
 	}
 	lines.push("");
-	const exampleValue = inputSchema != null && typeof inputSchema === "object" ? generateExampleJson(inputSchema) : null;
-	const exampleJson = JSON.stringify(exampleValue);
-	lines.push(`Expected input:`);
-	lines.push(`  $ keystroke workflows test "${workflowName}" --input '${exampleJson}'`);
+	lines.push("Expected input:");
+	lines.push(`  ${formatWorkflowTestExampleCommand(authoredWorkflowId, inputSchema)}`);
 	return lines.join("\n");
 }
 //#endregion
-export { resolveTypeHint as a, renderJsonSchema as i, formatValidationError as n, validateRequiredFields as o, isUnknownSchema as r, formatMissingInputError as t };
+export { isUnknownSchema as a, validateRequiredFields as c, formatWorkflowInputFlag as i, formatMissingInputError as n, renderJsonSchema as o, formatValidationError as r, resolveTypeHint as s, formatExampleInputJson as t };