@lensmcp/protocol-types 1.24.5 → 1.25.0

package/lib/dashboard.js

@@ -1 +1 @@
-"use strict";export const DASHBOARD_PROTOCOL=1;
+"use strict";export const DASHBOARD_PROTOCOL=1,DASH_PERF_KINDS=["n-plus-one","db-in-loop","render-storm","slow-path","slow-route","slow-query","missing-index","leak","egress-slow","duplicate-requests","perf-rule","other"];

package/lib/event.d.ts

@@ -43,6 +43,7 @@ export declare const EventCategorySchema: z.ZodEnum<{
     performance: "performance";
     deps: "deps";
     cluster: "cluster";
+    agent: "agent";
 }>;
 export type EventCategory = z.infer<typeof EventCategorySchema>;
 export declare const SeveritySchema: z.ZodEnum<{
@@ -100,6 +101,7 @@ export declare const BaseEventSchema: z.ZodObject<{
         performance: "performance";
         deps: "deps";
         cluster: "cluster";
+        agent: "agent";
     }>;
     severity: z.ZodEnum<{
         debug: "debug";

package/lib/event.js

@@ -1 +1 @@
-"use strict";import{z as e}from"zod";import{SourceLocationSchema as t}from"./source-location.js";import{TraceContextSchema as r}from"./context.js";export const EventSourceSchema=e.enum(["nx","vite","typescript","eslint","rollup","client-runtime","chrome","react","valtio","nestjs","nextjs","db","redis","queue","memory","visual","perf","security","gateway","external","ai","lens"]),EventCategorySchema=e.enum(["build","lint","typecheck","test","runtime","render","visual","trace","state","network","backend","db","memory","performance","security","deps","cluster","ai"]),SeveritySchema=e.enum(["debug","info","warning","error","fatal"]),BaseEventSchema=e.object({id:e.string(),sessionId:e.string(),timestamp:e.number().int().nonnegative(),source:EventSourceSchema,category:EventCategorySchema,severity:SeveritySchema,context:r,fingerprint:e.string(),title:e.string(),message:e.string().optional(),location:t.optional(),relatedFiles:e.array(e.string()).optional(),relatedUrls:e.array(e.string()).optional(),raw:e.unknown().optional()});
+"use strict";import{z as e}from"zod";import{SourceLocationSchema as t}from"./source-location.js";import{TraceContextSchema as r}from"./context.js";export const EventSourceSchema=e.enum(["nx","vite","typescript","eslint","rollup","client-runtime","chrome","react","valtio","nestjs","nextjs","db","redis","queue","memory","visual","perf","security","gateway","external","ai","lens"]),EventCategorySchema=e.enum(["build","lint","typecheck","test","runtime","render","visual","trace","state","network","backend","db","memory","performance","security","deps","cluster","ai","agent"]),SeveritySchema=e.enum(["debug","info","warning","error","fatal"]),BaseEventSchema=e.object({id:e.string(),sessionId:e.string(),timestamp:e.number().int().nonnegative(),source:EventSourceSchema,category:EventCategorySchema,severity:SeveritySchema,context:r,fingerprint:e.string(),title:e.string(),message:e.string().optional(),location:t.optional(),relatedFiles:e.array(e.string()).optional(),relatedUrls:e.array(e.string()).optional(),raw:e.unknown().optional()});

package/lib/http-exchange.d.ts

@@ -0,0 +1,80 @@
+/**
+ * One HTTP exchange the lens captured (R6): a service's outbound call as it went over the wire — its request and
+ * response headers (redacted), the query string and the bodies (redacted, the first 64 KB of each), and for a
+ * server-sent-events response every event with the moment it arrived. Kept OFF the bus, one file per exchange under
+ * `.lensmcp/http/`; the bus event carries its `exchangeId`. Capture: `LENSMCP_HTTP_CAPTURE=off | headers | bodies`.
+ *
+ * An AI provider's call keeps its conversation out of here: its headers, sizes and stream timing are captured, its
+ * prompt and completion only by the AI tap, opt-in (`LENSMCP_AI_CAPTURE=content`).
+ */
+export interface HttpExchangeBody {
+    contentType: string;
+    /** Every byte it had, kept or not. */
+    size: number;
+    /** The bytes kept as text (the first 64 KB). */
+    kept: number;
+    text?: string;
+    /** A binary body: its digest instead of its bytes (when it was small enough to hash). */
+    sha256?: string;
+    truncated: boolean;
+    /** Why there is no text: `binary`, `form-data`, `stream` (a request body sent as a stream), `ai`. */
+    omitted?: 'binary' | 'form-data' | 'stream' | 'ai';
+}
+export interface HttpExchangeStreamEvent {
+    /** Since the request started. */
+    atMs: number;
+    event: string;
+    bytes: number;
+    /** Its data, redacted, at most 4 KB — absent for an AI provider's stream. */
+    data?: string;
+}
+export interface HttpExchange {
+    schemaVersion: 1;
+    id: string;
+    capturedAt: number;
+    side: 'egress';
+    service?: string;
+    flowId?: string;
+    requestId?: string;
+    method: string;
+    /** Scheme, host and path — the query is in `request.query`, redacted. */
+    url: string;
+    host: string;
+    path: string;
+    status?: number;
+    statusText?: string;
+    /** A transport error: refused, reset, timed out, aborted. */
+    error?: string;
+    startedAt: number;
+    /** When the response headers arrived. */
+    ttfbMs?: number;
+    /** When the body ended (or the call failed). */
+    durationMs?: number;
+    capture: 'headers' | 'bodies';
+    request: {
+        headers: Array<[string, string]>;
+        query?: Array<[string, string]>;
+        body?: HttpExchangeBody;
+    };
+    response: {
+        headers: Array<[string, string]>;
+        body?: HttpExchangeBody;
+        stream?: {
+            protocol: 'sse';
+            firstEventMs?: number;
+            events: HttpExchangeStreamEvent[];
+            bytes: number;
+            total: number;
+            cut?: boolean;
+        };
+    };
+    /** What the lens removed before storing: header names, and body fields (paths). */
+    redacted: {
+        headers: string[];
+        bodyFields: string[];
+    };
+    /** An AI provider's call: no conversation here (see above). */
+    ai?: {
+        provider: string;
+    };
+}

package/lib/http-exchange.js

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

package/lib/log-query.d.ts

@@ -0,0 +1,30 @@
+import type { DashLogLine } from './dashboard.js';
+/**
+ * The Logs query language, shared by the dashboard server (`/api/logs?query=`) and the UI, so a query
+ * means the same thing whether the ring is filtered on the server or a live tail in the browser.
+ *
+ *   level:error service:engine -category:sql trace:mvc8tc6 ms:>500 timeout
+ *
+ * `key:value` tokens and free text. The same key twice is OR (`level:error level:warning`), different
+ * keys are AND; `-key:value` excludes. Values with spaces are quoted (`service:"my api"`). Free text
+ * matches the title, message, service and flow id, case-insensitively. A token with an unknown key is
+ * free text, so a URL like `GET:/x` is still searchable.
+ */
+export type LogQueryKey = 'level' | 'service' | 'flow' | 'trace' | 'category' | 'ms';
+export interface LogQueryToken {
+    key: LogQueryKey;
+    value: string;
+    negate: boolean;
+}
+export interface ParsedLogQuery {
+    tokens: LogQueryToken[];
+    /** The free text, words joined by single spaces. */
+    text: string;
+}
+export declare function parseLogQuery(input: string): ParsedLogQuery;
+export declare function formatLogQuery(q: ParsedLogQuery): string;
+/**
+ * Whether a line passes the query. `textMatch` replaces the plain substring test of the free text —
+ * the UI passes a compiled regex there in its Regex mode.
+ */
+export declare function matchesLogQuery(line: DashLogLine, q: ParsedLogQuery, textMatch?: (haystack: string) => boolean): boolean;

package/lib/log-query.js

@@ -0,0 +1 @@
+"use strict";var m=Object.defineProperty;var a=(e,r)=>m(e,"name",{value:r,configurable:!0});var L=Object.defineProperty,c=a((e,r)=>L(e,"name",{value:r,configurable:!0}),"c");const d={level:"level",severity:"level",service:"service",svc:"service",src:"service",source:"service",flow:"flow",trace:"trace",request:"trace",category:"category",cat:"category",ms:"ms"},h={warn:"warning",err:"error"},p=/(-?)(?:([A-Za-z]+):)?(?:"([^"]*)"|(\S+))/g;export function parseLogQuery(e){const r=[],t=[];for(const s of e.matchAll(p)){const[o,n,f,w,g]=s,u=(w??g??"").trim(),i=f?d[f.toLowerCase()]:void 0;if(i&&u){const y=i==="level"?h[u.toLowerCase()]??u.toLowerCase():u;r.push({key:i,value:y,negate:n==="-"})}else o.trim()&&t.push(o.trim())}return{tokens:r,text:t.join(" ")}}a(parseLogQuery,"parseLogQuery"),c(parseLogQuery,"parseLogQuery");export function formatLogQuery(e){const r=c(t=>/\s/.test(t)?`"${t}"`:t,"quote");return[...e.tokens.map(t=>`${t.negate?"-":""}${t.key}:${r(t.value)}`),e.text].filter(Boolean).join(" ")}a(formatLogQuery,"formatLogQuery"),c(formatLogQuery,"formatLogQuery");function v(e,r){if(e===void 0)return!1;const t=/^(>=|<=|>|<|=)?\s*(\d+(?:\.\d+)?)$/.exec(r);if(!t)return!1;const s=Number(t[2]);switch(t[1]){case">":return e>s;case"<":return e<s;case"<=":return e<=s;case"=":return e===s;default:return e>=s}}a(v,"h"),c(v,"msMatches");function l(e,r){const t=r.value.toLowerCase();switch(r.key){case"level":return e.severity.toLowerCase()===t;case"service":return e.source.toLowerCase()===t;case"flow":return!!e.flowId&&e.flowId.toLowerCase().startsWith(t);case"trace":return!!e.requestId&&e.requestId.toLowerCase().startsWith(t);case"category":return e.category.toLowerCase()===t;case"ms":return v(e.durationMs,r.value)}}a(l,"i"),c(l,"tokenMatches");export function matchesLogQuery(e,r,t){const s=new Map;for(const o of r.tokens){if(o.negate){if(l(e,o))return!1;continue}const n=s.get(o.key);n?n.push(o):s.set(o.key,[o])}for(const o of s.values())if(!o.some(n=>l(e,n)))return!1;if(r.text){const o=`${e.title} ${e.message??""} ${e.source} ${e.flowId??""}`;return t?t(o):o.toLowerCase().includes(r.text.toLowerCase())}return!0}a(matchesLogQuery,"matchesLogQuery"),c(matchesLogQuery,"matchesLogQuery");

package/lib/resources.d.ts

@@ -50,36 +50,36 @@ export type AgentBlockingItem = z.infer<typeof AgentBlockingItemSchema>;
 export declare const AgentChecksSchema: z.ZodObject<{
     typecheck: z.ZodOptional<z.ZodEnum<{
         unknown: "unknown";
-        passed: "passed";
         failed: "failed";
+        passed: "passed";
     }>>;
     lint: z.ZodOptional<z.ZodEnum<{
         unknown: "unknown";
-        passed: "passed";
         failed: "failed";
+        passed: "passed";
     }>>;
     build: z.ZodOptional<z.ZodEnum<{
         unknown: "unknown";
-        passed: "passed";
         failed: "failed";
+        passed: "passed";
     }>>;
     runtime: z.ZodOptional<z.ZodEnum<{
         warning: "warning";
         unknown: "unknown";
-        passed: "passed";
         failed: "failed";
+        passed: "passed";
     }>>;
     visual: z.ZodOptional<z.ZodEnum<{
         warning: "warning";
         unknown: "unknown";
-        passed: "passed";
         failed: "failed";
+        passed: "passed";
     }>>;
     memory: z.ZodOptional<z.ZodEnum<{
         warning: "warning";
         unknown: "unknown";
-        passed: "passed";
         failed: "failed";
+        passed: "passed";
     }>>;
 }, z.core.$strip>;
 /**
@@ -178,36 +178,36 @@ export declare const AgentCurrentStatusSchema: z.ZodObject<{
     checks: z.ZodOptional<z.ZodObject<{
         typecheck: z.ZodOptional<z.ZodEnum<{
             unknown: "unknown";
-            passed: "passed";
             failed: "failed";
+            passed: "passed";
         }>>;
         lint: z.ZodOptional<z.ZodEnum<{
             unknown: "unknown";
-            passed: "passed";
             failed: "failed";
+            passed: "passed";
         }>>;
         build: z.ZodOptional<z.ZodEnum<{
             unknown: "unknown";
-            passed: "passed";
             failed: "failed";
+            passed: "passed";
         }>>;
         runtime: z.ZodOptional<z.ZodEnum<{
             warning: "warning";
             unknown: "unknown";
-            passed: "passed";
             failed: "failed";
+            passed: "passed";
         }>>;
         visual: z.ZodOptional<z.ZodEnum<{
             warning: "warning";
             unknown: "unknown";
-            passed: "passed";
             failed: "failed";
+            passed: "passed";
         }>>;
         memory: z.ZodOptional<z.ZodEnum<{
             warning: "warning";
             unknown: "unknown";
-            passed: "passed";
             failed: "failed";
+            passed: "passed";
         }>>;
     }, z.core.$strip>>;
     server: z.ZodOptional<z.ZodObject<{

package/package.json

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