@operor/cli 0.1.0

package/README.md

@@ -0,0 +1,76 @@
+# @operor/cli
+
+CLI tool for Operor — setup wizard, diagnostics, testing, and knowledge base management.
+
+## Install
+
+```bash
+pnpm add -g @operor/cli
+```
+
+## Commands
+
+### Setup & Runtime
+
+```bash
+operor setup    # Interactive setup wizard
+operor start    # Start with existing .env config
+operor status   # Show configuration status
+operor doctor   # Validate config and test connections
+operor test     # Run demo test scenarios
+```
+
+### Configuration
+
+```bash
+operor config show          # Show current config
+operor config set KEY VALUE # Set a config value
+operor config unset KEY     # Remove a config value
+```
+
+### Knowledge Base
+
+Requires `KB_ENABLED=true` in `.env` (set via `operor setup` or `operor config set`).
+
+```bash
+# Ingest content
+operor kb add-url <url>                    # Ingest a web page
+operor kb add-file <path>                  # Ingest a document (PDF, TXT, MD, etc.)
+operor kb add-faq <question> <answer>      # Add a manual FAQ entry
+
+# Browse & search
+operor kb list                             # List all documents
+operor kb search <query>                   # Search with relevance scores
+operor kb search <query> -n 10             # Search with custom result limit
+
+# Manage
+operor kb delete <id>                      # Delete a document by ID
+operor kb stats                            # Show KB statistics (docs, chunks, DB size)
+```
+
+#### Examples
+
+```bash
+# Add your docs
+operor kb add-url https://docs.example.com/faq
+operor kb add-file ./product-manual.pdf
+operor kb add-faq "What are your hours?" "We're open Mon-Fri 9am-5pm EST."
+
+# Test retrieval
+operor kb search "return policy"
+
+# Check stats
+operor kb stats
+```
+
+#### KB Configuration
+
+Set during `operor setup` or manually via `operor config set`:
+
+| Variable | Description | Default |
+|---|---|---|
+| `KB_ENABLED` | Enable knowledge base | `false` |
+| `KB_DB_PATH` | SQLite database path | `./knowledge.db` |
+| `KB_EMBEDDING_PROVIDER` | `openai`, `google`, `mistral`, `cohere`, or `ollama` | `openai` |
+| `KB_EMBEDDING_MODEL` | Embedding model name | Provider default |
+| `KB_EMBEDDING_API_KEY` | API key for embeddings | — |

package/dist/config-Bn2pbORi.js

@@ -0,0 +1,34 @@
+import { n as readConfig, r as writeConfig, t as configExists } from "./index.js";
+
+//#region src/commands/config.ts
+function showConfig() {
+	if (!configExists()) {
+		console.error("No configuration found. Run \"operor setup\" first.");
+		process.exit(1);
+	}
+	const config = readConfig();
+	for (const [key, value] of Object.entries(config)) {
+		const display = key.includes("KEY") || key.includes("TOKEN") || key.includes("SECRET") ? maskValue(value || "") : value;
+		console.log(`  ${key}=${display}`);
+	}
+}
+function setConfigValue(key, value) {
+	const config = readConfig();
+	config[key] = value;
+	writeConfig(config);
+	console.log(`  Set ${key}=${key.includes("KEY") ? maskValue(value) : value}`);
+}
+function unsetConfigValue(key) {
+	const config = readConfig();
+	delete config[key];
+	writeConfig(config);
+	console.log(`  Removed ${key}`);
+}
+function maskValue(val) {
+	if (val.length <= 8) return "••••••••";
+	return val.slice(0, 4) + "••••" + val.slice(-4);
+}
+
+//#endregion
+export { setConfigValue, showConfig, unsetConfigValue };
+//# sourceMappingURL=config-Bn2pbORi.js.map

package/dist/config-Bn2pbORi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-Bn2pbORi.js","names":[],"sources":["../src/commands/config.ts"],"sourcesContent":["import { readConfig, writeConfig, configExists } from '../config.js';\n\nexport function showConfig(): void {\n  if (!configExists()) {\n    console.error('No configuration found. Run \"operor setup\" first.');\n    process.exit(1);\n  }\n  const config = readConfig();\n  for (const [key, value] of Object.entries(config)) {\n    const display = key.includes('KEY') || key.includes('TOKEN') || key.includes('SECRET')\n      ? maskValue(value || '')\n      : value;\n    console.log(`  ${key}=${display}`);\n  }\n}\n\nexport function setConfigValue(key: string, value: string): void {\n  const config = readConfig();\n  config[key] = value;\n  writeConfig(config);\n  console.log(`  Set ${key}=${key.includes('KEY') ? maskValue(value) : value}`);\n}\n\nexport function unsetConfigValue(key: string): void {\n  const config = readConfig();\n  delete config[key];\n  writeConfig(config);\n  console.log(`  Removed ${key}`);\n}\n\nfunction maskValue(val: string): string {\n  if (val.length <= 8) return '••••••••';\n  return val.slice(0, 4) + '••••' + val.slice(-4);\n}\n"],"mappings":";;;AAEA,SAAgB,aAAmB;AACjC,KAAI,CAAC,cAAc,EAAE;AACnB,UAAQ,MAAM,sDAAoD;AAClE,UAAQ,KAAK,EAAE;;CAEjB,MAAM,SAAS,YAAY;AAC3B,MAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,OAAO,EAAE;EACjD,MAAM,UAAU,IAAI,SAAS,MAAM,IAAI,IAAI,SAAS,QAAQ,IAAI,IAAI,SAAS,SAAS,GAClF,UAAU,SAAS,GAAG,GACtB;AACJ,UAAQ,IAAI,KAAK,IAAI,GAAG,UAAU;;;AAItC,SAAgB,eAAe,KAAa,OAAqB;CAC/D,MAAM,SAAS,YAAY;AAC3B,QAAO,OAAO;AACd,aAAY,OAAO;AACnB,SAAQ,IAAI,SAAS,IAAI,GAAG,IAAI,SAAS,MAAM,GAAG,UAAU,MAAM,GAAG,QAAQ;;AAG/E,SAAgB,iBAAiB,KAAmB;CAClD,MAAM,SAAS,YAAY;AAC3B,QAAO,OAAO;AACd,aAAY,OAAO;AACnB,SAAQ,IAAI,aAAa,MAAM;;AAGjC,SAAS,UAAU,KAAqB;AACtC,KAAI,IAAI,UAAU,EAAG,QAAO;AAC5B,QAAO,IAAI,MAAM,GAAG,EAAE,GAAG,SAAS,IAAI,MAAM,GAAG"}

package/dist/converse-C_PB7-JH.js

@@ -0,0 +1,142 @@
+import { n as readConfig } from "./index.js";
+
+//#region src/commands/converse.ts
+async function runConverse(options) {
+	const config = readConfig();
+	const { Operor } = await import("@operor/core");
+	const { MockProvider } = await import("@operor/provider-mock");
+	const { MockShopifySkill, CustomerSimulator, ConversationEvaluator, ConversationRunner, ECOMMERCE_SCENARIOS, SkillTestHarness } = await import("@operor/testing");
+	let llm;
+	if (config.LLM_PROVIDER && config.LLM_API_KEY) {
+		const { AIProvider } = await import("@operor/llm");
+		llm = new AIProvider({
+			provider: config.LLM_PROVIDER,
+			apiKey: config.LLM_API_KEY,
+			model: config.LLM_MODEL
+		});
+	}
+	let scenarios = [...ECOMMERCE_SCENARIOS];
+	if (options.file) {
+		const fs = await import("fs");
+		try {
+			const raw = fs.readFileSync(options.file, "utf-8");
+			scenarios = JSON.parse(raw);
+		} catch (err) {
+			console.error(`Failed to load scenarios from ${options.file}:`, err);
+			process.exit(1);
+		}
+	}
+	if (options.scenario) {
+		const match = scenarios.filter((s) => s.name.toLowerCase().includes(options.scenario.toLowerCase()) || s.id.toLowerCase().includes(options.scenario.toLowerCase()));
+		if (match.length === 0) {
+			console.error(`No scenario matching "${options.scenario}". Available:`);
+			scenarios.forEach((s) => console.error(`  - ${s.id}: ${s.name}`));
+			process.exit(1);
+		}
+		scenarios = match;
+	}
+	if (options.turns) scenarios = scenarios.map((s) => ({
+		...s,
+		maxTurns: options.turns
+	}));
+	if (options.persona) scenarios = scenarios.map((s) => ({
+		...s,
+		persona: options.persona
+	}));
+	const os = new Operor({
+		debug: false,
+		batchWindowMs: 0
+	});
+	const provider = new MockProvider();
+	const shopify = new MockShopifySkill();
+	let skill = shopify;
+	if (options.real || options.dryRun) {
+		skill = new SkillTestHarness(shopify, {
+			allowWrites: options.allowWrites ?? false,
+			dryRun: options.dryRun ?? false
+		});
+		await skill.authenticate();
+	}
+	await os.addProvider(provider);
+	await os.addSkill(skill);
+	const allTools = [
+		shopify.tools.get_order,
+		shopify.tools.create_discount,
+		shopify.tools.search_products
+	];
+	const agent = os.createAgent({
+		name: "Test Agent",
+		purpose: "Handle customer support conversations",
+		personality: "empathetic and solution-focused",
+		triggers: ["order_tracking", "general"],
+		tools: allTools,
+		rules: [{
+			name: "Auto-compensation",
+			condition: async (_ctx, toolResults) => {
+				const order = toolResults.find((t) => t.name === "get_order");
+				return order?.success && order.result?.isDelayed && order.result?.delayDays >= 2;
+			},
+			action: async () => {
+				return {
+					type: "discount_created",
+					code: (await shopify.tools.create_discount.execute({
+						percent: 10,
+						validDays: 30
+					})).code,
+					percent: 10,
+					validDays: 30
+				};
+			}
+		}]
+	});
+	let kbRuntime;
+	if (config.KB_ENABLED === "true") try {
+		const { SQLiteKnowledgeStore, EmbeddingService, RetrievalPipeline } = await import("@operor/knowledge");
+		const embedder = new EmbeddingService({
+			provider: config.KB_EMBEDDING_PROVIDER || config.LLM_PROVIDER,
+			apiKey: config.KB_EMBEDDING_API_KEY || config.LLM_API_KEY || "",
+			model: config.KB_EMBEDDING_MODEL
+		});
+		const kbStore = new SQLiteKnowledgeStore(config.KB_DB_PATH || "./knowledge.db", embedder.dimensions);
+		await kbStore.initialize();
+		const retrieval = new RetrievalPipeline(kbStore, embedder);
+		kbRuntime = { retrieve: (q) => retrieval.retrieve(q) };
+		console.log("[Operor] 📚 Knowledge Base enabled for conversations");
+	} catch (kbError) {
+		console.warn("[Operor] ⚠️  Failed to initialize Knowledge Base:", kbError.message);
+	}
+	if (llm) {
+		const { applyLLMOverride } = await import("./llm-override-BIQl0V6H.js").then((n) => n.n);
+		applyLLMOverride(agent, llm, allTools, { kbRuntime });
+	}
+	await os.start();
+	const runner = new ConversationRunner({
+		agentOS: os,
+		customerSimulator: new CustomerSimulator({ llmProvider: llm }),
+		conversationEvaluator: new ConversationEvaluator({ llmProvider: llm }),
+		verbose: options.verbose ?? false
+	});
+	if (!options.json) console.log(`\n  Running ${scenarios.length} conversation scenario(s)...\n`);
+	const results = await runner.runScenarios(scenarios);
+	await os.stop();
+	if (options.json) console.log(JSON.stringify(results, null, 2));
+	else {
+		let passed = 0;
+		let failed = 0;
+		for (const r of results) {
+			const icon = r.passed ? "✓" : "✗";
+			const status = r.passed ? "PASS" : "FAIL";
+			console.log(`  ${icon} ${r.scenario.name} — ${status} (${r.turns.length} turns, ${r.duration}ms)`);
+			if (!r.passed && r.evaluation.feedback) console.log(`    ${r.evaluation.feedback}`);
+			if (r.passed) passed++;
+			else failed++;
+		}
+		console.log(`\n  Results: ${passed} passed, ${failed} failed out of ${results.length}`);
+		console.log(`  Status: ${failed === 0 ? "✓ ALL PASSED" : "✗ SOME FAILED"}\n`);
+	}
+	process.exit(results.every((r) => r.passed) ? 0 : 1);
+}
+
+//#endregion
+export { runConverse };
+//# sourceMappingURL=converse-C_PB7-JH.js.map

package/dist/converse-C_PB7-JH.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"converse-C_PB7-JH.js","names":[],"sources":["../src/commands/converse.ts"],"sourcesContent":["import { readConfig } from '../config.js';\nimport { formatTimestamp } from '../utils.js';\n\nexport async function runConverse(options: {\n  scenario?: string;\n  file?: string;\n  turns?: number;\n  persona?: string;\n  verbose?: boolean;\n  json?: boolean;\n  real?: boolean;\n  allowWrites?: boolean;\n  dryRun?: boolean;\n}): Promise<void> {\n  const config = readConfig();\n  const { Operor } = await import('@operor/core');\n  const { MockProvider } = await import('@operor/provider-mock');\n  const {\n    MockShopifySkill,\n    CustomerSimulator,\n    ConversationEvaluator,\n    ConversationRunner,\n    ECOMMERCE_SCENARIOS,\n    SkillTestHarness,\n  } = await import('@operor/testing');\n\n  // Set up LLM if configured\n  let llm: any;\n  if (config.LLM_PROVIDER && config.LLM_API_KEY) {\n    const { AIProvider } = await import('@operor/llm');\n    llm = new AIProvider({\n      provider: config.LLM_PROVIDER as any,\n      apiKey: config.LLM_API_KEY,\n      model: config.LLM_MODEL,\n    });\n  }\n\n  // Determine which scenarios to run\n  let scenarios = [...ECOMMERCE_SCENARIOS];\n\n  if (options.file) {\n    const fs = await import('fs');\n    try {\n      const raw = fs.readFileSync(options.file, 'utf-8');\n      scenarios = JSON.parse(raw);\n    } catch (err) {\n      console.error(`Failed to load scenarios from ${options.file}:`, err);\n      process.exit(1);\n    }\n  }\n\n  if (options.scenario) {\n    const match = scenarios.filter(\n      (s) => s.name.toLowerCase().includes(options.scenario!.toLowerCase()) ||\n             s.id.toLowerCase().includes(options.scenario!.toLowerCase())\n    );\n    if (match.length === 0) {\n      console.error(`No scenario matching \"${options.scenario}\". Available:`);\n      scenarios.forEach((s) => console.error(`  - ${s.id}: ${s.name}`));\n      process.exit(1);\n    }\n    scenarios = match;\n  }\n\n  // Apply overrides\n  if (options.turns) {\n    scenarios = scenarios.map((s) => ({ ...s, maxTurns: options.turns! }));\n  }\n  if (options.persona) {\n    scenarios = scenarios.map((s) => ({ ...s, persona: options.persona! }));\n  }\n\n  // Set up Operor with mocks\n  const os = new Operor({ debug: false, batchWindowMs: 0 });\n  const provider = new MockProvider();\n  const shopify = new MockShopifySkill();\n\n  // Wrap skill with safety harness if --real or --dry-run\n  let skill: any = shopify;\n  if (options.real || options.dryRun) {\n    skill = new SkillTestHarness(shopify, {\n      allowWrites: options.allowWrites ?? false,\n      dryRun: options.dryRun ?? false,\n    });\n    await skill.authenticate();\n  }\n\n  await os.addProvider(provider);\n  await os.addSkill(skill);\n\n  const allTools = [shopify.tools.get_order, shopify.tools.create_discount, shopify.tools.search_products];\n\n  const agent = os.createAgent({\n    name: 'Test Agent',\n    purpose: 'Handle customer support conversations',\n    personality: 'empathetic and solution-focused',\n    triggers: ['order_tracking', 'general'],\n    tools: allTools,\n    rules: [{\n      name: 'Auto-compensation',\n      condition: async (_ctx: any, toolResults: any[]) => {\n        const order = toolResults.find((t) => t.name === 'get_order');\n        return order?.success && order.result?.isDelayed && order.result?.delayDays >= 2;\n      },\n      action: async () => {\n        const discount = await shopify.tools.create_discount.execute({ percent: 10, validDays: 30 });\n        return { type: 'discount_created', code: discount.code, percent: 10, validDays: 30 };\n      },\n    }],\n  });\n\n  // Set up Knowledge Base if enabled\n  let kbRuntime: any;\n  if (config.KB_ENABLED === 'true') {\n    try {\n      const { SQLiteKnowledgeStore, EmbeddingService, RetrievalPipeline } = await import('@operor/knowledge');\n      const embedder = new EmbeddingService({\n        provider: (config.KB_EMBEDDING_PROVIDER || config.LLM_PROVIDER) as any,\n        apiKey: config.KB_EMBEDDING_API_KEY || config.LLM_API_KEY || '',\n        model: config.KB_EMBEDDING_MODEL,\n      });\n      const kbStore = new SQLiteKnowledgeStore(config.KB_DB_PATH || './knowledge.db', embedder.dimensions);\n      await kbStore.initialize();\n      const retrieval = new RetrievalPipeline(kbStore, embedder);\n      kbRuntime = { retrieve: (q: string) => retrieval.retrieve(q) };\n      console.log('[Operor] 📚 Knowledge Base enabled for conversations');\n    } catch (kbError: any) {\n      console.warn('[Operor] ⚠️  Failed to initialize Knowledge Base:', kbError.message);\n    }\n  }\n\n  // Override agent.process with LLM-based implementation if LLM is configured\n  if (llm) {\n    const { applyLLMOverride } = await import('./llm-override.js');\n    applyLLMOverride(agent, llm, allTools, { kbRuntime });\n  }\n\n  await os.start();\n\n  // Create runner components with LLM if configured\n  const customerSimulator = new CustomerSimulator({ llmProvider: llm });\n  const conversationEvaluator = new ConversationEvaluator({ llmProvider: llm });\n  const runner = new ConversationRunner({\n    agentOS: os,\n    customerSimulator,\n    conversationEvaluator,\n    verbose: options.verbose ?? false,\n  });\n\n  if (!options.json) {\n    console.log(`\\n  Running ${scenarios.length} conversation scenario(s)...\\n`);\n  }\n\n  const results = await runner.runScenarios(scenarios);\n  await os.stop();\n\n  // Output results\n  if (options.json) {\n    console.log(JSON.stringify(results, null, 2));\n  } else {\n    let passed = 0;\n    let failed = 0;\n\n    for (const r of results) {\n      const icon = r.passed ? '✓' : '✗';\n      const status = r.passed ? 'PASS' : 'FAIL';\n      console.log(`  ${icon} ${r.scenario.name} — ${status} (${r.turns.length} turns, ${r.duration}ms)`);\n\n      if (!r.passed && r.evaluation.feedback) {\n        console.log(`    ${r.evaluation.feedback}`);\n      }\n\n      if (r.passed) passed++;\n      else failed++;\n    }\n\n    console.log(`\\n  Results: ${passed} passed, ${failed} failed out of ${results.length}`);\n    console.log(`  Status: ${failed === 0 ? '✓ ALL PASSED' : '✗ SOME FAILED'}\\n`);\n  }\n\n  process.exit(results.every((r) => r.passed) ? 0 : 1);\n}\n"],"mappings":"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"}

package/dist/doctor-98gPl743.js

@@ -0,0 +1,122 @@
+import { n as readConfig, t as configExists } from "./index.js";
+import * as clack from "@clack/prompts";
+
+//#region src/commands/doctor.ts
+async function runDoctor() {
+	clack.intro("Operor Doctor");
+	if (!configExists()) {
+		clack.log.error(".env file not found. Run \"operor setup\" first.");
+		process.exit(1);
+	}
+	const config = readConfig();
+	let allPassed = true;
+	clack.log.success(".env file found");
+	if (config.LLM_PROVIDER && config.LLM_API_KEY) {
+		const spinner = clack.spinner();
+		spinner.start(`Testing ${config.LLM_PROVIDER} LLM connection...`);
+		try {
+			const { AIProvider } = await import("@operor/llm");
+			await new AIProvider({
+				provider: config.LLM_PROVIDER,
+				apiKey: config.LLM_API_KEY,
+				model: config.LLM_MODEL
+			}).complete([{
+				role: "user",
+				content: "ping"
+			}], { maxTokens: 5 });
+			spinner.stop(`${config.LLM_PROVIDER} LLM: OK`);
+		} catch (error) {
+			spinner.stop(`${config.LLM_PROVIDER} LLM: FAILED — ${error.message}`);
+			allPassed = false;
+		}
+	} else {
+		clack.log.warning("LLM not configured");
+		allPassed = false;
+	}
+	if (config.SKILLS_ENABLED !== "false") {
+		const skillSpinner = clack.spinner();
+		skillSpinner.start("Checking MCP Skills...");
+		try {
+			const { loadSkillsConfig, SkillManager } = await import("@operor/skills");
+			const enabledSkills = loadSkillsConfig().skills.filter((s) => s.enabled !== false);
+			if (enabledSkills.length === 0) skillSpinner.stop("MCP Skills: No skills configured in mcp.json");
+			else {
+				const errors = [];
+				for (const skill of enabledSkills) {
+					const error = SkillManager.validateConfig(skill);
+					if (error) errors.push(`${skill.name}: ${error}`);
+				}
+				if (errors.length > 0) {
+					skillSpinner.stop(`MCP Skills: ${errors.length} config error(s)`);
+					for (const err of errors) clack.log.warning(`  ${err}`);
+					allPassed = false;
+				} else skillSpinner.stop(`MCP Skills: ${enabledSkills.length} skill(s) configured`);
+			}
+		} catch (error) {
+			skillSpinner.stop("MCP Skills: Not available (mcp.json not found or @operor/skills not installed)");
+		}
+	}
+	if (config.CHANNEL === "telegram" && config.TELEGRAM_BOT_TOKEN) clack.log.success("Telegram bot token configured");
+	else if (config.CHANNEL === "wati") if (config.WATI_API_TOKEN && config.WATI_TENANT_ID) clack.log.success("WATI credentials configured");
+	else {
+		clack.log.error("WATI: missing WATI_API_TOKEN or WATI_TENANT_ID");
+		allPassed = false;
+	}
+	if (config.KB_ENABLED === "true") {
+		const kbSpinner = clack.spinner();
+		kbSpinner.start("Checking Knowledge Base...");
+		try {
+			const { writeFileSync, unlinkSync, existsSync } = await import("node:fs");
+			const { dirname } = await import("node:path");
+			const { mkdirSync } = await import("node:fs");
+			const dbPath = config.KB_DB_PATH || "./knowledge.db";
+			const dir = dirname(dbPath);
+			if (!existsSync(dir)) mkdirSync(dir, { recursive: true });
+			const testFile = dbPath + ".write-test";
+			writeFileSync(testFile, "");
+			unlinkSync(testFile);
+			if (config.KB_EMBEDDING_PROVIDER !== "ollama" && !config.KB_EMBEDDING_API_KEY) {
+				kbSpinner.stop("Knowledge Base: WARNING — no embedding API key set");
+				allPassed = false;
+			} else try {
+				await import("@operor/knowledge");
+				kbSpinner.stop("Knowledge Base: OK");
+			} catch {
+				kbSpinner.stop("Knowledge Base: OK (config valid, @operor/knowledge not installed yet)");
+			}
+		} catch (error) {
+			kbSpinner.stop(`Knowledge Base: FAILED — ${error.message}`);
+			allPassed = false;
+		}
+	}
+	if (config.ANALYTICS_ENABLED !== "false") {
+		const analyticsSpinner = clack.spinner();
+		analyticsSpinner.start("Checking Analytics...");
+		try {
+			const { writeFileSync, unlinkSync, existsSync } = await import("node:fs");
+			const { dirname } = await import("node:path");
+			const { mkdirSync } = await import("node:fs");
+			const dbPath = config.ANALYTICS_DB_PATH || "./analytics.db";
+			const dir = dirname(dbPath);
+			if (!existsSync(dir)) mkdirSync(dir, { recursive: true });
+			const testFile = dbPath + ".write-test";
+			writeFileSync(testFile, "");
+			unlinkSync(testFile);
+			analyticsSpinner.stop("Analytics: OK (DB path writable)");
+		} catch (error) {
+			analyticsSpinner.stop(`Analytics: FAILED — ${error.message}`);
+			allPassed = false;
+		}
+	}
+	const nodeVersion = process.versions.node;
+	if (parseInt(nodeVersion.split(".")[0]) >= 18) clack.log.success(`Node.js ${nodeVersion}`);
+	else {
+		clack.log.error(`Node.js ${nodeVersion} — requires >= 18`);
+		allPassed = false;
+	}
+	clack.outro(allPassed ? "All checks passed!" : "Some checks failed. Fix the issues above.");
+}
+
+//#endregion
+export { runDoctor };
+//# sourceMappingURL=doctor-98gPl743.js.map

package/dist/doctor-98gPl743.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor-98gPl743.js","names":[],"sources":["../src/commands/doctor.ts"],"sourcesContent":["import * as clack from '@clack/prompts';\nimport { readConfig, configExists } from '../config.js';\n\nexport async function runDoctor(): Promise<void> {\n  clack.intro('Operor Doctor');\n\n  if (!configExists()) {\n    clack.log.error('.env file not found. Run \"operor setup\" first.');\n    process.exit(1);\n  }\n\n  const config = readConfig();\n  let allPassed = true;\n\n  // 1. Check .env exists\n  clack.log.success('.env file found');\n\n  // 2. Validate LLM\n  if (config.LLM_PROVIDER && config.LLM_API_KEY) {\n    const spinner = clack.spinner();\n    spinner.start(`Testing ${config.LLM_PROVIDER} LLM connection...`);\n    try {\n      const { AIProvider } = await import('@operor/llm');\n      const llm = new AIProvider({\n        provider: config.LLM_PROVIDER as any,\n        apiKey: config.LLM_API_KEY,\n        model: config.LLM_MODEL,\n      });\n      await llm.complete([{ role: 'user', content: 'ping' }], { maxTokens: 5 });\n      spinner.stop(`${config.LLM_PROVIDER} LLM: OK`);\n    } catch (error: any) {\n      spinner.stop(`${config.LLM_PROVIDER} LLM: FAILED — ${error.message}`);\n      allPassed = false;\n    }\n  } else {\n    clack.log.warning('LLM not configured');\n    allPassed = false;\n  }\n\n  // 3. Validate MCP Skills\n  if (config.SKILLS_ENABLED !== 'false') {\n    const skillSpinner = clack.spinner();\n    skillSpinner.start('Checking MCP Skills...');\n    try {\n      const { loadSkillsConfig, SkillManager } = await import('@operor/skills');\n      const skillsConfig = loadSkillsConfig();\n      const enabledSkills = skillsConfig.skills.filter((s: any) => s.enabled !== false);\n\n      if (enabledSkills.length === 0) {\n        skillSpinner.stop('MCP Skills: No skills configured in mcp.json');\n      } else {\n        // Validate config only (don't start servers)\n        const errors: string[] = [];\n        for (const skill of enabledSkills) {\n          const error = SkillManager.validateConfig(skill);\n          if (error) errors.push(`${skill.name}: ${error}`);\n        }\n        if (errors.length > 0) {\n          skillSpinner.stop(`MCP Skills: ${errors.length} config error(s)`);\n          for (const err of errors) clack.log.warning(`  ${err}`);\n          allPassed = false;\n        } else {\n          skillSpinner.stop(`MCP Skills: ${enabledSkills.length} skill(s) configured`);\n        }\n      }\n    } catch (error: any) {\n      skillSpinner.stop('MCP Skills: Not available (mcp.json not found or @operor/skills not installed)');\n    }\n  }\n\n  // 4. Validate channel credentials\n  if (config.CHANNEL === 'telegram' && config.TELEGRAM_BOT_TOKEN) {\n    clack.log.success('Telegram bot token configured');\n  } else if (config.CHANNEL === 'wati') {\n    if (config.WATI_API_TOKEN && config.WATI_TENANT_ID) {\n      clack.log.success('WATI credentials configured');\n    } else {\n      clack.log.error('WATI: missing WATI_API_TOKEN or WATI_TENANT_ID');\n      allPassed = false;\n    }\n  }\n\n  // 5. Knowledge Base checks\n  if (config.KB_ENABLED === 'true') {\n    const kbSpinner = clack.spinner();\n    kbSpinner.start('Checking Knowledge Base...');\n    try {\n      // Check DB path is writable\n      const { writeFileSync, unlinkSync, existsSync } = await import('node:fs');\n      const { dirname } = await import('node:path');\n      const { mkdirSync } = await import('node:fs');\n      const dbPath = config.KB_DB_PATH || './knowledge.db';\n      const dir = dirname(dbPath);\n      if (!existsSync(dir)) {\n        mkdirSync(dir, { recursive: true });\n      }\n      const testFile = dbPath + '.write-test';\n      writeFileSync(testFile, '');\n      unlinkSync(testFile);\n\n      // Check embedding API key (unless ollama)\n      if (config.KB_EMBEDDING_PROVIDER !== 'ollama' && !config.KB_EMBEDDING_API_KEY) {\n        kbSpinner.stop('Knowledge Base: WARNING — no embedding API key set');\n        allPassed = false;\n      } else {\n        // Try loading sqlite-vec\n        try {\n          await import('@operor/knowledge');\n          kbSpinner.stop('Knowledge Base: OK');\n        } catch {\n          kbSpinner.stop('Knowledge Base: OK (config valid, @operor/knowledge not installed yet)');\n        }\n      }\n    } catch (error: any) {\n      kbSpinner.stop(`Knowledge Base: FAILED — ${error.message}`);\n      allPassed = false;\n    }\n  }\n\n  // 6. Analytics checks\n  if (config.ANALYTICS_ENABLED !== 'false') {\n    const analyticsSpinner = clack.spinner();\n    analyticsSpinner.start('Checking Analytics...');\n    try {\n      const { writeFileSync, unlinkSync, existsSync } = await import('node:fs');\n      const { dirname } = await import('node:path');\n      const { mkdirSync } = await import('node:fs');\n      const dbPath = config.ANALYTICS_DB_PATH || './analytics.db';\n      const dir = dirname(dbPath);\n      if (!existsSync(dir)) {\n        mkdirSync(dir, { recursive: true });\n      }\n      const testFile = dbPath + '.write-test';\n      writeFileSync(testFile, '');\n      unlinkSync(testFile);\n      analyticsSpinner.stop('Analytics: OK (DB path writable)');\n    } catch (error: any) {\n      analyticsSpinner.stop(`Analytics: FAILED — ${error.message}`);\n      allPassed = false;\n    }\n  }\n\n  // 7. Check Node.js version\n  const nodeVersion = process.versions.node;\n  const major = parseInt(nodeVersion.split('.')[0]);\n  if (major >= 18) {\n    clack.log.success(`Node.js ${nodeVersion}`);\n  } else {\n    clack.log.error(`Node.js ${nodeVersion} — requires >= 18`);\n    allPassed = false;\n  }\n\n  clack.outro(allPassed ? 'All checks passed!' : 'Some checks failed. Fix the issues above.');\n}\n"],"mappings":"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"}

package/dist/index.d.ts

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