@hasna/recordings 0.2.6 → 0.2.8

package/dist/cli/index.js

@@ -1515,7 +1515,7 @@ function setAgentFocus(idOrName, projectId, db) {
 }
 
 // src/version.ts
-var VERSION = "0.2.6";
+var VERSION = "0.2.8";
 
 // src/db/feedback.ts
 function saveFeedback(input) {
@@ -2376,6 +2376,50 @@ function applyEnhancementOptions(config, opts) {
   return config;
 }
 
+// src/cli/mcp-config.ts
+function escapeRegExp(value) {
+  return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+function isTableHeader(line) {
+  return /^\s*\[/.test(line);
+}
+function removeCodexServerBlock(content, name) {
+  const headerRe = new RegExp(`^\\s*\\[mcp_servers\\.${escapeRegExp(name)}(\\..+)?\\]\\s*$`);
+  const lines = content.split(`
+`);
+  const out = [];
+  let skipping = false;
+  let removed = false;
+  for (const line of lines) {
+    if (isTableHeader(line)) {
+      skipping = headerRe.test(line);
+      if (skipping) {
+        removed = true;
+        continue;
+      }
+    }
+    if (skipping)
+      continue;
+    out.push(line);
+  }
+  const normalized = out.join(`
+`).replace(/\n{3,}/g, `
+
+`).replace(/^\n+/, "");
+  return { content: normalized, removed };
+}
+function upsertCodexStdioBlock(content, name, mcpCmd) {
+  const { content: cleaned } = removeCodexServerBlock(content, name);
+  const trimmed = cleaned.replace(/\s+$/, "");
+  const block = `[mcp_servers.${name}]
+command = "${mcpCmd}"
+args = []
+`;
+  return trimmed.length > 0 ? `${trimmed}
+
+${block}` : block;
+}
+
 // src/cli/index.ts
 var program = new Command;
 program.name("recordings").description("Speech-to-text recording tool \u2014 record, transcribe, and enhance with AI").version(VERSION).option("--json", "Output as JSON").option("--agent <name>", "Agent name or ID").option("--project <name>", "Project name or ID").option("--session <id>", "Session ID");
@@ -3204,19 +3248,16 @@ program.command("mcp").description("Install recordings MCP server into Claude Co
       if (target === "codex") {
         const configPath = pathJoin2(home, ".codex", "config.toml");
         if (fileExists(configPath)) {
-          let content = readFileSync3(configPath, "utf-8");
+          const content = readFileSync3(configPath, "utf-8");
           if (opts.uninstall) {
-            content = content.replace(/\n\[mcp_servers\.recordings\]\ncommand = "[^"]*"\nargs = \[\]\n?/g, `
-`);
-          } else if (!content.includes("[mcp_servers.recordings]")) {
-            content += `
-[mcp_servers.recordings]
-command = "${mcpCmd}"
-args = []
-`;
+            const { content: next, removed } = removeCodexServerBlock(content, "recordings");
+            writeFileSync(configPath, next, "utf-8");
+            console.log(removed ? chalk.green(`Removed from Codex: ${configPath}`) : chalk.yellow(`Codex: no recordings MCP block found in ${configPath}`));
+          } else {
+            const next = upsertCodexStdioBlock(content, "recordings", mcpCmd);
+            writeFileSync(configPath, next, "utf-8");
+            console.log(chalk.green(`Installed into Codex: ${configPath}`));
           }
-          writeFileSync(configPath, content, "utf-8");
-          console.log(chalk.green(`${action} Codex: ${configPath}`));
         } else {
           console.log(chalk.yellow(`Codex config not found: ${configPath}`));
         }

package/dist/cli/mcp-config.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Pure helpers for editing an agent's MCP server config.
+ *
+ * Codex stores MCP servers as TOML tables (`[mcp_servers.<name>]`). A server
+ * block can be written in several transport forms — stdio (`command`/`args`)
+ * or streamable-HTTP (`url`/`http`, optional `headers`/`env` subtables). The
+ * uninstall/upsert logic must treat the whole table (and any of its subtables)
+ * as one unit regardless of which keys it holds, instead of matching one
+ * hand-written key layout. These functions are exported so the round-trip is
+ * unit-tested without touching the real `~/.codex/config.toml`.
+ */
+/**
+ * Remove the `[mcp_servers.<name>]` table AND any of its subtables
+ * (`[mcp_servers.<name>.env]`, `.headers`, …) with their bodies — whatever the
+ * transport form. A block runs from its header until the next table header or
+ * end of file. Returns the rewritten content and whether anything was removed.
+ */
+export declare function removeCodexServerBlock(content: string, name: string): {
+    content: string;
+    removed: boolean;
+};
+/**
+ * Ensure exactly one stdio `[mcp_servers.<name>]` block exists, pointing at
+ * `mcpCmd`. Any pre-existing block (in any transport form) is replaced, so the
+ * install is authoritative and idempotent rather than a silent no-op.
+ */
+export declare function upsertCodexStdioBlock(content: string, name: string, mcpCmd: string): string;
+//# sourceMappingURL=mcp-config.d.ts.map

package/dist/cli/mcp-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-config.d.ts","sourceRoot":"","sources":["../../src/cli/mcp-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAWH;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,GACX;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CA4BvC;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,GACb,MAAM,CAKR"}

package/dist/db/errors.d.ts

@@ -12,4 +12,13 @@ export declare class ProjectNotFoundError extends Error {
     readonly ref: string;
     constructor(ref: string);
 }
+/**
+ * Thrown for invalid client input (missing/blank required fields). Its message
+ * is safe to surface to the caller as a clean 400. This is distinct from an
+ * unexpected internal/DB error, whose raw text (e.g. a Postgres constraint name)
+ * must NEVER be returned to the client.
+ */
+export declare class ValidationError extends Error {
+    constructor(message: string);
+}
 //# sourceMappingURL=errors.d.ts.map

package/dist/db/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/db/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;gBACT,GAAG,EAAE,MAAM;CAKxB"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/db/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;gBACT,GAAG,EAAE,MAAM;CAKxB;AAED;;;;;GAKG;AACH,qBAAa,eAAgB,SAAQ,KAAK;gBAC5B,OAAO,EAAE,MAAM;CAI5B"}

package/dist/index.js

@@ -774,7 +774,7 @@ function setAgentFocus(idOrName, projectId, db) {
 }
 
 // src/version.ts
-var VERSION = "0.2.6";
+var VERSION = "0.2.8";
 
 // src/db/feedback.ts
 function saveFeedback(input) {

package/dist/mcp/index.js

@@ -4648,7 +4648,7 @@ function setAgentFocus(idOrName, projectId, db) {
 }
 
 // src/version.ts
-var VERSION = "0.2.6";
+var VERSION = "0.2.8";
 
 // src/db/feedback.ts
 function saveFeedback(input) {

package/dist/server/index.js

@@ -18,7 +18,7 @@ var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
 var __require = import.meta.require;
 
 // src/version.ts
-var VERSION = "0.2.6";
+var VERSION = "0.2.8";
 
 // src/db/remote-storage.ts
 import pg from "pg";
@@ -262,7 +262,7 @@ var init_cloud = __esm(() => {
 });
 
 // src/db/errors.ts
-var ProjectNotFoundError;
+var ProjectNotFoundError, ValidationError;
 var init_errors = __esm(() => {
   ProjectNotFoundError = class ProjectNotFoundError extends Error {
     ref;
@@ -272,6 +272,12 @@ var init_errors = __esm(() => {
       this.ref = ref;
     }
   };
+  ValidationError = class ValidationError extends Error {
+    constructor(message) {
+      super(message);
+      this.name = "ValidationError";
+    }
+  };
 });
 
 // src/server/repo.ts
@@ -335,7 +341,7 @@ function parseProject(row) {
 }
 async function createRecording(pg2, input) {
   if (typeof input.raw_text !== "string" || !input.raw_text) {
-    throw new Error("raw_text is required");
+    throw new ValidationError("raw_text is required");
   }
   const id = shortUuid();
   await pg2.run(`INSERT INTO recordings (id, audio_path, raw_text, processed_text, processing_mode, model_used, enhancement_model, duration_ms, language, tags, agent_id, project_id, session_id, goal, role, task_list_id, machine_id, metadata)
@@ -423,7 +429,7 @@ async function getRecordingStats(pg2) {
 }
 async function registerAgent(pg2, name, description, role) {
   if (!name)
-    throw new Error("name is required");
+    throw new ValidationError("name is required");
   const now = new Date().toISOString();
   const existing = await pg2.get("SELECT * FROM agents WHERE name = ?", name);
   if (existing) {
@@ -471,7 +477,7 @@ async function setAgentFocus(pg2, idOrName, projectId) {
 }
 async function registerProject(pg2, name, path, description) {
   if (!name || !path)
-    throw new Error("name and path are required");
+    throw new ValidationError("name and path are required");
   const now = new Date().toISOString();
   const existing = await pg2.get("SELECT * FROM projects WHERE path = ?", path);
   if (existing) {
@@ -501,7 +507,7 @@ async function listProjects(pg2) {
 }
 async function saveFeedback(pg2, input) {
   if (typeof input.message !== "string" || !input.message.trim()) {
-    throw new Error("message is required");
+    throw new ValidationError("message is required");
   }
   await pg2.run("INSERT INTO feedback (message, email, category, version) VALUES (?, ?, ?, ?)", input.message, input.email || null, input.category || "general", input.version || null);
   return { saved: true };
@@ -679,7 +685,11 @@ async function handleV1Request(req, url) {
     }
     return error(404, `unknown /v1 resource: ${resource ?? ""}`);
   } catch (e) {
-    return error(500, e.message);
+    if (e instanceof ProjectNotFoundError || e instanceof ValidationError) {
+      return error(400, e.message);
+    }
+    console.error(`[recordings-serve] unhandled ${method} ${path} error:`, e);
+    return error(500, "internal server error");
   }
 }
 var JSON_HEADERS;

package/dist/server/repo.d.ts

@@ -12,9 +12,9 @@
  * stubs — every operation executes real SQL.
  */
 import type { PgAdapterAsync } from "../db/remote-storage.js";
-import { ProjectNotFoundError } from "../db/errors.js";
+import { ProjectNotFoundError, ValidationError } from "../db/errors.js";
 import type { Recording, CreateRecordingInput, RecordingFilter, Agent, Project } from "../types/index.js";
-export { ProjectNotFoundError };
+export { ProjectNotFoundError, ValidationError };
 export declare function createRecording(pg: PgAdapterAsync, input: CreateRecordingInput): Promise<Recording>;
 export declare function getRecording(pg: PgAdapterAsync, id: string): Promise<Recording | null>;
 export declare function listRecordings(pg: PgAdapterAsync, filter?: RecordingFilter): Promise<Recording[]>;

package/dist/server/repo.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"repo.d.ts","sourceRoot":"","sources":["../../src/server/repo.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"repo.d.ts","sourceRoot":"","sources":["../../src/server/repo.ts"],"names":[],"mappings":"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"}

package/dist/server/v1.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"v1.d.ts","sourceRoot":"","sources":["../../src/server/v1.ts"],"names":[],"mappings":"AAkCA;;;GAGG;AACH,wBAAsB,eAAe,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CA6KtF"}
+{"version":3,"file":"v1.d.ts","sourceRoot":"","sources":["../../src/server/v1.ts"],"names":[],"mappings":"AAkCA;;;GAGG;AACH,wBAAsB,eAAe,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAsLtF"}

package/dist/storage.js

@@ -613,7 +613,7 @@ function setAgentFocus(idOrName, projectId, db) {
 }
 
 // src/version.ts
-var VERSION = "0.2.6";
+var VERSION = "0.2.8";
 
 // src/db/feedback.ts
 function saveFeedback(input) {

package/dist/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.2.6";
+export declare const VERSION = "0.2.8";
 //# sourceMappingURL=version.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/recordings",
-  "version": "0.2.6",
+  "version": "0.2.8",
   "type": "module",
   "description": "Speech-to-text recording tool with MCP and CLI — records, transcribes, and optionally enhances text using AI",
   "repository": {