@mrrlin-dev/mcp 0.3.68 → 0.4.0

package/dist/bin.cjs

@@ -20700,6 +20700,18 @@ function retargetRetiredApiBaseUrl(input) {
 function retiredApiHostnames() {
   return Object.keys(RETIRED_API_BASE_URLS);
 }
+function bridgeUrlImpliesStaging(input) {
+  const raw = input?.trim();
+  if (!raw) return false;
+  if (isLoopbackUrl(raw)) return true;
+  let hostname3;
+  try {
+    hostname3 = new URL(raw).hostname.toLowerCase();
+  } catch {
+    return false;
+  }
+  return hostname3 === "staging.mrrlin.com";
+}
 function isLoopbackUrl(input) {
   try {
     const url2 = new URL(input);
@@ -20846,11 +20858,12 @@ async function installBrowser(opts = {}) {
 function deriveServeEnvFromProcessEnv(env) {
   const out = {};
   const rawApiUrl = env.MRRLIN_API_BASE_URL?.trim();
+  const bridgeWantsStaging = bridgeUrlImpliesStaging(env.MRRLIN_BRIDGE_URL);
   const apiUrl = rawApiUrl ? retargetRetiredApiBaseUrl(rawApiUrl).baseUrl : void 0;
   if (apiUrl && !isStagingApiBaseUrl(apiUrl)) {
     out.MRRLIN_API_BASE_URL = apiUrl;
     if (env.MRRLIN_API_ALLOW_REMOTE === "1") out.MRRLIN_API_ALLOW_REMOTE = "1";
-  } else if (apiUrl || env.MRRLIN_STAGING === "1") {
+  } else if (apiUrl || env.MRRLIN_STAGING === "1" || bridgeWantsStaging) {
     out.MRRLIN_STAGING = "1";
   }
   return Object.keys(out).length > 0 ? out : void 0;
@@ -21009,7 +21022,7 @@ function blockEnvHasRetiredApiUrl(actual) {
 }
 function renderEnvPreservedNotice(blockId, envKeys) {
   const keys = [...envKeys].sort().join(", ");
-  return `[mrrlin-mcp install-codex] kept your existing [mcp_servers.${blockId}] env keys (${keys}) so your API target is preserved. Re-run with --force to replace or remove it.`;
+  return `[mrrlin-mcp configure bridge] kept your existing [mcp_servers.${blockId}] env keys (${keys}) so your API target is preserved. Re-run with --force to replace or remove it.`;
 }
 async function pathExists(target) {
   try {
@@ -36401,6 +36414,8 @@ var openApiOperationIds = {
   getTask: "getTask",
   archiveTask: "archiveTask",
   unarchiveTask: "unarchiveTask",
+  takeOverTask: "takeOverTask",
+  closeTaskAsWontDo: "closeTaskAsWontDo",
   getWikiPage: "getWikiPage",
   handleGithubInstallCallback: "handleGithubInstallCallback",
   listExecutionArtifacts: "listExecutionArtifacts",
@@ -36889,6 +36904,32 @@ var SUPPORTED_EXECUTION_DOMAINS = Object.keys(SUPPORTED_EXECUTION_POLICY_BY_DOMA
 var taxonomyCategorySchema = external_exports.string().min(1).regex(/^[a-z][a-z0-9-]*$/);
 var taxonomySubcategorySchema = external_exports.string().min(1).regex(/^[a-z][a-z0-9-]*$/);
 var mrrlinTaskAssigneeSchema = external_exports.union([external_exports.string().regex(/^@/), external_exports.string().email()]).nullable();
+var mrrlinStopReasonSchema = external_exports.enum([
+  "task_terminal",
+  "active_run_exists",
+  "draft_running",
+  "consensus_running",
+  "spec_changed_during_advance",
+  "run_limit_reached",
+  "backoff_pending",
+  "blocked_by_active",
+  "spec_missing",
+  "spec_draft_failed",
+  "spec_not_specs_folder",
+  "awaiting_clarification",
+  "consensus_blocked",
+  "consensus_run_failed",
+  "consensus_disabled_spec_not_ready",
+  "spec_approval_pending",
+  "awaiting_handoff",
+  "assigned_to_other",
+  "attempts_exhausted",
+  "daily_job_budget_exhausted",
+  "taken_over",
+  "operator_absent",
+  "autonomy_paused",
+  "unknown"
+]);
 var mrrlinTaskSchema = external_exports.object({
   // Output-optional (not defaulted-required) so existing task fixtures/mocks across the
   // codebase need no churn; DB rows always resolve it to `string | null` via taskRowToTask.
@@ -36903,6 +36944,9 @@ var mrrlinTaskSchema = external_exports.object({
   autonomyReason: external_exports.string().min(1).max(240),
   blockedBy: external_exports.array(mrrlinTaskIdSchema),
   category: taxonomyCategorySchema,
+  // Slice 3 (task-stall-visibility): why a task was closed as won't-do -- populated only by
+  // closeTaskAsWontDo. Output-optional so existing task fixtures need no churn.
+  closeReason: external_exports.string().nullable().optional(),
   directorThreadId: external_exports.string().nullable().default(null),
   dueDate: external_exports.string().date().nullable(),
   followUpAt: external_exports.string().datetime().nullable(),
@@ -36911,6 +36955,9 @@ var mrrlinTaskSchema = external_exports.object({
   latestJudgement: external_exports.string().nullable().default(null),
   latestJudgementAt: external_exports.string().datetime().nullable().default(null),
   latestJudgementKind: external_exports.enum(["autonomy", "handoff"]).nullable().default(null),
+  // Slice 3: the retry-backoff timer for exactly spec_draft_failed/consensus_run_failed -- a task
+  // whose next_attempt_at is in the future is skipped from admission (backoff_pending).
+  nextAttemptAt: external_exports.string().datetime().nullable().optional(),
   notes: external_exports.string().nullable().default(null),
   // Raw operator request captured at task creation (operator-authored ONLY, never Director-generated).
   // The intent-aware spec gate judges the spec against this; null/absent ⇒ the gate fail-closes.
@@ -36920,6 +36967,14 @@ var mrrlinTaskSchema = external_exports.object({
   planId: mrrlinPlanIdSchema.nullable(),
   specApproved: mrrlinSpecApprovedSchema.optional(),
   specWikiPageId: mrrlinWikiPageIdSchema.nullable(),
+  // Slice 3: episode bookkeeping alongside the async_jobs-derived countEpisodeAttempts --
+  // stallAttemptCount backs the exponential-backoff formula, stallRearmed guards against
+  // re-arming the same episode's ceiling more than once.
+  stallAttemptCount: external_exports.number().int().nonnegative().optional(),
+  stallRearmed: external_exports.boolean().optional(),
+  stallNextAction: external_exports.string().nullable().optional(),
+  stallReason: mrrlinStopReasonSchema.nullable().optional(),
+  stallSince: external_exports.string().datetime().nullable().optional(),
   status: mrrlinTaskStatusSchema,
   subcategory: taxonomySubcategorySchema,
   tags: mrrlinTaskTagsSchema,
@@ -36982,6 +37037,12 @@ var mrrlinWikiPageSchema = external_exports.object({
 var mrrlinMarkSpecReadyRequestSchema = external_exports.object({
   ready: external_exports.boolean()
 });
+var mrrlinTakeOverTaskRequestSchema = external_exports.object({
+  assignee: external_exports.string().min(1)
+});
+var mrrlinCloseTaskAsWontDoRequestSchema = external_exports.object({
+  reason: external_exports.string().min(1)
+});
 var mrrlinGithubBindingSchema = external_exports.object({
   appInstallationState: external_exports.enum(["installed", "missing"]),
   installationId: external_exports.number().int().positive().nullable().default(null),
@@ -37997,7 +38058,8 @@ var mrrlinInFlightSchedulerEntrySchema = external_exports.discriminatedUnion("ki
 ]);
 var mrrlinIneligibleTaskSchema = external_exports.object({
   task: mrrlinTaskSchema,
-  autonomyLevel: mrrlinAutonomyLevelSchema
+  autonomyLevel: mrrlinAutonomyLevelSchema,
+  reason: external_exports.string().nullable().optional()
 });
 var schedulerPendingTasksResponseSchema = external_exports.object({
   data: external_exports.object({
@@ -38021,6 +38083,12 @@ var schedulerPendingTasksResponseSchema = external_exports.object({
     // 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),
+    // Additive: the same ownership exclusion grouped by assignee. This reveals who the
+    // autopilot is waiting for without returning task ids or titles in this endpoint.
+    ownershipExcludedAssignees: external_exports.array(external_exports.object({
+      assignee: external_exports.string(),
+      count: external_exports.number().int().min(1)
+    })),
     // Additive: true when the operator-web-presence gate is the reason nothing new is starting
     // (autonomyPaused takes precedence when both apply). Computed by the same shared helper the
     // tick uses, so this page can never claim a task is starting when the tick would decline it.
@@ -38124,6 +38192,7 @@ var mrrlinInboxItemSchema = external_exports.object({
   projectSlug: mrrlinProjectSlugSchema,
   questionOptions: mrrlinInboxQuestionOptionsSchema.nullable().default(null),
   readAt: external_exports.string().datetime().nullable(),
+  reason: external_exports.string().nullable().optional(),
   status: mrrlinInboxItemStatusSchema,
   taskId: mrrlinTaskIdSchema.nullable()
 }).superRefine((value, context) => {
@@ -38970,6 +39039,22 @@ function createMrrlinClient(config2) {
       });
       return taskResponseSchema.parse(body).data;
     },
+    async takeOverTask(projectSlug, taskId, assignee) {
+      const body = await request(`${projectPath(projectSlug)}/tasks/${encodeURIComponent(taskId)}/take-over`, {
+        method: "POST",
+        headers: { "content-type": "application/json" },
+        body: JSON.stringify({ assignee })
+      });
+      return taskResponseSchema.parse(body).data;
+    },
+    async closeTaskAsWontDo(projectSlug, taskId, reason) {
+      const body = await request(`${projectPath(projectSlug)}/tasks/${encodeURIComponent(taskId)}/wont-do`, {
+        method: "POST",
+        headers: { "content-type": "application/json" },
+        body: JSON.stringify({ reason })
+      });
+      return taskResponseSchema.parse(body).data;
+    },
     async updateWikiPage(projectSlug, pageId, patch) {
       const body = await request(`${projectPath(projectSlug)}/wiki/${encodeURIComponent(pageId)}`, {
         body: JSON.stringify(patch),
@@ -40050,7 +40135,7 @@ function startCodexProbe(deps = {}) {
 }
 
 // src/_generated/version.ts
-var PKG_VERSION = "0.3.68";
+var PKG_VERSION = "0.4.0";
 
 // src/api-base-url-migrate.ts
 var import_node_fs2 = __toESM(require("node:fs"), 1);
@@ -43992,9 +44077,14 @@ var BASE_INSTRUCTIONS_PREFIX = [
   "  if you are blocked and a human must decide before the work can continue, leave it at `handoff_needed`.",
   "",
   "File artifacts:",
-  "- Decide BEFORE writing your result whether the operator will scan it, compare across it,",
-  "  re-read it later, keep it, or share it. If so it is a file, not inline text \u2014 judge by use,",
-  "  not by topic, domain, or data type.",
+  "- Decide BEFORE writing your result, by PROVENANCE: output assembled from data you RETRIEVED",
+  "  this run (API, browser, analytics, database, a search over project records) that comes out as",
+  "  a multi-record or multi-dimension result is a FILE, not inline text.",
+  "- Your own synthesis or comparison stays inline however structured it looks, and so does a",
+  "  retrieval yielding one value. Both conditions must hold before it becomes a file. When it",
+  "  qualifies, produce the file; never merely offer one.",
+  "- Mixed output counts as retrieved: if any material part came from a retrieval, treat the whole",
+  "  result as retrieved rather than splitting it between inline text and a file.",
   "- When your output is a file (markdown report, HTML, screenshot), upload it with",
   "  `upload_artifact` and embed the returned markdown link \u2014 never inline large blobs",
   "  into chat, spec, or note text.",
@@ -50959,9 +51049,17 @@ function buildThreadStartParams(msg, config2, desiredModel) {
     "  is not measurable, re-set `verificationDueAt` to a new date with a reason.",
     "",
     "File artifacts contract \u2014 decide the delivery medium BEFORE you compose the reply:",
-    "- First ask what the operator will DO with this output. If they will scan it, compare across",
-    "  it, re-read it later, keep it, or share it, it belongs in a FILE. If they need to know one",
-    "  thing right now, chat alone is right. Judge by use, not by topic, domain, or data type.",
+    "- Decide by PROVENANCE, not by predicting what the operator will do later. If this answer is",
+    "  assembled from data you RETRIEVED this turn (an HTTP/API call, the browser, analytics, a",
+    "  database, a search over project records) AND it comes out as a multi-record or",
+    "  multi-dimension result rather than one fact or a few values, it belongs in a FILE.",
+    "- Your own synthesis, comparison, or judgement belongs in chat, however structured it looks.",
+    "  A retrieval that yields one number or one line also belongs in chat. Both conditions must",
+    "  hold before it becomes a file.",
+    "- Mixed answers count as retrieved: if any material part of the result came from a retrieval,",
+    "  treat the whole answer as retrieved rather than splitting it between chat and a file.",
+    '- When it qualifies, PRODUCE the file. Offering one ("I can give you this as CSV/JSON") is the',
+    "  failure, not the courtesy.",
     "- When it is a file: write it (`.md` for linear prose, `.html` when structure or layout",
     "  carries meaning), upload with `upload_artifact` (class=temp for one-off downloads,",
     "  class=durable when a spec/evidence page references it; pass taskId when known), and paste",
@@ -52133,7 +52231,18 @@ function createBridgeMessageHandler(deps) {
       });
       const mapper = thread.mapper;
       mapper.reset();
-      const contextPrefix = renderContextPrefix({ ...msg.context, directorSessionId });
+      const contextFocusTaskId = msg.context?.focusTaskId?.trim();
+      const contextProjectSlug = msg.context?.projectSlug?.trim();
+      let answeredQuestions;
+      if (deps.listAnsweredQuestions && contextFocusTaskId && contextProjectSlug) {
+        try {
+          const acknowledged = await deps.listAnsweredQuestions(contextProjectSlug, contextFocusTaskId);
+          const withAnswers = acknowledged.filter((item) => Boolean(item.answer)).map((item) => ({ answer: item.answer, question: item.body }));
+          answeredQuestions = withAnswers.length ? withAnswers : void 0;
+        } catch {
+        }
+      }
+      const contextPrefix = renderContextPrefix({ ...msg.context, answeredQuestions, directorSessionId });
       const sendInTurn = (msg2) => {
         const buf = thread.replay;
         if (!buf) {
@@ -52819,7 +52928,7 @@ async function startDirectorBridge() {
       if (!body) return;
       const id = `II-MCPUPD-${(0, import_node_crypto8.randomUUID)()}`;
       try {
-        const row = await client.createInboxItem(projectSlug, { id, kind: "question", body });
+        const row = await client.createInboxItem(projectSlug, { id, kind: "info", body });
         process.stderr.write(
           `[mrrlin-mcp director-bridge] info bridge.self_update.inbox_filed ${JSON.stringify({
             projectSlug,
@@ -52839,6 +52948,7 @@ async function startDirectorBridge() {
         );
       }
     },
+    listAnsweredQuestions: (projectSlug, taskId) => client.listInboxItems(projectSlug, { status: "acknowledged", kind: "question", taskId }),
     // External-agents control plane: the real spawn runner, with the EXTERNAL_AGENTS_CLI operator
     // escape hatch bound here (the handlers stay spawn-free and this is the only production seam).
     runExternalAgentsCli: (args, opts) => runExternalAgentsCli(args, { ...opts, envCliPath: process.env["EXTERNAL_AGENTS_CLI"] })
@@ -53253,11 +53363,13 @@ function renderContextPrefix(context) {
   const urlPath = context?.urlPath?.trim() ? context.urlPath.trim() : void 0;
   const focusTaskId = context?.focusTaskId?.trim() ? context.focusTaskId.trim() : void 0;
   const directorSessionId = context?.directorSessionId?.trim() ? context.directorSessionId.trim() : void 0;
+  const answeredQuestions = context?.answeredQuestions?.length ? context.answeredQuestions : void 0;
   const payload = {};
   if (projectSlug) payload.projectSlug = projectSlug;
   if (urlPath) payload.urlPath = urlPath;
   if (focusTaskId) payload.focusTaskId = focusTaskId;
   if (directorSessionId) payload.directorSessionId = directorSessionId;
+  if (answeredQuestions) payload.answeredQuestions = answeredQuestions;
   const keys = Object.keys(payload);
   if (keys.length === 0) return "";
   return `Context (JSON): ${JSON.stringify(payload)}`;
@@ -57836,6 +57948,8 @@ var mcpToolNames = {
   resetDirectorThread: "reset_director_thread",
   archiveTask: "archive_task",
   unarchiveTask: "unarchive_task",
+  takeOverTask: "take_over_task",
+  closeTaskAsWontDo: "close_task_as_wont_do",
   updateWikiPage: "update_wiki_page",
   markSpecReady: "mark_spec_ready",
   runSpecConsensus: "run_spec_consensus",
@@ -58342,6 +58456,8 @@ var updateTaskInputSchema = taskScopedSchema.merge(mrrlinTaskUpdateSchema);
 var resetDirectorThreadInputSchema = taskScopedSchema;
 var archiveTaskInputSchema = taskScopedSchema;
 var unarchiveTaskInputSchema = taskScopedSchema;
+var takeOverTaskInputSchema = taskScopedSchema.merge(mrrlinTakeOverTaskRequestSchema);
+var closeTaskAsWontDoInputSchema = taskScopedSchema.merge(mrrlinCloseTaskAsWontDoRequestSchema);
 var listPlansInputSchema = projectScopedSchema;
 var createPlanInputSchema = projectScopedSchema.merge(mrrlinPlanCreateSchema);
 var updatePlanInputSchema = planScopedSchema.merge(mrrlinPlanUpdateSchema);
@@ -58499,6 +58615,8 @@ var mcpToolInputSchemas = {
   [mcpToolNames.resetDirectorThread]: resetDirectorThreadInputSchema,
   [mcpToolNames.archiveTask]: archiveTaskInputSchema,
   [mcpToolNames.unarchiveTask]: unarchiveTaskInputSchema,
+  [mcpToolNames.takeOverTask]: takeOverTaskInputSchema,
+  [mcpToolNames.closeTaskAsWontDo]: closeTaskAsWontDoInputSchema,
   [mcpToolNames.updateWikiPage]: updateWikiPageInputSchema,
   [mcpToolNames.markSpecReady]: markSpecReadyInputSchema,
   [mcpToolNames.runSpecConsensus]: runSpecConsensusInputSchema,
@@ -58568,6 +58686,8 @@ var mcpToolOperationIds = {
   [mcpToolNames.resetDirectorThread]: openApiOperationIds.resetDirectorThread,
   [mcpToolNames.archiveTask]: openApiOperationIds.archiveTask,
   [mcpToolNames.unarchiveTask]: openApiOperationIds.unarchiveTask,
+  [mcpToolNames.takeOverTask]: openApiOperationIds.takeOverTask,
+  [mcpToolNames.closeTaskAsWontDo]: openApiOperationIds.closeTaskAsWontDo,
   [mcpToolNames.updateWikiPage]: openApiOperationIds.updateWikiPage,
   [mcpToolNames.markSpecReady]: openApiOperationIds.markSpecReady,
   [mcpToolNames.listInboxItems]: openApiOperationIds.listInboxItems,
@@ -58619,6 +58739,8 @@ var mcpToolDescriptions = {
   [mcpToolNames.resetDirectorThread]: "Clear a task's persisted Director execution thread handle so the next execution run starts a fresh provider thread. Records a director_thread_reset task event.",
   [mcpToolNames.archiveTask]: "Archive a task: hides it from default reads, removes it from plan progress and scheduler consideration, cancels its non-terminal execution runs, and closes its open inbox items. Reversible \u2014 the project owner can restore it with unarchive_task. Records an 'archived' task event.",
   [mcpToolNames.unarchiveTask]: "Restore an archived task to its original status and visibility. Owner-only \u2014 refused with NOT_PROJECT_OWNER for any other caller. Does not resurrect the execution runs or inbox items that were cancelled/closed when the task was archived. Records a 'restored' task event.",
+  [mcpToolNames.takeOverTask]: "Take ownership of a task by assigning it to the provided assignee through the dedicated take-over route.",
+  [mcpToolNames.closeTaskAsWontDo]: "Close a task as won't-do with a required human-readable reason recorded on the task.",
   [mcpToolNames.updateWikiPage]: "Update a markdown Wiki page.",
   [mcpToolNames.markSpecReady]: "Mark a wiki page (folder=Specs) as ready (or not) for execution-run gating. The Director sets this true after validating the spec; any edit to the page's markdown auto-resets it to false.",
   [mcpToolNames.runSpecConsensus]: 'Enqueue the consensus review gate over a Specs/{id} page. Returns IMMEDIATELY with one of: already_converged (a CONVERGED review already exists for the current content \u2014 proceed straight to create_execution_run, do NOT call mark_spec_ready, it is already set), already_reviewed (a terminal CONSENSUS_BLOCKED for this content), already_running (a consensus job is in flight), or queued (a new job was launched). The review runs in the background; its result/blocker arrives in the inbox (info on CONVERGED, handoff on failure) and is surfaced into the open chat. Do NOT call again for the same spec and do NOT poll. On queued/already_running, tell the user it was launched and end the turn. Pass extraHeads: ["researcher"] for specs referencing external libraries/APIs, or ["debugger"] for root-cause/investigation specs to add opt-in specialist reviewers on top of the fixed four. For a NON-code task (domain seo/marketing/content, ADR 0020): the low-risk lanes `seo`, `marketing`, and `content` proceed to `create_execution_run` after consensus, using the same flow as code tasks. Report the spec\'s review outcome to the operator.',
@@ -59066,6 +59188,20 @@ function createMrrlinTools(options) {
       "Unable to unarchive task.",
       async (c, { projectSlug, taskId }) => await c.unarchiveTask(projectSlug, taskId)
     ),
+    [mcpToolNames.takeOverTask]: makeTool(
+      client,
+      mcpToolNames.takeOverTask,
+      "TASK_TAKE_OVER_FAILED",
+      "Unable to take over task.",
+      async (c, { projectSlug, taskId, assignee }) => await c.takeOverTask(projectSlug, taskId, assignee)
+    ),
+    [mcpToolNames.closeTaskAsWontDo]: makeTool(
+      client,
+      mcpToolNames.closeTaskAsWontDo,
+      "TASK_CLOSE_AS_WONT_DO_FAILED",
+      "Unable to close task as won't-do.",
+      async (c, { projectSlug, taskId, reason }) => await c.closeTaskAsWontDo(projectSlug, taskId, reason)
+    ),
     [mcpToolNames.updateWikiPage]: makeTool(
       client,
       mcpToolNames.updateWikiPage,
@@ -59688,13 +59824,15 @@ function installService(deps) {
   }
   const resolvedBins = bins.filter((b) => b !== null);
   const pathEnv = Array.from(new Set(resolvedBins.map((b) => import_node_path21.default.dirname(b)))).join(":");
+  const apiBaseUrl = deps.env.MRRLIN_API_BASE_URL?.trim() || void 0;
+  const staging = deps.env.MRRLIN_STAGING === "1" || !apiBaseUrl && bridgeUrlImpliesStaging(deps.env.MRRLIN_BRIDGE_URL);
   const text = renderEcosystemConfig({
     cwd: resolved.cwd,
     home,
     codexHome: deps.env.CODEX_HOME?.trim() || void 0,
     pathEnv,
-    staging: deps.env.MRRLIN_STAGING === "1",
-    apiBaseUrl: deps.env.MRRLIN_API_BASE_URL?.trim() || void 0
+    staging,
+    apiBaseUrl
   });
   const ecoPath = import_node_path21.default.join(home, ".mrrlin", "ecosystem.config.cjs");
   deps.writeFile(ecoPath, text);
@@ -59817,22 +59955,22 @@ Usage:
   mrrlin-mcp install-browser    Idempotently install the dedicated, pinned
                                 Chromium into ~/.mrrlin/browser/browsers (its own
                                 copy, isolated from the operator's Chrome and
-                                codex-chrome). Run by install-codex; safe to
+                                codex-chrome). Run by configure bridge; safe to
                                 re-run. Exits non-zero on download failure.
 
   mrrlin-mcp browser-serve      Launch the vendored @playwright/mcp against the
                                 dedicated persistent profile
                                 (~/.mrrlin/browser/profile, headed). This is the
-                                command install-codex wires for the
+                                command configure bridge 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
+                                command configure bridge wires for the
                                 [mcp_servers.external-agents] block.
 
-  mrrlin-mcp install-codex      Idempotently register Mrrlin in
+  mrrlin-mcp configure bridge   Idempotently register Mrrlin in
   [--force]                     ~/.codex/config.toml (or CODEX_HOME). Adds an
                                 [mcp_servers.mrrlin] block. Development
                                 checkouts register the local dist/bin.cjs;
@@ -59841,12 +59979,12 @@ Usage:
                                 Bakes API-target env vars into the block as an
                                 inline env table so \`serve\` boots even when the
                                 local 127.0.0.1:8787 is not running. Setup guide:
-                                  MRRLIN_STAGING=1 mrrlin-mcp install-codex
+                                  MRRLIN_STAGING=1 mrrlin-mcp configure bridge
                                 is the canonical path (staging alias + remote-
                                 allow gate in one flag). For a non-staging remote,
                                 pass BOTH the URL AND the allow gate:
                                   MRRLIN_API_BASE_URL=https://... \\
-                                    MRRLIN_API_ALLOW_REMOTE=1 mrrlin-mcp install-codex
+                                    MRRLIN_API_ALLOW_REMOTE=1 mrrlin-mcp configure bridge
                                 Without an allow gate, \`serve\` still refuses any
                                 non-loopback URL (see \`mrrlin-mcp serve\` above).
                                 URL and MRRLIN_STAGING are mutually exclusive at
@@ -59959,8 +60097,8 @@ Usage:
   mrrlin-mcp --help             Show this help.
 
 Operator notes:
-  - install-codex is idempotent: a second run with the same target is a no-op.
-  - install-codex auto-detects how it was installed. Development checkouts keep
+  - configure bridge is idempotent: a second run with the same target is a no-op.
+  - configure bridge auto-detects how it was installed. Development checkouts keep
     using the local dist/bin.cjs; npm installs use
     \`mrrlin-mcp serve\`.
 `;
@@ -59995,16 +60133,29 @@ async function main() {
       process.exitCode = r.status ?? 1;
       return;
     }
-    case "install-codex": {
-      const force = rest.includes("--force");
+    case "configure": {
+      const [target, ...configureRest] = rest;
+      if (target !== "bridge") {
+        process.stderr.write(
+          `configure requires a target. The only supported form is:
+  mrrlin-mcp configure bridge [--force]
+`
+        );
+        if (target !== void 0) {
+          process.stderr.write(`Unknown configure target: ${target}
+`);
+        }
+        process.exit(2);
+      }
+      const force = configureRest.includes("--force");
       const binPath = resolveSelfBinPath();
       try {
         const b = await installBrowser();
-        process.stderr.write(`[mrrlin-mcp install-codex] install-browser ${b.action} ${b.browsersPath}
+        process.stderr.write(`[mrrlin-mcp configure bridge] install-browser ${b.action} ${b.browsersPath}
 `);
       } catch (error51) {
         process.stderr.write(
-          `[mrrlin-mcp install-codex] install-browser FAILED \u2014 config.toml left untouched: ${error51 instanceof Error ? error51.message : String(error51)}
+          `[mrrlin-mcp configure bridge] install-browser FAILED \u2014 config.toml left untouched: ${error51 instanceof Error ? error51.message : String(error51)}
 `
         );
         process.exit(2);
@@ -60015,18 +60166,18 @@ async function main() {
         force,
         serveEnv
       });
-      process.stderr.write(`[mrrlin-mcp install-codex] ${result.action} ${result.configPath}
+      process.stderr.write(`[mrrlin-mcp configure bridge] ${result.action} ${result.configPath}
 `);
       for (const preserved of result.preservedEnvBlocks) {
         process.stderr.write(`${renderEnvPreservedNotice(preserved.blockId, preserved.envKeys)}
 `);
       }
       for (const p of result.prompts) {
-        process.stderr.write(`[mrrlin-mcp install-codex] prompt ${p.name}: ${p.action} ${p.promptPath}
+        process.stderr.write(`[mrrlin-mcp configure bridge] prompt ${p.name}: ${p.action} ${p.promptPath}
 `);
         if (p.action === "skipped-modified") {
           process.stderr.write(
-            `[mrrlin-mcp install-codex] prompt ${p.name}: kept your local edits; run with --force-prompts to overwrite (or delete ${p.promptPath} to take the new bundled version)
+            `[mrrlin-mcp configure bridge] prompt ${p.name}: kept your local edits; run with --force-prompts to overwrite (or delete ${p.promptPath} to take the new bundled version)
 `
           );
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mrrlin-dev/mcp",
-  "version": "0.3.68",
+  "version": "0.4.0",
   "type": "module",
   "bin": {
     "mrrlin-mcp": "dist/bin.cjs"
@@ -21,12 +21,12 @@
     "@types/ws": "^8.18.1",
     "esbuild": "^0.24.0",
     "tsx": "^4.22.3",
-    "@mrrlin/wiki": "0.0.0",
-    "@mrrlin/schemas": "0.0.0",
     "@mrrlin/client": "0.0.0",
-    "@mrrlin/tsconfig": "0.0.0",
+    "@mrrlin/codex-client": "0.0.0",
     "@mrrlin/director-e2e": "0.0.0",
-    "@mrrlin/codex-client": "0.0.0"
+    "@mrrlin/schemas": "0.0.0",
+    "@mrrlin/tsconfig": "0.0.0",
+    "@mrrlin/wiki": "0.0.0"
   },
   "dependencies": {
     "@iarna/toml": "^2.2.5",