@lensmcp/protocol-types 1.25.12 → 1.25.14

package/lib/capture-demand.d.ts

@@ -6,7 +6,7 @@
  * Why a file and not the event bus: the bus is ONE-WAY. Producers (the Vite
  * plugin, the NestJS instrumentation, the capture runner) append to
  * `LENSMCP_EVENT_FILE` / the UDS socket and the MCP session tails it — nothing
- * flows back. So `visual.capture_frame` publishing a `visual-capture-request`
+ * flows back. So `visual_capture_frame` publishing a `visual-capture-request`
  * onto the MCP's in-process bus was a DEAD LETTER: the runner never saw it,
  * which is why capture had to poll a live Chrome forever (measured on a real
  * machine, 2026-07-29: 2 runners + >1GB of Chrome resident for 1d8h with
@@ -26,7 +26,7 @@ export declare const CAPTURE_REQUEST_FILENAME = "capture-request.json";
  * Presence-file name (same directory). The runner writes it at startup and
  * removes it on a clean stop.
  *
- * Its job is to keep the requester honest: `visual.capture_frame` now WAITS for
+ * Its job is to keep the requester honest: `visual_capture_frame` now WAITS for
  * the fresh frame it asked for (a cold browser needs ~1s), and without a way to
  * tell "a runner is warming up" from "no runner exists" that wait would also be
  * paid by every workspace running with capture disabled or no Chrome installed
@@ -74,7 +74,7 @@ export declare function appMatchesPage(app: string, page: CapturePage): boolean;
 /**
  * Session-rules file name (same directory).
  *
- * `visual.register_rule` had the dead-letter problem this module describes for
+ * `visual_register_rule` had the dead-letter problem this module describes for
  * capture requests, and kept it after they were fixed: it published
  * `visual-rule-registered` onto the MCP's in-process bus, where only the
  * reducer heard it. The reducer listed the rule and counted it ("1 rule
@@ -86,7 +86,7 @@ export declare function appMatchesPage(app: string, page: CapturePage): boolean;
  * reads them before each capture.
  */
 export declare const CAPTURE_RULES_FILENAME = "capture-rules.json";
-/** One rule registered through `visual.register_rule`. */
+/** One rule registered through `visual_register_rule`. */
 export interface CaptureSessionRule {
     /** The rule, in the `lensmcp.rules.json` shape. Validate on read — it crossed
      *  a process boundary, and a hand-edited file must not crash a capture. */

package/lib/dashboard.d.ts

@@ -1719,7 +1719,7 @@ export interface DashDbSchema {
     /** The newest read failed, and this is the last one that did not: why the newer failed, and when. */
     kept?: DashDbKept;
 }
-/** One database's last read by LensMCP's own checks (`db.schema`), as `db://analysis` names it beside the analyzer's runs. */
+/** One database's last read by LensMCP's own checks (`db_schema`), as `db://analysis` names it beside the analyzer's runs. */
 export interface DashDbChecksSeen {
     store: string;
     database: string;
@@ -2718,10 +2718,12 @@ export interface DashSuggestion {
     current: boolean;
     /** A review newer than its state still asks for it — an applied change that did not do it (a closed one reopens as new). */
     askedAgainAt?: number;
-    /** What it is about and where to read more (`suggestion.get`, the dashboard's detail): its target, what its review rested on, what it names. */
+    /** What it is about and where to read more (`suggestion_get`, the dashboard's detail): its target, what its review rested on, what it names. */
     refs?: DashSuggestionRef[];
-    /** The checks scheduled on it, newest first (`suggestion.get`, the dashboard's detail); in a list, how many wait. */
+    /** The checks scheduled on it, newest first (`suggestion_get`, the dashboard's detail); in a list, how many wait. */
     checks?: DashSuggestionCheck[];
+    /** A check to start from, read from its verify line (`suggestion_get`, the dashboard's Check a number…) — never scheduled by itself. */
+    proposedCheck?: DashCheckProposal;
     checksWaiting?: number;
 }
 /** One thing a suggestion is about, or rests on — and how to read it. */
@@ -2760,6 +2762,12 @@ export interface DashCheckMeasure {
     /** How long since the check began before it can pass — an error not seen again needs time to pass (default 30 min for `occurrences`). */
     holdMs?: number;
 }
+/** A check read from a finding's own words: measures to schedule as they are, or its review run anew — and what they were read from. */
+export interface DashCheckProposal {
+    measures?: DashCheckMeasure[];
+    review?: true;
+    from: string;
+}
 /** What one look of a check found. */
 export interface DashCheckResult {
     at: number;
@@ -2780,7 +2788,7 @@ export interface DashCheckResult {
     text: string;
 }
 /**
- * A check scheduled on a suggestion (by a coding agent, `suggestion.check`, or a developer): LensMCP looks again — at
+ * A check scheduled on a suggestion (by a coding agent, `suggestion_check`, or a developer): LensMCP looks again — at
  * the lens's numbers since it began (`measure`), or by reviewing its target anew (`review`, a paid run) — and closes
  * the suggestion when it passes. It looks first at `after`, then every `everyMs`, and gives up at `until`.
  */
@@ -3380,7 +3388,7 @@ export interface DashAgentEvent {
     at: number;
     /** `ask`: a prompt the person gave it (the Claude Code plugin's hook) — `result` holds its first line. */
     kind: 'tool' | 'read' | 'say' | 'ask';
-    /** The tool or the resource URI; `agent.task` for `say`; `prompt` for `ask`. */
+    /** The tool or the resource URI; `agent_task` for `say`; `prompt` for `ask`. */
     name: string;
     /** Its arguments, redacted, as JSON (at most 2 KB). */
     args?: string;
@@ -3406,13 +3414,13 @@ export interface DashAgentSession {
     lastSeenAt: number;
     /** Ended: when its shim exited (or, without one, its last call). */
     endedAt?: number;
-    /** What it says it is doing (`agent.task`): the task's first line, and the step it is on. */
+    /** What it says it is doing (`agent_task`): the task's first line, and the step it is on. */
     task?: string;
     step?: string;
     saidAt?: number;
     /**
      * What the person last asked it — the prompt's first line, recorded by the LensMCP Claude Code plugin's
-     * `UserPromptSubmit` hook, so a session shows its task even when the agent never calls `agent.task`.
+     * `UserPromptSubmit` hook, so a session shows its task even when the agent never calls `agent_task`.
      */
     asked?: string;
     askedAt?: number;

package/lib/error-dismissal.d.ts

@@ -18,7 +18,7 @@ import type { BaseEvent } from './event.js';
  *  - **It is undone the same way** (`error-restored`), and what is hidden is still listed.
  *
  * WHO may write one: a person in the dashboard, a person at the CLI, and an agent through
- * `observe.dismiss_errors`. The last two name EVENTS, not a dashboard row, and must say why —
+ * `observe_dismiss_errors`. The last two name EVENTS, not a dashboard row, and must say why —
  * `by` and `reason` travel with the dismissal and are shown wherever it is listed, so a status
  * that went quiet because an agent dismissed something says exactly that.
  */

package/lib/sources.d.ts

@@ -16,8 +16,8 @@
  *     ({@link SourceDeclarationRaw}). A group's `key` travels as `group`: the bus redacts any field NAMED `key`
  *     (`@lensmcp/core` `isSecretParam`), which would have turned every group into `[REDACTED]`. The cluster MIRRORS
  *     these shapes (it does not depend on this package); a parity fixture pins both sides.
- *  3. The READ — `apps/agent` folds them into `process://sources` ({@link SourcesReport}); the `observe.sources` and
- *     `source.get` tools, the status signal and the dashboard read that.
+ *  3. The READ — `apps/agent` folds them into `process://sources` ({@link SourcesReport}); the `observe_sources` and
+ *     `source_get` tools, the status signal and the dashboard read that.
  *
  * Phase 2 adds:
  *  - the `loop` kind — a background loop, scheduler or sweep answering `lensmcp.loop/v1` ({@link LoopSnapshotRaw});
@@ -546,7 +546,7 @@ export interface SourcePushedEvent {
     counterpart?: string;
     correlation?: string;
     error?: string;
-    /** The flow it ran in — open it with flow.get. */
+    /** The flow it ran in — open it with flow_get. */
     flowId?: string;
     requestId?: string;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lensmcp/protocol-types",
-  "version": "1.25.12",
+  "version": "1.25.14",
   "type": "module",
   "main": "./index.js",
   "module": "./index.js",