@lensmcp/protocol-types 1.25.24 → 1.25.26

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[];

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.24",
+  "version": "1.25.26",
   "type": "module",
   "main": "./index.js",
   "module": "./index.js",