@wenathlan/extension 1.1.63 → 1.1.64

package/extension/dist/background.js

@@ -5106,6 +5106,59 @@ var sessionmemory = class {
   async exportsessionbundle(exportedat) {
     return { kind: "sessionbundle", notes: await this.getsitenotes(), summaries: await this.listrunsummaries(), corrections: await this.getcorrections(), exportedat };
   }
+  /**
+   * Interface surface stores of the 1.1.64 family live here, scoped per profile workspace: the commandpalette usage counts the recent first ranking reads, the taskinput history of natural language goals, the onboarding completion state, the per surface layout preferences, the logstream filter preferences and the stepapprove resolution history per origin.
+   */
+  /** Returns every commandpalette usage record so the ranking lifts the recent commands first. */
+  async getpaletteusage() {
+    return await this.adapter.get("paletteusage") ?? [];
+  }
+  /** Replaces the commandpalette usage records after one use: the count grows and the last use time moves so the ranking reads both. */
+  async setpaletteusage(records) {
+    return this.adapter.set("paletteusage", records);
+  }
+  /** Returns the stored taskinput history, newest first. */
+  async gettaskinputs() {
+    return await this.adapter.get("taskinputs") ?? [];
+  }
+  /** Adds one taskinput submission to the per profile history; the retention window stays a user setting. */
+  async addtaskinput(entry) {
+    const retention = (await this.getsettings())?.taskinputretention;
+    const history2 = [entry, ...await this.gettaskinputs()];
+    await this.adapter.set("taskinputs", retention === void 0 ? history2 : history2.filter((candidate) => entry.at - candidate.at < retention));
+  }
+  /** Returns the onboarding completion state; an absent state means the walkthrough never ran. */
+  async getonboardingstate() {
+    return this.adapter.get("onboarding");
+  }
+  /** Stores the onboarding completion state; a done walkthrough never runs again on its own. */
+  async setonboardingstate(state) {
+    return this.adapter.set("onboarding", state);
+  }
+  /** Returns the layout preferences of one surface; an absent preference set returns undefined. */
+  async getsurfacelayout(surface) {
+    return this.adapter.get(`surfacelayout:${surface}`);
+  }
+  /** Stores the layout preferences of one surface, scoped per profile workspace. */
+  async setsurfacelayout(layout) {
+    return this.adapter.set(`surfacelayout:${layout.surface}`, layout);
+  }
+  /** Returns the stored logstream filter preferences of the live view. */
+  async getlogstreamfilters() {
+    return this.adapter.get("logstreamfilters");
+  }
+  /** Stores the logstream filter preferences of the live view. */
+  async setlogstreamfilters(filter) {
+    return this.adapter.set("logstreamfilters", filter);
+  }
+  /** Returns every stored stepapprove resolution, newest first, with its human provenance. */
+  async getstepapproveresolutions() {
+    return await this.adapter.get("stepapproveresolutions") ?? [];
+  }
+  /** Records one stepapprove resolution in the per origin history. */
+  async addstepapproveresolution(resolution) {
+    await this.adapter.set("stepapproveresolutions", [resolution, ...await this.getstepapproveresolutions()]);
+  }
 };
 function mediakindof(record2) {
   if ("pages" in record2) return "pdf";
@@ -10617,6 +10670,48 @@ function retrydispatchgate(input) {
   if (!input.reviewed) return { allowed: false, reason: `The retry of the step ${input.stepid} passes only through a new reviewed dispatch; an automatic retry never bypasses the review.` };
   return { allowed: true, reason: `The retry of the step ${input.stepid} dispatches again through the full consent gate chain: the session, the plan and the origin gates all recheck the step.` };
 }
+function paletteactiongate(input) {
+  if (input.action.permission !== void 0 && !input.granted.includes(input.action.permission)) return { allowed: false, reason: `The ${input.action.command} command needs the ${input.action.permission} capability granted before the palette lists it; the palette never offers an action the current capability set refuses.` };
+  if (input.action.session === true && !input.sessionactive) return { allowed: false, reason: `The ${input.action.command} command needs an active browser session before the palette lists it; the palette never offers a run action without its session.` };
+  return { allowed: true, reason: `The ${input.action.command} command rides its granted permissions and lists in the palette.` };
+}
+function taskinputproposalgate(input) {
+  if (input.direct) return { allowed: false, reason: "The taskinput never executes a goal directly; every natural language goal routes through the same proposal flow as the api and becomes a reviewed plan first." };
+  if (input.text.trim() === "") return { allowed: false, reason: "The taskinput submission needs its natural language goal; an empty goal never reaches the proposal flow." };
+  if (input.origin.trim() === "") return { allowed: false, reason: "The taskinput submission needs its active origin scope; a goal without an origin never reaches the proposal flow." };
+  return { allowed: true, reason: `The taskinput goal for ${input.origin} rides the same proposal flow as the api: the observation, the capabilities and the plan review all recheck it.` };
+}
+function planreviewgate(input) {
+  if (input.state === "approved") return { allowed: true, reason: "The plan already passed its review: the approval is the review of record and the execution proceeds." };
+  if (!input.reviewed) return { allowed: false, reason: "The pending plan has no plancard review yet; every step renders its card with the risk class, the environment and the options before any execution." };
+  return { allowed: true, reason: "The plancard review of the pending plan is open; the resolution of each step stays a distinct human action." };
+}
+function stepapprovegate(input) {
+  if (input.stepids.length === 0) return { allowed: false, reason: "A stepapprove resolution names its single step." };
+  if (input.stepids.length > 1) return { allowed: false, reason: `One human action resolves exactly one step; the batch of ${input.stepids.length} steps refuses in full because no batch approval exists.` };
+  if (input.surface === "background") return { allowed: false, reason: `The ${input.resolution} resolution of the step ${input.stepids[0]} needs its distinct human action from a surface; the background never resolves a review on its own.` };
+  if (input.resolution === "edit") return { allowed: true, reason: `The user edits the step ${input.stepids[0]} from the ${input.surface} before approving; the corrected shape rides the plan and the resolution keeps its human provenance.` };
+  return { allowed: true, reason: `The user ${input.resolution === "approve" ? "approved" : "rejected"} the step ${input.stepids[0]} from the ${input.surface}; one distinct human action resolved the step alone.` };
+}
+function diffpreviewgate(input) {
+  if (input.risk !== "sensitive") return { allowed: false, reason: `The ${input.risk} step changes no page or browser state; the diffpreview compares the observed before state with the predicted after state of write class steps only.` };
+  return { allowed: true, reason: "The write class step changes page or browser state, so the diffpreview compares its observed before state with its predicted after state." };
+}
+function onboardingconsentgate(input) {
+  if (input.consentevents.length === 0) return { allowed: true, reason: "The onboarding completion writes its single consent scoped event; no consent event exists yet." };
+  if (input.consentevents.length === 1) return { allowed: false, reason: `The onboarding already wrote its single consent scoped event ${input.consentevents[0]}; a walkthrough never writes a second one.` };
+  return { allowed: false, reason: `The onboarding found ${input.consentevents.length} consent scoped events; a walkthrough writes exactly one and the extra events refuse.` };
+}
+function logbufferboundvalid(bound) {
+  if (bound === void 0) return { allowed: true, reason: "No logstream buffer bound is configured, so the live window keeps every event while the full history stays in memory." };
+  if (!Number.isInteger(bound) || bound <= 0) return { allowed: false, reason: "The logstream buffer bound stays a positive whole number of events the user chose; no engine cap exists." };
+  return { allowed: true, reason: `The logstream buffer bound of ${bound} event${bound === 1 ? "" : "s"} stays the user configured choice; the full history stays in memory.` };
+}
+function logstreamegressgate(input) {
+  if (input.entries === 0) return { allowed: false, reason: "The audit excerpt names no event of the logstream; an empty range never copies." };
+  if (!input.verified) return { allowed: false, reason: "The logstream chain failed its live verification; the audit excerpt refuses the copy because only a verified range leaves the stream." };
+  return { allowed: true, reason: `The logstream chain verifies across the ${input.entries} event${input.entries === 1 ? "" : "s"} of the range; the audit excerpt copies as one verified record.` };
+}
 
 // progress.ts
 function emptyprogress(planid, now) {
@@ -10867,7 +10962,7 @@ function maskexport(record2, shapes) {
 }
 
 // version.ts
-var packageversion = "1.1.63";
+var packageversion = "1.1.64";
 
 // types.ts
 var protocolversion = packageversion;
@@ -11844,6 +11939,9 @@ function environmentreport(input) {
 function transparencyreport(input) {
   return { version: protocolversion, posture: "denydefault", grants: input.grants, windows: input.windows, connectallow: input.connectallow, permdiffs: input.permdiffs, safedefaults: input.safedefaults, vault: input.vault };
 }
+function surfacesnapshot(input) {
+  return { version: protocolversion, surface: input.surface, palette: input.palette, timeline: input.timeline, logstream: input.logstream, plancards: input.plancards, ...input.onboarding !== void 0 ? { onboarding: input.onboarding } : {} };
+}
 
 // capture.ts
 var capturekinds = ["shotview", "shotfullpage", "shotelement", "shotregion", "contactsheet"];
@@ -13091,6 +13189,9 @@ function rejectedcorrectionof(input) {
   if (input.stepid.trim() === "" || input.reason.trim() === "") throw new Error("The rejected correction needs its step and its rejection reason.");
   return { id: input.id ?? randomid(), origin: input.origin, kind: input.kind, stepid: input.stepid, source: "rejected", original: input.original, reason: input.reason, at: input.now };
 }
+function matchingcorrections(corrections, proposal) {
+  return corrections.filter((entry) => entry.origin === proposal.origin && entry.kind === proposal.kind);
+}
 function consentmemoryof(input) {
   if (input.origin.trim() === "") throw new Error("The consent memory entry needs its origin.");
   if (input.boundary.trim() === "") throw new Error("The consent memory entry needs the boundary the prompt named.");
@@ -13180,6 +13281,263 @@ function tabsessionrefof(input) {
   return { tabid: input.tabid, sessionid: input.sessionid, ...input.runid !== void 0 && input.runid.trim() !== "" ? { runid: input.runid } : {}, origin: input.origin, updatedat: input.now };
 }
 
+// surfaces.ts
+function surfacepalette() {
+  return [
+    { id: "starttask", label: "Start task", keywords: ["task", "objective", "run", "goal", "plan"], action: { command: "starttask", surface: "popup" } },
+    { id: "pauserun", label: "Pause run", keywords: ["pause", "hold", "stop", "run"], action: { command: "pauserun", surface: "popup", session: true } },
+    { id: "resumerun", label: "Resume run", keywords: ["resume", "continue", "unpause", "run"], action: { command: "resumerun", surface: "popup", session: true } },
+    { id: "cancelrun", label: "Cancel run", keywords: ["cancel", "stop", "rollback", "queued"], action: { command: "cancelrun", surface: "popup", session: true } },
+    { id: "resumesession", label: "Resume session", keywords: ["session", "resume", "grid", "reopen"], action: { command: "resumesession", surface: "sidepanel" } },
+    { id: "stepapprove", label: "Review step", keywords: ["approve", "reject", "edit", "step", "review", "plancard"], action: { command: "stepapprove", surface: "sidepanel", session: true } },
+    { id: "diffpreview", label: "Preview step diff", keywords: ["diff", "preview", "before", "after", "write"], action: { command: "diffpreview", surface: "sidepanel", session: true } },
+    { id: "historysearch", label: "Search history", keywords: ["history", "search", "notes", "summaries", "corpus"], action: { command: "historysearch", surface: "dashboardpage" } },
+    { id: "revokeconsent", label: "Revoke consent", keywords: ["revoke", "consent", "allowlist", "origin", "grant"], action: { command: "revokeconsent", surface: "dashboardpage", session: true } },
+    { id: "opentransparencypage", label: "Open transparency page", keywords: ["transparency", "grants", "permissions", "diff"], action: { command: "opentransparencypage", surface: "optionspage" } },
+    { id: "opendashboardpage", label: "Open dashboard", keywords: ["dashboard", "sessions", "runs", "notes", "full"], action: { command: "opendashboardpage", surface: "dashboardpage" } },
+    { id: "openoptionspage", label: "Open options", keywords: ["options", "settings", "preferences", "configure"], action: { command: "openoptionspage", surface: "optionspage" } },
+    { id: "copyauditexcerpt", label: "Copy audit excerpt", keywords: ["audit", "excerpt", "copy", "verified", "range"], action: { command: "copyauditexcerpt", surface: "dashboardpage" } },
+    { id: "replayonboarding", label: "Replay onboarding", keywords: ["onboarding", "tour", "walkthrough", "replay", "first"], action: { command: "replayonboarding", surface: "onboarding" } }
+  ];
+}
+function palettecommandsof(entries, input) {
+  return entries.filter((entry) => paletteactiongate({ action: entry.action, granted: input.granted, sessionactive: input.sessionactive }).allowed);
+}
+function fuzzyentryscore(entry, query) {
+  const text2 = query.trim().toLowerCase();
+  if (text2 === "") return 1;
+  const id = entry.id.toLowerCase();
+  const label = entry.label.toLowerCase();
+  if (id === text2 || label === text2) return 100;
+  let score = 0;
+  if (id.includes(text2)) score += 40;
+  if (label.includes(text2)) score += 30;
+  for (const keyword of entry.keywords) {
+    const lower = keyword.toLowerCase();
+    if (lower === text2) score += 20;
+    else if (lower.includes(text2)) score += 10;
+  }
+  if (score === 0 && text2.length > 1) {
+    for (const haystack of [label, id]) {
+      let cursor = 0;
+      let matched = true;
+      for (const letter of text2) {
+        const found = haystack.indexOf(letter, cursor);
+        if (found === -1) {
+          matched = false;
+          break;
+        }
+        cursor = found + 1;
+      }
+      if (matched) {
+        score += 15;
+        break;
+      }
+    }
+  }
+  return score;
+}
+function palettequery(entries, input) {
+  const text2 = input.text.trim();
+  const matches = entries.map((entry) => ({ entry, score: fuzzyentryscore(entry, text2) })).filter((match) => match.score > 0);
+  const lastusedof = (command) => input.usage.find((record2) => record2.command === command)?.lastusedat ?? 0;
+  const countof = (command) => input.usage.find((record2) => record2.command === command)?.count ?? 0;
+  const recentwindow = input.recentwindow;
+  const ranked = matches.sort((left, right) => {
+    if (right.score !== left.score) return right.score - left.score;
+    const leftrecent = recentwindow === void 0 ? 0 : countof(left.entry.action.command) > 0 && lastusedof(left.entry.action.command) >= lastusedof(right.entry.action.command) ? 1 : 0;
+    const rightrecent = recentwindow === void 0 ? 0 : countof(right.entry.action.command) > 0 && lastusedof(right.entry.action.command) >= lastusedof(left.entry.action.command) ? 1 : 0;
+    if (rightrecent !== leftrecent) return rightrecent - leftrecent;
+    return lastusedof(right.entry.action.command) - lastusedof(left.entry.action.command);
+  });
+  return ranked.map((match) => ({ entry: match.entry, score: match.score, reason: match.score >= 100 ? `The query matches the ${match.entry.id} command exactly.` : `The query matches the label or the keywords of the ${match.entry.id} command${countof(match.entry.action.command) > 0 ? ` and its ${countof(match.entry.action.command)} recorded use${countof(match.entry.action.command) === 1 ? "" : "s"} rank it first among equals` : ""}.` }));
+}
+function paletteuseafter(usage, command, now) {
+  const existing = usage.find((record2) => record2.command === command);
+  if (existing === void 0) return [{ command, count: 1, lastusedat: now }, ...usage];
+  return usage.map((record2) => record2.command === command ? { ...record2, count: record2.count + 1, lastusedat: now } : record2);
+}
+function taskinputof(input) {
+  if (input.text.trim() === "") throw new Error("The taskinput needs its natural language goal.");
+  if (input.origin.trim() === "") throw new Error("The taskinput needs its active origin scope.");
+  return { id: randomid(), text: input.text.trim(), context: input.context ?? "", origin: input.origin.trim(), surface: input.surface, at: input.at };
+}
+function onboardingsteps() {
+  return [
+    { id: "origingrants", surface: "popup", title: "Origin grants", body: "Devthink denies automation by default; grant one exact origin at a time from the popup and every run stays inside the granted origins.", completion: "origingrantscompleted" },
+    { id: "planreview", surface: "sidepanel", title: "Plan review", body: "Every task becomes a plan of reviewed steps; read the plancards of each risk class and approve, reject or edit one step at a time.", completion: "planreviewcompleted" },
+    { id: "runcontrol", surface: "sidepanel", title: "Run control", body: "Runs start, pause, resume and cancel under your hand; a cancelled run rolls only its queued steps back while the executed steps stay sealed.", completion: "runcontrolcompleted" },
+    { id: "logaudit", surface: "dashboardpage", title: "Log audit", body: "The immutable log chains every step transition with masked values; open the dashboard, verify the chain and copy a verified range as an audit excerpt.", completion: "logauditcompleted" }
+  ];
+}
+function onboardingstart(previous, now) {
+  return { stepscompleted: [], done: false, startedat: now };
+}
+function onboardingcomplete(state, stepid, now) {
+  const steps = onboardingsteps();
+  const step = steps.find((candidate) => candidate.id === stepid);
+  if (step === void 0) throw new Error(`The onboarding knows no ${stepid} step.`);
+  const completed = state.stepscompleted.includes(stepid) ? state.stepscompleted : [...state.stepscompleted, stepid];
+  const done = steps.every((candidate) => completed.includes(candidate.id));
+  if (!done) return { state: { ...state, stepscompleted: completed, done: false } };
+  const consentevent = "onboardingconsentgranted";
+  return { state: { stepscompleted: completed, done: true, ...state.startedat !== void 0 ? { startedat: state.startedat } : {}, consentevent, completedat: now }, consentevent };
+}
+function broadcastframeof(input) {
+  if (input.summary.trim() === "") throw new Error("The broadcast frame needs its summary.");
+  return { channel: input.channel, surface: input.surface, summary: input.summary, at: input.at };
+}
+function broadcastchannelof(kind) {
+  if (["session", "proposal", "approval", "action", "stop", "pause", "resume", "complete", "cancel", "error", "capability"].includes(kind)) return "runstate";
+  if (["notes", "scratchpad", "summary", "recall", "correction", "consentmemory", "search", "vault", "gate", "grant", "revoke", "expiry", "deny"].includes(kind)) return "sessions";
+  if (["configure", "transparency"].includes(kind)) return "settings";
+  return "logstream";
+}
+function busrouteaction(action, input) {
+  const entry = surfacepalette().find((candidate) => candidate.action.command === action.command);
+  if (entry === void 0) return { dispatched: false, gate: "commandbus", reason: `The ${action.surface} asked for the unknown ${action.command} command; the bus routes only catalog commands.` };
+  const permission = paletteactiongate({ action: entry.action, granted: input.granted, sessionactive: input.sessionactive });
+  if (!permission.allowed) return { dispatched: false, gate: "paletteactiongate", reason: permission.reason ?? "The command misses its granted permission." };
+  if (action.command === "starttask") {
+    const proposal = taskinputproposalgate({ text: input.text ?? "", origin: input.origin ?? "", direct: false });
+    if (!proposal.allowed) return { dispatched: false, gate: "taskinputproposalgate", reason: proposal.reason ?? "The task submission refuses." };
+  }
+  if (action.command === "stepapprove" || action.command === "diffpreview") {
+    const review = planreviewgate({ reviewed: input.planreviewed, state: input.planstate });
+    if (!review.allowed) return { dispatched: false, gate: "planreviewgate", reason: review.reason ?? "The plan review stays open." };
+  }
+  return { dispatched: true, gate: "commandbus", reason: `The ${action.command} action of the ${action.surface} routed through its policy gates and dispatches.` };
+}
+
+// planreview.ts
+function plancardsof(input) {
+  return input.plan.steps.map((step) => ({
+    stepid: step.id,
+    kind: step.kind,
+    risk: step.risk,
+    environment: step.environment ?? defaultenvironment(step),
+    options: step.options ?? "",
+    summary: step.summary,
+    corrections: matchingcorrections(input.corrections, { origin: input.plan.origin, kind: step.kind }).map((entry) => ({ id: entry.id, source: entry.source, reason: entry.reason })),
+    editable: input.plan.state === "pending"
+  }));
+}
+function plancardgroups(cards) {
+  const order = ["sensitive", "interaction", "read"];
+  return order.map((risk) => ({ risk, cards: cards.filter((card) => card.risk === risk), expanded: risk === "sensitive" })).filter((group) => group.cards.length > 0);
+}
+function stepresolutionof(input) {
+  if (input.stepid.trim() === "") throw new Error("The stepapprove resolution needs its step.");
+  if (input.resolution === "edit" && (input.edited ?? "").trim() === "") throw new Error("The edited resolution needs its corrected step shape.");
+  return { stepid: input.stepid, planid: input.planid, origin: input.origin, resolution: input.resolution, surface: input.surface, ...input.edited !== void 0 && input.edited.trim() !== "" ? { edited: input.edited } : {}, at: input.at };
+}
+function resolutionlogeventof(resolution) {
+  return {
+    kind: "review",
+    stepid: resolution.stepid,
+    summary: resolution.resolution === "edit" ? `The user edited the step ${resolution.stepid} of the plan ${resolution.planid} from the ${resolution.surface} before approving; the corrected shape rides the plan.` : `The user ${resolution.resolution === "approve" ? "approved" : "rejected"} the step ${resolution.stepid} of the plan ${resolution.planid} from the ${resolution.surface}; one distinct human action resolved the step alone.`
+  };
+}
+function maskverdictsof(state, sensitivefields) {
+  const verdicts = {};
+  for (const [field, value] of Object.entries(state)) {
+    if (sensitivefields.includes(field)) verdicts[field] = `The ${field} value stays masked (${value.length} characters) and never renders in the clear.`;
+  }
+  return verdicts;
+}
+function diffpreviewof(input) {
+  const changes = [];
+  const fields = [.../* @__PURE__ */ new Set([...Object.keys(input.before), ...Object.keys(input.after)])];
+  for (const field of fields) {
+    const hasbefore = Object.prototype.hasOwnProperty.call(input.before, field);
+    const hasafter = Object.prototype.hasOwnProperty.call(input.after, field);
+    const beforevalue = input.before[field];
+    const aftervalue = input.after[field];
+    if (hasbefore && !hasafter && beforevalue !== void 0) changes.push({ field, kind: "removed", before: beforevalue });
+    else if (!hasbefore && hasafter && aftervalue !== void 0) changes.push({ field, kind: "added", after: aftervalue });
+    else if (hasbefore && hasafter && beforevalue !== void 0 && aftervalue !== void 0 && beforevalue !== aftervalue) changes.push({ field, kind: "changed", before: beforevalue, after: aftervalue });
+  }
+  return { stepid: input.stepid, before: input.before, after: input.after, changes, maskverdicts: input.maskverdicts ?? {}, provenance: input.provenance };
+}
+function stepstimelinenodes(input) {
+  const completed = input.progress?.completedsteps ?? [];
+  const outcomes = input.progress?.outcomes ?? [];
+  const environments = input.progress?.environments;
+  const turnarounds = input.progress?.turnarounds;
+  const gatewaits = input.progress?.gatewaits;
+  let activeset = false;
+  let blocked = false;
+  return input.plan.steps.map((step) => {
+    const outcome = [...outcomes].reverse().find((candidate) => candidate.stepid === step.id);
+    const gatewait = gatewaits?.[step.id];
+    let status;
+    if (outcome !== void 0) status = outcome.ok ? "done" : "failed";
+    else if (gatewait !== void 0) status = "waiting";
+    else if (completed.includes(step.id)) status = "done";
+    else if (input.plan.state === "cancelled" || input.plan.state === "expired") status = "halted";
+    else if (input.plan.state === "rejected") status = "halted";
+    else if (input.plan.state === "approved" && !activeset && !blocked) {
+      status = "running";
+      activeset = true;
+    } else status = "pending";
+    if (status === "waiting") blocked = true;
+    const active = status === "running";
+    return {
+      stepid: step.id,
+      kind: step.kind,
+      status,
+      ...turnarounds?.[step.id] !== void 0 ? { durationms: turnarounds[step.id] } : {},
+      ...environments?.[step.id] !== void 0 ? { environment: environments[step.id] } : step.environment !== void 0 ? { environment: step.environment } : {},
+      active,
+      anchor: `#step-${step.id}`,
+      ...outcome !== void 0 ? { resultsummary: outcome.summary } : {}
+    };
+  });
+}
+var logstreamgenesis = "0".repeat(64);
+async function logstreameventof(input) {
+  if (input.summary.trim() === "") throw new Error("The logstream event needs its summary.");
+  const id = randomid();
+  const hash = await entryhashof({ previous: input.previous, entry: { id, runid: "surfaces", kind: "step", summary: input.summary, origin: input.origin, ...input.stepid !== void 0 ? { stepid: input.stepid } : {}, at: input.at } });
+  return { id, level: input.level, source: input.source, origin: input.origin, summary: input.summary, ...input.stepid !== void 0 ? { stepid: input.stepid } : {}, masked: input.masked, maskverdict: input.maskverdict, hash, at: input.at };
+}
+function appendlogstreamevent(events, event) {
+  return [...events, event];
+}
+function filterlogstream(events, filter) {
+  return events.filter((event) => (filter.level === void 0 || event.level === filter.level) && (filter.origin === void 0 || filter.origin === "" || event.origin === filter.origin) && (filter.stepid === void 0 || filter.stepid === "" || event.stepid === filter.stepid));
+}
+function livebufferof(events, bound) {
+  if (bound === void 0) return events;
+  if (!Number.isInteger(bound) || bound <= 0) return events;
+  return events.slice(-bound);
+}
+async function verifylogstream(events) {
+  for (let index = 0; index < events.length; index += 1) {
+    const event = events[index];
+    if (event === void 0) continue;
+    const predecessor = events[index - 1];
+    const expectedprevious = index === 0 || predecessor === void 0 ? logstreamgenesis : predecessor.hash.current;
+    if (event.hash.previous !== expectedprevious) return { valid: false, brokenat: index, reason: `The logstream chain breaks at the event ${event.id}: its previous hash does not link to its predecessor.` };
+    const recomputed = await entryhashof({ previous: event.hash.previous, entry: { id: event.id, runid: "surfaces", kind: "step", summary: event.summary, origin: event.origin, ...event.stepid !== void 0 ? { stepid: event.stepid } : {}, at: event.at } });
+    if (recomputed.current !== event.hash.current) return { valid: false, brokenat: index, reason: `The logstream chain breaks at the event ${event.id}: its own hash does not reproduce.` };
+  }
+  return { valid: true, reason: `The logstream chain of ${events.length} event${events.length === 1 ? "" : "s"} verifies link by link.` };
+}
+async function auditexcerptof(events, input) {
+  if (input.from < 0 || input.to <= input.from || input.to > events.length) return { ok: false, text: "", reason: `The excerpt range ${input.from} to ${input.to} names no contiguous slice of the ${events.length} event${events.length === 1 ? "" : "s"}.` };
+  const range = events.slice(input.from, input.to);
+  const verification = await verifylogstream(range);
+  if (!verification.valid) return { ok: false, text: "", reason: `The excerpt refuses the copy: ${verification.reason}` };
+  const text2 = range.map((event) => `[${event.at}] ${event.level} ${event.source}${event.stepid !== void 0 ? ` step ${event.stepid}` : ""} ${event.origin} \u2014 ${event.summary}${event.masked ? ` (${event.maskverdict})` : ""}`).join("\n");
+  return { ok: true, text: text2, reason: `The excerpt copied the verified range ${input.from} to ${input.to} of the logstream.` };
+}
+function loglevelof(kind) {
+  if (kind === "error") return "error";
+  if (["deny", "revoke", "stop", "quarantine", "phish", "defer", "schema", "expiry"].includes(kind)) return "warn";
+  return "info";
+}
+
 // llm.ts
 var defaultrefusalmarkers = ["i cannot", "i can't", "i'm unable", "refusal:", "cannot comply"];
 function buildrequest(input) {
@@ -15378,6 +15736,31 @@ function extensionpage(sender) {
 }
 async function audit(kind, summary, extra = {}) {
   await memory.addaudi({ id: randomid(), kind, at: Date.now(), summary, ...extra });
+  await recordsurfaceevent(kind, summary, extra);
+}
+var surfacechannel = typeof BroadcastChannel === "function" ? new BroadcastChannel("devthinksurfaces") : void 0;
+var logstreamhistory = [];
+var recentframes = [];
+async function recordsurfaceevent(kind, summary, extra = {}) {
+  try {
+    const session = await memory.getsession();
+    const origin = session?.origin ?? "";
+    if (origin === "") return;
+    const at = Date.now();
+    const lastevent = logstreamhistory[logstreamhistory.length - 1];
+    const previous = lastevent !== void 0 ? lastevent.hash.current : logstreamgenesis;
+    const event = await logstreameventof({ level: loglevelof(kind), source: "background", origin, summary, ...extra.stepid !== void 0 ? { stepid: extra.stepid } : {}, masked: extra.masked === true, maskverdict: extra.masked === true ? extra.maskverdict ?? "The source payload stayed masked before it streamed." : "The source payload carries no masked value.", previous, at });
+    logstreamhistory = appendlogstreamevent(logstreamhistory, event);
+    const frame = broadcastframeof({ channel: broadcastchannelof(kind), surface: "background", summary, at });
+    recentframes = [...recentframes, frame];
+    surfacechannel?.postMessage(frame);
+  } catch {
+  }
+}
+async function broadcastsurfaceframe(input) {
+  const frame = broadcastframeof({ ...input, at: Date.now() });
+  recentframes = [...recentframes, frame];
+  surfacechannel?.postMessage(frame);
 }
 function stepoptions6(step) {
   try {
@@ -21145,6 +21528,7 @@ var commandschemas = {
   sessions: { note: "object", scratch: "object", summary: "object", recall: "object", correction: "object", consent: "object", grid: "object", search: "object", cancel: "object", retry: "object", error: "object", settings: "object", bundle: "object" },
   environments: { action: "string", grants: "array", requestcapability: "boolean", pool: "object", offscreenclose: "boolean", sandbox: "object", settings: "object", render: "object", sandboxhost: "object" },
   transparency: {},
+  surface: { palette: "object", task: "object", onboarding: "object", bus: "object", broadcast: "object", layout: "object", logstream: "object", approve: "object", diff: "object", review: "object", timeline: "object", dashboard: "object", settings: "object" },
   execute: { stepid: "string" },
   configure: { endpoint: "string" }
 };
@@ -21371,6 +21755,279 @@ async function handlesessionscommand(message) {
   }
   throw new Error("The sessions command carries no note, scratch, summary, recall, correction, consent, grid, search, cancel, retry, error, settings or bundle action.");
 }
+async function grantedcapabilities() {
+  const report = await memory.getcapabilities();
+  const granted = ["activeTab", "storage", "scripting", "sidePanel"];
+  if (report?.tabs) granted.push("tabs");
+  if (report?.downloads) granted.push("downloads");
+  if (report?.clipboardread) granted.push("clipboardRead");
+  if (report?.clipboardwrite) granted.push("clipboardWrite");
+  if (await offscreengranted()) granted.push("offscreen");
+  return granted;
+}
+async function surfacesnapshotof(surface) {
+  const settings = await memory.getsettings();
+  const session = await memory.getsession();
+  const sessionactive = Boolean(session && !session.stoppedat && session.expiresat > Date.now());
+  const granted = await grantedcapabilities();
+  const plan = await memory.getplan();
+  const progress = await memory.getprogress();
+  const onboarding = await memory.getonboardingstate();
+  const palette = palettequery(palettecommandsof(surfacepalette(), { granted, sessionactive }), { text: "", usage: await memory.getpaletteusage(), ...settings?.paletterecents !== void 0 ? { recentwindow: settings.paletterecents } : {} });
+  const verification = await verifylogstream(logstreamhistory);
+  return surfacesnapshot({
+    surface,
+    palette,
+    timeline: plan ? stepstimelinenodes({ plan, ...progress !== void 0 && progress.planid === plan.id ? { progress } : {}, now: Date.now() }) : [],
+    logstream: { events: livebufferof(logstreamhistory, settings?.logstreambuffer).map((event) => ({ id: event.id, level: event.level, source: event.source, origin: event.origin, summary: event.summary, ...event.stepid !== void 0 ? { stepid: event.stepid } : {}, masked: event.masked, maskverdict: event.maskverdict, at: event.at })), chainvalid: verification.valid, reason: verification.reason },
+    plancards: plan !== void 0 ? plancardgroups(plancardsof({ plan, corrections: await memory.getcorrections() })) : [],
+    ...onboarding !== void 0 ? { onboarding: { stepscompleted: onboarding.stepscompleted, done: onboarding.done } } : {}
+  });
+}
+async function handlesurfacecommand(message) {
+  const input = message;
+  const now = Date.now();
+  const session = await memory.getsession();
+  const sessionactive = Boolean(session && !session.stoppedat && session.expiresat > now);
+  const settings = await memory.getsettings();
+  const plan = await memory.getplan();
+  const surfaceof = (value, fallback) => ["popup", "sidepanel", "dashboardpage", "optionspage", "onboarding"].includes(value ?? "") ? value : fallback;
+  if (input.palette !== void 0) {
+    const granted = await grantedcapabilities();
+    const entries = surfacepalette();
+    if (input.palette.used !== void 0) {
+      const command = input.palette.used.command?.trim() ?? "";
+      if (command === "") throw new Error("The palette use record needs its command.");
+      const usage = paletteuseafter(await memory.getpaletteusage(), command, now);
+      const record2 = usage[0];
+      if (record2 === void 0) throw new Error("The palette use record never landed.");
+      await memory.setpaletteusage(usage);
+      await audit("palette", `The user ran the ${command} command from the commandpalette; its ${record2.count} recorded use${record2.count === 1 ? "" : "s"} rank it first among equal matches.`, { ...session ? { sessionid: session.id } : {} });
+      return { usage: record2 };
+    }
+    if (input.palette.query !== void 0) {
+      const matches = palettequery(palettecommandsof(entries, { granted, sessionactive }), { text: input.palette.query.text ?? "", usage: await memory.getpaletteusage(), ...settings?.paletterecents !== void 0 ? { recentwindow: settings.paletterecents } : {} });
+      return { matches };
+    }
+    return { entries: palettecommandsof(entries, { granted, sessionactive }) };
+  }
+  if (input.task !== void 0) {
+    if (input.task.submit !== void 0) {
+      if (!session || session.stoppedat || session.expiresat <= now) throw new Error("Start a current browser session before submitting a task goal.");
+      const { tab, origin } = await activecontext();
+      if (session.tabid !== tab.id || session.origin !== origin) throw new Error("The selected tab or origin no longer matches the approved session.");
+      const version = await memory.getobservationversion();
+      const storedobservation = version !== void 0 ? await memory.getobservation(version) : void 0;
+      const context = storedobservation ? `${storedobservation.observation.title}: ${storedobservation.observation.textpreview}` : tab.title ?? "";
+      const submission = taskinputof({ text: input.task.submit.text ?? "", context, origin, surface: surfaceof(input.task.submit.surface, "popup"), at: now });
+      await memory.addtaskinput(submission);
+      const proposed = await propose(submission.text, false);
+      await audit("surface", `The ${submission.surface} taskinput submitted a natural language goal for ${origin} with the active origin and the page outline attached; the goal routed through the same proposal flow as the api and the plan ${proposed.id} now awaits its plancard review.`, { sessionid: session.id, planid: proposed.id });
+      await broadcastsurfaceframe({ channel: "runstate", surface: "background", summary: `A taskinput goal became the plan ${proposed.id} and awaits review.` });
+      return { submission, plan: proposed, status: "ready" };
+    }
+    if (input.task.history === true) return { history: await memory.gettaskinputs() };
+    if (input.task.status === true) return { status: plan === void 0 ? "idle" : plan.state === "pending" ? "ready" : plan.state === "approved" ? "ready" : "failed" };
+  }
+  if (input.onboarding !== void 0) {
+    const state = await memory.getonboardingstate();
+    if (input.onboarding.complete !== void 0) {
+      const stepid = input.onboarding.complete.stepid?.trim() ?? "";
+      const current = state ?? onboardingstart(void 0, now);
+      const completion = onboardingcomplete(current, stepid, now);
+      if (completion.consentevent !== void 0) {
+        const consentgate = onboardingconsentgate({ consentevents: current.consentevent !== void 0 ? [current.consentevent] : [] });
+        if (!consentgate.allowed) throw new Error(consentgate.reason);
+        const origin = session?.origin ?? "onboarding";
+        await memory.addconsentmemoryentry(consentmemoryof({ origin, decision: "grant", boundary: "onboarding", kinds: [], now }));
+      }
+      await memory.setonboardingstate(completion.state);
+      await audit("onboarding", completion.consentevent !== void 0 ? `The user finished the onboarding walkthrough and its completion wrote the single consent scoped event ${completion.consentevent}; the walkthrough never writes a second one.` : `The user completed the ${stepid} step of the onboarding walkthrough; ${completion.state.stepscompleted.length} of ${onboardingsteps().length} steps stand done.`, { ...session ? { sessionid: session.id } : {} });
+      await broadcastsurfaceframe({ channel: "settings", surface: "background", summary: completion.consentevent !== void 0 ? "The onboarding walkthrough completed." : `The onboarding step ${stepid} completed.` });
+      return { steps: onboardingsteps(), state: completion.state, ...completion.consentevent !== void 0 ? { consentevent: completion.consentevent } : {} };
+    }
+    if (input.onboarding.replay === true) {
+      const replayed = onboardingstart(state, now);
+      await memory.setonboardingstate(replayed);
+      await audit("onboarding", "The user replayed the onboarding walkthrough on demand from the optionspage; the replay restarts the steps and writes no second consent event.", {});
+      return { steps: onboardingsteps(), state: replayed };
+    }
+    return { steps: onboardingsteps(), ...state ? { state } : {} };
+  }
+  if (input.bus !== void 0 && input.bus.action !== void 0) {
+    const surface = surfaceof(input.bus.action.surface, "popup");
+    const command = input.bus.action.command?.trim() ?? "";
+    const action = { surface, command, ...input.bus.action.stepid !== void 0 && input.bus.action.stepid.trim() !== "" ? { stepid: input.bus.action.stepid } : {}, ...input.bus.action.payload !== void 0 && input.bus.action.payload.trim() !== "" ? { payload: input.bus.action.payload } : {} };
+    const granted = await grantedcapabilities();
+    const route = busrouteaction(action, { sessionactive, granted, planreviewed: Boolean(plan && plan.state === "approved"), planstate: plan?.state === "pending" ? "pending" : "approved", text: input.bus.action.payload ?? "", origin: session?.origin ?? "" });
+    if (!route.dispatched) throw new Error(route.reason);
+    await audit("surface", `The ${surface} routed the ${command} action through the command bus: ${route.reason}`, { ...session ? { sessionid: session.id } : {}, ...plan ? { planid: plan.id } : {} });
+    if (command === "starttask") {
+      if (!sessionactive) await handlerequest({ kind: "startsession" }, {});
+      const goal = (input.bus.action.payload ?? "").trim();
+      if (goal !== "") await propose(goal, false);
+    } else if (command === "pauserun") await handlerequest({ kind: "pausesession" }, {});
+    else if (command === "resumerun") await handlerequest({ kind: "resumesession" }, {});
+    else if (command === "cancelrun") {
+      if (plan) await handlerequest({ kind: "sessions", cancel: { runid: plan.id } }, {}).catch(() => {
+      });
+    } else if (command === "revokeconsent") {
+      if (session) await handlerequest({ kind: "security", allowlist: { remove: { origin: session.origin } } }, {}).catch(() => {
+      });
+    }
+    await broadcastsurfaceframe({ channel: "runstate", surface, summary: `The ${command} action of the ${surface} dispatched through the command bus.` });
+    return { route, palette: palettecommandsof(surfacepalette(), { granted, sessionactive }) };
+  }
+  if (input.broadcast !== void 0 && input.broadcast.frames === true) {
+    const bound = settings?.logstreambuffer;
+    const boundgate = logbufferboundvalid(bound);
+    if (!boundgate.allowed) throw new Error(boundgate.reason);
+    return { frames: bound === void 0 ? recentframes : recentframes.slice(-bound), logstream: livebufferof(logstreamhistory, bound), total: logstreamhistory.length };
+  }
+  if (input.layout !== void 0) {
+    if (input.layout.set !== void 0) {
+      const surface = surfaceof(input.layout.set.surface, "popup");
+      const preferences = input.layout.set.preferences ?? {};
+      await memory.setsurfacelayout({ surface, preferences, updatedat: now });
+      await audit("surface", `The user saved the layout preferences of the ${surface} with ${Object.keys(preferences).length} key${Object.keys(preferences).length === 1 ? "" : "s"}; the preferences scope per profile workspace and take effect without a reload.`, { ...session ? { sessionid: session.id } : {} });
+      return { layout: { surface, preferences, updatedat: now } };
+    }
+    if (input.layout.get !== void 0) return { layout: await memory.getsurfacelayout(surfaceof(input.layout.get.surface, "popup")) };
+  }
+  if (input.logstream !== void 0) {
+    if (input.logstream.read !== void 0) {
+      const stored = await memory.getlogstreamfilters();
+      const requested = input.logstream.read.filters;
+      const level = requested?.level !== void 0 && requested.level !== "" ? requested.level : stored?.level;
+      const origin = requested?.origin !== void 0 && requested.origin !== "" ? requested.origin : stored?.origin;
+      const stepid = requested?.stepid !== void 0 && requested.stepid !== "" ? requested.stepid : stored?.stepid;
+      const filter = {};
+      if (level !== void 0 && level !== "") filter.level = level;
+      if (origin !== void 0 && origin !== "") filter.origin = origin;
+      if (stepid !== void 0 && stepid !== "") filter.stepid = stepid;
+      const verification = await verifylogstream(logstreamhistory);
+      return { events: filterlogstream(livebufferof(logstreamhistory, settings?.logstreambuffer), filter), chain: verification, total: logstreamhistory.length };
+    }
+    if (input.logstream.excerpt !== void 0) {
+      const from = input.logstream.excerpt.from ?? 0;
+      const to = input.logstream.excerpt.to ?? logstreamhistory.length;
+      const excerpt = await auditexcerptof(logstreamhistory, { from, to });
+      const gate = logstreamegressgate({ verified: excerpt.ok, entries: Math.max(0, Math.min(to, logstreamhistory.length) - Math.max(0, from)) });
+      if (!gate.allowed) throw new Error(gate.reason);
+      await audit("logstream", `The user copied the verified range ${from} to ${to} of the live logstream as an audit excerpt; the copy left the stream only after the chain verified.`, { ...session ? { sessionid: session.id } : {} });
+      return { excerpt: excerpt.text, reason: excerpt.reason };
+    }
+    if (input.logstream.filters?.set !== void 0) {
+      const requested = input.logstream.filters.set;
+      const filter = {};
+      if (requested?.level !== void 0 && requested.level !== "") filter.level = requested.level;
+      if (requested?.origin !== void 0 && requested.origin !== "") filter.origin = requested.origin;
+      if (requested?.stepid !== void 0 && requested.stepid !== "") filter.stepid = requested.stepid;
+      await memory.setlogstreamfilters(filter);
+      await audit("surface", `The user saved the logstream filter preferences${Object.keys(filter).length > 0 ? ` for ${Object.entries(filter).map(([key, value]) => `${key} ${value}`).join(" and ")}` : ""}; the live view reopens with them.`, {});
+      return { filters: filter };
+    }
+  }
+  if (input.approve !== void 0 && input.approve.resolve !== void 0) {
+    const stepid = input.approve.resolve.stepid?.trim() ?? "";
+    const resolution = input.approve.resolve.resolution === "approve" || input.approve.resolve.resolution === "edit" ? input.approve.resolve.resolution : input.approve.resolve.resolution === "reject" ? "reject" : void 0;
+    if (resolution === void 0) throw new Error("The stepapprove resolution needs its approve, reject or edit decision.");
+    const surface = surfaceof(input.approve.resolve.surface, "sidepanel");
+    if (!plan || !["pending", "approved"].includes(plan.state)) throw new Error("The stepapprove resolution serves the pending or approved plan under review.");
+    const step = plan.steps.find((candidate) => candidate.id === stepid);
+    if (!step) throw new Error(`No step ${stepid} of the plan ${plan.id} exists to resolve.`);
+    const gate = stepapprovegate({ stepids: [stepid], resolution, surface });
+    if (!gate.allowed) throw new Error(gate.reason);
+    const record2 = stepresolutionof({ stepid, planid: plan.id, origin: plan.origin, resolution, surface, ...resolution === "edit" && input.approve.resolve.edited !== void 0 ? { edited: input.approve.resolve.edited } : {}, at: now });
+    await memory.addstepapproveresolution(record2);
+    const event = resolutionlogeventof(record2);
+    if (resolution === "edit") {
+      const edited = input.approve.resolve.edited ?? "";
+      try {
+        const shape = JSON.parse(edited);
+        const editedkind = shape.kind;
+        const editedsummary = shape.summary;
+        if (typeof editedkind !== "string" || editedkind.trim() === "" || typeof editedsummary !== "string" || editedsummary.trim() === "") throw new Error("The edited step shape needs its kind and summary.");
+        await memory.setplan({ ...plan, steps: plan.steps.map((candidate) => candidate.id === stepid ? { ...candidate, kind: editedkind, summary: editedsummary, ...shape.target !== void 0 ? { target: shape.target } : {}, ...shape.value !== void 0 ? { value: shape.value } : {}, ...shape.options !== void 0 ? { options: shape.options } : {} } : candidate) });
+        await memory.addcorrection(editedcorrectionof({ origin: plan.origin, kind: step.kind, stepid, original: JSON.stringify({ kind: step.kind, summary: step.summary, ...step.target !== void 0 ? { target: step.target } : {}, ...step.value !== void 0 ? { value: step.value } : {}, ...step.options !== void 0 ? { options: step.options } : {} }), corrected: edited, reason: `The user edited the step ${stepid} from the ${surface} before approving.`, now }));
+      } catch (error) {
+        throw new Error(error instanceof Error ? error.message : "The edited step shape failed to parse.");
+      }
+    }
+    if (resolution === "reject") await memory.addcorrection(rejectedcorrectionof({ origin: plan.origin, kind: step.kind, stepid, original: JSON.stringify({ kind: step.kind, summary: step.summary }), reason: `The user rejected the step ${stepid} from the ${surface}.`, now }));
+    await appendrunevent("review", event.summary, session, plan.origin, stepid);
+    await audit("approval", event.summary, { ...session ? { sessionid: session.id } : {}, planid: plan.id, stepid });
+    await broadcastsurfaceframe({ channel: "runstate", surface, summary: `The step ${stepid} resolved with a ${resolution} from the ${surface}.` });
+    return { resolution: record2, cards: plancardsof({ plan: await memory.getplan() ?? plan, corrections: await memory.getcorrections() }) };
+  }
+  if (input.diff !== void 0 && input.diff.preview !== void 0) {
+    const stepid = input.diff.preview.stepid?.trim() ?? "";
+    if (!plan) throw new Error("The diffpreview serves the plan under review.");
+    const step = plan.steps.find((candidate) => candidate.id === stepid);
+    if (!step) throw new Error(`No step ${stepid} of the plan ${plan.id} exists to preview.`);
+    const gate = diffpreviewgate({ risk: step.risk });
+    if (!gate.allowed) throw new Error(gate.reason);
+    if (!session) throw new Error("The diffpreview needs its session to observe the before state.");
+    const before = input.diff.preview.before ?? {};
+    const options = stepoptions6(step);
+    const predicted = { ...Object.fromEntries(Object.entries(options).filter(([, value]) => typeof value === "string" || typeof value === "number" || typeof value === "boolean").map(([key, value]) => [key, String(value)])), ...step.value !== void 0 ? { value: step.value } : {}, ...step.target !== void 0 ? { target: step.target } : {} };
+    const after = Object.keys(input.diff.preview.after ?? {}).length > 0 ? input.diff.preview.after : predicted;
+    const payload = JSON.stringify({ before, after });
+    let provenance = "inline";
+    if (settings?.diffpreviewbytes !== void 0 && payload.length >= settings.diffpreviewbytes && await offscreengranted()) {
+      try {
+        const answer = await chrome.runtime.sendMessage({ kind: "offscreen", action: "parse", request: { id: randomid(), runid: plan.id, stepid, task: "diffpreview", payload, transferables: [] } });
+        if (answer?.ok === true) provenance = "offscreenworker";
+      } catch {
+      }
+    }
+    const sensitivefields = [.../* @__PURE__ */ new Set([...Object.keys(before), ...Object.keys(after)])].filter((field) => defaultmaskshapes.some((shape) => field.toLowerCase().includes(shape)));
+    const preview = diffpreviewof({ stepid, before, after, maskverdicts: maskverdictsof({ ...before, ...after }, sensitivefields), provenance });
+    await audit("diff", `The user opened the diffpreview of the write class step ${stepid} of the plan ${plan.id}: ${preview.changes.filter((change) => change.kind === "added").length} added, ${preview.changes.filter((change) => change.kind === "changed").length} changed and ${preview.changes.filter((change) => change.kind === "removed").length} removed field${preview.changes.length === 1 ? "" : "s"}${preview.maskverdicts && Object.keys(preview.maskverdicts).length > 0 ? ` with ${Object.keys(preview.maskverdicts).length} masked value${Object.keys(preview.maskverdicts).length === 1 ? "" : "s"} carrying their mask verdicts` : ""}${provenance === "offscreenworker" ? "; the generation offloaded to the offscreen worker pool" : ""}.`, { ...session ? { sessionid: session.id } : {}, planid: plan.id, stepid });
+    return { preview };
+  }
+  if (input.review !== void 0) {
+    const corrections = await memory.getcorrections();
+    const cards = plan ? plancardsof({ plan, corrections }) : [];
+    if (input.review.groups !== void 0 || input.review.cards !== void 0) return { cards, groups: plancardgroups(cards) };
+    return { cards };
+  }
+  if (input.timeline !== void 0 && input.timeline.nodes === true) {
+    if (!plan) return { nodes: [] };
+    const progress = await memory.getprogress();
+    return { nodes: stepstimelinenodes({ plan, ...progress !== void 0 && progress.planid === plan.id ? { progress } : {}, now }) };
+  }
+  if (input.dashboard !== void 0 && input.dashboard.view === true) {
+    const view = await memory.gettransparencyview();
+    const report = transparencyreport({ grants: transparencygrants({ allowlist: view.allowlist, profiles: view.profiles }), windows: windowhistory(view.windows), connectallow: connectallowlist(view.connectallow), permdiffs: view.permdiffs, safedefaults: view.safedefaults, vault: vaultview(view.vault) });
+    const onboarding = await memory.getonboardingstate();
+    return { sessionview: await sessionviewof(), transparency: report, onboarding: onboarding ?? { stepscompleted: [], done: false }, environments: await environmentviewof(), security: await securityviewof() };
+  }
+  if (input.snapshot !== void 0) return await surfacesnapshotof(surfaceof(input.snapshot.surface, "popup"));
+  if (input.settings !== void 0) {
+    const current = settings ?? {};
+    if (input.settings.logstreambuffer !== void 0) {
+      const boundgate = logbufferboundvalid(input.settings.logstreambuffer);
+      if (!boundgate.allowed) throw new Error(boundgate.reason);
+    }
+    if (input.settings.paletterecents !== void 0 && (!Number.isInteger(input.settings.paletterecents) || input.settings.paletterecents < 0)) throw new Error("The palette recent window stays a whole number of commands the user chose.");
+    if (input.settings.taskinputretention !== void 0 && input.settings.taskinputretention <= 0) throw new Error("The taskinput history retention stays a positive user value in milliseconds.");
+    if (input.settings.diffpreviewbytes !== void 0 && input.settings.diffpreviewbytes <= 0) throw new Error("The diffpreview byte ceiling stays a positive user value.");
+    const next = {
+      ...current,
+      ...input.settings.paletterecents !== void 0 ? { paletterecents: input.settings.paletterecents } : {},
+      ...input.settings.logstreambuffer !== void 0 ? { logstreambuffer: input.settings.logstreambuffer } : {},
+      ...input.settings.taskinputretention !== void 0 ? { taskinputretention: input.settings.taskinputretention } : {},
+      ...input.settings.paletteshortcut !== void 0 ? { paletteshortcut: input.settings.paletteshortcut } : {},
+      ...input.settings.diffpreviewbytes !== void 0 ? { diffpreviewbytes: input.settings.diffpreviewbytes } : {}
+    };
+    await memory.setsettings(next);
+    await audit("configure", `The user set the interface surface options${input.settings.paletterecents !== void 0 ? ` with the palette recent window of ${input.settings.paletterecents}` : ""}${input.settings.logstreambuffer !== void 0 ? ` and the logstream live buffer bound of ${input.settings.logstreambuffer}` : ""}${input.settings.paletteshortcut !== void 0 ? ` and the palette shortcut ${input.settings.paletteshortcut}` : ""}${input.settings.diffpreviewbytes !== void 0 ? ` and the diffpreview byte ceiling of ${input.settings.diffpreviewbytes}` : ""}; every write takes effect without reloading the extension.`, { ...session ? { sessionid: session.id } : {} });
+    await broadcastsurfaceframe({ channel: "settings", surface: "optionspage", summary: "The interface surface options changed and take effect without a reload." });
+    return { settings: next };
+  }
+  throw new Error("The surface command carries no palette, task, onboarding, bus, broadcast, layout, logstream, approve, diff, review, timeline, dashboard, snapshot or settings action.");
+}
 async function handlerequest(message, sender) {
   const originverdict = origincheckof({ ...sender.id !== void 0 ? { senderid: sender.id } : {}, ...sender.origin !== void 0 ? { senderorigin: sender.origin } : {}, extensionid: chrome.runtime.id, connectallow: await memory.getconnectallow() });
   const inboundgate = origincheckgate({ verdict: originverdict });
@@ -21506,7 +22163,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()] } : {}, mcp: await mcpstateof(), llm: await llmstateof(), swarm: await swarmstateof(), environments: await environmentviewof(), security: await securityviewof(), sessionview: await sessionviewof(), sessionpreferences: { ...runsettings?.recallwindow !== void 0 ? { recallwindow: runsettings.recallwindow } : {}, ...runsettings?.noteretention !== void 0 ? { noteretention: runsettings.noteretention } : {}, ...runsettings?.scratchpadretention !== void 0 ? { scratchpadretention: runsettings.scratchpadretention } : {}, ...runsettings?.summaryretention !== void 0 ? { summaryretention: runsettings.summaryretention } : {}, ...runsettings?.correctionretention !== void 0 ? { correctionretention: runsettings.correctionretention } : {}, ...runsettings?.summarywindow !== void 0 ? { summarywindow: runsettings.summarywindow } : {}, ...runsettings?.historyindex !== void 0 ? { historyindex: runsettings.historyindex } : {}, ...runsettings?.cancelrollback !== void 0 ? { cancelrollback: runsettings.cancelrollback } : {} } };
+      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(), llm: await llmstateof(), swarm: await swarmstateof(), environments: await environmentviewof(), security: await securityviewof(), sessionview: await sessionviewof(), surfacepreferences: { ...runsettings?.paletterecents !== void 0 ? { paletterecents: runsettings.paletterecents } : {}, ...runsettings?.paletteshortcut !== void 0 ? { paletteshortcut: runsettings.paletteshortcut } : {}, ...runsettings?.logstreambuffer !== void 0 ? { logstreambuffer: runsettings.logstreambuffer } : {}, ...runsettings?.taskinputretention !== void 0 ? { taskinputretention: runsettings.taskinputretention } : {}, ...runsettings?.diffpreviewbytes !== void 0 ? { diffpreviewbytes: runsettings.diffpreviewbytes } : {} }, sessionpreferences: { ...runsettings?.recallwindow !== void 0 ? { recallwindow: runsettings.recallwindow } : {}, ...runsettings?.noteretention !== void 0 ? { noteretention: runsettings.noteretention } : {}, ...runsettings?.scratchpadretention !== void 0 ? { scratchpadretention: runsettings.scratchpadretention } : {}, ...runsettings?.summaryretention !== void 0 ? { summaryretention: runsettings.summaryretention } : {}, ...runsettings?.correctionretention !== void 0 ? { correctionretention: runsettings.correctionretention } : {}, ...runsettings?.summarywindow !== void 0 ? { summarywindow: runsettings.summarywindow } : {}, ...runsettings?.historyindex !== void 0 ? { historyindex: runsettings.historyindex } : {}, ...runsettings?.cancelrollback !== void 0 ? { cancelrollback: runsettings.cancelrollback } : {} } };
     }
     case "capabilities":
       return refreshcapabilities();
@@ -24578,6 +25235,8 @@ async function handlerequest(message, sender) {
     }
     case "sessions":
       return handlesessionscommand(message);
+    case "surface":
+      return handlesurfacecommand(message);
     case "security": {
       const input2 = message;
       const now = Date.now();
@@ -25629,6 +26288,14 @@ chrome.runtime.onStartup.addListener(() => {
   void runwatchdog().catch(() => {
   });
 });
+chrome.runtime.onInstalled.addListener((details) => {
+  void (async () => {
+    if (details.reason !== "install") return;
+    await memory.setonboardingstate(onboardingstart(await memory.getonboardingstate(), Date.now()));
+    await audit("onboarding", "Devthink installed for the first time and the onboarding walkthrough started; it walks the origin grants, the plan review, the run control and the log audit once.", {});
+  })().catch(() => {
+  });
+});
 async function pauseinterruptedworkflowruns() {
   for (const run of await memory.listworkflowruns()) {
     if (run.state !== "running") continue;