@hasna/recordings 0.2.5 → 0.2.7

package/dist/cli/index.js

@@ -1397,6 +1397,59 @@ function getRecordingStats(db) {
   };
 }
 
+// src/db/projects.ts
+function parseProject(row) {
+  return {
+    id: row["id"],
+    name: row["name"],
+    path: row["path"],
+    description: row["description"] || null,
+    created_at: row["created_at"],
+    updated_at: row["updated_at"]
+  };
+}
+function registerProject(name, path, description, db) {
+  const d = db || getDatabase();
+  const now2 = new Date().toISOString();
+  const existing = d.query("SELECT * FROM projects WHERE path = ?").get(path);
+  if (existing) {
+    d.query("UPDATE projects SET updated_at = ? WHERE id = ?").run(now2, existing["id"]);
+    return getProject(existing["id"], d);
+  }
+  const id = crypto.randomUUID();
+  d.query("INSERT INTO projects (id, name, path, description, created_at, updated_at) VALUES (?, ?, ?, ?, ?, ?)").run(id, name, path, description || null, now2, now2);
+  return getProject(id, d);
+}
+function getProject(idOrPath, db) {
+  const d = db || getDatabase();
+  let row = d.query("SELECT * FROM projects WHERE id = ?").get(idOrPath);
+  if (!row) {
+    row = d.query("SELECT * FROM projects WHERE path = ?").get(idOrPath);
+  }
+  if (!row) {
+    row = d.query("SELECT * FROM projects WHERE name = ?").get(idOrPath);
+  }
+  if (!row && idOrPath) {
+    row = d.query("SELECT * FROM projects WHERE id LIKE ? || '%'").get(idOrPath);
+  }
+  return row ? parseProject(row) : null;
+}
+function listProjects(db) {
+  const d = db || getDatabase();
+  const rows = d.query("SELECT * FROM projects ORDER BY updated_at DESC").all();
+  return rows.map(parseProject);
+}
+
+// src/db/errors.ts
+class ProjectNotFoundError extends Error {
+  ref;
+  constructor(ref) {
+    super(`project not found: ${ref}`);
+    this.name = "ProjectNotFoundError";
+    this.ref = ref;
+  }
+}
+
 // src/db/agents.ts
 function parseAgent(row) {
   return {
@@ -1450,49 +1503,19 @@ function setAgentFocus(idOrName, projectId, db) {
   const agent = getAgent(idOrName, d);
   if (!agent)
     return null;
-  d.query("UPDATE agents SET active_project_id = ?, last_seen_at = ? WHERE id = ?").run(projectId, new Date().toISOString(), agent.id);
+  let resolvedProjectId = null;
+  if (projectId) {
+    const project = getProject(projectId, d);
+    if (!project)
+      throw new ProjectNotFoundError(projectId);
+    resolvedProjectId = project.id;
+  }
+  d.query("UPDATE agents SET active_project_id = ?, last_seen_at = ? WHERE id = ?").run(resolvedProjectId, new Date().toISOString(), agent.id);
   return getAgent(agent.id, d);
 }
 
-// src/db/projects.ts
-function parseProject(row) {
-  return {
-    id: row["id"],
-    name: row["name"],
-    path: row["path"],
-    description: row["description"] || null,
-    created_at: row["created_at"],
-    updated_at: row["updated_at"]
-  };
-}
-function registerProject(name, path, description, db) {
-  const d = db || getDatabase();
-  const now2 = new Date().toISOString();
-  const existing = d.query("SELECT * FROM projects WHERE path = ?").get(path);
-  if (existing) {
-    d.query("UPDATE projects SET updated_at = ? WHERE id = ?").run(now2, existing["id"]);
-    return getProject(existing["id"], d);
-  }
-  const id = crypto.randomUUID();
-  d.query("INSERT INTO projects (id, name, path, description, created_at, updated_at) VALUES (?, ?, ?, ?, ?, ?)").run(id, name, path, description || null, now2, now2);
-  return getProject(id, d);
-}
-function getProject(idOrPath, db) {
-  const d = db || getDatabase();
-  let row = d.query("SELECT * FROM projects WHERE id = ?").get(idOrPath);
-  if (!row) {
-    row = d.query("SELECT * FROM projects WHERE path = ?").get(idOrPath);
-  }
-  return row ? parseProject(row) : null;
-}
-function listProjects(db) {
-  const d = db || getDatabase();
-  const rows = d.query("SELECT * FROM projects ORDER BY updated_at DESC").all();
-  return rows.map(parseProject);
-}
-
 // src/version.ts
-var VERSION = "0.2.5";
+var VERSION = "0.2.7";
 
 // src/db/feedback.ts
 function saveFeedback(input) {
@@ -1923,8 +1946,16 @@ function apiStore(client) {
         const res = await client.transport.post(`/agents/${encodeURIComponent(idOrName)}/focus`, { project_id: projectId });
         return res ? unwrap(res, "agent") : null;
       } catch (error) {
-        if (error && typeof error === "object" && error.status === 404)
-          return null;
+        if (error && typeof error === "object") {
+          const status = error.status;
+          if (status === 404)
+            return null;
+          if (status === 400) {
+            const body = error.body;
+            const msg = body && typeof body === "object" && typeof body.error === "string" ? body.error : "invalid focus request";
+            throw new Error(msg);
+          }
+        }
         throw error;
       }
     },
@@ -2345,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");
@@ -3173,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/agents.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../src/db/agents.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAc/C,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,EACZ,WAAW,CAAC,EAAE,MAAM,EACpB,IAAI,CAAC,EAAE,MAAM,EACb,EAAE,CAAC,EAAE,QAAQ,GACZ,KAAK,CAuBP;AAED,wBAAgB,QAAQ,CACtB,QAAQ,EAAE,MAAM,EAChB,EAAE,CAAC,EAAE,QAAQ,GACZ,KAAK,GAAG,IAAI,CAuBd;AAED,wBAAgB,UAAU,CAAC,EAAE,CAAC,EAAE,QAAQ,GAAG,KAAK,EAAE,CAMjD;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,KAAK,GAAG,IAAI,CAS5E;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,KAAK,GAAG,IAAI,CAUrG"}
+{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../src/db/agents.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,YAAY,CAAC;AAI3C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAc/C,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,EACZ,WAAW,CAAC,EAAE,MAAM,EACpB,IAAI,CAAC,EAAE,MAAM,EACb,EAAE,CAAC,EAAE,QAAQ,GACZ,KAAK,CAuBP;AAED,wBAAgB,QAAQ,CACtB,QAAQ,EAAE,MAAM,EAChB,EAAE,CAAC,EAAE,QAAQ,GACZ,KAAK,GAAG,IAAI,CAuBd;AAED,wBAAgB,UAAU,CAAC,EAAE,CAAC,EAAE,QAAQ,GAAG,KAAK,EAAE,CAMjD;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,KAAK,GAAG,IAAI,CAS5E;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,KAAK,GAAG,IAAI,CAoBrG"}

package/dist/db/errors.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Shared domain errors for the storage layer.
+ *
+ * `ProjectNotFoundError` is thrown when a focus request references a project
+ * that cannot be resolved to a real row. It exists so both backends (LocalStore
+ * SQLite and the server Postgres repo) fail focus the SAME clean way — and so
+ * the `/v1` route can translate it into a 400 instead of leaking the raw
+ * foreign-key error (`agents_active_project_id_fkey` / "FOREIGN KEY constraint
+ * failed").
+ */
+export declare class ProjectNotFoundError extends Error {
+    readonly ref: string;
+    constructor(ref: string);
+}
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +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"}

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

@@ -1 +1 @@
-{"version":3,"file":"projects.d.ts","sourceRoot":"","sources":["../../src/db/projects.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAajD,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,WAAW,CAAC,EAAE,MAAM,EACpB,EAAE,CAAC,EAAE,QAAQ,GACZ,OAAO,CAuBT;AAED,wBAAgB,UAAU,CACxB,QAAQ,EAAE,MAAM,EAChB,EAAE,CAAC,EAAE,QAAQ,GACZ,OAAO,GAAG,IAAI,CAchB;AAED,wBAAgB,YAAY,CAAC,EAAE,CAAC,EAAE,QAAQ,GAAG,OAAO,EAAE,CAMrD"}
+{"version":3,"file":"projects.d.ts","sourceRoot":"","sources":["../../src/db/projects.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAajD,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,WAAW,CAAC,EAAE,MAAM,EACpB,EAAE,CAAC,EAAE,QAAQ,GACZ,OAAO,CAuBT;AAED,wBAAgB,UAAU,CACxB,QAAQ,EAAE,MAAM,EAChB,EAAE,CAAC,EAAE,QAAQ,GACZ,OAAO,GAAG,IAAI,CA4BhB;AAED,wBAAgB,YAAY,CAAC,EAAE,CAAC,EAAE,QAAQ,GAAG,OAAO,EAAE,CAMrD"}

package/dist/index.js

@@ -656,6 +656,59 @@ function getRecordingStats(db) {
   };
 }
 
+// src/db/projects.ts
+function parseProject(row) {
+  return {
+    id: row["id"],
+    name: row["name"],
+    path: row["path"],
+    description: row["description"] || null,
+    created_at: row["created_at"],
+    updated_at: row["updated_at"]
+  };
+}
+function registerProject(name, path, description, db) {
+  const d = db || getDatabase();
+  const now = new Date().toISOString();
+  const existing = d.query("SELECT * FROM projects WHERE path = ?").get(path);
+  if (existing) {
+    d.query("UPDATE projects SET updated_at = ? WHERE id = ?").run(now, existing["id"]);
+    return getProject(existing["id"], d);
+  }
+  const id = crypto.randomUUID();
+  d.query("INSERT INTO projects (id, name, path, description, created_at, updated_at) VALUES (?, ?, ?, ?, ?, ?)").run(id, name, path, description || null, now, now);
+  return getProject(id, d);
+}
+function getProject(idOrPath, db) {
+  const d = db || getDatabase();
+  let row = d.query("SELECT * FROM projects WHERE id = ?").get(idOrPath);
+  if (!row) {
+    row = d.query("SELECT * FROM projects WHERE path = ?").get(idOrPath);
+  }
+  if (!row) {
+    row = d.query("SELECT * FROM projects WHERE name = ?").get(idOrPath);
+  }
+  if (!row && idOrPath) {
+    row = d.query("SELECT * FROM projects WHERE id LIKE ? || '%'").get(idOrPath);
+  }
+  return row ? parseProject(row) : null;
+}
+function listProjects(db) {
+  const d = db || getDatabase();
+  const rows = d.query("SELECT * FROM projects ORDER BY updated_at DESC").all();
+  return rows.map(parseProject);
+}
+
+// src/db/errors.ts
+class ProjectNotFoundError extends Error {
+  ref;
+  constructor(ref) {
+    super(`project not found: ${ref}`);
+    this.name = "ProjectNotFoundError";
+    this.ref = ref;
+  }
+}
+
 // src/db/agents.ts
 function parseAgent(row) {
   return {
@@ -709,49 +762,19 @@ function setAgentFocus(idOrName, projectId, db) {
   const agent = getAgent(idOrName, d);
   if (!agent)
     return null;
-  d.query("UPDATE agents SET active_project_id = ?, last_seen_at = ? WHERE id = ?").run(projectId, new Date().toISOString(), agent.id);
+  let resolvedProjectId = null;
+  if (projectId) {
+    const project = getProject(projectId, d);
+    if (!project)
+      throw new ProjectNotFoundError(projectId);
+    resolvedProjectId = project.id;
+  }
+  d.query("UPDATE agents SET active_project_id = ?, last_seen_at = ? WHERE id = ?").run(resolvedProjectId, new Date().toISOString(), agent.id);
   return getAgent(agent.id, d);
 }
 
-// src/db/projects.ts
-function parseProject(row) {
-  return {
-    id: row["id"],
-    name: row["name"],
-    path: row["path"],
-    description: row["description"] || null,
-    created_at: row["created_at"],
-    updated_at: row["updated_at"]
-  };
-}
-function registerProject(name, path, description, db) {
-  const d = db || getDatabase();
-  const now = new Date().toISOString();
-  const existing = d.query("SELECT * FROM projects WHERE path = ?").get(path);
-  if (existing) {
-    d.query("UPDATE projects SET updated_at = ? WHERE id = ?").run(now, existing["id"]);
-    return getProject(existing["id"], d);
-  }
-  const id = crypto.randomUUID();
-  d.query("INSERT INTO projects (id, name, path, description, created_at, updated_at) VALUES (?, ?, ?, ?, ?, ?)").run(id, name, path, description || null, now, now);
-  return getProject(id, d);
-}
-function getProject(idOrPath, db) {
-  const d = db || getDatabase();
-  let row = d.query("SELECT * FROM projects WHERE id = ?").get(idOrPath);
-  if (!row) {
-    row = d.query("SELECT * FROM projects WHERE path = ?").get(idOrPath);
-  }
-  return row ? parseProject(row) : null;
-}
-function listProjects(db) {
-  const d = db || getDatabase();
-  const rows = d.query("SELECT * FROM projects ORDER BY updated_at DESC").all();
-  return rows.map(parseProject);
-}
-
 // src/version.ts
-var VERSION = "0.2.5";
+var VERSION = "0.2.7";
 
 // src/db/feedback.ts
 function saveFeedback(input) {
@@ -1182,8 +1205,16 @@ function apiStore(client) {
         const res = await client.transport.post(`/agents/${encodeURIComponent(idOrName)}/focus`, { project_id: projectId });
         return res ? unwrap(res, "agent") : null;
       } catch (error) {
-        if (error && typeof error === "object" && error.status === 404)
-          return null;
+        if (error && typeof error === "object") {
+          const status = error.status;
+          if (status === 404)
+            return null;
+          if (status === 400) {
+            const body = error.body;
+            const msg = body && typeof body === "object" && typeof body.error === "string" ? body.error : "invalid focus request";
+            throw new Error(msg);
+          }
+        }
         throw error;
       }
     },

package/dist/mcp/index.js

@@ -4530,6 +4530,59 @@ function getRecordingStats(db) {
   };
 }
 
+// src/db/projects.ts
+function parseProject(row) {
+  return {
+    id: row["id"],
+    name: row["name"],
+    path: row["path"],
+    description: row["description"] || null,
+    created_at: row["created_at"],
+    updated_at: row["updated_at"]
+  };
+}
+function registerProject(name, path, description, db) {
+  const d = db || getDatabase();
+  const now = new Date().toISOString();
+  const existing = d.query("SELECT * FROM projects WHERE path = ?").get(path);
+  if (existing) {
+    d.query("UPDATE projects SET updated_at = ? WHERE id = ?").run(now, existing["id"]);
+    return getProject(existing["id"], d);
+  }
+  const id = crypto.randomUUID();
+  d.query("INSERT INTO projects (id, name, path, description, created_at, updated_at) VALUES (?, ?, ?, ?, ?, ?)").run(id, name, path, description || null, now, now);
+  return getProject(id, d);
+}
+function getProject(idOrPath, db) {
+  const d = db || getDatabase();
+  let row = d.query("SELECT * FROM projects WHERE id = ?").get(idOrPath);
+  if (!row) {
+    row = d.query("SELECT * FROM projects WHERE path = ?").get(idOrPath);
+  }
+  if (!row) {
+    row = d.query("SELECT * FROM projects WHERE name = ?").get(idOrPath);
+  }
+  if (!row && idOrPath) {
+    row = d.query("SELECT * FROM projects WHERE id LIKE ? || '%'").get(idOrPath);
+  }
+  return row ? parseProject(row) : null;
+}
+function listProjects(db) {
+  const d = db || getDatabase();
+  const rows = d.query("SELECT * FROM projects ORDER BY updated_at DESC").all();
+  return rows.map(parseProject);
+}
+
+// src/db/errors.ts
+class ProjectNotFoundError extends Error {
+  ref;
+  constructor(ref) {
+    super(`project not found: ${ref}`);
+    this.name = "ProjectNotFoundError";
+    this.ref = ref;
+  }
+}
+
 // src/db/agents.ts
 function parseAgent(row) {
   return {
@@ -4583,49 +4636,19 @@ function setAgentFocus(idOrName, projectId, db) {
   const agent = getAgent(idOrName, d);
   if (!agent)
     return null;
-  d.query("UPDATE agents SET active_project_id = ?, last_seen_at = ? WHERE id = ?").run(projectId, new Date().toISOString(), agent.id);
+  let resolvedProjectId = null;
+  if (projectId) {
+    const project = getProject(projectId, d);
+    if (!project)
+      throw new ProjectNotFoundError(projectId);
+    resolvedProjectId = project.id;
+  }
+  d.query("UPDATE agents SET active_project_id = ?, last_seen_at = ? WHERE id = ?").run(resolvedProjectId, new Date().toISOString(), agent.id);
   return getAgent(agent.id, d);
 }
 
-// src/db/projects.ts
-function parseProject(row) {
-  return {
-    id: row["id"],
-    name: row["name"],
-    path: row["path"],
-    description: row["description"] || null,
-    created_at: row["created_at"],
-    updated_at: row["updated_at"]
-  };
-}
-function registerProject(name, path, description, db) {
-  const d = db || getDatabase();
-  const now = new Date().toISOString();
-  const existing = d.query("SELECT * FROM projects WHERE path = ?").get(path);
-  if (existing) {
-    d.query("UPDATE projects SET updated_at = ? WHERE id = ?").run(now, existing["id"]);
-    return getProject(existing["id"], d);
-  }
-  const id = crypto.randomUUID();
-  d.query("INSERT INTO projects (id, name, path, description, created_at, updated_at) VALUES (?, ?, ?, ?, ?, ?)").run(id, name, path, description || null, now, now);
-  return getProject(id, d);
-}
-function getProject(idOrPath, db) {
-  const d = db || getDatabase();
-  let row = d.query("SELECT * FROM projects WHERE id = ?").get(idOrPath);
-  if (!row) {
-    row = d.query("SELECT * FROM projects WHERE path = ?").get(idOrPath);
-  }
-  return row ? parseProject(row) : null;
-}
-function listProjects(db) {
-  const d = db || getDatabase();
-  const rows = d.query("SELECT * FROM projects ORDER BY updated_at DESC").all();
-  return rows.map(parseProject);
-}
-
 // src/version.ts
-var VERSION = "0.2.5";
+var VERSION = "0.2.7";
 
 // src/db/feedback.ts
 function saveFeedback(input) {
@@ -5056,8 +5079,16 @@ function apiStore(client) {
         const res = await client.transport.post(`/agents/${encodeURIComponent(idOrName)}/focus`, { project_id: projectId });
         return res ? unwrap(res, "agent") : null;
       } catch (error) {
-        if (error && typeof error === "object" && error.status === 404)
-          return null;
+        if (error && typeof error === "object") {
+          const status = error.status;
+          if (status === 404)
+            return null;
+          if (status === 400) {
+            const body = error.body;
+            const msg = body && typeof body === "object" && typeof body.error === "string" ? body.error : "invalid focus request";
+            throw new Error(msg);
+          }
+        }
         throw error;
       }
     },

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.5";
+var VERSION = "0.2.7";
 
 // src/db/remote-storage.ts
 import pg from "pg";
@@ -261,6 +261,19 @@ var init_cloud = __esm(() => {
   init_pg_migrations();
 });
 
+// src/db/errors.ts
+var ProjectNotFoundError;
+var init_errors = __esm(() => {
+  ProjectNotFoundError = class ProjectNotFoundError extends Error {
+    ref;
+    constructor(ref) {
+      super(`project not found: ${ref}`);
+      this.name = "ProjectNotFoundError";
+      this.ref = ref;
+    }
+  };
+});
+
 // src/server/repo.ts
 function shortUuid() {
   return crypto.randomUUID().slice(0, 8);
@@ -446,7 +459,14 @@ async function setAgentFocus(pg2, idOrName, projectId) {
   const agent = await getAgent(pg2, idOrName);
   if (!agent)
     return null;
-  await pg2.run("UPDATE agents SET active_project_id = ?, last_seen_at = ? WHERE id = ?", projectId, new Date().toISOString(), agent.id);
+  let resolvedProjectId = null;
+  if (projectId) {
+    const project = await getProject(pg2, projectId);
+    if (!project)
+      throw new ProjectNotFoundError(projectId);
+    resolvedProjectId = project.id;
+  }
+  await pg2.run("UPDATE agents SET active_project_id = ?, last_seen_at = ? WHERE id = ?", resolvedProjectId, new Date().toISOString(), agent.id);
   return getAgent(pg2, agent.id);
 }
 async function registerProject(pg2, name, path, description) {
@@ -467,6 +487,12 @@ async function getProject(pg2, idOrPath) {
   if (!row) {
     row = await pg2.get("SELECT * FROM projects WHERE path = ?", idOrPath);
   }
+  if (!row) {
+    row = await pg2.get("SELECT * FROM projects WHERE name = ?", idOrPath);
+  }
+  if (!row && idOrPath) {
+    row = await pg2.get("SELECT * FROM projects WHERE id LIKE ? || '%'", idOrPath);
+  }
   return row ? parseProject(row) : null;
 }
 async function listProjects(pg2) {
@@ -480,6 +506,9 @@ async function saveFeedback(pg2, input) {
   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 };
 }
+var init_repo = __esm(() => {
+  init_errors();
+});
 
 // src/server/v1.ts
 function json(body, status = 200) {
@@ -592,8 +621,14 @@ async function handleV1Request(req, url) {
         if (method !== "POST")
           return error(405, `method ${method} not allowed on /v1/agents/:id/focus`);
         const body = await readJson(req);
-        const agent = await setAgentFocus(pg2, id, body?.project_id ?? null);
-        return agent ? json({ agent }) : error(404, "agent not found");
+        try {
+          const agent = await setAgentFocus(pg2, id, body?.project_id ?? null);
+          return agent ? json({ agent }) : error(404, "agent not found");
+        } catch (e) {
+          if (e instanceof ProjectNotFoundError)
+            return error(400, e.message);
+          throw e;
+        }
       }
       if (action)
         return error(404, `unknown agent action: ${action}`);
@@ -650,6 +685,7 @@ async function handleV1Request(req, url) {
 var JSON_HEADERS;
 var init_v1 = __esm(() => {
   init_cloud();
+  init_repo();
   JSON_HEADERS = { "Content-Type": "application/json" };
 });
 
@@ -1430,7 +1466,7 @@ function getErrorMap() {
   return overrideErrorMap;
 }
 var overrideErrorMap;
-var init_errors = __esm(() => {
+var init_errors2 = __esm(() => {
   init_en();
   overrideErrorMap = en_default;
 });
@@ -1532,7 +1568,7 @@ var makeIssue = (params) => {
   };
 }, EMPTY_PATH, INVALID, DIRTY = (value) => ({ status: "dirty", value }), OK = (value) => ({ status: "valid", value }), isAborted = (x) => x.status === "aborted", isDirty = (x) => x.status === "dirty", isValid = (x) => x.status === "valid", isAsync = (x) => typeof Promise !== "undefined" && x instanceof Promise;
 var init_parseUtil = __esm(() => {
-  init_errors();
+  init_errors2();
   init_en();
   EMPTY_PATH = [];
   INVALID = Object.freeze({
@@ -2100,7 +2136,7 @@ var handleResult = (ctx, result) => {
 }) => custom((data) => data instanceof cls, params), stringType, numberType, nanType, bigIntType, booleanType, dateType, symbolType, undefinedType, nullType, anyType, unknownType, neverType, voidType, arrayType, objectType, strictObjectType, unionType, discriminatedUnionType, intersectionType, tupleType, recordType, mapType, setType, functionType, lazyType, literalType, enumType, nativeEnumType, promiseType, effectsType, optionalType, nullableType, preprocessType, pipelineType, ostring = () => stringType().optional(), onumber = () => numberType().optional(), oboolean = () => booleanType().optional(), coerce, NEVER;
 var init_types = __esm(() => {
   init_ZodError();
-  init_errors();
+  init_errors2();
   init_errorUtil();
   init_parseUtil();
   init_util();
@@ -5015,7 +5051,7 @@ __export(exports_external, {
   BRAND: () => BRAND
 });
 var init_external = __esm(() => {
-  init_errors();
+  init_errors2();
   init_parseUtil();
   init_typeAliases();
   init_util();
@@ -5531,6 +5567,52 @@ var init_recordings = __esm(() => {
   init_database();
 });
 
+// src/db/projects.ts
+function parseProject2(row) {
+  return {
+    id: row["id"],
+    name: row["name"],
+    path: row["path"],
+    description: row["description"] || null,
+    created_at: row["created_at"],
+    updated_at: row["updated_at"]
+  };
+}
+function registerProject2(name, path, description, db) {
+  const d = db || getDatabase();
+  const now = new Date().toISOString();
+  const existing = d.query("SELECT * FROM projects WHERE path = ?").get(path);
+  if (existing) {
+    d.query("UPDATE projects SET updated_at = ? WHERE id = ?").run(now, existing["id"]);
+    return getProject2(existing["id"], d);
+  }
+  const id = crypto.randomUUID();
+  d.query("INSERT INTO projects (id, name, path, description, created_at, updated_at) VALUES (?, ?, ?, ?, ?, ?)").run(id, name, path, description || null, now, now);
+  return getProject2(id, d);
+}
+function getProject2(idOrPath, db) {
+  const d = db || getDatabase();
+  let row = d.query("SELECT * FROM projects WHERE id = ?").get(idOrPath);
+  if (!row) {
+    row = d.query("SELECT * FROM projects WHERE path = ?").get(idOrPath);
+  }
+  if (!row) {
+    row = d.query("SELECT * FROM projects WHERE name = ?").get(idOrPath);
+  }
+  if (!row && idOrPath) {
+    row = d.query("SELECT * FROM projects WHERE id LIKE ? || '%'").get(idOrPath);
+  }
+  return row ? parseProject2(row) : null;
+}
+function listProjects2(db) {
+  const d = db || getDatabase();
+  const rows = d.query("SELECT * FROM projects ORDER BY updated_at DESC").all();
+  return rows.map(parseProject2);
+}
+var init_projects = __esm(() => {
+  init_database();
+});
+
 // src/db/agents.ts
 function parseAgent2(row) {
   return {
@@ -5584,51 +5666,20 @@ function setAgentFocus2(idOrName, projectId, db) {
   const agent = getAgent2(idOrName, d);
   if (!agent)
     return null;
-  d.query("UPDATE agents SET active_project_id = ?, last_seen_at = ? WHERE id = ?").run(projectId, new Date().toISOString(), agent.id);
+  let resolvedProjectId = null;
+  if (projectId) {
+    const project = getProject2(projectId, d);
+    if (!project)
+      throw new ProjectNotFoundError(projectId);
+    resolvedProjectId = project.id;
+  }
+  d.query("UPDATE agents SET active_project_id = ?, last_seen_at = ? WHERE id = ?").run(resolvedProjectId, new Date().toISOString(), agent.id);
   return getAgent2(agent.id, d);
 }
 var init_agents = __esm(() => {
   init_database();
-});
-
-// src/db/projects.ts
-function parseProject2(row) {
-  return {
-    id: row["id"],
-    name: row["name"],
-    path: row["path"],
-    description: row["description"] || null,
-    created_at: row["created_at"],
-    updated_at: row["updated_at"]
-  };
-}
-function registerProject2(name, path, description, db) {
-  const d = db || getDatabase();
-  const now = new Date().toISOString();
-  const existing = d.query("SELECT * FROM projects WHERE path = ?").get(path);
-  if (existing) {
-    d.query("UPDATE projects SET updated_at = ? WHERE id = ?").run(now, existing["id"]);
-    return getProject2(existing["id"], d);
-  }
-  const id = crypto.randomUUID();
-  d.query("INSERT INTO projects (id, name, path, description, created_at, updated_at) VALUES (?, ?, ?, ?, ?, ?)").run(id, name, path, description || null, now, now);
-  return getProject2(id, d);
-}
-function getProject2(idOrPath, db) {
-  const d = db || getDatabase();
-  let row = d.query("SELECT * FROM projects WHERE id = ?").get(idOrPath);
-  if (!row) {
-    row = d.query("SELECT * FROM projects WHERE path = ?").get(idOrPath);
-  }
-  return row ? parseProject2(row) : null;
-}
-function listProjects2(db) {
-  const d = db || getDatabase();
-  const rows = d.query("SELECT * FROM projects ORDER BY updated_at DESC").all();
-  return rows.map(parseProject2);
-}
-var init_projects = __esm(() => {
-  init_database();
+  init_projects();
+  init_errors();
 });
 
 // src/db/feedback.ts
@@ -6014,8 +6065,16 @@ function apiStore(client) {
         const res = await client.transport.post(`/agents/${encodeURIComponent(idOrName)}/focus`, { project_id: projectId });
         return res ? unwrap(res, "agent") : null;
       } catch (error2) {
-        if (error2 && typeof error2 === "object" && error2.status === 404)
-          return null;
+        if (error2 && typeof error2 === "object") {
+          const status = error2.status;
+          if (status === 404)
+            return null;
+          if (status === 400) {
+            const body = error2.body;
+            const msg = body && typeof body === "object" && typeof body.error === "string" ? body.error : "invalid focus request";
+            throw new Error(msg);
+          }
+        }
         throw error2;
       }
     },

package/dist/server/repo.d.ts

@@ -12,7 +12,9 @@
  * stubs — every operation executes real SQL.
  */
 import type { PgAdapterAsync } from "../db/remote-storage.js";
+import { ProjectNotFoundError } from "../db/errors.js";
 import type { Recording, CreateRecordingInput, RecordingFilter, Agent, Project } from "../types/index.js";
+export { ProjectNotFoundError };
 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,CAuKtF"}
+{"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"}

package/dist/storage.js

@@ -495,6 +495,59 @@ function getRecordingStats(db) {
   };
 }
 
+// src/db/projects.ts
+function parseProject(row) {
+  return {
+    id: row["id"],
+    name: row["name"],
+    path: row["path"],
+    description: row["description"] || null,
+    created_at: row["created_at"],
+    updated_at: row["updated_at"]
+  };
+}
+function registerProject(name, path, description, db) {
+  const d = db || getDatabase();
+  const now = new Date().toISOString();
+  const existing = d.query("SELECT * FROM projects WHERE path = ?").get(path);
+  if (existing) {
+    d.query("UPDATE projects SET updated_at = ? WHERE id = ?").run(now, existing["id"]);
+    return getProject(existing["id"], d);
+  }
+  const id = crypto.randomUUID();
+  d.query("INSERT INTO projects (id, name, path, description, created_at, updated_at) VALUES (?, ?, ?, ?, ?, ?)").run(id, name, path, description || null, now, now);
+  return getProject(id, d);
+}
+function getProject(idOrPath, db) {
+  const d = db || getDatabase();
+  let row = d.query("SELECT * FROM projects WHERE id = ?").get(idOrPath);
+  if (!row) {
+    row = d.query("SELECT * FROM projects WHERE path = ?").get(idOrPath);
+  }
+  if (!row) {
+    row = d.query("SELECT * FROM projects WHERE name = ?").get(idOrPath);
+  }
+  if (!row && idOrPath) {
+    row = d.query("SELECT * FROM projects WHERE id LIKE ? || '%'").get(idOrPath);
+  }
+  return row ? parseProject(row) : null;
+}
+function listProjects(db) {
+  const d = db || getDatabase();
+  const rows = d.query("SELECT * FROM projects ORDER BY updated_at DESC").all();
+  return rows.map(parseProject);
+}
+
+// src/db/errors.ts
+class ProjectNotFoundError extends Error {
+  ref;
+  constructor(ref) {
+    super(`project not found: ${ref}`);
+    this.name = "ProjectNotFoundError";
+    this.ref = ref;
+  }
+}
+
 // src/db/agents.ts
 function parseAgent(row) {
   return {
@@ -548,49 +601,19 @@ function setAgentFocus(idOrName, projectId, db) {
   const agent = getAgent(idOrName, d);
   if (!agent)
     return null;
-  d.query("UPDATE agents SET active_project_id = ?, last_seen_at = ? WHERE id = ?").run(projectId, new Date().toISOString(), agent.id);
+  let resolvedProjectId = null;
+  if (projectId) {
+    const project = getProject(projectId, d);
+    if (!project)
+      throw new ProjectNotFoundError(projectId);
+    resolvedProjectId = project.id;
+  }
+  d.query("UPDATE agents SET active_project_id = ?, last_seen_at = ? WHERE id = ?").run(resolvedProjectId, new Date().toISOString(), agent.id);
   return getAgent(agent.id, d);
 }
 
-// src/db/projects.ts
-function parseProject(row) {
-  return {
-    id: row["id"],
-    name: row["name"],
-    path: row["path"],
-    description: row["description"] || null,
-    created_at: row["created_at"],
-    updated_at: row["updated_at"]
-  };
-}
-function registerProject(name, path, description, db) {
-  const d = db || getDatabase();
-  const now = new Date().toISOString();
-  const existing = d.query("SELECT * FROM projects WHERE path = ?").get(path);
-  if (existing) {
-    d.query("UPDATE projects SET updated_at = ? WHERE id = ?").run(now, existing["id"]);
-    return getProject(existing["id"], d);
-  }
-  const id = crypto.randomUUID();
-  d.query("INSERT INTO projects (id, name, path, description, created_at, updated_at) VALUES (?, ?, ?, ?, ?, ?)").run(id, name, path, description || null, now, now);
-  return getProject(id, d);
-}
-function getProject(idOrPath, db) {
-  const d = db || getDatabase();
-  let row = d.query("SELECT * FROM projects WHERE id = ?").get(idOrPath);
-  if (!row) {
-    row = d.query("SELECT * FROM projects WHERE path = ?").get(idOrPath);
-  }
-  return row ? parseProject(row) : null;
-}
-function listProjects(db) {
-  const d = db || getDatabase();
-  const rows = d.query("SELECT * FROM projects ORDER BY updated_at DESC").all();
-  return rows.map(parseProject);
-}
-
 // src/version.ts
-var VERSION = "0.2.5";
+var VERSION = "0.2.7";
 
 // src/db/feedback.ts
 function saveFeedback(input) {
@@ -1021,8 +1044,16 @@ function apiStore(client) {
         const res = await client.transport.post(`/agents/${encodeURIComponent(idOrName)}/focus`, { project_id: projectId });
         return res ? unwrap(res, "agent") : null;
       } catch (error) {
-        if (error && typeof error === "object" && error.status === 404)
-          return null;
+        if (error && typeof error === "object") {
+          const status = error.status;
+          if (status === 404)
+            return null;
+          if (status === 400) {
+            const body = error.body;
+            const msg = body && typeof body === "object" && typeof body.error === "string" ? body.error : "invalid focus request";
+            throw new Error(msg);
+          }
+        }
         throw error;
       }
     },

package/dist/store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EACV,SAAS,EACT,oBAAoB,EACpB,eAAe,EACf,KAAK,EACL,OAAO,EACR,MAAM,kBAAkB,CAAC;AAI1B,OAAO,EAAqC,KAAK,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGzF,eAAO,MAAM,GAAG,eAAe,CAAC;AAEhC,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEtD,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,KAAK;IACpB,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,YAAY,CAAC;IACtC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAGhC,eAAe,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IACjE,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC;IACpD,cAAc,CAAC,MAAM,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IAC/D,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IAChF,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9C,iBAAiB,IAAI,OAAO,CAAC,cAAc,CAAC,CAAC;IAG7C,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IACjF,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC;IAClD,UAAU,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;IAC/B,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC;IACxD,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC;IAGjF,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACpF,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IACtD,YAAY,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IAGnC,YAAY,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnD;AAuKD;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,GAAG,GAAE,MAAM,CAAC,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAe,GAAG,KAAK,CAMzG;AAED,2CAA2C;AAC3C,wBAAgB,YAAY,IAAI,IAAI,CAEnC"}
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EACV,SAAS,EACT,oBAAoB,EACpB,eAAe,EACf,KAAK,EACL,OAAO,EACR,MAAM,kBAAkB,CAAC;AAI1B,OAAO,EAAqC,KAAK,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGzF,eAAO,MAAM,GAAG,eAAe,CAAC;AAEhC,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEtD,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,KAAK;IACpB,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,YAAY,CAAC;IACtC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAGhC,eAAe,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IACjE,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC;IACpD,cAAc,CAAC,MAAM,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IAC/D,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IAChF,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9C,iBAAiB,IAAI,OAAO,CAAC,cAAc,CAAC,CAAC;IAG7C,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IACjF,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC;IAClD,UAAU,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;IAC/B,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC;IACxD,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC;IAGjF,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACpF,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IACtD,YAAY,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IAGnC,YAAY,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnD;AAoLD;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,GAAG,GAAE,MAAM,CAAC,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAe,GAAG,KAAK,CAMzG;AAED,2CAA2C;AAC3C,wBAAgB,YAAY,IAAI,IAAI,CAEnC"}

package/dist/version.d.ts

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

package/package.json

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