@keystrokehq/cli 0.0.28 → 0.0.30

package/dist/render-operation-Bc7Wu1sP.mjs

@@ -0,0 +1,36 @@
+#!/usr/bin/env node
+
+import { a as ui } from "./keystroke.mjs";
+import { n as formatPackageInstallCommand } from "./package-manager-DT1EhOkS.mjs";
+//#region src/lib/render-operation.ts
+function isFull(op) {
+	return "inputSchemaJson" in op;
+}
+function renderOperation(op, options = {}) {
+	const { showSchemas = false, packageManager } = options;
+	ui.br();
+	ui.text(op.id);
+	ui.text(`  ${op.name}`);
+	ui.text(`  ${op.description}`);
+	if (op.tags.length > 0) ui.text(`  tags: ${op.tags.join(", ")}`);
+	if (op.score !== void 0) ui.text(`  score: ${op.score.toFixed(2)}`);
+	if (isFull(op)) {
+		if (op.needsApproval) ui.warn("  needs approval");
+		if (op.deprecatedAt) ui.warn(`  deprecated since ${op.deprecatedAt}`);
+		if (op.requiredOauthScopes && op.requiredOauthScopes.length > 0) ui.text(`  oauth scopes: ${op.requiredOauthScopes.join(", ")}`);
+		if (showSchemas) {
+			ui.text(`  input fields: ${describeSchemaFields(op.inputSchemaJson)}`);
+			ui.text(`  output fields: ${describeSchemaFields(op.outputSchemaJson)}`);
+		}
+	}
+	const npmPackageName = op.npmPackageName ?? `@keystrokehq/${op.integrationId}`;
+	ui.text(`  install: ${formatPackageInstallCommand(npmPackageName, { packageManager })}`);
+}
+function describeSchemaFields(schema) {
+	if (!schema || typeof schema !== "object") return "(none)";
+	const props = schema.properties ?? {};
+	const names = Object.keys(props);
+	return names.length === 0 ? "(none)" : names.join(", ");
+}
+//#endregion
+export { renderOperation as t };

package/dist/{requirements.handler-Cje-GJ8H.mjs → requirements.handler-B5rqCjMu.mjs}

@@ -3,10 +3,10 @@
 import { a as ui, c as getProcessEnv, n as style, t as ANSI } from "./keystroke.mjs";
 import { i as writeJson } from "./output-BWcVRt-T.mjs";
 import { a as readManifestsFromOutDir } from "./dist-CTEtWDW4.mjs";
-import { t as requireWorkflowsDir } from "./resolve-project-DJJZIOmu.mjs";
-import { t as readCredentialEnvMap } from "./credential-env-map-CtmzNkwU.mjs";
-import { a as loadProjectDotenvFile, c as getTerminalContentWidth, o as manifestGroupKey, s as normalizeManifestScopeToServer, t as buildCredentialWorkflowConsumersByGroup, u as truncateWithEllipsis } from "./list-enrichment-CCRHYslm.mjs";
-import { t as groupCredentialRequirements } from "./credentials-DQW8xxof.mjs";
+import { t as requireWorkflowsDir } from "./resolve-project-E9mrh_el.mjs";
+import { t as readCredentialEnvMap } from "./credential-env-map-CRs0llf0.mjs";
+import { a as loadProjectDotenvFile, c as getTerminalContentWidth, o as manifestGroupKey, s as normalizeManifestScopeToServer, t as buildCredentialWorkflowConsumersByGroup, u as truncateWithEllipsis } from "./list-enrichment-DP1wEyBZ.mjs";
+import { t as groupCredentialRequirements } from "./credentials-DKrSaaLw.mjs";
 //#region src/commands/credentials/requirements/requirements-display.ts
 function dimLabel(label, width = 10) {
 	return style(label.padEnd(width), ANSI.dim);

package/dist/{resolve-cli-credentials-B4crOe_y.mjs → resolve-cli-credentials-CAOSVMJP.mjs}

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 
-import { n as credentials } from "./dist-D_KgdxW5.mjs";
+import { n as credentials } from "./dist-Dw7gCE7y.mjs";
 //#region src/lib/resolve-cli-credentials.ts
 /**
 * Resolves CLI credential inputs using explicit overrides first, then stored

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

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 import { a as ui, k as ProjectNotFoundError } from "./keystroke.mjs";
-import { i as projects } from "./dist-D_KgdxW5.mjs";
+import { i as projects } from "./dist-Dw7gCE7y.mjs";
 import { n as findProjectRoot } from "./project-config-DudGRFPO.mjs";
 import path from "node:path";
 //#region src/lib/resolve-project.ts

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

@@ -2,8 +2,8 @@
 
 import { O as InputValidationError, a as ui, y as toErrorMessage } from "./keystroke.mjs";
 import { a as readManifestsFromOutDir } from "./dist-CTEtWDW4.mjs";
-import { a as validateRequiredFields, n as formatValidationError, t as formatMissingInputError } from "./schema-display-XrRCdFL0.mjs";
-import { n as sleep, t as TERMINAL_STATUSES } from "./run-polling-DKWPGLyF.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 * as path$1 from "node:path";
 import * as fs from "node:fs/promises";
 import { z } from "zod";

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

@@ -1,13 +1,13 @@
 #!/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-D_KgdxW5.mjs";
+import { i as projects } from "./dist-Dw7gCE7y.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-DHOTSgPb.mjs";
-import { n as resolveWorkflowsDir } from "./resolve-project-DJJZIOmu.mjs";
-import { t as lookupCurrentDeploymentWorkflow } from "./current-deployment-workflow-Cm_aU9rQ.mjs";
-import { i as resolveWorkflowGlobals, o as validateInputOrExit, r as resolveRunInput, s as validateWorkflowGlobalsOrExit, t as pollForCompletion } from "./run-polling-cylAR4FL.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";
 //#region src/commands/workflows/run.handler.ts
 async function handleWorkflowsRun(options, ctx) {
 	const client = requireClient(ctx);

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

@@ -2,8 +2,8 @@
 
 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-BTMzBiLq.mjs";
-import { i as requireClient } from "./context-DHOTSgPb.mjs";
+import { t as createTypedCommand } from "./commander-BlrSdFcu.mjs";
+import { i as requireClient } from "./context-sgKhRc5v.mjs";
 import { z } from "zod";
 //#region src/commands/runs/inspect-display.ts
 function renderRunInspect(input) {

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

@@ -1,5 +1,6 @@
 #!/usr/bin/env node
 
+import { a as ui } from "./keystroke.mjs";
 //#region src/lib/schema-display.ts
 /**
 * Returns true when the schema is the fallback "unknown" sentinel emitted
@@ -67,6 +68,32 @@ function validateRequiredFields(input, schema) {
 *      { type: ["string", "null"] } → "string | null"
 *      { $ref: "..." } → "object"
 */
+/**
+* Renders a JSON Schema object's top-level properties for human-readable CLI output.
+*/
+function renderJsonSchema(schema) {
+	const formatted = formatSchemaPropertyLines(schema);
+	if (formatted.length === 0) {
+		ui.text("    (none)");
+		return;
+	}
+	for (const line of formatted) ui.text(line);
+}
+function formatSchemaPropertyLines(schema) {
+	if (!schema || typeof schema !== "object") return [];
+	const props = schema.properties;
+	if (!props || Object.keys(props).length === 0) return [];
+	const required = schema.required ?? [];
+	const requiredSet = new Set(required);
+	const lines = [];
+	for (const [name, fieldSchema] of Object.entries(props)) {
+		const typeHint = resolveTypeHint(fieldSchema);
+		const req = requiredSet.has(name) ? "  required" : "";
+		const desc = typeof fieldSchema.description === "string" ? `\n      ${fieldSchema.description}` : "";
+		lines.push(`    ${name}  ${typeHint}${req}${desc}`);
+	}
+	return lines;
+}
 function resolveTypeHint(fieldSchema) {
 	if (!fieldSchema) return "any";
 	if (Array.isArray(fieldSchema.enum) && fieldSchema.enum.length > 0) return `${typeof fieldSchema.type === "string" ? `${fieldSchema.type}: ` : ""}${fieldSchema.enum.map(String).join(" | ")}`;
@@ -127,4 +154,4 @@ function formatValidationError(workflowName, issues, inputSchema) {
 	return lines.join("\n");
 }
 //#endregion
-export { validateRequiredFields as a, resolveTypeHint as i, formatValidationError as n, isUnknownSchema as r, formatMissingInputError as t };
+export { resolveTypeHint as a, renderJsonSchema as i, formatValidationError as n, validateRequiredFields as o, isUnknownSchema as r, formatMissingInputError as t };

package/dist/schemas-4Mq_bxob.mjs

@@ -0,0 +1,39 @@
+#!/usr/bin/env node
+
+import { z } from "zod";
+const CatalogDefinitionSourceSchema = z.enum(["official", "custom"]);
+z.object({
+	limit: z.number(),
+	offset: z.number(),
+	total: z.number()
+});
+/**
+* Pagination query parameters for list endpoints.
+* Uses consistent validation across all endpoints:
+* - limit: 1-100 (default: 20)
+* - offset: >= 0 (default: 0)
+*/
+const PaginationQuerySchema = z.object({
+	limit: z.coerce.number().min(1).max(100).optional().default(20),
+	offset: z.coerce.number().min(0).optional().default(0)
+});
+z.object({
+	error: z.string(),
+	message: z.string().optional(),
+	code: z.string().optional()
+});
+z.object({
+	error: z.literal("Not found"),
+	resource: z.string(),
+	id: z.string()
+});
+z.object({
+	error: z.literal("Validation failed"),
+	message: z.string(),
+	fields: z.record(z.string(), z.array(z.string())).optional()
+});
+/** Matches UUID v1-v5 format. Used to distinguish UUIDs from slugs at runtime. */
+const UUID_FORMAT = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+z.string().min(1).max(255).regex(/^[a-z0-9-]+$/, "Slug must be alphanumeric and can contain hyphens").refine((val) => !UUID_FORMAT.test(val), "Slug must not be in UUID format");
+//#endregion
+export { PaginationQuerySchema as n, CatalogDefinitionSourceSchema as t };

package/dist/search-BEfy2fG9.mjs

@@ -0,0 +1,53 @@
+#!/usr/bin/env node
+
+import { n as JsonOptionSchema, t as JSON_OPTION_CONFIG } from "./output-BWcVRt-T.mjs";
+import { t as createTypedCommand } from "./commander-BlrSdFcu.mjs";
+import { z } from "zod";
+//#region src/commands/search/search.command.ts
+const SearchTypeValues = [
+	"operations",
+	"integrations",
+	"credentials"
+];
+const SearchOptionsSchema = JsonOptionSchema.extend({
+	query: z.string().min(1),
+	type: z.enum(SearchTypeValues).optional().default("operations"),
+	integration: z.string().optional(),
+	limit: z.coerce.number().int().positive().max(50).optional(),
+	full: z.boolean().optional()
+});
+const SEARCH_OPTIONS_CONFIG = {
+	...JSON_OPTION_CONFIG,
+	type: {
+		flag: "--type <resource>",
+		description: `Resource to search: ${SearchTypeValues.join(" | ")} (default: operations)`
+	},
+	integration: {
+		flag: "--integration <id>",
+		description: "Restrict to one integration (operations and credentials only)"
+	},
+	limit: {
+		flag: "--limit <n>",
+		description: "Max results (1–50, default: 10)"
+	},
+	full: {
+		flag: "--full",
+		description: "Include extended fields (schemas, safety flags, nested operations) without a follow-up show"
+	}
+};
+function createSearchCommand() {
+	return createTypedCommand({
+		name: "search",
+		description: "Ranked discovery search across operations, integrations, or credential definitions",
+		schema: SearchOptionsSchema,
+		optionsConfig: SEARCH_OPTIONS_CONFIG,
+		argument: {
+			name: "query",
+			description: "Search query (matches name and related fields per --type)",
+			key: "query"
+		},
+		loadHandler: async () => (await import("./search.handler-V7ObLGjN.mjs")).handleSearch
+	});
+}
+//#endregion
+export { createSearchCommand };

package/dist/search.handler-V7ObLGjN.mjs

@@ -0,0 +1,79 @@
+#!/usr/bin/env node
+
+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";
+//#region src/lib/render-integration.ts
+function renderIntegration(i, { full = false, packageManager } = {}) {
+	ui.br();
+	ui.text(i.publicId);
+	ui.text(`  ${i.name}`);
+	if (i.description) ui.text(`  ${i.description}`);
+	if (i.score !== void 0) ui.text(`  score: ${i.score.toFixed(2)}`);
+	const npmPackageName = i.npmPackageName ?? `@keystrokehq/${i.publicId}`;
+	ui.text(`  install: ${formatPackageInstallCommand(npmPackageName, { packageManager })}`);
+	if (full) {
+		const withOps = i;
+		if (Array.isArray(withOps.operations) && withOps.operations.length > 0) {
+			ui.text(`  operations (${withOps.operations.length}):`);
+			for (const op of withOps.operations) ui.text(`    ${op.id}  —  ${op.name}`);
+		}
+	}
+}
+//#endregion
+//#region src/commands/search/search.handler.ts
+async function handleSearch(options, ctx) {
+	const type = options.type ?? "operations";
+	const result = await dispatchSearch(requireClient(ctx), type, {
+		q: options.query,
+		integrationId: options.integration,
+		limit: options.limit,
+		...options.full ? { include: "full" } : {}
+	});
+	if (ctx.jsonMode) {
+		writeJson(result);
+		return;
+	}
+	if (result.results.length === 0) {
+		ui.hint(`No ${type} matched "${options.query}".`);
+		ui.hint(`Try a different query, or run \`keystroke ${browseCommand(type)}\` to browse.`);
+		return;
+	}
+	const packageManager = detectPackageManager();
+	for (const hit of result.results) renderHit(type, hit, {
+		full: Boolean(options.full),
+		packageManager
+	});
+}
+function browseCommand(type) {
+	if (type === "operations") return "operations list";
+	if (type === "integrations") return "integrations list";
+	return "credentials definitions list";
+}
+function dispatchSearch(client, type, params) {
+	if (type === "operations") return client.search.operations(params);
+	if (type === "integrations") return client.search.integrations(params);
+	return client.search.credentials(params);
+}
+function renderHit(type, hit, { full, packageManager }) {
+	if (type === "operations") {
+		renderOperation(hit, {
+			showSchemas: full,
+			packageManager
+		});
+		return;
+	}
+	if (type === "integrations") {
+		renderIntegration(hit, {
+			full,
+			packageManager
+		});
+		return;
+	}
+	renderCredential(hit, { full });
+}
+//#endregion
+export { handleSearch };

package/dist/show.handler-C_VDYU91.mjs

@@ -0,0 +1,31 @@
+#!/usr/bin/env node
+
+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";
+//#region src/commands/integrations/show.handler.ts
+async function handleIntegrationShow(options, ctx) {
+	const client = requireClient(ctx);
+	const [integration, operations] = await Promise.all([client.integrations.get(options.id), client.integrations.listOperations(options.id)]);
+	if (ctx.jsonMode) {
+		writeJson({
+			integration: integration.integration,
+			operations: operations.operations
+		});
+		return;
+	}
+	const entry = integration.integration;
+	const packageManager = detectPackageManager();
+	const npmPackageName = entry.npmPackageName ?? `@keystrokehq/${entry.publicId}`;
+	ui.text(entry.publicId);
+	ui.text(`  ${entry.name}`);
+	if (entry.description) ui.text(`  ${entry.description}`);
+	ui.text(`  install: ${formatPackageInstallCommand(npmPackageName, { packageManager })}`);
+	ui.text(`  operations (${operations.operations.length}):`);
+	for (const op of operations.operations) ui.text(`    ${op.id}  —  ${op.name}`);
+	ui.br();
+	ui.hint(`Usage examples are in ${entry.npmPackageName ?? `@keystrokehq/${entry.publicId}`}'s TSDoc — open in your IDE for hover docs.`);
+}
+//#endregion
+export { handleIntegrationShow };

package/dist/show.handler-CsidInW8.mjs

@@ -0,0 +1,21 @@
+#!/usr/bin/env node
+
+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 renderCredential } from "./render-credential-Bn15FEUC.mjs";
+//#region src/commands/credentials/definitions/show.handler.ts
+async function handleCredentialDefinitionShow(options, ctx) {
+	const { credential } = await requireClient(ctx).credentials.definitions.get(options.id);
+	if (ctx.jsonMode) {
+		writeJson(credential);
+		return;
+	}
+	renderCredential(credential, { full: true });
+	ui.br();
+	ui.text("Auth schema:");
+	renderJsonSchema(credential.authSchemaJson);
+}
+//#endregion
+export { handleCredentialDefinitionShow };

package/dist/show.handler-Wmv0tkxx.mjs

@@ -0,0 +1,35 @@
+#!/usr/bin/env node
+
+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";
+//#region src/commands/operations/show.handler.ts
+async function handleOperationShow(options, ctx) {
+	const { operation } = await requireClient(ctx).operations.get(options.id);
+	if (options.schema) {
+		writeJson({
+			input: operation.inputSchemaJson,
+			output: operation.outputSchemaJson
+		});
+		return;
+	}
+	if (ctx.jsonMode) {
+		writeJson(operation);
+		return;
+	}
+	renderOperation(operation, {
+		showSchemas: true,
+		packageManager: detectPackageManager()
+	});
+	ui.br();
+	ui.text("Input schema:");
+	renderJsonSchema(operation.inputSchemaJson);
+	ui.br();
+	ui.text("Output schema:");
+	renderJsonSchema(operation.outputSchemaJson);
+}
+//#endregion
+export { handleOperationShow };

package/dist/{skills-sync.handler-DsJP_-XZ.mjs → skills-sync.handler-BAATdT6N.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-AX0X-u1J.mjs";
+import { i as UnknownSkillAgentError, n as resolveSkillInstallChoices, r as installKeystrokeAgentSkills, t as summarizeSkillInstall } from "./skill-installer-D6j9IA3Z.mjs";
 import path from "node:path";
 //#region src/commands/skills/skills-sync.handler.ts
 async function handleSkillsSync(options, _ctx) {

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

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 
 import { n as JsonOptionSchema, t as JSON_OPTION_CONFIG } from "./output-BWcVRt-T.mjs";
-import { t as createTypedCommand } from "./commander-BTMzBiLq.mjs";
-import { t as SKILL_INSTALL_METHODS } from "./types-D1cVpE7_.mjs";
+import { t as createTypedCommand } from "./commander-BlrSdFcu.mjs";
+import { t as SKILL_INSTALL_METHODS } from "./types-AlA-ifK9.mjs";
 import { z } from "zod";
 //#region src/commands/skills/skills.command.ts
 const SkillsCommandOptionsSchema = JsonOptionSchema.extend({
@@ -32,13 +32,13 @@ function createSkillsCommand() {
 		description: "Sync Keystroke agent skills (SKILL.md) from @keystrokehq/skills",
 		schema: SkillsCommandOptionsSchema,
 		optionsConfig: SKILLS_OPTIONS_CONFIG,
-		loadHandler: async () => (await import("./skills.handler-KEUkV5NH.mjs")).handleSkillsParent,
+		loadHandler: async () => (await import("./skills.handler-DYIQK0Vu.mjs")).handleSkillsParent,
 		subcommands: [createTypedCommand({
 			name: "sync",
 			description: "Install bundled Keystroke skills into selected agent skill directories",
 			schema: SkillsCommandOptionsSchema,
 			optionsConfig: SKILLS_OPTIONS_CONFIG,
-			loadHandler: async () => (await import("./skills-sync.handler-DsJP_-XZ.mjs")).handleSkillsSync
+			loadHandler: async () => (await import("./skills-sync.handler-BAATdT6N.mjs")).handleSkillsSync
 		})]
 	});
 	cmd.enablePositionalOptions();