kly 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 xinyao27 <https://github.com/xinyao27>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,11 @@
+# kly
+
+[![NPM version](https://img.shields.io/npm/v/kly?color=a1b858&label=)](https://www.npmjs.com/package/kly)
+
+```ts
+const a = 1
+```
+
+## License
+
+[MIT](./LICENSE) License © 2025 [xinyao27](https://github.com/xinyao27)

package/dist/ai/context.mjs

@@ -0,0 +1,79 @@
+import { checkApiKeyPermission, getAppIdentifier } from "../permissions/index.mjs";
+import { getCurrentModelConfig, listModels } from "./storage.mjs";
+
+//#region src/ai/context.ts
+/**
+* Create models context for ExecuteContext
+* Provides access to configured LLM models and their credentials (with permission checks)
+*/
+function createModelsContext() {
+	let permissionChecked = false;
+	let permissionGranted = false;
+	/**
+	* Check permission before allowing access to API keys
+	*/
+	async function ensurePermission() {
+		if (permissionChecked) {
+			if (!permissionGranted) throw new Error("Permission denied: This app does not have permission to access API keys.");
+			return;
+		}
+		permissionGranted = await checkApiKeyPermission(getAppIdentifier());
+		permissionChecked = true;
+		if (!permissionGranted) throw new Error("Permission denied: This app does not have permission to access API keys.");
+	}
+	return {
+		list() {
+			return listModels().map((m) => ({
+				name: m.name,
+				provider: m.config.provider,
+				model: m.config.model,
+				isCurrent: m.isCurrent
+			}));
+		},
+		getCurrent() {
+			const current = listModels().find((m) => m.isCurrent);
+			if (!current) return null;
+			return {
+				name: current.name,
+				provider: current.config.provider,
+				model: current.config.model,
+				isCurrent: true
+			};
+		},
+		get(name) {
+			const found = listModels().find((m) => m.name === name);
+			if (!found) return null;
+			return {
+				name: found.name,
+				provider: found.config.provider,
+				model: found.config.model,
+				isCurrent: found.isCurrent
+			};
+		},
+		async getConfigAsync(name) {
+			await ensurePermission();
+			if (name) {
+				const found = listModels().find((m) => m.name === name);
+				if (!found) return null;
+				return {
+					provider: found.config.provider,
+					model: found.config.model,
+					apiKey: found.config.apiKey,
+					baseURL: found.config.baseURL
+				};
+			}
+			const current = getCurrentModelConfig();
+			if (!current) return null;
+			return {
+				provider: current.provider,
+				model: current.model,
+				apiKey: current.apiKey,
+				baseURL: current.baseURL
+			};
+		}
+	};
+}
+
+//#endregion
+export { createModelsContext };
+//# sourceMappingURL=context.mjs.map

package/dist/ai/context.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.mjs","names":[],"sources":["../../src/ai/context.ts"],"sourcesContent":["import { checkApiKeyPermission, getAppIdentifier } from \"../permissions\";\nimport type { ModelConfig, ModelInfo, ModelsContext } from \"../types\";\nimport { getCurrentModelConfig, listModels } from \"./storage\";\n\n/**\n * Create models context for ExecuteContext\n * Provides access to configured LLM models and their credentials (with permission checks)\n */\nexport function createModelsContext(): ModelsContext {\n  // Track if permission has been checked in this process\n  let permissionChecked = false;\n  let permissionGranted = false;\n\n  /**\n   * Check permission before allowing access to API keys\n   */\n  async function ensurePermission(): Promise<void> {\n    if (permissionChecked) {\n      if (!permissionGranted) {\n        throw new Error(\n          \"Permission denied: This app does not have permission to access API keys.\",\n        );\n      }\n      return;\n    }\n\n    const appId = getAppIdentifier();\n    permissionGranted = await checkApiKeyPermission(appId);\n    permissionChecked = true;\n\n    if (!permissionGranted) {\n      throw new Error(\n        \"Permission denied: This app does not have permission to access API keys.\",\n      );\n    }\n  }\n\n  return {\n    list(): ModelInfo[] {\n      return listModels().map((m) => ({\n        name: m.name,\n        provider: m.config.provider,\n        model: m.config.model,\n        isCurrent: m.isCurrent,\n      }));\n    },\n\n    getCurrent(): ModelInfo | null {\n      const models = listModels();\n      const current = models.find((m) => m.isCurrent);\n      if (!current) return null;\n\n      return {\n        name: current.name,\n        provider: current.config.provider,\n        model: current.config.model,\n        isCurrent: true,\n      };\n    },\n\n    get(name: string): ModelInfo | null {\n      const models = listModels();\n      const found = models.find((m) => m.name === name);\n      if (!found) return null;\n\n      return {\n        name: found.name,\n        provider: found.config.provider,\n        model: found.config.model,\n        isCurrent: found.isCurrent,\n      };\n    },\n\n    async getConfigAsync(name?: string): Promise<ModelConfig | null> {\n      // Check permission first\n      await ensurePermission();\n\n      if (name) {\n        const models = listModels();\n        const found = models.find((m) => m.name === name);\n        if (!found) return null;\n\n        return {\n          provider: found.config.provider,\n          model: found.config.model,\n          apiKey: found.config.apiKey,\n          baseURL: found.config.baseURL,\n        };\n      }\n\n      const current = getCurrentModelConfig();\n      if (!current) return null;\n\n      return {\n        provider: current.provider,\n        model: current.model,\n        apiKey: current.apiKey,\n        baseURL: current.baseURL,\n      };\n    },\n  };\n}\n"],"mappings":";;;;;;;;AAQA,SAAgB,sBAAqC;CAEnD,IAAI,oBAAoB;CACxB,IAAI,oBAAoB;;;;CAKxB,eAAe,mBAAkC;AAC/C,MAAI,mBAAmB;AACrB,OAAI,CAAC,kBACH,OAAM,IAAI,MACR,2EACD;AAEH;;AAIF,sBAAoB,MAAM,sBADZ,kBAAkB,CACsB;AACtD,sBAAoB;AAEpB,MAAI,CAAC,kBACH,OAAM,IAAI,MACR,2EACD;;AAIL,QAAO;EACL,OAAoB;AAClB,UAAO,YAAY,CAAC,KAAK,OAAO;IAC9B,MAAM,EAAE;IACR,UAAU,EAAE,OAAO;IACnB,OAAO,EAAE,OAAO;IAChB,WAAW,EAAE;IACd,EAAE;;EAGL,aAA+B;GAE7B,MAAM,UADS,YAAY,CACJ,MAAM,MAAM,EAAE,UAAU;AAC/C,OAAI,CAAC,QAAS,QAAO;AAErB,UAAO;IACL,MAAM,QAAQ;IACd,UAAU,QAAQ,OAAO;IACzB,OAAO,QAAQ,OAAO;IACtB,WAAW;IACZ;;EAGH,IAAI,MAAgC;GAElC,MAAM,QADS,YAAY,CACN,MAAM,MAAM,EAAE,SAAS,KAAK;AACjD,OAAI,CAAC,MAAO,QAAO;AAEnB,UAAO;IACL,MAAM,MAAM;IACZ,UAAU,MAAM,OAAO;IACvB,OAAO,MAAM,OAAO;IACpB,WAAW,MAAM;IAClB;;EAGH,MAAM,eAAe,MAA4C;AAE/D,SAAM,kBAAkB;AAExB,OAAI,MAAM;IAER,MAAM,QADS,YAAY,CACN,MAAM,MAAM,EAAE,SAAS,KAAK;AACjD,QAAI,CAAC,MAAO,QAAO;AAEnB,WAAO;KACL,UAAU,MAAM,OAAO;KACvB,OAAO,MAAM,OAAO;KACpB,QAAQ,MAAM,OAAO;KACrB,SAAS,MAAM,OAAO;KACvB;;GAGH,MAAM,UAAU,uBAAuB;AACvC,OAAI,CAAC,QAAS,QAAO;AAErB,UAAO;IACL,UAAU,QAAQ;IAClB,OAAO,QAAQ;IACf,QAAQ,QAAQ;IAChB,SAAS,QAAQ;IAClB;;EAEJ"}

package/dist/ai/storage.mjs

@@ -0,0 +1,50 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+
+//#region src/ai/storage.ts
+const CONFIG_DIR = join(homedir(), ".kly");
+const CONFIG_FILE = join(CONFIG_DIR, "config.json");
+/**
+* Ensure config directory exists
+*/
+function ensureConfigDir() {
+	if (!existsSync(CONFIG_DIR)) mkdirSync(CONFIG_DIR, { recursive: true });
+}
+/**
+* Load configuration from ~/.kly/config.json
+*/
+function loadConfig() {
+	ensureConfigDir();
+	if (!existsSync(CONFIG_FILE)) return { models: {} };
+	try {
+		const content = readFileSync(CONFIG_FILE, "utf-8");
+		return JSON.parse(content);
+	} catch (error) {
+		console.error("Failed to parse config file:", error);
+		return { models: {} };
+	}
+}
+/**
+* Get current active model configuration
+*/
+function getCurrentModelConfig() {
+	const config = loadConfig();
+	if (!config.currentModel) return null;
+	return config.models[config.currentModel] || null;
+}
+/**
+* List all configured models
+*/
+function listModels() {
+	const config = loadConfig();
+	return Object.entries(config.models).map(([name, modelConfig]) => ({
+		name,
+		config: modelConfig,
+		isCurrent: name === config.currentModel
+	}));
+}
+
+//#endregion
+export { getCurrentModelConfig, listModels };
+//# sourceMappingURL=storage.mjs.map

package/dist/ai/storage.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.mjs","names":[],"sources":["../../src/ai/storage.ts"],"sourcesContent":["import { existsSync, mkdirSync, readFileSync, writeFileSync } from \"node:fs\";\nimport { homedir } from \"node:os\";\nimport { join } from \"node:path\";\nimport type { LLMConfig, LLMProvider } from \"./types\";\n\nconst CONFIG_DIR = join(homedir(), \".kly\");\nconst CONFIG_FILE = join(CONFIG_DIR, \"config.json\");\n\nexport interface KlyConfig {\n  currentModel?: string;\n  models: Record<string, LLMConfig>;\n}\n\n/**\n * Ensure config directory exists\n */\nfunction ensureConfigDir(): void {\n  if (!existsSync(CONFIG_DIR)) {\n    mkdirSync(CONFIG_DIR, { recursive: true });\n  }\n}\n\n/**\n * Load configuration from ~/.kly/config.json\n */\nexport function loadConfig(): KlyConfig {\n  ensureConfigDir();\n\n  if (!existsSync(CONFIG_FILE)) {\n    return { models: {} };\n  }\n\n  try {\n    const content = readFileSync(CONFIG_FILE, \"utf-8\");\n    return JSON.parse(content);\n  } catch (error) {\n    console.error(\"Failed to parse config file:\", error);\n    return { models: {} };\n  }\n}\n\n/**\n * Save configuration to ~/.kly/config.json\n */\nexport function saveConfig(config: KlyConfig): void {\n  ensureConfigDir();\n  writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2), \"utf-8\");\n}\n\n/**\n * Get current active model configuration\n */\nexport function getCurrentModelConfig(): LLMConfig | null {\n  const config = loadConfig();\n\n  if (!config.currentModel) {\n    return null;\n  }\n\n  return config.models[config.currentModel] || null;\n}\n\n/**\n * Set a model as current\n */\nexport function setCurrentModel(modelName: string): void {\n  const config = loadConfig();\n\n  if (!config.models[modelName]) {\n    throw new Error(`Model '${modelName}' not found in config`);\n  }\n\n  config.currentModel = modelName;\n  saveConfig(config);\n}\n\n/**\n * Add or update a model configuration\n */\nexport function saveModelConfig(\n  modelName: string,\n  modelConfig: LLMConfig,\n): void {\n  const config = loadConfig();\n\n  config.models[modelName] = modelConfig;\n\n  // Set as current if it's the first model\n  if (!config.currentModel) {\n    config.currentModel = modelName;\n  }\n\n  saveConfig(config);\n}\n\n/**\n * Remove a model configuration\n */\nexport function removeModelConfig(modelName: string): void {\n  const config = loadConfig();\n\n  delete config.models[modelName];\n\n  // Clear current if it was removed\n  if (config.currentModel === modelName) {\n    config.currentModel = undefined;\n  }\n\n  saveConfig(config);\n}\n\n/**\n * List all configured models\n */\nexport function listModels(): Array<{\n  name: string;\n  config: LLMConfig;\n  isCurrent: boolean;\n}> {\n  const config = loadConfig();\n\n  return Object.entries(config.models).map(([name, modelConfig]) => ({\n    name,\n    config: modelConfig,\n    isCurrent: name === config.currentModel,\n  }));\n}\n\n/**\n * Get provider display name\n */\nexport function getProviderDisplayName(provider: LLMProvider): string {\n  const displayNames: Record<LLMProvider, string> = {\n    openai: \"OpenAI\",\n    anthropic: \"Anthropic\",\n    google: \"Google\",\n    deepseek: \"DeepSeek\",\n    ollama: \"Ollama\",\n    groq: \"Groq\",\n    mistral: \"Mistral\",\n    cohere: \"Cohere\",\n    \"openai-compatible\": \"OpenAI Compatible\",\n  };\n  return displayNames[provider];\n}\n"],"mappings":";;;;;AAKA,MAAM,aAAa,KAAK,SAAS,EAAE,OAAO;AAC1C,MAAM,cAAc,KAAK,YAAY,cAAc;;;;AAUnD,SAAS,kBAAwB;AAC/B,KAAI,CAAC,WAAW,WAAW,CACzB,WAAU,YAAY,EAAE,WAAW,MAAM,CAAC;;;;;AAO9C,SAAgB,aAAwB;AACtC,kBAAiB;AAEjB,KAAI,CAAC,WAAW,YAAY,CAC1B,QAAO,EAAE,QAAQ,EAAE,EAAE;AAGvB,KAAI;EACF,MAAM,UAAU,aAAa,aAAa,QAAQ;AAClD,SAAO,KAAK,MAAM,QAAQ;UACnB,OAAO;AACd,UAAQ,MAAM,gCAAgC,MAAM;AACpD,SAAO,EAAE,QAAQ,EAAE,EAAE;;;;;;AAezB,SAAgB,wBAA0C;CACxD,MAAM,SAAS,YAAY;AAE3B,KAAI,CAAC,OAAO,aACV,QAAO;AAGT,QAAO,OAAO,OAAO,OAAO,iBAAiB;;;;;AAuD/C,SAAgB,aAIb;CACD,MAAM,SAAS,YAAY;AAE3B,QAAO,OAAO,QAAQ,OAAO,OAAO,CAAC,KAAK,CAAC,MAAM,kBAAkB;EACjE;EACA,QAAQ;EACR,WAAW,SAAS,OAAO;EAC5B,EAAE"}

package/dist/bin/kly.d.mts

@@ -0,0 +1 @@
+export { };