@keystrokehq/cli 0.1.22 → 0.1.24

package/dist/index.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
-import { $ as HealthResponseSchema, $t as StartKeystrokeConnectionResultSchema, A as CreateCustomAppRequestSchema, An as WorkflowSummaryDetailResponseSchema, At as PresignChatAttachmentResponseSchema, B as CredentialConsumerListQuerySchema, Bn as detectProjectPackageManagerFromSnapshot, Bt as ProjectSettingsResponseSchema, C as ConnectAuthorizeUrlResponseSchema, Cn as UserAvatarPatchSchema, Ct as OpenApiDiscoverResponseSchema, D as CreateCredentialInstanceBodySchema, Dn as WorkflowRunDetailResponseSchema, Dt as PROJECT_REACHABILITY_REQUEST_TIMEOUT_MS, E as CreateApiKeyResponseSchema, En as UserPreferencesSchema, Et as PROJECT_PULL_STATE_RELATIVE_PATH, F as CreateProjectRequestSchema, Fn as WorkspaceTriggerOverviewSchema, Ft as PresignUserAvatarRequestSchema, G as DeclineOrganizationInvitationResponseSchema, Gn as parseAppSlug, Gt as QueuedAgentPromptResponseSchema, H as CredentialInstanceListResponseSchema, Hn as listenPortFromPublicUrl, Ht as PromptInputSchema, I as CreateProjectResponseSchema, In as WorkspaceTriggerRunListResponseSchema, It as PresignUserAvatarResponseSchema, J as ErrorResponseSchema, Jn as resolveConnectAppSlug, Jt as RecentResourceListResponseSchema, K as DownloadActiveProjectArtifactResponseSchema, Kn as parseErrorResponse, Kt as QueuedRunResponseSchema, L as CredentialAssignmentListQuerySchema, Ln as buildConnectDeeplink, Lt as ProjectPullStateSchema, M as CreateOrganizationRequestSchema, Mn as WorkspaceTriggerDetailSchema, Mt as PresignOrgLogoResponseSchema, N as CreateOrganizationResponseSchema, Nn as WorkspaceTriggerFileSchema, Nt as PresignProjectSourceRequestSchema, O as CreateCredentialsRequestSchema, On as WorkflowRunHooksResponseSchema, Ot as PollRunResponseSchema, P as CreateProjectArtifactResponseSchema, Pn as WorkspaceTriggerListResponseSchema, Pt as PresignProjectSourceResponseSchema, Q as GraphqlDiscoverResponseSchema, Qt as StartKeystrokeConnectionInputSchema, R as CredentialAssignmentListResponseSchema, Rt as ProjectReachabilityResponseSchema, S as CompleteProjectArtifactResponseSchema, Sn as UpsertGatewayAttachmentBodySchema, St as McpDiscoverResponseSchema, T as CreateApiKeyRequestSchema, Tn as UserPreferencesPatchSchema, Tt as OrganizationSidebarBrandingSchema, U as CredentialInstanceRecordSchema, Ut as PromptResponseSchema, V as CredentialConsumerListResponseSchema, Vn as isAcceptableInstallExit, Vt as ProjectSlugAvailabilityResponseSchema, X as GetCredentialResponseSchema, Xn as slugifyAppName, Xt as SkillSummaryListResponseSchema, Y as GatewayAttachmentRecordSchema, Yn as resolvePublicPlatformOrigin, Yt as SkillSummaryDetailResponseSchema, Z as GetCustomAppResponseSchema, Zt as SlugAvailabilityResponseSchema, _ as ChannelAccountListResponseSchema, _n as UpdateProjectMemberResponseSchema, _t as ListProjectDeploymentsResponseSchema, a as AgentSessionDetailResponseSchema, an as SubmitTeamRequestRequestSchema, at as InviteOrganizationMembersResponseSchema, b as ChannelDirectoryListResponseSchema, bn as UploadProjectSourceManifestRequestSchema, bt as ListProjectMetricsResponseSchema, c as AgentSummaryListResponseSchema, cn as TriggerRunDetailResponseSchema, d as AssignCredentialBodySchema, dn as UpdateCredentialInstanceBodySchema, dt as ListApiKeysResponseSchema, en as StartMcpOAuthConnectionInputSchema, et as HistoryRunCancelResponseSchema, f as BindChannelBodySchema, fn as UpdateCredentialRequestSchema, ft as ListAppsResponseSchema, g as CatalogAppsPageResponseSchema, gn as UpdateProjectMemberRequestSchema, gt as ListOrganizationsResponseSchema, h as CatalogAppDetailResponseSchema, hn as UpdateOrganizationRequestSchema, ht as ListOrganizationMembersResponseSchema, i as AgentSessionChatStateResponseSchema, in as SubmitMarketingContactRequestSchema, it as InviteOrganizationMembersRequestSchema, j as CreateCustomAppResponseSchema, jn as WorkflowSummaryListResponseSchema, jt as PresignOrgLogoRequestSchema, k as CreateCredentialsResponseSchema, kn as WorkflowRunListResponseSchema, kt as PresignChatAttachmentRequestSchema, l as AgentTriggerSummaryListResponseSchema, ln as TriggerRunListResponseSchema, lt as ListAgentMemoryFilesResponseSchema, m as CatalogActionsPageResponseSchema, mn as UpdateOrganizationMemberResponseSchema, mt as ListOrganizationInvitationsResponseSchema, n as AcceptOrganizationInvitationResponseSchema, nn as StartOAuthConnectionInputSchema, nt as HistoryRunListQuerySchema, o as AgentSessionListResponseSchema, on as TriggerDetailResponseSchema, ot as InviteProjectMembersRequestSchema, p as CatalogActionDetailResponseSchema, pn as UpdateOrganizationMemberRequestSchema, pt as ListCredentialsResponseSchema, q as DownloadActiveProjectSourceResponseSchema, r as ActiveOrganizationResponseSchema, rn as StartOAuthConnectionResultSchema, rt as HistoryRunListResponseSchema, s as AgentSummaryDetailResponseSchema, sn as TriggerListResponseSchema, st as InviteProjectMembersResponseSchema, t as ACTIVE_ORG_HEADER, tn as StartMcpOAuthConnectionResultSchema, tt as HistoryRunDetailResponseSchema, u as AppSlugAvailabilityResponseSchema, un as UpdateChannelBindingBodySchema, ut as ListAgentWorkspaceFilesResponseSchema, v as ChannelConnectionListResponseSchema, vn as UpdateProjectRequestSchema, vt as ListProjectFilesResponseSchema, w as ConnectProvidersResponseSchema, wn as UserAvatarSchema, wt as OrganizationSidebarBrandingPatchSchema, x as ChannelPlatformSchema, xn as UploadProjectSourceResponseSchema, xt as ListProjectsResponseSchema, y as ChannelConnectionSchema, yn as UpdateProjectSettingsRequestSchema, yt as ListProjectMembersResponseSchema, z as CredentialAssignmentRecordSchema, zn as deriveCustomAppDisplay, zt as ProjectResponseSchema } from "./dist-UdbUy9DM.mjs";
-import { a as installPlaygroundDependencies, c as createCliConfig, d as getEffectiveApiTarget, f as getPlatformUrl, g as resolvePlatformUrlForWebUrl, i as installDependencies$1, l as getCliConfigDir, m as DEFAULT_PLATFORM_URL, n as buildPlaygroundWorkspace, o as resolvePackageManager, p as getWebUrl, s as resolveCliRoot, t as readCliVersion, u as getConfigDir } from "./version-CUTRAMa8.mjs";
-import { n as mergeFilteredArtifact, r as packProjectArtifact, t as mapInParallelBatches } from "./dist-D8wvycYm.mjs";
+import { $ as GetCustomAppResponseSchema, $n as slugifyAppName, $t as SlugAvailabilityResponseSchema, A as CreateCustomAppRequestSchema, An as WorkflowRunHooksResponseSchema, At as PollRunResponseSchema, B as CredentialConsumerListQuerySchema, Bt as ProjectReachabilityResponseSchema, C as ConnectAuthorizeUrlResponseSchema, Cn as UploadProjectSourceResponseSchema, Ct as ListProjectsResponseSchema, D as CreateCredentialInstanceBodySchema, Dn as UserPreferencesPatchSchema, Dt as OrganizationSidebarBrandingSchema, E as CreateApiKeyResponseSchema, En as UserAvatarSchema, Et as OrganizationSidebarBrandingPatchSchema, F as CreateProjectRequestSchema, Fn as WorkspaceTriggerFileSchema, Ft as PresignProjectSourceRequestSchema, G as DOCS_QUERY_TOOL, Gt as PromptResponseSchema, H as CredentialInstanceListResponseSchema, Hn as detectProjectPackageManagerFromSnapshot, Ht as ProjectSettingsResponseSchema, I as CreateProjectResponseSchema, In as WorkspaceTriggerListResponseSchema, It as PresignProjectSourceResponseSchema, J as DownloadActiveProjectArtifactResponseSchema, Jn as parseErrorResponse, Jt as QueuedRunResponseSchema, K as DOCS_SEARCH_TOOL, L as CredentialAssignmentListQuerySchema, Ln as WorkspaceTriggerOverviewSchema, Lt as PresignUserAvatarRequestSchema, M as CreateOrganizationRequestSchema, Mn as WorkflowSummaryDetailResponseSchema, Mt as PresignChatAttachmentResponseSchema, N as CreateOrganizationResponseSchema, Nn as WorkflowSummaryListResponseSchema, Nt as PresignOrgLogoRequestSchema, O as CreateCredentialsRequestSchema, On as UserPreferencesSchema, Ot as PROJECT_PULL_STATE_RELATIVE_PATH, P as CreateProjectArtifactResponseSchema, Pn as WorkspaceTriggerDetailSchema, Pt as PresignOrgLogoResponseSchema, Q as GetCredentialResponseSchema, Qn as resolvePublicPlatformOrigin, Qt as SkillSummaryListResponseSchema, R as CredentialAssignmentListResponseSchema, Rn as WorkspaceTriggerRunListResponseSchema, Rt as PresignUserAvatarResponseSchema, S as CompleteProjectArtifactResponseSchema, Sn as UploadProjectSourceManifestRequestSchema, St as ListProjectMetricsResponseSchema, T as CreateApiKeyRequestSchema, Tn as UserAvatarPatchSchema, Tt as OpenApiDiscoverResponseSchema, U as CredentialInstanceRecordSchema, Un as isAcceptableInstallExit, Ut as ProjectSlugAvailabilityResponseSchema, V as CredentialConsumerListResponseSchema, Vn as deriveCustomAppDisplay, Vt as ProjectResponseSchema, Wn as listenPortFromPublicUrl, Wt as PromptInputSchema, X as ErrorResponseSchema, Xn as resolveConnectAppSlug, Xt as RecentResourceListResponseSchema, Y as DownloadActiveProjectSourceResponseSchema, Z as GatewayAttachmentRecordSchema, Zn as resolveDocsMcpUrl, Zt as SkillSummaryDetailResponseSchema, _ as ChannelAccountListResponseSchema, _n as UpdateOrganizationRequestSchema, _t as ListOrganizationMembersResponseSchema, a as AgentSessionDetailResponseSchema, an as StartOAuthConnectionResultSchema, at as HistoryRunListResponseSchema, b as ChannelDirectoryListResponseSchema, bn as UpdateProjectRequestSchema, bt as ListProjectFilesResponseSchema, c as AgentSummaryListResponseSchema, cn as TriggerDetailResponseSchema, ct as InviteProjectMembersRequestSchema, d as AssignCredentialBodySchema, dn as TriggerRunListResponseSchema, dt as ListAgentMemoryFilesResponseSchema, en as StartKeystrokeConnectionInputSchema, et as GraphqlDiscoverResponseSchema, f as BindChannelBodySchema, fn as UpdateChannelBindingBodySchema, ft as ListAgentWorkspaceFilesResponseSchema, g as CatalogAppsPageResponseSchema, gn as UpdateOrganizationMemberResponseSchema, gt as ListOrganizationInvitationsResponseSchema, h as CatalogAppDetailResponseSchema, hn as UpdateOrganizationMemberRequestSchema, ht as ListCredentialsResponseSchema, i as AgentSessionChatStateResponseSchema, in as StartOAuthConnectionInputSchema, it as HistoryRunListQuerySchema, j as CreateCustomAppResponseSchema, jn as WorkflowRunListResponseSchema, jt as PresignChatAttachmentRequestSchema, k as CreateCredentialsResponseSchema, kn as WorkflowRunDetailResponseSchema, kt as PROJECT_REACHABILITY_REQUEST_TIMEOUT_MS, l as AgentTriggerSummaryListResponseSchema, ln as TriggerListResponseSchema, lt as InviteProjectMembersResponseSchema, m as CatalogActionsPageResponseSchema, mn as UpdateCredentialRequestSchema, mt as ListAppsResponseSchema, n as AcceptOrganizationInvitationResponseSchema, nn as StartMcpOAuthConnectionInputSchema, nt as HistoryRunCancelResponseSchema, o as AgentSessionListResponseSchema, on as SubmitMarketingContactRequestSchema, ot as InviteOrganizationMembersRequestSchema, p as CatalogActionDetailResponseSchema, pn as UpdateCredentialInstanceBodySchema, pt as ListApiKeysResponseSchema, q as DeclineOrganizationInvitationResponseSchema, qn as parseAppSlug, qt as QueuedAgentPromptResponseSchema, r as ActiveOrganizationResponseSchema, rn as StartMcpOAuthConnectionResultSchema, rt as HistoryRunDetailResponseSchema, s as AgentSummaryDetailResponseSchema, sn as SubmitTeamRequestRequestSchema, st as InviteOrganizationMembersResponseSchema, t as ACTIVE_ORG_HEADER, tn as StartKeystrokeConnectionResultSchema, tt as HealthResponseSchema, u as AppSlugAvailabilityResponseSchema, un as TriggerRunDetailResponseSchema, v as ChannelConnectionListResponseSchema, vn as UpdateProjectMemberRequestSchema, vt as ListOrganizationsResponseSchema, w as ConnectProvidersResponseSchema, wn as UpsertGatewayAttachmentBodySchema, wt as McpDiscoverResponseSchema, x as ChannelPlatformSchema, xn as UpdateProjectSettingsRequestSchema, xt as ListProjectMembersResponseSchema, y as ChannelConnectionSchema, yn as UpdateProjectMemberResponseSchema, yt as ListProjectDeploymentsResponseSchema, z as CredentialAssignmentRecordSchema, zn as buildConnectDeeplink, zt as ProjectPullStateSchema } from "./dist-BOhrc_Nv.mjs";
+import { i as packProjectArtifact, n as withMcpReadClient, r as mergeFilteredArtifact, t as mapInParallelBatches } from "./dist-Re6HHSqz.mjs";
+import { a as installPlaygroundDependencies, c as createCliConfig, d as getEffectiveApiTarget, f as getPlatformUrl, g as resolvePlatformUrlForWebUrl, i as installDependencies$1, l as getCliConfigDir, m as DEFAULT_PLATFORM_URL, n as buildPlaygroundWorkspace, o as resolvePackageManager, p as getWebUrl, s as resolveCliRoot, t as readCliVersion, u as getConfigDir } from "./version-DcR3O1UD.mjs";
 import { createRequire } from "node:module";
 import { Command } from "commander";
 import { platform } from "node:os";
@@ -5012,6 +5012,23 @@ function formatCliError(error, fallback, context) {
 }
 //#endregion
 //#region src/errors/run-command.ts
+/**
+* Run a command that needs no project/org target or auth (e.g. public docs).
+* Builds config and formats errors, but skips `resolveApiTarget` / `ensureActiveOrganization`,
+* so it works logged-out from any directory.
+*/
+async function runStandaloneCliCommand(fallback, fn, errorContext) {
+	const config = createCliConfig();
+	try {
+		await fn({ config });
+	} catch (error) {
+		process.stderr.write(`${formatCliError(error, fallback, {
+			...errorContext,
+			webUrl: getWebUrl(config)
+		})}\n`);
+		process.exitCode = 1;
+	}
+}
 async function runProjectCliCommand(fallback, fn, errorContext, targetOptions = {}) {
 	return runCliCommand(fallback, fn, errorContext, {
 		...projectScopedTarget,
@@ -6206,7 +6223,7 @@ function registerBuildCommand(program) {
 	program.command("build").description("Build the keystroke project for production").option("--dir <path>", "Project directory", process.cwd()).action(async (options) => {
 		try {
 			const root = resolveProjectRoot(options.dir);
-			const { buildApp } = await import("./dist-BdewSOMb.mjs");
+			const { buildApp } = await import("./dist-CUEVu120.mjs");
 			await buildApp({ root });
 			process.stdout.write(`Built ${root}\n`);
 		} catch (error) {
@@ -6260,7 +6277,7 @@ async function sleep(ms) {
 }
 async function buildDeployArchive(client, root, projectId, filter) {
 	if (filter?.length) {
-		const { buildFilteredApp } = await import("./dist-BdewSOMb.mjs");
+		const { buildFilteredApp } = await import("./dist-CUEVu120.mjs");
 		const filtered = await buildFilteredApp({
 			root,
 			filter,
@@ -6282,7 +6299,7 @@ async function buildDeployArchive(client, root, projectId, filter) {
 			sourceFiles: filtered.sourceFiles
 		};
 	}
-	const { buildApp } = await import("./dist-BdewSOMb.mjs");
+	const { buildApp } = await import("./dist-CUEVu120.mjs");
 	const { sourceFiles } = await buildApp({
 		root,
 		collectSources: true,
@@ -6401,7 +6418,7 @@ function runtimeChildEnv(parentEnv, overrides) {
 //#region src/project/bootstrap-run.ts
 /** Node args + env for `@keystrokehq/build` bootstrap (shared by start + dev). */
 async function resolveBootstrapRun(options) {
-	const { resolveRuntimeBuildArtifact } = await import("./dist-BdewSOMb.mjs");
+	const { resolveRuntimeBuildArtifact } = await import("./dist-CUEVu120.mjs");
 	const loader = pathToFileURL(resolveRuntimeBuildArtifact(options.runtimeNodeModules, "dist/runtime-loader.mjs")).href;
 	const bootstrap = resolveRuntimeBuildArtifact(options.runtimeNodeModules, "dist/standalone-bootstrap.mjs");
 	const args = [`--import=${loader}`];
@@ -6550,7 +6567,7 @@ async function runDev(options) {
 	process.on("SIGINT", shutdown);
 	process.on("SIGTERM", shutdown);
 	try {
-		const { watchApp } = await import("./dist-BdewSOMb.mjs");
+		const { watchApp } = await import("./dist-CUEVu120.mjs");
 		await watchApp({
 			root,
 			clean: false,
@@ -6578,6 +6595,63 @@ function registerDevCommand(program) {
 	});
 }
 //#endregion
+//#region src/commands/docs/run-docs.ts
+/**
+* Render an MCP tool result for the terminal. The docs tools return text/markdown
+* blocks (search hits, file contents, sandbox stdout/stderr), so we pass them through
+* verbatim and only fall back to JSON when a result carries no text.
+*/
+function renderToolResult(result) {
+	const blocks = result?.content;
+	if (Array.isArray(blocks)) {
+		const text = blocks.filter((block) => block?.type === "text" && typeof block.text === "string").map((block) => block.text).join("\n");
+		if (text.length > 0) return text;
+	}
+	return JSON.stringify(result, null, 2);
+}
+/** Call a docs MCP tool and render its result as text. */
+async function callDocsTool(client, name, args) {
+	return renderToolResult(await client.callTool({
+		name,
+		arguments: args
+	}));
+}
+//#endregion
+//#region src/commands/docs/docs-mcp-url.ts
+/**
+* Public Keystroke docs MCP endpoint (Mintlify-hosted, no auth).
+* Derived from the configured web URL; `KEYSTROKE_DOCS_MCP_URL` overrides for dev/testing.
+*/
+function getDocsMcpUrl(config) {
+	return resolveDocsMcpUrl({
+		webUrl: getWebUrl(config),
+		override: process.env.KEYSTROKE_DOCS_MCP_URL
+	});
+}
+//#endregion
+//#region src/commands/docs/query.ts
+function registerDocsQueryCommand(docs) {
+	docs.command("query").description("Read the Keystroke docs filesystem with a shell-style command (cat, rg, ls, tree)").argument("<command>", "Read-only command, e.g. \"cat /quickstart.mdx\" or \"rg -il auth /\"").action((command) => runStandaloneCliCommand("Docs query failed", async ({ config }) => {
+		const output = await withMcpReadClient(getDocsMcpUrl(config), (client) => callDocsTool(client, DOCS_QUERY_TOOL, { command }));
+		process.stdout.write(`${output}\n`);
+	}));
+}
+//#endregion
+//#region src/commands/docs/search.ts
+function registerDocsSearchCommand(docs) {
+	docs.command("search").description("Search the Keystroke documentation for relevant pages and examples").argument("<query>", "Search query").action((query) => runStandaloneCliCommand("Docs search failed", async ({ config }) => {
+		const output = await withMcpReadClient(getDocsMcpUrl(config), (client) => callDocsTool(client, DOCS_SEARCH_TOOL, { query }));
+		process.stdout.write(`${output}\n`);
+	}));
+}
+//#endregion
+//#region src/commands/docs/index.ts
+function registerDocsCommand(program) {
+	const docs = program.command("docs").description("Search and read the Keystroke documentation");
+	registerDocsSearchCommand(docs);
+	registerDocsQueryCommand(docs);
+}
+//#endregion
 //#region src/commands/history/run-history.ts
 async function runHistoryList(config, filters) {
 	if (filters?.admin) await requireAdminRole(config);
@@ -6700,7 +6774,7 @@ const INIT_CATALOG_VERSIONS = {
 	vitest: "^4.1.7",
 	"@types/node": "^25.9.1"
 };
-const INIT_KEYSTROKE_VERSION = "^0.1.19";
+const INIT_KEYSTROKE_VERSION = "^0.1.22";
 //#endregion
 //#region src/init/copy-template.ts
 function renderTemplate(content, variables) {
@@ -7485,7 +7559,7 @@ async function runStart(options) {
 	const apiPort = Number(new URL(serverUrl).port || 80);
 	const runtimeNodeModules = resolveCliRuntimeNodeModules(resolveCliRoot(import.meta.url));
 	ensureNativeDeps(runtimeNodeModules);
-	const { buildApp } = await import("./dist-BdewSOMb.mjs");
+	const { buildApp } = await import("./dist-CUEVu120.mjs");
 	await buildApp({
 		root,
 		clean: false
@@ -8053,6 +8127,7 @@ function createProgram() {
 	registerHistoryCommand(program);
 	registerCredentialsCommand(program);
 	registerHealthCommand(program);
+	registerDocsCommand(program);
 	registerInitCommand(program);
 	registerSkillsCommand(program);
 	registerSkillCommand(program);
@@ -8069,7 +8144,7 @@ function createProgram() {
 	return program;
 }
 async function runCli(argv) {
-	const { maybeAutoUpdate } = await import("./maybe-auto-update-BK4A8nTA.mjs");
+	const { maybeAutoUpdate } = await import("./maybe-auto-update-q5MthdI8.mjs");
 	await maybeAutoUpdate(argv);
 	createProgram().parse(argv);
 }