@orka-js/cli 1.5.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Orka Team
+
+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/dist/cli.js

@@ -0,0 +1,260 @@
+#!/usr/bin/env node
+import { intro, log, spinner, outro, text, select, confirm } from '@clack/prompts';
+import { join } from 'path';
+import fs from 'fs-extra';
+
+var TEMPLATES = {
+  basic: {
+    description: "Simple agent with a goal and optional tools",
+    files: {
+      "src/agent.ts": `import { StreamingToolAgent } from '@orka-js/agent';
+import { OpenAIAdapter } from '@orka-js/openai';
+
+const llm = new OpenAIAdapter({ apiKey: process.env.OPENAI_API_KEY! });
+
+export const agent = new StreamingToolAgent({
+  goal: 'You are a helpful assistant.',
+}, llm);
+`,
+      "src/index.ts": `import { agent } from './agent.js';
+
+const input = process.argv[2] ?? 'Hello!';
+
+for await (const event of agent.runStream(input)) {
+  if (event.type === 'token') process.stdout.write(event.token);
+  if (event.type === 'done') console.log('\\n\\nDone!');
+}
+`
+    }
+  },
+  rag: {
+    description: "RAG pipeline with vector search and document loading",
+    files: {
+      "src/agent.ts": `import { StreamingToolAgent } from '@orka-js/agent';
+import { OpenAIAdapter } from '@orka-js/openai';
+import { InMemoryVectorStore } from '@orka-js/memory';
+
+const llm = new OpenAIAdapter({ apiKey: process.env.OPENAI_API_KEY! });
+const vectorStore = new InMemoryVectorStore({ llm });
+
+export const searchTool = {
+  name: 'search_docs',
+  description: 'Search the knowledge base for relevant documents',
+  parameters: [{ name: 'query', type: 'string', description: 'Search query', required: true }],
+  execute: async ({ query }: { query: string }) => {
+    const results = await vectorStore.similaritySearch(query, { topK: 3 });
+    return results.map(r => r.content).join('\\n---\\n');
+  },
+};
+
+export const agent = new StreamingToolAgent({
+  goal: 'Answer questions using the knowledge base. Always search before answering.',
+  tools: [searchTool],
+}, llm);
+`,
+      "src/ingest.ts": `import { InMemoryVectorStore } from '@orka-js/memory';
+import { OpenAIAdapter } from '@orka-js/openai';
+
+const llm = new OpenAIAdapter({ apiKey: process.env.OPENAI_API_KEY! });
+const vectorStore = new InMemoryVectorStore({ llm });
+
+// Add your documents here
+await vectorStore.add([
+  { id: '1', content: 'OrkaJS is a TypeScript AI agent framework.', metadata: {} },
+  { id: '2', content: 'OrkaJS supports streaming, tools, memory, and graph workflows.', metadata: {} },
+]);
+
+console.log('Documents ingested!');
+`
+    }
+  },
+  sales: {
+    description: "Sales agent with tools and durable job persistence",
+    files: {
+      "src/agent.ts": `import { StreamingToolAgent } from '@orka-js/agent';
+import { DurableAgent, MemoryDurableStore } from '@orka-js/durable';
+import { OpenAIAdapter } from '@orka-js/openai';
+
+const llm = new OpenAIAdapter({ apiKey: process.env.OPENAI_API_KEY! });
+const store = new MemoryDurableStore();
+
+const tools = [
+  {
+    name: 'search_company',
+    description: 'Look up company information',
+    parameters: [{ name: 'name', type: 'string', description: 'Company name', required: true }],
+    execute: async ({ name }: { name: string }) => \`Company: \${name} \u2014 500 employees, SaaS.\`,
+  },
+  {
+    name: 'send_email',
+    description: 'Send a prospecting email',
+    parameters: [
+      { name: 'to', type: 'string', description: 'Email address', required: true },
+      { name: 'subject', type: 'string', description: 'Email subject', required: true },
+      { name: 'body', type: 'string', description: 'Email body', required: true },
+    ],
+    execute: async ({ to, subject }: { to: string; subject: string }) => \`Email sent to \${to}: \${subject}\`,
+  },
+];
+
+const innerAgent = new StreamingToolAgent({ goal: 'You are a B2B sales agent.', tools }, llm);
+export const durableAgent = new DurableAgent(innerAgent, store);
+`
+    }
+  }
+};
+async function runInit(targetDir) {
+  intro("Orka Init \u2014 Create a new OrkaJS project");
+  const dir = targetDir ?? await text({
+    message: "Project directory:",
+    placeholder: "./my-orka-agent",
+    defaultValue: "./my-orka-agent"
+  });
+  if (!dir) {
+    log.error("No directory specified.");
+    process.exit(1);
+  }
+  const template = await select({
+    message: "Choose a template:",
+    options: Object.entries(TEMPLATES).map(([value, t]) => ({
+      value,
+      label: value,
+      hint: t.description
+    }))
+  });
+  const provider = await select({
+    message: "LLM provider:",
+    options: [
+      { value: "openai", label: "OpenAI", hint: "GPT-4o, GPT-4-turbo" },
+      { value: "anthropic", label: "Anthropic", hint: "Claude 3.5, Claude 4" },
+      { value: "google", label: "Google", hint: "Gemini 2.0 Flash" },
+      { value: "ollama", label: "Ollama", hint: "Local models" }
+    ]
+  });
+  const install = await confirm({ message: "Install dependencies?" });
+  const s = spinner();
+  s.start("Creating project files\u2026");
+  const fullDir = join(process.cwd(), dir);
+  await fs.ensureDir(fullDir);
+  await fs.ensureDir(join(fullDir, "src"));
+  const tpl = TEMPLATES[template];
+  for (const [file, content] of Object.entries(tpl.files)) {
+    await fs.outputFile(join(fullDir, file), content);
+  }
+  const pkgDeps = {
+    "@orka-js/agent": "^1.5.0",
+    "@orka-js/core": "^1.5.0"
+  };
+  if (provider !== "ollama") pkgDeps[`@orka-js/${provider}`] = "^1.5.0";
+  if (provider === "ollama") pkgDeps["@orka-js/ollama"] = "^1.5.0";
+  if (template === "rag") pkgDeps["@orka-js/memory"] = "^1.5.0";
+  if (template === "sales") pkgDeps["@orka-js/durable"] = "^1.5.0";
+  await fs.outputJSON(join(fullDir, "package.json"), {
+    name: dir.replace("./", "").replace(/\//g, "-"),
+    version: "0.1.0",
+    type: "module",
+    scripts: { dev: "node --loader ts-node/esm src/index.ts", build: "tsc" },
+    dependencies: pkgDeps,
+    devDependencies: { typescript: "^5.4.0", "ts-node": "^10.9.2" }
+  }, { spaces: 2 });
+  const envVars = provider !== "ollama" ? `${provider.toUpperCase()}_API_KEY=your-api-key-here
+` : "";
+  await fs.outputFile(join(fullDir, ".env.example"), envVars);
+  await fs.outputFile(join(fullDir, ".gitignore"), "node_modules\ndist\n.env\n");
+  s.stop("Project files created!");
+  if (install) {
+    const s2 = spinner();
+    s2.start("Installing dependencies\u2026");
+    const { execSync } = await import('child_process');
+    try {
+      execSync("npm install", { cwd: fullDir, stdio: "pipe" });
+      s2.stop("Dependencies installed!");
+    } catch {
+      s2.stop("Install failed \u2014 run npm install manually.");
+    }
+  }
+  outro(`Done! \`cd ${dir}\` and add your API key to .env`);
+}
+async function runDev(options = {}) {
+  intro("Orka Dev Server");
+  const port = options.port ?? 4200;
+  const cwd = process.cwd();
+  const configPaths = [
+    join(cwd, "orka.config.ts"),
+    join(cwd, "orka.config.js"),
+    join(cwd, "src", "agent.ts"),
+    join(cwd, "src", "agents.ts")
+  ];
+  let configFile = null;
+  for (const p of configPaths) {
+    if (await fs.pathExists(p)) {
+      configFile = p;
+      break;
+    }
+  }
+  if (!configFile) {
+    log.error("No agent config found. Create orka.config.ts or src/agent.ts");
+    log.info("Expected export: export default { agents: { assistant: myAgent } }");
+    process.exit(1);
+  }
+  const s = spinner();
+  s.start(`Loading agents from ${configFile}\u2026`);
+  try {
+    const mod = await import(configFile);
+    const agentConfig = mod.default ?? mod;
+    const agents = agentConfig.agents ?? {};
+    s.stop(`Loaded ${Object.keys(agents).length} agent(s)`);
+    const { createOrkaServer } = await import('@orka-js/server');
+    const server = await createOrkaServer({
+      agents,
+      port,
+      open: options.open ?? true
+    });
+    outro(`Orka Dev Server running at ${server.url}`);
+    log.info("Press Ctrl+C to stop.");
+    process.on("SIGINT", async () => {
+      await server.close();
+      process.exit(0);
+    });
+  } catch (error) {
+    s.stop("Failed to start server");
+    log.error(error.message);
+    process.exit(1);
+  }
+}
+
+// src/cli.ts
+var [, , command, ...args] = process.argv;
+async function main() {
+  switch (command) {
+    case "init": {
+      await runInit(args[0]);
+      break;
+    }
+    case "dev": {
+      const portFlag = args.findIndex((a) => a === "--port" || a === "-p");
+      const port = portFlag !== -1 ? parseInt(args[portFlag + 1]) : void 0;
+      const open = !args.includes("--no-open");
+      await runDev({ port, open });
+      break;
+    }
+    default: {
+      console.log(`
+  orka \u2014 OrkaJS CLI
+
+  Commands:
+    orka init [dir]          Create a new OrkaJS project
+    orka dev [--port 4200]   Start the dev server
+
+  Examples:
+    npx @orka-js/cli init ./my-agent
+    npx @orka-js/cli dev --port 3000
+`);
+      break;
+    }
+  }
+}
+main().catch((err) => {
+  console.error(err.message);
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "@orka-js/cli",
+  "version": "1.5.0",
+  "description": "CLI for OrkaJS — npx orka init, orka dev",
+  "type": "module",
+  "bin": {
+    "orka": "./dist/cli.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@clack/prompts": "^0.7.0",
+    "fs-extra": "^11.2.0"
+  },
+  "devDependencies": {
+    "@types/fs-extra": "^11.0.4",
+    "vitest": "^1.6.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  }
+}