@lensmcp/protocol-types 1.23.3 → 1.23.6

package/index.d.ts

@@ -13,3 +13,4 @@ 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/ai-content.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";
+"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/ai-content.js";

package/lib/ai-content.d.ts

@@ -0,0 +1,59 @@
+/**
+ * The shape of one captured AI call's conversation — the sidecar file `.lensmcp/ai/<callId>.json`.
+ *
+ * Types only, so the dashboard UI can name them without pulling in the node-side reader. The writer
+ * lives in `@lensmcp/node-instrumentation`, the readers in `@lensmcp/core/ai-content`; see that module
+ * for why the conversation is kept off the event bus.
+ */
+export interface AiMessageContent {
+    role: string;
+    /** Flattened to text. Images and other binary parts are replaced by a `[image]` marker, never inlined. */
+    content: string;
+}
+export interface AiToolCallContent {
+    id?: string;
+    name: string;
+    /** The raw JSON string the model produced, redacted and clipped. */
+    arguments?: string;
+}
+export interface AiUsageContent {
+    promptTokens?: number;
+    completionTokens?: number;
+    totalTokens?: number;
+    cachedTokens?: number;
+    reasoningTokens?: number;
+}
+export interface AiCallContent {
+    schemaVersion: 1;
+    id: string;
+    capturedAt: number;
+    flowId?: string;
+    requestId?: string;
+    project?: string;
+    provider: string;
+    api: string;
+    model?: string;
+    host: string;
+    endpoint: string;
+    stream: boolean;
+    status?: number;
+    request: {
+        system?: string;
+        messages: AiMessageContent[];
+        tools?: Array<{
+            name: string;
+            description?: string;
+        }>;
+        params?: Record<string, unknown>;
+    };
+    response?: {
+        completion?: string;
+        reasoning?: string;
+        toolCalls?: AiToolCallContent[];
+        finishReason?: string;
+        usage?: AiUsageContent;
+        error?: string;
+    };
+    /** True when any field was clipped to fit the per-call cap — the reader should say so. */
+    truncated?: boolean;
+}

package/lib/ai-content.js

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

package/lib/dashboard.d.ts

@@ -248,7 +248,22 @@ export interface DashFlowSummary {
      * still finds a flow that shows it.
      */
     touches?: string[];
+    /** What kind of flow this is: `page-load`, `user-action`, `api`… or one of the workspace's own categories. */
+    category?: string;
+    /** Where the category sits in the built-in order (`CATEGORY_ORDER` in core); a custom category sorts after every built-in one. */
+    categoryRank?: number;
+    /** Which layer decided the category: a workspace rule, the test detector, how the flow started, or its shape. */
+    decidedBy?: DashCategoryDecision;
+    /** What the flow is about, below its category: the templated page, the component, the root route… */
+    subject?: string;
+    /** Cheap orthogonal facts a person filters on: `fan-out`, `has-error`, `storm`, `slow`… Sorted. */
+    tags?: string[];
+    /** How many units the flow was cut into, how many phases they fall in, and how many events were signal. */
+    segmentCount?: number;
+    phaseCount?: number;
+    signalCount?: number;
 }
+export type DashCategoryDecision = 'rule' | 'test' | 'origin' | 'shape';
 /**
  * One display node of a flow — the output of `buildFlowDetail` in `@lensmcp/core`. Every field
  * beyond the first block is optional: which appear depends on the event kind and on the folds
@@ -303,6 +318,76 @@ export interface DashFlowNode {
     }>;
     memberIds?: string[];
     selfMs?: number;
+    /** The segment this step belongs to (see `DashFlowSegment`). Absent on a flow that was not segmented. */
+    segmentId?: string;
+}
+/** What a segment is: one backend call, a burst of UI work, the burst that started the flow, or backend noise. */
+export type DashSegmentKind = 'origin' | 'request' | 'ui' | 'ambient';
+export interface DashSegmentCounts {
+    total: number;
+    /** Everything that is not registry bookkeeping. */
+    signal: number;
+    bookkeeping: number;
+    errors: number;
+    warnings: number;
+}
+/** Which slice of an over-cap unit a segment is: `index` of `total`, 1-based. */
+export interface DashSegmentPart {
+    index: number;
+    total: number;
+}
+export interface DashFlowSegment {
+    /** Stable while the flow grows: `<flowId>~r:<requestId>`, `~u:<firstEventId>`, `~o:…`, `~a:…`; parts add `#n`. */
+    id: string;
+    kind: DashSegmentKind;
+    label: string;
+    /** 1-based, in time order: units in the same phase happened in the same burst of activity. */
+    phase: number;
+    start: number;
+    end: number;
+    durationMs: number;
+    counts: DashSegmentCounts;
+    projects: string[];
+    /** `METHOD /route` of the request, when there is one. */
+    method?: string;
+    route?: string;
+    requestId?: string;
+    /** For a UI burst that followed several fetches: which requests it may belong to. */
+    after?: string[];
+    /** For a UI burst: what churned most (`ProductTable ×40`), busiest first. */
+    hot?: string[];
+    part?: DashSegmentPart;
+    worstSeverity: 'debug' | 'info' | 'warning' | 'error' | 'fatal';
+    /** `api` for a request, `ui` for a burst, `system` for noise — or one of the workspace's own route/project rules. */
+    category: string;
+}
+export interface DashFlowPhase {
+    index: number;
+    start: number;
+    end: number;
+    segmentIds: string[];
+}
+/** The flow's own origin: what started it, in the same words the flow-origin event used. */
+export interface DashFlowOrigin {
+    type?: string;
+    nodeId?: string;
+}
+export interface DashFlowClassification {
+    category: string;
+    decidedBy: DashCategoryDecision;
+    /** Index into the workspace's `lensmcp.flows.categories` when `decidedBy` is `rule`. */
+    ruleIndex?: number;
+    subject?: string;
+    tags: string[];
+    origin: DashFlowOrigin;
+}
+export interface DashSegmentStats {
+    events: number;
+    signal: number;
+    bookkeeping: number;
+    segments: number;
+    phases: number;
+    largestSegment: number;
 }
 export interface DashFlowDetail {
     flowId: string;
@@ -311,6 +396,15 @@ export interface DashFlowDetail {
     events: DashFlowNode[];
     /** Same counter as `DashFlowSummary.rev` at the time of the read. */
     rev?: number;
+    /** The flow cut into units. Always the WHOLE flow's segments, also when `focus` narrows `events`. */
+    segments?: DashFlowSegment[];
+    phases?: DashFlowPhase[];
+    classification?: DashFlowClassification;
+    /** segment id → its category (also on each segment; kept as a map for lookups by id). */
+    segmentCategories?: Record<string, string>;
+    segmentStats?: DashSegmentStats;
+    /** Present when the read asked for one segment (`?segment=`): `events` then holds only that segment. */
+    focus?: DashFlowSegment;
 }
 export interface DashLogLine {
     seq: number;

package/package.json

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