@tuttiai/cli 0.2.0 → 0.3.0

package/dist/index.js

@@ -203,6 +203,102 @@ ${result.output}
   process.exit(0);
 }
 
+// src/commands/add.ts
+import { existsSync as existsSync3, readFileSync } from "fs";
+import { resolve as resolve2 } from "path";
+import { execSync } from "child_process";
+import chalk3 from "chalk";
+import ora2 from "ora";
+var OFFICIAL_VOICES = {
+  filesystem: {
+    package: "@tuttiai/filesystem",
+    setup: `  Add to your score:
+    ${chalk3.cyan('import { FilesystemVoice } from "@tuttiai/filesystem"')}
+    ${chalk3.cyan("voices: [new FilesystemVoice()]")}`
+  },
+  github: {
+    package: "@tuttiai/github",
+    setup: `  Add ${chalk3.bold("GITHUB_TOKEN")} to your .env file:
+    ${chalk3.cyan("GITHUB_TOKEN=ghp_your_token_here")}
+
+  Add to your score:
+    ${chalk3.cyan('import { GitHubVoice } from "@tuttiai/github"')}
+    ${chalk3.cyan("voices: [new GitHubVoice()]")}`
+  },
+  playwright: {
+    package: "@tuttiai/playwright",
+    setup: `  Install the browser:
+    ${chalk3.cyan("npx playwright install chromium")}
+
+  Add to your score:
+    ${chalk3.cyan('import { PlaywrightVoice } from "@tuttiai/playwright"')}
+    ${chalk3.cyan("voices: [new PlaywrightVoice()]")}`
+  }
+};
+function resolvePackageName(input) {
+  if (OFFICIAL_VOICES[input]) {
+    return OFFICIAL_VOICES[input].package;
+  }
+  if (input.startsWith("@")) {
+    return input;
+  }
+  return `@tuttiai/${input}`;
+}
+function isAlreadyInstalled(packageName) {
+  const pkgPath = resolve2(process.cwd(), "package.json");
+  if (!existsSync3(pkgPath)) return false;
+  try {
+    const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
+    const deps = { ...pkg.dependencies, ...pkg.devDependencies };
+    return packageName in deps;
+  } catch {
+    return false;
+  }
+}
+async function addCommand(voiceName) {
+  const packageName = resolvePackageName(voiceName);
+  const pkgPath = resolve2(process.cwd(), "package.json");
+  if (!existsSync3(pkgPath)) {
+    console.error(
+      chalk3.red("No package.json found in the current directory.")
+    );
+    console.error(
+      chalk3.dim('Run "tutti-ai init" to create a new project first.')
+    );
+    process.exit(1);
+  }
+  if (isAlreadyInstalled(packageName)) {
+    console.log(chalk3.green(`  \u2714 ${packageName} is already installed`));
+    return;
+  }
+  const spinner = ora2(`Installing ${packageName}...`).start();
+  try {
+    execSync(`npm install ${packageName}`, {
+      cwd: process.cwd(),
+      stdio: "pipe"
+    });
+    spinner.succeed(`Installed ${packageName}`);
+  } catch (error) {
+    spinner.fail(`Failed to install ${packageName}`);
+    const message = error instanceof Error ? error.message : String(error);
+    console.error(chalk3.red(message));
+    process.exit(1);
+  }
+  const official = OFFICIAL_VOICES[voiceName];
+  if (official) {
+    console.log();
+    console.log("  Setup:");
+    console.log(official.setup);
+    console.log();
+  } else {
+    console.log();
+    console.log(
+      chalk3.dim("  Check the package README for setup instructions.")
+    );
+    console.log();
+  }
+}
+
 // src/index.ts
 config();
 var program = new Command();
@@ -213,5 +309,8 @@ program.command("init [project-name]").description("Create a new Tutti project")
 program.command("run [score]").description("Run a Tutti score interactively").action(async (score) => {
   await runCommand(score);
 });
+program.command("add <voice>").description("Add a voice to your project").action(async (voice) => {
+  await addCommand(voice);
+});
 program.parse();
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/commands/init.ts","../src/commands/run.ts"],"sourcesContent":["import { config } from \"dotenv\";\nconfig();\n\nimport { Command } from \"commander\";\nimport { initCommand } from \"./commands/init.js\";\nimport { runCommand } from \"./commands/run.js\";\n\nconst program = new Command();\n\nprogram\n  .name(\"tutti-ai\")\n  .description(\"Tutti — multi-agent orchestration. All agents. All together.\")\n  .version(\"0.2.0\");\n\nprogram\n  .command(\"init [project-name]\")\n  .description(\"Create a new Tutti project\")\n  .action(async (projectName?: string) => {\n    await initCommand(projectName);\n  });\n\nprogram\n  .command(\"run [score]\")\n  .description(\"Run a Tutti score interactively\")\n  .action(async (score?: string) => {\n    await runCommand(score);\n  });\n\nprogram.parse();\n","import { mkdirSync, writeFileSync, existsSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport chalk from \"chalk\";\nimport Enquirer from \"enquirer\";\n\nconst { prompt } = Enquirer;\n\nexport async function initCommand(projectName?: string): Promise<void> {\n  if (!projectName) {\n    const response = await prompt<{ projectName: string }>({\n      type: \"input\",\n      name: \"projectName\",\n      message: \"Project name?\",\n    });\n    projectName = response.projectName;\n  }\n\n  if (!projectName) {\n    console.error(chalk.red(\"Project name is required.\"));\n    process.exit(1);\n  }\n\n  const dir = join(process.cwd(), projectName);\n\n  if (existsSync(dir)) {\n    console.error(chalk.red(`Directory already exists: ${projectName}/`));\n    process.exit(1);\n  }\n\n  mkdirSync(dir, { recursive: true });\n\n  const files: Record<string, string> = {\n    \"package.json\": JSON.stringify(\n      {\n        name: projectName,\n        version: \"0.0.1\",\n        type: \"module\",\n        scripts: {\n          dev: \"tsx watch tutti.score.ts\",\n          start: \"tsx tutti.score.ts\",\n        },\n        dependencies: {\n          \"@tuttiai/core\": \"*\",\n          \"@tuttiai/types\": \"*\",\n        },\n        devDependencies: {\n          tsx: \"^4.0.0\",\n          typescript: \"^5.7.0\",\n        },\n      },\n      null,\n      2,\n    ),\n\n    \".env.example\": \"ANTHROPIC_API_KEY=your_key_here\\n\",\n\n    \".gitignore\": \"node_modules\\ndist\\n.env\\n\",\n\n    \"tsconfig.json\": JSON.stringify(\n      {\n        compilerOptions: {\n          strict: true,\n          target: \"ES2022\",\n          module: \"ES2022\",\n          moduleResolution: \"bundler\",\n          esModuleInterop: true,\n          skipLibCheck: true,\n          outDir: \"dist\",\n          rootDir: \".\",\n        },\n        include: [\".\"],\n      },\n      null,\n      2,\n    ),\n\n    \"tutti.score.ts\": `import { defineScore, AnthropicProvider } from \"@tuttiai/core\"\n\nexport default defineScore({\n  provider: new AnthropicProvider(),\n  default_model: \"claude-sonnet-4-20250514\",\n  agents: {\n    assistant: {\n      name: \"Assistant\",\n      system_prompt: \"You are a helpful assistant.\",\n      voices: [],\n    }\n  }\n})\n`,\n\n    \"README.md\": `# ${projectName}\n\nA Tutti agent project. All agents. All together.\n\n## Setup\n\n\\`\\`\\`bash\ncp .env.example .env\n# Add your ANTHROPIC_API_KEY to .env\nnpm install\n\\`\\`\\`\n\n## Run\n\n\\`\\`\\`bash\nnpm run dev\n\\`\\`\\`\n`,\n  };\n\n  for (const [filename, content] of Object.entries(files)) {\n    writeFileSync(join(dir, filename), content);\n  }\n\n  console.log();\n  console.log(chalk.green(`  ✔ Created ${projectName}/`));\n  console.log();\n  console.log(\"  Next steps:\");\n  console.log(chalk.cyan(`    cd ${projectName}`));\n  console.log(chalk.cyan(\"    cp .env.example .env\"));\n  console.log(chalk.cyan(\"    npm install\"));\n  console.log(chalk.cyan(\"    npm run dev\"));\n  console.log();\n}\n","import { existsSync } from \"node:fs\";\nimport { resolve } from \"node:path\";\nimport { createInterface } from \"node:readline/promises\";\nimport chalk from \"chalk\";\nimport ora from \"ora\";\nimport { TuttiRuntime, ScoreLoader } from \"@tuttiai/core\";\n\nexport async function runCommand(scorePath?: string): Promise<void> {\n  const file = resolve(scorePath ?? \"./tutti.score.ts\");\n\n  if (!existsSync(file)) {\n    console.error(chalk.red(`Score file not found: ${file}`));\n    console.error(\n      chalk.dim('Run \"tutti-ai init\" to create a new project.'),\n    );\n    process.exit(1);\n  }\n\n  let score;\n  try {\n    score = await ScoreLoader.load(file);\n  } catch (err) {\n    console.error(\n      chalk.red(\n        `Failed to load score: ${err instanceof Error ? err.message : err}`,\n      ),\n    );\n    process.exit(1);\n  }\n\n  const runtime = new TuttiRuntime(score);\n  const spinner = ora({ color: \"cyan\" });\n\n  // Event-based execution trace\n  runtime.events.on(\"agent:start\", (e) => {\n    console.log(chalk.cyan(`Running agent: ${e.agent_name}`));\n  });\n\n  runtime.events.on(\"llm:request\", () => {\n    spinner.start(\"Thinking...\");\n  });\n\n  runtime.events.on(\"llm:response\", () => {\n    spinner.stop();\n  });\n\n  runtime.events.on(\"tool:start\", (e) => {\n    console.log(chalk.dim(`  Using tool: ${e.tool_name}`));\n  });\n\n  runtime.events.on(\"tool:end\", (e) => {\n    console.log(chalk.dim(`  Done: ${e.tool_name}`));\n  });\n\n  runtime.events.on(\"tool:error\", (e) => {\n    console.log(chalk.red(`  Error in tool: ${e.tool_name}`));\n  });\n\n  // REPL\n  const rl = createInterface({\n    input: process.stdin,\n    output: process.stdout,\n  });\n\n  console.log(chalk.dim('Tutti REPL — type \"exit\" to quit\\n'));\n\n  let sessionId: string | undefined;\n\n  // Handle Ctrl+C\n  process.on(\"SIGINT\", () => {\n    console.log(chalk.dim(\"\\nGoodbye!\"));\n    rl.close();\n    process.exit(0);\n  });\n\n  try {\n    while (true) {\n      const input = await rl.question(chalk.cyan(\"> \"));\n      const trimmed = input.trim();\n\n      if (!trimmed) continue;\n      if (trimmed === \"exit\" || trimmed === \"quit\") break;\n\n      try {\n        const result = await runtime.run(\"assistant\", trimmed, sessionId);\n        sessionId = result.session_id;\n        console.log(`\\n${result.output}\\n`);\n      } catch (err) {\n        spinner.stop();\n        console.error(\n          chalk.red(\n            `Error: ${err instanceof Error ? err.message : err}`,\n          ),\n        );\n      }\n    }\n  } catch {\n    // readline closed\n  }\n\n  console.log(chalk.dim(\"Goodbye!\"));\n  rl.close();\n  process.exit(0);\n}\n"],"mappings":"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","names":["existsSync","chalk"]}
+{"version":3,"sources":["../src/index.ts","../src/commands/init.ts","../src/commands/run.ts","../src/commands/add.ts"],"sourcesContent":["import { config } from \"dotenv\";\nconfig();\n\nimport { Command } from \"commander\";\nimport { initCommand } from \"./commands/init.js\";\nimport { runCommand } from \"./commands/run.js\";\nimport { addCommand } from \"./commands/add.js\";\n\nconst program = new Command();\n\nprogram\n  .name(\"tutti-ai\")\n  .description(\"Tutti — multi-agent orchestration. All agents. All together.\")\n  .version(\"0.2.0\");\n\nprogram\n  .command(\"init [project-name]\")\n  .description(\"Create a new Tutti project\")\n  .action(async (projectName?: string) => {\n    await initCommand(projectName);\n  });\n\nprogram\n  .command(\"run [score]\")\n  .description(\"Run a Tutti score interactively\")\n  .action(async (score?: string) => {\n    await runCommand(score);\n  });\n\nprogram\n  .command(\"add <voice>\")\n  .description(\"Add a voice to your project\")\n  .action(async (voice: string) => {\n    await addCommand(voice);\n  });\n\nprogram.parse();\n","import { mkdirSync, writeFileSync, existsSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport chalk from \"chalk\";\nimport Enquirer from \"enquirer\";\n\nconst { prompt } = Enquirer;\n\nexport async function initCommand(projectName?: string): Promise<void> {\n  if (!projectName) {\n    const response = await prompt<{ projectName: string }>({\n      type: \"input\",\n      name: \"projectName\",\n      message: \"Project name?\",\n    });\n    projectName = response.projectName;\n  }\n\n  if (!projectName) {\n    console.error(chalk.red(\"Project name is required.\"));\n    process.exit(1);\n  }\n\n  const dir = join(process.cwd(), projectName);\n\n  if (existsSync(dir)) {\n    console.error(chalk.red(`Directory already exists: ${projectName}/`));\n    process.exit(1);\n  }\n\n  mkdirSync(dir, { recursive: true });\n\n  const files: Record<string, string> = {\n    \"package.json\": JSON.stringify(\n      {\n        name: projectName,\n        version: \"0.0.1\",\n        type: \"module\",\n        scripts: {\n          dev: \"tsx watch tutti.score.ts\",\n          start: \"tsx tutti.score.ts\",\n        },\n        dependencies: {\n          \"@tuttiai/core\": \"*\",\n          \"@tuttiai/types\": \"*\",\n        },\n        devDependencies: {\n          tsx: \"^4.0.0\",\n          typescript: \"^5.7.0\",\n        },\n      },\n      null,\n      2,\n    ),\n\n    \".env.example\": \"ANTHROPIC_API_KEY=your_key_here\\n\",\n\n    \".gitignore\": \"node_modules\\ndist\\n.env\\n\",\n\n    \"tsconfig.json\": JSON.stringify(\n      {\n        compilerOptions: {\n          strict: true,\n          target: \"ES2022\",\n          module: \"ES2022\",\n          moduleResolution: \"bundler\",\n          esModuleInterop: true,\n          skipLibCheck: true,\n          outDir: \"dist\",\n          rootDir: \".\",\n        },\n        include: [\".\"],\n      },\n      null,\n      2,\n    ),\n\n    \"tutti.score.ts\": `import { defineScore, AnthropicProvider } from \"@tuttiai/core\"\n\nexport default defineScore({\n  provider: new AnthropicProvider(),\n  default_model: \"claude-sonnet-4-20250514\",\n  agents: {\n    assistant: {\n      name: \"Assistant\",\n      system_prompt: \"You are a helpful assistant.\",\n      voices: [],\n    }\n  }\n})\n`,\n\n    \"README.md\": `# ${projectName}\n\nA Tutti agent project. All agents. All together.\n\n## Setup\n\n\\`\\`\\`bash\ncp .env.example .env\n# Add your ANTHROPIC_API_KEY to .env\nnpm install\n\\`\\`\\`\n\n## Run\n\n\\`\\`\\`bash\nnpm run dev\n\\`\\`\\`\n`,\n  };\n\n  for (const [filename, content] of Object.entries(files)) {\n    writeFileSync(join(dir, filename), content);\n  }\n\n  console.log();\n  console.log(chalk.green(`  ✔ Created ${projectName}/`));\n  console.log();\n  console.log(\"  Next steps:\");\n  console.log(chalk.cyan(`    cd ${projectName}`));\n  console.log(chalk.cyan(\"    cp .env.example .env\"));\n  console.log(chalk.cyan(\"    npm install\"));\n  console.log(chalk.cyan(\"    npm run dev\"));\n  console.log();\n}\n","import { existsSync } from \"node:fs\";\nimport { resolve } from \"node:path\";\nimport { createInterface } from \"node:readline/promises\";\nimport chalk from \"chalk\";\nimport ora from \"ora\";\nimport { TuttiRuntime, ScoreLoader } from \"@tuttiai/core\";\n\nexport async function runCommand(scorePath?: string): Promise<void> {\n  const file = resolve(scorePath ?? \"./tutti.score.ts\");\n\n  if (!existsSync(file)) {\n    console.error(chalk.red(`Score file not found: ${file}`));\n    console.error(\n      chalk.dim('Run \"tutti-ai init\" to create a new project.'),\n    );\n    process.exit(1);\n  }\n\n  let score;\n  try {\n    score = await ScoreLoader.load(file);\n  } catch (err) {\n    console.error(\n      chalk.red(\n        `Failed to load score: ${err instanceof Error ? err.message : err}`,\n      ),\n    );\n    process.exit(1);\n  }\n\n  const runtime = new TuttiRuntime(score);\n  const spinner = ora({ color: \"cyan\" });\n\n  // Event-based execution trace\n  runtime.events.on(\"agent:start\", (e) => {\n    console.log(chalk.cyan(`Running agent: ${e.agent_name}`));\n  });\n\n  runtime.events.on(\"llm:request\", () => {\n    spinner.start(\"Thinking...\");\n  });\n\n  runtime.events.on(\"llm:response\", () => {\n    spinner.stop();\n  });\n\n  runtime.events.on(\"tool:start\", (e) => {\n    console.log(chalk.dim(`  Using tool: ${e.tool_name}`));\n  });\n\n  runtime.events.on(\"tool:end\", (e) => {\n    console.log(chalk.dim(`  Done: ${e.tool_name}`));\n  });\n\n  runtime.events.on(\"tool:error\", (e) => {\n    console.log(chalk.red(`  Error in tool: ${e.tool_name}`));\n  });\n\n  // REPL\n  const rl = createInterface({\n    input: process.stdin,\n    output: process.stdout,\n  });\n\n  console.log(chalk.dim('Tutti REPL — type \"exit\" to quit\\n'));\n\n  let sessionId: string | undefined;\n\n  // Handle Ctrl+C\n  process.on(\"SIGINT\", () => {\n    console.log(chalk.dim(\"\\nGoodbye!\"));\n    rl.close();\n    process.exit(0);\n  });\n\n  try {\n    while (true) {\n      const input = await rl.question(chalk.cyan(\"> \"));\n      const trimmed = input.trim();\n\n      if (!trimmed) continue;\n      if (trimmed === \"exit\" || trimmed === \"quit\") break;\n\n      try {\n        const result = await runtime.run(\"assistant\", trimmed, sessionId);\n        sessionId = result.session_id;\n        console.log(`\\n${result.output}\\n`);\n      } catch (err) {\n        spinner.stop();\n        console.error(\n          chalk.red(\n            `Error: ${err instanceof Error ? err.message : err}`,\n          ),\n        );\n      }\n    }\n  } catch {\n    // readline closed\n  }\n\n  console.log(chalk.dim(\"Goodbye!\"));\n  rl.close();\n  process.exit(0);\n}\n","import { existsSync, readFileSync } from \"node:fs\";\nimport { resolve } from \"node:path\";\nimport { execSync } from \"node:child_process\";\nimport chalk from \"chalk\";\nimport ora from \"ora\";\n\nconst OFFICIAL_VOICES: Record<string, { package: string; setup: string }> = {\n  filesystem: {\n    package: \"@tuttiai/filesystem\",\n    setup: `  Add to your score:\n    ${chalk.cyan('import { FilesystemVoice } from \"@tuttiai/filesystem\"')}\n    ${chalk.cyan(\"voices: [new FilesystemVoice()]\")}`,\n  },\n  github: {\n    package: \"@tuttiai/github\",\n    setup: `  Add ${chalk.bold(\"GITHUB_TOKEN\")} to your .env file:\n    ${chalk.cyan(\"GITHUB_TOKEN=ghp_your_token_here\")}\n\n  Add to your score:\n    ${chalk.cyan('import { GitHubVoice } from \"@tuttiai/github\"')}\n    ${chalk.cyan(\"voices: [new GitHubVoice()]\")}`,\n  },\n  playwright: {\n    package: \"@tuttiai/playwright\",\n    setup: `  Install the browser:\n    ${chalk.cyan(\"npx playwright install chromium\")}\n\n  Add to your score:\n    ${chalk.cyan('import { PlaywrightVoice } from \"@tuttiai/playwright\"')}\n    ${chalk.cyan(\"voices: [new PlaywrightVoice()]\")}`,\n  },\n};\n\nfunction resolvePackageName(input: string): string {\n  // Known official voice\n  if (OFFICIAL_VOICES[input]) {\n    return OFFICIAL_VOICES[input].package;\n  }\n  // Already a scoped package\n  if (input.startsWith(\"@\")) {\n    return input;\n  }\n  // Try @tuttiai/<name> convention\n  return `@tuttiai/${input}`;\n}\n\nfunction isAlreadyInstalled(packageName: string): boolean {\n  const pkgPath = resolve(process.cwd(), \"package.json\");\n  if (!existsSync(pkgPath)) return false;\n\n  try {\n    const pkg = JSON.parse(readFileSync(pkgPath, \"utf-8\"));\n    const deps = { ...pkg.dependencies, ...pkg.devDependencies };\n    return packageName in deps;\n  } catch {\n    return false;\n  }\n}\n\nexport async function addCommand(voiceName: string): Promise<void> {\n  const packageName = resolvePackageName(voiceName);\n\n  // Check if package.json exists in cwd\n  const pkgPath = resolve(process.cwd(), \"package.json\");\n  if (!existsSync(pkgPath)) {\n    console.error(\n      chalk.red(\"No package.json found in the current directory.\"),\n    );\n    console.error(\n      chalk.dim('Run \"tutti-ai init\" to create a new project first.'),\n    );\n    process.exit(1);\n  }\n\n  // Check if already installed\n  if (isAlreadyInstalled(packageName)) {\n    console.log(chalk.green(`  ✔ ${packageName} is already installed`));\n    return;\n  }\n\n  // Install\n  const spinner = ora(`Installing ${packageName}...`).start();\n\n  try {\n    execSync(`npm install ${packageName}`, {\n      cwd: process.cwd(),\n      stdio: \"pipe\",\n    });\n    spinner.succeed(`Installed ${packageName}`);\n  } catch (error) {\n    spinner.fail(`Failed to install ${packageName}`);\n    const message =\n      error instanceof Error ? error.message : String(error);\n    console.error(chalk.red(message));\n    process.exit(1);\n  }\n\n  // Print setup instructions\n  const official = OFFICIAL_VOICES[voiceName];\n  if (official) {\n    console.log();\n    console.log(\"  Setup:\");\n    console.log(official.setup);\n    console.log();\n  } else {\n    console.log();\n    console.log(\n      chalk.dim(\"  Check the package README for setup instructions.\"),\n    );\n    console.log();\n  }\n}\n"],"mappings":"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","names":["existsSync","chalk","existsSync","resolve","chalk","ora"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tuttiai/cli",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Tutti CLI — scaffold and run multi-agent projects",
   "type": "module",
   "bin": {
@@ -21,8 +21,8 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@tuttiai/core": "^0.1.0",
-    "@tuttiai/types": "^0.1.0",
+    "@tuttiai/core": "^0.3.0",
+    "@tuttiai/types": "^0.2.0",
     "chalk": "^5.4.0",
     "commander": "^13.1.0",
     "dotenv": "^17.4.1",