create-operor 0.1.0

package/dist/index.d-BnefwYtp.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,153 @@
+#!/usr/bin/env node
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { execSync } from "node:child_process";
+import * as p from "@clack/prompts";
+
+//#region src/index.ts
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const TEMPLATES_DIR = path.join(__dirname, "..", "templates", "default");
+function parseArgs(args) {
+	const rest = args.slice(2);
+	const demo = rest.includes("--demo");
+	return {
+		projectName: rest.filter((a) => !a.startsWith("--"))[0] ?? "",
+		demo
+	};
+}
+function detectPackageManager() {
+	const ua = process.env.npm_config_user_agent ?? "";
+	if (ua.startsWith("pnpm")) return "pnpm";
+	if (ua.startsWith("yarn")) return "yarn";
+	if (ua.startsWith("bun")) return "bun";
+	return "npm";
+}
+function copyDir(src, dest) {
+	fs.mkdirSync(dest, { recursive: true });
+	for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
+		const srcPath = path.join(src, entry.name);
+		const destPath = path.join(dest, entry.name);
+		if (entry.isDirectory()) copyDir(srcPath, destPath);
+		else fs.copyFileSync(srcPath, destPath);
+	}
+}
+async function main() {
+	const opts = parseArgs(process.argv);
+	p.intro("create-operor");
+	let projectName = opts.projectName;
+	if (!projectName) {
+		const result = await p.text({
+			message: "Project name:",
+			placeholder: "my-bot",
+			validate: (v) => !v.trim() ? "Project name is required" : void 0
+		});
+		if (p.isCancel(result)) {
+			p.cancel("Cancelled.");
+			process.exit(0);
+		}
+		projectName = result;
+	}
+	const projectDir = path.resolve(process.cwd(), projectName);
+	if (fs.existsSync(projectDir)) {
+		p.cancel(`Directory "${projectName}" already exists.`);
+		process.exit(1);
+	}
+	let provider = "mock";
+	let apiKey = "";
+	let description = "My Operor project";
+	if (opts.demo) p.log.info("Demo mode — using MockProvider defaults");
+	else {
+		const providerResult = await p.select({
+			message: "LLM provider:",
+			options: [
+				{
+					value: "openai",
+					label: "OpenAI"
+				},
+				{
+					value: "anthropic",
+					label: "Anthropic"
+				},
+				{
+					value: "google",
+					label: "Google"
+				},
+				{
+					value: "groq",
+					label: "Groq"
+				},
+				{
+					value: "ollama",
+					label: "Ollama (local)"
+				}
+			]
+		});
+		if (p.isCancel(providerResult)) {
+			p.cancel("Cancelled.");
+			process.exit(0);
+		}
+		provider = providerResult;
+		if (provider !== "ollama") {
+			const keyResult = await p.password({ message: "API key:" });
+			if (p.isCancel(keyResult)) {
+				p.cancel("Cancelled.");
+				process.exit(0);
+			}
+			apiKey = keyResult ?? "";
+		}
+		const descResult = await p.text({
+			message: "Describe your business in one sentence:",
+			placeholder: "We sell handmade candles"
+		});
+		if (p.isCancel(descResult)) {
+			p.cancel("Cancelled.");
+			process.exit(0);
+		}
+		description = descResult || description;
+	}
+	const s = p.spinner();
+	s.start("Creating project");
+	copyDir(TEMPLATES_DIR, projectDir);
+	const tmplPath = path.join(projectDir, "package.json.tmpl");
+	const pkgContent = fs.readFileSync(tmplPath, "utf-8").replace(/\{\{name\}\}/g, projectName);
+	fs.writeFileSync(path.join(projectDir, "package.json"), pkgContent);
+	fs.unlinkSync(tmplPath);
+	const envLines = [`# LLM Configuration`, `LLM_PROVIDER=${provider}`];
+	if (apiKey) envLines.push(`LLM_API_KEY=${apiKey}`);
+	if (provider === "mock") envLines.push(`CHANNEL=mock`);
+	envLines.push("", "# Knowledge Base", "KB_ENABLED=true", "", "# Analytics", "ANALYTICS_ENABLED=true");
+	fs.writeFileSync(path.join(projectDir, ".env"), envLines.join("\n") + "\n");
+	const userMdPath = path.join(projectDir, "USER.md");
+	const userMd = fs.readFileSync(userMdPath, "utf-8").replace(/\{\{description\}\}/g, description);
+	fs.writeFileSync(userMdPath, userMd);
+	s.stop("Project created");
+	const pm = detectPackageManager();
+	const installCmd = pm === "yarn" ? "yarn" : `${pm} install`;
+	s.start(`Installing dependencies (${pm})`);
+	try {
+		execSync(installCmd, {
+			cwd: projectDir,
+			stdio: "pipe"
+		});
+		s.stop("Dependencies installed");
+	} catch {
+		s.stop("Could not install dependencies");
+		p.log.warn(`Run \`cd ${projectName} && ${installCmd}\` to install manually.`);
+	}
+	p.note([
+		`cd ${projectName}`,
+		"",
+		provider === "mock" ? `${pm === "npm" ? "npm run" : pm} chat        # try it out` : `${pm === "npm" ? "npm run" : pm} setup       # configure your agent`,
+		`${pm === "npm" ? "npm run" : pm} start       # launch the agent`
+	].join("\n"), "Next steps");
+	p.outro("Happy building!");
+}
+main().catch((err) => {
+	p.log.error(err instanceof Error ? err.message : String(err));
+	process.exit(1);
+});
+
+//#endregion
+export {  };
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["import fs from 'node:fs';\nimport path from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport { execSync } from 'node:child_process';\nimport * as p from '@clack/prompts';\n\nconst __dirname = path.dirname(fileURLToPath(import.meta.url));\nconst TEMPLATES_DIR = path.join(__dirname, '..', 'templates', 'default');\n\ninterface Options {\n  projectName: string;\n  demo: boolean;\n  provider?: string;\n  apiKey?: string;\n  description?: string;\n}\n\nfunction parseArgs(args: string[]): Options {\n  const rest = args.slice(2);\n  const demo = rest.includes('--demo');\n  const positional = rest.filter((a) => !a.startsWith('--'));\n  const projectName = positional[0] ?? '';\n  return { projectName, demo };\n}\n\nfunction detectPackageManager(): string {\n  const ua = process.env.npm_config_user_agent ?? '';\n  if (ua.startsWith('pnpm')) return 'pnpm';\n  if (ua.startsWith('yarn')) return 'yarn';\n  if (ua.startsWith('bun')) return 'bun';\n  return 'npm';\n}\n\nfunction copyDir(src: string, dest: string) {\n  fs.mkdirSync(dest, { recursive: true });\n  for (const entry of fs.readdirSync(src, { withFileTypes: true })) {\n    const srcPath = path.join(src, entry.name);\n    const destPath = path.join(dest, entry.name);\n    if (entry.isDirectory()) {\n      copyDir(srcPath, destPath);\n    } else {\n      fs.copyFileSync(srcPath, destPath);\n    }\n  }\n}\n\nasync function main() {\n  const opts = parseArgs(process.argv);\n\n  p.intro('create-operor');\n\n  // Get project name\n  let projectName = opts.projectName;\n  if (!projectName) {\n    const result = await p.text({\n      message: 'Project name:',\n      placeholder: 'my-bot',\n      validate: (v) => (!v.trim() ? 'Project name is required' : undefined),\n    });\n    if (p.isCancel(result)) {\n      p.cancel('Cancelled.');\n      process.exit(0);\n    }\n    projectName = result;\n  }\n\n  const projectDir = path.resolve(process.cwd(), projectName);\n\n  if (fs.existsSync(projectDir)) {\n    p.cancel(`Directory \"${projectName}\" already exists.`);\n    process.exit(1);\n  }\n\n  let provider = 'mock';\n  let apiKey = '';\n  let description = 'My Operor project';\n\n  if (opts.demo) {\n    p.log.info('Demo mode — using MockProvider defaults');\n  } else {\n    const providerResult = await p.select({\n      message: 'LLM provider:',\n      options: [\n        { value: 'openai', label: 'OpenAI' },\n        { value: 'anthropic', label: 'Anthropic' },\n        { value: 'google', label: 'Google' },\n        { value: 'groq', label: 'Groq' },\n        { value: 'ollama', label: 'Ollama (local)' },\n      ],\n    });\n    if (p.isCancel(providerResult)) {\n      p.cancel('Cancelled.');\n      process.exit(0);\n    }\n    provider = providerResult as string;\n\n    if (provider !== 'ollama') {\n      const keyResult = await p.password({\n        message: 'API key:',\n      });\n      if (p.isCancel(keyResult)) {\n        p.cancel('Cancelled.');\n        process.exit(0);\n      }\n      apiKey = keyResult ?? '';\n    }\n\n    const descResult = await p.text({\n      message: 'Describe your business in one sentence:',\n      placeholder: 'We sell handmade candles',\n    });\n    if (p.isCancel(descResult)) {\n      p.cancel('Cancelled.');\n      process.exit(0);\n    }\n    description = descResult || description;\n  }\n\n  // Scaffold project\n  const s = p.spinner();\n  s.start('Creating project');\n\n  // Copy template files\n  copyDir(TEMPLATES_DIR, projectDir);\n\n  // Process package.json.tmpl → package.json\n  const tmplPath = path.join(projectDir, 'package.json.tmpl');\n  const pkgContent = fs.readFileSync(tmplPath, 'utf-8').replace(/\\{\\{name\\}\\}/g, projectName);\n  fs.writeFileSync(path.join(projectDir, 'package.json'), pkgContent);\n  fs.unlinkSync(tmplPath);\n\n  // Write .env\n  const envLines = [`# LLM Configuration`, `LLM_PROVIDER=${provider}`];\n  if (apiKey) {\n    envLines.push(`LLM_API_KEY=${apiKey}`);\n  }\n  if (provider === 'mock') {\n    envLines.push(`CHANNEL=mock`);\n  }\n  envLines.push('', '# Knowledge Base', 'KB_ENABLED=true', '', '# Analytics', 'ANALYTICS_ENABLED=true');\n  fs.writeFileSync(path.join(projectDir, '.env'), envLines.join('\\n') + '\\n');\n\n  // Write USER.md with business description\n  const userMdPath = path.join(projectDir, 'USER.md');\n  const userMd = fs.readFileSync(userMdPath, 'utf-8').replace(/\\{\\{description\\}\\}/g, description);\n  fs.writeFileSync(userMdPath, userMd);\n\n  s.stop('Project created');\n\n  // Install dependencies\n  const pm = detectPackageManager();\n  const installCmd = pm === 'yarn' ? 'yarn' : `${pm} install`;\n\n  s.start(`Installing dependencies (${pm})`);\n  try {\n    execSync(installCmd, { cwd: projectDir, stdio: 'pipe' });\n    s.stop('Dependencies installed');\n  } catch {\n    s.stop('Could not install dependencies');\n    p.log.warn(`Run \\`cd ${projectName} && ${installCmd}\\` to install manually.`);\n  }\n\n  // Success\n  p.note(\n    [\n      `cd ${projectName}`,\n      '',\n      provider === 'mock'\n        ? `${pm === 'npm' ? 'npm run' : pm} chat        # try it out`\n        : `${pm === 'npm' ? 'npm run' : pm} setup       # configure your agent`,\n      `${pm === 'npm' ? 'npm run' : pm} start       # launch the agent`,\n    ].join('\\n'),\n    'Next steps',\n  );\n\n  p.outro('Happy building!');\n}\n\nmain().catch((err) => {\n  p.log.error(err instanceof Error ? err.message : String(err));\n  process.exit(1);\n});\n"],"mappings":"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"}

package/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "create-operor",
+  "version": "0.1.0",
+  "description": "Create a new Agent OS project",
+  "type": "module",
+  "bin": {
+    "create-operor": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "templates"
+  ],
+  "dependencies": {
+    "@clack/prompts": "^1.0.0"
+  },
+  "devDependencies": {
+    "tsdown": "^0.12.0",
+    "typescript": "^5.7.0"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "test": "echo 'no tests yet'"
+  }
+}

package/templates/default/.env.example

@@ -0,0 +1,9 @@
+# LLM Configuration
+LLM_PROVIDER=openai
+LLM_API_KEY=your-api-key-here
+
+# Knowledge Base
+KB_ENABLED=true
+
+# Analytics
+ANALYTICS_ENABLED=true

package/templates/default/USER.md

@@ -0,0 +1,3 @@
+# About Us
+
+{{description}}

package/templates/default/agents/_defaults/SOUL.md

@@ -0,0 +1,25 @@
+# Agent Soul
+
+## Core Principles
+
+- The customer's time is valuable — resolve issues in as few messages as possible
+- Empathy first, solutions second — acknowledge feelings before jumping to fixes
+- Honesty builds trust — if you don't know, say so and find out
+
+## Boundaries
+
+- Stay within your scope; escalate gracefully when you can't help
+- Don't overpromise — set realistic expectations about timelines and outcomes
+
+## Tone
+
+- Conversational but professional
+- Positive without being dismissive of problems
+- Direct — avoid filler phrases
+- Match the customer's energy — if they're brief, be brief; if they need reassurance, provide it
+
+## When Things Go Wrong
+
+- Lead with accountability: "I see the issue and I'm sorry about that"
+- Offer a concrete next step, not just an apology
+- Follow through — if you say you'll check on something, do it

package/templates/default/agents/support/INSTRUCTIONS.md

@@ -0,0 +1,49 @@
+---
+name: support
+purpose: Handle customer support inquiries
+triggers:
+  - "*"
+knowledgeBase: true
+guardrails:
+  maxResponseLength: 500
+  blockedTopics:
+    - competitor pricing
+    - internal company policies
+    - employee information
+  escalationTriggers:
+    - speak to a human
+    - talk to a manager
+    - escalate
+  systemRules:
+    - Never share customer data with other customers
+    - Always verify order ownership before sharing details
+---
+
+## Role
+
+You are a helpful customer support agent. Your job is to answer questions, resolve issues, and provide a great experience.
+
+## Scope
+
+- Answer questions about products, services, and policies
+- Help with order tracking and status updates
+- Assist with returns and exchanges
+- Provide shipping and delivery information
+
+## Out of Scope
+
+- Cannot process refunds directly (escalate to a team member)
+- Cannot access or discuss other customers' information
+- Do not provide legal, medical, or financial advice
+
+## Style
+
+- Warm, professional, and concise
+- Use short paragraphs and bullet points for clarity
+- Acknowledge the customer's concern before problem-solving
+- End each interaction with a clear next step
+
+## Escalation
+
+- If the customer asks for a human agent, acknowledge their request and provide handoff instructions
+- Use the phrase: "Let me connect you with a team member who can help with this."

package/templates/default/package.json.tmpl

@@ -0,0 +1,20 @@
+{
+  "name": "{{name}}",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "start": "agent-os start",
+    "setup": "agent-os setup",
+    "chat": "agent-os chat",
+    "test": "agent-os test"
+  },
+  "dependencies": {
+    "@agent-os/cli": "^0.1.0",
+    "@agent-os/core": "^0.1.0",
+    "@agent-os/llm": "^0.1.0",
+    "@agent-os/memory": "^0.1.0",
+    "@agent-os/knowledge": "^0.1.0",
+    "@agent-os/provider-mock": "^0.1.0"
+  }
+}