@hasna/recordings 0.1.23 → 0.1.25

package/dist/mcp/index.js

@@ -4920,7 +4920,7 @@ var require_lib2 = __commonJS((exports, module) => {
 var require_package = __commonJS((exports, module) => {
   module.exports = {
     name: "@hasna/recordings",
-    version: "0.1.23",
+    version: "0.1.25",
     type: "module",
     description: "Speech-to-text recording tool with MCP and CLI \u2014 records, transcribes, and optionally enhances text using AI",
     repository: {
@@ -4937,13 +4937,18 @@ var require_package = __commonJS((exports, module) => {
       ".": {
         import: "./dist/index.js",
         types: "./dist/index.d.ts"
+      },
+      "./storage": {
+        import: "./dist/storage.js",
+        types: "./dist/storage.d.ts"
       }
     },
     scripts: {
-      build: "bun run build:cli && bun run build:mcp && bun run build:lib && tsc --emitDeclarationOnly --outDir dist",
+      clean: "rm -rf dist",
+      build: "bun run clean && bun run build:cli && bun run build:mcp && bun run build:lib && tsc --emitDeclarationOnly --outDir dist",
       "build:cli": "bun build src/cli/index.ts --target=bun --outfile=dist/cli/index.js --external=commander --external=chalk --external=openai",
       "build:mcp": "bun build src/mcp/index.ts --target=bun --outfile=dist/mcp/index.js --external=@modelcontextprotocol/sdk --external=openai",
-      "build:lib": "bun build src/index.ts --target=bun --outfile=dist/index.js --external=openai",
+      "build:lib": "bun build src/index.ts src/storage.ts --target=bun --outdir=dist --external=openai",
       typecheck: "tsc --noEmit",
       test: "bun test",
       "test:coverage": "bun test --coverage",
@@ -4990,6 +4995,51 @@ var require_package = __commonJS((exports, module) => {
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 
+// src/mcp/http.ts
+import { WebStandardStreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/webStandardStreamableHttp.js";
+var DEFAULT_MCP_HTTP_PORT = 8873;
+var MCP_HTTP_HOST = "127.0.0.1";
+function isStdioMode(args) {
+  return args.includes("--stdio") || process.env.MCP_STDIO === "1";
+}
+function resolveMcpHttpPort(args) {
+  const portIdx = args.indexOf("--port");
+  if (portIdx >= 0 && args[portIdx + 1]) {
+    return Number(args[portIdx + 1]);
+  }
+  const envPort = process.env.MCP_HTTP_PORT;
+  if (envPort)
+    return Number(envPort);
+  return DEFAULT_MCP_HTTP_PORT;
+}
+async function handleMcpRequest(req, buildServer) {
+  const transport = new WebStandardStreamableHTTPServerTransport({
+    sessionIdGenerator: undefined
+  });
+  const server = buildServer();
+  await server.connect(transport);
+  return transport.handleRequest(req);
+}
+function startMcpHttpServer(options) {
+  const { name, port, buildServer } = options;
+  const server = Bun.serve({
+    hostname: MCP_HTTP_HOST,
+    port,
+    async fetch(req) {
+      const url = new URL(req.url);
+      if (url.pathname === "/health" && req.method === "GET") {
+        return Response.json({ status: "ok", name });
+      }
+      if (url.pathname === "/mcp") {
+        return handleMcpRequest(req, buildServer);
+      }
+      return new Response("Not Found", { status: 404 });
+    }
+  });
+  console.error(`${name}-mcp HTTP listening on http://${MCP_HTTP_HOST}:${port}/mcp`);
+  return server;
+}
+
 // node_modules/zod/v3/external.js
 var exports_external = {};
 __export(exports_external, {
@@ -9598,9 +9648,18 @@ async function transcribeAudio(audioPath, config, options = {}) {
     };
   } catch (error) {
     const msg = error instanceof Error ? error.message : String(error);
-    throw new TranscriptionError(`Transcription failed: ${msg}`);
+    throw new TranscriptionError(`Transcription failed: ${describeTranscriptionFailure(msg)}`);
   }
 }
+function describeTranscriptionFailure(message) {
+  if (/401|incorrect api key|invalid_api_key/i.test(message)) {
+    return "OpenAI API key invalid or expired (401). Update it in ~/.hasna/recordings/config.json, the OPENAI_API_KEY env var, or the Recordings app Settings.";
+  }
+  if (/429|exceeded your current quota|insufficient_quota/i.test(message)) {
+    return "OpenAI quota exceeded (429). Check the OpenAI account plan and billing.";
+  }
+  return message;
+}
 function buildVerbatimPrompt(context) {
   const base = "Transcribe the speaker's words verbatim. Output only words that were spoken. Do not summarize, paraphrase, rewrite, clean up grammar, add explanations, or infer missing words. Preserve names, acronyms, technical terms, punctuation, and casing when audible.";
   const trimmed = context?.trim();
@@ -9718,7 +9777,7 @@ ${systemPrompt}` : basePrompt;
     };
   } catch (error) {
     const msg = error instanceof Error ? error.message : String(error);
-    throw new EnhancementError(`Enhancement failed: ${msg}`);
+    throw new EnhancementError(`Enhancement failed: ${describeTranscriptionFailure(msg)}`);
   }
 }
 async function processText(rawText, config, systemPrompt) {
@@ -9738,57 +9797,82 @@ async function processText(rawText, config, systemPrompt) {
 }
 
 // src/version.ts
-var VERSION = "0.1.20";
+var VERSION = "0.1.25";
 
-// src/db/cloud-config.ts
+// src/db/storage-config.ts
 import { existsSync as existsSync2, readFileSync as readFileSync2 } from "fs";
 import { homedir as homedir2 } from "os";
 import { join as join2 } from "path";
-var CONFIG_PATH = join2(homedir2(), ".hasna", "recordings", "cloud", "config.json");
-function isMode(value) {
-  return value === "local" || value === "hybrid" || value === "cloud";
+var STORAGE_CONFIG_PATH = join2(homedir2(), ".hasna", "recordings", "storage", "config.json");
+var RECORDINGS_STORAGE_ENV = "HASNA_RECORDINGS_DATABASE_URL";
+var RECORDINGS_STORAGE_FALLBACK_ENV = "RECORDINGS_DATABASE_URL";
+var RECORDINGS_STORAGE_MODE_ENV = "HASNA_RECORDINGS_STORAGE_MODE";
+var RECORDINGS_STORAGE_MODE_FALLBACK_ENV = "RECORDINGS_STORAGE_MODE";
+var STORAGE_DATABASE_ENV = [RECORDINGS_STORAGE_ENV, RECORDINGS_STORAGE_FALLBACK_ENV];
+function readEnv(name) {
+  const value = process.env[name]?.trim();
+  return value || undefined;
+}
+function normalizeMode(value) {
+  const normalized = value?.trim().toLowerCase();
+  if (normalized === "local" || normalized === "hybrid" || normalized === "remote")
+    return normalized;
+  return;
+}
+function getStorageDatabaseEnvName() {
+  for (const name of STORAGE_DATABASE_ENV) {
+    if (readEnv(name))
+      return name;
+  }
+  return null;
 }
-function envConnectionString() {
-  return process.env["HASNA_RECORDINGS_CLOUD_DATABASE_URL"] ?? process.env["OPEN_RECORDINGS_CLOUD_DATABASE_URL"] ?? process.env["RECORDINGS_CLOUD_DATABASE_URL"];
+function getStorageDatabaseEnv() {
+  const name = getStorageDatabaseEnvName();
+  return name ? { name } : null;
 }
-function getCloudConfig() {
+function getStorageDatabaseUrl() {
+  const env = getStorageDatabaseEnv();
+  return env ? readEnv(env.name) : undefined;
+}
+function getStorageConfig() {
   const config = {
     mode: "local",
     rds: {
       host: "",
       port: 5432,
       username: "",
-      password_env: "RECORDINGS_CLOUD_DATABASE_PASSWORD",
+      password_env: "RECORDINGS_DATABASE_PASSWORD",
       ssl: true
     }
   };
-  if (existsSync2(CONFIG_PATH)) {
+  if (existsSync2(STORAGE_CONFIG_PATH)) {
     try {
-      const raw = JSON.parse(readFileSync2(CONFIG_PATH, "utf-8"));
-      config.mode = raw.mode ?? config.mode;
+      const raw = JSON.parse(readFileSync2(STORAGE_CONFIG_PATH, "utf-8"));
+      config.mode = normalizeMode(raw.mode) ?? config.mode;
       config.rds = { ...config.rds, ...raw.rds ?? {} };
     } catch {}
   }
-  const modeOverride = process.env["HASNA_RECORDINGS_CLOUD_MODE"] ?? process.env["OPEN_RECORDINGS_CLOUD_MODE"] ?? process.env["RECORDINGS_CLOUD_MODE"];
-  if (isMode(modeOverride)) {
-    config.mode = modeOverride;
-  } else if (envConnectionString() && config.mode === "local") {
+  const modeOverride = readEnv(RECORDINGS_STORAGE_MODE_ENV) ?? readEnv(RECORDINGS_STORAGE_MODE_FALLBACK_ENV);
+  const normalizedMode = normalizeMode(modeOverride);
+  if (normalizedMode) {
+    config.mode = normalizedMode;
+  } else if (getStorageDatabaseUrl() && config.mode === "local") {
     config.mode = "hybrid";
   }
   return config;
 }
-function getConnectionString(dbName = "recordings") {
-  const direct = envConnectionString();
+function getStorageConnectionString(dbName = "recordings") {
+  const direct = getStorageDatabaseUrl();
   if (direct)
     return direct;
-  const config = getCloudConfig();
+  const config = getStorageConfig();
   const { host, port, username, password_env, ssl } = config.rds;
   if (!host || !username) {
-    throw new Error("Cloud database is not configured. Set HASNA_RECORDINGS_CLOUD_DATABASE_URL or configure ~/.hasna/recordings/cloud/config.json.");
+    throw new Error("Storage database is not configured. Set HASNA_RECORDINGS_DATABASE_URL or configure ~/.hasna/recordings/storage/config.json.");
   }
   const password = process.env[password_env];
   if (!password) {
-    throw new Error(`Cloud database password is not set. Export ${password_env}.`);
+    throw new Error(`Storage database password is not set. Export ${password_env}.`);
   }
   const sslParam = ssl ? "?sslmode=require" : "";
   return `postgres://${username}:${encodeURIComponent(password)}@${host}:${port}/${dbName}${sslParam}`;
@@ -9915,8 +9999,8 @@ var PG_MIGRATIONS = [
   `ALTER TABLE agents ADD COLUMN IF NOT EXISTS active_project_id TEXT REFERENCES projects(id) ON DELETE SET NULL`
 ];
 
-// src/db/cloud-sync.ts
-var CLOUD_TABLES = [
+// src/db/storage-sync.ts
+var STORAGE_TABLES = [
   "projects",
   "agents",
   "recordings",
@@ -9975,21 +10059,26 @@ function upsertSqlite(db, table, rows) {
   }
   return written;
 }
-async function getCloudPg() {
-  return new PgAdapterAsync(getConnectionString("recordings"));
+async function getStoragePg() {
+  return new PgAdapterAsync(getStorageConnectionString("recordings"));
 }
-async function runCloudMigrations(remote) {
+async function runStorageMigrations(remote) {
   for (const migration of PG_MIGRATIONS) {
     await remote.exec(migration);
   }
 }
-function getCloudStatus(db = getDatabase()) {
-  const config = getCloudConfig();
+function getStorageStatus(db = getDatabase()) {
+  const config = getStorageConfig();
+  const activeEnv = getStorageDatabaseEnv();
   return {
+    configured: Boolean(activeEnv),
     mode: config.mode,
-    enabled: config.mode === "hybrid" || config.mode === "cloud",
+    enabled: config.mode === "hybrid" || config.mode === "remote",
+    env: STORAGE_DATABASE_ENV,
+    activeEnv: activeEnv?.name ?? null,
+    service: "recordings",
     db_path: getDbPath(),
-    tables: CLOUD_TABLES.map((table) => {
+    tables: STORAGE_TABLES.map((table) => {
       try {
         const row = db.query(`SELECT COUNT(*) as count FROM ${quoteId(table)}`).get();
         return { table, rows: row.count };
@@ -9999,12 +10088,12 @@ function getCloudStatus(db = getDatabase()) {
     })
   };
 }
-async function pushCloudChanges(tables = [...CLOUD_TABLES]) {
+async function pushStorageChanges(tables = [...STORAGE_TABLES]) {
   const db = getDatabase();
-  const remote = await getCloudPg();
+  const remote = await getStoragePg();
   const results = [];
   try {
-    await runCloudMigrations(remote);
+    await runStorageMigrations(remote);
     for (const table of tables) {
       const result = { table, direction: "push", rows_read: 0, rows_written: 0, errors: [] };
       try {
@@ -10021,12 +10110,12 @@ async function pushCloudChanges(tables = [...CLOUD_TABLES]) {
   }
   return results;
 }
-async function pullCloudChanges(tables = [...CLOUD_TABLES]) {
+async function pullStorageChanges(tables = [...STORAGE_TABLES]) {
   const db = getDatabase();
-  const remote = await getCloudPg();
+  const remote = await getStoragePg();
   const results = [];
   try {
-    await runCloudMigrations(remote);
+    await runStorageMigrations(remote);
     for (const table of tables) {
       const result = { table, direction: "pull", rows_read: 0, rows_written: 0, errors: [] };
       try {
@@ -10043,20 +10132,26 @@ async function pullCloudChanges(tables = [...CLOUD_TABLES]) {
   }
   return results;
 }
-async function syncCloudChanges(tables = [...CLOUD_TABLES]) {
+async function syncStorageChanges(tables = [...STORAGE_TABLES]) {
   return {
-    push: await pushCloudChanges(tables),
-    pull: await pullCloudChanges(tables)
+    push: await pushStorageChanges(tables),
+    pull: await pullStorageChanges(tables)
   };
 }
-function parseCloudTables(raw) {
+function parseStorageTables(raw) {
   if (!raw)
-    return [...CLOUD_TABLES];
+    return [...STORAGE_TABLES];
   const requested = raw.split(",").map((table) => table.trim()).filter(Boolean);
-  return requested.length > 0 ? requested : [...CLOUD_TABLES];
+  if (requested.length === 0)
+    return [...STORAGE_TABLES];
+  const allowed = new Set(STORAGE_TABLES);
+  const invalid = requested.filter((table) => !allowed.has(table));
+  if (invalid.length > 0)
+    throw new Error(`Unknown recordings sync table(s): ${invalid.join(", ")}`);
+  return requested;
 }
 
-// src/mcp/cloud-tools.ts
+// src/mcp/storage-tools.ts
 function text(value) {
   return { content: [{ type: "text", text: JSON.stringify(value, null, 2) }] };
 }
@@ -10066,42 +10161,42 @@ function errorText(error) {
     isError: true
   };
 }
-function registerRecordingsCloudTools(server) {
-  server.tool("recordings_cloud_status", "Show recordings local database and cloud sync status", {}, async () => {
+function registerRecordingsStorageTools(server) {
+  server.tool("recordings_storage_status", "Show recordings local database and storage sync status", {}, async () => {
     try {
-      return text(getCloudStatus());
+      return text(getStorageStatus());
     } catch (error) {
       return errorText(error);
     }
   });
-  server.tool("recordings_cloud_push", "Push local recordings data to PostgreSQL", {
+  server.tool("recordings_storage_push", "Push local recordings data to PostgreSQL", {
     tables: exports_external.string().optional().describe("Comma-separated table names")
   }, async ({ tables }) => {
     try {
-      return text(await pushCloudChanges(parseCloudTables(tables)));
+      return text(await pushStorageChanges(parseStorageTables(tables)));
     } catch (error) {
       return errorText(error);
     }
   });
-  server.tool("recordings_cloud_pull", "Pull PostgreSQL recordings data into the local database", {
+  server.tool("recordings_storage_pull", "Pull PostgreSQL recordings data into the local database", {
     tables: exports_external.string().optional().describe("Comma-separated table names")
   }, async ({ tables }) => {
     try {
-      return text(await pullCloudChanges(parseCloudTables(tables)));
+      return text(await pullStorageChanges(parseStorageTables(tables)));
     } catch (error) {
       return errorText(error);
     }
   });
-  server.tool("recordings_cloud_sync", "Push local changes, then pull remote changes", {
+  server.tool("recordings_storage_sync", "Push local changes, then pull remote changes", {
     tables: exports_external.string().optional().describe("Comma-separated table names")
   }, async ({ tables }) => {
     try {
-      return text(await syncCloudChanges(parseCloudTables(tables)));
+      return text(await syncStorageChanges(parseStorageTables(tables)));
     } catch (error) {
       return errorText(error);
     }
   });
-  server.tool("recordings_cloud_feedback", "Save feedback for recordings", {
+  server.tool("recordings_storage_feedback", "Save feedback for recordings", {
     message: exports_external.string(),
     email: exports_external.string().optional(),
     category: exports_external.enum(["bug", "feature", "general"]).optional()
@@ -10120,382 +10215,398 @@ function registerRecordingsCloudTools(server) {
 var config = loadConfig();
 ensureDataDir(config);
 getDatabase(config.db_path);
-var server = new McpServer({
-  name: "recordings",
-  version: VERSION
-});
-var registerTool = server.tool.bind(server);
-function text2(content) {
-  return { content: [{ type: "text", text: content }] };
-}
-function errorResult(e) {
-  const msg = e instanceof Error ? e.message : String(e);
-  return { content: [{ type: "text", text: `Error: ${msg}` }], isError: true };
-}
-function compact(r) {
-  const t = (r.processed_text || r.raw_text).slice(0, 80);
-  return `${r.id.slice(0, 8)} | ${r.processing_mode} | ${r.created_at.slice(0, 16)} | ${t}${t.length >= 80 ? "..." : ""}`;
-}
-function full(r) {
-  const lines = [`ID: ${r.id}`, `Mode: ${r.processing_mode}`, `Model: ${r.model_used}`];
-  if (r.enhancement_model)
-    lines.push(`Enhanced by: ${r.enhancement_model}`);
-  if (r.duration_ms)
-    lines.push(`Duration: ${(r.duration_ms / 1000).toFixed(1)}s`);
-  if (r.language)
-    lines.push(`Language: ${r.language}`);
-  if (r.tags.length > 0)
-    lines.push(`Tags: ${r.tags.join(", ")}`);
-  if (r.agent_id)
-    lines.push(`Agent: ${r.agent_id}`);
-  if (r.project_id)
-    lines.push(`Project: ${r.project_id}`);
-  if (r.session_id)
-    lines.push(`Session: ${r.session_id}`);
-  lines.push(`Created: ${r.created_at}`);
-  lines.push(`Text: ${r.raw_text}`);
-  if (r.processed_text && r.processed_text !== r.raw_text) {
-    lines.push(`Enhanced: ${r.processed_text}`);
-  }
-  return lines.join(`
+function buildServer() {
+  const server = new McpServer({
+    name: "recordings",
+    version: VERSION
+  });
+  const registerTool = server.tool.bind(server);
+  function text2(content) {
+    return { content: [{ type: "text", text: content }] };
+  }
+  function errorResult(e) {
+    const msg = e instanceof Error ? e.message : String(e);
+    return { content: [{ type: "text", text: `Error: ${msg}` }], isError: true };
+  }
+  function compact(r) {
+    const t = (r.processed_text || r.raw_text).slice(0, 80);
+    return `${r.id.slice(0, 8)} | ${r.processing_mode} | ${r.created_at.slice(0, 16)} | ${t}${t.length >= 80 ? "..." : ""}`;
+  }
+  function full(r) {
+    const lines = [`ID: ${r.id}`, `Mode: ${r.processing_mode}`, `Model: ${r.model_used}`];
+    if (r.enhancement_model)
+      lines.push(`Enhanced by: ${r.enhancement_model}`);
+    if (r.duration_ms)
+      lines.push(`Duration: ${(r.duration_ms / 1000).toFixed(1)}s`);
+    if (r.language)
+      lines.push(`Language: ${r.language}`);
+    if (r.tags.length > 0)
+      lines.push(`Tags: ${r.tags.join(", ")}`);
+    if (r.agent_id)
+      lines.push(`Agent: ${r.agent_id}`);
+    if (r.project_id)
+      lines.push(`Project: ${r.project_id}`);
+    if (r.session_id)
+      lines.push(`Session: ${r.session_id}`);
+    lines.push(`Created: ${r.created_at}`);
+    lines.push(`Text: ${r.raw_text}`);
+    if (r.processed_text && r.processed_text !== r.raw_text) {
+      lines.push(`Enhanced: ${r.processed_text}`);
+    }
+    return lines.join(`
 `);
-}
-async function saveRecordingMemento(args) {
-  try {
-    const proc = Bun.spawn([
-      "mementos",
-      "save",
-      "--scope",
-      "shared",
-      "--category",
-      "history",
-      "--importance",
-      "5",
-      "--tags",
-      "recording,transcription",
-      "--summary",
-      args.summary,
-      args.key,
-      args.value
-    ], {
-      stdout: "ignore",
-      stderr: "ignore"
-    });
-    await proc.exited;
-  } catch {}
-}
-var toolDocs = {
-  transcribe_audio: `Transcribe audio file. Auto-enhances if needed.
+  }
+  async function saveRecordingMemento(args) {
+    try {
+      const proc = Bun.spawn([
+        "mementos",
+        "save",
+        "--scope",
+        "shared",
+        "--category",
+        "history",
+        "--importance",
+        "5",
+        "--tags",
+        "recording,transcription",
+        "--summary",
+        args.summary,
+        args.key,
+        args.value
+      ], {
+        stdout: "ignore",
+        stderr: "ignore"
+      });
+      await proc.exited;
+    } catch {}
+  }
+  const toolDocs = {
+    transcribe_audio: `Transcribe audio file. Auto-enhances if needed.
 Params: audio_path (string, required): path to wav/mp3/m4a/webm | language (string): ISO code e.g. en/es/fr | no_enhance (bool): skip AI enhancement | tags (string[]): tags | agent_id (string) | project_id (string) | session_id (string)`,
-  save_recording: `Save text as recording. Auto-enhances if needed.
+    save_recording: `Save text as recording. Auto-enhances if needed.
 Params: text (string, required): text to save | enhance (bool): force enhancement | tags (string[]) | agent_id (string) | project_id (string) | session_id (string) | metadata (object)`,
-  get_recording: `Get recording by ID or prefix.
+    get_recording: `Get recording by ID or prefix.
 Params: id (string, required): recording ID or prefix`,
-  list_recordings: `List recordings, compact by default, most recent first.
+    list_recordings: `List recordings, compact by default, most recent first.
 Params: limit (number, default 10) | offset (number) | processing_mode ('raw'|'enhanced') | tags (string[]) | search (string): text search | since/until (ISO date) | agent_id | project_id | session_id | full (bool): verbose output`,
-  search_recordings: `Search recordings by text content.
+    search_recordings: `Search recordings by text content.
 Params: query (string, required) | limit (number, default 10) | agent_id | project_id | full (bool): verbose output`,
-  delete_recording: `Delete recording by ID.
+    delete_recording: `Delete recording by ID.
 Params: id (string, required)`,
-  recording_stats: `Recording count, mode breakdown, duration.
+    recording_stats: `Recording count, mode breakdown, duration.
 Params: none`,
-  detect_enhancement: `Check if text needs AI enhancement.
+    detect_enhancement: `Check if text needs AI enhancement.
 Params: text (string, required)`,
-  register_agent: `Register agent (idempotent). Auto-updates last_seen_at on re-register.
+    register_agent: `Register agent (idempotent). Auto-updates last_seen_at on re-register.
 Params: name (string, required) | description (string) | role (string)`,
-  list_agents: `List registered agents.
+    list_agents: `List registered agents.
 Params: none`,
-  get_agent: `Get agent by ID or name.
+    get_agent: `Get agent by ID or name.
 Params: id (string, required)`,
-  heartbeat: `Update last_seen_at to signal agent is active.
+    heartbeat: `Update last_seen_at to signal agent is active.
 Params: agent_id (string, required): agent ID or name`,
-  set_focus: `Set active project context for this agent session.
+    set_focus: `Set active project context for this agent session.
 Params: agent_id (string, required) | project_id (string, nullable): project ID or null to clear`,
-  register_project: `Register project (idempotent).
+    register_project: `Register project (idempotent).
 Params: name (string, required) | path (string, required): absolute path | description (string)`,
-  list_projects: `List registered projects.
+    list_projects: `List registered projects.
 Params: none`
-};
-registerTool("describe_tool", "Get full param docs for any tool.", { name: exports_external.string() }, async (args) => {
-  const doc = toolDocs[args.name];
-  return doc ? text2(doc) : text2(`Unknown tool: ${args.name}. Available: ${Object.keys(toolDocs).join(", ")}`);
-});
-registerTool("transcribe_audio", "Transcribe audio file. Auto-enhances if needed.", {
-  audio_path: exports_external.string(),
-  language: exports_external.string().optional(),
-  no_enhance: exports_external.boolean().optional(),
-  tags: exports_external.array(exports_external.string()).optional(),
-  agent_id: exports_external.string().optional(),
-  project_id: exports_external.string().optional(),
-  session_id: exports_external.string().optional()
-}, async (args) => {
-  try {
-    const cfg = { ...config };
-    if (args.language)
-      cfg.language = args.language;
-    if (args.no_enhance)
-      cfg.auto_enhance = false;
-    const transcription = await transcribeAudio(args.audio_path, cfg);
-    const processed = await processText(transcription.text, cfg);
-    const recording = createRecording({
-      audio_path: args.audio_path,
-      raw_text: transcription.text,
-      processed_text: processed.mode === "enhanced" ? processed.text : undefined,
-      processing_mode: processed.mode,
-      model_used: transcription.model,
-      enhancement_model: processed.enhancement_model || undefined,
-      duration_ms: transcription.duration_ms,
-      language: transcription.language || undefined,
-      tags: args.tags,
-      agent_id: args.agent_id,
-      project_id: args.project_id,
-      session_id: args.session_id
-    });
-    if (args.agent_id) {
-      await saveRecordingMemento({
-        key: `recording-${recording.id}`,
-        value: JSON.stringify({
-          recording_id: recording.id,
-          text: processed.mode === "enhanced" ? processed.text : transcription.text,
-          agent_id: args.agent_id,
-          project_id: args.project_id,
-          session_id: args.session_id,
-          created_at: recording.created_at
-        }),
-        summary: `Recording ${recording.id.slice(0, 8)} for ${args.agent_id}`
+  };
+  registerTool("describe_tool", "Get full param docs for any tool.", { name: exports_external.string() }, async (args) => {
+    const doc = toolDocs[args.name];
+    return doc ? text2(doc) : text2(`Unknown tool: ${args.name}. Available: ${Object.keys(toolDocs).join(", ")}`);
+  });
+  registerTool("transcribe_audio", "Transcribe audio file. Auto-enhances if needed.", {
+    audio_path: exports_external.string(),
+    language: exports_external.string().optional(),
+    no_enhance: exports_external.boolean().optional(),
+    tags: exports_external.array(exports_external.string()).optional(),
+    agent_id: exports_external.string().optional(),
+    project_id: exports_external.string().optional(),
+    session_id: exports_external.string().optional()
+  }, async (args) => {
+    try {
+      const cfg = { ...config };
+      if (args.language)
+        cfg.language = args.language;
+      if (args.no_enhance)
+        cfg.auto_enhance = false;
+      const transcription = await transcribeAudio(args.audio_path, cfg);
+      const processed = await processText(transcription.text, cfg);
+      const recording = createRecording({
+        audio_path: args.audio_path,
+        raw_text: transcription.text,
+        processed_text: processed.mode === "enhanced" ? processed.text : undefined,
+        processing_mode: processed.mode,
+        model_used: transcription.model,
+        enhancement_model: processed.enhancement_model || undefined,
+        duration_ms: transcription.duration_ms,
+        language: transcription.language || undefined,
+        tags: args.tags,
+        agent_id: args.agent_id,
+        project_id: args.project_id,
+        session_id: args.session_id
       });
+      if (args.agent_id) {
+        await saveRecordingMemento({
+          key: `recording-${recording.id}`,
+          value: JSON.stringify({
+            recording_id: recording.id,
+            text: processed.mode === "enhanced" ? processed.text : transcription.text,
+            agent_id: args.agent_id,
+            project_id: args.project_id,
+            session_id: args.session_id,
+            created_at: recording.created_at
+          }),
+          summary: `Recording ${recording.id.slice(0, 8)} for ${args.agent_id}`
+        });
+      }
+      const output = processed.mode === "enhanced" ? processed.text : transcription.text;
+      return text2(`${recording.id.slice(0, 8)} | ${processed.mode} | ${output}`);
+    } catch (e) {
+      return errorResult(e);
     }
-    const output = processed.mode === "enhanced" ? processed.text : transcription.text;
-    return text2(`${recording.id.slice(0, 8)} | ${processed.mode} | ${output}`);
-  } catch (e) {
-    return errorResult(e);
-  }
-});
-registerTool("save_recording", "Save text as recording. Auto-enhances if needed.", {
-  text: exports_external.string(),
-  enhance: exports_external.boolean().optional(),
-  tags: exports_external.array(exports_external.string()).optional(),
-  agent_id: exports_external.string().optional(),
-  project_id: exports_external.string().optional(),
-  session_id: exports_external.string().optional(),
-  goal: exports_external.string().optional().describe("Goal or purpose of this recording session (e.g. 'code review for PR #123')"),
-  role: exports_external.string().optional().describe("Agent role for this session (e.g. 'dev agent for connectdev')"),
-  task_list_id: exports_external.string().optional().describe("Task list ID to bind this recording to"),
-  metadata: exports_external.record(exports_external.unknown()).optional()
-}, async (args) => {
-  try {
-    let processedText;
-    let mode = "raw";
-    let enhModel;
-    if (args.enhance !== false) {
-      const processed = await processText(args.text, config);
-      if (processed.mode === "enhanced") {
-        processedText = processed.text;
-        mode = "enhanced";
-        enhModel = processed.enhancement_model || undefined;
-      }
-    }
-    const recording = createRecording({
-      raw_text: args.text,
-      processed_text: processedText,
-      processing_mode: mode,
-      model_used: "direct-input",
-      enhancement_model: enhModel,
-      tags: args.tags,
-      agent_id: args.agent_id,
-      project_id: args.project_id,
-      session_id: args.session_id,
-      goal: args.goal,
-      role: args.role,
-      task_list_id: args.task_list_id,
-      metadata: args.metadata
-    });
-    const output = processedText || args.text;
-    return text2(`${recording.id.slice(0, 8)} | ${mode} | ${output}`);
-  } catch (e) {
-    return errorResult(e);
-  }
-});
-registerTool("get_recording", "Get recording by ID or prefix.", { id: exports_external.string() }, async (args) => {
-  try {
-    const r = getRecording(args.id);
-    if (!r)
-      return text2(`Not found: ${args.id}`);
-    return text2(full(r));
-  } catch (e) {
-    return errorResult(e);
-  }
-});
-registerTool("list_recordings", "List recordings. Compact default, recent first.", {
-  limit: exports_external.number().optional(),
-  offset: exports_external.number().optional(),
-  processing_mode: exports_external.enum(["raw", "enhanced"]).optional(),
-  tags: exports_external.array(exports_external.string()).optional(),
-  search: exports_external.string().optional(),
-  since: exports_external.string().optional(),
-  until: exports_external.string().optional(),
-  agent_id: exports_external.string().optional(),
-  project_id: exports_external.string().optional(),
-  session_id: exports_external.string().optional(),
-  full: exports_external.boolean().optional()
-}, async (args) => {
-  try {
-    const filter = {
-      limit: args.limit || 10,
-      offset: args.offset,
-      processing_mode: args.processing_mode,
-      tags: args.tags,
-      search: args.search,
-      since: args.since,
-      until: args.until,
-      agent_id: args.agent_id,
-      project_id: args.project_id,
-      session_id: args.session_id
-    };
-    const recordings = listRecordings(filter);
-    if (recordings.length === 0)
-      return text2("No recordings found.");
-    const fmt = args.full ? full : compact;
-    const sep = args.full ? `
+  });
+  registerTool("save_recording", "Save text as recording. Auto-enhances if needed.", {
+    text: exports_external.string(),
+    enhance: exports_external.boolean().optional(),
+    tags: exports_external.array(exports_external.string()).optional(),
+    agent_id: exports_external.string().optional(),
+    project_id: exports_external.string().optional(),
+    session_id: exports_external.string().optional(),
+    goal: exports_external.string().optional().describe("Goal or purpose of this recording session (e.g. 'code review for PR #123')"),
+    role: exports_external.string().optional().describe("Agent role for this session (e.g. 'dev agent for connectdev')"),
+    task_list_id: exports_external.string().optional().describe("Task list ID to bind this recording to"),
+    metadata: exports_external.record(exports_external.unknown()).optional()
+  }, async (args) => {
+    try {
+      let processedText;
+      let mode = "raw";
+      let enhModel;
+      if (args.enhance !== false) {
+        const processed = await processText(args.text, config);
+        if (processed.mode === "enhanced") {
+          processedText = processed.text;
+          mode = "enhanced";
+          enhModel = processed.enhancement_model || undefined;
+        }
+      }
+      const recording = createRecording({
+        raw_text: args.text,
+        processed_text: processedText,
+        processing_mode: mode,
+        model_used: "direct-input",
+        enhancement_model: enhModel,
+        tags: args.tags,
+        agent_id: args.agent_id,
+        project_id: args.project_id,
+        session_id: args.session_id,
+        goal: args.goal,
+        role: args.role,
+        task_list_id: args.task_list_id,
+        metadata: args.metadata
+      });
+      const output = processedText || args.text;
+      return text2(`${recording.id.slice(0, 8)} | ${mode} | ${output}`);
+    } catch (e) {
+      return errorResult(e);
+    }
+  });
+  registerTool("get_recording", "Get recording by ID or prefix.", { id: exports_external.string() }, async (args) => {
+    try {
+      const r = getRecording(args.id);
+      if (!r)
+        return text2(`Not found: ${args.id}`);
+      return text2(full(r));
+    } catch (e) {
+      return errorResult(e);
+    }
+  });
+  registerTool("list_recordings", "List recordings. Compact default, recent first.", {
+    limit: exports_external.number().optional(),
+    offset: exports_external.number().optional(),
+    processing_mode: exports_external.enum(["raw", "enhanced"]).optional(),
+    tags: exports_external.array(exports_external.string()).optional(),
+    search: exports_external.string().optional(),
+    since: exports_external.string().optional(),
+    until: exports_external.string().optional(),
+    agent_id: exports_external.string().optional(),
+    project_id: exports_external.string().optional(),
+    session_id: exports_external.string().optional(),
+    full: exports_external.boolean().optional()
+  }, async (args) => {
+    try {
+      const filter = {
+        limit: args.limit || 10,
+        offset: args.offset,
+        processing_mode: args.processing_mode,
+        tags: args.tags,
+        search: args.search,
+        since: args.since,
+        until: args.until,
+        agent_id: args.agent_id,
+        project_id: args.project_id,
+        session_id: args.session_id
+      };
+      const recordings = listRecordings(filter);
+      if (recordings.length === 0)
+        return text2("No recordings found.");
+      const fmt = args.full ? full : compact;
+      const sep = args.full ? `
 ---
 ` : `
 `;
-    return text2(`${recordings.length} recording(s):${sep}${recordings.map(fmt).join(sep)}`);
-  } catch (e) {
-    return errorResult(e);
-  }
-});
-registerTool("search_recordings", "Search recordings by text.", {
-  query: exports_external.string(),
-  limit: exports_external.number().optional(),
-  agent_id: exports_external.string().optional(),
-  project_id: exports_external.string().optional(),
-  full: exports_external.boolean().optional()
-}, async (args) => {
-  try {
-    const results = searchRecordings(args.query, {
-      limit: args.limit || 10,
-      agent_id: args.agent_id,
-      project_id: args.project_id
-    });
-    if (results.length === 0)
-      return text2("No results.");
-    const fmt = args.full ? full : compact;
-    const sep = args.full ? `
+      return text2(`${recordings.length} recording(s):${sep}${recordings.map(fmt).join(sep)}`);
+    } catch (e) {
+      return errorResult(e);
+    }
+  });
+  registerTool("search_recordings", "Search recordings by text.", {
+    query: exports_external.string(),
+    limit: exports_external.number().optional(),
+    agent_id: exports_external.string().optional(),
+    project_id: exports_external.string().optional(),
+    full: exports_external.boolean().optional()
+  }, async (args) => {
+    try {
+      const results = searchRecordings(args.query, {
+        limit: args.limit || 10,
+        agent_id: args.agent_id,
+        project_id: args.project_id
+      });
+      if (results.length === 0)
+        return text2("No results.");
+      const fmt = args.full ? full : compact;
+      const sep = args.full ? `
 ---
 ` : `
 `;
-    return text2(`${results.length} result(s):${sep}${results.map(fmt).join(sep)}`);
-  } catch (e) {
-    return errorResult(e);
-  }
-});
-registerTool("delete_recording", "Delete recording by ID.", { id: exports_external.string() }, async (args) => {
-  try {
-    return text2(deleteRecording(args.id) ? `Deleted ${args.id}` : `Not found: ${args.id}`);
-  } catch (e) {
-    return errorResult(e);
-  }
-});
-registerTool("recording_stats", "Recording stats: count, modes, duration.", {}, async () => {
-  try {
-    const s = getRecordingStats();
-    let out = `Total: ${s.total} | Raw: ${s.raw} | Enhanced: ${s.enhanced} | Duration: ${(s.total_duration_ms / 1000).toFixed(1)}s`;
-    if (Object.keys(s.by_model).length > 0) {
-      out += `
+      return text2(`${results.length} result(s):${sep}${results.map(fmt).join(sep)}`);
+    } catch (e) {
+      return errorResult(e);
+    }
+  });
+  registerTool("delete_recording", "Delete recording by ID.", { id: exports_external.string() }, async (args) => {
+    try {
+      return text2(deleteRecording(args.id) ? `Deleted ${args.id}` : `Not found: ${args.id}`);
+    } catch (e) {
+      return errorResult(e);
+    }
+  });
+  registerTool("recording_stats", "Recording stats: count, modes, duration.", {}, async () => {
+    try {
+      const s = getRecordingStats();
+      let out = `Total: ${s.total} | Raw: ${s.raw} | Enhanced: ${s.enhanced} | Duration: ${(s.total_duration_ms / 1000).toFixed(1)}s`;
+      if (Object.keys(s.by_model).length > 0) {
+        out += `
 ` + Object.entries(s.by_model).map(([m, c]) => `${m}: ${c}`).join(", ");
+      }
+      return text2(out);
+    } catch (e) {
+      return errorResult(e);
     }
-    return text2(out);
-  } catch (e) {
-    return errorResult(e);
-  }
-});
-registerTool("detect_enhancement", "Check if text needs AI enhancement.", { text: exports_external.string() }, async (args) => {
-  try {
-    const r = needsEnhancement(args.text, config);
-    return text2(`${r.needs ? "Yes" : "No"}: ${r.reason}`);
-  } catch (e) {
-    return errorResult(e);
-  }
-});
-registerTool("register_agent", "Register agent (idempotent).", { name: exports_external.string(), description: exports_external.string().optional(), role: exports_external.string().optional() }, async (args) => {
-  try {
-    const a = registerAgent(args.name, args.description, args.role);
-    return text2(`${a.id} | ${a.name} | ${a.role}`);
-  } catch (e) {
-    return errorResult(e);
-  }
-});
-registerTool("list_agents", "List registered agents.", {}, async () => {
-  try {
-    const agents = listAgents();
-    if (agents.length === 0)
-      return text2("None.");
-    return text2(agents.map((a) => `${a.id} | ${a.name} | ${a.role}`).join(`
+  });
+  registerTool("detect_enhancement", "Check if text needs AI enhancement.", { text: exports_external.string() }, async (args) => {
+    try {
+      const r = needsEnhancement(args.text, config);
+      return text2(`${r.needs ? "Yes" : "No"}: ${r.reason}`);
+    } catch (e) {
+      return errorResult(e);
+    }
+  });
+  registerTool("register_agent", "Register agent (idempotent).", { name: exports_external.string(), description: exports_external.string().optional(), role: exports_external.string().optional() }, async (args) => {
+    try {
+      const a = registerAgent(args.name, args.description, args.role);
+      return text2(`${a.id} | ${a.name} | ${a.role}`);
+    } catch (e) {
+      return errorResult(e);
+    }
+  });
+  registerTool("list_agents", "List registered agents.", {}, async () => {
+    try {
+      const agents = listAgents();
+      if (agents.length === 0)
+        return text2("None.");
+      return text2(agents.map((a) => `${a.id} | ${a.name} | ${a.role}`).join(`
 `));
-  } catch (e) {
-    return errorResult(e);
-  }
-});
-registerTool("get_agent", "Get agent by ID or name.", { id: exports_external.string() }, async (args) => {
-  try {
-    const a = getAgent(args.id);
-    if (!a)
-      return text2(`Not found: ${args.id}`);
-    return text2(`${a.id} | ${a.name} | ${a.role} | ${a.last_seen_at}`);
-  } catch (e) {
-    return errorResult(e);
-  }
-});
-registerTool("register_project", "Register project (idempotent).", { name: exports_external.string(), path: exports_external.string(), description: exports_external.string().optional() }, async (args) => {
-  try {
-    const p = registerProject(args.name, args.path, args.description);
-    return text2(`${p.id.slice(0, 8)} | ${p.name} | ${p.path}`);
-  } catch (e) {
-    return errorResult(e);
-  }
-});
-registerTool("list_projects", "List registered projects.", {}, async () => {
-  try {
-    const projects = listProjects();
-    if (projects.length === 0)
-      return text2("None.");
-    return text2(projects.map((p) => `${p.id.slice(0, 8)} | ${p.name} | ${p.path}`).join(`
+    } catch (e) {
+      return errorResult(e);
+    }
+  });
+  registerTool("get_agent", "Get agent by ID or name.", { id: exports_external.string() }, async (args) => {
+    try {
+      const a = getAgent(args.id);
+      if (!a)
+        return text2(`Not found: ${args.id}`);
+      return text2(`${a.id} | ${a.name} | ${a.role} | ${a.last_seen_at}`);
+    } catch (e) {
+      return errorResult(e);
+    }
+  });
+  registerTool("register_project", "Register project (idempotent).", { name: exports_external.string(), path: exports_external.string(), description: exports_external.string().optional() }, async (args) => {
+    try {
+      const p = registerProject(args.name, args.path, args.description);
+      return text2(`${p.id.slice(0, 8)} | ${p.name} | ${p.path}`);
+    } catch (e) {
+      return errorResult(e);
+    }
+  });
+  registerTool("list_projects", "List registered projects.", {}, async () => {
+    try {
+      const projects = listProjects();
+      if (projects.length === 0)
+        return text2("None.");
+      return text2(projects.map((p) => `${p.id.slice(0, 8)} | ${p.name} | ${p.path}`).join(`
 `));
-  } catch (e) {
-    return errorResult(e);
-  }
-});
-registerTool("heartbeat", "Update last_seen_at to signal agent is active. Call periodically during long tasks.", { agent_id: exports_external.string().describe("Agent ID or name") }, async (args) => {
-  try {
-    const agent = heartbeatAgent(args.agent_id);
-    if (!agent)
-      return text2(`Agent not found: ${args.agent_id}`);
-    return text2(`${agent.id} | ${agent.name} | last_seen: ${agent.last_seen_at}`);
-  } catch (e) {
-    return errorResult(e);
-  }
-});
-registerTool("set_focus", "Set active project context for this agent session.", { agent_id: exports_external.string().describe("Agent ID or name"), project_id: exports_external.string().nullable().optional().describe("Project ID to focus on, or null to clear") }, async (args) => {
-  try {
-    const agent = setAgentFocus(args.agent_id, args.project_id ?? null);
-    if (!agent)
-      return text2(`Agent not found: ${args.agent_id}`);
-    return text2(args.project_id ? `Focus set: ${args.project_id}` : "Focus cleared");
-  } catch (e) {
-    return errorResult(e);
+    } catch (e) {
+      return errorResult(e);
+    }
+  });
+  registerTool("heartbeat", "Update last_seen_at to signal agent is active. Call periodically during long tasks.", { agent_id: exports_external.string().describe("Agent ID or name") }, async (args) => {
+    try {
+      const agent = heartbeatAgent(args.agent_id);
+      if (!agent)
+        return text2(`Agent not found: ${args.agent_id}`);
+      return text2(`${agent.id} | ${agent.name} | last_seen: ${agent.last_seen_at}`);
+    } catch (e) {
+      return errorResult(e);
+    }
+  });
+  registerTool("set_focus", "Set active project context for this agent session.", { agent_id: exports_external.string().describe("Agent ID or name"), project_id: exports_external.string().nullable().optional().describe("Project ID to focus on, or null to clear") }, async (args) => {
+    try {
+      const agent = setAgentFocus(args.agent_id, args.project_id ?? null);
+      if (!agent)
+        return text2(`Agent not found: ${args.agent_id}`);
+      return text2(args.project_id ? `Focus set: ${args.project_id}` : "Focus cleared");
+    } catch (e) {
+      return errorResult(e);
+    }
+  });
+  registerTool("send_feedback", "Send feedback about this service", {
+    message: exports_external.string().describe("Feedback message"),
+    email: exports_external.string().optional().describe("Contact email (optional)"),
+    category: exports_external.enum(["bug", "feature", "general"]).optional().describe("Feedback category")
+  }, async (params) => {
+    const adapter = getAdapter();
+    const pkg = require_package();
+    adapter.run("INSERT INTO feedback (message, email, category, version) VALUES (?, ?, ?, ?)", params.message, params.email || null, params.category || "general", pkg.version);
+    return text2("Feedback saved. Thank you!");
+  });
+  registerRecordingsStorageTools(server);
+  return server;
+}
+async function main() {
+  const args = process.argv.slice(2);
+  if (isStdioMode(args)) {
+    const transport = new StdioServerTransport;
+    await buildServer().connect(transport);
+    return;
   }
-});
-registerTool("send_feedback", "Send feedback about this service", {
-  message: exports_external.string().describe("Feedback message"),
-  email: exports_external.string().optional().describe("Contact email (optional)"),
-  category: exports_external.enum(["bug", "feature", "general"]).optional().describe("Feedback category")
-}, async (params) => {
-  const adapter = getAdapter();
-  const pkg = require_package();
-  adapter.run("INSERT INTO feedback (message, email, category, version) VALUES (?, ?, ?, ?)", params.message, params.email || null, params.category || "general", pkg.version);
-  return text2("Feedback saved. Thank you!");
-});
-var transport = new StdioServerTransport;
-registerRecordingsCloudTools(server);
-await server.connect(transport);
+  startMcpHttpServer({ name: "recordings", port: resolveMcpHttpPort(args), buildServer });
+}
+if (import.meta.main) {
+  await main();
+}
+export {
+  buildServer
+};