@lensmcp/protocol-types 1.25.23 → 1.25.25

package/index.d.ts

@@ -22,3 +22,5 @@ export * from './lib/perf-rules.js';
 export * from './lib/sources.js';
 export * from './lib/page-visit.js';
 export * from './lib/replay.js';
+export * from './lib/event-loop.js';
+export * from './lib/workspace-actions.js';

package/index.js

@@ -1 +1 @@
-"use strict";export*from"./lib/schema-version.js";export*from"./lib/source-location.js";export*from"./lib/context.js";export*from"./lib/event.js";export*from"./lib/node.js";export*from"./lib/edge.js";export*from"./lib/attributes.js";export*from"./lib/producer-health.js";export*from"./lib/resources.js";export*from"./lib/tokens.js";export*from"./lib/capture-demand.js";export*from"./lib/bounded-clone.js";export*from"./lib/bounded-map.js";export*from"./lib/flood-guard.js";export*from"./lib/dashboard.js";export*from"./lib/log-query.js";export*from"./lib/error-dismissal.js";export*from"./lib/ai-content.js";export*from"./lib/http-exchange.js";export*from"./lib/pod-memory.js";export*from"./lib/perf-rules.js";export*from"./lib/sources.js";export*from"./lib/page-visit.js";export*from"./lib/replay.js";
+"use strict";export*from"./lib/schema-version.js";export*from"./lib/source-location.js";export*from"./lib/context.js";export*from"./lib/event.js";export*from"./lib/node.js";export*from"./lib/edge.js";export*from"./lib/attributes.js";export*from"./lib/producer-health.js";export*from"./lib/resources.js";export*from"./lib/tokens.js";export*from"./lib/capture-demand.js";export*from"./lib/bounded-clone.js";export*from"./lib/bounded-map.js";export*from"./lib/flood-guard.js";export*from"./lib/dashboard.js";export*from"./lib/log-query.js";export*from"./lib/error-dismissal.js";export*from"./lib/ai-content.js";export*from"./lib/http-exchange.js";export*from"./lib/pod-memory.js";export*from"./lib/perf-rules.js";export*from"./lib/sources.js";export*from"./lib/page-visit.js";export*from"./lib/replay.js";export*from"./lib/event-loop.js";export*from"./lib/workspace-actions.js";

package/lib/dashboard.d.ts

@@ -295,6 +295,85 @@ export interface DashWorktree {
     data?: string[];
     updatedAt?: string;
 }
+/** Worktree management always runs on the main checkout's dashboard. */
+export interface DashWorktreeManagement {
+    mainRoot: string;
+    managementUrl: string;
+    canManage: boolean;
+    worktrees: Array<{
+        key: string;
+        name: string;
+        root: string;
+        state: string;
+        branch?: string;
+        createdByLens: boolean;
+        data: string[];
+    }>;
+}
+export interface DashCheckoutChanges {
+    root: string;
+    head: string;
+    branch?: string;
+    changes: Array<{
+        path: string;
+        staged: string;
+        unstaged: string;
+        from?: string;
+    }>;
+}
+export interface DashWorktreeComparison {
+    at: number;
+    mode: 'working' | 'committed';
+    main: DashCheckoutChanges;
+    worktree: DashCheckoutChanges;
+    ahead: number;
+    behind: number;
+    files: Array<{
+        path: string;
+        kind: 'added' | 'deleted' | 'modified';
+        binary?: boolean;
+        unavailable?: string;
+        added?: number;
+        removed?: number;
+    }>;
+    total: number;
+    nextOffset?: number;
+    partial: boolean;
+    notes: string[];
+}
+export interface DashWorktreePatch {
+    path: string;
+    text?: string;
+    unavailable?: string;
+    truncated?: boolean;
+}
+export interface DashWorktreeRemoval {
+    token: string;
+    key: string;
+    name: string;
+    root: string;
+    directoryExists: boolean;
+    branch?: string;
+    changes: DashCheckoutChanges['changes'];
+    ahead: number;
+    data: string[];
+    canRemove: boolean;
+    reason?: string;
+}
+export interface DashWorktreeAction {
+    id: string;
+    key: string;
+    action: 'stop' | 'remove';
+    state: 'running' | 'succeeded' | 'failed';
+    stage: string;
+    startedAt: number;
+    finishedAt?: number;
+    error?: string;
+    directoryExists?: boolean;
+    remainingData?: string[];
+    remainingDataOmitted?: number;
+    branch?: string;
+}
 export interface DashKpis {
     at: number;
     /** The window `last` covers, in seconds. */
@@ -513,6 +592,7 @@ export interface DashSegmentStats {
 }
 export interface DashFlowDetail {
     flowId: string;
+    eventLoopIncidents?: import('./event-loop.js').EventLoopIncident[];
     /** The reducer's own summary (kept as-is for older consumers). */
     summary: unknown;
     events: DashFlowNode[];
@@ -909,6 +989,8 @@ export interface DashRouteRun {
     requestId?: string;
     status?: number;
     durationMs?: number;
+    /** Duration is a streaming connection lifetime, not request/first-byte latency. */
+    streaming?: boolean;
     /** What its SQL statements took, summed (ms) — the statements its `sql:` touches count. */
     sqlMs?: number;
     /** Its SQL by its service's own count, when the service sent one — the whole of it, where `touches` may hold a part. */
@@ -947,6 +1029,7 @@ export interface DashRouteSummary {
         at: number;
         status?: number;
         durationMs?: number;
+        streaming?: boolean;
         flowId?: string;
         touches?: DashTouches;
     };
@@ -1833,6 +1916,17 @@ export interface DashDbIndex {
     name: string;
     /** `CREATE INDEX … ON … USING btree (tenant_id, created_at)`. */
     definition: string;
+    /** PostgreSQL catalog identity, used instead of parsing/lowercasing SQL text for equivalence. */
+    access?: {
+        method: string;
+        attributes: number[];
+        keyCount: number;
+        operatorClasses: number[];
+        collations: number[];
+        options: number[];
+        expressions: string | null;
+        predicate: string | null;
+    };
     unique: boolean;
     primary: boolean;
     /** False when a CREATE INDEX CONCURRENTLY failed and left it behind. */
@@ -1917,7 +2011,7 @@ export interface DashDbLint {
     /** The statements the lint looked at (the services' own: they touch a table), and how many have a name. */
     statements: number;
     named: number;
-    /** Errors first, then warnings; the busiest first; at most 60 (`more` says how many were left out). */
+    /** Errors first, then warnings; the busiest first; complete list; large MCP answers are paged through result_query. */
     issues: DashDbLintIssue[];
     more: number;
     /** Each name: the statement it names now, and the versions it replaced (not seen since the current one came). */
@@ -1930,7 +2024,7 @@ export interface DashDbLint {
 }
 export interface DashDbLintIssue {
     severity: 'error' | 'warning';
-    rule: 'unnamed-statement' | 'name-reused' | 'review-below';
+    rule: 'unnamed-statement' | 'name-reused' | 'review-below' | 'review-stale' | 'review-unverified';
     statement: string;
     name?: string;
     verb: string;
@@ -1953,6 +2047,7 @@ export interface DashDbLintIssue {
         overall: number;
         title?: string;
         top?: string;
+        freshness?: DashReviewFreshness;
     };
 }
 /**
@@ -1978,6 +2073,7 @@ export interface DashDbStatementLint {
         overall?: number;
         title?: string;
         top?: string;
+        freshness?: DashReviewFreshness;
     };
     /** The routes that ran it, newest first (`routes://lint` has their issues). */
     routes: string[];
@@ -1999,7 +2095,7 @@ export interface DashRoutesLintStatement {
 }
 export interface DashRoutesLintIssue {
     severity: 'error' | 'warning';
-    rule: 'unnamed-sql' | 'review-hole' | 'credential-in-url' | 'stack-in-error' | 'review-below' | 'sql-review-below' | 'sql-loop' | 'get-writes';
+    rule: 'unnamed-sql' | 'review-hole' | 'review-stale' | 'review-unverified' | 'credential-in-url' | 'stack-in-error' | 'review-below' | 'sql-review-below' | 'sql-loop' | 'get-writes';
     /** The route's catalog id (`<service> <METHOD> <route>`), and its parts. */
     route: string;
     service: string;
@@ -2019,6 +2115,7 @@ export interface DashRoutesLintIssue {
         overall?: number;
         title?: string;
         top?: string;
+        freshness?: DashReviewFreshness;
         low?: Array<{
             id: string;
             score: number;
@@ -2043,7 +2140,7 @@ export interface DashRoutesLint {
     /** The routes the lint looked at, and how many have a route review. */
     routes: number;
     reviewed: number;
-    /** Errors first, then warnings; the busiest first; at most 80 (`more` says how many were left out). */
+    /** Errors first, then warnings; the busiest first; complete list; large MCP answers are paged through result_query. */
     issues: DashRoutesLintIssue[];
     more: number;
     /** Every route with an issue, and how many of each — none left out. */
@@ -2076,7 +2173,7 @@ export interface DashDbStatementStat {
     hitRatio?: number;
 }
 export interface DashDbFinding {
-    kind: 'unused-index' | 'duplicate-index' | 'invalid-index' | 'seq-scan' | 'dead-rows' | 'unindexed-foreign-key';
+    kind: 'unused-index' | 'duplicate-index' | 'overlapping-index' | 'invalid-index' | 'seq-scan' | 'dead-rows' | 'unindexed-foreign-key';
     severity: 'high' | 'medium' | 'low';
     table: string;
     index?: string;
@@ -2134,6 +2231,8 @@ export interface DashKvCommandRun {
     key: string;
     /** The command as sent, values sized or masked. */
     command: string;
+    /** Requested expiry semantics captured before redaction; absent on older events. Never contains values. */
+    expiry?: 'set' | 'kept' | 'none' | 'unknown';
     result?: 'hit' | 'miss';
     durationMs?: number;
     service: string;
@@ -2665,7 +2764,13 @@ export interface DashAiRanFirst {
     why?: string;
 }
 /** A finished review as a list shows it: its overall score (under 70 a warning), when, and its run. */
+export interface DashReviewFreshness {
+    state: 'current' | 'stale' | 'unknown';
+    checkedAt?: number;
+    why: string;
+}
 export interface DashReviewMark {
+    freshness?: DashReviewFreshness;
     runId: string;
     at: number;
     overall?: number;
@@ -2880,7 +2985,7 @@ export interface DashSuggestions {
 /** One issue of `kv://lint`: a Redis / Valkey key family against what a coding agent fixes. */
 export interface DashKvLintIssue {
     severity: 'error' | 'warning';
-    rule: 'secret-in-key' | 'review-hole' | 'counter-unbounded' | 'no-expiry' | 'ttl-dropped' | 'persist' | 'oversized-value' | 'personal-data-in-key' | 'miss-heavy' | 'review-below';
+    rule: 'secret-in-key' | 'review-hole' | 'review-stale' | 'review-unverified' | 'expiry-unverified' | 'counter-unbounded' | 'no-expiry' | 'ttl-dropped' | 'persist' | 'oversized-value' | 'personal-data-in-key' | 'miss-heavy' | 'review-below';
     /** The key family: the pattern with its ids folded (`session:*`). */
     pattern: string;
     /** The commands the services sent against it (`GET`, `INCRBY` …), its runs, who sent them, when last. */
@@ -2898,6 +3003,7 @@ export interface DashKvLintIssue {
         overall?: number;
         title?: string;
         top?: string;
+        freshness?: DashReviewFreshness;
         low?: Array<{
             id: string;
             score: number;
@@ -2920,7 +3026,7 @@ export interface DashKvLint {
     families: number;
     reviewed: number;
     keysRead: boolean;
-    /** Errors first, then warnings; the busiest first; at most 80 (`more` says how many were left out). */
+    /** Errors first, then warnings; the busiest first; complete list; large MCP answers are paged through result_query. */
     issues: DashKvLintIssue[];
     more: number;
     /** Every family with an issue, and how many of each. */
@@ -2936,7 +3042,7 @@ export interface DashKvLint {
 /** One issue of `queues://lint`: a BullMQ queue (or a family of per-run queues) against what a coding agent fixes. */
 export interface DashQueuesLintIssue {
     severity: 'error' | 'warning';
-    rule: 'eviction' | 'no-worker' | 'failing-no-retry' | 'review-hole' | 'no-backoff' | 'retention-unbounded' | 'schedule-late' | 'stalls' | 'retries-exhausted' | 'paused-backlog' | 'review-below';
+    rule: 'eviction' | 'no-worker' | 'failing-no-retry' | 'review-hole' | 'review-stale' | 'review-unverified' | 'no-backoff' | 'retention-unbounded' | 'schedule-late' | 'stalls' | 'retries-exhausted' | 'paused-backlog' | 'review-below';
     /** `<store>/<db>/<queue>` — the queue the issue was read from (a family's busiest). */
     queue: string;
     name: string;
@@ -2953,6 +3059,7 @@ export interface DashQueuesLintIssue {
         overall?: number;
         title?: string;
         top?: string;
+        freshness?: DashReviewFreshness;
         low?: Array<{
             id: string;
             score: number;

package/lib/event-loop.d.ts

@@ -0,0 +1,65 @@
+/** A loop is a process/thread lifetime or a browser document, never just a service name. */
+export interface EventLoopIdentity {
+    id: string;
+    runtime: 'node' | 'browser';
+    project: string;
+    pid?: number;
+    threadId?: number;
+    tabId?: string;
+    loadId?: string;
+}
+export interface EventLoopScript {
+    url: string;
+    functionName?: string;
+    invoker?: string;
+    durationMs: number;
+    startAt: number;
+}
+export interface EventLoopEvidence {
+    eventId: string;
+    title: string;
+    kind: string;
+    startAt: number;
+    endAt: number;
+    flowId?: string;
+    requestId?: string;
+    /** Wall-time overlap is association, never proof that this operation blocked the loop. */
+    relation: 'executing' | 'overlap';
+}
+export interface EventLoopIncident {
+    id: string;
+    loop: EventLoopIdentity;
+    startAt: number;
+    endAt?: number;
+    observedAt: number;
+    durationMs: number;
+    state: 'recovered' | 'unresponsive' | 'unknown';
+    mechanism: 'callback' | 'heartbeat' | 'long-animation-frame' | 'longtask';
+    severity: 'warning' | 'error';
+    /** Exact async execution context, when measured inside a Node callback. Not a CPU profile. */
+    flowId?: string;
+    requestId?: string;
+    callbackType?: string;
+    scripts: EventLoopScript[];
+    evidence: EventLoopEvidence[];
+    evidenceTruncated: boolean;
+    explanation: string;
+}
+export interface EventLoopStatus {
+    loop: EventLoopIdentity;
+    lastSeen: number;
+    state: 'observed' | 'unresponsive' | 'unknown';
+    coverage: string;
+    meanMs?: number;
+    maxMs?: number;
+    p99Ms?: number;
+    utilization?: number;
+}
+export interface EventLoopsView {
+    loops: EventLoopStatus[];
+    incidents: EventLoopIncident[];
+    /** Bounded result: older incidents can be requested using before. */
+    nextBefore?: number;
+    persistence: 'disk' | 'memory';
+    retentionDays: number;
+}

package/lib/event-loop.js

@@ -0,0 +1 @@
+"use strict";export{};

package/lib/workspace-actions.d.ts

@@ -0,0 +1,97 @@
+export type WorkspaceActionKind = 'start' | 'stop' | 'restart' | 'migrate' | 'test' | 'e2e' | 'typecheck' | 'lint' | 'build' | 'verify' | 'worktree-stop' | 'worktree-remove';
+export type WorkspaceActionState = 'queued' | 'running' | 'passed' | 'failed' | 'errored' | 'cancelled' | 'timeout';
+export interface WorkspaceActionInput {
+    action: WorkspaceActionKind;
+    project: string;
+    target?: string;
+    worktree?: string;
+    timeoutMs?: number;
+    files?: string[];
+    testName?: string;
+    hard?: boolean;
+    /** Preparation of an existing instance. Only services started by this run are cleaned up. */
+    prepare?: {
+        migrationProject?: string;
+        migrationTarget?: string;
+        services?: string[];
+    };
+}
+export interface WorkspaceActionDescriptor {
+    id: string;
+    action: WorkspaceActionKind;
+    project: string;
+    target?: string;
+    runner?: 'jest' | 'vitest' | 'playwright' | 'opaque';
+    available: boolean;
+    reason?: string;
+    prerequisites: string[];
+}
+export interface WorkspaceActionFailure {
+    id: string;
+    name: string;
+    file?: string;
+    line?: number;
+    message: string;
+    occurrences: number;
+}
+export interface WorkspaceActionCounts {
+    passed: number;
+    failed: number;
+    skipped: number;
+    total: number;
+}
+export interface WorkspaceActionStep {
+    id: string;
+    action: WorkspaceActionKind | 'cleanup';
+    state: WorkspaceActionState | 'skipped';
+    durationMs: number;
+    target?: string;
+    exitCode?: number | null;
+    signal?: string;
+    counts?: WorkspaceActionCounts;
+    failureKind?: 'assertion' | 'setup' | 'runner-crash' | 'cancelled' | 'timeout' | 'command';
+    failures: WorkspaceActionFailure[];
+    omittedFailures: number;
+    note?: string;
+    migrations?: {
+        applied: number | null;
+        pending: number | null;
+        failed?: string;
+    };
+    worktree?: {
+        key: string;
+        directoryExists: boolean;
+        remainingData?: string[];
+        omittedData?: number;
+        branch?: string;
+    };
+    service?: {
+        name: string;
+        state: string;
+        ready: boolean;
+    };
+    evidence: {
+        log: string;
+        report?: string;
+        attachments?: string;
+    };
+}
+export interface WorkspaceActionRun {
+    runId: string;
+    scope: {
+        workspace: string;
+        worktree: string;
+        project: string;
+    };
+    action: WorkspaceActionKind;
+    state: WorkspaceActionState;
+    stage?: string;
+    queuedAt: number;
+    startedAt?: number;
+    completedAt?: number;
+    durationMs: number;
+    steps: WorkspaceActionStep[];
+    note?: string;
+    resultRef: string;
+    retentionDays: number;
+}

package/lib/workspace-actions.js

@@ -0,0 +1 @@
+"use strict";export{};

package/package.json

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