kly 0.1.0

package/dist/cli.mjs

@@ -0,0 +1,229 @@
+//#region src/cli.ts
+/**
+* Extract JSON Schema from a Standard Schema if available
+*/
+function extractJsonSchema(schema) {
+	const standard = schema["~standard"];
+	if ("jsonSchema" in standard && standard.jsonSchema) {
+		const jsonSchema = standard.jsonSchema;
+		try {
+			return jsonSchema.output({ target: "draft-07" });
+		} catch {
+			return null;
+		}
+	}
+	return null;
+}
+/**
+* Extract property info from JSON Schema
+*/
+function extractProperties(jsonSchema) {
+	const properties = jsonSchema.properties ?? {};
+	const required = jsonSchema.required ?? [];
+	return Object.entries(properties).map(([name, prop]) => {
+		let type = prop.type ?? "unknown";
+		if (prop.enum) type = prop.enum.join(" | ");
+		return {
+			name,
+			type,
+			description: prop.description,
+			default: prop.default,
+			enum: prop.enum,
+			required: required.includes(name) && prop.default === void 0
+		};
+	});
+}
+/**
+* Format a single option line for help text
+*/
+function formatOptionLine(prop) {
+	const flagPart = `${`--${prop.name}`}${prop.type !== "boolean" ? `=<${prop.type}>` : ""}`.padEnd(25);
+	let descPart = prop.description ?? "";
+	if (prop.default !== void 0) descPart += ` (default: ${JSON.stringify(prop.default)})`;
+	if (prop.required) descPart += " [required]";
+	return `  ${flagPart} ${descPart}`;
+}
+/**
+* Generate usage string with required args
+*/
+function generateUsage(command, properties) {
+	return `  ${command} ${properties.filter((p) => p.required).map((p) => `--${p.name}=<${p.type}>`).join(" ")}${properties.some((p) => !p.required) ? " [options]" : ""}`.trim();
+}
+/**
+* Parse command line arguments into an object
+*/
+function parseCliArgs(argv) {
+	const result = {};
+	let i = 0;
+	while (i < argv.length) {
+		const arg = argv[i];
+		if (!arg.startsWith("-")) {
+			i++;
+			continue;
+		}
+		if (arg.includes("=")) {
+			const [key$1, ...valueParts] = arg.split("=");
+			const cleanKey = key$1.replace(/^-+/, "");
+			result[cleanKey] = coerceValue(valueParts.join("="));
+			i++;
+			continue;
+		}
+		if (arg.startsWith("--no-")) {
+			const key$1 = arg.slice(5);
+			result[key$1] = false;
+			i++;
+			continue;
+		}
+		const key = arg.replace(/^-+/, "");
+		const nextArg = argv[i + 1];
+		if (nextArg === void 0 || nextArg.startsWith("-")) {
+			result[key] = true;
+			i++;
+		} else {
+			result[key] = coerceValue(nextArg);
+			i += 2;
+		}
+	}
+	return result;
+}
+/**
+* Coerce string value to appropriate type
+*/
+function coerceValue(value) {
+	if (value === "true") return true;
+	if (value === "false") return false;
+	const num = Number(value);
+	if (!Number.isNaN(num) && value.trim() !== "") return num;
+	return value;
+}
+/**
+* Check if --help or -h was requested
+*/
+function isHelpRequested(argv) {
+	return argv.includes("--help") || argv.includes("-h");
+}
+/**
+* Check if --version or -v was requested
+*/
+function isVersionRequested(argv) {
+	return argv.includes("--version") || argv.includes("-v");
+}
+/**
+* Parse subcommand from argv
+*/
+function parseSubcommand(argv) {
+	const firstNonFlag = argv.findIndex((arg) => !arg.startsWith("-"));
+	if (firstNonFlag === -1) return {
+		subcommand: null,
+		args: argv
+	};
+	return {
+		subcommand: argv[firstNonFlag],
+		args: [...argv.slice(0, firstNonFlag), ...argv.slice(firstNonFlag + 1)]
+	};
+}
+/**
+* Generate help text for a single tool (used in multi-tools mode as subcommand help)
+*/
+function generateToolHelp(appName, tool) {
+	const lines = [];
+	lines.push(`${appName} ${tool.name}`);
+	lines.push("");
+	lines.push(tool.description ?? "No description");
+	lines.push("");
+	const jsonSchema = extractJsonSchema(tool.inputSchema);
+	const properties = jsonSchema ? extractProperties(jsonSchema) : [];
+	lines.push("Usage:");
+	if (properties.length > 0) lines.push(generateUsage(`bun run <file>.ts ${tool.name}`, properties));
+	else lines.push(`  bun run <file>.ts ${tool.name} [options]`);
+	lines.push("");
+	if (properties.length > 0) {
+		lines.push("Options:");
+		for (const prop of properties) lines.push(formatOptionLine(prop));
+		lines.push("");
+	}
+	lines.push("Flags:");
+	lines.push("  --help, -h               Show this help message");
+	return lines.join("\n");
+}
+/**
+* Generate help text for single tool app (no subcommand needed)
+*/
+function generateSingleToolHelp(config, tool) {
+	const lines = [];
+	lines.push(`${config.name} v${config.version}`);
+	lines.push("");
+	lines.push(config.description);
+	lines.push("");
+	const jsonSchema = extractJsonSchema(tool.inputSchema);
+	const properties = jsonSchema ? extractProperties(jsonSchema) : [];
+	lines.push("Usage:");
+	if (properties.length > 0) lines.push(generateUsage("bun run <file>.ts", properties));
+	else lines.push("  bun run <file>.ts [options]");
+	lines.push("");
+	if (properties.length > 0) {
+		lines.push("Options:");
+		for (const prop of properties) lines.push(formatOptionLine(prop));
+		lines.push("");
+	}
+	lines.push("Flags:");
+	lines.push("  --help, -h               Show this help message");
+	lines.push("  --version, -v            Show version");
+	return lines.join("\n");
+}
+/**
+* Generate help text from app config
+*/
+function generateMultiToolsHelp(config) {
+	const lines = [];
+	lines.push(`${config.name} v${config.version}`);
+	lines.push("");
+	lines.push(config.description);
+	lines.push("");
+	lines.push("Usage:");
+	lines.push("  bun run <file>.ts <command> [options]");
+	lines.push("");
+	lines.push("Commands:");
+	for (const tool of config.tools) {
+		const desc = tool.description ?? "";
+		lines.push(`  ${tool.name.padEnd(15)} ${desc}`);
+	}
+	lines.push("");
+	lines.push("Flags:");
+	lines.push("  --help, -h               Show this help message");
+	lines.push("  --version, -v            Show version");
+	lines.push("");
+	lines.push(`Run '${config.name} <command> --help' for more information.`);
+	return lines.join("\n");
+}
+/**
+* Get missing required fields from a schema based on provided args
+*/
+function getMissingRequiredFields(schema, providedArgs) {
+	const jsonSchema = extractJsonSchema(schema);
+	if (!jsonSchema) return [];
+	const properties = extractProperties(jsonSchema);
+	const missing = [];
+	for (const prop of properties) {
+		if (providedArgs[prop.name] !== void 0) continue;
+		if (!prop.required) continue;
+		let fieldType = "string";
+		if (prop.type === "number" || prop.type === "integer") fieldType = "number";
+		else if (prop.type === "boolean") fieldType = "boolean";
+		else if (prop.enum && prop.enum.length > 0) fieldType = "enum";
+		missing.push({
+			name: prop.name,
+			label: prop.description || prop.name,
+			type: fieldType,
+			required: true,
+			defaultValue: prop.default,
+			description: prop.description,
+			enumValues: prop.enum?.map(String)
+		});
+	}
+	return missing;
+}
+
+//#endregion
+export { generateMultiToolsHelp, generateSingleToolHelp, generateToolHelp, getMissingRequiredFields, isHelpRequested, isVersionRequested, parseCliArgs, parseSubcommand };
+//# sourceMappingURL=cli.mjs.map

package/dist/cli.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.mjs","names":["result: ParsedArgs","key","lines: string[]","missing: SchemaInputField[]","fieldType: SchemaInputField[\"type\"]"],"sources":["../src/cli.ts"],"sourcesContent":["import type { AnyTool, AppDefinition, StandardSchemaV1 } from \"./types\";\n\n/**\n * Parsed CLI arguments as key-value pairs\n */\nexport type ParsedArgs = Record<string, string | number | boolean>;\n\n/**\n * JSON Schema property info\n */\ninterface PropertyInfo {\n  name: string;\n  type: string;\n  description?: string;\n  default?: unknown;\n  enum?: unknown[];\n  required: boolean;\n}\n\n/**\n * Extract JSON Schema from a Standard Schema if available\n */\nfunction extractJsonSchema(\n  schema: StandardSchemaV1,\n): Record<string, unknown> | null {\n  const standard = schema[\"~standard\"] as unknown as Record<string, unknown>;\n  if (\"jsonSchema\" in standard && standard.jsonSchema) {\n    const jsonSchema = standard.jsonSchema as {\n      output: (opts: { target: string }) => Record<string, unknown>;\n    };\n    try {\n      return jsonSchema.output({ target: \"draft-07\" });\n    } catch {\n      return null;\n    }\n  }\n  return null;\n}\n\n/**\n * Extract property info from JSON Schema\n */\nfunction extractProperties(\n  jsonSchema: Record<string, unknown>,\n): PropertyInfo[] {\n  const properties = (jsonSchema.properties ?? {}) as Record<\n    string,\n    Record<string, unknown>\n  >;\n  const required = (jsonSchema.required ?? []) as string[];\n\n  return Object.entries(properties).map(([name, prop]) => {\n    let type = (prop.type as string) ?? \"unknown\";\n\n    // Handle enum\n    if (prop.enum) {\n      type = (prop.enum as unknown[]).join(\" | \");\n    }\n\n    return {\n      name,\n      type,\n      description: prop.description as string | undefined,\n      default: prop.default,\n      enum: prop.enum as unknown[] | undefined,\n      required: required.includes(name) && prop.default === undefined,\n    };\n  });\n}\n\n/**\n * Format a single option line for help text\n */\nfunction formatOptionLine(prop: PropertyInfo): string {\n  const flag = `--${prop.name}`;\n  const typeHint = prop.type !== \"boolean\" ? `=<${prop.type}>` : \"\";\n  const flagPart = `${flag}${typeHint}`.padEnd(25);\n\n  let descPart = prop.description ?? \"\";\n\n  // Add default value hint\n  if (prop.default !== undefined) {\n    descPart += ` (default: ${JSON.stringify(prop.default)})`;\n  }\n\n  // Add required hint\n  if (prop.required) {\n    descPart += \" [required]\";\n  }\n\n  return `  ${flagPart} ${descPart}`;\n}\n\n/**\n * Generate usage string with required args\n */\nfunction generateUsage(command: string, properties: PropertyInfo[]): string {\n  const requiredArgs = properties\n    .filter((p) => p.required)\n    .map((p) => `--${p.name}=<${p.type}>`)\n    .join(\" \");\n\n  const optionalHint = properties.some((p) => !p.required) ? \" [options]\" : \"\";\n\n  return `  ${command} ${requiredArgs}${optionalHint}`.trim();\n}\n\n/**\n * Parse command line arguments into an object\n */\nexport function parseCliArgs(argv: string[]): ParsedArgs {\n  const result: ParsedArgs = {};\n  let i = 0;\n\n  while (i < argv.length) {\n    const arg = argv[i]!;\n\n    // Skip non-flag arguments (positional)\n    if (!arg.startsWith(\"-\")) {\n      i++;\n      continue;\n    }\n\n    // Handle --key=value format\n    if (arg.includes(\"=\")) {\n      const [key, ...valueParts] = arg.split(\"=\");\n      const cleanKey = key!.replace(/^-+/, \"\");\n      const value = valueParts.join(\"=\");\n      result[cleanKey] = coerceValue(value);\n      i++;\n      continue;\n    }\n\n    // Handle --no-flag format (boolean false)\n    if (arg.startsWith(\"--no-\")) {\n      const key = arg.slice(5);\n      result[key] = false;\n      i++;\n      continue;\n    }\n\n    // Handle --flag or --key value format\n    const key = arg.replace(/^-+/, \"\");\n    const nextArg = argv[i + 1];\n\n    // Check if next arg is a value or another flag\n    if (nextArg === undefined || nextArg.startsWith(\"-\")) {\n      // It's a boolean flag\n      result[key] = true;\n      i++;\n    } else {\n      // It's a key-value pair\n      result[key] = coerceValue(nextArg);\n      i += 2;\n    }\n  }\n\n  return result;\n}\n\n/**\n * Coerce string value to appropriate type\n */\nfunction coerceValue(value: string): string | number | boolean {\n  // Boolean\n  if (value === \"true\") return true;\n  if (value === \"false\") return false;\n\n  // Number\n  const num = Number(value);\n  if (!Number.isNaN(num) && value.trim() !== \"\") {\n    return num;\n  }\n\n  // String\n  return value;\n}\n\n/**\n * Check if --help or -h was requested\n */\nexport function isHelpRequested(argv: string[]): boolean {\n  return argv.includes(\"--help\") || argv.includes(\"-h\");\n}\n\n/**\n * Check if --version or -v was requested\n */\nexport function isVersionRequested(argv: string[]): boolean {\n  return argv.includes(\"--version\") || argv.includes(\"-v\");\n}\n\n/**\n * Parse subcommand from argv\n */\nexport function parseSubcommand(argv: string[]): {\n  subcommand: string | null;\n  args: string[];\n} {\n  const firstNonFlag = argv.findIndex((arg) => !arg.startsWith(\"-\"));\n\n  if (firstNonFlag === -1) {\n    return { subcommand: null, args: argv };\n  }\n\n  return {\n    subcommand: argv[firstNonFlag]!,\n    args: [...argv.slice(0, firstNonFlag), ...argv.slice(firstNonFlag + 1)],\n  };\n}\n\n/**\n * Generate help text for a single tool (used in multi-tools mode as subcommand help)\n */\nexport function generateToolHelp(appName: string, tool: AnyTool): string {\n  const lines: string[] = [];\n\n  // Header\n  lines.push(`${appName} ${tool.name}`);\n  lines.push(\"\");\n  lines.push(tool.description ?? \"No description\");\n  lines.push(\"\");\n\n  // Try to extract JSON Schema for dynamic help\n  const jsonSchema = extractJsonSchema(tool.inputSchema);\n  const properties = jsonSchema ? extractProperties(jsonSchema) : [];\n\n  // Usage\n  lines.push(\"Usage:\");\n  if (properties.length > 0) {\n    lines.push(generateUsage(`bun run <file>.ts ${tool.name}`, properties));\n  } else {\n    lines.push(`  bun run <file>.ts ${tool.name} [options]`);\n  }\n  lines.push(\"\");\n\n  // Options from schema\n  if (properties.length > 0) {\n    lines.push(\"Options:\");\n    for (const prop of properties) {\n      lines.push(formatOptionLine(prop));\n    }\n    lines.push(\"\");\n  }\n\n  // Built-in options\n  lines.push(\"Flags:\");\n  lines.push(\"  --help, -h               Show this help message\");\n\n  return lines.join(\"\\n\");\n}\n\n/**\n * Generate help text for single tool app (no subcommand needed)\n */\nexport function generateSingleToolHelp(\n  config: AppDefinition,\n  tool: AnyTool,\n): string {\n  const lines: string[] = [];\n\n  // Header\n  lines.push(`${config.name} v${config.version}`);\n  lines.push(\"\");\n  lines.push(config.description);\n  lines.push(\"\");\n\n  // Try to extract JSON Schema for dynamic help\n  const jsonSchema = extractJsonSchema(tool.inputSchema);\n  const properties = jsonSchema ? extractProperties(jsonSchema) : [];\n\n  // Usage\n  lines.push(\"Usage:\");\n  if (properties.length > 0) {\n    lines.push(generateUsage(\"bun run <file>.ts\", properties));\n  } else {\n    lines.push(\"  bun run <file>.ts [options]\");\n  }\n  lines.push(\"\");\n\n  // Options from schema\n  if (properties.length > 0) {\n    lines.push(\"Options:\");\n    for (const prop of properties) {\n      lines.push(formatOptionLine(prop));\n    }\n    lines.push(\"\");\n  }\n\n  // Built-in options\n  lines.push(\"Flags:\");\n  lines.push(\"  --help, -h               Show this help message\");\n  lines.push(\"  --version, -v            Show version\");\n\n  return lines.join(\"\\n\");\n}\n\n/**\n * Generate help text from app config\n */\nexport function generateMultiToolsHelp(config: AppDefinition): string {\n  const lines: string[] = [];\n\n  // Header\n  lines.push(`${config.name} v${config.version}`);\n  lines.push(\"\");\n  lines.push(config.description);\n  lines.push(\"\");\n\n  // Usage\n  lines.push(\"Usage:\");\n  lines.push(\"  bun run <file>.ts <command> [options]\");\n  lines.push(\"\");\n\n  // Commands\n  lines.push(\"Commands:\");\n  for (const tool of config.tools) {\n    const desc = tool.description ?? \"\";\n    lines.push(`  ${tool.name.padEnd(15)} ${desc}`);\n  }\n  lines.push(\"\");\n\n  // Flags\n  lines.push(\"Flags:\");\n  lines.push(\"  --help, -h               Show this help message\");\n  lines.push(\"  --version, -v            Show version\");\n  lines.push(\"\");\n  lines.push(`Run '${config.name} <command> --help' for more information.`);\n\n  return lines.join(\"\\n\");\n}\n\n/**\n * Input field for interactive prompts (duplicated to avoid circular deps)\n */\ninterface SchemaInputField {\n  name: string;\n  label: string;\n  type: \"string\" | \"number\" | \"boolean\" | \"enum\";\n  required: boolean;\n  defaultValue?: unknown;\n  description?: string;\n  enumValues?: string[];\n  min?: number;\n  max?: number;\n}\n\n/**\n * Get missing required fields from a schema based on provided args\n */\nexport function getMissingRequiredFields(\n  schema: StandardSchemaV1,\n  providedArgs: Record<string, unknown>,\n): SchemaInputField[] {\n  const jsonSchema = extractJsonSchema(schema);\n  if (!jsonSchema) return [];\n\n  const properties = extractProperties(jsonSchema);\n  const missing: SchemaInputField[] = [];\n\n  for (const prop of properties) {\n    // Skip if already provided\n    if (providedArgs[prop.name] !== undefined) continue;\n\n    // Skip if not required (has default or optional)\n    if (!prop.required) continue;\n\n    // Convert to input field\n    let fieldType: SchemaInputField[\"type\"] = \"string\";\n    if (prop.type === \"number\" || prop.type === \"integer\") {\n      fieldType = \"number\";\n    } else if (prop.type === \"boolean\") {\n      fieldType = \"boolean\";\n    } else if (prop.enum && prop.enum.length > 0) {\n      fieldType = \"enum\";\n    }\n\n    missing.push({\n      name: prop.name,\n      label: prop.description || prop.name,\n      type: fieldType,\n      required: true,\n      defaultValue: prop.default,\n      description: prop.description,\n      enumValues: prop.enum?.map(String),\n    });\n  }\n\n  return missing;\n}\n"],"mappings":"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"}

package/dist/define-app.d.mts

@@ -0,0 +1,33 @@
+import { AnyTool, AppDefinition, KlyApp } from "./types.mjs";
+
+//#region src/define-app.d.ts
+
+/**
+ * Define a Kly app with tools
+ *
+ * @example
+ * ```typescript
+ * import { defineApp, tool } from "kly"
+ * import { z } from "zod"
+ *
+ * const helloTool = tool({
+ *   name: "hello",
+ *   description: "Say hello",
+ *   inputSchema: z.object({ name: z.string() }),
+ *   execute: async ({ name }) => `Hello, ${name}!`,
+ * })
+ *
+ * defineApp({
+ *   name: "my-app",
+ *   version: "0.1.0",
+ *   description: "My CLI app",
+ *   tools: [helloTool],
+ * })
+ * // CLI: `my-app hello --name=World`
+ * // MCP: exposes tool as my-app_hello
+ * ```
+ */
+declare function defineApp<TTools extends AnyTool[]>(definition: AppDefinition<TTools>): KlyApp<TTools>;
+//#endregion
+export { defineApp };
+//# sourceMappingURL=define-app.d.mts.map

package/dist/define-app.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-app.d.mts","names":[],"sources":["../src/define-app.ts"],"sourcesContent":[],"mappings":";;;;;;AAuDA;;;;;;;;;;;;;;;;;;;;;;;iBAAgB,yBAAyB,uBAC3B,cAAc,UACzB,OAAO"}

package/dist/define-app.mjs

@@ -0,0 +1,183 @@
+import { detectMode, isSandbox } from "./shared/runtime-mode.mjs";
+import { isTTY } from "./ui/utils/tty.mjs";
+import { form } from "./ui/components/form.mjs";
+import { select } from "./ui/components/select.mjs";
+import { error, output } from "./ui/utils/output.mjs";
+import { createModelsContext } from "./ai/context.mjs";
+import { generateMultiToolsHelp, generateSingleToolHelp, generateToolHelp, getMissingRequiredFields, isHelpRequested, isVersionRequested, parseCliArgs, parseSubcommand } from "./cli.mjs";
+import { ValidationError } from "./types.mjs";
+
+//#region src/define-app.ts
+/**
+* Get the appropriate models context based on runtime environment
+*/
+async function _getModelsContext() {
+	if (isSandbox()) return (await import("./sandbox/sandboxed-context.mjs")).getSandboxedContext().modelsContext;
+	return createModelsContext();
+}
+/**
+* Define a Kly app with tools
+*
+* @example
+* ```typescript
+* import { defineApp, tool } from "kly"
+* import { z } from "zod"
+*
+* const helloTool = tool({
+*   name: "hello",
+*   description: "Say hello",
+*   inputSchema: z.object({ name: z.string() }),
+*   execute: async ({ name }) => `Hello, ${name}!`,
+* })
+*
+* defineApp({
+*   name: "my-app",
+*   version: "0.1.0",
+*   description: "My CLI app",
+*   tools: [helloTool],
+* })
+* // CLI: `my-app hello --name=World`
+* // MCP: exposes tool as my-app_hello
+* ```
+*/
+function defineApp(definition) {
+	const toolsMap = /* @__PURE__ */ new Map();
+	for (const tool of definition.tools) toolsMap.set(tool.name, tool);
+	const app = {
+		definition,
+		tools: toolsMap,
+		async execute(toolName, providedArgs) {
+			const mode$1 = detectMode();
+			const tool = toolsMap.get(toolName);
+			if (!tool) {
+				const available = Array.from(toolsMap.keys()).join(", ");
+				throw new Error(`Unknown tool: ${toolName}. Available tools: ${available}`);
+			}
+			const result = await tool.inputSchema["~standard"].validate(providedArgs ?? {});
+			if (result.issues) throw new ValidationError(result.issues);
+			return await tool.execute(result.value, {
+				mode: mode$1,
+				models: await _getModelsContext()
+			});
+		}
+	};
+	const mode = detectMode();
+	if (mode === "cli") runCli(app, definition).catch((err) => {
+		console.error("Fatal error:", err.message);
+		process.exit(1);
+	});
+	else if (mode === "mcp") import("./mcp/index.mjs").then(({ startMcpServer }) => {
+		startMcpServer(app).catch((err) => {
+			console.error("MCP server error:", err.message);
+			process.exit(1);
+		});
+	});
+	return app;
+}
+/**
+* Run app in CLI mode
+*/
+async function runCli(app, definition) {
+	const argv = process.argv.slice(2);
+	const isSingleTool = definition.tools.length === 1;
+	if (isHelpRequested(argv)) {
+		if (isSingleTool) console.log(generateSingleToolHelp(definition, definition.tools[0]));
+		else {
+			const { subcommand } = parseSubcommand(argv);
+			if (subcommand) {
+				const tool = app.tools.get(subcommand);
+				if (tool) console.log(generateToolHelp(definition.name, tool));
+				else console.log(generateMultiToolsHelp(definition));
+			} else console.log(generateMultiToolsHelp(definition));
+		}
+		return;
+	}
+	if (isVersionRequested(argv)) {
+		console.log(`${definition.name} v${definition.version}`);
+		return;
+	}
+	if (isSingleTool) await runSingleToolCli(app, definition);
+	else await runMultiToolsCli(app, definition);
+	process.exit(0);
+}
+/**
+* Run single tool app in CLI mode (no subcommand needed)
+*/
+async function runSingleToolCli(app, definition) {
+	const argv = process.argv.slice(2);
+	const tool = definition.tools[0];
+	const interactive = isTTY();
+	let parsedArgs = parseCliArgs(argv);
+	if (interactive) {
+		const missingFields = getMissingRequiredFields(tool.inputSchema, parsedArgs);
+		if (missingFields.length > 0) {
+			const additionalArgs = await form({ fields: missingFields });
+			parsedArgs = {
+				...parsedArgs,
+				...additionalArgs
+			};
+		}
+	}
+	try {
+		const result = await app.execute(tool.name, parsedArgs);
+		if (result !== void 0) output(result);
+	} catch (err) {
+		if (err instanceof ValidationError) {
+			error(err.message, [`Run with --help for usage information.`]);
+			process.exit(1);
+		}
+		throw err;
+	}
+}
+/**
+* Run multi tools app in CLI mode (with subcommands)
+*/
+async function runMultiToolsCli(app, definition) {
+	const argv = process.argv.slice(2);
+	let { subcommand } = parseSubcommand(argv);
+	const interactive = isTTY();
+	const { args: restArgs } = parseSubcommand(argv);
+	if (!subcommand) if (interactive) subcommand = await select({
+		options: definition.tools.map((t) => ({
+			name: t.name,
+			description: t.description,
+			value: t.name
+		})),
+		prompt: `${definition.name} - Select a command`
+	});
+	else {
+		error("No subcommand provided.", [`Available commands: ${definition.tools.map((t) => t.name).join(", ")}`, `Run '${definition.name} --help' for usage.`]);
+		process.exit(1);
+	}
+	const selectedCommand = subcommand;
+	const tool = app.tools.get(selectedCommand);
+	if (!tool) {
+		error(`Unknown command '${selectedCommand}'.`, [`Available commands: ${definition.tools.map((t) => t.name).join(", ")}`, `Run '${definition.name} --help' for usage.`]);
+		process.exit(1);
+	}
+	let parsedArgs = parseCliArgs(restArgs);
+	if (interactive) {
+		const missingFields = getMissingRequiredFields(tool.inputSchema, parsedArgs);
+		if (missingFields.length > 0) {
+			const additionalArgs = await form({ fields: missingFields });
+			parsedArgs = {
+				...parsedArgs,
+				...additionalArgs
+			};
+		}
+	}
+	try {
+		const result = await app.execute(selectedCommand, parsedArgs);
+		if (result !== void 0) output(result);
+	} catch (err) {
+		if (err instanceof ValidationError) {
+			error(err.message, [`Run '${definition.name} ${selectedCommand} --help' for usage.`]);
+			process.exit(1);
+		}
+		throw err;
+	}
+}
+
+//#endregion
+export { defineApp };
+//# sourceMappingURL=define-app.mjs.map

package/dist/define-app.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-app.mjs","names":["app: KlyApp<TTools>","mode"],"sources":["../src/define-app.ts"],"sourcesContent":["import { createModelsContext } from \"./ai/context\";\nimport {\n  generateMultiToolsHelp,\n  generateSingleToolHelp,\n  generateToolHelp,\n  getMissingRequiredFields,\n  isHelpRequested,\n  isVersionRequested,\n  parseCliArgs,\n  parseSubcommand,\n} from \"./cli\";\nimport { detectMode, isSandbox } from \"./shared/runtime-mode\";\nimport type { AnyTool, AppDefinition, KlyApp } from \"./types\";\nimport { ValidationError } from \"./types\";\nimport { error, form, isTTY, output, select } from \"./ui\";\n\n/**\n * Get the appropriate models context based on runtime environment\n */\nasync function _getModelsContext() {\n  if (isSandbox()) {\n    // In sandbox: use IPC-based context\n    // Dynamic import for runtime-specific module loading\n    const m = await import(\"./sandbox/sandboxed-context\");\n    return m.getSandboxedContext().modelsContext;\n  }\n  // Outside sandbox: use direct file access\n  return createModelsContext();\n}\n\n/**\n * Define a Kly app with tools\n *\n * @example\n * ```typescript\n * import { defineApp, tool } from \"kly\"\n * import { z } from \"zod\"\n *\n * const helloTool = tool({\n *   name: \"hello\",\n *   description: \"Say hello\",\n *   inputSchema: z.object({ name: z.string() }),\n *   execute: async ({ name }) => `Hello, ${name}!`,\n * })\n *\n * defineApp({\n *   name: \"my-app\",\n *   version: \"0.1.0\",\n *   description: \"My CLI app\",\n *   tools: [helloTool],\n * })\n * // CLI: `my-app hello --name=World`\n * // MCP: exposes tool as my-app_hello\n * ```\n */\nexport function defineApp<TTools extends AnyTool[]>(\n  definition: AppDefinition<TTools>,\n): KlyApp<TTools> {\n  // Build tools map\n  const toolsMap = new Map<string, AnyTool>();\n  for (const tool of definition.tools) {\n    toolsMap.set(tool.name, tool);\n  }\n\n  const app: KlyApp<TTools> = {\n    definition,\n    tools: toolsMap,\n\n    async execute(\n      toolName: string,\n      providedArgs?: Record<string, unknown>,\n    ): Promise<unknown> {\n      const mode = detectMode();\n      const tool = toolsMap.get(toolName);\n\n      if (!tool) {\n        const available = Array.from(toolsMap.keys()).join(\", \");\n        throw new Error(\n          `Unknown tool: ${toolName}. Available tools: ${available}`,\n        );\n      }\n\n      // Validate with schema\n      const result = await tool.inputSchema[\"~standard\"].validate(\n        providedArgs ?? {},\n      );\n\n      if (result.issues) {\n        throw new ValidationError(result.issues);\n      }\n\n      // Execute with appropriate context (sandboxed or direct)\n      const execResult = await tool.execute(result.value, {\n        mode,\n        models: await _getModelsContext(),\n      });\n      return execResult;\n    },\n  };\n\n  // Auto-run based on mode\n  const mode = detectMode();\n  if (mode === \"cli\") {\n    runCli(app, definition).catch((err) => {\n      console.error(\"Fatal error:\", err.message);\n      process.exit(1);\n    });\n  } else if (mode === \"mcp\") {\n    // Dynamically import MCP server to avoid bundling it in CLI mode\n    import(\"./mcp\").then(({ startMcpServer }) => {\n      startMcpServer(app).catch((err) => {\n        console.error(\"MCP server error:\", err.message);\n        process.exit(1);\n      });\n    });\n  }\n\n  return app;\n}\n\n/**\n * Run app in CLI mode\n */\nasync function runCli<TTools extends AnyTool[]>(\n  app: KlyApp<TTools>,\n  definition: AppDefinition<TTools>,\n): Promise<void> {\n  const argv = process.argv.slice(2);\n  const isSingleTool = definition.tools.length === 1;\n\n  // Handle --help and --version without TUI\n  if (isHelpRequested(argv)) {\n    if (isSingleTool) {\n      console.log(generateSingleToolHelp(definition, definition.tools[0]!));\n    } else {\n      const { subcommand } = parseSubcommand(argv);\n      if (subcommand) {\n        const tool = app.tools.get(subcommand);\n        if (tool) {\n          console.log(generateToolHelp(definition.name, tool));\n        } else {\n          console.log(generateMultiToolsHelp(definition));\n        }\n      } else {\n        console.log(generateMultiToolsHelp(definition));\n      }\n    }\n    return;\n  }\n\n  if (isVersionRequested(argv)) {\n    console.log(`${definition.name} v${definition.version}`);\n    return;\n  }\n\n  // Run the appropriate CLI mode\n  if (isSingleTool) {\n    await runSingleToolCli(app, definition);\n  } else {\n    await runMultiToolsCli(app, definition);\n  }\n  // Clean exit\n  process.exit(0);\n}\n\n/**\n * Run single tool app in CLI mode (no subcommand needed)\n */\nasync function runSingleToolCli<TTools extends AnyTool[]>(\n  app: KlyApp<TTools>,\n  definition: AppDefinition<TTools>,\n): Promise<void> {\n  const argv = process.argv.slice(2);\n  const tool = definition.tools[0]!;\n  const interactive = isTTY();\n\n  // Parse args\n  let parsedArgs = parseCliArgs(argv) as Record<string, unknown>;\n\n  // Check for missing required fields and prompt if in TTY mode\n  // In sandbox mode, form() will use IPC to prompt in the host process\n  if (interactive) {\n    const missingFields = getMissingRequiredFields(\n      tool.inputSchema,\n      parsedArgs,\n    );\n\n    if (missingFields.length > 0) {\n      const additionalArgs = await form({ fields: missingFields });\n      parsedArgs = { ...parsedArgs, ...additionalArgs };\n    }\n  }\n\n  try {\n    const result = await app.execute(tool.name, parsedArgs);\n    if (result !== undefined) {\n      output(result);\n    }\n  } catch (err) {\n    if (err instanceof ValidationError) {\n      error(err.message, [`Run with --help for usage information.`]);\n      process.exit(1);\n    }\n    throw err;\n  }\n}\n\n/**\n * Run multi tools app in CLI mode (with subcommands)\n */\nasync function runMultiToolsCli<TTools extends AnyTool[]>(\n  app: KlyApp<TTools>,\n  definition: AppDefinition<TTools>,\n): Promise<void> {\n  const argv = process.argv.slice(2);\n  let { subcommand } = parseSubcommand(argv);\n  const interactive = isTTY();\n\n  // Get rest args (subcommand already parsed above)\n  const { args: restArgs } = parseSubcommand(argv);\n\n  // Interactive tool selection if no subcommand and in TTY mode\n  // In sandbox mode, select() will use IPC to prompt in the host process\n  if (!subcommand) {\n    if (interactive) {\n      // Show interactive menu to select a tool\n      const toolOptions = definition.tools.map((t) => ({\n        name: t.name,\n        description: t.description,\n        value: t.name,\n      }));\n      subcommand = await select({\n        options: toolOptions,\n        prompt: `${definition.name} - Select a command`,\n      });\n    } else {\n      error(\"No subcommand provided.\", [\n        `Available commands: ${definition.tools.map((t) => t.name).join(\", \")}`,\n        `Run '${definition.name} --help' for usage.`,\n      ]);\n      process.exit(1);\n    }\n  }\n\n  // At this point subcommand is guaranteed to be a string\n  const selectedCommand = subcommand as string;\n\n  const tool = app.tools.get(selectedCommand);\n  if (!tool) {\n    error(`Unknown command '${selectedCommand}'.`, [\n      `Available commands: ${definition.tools.map((t) => t.name).join(\", \")}`,\n      `Run '${definition.name} --help' for usage.`,\n    ]);\n    process.exit(1);\n  }\n\n  // Parse args\n  let parsedArgs = parseCliArgs(restArgs) as Record<string, unknown>;\n\n  // Check for missing required fields and prompt if in TTY mode\n  // In sandbox mode, form() will use IPC to prompt in the host process\n  if (interactive) {\n    const missingFields = getMissingRequiredFields(\n      tool.inputSchema,\n      parsedArgs,\n    );\n\n    if (missingFields.length > 0) {\n      const additionalArgs = await form({ fields: missingFields });\n      parsedArgs = { ...parsedArgs, ...additionalArgs };\n    }\n  }\n\n  try {\n    const result = await app.execute(selectedCommand, parsedArgs);\n    if (result !== undefined) {\n      output(result);\n    }\n  } catch (err) {\n    if (err instanceof ValidationError) {\n      error(err.message, [\n        `Run '${definition.name} ${selectedCommand} --help' for usage.`,\n      ]);\n      process.exit(1);\n    }\n    throw err;\n  }\n}\n"],"mappings":"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"}

package/dist/index.d.mts

@@ -0,0 +1,16 @@
+import { AnyTool, AppDefinition, AppPermissions, ExecuteContext, InferOutput, KlyApp, ModelConfig, ModelInfo, ModelsContext, RuntimeMode, StandardSchemaV1, Tool, ToolDefinition, ValidationError } from "./types.mjs";
+import { defineApp } from "./define-app.mjs";
+import { JsonSchema } from "./mcp/schema-converter.mjs";
+import { startMcpServer } from "./mcp/server.mjs";
+import { tool } from "./tool.mjs";
+import { confirm } from "./ui/components/confirm.mjs";
+import { FormConfig, FormField, form } from "./ui/components/form.mjs";
+import { InputConfig, input } from "./ui/components/input.mjs";
+import { SelectOption, select } from "./ui/components/select.mjs";
+import { SpinnerHandle, spinner } from "./ui/components/spinner.mjs";
+import { ColumnAlign, TableColumn, TableConfig, table } from "./ui/components/table.mjs";
+import { formatText, pc, theme } from "./ui/utils/colors.mjs";
+import { error, help, output } from "./ui/utils/output.mjs";
+import { isTTY } from "./ui/utils/tty.mjs";
+import "./ui/index.mjs";
+export { type AnyTool, type AppDefinition, type AppPermissions, type ColumnAlign, type ExecuteContext, type FormConfig, type FormField, type InferOutput, type InputConfig, type JsonSchema, type KlyApp, type ModelConfig, type ModelInfo, type ModelsContext, type RuntimeMode, type SelectOption, type SpinnerHandle, type StandardSchemaV1, type TableColumn, type TableConfig, type Tool, type ToolDefinition, ValidationError, pc as color, confirm, defineApp, error, form, formatText, help, input, isTTY, output, select, spinner, startMcpServer, table, theme, tool };

package/dist/index.mjs

@@ -0,0 +1,15 @@
+import { isTTY } from "./ui/utils/tty.mjs";
+import { confirm } from "./ui/components/confirm.mjs";
+import { form } from "./ui/components/form.mjs";
+import { input } from "./ui/components/input.mjs";
+import { select } from "./ui/components/select.mjs";
+import { spinner } from "./ui/components/spinner.mjs";
+import { formatText, pc, theme } from "./ui/utils/colors.mjs";
+import { table } from "./ui/components/table.mjs";
+import { error, help, output } from "./ui/utils/output.mjs";
+import { ValidationError } from "./types.mjs";
+import { defineApp } from "./define-app.mjs";
+import { startMcpServer } from "./mcp/server.mjs";
+import { tool } from "./tool.mjs";
+
+export { ValidationError, pc as color, confirm, defineApp, error, form, formatText, help, input, isTTY, output, select, spinner, startMcpServer, table, theme, tool };

package/dist/mcp/index.mjs

@@ -0,0 +1,4 @@
+import { convertToJsonSchema } from "./schema-converter.mjs";
+import { startMcpServer } from "./server.mjs";
+
+export { startMcpServer };

package/dist/mcp/schema-converter.d.mts

@@ -0,0 +1,13 @@
+//#region src/mcp/schema-converter.d.ts
+/**
+ * JSON Schema for MCP tool inputs
+ */
+interface JsonSchema {
+  type: string;
+  properties?: Record<string, unknown>;
+  required?: string[];
+  [key: string]: unknown;
+}
+//#endregion
+export { JsonSchema };
+//# sourceMappingURL=schema-converter.d.mts.map

package/dist/mcp/schema-converter.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-converter.d.mts","names":[],"sources":["../../src/mcp/schema-converter.ts"],"sourcesContent":[],"mappings":";AAMA;;;UAAiB,UAAA;;eAEF"}

package/dist/mcp/schema-converter.mjs

@@ -0,0 +1,30 @@
+import * as z from "zod";
+
+//#region src/mcp/schema-converter.ts
+/**
+* Convert StandardSchema to JSON Schema for MCP
+*
+* Currently supports Zod schemas (v4+).
+* For other schema libraries (Valibot, ArkType, etc.), add conversion logic here.
+*/
+function convertToJsonSchema(schema) {
+	const zodSchema = schema;
+	if (zodSchema._def) {
+		const { $schema, ...rest } = z.toJSONSchema(zodSchema, {
+			target: "draft-07",
+			unrepresentable: "any",
+			io: "output"
+		});
+		return rest;
+	}
+	console.warn("Unknown schema type - using fallback conversion. Consider adding explicit support for your schema library.");
+	return {
+		type: "object",
+		properties: {},
+		required: []
+	};
+}
+
+//#endregion
+export { convertToJsonSchema };
+//# sourceMappingURL=schema-converter.mjs.map

package/dist/mcp/schema-converter.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-converter.mjs","names":[],"sources":["../../src/mcp/schema-converter.ts"],"sourcesContent":["import * as z from \"zod\";\nimport type { StandardSchemaV1 } from \"../types\";\n\n/**\n * JSON Schema for MCP tool inputs\n */\nexport interface JsonSchema {\n  type: string;\n  properties?: Record<string, unknown>;\n  required?: string[];\n  [key: string]: unknown;\n}\n\n/**\n * Convert StandardSchema to JSON Schema for MCP\n *\n * Currently supports Zod schemas (v4+).\n * For other schema libraries (Valibot, ArkType, etc.), add conversion logic here.\n */\nexport function convertToJsonSchema(schema: StandardSchemaV1): JsonSchema {\n  // Check if it's a Zod schema by looking for _def property\n  const zodSchema = schema as any;\n\n  if (zodSchema._def) {\n    // It's a Zod 4+ schema - use z.toJSONSchema() function\n    const jsonSchema = z.toJSONSchema(zodSchema as z.ZodType, {\n      target: \"draft-07\",\n      unrepresentable: \"any\",\n      io: \"output\",\n    });\n\n    // Remove $schema property if present (MCP doesn't need it)\n    const { $schema, ...rest } = jsonSchema as Record<string, unknown>;\n\n    return rest as JsonSchema;\n  }\n\n  // For other StandardSchema implementations, try to extract schema info\n  // This is a fallback that creates a basic JSON schema\n  console.warn(\n    \"Unknown schema type - using fallback conversion. Consider adding explicit support for your schema library.\",\n  );\n\n  return {\n    type: \"object\",\n    properties: {},\n    required: [],\n  };\n}\n"],"mappings":";;;;;;;;;AAmBA,SAAgB,oBAAoB,QAAsC;CAExE,MAAM,YAAY;AAElB,KAAI,UAAU,MAAM;EASlB,MAAM,EAAE,SAAS,GAAG,SAPD,EAAE,aAAa,WAAwB;GACxD,QAAQ;GACR,iBAAiB;GACjB,IAAI;GACL,CAAC;AAKF,SAAO;;AAKT,SAAQ,KACN,6GACD;AAED,QAAO;EACL,MAAM;EACN,YAAY,EAAE;EACd,UAAU,EAAE;EACb"}

package/dist/mcp/server.d.mts

@@ -0,0 +1,33 @@
+import { KlyApp } from "../types.mjs";
+
+//#region src/mcp/server.d.ts
+
+/**
+ * Start an MCP server for a Kly app
+ *
+ * This makes all tools from the app available to Claude Desktop/Code via the MCP protocol.
+ *
+ * @param app - The Kly app instance returned by defineApp()
+ *
+ * @example
+ * ```typescript
+ * import { defineApp, tool, startMcpServer } from "kly"
+ * import { z } from "zod"
+ *
+ * const app = defineApp({
+ *   name: "my-app",
+ *   version: "1.0.0",
+ *   description: "My app",
+ *   tools: [myTool],
+ * })
+ *
+ * // In MCP mode, start the server
+ * if (process.env.KLY_MCP_MODE === "true") {
+ *   await startMcpServer(app)
+ * }
+ * ```
+ */
+declare function startMcpServer(app: KlyApp): Promise<void>;
+//#endregion
+export { startMcpServer };
+//# sourceMappingURL=server.d.mts.map

package/dist/mcp/server.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.mts","names":[],"sources":["../../src/mcp/server.ts"],"sourcesContent":[],"mappings":";;;;;;AAkCA;;;;;;;;;;;;;;;;;;;;;;;iBAAsB,cAAA,MAAoB,SAAS"}