@hasna/todos 0.11.84 → 0.11.86

package/dist/index.js

@@ -23527,7 +23527,8 @@ function createPostgresTodosStorageAdapter(options) {
       getActiveWork: (filters) => getActiveWork2(filters, store),
       getChangedSince: (since, filters) => getChangedSince(since, filters, store),
       lock: (id, agentId) => lockTask2(id, agentId, store),
-      unlock: (id, agentId) => unlockTask2(id, agentId, store)
+      unlock: (id, agentId) => unlockTask2(id, agentId, store),
+      getByFingerprint: (fingerprint2) => store.getTaskByFingerprint(fingerprint2)
     },
     dependencies: {
       add: (taskId, dependsOn, context) => addDependency2(taskId, dependsOn, store, context),
@@ -23539,6 +23540,16 @@ function createPostgresTodosStorageAdapter(options) {
       add: (input, context) => addVerification(input, store, context),
       list: (taskId) => listVerifications(taskId, store)
     },
+    commits: {
+      add: (input, context) => addCommit(input, store, context),
+      list: (taskId) => listCommits(taskId, store),
+      find: (sha) => findCommit(sha, store)
+    },
+    gitRefs: {
+      add: (input, context) => addGitRef(input, store, context),
+      list: (taskId) => listGitRefs(taskId, store),
+      find: (ref) => findGitRefs(ref, store)
+    },
     projects: {
       create: (input, context) => createProject2(input, store, context),
       get: (id) => store.get("projects", id),
@@ -23559,7 +23570,9 @@ function createPostgresTodosStorageAdapter(options) {
       get: (id) => store.get("agents", id),
       getByName: async (name) => (await store.list("agents")).find((agent) => agent.name === name) ?? null,
       list: async (options2) => (await store.list("agents")).filter((agent) => options2?.include_archived || agent.status !== "archived").sort((a, b) => a.name.localeCompare(b.name)),
-      update: (id, input) => updateAgent2(id, input, store)
+      update: (id, input) => updateAgent2(id, input, store),
+      heartbeat: (idOrName, context) => heartbeatAgent(idOrName, store, context),
+      release: (idOrName, sessionId, context) => releaseAgent2(idOrName, sessionId, store, context)
     },
     taskLists: {
       create: (input, context) => createTaskList2(input, store, context),
@@ -23704,6 +23717,17 @@ class PostgresJsonRecordStore {
     const result = await this.options.client.query(sql, params);
     return result.rows.map((row) => payloadRecord2(row.payload));
   }
+  async getTaskByFingerprint(fingerprint2) {
+    await this.ensureSchema();
+    const sql = `/* todos:task-by-fingerprint */ SELECT payload FROM ${this.tableName}
+      WHERE service = $1 AND object_type = $2 AND deleted_at IS NULL
+        AND payload->'metadata'->>'fingerprint' = $3
+      ORDER BY payload->>'created_at' ASC
+      LIMIT 1`;
+    const result = await this.options.client.query(sql, [this.service, "tasks", fingerprint2]);
+    const row = result.rows[0];
+    return row ? payloadRecord2(row.payload) : null;
+  }
   async countTasks(filter) {
     await this.ensureSchema();
     const { where, params } = this.buildTaskFilterSql(filter);
@@ -24090,6 +24114,53 @@ async function addVerification(input, store, context) {
 async function listVerifications(taskId, store) {
   return (await store.list("verifications")).filter((verification) => verification.task_id === taskId).sort((a, b) => b.run_at.localeCompare(a.run_at));
 }
+async function addCommit(input, store, context) {
+  if (!await store.get("tasks", input.task_id))
+    throw new Error(`Task not found: ${input.task_id}`);
+  const timestamp2 = new Date().toISOString();
+  const commit = {
+    id: randomUUID3(),
+    task_id: input.task_id,
+    sha: input.sha,
+    message: input.message ?? null,
+    author: input.author ?? null,
+    files_changed: input.files_changed ?? null,
+    created_at: timestamp2
+  };
+  await store.upsert("commits", { ...commit, updated_at: timestamp2 }, context);
+  return commit;
+}
+async function listCommits(taskId, store) {
+  return (await store.list("commits")).filter((commit) => commit.task_id === taskId).sort((a, b) => b.created_at.localeCompare(a.created_at));
+}
+async function findCommit(sha, store) {
+  const matches = (await store.list("commits")).filter((commit) => commit.sha === sha || commit.sha.startsWith(sha) || sha.startsWith(commit.sha)).sort((a, b) => b.created_at.localeCompare(a.created_at));
+  return matches[0] ?? null;
+}
+async function addGitRef(input, store, context) {
+  if (!await store.get("tasks", input.task_id))
+    throw new Error(`Task not found: ${input.task_id}`);
+  const timestamp2 = new Date().toISOString();
+  const gitRef = {
+    id: randomUUID3(),
+    task_id: input.task_id,
+    ref_type: input.ref_type,
+    name: input.name,
+    url: input.url ?? null,
+    provider: input.provider ?? null,
+    metadata: input.metadata ?? {},
+    created_at: timestamp2,
+    updated_at: timestamp2
+  };
+  await store.upsert("refs", gitRef, context);
+  return gitRef;
+}
+async function listGitRefs(taskId, store) {
+  return (await store.list("refs")).filter((ref) => ref.task_id === taskId).sort((a, b) => b.created_at.localeCompare(a.created_at));
+}
+async function findGitRefs(ref, store) {
+  return (await store.list("refs")).filter((r) => r.name === ref).sort((a, b) => b.created_at.localeCompare(a.created_at));
+}
 var TASK_ORDER_BY = "ORDER BY CASE payload->>'priority' WHEN 'critical' THEN 0 WHEN 'high' THEN 1 WHEN 'medium' THEN 2 WHEN 'low' THEN 3 ELSE 4 END ASC, payload->>'created_at' ASC, payload->>'id' ASC";
 function toFilterArray(value) {
   return Array.isArray(value) ? value : [value];
@@ -24237,6 +24308,28 @@ async function updateAgent2(id, input, store) {
     last_seen_at: new Date().toISOString()
   });
 }
+async function resolveAgent(idOrName, store) {
+  const byId = await store.get("agents", idOrName);
+  if (byId)
+    return byId;
+  return (await store.list("agents")).find((agent) => agent.name === idOrName) ?? null;
+}
+async function heartbeatAgent(idOrName, store, context) {
+  const agent = await resolveAgent(idOrName, store);
+  if (!agent)
+    return null;
+  return store.upsert("agents", { ...agent, last_seen_at: new Date().toISOString() }, context);
+}
+async function releaseAgent2(idOrName, sessionId, store, context) {
+  const agent = await resolveAgent(idOrName, store);
+  if (!agent)
+    return null;
+  if (sessionId && agent.session_id && agent.session_id !== sessionId) {
+    return { agent, released: false };
+  }
+  const updated = await store.upsert("agents", { ...agent, session_id: null, last_seen_at: new Date().toISOString() }, context);
+  return { agent: updated, released: true };
+}
 async function createTaskList2(input, store, context) {
   const timestamp2 = new Date().toISOString();
   return store.upsert("task_lists", {
@@ -31317,7 +31410,7 @@ function resolveRun(parsed, db) {
   }
   return resolution;
 }
-function resolveAgent(parsed, db) {
+function resolveAgent2(parsed, db) {
   const resolution = blankResolution(parsed);
   const id = resolvePartialId(db, "agents", parsed.target);
   const agent = id ? getAgent(id, db) : getAgentByName(parsed.target, db);
@@ -31354,7 +31447,7 @@ function resolveTask(parsed, db) {
 function resolveUnknown(parsed, workspace, db, maxSymbolMatches) {
   const attempts = [
     () => resolveTask({ ...parsed, kind: "task" }, db),
-    () => resolveAgent({ ...parsed, kind: "agent" }, db),
+    () => resolveAgent2({ ...parsed, kind: "agent" }, db),
     () => resolvePlan({ ...parsed, kind: "plan" }, db),
     () => resolveSymbol({ ...parsed, kind: "symbol" }, workspace, maxSymbolMatches)
   ];
@@ -31389,7 +31482,7 @@ function resolveMentions(input, db) {
       case "run":
         return resolveRun(parsed, d);
       case "agent":
-        return resolveAgent(parsed, d);
+        return resolveAgent2(parsed, d);
       case "task":
         return resolveTask(parsed, d);
       default:
@@ -42207,7 +42300,7 @@ function resolveProjectId(value, db) {
     return null;
   return resolvePartialId(db, "projects", value) || value;
 }
-function resolveAgent2(agentId, db) {
+function resolveAgent3(agentId, db) {
   return db.query("SELECT id, name FROM agents WHERE id = ? OR LOWER(name) = LOWER(?)").get(agentId, agentId);
 }
 function agentTaskWhere(agent, options, db) {
@@ -42251,7 +42344,7 @@ function scoreHandoffs(created, withTaskRefs, withBlockers) {
 }
 function getAgentReliabilityScorecard(agentId, options = {}, db) {
   const d = db || getDatabase();
-  const agent = resolveAgent2(agentId, d);
+  const agent = resolveAgent3(agentId, d);
   if (!agent)
     return null;
   const generatedAt = now();
@@ -42420,7 +42513,7 @@ function getAgentReliabilityScorecard(agentId, options = {}, db) {
 }
 function listAgentReliabilityScorecards(options = {}, db) {
   const d = db || getDatabase();
-  const agents = options.agent_id ? resolveAgent2(options.agent_id, d) ? [resolveAgent2(options.agent_id, d)] : [] : d.query("SELECT id, name FROM agents ORDER BY name").all();
+  const agents = options.agent_id ? resolveAgent3(options.agent_id, d) ? [resolveAgent3(options.agent_id, d)] : [] : d.query("SELECT id, name FROM agents ORDER BY name").all();
   const limit = Number.isFinite(options.limit) && options.limit > 0 ? Math.min(Math.floor(options.limit), 500) : 50;
   return agents.map((agent) => getAgentReliabilityScorecard(agent.id, options, d)).filter((scorecard) => Boolean(scorecard)).filter((scorecard) => {
     const signals = scorecard.signals;

package/dist/mcp/index.js

@@ -22870,6 +22870,18 @@ async function cloudRegisterAgent(client, input) {
   }
   return raw;
 }
+async function cloudHeartbeatAgent(client, idOrName) {
+  const raw = await client.transport.post(`/agents/${encodeURIComponent(idOrName)}/heartbeat`, {});
+  if (raw && typeof raw === "object" && "agent" in raw) {
+    return raw.agent;
+  }
+  return raw ?? null;
+}
+async function cloudReleaseAgent(client, idOrName, sessionId) {
+  const raw = await client.transport.post(`/agents/${encodeURIComponent(idOrName)}/release`, sessionId ? { session_id: sessionId } : {});
+  const env = raw ?? {};
+  return { agent: env.agent ?? null, released: env.released !== false };
+}
 var _cache;
 var init_cloud_router = __esm(() => {
   init_storage();
@@ -44496,6 +44508,19 @@ ID: ${updated.id}${taskNote}`
       agent_id: exports_external.string().describe("Your agent ID or name.")
     }, async ({ agent_id }) => {
       try {
+        const cloud = getTodosCloudClient();
+        if (cloud) {
+          const a = await cloudHeartbeatAgent(cloud, agent_id);
+          if (!a) {
+            return { content: [{ type: "text", text: `Agent not found: ${agent_id}` }], isError: true };
+          }
+          return {
+            content: [{
+              type: "text",
+              text: `Heartbeat: ${a.name} (${a.id}) \u2014 last_seen_at updated to ${a.last_seen_at}`
+            }]
+          };
+        }
         const agent = getAgent(agent_id) || getAgentByName(agent_id);
         if (!agent) {
           return { content: [{ type: "text", text: `Agent not found: ${agent_id}` }], isError: true };
@@ -44518,6 +44543,22 @@ ID: ${updated.id}${taskNote}`
       session_id: exports_external.string().optional().describe("Your session ID \u2014 if provided, release only succeeds if it matches (prevents other sessions from releasing your agent).")
     }, async ({ agent_id, session_id }) => {
       try {
+        const cloud = getTodosCloudClient();
+        if (cloud) {
+          const result = await cloudReleaseAgent(cloud, agent_id, session_id);
+          if (!result.agent) {
+            return { content: [{ type: "text", text: `Agent not found: ${agent_id}` }], isError: true };
+          }
+          if (!result.released) {
+            return { content: [{ type: "text", text: `Release denied: session_id does not match agent's current session.` }], isError: true };
+          }
+          return {
+            content: [{
+              type: "text",
+              text: `Agent released: ${result.agent.name} (${result.agent.id}) \u2014 session cleared, name is now available.`
+            }]
+          };
+        }
         const agent = getAgent(agent_id) || getAgentByName(agent_id);
         if (!agent) {
           return { content: [{ type: "text", text: `Agent not found: ${agent_id}` }], isError: true };
@@ -48130,7 +48171,8 @@ function createPostgresTodosStorageAdapter(options) {
       getActiveWork: (filters) => getActiveWork2(filters, store),
       getChangedSince: (since, filters) => getChangedSince(since, filters, store),
       lock: (id, agentId) => lockTask2(id, agentId, store),
-      unlock: (id, agentId) => unlockTask2(id, agentId, store)
+      unlock: (id, agentId) => unlockTask2(id, agentId, store),
+      getByFingerprint: (fingerprint3) => store.getTaskByFingerprint(fingerprint3)
     },
     dependencies: {
       add: (taskId, dependsOn, context) => addDependency2(taskId, dependsOn, store, context),
@@ -48142,6 +48184,16 @@ function createPostgresTodosStorageAdapter(options) {
       add: (input, context) => addVerification(input, store, context),
       list: (taskId) => listVerifications(taskId, store)
     },
+    commits: {
+      add: (input, context) => addCommit(input, store, context),
+      list: (taskId) => listCommits(taskId, store),
+      find: (sha) => findCommit(sha, store)
+    },
+    gitRefs: {
+      add: (input, context) => addGitRef(input, store, context),
+      list: (taskId) => listGitRefs(taskId, store),
+      find: (ref) => findGitRefs(ref, store)
+    },
     projects: {
       create: (input, context) => createProject2(input, store, context),
       get: (id) => store.get("projects", id),
@@ -48162,7 +48214,9 @@ function createPostgresTodosStorageAdapter(options) {
       get: (id) => store.get("agents", id),
       getByName: async (name) => (await store.list("agents")).find((agent) => agent.name === name) ?? null,
       list: async (options2) => (await store.list("agents")).filter((agent) => options2?.include_archived || agent.status !== "archived").sort((a, b) => a.name.localeCompare(b.name)),
-      update: (id, input) => updateAgent2(id, input, store)
+      update: (id, input) => updateAgent2(id, input, store),
+      heartbeat: (idOrName, context) => heartbeatAgent(idOrName, store, context),
+      release: (idOrName, sessionId, context) => releaseAgent2(idOrName, sessionId, store, context)
     },
     taskLists: {
       create: (input, context) => createTaskList2(input, store, context),
@@ -48307,6 +48361,17 @@ class PostgresJsonRecordStore {
     const result = await this.options.client.query(sql, params);
     return result.rows.map((row) => payloadRecord2(row.payload));
   }
+  async getTaskByFingerprint(fingerprint3) {
+    await this.ensureSchema();
+    const sql = `/* todos:task-by-fingerprint */ SELECT payload FROM ${this.tableName}
+      WHERE service = $1 AND object_type = $2 AND deleted_at IS NULL
+        AND payload->'metadata'->>'fingerprint' = $3
+      ORDER BY payload->>'created_at' ASC
+      LIMIT 1`;
+    const result = await this.options.client.query(sql, [this.service, "tasks", fingerprint3]);
+    const row = result.rows[0];
+    return row ? payloadRecord2(row.payload) : null;
+  }
   async countTasks(filter) {
     await this.ensureSchema();
     const { where, params } = this.buildTaskFilterSql(filter);
@@ -48692,6 +48757,53 @@ async function addVerification(input, store, context) {
 async function listVerifications(taskId, store) {
   return (await store.list("verifications")).filter((verification) => verification.task_id === taskId).sort((a, b) => b.run_at.localeCompare(a.run_at));
 }
+async function addCommit(input, store, context) {
+  if (!await store.get("tasks", input.task_id))
+    throw new Error(`Task not found: ${input.task_id}`);
+  const timestamp3 = new Date().toISOString();
+  const commit = {
+    id: randomUUID3(),
+    task_id: input.task_id,
+    sha: input.sha,
+    message: input.message ?? null,
+    author: input.author ?? null,
+    files_changed: input.files_changed ?? null,
+    created_at: timestamp3
+  };
+  await store.upsert("commits", { ...commit, updated_at: timestamp3 }, context);
+  return commit;
+}
+async function listCommits(taskId, store) {
+  return (await store.list("commits")).filter((commit) => commit.task_id === taskId).sort((a, b) => b.created_at.localeCompare(a.created_at));
+}
+async function findCommit(sha, store) {
+  const matches = (await store.list("commits")).filter((commit) => commit.sha === sha || commit.sha.startsWith(sha) || sha.startsWith(commit.sha)).sort((a, b) => b.created_at.localeCompare(a.created_at));
+  return matches[0] ?? null;
+}
+async function addGitRef(input, store, context) {
+  if (!await store.get("tasks", input.task_id))
+    throw new Error(`Task not found: ${input.task_id}`);
+  const timestamp3 = new Date().toISOString();
+  const gitRef = {
+    id: randomUUID3(),
+    task_id: input.task_id,
+    ref_type: input.ref_type,
+    name: input.name,
+    url: input.url ?? null,
+    provider: input.provider ?? null,
+    metadata: input.metadata ?? {},
+    created_at: timestamp3,
+    updated_at: timestamp3
+  };
+  await store.upsert("refs", gitRef, context);
+  return gitRef;
+}
+async function listGitRefs(taskId, store) {
+  return (await store.list("refs")).filter((ref) => ref.task_id === taskId).sort((a, b) => b.created_at.localeCompare(a.created_at));
+}
+async function findGitRefs(ref, store) {
+  return (await store.list("refs")).filter((r) => r.name === ref).sort((a, b) => b.created_at.localeCompare(a.created_at));
+}
 function toFilterArray(value) {
   return Array.isArray(value) ? value : [value];
 }
@@ -48838,6 +48950,28 @@ async function updateAgent2(id, input, store) {
     last_seen_at: new Date().toISOString()
   });
 }
+async function resolveAgent3(idOrName, store) {
+  const byId = await store.get("agents", idOrName);
+  if (byId)
+    return byId;
+  return (await store.list("agents")).find((agent) => agent.name === idOrName) ?? null;
+}
+async function heartbeatAgent(idOrName, store, context) {
+  const agent = await resolveAgent3(idOrName, store);
+  if (!agent)
+    return null;
+  return store.upsert("agents", { ...agent, last_seen_at: new Date().toISOString() }, context);
+}
+async function releaseAgent2(idOrName, sessionId, store, context) {
+  const agent = await resolveAgent3(idOrName, store);
+  if (!agent)
+    return null;
+  if (sessionId && agent.session_id && agent.session_id !== sessionId) {
+    return { agent, released: false };
+  }
+  const updated = await store.upsert("agents", { ...agent, session_id: null, last_seen_at: new Date().toISOString() }, context);
+  return { agent: updated, released: true };
+}
 async function createTaskList2(input, store, context) {
   const timestamp3 = new Date().toISOString();
   return store.upsert("task_lists", {
@@ -49586,6 +49720,61 @@ async function handleV1Request(req, url) {
           missing
         });
       }
+      if (id === "upsert" && !action) {
+        if (method !== "POST")
+          return error(405, `method ${method} not allowed on /v1/tasks/upsert`);
+        if (typeof store.tasks.getByFingerprint !== "function") {
+          return error(501, "fingerprint upsert is not supported by this storage backend");
+        }
+        const body = await readJson(req) ?? {};
+        const fingerprint3 = typeof body.fingerprint === "string" ? body.fingerprint.trim() : "";
+        if (!fingerprint3)
+          return error(400, "fingerprint is required");
+        if (typeof body.title !== "string" || !body.title.trim())
+          return error(400, "title is required");
+        const existing = await store.tasks.getByFingerprint(fingerprint3);
+        const metadata = {
+          ...existing?.metadata ?? {},
+          ...body.metadata ?? {},
+          fingerprint: fingerprint3
+        };
+        const fields = { metadata };
+        for (const key of [
+          "title",
+          "description",
+          "priority",
+          "status",
+          "project_id",
+          "assigned_to",
+          "working_dir",
+          "plan_id",
+          "task_list_id",
+          "tags",
+          "due_at",
+          "estimated_minutes",
+          "sla_minutes",
+          "requires_approval",
+          "recurrence_rule",
+          "task_type"
+        ]) {
+          const bag = body;
+          if (bag[key] !== undefined)
+            fields[key] = bag[key];
+        }
+        if (!existing) {
+          const task2 = await store.tasks.create({ ...fields, title: body.title }, contextFromPrincipal(principal, body));
+          return json2({ task: task2, created: true }, 201);
+        }
+        try {
+          const task2 = await store.tasks.update(existing.id, { ...fields, version: existing.version }, contextFromPrincipal(principal, body));
+          return json2({ task: task2, created: false });
+        } catch (e) {
+          const msg = e.message || "";
+          if (msg.includes("version conflict"))
+            return error(409, msg);
+          throw e;
+        }
+      }
       if (!id) {
         if (method === "GET") {
           const filter = {
@@ -49639,6 +49828,14 @@ async function handleV1Request(req, url) {
           }
           return error(405, `method ${method} not allowed on /v1/tasks/:id/comments`);
         }
+        if (action === "history") {
+          if (method !== "GET")
+            return error(405, `method ${method} not allowed on /v1/tasks/:id/history`);
+          if (!await store.tasks.get(id))
+            return error(404, "task not found");
+          const history = await store.audit.getTaskHistory(id);
+          return json2({ history, count: history.length });
+        }
         if (action === "lock" || action === "unlock") {
           if (method !== "POST")
             return error(405, `method ${method} not allowed on /v1/tasks/:id/${action}`);
@@ -49722,6 +49919,70 @@ async function handleV1Request(req, url) {
           }
           return error(405, `method ${method} not allowed on /v1/tasks/:id/verifications`);
         }
+        if (action === "commits") {
+          if (!store.commits)
+            return error(501, "commit links are not supported by this storage backend");
+          if (method === "GET") {
+            if (!await store.tasks.get(id))
+              return error(404, "task not found");
+            const commits = await store.commits.list(id);
+            return json2({ commits, count: commits.length });
+          }
+          if (method === "POST") {
+            const body2 = await readJson(req) ?? {};
+            if (typeof body2.sha !== "string" || !body2.sha.trim())
+              return error(400, "sha is required");
+            try {
+              const commit = await store.commits.add({
+                task_id: id,
+                sha: body2.sha,
+                message: body2.message,
+                author: body2.author,
+                files_changed: Array.isArray(body2.files_changed) ? body2.files_changed : undefined
+              }, contextFromPrincipal(principal));
+              return json2({ commit }, 201);
+            } catch (e) {
+              const msg = e.message || "";
+              if (msg.includes("not found"))
+                return error(404, msg);
+              throw e;
+            }
+          }
+          return error(405, `method ${method} not allowed on /v1/tasks/:id/commits`);
+        }
+        if (action === "refs") {
+          if (!store.gitRefs)
+            return error(501, "git ref links are not supported by this storage backend");
+          if (method === "GET") {
+            if (!await store.tasks.get(id))
+              return error(404, "task not found");
+            const refs = await store.gitRefs.list(id);
+            return json2({ refs, count: refs.length });
+          }
+          if (method === "POST") {
+            const body2 = await readJson(req) ?? {};
+            const refType = body2.ref_type === "pull_request" || body2.ref_type === "branch" ? body2.ref_type : "branch";
+            if (typeof body2.name !== "string" || !body2.name.trim())
+              return error(400, "name is required");
+            try {
+              const ref = await store.gitRefs.add({
+                task_id: id,
+                ref_type: refType,
+                name: body2.name,
+                url: body2.url,
+                provider: body2.provider,
+                metadata: body2.metadata
+              }, contextFromPrincipal(principal));
+              return json2({ ref }, 201);
+            } catch (e) {
+              const msg = e.message || "";
+              if (msg.includes("not found"))
+                return error(404, msg);
+              throw e;
+            }
+          }
+          return error(405, `method ${method} not allowed on /v1/tasks/:id/refs`);
+        }
         const body = await readJson(req) ?? {};
         const agentId = body.agent_id || principal.agent || "todos-serve";
         if (action === "start" && method === "POST") {
@@ -49834,6 +50095,30 @@ async function handleV1Request(req, url) {
         }
         return json2({ agent: result }, 201);
       }
+      if (id && action === "heartbeat") {
+        if (method !== "POST")
+          return error(405, `method ${method} not allowed on /v1/agents/:id/heartbeat`);
+        if (typeof store.agents.heartbeat !== "function") {
+          return error(501, "agent heartbeat is not supported by this storage backend");
+        }
+        const agent = await store.agents.heartbeat(id, contextFromPrincipal(principal));
+        return agent ? json2({ agent }) : error(404, "agent not found");
+      }
+      if (id && action === "release") {
+        if (method !== "POST")
+          return error(405, `method ${method} not allowed on /v1/agents/:id/release`);
+        if (typeof store.agents.release !== "function") {
+          return error(501, "agent release is not supported by this storage backend");
+        }
+        const body = await readJson(req) ?? {};
+        const result = await store.agents.release(id, body.session_id, contextFromPrincipal(principal));
+        if (!result)
+          return error(404, "agent not found");
+        if (!result.released) {
+          return error(409, "release denied: session_id does not match agent's current session", { released: false });
+        }
+        return json2({ agent: result.agent, released: true });
+      }
       if (id && method === "GET") {
         const agent = await store.agents.get(id);
         return agent ? json2({ agent }) : error(404, "agent not found");
@@ -49863,6 +50148,22 @@ async function handleV1Request(req, url) {
       const dependencies = await store.dependencies.listAll();
       return json2({ dependencies, count: dependencies.length });
     }
+    if (resource === "commits" && id) {
+      if (method !== "GET")
+        return error(405, `method ${method} not allowed on /v1/commits/:sha`);
+      if (!store.commits)
+        return error(501, "commit links are not supported by this storage backend");
+      const commit = await store.commits.find(id);
+      return json2({ commit: commit ?? null });
+    }
+    if (resource === "refs" && id) {
+      if (method !== "GET")
+        return error(405, `method ${method} not allowed on /v1/refs/:ref`);
+      if (!store.gitRefs)
+        return error(501, "git ref links are not supported by this storage backend");
+      const refs = await store.gitRefs.find(id);
+      return json2({ refs, count: refs.length });
+    }
     if (resource === "next" && !id) {
       if (method !== "GET")
         return error(405, `method ${method} not allowed on /v1/next`);

package/dist/mcp/tools/agents.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/agents.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAOzE,UAAU,UAAU;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,KAAK,OAAO,GAAG;IACb,kBAAkB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IAC9C,SAAS,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IAClD,WAAW,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,MAAM,CAAC;IACpC,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACvC,aAAa,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,UAAU,GAAG,SAAS,CAAC;CAC5D,CAAC;AAEF,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,kBAAkB,EAAE,SAAS,EAAE,WAAW,EAAE,aAAa,EAAE,aAAa,EAAE,EAAE,OAAO,GAAG,IAAI,CA6cjJ"}
+{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/agents.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAOzE,UAAU,UAAU;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,KAAK,OAAO,GAAG;IACb,kBAAkB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IAC9C,SAAS,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IAClD,WAAW,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,MAAM,CAAC;IACpC,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACvC,aAAa,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,UAAU,GAAG,SAAS,CAAC;CAC5D,CAAC;AAEF,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,kBAAkB,EAAE,SAAS,EAAE,WAAW,EAAE,aAAa,EAAE,aAAa,EAAE,EAAE,OAAO,GAAG,IAAI,CA+ejJ"}

package/dist/release-provenance.json

@@ -1,7 +1,7 @@
 {
   "packageName": "@hasna/todos",
-  "packageVersion": "0.11.84",
+  "packageVersion": "0.11.86",
   "repository": "https://github.com/hasna/todos.git",
-  "gitCommit": "f7fcea3d57bf87853fcc48b009019733b2206ca7",
-  "generatedAt": "2026-07-08T15:23:54.541Z"
+  "gitCommit": "25cf0e9f66c7cac1e5e4d312ae8cd7f901e8a9b9",
+  "generatedAt": "2026-07-08T17:12:30.188Z"
 }