@tuttiai/cli 0.9.0 → 0.11.0

package/dist/index.js

@@ -2,7 +2,7 @@
 
 // src/index.ts
 import { config } from "dotenv";
-import { createLogger as createLogger10 } from "@tuttiai/core";
+import { createLogger as createLogger11 } from "@tuttiai/core";
 import { Command } from "commander";
 
 // src/commands/init.ts
@@ -356,7 +356,7 @@ function templatesCommand() {
 
 // src/commands/run.ts
 import { existsSync as existsSync2 } from "fs";
-import { resolve } from "path";
+import { resolve as resolve2 } from "path";
 import { createInterface } from "readline/promises";
 import chalk2 from "chalk";
 import ora from "ora";
@@ -367,11 +367,122 @@ import {
   OpenAIProvider,
   GeminiProvider,
   SecretsManager,
+  InMemorySessionStore,
   createLogger as createLogger2
 } from "@tuttiai/core";
+
+// src/watch/score-watcher.ts
+import { dirname, resolve } from "path";
+import { EventEmitter } from "events";
+import chokidar from "chokidar";
+import { validateScore } from "@tuttiai/core";
+var DEFAULT_DEBOUNCE_MS = 200;
+var DEFAULT_IGNORED = [
+  /(^|[/\\])\../,
+  // dotfiles (.git, .env, etc.)
+  /node_modules/,
+  /[/\\]dist[/\\]/,
+  /[/\\]coverage[/\\]/
+];
+async function defaultLoadScore(path) {
+  const absolute = resolve(path);
+  const { pathToFileURL } = await import("url");
+  const url = pathToFileURL(absolute).href + "?t=" + Date.now().toString(36);
+  const mod = await import(url);
+  if (!mod.default) {
+    throw new Error(
+      "Score file has no default export: " + path + " \u2014 your score must export `defineScore({ ... })` as its default."
+    );
+  }
+  validateScore(mod.default);
+  return mod.default;
+}
+var ReactiveScore = class extends EventEmitter {
+  _current;
+  scorePath;
+  load;
+  debounceMs;
+  watcher;
+  debounceTimer;
+  closed = false;
+  _pendingReload = false;
+  constructor(initialScore, scorePath, options = {}) {
+    super();
+    this._current = initialScore;
+    this.scorePath = resolve(scorePath);
+    this.load = options.load ?? defaultLoadScore;
+    this.debounceMs = options.debounceMs ?? DEFAULT_DEBOUNCE_MS;
+    const watchTargets = [
+      this.scorePath,
+      dirname(this.scorePath),
+      ...options.extraPaths ?? []
+    ];
+    this.watcher = chokidar.watch(watchTargets, {
+      ignored: DEFAULT_IGNORED,
+      ignoreInitial: true,
+      // awaitWriteFinish: guard against partial writes from editors that
+      // save atomically via rename/move.
+      awaitWriteFinish: {
+        stabilityThreshold: 50,
+        pollInterval: 20
+      }
+    });
+    this.watcher.on("change", (path) => this.handleChange(path));
+    this.watcher.on("add", (path) => this.handleChange(path));
+  }
+  /** The most recent successfully-loaded score. Never stale. */
+  get current() {
+    return this._current;
+  }
+  /**
+   * True when a file change has been observed and a reload is pending
+   * (or just completed and not yet consumed). Readers call
+   * {@link consumePendingReload} to clear the flag when they've taken
+   * action on the new config.
+   */
+  get pendingReload() {
+    return this._pendingReload;
+  }
+  consumePendingReload() {
+    this._pendingReload = false;
+  }
+  /** Release the underlying filesystem watchers. */
+  async close() {
+    this.closed = true;
+    if (this.debounceTimer) clearTimeout(this.debounceTimer);
+    await this.watcher.close();
+  }
+  /**
+   * Force an immediate reload without waiting for a filesystem event.
+   * Exposed for tests and for the `reload` REPL command.
+   */
+  async reloadNow() {
+    if (this.closed) return;
+    this.emit("reloading");
+    try {
+      const next = await this.load(this.scorePath);
+      this._current = next;
+      this._pendingReload = true;
+      this.emit("reloaded", next);
+    } catch (err) {
+      const error = err instanceof Error ? err : new Error(String(err));
+      this.emit("reload-failed", error);
+    }
+  }
+  handleChange(path) {
+    if (this.closed) return;
+    this.emit("file-change", path);
+    if (this.debounceTimer) clearTimeout(this.debounceTimer);
+    this.debounceTimer = setTimeout(() => {
+      void this.reloadNow();
+    }, this.debounceMs);
+  }
+};
+
+// src/commands/run.ts
 var logger2 = createLogger2("tutti-cli");
-async function runCommand(scorePath) {
-  const file = resolve(scorePath ?? "./tutti.score.ts");
+async function runCommand(scorePath, options = {}) {
+  const file = resolve2(scorePath ?? "./tutti.score.ts");
   if (!existsSync2(file)) {
     logger2.error({ file }, "Score file not found");
     console.error(chalk2.dim('Run "tutti-ai init" to create a new project.'));
@@ -401,90 +512,128 @@ async function runCommand(scorePath) {
       }
     }
   }
-  for (const agent of Object.values(score.agents)) {
-    agent.streaming = true;
-  }
-  const runtime = new TuttiRuntime(score);
+  const applyRunDefaults = (cfg) => {
+    for (const agent of Object.values(cfg.agents)) {
+      agent.streaming = true;
+    }
+  };
+  applyRunDefaults(score);
+  const sharedSessions = options.watch ? new InMemorySessionStore() : void 0;
   const spinner = ora({ color: "cyan" });
   let streaming = false;
-  runtime.events.on("agent:start", (e) => {
-    logger2.info({ agent: e.agent_name }, "Running agent");
-  });
-  runtime.events.on("llm:request", () => {
-    spinner.start("Thinking...");
-  });
-  runtime.events.on("token:stream", (e) => {
-    if (!streaming) {
-      spinner.stop();
-      streaming = true;
-    }
-    process.stdout.write(e.text);
-  });
-  runtime.events.on("llm:response", () => {
-    if (streaming) {
-      process.stdout.write("\n");
-    } else {
-      spinner.stop();
-    }
-  });
-  runtime.events.on("tool:start", (e) => {
-    if (streaming) {
-      process.stdout.write(chalk2.dim("\n  [using: " + e.tool_name + "]"));
-    } else {
-      spinner.stop();
-      console.log(chalk2.dim("  [using: " + e.tool_name + "]"));
-    }
-  });
-  runtime.events.on("tool:end", (e) => {
-    if (streaming) {
-      process.stdout.write(chalk2.dim("  [done: " + e.tool_name + "]\n"));
-    }
-  });
-  runtime.events.on("tool:error", (e) => {
-    spinner.stop();
-    logger2.error({ tool: e.tool_name }, "Tool error");
-  });
-  runtime.events.on("security:injection_detected", (e) => {
-    logger2.warn({ tool: e.tool_name }, "Potential prompt injection detected");
-  });
-  runtime.events.on("budget:warning", () => {
-    logger2.warn("Approaching token budget (80%)");
-  });
-  runtime.events.on("budget:exceeded", () => {
-    logger2.error("Token budget exceeded \u2014 stopping");
-  });
+  let runtime = buildRuntime(score, sharedSessions);
+  attachListeners(runtime);
   const rl = createInterface({
     input: process.stdin,
     output: process.stdout
   });
-  runtime.events.on("hitl:requested", (e) => {
-    spinner.stop();
-    if (streaming) {
-      process.stdout.write("\n");
-      streaming = false;
-    }
-    console.log();
-    console.log(chalk2.yellow("  " + chalk2.bold("[Agent needs input]") + " " + e.question));
-    if (e.options) {
-      e.options.forEach((opt, i) => {
-        console.log(chalk2.yellow("    " + (i + 1) + ". " + opt));
+  function attachListeners(r) {
+    r.events.on("agent:start", (e) => {
+      logger2.info({ agent: e.agent_name }, "Running agent");
+    });
+    r.events.on("llm:request", () => {
+      spinner.start("Thinking...");
+    });
+    r.events.on("token:stream", (e) => {
+      if (!streaming) {
+        spinner.stop();
+        streaming = true;
+      }
+      process.stdout.write(e.text);
+    });
+    r.events.on("llm:response", () => {
+      if (streaming) {
+        process.stdout.write("\n");
+      } else {
+        spinner.stop();
+      }
+    });
+    r.events.on("tool:start", (e) => {
+      if (streaming) {
+        process.stdout.write(chalk2.dim("\n  [using: " + e.tool_name + "]"));
+      } else {
+        spinner.stop();
+        console.log(chalk2.dim("  [using: " + e.tool_name + "]"));
+      }
+    });
+    r.events.on("tool:end", (e) => {
+      if (streaming) {
+        process.stdout.write(chalk2.dim("  [done: " + e.tool_name + "]\n"));
+      }
+    });
+    r.events.on("tool:error", (e) => {
+      spinner.stop();
+      logger2.error({ tool: e.tool_name }, "Tool error");
+    });
+    r.events.on("security:injection_detected", (e) => {
+      logger2.warn({ tool: e.tool_name }, "Potential prompt injection detected");
+    });
+    r.events.on("budget:warning", () => {
+      logger2.warn("Approaching token budget (80%)");
+    });
+    r.events.on("budget:exceeded", () => {
+      logger2.error("Token budget exceeded \u2014 stopping");
+    });
+    r.events.on("hitl:requested", (e) => {
+      spinner.stop();
+      if (streaming) {
+        process.stdout.write("\n");
+        streaming = false;
+      }
+      console.log();
+      console.log(
+        chalk2.yellow(
+          "  " + chalk2.bold("[Agent needs input]") + " " + e.question
+        )
+      );
+      if (e.options) {
+        e.options.forEach((opt, i) => {
+          console.log(chalk2.yellow("    " + (i + 1) + ". " + opt));
+        });
+      }
+      void rl.question(chalk2.yellow("  > ")).then((answer) => {
+        runtime.answer(e.session_id, answer.trim());
       });
-    }
-    void rl.question(chalk2.yellow("  > ")).then((answer) => {
-      runtime.answer(e.session_id, answer.trim());
     });
-  });
+  }
+  let reactive;
+  if (options.watch) {
+    reactive = new ReactiveScore(score, file);
+    reactive.on("file-change", () => {
+      console.log(chalk2.cyan("\n[tutti] Score changed, reloading..."));
+    });
+    reactive.on("reloaded", () => {
+      console.log(chalk2.green("[tutti] Score reloaded. Changes applied."));
+    });
+    reactive.on("reload-failed", (err) => {
+      logger2.error(
+        { error: err instanceof Error ? err.message : String(err) },
+        "[tutti] Reload failed \u2014 using previous config"
+      );
+    });
+  }
   console.log(chalk2.dim('Tutti REPL \u2014 type "exit" to quit\n'));
+  if (options.watch) {
+    console.log(chalk2.dim("Watching " + file + " for changes\u2026\n"));
+  }
   let sessionId;
   process.on("SIGINT", () => {
     if (streaming) process.stdout.write("\n");
     spinner.stop();
     console.log(chalk2.dim("Goodbye!"));
     rl.close();
+    if (reactive) void reactive.close();
     process.exit(0);
   });
   try {
     while (true) {
+      if (reactive?.pendingReload) {
+        const nextScore = reactive.current;
+        applyRunDefaults(nextScore);
+        runtime = buildRuntime(nextScore, sharedSessions);
+        attachListeners(runtime);
+        reactive.consumePendingReload();
+      }
       const input = await rl.question(chalk2.cyan("> "));
       const trimmed = input.trim();
       if (!trimmed) continue;
@@ -511,12 +660,19 @@ async function runCommand(scorePath) {
   }
   console.log(chalk2.dim("Goodbye!"));
   rl.close();
+  if (reactive) await reactive.close();
   process.exit(0);
 }
+function buildRuntime(score, sessionStore) {
+  return new TuttiRuntime(
+    score,
+    sessionStore ? { sessionStore } : {}
+  );
+}
 
 // src/commands/resume.ts
 import { existsSync as existsSync3 } from "fs";
-import { resolve as resolve2 } from "path";
+import { resolve as resolve3 } from "path";
 import { createInterface as createInterface2 } from "readline/promises";
 import chalk3 from "chalk";
 import ora2 from "ora";
@@ -532,7 +688,7 @@ import {
 } from "@tuttiai/core";
 var logger3 = createLogger3("tutti-cli");
 async function resumeCommand(sessionId, opts) {
-  const scoreFile = resolve2(opts.score ?? "./tutti.score.ts");
+  const scoreFile = resolve3(opts.score ?? "./tutti.score.ts");
   if (!existsSync3(scoreFile)) {
     logger3.error({ file: scoreFile }, "Score file not found");
     console.error(chalk3.dim('Run "tutti-ai init" to create a new project.'));
@@ -776,7 +932,7 @@ function wireProgress(runtime) {
 
 // src/commands/add.ts
 import { existsSync as existsSync4, readFileSync } from "fs";
-import { resolve as resolve3 } from "path";
+import { resolve as resolve4 } from "path";
 import { execSync } from "child_process";
 import chalk4 from "chalk";
 import ora3 from "ora";
@@ -832,7 +988,7 @@ function resolvePackageName(input) {
   return `@tuttiai/${input}`;
 }
 function isAlreadyInstalled(packageName) {
-  const pkgPath = resolve3(process.cwd(), "package.json");
+  const pkgPath = resolve4(process.cwd(), "package.json");
   if (!existsSync4(pkgPath)) return false;
   try {
     const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
@@ -844,7 +1000,7 @@ function isAlreadyInstalled(packageName) {
 }
 function addCommand(voiceName) {
   const packageName = resolvePackageName(voiceName);
-  const pkgPath = resolve3(process.cwd(), "package.json");
+  const pkgPath = resolve4(process.cwd(), "package.json");
   if (!existsSync4(pkgPath)) {
     logger4.error("No package.json found in the current directory");
     console.error(chalk4.dim('Run "tutti-ai init" to create a new project first.'));
@@ -884,7 +1040,7 @@ function addCommand(voiceName) {
 
 // src/commands/check.ts
 import { existsSync as existsSync5 } from "fs";
-import { resolve as resolve4 } from "path";
+import { resolve as resolve5 } from "path";
 import chalk5 from "chalk";
 import {
   ScoreLoader as ScoreLoader3,
@@ -898,7 +1054,7 @@ var logger5 = createLogger5("tutti-cli");
 var ok = (msg) => console.log(chalk5.green("  \u2714 " + msg));
 var fail = (msg) => console.log(chalk5.red("  \u2718 " + msg));
 async function checkCommand(scorePath) {
-  const file = resolve4(scorePath ?? "./tutti.score.ts");
+  const file = resolve5(scorePath ?? "./tutti.score.ts");
   console.log(chalk5.cyan(`
 Checking ${file}...
 `));
@@ -981,7 +1137,7 @@ Checking ${file}...
 
 // src/commands/studio.ts
 import { existsSync as existsSync6 } from "fs";
-import { resolve as resolve5 } from "path";
+import { resolve as resolve6 } from "path";
 import { execFile } from "child_process";
 import express from "express";
 import chalk6 from "chalk";
@@ -1009,7 +1165,7 @@ function openBrowser(url) {
   execFile(cmd, [url]);
 }
 async function studioCommand(scorePath) {
-  const file = resolve5(scorePath ?? "./tutti.score.ts");
+  const file = resolve6(scorePath ?? "./tutti.score.ts");
   if (!existsSync6(file)) {
     logger6.error({ file }, "Score file not found");
     console.error(chalk6.dim('Run "tutti-ai init" to create a new project.'));
@@ -1144,7 +1300,7 @@ function getStudioHtml() {
 
 // src/commands/search.ts
 import { existsSync as existsSync7, readFileSync as readFileSync2 } from "fs";
-import { resolve as resolve6 } from "path";
+import { resolve as resolve7 } from "path";
 import chalk7 from "chalk";
 import ora4 from "ora";
 import { createLogger as createLogger7 } from "@tuttiai/core";
@@ -1215,7 +1371,7 @@ function matchesQuery(voice, query) {
   return false;
 }
 function isInstalled(packageName) {
-  const pkgPath = resolve6(process.cwd(), "package.json");
+  const pkgPath = resolve7(process.cwd(), "package.json");
   if (!existsSync7(pkgPath)) return false;
   try {
     const pkg = JSON.parse(readFileSync2(pkgPath, "utf-8"));
@@ -1288,7 +1444,7 @@ async function voicesCommand() {
 
 // src/commands/publish.ts
 import { existsSync as existsSync8, readFileSync as readFileSync3 } from "fs";
-import { resolve as resolve7 } from "path";
+import { resolve as resolve8 } from "path";
 import { execSync as execSync2 } from "child_process";
 import chalk8 from "chalk";
 import ora5 from "ora";
@@ -1297,7 +1453,7 @@ import { createLogger as createLogger8, SecretsManager as SecretsManager4 } from
 var { prompt: prompt2 } = Enquirer2;
 var logger8 = createLogger8("tutti-cli");
 function readPkg(dir) {
-  const p = resolve7(dir, "package.json");
+  const p = resolve8(dir, "package.json");
   if (!existsSync8(p)) return void 0;
   return JSON.parse(readFileSync3(p, "utf-8"));
 }
@@ -1317,7 +1473,7 @@ async function publishCommand(opts) {
   console.log();
   const spinner = ora5("Running pre-flight checks...").start();
   if (!pkg) fail2("No package.json found in the current directory.");
-  if (!existsSync8(resolve7(cwd, "src/index.ts"))) fail2("No src/index.ts found \u2014 are you inside a voice directory?");
+  if (!existsSync8(resolve8(cwd, "src/index.ts"))) fail2("No src/index.ts found \u2014 are you inside a voice directory?");
   const missing = [];
   if (!pkg.name) missing.push("name");
   if (!pkg.version) missing.push("version");
@@ -1329,7 +1485,7 @@ async function publishCommand(opts) {
   const version = pkg.version;
   const validName = name.startsWith("@tuttiai/") || name.startsWith("tutti");
   if (!validName) fail2("Package name must start with @tuttiai/ or tutti \u2014 got: " + name);
-  const src = readFileSync3(resolve7(cwd, "src/index.ts"), "utf-8");
+  const src = readFileSync3(resolve8(cwd, "src/index.ts"), "utf-8");
   if (!src.includes("required_permissions")) {
     fail2("Voice class must declare required_permissions in src/index.ts");
   }
@@ -1510,7 +1666,7 @@ async function openRegistryPR(packageName, version, description, token) {
 
 // src/commands/eval.ts
 import { existsSync as existsSync9, readFileSync as readFileSync4 } from "fs";
-import { resolve as resolve8 } from "path";
+import { resolve as resolve9 } from "path";
 import chalk9 from "chalk";
 import ora6 from "ora";
 import {
@@ -1521,7 +1677,7 @@ import {
 } from "@tuttiai/core";
 var logger9 = createLogger9("tutti-cli");
 async function evalCommand(suitePath, opts) {
-  const suiteFile = resolve8(suitePath);
+  const suiteFile = resolve9(suitePath);
   if (!existsSync9(suiteFile)) {
     logger9.error({ file: suiteFile }, "Suite file not found");
     process.exit(1);
@@ -1533,7 +1689,7 @@ async function evalCommand(suitePath, opts) {
     logger9.error({ error: err instanceof Error ? err.message : String(err) }, "Failed to parse suite file");
     process.exit(1);
   }
-  const scoreFile = resolve8(opts.score ?? "./tutti.score.ts");
+  const scoreFile = resolve9(opts.score ?? "./tutti.score.ts");
   if (!existsSync9(scoreFile)) {
     logger9.error({ file: scoreFile }, "Score file not found");
     process.exit(1);
@@ -1559,27 +1715,178 @@ async function evalCommand(suitePath, opts) {
   }
 }
 
+// src/commands/serve.ts
+import { existsSync as existsSync10 } from "fs";
+import { resolve as resolve10 } from "path";
+import chalk10 from "chalk";
+import {
+  TuttiRuntime as TuttiRuntime4,
+  ScoreLoader as ScoreLoader6,
+  AnthropicProvider as AnthropicProvider4,
+  OpenAIProvider as OpenAIProvider4,
+  GeminiProvider as GeminiProvider4,
+  SecretsManager as SecretsManager5,
+  InMemorySessionStore as InMemorySessionStore2,
+  createLogger as createLogger10
+} from "@tuttiai/core";
+import { createServer, DEFAULT_PORT, SERVER_VERSION } from "@tuttiai/server";
+var logger10 = createLogger10("tutti-serve");
+async function serveCommand(scorePath, options = {}) {
+  const file = resolve10(scorePath ?? "./tutti.score.ts");
+  if (!existsSync10(file)) {
+    logger10.error({ file }, "Score file not found");
+    console.error(chalk10.dim('Run "tutti-ai init" to create a new project.'));
+    process.exit(1);
+  }
+  let score;
+  try {
+    score = await ScoreLoader6.load(file);
+  } catch (err) {
+    logger10.error(
+      { error: err instanceof Error ? err.message : String(err) },
+      "Failed to load score"
+    );
+    process.exit(1);
+  }
+  const providerKeyMap = [
+    [AnthropicProvider4, "ANTHROPIC_API_KEY"],
+    [OpenAIProvider4, "OPENAI_API_KEY"],
+    [GeminiProvider4, "GEMINI_API_KEY"]
+  ];
+  for (const [ProviderClass, envVar] of providerKeyMap) {
+    if (score.provider instanceof ProviderClass) {
+      const key = SecretsManager5.optional(envVar);
+      if (!key) {
+        logger10.error({ envVar }, "Missing API key");
+        process.exit(1);
+      }
+    }
+  }
+  const agentNames = Object.keys(score.agents);
+  const agentName = options.agent ?? (typeof score.entry === "string" ? score.entry : void 0) ?? agentNames[0];
+  if (!agentName || !score.agents[agentName]) {
+    logger10.error(
+      { requested: agentName, available: agentNames },
+      "Agent not found in score"
+    );
+    process.exit(1);
+  }
+  const port = parsePort(options.port);
+  const host = options.host ?? "0.0.0.0";
+  const sharedSessions = options.watch ? new InMemorySessionStore2() : void 0;
+  let runtime = buildRuntime2(score, sharedSessions);
+  let app = await buildApp(runtime, agentName, port, host, options.apiKey);
+  let reactive;
+  if (options.watch) {
+    reactive = new ReactiveScore(score, file);
+    reactive.on("file-change", () => {
+      console.log(chalk10.cyan("\n[tutti] Score changed, reloading..."));
+    });
+    reactive.on("reloaded", async () => {
+      try {
+        const nextScore = reactive.current;
+        const nextRuntime = buildRuntime2(nextScore, sharedSessions);
+        const nextApp = await buildApp(nextRuntime, agentName, port, host, options.apiKey);
+        await app.close();
+        runtime = nextRuntime;
+        app = nextApp;
+        await app.listen({ port, host });
+        console.log(chalk10.green("[tutti] Score reloaded. Server restarted."));
+      } catch (err) {
+        logger10.error(
+          { error: err instanceof Error ? err.message : String(err) },
+          "[tutti] Reload failed \u2014 server continues with previous config"
+        );
+      }
+    });
+    reactive.on("reload-failed", (err) => {
+      logger10.error(
+        { error: err instanceof Error ? err.message : String(err) },
+        "[tutti] Reload failed \u2014 server continues with previous config"
+      );
+    });
+  }
+  await app.listen({ port, host });
+  printBanner(port, host, agentName, score, file, options.watch);
+  const shutdown = async (signal) => {
+    console.log(chalk10.dim("\n" + signal + " received \u2014 shutting down..."));
+    if (reactive) await reactive.close();
+    await app.close();
+    process.exit(0);
+  };
+  process.on("SIGINT", () => void shutdown("SIGINT"));
+  process.on("SIGTERM", () => void shutdown("SIGTERM"));
+}
+function parsePort(raw) {
+  if (raw === void 0) return DEFAULT_PORT;
+  const n = Number.parseInt(raw, 10);
+  if (!Number.isInteger(n) || n < 1 || n > 65535) {
+    logger10.error({ port: raw }, "Invalid port number");
+    process.exit(1);
+  }
+  return n;
+}
+function buildRuntime2(score, sessionStore) {
+  return new TuttiRuntime4(
+    score,
+    sessionStore ? { sessionStore } : {}
+  );
+}
+async function buildApp(runtime, agentName, port, host, apiKey) {
+  return createServer({
+    port,
+    host,
+    runtime,
+    agent_name: agentName,
+    api_key: apiKey
+  });
+}
+function printBanner(port, host, agentName, score, file, watch) {
+  const display = host === "0.0.0.0" || host === "::" ? "localhost" : host;
+  const url = "http://" + display + ":" + port;
+  console.log();
+  console.log(chalk10.bold("  Tutti Server v" + SERVER_VERSION));
+  console.log(chalk10.dim("  " + url));
+  console.log();
+  console.log(chalk10.dim("  Score:  ") + (score.name ?? file));
+  console.log(chalk10.dim("  Agent:  ") + agentName);
+  console.log(chalk10.dim("  Agents: ") + Object.keys(score.agents).join(", "));
+  if (watch) {
+    console.log(chalk10.dim("  Watch:  ") + chalk10.cyan("enabled"));
+  }
+  console.log();
+  console.log(chalk10.dim("  Endpoints:"));
+  console.log(chalk10.dim("    POST  ") + url + "/run");
+  console.log(chalk10.dim("    POST  ") + url + "/run/stream");
+  console.log(chalk10.dim("    GET   ") + url + "/sessions/:id");
+  console.log(chalk10.dim("    GET   ") + url + "/health");
+  console.log();
+}
+
 // src/index.ts
 config();
-var logger10 = createLogger10("tutti-cli");
+var logger11 = createLogger11("tutti-cli");
 process.on("unhandledRejection", (reason) => {
-  logger10.error({ error: reason instanceof Error ? reason.message : String(reason) }, "Unhandled rejection");
+  logger11.error({ error: reason instanceof Error ? reason.message : String(reason) }, "Unhandled rejection");
   process.exit(1);
 });
 process.on("uncaughtException", (err) => {
-  logger10.error({ error: err.message }, "Fatal error");
+  logger11.error({ error: err.message }, "Fatal error");
   process.exit(1);
 });
 var program = new Command();
-program.name("tutti-ai").description("Tutti \u2014 multi-agent orchestration. All agents. All together.").version("0.9.0");
+program.name("tutti-ai").description("Tutti \u2014 multi-agent orchestration. All agents. All together.").version("0.11.0");
 program.command("init [project-name]").description("Create a new Tutti project").option("-t, --template <id>", "Project template to use").action(async (projectName, opts) => {
   await initCommand(projectName, opts.template);
 });
 program.command("templates").description("List all available project templates").action(() => {
   templatesCommand();
 });
-program.command("run [score]").description("Run a Tutti score interactively").action(async (score) => {
-  await runCommand(score);
+program.command("run [score]").description("Run a Tutti score interactively").option("-w, --watch", "Reload the score on file changes").action(async (score, opts) => {
+  await runCommand(score, { watch: opts.watch });
+});
+program.command("serve [score]").description("Start the Tutti HTTP server").option("-p, --port <number>", "Port to listen on (default: 3847)").option("-H, --host <address>", "Host to bind to (default: 0.0.0.0)").option("-k, --api-key <key>", "API key for bearer auth (or set TUTTI_API_KEY)").option("-a, --agent <name>", "Agent to expose (default: score entry or first agent)").option("-w, --watch", "Reload the score on file changes").action(async (score, opts) => {
+  await serveCommand(score, opts);
 });
 program.command("resume <session-id>").description("Resume a crashed or interrupted run from its last checkpoint").option(
   "--store <backend>",