@todos-dev/cli 0.1.4 → 0.1.5

package/dist/index.js

@@ -484,6 +484,11 @@ function text(s, details) {
 // src/lib/todoTools.ts
 var REQUEST_TIMEOUT_MS = 1e4;
 var LIST_CAP = 8e3;
+function toolScope(step) {
+  if (step.workspace?.projectId) return { kind: "project", projectId: step.workspace.projectId };
+  if (step.chiefId) return { kind: "account", chiefId: step.chiefId };
+  return null;
+}
 async function request(serverUrl, method, path, token, body) {
   const headers = { "Content-Type": "application/json" };
   if (token) headers["Authorization"] = `Bearer ${token}`;
@@ -511,60 +516,80 @@ function makeTodoTools(serverUrl, token, step) {
   ];
 }
 function makeListTodosTool(serverUrl, token, step) {
-  const projectId = step.workspace?.projectId;
+  const scope = toolScope(step);
   return {
     name: "list_todos",
     label: "List Todos",
-    description: `List the todos in this project so you can see existing/related work and find a todo to update. The first line lists the project's tags with their ids (usable as update_todo's tagIds). Returns each todo as "#<seq> [<phase>] <title> (id: <id>) [tags: \u2026]"; todos you created are marked (yours).`,
+    description: scope?.kind === "account" ? `List the todo boards of every project across the user's teams, grouped by project. Each project header carries its projectId (required by create_todo); each todo renders as "#<seq> [<phase>] <title> (id: <id>)".` : `List the todos in this project so you can see existing/related work and find a todo to update. The first line lists the project's tags with their ids (usable as update_todo's tagIds). Returns each todo as "#<seq> [<phase>] <title> (id: <id>) [tags: \u2026]"; todos you created are marked (yours).`,
     parameters: { type: "object", properties: {}, required: [], additionalProperties: false },
     async execute() {
-      if (!projectId) return text2("No project context for this turn \u2014 todos are unavailable.");
-      const [reply, tagsReply] = await Promise.all([
-        request(serverUrl, "GET", `/api/projects/${projectId}/todos`, token),
-        request(serverUrl, "GET", `/api/projects/${projectId}/tags`, token)
-      ]);
-      if (!reply.ok) return text2(errorText(reply, "Failed to list todos"));
-      const todos = reply.body ?? [];
-      if (!todos.length) return text2("No todos in this project yet.");
-      const tags = tagsReply.ok ? tagsReply.body ?? [] : [];
-      const tagName = new Map(tags.map((t) => [t.id, t.name]));
-      const header = tags.length ? `Project tags: ${tags.map((t) => `${t.name} (id: ${t.id})`).join(", ")}
+      if (scope?.kind === "project") {
+        const { projectId } = scope;
+        const [reply, tagsReply] = await Promise.all([
+          request(serverUrl, "GET", `/api/projects/${projectId}/todos`, token),
+          request(serverUrl, "GET", `/api/projects/${projectId}/tags`, token)
+        ]);
+        if (!reply.ok) return text2(errorText(reply, "Failed to list todos"));
+        const todos = reply.body ?? [];
+        if (!todos.length) return text2("No todos in this project yet.");
+        const tags = tagsReply.ok ? tagsReply.body ?? [] : [];
+        const tagName = new Map(tags.map((t) => [t.id, t.name]));
+        const header = tags.length ? `Project tags: ${tags.map((t) => `${t.name} (id: ${t.id})`).join(", ")}
 ` : "";
-      const lines = todos.map((t) => {
-        const mine = t.createdBy === step.agent.agentId ? " (yours)" : "";
-        const names = (t.tagIds ?? []).map((id) => tagName.get(id)).filter(Boolean);
-        const tagsStr = names.length ? ` [tags: ${names.join(", ")}]` : "";
-        return `#${t.seqNum} [${t.phase}] ${t.title} (id: ${t.id})${tagsStr}${mine}`;
-      });
-      let out = header + lines.join("\n");
-      if (out.length > LIST_CAP) out = out.slice(0, LIST_CAP) + "\n\u2026(truncated)";
-      return text2(out);
+        const lines = todos.map((t) => {
+          const mine = t.createdBy === step.agent.agentId ? " (yours)" : "";
+          const names = (t.tagIds ?? []).map((id) => tagName.get(id)).filter(Boolean);
+          const tagsStr = names.length ? ` [tags: ${names.join(", ")}]` : "";
+          return `#${t.seqNum} [${t.phase}] ${t.title} (id: ${t.id})${tagsStr}${mine}`;
+        });
+        let out = header + lines.join("\n");
+        if (out.length > LIST_CAP) out = out.slice(0, LIST_CAP) + "\n\u2026(truncated)";
+        return text2(out);
+      }
+      if (scope?.kind === "account") {
+        const reply = await request(serverUrl, "GET", `/api/machine/chief/todos?chiefId=${encodeURIComponent(scope.chiefId)}`, token);
+        if (!reply.ok) return text2(errorText(reply, "Failed to list todos"));
+        const projects = reply.body?.projects ?? [];
+        if (!projects.length) return text2("No projects in your teams yet.");
+        const blocks = projects.map((p) => {
+          const lines = p.todos.length ? p.todos.map((t) => `#${t.seqNum} [${t.phase}] ${t.title} (id: ${t.id})`).join("\n") : "(no todos)";
+          return `## ${p.name} (projectId: ${p.id})
+${lines}`;
+        });
+        let out = blocks.join("\n\n");
+        if (out.length > LIST_CAP) out = out.slice(0, LIST_CAP) + "\n\u2026(truncated)";
+        return text2(out);
+      }
+      return text2("No project context for this turn \u2014 todos are unavailable.");
     }
   };
 }
 function makeCreateTodoTool(serverUrl, token, step) {
-  const projectId = step.workspace?.projectId;
+  const scope = toolScope(step);
+  const accountScope = scope?.kind === "account";
   return {
     name: "create_todo",
     label: "Create Todo",
-    description: "Create a follow-up todo for work you discovered but that is out of scope for the current task (e.g. a refactor, a separate bug, a next step). The new todo is added to the project backlog and does NOT run automatically \u2014 the user decides when to start it. Use a clear, actionable title and put the context/acceptance criteria in spec.",
+    description: accountScope ? "Create a todo in one of the user's projects (projectId comes from list_todos's project headers). The new todo lands in that project's backlog and does NOT run automatically \u2014 propose it with propose_builds when it should run. Use a clear, actionable title and put the objective, boundaries, and acceptance criteria in spec." : "Create a follow-up todo for work you discovered but that is out of scope for the current task (e.g. a refactor, a separate bug, a next step). The new todo is added to the project backlog and does NOT run automatically \u2014 the user decides when to start it. Use a clear, actionable title and put the context/acceptance criteria in spec.",
     parameters: {
       type: "object",
       properties: {
-        title: { type: "string", description: "Short, actionable title for the follow-up work." },
+        ...accountScope ? { projectId: { type: "string", description: "Target project id (from list_todos)." } } : {},
+        title: { type: "string", description: "Short, actionable title for the work." },
         spec: { type: "string", description: "Details: what to do, why, and any acceptance criteria. Optional but recommended." }
       },
-      required: ["title"],
+      required: accountScope ? ["projectId", "title"] : ["title"],
       additionalProperties: false
     },
     async execute(_id, params) {
-      if (!projectId) return text2("No project context for this turn \u2014 cannot create a todo.");
       const p = params ?? {};
+      const projectId = scope?.kind === "project" ? scope.projectId : p.projectId;
+      if (!scope || !projectId) return text2(accountScope ? "A projectId is required (find it with list_todos)." : "No project context for this turn \u2014 cannot create a todo.");
       if (!p.title?.trim()) return text2("A title is required to create a todo.");
       const reply = await request(serverUrl, "POST", `/api/projects/${projectId}/todos`, token, {
         title: p.title,
         spec: p.spec ?? "",
-        buildId: step.conversationId
+        buildId: scope.kind === "account" ? scope.chiefId : step.conversationId
       });
       if (!reply.ok) return text2(errorText(reply, "Failed to create todo"));
       const t = reply.body;
@@ -573,10 +598,11 @@ function makeCreateTodoTool(serverUrl, token, step) {
   };
 }
 function makeUpdateTodoTool(serverUrl, token, step) {
+  const scope = toolScope(step);
   return {
     name: "update_todo",
     label: "Update Todo",
-    description: `Update a todo YOU created (only your own \u2014 found via list_todos, marked "(yours)"). You can change its title, spec, or tags (tag ids come from the "Project tags" line of list_todos). Use this to refine a follow-up todo as you learn more. You cannot edit todos created by others or the user, change a todo's phase, or start a build.`,
+    description: scope?.kind === "account" ? "Update a todo's title or spec \u2014 use this to groom a todo before proposing it: make the spec state the objective, boundaries, and acceptance criteria. You cannot change a todo's phase, assignment, or start a build." : `Update a todo YOU created (only your own \u2014 found via list_todos, marked "(yours)"). You can change its title, spec, or tags (tag ids come from the "Project tags" line of list_todos). Use this to refine a follow-up todo as you learn more. You cannot edit todos created by others or the user, change a todo's phase, or start a build.`,
     parameters: {
       type: "object",
       properties: {
@@ -591,7 +617,7 @@ function makeUpdateTodoTool(serverUrl, token, step) {
     async execute(_id, params) {
       const p = params ?? {};
       if (!p.id) return text2("A todo id is required (find it with list_todos).");
-      const patch = { buildId: step.conversationId };
+      const patch = { buildId: scope?.kind === "account" ? scope.chiefId : step.conversationId };
       if (p.title !== void 0) patch.title = p.title;
       if (p.spec !== void 0) patch.spec = p.spec;
       if (p.tagIds !== void 0) patch.tagIds = p.tagIds;
@@ -603,6 +629,126 @@ function makeUpdateTodoTool(serverUrl, token, step) {
   };
 }
 
+// src/lib/chiefTools.ts
+function makeChiefTools(serverUrl, token, step) {
+  return [
+    makeProposeBuildsTool(serverUrl, token, step),
+    makeRunBuildsTool(serverUrl, token, step),
+    makeUpdateMemoryTool(serverUrl, token, step)
+  ];
+}
+var DISPATCH_ITEMS_SCHEMA = {
+  type: "array",
+  minItems: 1,
+  items: {
+    type: "object",
+    properties: {
+      todoId: { type: "string", description: "The todo to run (id from list_todos)." },
+      withPlan: { type: "boolean", description: "Start with a plan step the user confirms before implementation. Default false." },
+      agentId: { type: "string", description: "Suggested agent (from the available-agents list). Omit to use the todo's own assignment." },
+      thinkingLevel: { type: "string", description: "Suggested thinking level for the agent (only with agentId)." },
+      reason: { type: "string", description: "One line on why this todo, this agent, now." }
+    },
+    required: ["todoId"],
+    additionalProperties: false
+  }
+};
+function itemsToBody(items) {
+  return items.map((i) => ({
+    todoId: i.todoId,
+    ...i.withPlan !== void 0 ? { withPlan: i.withPlan } : {},
+    ...i.agentId ? { agent: { agentId: i.agentId, ...i.thinkingLevel ? { thinkingLevel: i.thinkingLevel } : {} } } : {},
+    ...i.reason ? { reason: i.reason } : {}
+  }));
+}
+function makeProposeBuildsTool(serverUrl, token, step) {
+  const chiefId = step.chiefId;
+  return {
+    name: "propose_builds",
+    label: "Propose Builds",
+    description: "Propose which todos to run next. This does NOT start anything \u2014 it creates a proposal card the user reviews, adjusts, and runs. Use this for work YOU are initiating; when the user has explicitly asked to run something, use run_builds instead. Pick the agent (agentId from the available-agents list) and thinking level per item to match the work; set withPlan for tasks that deserve a reviewed plan first. Groom each todo (update_todo: objective, boundaries, acceptance criteria) BEFORE proposing it. On success, reference the returned doc id in your reply as [Run N todos](doc:<id>) so the user sees the card.",
+    parameters: {
+      type: "object",
+      properties: {
+        items: DISPATCH_ITEMS_SCHEMA,
+        summary: { type: "string", description: "One-line summary of the proposal as a whole (optional)." }
+      },
+      required: ["items"],
+      additionalProperties: false
+    },
+    async execute(_id, params) {
+      if (!chiefId) return text2("propose_builds is only available in the chief conversation.");
+      const p = params ?? {};
+      const items = (p.items ?? []).filter((i) => i?.todoId);
+      if (!items.length) return text2("At least one item with a todoId is required.");
+      const reply = await request(serverUrl, "POST", "/api/machine/chief/proposals", token, {
+        chiefId,
+        items: itemsToBody(items),
+        ...p.summary ? { summary: p.summary } : {}
+      });
+      if (!reply.ok) return text2(errorText(reply, "Failed to create the proposal"));
+      const docId = reply.body?.docId;
+      return text2(`Created a proposal with ${items.length} item(s). Reference it in your reply as [Run ${items.length} todo${items.length > 1 ? "s" : ""}](doc:${docId}) so the user sees the proposal card.`);
+    }
+  };
+}
+function makeRunBuildsTool(serverUrl, token, step) {
+  const chiefId = step.chiefId;
+  return {
+    name: "run_builds",
+    label: "Run Builds",
+    description: "Start builds for todos IMMEDIATELY \u2014 no confirmation card. Use this ONLY when the user has explicitly asked for the work to run in this conversation (their message is the approval); for work you are initiating yourself, use propose_builds instead. Same item shape as propose_builds: pick agent/thinkingLevel per item, withPlan for tasks needing a reviewed plan. Groom each todo before running it.",
+    parameters: {
+      type: "object",
+      properties: {
+        items: DISPATCH_ITEMS_SCHEMA
+      },
+      required: ["items"],
+      additionalProperties: false
+    },
+    async execute(_id, params) {
+      if (!chiefId) return text2("run_builds is only available in the chief conversation.");
+      const p = params ?? {};
+      const items = (p.items ?? []).filter((i) => i?.todoId);
+      if (!items.length) return text2("At least one item with a todoId is required.");
+      const reply = await request(serverUrl, "POST", "/api/machine/chief/builds", token, {
+        chiefId,
+        items: itemsToBody(items)
+      });
+      if (!reply.ok) return text2(errorText(reply, "Failed to start builds"));
+      const started = reply.body?.started ?? [];
+      const skipped = items.length - started.length;
+      return text2(
+        `Started ${started.length} build(s): ${started.map((s) => `#${s.seqNum}`).join(", ")}.` + (skipped > 0 ? ` ${skipped} item(s) were skipped (phase changed or no resolvable agent).` : "") + " Tell the user what is now running and with which agents."
+      );
+    }
+  };
+}
+function makeUpdateMemoryTool(serverUrl, token, step) {
+  const chiefId = step.chiefId;
+  return {
+    name: "update_memory",
+    label: "Update Memory",
+    description: "Rewrite your persistent memory \u2014 the notes injected into every future turn, surviving session resets. FULL REPLACEMENT: send the complete new text, not a diff; prune stale entries to stay under the size cap. Save immediately when you learn a durable routing preference, a user preference, or a lesson \u2014 do not wait. Every update is kept as a version the user can restore.",
+    parameters: {
+      type: "object",
+      properties: {
+        content: { type: "string", description: "The complete new memory text (replaces the old entirely)." }
+      },
+      required: ["content"],
+      additionalProperties: false
+    },
+    async execute(_id, params) {
+      if (!chiefId) return text2("update_memory is only available in the chief conversation.");
+      const p = params ?? {};
+      if (!p.content?.trim()) return text2("Memory content is required (full replacement text).");
+      const reply = await request(serverUrl, "POST", "/api/machine/chief/memory", token, { chiefId, content: p.content });
+      if (!reply.ok) return text2(errorText(reply, "Failed to update memory"));
+      return text2("Memory updated. It will be injected into your future turns.");
+    }
+  };
+}
+
 // src/lib/sessionStore.ts
 var import_node_fs3 = require("node:fs");
 var import_promises = require("node:fs/promises");
@@ -1212,7 +1358,8 @@ async function executeStep(step, serverUrl, token, tunnel) {
     const skills = await materializeSkills(step.skills, agentDir);
     const extraCustomTools = [
       makeClientShellTool(tunnel, conversationId, runnersRef),
-      ...makeTodoTools(serverUrl, token, step)
+      ...makeTodoTools(serverUrl, token, step),
+      ...makeChiefTools(serverUrl, token, step)
     ];
     const session = await createSession(sdk, {
       authStorage,
@@ -16031,7 +16178,8 @@ var STEP_DEF = {
   implement_revision: { track: "implement", sink: "chat", phase: { busy: "building", rest: "review", notify: "build_review" } },
   merge: { track: "implement", sink: "chat", phase: { busy: "building", rest: "review", notify: "build_review" } },
   plan_review: { track: "plan", sink: "review" },
-  implement_review: { track: "implement", sink: "review" }
+  implement_review: { track: "implement", sink: "review" },
+  chief: { sink: "chief" }
 };
 var isReviewStep = (k) => STEP_DEF[k].sink === "review";
 var REVIEW_STEP_KINDS = Object.keys(STEP_DEF).filter(isReviewStep);
@@ -16108,6 +16256,33 @@ var UpdateTodoRequestSchema = external_exports.object({
 });
 var MachineCreateTodoRequestSchema = CreateTodoRequestSchema.extend({ buildId: external_exports.string() });
 var MachineUpdateTodoRequestSchema = UpdateTodoRequestSchema.omit({ assignment: true }).extend({ buildId: external_exports.string() });
+var UpdateChiefRequestSchema = external_exports.object({
+  agent: AgentEntrySchema.nullable().optional(),
+  charter: external_exports.string().optional()
+});
+var ChiefStepRequestSchema = external_exports.object({
+  content: external_exports.string().trim().min(1)
+});
+var DispatchItemSchema = external_exports.object({
+  todoId: external_exports.string().min(1),
+  withPlan: external_exports.boolean().optional(),
+  agent: AgentEntrySchema.optional(),
+  reason: external_exports.string().optional()
+});
+var MAX_DISPATCH_ITEMS = 20;
+var MachineProposeBuildsRequestSchema = external_exports.object({
+  chiefId: external_exports.string().min(1),
+  items: external_exports.array(DispatchItemSchema).min(1).max(MAX_DISPATCH_ITEMS),
+  summary: external_exports.string().optional()
+});
+var MachineRunBuildsRequestSchema = external_exports.object({
+  chiefId: external_exports.string().min(1),
+  items: external_exports.array(DispatchItemSchema).min(1).max(MAX_DISPATCH_ITEMS)
+});
+var MachineUpdateMemoryRequestSchema = external_exports.object({
+  chiefId: external_exports.string().min(1),
+  content: external_exports.string().min(1)
+});
 var TriggerBuildRequestSchema = external_exports.object({
   todoIds: external_exports.array(external_exports.string()).min(1),
   // One-time assignment override; falls back to todo.assignment. Server enriches model.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@todos-dev/cli",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "bin": {
     "tds": "dist/index.js"
   },
@@ -27,12 +27,12 @@
     "@tds/types": "0.1.0"
   },
   "optionalDependencies": {
-    "@todos-dev/cli-darwin-arm64": "0.1.4",
-    "@todos-dev/cli-darwin-x64": "0.1.4",
-    "@todos-dev/cli-linux-x64": "0.1.4",
-    "@todos-dev/cli-linux-arm64": "0.1.4",
-    "@todos-dev/cli-win32-x64": "0.1.4",
-    "@todos-dev/cli-win32-arm64": "0.1.4"
+    "@todos-dev/cli-darwin-arm64": "0.1.5",
+    "@todos-dev/cli-darwin-x64": "0.1.5",
+    "@todos-dev/cli-linux-x64": "0.1.5",
+    "@todos-dev/cli-linux-arm64": "0.1.5",
+    "@todos-dev/cli-win32-x64": "0.1.5",
+    "@todos-dev/cli-win32-arm64": "0.1.5"
   },
   "scripts": {
     "dev": "tsx watch src/index.ts",