@mrrlin-dev/mcp 0.3.41 → 0.3.45

package/dist/bin.cjs

@@ -20672,12 +20672,18 @@ function browserPaths(homeDir = import_node_os.default.homedir()) {
   const root = import_node_path.default.join(homeDir, ".mrrlin", "browser");
   return { root, browsersPath: import_node_path.default.join(root, "browsers"), profilePath: import_node_path.default.join(root, "profile") };
 }
-function resolvePackageBin(pkg) {
+function resolvePackageBin(pkg, binName) {
   const require2 = moduleRequire();
   const pkgJsonPath = require2.resolve(`${pkg}/package.json`);
   const pkgJson = require2(`${pkg}/package.json`);
   const bin = pkgJson.bin;
-  const rel = typeof bin === "string" ? bin : bin ? Object.values(bin)[0] : void 0;
+  let rel;
+  if (binName && bin && typeof bin !== "string") {
+    rel = bin[binName];
+    if (!rel) throw new Error(`${pkg} has no bin entry named ${binName}`);
+  } else {
+    rel = typeof bin === "string" ? bin : bin ? Object.values(bin)[0] : void 0;
+  }
   if (!rel) throw new Error(`${pkg} has no bin entry to resolve a CLI from`);
   return import_node_path.default.join(import_node_path.default.dirname(pkgJsonPath), rel);
 }
@@ -20691,6 +20697,13 @@ function browserServeArgs(homeDir = import_node_os.default.homedir()) {
     env: { PLAYWRIGHT_BROWSERS_PATH: browsersPath }
   };
 }
+function externalAgentsServeArgs() {
+  return {
+    command: process.execPath,
+    // node
+    args: [resolvePackageBin("@mrrlin-dev/external-agents", "external-agents-mcp")]
+  };
+}
 async function installBrowser(opts = {}) {
   const homeDir = opts.homeDir ?? import_node_os.default.homedir();
   const { browsersPath } = browserPaths(homeDir);
@@ -20747,8 +20760,9 @@ function mrrlinTable(binPath, distribution, serveEnv) {
   }
   return { ...base, startup_timeout_sec: 30 };
 }
-function externalAgentsTable() {
-  return { command: "external-agents-mcp", args: [], startup_timeout_sec: 30 };
+function externalAgentsTable(binPath, distribution) {
+  const base = distribution === "npm" ? { command: "mrrlin-mcp", args: ["external-agents-serve"] } : { command: "node", args: [binPath, "external-agents-serve"] };
+  return { ...base, startup_timeout_sec: 30 };
 }
 function browserTable(binPath, distribution, homeDir) {
   const base = distribution === "npm" ? { command: "mrrlin-mcp", args: ["browser-serve"] } : { command: "node", args: [binPath, "browser-serve"] };
@@ -20773,8 +20787,22 @@ function managedBlocks(options, distribution) {
     },
     {
       id: "external-agents",
-      expected: externalAgentsTable(),
-      blockRe: blockRegex("external-agents")
+      expected: externalAgentsTable(options.binPath, distribution),
+      blockRe: blockRegex("external-agents"),
+      // Match ONLY the exact shape this installer used to write: a bare command, optionally with
+      // empty args / a startup_timeout_sec, and NOTHING else. An extra key means the operator
+      // customized the block — most plausibly a hand-added `env` carrying provider API keys, which
+      // renderBlock() would silently drop on rewrite (it renders strictly from `expected`). Such a
+      // block must fall through to CODEX_CONFIG_CONFLICT so replacing it takes an explicit --force,
+      // rather than losing an operator's credentials during a routine update. We deliberately do
+      // NOT carry the env forward instead: KNOWN_MRRLIN_ENV_KEYS treats any foreign key as
+      // operator-authored and never-preserve, so a carried key would turn the NEXT bare re-run into
+      // a conflict and break idempotency.
+      isLegacyOurs: (actual) => {
+        const legacyKeys = /* @__PURE__ */ new Set(["command", "args", "startup_timeout_sec"]);
+        if (!Object.keys(actual).every((key) => legacyKeys.has(key))) return false;
+        return actual.command === "external-agents-mcp" && (actual.args === void 0 || Array.isArray(actual.args) && actual.args.length === 0);
+      }
     }
   ];
 }
@@ -20917,6 +20945,12 @@ async function installCodex(options) {
         if (action === "noop") action = "env-preserved";
         continue;
       }
+      if (block.isLegacyOurs?.(existingTable)) {
+        content = replaceBlock(content, block.blockRe, renderBlock(block));
+        action = "replaced";
+        mutated = true;
+        continue;
+      }
       if (!options.force) {
         const err = {
           code: "CODEX_CONFIG_CONFLICT",
@@ -36358,6 +36392,7 @@ var openApiOperationIds = {
   listInboxItems: "listInboxItems",
   decideInboxItem: "decideInboxItem",
   markInboxItemRead: "markInboxItemRead",
+  markInboxItemsReadByIds: "markInboxItemsReadByIds",
   markAllInboxItemsRead: "markAllInboxItemsRead",
   searchKnowledge: "searchKnowledge",
   updateExecutionRun: "updateExecutionRun",
@@ -37496,16 +37531,116 @@ var mrrlinSchedulerPendingReasonSchema = external_exports.enum([
   "verification_due",
   "wake_floor_passed"
 ]);
+var mrrlinAutonomousStepSchema = external_exports.enum([
+  "noop",
+  "needs_human",
+  "enqueue_spec_draft",
+  "enqueue_consensus",
+  "auto_approve_spec_and_run",
+  "create_execution_run"
+]);
+var mrrlinAutonomousStepReasonSchema = external_exports.enum([
+  "task_terminal",
+  "active_run_exists",
+  "blocked_by_active",
+  "draft_running",
+  "consensus_running",
+  "spec_missing",
+  "spec_draft_failed",
+  "spec_not_specs_folder",
+  "awaiting_clarification",
+  "consensus_blocked",
+  "consensus_disabled_spec_not_ready",
+  "spec_approval_pending",
+  "non_code_execution_unsupported"
+]);
+var mrrlinAutonomousStepVerdictSchema = external_exports.object({
+  step: mrrlinAutonomousStepSchema,
+  reason: mrrlinAutonomousStepReasonSchema.nullable(),
+  // Additive: when reason is "spec_draft_failed" or "consensus_blocked" (the two reasons that park
+  // a task until a human intervenes), the attempt_count of the async_jobs row that produced that
+  // outcome — so the operator can see "failed x3" and judge whether a retry mechanism is needed.
+  // null for every other reason/step (not applicable), and also null if the job could not be found.
+  failureCount: external_exports.number().int().min(0).nullable()
+});
 var mrrlinSchedulerPendingTaskSchema = external_exports.object({
   dueAt: external_exports.string().datetime(),
   reason: mrrlinSchedulerPendingReasonSchema,
-  task: mrrlinTaskSchema
+  task: mrrlinTaskSchema,
+  // Additive: whether the scheduler considers this task due NOW (per `deriveSchedulerDue`), as
+  // opposed to `dueAt` reporting a future trigger or the evaluatedAt fallback when the task has no
+  // trigger at all. Consumers must read this instead of re-deriving due-ness by re-parsing `dueAt`
+  // against "now" — a task with no trigger has `dueAt === evaluatedAt`, which a naive `dueAt <= now`
+  // re-derivation would misclassify as due.
+  due: external_exports.boolean(),
+  // Additive: the REAL admission verdict for this row, computed only inside the tick's bounded
+  // per-cycle slice (`resolveSchedulerProjectLimit`). `null` means "not evaluated this cycle" —
+  // the row is a genuine actionable candidate by the cheap classifier, but beyond the bound the
+  // tick actually looks at, so no real verdict exists yet. Never infer readiness from `null`.
+  verdict: mrrlinAutonomousStepVerdictSchema.nullable()
+});
+var mrrlinSchedulerParkedReasonSchema = external_exports.enum([
+  "running",
+  "awaiting_handoff",
+  "awaiting_clarification",
+  "spec_awaiting_approval",
+  "blocked_by_active"
+]);
+var mrrlinSchedulerParkedTaskSchema = external_exports.object({
+  task: mrrlinTaskSchema,
+  reason: mrrlinSchedulerParkedReasonSchema,
+  blockedByIds: external_exports.array(mrrlinTaskIdSchema),
+  inboxItemId: external_exports.string().nullable(),
+  runId: mrrlinExecutionRunIdSchema.nullable()
+});
+var mrrlinInFlightSchedulerEntrySchema = external_exports.discriminatedUnion("kind", [
+  external_exports.object({
+    kind: external_exports.literal("run"),
+    taskId: mrrlinTaskIdSchema,
+    runId: mrrlinExecutionRunIdSchema,
+    status: external_exports.string(),
+    // Additive: the task's own title, resolved server-side from the same task list the handler
+    // already loaded for this request (no extra query). null only when the task itself could not
+    // be found (should not happen for a `run` entry, whose taskId is required, but the wire
+    // contract stays honest about it rather than assuming).
+    taskTitle: external_exports.string().nullable()
+  }),
+  external_exports.object({
+    kind: external_exports.literal("async_job"),
+    taskId: mrrlinTaskIdSchema.nullable(),
+    jobId: external_exports.string(),
+    toolName: external_exports.enum(["draft_task_spec", "run_spec_consensus"]),
+    // Additive: same resolution as the `run` variant above. null when `taskId` is null (a job
+    // genuinely untied to a visible task) or the task could not be found.
+    taskTitle: external_exports.string().nullable()
+  })
+]);
+var mrrlinIneligibleTaskSchema = external_exports.object({
+  task: mrrlinTaskSchema,
+  autonomyLevel: mrrlinAutonomyLevelSchema
 });
 var schedulerPendingTasksResponseSchema = external_exports.object({
   data: external_exports.object({
     evaluatedAt: external_exports.string().datetime(),
     pending: external_exports.array(mrrlinSchedulerPendingTaskSchema),
-    policy: mrrlinProjectSchedulerPolicySchema
+    parked: external_exports.array(mrrlinSchedulerParkedTaskSchema),
+    slots: external_exports.number().int(),
+    perProjectLimit: external_exports.number().int().min(1),
+    policy: mrrlinProjectSchedulerPolicySchema,
+    // Additive (see mrrlinInFlightSchedulerEntrySchema doc): the actual runs/jobs occupying
+    // autonomous capacity right now. `slots` is derived from THIS SAME list server-side, so the
+    // count and the list can never disagree.
+    inFlight: external_exports.array(mrrlinInFlightSchedulerEntrySchema),
+    // Additive: tasks the tick never even considers (autonomyLevel outside
+    // policy.eligibleAutonomyLevels), excluding terminal tasks.
+    ineligible: external_exports.array(mrrlinIneligibleTaskSchema),
+    // Additive: how many non-terminal tasks were excluded from BOTH `pending` and `parked` because
+    // their assignee is set and does not match the project operator (github.operator). A COUNT
+    // only, deliberately — the operator asked not to show a list of other people's tasks, just a
+    // disclosure that some exist, so a misconfigured `github.operator` (e.g. it doesn't match the
+    // person actually running the project) is visible as a large number instead of the autopilot
+    // silently doing nothing.
+    excludedByOwnershipCount: external_exports.number().int().min(0)
   })
 });
 var wakeDirectorRequestSchema = external_exports.object({
@@ -37594,6 +37729,7 @@ var mrrlinInboxItemSchema = external_exports.object({
   decidedBy: external_exports.string().min(1).nullable(),
   dedupKey: external_exports.string().nullable(),
   directorSessionId: external_exports.string().min(1).nullable(),
+  groupId: external_exports.string().nullable().default(null),
   id: mrrlinInboxItemIdSchema,
   kind: mrrlinInboxItemKindSchema,
   origin: external_exports.string().nullable().optional(),
@@ -37616,6 +37752,7 @@ var mrrlinInboxItemCreateSchema = external_exports.object({
   actionPayload: mrrlinInboxItemActionPayloadSchema.nullable().optional(),
   body: external_exports.string().min(1),
   directorSessionId: external_exports.string().min(1).optional(),
+  groupId: external_exports.string().min(1).optional(),
   id: mrrlinInboxItemIdSchema,
   kind: mrrlinInboxItemKindSchema,
   origin: external_exports.string().min(1).optional(),
@@ -37646,6 +37783,7 @@ var mrrlinInboxItemDecideSchema = external_exports.object({
   }
 });
 var mrrlinInboxItemListFiltersSchema = external_exports.object({
+  groupId: external_exports.string().optional(),
   kind: mrrlinInboxItemKindSchema.optional(),
   readState: external_exports.enum(["read", "unread"]).optional(),
   status: mrrlinInboxItemStatusSchema.optional(),
@@ -37662,6 +37800,15 @@ var inboxMarkAllReadResponseSchema = external_exports.object({
     readAt: external_exports.string().datetime()
   })
 });
+var mrrlinInboxItemsMarkReadRequestSchema = external_exports.object({
+  ids: external_exports.array(external_exports.string().min(1)).min(1)
+});
+var inboxItemsMarkReadResponseSchema = external_exports.object({
+  data: external_exports.object({
+    markedCount: external_exports.number().int().nonnegative(),
+    readAt: external_exports.string().datetime()
+  })
+});
 var inboxItemResponseSchema = external_exports.object({ data: mrrlinInboxItemSchema });
 var inboxItemListResponseSchema = external_exports.object({ data: external_exports.array(mrrlinInboxItemSchema) });
 
@@ -38284,6 +38431,14 @@ function createMrrlinClient(config2) {
       });
       return inboxItemReadResponseSchema.parse(body).data;
     },
+    async markInboxItemsReadByIds(projectSlug, ids) {
+      const body = await request(`${projectPath(projectSlug)}/inbox/mark-read`, {
+        body: JSON.stringify({ ids }),
+        headers: { "content-type": "application/json" },
+        method: "POST"
+      });
+      return inboxItemsMarkReadResponseSchema.parse(body).data;
+    },
     async markAllInboxItemsRead(projectSlug) {
       const body = await request(`${projectPath(projectSlug)}/inbox/mark-all-read`, {
         method: "POST"
@@ -38955,7 +39110,7 @@ function startCodexProbe(deps = {}) {
 }
 
 // src/_generated/version.ts
-var PKG_VERSION = "0.3.41";
+var PKG_VERSION = "0.3.45";
 
 // src/api-base-url.ts
 var DEFAULT_API_BASE_URL = "http://127.0.0.1:8787";
@@ -39248,6 +39403,19 @@ async function collectAgentPoolSnapshot(deps) {
   );
 }
 
+// src/external-agents-bin.ts
+function resolveExternalAgentsCliInvocation(override) {
+  if (override && override.trim()) return { command: override, prefixArgs: [] };
+  try {
+    return {
+      command: "node",
+      prefixArgs: [resolvePackageBin("@mrrlin-dev/external-agents", "external-agents")]
+    };
+  } catch {
+    return { command: "external-agents", prefixArgs: [] };
+  }
+}
+
 // src/agent-pool-loop.ts
 var DEFAULT_INTERVAL_MS2 = 6e4;
 function agentPoolLoopDisabled(env = process.env) {
@@ -39255,7 +39423,7 @@ function agentPoolLoopDisabled(env = process.env) {
 }
 function defaultRunCli(args) {
   const cli = process.env["EXTERNAL_AGENTS_CLI"];
-  const [cmd, baseArgs] = cli ? ["node", [cli, ...args]] : ["external-agents", args];
+  const { command, prefixArgs } = cli ? { command: "node", prefixArgs: [cli] } : resolveExternalAgentsCliInvocation();
   return new Promise((resolve) => {
     let stdout = "";
     let settled = false;
@@ -39266,7 +39434,7 @@ function defaultRunCli(args) {
       }
     };
     try {
-      const child = (0, import_node_child_process5.spawn)(cmd, baseArgs, { stdio: ["ignore", "pipe", "ignore"] });
+      const child = (0, import_node_child_process5.spawn)(command, [...prefixArgs, ...args], { stdio: ["ignore", "pipe", "ignore"] });
       const timer = setTimeout(() => {
         try {
           child.kill("SIGKILL");
@@ -53128,7 +53296,7 @@ var import_node_child_process11 = require("node:child_process");
 function errMessage3(err) {
   return err instanceof Error ? err.message : String(err);
 }
-function runExternalAgents(bin, args, timeoutMs, spawn3) {
+function runExternalAgents(bin, args, label, timeoutMs, spawn3) {
   return new Promise((resolve) => {
     let settled = false;
     const timerRef = { id: void 0 };
@@ -53154,20 +53322,20 @@ function runExternalAgents(bin, args, timeoutMs, spawn3) {
     let stdout = "";
     timerRef.id = setTimeout(() => {
       child.kill("SIGKILL");
-      finish({ code: null, stdout, error: `external-agents ${args[0]} timed out after ${timeoutMs}ms` });
+      finish({ code: null, stdout, error: `external-agents ${label} timed out after ${timeoutMs}ms` });
     }, timeoutMs);
     child.stdout?.on("data", (chunk) => {
       stdout += chunk.toString();
     });
     child.stderr?.on("data", () => {
     });
-    child.on("error", (err) => finish({ code: null, stdout, error: `external-agents ${args[0]} error: ${errMessage3(err)}` }));
+    child.on("error", (err) => finish({ code: null, stdout, error: `external-agents ${label} error: ${errMessage3(err)}` }));
     child.on("close", (code) => finish({ code, stdout }));
   });
 }
 async function pickPanel(input, deps) {
   const spawn3 = deps?.spawn ?? import_node_child_process11.spawn;
-  const bin = deps?.externalAgentsBin ?? "external-agents";
+  const { command, prefixArgs } = resolveExternalAgentsCliInvocation(deps?.externalAgentsBin);
   const args = [
     "pick",
     "--tier-prefer",
@@ -53179,7 +53347,7 @@ async function pickPanel(input, deps) {
     "--exclude-providers",
     input.excludeProvider
   ];
-  const r = await runExternalAgents(bin, args, input.timeoutMs, spawn3);
+  const r = await runExternalAgents(command, [...prefixArgs, ...args], "pick", input.timeoutMs, spawn3);
   if (r.error) return { ok: false, error: r.error };
   if (r.code === 3) return { ok: true, agents: [] };
   if (r.code !== 0) return { ok: false, error: `external-agents pick exited ${r.code}` };
@@ -53188,9 +53356,9 @@ async function pickPanel(input, deps) {
 }
 async function dispatchHead(agentId, prompt, timeoutMs, deps) {
   const spawn3 = deps?.spawn ?? import_node_child_process11.spawn;
-  const bin = deps?.externalAgentsBin ?? "external-agents";
+  const { command, prefixArgs } = resolveExternalAgentsCliInvocation(deps?.externalAgentsBin);
   const args = ["dispatch", agentId, "--json", prompt];
-  const r = await runExternalAgents(bin, args, timeoutMs, spawn3);
+  const r = await runExternalAgents(command, [...prefixArgs, ...args], "dispatch", timeoutMs, spawn3);
   if (r.error) return { ok: false, error: r.error };
   const lines2 = r.stdout.split(/\r?\n/).map((l) => l.trim()).filter(Boolean);
   const jsonLine = [...lines2].reverse().find((l) => l[0] === "{");
@@ -53551,8 +53719,9 @@ async function run(ctx, input) {
         planId = plans.find((p) => p.specWikiPageId === input.pageId)?.id ?? null;
       }
       if (taskId) {
+        const scopeId = taskId;
+        const groupId = clarifications.length > 1 ? `II-${scopeId}-gate-group-${(0, import_node_crypto8.createHash)("sha256").update(clarifications.map((c) => c.question).sort().join("\n")).digest("hex").slice(0, 10)}` : void 0;
         for (const clarification of clarifications) {
-          const scopeId = taskId;
           const id = `II-${scopeId}-gate-${(0, import_node_crypto8.createHash)("sha256").update(clarification.question).digest("hex").slice(0, 10)}`;
           try {
             const questionOptions = buildGateQuestionOptions(clarification.question, clarification.category);
@@ -53562,15 +53731,17 @@ async function run(ctx, input) {
               taskId: scopeId,
               body: clarification.question,
               origin: "gate",
-              ...questionOptions ? { questionOptions } : {}
+              ...questionOptions ? { questionOptions } : {},
+              ...groupId ? { groupId } : {}
             });
           } catch {
           }
         }
         filedQuestionCount = clarifications.length;
       } else if (planId) {
+        const scopeId = planId;
+        const groupId = clarifications.length > 1 ? `II-${scopeId}-gate-group-${(0, import_node_crypto8.createHash)("sha256").update(clarifications.map((c) => c.question).sort().join("\n")).digest("hex").slice(0, 10)}` : void 0;
         for (const clarification of clarifications) {
-          const scopeId = planId;
           const id = `II-${scopeId}-gate-${(0, import_node_crypto8.createHash)("sha256").update(clarification.question).digest("hex").slice(0, 10)}`;
           try {
             const questionOptions = buildGateQuestionOptions(clarification.question, clarification.category);
@@ -53580,7 +53751,8 @@ async function run(ctx, input) {
               planId: scopeId,
               body: clarification.question,
               origin: "gate",
-              ...questionOptions ? { questionOptions } : {}
+              ...questionOptions ? { questionOptions } : {},
+              ...groupId ? { groupId } : {}
             });
           } catch {
           }
@@ -55854,6 +56026,12 @@ Usage:
                                 command install-codex wires for the
                                 [mcp_servers.mrrlin-browser] block.
 
+  mrrlin-mcp external-agents-serve
+                                Launch the bundled @mrrlin-dev/external-agents
+                                MCP server (multi-LLM dispatch pool). This is the
+                                command install-codex wires for the
+                                [mcp_servers.external-agents] block.
+
   mrrlin-mcp install-codex      Idempotently register Mrrlin in
   [--force]                     ~/.codex/config.toml (or CODEX_HOME). Adds an
                                 [mcp_servers.mrrlin] block. Development
@@ -56009,6 +56187,12 @@ async function main() {
       process.exitCode = r.status ?? 1;
       return;
     }
+    case "external-agents-serve": {
+      const { command: command2, args } = externalAgentsServeArgs();
+      const r = (0, import_node_child_process13.spawnSync)(command2, args, { stdio: "inherit", env: process.env });
+      process.exitCode = r.status ?? 1;
+      return;
+    }
     case "install-codex": {
       const force = rest.includes("--force");
       const binPath = resolveSelfBinPath();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mrrlin-dev/mcp",
-  "version": "0.3.41",
+  "version": "0.3.45",
   "type": "module",
   "bin": {
     "mrrlin-mcp": "dist/bin.cjs"
@@ -21,16 +21,17 @@
     "@types/ws": "^8.18.1",
     "esbuild": "^0.24.0",
     "tsx": "^4.22.3",
+    "@mrrlin/schemas": "0.0.0",
     "@mrrlin/director-e2e": "0.0.0",
     "@mrrlin/wiki": "0.0.0",
-    "@mrrlin/schemas": "0.0.0",
+    "@mrrlin/client": "0.0.0",
     "@mrrlin/codex-client": "0.0.0",
-    "@mrrlin/tsconfig": "0.0.0",
-    "@mrrlin/client": "0.0.0"
+    "@mrrlin/tsconfig": "0.0.0"
   },
   "dependencies": {
     "@iarna/toml": "^2.2.5",
     "@modelcontextprotocol/sdk": "^1.0.0",
+    "@mrrlin-dev/external-agents": "^0.32.0",
     "@playwright/mcp": "0.0.76",
     "playwright-core": "1.61.0-alpha-1781023400000",
     "proper-lockfile": "^4.1.2",