@wenathlan/extension 1.1.55 → 1.1.56

package/extension/dist/background.js

@@ -2510,6 +2510,111 @@ var sessionmemory = class {
   async setstreamchannels(channels) {
     return this.adapter.set("mcpchannels", channels);
   }
+  /** Returns every client event subscription with its kinds and filters, newest first. */
+  async geteventsubscriptions() {
+    return await this.adapter.get("mcpeventsubscriptions") ?? [];
+  }
+  /** Replaces the stored event subscription set after one subscribe, unsubscribe or delivery sweep. */
+  async seteventsubscriptions(subscriptions) {
+    return this.adapter.set("mcpeventsubscriptions", subscriptions);
+  }
+  /** Returns every page state resource watcher with its baseline, newest first. */
+  async getresourcewatches() {
+    return await this.adapter.get("mcpresourcewatches") ?? [];
+  }
+  /** Replaces the stored resource watcher set after one watch, unwatch or delta push. */
+  async setresourcewatches(watches) {
+    return this.adapter.set("mcpresourcewatches", watches);
+  }
+  /** Returns every sampling request with its provenance, newest first. */
+  async getsamplingrequests() {
+    return await this.adapter.get("mcpsampling") ?? [];
+  }
+  /** Replaces the stored sampling request set after one request or answer. */
+  async setsamplingrequests(requests) {
+    return this.adapter.set("mcpsampling", requests);
+  }
+  /** Returns every stored idempotency record for replay, newest first. */
+  async getidempotencyrecords() {
+    return await this.adapter.get("mcpidempotency") ?? [];
+  }
+  /** Replaces the stored idempotency record set after one store or expiry sweep. */
+  async setidempotencyrecords(records) {
+    return this.adapter.set("mcpidempotency", records);
+  }
+  /** Returns every per client rate limit counter with its window and budget. */
+  async getcallratelimits() {
+    return await this.adapter.get("mcpcallratelimits") ?? [];
+  }
+  /** Replaces the stored per client rate limit set after one configuration or counted call. */
+  async setcallratelimits(limits) {
+    return this.adapter.set("mcpcallratelimits", limits);
+  }
+  /** Returns every stored batch call with its per item outcomes, newest first. */
+  async getbatchcalls() {
+    return await this.adapter.get("mcpbatchcalls") ?? [];
+  }
+  /** Upserts one batch call by its id with the per item outcomes riding the record. */
+  async setbatchcall(batch) {
+    await this.adapter.set("mcpbatchcalls", [batch, ...(await this.getbatchcalls()).filter((candidate) => candidate.id !== batch.id)]);
+  }
+  /** Returns every call context of the call runtime, newest first. */
+  async getcallcontexts() {
+    return await this.adapter.get("mcpcallcontexts") ?? [];
+  }
+  /** Replaces the stored call context set after one begin, end or cancellation. */
+  async setcallcontexts(contexts) {
+    return this.adapter.set("mcpcallcontexts", contexts);
+  }
+  /** Returns every stored tool mock for client testing. */
+  async gettoolmocks() {
+    return await this.adapter.get("mcptoolmocks") ?? [];
+  }
+  /** Upserts one tool mock by its tool name or removes it when the canned result is absent. */
+  async settoolmock(mock) {
+    await this.adapter.set("mcptoolmocks", [mock, ...(await this.gettoolmocks()).filter((candidate) => candidate.tool !== mock.tool)]);
+  }
+  /** Removes one tool mock so its tool returns to the real gates. */
+  async removetoolmock(tool) {
+    await this.adapter.set("mcptoolmocks", (await this.gettoolmocks()).filter((candidate) => candidate.tool !== tool));
+  }
+  /** Stores one stream chunk of a progressive tool result under the recent chunk window of 25 records. */
+  async addstreamchunk(chunk) {
+    await this.adapter.set("mcpstreamchunks", [chunk, ...(await this.getstreamchunks()).slice(0, 24)]);
+  }
+  /** Returns the recent stream chunks of progressive tool results, newest first. */
+  async getstreamchunks() {
+    return await this.adapter.get("mcpstreamchunks") ?? [];
+  }
+  /** Replaces the recent stream chunk window after one streaming sweep. */
+  async setstreamchunks(chunks) {
+    return this.adapter.set("mcpstreamchunks", chunks);
+  }
+  /** Returns the audited tool call log under the requested filters: the client, the tool, the outcome, the time floor and the newest bound, all optional. */
+  async getcalllog(filters) {
+    let records = await this.listtoolcalls();
+    if (filters?.clientid !== void 0) records = records.filter((record2) => record2.clientid === filters.clientid);
+    if (filters?.tool !== void 0) records = records.filter((record2) => record2.tool === filters.tool);
+    if (filters?.ok !== void 0) records = records.filter((record2) => record2.ok === filters.ok);
+    if (filters?.since !== void 0) records = records.filter((record2) => record2.at >= (filters.since ?? 0));
+    return filters?.limit !== void 0 ? records.slice(0, filters.limit) : records;
+  }
+  /** Stores one progress notice of a long tool call under the recent notice window of 25 records. */
+  async addprogressnotice(notice) {
+    await this.adapter.set("mcpprogressnotices", [notice, ...(await this.getprogressnotices()).slice(0, 24)]);
+  }
+  /** Returns the recent progress notices of long tool calls, newest first. */
+  async getprogressnotices() {
+    return await this.adapter.get("mcpprogressnotices") ?? [];
+  }
+  /** Returns the tool dry run toggle of the next call: true once the user armed the dry run in the panel. */
+  async getdryruntoggle() {
+    return await this.adapter.get("mcpdryruntoggle") === true;
+  }
+  /** Arms or disarms the tool dry run of the next call. */
+  async setdryruntoggle(enabled) {
+    return this.adapter.set("mcpdryruntoggle", enabled);
+  }
 };
 function mediakindof(record2) {
   if ("pages" in record2) return "pdf";
@@ -8417,6 +8522,30 @@ function approvaltimeoutvalid(timeout) {
 function revocationgate() {
   return { allowed: true };
 }
+function subscriptiongrade(subscription) {
+  if (!Array.isArray(subscription.kinds) || subscription.kinds.length === 0) return { allowed: false, reason: "An event subscription needs at least one protocol event kind." };
+  if (subscription.kinds.includes("callstarted") && subscription.origin === void 0 && subscription.tool === void 0) return { allowed: false, reason: "An event subscription that mirrors the callstarted events of tools with side effects needs its origin or tool filter so it never widens what the session grants." };
+  return { allowed: true };
+}
+function callratelimitvalid(limit) {
+  if (limit === void 0) return { allowed: true };
+  if (typeof limit.windowms !== "number" || !Number.isFinite(limit.windowms) || limit.windowms <= 0) return { allowed: false, reason: "The rate limit window must stay a positive user value with no code ceiling." };
+  if (limit.budget !== void 0 && (typeof limit.budget !== "number" || !Number.isFinite(limit.budget) || limit.budget <= 0)) return { allowed: false, reason: "The rate limit budget must stay a positive user value with no code ceiling." };
+  if (limit.clientid.trim() === "") return { allowed: false, reason: "A per client rate limit needs the client it counts." };
+  return { allowed: true };
+}
+function batchgrade(input) {
+  if (input.calls.length === 0) return { allowed: false, reason: "A batch call needs at least one ordered tool call." };
+  const sensitive = input.calls.some((call) => call.risk === "sensitive");
+  if (sensitive && !input.approved) return { allowed: false, reason: "The batch grades sensitive through its most sensitive member and runs only behind the approval gates." };
+  return { allowed: true };
+}
+function mockusagevalid(mock) {
+  if (mock.testcontext !== true) return { allowed: false, reason: `The ${mock.tool} mock stays outside a test context and is refused; tool mocks never answer real calls.` };
+  if (mock.tool.trim() === "") return { allowed: false, reason: "A tool mock needs the namespaced tool it stands in for." };
+  if (typeof mock.result.content !== "string") return { allowed: false, reason: "A tool mock needs its canned result content." };
+  return { allowed: true };
+}
 
 // progress.ts
 function emptyprogress(planid, now) {
@@ -8596,7 +8725,7 @@ function recordtoolcall(progress, planid, stepid, entry, now) {
 }
 
 // version.ts
-var packageversion = "1.1.55";
+var packageversion = "1.1.56";
 
 // types.ts
 var protocolversion = packageversion;
@@ -8665,6 +8794,128 @@ function tlsstateof(tls) {
   return { mode: tls.mode, certificaterequired: tls.mode === "required" || tls.certificatefingerprint !== void 0, verified: tls.verifiedat !== void 0 };
 }
 
+// agentstream.ts
+var protocoleventkinds = ["callstarted", "callresult", "streamchunk", "progress", "resourcedelta", "sampling", "cancellation"];
+var readonlyeventkinds = ["callresult", "streamchunk", "progress", "resourcedelta", "sampling", "cancellation"];
+function subscriberegister(input) {
+  if (input.clientid.trim() === "") return { reason: "The event subscription needs the paired client it belongs to." };
+  const kinds = input.kinds === void 0 || input.kinds.length === 0 ? [...readonlyeventkinds] : [...new Set(input.kinds)];
+  for (const kind of kinds) {
+    if (!protocoleventkinds.includes(kind)) return { reason: `The event kind ${kind} is not a protocol event kind.` };
+  }
+  if (input.origin !== void 0 && input.origin.trim() === "") return { reason: "The origin filter of an event subscription must name an origin or stay absent." };
+  if (input.tool !== void 0 && input.tool.trim() === "") return { reason: "The tool filter of an event subscription must name a tool or stay absent." };
+  return { subscription: { id: input.id ?? randomid(), clientid: input.clientid, kinds, ...input.origin !== void 0 ? { origin: input.origin } : {}, ...input.tool !== void 0 ? { tool: input.tool } : {}, createdat: input.now } };
+}
+function unsubscriberegister(subscriptions, id, now) {
+  return subscriptions.map((subscription) => subscription.id === id && subscription.canceledat === void 0 ? { ...subscription, canceledat: now } : subscription);
+}
+function notifyevent(input) {
+  const deliveries = [];
+  const subscriptions = input.subscriptions.map((subscription) => {
+    if (subscription.canceledat !== void 0) return subscription;
+    if (!subscription.kinds.includes(input.kind)) return subscription;
+    if (subscription.origin !== void 0 && input.origin !== void 0 && subscription.origin !== input.origin) return subscription;
+    if (subscription.tool !== void 0 && input.tool !== void 0 && subscription.tool !== input.tool) return subscription;
+    deliveries.push({ subscriptionid: subscription.id, clientid: subscription.clientid, frame: { jsonrpc: "2.0", method: "events/notify", params: { subscriptionid: subscription.id, kind: input.kind, ...input.origin !== void 0 ? { origin: input.origin } : {}, ...input.tool !== void 0 ? { tool: input.tool } : {}, ...input.payload !== void 0 ? { payload: input.payload } : {}, at: input.now } } });
+    return { ...subscription, lastdeliveredat: input.now };
+  });
+  return { deliveries, subscriptions };
+}
+function watchresource(input) {
+  if (input.clientid.trim() === "") return { reason: "The resource watcher needs the paired client it belongs to." };
+  if (input.resource.trim() === "") return { reason: "The resource watcher needs the page state resource it watches." };
+  return { watch: { id: input.id ?? randomid(), clientid: input.clientid, resource: input.resource, baseline: input.state ?? {}, createdat: input.now } };
+}
+function unwatchresource(watches, id, now) {
+  return watches.map((watch) => watch.id === id && watch.canceledat === void 0 ? { ...watch, canceledat: now } : watch);
+}
+function notifyresource(input) {
+  const deliveries = [];
+  const watches = input.watches.map((watch) => {
+    if (watch.canceledat !== void 0 || watch.resource !== input.resource) return watch;
+    const delta = {};
+    for (const [key, value] of Object.entries(input.state)) {
+      if (!(key in watch.baseline) || watch.baseline[key] !== value) delta[key] = value;
+    }
+    if (Object.keys(delta).length === 0) return watch;
+    deliveries.push({ watchid: watch.id, clientid: watch.clientid, delta });
+    return { ...watch, baseline: { ...input.state }, lastdeliveredat: input.now };
+  });
+  return { deliveries, watches };
+}
+function requestsampling(input) {
+  if (input.clientid.trim() === "") return { reason: "The sampling callback needs the paired client it addresses." };
+  if (input.prompt.trim() === "") return { reason: "The sampling callback needs its prompt." };
+  if (input.capabilities?.sampling === false) return { reason: "The client declared no sampling capability and the callback is refused." };
+  if (input.maxtokens !== void 0 && (!Number.isFinite(input.maxtokens) || input.maxtokens <= 0)) return { reason: "The granted maximum tokens of a sampling callback must stay a positive user value." };
+  const granted = input.pagegrant === true;
+  const pagecontent = granted ? input.pagecontent : void 0;
+  const prompt = granted || input.pagecontent === void 0 ? input.prompt : `${input.prompt}
+The page content stays stripped because the user granted none.`;
+  return { request: { id: input.id ?? randomid(), clientid: input.clientid, prompt, ...input.system !== void 0 ? { system: input.system } : {}, ...pagecontent !== void 0 ? { pagecontent } : {}, ...input.maxtokens !== void 0 ? { maxtokens: input.maxtokens } : {}, state: "pending", requestedat: input.now } };
+}
+function answersampling(input) {
+  const match = input.requests.find((request2) => request2.id === input.id);
+  if (match === void 0) return { requests: input.requests, reason: "The sampling answer names no stored request." };
+  if (match.state !== "pending") return { requests: input.requests, reason: "The sampling request already closed its round trip." };
+  const request = { ...match, state: input.refused === true ? "refused" : "answered", answeredat: input.now, ...input.refused !== true && input.answer !== void 0 ? { answer: input.answer } : {} };
+  return { requests: input.requests.map((candidate) => candidate.id === input.id ? request : candidate), request };
+}
+function listprompts() {
+  return [
+    { name: "runreview", description: "Renders the run review prompt that asks the user model to summarize the executed steps of the approved plan behind the consent gates.", arguments: [{ name: "objective", description: "The objective of the approved plan under review.", required: true }, { name: "steps", description: "The executed step summaries the review covers.", required: true }, { name: "tone", description: "The tone of the summary.", default: "plain" }], template: "Review the run of the objective {{objective}}. Summarize the executed steps: {{steps}}. Keep the tone {{tone}} and state every refusal the consent gates raised." },
+    { name: "pagesummary", description: "Renders the page summary prompt that condenses the observed page state of the session tab into the summary the client model asked for.", arguments: [{ name: "url", description: "The url of the observed page.", required: true }, { name: "observations", description: "The observed page state sections the summary condenses.", required: true }], template: "Summarize the page at {{url}} from the observations: {{observations}}. Name nothing the observations leave out." },
+    { name: "failuretriage", description: "Renders the failure triage prompt that classifies a failed tool call through the retry hints of the structured error it produced.", arguments: [{ name: "tool", description: "The namespaced tool that failed.", required: true }, { name: "error", description: "The structured error of the failed call.", required: true }], template: "Triage the failure of the {{tool}} tool: {{error}}. Classify it as retryable, a busy window or a consent refusal and propose the next reviewed step." }
+  ];
+}
+function renderprompt(prompt, args) {
+  return prompt.template.replace(/\{\{\s*([a-z0-9]+)\s*\}\}/g, (whole, name) => {
+    const value = args[name];
+    if (value === void 0 || value === null) return whole;
+    return typeof value === "string" ? value : JSON.stringify(value);
+  });
+}
+function callprompt(input) {
+  const prompt = listprompts().find((candidate) => candidate.name === input.name);
+  if (prompt === void 0) return { reason: `The server exposes no prompt named ${input.name}.` };
+  const args = input.args ?? {};
+  const findings = [];
+  const resolved = {};
+  for (const argument of prompt.arguments) {
+    const value = args[argument.name];
+    if (value === void 0 || value === null || typeof value === "string" && value.trim() === "") {
+      if (argument.default !== void 0) resolved[argument.name] = argument.default;
+      else if (argument.required === true) findings.push(`The prompt argument ${argument.name} is required and stays empty.`);
+      else resolved[argument.name] = "";
+    } else {
+      resolved[argument.name] = value;
+    }
+  }
+  if (findings.length > 0) return { reason: findings.join(" ") };
+  return { rendered: renderprompt(prompt, resolved), toolcall: { name: `prompts.${prompt.name}`, params: { prompt: prompt.name, arguments: resolved, rendered: renderprompt(prompt, resolved) } } };
+}
+function streamchunkof(input) {
+  return { callid: input.callid, seq: input.seq, content: input.content, done: input.done === true, at: input.now };
+}
+function chunkcontent(input) {
+  const size = input.size !== void 0 && Number.isFinite(input.size) && input.size > 0 ? Math.floor(input.size) : 80;
+  const parts = [];
+  for (let index = 0; index < input.content.length; index += size) parts.push(input.content.slice(index, index + size));
+  const slices = parts.length > 0 ? parts : [""];
+  return slices.map((content, index) => streamchunkof({ callid: input.callid, seq: index + 1, content, done: index === slices.length - 1, now: input.now + index }));
+}
+function notifyprogress(input) {
+  return { callid: input.callid, ...input.percent !== void 0 ? { percent: input.percent } : {}, message: input.message, cancellable: input.cancellable !== false, at: input.now };
+}
+function canceltool(input) {
+  const match = input.contexts.find((context2) => context2.callid === input.callid);
+  if (match === void 0) return { contexts: input.contexts, reason: `The cancellation frame names no call context ${input.callid}.` };
+  if (match.state !== "inflight") return { contexts: input.contexts, reason: `The call ${input.callid} already left the in flight state.` };
+  const context = { ...match, state: "cancelled", endedat: input.now, ...input.partial !== void 0 ? { partial: input.partial } : {} };
+  return { contexts: input.contexts.map((candidate) => candidate.callid === input.callid ? context : candidate), context };
+}
+
 // mcpserver.ts
 var localhostbind = "127.0.0.1";
 var defaultmcpport = 7436;
@@ -8707,7 +8958,10 @@ function servermethods() {
     { 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." }
+    { method: "tools/call", handler: "dispatch", description: "Invokes one tool behind the consent gates." },
+    { method: "prompts/list", handler: "listprompts", description: "Lists the prompt defs the server exposes as callable tools." },
+    { method: "prompts/call", handler: "callprompt", description: "Renders one prompt and returns its arguments as a tool call." },
+    { method: "calls/cancel", handler: "cancel", description: "Aborts one in flight tool call and preserves its partial result." }
   ];
 }
 function servercapabilities(input) {
@@ -8792,6 +9046,22 @@ async function handleframe(input) {
     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.") } });
   }
+  if (entry.handler === "listprompts") return respond({ ...frame.id !== void 0 ? { id: frame.id } : {}, result: { prompts: listprompts() } });
+  if (entry.handler === "callprompt") {
+    const name = typeof params?.name === "string" ? params.name : "";
+    const args = params?.arguments && typeof params.arguments === "object" && !Array.isArray(params.arguments) ? params.arguments : void 0;
+    const called = name === "" ? { reason: "The prompt call needs the prompt name." } : callprompt({ name, ...args !== void 0 ? { args } : {} });
+    if (called.toolcall === void 0) return respond({ ...frame.id !== void 0 ? { id: frame.id } : {}, error: rpcerrorof("params", called.reason ?? "The prompt call did not render.") });
+    return respond({ ...frame.id !== void 0 ? { id: frame.id } : {}, result: { toolcall: called.toolcall, rendered: called.rendered } });
+  }
+  if (entry.handler === "cancel") {
+    const callid = typeof params?.callid === "string" ? params.callid : "";
+    const reason = typeof params?.reason === "string" ? params.reason : void 0;
+    if (callid.trim() === "") return respond({ ...frame.id !== void 0 ? { id: frame.id } : {}, error: rpcerrorof("params", "The cancellation frame needs the call id it aborts.") });
+    const aborted = canceltool({ contexts: input.contexts ?? [], callid, ...reason !== void 0 ? { reason } : {}, now: input.now });
+    if (aborted.context === void 0) return respond({ ...frame.id !== void 0 ? { id: frame.id } : {}, error: rpcerrorof("params", aborted.reason ?? "The cancellation frame named no in flight tool call.") });
+    return respond({ ...frame.id !== void 0 ? { id: frame.id } : {}, result: { cancelled: true, callid, ...reason !== void 0 ? { reason } : {}, ...aborted.context.partial !== void 0 ? { partial: aborted.context.partial } : {} } });
+  }
   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 } : {}, ...input.scopes !== void 0 ? { scopes: input.scopes } : {}, 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 } });
 }
@@ -8806,7 +9076,7 @@ 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 };
+  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, ...input.callid !== void 0 ? { callid: input.callid } : {}, ...input.idempotencykey !== void 0 && input.idempotencykey.trim() !== "" ? { idempotencykey: input.idempotencykey } : {}, ...input.dryrun === true ? { dryrun: true } : {}, ...input.mocked === true ? { mocked: true } : {}, ...input.batchid !== void 0 ? { batchid: input.batchid } : {}, ...input.replayed === true ? { replayed: true } : {} };
 }
 
 // httpstream.ts
@@ -10477,6 +10747,90 @@ function yamlscalarvalue(text2) {
   return text2;
 }
 
+// toolcalls.ts
+var defaultidempotencywindowms = 3e5;
+function applyratelimit(input) {
+  const existing = input.limits.find((limit2) => limit2.clientid === input.clientid);
+  if (existing === void 0) return { allowed: true, used: 0, limits: input.limits };
+  const elapsed = input.now - existing.windowstartedat;
+  const limit = elapsed >= existing.windowms ? { ...existing, windowstartedat: input.now, used: 0 } : existing;
+  if (limit.budget !== void 0 && limit.used >= limit.budget) {
+    const retryafter = Math.max(0, limit.windowms - (input.now - limit.windowstartedat));
+    return { allowed: false, used: limit.used, budget: limit.budget, retryafter, limits: input.limits.map((candidate) => candidate.clientid === input.clientid ? limit : candidate) };
+  }
+  const counted = { ...limit, used: limit.used + 1 };
+  return { allowed: true, used: counted.used, ...counted.budget !== void 0 ? { budget: counted.budget } : {}, limit: counted, limits: input.limits.map((candidate) => candidate.clientid === input.clientid ? counted : candidate) };
+}
+function structurederrorof(input) {
+  return { code: input.code, message: input.message, retryhint: input.retryhint, ...input.retryafter !== void 0 ? { retryafter: input.retryafter } : {} };
+}
+function retryhintof(failure) {
+  const text2 = `${failure.code ?? ""} ${failure.message ?? ""}`.toLowerCase();
+  if (text2.includes("consent") || text2.includes("refus") || text2.includes("unpaired") || text2.includes("unapproved") || text2.includes("grant")) return "none";
+  if (text2.includes("rate") || text2.includes("busy") || text2.includes("queue") || text2.includes("window")) return "wait";
+  if (text2.includes("timeout") || text2.includes("timed out") || text2.includes("internal") || text2.includes("network")) return "retry";
+  return "none";
+}
+function checkidempotency(input) {
+  const match = input.records.find((record2) => record2.key === input.key);
+  if (match === void 0) return { reason: "The idempotency key names no stored record." };
+  if (match.clientid !== input.clientid) return { reason: "The idempotency key belongs to another client and never replays across clients." };
+  if (input.now >= match.expiresat) return { reason: "The idempotency record expired past its window and the call runs again." };
+  return { replay: match.result, record: match };
+}
+function recordidempotency(input) {
+  const record2 = { key: input.key, clientid: input.clientid, tool: input.tool, result: input.result, createdat: input.now, expiresat: input.now + (input.window ?? defaultidempotencywindowms) };
+  return [record2, ...input.records.filter((candidate) => !(candidate.key === input.key && candidate.clientid === input.clientid))];
+}
+function expireidempotency(records, now) {
+  return records.filter((record2) => now < record2.expiresat);
+}
+async function runbatch(input) {
+  const outcomes = [];
+  for (let index = 0; index < input.calls.length; index += 1) {
+    const call = input.calls[index];
+    if (call === void 0) continue;
+    const outcome = await input.execute(call, index);
+    outcomes.push({ callid: call.id, tool: call.name, ok: outcome.ok, ...outcome.result !== void 0 ? { result: outcome.result } : {}, ...outcome.error !== void 0 ? { error: outcome.error } : {}, at: input.now + index });
+    if (!outcome.ok && input.stoponerror) return { outcomes, stoppedat: call.id };
+  }
+  return { outcomes };
+}
+function dryruntool(input) {
+  const findings = [];
+  for (const required of input.tool.inputschema.required) {
+    const value = input.params[required];
+    if (value === void 0 || value === null || typeof value === "string" && value.trim() === "") findings.push(`The required argument ${required} of ${input.tool.name} stays empty.`);
+  }
+  for (const [name, property] of Object.entries(input.tool.inputschema.properties)) {
+    const value = input.params[name];
+    if (value === void 0 || value === null) continue;
+    const expected = property.type;
+    const actual = Array.isArray(value) ? "array" : typeof value;
+    if (actual !== expected) findings.push(`The argument ${name} of ${input.tool.name} carries a ${actual} value where the schema asks a ${expected}.`);
+  }
+  const stepid = input.stepid !== void 0 ? input.stepid : typeof input.params.stepid === "string" ? input.params.stepid : void 0;
+  const gate = tooldispatchgate({ client: input.client, tool: input.tool, session: input.session, plan: input.plan, origin: input.origin, ...stepid !== void 0 ? { stepid } : {}, now: input.now });
+  if (!gate.allowed) findings.push(gate.reason ?? `The consent gates refused the ${input.tool.name} dry run.`);
+  return { callid: input.callid ?? randomid(), tool: input.tool.name, argsvalid: findings.length === 0, consentok: gate.allowed, findings, executed: false, mutations: [], at: input.now };
+}
+function applymock(input) {
+  const mock = input.mocks.find((candidate) => candidate.tool === input.tool);
+  if (mock === void 0) return {};
+  if (mock.testcontext !== true) return { reason: `The ${input.tool} mock stays outside a test context and is refused; mocks never answer real calls.` };
+  return { result: mock.result };
+}
+function begincall(input) {
+  return { callid: input.callid ?? randomid(), clientid: input.clientid, tool: input.tool, state: "inflight", startedat: input.now, ...input.idempotencykey !== void 0 && input.idempotencykey.trim() !== "" ? { idempotencykey: input.idempotencykey } : {}, ...input.dryrun === true ? { dryrun: true } : {}, ...input.batchid !== void 0 ? { batchid: input.batchid } : {}, chunks: 0 };
+}
+function endcall(input) {
+  const match = input.contexts.find((context2) => context2.callid === input.callid);
+  if (match === void 0) return { contexts: input.contexts, reason: `The call context ${input.callid} never opened.` };
+  if (match.state !== "inflight") return { contexts: input.contexts, context: match };
+  const context = { ...match, state: input.ok ? "done" : "failed", endedat: input.now, ...input.errorcode !== void 0 ? { errorcode: input.errorcode } : {}, ...input.partial !== void 0 ? { partial: input.partial } : {} };
+  return { contexts: input.contexts.map((candidate) => candidate.callid === input.callid ? context : candidate), context };
+}
+
 // extension/pagesession.ts
 function capturepagestate(sections) {
   const wants = (section) => sections.includes(section);
@@ -18690,6 +19044,122 @@ async function handlerequest(message, sender) {
       }
       return mcpstateof();
     }
+    case "mcpsubscribe": {
+      const inputsub = message;
+      const clientid = inputsub.clientid?.trim() ?? "";
+      if (clientid === "") throw new Error("The event subscription needs the paired client.");
+      const now = Date.now();
+      if (inputsub.unsubscribe === true) {
+        const subscriptionid = inputsub.subscriptionid?.trim() ?? "";
+        if (subscriptionid === "") throw new Error("The unsubscribe needs the subscription id.");
+        await memory.seteventsubscriptions(unsubscriberegister(await memory.geteventsubscriptions(), subscriptionid, now));
+        await audit("protocol", `The user cancelled the event subscription ${subscriptionid} of the client ${clientid}; the record stays for the audit trail.`, {});
+        return mcpstateof();
+      }
+      const registered = subscriberegister({ clientid, ...Array.isArray(inputsub.kinds) ? { kinds: inputsub.kinds } : {}, ...inputsub.origin !== void 0 && inputsub.origin.trim() !== "" ? { origin: inputsub.origin.trim() } : {}, ...inputsub.tool !== void 0 && inputsub.tool.trim() !== "" ? { tool: inputsub.tool.trim() } : {}, now });
+      if (registered.subscription === void 0) throw new Error(registered.reason ?? "The event subscription did not register.");
+      const grade = subscriptiongrade(registered.subscription);
+      if (!grade.allowed) throw new Error(grade.reason ?? "The event subscription failed its gate.");
+      await memory.seteventsubscriptions([registered.subscription, ...await memory.geteventsubscriptions()]);
+      await audit("protocol", `The user subscribed the client ${clientid} to the ${registered.subscription.kinds.join(", ")} event kinds${registered.subscription.origin !== void 0 ? ` of the origin ${registered.subscription.origin}` : ""}${registered.subscription.tool !== void 0 ? ` for the tool ${registered.subscription.tool}` : ""}.`, {});
+      return mcpstateof();
+    }
+    case "mcpresource": {
+      const inputwatch = message;
+      const clientid = inputwatch.clientid?.trim() ?? "";
+      if (clientid === "") throw new Error("The resource watcher needs the paired client.");
+      const now = Date.now();
+      if (inputwatch.unwatch === true) {
+        const watchid = inputwatch.watchid?.trim() ?? "";
+        if (watchid === "") throw new Error("The unwatch needs the watcher id.");
+        await memory.setresourcewatches(unwatchresource(await memory.getresourcewatches(), watchid, now));
+        await audit("protocol", `The user cancelled the resource watcher ${watchid} of the client ${clientid}; the record stays for the audit trail.`, {});
+        return mcpstateof();
+      }
+      const watched = watchresource({ clientid, resource: inputwatch.resource?.trim() ?? "", ...inputwatch.state !== void 0 ? { state: inputwatch.state } : {}, now });
+      if (watched.watch === void 0) throw new Error(watched.reason ?? "The resource watcher did not start.");
+      await memory.setresourcewatches([watched.watch, ...await memory.getresourcewatches()]);
+      await audit("protocol", `The user started the ${watched.watch.resource} resource watcher for the client ${clientid} with its page state baseline; the deltas compare against it.`, {});
+      return mcpstateof();
+    }
+    case "mcpsampling": {
+      const inputsample = message;
+      const now = Date.now();
+      if (inputsample.respond === true) {
+        const samplingid = inputsample.samplingid?.trim() ?? "";
+        if (samplingid === "") throw new Error("The sampling answer needs the request id.");
+        const outcome = answersampling({ requests: await memory.getsamplingrequests(), id: samplingid, ...inputsample.answer !== void 0 ? { answer: inputsample.answer } : {}, ...inputsample.refused === true ? { refused: true } : {}, now });
+        if (outcome.request === void 0) throw new Error(outcome.reason ?? "The sampling answer closed no request.");
+        await memory.setsamplingrequests(outcome.requests);
+        await audit("protocol", `The sampling callback ${samplingid} of the client ${outcome.request.clientid} closed its round trip with the client answer; the provenance times ride the record.`, {});
+        return mcpstateof();
+      }
+      const clientid = inputsample.clientid?.trim() ?? "";
+      if (clientid === "") throw new Error("The sampling callback needs the paired client it addresses.");
+      const client = (await memory.getclients()).find((entry) => entry.id === clientid);
+      const requested = requestsampling({ clientid, ...client?.capabilities !== void 0 ? { capabilities: client.capabilities } : {}, prompt: inputsample.prompt ?? "", ...inputsample.system !== void 0 ? { system: inputsample.system } : {}, ...inputsample.pagecontent !== void 0 ? { pagecontent: inputsample.pagecontent } : {}, pagegrant: inputsample.pagegrant === true, ...inputsample.maxtokens !== void 0 ? { maxtokens: inputsample.maxtokens } : {}, now });
+      if (requested.request === void 0) throw new Error(requested.reason ?? "The sampling callback was refused.");
+      await memory.setsamplingrequests([requested.request, ...await memory.getsamplingrequests()]);
+      await audit("protocol", `The user sent one sampling callback to the client ${clientid}: the prompt leaves the browser${requested.request.pagecontent !== void 0 ? " with the page content the user granted" : " with the page content stripped because the user granted none"}, and the exact payload rides the panel.`, {});
+      return mcpstateof();
+    }
+    case "mcpcancelcall": {
+      const inputcancel = message;
+      const callid = inputcancel.callid?.trim() ?? "";
+      if (callid === "") throw new Error("The cancellation needs the call id.");
+      const now = Date.now();
+      const contexts = await memory.getcallcontexts();
+      const chunks = (await memory.getstreamchunks()).filter((chunk) => chunk.callid === callid);
+      const partial = chunks.length > 0 ? { content: chunks.map((chunk) => chunk.content).join(""), iserror: false } : void 0;
+      const aborted = canceltool({ contexts, callid, ...inputcancel.reason !== void 0 ? { reason: inputcancel.reason } : {}, ...partial !== void 0 ? { partial } : {}, now });
+      if (aborted.context === void 0) throw new Error(aborted.reason ?? "The cancellation named no in flight call.");
+      await memory.setcallcontexts(aborted.contexts);
+      await audit("protocol", `The user cancelled the in flight ${aborted.context.tool} call ${callid}${partial !== void 0 ? " with its partial result preserved" : ""}; the cooperative flag stops the page executor and the workflow engine keeps its own pause machinery.`, {});
+      return mcpstateof();
+    }
+    case "mcpmock": {
+      const inputmock = message;
+      const toolname = inputmock.tool?.trim() ?? "";
+      if (toolname === "") throw new Error("The tool mock needs the namespaced tool it stands in for.");
+      const now = Date.now();
+      if (inputmock.remove === true) {
+        await memory.removetoolmock(toolname);
+        await audit("protocol", `The user removed the ${toolname} tool mock; the tool returns to the real gates.`, {});
+        return mcpstateof();
+      }
+      if (resolvetool(buildtoolcatalog(), toolname) === void 0) throw new Error(`The catalog holds no unambiguous tool named ${toolname}.`);
+      const mock = { tool: toolname, result: { content: inputmock.content ?? `The ${toolname} mock answered from the test context.`, iserror: false }, testcontext: true, createdat: now };
+      const valid = mockusagevalid(mock);
+      if (!valid.allowed) throw new Error(valid.reason ?? "The tool mock failed its validation.");
+      await memory.settoolmock(mock);
+      await audit("protocol", `The user registered the ${toolname} tool mock of a test context; mocks answer with canned results and never touch the browser.`, {});
+      return mcpstateof();
+    }
+    case "mcpratelimit": {
+      const inputlimit = message;
+      const clientid = inputlimit.clientid?.trim() ?? "";
+      if (clientid === "") throw new Error("The per client rate limit needs the client it counts.");
+      const now = Date.now();
+      const limits = (await memory.getcallratelimits()).filter((limit2) => limit2.clientid !== clientid);
+      if (inputlimit.remove === true) {
+        await memory.setcallratelimits(limits);
+        await audit("protocol", `The user removed the rate limit of the client ${clientid}; the client stays unbounded because no silent default applies.`, {});
+        return mcpstateof();
+      }
+      const limit = { clientid, windowms: inputlimit.windowms ?? 6e4, ...inputlimit.budget !== void 0 ? { budget: inputlimit.budget } : {}, windowstartedat: now, used: 0 };
+      const valid = callratelimitvalid(limit);
+      if (!valid.allowed) throw new Error(valid.reason ?? "The rate limit failed its validation.");
+      await memory.setcallratelimits([limit, ...limits]);
+      await audit("protocol", `The user limited the client ${clientid} to ${limit.budget !== void 0 ? `${limit.budget} call${limit.budget === 1 ? "" : "s"} per ${limit.windowms} millisecond window` : `a ${limit.windowms} millisecond window with no call budget`}; every value stays the user choice.`, {});
+      return mcpstateof();
+    }
+    case "mcpdryrun": {
+      const inputdry = message;
+      const enabled = inputdry.enabled === true;
+      await memory.setdryruntoggle(enabled);
+      await audit("protocol", `The user ${enabled ? "armed the tool dry run of the next call: it evaluates arguments and consent with no side effects" : "disarmed the tool dry run; the next call executes behind the gates"}.`, {});
+      return mcpstateof();
+    }
     case "runtobreakpoint": {
       const inputdebug = message;
       const session = await memory.getsession();
@@ -19067,7 +19537,23 @@ async function mcpstateof() {
   const channels = closeidlechannels({ channels: await memory.getstreamchannels(), now, ...config.httpstream?.idlewindowms !== void 0 ? { idlewindow: config.httpstream.idlewindowms } : {} });
   await memory.setstreamchannels(channels);
   const streamstatus = listremotestatus;
-  return { state: state?.state ?? "stopped", config, bind: binding.bind, port: binding.port, localhost: binding.localhost, clients, ...state?.bridge !== void 0 ? { bridge: state.bridge } : {}, calls: (await memory.listtoolcalls()).slice(0, 25), catalog: listtools(buildtoolcatalog()), launches: (await memory.listbridgelaunches()).slice(0, 10), remote: streamstatus({ config, channels, clients, tokens, now }), pairing: (await memory.getpairingcodes()).filter((code) => code.usedat === void 0 && now < code.expiresat), allowlist: await memory.getallowlist(), tokens, identities: await memory.getclientidentities(), handshakes: (await memory.listauthhandshakes()).slice(0, 10), channels, approvals: await memory.listapprovals() };
+  const watches = await pushresourcestate(now);
+  const contexts = await memory.getcallcontexts();
+  const dryruntoggle = await memory.getdryruntoggle();
+  return { state: state?.state ?? "stopped", config, bind: binding.bind, port: binding.port, localhost: binding.localhost, clients, ...state?.bridge !== void 0 ? { bridge: state.bridge } : {}, calls: (await memory.listtoolcalls()).slice(0, 25), calllog: await memory.getcalllog({ limit: 25 }), catalog: listtools(buildtoolcatalog()), launches: (await memory.listbridgelaunches()).slice(0, 10), remote: streamstatus({ config, channels, clients, tokens, now }), pairing: (await memory.getpairingcodes()).filter((code) => code.usedat === void 0 && now < code.expiresat), allowlist: await memory.getallowlist(), tokens, identities: await memory.getclientidentities(), handshakes: (await memory.listauthhandshakes()).slice(0, 10), channels, approvals: await memory.listapprovals(), subscriptions: (await memory.geteventsubscriptions()).filter((subscription) => subscription.canceledat === void 0), watches: watches.filter((watch) => watch.canceledat === void 0), sampling: (await memory.getsamplingrequests()).slice(0, 10), limits: await memory.getcallratelimits(), contexts: contexts.slice(0, 25), inflight: contexts.filter((context) => context.state === "inflight"), batches: (await memory.getbatchcalls()).slice(0, 10), chunks: (await memory.getstreamchunks()).slice(0, 25), progressnotices: (await memory.getprogressnotices()).slice(0, 25), mocks: await memory.gettoolmocks(), dryruntoggle, idempotency: expireidempotency(await memory.getidempotencyrecords(), now) };
+}
+async function pushresourcestate(now) {
+  const watches = await memory.getresourcewatches();
+  const active = watches.filter((watch) => watch.canceledat === void 0);
+  if (active.length === 0) return watches;
+  const session = await memory.getsession();
+  const state = { origin: session?.origin ?? "", mutations: (await memory.getmutationevents()).length, diffs: (await memory.getdiffs()).length };
+  const pushed = notifyresource({ watches, resource: "page", state, now });
+  if (pushed.deliveries.length > 0) {
+    await memory.setresourcewatches(pushed.watches);
+    await audit("protocol", `${pushed.deliveries.length} page state delta${pushed.deliveries.length === 1 ? "" : "s"} reached the resource watcher${pushed.deliveries.length === 1 ? "" : "s"} of ${[...new Set(pushed.deliveries.map((delivery) => delivery.clientid))].join(", ")}; the baselines absorbed the new page state.`, {});
+  }
+  return pushed.watches;
 }
 async function mcpmaintenance(now) {
   const tokens = await memory.getsessiontokens();
@@ -19076,6 +19562,12 @@ async function mcpmaintenance(now) {
     await memory.setsessiontokens(tokens.map((token) => expired.includes(token) ? { ...token, revokedat: now } : token));
     await audit("protocol", `${expired.length} session token${expired.length === 1 ? "" : "s"} reached the user configured lifetime and the server refused ${expired.length === 1 ? "it" : "them"}; the records stay for the audit trail.`, {});
   }
+  const storedrecords = await memory.getidempotencyrecords();
+  const liverecords = expireidempotency(storedrecords, now);
+  if (liverecords.length !== storedrecords.length) {
+    await memory.setidempotencyrecords(liverecords);
+    await audit("protocol", `${storedrecords.length - liverecords.length} idempotency record${storedrecords.length - liverecords.length === 1 ? "" : "s"} expired past the user configured window and the key${storedrecords.length - liverecords.length === 1 ? " never replays" : "s never replay"}.`, {});
+  }
   const stored = await memory.listapprovals();
   const approvals = expireapprovals(stored, now);
   for (let index = 0; index < approvals.length; index += 1) {
@@ -19148,14 +19640,13 @@ async function trybridgelaunch(restart) {
 function restartbridgeof(bridge) {
   return { ...bridge, connected: true, restarts: bridge.restarts + 1, startedat: Date.now() };
 }
+var mcpcancelledcalls = /* @__PURE__ */ new Set();
 async function routemcpframe(client, frame, config, scopes) {
   const session = await memory.getsession();
   const plan = await memory.getplan();
   const catalog = buildtoolcatalog();
-  const calledtool = frame.method === "tools/call" && typeof frame.params?.name === "string" ? resolvetool(catalog, frame.params.name.trim()) : void 0;
-  const gatedname = client.transport === "http" && calledtool !== void 0 && calledtool.risk !== "read" ? calledtool.name : void 0;
-  const callparams = frame.params ?? {};
-  const response = await handleframe({ frame, client, catalog, config, ...session !== void 0 ? { session } : {}, ...plan !== void 0 ? { plan } : {}, ...scopes !== void 0 ? { scopes } : {}, origin: session?.origin ?? "", tabid: session?.tabid ?? 0, now: Date.now(), execute: gatedname !== void 0 ? (step) => raiseremoteapproval(client.id, gatedname, callparams, step) : executemcpstep });
+  if (frame.method === "tools/call") return await routetoolcall(client, frame, config, scopes, session, plan, catalog);
+  const response = await handleframe({ frame, client, catalog, config, ...session !== void 0 ? { session } : {}, ...plan !== void 0 ? { plan } : {}, ...scopes !== void 0 ? { scopes } : {}, 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;
@@ -19181,19 +19672,187 @@ async function routemcpframe(client, frame, config, scopes) {
     }
     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 ? gatedname !== void 0 ? "its approval gate waits for the user decision" : "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 routetoolcall(client, frame, config, scopes, session, plan, catalog) {
+  const now = Date.now();
+  const params = frame.params ?? {};
+  const name = typeof params.name === "string" ? params.name : "";
+  const origin = session?.origin ?? "";
+  const answerframe = (result2, error) => ({ jsonrpc: "2.0", ...frame.id !== void 0 ? { id: frame.id } : error !== void 0 ? { id: null } : {}, ...error !== void 0 ? { error: { code: error.code, message: error.message, ...error.data !== void 0 ? { data: error.data } : {} } } : { result: result2 } });
+  const refuse = async (code, message, data) => {
+    await memory.addtoolcall(toolcallevent({ id: randomid(), clientid: client.id, tool: name, origin, ok: false, now: Date.now(), code }));
+    await audit("tool", `The mcp client ${client.id} called the ${name} tool on ${origin || "no origin"} and was refused with the ${code} error; no payload rides the record.`, {});
+    return answerframe(void 0, { code, message, ...data !== void 0 ? { data } : {} });
+  };
+  const counted = applyratelimit({ limits: await memory.getcallratelimits(), clientid: client.id, now });
+  await memory.setcallratelimits(counted.limits);
+  if (!counted.allowed) {
+    const error = structurederrorof({ code: "ratelimited", message: `The client ${client.id} spent its user configured call budget of ${counted.budget ?? 0} inside the window.`, retryhint: "wait", ...counted.retryafter !== void 0 ? { retryafter: counted.retryafter } : {} });
+    await audit("protocol", `The per client rate limit refused the ${name} call of the client ${client.id}: the budget of ${counted.budget ?? 0} calls is spent and the retry hint waits ${counted.retryafter ?? 0} milliseconds.`, {});
+    return refuse("consentrefused", `${error.message} Retry: wait${error.retryafter !== void 0 ? ` after ${error.retryafter} milliseconds` : ""}.`, { retryhint: error.retryhint, ...error.retryafter !== void 0 ? { retryafter: error.retryafter } : {} });
+  }
+  const key = typeof params.idempotencykey === "string" && params.idempotencykey.trim() !== "" ? params.idempotencykey.trim() : void 0;
+  if (key !== void 0) {
+    const replay = checkidempotency({ records: await memory.getidempotencyrecords(), key, clientid: client.id, now });
+    if (replay.replay !== void 0 && replay.record !== void 0) {
+      await memory.addtoolcall(toolcallevent({ id: randomid(), clientid: client.id, tool: name, origin, ok: !replay.replay.iserror, now: Date.now(), idempotencykey: key, replayed: true }));
+      await audit("tool", `The mcp client ${client.id} repeated the idempotency key of the ${name} call and the server replayed the stored result instead of executing; no payload rides the record.`, {});
+      return answerframe({ ...replay.replay, replayed: true, idempotencykey: key, originalat: replay.record.createdat });
+    }
+  }
+  const tool = name !== "" ? resolvetool(catalog, name) : void 0;
+  const mock = tool !== void 0 ? applymock({ mocks: await memory.gettoolmocks(), tool: tool.name }) : void 0;
+  if (mock?.result !== void 0) {
+    await memory.addtoolcall(toolcallevent({ id: randomid(), clientid: client.id, tool: name, origin, ok: !mock.result.iserror, now: Date.now(), mocked: true }));
+    await audit("tool", `A tool mock of a test context answered the ${name} call of the client ${client.id} with its canned result; the browser was never touched.`, {});
+    return answerframe({ ...mock.result, mocked: true });
+  }
+  if (mock?.reason !== void 0) return await refuse("consentrefused", mock.reason);
+  let dryrun = params.dryrun === true;
+  if (!dryrun && await memory.getdryruntoggle()) {
+    dryrun = true;
+    await memory.setdryruntoggle(false);
+  }
+  if (dryrun && tool !== void 0) {
+    const dry = dryruntool({ tool, params, client, ...session !== void 0 ? { session } : {}, ...plan !== void 0 ? { plan } : {}, origin, now });
+    await memory.addtoolcall(toolcallevent({ id: randomid(), clientid: client.id, tool: name, origin, ok: dry.argsvalid && dry.consentok, now: Date.now(), dryrun: true }));
+    await audit("tool", `The mcp client ${client.id} dry ran the ${name} tool: ${dry.findings.length} finding${dry.findings.length === 1 ? "" : "s"} and no page mutation because a dry run never executes anything.`, {});
+    return answerframe({ content: `The ${name} dry run found ${dry.findings.length} issue${dry.findings.length === 1 ? "" : "s"}.`, payload: { dryrun: dry }, iserror: false });
+  }
+  const context = begincall({ clientid: client.id, tool: name, ...key !== void 0 ? { idempotencykey: key } : {}, now });
+  await memory.setcallcontexts([context, ...await memory.getcallcontexts()]);
+  const started = notifyevent({ subscriptions: await memory.geteventsubscriptions(), kind: "callstarted", ...origin !== "" ? { origin } : {}, ...name !== "" ? { tool: name } : {}, payload: { callid: context.callid, clientid: client.id }, now });
+  await memory.seteventsubscriptions(started.subscriptions);
+  const notice = notifyprogress({ callid: context.callid, percent: 10, message: `The ${name} call started behind the consent gates.`, now });
+  await memory.addprogressnotice(notice);
+  const progressed = notifyevent({ subscriptions: started.subscriptions, kind: "progress", ...origin !== "" ? { origin } : {}, ...name !== "" ? { tool: name } : {}, payload: { callid: notice.callid, percent: notice.percent, message: notice.message, cancellable: notice.cancellable }, now });
+  await memory.seteventsubscriptions(progressed.subscriptions);
+  const gatedname = client.transport === "http" && tool !== void 0 && tool.risk !== "read" ? tool.name : void 0;
+  const execute = gatedname !== void 0 ? (step) => raiseremoteapproval(client.id, gatedname, params, step) : async (step) => {
+    if (mcpcancelledcalls.has(context.callid)) throw new Error(`The ${name} call was cancelled before the page executor ran.`);
+    const result2 = await executemcpstep(step);
+    if (mcpcancelledcalls.has(context.callid)) throw new Error(`The ${name} call was cancelled in flight; the partial result stays preserved.`);
+    return result2;
+  };
+  const response = await handleframe({ frame, client, catalog, config, ...session !== void 0 ? { session } : {}, ...plan !== void 0 ? { plan } : {}, ...scopes !== void 0 ? { scopes } : {}, origin, tabid: session?.tabid ?? 0, now: Date.now(), contexts: await memory.getcallcontexts(), execute });
+  const after = Date.now();
+  const ok = response.error === void 0 && (response.result?.iserror ?? true) !== true;
+  const result = response.error === void 0 ? response.result : void 0;
+  const closed = endcall({ contexts: await memory.getcallcontexts(), callid: context.callid, ok, ...response.error !== void 0 ? { errorcode: response.error.code } : {}, ...result !== void 0 ? { partial: result } : {}, now: after });
+  if (closed.contexts !== void 0) await memory.setcallcontexts(closed.contexts);
+  if (result !== void 0 && typeof result.content === "string" && result.content.length > 0) {
+    const chunks = chunkcontent({ callid: context.callid, content: result.content, now: after });
+    for (const chunk of chunks) await memory.addstreamchunk(chunk);
+    const streamed = notifyevent({ subscriptions: await memory.geteventsubscriptions(), kind: "streamchunk", ...origin !== "" ? { origin } : {}, ...name !== "" ? { tool: name } : {}, payload: { callid: context.callid, chunks: chunks.length, done: true }, now: after });
+    await memory.seteventsubscriptions(streamed.subscriptions);
+  }
+  const finished = notifyevent({ subscriptions: await memory.geteventsubscriptions(), kind: "callresult", ...origin !== "" ? { origin } : {}, ...name !== "" ? { tool: name } : {}, payload: { callid: context.callid, ok }, now: after });
+  await memory.seteventsubscriptions(finished.subscriptions);
+  if (key !== void 0 && result !== void 0 && !result.iserror) await memory.setidempotencyrecords(recordidempotency({ records: await memory.getidempotencyrecords(), key, clientid: client.id, tool: name, result, now: after }));
+  await memory.addtoolcall(toolcallevent({ id: randomid(), clientid: client.id, tool: name, origin, ok, now: after, ...response.error !== void 0 ? { code: response.error.code } : {}, callid: context.callid, ...key !== void 0 ? { idempotencykey: key } : {} }));
+  if (plan !== void 0) {
+    const stepid = typeof params.stepid === "string" ? params.stepid : "mcp";
+    await memory.setprogress(recordtoolcall(await memory.getprogress(), plan.id, stepid, { clientid: client.id, tool: name, ok, ...response.error !== void 0 ? { code: response.error.code } : {} }, after));
+  }
+  await audit("tool", `The mcp client ${client.id} called the ${name} tool on ${origin || "no origin"} and ${ok ? gatedname !== void 0 ? "its approval gate waits for the user decision" : `it ran behind the consent gates as the call ${context.callid}` : `it was refused${response.error !== void 0 ? ` with the ${response.error.code} error` : ""}`}${key !== void 0 ? " under its idempotency key" : ""}; no payload rides the record.`, {});
+  return response;
+}
+async function routeprotocolframe(client, frame, config, scopes) {
+  void config;
+  void scopes;
+  const params = frame.params ?? {};
+  const now = Date.now();
+  const answerframe = (result, error) => ({ jsonrpc: "2.0", ...frame.id !== void 0 ? { id: frame.id } : error !== void 0 ? { id: null } : {}, ...error !== void 0 ? { error: { code: error.code, message: error.message } } : { result } });
+  if (frame.method === "events/subscribe") {
+    const kinds = Array.isArray(params.kinds) ? params.kinds.filter((kind) => typeof kind === "string") : void 0;
+    const registered = subscriberegister({ clientid: client.id, ...kinds !== void 0 ? { kinds } : {}, ...typeof params.origin === "string" && params.origin.trim() !== "" ? { origin: params.origin.trim() } : {}, ...typeof params.tool === "string" && params.tool.trim() !== "" ? { tool: params.tool.trim() } : {}, now });
+    if (registered.subscription === void 0) return answerframe(void 0, { code: "params", message: registered.reason ?? "The event subscription did not register." });
+    const grade = subscriptiongrade(registered.subscription);
+    if (!grade.allowed) return answerframe(void 0, { code: "consentrefused", message: grade.reason ?? "The event subscription failed its gate." });
+    await memory.seteventsubscriptions([registered.subscription, ...await memory.geteventsubscriptions()]);
+    await audit("protocol", `The client ${client.id} subscribed to the ${registered.subscription.kinds.join(", ")} event kinds${registered.subscription.origin !== void 0 ? ` of the origin ${registered.subscription.origin}` : ""}${registered.subscription.tool !== void 0 ? ` for the tool ${registered.subscription.tool}` : ""}; the subscription grades read only.`, {});
+    return answerframe({ subscriptionid: registered.subscription.id, kinds: registered.subscription.kinds });
+  }
+  if (frame.method === "events/unsubscribe") {
+    const subscriptionid = typeof params.subscriptionid === "string" ? params.subscriptionid : "";
+    await memory.seteventsubscriptions(unsubscriberegister(await memory.geteventsubscriptions(), subscriptionid, now));
+    await audit("protocol", `The client ${client.id} cancelled its event subscription ${subscriptionid}; the record stays for the audit trail.`, {});
+    return answerframe({ unsubscribed: true, subscriptionid });
+  }
+  if (frame.method === "resources/watch") {
+    const resource = typeof params.resource === "string" ? params.resource.trim() : "";
+    const state = params.state !== void 0 && typeof params.state === "object" && !Array.isArray(params.state) ? params.state : void 0;
+    const watched = watchresource({ clientid: client.id, resource, ...state !== void 0 ? { state } : {}, now });
+    if (watched.watch === void 0) return answerframe(void 0, { code: "params", message: watched.reason ?? "The resource watcher did not start." });
+    await memory.setresourcewatches([watched.watch, ...await memory.getresourcewatches()]);
+    await audit("protocol", `The client ${client.id} started the ${watched.watch.resource} resource watcher with its page state baseline; the deltas compare against it.`, {});
+    return answerframe({ watchid: watched.watch.id, resource: watched.watch.resource });
+  }
+  if (frame.method === "resources/unwatch") {
+    const watchid = typeof params.watchid === "string" ? params.watchid : "";
+    await memory.setresourcewatches(unwatchresource(await memory.getresourcewatches(), watchid, now));
+    await audit("protocol", `The client ${client.id} cancelled its resource watcher ${watchid}; the record stays for the audit trail.`, {});
+    return answerframe({ unwatched: true, watchid });
+  }
+  if (frame.method === "sampling/answer") {
+    const samplingid = typeof params.samplingid === "string" ? params.samplingid : "";
+    const clientanswer = typeof params.answer === "string" ? params.answer : void 0;
+    const outcome = answersampling({ requests: await memory.getsamplingrequests(), id: samplingid, ...clientanswer !== void 0 ? { answer: clientanswer } : {}, ...params.refused === true ? { refused: true } : {}, now });
+    if (outcome.request === void 0) return answerframe(void 0, { code: "params", message: outcome.reason ?? "The sampling answer closed no request." });
+    await memory.setsamplingrequests(outcome.requests);
+    await audit("protocol", `The sampling callback ${samplingid} of the client ${client.id} closed its round trip with the client answer; the provenance times ride the record.`, {});
+    return answerframe({ samplingid, state: outcome.request.state });
+  }
+  if (frame.method === "calls/cancel") {
+    const callid = typeof params.callid === "string" ? params.callid : "";
+    const reason = typeof params.reason === "string" ? params.reason : void 0;
+    if (callid.trim() === "") return answerframe(void 0, { code: "params", message: "The cancellation frame needs the call id it aborts." });
+    const chunks = (await memory.getstreamchunks()).filter((chunk) => chunk.callid === callid);
+    const partial = chunks.length > 0 ? { content: chunks.map((chunk) => chunk.content).join(""), iserror: false } : void 0;
+    const aborted = canceltool({ contexts: await memory.getcallcontexts(), callid, ...reason !== void 0 ? { reason } : {}, ...partial !== void 0 ? { partial } : {}, now });
+    if (aborted.context === void 0) return answerframe(void 0, { code: "params", message: aborted.reason ?? "The cancellation frame named no in flight tool call." });
+    await memory.setcallcontexts(aborted.contexts);
+    mcpcancelledcalls.add(callid);
+    const cancelled = notifyevent({ subscriptions: await memory.geteventsubscriptions(), kind: "cancellation", payload: { callid, reason: reason ?? "cancelled by the client" }, now });
+    await memory.seteventsubscriptions(cancelled.subscriptions);
+    await audit("protocol", `The client ${client.id} cancelled the in flight ${aborted.context.tool} call ${callid}${partial !== void 0 ? " with its partial result preserved" : ""}; the cooperative flag stops the page executor between chunks and the workflow engine keeps its own pause machinery.`, {});
+    return answerframe({ cancelled: true, callid, ...aborted.context.partial !== void 0 ? { partial: aborted.context.partial } : {} });
+  }
+  if (frame.method === "calls/batch") {
+    const members = (Array.isArray(params.calls) ? params.calls : []).filter((entry) => entry !== null && typeof entry === "object" && !Array.isArray(entry)).map((entry, index) => ({ id: typeof entry.id === "string" && entry.id.trim() !== "" ? entry.id.trim() : `member-${index + 1}`, name: typeof entry.name === "string" ? entry.name : "", params: entry.params !== void 0 && typeof entry.params === "object" && !Array.isArray(entry.params) ? entry.params : {} }));
+    const stoponerror = params.stoponerror === true;
+    const session = await memory.getsession();
+    const plan = await memory.getplan();
+    const catalog = buildtoolcatalog();
+    const risks = members.map((member) => {
+      const tool = resolvetool(catalog, member.name);
+      return { risk: tool?.risk ?? "read" };
+    });
+    const approved = plan?.state === "approved" && members.every((member) => {
+      const tool = resolvetool(catalog, member.name);
+      return tool === void 0 || tool.risk === "read" || typeof member.params.stepid === "string" && plan.steps.some((step) => step.id === member.params.stepid);
+    });
+    const gate = batchgrade({ calls: risks, approved });
+    const batch = { id: randomid(), clientid: client.id, calls: members, stoponerror, state: gate.allowed ? "running" : "stopped", createdat: now, outcomes: [] };
+    await memory.setbatchcall(batch);
+    if (!gate.allowed) {
+      await audit("protocol", `The batch call of the client ${client.id} was refused: ${gate.reason ?? "the batch failed its grade."}`, {});
+      return answerframe(void 0, { code: "consentrefused", message: gate.reason ?? "The batch call failed its grade." });
+    }
+    const outcome = await runbatch({ calls: members, stoponerror, now, execute: async (member) => {
+      const response = await routemcpframe(client, { jsonrpc: "2.0", ...frame.id !== void 0 ? { id: frame.id } : {}, method: "tools/call", params: { ...member.params, name: member.name } }, config, scopes);
+      const ok = response.error === void 0 && (response.result?.iserror ?? true) !== true;
+      return { ok, ...response.result !== void 0 ? { result: response.result } : {}, ...response.error !== void 0 ? { error: structurederrorof({ code: response.error.code, message: response.error.message, retryhint: retryhintof({ code: response.error.code, message: response.error.message }) }) } : {} };
+    } });
+    const storedbatch = { ...batch, state: outcome.stoppedat !== void 0 ? "stopped" : "done", outcomes: outcome.outcomes, finishedat: Date.now() };
+    await memory.setbatchcall(storedbatch);
+    const ran = outcome.outcomes.filter((entry) => entry.ok).length;
+    await audit("protocol", `The client ${client.id} ran the batch ${batch.id} of ${members.length} ordered call${members.length === 1 ? "" : "s"}${outcome.stoppedat !== void 0 ? ` and stopped at the member ${outcome.stoppedat} on its first error as the flag requested` : ""}; ${ran} of ${members.length} members ran behind the gates.`, {});
+    return answerframe({ batchid: batch.id, state: storedbatch.state, stoponerror, outcomes: storedbatch.outcomes });
+  }
+  return void 0;
+}
 async function processmcpframe(raw, clientid, transport, rawtoken, fingerprint) {
   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.") };
@@ -19236,7 +19895,11 @@ async function processmcpframe(raw, clientid, transport, rawtoken, fingerprint)
     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, scopes));
+  const task = previous.catch(() => void 0).then(async () => {
+    const protocol = await routeprotocolframe(client, frame, config, scopes);
+    if (protocol !== void 0) return protocol;
+    return await routemcpframe(client, frame, config, scopes);
+  });
   mcpclientchains.set(client.id, task);
   return task;
 }