@keystrokehq/cli 0.1.112 → 0.1.113

package/dist/index.mjs

@@ -6260,6 +6260,11 @@ function listActionsHint(app) {
 	const bin = cliBinaryName();
 	return `\nNext steps:\n  Inspect a tool:  ${bin} apps actions get ${app} <TOOL_SLUG>\n  Run a tool:      ${bin} apps execute ${app} <TOOL_SLUG> --input '{...}'\n`;
 }
+/** Hint when listing actions for a custom org app (no toolkit tools). */
+function listCustomAppActionsHint(app) {
+	const bin = cliBinaryName();
+	return `\nCustom org apps have no catalog action list.\n  Inspect app:     ${bin} apps get ${app}\n  Scaffold code:   ${bin} apps sync ${app}\n  Connect secret:  ${bin} connect ${app}\n  Author actions:  defineApp({ slug: "${app}", ... }).action(...)\n`;
+}
 /** Next-step hint printed after showing one action's schema. */
 function showActionHint(app, tool, inputParameters) {
 	const bin = cliBinaryName();
@@ -6267,6 +6272,12 @@ function showActionHint(app, tool, inputParameters) {
 }
 //#endregion
 //#region src/commands/apps/run-app-catalog.ts
+const CUSTOM_APP_ACTIONS_MESSAGE = "Custom org apps do not expose catalog actions. Actions live in your project as defineApp(...).action(...). Use `keystroke apps get <slug>` for the credential template, or `keystroke apps sync <slug>` to scaffold the app module.";
+function isNotFoundError(error) {
+	if (!(error instanceof PlatformError)) return false;
+	if (error.status === 404) return true;
+	return /not found/i.test(error.message);
+}
 async function runAppSearch(client, query, options) {
 	const trimmed = query.trim();
 	if (!trimmed) throw new Error("Search query is required");
@@ -6280,22 +6291,58 @@ async function runAppSearch(client, query, options) {
 async function runAppShow(client, slug) {
 	const trimmed = slug.trim();
 	if (!trimmed) throw new Error("App slug is required");
-	return client.apps.getCatalogApp(trimmed);
+	const parsed = parseAppSlug(trimmed);
+	if (parsed.kind === "org") return {
+		kind: "custom",
+		app: await client.apps.get(parsed.slug)
+	};
+	try {
+		return {
+			kind: "catalog",
+			app: await client.apps.getCatalogApp(trimmed)
+		};
+	} catch (error) {
+		if (!isNotFoundError(error)) throw error;
+		try {
+			return {
+				kind: "custom",
+				app: await client.apps.get(trimmed)
+			};
+		} catch (fallbackError) {
+			if (isNotFoundError(fallbackError)) throw error;
+			throw fallbackError;
+		}
+	}
 }
 async function runAppActions(client, options) {
 	const slug = options.slug?.trim();
 	const search = options.search?.trim();
-	if (slug) return client.apps.listCatalogActions(slug, {
-		search,
-		limit: options.limit,
-		cursor: options.cursor
-	});
+	if (slug) {
+		const parsed = parseAppSlug(slug);
+		if (parsed.kind === "org") return {
+			kind: "custom",
+			toolkit: parsed.slug,
+			items: [],
+			message: CUSTOM_APP_ACTIONS_MESSAGE
+		};
+		return {
+			kind: "catalog",
+			...await client.apps.listCatalogActions(slug, {
+				search,
+				limit: options.limit,
+				cursor: options.cursor
+			})
+		};
+	}
 	if (!search) throw new Error("App slug or --search is required");
-	return client.apps.searchCatalogActions({
-		search,
-		limit: options.limit,
-		cursor: options.cursor
-	});
+	return {
+		kind: "catalog",
+		...await client.apps.searchCatalogActions({
+			search,
+			limit: options.limit,
+			cursor: options.cursor
+		})
+	};
 }
 async function runAppAction(client, toolSlug) {
 	const trimmed = toolSlug.trim().toUpperCase();
@@ -6305,8 +6352,8 @@ async function runAppAction(client, toolSlug) {
 //#endregion
 //#region src/commands/apps/actions.ts
 function registerAppActionsCommands(app) {
-	const actions = app.command("actions").description("List and inspect catalog app actions");
-	actions.command("list").description("List or search a catalog app's actions").argument("[slug]", "App slug (omit for cross-app search with --search)").option("--search <query>", "Search actions within the app or across all apps").option("--limit <n>", "Page size", (value) => Number.parseInt(value, 10)).option("--cursor <cursor>", "Pagination cursor").action((slug, options) => runCliCommand("App actions list failed", async () => {
+	const actions = app.command("actions").description("List and inspect built-in catalog app actions (not custom org apps)");
+	actions.command("list").description("List or search catalog toolkit actions; custom org apps return kind:custom with guidance").argument("[slug]", "App slug (omit for cross-app search with --search)").option("--search <query>", "Search actions within the app or across all apps").option("--limit <n>", "Page size", (value) => Number.parseInt(value, 10)).option("--cursor <cursor>", "Pagination cursor").action((slug, options) => runCliCommand("App actions list failed", async () => {
 		const config = createCliConfig();
 		const client = createCliPlatformClient(config);
 		await resolveActiveOrganization(config);
@@ -6315,9 +6362,15 @@ function registerAppActionsCommands(app) {
 			...options
 		});
 		process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
-		if (slug?.trim()) process.stderr.write(listActionsHint(slug.trim().toLowerCase()));
+		const trimmedSlug = slug?.trim();
+		if (!trimmedSlug) return;
+		if (result.kind === "custom") {
+			process.stderr.write(listCustomAppActionsHint(trimmedSlug));
+			return;
+		}
+		process.stderr.write(listActionsHint(trimmedSlug.toLowerCase()));
 	}, void 0, { orgScoped: true }));
-	actions.command("get").description("Get a catalog action schema, plus how to run and import it").argument("<app>", "App slug (e.g. github)").argument("<tool>", "Tool slug (e.g. github_create_an_issue)").action((appSlug, toolSlug) => runCliCommand("App action get failed", async () => {
+	actions.command("get").description("Get a catalog action schema, plus how to run and import it").argument("<app>", "Catalog app slug (e.g. github) — not a custom org app").argument("<tool>", "Tool slug (e.g. github_create_an_issue)").action((appSlug, toolSlug) => runCliCommand("App action get failed", async () => {
 		const config = createCliConfig();
 		const client = createCliPlatformClient(config);
 		await resolveActiveOrganization(config);
@@ -6439,7 +6492,7 @@ function parseFieldOverrides(flags) {
 	return parseCustomAppFields(flags);
 }
 function registerAppCreateCommand(app) {
-	app.command("create").description("Create a custom org app").option("--name <name>", "App display name").option("--slug <slug>", "App slug segment (defaults from name)").option("--description <description>", "App description").option("--field <field>", "Credential field as key, key:secret, key:optional, or key:secret:optional (repeatable)", collectValues$1, []).option("--mcp <url>", "Create from an MCP server URL (auto-detect auth)").option("--openapi <url>", "Create from an OpenAPI spec URL (auto-detect auth)").option("--graphql <url>", "Create from a GraphQL endpoint URL (auto-detect auth)").option("--auth <kind>", "Override detected auth: oauth or api_key (MCP only)").option("--preview", "Show the request that would be created without creating").action((options) => runCliCommand("Create app failed", async () => {
+	app.command("create").description("Create a custom org app").option("--name <name>", "App display name").option("--slug <slug>", "App slug segment (defaults from name)").option("--description <description>", "App description (defaults to --name)").option("--field <field>", "Credential field as key, key:secret, key:optional, or key:secret:optional (repeatable)", collectValues$1, []).option("--mcp <url>", "Create from an MCP server URL (auto-detect auth)").option("--openapi <url>", "Create from an OpenAPI spec URL (auto-detect auth)").option("--graphql <url>", "Create from a GraphQL endpoint URL (auto-detect auth)").option("--auth <kind>", "Override detected auth: oauth or api_key (MCP only)").option("--preview", "Show the request that would be created without creating").action((options) => runCliCommand("Create app failed", async () => {
 		const config = createCliConfig();
 		const client = createCliPlatformClient(config);
 		await resolveActiveOrganization(config);
@@ -6459,12 +6512,11 @@ function registerAppCreateCommand(app) {
 			return;
 		}
 		if (!options.name?.trim()) throw new Error("--name is required for custom apps");
-		if (!options.description?.trim()) throw new Error("--description is required for custom apps");
-		const slug = options.slug?.trim() || slugifyAppName(options.name);
+		const name = options.name.trim();
 		const result = await runAppCreate(client, {
-			name: options.name.trim(),
-			slug,
-			description: options.description.trim(),
+			name,
+			slug: options.slug?.trim() || slugifyAppName(name),
+			description: options.description?.trim() || name,
 			source: "custom",
 			fields: parseCustomAppFields(options.field)
 		}, { preview: options.preview ?? false });
@@ -6536,7 +6588,7 @@ Examples:
 //#endregion
 //#region src/commands/apps/get.ts
 function registerAppGetCommand(app) {
-	app.command("get").description("Get a Composio app from the live catalog").argument("<slug>", "App slug").action((slug) => runCliCommand("App get failed", async () => {
+	app.command("get").description("Get an app: catalog toolkit detail, or custom org app credential template (kind: catalog|custom)").argument("<slug>", "App slug (e.g. github or acme/internal-api)").action((slug) => runCliCommand("App get failed", async () => {
 		const config = createCliConfig();
 		const client = createCliPlatformClient(config);
 		await resolveActiveOrganization(config);