@wenathlan/extension 1.1.53 → 1.1.54

package/extension/dist/background.js

@@ -2383,6 +2383,61 @@ var sessionmemory = class {
   async removeworkflowversion(id, version) {
     await this.adapter.set("workflowrecords", (await this.getworkflowrecordversions()).filter((entry) => !(entry.id === id && entry.version === version)));
   }
+  /** Returns every stored mcp client record, newest first. */
+  async getclients() {
+    return await this.adapter.get("mcpclients") ?? [];
+  }
+  /** Upserts one mcp client record by its id so one clientrecord stays per connected transport. */
+  async setclient(client) {
+    const records = (await this.getclients()).filter((entry) => entry.id !== client.id);
+    await this.adapter.set("mcpclients", [client, ...records]);
+  }
+  /** Returns the connected client records — every client whose disconnect time is absent. */
+  async listclients() {
+    return (await this.getclients()).filter((client) => client.disconnectedat === void 0);
+  }
+  /** Stores the negotiated capability set of one client on its record. */
+  async setclientcapabilities(id, capabilities) {
+    await this.adapter.set("mcpclients", (await this.getclients()).map((client) => client.id === id ? { ...client, capabilities } : client));
+  }
+  /** Drops every stored client record when the server stops. */
+  async clearclients() {
+    await this.adapter.set("mcpclients", []);
+  }
+  /** Records one stdio bridge launch event with its process id; a restart marker distinguishes the relaunch of a dead client process. */
+  async addbridgelaunch(launch) {
+    await this.adapter.set("mcbridgelaunches", [launch, ...await this.adapter.get("mcbridgelaunches") ?? []]);
+  }
+  /** Returns every stdio bridge launch event, newest first. */
+  async listbridgelaunches() {
+    return await this.adapter.get("mcbridgelaunches") ?? [];
+  }
+  /** Returns the user configured mcp server config; an absent record keeps the documented localhost default. */
+  async getmcpconfig() {
+    return this.adapter.get("mcpconfig");
+  }
+  /** Stores the user configured mcp server config: bind address, port, transports, frame size, queue depth and enablement all stay user choices. */
+  async setmcpconfig(config) {
+    return this.adapter.set("mcpconfig", config);
+  }
+  /** Returns the persisted mcp server runtime state. */
+  async getmcpstate() {
+    return this.adapter.get("mcpstate");
+  }
+  /** Stores the mcp server runtime state with the stdio bridge status. */
+  async setmcpstate(state) {
+    return this.adapter.set("mcpstate", state);
+  }
+  /** Records one mcp tool call — the client, the tool, the origin and the outcome without any payload — under the user configured call retention with no code ceiling. */
+  async addtoolcall(record2) {
+    const records = await this.listtoolcalls();
+    const retention = (await this.getmcpconfig())?.callretention;
+    await this.adapter.set("mcptoolcalls", retention === void 0 ? [record2, ...records] : [record2, ...records].slice(0, retention));
+  }
+  /** Returns every stored mcp tool call record, newest first. */
+  async listtoolcalls() {
+    return await this.adapter.get("mcptoolcalls") ?? [];
+  }
 };
 function mediakindof(record2) {
   if ("pages" in record2) return "pdf";
@@ -2426,6 +2481,93 @@ function randomid() {
   return crypto.randomUUID();
 }
 
+// toolcatalog.ts
+var toolcatalogversion = 1;
+var toolnamespaces = ["browser", "workflow", "memory", "system"];
+function toolschemaof(properties) {
+  return { type: "object", properties, required: Object.entries(properties).filter(([, property]) => property.required === true).map(([name]) => name) };
+}
+function readtool(name, kind, description, inputs = {}) {
+  return { name, version: toolcatalogversion, description, inputschema: toolschemaof({ target: { type: "string", description: "Reviewed css selector the tool addresses." }, value: { type: "string", description: "Reviewed literal value the tool carries." }, options: { type: "object", description: "Reviewed json options of the wrapped action kind with the empty default.", default: {} }, ...inputs }), kind, risk: "read" };
+}
+function gatedtool(name, kind, risk, description, review) {
+  return { name, version: toolcatalogversion, description, inputschema: toolschemaof({ stepid: { type: "string", description: "Id of the approved plan step this tool executes.", required: true } }), kind, risk, consentmeta: { review } };
+}
+function browserdomain() {
+  return {
+    namespace: "browser",
+    version: toolcatalogversion,
+    tools: [
+      readtool("browser.snapshot", "observe", "Captures the semantic snapshot of the active tab: url, title, text preview, forms and interactive elements. Read only with no side effects; runs under the dryrun risk class once the session is approved."),
+      readtool("browser.extract", "extract", "Extracts the reviewed structured data of the page. Read only with no side effects."),
+      readtool("browser.readtext", "readtext", "Reads the text of the addressed element. Read only with no side effects.", { target: { type: "string", description: "Reviewed css selector of the element to read.", required: true } }),
+      readtool("browser.readtable", "readtable", "Reads the rows of the addressed data table. Read only with no side effects.", { target: { type: "string", description: "Reviewed css selector of the table to read.", required: true } }),
+      readtool("browser.readlinks", "readlinks", "Reads the link inventory of the page. Read only with no side effects."),
+      readtool("browser.a11ytree", "a11ytree", "Reads the accessibility tree of the page. Read only with no side effects."),
+      readtool("browser.tablist", "tablist", "Lists the open tabs. Read only with no side effects."),
+      readtool("browser.windowlist", "windowlist", "Lists the open windows. Read only with no side effects."),
+      gatedtool("browser.click", "click", "sensitive", "Clicks the addressed element. Sensitive: it changes page state, so it executes exactly one approved plan step.", "The click runs only as the approved plan step it names; a paired client can never widen the reviewed target or options."),
+      gatedtool("browser.type", "type", "sensitive", "Types the reviewed text into the addressed element. Sensitive: it changes page state, so it executes exactly one approved plan step.", "The typing runs only as the approved plan step it names; the reviewed target, text and options stay fixed."),
+      gatedtool("browser.presskey", "presskey", "sensitive", "Presses the reviewed key. Sensitive: it changes page state, so it executes exactly one approved plan step.", "The key press runs only as the approved plan step it names."),
+      gatedtool("browser.navigate", "navigate", "sensitive", "Navigates the active tab to the reviewed url. Sensitive: it changes browser state, so it executes exactly one approved plan step.", "The navigation runs only as the approved plan step it names and stays inside the session origin grants."),
+      gatedtool("browser.back", "back", "sensitive", "Navigates back in the history of the active tab. Sensitive: it changes browser state, so it executes exactly one approved plan step.", "The history navigation runs only as the approved plan step it names."),
+      gatedtool("browser.forward", "forward", "sensitive", "Navigates forward in the history of the active tab. Sensitive: it changes browser state, so it executes exactly one approved plan step.", "The history navigation runs only as the approved plan step it names."),
+      gatedtool("browser.reload", "reload", "sensitive", "Reloads the active tab. Sensitive: it changes browser state, so it executes exactly one approved plan step.", "The reload runs only as the approved plan step it names."),
+      gatedtool("browser.tabcreate", "tabcreate", "sensitive", "Opens a new tab. Sensitive: it changes browser state, so it executes exactly one approved plan step.", "The tab creation runs only as the approved plan step it names."),
+      gatedtool("browser.tabactivate", "tabactivate", "sensitive", "Activates the reviewed tab. Sensitive: it moves focus, so it executes exactly one approved plan step.", "The tab activation runs only as the approved plan step it names."),
+      gatedtool("browser.tabclose", "tabclose", "sensitive", "Closes the reviewed tab. Sensitive: it destroys browser state, so it executes exactly one approved plan step.", "The tab close runs only as the approved plan step it names."),
+      gatedtool("browser.windowcreate", "windowcreate", "sensitive", "Opens a new window. Sensitive: it changes browser state, so it executes exactly one approved plan step.", "The window creation runs only as the approved plan step it names."),
+      gatedtool("browser.windowclose", "windowclose", "sensitive", "Closes the reviewed window. Sensitive: it destroys browser state, so it executes exactly one approved plan step.", "The window close runs only as the approved plan step it names."),
+      gatedtool("browser.windowresize", "windowresize", "sensitive", "Resizes the reviewed window. Sensitive: it changes browser state, so it executes exactly one approved plan step.", "The window resize runs only as the approved plan step it names.")
+    ]
+  };
+}
+function workflowdomain() {
+  return {
+    namespace: "workflow",
+    version: toolcatalogversion,
+    tools: [
+      readtool("workflow.list", "composeworkflow", "Lists the composed workflows with their names, versions, origins and step counts. Read only with no side effects."),
+      readtool("workflow.dryrun", "dryrun", "Runs a composed workflow as a dry run: read steps project their would be outcome and every step with side effects is refused. Read only with no side effects."),
+      gatedtool("workflow.run", "runworkflow", "sensitive", "Runs a composed workflow for real. Sensitive: it executes every step of the workflow, so it executes exactly one approved runworkflow plan step with its explicit run review.", "The workflow run needs the explicit run review: the approved runworkflow plan step with its expanded step list shown before the first step executes."),
+      gatedtool("workflow.triggers", "eventrule", "sensitive", "Lists the armed trigger rules with their schedules, cooldowns and fire counters so a client can inspect what launches runs automatically. Sensitive by its trigger family: automatic launchers stay behind the arm review class.", "The trigger listing runs behind the approved plan review because trigger rules launch runs automatically.")
+    ]
+  };
+}
+function memorydomain() {
+  return {
+    namespace: "memory",
+    version: toolcatalogversion,
+    tools: [
+      readtool("memory.list", "listruns", "Lists the stored workflow run records with their states and step cursors from local memory. Read only with no page access.", { target: { type: "string", description: "Unused by the memory read; kept for schema uniformity." }, value: { type: "string", description: "Unused by the memory read; kept for schema uniformity." }, state: { type: "string", description: "Optional reviewed run state filter of the listing.", default: "" } }),
+      readtool("memory.variables", "extractvars", "Reads the stored variable scopes of a run from local memory. Read only with no page access."),
+      readtool("memory.audit", "trailaudit", "Reads the audit summary of the session trail from local memory. Read only with no page access.")
+    ]
+  };
+}
+function systemdomain() {
+  return {
+    namespace: "system",
+    version: toolcatalogversion,
+    tools: [
+      readtool("system.status", "observe", "Reports the mcp server status, the session state and the connected clients. Read only with no side effects."),
+      readtool("system.version", "readmeta", "Reports the protocol version, the catalog version and the extension version. Read only with no side effects."),
+      readtool("system.capabilities", "observe", "Reports the optional browser capabilities the user has granted. Read only with no side effects.")
+    ]
+  };
+}
+function buildtoolcatalog() {
+  return { version: toolcatalogversion, domains: [browserdomain(), workflowdomain(), memorydomain(), systemdomain()] };
+}
+function alltools(catalog) {
+  return catalog.domains.flatMap((domain) => domain.tools);
+}
+function resolvetool(catalog, name) {
+  if (name.includes(".")) return alltools(catalog).find((tool) => tool.name === name);
+  const matches = alltools(catalog).filter((tool) => tool.name.split(".")[1] === name);
+  return matches.length === 1 ? matches[0] : void 0;
+}
+
 // socketbus.ts
 var socketkinds = ["opensocket", "sendmessage", "waitmessage", "subscribesse", "longpoll"];
 function channelorigin(url) {
@@ -5232,7 +5374,7 @@ function consolediff(input) {
 // policy.ts
 var sensitiveactions = /* @__PURE__ */ new Set(["click", "type", "navigate", "select", "presskey", "drag", "drop", "upload", "clear", "check", "uncheck", "toggle", "submit", "reload", "back", "forward", "writestorage", "setattribute", "removeattribute", "evaluate", "tabcreate", "tabactivate", "tabclose", "tabreload", "windowcreate", "windowclose", "windowresize", "downloadfile", "clickpoint", "shiftclick", "dismissdialog", "enterframe", "typetime", "appendtext", "setvalue", "typeedit", "keyhold", "keyrelease", "submitsearch", "selectmulti", "chooseradio", "setslider", "setdate", "setcolor", "openlink", "openprivate", "reloadcache", "stopnav", "followlink", "spanav", "rewritequery", "setfragment", "navlist", "navprofile", "handleauth", "printpdf", "prefetch", "preconnect", "deeplink", "reopentab", "pausenav", "navrate", "openclipboard", "batchopen", "duplicatetab", "closepattern", "pintab", "mutetab", "movetab", "movetabwindow", "grouptabs", "colorgroup", "collapsegroup", "discardtab", "reloadtabs", "zoomin", "zoomout", "switchtab", "maximizewindow", "minimizewindow", "restorewindow", "focuswindow", "scratchwindow", "incognitowindow", "restoretab", "restorelayout", "reopenrun", "badgetab", "fillform", "filllabel", "fillplaceholder", "submitform", "retryform", "runwizard", "selectchain", "picktypeahead", "pickdate", "attachfile", "fillcard", "fillcode", "consentpassword", "exportcsv", "exportjson", "exportexcel", "copytable", "pushsheets", "streamdisk", "paginateextract", "resumeextract", "batchdownload", "pausedownload", "resumedownload", "interceptmime", "readclipboard", "writeclipboard", "copyscreen", "quarantinedownload", "scanvirus", "cleanupartifacts", "recordscreen", "captureaudio", "downloadimages", "callrest", "callgraphql", "sendmessage", "blockrequest", "mockresponse", "rewriteheaders", "setcookies", "clearcookies", "authflow", "saveapikey", "routeproxy", "postform", "postfiles", "attachcdp", "detachcdp", "cdpcmd", "overridescript", "heapshot", "profilecpu", "capturesourcemaps", "emulatedevice", "emulatenetwork", "emulatelocate", "setuseragent", "overridepermission", "restoresession", "exportsessions", "importsessions", "runworkflow", "visitrule", "urlrule", "menurule", "keyrule", "buttonrule", "cronrule", "intervalrule", "urllistrule", "webhookrule", "eventrule"]);
 var interactionactions = /* @__PURE__ */ new Set(["focus", "scroll", "hover", "clickdeep", "rightclick", "doubleclick", "scrollpage", "scrollby", "scrollend", "scrolltop", "fullscreen", "zoomset", "movepointer", "clicktext", "clickaria", "clickname", "expanddetails", "pierceshadow", "retryaction", "capturebodies", "setbreakpoint", "stepcode", "watchexpr", "loop", "repeatuntil", "whileloop", "foreach", "parallel", "trycatch"]);
-var readactions = /* @__PURE__ */ new Set(["observe", "inspect", "extract", "wait", "waitfor", "waittext", "readattribute", "readstyle", "readgeometry", "readvalue", "readtext", "readhtml", "countelements", "readtable", "readlinks", "readimages", "readmeta", "readforms", "readstorage", "highlight", "tablist", "windowlist", "tabsnapshot", "mapclicks", "verifyvisible", "verifyenabled", "resolvexpath", "a11ytree", "readvisible", "readertree", "detectlists", "detecttables", "readjson", "watchmutate", "waitquiet", "watchbanner", "detectinfinitescroll", "detectvirtual", "detectlazy", "readscrollpos", "readlang", "readoutline", "countpages", "listshadow", "listframes", "classifypage", "fingerprintsection", "diffsnapshots", "readselection", "watchfocus", "detectsticky", "detectscrolllock", "readopengraph", "detectlanguage", "deriveselector", "waitload", "waiturl", "spawait", "detecthttp", "readredirects", "readfinalurl", "trailaudit", "navintent", "checksafe", "querytabs", "watchtab", "findclones", "searchtabs", "listaudio", "snapshotsession", "savelayout", "attachmeta", "detectfields", "generatevalues", "saveprofiles", "asksubmit", "readerrors", "skiphoneypot", "detectlogin", "detecttemplate", "handoffcaptcha", "scrapetable", "importcsv", "looprows", "transformvalues", "deduperows", "mergepages", "stamplerows", "previewgrid", "logprovenance", "verifydownload", "exportnetlog", "namecaptures", "shotview", "shotfullpage", "shotelement", "shotregion", "contactsheet", "capturepdf", "captureframe", "readmedia", "readassets", "probestream", "timelapse", "shotcanvas", "convertimage", "makethumbs", "fetchurl", "parsejson", "parsehtml", "opensocket", "waitmessage", "watchrequests", "readheaders", "mapapi", "subscribesse", "longpoll", "extractapi", "readcookies", "watchconsole", "watcherrors", "watchtasks", "watchcdp", "measureflow", "trackmemory", "watchshifts", "traceload", "annotatetrace", "replaytrace", "blackboxscripts", "persiststate", "capturesession", "namedsessions", "diffsessions", "searchsessions", "composeworkflow", "savetemplate", "dryrun", "delay", "waitelement", "compute", "extractvars", "condition", "branch"]);
+var readactions = /* @__PURE__ */ new Set(["observe", "inspect", "extract", "wait", "waitfor", "waittext", "readattribute", "readstyle", "readgeometry", "readvalue", "readtext", "readhtml", "countelements", "readtable", "readlinks", "readimages", "readmeta", "readforms", "readstorage", "highlight", "tablist", "windowlist", "tabsnapshot", "mapclicks", "verifyvisible", "verifyenabled", "resolvexpath", "a11ytree", "readvisible", "readertree", "detectlists", "detecttables", "readjson", "watchmutate", "waitquiet", "watchbanner", "detectinfinitescroll", "detectvirtual", "detectlazy", "readscrollpos", "readlang", "readoutline", "countpages", "listshadow", "listframes", "classifypage", "fingerprintsection", "diffsnapshots", "readselection", "watchfocus", "detectsticky", "detectscrolllock", "readopengraph", "detectlanguage", "deriveselector", "waitload", "waiturl", "spawait", "detecthttp", "readredirects", "readfinalurl", "trailaudit", "navintent", "checksafe", "querytabs", "watchtab", "findclones", "searchtabs", "listaudio", "snapshotsession", "savelayout", "attachmeta", "detectfields", "generatevalues", "saveprofiles", "asksubmit", "readerrors", "skiphoneypot", "detectlogin", "detecttemplate", "handoffcaptcha", "scrapetable", "importcsv", "looprows", "transformvalues", "deduperows", "mergepages", "stamplerows", "previewgrid", "logprovenance", "verifydownload", "exportnetlog", "namecaptures", "shotview", "shotfullpage", "shotelement", "shotregion", "contactsheet", "capturepdf", "captureframe", "readmedia", "readassets", "probestream", "timelapse", "shotcanvas", "convertimage", "makethumbs", "fetchurl", "parsejson", "parsehtml", "opensocket", "waitmessage", "watchrequests", "readheaders", "mapapi", "subscribesse", "longpoll", "extractapi", "readcookies", "watchconsole", "watcherrors", "watchtasks", "watchcdp", "measureflow", "trackmemory", "watchshifts", "traceload", "annotatetrace", "replaytrace", "blackboxscripts", "persiststate", "capturesession", "namedsessions", "diffsessions", "searchsessions", "composeworkflow", "savetemplate", "dryrun", "delay", "waitelement", "compute", "extractvars", "listruns", "condition", "branch"]);
 var allowedactions = /* @__PURE__ */ new Set([...sensitiveactions, ...interactionactions, ...readactions]);
 var watchactions = /* @__PURE__ */ new Set(["watchmutate", "watchbanner", "watchfocus", "watchtab"]);
 var targetactions = /* @__PURE__ */ new Set(["inspect", "focus", "click", "type", "scroll", "select", "hover", "clickdeep", "rightclick", "doubleclick", "drag", "drop", "upload", "clear", "check", "uncheck", "toggle", "submit", "readattribute", "readstyle", "readgeometry", "readvalue", "readtext", "readhtml", "countelements", "readtable", "highlight", "setattribute", "removeattribute", "waitfor", "shiftclick", "typetime", "appendtext", "setvalue", "typeedit", "submitsearch", "selectmulti", "chooseradio", "setslider", "setdate", "setcolor", "expanddetails", "verifyvisible", "verifyenabled", "pierceshadow", "deriveselector", "fingerprintsection", "submitform", "retryform", "selectchain", "picktypeahead", "pickdate", "attachfile", "fillcode", "consentpassword", "scrapetable", "paginateextract", "shotelement", "captureframe", "shotcanvas"]);
@@ -8119,6 +8261,37 @@ function watchdogconfigvalid(config) {
   if (config.zombiewindow !== void 0 && (typeof config.zombiewindow !== "number" || !Number.isFinite(config.zombiewindow) || config.zombiewindow <= 0)) return { allowed: false, reason: "The watchdog zombie window, when configured, must be a positive number of milliseconds with no code ceiling." };
   return { allowed: true };
 }
+function serverbindgate(config) {
+  const bind = config.bind !== void 0 && config.bind.trim() !== "" ? config.bind.trim() : "127.0.0.1";
+  const local = bind === "127.0.0.1" || bind === "localhost" || bind === "::1";
+  if (!local && config.remote !== true) return { allowed: false, reason: `The bind ${bind} leaves localhost and grades sensitive: the explicit remote review must approve it first.` };
+  return { allowed: true };
+}
+function serverenablementgate(config) {
+  if (config.enabled !== true) return { allowed: false, reason: "The mcp server starts only after the user enables it; the protocol surface stays closed by default." };
+  const bind = serverbindgate(config);
+  if (!bind.allowed) return bind;
+  if (!Array.isArray(config.transports) || config.transports.length === 0) return { allowed: false, reason: "The mcp server needs at least one allowed transport of stdio or http." };
+  if (!config.transports.every((transport) => transport === "stdio" || transport === "http")) return { allowed: false, reason: "The allowed transports of the mcp server are stdio and http." };
+  if (typeof config.port !== "number" || !Number.isFinite(config.port) || config.port <= 0 || config.port > 65535) return { allowed: false, reason: "The http listener port must be a valid port number." };
+  if (config.framesize !== void 0 && (typeof config.framesize !== "number" || !Number.isFinite(config.framesize) || config.framesize <= 0)) return { allowed: false, reason: "The user configured frame size must stay a positive number with no code ceiling." };
+  if (config.queuedepth !== void 0 && (typeof config.queuedepth !== "number" || !Number.isFinite(config.queuedepth) || config.queuedepth <= 0)) return { allowed: false, reason: "The user configured queue depth must stay a positive number with no code ceiling." };
+  return { allowed: true };
+}
+function tooldispatchgate(input) {
+  if (input.client.disconnectedat !== void 0) return { allowed: false, reason: "The mcp client is disconnected and its tool calls are refused." };
+  if (!input.client.paired) return { allowed: false, reason: "The mcp client waits for the user pairing approval; unpaired clients never dispatch tools." };
+  if (!input.session || input.session.stoppedat || input.session.pausedat) return { allowed: false, reason: "Tool dispatch needs the live browser session behind the consent gates." };
+  if (input.session.expiresat <= input.now) return { allowed: false, reason: "The browser session has expired and tool dispatch is refused." };
+  if (!input.plan || input.plan.state !== "approved") return { allowed: false, reason: "Tool dispatch needs the approved plan review before any tool runs." };
+  if (!origingranted(input.session, input.origin)) return { allowed: false, reason: `The tool call origin ${input.origin} stays outside the session grants and is refused.` };
+  if (input.tool.risk === "read") return { allowed: true };
+  if (input.stepid === void 0 || input.stepid.trim() === "") return { allowed: false, reason: `The ${input.tool.name} tool has side effects and needs the id of the approved plan step it executes.` };
+  const step = input.plan.steps.find((candidate) => candidate.id === input.stepid);
+  if (step === void 0) return { allowed: false, reason: `The tool call names the step ${input.stepid} which the approved plan does not carry.` };
+  if (step.kind !== input.tool.kind) return { allowed: false, reason: `The tool call names the step ${input.stepid} whose kind ${String(step.kind)} does not match the ${input.tool.name} tool.` };
+  return { allowed: true };
+}
 
 // progress.ts
 function emptyprogress(planid, now) {
@@ -8291,9 +8464,14 @@ function recordtrigger(progress, planid, stepid, entry, now) {
   const outcome = { stepid, ok: true, summary: `${entry.detail}${counts.length > 0 ? ` with ${counts}` : ""}.`, details: { trigger: entry }, at: now };
   return recordoutcome(base, planid, outcome, now);
 }
+function recordtoolcall(progress, planid, stepid, entry, now) {
+  const base = progress && progress.planid === planid ? progress : emptyprogress(planid, now);
+  const outcome = { stepid, ok: entry.ok, summary: `The ${entry.tool} tool call of the client ${entry.clientid} ${entry.ok ? "ran behind the consent gates" : `was refused${entry.code !== void 0 ? ` with the ${entry.code} error` : ""}`}.`, details: { tool: entry }, at: now };
+  return recordoutcome(base, planid, outcome, now);
+}
 
 // version.ts
-var packageversion = "1.1.53";
+var packageversion = "1.1.54";
 
 // types.ts
 var protocolversion = packageversion;
@@ -8630,7 +8808,7 @@ function requestbody(input) {
   return JSON.stringify({ version: protocolversion, objective: input.objective, session: input.session, observation: input.observation, capabilities: input.capabilities });
 }
 function outcomeresponse(input) {
-  return JSON.stringify({ version: protocolversion, planid: input.plan.id, planstate: input.plan.state, outcome: input.outcome, ...input.resolvedtarget ? { resolvedtarget: input.resolvedtarget } : {}, ...input.capture ? { capture: input.capture } : {}, ...input.media ? { media: input.media } : {}, ...input.transport ? { transport: input.transport } : {}, ...input.network ? { network: input.network } : {}, ...input.control ? { control: input.control } : {}, ...input.timeline ? { timeline: input.timeline } : {}, ...input.cdp ? { cdp: input.cdp } : {}, ...input.profile ? { profile: input.profile } : {}, ...input.emulation ? { emulation: input.emulation } : {}, ...input.session ? { session: input.session } : {}, ...input.workflow ? { workflow: { runid: input.workflow.runid, state: input.workflow.state, ...input.workflow.dryrun === true ? { dryrun: true } : {}, produced: input.workflow.produced, consumed: input.workflow.consumed, ...input.workflow.timeout !== void 0 ? { timeout: input.workflow.timeout } : {}, ...input.workflow.retry !== void 0 ? { retry: input.workflow.retry } : {} } } : {}, ...input.trigger ? { trigger: { ruleid: input.trigger.ruleid, kind: input.trigger.kind, enabled: input.trigger.enabled, ...input.trigger.nextfireat !== void 0 ? { nextfireat: input.trigger.nextfireat } : {} } } : {} });
+  return JSON.stringify({ version: protocolversion, planid: input.plan.id, planstate: input.plan.state, outcome: input.outcome, ...input.resolvedtarget ? { resolvedtarget: input.resolvedtarget } : {}, ...input.capture ? { capture: input.capture } : {}, ...input.media ? { media: input.media } : {}, ...input.transport ? { transport: input.transport } : {}, ...input.network ? { network: input.network } : {}, ...input.control ? { control: input.control } : {}, ...input.timeline ? { timeline: input.timeline } : {}, ...input.cdp ? { cdp: input.cdp } : {}, ...input.profile ? { profile: input.profile } : {}, ...input.emulation ? { emulation: input.emulation } : {}, ...input.session ? { session: input.session } : {}, ...input.workflow ? { workflow: { runid: input.workflow.runid, state: input.workflow.state, ...input.workflow.dryrun === true ? { dryrun: true } : {}, produced: input.workflow.produced, consumed: input.workflow.consumed, ...input.workflow.timeout !== void 0 ? { timeout: input.workflow.timeout } : {}, ...input.workflow.retry !== void 0 ? { retry: input.workflow.retry } : {} } } : {}, ...input.trigger ? { trigger: { ruleid: input.trigger.ruleid, kind: input.trigger.kind, enabled: input.trigger.enabled, ...input.trigger.nextfireat !== void 0 ? { nextfireat: input.trigger.nextfireat } : {} } } : {}, ...input.tool ? { tool: { clientid: input.tool.clientid, tool: input.tool.tool, origin: input.tool.origin, ok: input.tool.ok, ...input.tool.code !== void 0 ? { code: input.tool.code } : {} } } : {} });
 }
 function mapresponse(input) {
   return JSON.stringify({ version: protocolversion, planid: input.plan.id, planstate: input.plan.state, map: input.map });
@@ -9894,6 +10072,142 @@ function yamlscalarvalue(text2) {
   return text2;
 }
 
+// mcpserver.ts
+var localhostbind = "127.0.0.1";
+var defaultmcpport = 7436;
+function rpcerrorof(code, message, data) {
+  return { code, message, ...data !== void 0 ? { data } : {} };
+}
+function defaultmcpconfig() {
+  return { port: defaultmcpport, transports: ["stdio", "http"], enabled: false };
+}
+function unwraphttppost(value) {
+  if (value && typeof value === "object" && !Array.isArray(value)) {
+    const candidate = value;
+    if (candidate.transport === "http" && candidate.frame && typeof candidate.frame === "object" && !Array.isArray(candidate.frame)) return candidate.frame;
+  }
+  return value;
+}
+function parseframe(raw) {
+  const parsed = unwraphttppost(JSON.parse(raw));
+  if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) throw new Error("A json rpc frame must be an object.");
+  return parsed;
+}
+function serializeframe(frame) {
+  return JSON.stringify(frame);
+}
+function validateframe(frame, methods, config) {
+  if (frame.jsonrpc !== "2.0") return rpcerrorof("parse", "The frame must carry the jsonrpc 2.0 tag.");
+  if (frame.id !== void 0 && typeof frame.id !== "number" && typeof frame.id !== "string" && frame.id !== null) return rpcerrorof("parse", "The frame id must be a number, a string or null.");
+  if (frame.method === void 0 || frame.method.trim() === "") return rpcerrorof("method", "The frame carries no method to route.");
+  if (!methods.some((entry) => entry.method === frame.method)) return rpcerrorof("method", `The server routes no method named ${frame.method}.`);
+  if (frame.params !== void 0 && (typeof frame.params !== "object" || Array.isArray(frame.params))) return rpcerrorof("params", "The frame params must be an object.");
+  if (config?.framesize !== void 0 && serializeframe(frame).length > config.framesize) return rpcerrorof("params", `The serialized frame exceeds the user configured frame size of ${config.framesize} characters.`);
+  return void 0;
+}
+function respond(input) {
+  return { jsonrpc: "2.0", ...input.id === void 0 ? input.error !== void 0 ? { id: null } : {} : { id: input.id }, ...input.error !== void 0 ? { error: input.error } : { result: input.result } };
+}
+function servermethods() {
+  return [
+    { method: "initialize", handler: "initialize", description: "Completes the mcp handshake and returns the server info." },
+    { method: "ping", handler: "ping", description: "Answers keepalive frames with pong." },
+    { method: "tools/list", handler: "listtools", description: "Returns every tool with its version and json schema inputs." },
+    { method: "negotiate", handler: "negotiate", description: "Exchanges capability sets with the client." },
+    { method: "tools/call", handler: "dispatch", description: "Invokes one tool behind the consent gates." }
+  ];
+}
+function servercapabilities(input) {
+  return { protocolversion, name: "devthink", version: protocolversion, toolversion: input.catalog.version, tools: alltools(input.catalog).length, namespaces: toolnamespaces, transports: input.config.transports };
+}
+function initialize(input) {
+  void input.params;
+  return { serverinfo: servercapabilities({ config: input.config, catalog: input.catalog }), protocolversion, instructions: "Devthink serves browser tools behind the human review gates: read only tools run once a session is approved while every tool with side effects executes exactly the approved plan step it names. No endpoint, provider or key is hardcoded; the user pairs every client." };
+}
+function ping(input) {
+  return { pong: true, at: input.now };
+}
+function listtools(catalog) {
+  return { tools: alltools(catalog).map((tool) => ({ name: tool.name, version: tool.version, description: tool.description, inputschema: tool.inputschema, risk: tool.risk, ...tool.consentmeta !== void 0 ? { consentmeta: tool.consentmeta.review } : {} })) };
+}
+function negotiate(input) {
+  const client = input.client;
+  if (client?.protocolversion !== void 0 && client.protocolversion !== input.server.protocolversion) return { agreed: false, mismatch: `The client speaks protocol version ${String(client.protocolversion)} while the server offers ${input.server.protocolversion}.` };
+  if (client?.toolversion !== void 0 && client.toolversion > input.server.toolversion) return { agreed: false, mismatch: `The client requires tool version ${String(client.toolversion)} while the server offers ${String(input.server.toolversion)}.` };
+  if (client?.transports !== void 0 && client.transports.some((transport) => !input.server.transports.includes(transport))) return { agreed: false, mismatch: "The client requires a transport the server configuration does not allow." };
+  return { agreed: true, capabilities: input.server };
+}
+function connectclient(input) {
+  return { id: input.id ?? `client-${input.now}`, transport: input.transport, paired: false, connectedat: input.now };
+}
+function disconnectclient(clients, id, now) {
+  return clients.map((client) => client.id === id && client.disconnectedat === void 0 ? { ...client, disconnectedat: now } : client);
+}
+async function dispatchtool(input) {
+  const params = input.params;
+  if (!params || typeof params !== "object" || Array.isArray(params)) return { error: rpcerrorof("params", "The tool call needs its params object.") };
+  if (typeof params.name !== "string" || !params.name.trim()) return { error: rpcerrorof("params", "The tool call needs the namespaced name of the tool it invokes.") };
+  const tool = resolvetool(input.catalog, params.name.trim());
+  if (tool === void 0) return { error: rpcerrorof("params", `The catalog holds no unambiguous tool named ${params.name.trim()}.`) };
+  const floor = input.client.capabilities?.toolversion ?? input.catalog.version;
+  if (tool.version < floor) return { error: rpcerrorof("params", `The tool ${tool.name} of version ${tool.version} stays below the negotiated compatibility floor of ${floor}.`) };
+  const stepid = typeof params.stepid === "string" ? params.stepid : void 0;
+  const gate = tooldispatchgate({ client: input.client, tool, session: input.session, plan: input.plan, origin: input.origin, ...stepid !== void 0 ? { stepid } : {}, now: input.now });
+  if (!gate.allowed) return { error: rpcerrorof("consentrefused", gate.reason ?? "The consent gates refused the tool call.") };
+  const step = tool.risk === "read" ? { id: `mcp-${input.client.id}-${input.now}`, kind: tool.kind, summary: tool.description.split(".")[0] ?? tool.description, risk: "read", ...typeof params.target === "string" ? { target: params.target } : {}, ...typeof params.value === "string" ? { value: params.value } : {}, ...params.options !== void 0 && typeof params.options === "object" && !Array.isArray(params.options) ? { options: JSON.stringify(params.options) } : {} } : input.plan?.steps.find((candidate) => candidate.id === stepid);
+  if (step === void 0) return { error: rpcerrorof("consentrefused", "The tool call names a step the approved plan does not carry.") };
+  try {
+    const result = await input.execute(step);
+    return { result, step };
+  } catch (error) {
+    return { error: rpcerrorof("internal", error instanceof Error ? error.message : String(error)) };
+  }
+}
+async function handleframe(input) {
+  if (input.raw !== void 0 && input.config.framesize !== void 0 && input.raw.length > input.config.framesize) return respond({ id: null, error: rpcerrorof("params", `The wire frame exceeds the user configured frame size of ${input.config.framesize} characters.`) });
+  let frame;
+  if (input.raw !== void 0) {
+    try {
+      frame = parseframe(input.raw);
+    } catch {
+      return respond({ id: null, error: rpcerrorof("parse", "The wire frame does not parse as json.") });
+    }
+  } else if (input.frame !== void 0) {
+    frame = input.frame;
+  } else {
+    return respond({ id: null, error: rpcerrorof("parse", "The server received no frame to route.") });
+  }
+  const invalid = validateframe(frame, servermethods(), input.config);
+  if (invalid !== void 0) return respond({ ...frame.id !== void 0 ? { id: frame.id } : {}, error: invalid });
+  const entry = servermethods().find((candidate) => candidate.method === frame.method);
+  if (entry === void 0) return respond({ ...frame.id !== void 0 ? { id: frame.id } : {}, error: rpcerrorof("method", `The server routes no method named ${String(frame.method)}.`) });
+  const params = frame.params;
+  if (entry.handler === "initialize") return respond({ ...frame.id !== void 0 ? { id: frame.id } : {}, result: initialize({ ...params !== void 0 ? { params } : {}, config: input.config, catalog: input.catalog }) });
+  if (entry.handler === "ping") return respond({ ...frame.id !== void 0 ? { id: frame.id } : {}, result: ping({ now: input.now }) });
+  if (entry.handler === "listtools") return respond({ ...frame.id !== void 0 ? { id: frame.id } : {}, result: listtools(input.catalog) });
+  if (entry.handler === "negotiate") {
+    const server = servercapabilities({ config: input.config, catalog: input.catalog });
+    const clientcaps = params?.capabilities && typeof params.capabilities === "object" && !Array.isArray(params.capabilities) ? params.capabilities : void 0;
+    const outcome = negotiate({ ...clientcaps !== void 0 ? { client: clientcaps } : {}, server });
+    return respond({ ...frame.id !== void 0 ? { id: frame.id } : {}, ...outcome.agreed ? { result: outcome.capabilities } : { error: rpcerrorof("params", outcome.mismatch ?? "The capability negotiation did not agree.") } });
+  }
+  const dispatched = await dispatchtool({ ...params !== void 0 ? { params } : {}, client: input.client, catalog: input.catalog, ...input.session !== void 0 ? { session: input.session } : {}, ...input.plan !== void 0 ? { plan: input.plan } : {}, origin: input.origin, now: input.now, execute: input.execute });
+  return respond({ ...frame.id !== void 0 ? { id: frame.id } : {}, ...dispatched.error !== void 0 ? { error: dispatched.error } : { result: dispatched.result } });
+}
+function bindlocalhost(config) {
+  const bind = config.bind !== void 0 && config.bind.trim() !== "" ? config.bind.trim() : localhostbind;
+  return { bind, port: config.port, localhost: bind === localhostbind || bind === "localhost" || bind === "::1" };
+}
+function launchbridge(input) {
+  return { id: input.id ?? `bridge-${input.now}`, host: input.host, connected: true, ...input.pid !== void 0 ? { pid: input.pid } : {}, startedat: input.now, restarts: 0, received: 0, sent: 0 };
+}
+function relayframe(input) {
+  return { ...input.bridge, connected: true, received: input.bridge.received + (input.direction === "inbound" ? 1 : 0), sent: input.bridge.sent + (input.direction === "outbound" ? 1 : 0), lastframeat: input.now };
+}
+function toolcallevent(input) {
+  return { id: input.id, clientid: input.clientid, tool: input.tool, origin: input.origin, ok: input.ok, ...input.code !== void 0 ? { code: input.code } : {}, at: input.now };
+}
+
 // extension/pagesession.ts
 function capturepagestate(sections) {
   const wants = (section) => sections.includes(section);
@@ -16083,6 +16397,8 @@ async function executeaction(step, session, plan, tabid2, origin, settings, verd
     } else if (istriggeraction(step.kind)) {
       if (!session || !plan || plan.state !== "approved") throw new Error("Trigger kinds refuse to run outside an approved session plan.");
       output = await executetriggerstep(step, session, plan, tabid2, origin);
+    } else if (step.kind === "listruns") {
+      output = await executelistruns(step, session);
     } else {
       if (step.target && freshcheckkinds.has(step.kind)) {
         const fresh = await snapshot(tabid2);
@@ -16337,7 +16653,7 @@ async function handlerequest(message, sender) {
       const livetab = session ? await chrome.tabs.get(session.tabid).catch(() => void 0) : void 0;
       const waitprofile = session ? waitprofiles.find((record2) => record2.origin === session.origin) : void 0;
       const livestate = { phase: livetab?.status === "loading" ? "loading" : "complete", ...navrecords[0] ? { finalurl: navrecords[0].finalurl, redirects: navrecords[0].chain } : {} };
-      return { config: await memory.getconfig(), session, plan, progress: plan && progress?.planid === plan.id ? progress : void 0, diagnostic: await memory.getdiagnostic(), audit: await memory.getaudit(), capabilities: await refreshcapabilities(), outcomes: await memory.getoutcomes(), holds: heldkeysreport({ tabid: session?.tabid ?? 0, holds }), dialogs: await memory.getdialogs(), retries: await memory.getretries(), ...signals ? { signals: signalsreport({ signals }) } : { signals: signalsreport({}) }, banners: await memory.getbanners(), mutationevents: await memory.getmutationevents(), focusevents: await memory.getfocusevents(), diffs: await memory.getdiffs(), selectors: await memory.getselectors(), ...a11y ? { a11y } : {}, ...reader ? { reader } : {}, ...map ? { map } : {}, trail: trailreport({ ...session ? { sessionid: session.id } : {}, trail }), navrecords, ratestates, safeties, curated, waitprofiles, auths, navcontrol, navqueues, artifacts, navstate: livestate, ...waitprofile ? { waitprofile } : {}, offline: !navigator.onLine, tabs, windows, layouts: layoutreport({ layouts }), tabgroups, tabmetas, badges, snapshots, closedtabs, tabwatchevents, clones, tasktabgauge: taskgauge, ...controltab ? { controltab } : {}, tabreport: report, profiles, tickets, wizards: wizardreport({ ...session ? { sessionid: session.id } : {}, wizards, picks }), picks, errorreports, captchas, detections, ...codeentry !== void 0 ? { codeentry: true } : {}, datasets, imports, extractsessions, streams, exports, provenances, taskrules, sheetendpoints: sheetgrants, downloads, netlogs, clipconsents, clips, quarantines, cleanuprules, cleanupruns, capturecounters, inventory, mimefilters, scanhooks, captures: capturemetadata, capturepairs, capturepolicy: runsettings?.capturepolicy ?? "manual", media: mediarecords, imagebatches, recordingconsents, recordingactive: [...activerecordings.values()].map((active) => ({ id: active.record.id, kind: active.record.kind, scope: active.record.scope, startedat: active.record.startedat, stopat: active.stopat })), recordingwindow: runsettings?.recordingwindow, calls, endpoints, fetchconsents, apikeys, callretention: runsettings?.callretention, fetchesactive: activefetches.size, exchanges, channels, subscriptions, apimap, messages: messagecount, webrequestgrant: runsettings?.webrequestgrant === true, bodyretention: runsettings?.bodyretention, timelineretention: runsettings?.timelineretention, timeline, consoleconsents: await memory.getconsoleconsents(), rotationtargets: await memory.getrotationtargets(), levelsummaries: await memory.getlevelsummaries(), cdpsessions: await memory.getcdpsessions(), cdpcommands: await memory.getcdpcommands(), cdpeventrules: await memory.getcdpeventrules(), breakpoints: await memory.getbreakpoints(), pauses: await memory.getpauses(), watchexpressions: await memory.getwatchexpressions(), scriptoverrides: await memory.getscriptoverrides(), debuggergrants: await memory.getdebuggergrants(), pauseretention: runsettings?.pauseretention, breakpointceiling: runsettings?.breakpointceiling, cdpattached: [...activecdpsessions.values()].filter((active) => active.session.detachedat === void 0).length, profileretention: runsettings?.profileretention, traceceiling: runsettings?.traceceiling, profile: profilereport({ flows: await memory.getflowmetrics(), heaps: await memory.getheaprecords(), samples: await memory.getgrowsamples(), trends: await memory.gettrends(), profiles: await memory.getcpuprofiles(), shifts: await memory.getshiftentries(), traces: await memory.gettracerecords(), sourcemaps: await memory.getsourcemaps(), consents: await memory.getsourcemapconsents() }), profileactive: activememorytrackers.size + activeprofiletargets.size, profiletargets: [...activeprofiletargets.values()].flatMap((entry) => entry.targets), socketsactive: activesockets.size, emulation: emulationreport({ ...plan && await loademulationstate(plan.id) !== void 0 ? { state: await loademulationstate(plan.id) } : {}, devices: await memory.getdevicepresets(), networks: await memory.getnetworkpresets(), locations: await memory.getlocationpresets(), agents: await memory.getagentpresets(), blackbox: await memory.getblackboxrules(), permissions: await memory.getpermissionoverrides(), consents: await memory.getlocationconsents() }), emulatedlayers: plan ? layernames(await loademulationstate(plan.id)) : [], emulationretention: runsettings?.emulationretention, traffic, tokens, authflows, activerules: [...activerules.values()].reduce((total, ruleset) => total + ruleset.blocks.filter((rule) => rule.revertedat === void 0).length + ruleset.mocks.filter((rule) => rule.revertedat === void 0).length + ruleset.rewrites.filter((rule) => rule.revertedat === void 0).length + (ruleset.proxy !== void 0 && ruleset.proxy.revertedat === void 0 ? 1 : 0), 0), sessionmemory: sessionreport({ records: sessionrecords, events: await memory.getsessionevents(), folders: await memory.getsessionfolders(), diffs: await memory.getsessiondiffs(), ...autosnapshot !== void 0 ? { auto: autosnapshot.interval } : {}, ...crashed ? { crashed: true } : {} }), autosnapshotstate: autosnapshot, sessionretention: runsettings?.sessionretention, trigger: triggerlist({ rules: await memory.gettriggerules(), workflows: await memory.listworkflows(), queue: await memory.gettriggerqueue() }), triggerretention: runsettings?.triggerretention, workflow: workflowreport({ workflows: await memory.listworkflows(), runs: await memory.listworkflowruns(), templates: await memory.getsteptemplates(), ...newestworkflowrun !== void 0 ? { log: await memory.getrunlog(newestworkflowrun.id), scopes: await memory.getrunscopes(newestworkflowrun.id), provenance: await memory.getworkflowprovenance(newestworkflowrun.id), control: await memory.listcontroldecisions(newestworkflowrun.id) } : {} }), runlogretention: runsettings?.runlogretention, runhistoryretention: runsettings?.runhistoryretention, editor: editorstate({ versions: await memory.listworkflowversions(), diffs: await memory.listversiondiffs(), history: await memory.gethistory(), overrides: await memory.listsiteoverrides(), imports: (await memory.listworkflowimports()).map((entry) => ({ id: entry.id, workflowid: entry.record.id, name: entry.record.name, version: entry.record.version, steps: entry.record.steps.length, risk: entry.record.risk, importedat: entry.importedat, ...entry.filename !== void 0 ? { filename: entry.filename } : {} })), backgroundruns: await memory.getbackgroundruns(), watchdog: { ...runsettings?.watchdog !== void 0 ? { config: runsettings.watchdog } : {}, events: await memory.listwatchdogevents() } }), ...taskstate !== void 0 ? { taskstate } : {}, ...stitchprogress.size > 0 ? { stitchprogress: [...stitchprogress.values()] } : {} };
+      return { config: await memory.getconfig(), session, plan, progress: plan && progress?.planid === plan.id ? progress : void 0, diagnostic: await memory.getdiagnostic(), audit: await memory.getaudit(), capabilities: await refreshcapabilities(), outcomes: await memory.getoutcomes(), holds: heldkeysreport({ tabid: session?.tabid ?? 0, holds }), dialogs: await memory.getdialogs(), retries: await memory.getretries(), ...signals ? { signals: signalsreport({ signals }) } : { signals: signalsreport({}) }, banners: await memory.getbanners(), mutationevents: await memory.getmutationevents(), focusevents: await memory.getfocusevents(), diffs: await memory.getdiffs(), selectors: await memory.getselectors(), ...a11y ? { a11y } : {}, ...reader ? { reader } : {}, ...map ? { map } : {}, trail: trailreport({ ...session ? { sessionid: session.id } : {}, trail }), navrecords, ratestates, safeties, curated, waitprofiles, auths, navcontrol, navqueues, artifacts, navstate: livestate, ...waitprofile ? { waitprofile } : {}, offline: !navigator.onLine, tabs, windows, layouts: layoutreport({ layouts }), tabgroups, tabmetas, badges, snapshots, closedtabs, tabwatchevents, clones, tasktabgauge: taskgauge, ...controltab ? { controltab } : {}, tabreport: report, profiles, tickets, wizards: wizardreport({ ...session ? { sessionid: session.id } : {}, wizards, picks }), picks, errorreports, captchas, detections, ...codeentry !== void 0 ? { codeentry: true } : {}, datasets, imports, extractsessions, streams, exports, provenances, taskrules, sheetendpoints: sheetgrants, downloads, netlogs, clipconsents, clips, quarantines, cleanuprules, cleanupruns, capturecounters, inventory, mimefilters, scanhooks, captures: capturemetadata, capturepairs, capturepolicy: runsettings?.capturepolicy ?? "manual", media: mediarecords, imagebatches, recordingconsents, recordingactive: [...activerecordings.values()].map((active) => ({ id: active.record.id, kind: active.record.kind, scope: active.record.scope, startedat: active.record.startedat, stopat: active.stopat })), recordingwindow: runsettings?.recordingwindow, calls, endpoints, fetchconsents, apikeys, callretention: runsettings?.callretention, fetchesactive: activefetches.size, exchanges, channels, subscriptions, apimap, messages: messagecount, webrequestgrant: runsettings?.webrequestgrant === true, bodyretention: runsettings?.bodyretention, timelineretention: runsettings?.timelineretention, timeline, consoleconsents: await memory.getconsoleconsents(), rotationtargets: await memory.getrotationtargets(), levelsummaries: await memory.getlevelsummaries(), cdpsessions: await memory.getcdpsessions(), cdpcommands: await memory.getcdpcommands(), cdpeventrules: await memory.getcdpeventrules(), breakpoints: await memory.getbreakpoints(), pauses: await memory.getpauses(), watchexpressions: await memory.getwatchexpressions(), scriptoverrides: await memory.getscriptoverrides(), debuggergrants: await memory.getdebuggergrants(), pauseretention: runsettings?.pauseretention, breakpointceiling: runsettings?.breakpointceiling, cdpattached: [...activecdpsessions.values()].filter((active) => active.session.detachedat === void 0).length, profileretention: runsettings?.profileretention, traceceiling: runsettings?.traceceiling, profile: profilereport({ flows: await memory.getflowmetrics(), heaps: await memory.getheaprecords(), samples: await memory.getgrowsamples(), trends: await memory.gettrends(), profiles: await memory.getcpuprofiles(), shifts: await memory.getshiftentries(), traces: await memory.gettracerecords(), sourcemaps: await memory.getsourcemaps(), consents: await memory.getsourcemapconsents() }), profileactive: activememorytrackers.size + activeprofiletargets.size, profiletargets: [...activeprofiletargets.values()].flatMap((entry) => entry.targets), socketsactive: activesockets.size, emulation: emulationreport({ ...plan && await loademulationstate(plan.id) !== void 0 ? { state: await loademulationstate(plan.id) } : {}, devices: await memory.getdevicepresets(), networks: await memory.getnetworkpresets(), locations: await memory.getlocationpresets(), agents: await memory.getagentpresets(), blackbox: await memory.getblackboxrules(), permissions: await memory.getpermissionoverrides(), consents: await memory.getlocationconsents() }), emulatedlayers: plan ? layernames(await loademulationstate(plan.id)) : [], emulationretention: runsettings?.emulationretention, traffic, tokens, authflows, activerules: [...activerules.values()].reduce((total, ruleset) => total + ruleset.blocks.filter((rule) => rule.revertedat === void 0).length + ruleset.mocks.filter((rule) => rule.revertedat === void 0).length + ruleset.rewrites.filter((rule) => rule.revertedat === void 0).length + (ruleset.proxy !== void 0 && ruleset.proxy.revertedat === void 0 ? 1 : 0), 0), sessionmemory: sessionreport({ records: sessionrecords, events: await memory.getsessionevents(), folders: await memory.getsessionfolders(), diffs: await memory.getsessiondiffs(), ...autosnapshot !== void 0 ? { auto: autosnapshot.interval } : {}, ...crashed ? { crashed: true } : {} }), autosnapshotstate: autosnapshot, sessionretention: runsettings?.sessionretention, trigger: triggerlist({ rules: await memory.gettriggerules(), workflows: await memory.listworkflows(), queue: await memory.gettriggerqueue() }), triggerretention: runsettings?.triggerretention, workflow: workflowreport({ workflows: await memory.listworkflows(), runs: await memory.listworkflowruns(), templates: await memory.getsteptemplates(), ...newestworkflowrun !== void 0 ? { log: await memory.getrunlog(newestworkflowrun.id), scopes: await memory.getrunscopes(newestworkflowrun.id), provenance: await memory.getworkflowprovenance(newestworkflowrun.id), control: await memory.listcontroldecisions(newestworkflowrun.id) } : {} }), runlogretention: runsettings?.runlogretention, runhistoryretention: runsettings?.runhistoryretention, editor: editorstate({ versions: await memory.listworkflowversions(), diffs: await memory.listversiondiffs(), history: await memory.gethistory(), overrides: await memory.listsiteoverrides(), imports: (await memory.listworkflowimports()).map((entry) => ({ id: entry.id, workflowid: entry.record.id, name: entry.record.name, version: entry.record.version, steps: entry.record.steps.length, risk: entry.record.risk, importedat: entry.importedat, ...entry.filename !== void 0 ? { filename: entry.filename } : {} })), backgroundruns: await memory.getbackgroundruns(), watchdog: { ...runsettings?.watchdog !== void 0 ? { config: runsettings.watchdog } : {}, events: await memory.listwatchdogevents() } }), ...taskstate !== void 0 ? { taskstate } : {}, ...stitchprogress.size > 0 ? { stitchprogress: [...stitchprogress.values()] } : {}, mcp: await mcpstateof() };
     }
     case "capabilities":
       return refreshcapabilities();
@@ -17875,6 +18191,89 @@ async function handlerequest(message, sender) {
       const fires = await memory.listtriggerfires();
       return triggerlist({ rules: await memory.gettriggerules(), workflows: await memory.listworkflows(), queue: await memory.gettriggerqueue() });
     }
+    case "mcpstate": {
+      return mcpstateof();
+    }
+    case "mcpserverconfig": {
+      const inputconfig = message;
+      const current = await mcpconfigof();
+      const transports = Array.isArray(inputconfig.transports) && inputconfig.transports.length > 0 ? [...new Set(inputconfig.transports.filter((transport) => transport === "stdio" || transport === "http"))] : current.transports;
+      const config = {
+        ...inputconfig.bind !== void 0 ? { bind: inputconfig.bind } : current.bind !== void 0 ? { bind: current.bind } : {},
+        port: typeof inputconfig.port === "number" && Number.isFinite(inputconfig.port) && inputconfig.port > 0 && inputconfig.port <= 65535 ? Math.floor(inputconfig.port) : current.port,
+        transports,
+        ...inputconfig.framesize !== void 0 || current.framesize !== void 0 ? { framesize: typeof inputconfig.framesize === "number" ? inputconfig.framesize : current.framesize } : {},
+        ...inputconfig.queuedepth !== void 0 || current.queuedepth !== void 0 ? { queuedepth: typeof inputconfig.queuedepth === "number" ? inputconfig.queuedepth : current.queuedepth } : {},
+        ...inputconfig.callretention !== void 0 || current.callretention !== void 0 ? { callretention: typeof inputconfig.callretention === "number" ? inputconfig.callretention : current.callretention } : {},
+        enabled: inputconfig.enabled === true || inputconfig.enabled === void 0 && current.enabled === true,
+        ...inputconfig.remote === true || inputconfig.remote === void 0 && current.remote === true ? { remote: true } : {}
+      };
+      const bindcheck = serverbindgate(config);
+      if (!bindcheck.allowed) throw new Error(bindcheck.reason ?? "The server bind failed its gate.");
+      await memory.setmcpconfig(config);
+      const binding = bindlocalhost(config);
+      await audit("protocol", `Configured the mcp server for the ${binding.bind} bind on port ${binding.port} with the transports ${config.transports.join(" and ")}${config.framesize !== void 0 ? `, a frame size of ${config.framesize} characters` : " and no frame size cap"}${config.queuedepth !== void 0 ? `, a queue depth of ${config.queuedepth}` : " and an unbounded queue"}; every value stays the user choice and the server ${config.enabled ? "stays enabled" : "stays disabled"}.`, {});
+      return mcpstateof();
+    }
+    case "mcpserverstart": {
+      const config = { ...await mcpconfigof(), enabled: true };
+      const gate = serverenablementgate(config);
+      if (!gate.allowed) throw new Error(gate.reason ?? "The mcp server failed its enablement gate.");
+      await memory.setmcpconfig(config);
+      const binding = bindlocalhost(config);
+      const bridge = await trybridgelaunch(false);
+      await memory.setmcpstate({ state: "running", startedat: Date.now(), ...bridge !== void 0 ? { bridge } : {} });
+      await audit("protocol", `The user started the mcp server on ${binding.bind}:${binding.port} with the tool catalog of ${listtools(buildtoolcatalog()).tools.length} tools across the browser, workflow, memory and system namespaces; the localhost bind stays the default and every client waits for the pairing approval.`, {});
+      return mcpstateof();
+    }
+    case "mcpserverstop": {
+      const clients = await memory.getclients();
+      const now = Date.now();
+      for (const client of clients) {
+        const updated = disconnectclient(clients, client.id, now).find((entry) => entry.id === client.id);
+        if (updated) await memory.setclient(updated);
+      }
+      await memory.setmcpstate({ state: "stopped", stoppedat: now });
+      await audit("protocol", `The user stopped the mcp server; ${clients.length} connected client${clients.length === 1 ? "" : "s"} disconnected and no tool call passes the gates until the next start.`, {});
+      return mcpstateof();
+    }
+    case "mcpclientdecision": {
+      const inputdecision = message;
+      const clientid = inputdecision.clientid ?? "";
+      const clients = await memory.getclients();
+      const client = clients.find((entry) => entry.id === clientid);
+      if (!client || client.disconnectedat !== void 0) throw new Error(`No connected mcp client matches ${clientid}.`);
+      if (typeof inputdecision.approved !== "boolean") throw new Error("The client pairing decision needs the reviewed approved flag.");
+      const updated = inputdecision.approved ? { ...client, paired: true, pairedat: Date.now() } : { ...client, paired: false, disconnectedat: Date.now() };
+      await memory.setclient(updated);
+      await audit("protocol", `The user ${inputdecision.approved ? "approved the pairing of" : "refused and disconnected"} the mcp client ${clientid} on the ${client.transport} transport${inputdecision.approved ? "; its tool calls now pass the same consent gates as the panels" : "; its tool calls stay refused"}.`, {});
+      return mcpstateof();
+    }
+    case "mcpclientdisconnect": {
+      const inputdisconnect = message;
+      const clientid = inputdisconnect.clientid ?? "";
+      const clients = await memory.getclients();
+      const client = clients.find((entry) => entry.id === clientid);
+      if (!client || client.disconnectedat !== void 0) throw new Error(`No connected mcp client matches ${clientid}.`);
+      await memory.setclient({ ...client, disconnectedat: Date.now() });
+      await audit("protocol", `The user disconnected the mcp client ${clientid} on the ${client.transport} transport; its record stays for the audit trail.`, {});
+      return mcpstateof();
+    }
+    case "mcpbridge": {
+      const inputbridge = message;
+      const state = await memory.getmcpstate();
+      if (state?.state !== "running") throw new Error("The stdio bridge restart needs the running mcp server.");
+      const bridge = await trybridgelaunch(true);
+      await memory.setmcpstate({ ...state, ...bridge !== void 0 ? { bridge } : {} });
+      await audit("protocol", bridge !== void 0 ? `The stdio bridge restarted the local client process on demand; the bridge record counts the restart.` : `The stdio bridge restart found no native messaging host because the browser exposes no native messaging permission under the current permission set; the mcp frame grammar and the panel path stay fully available.`, {});
+      return mcpstateof();
+    }
+    case "mcpframe": {
+      const inputframe = message;
+      if (typeof inputframe.raw !== "string" || inputframe.raw.trim() === "") throw new Error("The mcp frame intake needs the raw wire frame.");
+      const transport = inputframe.transport === "http" ? "http" : "stdio";
+      return processmcpframe(inputframe.raw, inputframe.clientid ?? "", transport);
+    }
     case "runtobreakpoint": {
       const inputdebug = message;
       const session = await memory.getsession();
@@ -18238,6 +18637,137 @@ async function restorebackgroundruns() {
     await audit("workflow", `The worker wake restored the background run ${run.id} of the workflow ${record2.name} from its checkpoint at step cursor ${run.cursor}; the session, plan and origin gates re-passed.`, { sessionid: session.id, planid: plan.id });
   }
 }
+async function mcpconfigof() {
+  return await memory.getmcpconfig() ?? defaultmcpconfig();
+}
+async function mcpstateof() {
+  const config = await mcpconfigof();
+  const state = await memory.getmcpstate();
+  const binding = bindlocalhost(config);
+  return { state: state?.state ?? "stopped", config, bind: binding.bind, port: binding.port, localhost: binding.localhost, clients: await memory.listclients(), ...state?.bridge !== void 0 ? { bridge: state.bridge } : {}, calls: (await memory.listtoolcalls()).slice(0, 25), catalog: listtools(buildtoolcatalog()), launches: (await memory.listbridgelaunches()).slice(0, 10) };
+}
+async function executelistruns(step, session) {
+  const options = stepoptions2(step);
+  const statefilter = typeof options.state === "string" && options.state.trim() !== "" ? options.state : void 0;
+  const runs = await memory.listworkflowruns();
+  const selected = statefilter !== void 0 ? runs.filter((run) => run.state === statefilter) : runs;
+  await audit("workflow", `Listed ${selected.length} stored workflow run record${selected.length === 1 ? "" : "s"}${statefilter !== void 0 ? ` of the ${statefilter} state` : ""} from local memory as the read only listruns step; the listing carries no page data.`, { ...session ? { sessionid: session.id } : {}, stepid: step.id });
+  return { ok: true, summary: `Listed ${selected.length} stored workflow run${selected.length === 1 ? "" : "s"} from local memory.`, details: { runs: selected.map((run) => ({ id: run.id, workflowid: run.workflowid, state: run.state, cursor: run.cursor, startedat: run.startedat, ...run.dryrun === true ? { dryrun: true } : {} })) } };
+}
+async function executemcpstep(step) {
+  const session = await memory.getsession();
+  if (!session) throw new Error("No active browser session exists.");
+  const plan = await memory.getplan();
+  const output = await executeaction(step, session, plan, session.tabid, session.origin, await memory.getsettings(), void 0, "plan");
+  return { content: output.summary, ...output.details !== void 0 ? { payload: output.details } : {}, iserror: !output.ok };
+}
+async function trybridgelaunch(restart) {
+  const host = "com.wenathlan.devthink";
+  const runtime = chrome.runtime;
+  try {
+    const port = runtime.connectNative?.(host);
+    if (!port) throw new Error("The browser exposes no native messaging api under the current permission set.");
+    const previous = (await memory.getmcpstate())?.bridge;
+    const bridge = restart && previous !== void 0 ? restartbridgeof(previous) : launchbridge({ host, now: Date.now() });
+    port.onDisconnect.addListener(() => {
+      void (async () => {
+        const state = await memory.getmcpstate();
+        if (state?.bridge !== void 0) await memory.setmcpstate({ ...state, bridge: { ...state.bridge, connected: false } });
+      })().catch(() => {
+      });
+    });
+    port.onMessage.addListener((message) => {
+      if (typeof message !== "string") return;
+      void (async () => {
+        port.postMessage(serializeframe(await relaystdin(message)));
+      })().catch(() => {
+      });
+    });
+    return bridge;
+  } catch {
+    return void 0;
+  }
+}
+function restartbridgeof(bridge) {
+  return { ...bridge, connected: true, restarts: bridge.restarts + 1, startedat: Date.now() };
+}
+async function routemcpframe(client, frame, config) {
+  const session = await memory.getsession();
+  const plan = await memory.getplan();
+  const catalog = buildtoolcatalog();
+  const response = await handleframe({ frame, client, catalog, config, ...session !== void 0 ? { session } : {}, ...plan !== void 0 ? { plan } : {}, origin: session?.origin ?? "", tabid: session?.tabid ?? 0, now: Date.now(), execute: executemcpstep });
+  const now = Date.now();
+  if (frame.method === "initialize") {
+    const clientinfo = frame.params?.clientinfo && typeof frame.params.clientinfo === "object" && !Array.isArray(frame.params.clientinfo) ? frame.params.clientinfo : void 0;
+    const pid = typeof clientinfo?.pid === "number" && Number.isFinite(clientinfo.pid) ? clientinfo.pid : void 0;
+    if (pid !== void 0) {
+      const bridge = (await memory.getmcpstate())?.bridge;
+      await memory.addbridgelaunch({ id: randomid(), host: bridge?.host ?? "com.wenathlan.devthink", pid, restart: false, at: now });
+    }
+    await audit("protocol", `The mcp client ${client.id} completed the initialize handshake${pid !== void 0 ? ` and reported its process id ${pid} for the bridge launch record` : ""}; the server offered protocol version ${String(response.result?.protocolversion ?? "") || "its own"} and the client waits for the pairing approval.`, {});
+  }
+  if (frame.method === "tools/list") await audit("protocol", `The mcp client ${client.id} listed the tool catalog of ${listtools(catalog).tools.length} tools with their json schema inputs; the listing carries no page data.`, {});
+  if (frame.method === "negotiate") {
+    const agreed = response.error === void 0;
+    if (agreed && response.result !== void 0) await memory.setclientcapabilities(client.id, response.result);
+    await audit("protocol", `The mcp client ${client.id} ${agreed ? "negotiated its capability set with the server and the negotiated floor stays stored on its record" : `failed the capability negotiation: ${response.error?.message ?? "the sets did not agree"}`}.`, {});
+  }
+  if (frame.method === "tools/call") {
+    const name = typeof frame.params?.name === "string" ? frame.params.name : "";
+    const code = response.error?.code;
+    const ok = response.error === void 0 && response.result?.iserror !== true;
+    await memory.addtoolcall(toolcallevent({ id: randomid(), clientid: client.id, tool: name, origin: session?.origin ?? "", ok, now, ...code !== void 0 ? { code } : {} }));
+    if (plan !== void 0) {
+      const stepid = typeof frame.params?.stepid === "string" ? frame.params.stepid : "mcp";
+      await memory.setprogress(recordtoolcall(await memory.getprogress(), plan.id, stepid, { clientid: client.id, tool: name, ok, ...code !== void 0 ? { code } : {} }, now));
+    }
+    await audit("tool", `The mcp client ${client.id} called the ${name} tool on ${session?.origin ?? "no origin"} and ${ok ? "it ran behind the consent gates" : `it was refused${code !== void 0 ? ` with the ${code} error` : ""}`}; no payload rides the record.`, {});
+  }
+  return response;
+}
+async function processmcpframe(raw, clientid, transport) {
+  const state = await memory.getmcpstate();
+  if (state?.state !== "running") return { jsonrpc: "2.0", id: null, error: rpcerrorof("consentrefused", "The mcp server is not running and no frame is routed.") };
+  const config = await mcpconfigof();
+  if (!config.transports.includes(transport)) return { jsonrpc: "2.0", id: null, error: rpcerrorof("consentrefused", `The ${transport} transport is not allowed by the server configuration.`) };
+  let frame;
+  try {
+    frame = parseframe(raw);
+  } catch {
+    await audit("protocol", "The mcp server refused a wire frame that does not parse as json; the parse error answered the client.", {});
+    return { jsonrpc: "2.0", id: null, error: rpcerrorof("parse", "The wire frame does not parse as json.") };
+  }
+  let client = (await memory.getclients()).find((entry) => entry.id === clientid && entry.disconnectedat === void 0);
+  if (client === void 0) {
+    client = connectclient({ transport, now: Date.now(), ...clientid !== "" ? { id: clientid } : {} });
+    await memory.setclient(client);
+    await audit("protocol", `A new mcp client ${client.id} connected on the ${transport} transport and waits for the pairing approval; unpaired clients never dispatch tools.`, {});
+  }
+  const previous = mcpclientchains.get(client.id) ?? Promise.resolve();
+  const task = previous.catch(() => void 0).then(async () => await routemcpframe(client, frame, config));
+  mcpclientchains.set(client.id, task);
+  return task;
+}
+async function relaystdin(raw) {
+  const now = Date.now();
+  let state = await memory.getmcpstate();
+  if (state?.bridge !== void 0) {
+    let frame;
+    try {
+      frame = parseframe(raw);
+    } catch {
+      frame = void 0;
+    }
+    if (frame !== void 0) {
+      await memory.setmcpstate({ ...state, bridge: relayframe({ bridge: state.bridge, direction: "inbound", frame, now }) });
+      state = await memory.getmcpstate();
+    }
+  }
+  const response = await processmcpframe(raw, "", "stdio");
+  if (state?.bridge !== void 0) await memory.setmcpstate({ ...state, bridge: relayframe({ bridge: state.bridge, direction: "outbound", frame: response, now: Date.now() }) });
+  return response;
+}
+var mcpclientchains = /* @__PURE__ */ new Map();
 chrome.runtime.onMessage.addListener((message, sender, sendresponse) => {
   handlerequest(message, sender).then((value) => sendresponse({ ok: true, value })).catch((error) => sendresponse({ ok: false, error: error instanceof Error ? error.message : String(error) }));
   return true;