@mrrlin-dev/mcp 0.2.6 → 0.3.0

package/dist/bin.cjs

@@ -19266,13 +19266,15 @@ async function acquireThread(codex, opts) {
 }
 
 // ../../packages/codex-client/dist/render-context-bundle.js
+var DEFAULT_SPEC_BUDGET_CHARS = 6e3;
+var DEFAULT_ARTIFACT_PAYLOAD_BUDGET_CHARS = 400;
 function renderContextBundle(input) {
   const sections = [];
   sections.push(renderTaskSummary(input.task));
-  sections.push(renderSpec(input.specMarkdown));
+  sections.push(renderSpec(input.specMarkdown, input.compact));
   sections.push(renderRunHistory(input.runs, input.openRunId));
   sections.push(renderOpenRun(input.openRunId));
-  sections.push(renderArtifacts(input.artifacts, input.omittedArtifactCount ?? 0));
+  sections.push(renderArtifacts(input.artifacts, input.omittedArtifactCount ?? 0, input.compact));
   sections.push(renderAutonomyEvents(input.autonomyEvents));
   return sections.join("\n\n");
 }
@@ -19290,11 +19292,55 @@ function renderTaskSummary(task) {
   }
   return lines2.join("\n");
 }
-function renderSpec(specMarkdown) {
+function renderSpec(specMarkdown, compact) {
   if (!specMarkdown)
     return "## Spec\n(none)";
-  return `## Spec
+  if (!compact)
+    return `## Spec
+${specMarkdown}`;
+  const budget = compact.specBudgetChars ?? DEFAULT_SPEC_BUDGET_CHARS;
+  if (specMarkdown.length <= budget)
+    return `## Spec
 ${specMarkdown}`;
+  return `## Spec
+${compactSpecMarkdown(specMarkdown, budget, compact.projectSlug ?? null, compact.specWikiPageId ?? null)}`;
+}
+function compactSpecMarkdown(markdown, totalBudget, projectSlug, specWikiPageId) {
+  const lines2 = markdown.split(/\r?\n/);
+  const sections = [{ heading: "", body: [] }];
+  for (const line of lines2) {
+    if (/^#{1,6}\s/.test(line)) {
+      sections.push({ heading: line, body: [] });
+    } else {
+      sections[sections.length - 1].body.push(line);
+    }
+  }
+  const sectionCount = Math.max(1, sections.length);
+  const perSectionBudget = Math.max(120, Math.floor(totalBudget / sectionCount));
+  const out = [];
+  for (const section of sections) {
+    const bodyText = section.body.join("\n").replace(/^\s+|\s+$/g, "");
+    if (section.heading)
+      out.push(section.heading);
+    if (!bodyText)
+      continue;
+    if (bodyText.length <= perSectionBudget) {
+      out.push(bodyText);
+    } else {
+      const kept = bodyText.slice(0, perSectionBudget);
+      const omitted = bodyText.length - perSectionBudget;
+      out.push(`${kept}
+\u2026(${omitted} chars omitted; retrieve full spec for the rest)`);
+    }
+  }
+  if (projectSlug && specWikiPageId) {
+    out.push("");
+    out.push(`> Compact spec. Source: mrrlin://wiki/${projectSlug}/${specWikiPageId} \u2014 call retrieve_context with this handle before any irreversible decision.`);
+  } else {
+    out.push("");
+    out.push("> Compact spec. Retrieve the Specs/{id} wiki page via get_wiki_page before any irreversible decision.");
+  }
+  return out.join("\n");
 }
 function renderRunHistory(runs, openRunId) {
   if (runs.length === 0)
@@ -19310,13 +19356,14 @@ function renderOpenRun(openRunId) {
   return `## Open run
 ${openRunId ?? "(none)"}`;
 }
-function renderArtifacts(artifacts, omittedCount) {
+function renderArtifacts(artifacts, omittedCount, compact) {
   if (artifacts.length === 0 && omittedCount === 0)
     return "## Artifacts\n(none)";
   const lines2 = ["## Artifacts"];
   if (omittedCount > 0) {
     lines2.push(`(+${omittedCount} older artifact${omittedCount === 1 ? "" : "s"} omitted)`);
   }
+  let truncatedAny = false;
   for (const artifact of artifacts) {
     if (artifact.kind === "file") {
       const p = artifact.payload;
@@ -19325,7 +19372,16 @@ function renderArtifacts(artifacts, omittedCount) {
         continue;
       }
     }
-    lines2.push(`- ${artifact.createdAt} [${artifact.kind}] run=${artifact.runId} ${JSON.stringify(artifact.payload)}`);
+    const payloadText = JSON.stringify(artifact.payload);
+    const budget = compact?.artifactPayloadBudgetChars ?? DEFAULT_ARTIFACT_PAYLOAD_BUDGET_CHARS;
+    const willTruncate = !!compact && payloadText.length > budget;
+    const rendered = willTruncate ? `${payloadText.slice(0, budget)}\u2026(${payloadText.length - budget} chars omitted)` : payloadText;
+    if (willTruncate)
+      truncatedAny = true;
+    lines2.push(`- ${artifact.createdAt} [${artifact.kind}] run=${artifact.runId} ${rendered}`);
+  }
+  if (compact && (omittedCount > 0 || truncatedAny)) {
+    lines2.push("> Compact artifacts. Use retrieve_context with a `mrrlin://run/{projectSlug}/{runId}/artifacts` handle (substitute the slug and run id from the lines above) to load a run's full artifact history.");
   }
   return lines2.join("\n");
 }
@@ -33901,7 +33957,6 @@ var openApiOperationIds = {
   listExecutionArtifacts: "listExecutionArtifacts",
   listExecutionRuns: "listExecutionRuns",
   listGithubInstallations: "listGithubInstallations",
-  listGithubWebhookDeliveries: "listGithubWebhookDeliveries",
   listGithubWorkflows: "listGithubWorkflows",
   listPlans: "listPlans",
   listProjects: "listProjects",
@@ -33918,7 +33973,6 @@ var openApiOperationIds = {
   decideInboxItem: "decideInboxItem",
   markInboxItemRead: "markInboxItemRead",
   markAllInboxItemsRead: "markAllInboxItemsRead",
-  receiveGithubWebhook: "receiveGithubWebhook",
   searchKnowledge: "searchKnowledge",
   updateExecutionRun: "updateExecutionRun",
   upsertProjectSchedulerPolicy: "upsertProjectSchedulerPolicy",
@@ -33935,6 +33989,10 @@ var openApiOperationIds = {
   listAgentCredentials: "listAgentCredentials",
   revokeAgentCredential: "revokeAgentCredential",
   exchangeAgentToken: "exchangeAgentToken",
+  // ADR 0016 — operator-scoped credential routes.
+  issueOperatorAgentCredential: "issueOperatorAgentCredential",
+  listOperatorAgentCredentials: "listOperatorAgentCredentials",
+  revokeOperatorAgentCredential: "revokeOperatorAgentCredential",
   createArtifactFile: "createArtifactFile",
   completeArtifactFile: "completeArtifactFile",
   getArtifactFile: "getArtifactFile",
@@ -33958,7 +34016,12 @@ var operatorSessionSchema = external_exports.object({
   login: external_exports.string().min(1),
   projectSlug: external_exports.string().min(1),
   provider: external_exports.literal("github"),
-  repo: external_exports.string().min(1).nullable()
+  repo: external_exports.string().min(1).nullable(),
+  // ADR 0016: `scope` distinguishes project-pinned agent tokens (legacy, default) from
+  // operator-scoped agent tokens. Only relevant for kind:"agent". `web` sessions ignore it.
+  // Default 'project' for backward-compat: tokens minted before this field existed parse
+  // cleanly into the project branch of the middleware (which mirrors today's behavior).
+  scope: external_exports.enum(["project", "operator"]).default("project")
 });
 var AGENT_SESSION_TTL_MS = 1e3 * 60 * 60;
 
@@ -34260,15 +34323,6 @@ var mrrlinGithubWorkflowDispatchSchema = external_exports.object({
   ref: external_exports.string().min(1),
   workflowId: external_exports.string().min(1)
 });
-var mrrlinGithubWebhookDeliverySchema = external_exports.object({
-  action: external_exports.string().min(1).nullable(),
-  deliveryId: external_exports.string().min(1),
-  eventType: external_exports.string().min(1),
-  installationId: external_exports.number().int().positive().nullable(),
-  projectSlug: mrrlinProjectSlugSchema.nullable(),
-  receivedAt: external_exports.string().datetime(),
-  repositoryFullName: external_exports.string().regex(/^[^/]+\/[^/]+$/).nullable()
-});
 var mrrlinProjectSummarySchema = external_exports.object({
   displayName: external_exports.string().min(1),
   emoji: mrrlinProjectEmojiSchema,
@@ -34494,14 +34548,6 @@ var githubBindProjectRepoRequestSchema = external_exports.object({
 var githubBindProjectRepoResponseSchema = external_exports.object({
   data: mrrlinProjectSummarySchema
 });
-var githubWebhookReceiptResponseSchema = external_exports.object({
-  data: external_exports.object({
-    deliveryId: external_exports.string().min(1),
-    eventType: external_exports.string().min(1),
-    linkedProjectSlugs: external_exports.array(mrrlinProjectSlugSchema),
-    stored: external_exports.boolean()
-  })
-});
 var githubCreateBranchRequestSchema = external_exports.object({
   baseBranch: external_exports.string().min(1).default("main"),
   branchName: external_exports.string().min(1)
@@ -34551,9 +34597,6 @@ var githubLatestDeploymentQuerySchema = external_exports.object({
 var githubLatestDeploymentResponseSchema = external_exports.object({
   data: external_exports.object({ deploymentId: external_exports.number().int(), environmentUrl: external_exports.string() }).nullable()
 });
-var githubWebhookDeliveryListResponseSchema = external_exports.object({
-  data: external_exports.array(mrrlinGithubWebhookDeliverySchema)
-});
 var githubMintPushTokenRequestSchema = external_exports.object({
   runId: mrrlinExecutionRunIdSchema,
   leaseId: external_exports.string().min(1)
@@ -34766,13 +34809,24 @@ var agentCredentialSummarySchema = external_exports.object({
   createdAt: external_exports.string().datetime(),
   lastUsedAt: external_exports.string().datetime().nullable(),
   revokedAt: external_exports.string().datetime().nullable(),
-  expiresAt: external_exports.string().datetime().nullable()
+  expiresAt: external_exports.string().datetime().nullable(),
+  // ADR 0016: surface scope so UI can label rows; seedProjectSlug is audit-only ("issued from
+  // project X"). Both default to 'project'/null for back-compat with legacy rows.
+  scope: external_exports.enum(["project", "operator"]).default("project"),
+  seedProjectSlug: external_exports.string().nullable().default(null)
 });
 var agentCredentialListResponseSchema = external_exports.object({
   data: external_exports.array(agentCredentialSummarySchema)
 });
 var exchangeAgentTokenRequestSchema = external_exports.object({
-  secret: external_exports.string().min(1)
+  // ADR 0016 §3 no-oracle: the exchange schema MUST accept any string shape for `secret` and
+  // `projectSlug`. Empty/whitespace/missing inputs are handled by the handler's constant-work
+  // 5-step loop and flow into the same uniform 401 path as wrong-secret. A schema-level 400
+  // would leak (attacker can distinguish "malformed input" from "wrong secret" before the
+  // handler runs). Validation of structural content (e.g. selector parseability for `secret`)
+  // happens inside the handler against the dummy hash.
+  secret: external_exports.string(),
+  projectSlug: external_exports.string().optional()
 });
 var exchangeAgentTokenResponseSchema = external_exports.object({
   token: external_exports.string().min(1),
@@ -34987,10 +35041,10 @@ var AgentTokenProviderError = class extends Error {
     this.code = code;
   }
 };
-async function defaultExchange(secret, baseUrl) {
+async function defaultExchange(secret, baseUrl, projectSlug) {
   const url2 = `${baseUrl.replace(/\/$/, "")}/auth/agent/token`;
   const response = await fetch(url2, {
-    body: JSON.stringify({ secret }),
+    body: JSON.stringify({ secret, ...projectSlug ? { projectSlug } : {} }),
     headers: { "content-type": "application/json" },
     method: "POST"
   });
@@ -35015,22 +35069,28 @@ function createAgentTokenProvider(opts) {
   const { baseUrl, secret } = opts;
   const exchange = opts.exchange ?? defaultExchange;
   const now = opts.now ?? (() => Date.now());
-  let cached2 = null;
-  function isValid() {
-    if (!cached2)
+  const LEGACY_KEY = "__mrrlin_agent_no_slug__";
+  const cacheByKey = /* @__PURE__ */ new Map();
+  function cacheKey(projectSlug) {
+    return projectSlug ?? LEGACY_KEY;
+  }
+  function isValid(entry) {
+    if (!entry)
       return false;
-    const expiresAtMs = new Date(cached2.expiresAt).getTime();
+    const expiresAtMs = new Date(entry.expiresAt).getTime();
     return now() < expiresAtMs - REFRESH_BUFFER_MS;
   }
-  async function getSession() {
-    if (!isValid()) {
-      cached2 = await exchange(secret, baseUrl);
+  async function getSession(projectSlug) {
+    const key = cacheKey(projectSlug);
+    let entry = cacheByKey.get(key);
+    if (!isValid(entry)) {
+      entry = await exchange(secret, baseUrl, projectSlug);
+      cacheByKey.set(key, entry);
     }
-    const c = cached2;
-    return { token: c.token, projectSlug: c.projectSlug, login: c.login };
+    return { token: entry.token, projectSlug: entry.projectSlug, login: entry.login };
   }
-  async function getToken() {
-    return (await getSession()).token;
+  async function getToken(projectSlug) {
+    return (await getSession(projectSlug)).token;
   }
   return { getToken, getSession };
 }
@@ -35328,10 +35388,6 @@ function createMrrlinClient(config2) {
       const body = await request(`${projectPath(projectSlug)}/github/workflows`);
       return githubWorkflowListResponseSchema.parse(body).data;
     },
-    async listGithubWebhookDeliveries(projectSlug) {
-      const body = await request(`${projectPath(projectSlug)}/github/webhook-deliveries`);
-      return githubWebhookDeliveryListResponseSchema.parse(body).data;
-    },
     async listProjects() {
       const body = await request("/projects");
       return projectSummaryListResponseSchema.parse(body).data;
@@ -35763,6 +35819,24 @@ function createMrrlinClient(config2) {
         method: "POST"
       });
       return exchangeAgentTokenResponseSchema.parse(body);
+    },
+    // ── ADR 0016 — operator-scoped credential client methods ─────────────────
+    async issueOperatorAgentCredential(input) {
+      const body = await request("/operator/agent-credentials", {
+        body: JSON.stringify(input),
+        headers: { "content-type": "application/json" },
+        method: "POST"
+      });
+      return agentCredentialResponseSchema.parse(body.data);
+    },
+    async listOperatorAgentCredentials() {
+      const body = await request("/operator/agent-credentials");
+      return agentCredentialListResponseSchema.parse(body).data;
+    },
+    async revokeOperatorAgentCredential(credentialId) {
+      await request(`/operator/agent-credentials/${encodeURIComponent(credentialId)}`, {
+        method: "DELETE"
+      });
     }
   };
 }
@@ -36436,7 +36510,17 @@ async function driveRun(deps, projectSlug, runId) {
   }
   const leaseId = claimed.leaseId;
   const task = await deps.client.getTask(projectSlug, claimed.taskId);
-  const bundle = renderContextBundle(await gatherContext(deps.client, projectSlug, task, runId));
+  const compactEnabled = (process.env.MRRLIN_MCP_COMPACT_DISABLE ?? "").trim() !== "1";
+  const context = await gatherContext(deps.client, projectSlug, task, runId);
+  const bundle = renderContextBundle(
+    compactEnabled ? {
+      ...context,
+      compact: {
+        projectSlug,
+        specWikiPageId: task.specWikiPageId ?? null
+      }
+    } : context
+  );
   const checkout = deps.checkoutRegistry?.get(projectSlug) ?? null;
   let sandbox = "read-only";
   let turnCwd = deps.codexCwd ?? null;
@@ -41256,8 +41340,16 @@ var NOOP_LOGGER = {
   }
 };
 var REDACT_DEPTH_CAP = 8;
+var IMAGE_DATA_URI_RE = /^(data:image\/[a-zA-Z0-9.+-]+;base64,)([A-Za-z0-9+/=]+)$/;
+function redactImageDataUri(value) {
+  const m = value.match(IMAGE_DATA_URI_RE);
+  if (!m) return value;
+  const prefix = m[1];
+  const body = m[2];
+  return `${prefix}\u2026(${body.length} bytes)`;
+}
 function redactValue(value, depth) {
-  if (typeof value === "string") return redact(value);
+  if (typeof value === "string") return redact(redactImageDataUri(value));
   if (value === null || typeof value !== "object") return value;
   if (depth >= REDACT_DEPTH_CAP) {
     try {
@@ -41883,13 +41975,30 @@ function createBridgeMessageHandler(deps) {
         sendForSpan({ type: "error", error: "Invalid message schema." });
         return;
       }
+      const rawImage = msg.imageDataUri;
+      let imageDataUri = null;
+      if (rawImage !== void 0 && rawImage !== null) {
+        if (typeof rawImage !== "string") {
+          sendForSpan({ type: "error", error: "imageDataUri must be a string." });
+          return;
+        }
+        if (!rawImage.startsWith("data:image/")) {
+          sendForSpan({ type: "error", error: "imageDataUri must be a data URI for an image." });
+          return;
+        }
+        if (rawImage.length > 3 * 1024 * 1024) {
+          sendForSpan({ type: "error", error: "Image too large." });
+          return;
+        }
+        imageDataUri = rawImage;
+      }
       const directorSessionId = msg.directorSessionId.trim();
       if (!directorSessionId) {
         sendForSpan({ type: "error", error: "directorSessionId is required." });
         return;
       }
       const inputText = msg.message.trim();
-      if (!inputText) {
+      if (!inputText && !imageDataUri) {
         sendForSpan({ type: "error", directorSessionId, error: "message is required." });
         return;
       }
@@ -42035,11 +42144,19 @@ function createBridgeMessageHandler(deps) {
           socket.once("close", onSocketClose);
           pokeActivity = () => watchdog.poke();
           const runSequence = (async () => {
+            const turnInput = [];
+            if (inputText.length > 0) {
+              const composed = contextPrefix ? `${contextPrefix}
+
+${inputText}` : inputText;
+              turnInput.push({ type: "text", text: composed, text_elements: [] });
+            }
+            if (imageDataUri) {
+              turnInput.push({ type: "image", url: imageDataUri });
+            }
             await codexClient.turn.start({
               threadId: thread.threadId,
-              input: [{ type: "text", text: contextPrefix ? `${contextPrefix}
-
-${inputText}` : inputText }],
+              input: turnInput,
               ...thread.reasoningEffort ? { effort: thread.reasoningEffort } : {}
             });
             await turnFinished;
@@ -47218,8 +47335,7 @@ function remoteMatchesRepo(remoteUrl, repoFullName) {
   return a !== null && a === repoFullName.trim().toLowerCase();
 }
 
-// src/tools.ts
-registerAsyncTool(consensusDescriptor);
+// src/tool-names.ts
 var mcpToolNames = {
   appendExecutionArtifact: "append_execution_artifact",
   archivePlan: "archive_plan",
@@ -47255,7 +47371,6 @@ var mcpToolNames = {
   listExecutionArtifacts: "list_execution_artifacts",
   listExecutionRuns: "list_execution_runs",
   listInboxItems: "list_inbox_items",
-  listGithubWebhookDeliveries: "list_github_webhook_deliveries",
   listGithubInstallations: "list_github_installations",
   listGithubWorkflows: "list_github_workflows",
   listPlans: "list_plans",
@@ -47279,8 +47394,499 @@ var mcpToolNames = {
   uploadArtifact: "upload_artifact",
   listArtifactFiles: "list_artifact_files",
   resolveHandoff: "resolve_handoff",
-  registerLocalCheckout: "register_local_checkout"
+  registerLocalCheckout: "register_local_checkout",
+  /** Compact-context retrieval: rehydrate a mrrlin:// handle into the canonical full record. */
+  retrieveContext: "retrieve_context"
 };
+
+// src/context-compact/policy.ts
+var DEFAULT_THRESHOLD_CHARS = 12e3;
+var DEFAULT_MAX_ITEMS = 25;
+function readPositiveInt(value, fallback) {
+  const raw = (value ?? "").trim();
+  if (!raw) return fallback;
+  const parsed = Number.parseInt(raw, 10);
+  return Number.isInteger(parsed) && parsed > 0 ? parsed : fallback;
+}
+function readCompactPolicy(env = process.env) {
+  const disabled = (env.MRRLIN_MCP_COMPACT_DISABLE ?? "").trim() === "1";
+  return {
+    enabled: !disabled,
+    thresholdChars: readPositiveInt(env.MRRLIN_MCP_COMPACT_THRESHOLD_CHARS, DEFAULT_THRESHOLD_CHARS),
+    maxItems: readPositiveInt(env.MRRLIN_MCP_COMPACT_MAX_ITEMS, DEFAULT_MAX_ITEMS),
+    debug: (env.MRRLIN_MCP_COMPACT_DEBUG ?? "").trim() === "1"
+  };
+}
+
+// src/context-compact/handles.ts
+var MRRLIN_HANDLE_SCHEME = "mrrlin://";
+var SLUG_RE = /^[a-z0-9][a-z0-9-]*[a-z0-9]$|^[a-z0-9]$/;
+var TASK_ID_RE = /^GT-[A-Za-z0-9-]+$/;
+var WIKI_ID_RE = /^WK-[A-Za-z0-9-]+$/;
+var RUN_ID_RE = /^ER-[A-Za-z0-9-]+$/;
+function isProjectSlug(value) {
+  return SLUG_RE.test(value);
+}
+function formatTaskHandle(projectSlug, taskId) {
+  return `${MRRLIN_HANDLE_SCHEME}task/${projectSlug}/${taskId}`;
+}
+function formatTaskEventsHandle(projectSlug, taskId) {
+  return `${MRRLIN_HANDLE_SCHEME}task/${projectSlug}/${taskId}/events`;
+}
+function formatWikiHandle(projectSlug, pageId) {
+  return `${MRRLIN_HANDLE_SCHEME}wiki/${projectSlug}/${pageId}`;
+}
+function formatProjectSnapshotHandle(projectSlug) {
+  return `${MRRLIN_HANDLE_SCHEME}project/${projectSlug}/snapshot`;
+}
+function formatRunArtifactsHandle(projectSlug, runId) {
+  return `${MRRLIN_HANDLE_SCHEME}run/${projectSlug}/${runId}/artifacts`;
+}
+function parseMrrlinHandle(value) {
+  if (typeof value !== "string") return null;
+  if (!value.startsWith(MRRLIN_HANDLE_SCHEME)) return null;
+  const rest = value.slice(MRRLIN_HANDLE_SCHEME.length);
+  if (!rest) return null;
+  if (rest.includes("?") || rest.includes("#")) return null;
+  const parts = rest.split("/");
+  if (parts.length < 2) return null;
+  const [kind, slug, ...tail2] = parts;
+  if (!kind || !slug) return null;
+  if (!isProjectSlug(slug)) return null;
+  switch (kind) {
+    case "task": {
+      if (tail2.length < 1 || tail2.length > 2) return null;
+      const taskId = tail2[0] ?? "";
+      if (!TASK_ID_RE.test(taskId)) return null;
+      if (tail2.length === 1) return { kind: "task", projectSlug: slug, taskId };
+      if (tail2[1] !== "events") return null;
+      return { kind: "task-events", projectSlug: slug, taskId };
+    }
+    case "wiki": {
+      if (tail2.length !== 1) return null;
+      const pageId = tail2[0] ?? "";
+      if (!WIKI_ID_RE.test(pageId)) return null;
+      return { kind: "wiki", projectSlug: slug, pageId };
+    }
+    case "project": {
+      if (tail2.length !== 1) return null;
+      const sub = tail2[0];
+      if (sub === "snapshot") return { kind: "project-snapshot", projectSlug: slug };
+      if (sub === "tasks") return { kind: "project-tasks", projectSlug: slug };
+      return null;
+    }
+    case "run": {
+      if (tail2.length < 1 || tail2.length > 2) return null;
+      const runId = tail2[0] ?? "";
+      if (!RUN_ID_RE.test(runId)) return null;
+      if (tail2.length === 1) return { kind: "run", projectSlug: slug, runId };
+      if (tail2[1] !== "artifacts") return null;
+      return { kind: "run-artifacts", projectSlug: slug, runId };
+    }
+    default:
+      return null;
+  }
+}
+
+// src/context-compact/compactors.ts
+var NOTES_EXCERPT_CHARS = 200;
+var TITLE_TRUNCATE_CHARS = 160;
+var EXCERPT_TRUNCATE_CHARS = 240;
+function truncate(value, maxChars) {
+  if (value.length <= maxChars) return value;
+  return `${value.slice(0, Math.max(0, maxChars - 1))}\u2026`;
+}
+function firstHeadingLine(markdown) {
+  for (const line of markdown.split(/\r?\n/, 32)) {
+    if (line.startsWith("#")) return line.replace(/\s+$/u, "");
+  }
+  return null;
+}
+function compactTaskList(projectSlug, tasks, maxItems) {
+  const total = tasks.length;
+  const included = Math.min(total, maxItems);
+  const slice = tasks.slice(0, included);
+  const items = slice.map((t) => ({
+    id: t.id,
+    title: truncate(t.title, TITLE_TRUNCATE_CHARS),
+    status: t.status,
+    type: t.type,
+    category: t.category,
+    subcategory: t.subcategory,
+    impact: t.impact,
+    autonomy: t.autonomyLevel,
+    tags: t.tags,
+    assignee: t.assignee,
+    planId: t.planId,
+    specWikiPageId: t.specWikiPageId,
+    notesExcerpt: t.notes ? truncate(t.notes, NOTES_EXCERPT_CHARS) : null,
+    latestJudgementExcerpt: t.latestJudgement ? truncate(t.latestJudgement, NOTES_EXCERPT_CHARS) : null,
+    handle: formatTaskHandle(projectSlug, t.id)
+  }));
+  const handles = slice.map((t) => ({
+    handle: formatTaskHandle(projectSlug, t.id),
+    retrieveTool: mcpToolNames.getTask,
+    retrieveArgs: { projectSlug, taskId: t.id }
+  }));
+  return {
+    summary: `${total} task${total === 1 ? "" : "s"} in project ${projectSlug}; ${included} included in this compact view.`,
+    items,
+    handles,
+    counts: { total, included, omitted: total - included }
+  };
+}
+function compactWikiPageList(projectSlug, pages, maxItems) {
+  const total = pages.length;
+  const included = Math.min(total, maxItems);
+  const slice = pages.slice(0, included);
+  const items = slice.map((p) => ({
+    id: p.id,
+    title: truncate(p.title, TITLE_TRUNCATE_CHARS),
+    folder: p.folder,
+    path: p.path,
+    taskId: p.taskId,
+    specReady: p.specReady,
+    firstHeading: firstHeadingLine(p.markdownBody),
+    handle: formatWikiHandle(projectSlug, p.id)
+  }));
+  const handles = slice.map((p) => ({
+    handle: formatWikiHandle(projectSlug, p.id),
+    retrieveTool: mcpToolNames.getWikiPage,
+    retrieveArgs: { projectSlug, pageId: p.id }
+  }));
+  return {
+    summary: `${total} wiki page${total === 1 ? "" : "s"} in project ${projectSlug}; ${included} included in this compact view.`,
+    items,
+    handles,
+    counts: { total, included, omitted: total - included }
+  };
+}
+function compactWikiSearch(projectSlug, results, maxItems) {
+  const total = results.length;
+  const included = Math.min(total, maxItems);
+  const slice = results.slice(0, included);
+  const items = slice.map((r) => ({
+    pageId: r.id,
+    title: truncate(r.title, TITLE_TRUNCATE_CHARS),
+    folder: r.folder,
+    path: r.path,
+    rank: r.rank,
+    snippet: truncate(r.snippet, EXCERPT_TRUNCATE_CHARS),
+    handle: formatWikiHandle(projectSlug, r.id)
+  }));
+  const handles = slice.map((r) => ({
+    handle: formatWikiHandle(projectSlug, r.id),
+    retrieveTool: mcpToolNames.getWikiPage,
+    retrieveArgs: { projectSlug, pageId: r.id }
+  }));
+  return {
+    summary: `${total} wiki search hit${total === 1 ? "" : "s"} in project ${projectSlug}; ${included} included.`,
+    items,
+    handles,
+    counts: { total, included, omitted: total - included }
+  };
+}
+function compactProjectSnapshot(projectSlug, snapshot, maxItems) {
+  const taskBody = compactTaskList(projectSlug, snapshot.tasks, maxItems);
+  const wikiBody = compactWikiPageList(projectSlug, snapshot.wikiPages, maxItems);
+  const statusCounts = {};
+  for (const t of snapshot.tasks) {
+    statusCounts[t.status] = (statusCounts[t.status] ?? 0) + 1;
+  }
+  const categoryCounts = {};
+  for (const t of snapshot.tasks) {
+    const key = `${t.category}/${t.subcategory}`;
+    categoryCounts[key] = (categoryCounts[key] ?? 0) + 1;
+  }
+  const compactPlans = snapshot.plans.map((p) => ({
+    id: p.id,
+    name: truncate(p.name, TITLE_TRUNCATE_CHARS),
+    status: p.status,
+    taskCount: p.taskCount,
+    closedTaskCount: p.closedTaskCount,
+    progress: p.progress,
+    dueDate: p.dueDate
+  }));
+  const items = [
+    {
+      project: snapshot.project,
+      github: {
+        installationState: snapshot.github.appInstallationState,
+        installationId: snapshot.github.installationId,
+        operator: snapshot.github.operator
+      },
+      taskCount: snapshot.tasks.length,
+      wikiCount: snapshot.wikiPages.length,
+      planCount: snapshot.plans.length,
+      statusCounts,
+      categoryCounts,
+      plans: compactPlans,
+      tasks: taskBody.items,
+      wikiPages: wikiBody.items
+    }
+  ];
+  const handles = [
+    {
+      handle: formatProjectSnapshotHandle(projectSlug),
+      retrieveTool: mcpToolNames.getProjectSnapshot,
+      retrieveArgs: { projectSlug }
+    },
+    ...taskBody.handles,
+    ...wikiBody.handles
+  ];
+  const total = snapshot.tasks.length + snapshot.wikiPages.length;
+  const included = taskBody.counts.included + wikiBody.counts.included;
+  return {
+    summary: `Snapshot for ${projectSlug}: ${snapshot.tasks.length} tasks, ${snapshot.wikiPages.length} wiki pages, ${snapshot.plans.length} plans.`,
+    items,
+    handles,
+    counts: { total, included, omitted: total - included }
+  };
+}
+var ARTIFACT_PAYLOAD_BUDGET = 400;
+var COMMAND_OUTPUT_TAIL_LINES = 10;
+function compactArtifactPayload(artifact) {
+  const payload = artifact.payload ?? {};
+  switch (artifact.kind) {
+    case "file": {
+      return {
+        filename: payload.filename ?? null,
+        contentType: payload.contentType ?? null,
+        sizeBytes: payload.sizeBytes ?? null,
+        class: payload.class ?? null,
+        stableUrl: payload.stableUrl ?? null,
+        description: payload.description ?? null
+      };
+    }
+    case "command_output": {
+      const event = payload.event ?? void 0;
+      const command = payload.command ?? event?.tool?.input?.command ?? null;
+      const cwd = payload.cwd ?? event?.tool?.input?.cwd ?? null;
+      const exitCode = payload.exitCode ?? null;
+      const rawOutput = payload.stdout ?? payload.output ?? event?.content ?? "";
+      const lines2 = rawOutput.split(/\r?\n/);
+      const tail2 = lines2.slice(-COMMAND_OUTPUT_TAIL_LINES).join("\n");
+      const firstError = lines2.find((l) => /error|fail/i.test(l)) ?? null;
+      return {
+        command,
+        cwd,
+        exitCode,
+        firstError,
+        tail: truncate(tail2, ARTIFACT_PAYLOAD_BUDGET),
+        totalLines: lines2.length
+      };
+    }
+    case "test_result": {
+      return {
+        status: payload.status ?? null,
+        command: payload.command ?? null,
+        summary: typeof payload.summary === "string" ? truncate(payload.summary, ARTIFACT_PAYLOAD_BUDGET) : null,
+        failed: Array.isArray(payload.failedTests) ? payload.failedTests.slice(0, 25) : null
+      };
+    }
+    case "diff_summary": {
+      return {
+        files: Array.isArray(payload.files) ? payload.files.slice(0, 50) : null,
+        added: payload.added ?? null,
+        removed: payload.removed ?? null,
+        renamed: payload.renamed ?? null
+      };
+    }
+    case "handoff_judgement":
+    case "self_review":
+    case "error":
+    case "checkpoint":
+    default: {
+      const flattened = JSON.stringify(payload);
+      return { excerpt: truncate(flattened, ARTIFACT_PAYLOAD_BUDGET) };
+    }
+  }
+}
+function compactExecutionArtifacts(projectSlug, artifacts, maxItems) {
+  const total = artifacts.length;
+  const included = Math.min(total, maxItems);
+  const slice = total > included ? artifacts.slice(total - included) : artifacts;
+  const items = slice.map((a) => ({
+    id: a.id,
+    runId: a.runId,
+    kind: a.kind,
+    createdAt: a.createdAt,
+    payload: compactArtifactPayload(a)
+  }));
+  const runIds = Array.from(new Set(slice.map((a) => a.runId)));
+  const handles = runIds.map((runId) => ({
+    handle: formatRunArtifactsHandle(projectSlug, runId),
+    retrieveTool: mcpToolNames.listExecutionArtifacts,
+    retrieveArgs: { projectSlug, runId }
+  }));
+  return {
+    summary: `${total} execution artifact${total === 1 ? "" : "s"}; ${included} included (most recent first dropped older).`,
+    items,
+    handles,
+    counts: { total, included, omitted: total - included }
+  };
+}
+function compactTaskEvents(projectSlug, taskId, events, maxItems) {
+  const total = events.length;
+  const included = Math.min(total, maxItems);
+  const slice = total > included ? events.slice(total - included) : events;
+  const items = slice.map((e) => ({
+    id: e.id,
+    eventType: e.eventType,
+    actor: e.actor,
+    createdAt: e.createdAt,
+    autonomyLevel: e.autonomyLevel,
+    autonomyReason: e.autonomyReason,
+    bodyExcerpt: e.body ? truncate(e.body, NOTES_EXCERPT_CHARS) : null
+  }));
+  const handles = [
+    {
+      handle: formatTaskEventsHandle(projectSlug, taskId),
+      retrieveTool: mcpToolNames.listTaskEvents,
+      retrieveArgs: { projectSlug, taskId }
+    }
+  ];
+  return {
+    summary: `${total} task event${total === 1 ? "" : "s"} for ${taskId}; ${included} most recent included.`,
+    items,
+    handles,
+    counts: { total, included, omitted: total - included }
+  };
+}
+function compactGeneric(value, maxItems, projectSlug) {
+  if (Array.isArray(value)) {
+    const total = value.length;
+    const included = Math.min(total, maxItems);
+    const slice = value.slice(0, included).map((entry) => {
+      const text2 = typeof entry === "string" ? entry : JSON.stringify(entry);
+      return truncate(text2, ARTIFACT_PAYLOAD_BUDGET);
+    });
+    return {
+      summary: `Compact array view: ${total} entries, ${included} included.`,
+      items: slice,
+      handles: [],
+      counts: { total, included, omitted: total - included }
+    };
+  }
+  if (value && typeof value === "object") {
+    const obj = value;
+    const keys = Object.keys(obj);
+    return {
+      summary: `Compact object view (project=${projectSlug}): keys=[${keys.join(", ")}].`,
+      items: [
+        Object.fromEntries(
+          keys.map((k) => {
+            const entry = obj[k];
+            if (Array.isArray(entry)) return [k, `[Array(${entry.length})]`];
+            if (entry && typeof entry === "object") return [k, "[Object]"];
+            return [k, entry];
+          })
+        )
+      ],
+      handles: [],
+      counts: { total: 1, included: 1, omitted: 0 }
+    };
+  }
+  const text = typeof value === "string" ? value : JSON.stringify(value);
+  return {
+    summary: "Compact scalar view.",
+    items: [truncate(text, ARTIFACT_PAYLOAD_BUDGET)],
+    handles: [],
+    counts: { total: 1, included: 1, omitted: 0 }
+  };
+}
+
+// src/context-compact/index.ts
+var COMPACT_WARNING = "Compact result. Source of truth lives in the Mrrlin API; call `retrieve_context` with one of the embedded mrrlin:// handles to load the full record before any irreversible decision.";
+function serializedChars(value) {
+  return JSON.stringify({ data: value }, null, 2).length;
+}
+function buildEnvelope(dispatch, body, originalChars) {
+  const partial2 = {
+    compact: true,
+    kind: dispatch.kind,
+    toolName: dispatch.toolName,
+    projectSlug: dispatch.projectSlug,
+    summary: body.summary,
+    counts: body.counts,
+    items: body.items,
+    handles: body.handles,
+    warning: COMPACT_WARNING
+  };
+  const compactNoStats = JSON.stringify({ data: partial2 }, null, 2).length;
+  const statsOverhead = 220;
+  const compactChars = compactNoStats + statsOverhead;
+  const savedChars = originalChars - compactChars;
+  const savedRatio = originalChars > 0 ? Math.max(0, savedChars / originalChars) : 0;
+  const envelope = {
+    ...partial2,
+    stats: {
+      originalChars,
+      compactChars,
+      savedChars,
+      savedRatio: Number(savedRatio.toFixed(4))
+    }
+  };
+  return { envelope, shrunk: compactChars < originalChars };
+}
+function runCompactor(dispatch, policy) {
+  switch (dispatch.kind) {
+    case "task-list":
+      return compactTaskList(dispatch.projectSlug, dispatch.rawValue, policy.maxItems);
+    case "wiki-list":
+      return compactWikiPageList(dispatch.projectSlug, dispatch.rawValue, policy.maxItems);
+    case "wiki-search":
+      return compactWikiSearch(
+        dispatch.projectSlug,
+        dispatch.rawValue,
+        policy.maxItems
+      );
+    case "project-snapshot":
+      return compactProjectSnapshot(
+        dispatch.projectSlug,
+        dispatch.rawValue,
+        policy.maxItems
+      );
+    case "execution-artifacts":
+      return compactExecutionArtifacts(
+        dispatch.projectSlug,
+        dispatch.rawValue,
+        policy.maxItems
+      );
+    case "task-events": {
+      if (!dispatch.taskId) throw new Error("task-events compact requires taskId");
+      return compactTaskEvents(dispatch.projectSlug, dispatch.taskId, dispatch.rawValue, policy.maxItems);
+    }
+    case "generic-json":
+      return compactGeneric(dispatch.rawValue, policy.maxItems, dispatch.projectSlug);
+  }
+}
+function maybeCompact(dispatch, policy = readCompactPolicy()) {
+  if (!policy.enabled) return null;
+  const originalChars = serializedChars(dispatch.rawValue);
+  if (originalChars <= policy.thresholdChars) return null;
+  const body = runCompactor(dispatch, policy);
+  const result = buildEnvelope(dispatch, body, originalChars);
+  if (policy.debug) {
+    process.stderr.write(
+      `[mrrlin-mcp compact] tool=${dispatch.toolName} kind=${dispatch.kind} originalChars=${originalChars} compactChars=${result.envelope.stats.compactChars} savedRatio=${result.envelope.stats.savedRatio}
+`
+    );
+  }
+  if (!result.shrunk) return null;
+  return result.envelope;
+}
+var COMPACT_OPT_IN = {
+  [mcpToolNames.listTasks]: "task-list",
+  [mcpToolNames.listWikiPages]: "wiki-list",
+  [mcpToolNames.searchWikiPages]: "wiki-search",
+  [mcpToolNames.getProjectSnapshot]: "project-snapshot",
+  [mcpToolNames.listExecutionArtifacts]: "execution-artifacts",
+  [mcpToolNames.listTaskEvents]: "task-events"
+};
+
+// src/tools.ts
+registerAsyncTool(consensusDescriptor);
 var projectScopedSchema = external_exports.object({ projectSlug: mrrlinProjectSlugSchema });
 var taskScopedSchema = projectScopedSchema.extend({ taskId: mrrlinTaskIdSchema });
 var planScopedSchema = projectScopedSchema.extend({ planId: mrrlinPlanIdSchema });
@@ -47332,7 +47938,6 @@ var runCodeReviewerGateInputSchema = external_exports.object({
 var searchKnowledgeInputSchema = wikiKnowledgeSearchInputSchema;
 var createGithubBranchInputSchema = projectScopedSchema.merge(githubCreateBranchRequestSchema);
 var createGithubPullRequestInputSchema = projectScopedSchema.merge(githubCreatePullRequestRequestSchema);
-var listGithubWebhookDeliveriesInputSchema = projectScopedSchema;
 var listGithubWorkflowsInputSchema = projectScopedSchema;
 var dispatchGithubWorkflowInputSchema = projectScopedSchema.extend({ workflowId: external_exports.string().min(1) }).merge(githubWorkflowDispatchRequestSchema);
 var dispatchTaskDeployInputSchema = taskScopedSchema.extend({
@@ -47381,6 +47986,14 @@ var registerLocalCheckoutInputSchema = projectScopedSchema.extend({
   path: external_exports.string().min(1).describe("Absolute path to the local git checkout (must be a git repo whose origin matches `repo`)."),
   repo: external_exports.string().min(1).describe("The project's bound GitHub repo full name in `owner/repo` form.")
 });
+var retrieveContextInputSchema = external_exports.object({
+  handle: external_exports.string().min(1).describe(
+    "A mrrlin:// handle emitted in a compact envelope. Examples: mrrlin://task/{slug}/GT-123, mrrlin://wiki/{slug}/WK-1, mrrlin://project/{slug}/snapshot, mrrlin://run/{slug}/ER-9, mrrlin://run/{slug}/ER-9/artifacts."
+  ),
+  mode: external_exports.enum(["full", "summary", "metadata"]).optional().describe(
+    "Reserved. v1 always returns the full record regardless; future versions will use this to scope rehydration."
+  )
+});
 var mcpToolInputSchemas = {
   [mcpToolNames.appendExecutionArtifact]: appendExecutionArtifactInputSchema,
   [mcpToolNames.archivePlan]: archivePlanInputSchema,
@@ -47413,7 +48026,6 @@ var mcpToolInputSchemas = {
   [mcpToolNames.getGithubInstallationRepositories]: getGithubInstallationRepositoriesInputSchema,
   [mcpToolNames.listExecutionArtifacts]: listExecutionArtifactsInputSchema,
   [mcpToolNames.listExecutionRuns]: listExecutionRunsInputSchema,
-  [mcpToolNames.listGithubWebhookDeliveries]: listGithubWebhookDeliveriesInputSchema,
   [mcpToolNames.listGithubInstallations]: listGithubInstallationsInputSchema,
   [mcpToolNames.listGithubWorkflows]: listGithubWorkflowsInputSchema,
   [mcpToolNames.listPlans]: listPlansInputSchema,
@@ -47440,7 +48052,8 @@ var mcpToolInputSchemas = {
   [mcpToolNames.uploadArtifact]: uploadArtifactInputSchema,
   [mcpToolNames.listArtifactFiles]: listArtifactFilesInputSchema,
   [mcpToolNames.resolveHandoff]: resolveHandoffInputSchema,
-  [mcpToolNames.registerLocalCheckout]: registerLocalCheckoutInputSchema
+  [mcpToolNames.registerLocalCheckout]: registerLocalCheckoutInputSchema,
+  [mcpToolNames.retrieveContext]: retrieveContextInputSchema
 };
 var mcpToolOperationIds = {
   [mcpToolNames.appendExecutionArtifact]: openApiOperationIds.appendExecutionArtifact,
@@ -47474,7 +48087,6 @@ var mcpToolOperationIds = {
   [mcpToolNames.getGithubInstallationRepositories]: openApiOperationIds.getGithubInstallationRepositories,
   [mcpToolNames.listExecutionArtifacts]: openApiOperationIds.listExecutionArtifacts,
   [mcpToolNames.listExecutionRuns]: openApiOperationIds.listExecutionRuns,
-  [mcpToolNames.listGithubWebhookDeliveries]: openApiOperationIds.listGithubWebhookDeliveries,
   [mcpToolNames.listGithubInstallations]: openApiOperationIds.listGithubInstallations,
   [mcpToolNames.listGithubWorkflows]: openApiOperationIds.listGithubWorkflows,
   [mcpToolNames.listPlans]: openApiOperationIds.listPlans,
@@ -47524,7 +48136,6 @@ var mcpToolDescriptions = {
   [mcpToolNames.dispatchGithubWorkflow]: "Dispatch a GitHub Actions workflow by workflow file/id against a ref visible to the linked installation.",
   [mcpToolNames.dispatchTaskDeploy]: "Dispatch a task's dev or prod deploy; caller supplies workflowId chosen for this run (ADR 0012). Subject to auto_deploy policy and prod dev-verification gate.",
   [mcpToolNames.getGithubInstallationRepositories]: "List repositories visible to a GitHub App installation id.",
-  [mcpToolNames.listGithubWebhookDeliveries]: "List recent persisted GitHub webhook deliveries for the project so install/webhook smoke can be verified without raw DB access.",
   [mcpToolNames.listGithubInstallations]: "List persisted GitHub App installations.",
   [mcpToolNames.listGithubWorkflows]: "List the bound repository's GitHub Actions workflows live through the linked installation. No Mrrlin-side cache.",
   [mcpToolNames.listProjects]: "List every project visible to the operator.",
@@ -47559,7 +48170,8 @@ var mcpToolDescriptions = {
   [mcpToolNames.uploadArtifact]: "Upload a local file (md/txt/html/csv/json/pdf/png/jpg/webp/gif, <=5MB) as a project artifact. Returns a stable markdown link to embed in chat/spec/handoff text. Use class=temp for one-off hand-offs, class=durable for anything referenced by specs or evidence. Pass runId to record the file in that run's artifact history; pass taskId to surface it on the task's Artifacts list.",
   [mcpToolNames.listArtifactFiles]: "List uploaded artifact files for the project (optionally filtered by taskId/runId), newest first.",
   [mcpToolNames.resolveHandoff]: "Resolve a tool_assisted handoff for an execution run (outcome success|failure). Success returns the task to the board; failure opens a new handoff cycle. Idempotent.",
-  [mcpToolNames.registerLocalCheckout]: "Register the operator-local git checkout path for `projectSlug` so execution-run workers run code on this machine instead of the cloud. Validates the path is a git repo whose `origin` remote matches `repo`, then writes the (slug -> absolute path) entry to the operator-local checkout registry. Call this after locating the checkout on disk (e.g. via filesystem search) and confirming the choice with the user in chat \u2014 they should NOT have to paste the path into Settings. Returns `{ projectSlug, path, confirmedAt }`. Idempotent: re-registering overwrites the prior entry."
+  [mcpToolNames.registerLocalCheckout]: "Register the operator-local git checkout path for `projectSlug` so execution-run workers run code on this machine instead of the cloud. Validates the path is a git repo whose `origin` remote matches `repo`, then writes the (slug -> absolute path) entry to the operator-local checkout registry. Call this after locating the checkout on disk (e.g. via filesystem search) and confirming the choice with the user in chat \u2014 they should NOT have to paste the path into Settings. Returns `{ projectSlug, path, confirmedAt }`. Idempotent: re-registering overwrites the prior entry.",
+  [mcpToolNames.retrieveContext]: "Rehydrate a mrrlin:// handle emitted by the compact-context layer into the full canonical Mrrlin record (task/wiki page/project snapshot/execution run/artifacts). Use whenever you need the full source \u2014 irreversible decisions (closing tasks, dispatching deploys, writing specs) MUST call this first; never act on a compact envelope alone. Returns `{ kind, data }`. Invalid or unsupported handle \u2192 structured `HANDLE_INVALID` error."
 };
 var ARTIFACT_EXTENSION_TYPES = {
   ".md": "text/markdown",
@@ -47663,6 +48275,41 @@ function makeTool(client, name, fallbackCode, fallbackMessage, handler) {
     }
   };
 }
+function structuredOkCompactEnvelope(envelope) {
+  return {
+    content: [{ text: JSON.stringify({ data: envelope }, null, 2), type: "text" }],
+    isError: false,
+    structuredContent: { data: envelope }
+  };
+}
+function structuredOkMaybeCompact(name, projectSlug, value, context = {}) {
+  const kind = COMPACT_OPT_IN[name];
+  if (!kind) return structuredOk(value);
+  const envelope = maybeCompact(
+    { toolName: name, projectSlug, kind, rawValue: value, taskId: context.taskId },
+    readCompactPolicy()
+  );
+  if (!envelope) return structuredOk(value);
+  return structuredOkCompactEnvelope(envelope);
+}
+function makeReadTool(client, name, fallbackCode, fallbackMessage, handler, projectSlugFrom, taskIdFrom) {
+  return {
+    description: mcpToolDescriptions[name],
+    inputSchema: mcpToolInputSchemas[name],
+    name,
+    openApiOperationId: mcpToolOperationIds[name],
+    async invoke(input) {
+      try {
+        const value = await handler(client, input);
+        return structuredOkMaybeCompact(name, projectSlugFrom(input), value, {
+          taskId: taskIdFrom ? taskIdFrom(input) : void 0
+        });
+      } catch (error51) {
+        return structuredErr(classifyClientError(fallbackCode, fallbackMessage, error51));
+      }
+    }
+  };
+}
 function createMrrlinTools(options) {
   const client = createMrrlinClient(withAuth(options));
   return {
@@ -47799,12 +48446,13 @@ function createMrrlinTools(options) {
       "Unable to read project.",
       async (c, { projectSlug }) => await c.getProject(projectSlug)
     ),
-    [mcpToolNames.getProjectSnapshot]: makeTool(
+    [mcpToolNames.getProjectSnapshot]: makeReadTool(
       client,
       mcpToolNames.getProjectSnapshot,
       "PROJECT_SNAPSHOT_READ_FAILED",
       "Unable to read project snapshot.",
-      async (c, { projectSlug }) => await c.getProjectSnapshot(projectSlug)
+      async (c, { projectSlug }) => await c.getProjectSnapshot(projectSlug),
+      ({ projectSlug }) => projectSlug
     ),
     [mcpToolNames.getTask]: makeTool(
       client,
@@ -47834,13 +48482,6 @@ function createMrrlinTools(options) {
       "Unable to dispatch the task deploy workflow.",
       async (c, { projectSlug, taskId, workflowId, ...rest }) => await c.dispatchTaskDeploy(projectSlug, taskId, { ...rest, workflowId })
     ),
-    [mcpToolNames.listGithubWebhookDeliveries]: makeTool(
-      client,
-      mcpToolNames.listGithubWebhookDeliveries,
-      "GITHUB_WEBHOOK_DELIVERY_LIST_FAILED",
-      "Unable to list GitHub webhook deliveries.",
-      async (c, { projectSlug }) => await c.listGithubWebhookDeliveries(projectSlug)
-    ),
     [mcpToolNames.listGithubWorkflows]: makeTool(
       client,
       mcpToolNames.listGithubWorkflows,
@@ -47869,19 +48510,22 @@ function createMrrlinTools(options) {
       "Unable to list task dependencies.",
       async (c, { projectSlug }) => await c.listTaskDependencies(projectSlug)
     ),
-    [mcpToolNames.listTaskEvents]: makeTool(
+    [mcpToolNames.listTaskEvents]: makeReadTool(
       client,
       mcpToolNames.listTaskEvents,
       "TASK_EVENT_LIST_FAILED",
       "Unable to list task events.",
-      async (c, { projectSlug, taskId }) => await c.listTaskEvents(projectSlug, taskId)
+      async (c, { projectSlug, taskId }) => await c.listTaskEvents(projectSlug, taskId),
+      ({ projectSlug }) => projectSlug,
+      ({ taskId }) => taskId
     ),
-    [mcpToolNames.listTasks]: makeTool(
+    [mcpToolNames.listTasks]: makeReadTool(
       client,
       mcpToolNames.listTasks,
       "TASK_LIST_FAILED",
       "Unable to list tasks.",
-      async (c, { projectSlug, ...filters }) => await c.listTasks(projectSlug, filters)
+      async (c, { projectSlug, ...filters }) => await c.listTasks(projectSlug, filters),
+      ({ projectSlug }) => projectSlug
     ),
     [mcpToolNames.listTaxonomy]: makeTool(
       client,
@@ -47890,19 +48534,21 @@ function createMrrlinTools(options) {
       "Unable to list taxonomy.",
       async (c, { projectSlug }) => await c.listTaxonomy(projectSlug)
     ),
-    [mcpToolNames.listWikiPages]: makeTool(
+    [mcpToolNames.listWikiPages]: makeReadTool(
       client,
       mcpToolNames.listWikiPages,
       "WIKI_PAGE_LIST_FAILED",
       "Unable to list wiki pages.",
-      async (c, { projectSlug, ...filters }) => await c.listWikiPages(projectSlug, filters)
+      async (c, { projectSlug, ...filters }) => await c.listWikiPages(projectSlug, filters),
+      ({ projectSlug }) => projectSlug
     ),
-    [mcpToolNames.searchWikiPages]: makeTool(
+    [mcpToolNames.searchWikiPages]: makeReadTool(
       client,
       mcpToolNames.searchWikiPages,
       "WIKI_PAGE_SEARCH_FAILED",
       "Unable to search wiki pages.",
-      async (c, { projectSlug, ...query }) => await c.searchWikiPages(projectSlug, query)
+      async (c, { projectSlug, ...query }) => await c.searchWikiPages(projectSlug, query),
+      ({ projectSlug }) => projectSlug
     ),
     [mcpToolNames.searchKnowledge]: makeTool(
       client,
@@ -48049,12 +48695,13 @@ function createMrrlinTools(options) {
       "Unable to update execution run.",
       async (c, { projectSlug, runId, ...patch }) => await c.updateExecutionRun(projectSlug, runId, patch)
     ),
-    [mcpToolNames.listExecutionArtifacts]: makeTool(
+    [mcpToolNames.listExecutionArtifacts]: makeReadTool(
       client,
       mcpToolNames.listExecutionArtifacts,
       "EXECUTION_ARTIFACTS_LIST_FAILED",
       "Unable to list execution artifacts.",
-      async (c, { projectSlug, runId }) => await c.listExecutionArtifacts(projectSlug, runId)
+      async (c, { projectSlug, runId }) => await c.listExecutionArtifacts(projectSlug, runId),
+      ({ projectSlug }) => projectSlug
     ),
     [mcpToolNames.appendExecutionArtifact]: makeTool(
       client,
@@ -48273,9 +48920,49 @@ function createMrrlinTools(options) {
         registry3.confirm(projectSlug, resolvedPath, confirmedAt);
         return { projectSlug, path: resolvedPath, confirmedAt };
       }
+    ),
+    [mcpToolNames.retrieveContext]: makeTool(
+      client,
+      mcpToolNames.retrieveContext,
+      "HANDLE_INVALID",
+      "Unable to retrieve handle.",
+      async (c, { handle }) => {
+        const parsed = parseMrrlinHandle(handle);
+        if (!parsed) {
+          throw new McpToolCodedError(
+            "HANDLE_INVALID",
+            `Unrecognized mrrlin:// handle: ${handle}. Valid kinds: task | wiki | project/{slug}/snapshot | project/{slug}/tasks | run/{slug}/{runId} | run/{slug}/{runId}/artifacts.`
+          );
+        }
+        return await dispatchHandle(c, parsed);
+      }
     )
   };
 }
+async function dispatchHandle(client, handle) {
+  switch (handle.kind) {
+    case "task":
+      return { kind: handle.kind, data: await client.getTask(handle.projectSlug, handle.taskId) };
+    case "task-events":
+      return {
+        kind: handle.kind,
+        data: await client.listTaskEvents(handle.projectSlug, handle.taskId)
+      };
+    case "wiki":
+      return { kind: handle.kind, data: await client.getWikiPage(handle.projectSlug, handle.pageId) };
+    case "project-snapshot":
+      return { kind: handle.kind, data: await client.getProjectSnapshot(handle.projectSlug) };
+    case "project-tasks":
+      return { kind: handle.kind, data: await client.listTasks(handle.projectSlug, {}) };
+    case "run":
+      return { kind: handle.kind, data: await client.getExecutionRun(handle.projectSlug, handle.runId) };
+    case "run-artifacts":
+      return {
+        kind: handle.kind,
+        data: await client.listExecutionArtifacts(handle.projectSlug, handle.runId)
+      };
+  }
+}
 
 // src/server.ts
 function redactUrlForLog(value) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mrrlin-dev/mcp",
-  "version": "0.2.6",
+  "version": "0.3.0",
   "type": "module",
   "bin": {
     "mrrlin-mcp": "dist/bin.cjs"
@@ -20,8 +20,8 @@
     "@types/ws": "^8.18.1",
     "esbuild": "^0.24.0",
     "tsx": "^4.22.3",
-    "@mrrlin/client": "0.0.0",
     "@mrrlin/director-e2e": "0.0.0",
+    "@mrrlin/client": "0.0.0",
     "@mrrlin/wiki": "0.0.0",
     "@mrrlin/codex-client": "0.0.0",
     "@mrrlin/schemas": "0.0.0",