@arvoretech/runtime-lens-mcp 1.0.0

package/dist/types.d.ts

@@ -0,0 +1,280 @@
+import { z } from "zod";
+export declare const LogLevel: z.ZodEnum<["debug", "info", "warn", "error", "fatal"]>;
+export type LogLevel = z.infer<typeof LogLevel>;
+export declare const Framework: z.ZodEnum<["react", "nextjs", "nestjs", "unknown"]>;
+export type Framework = z.infer<typeof Framework>;
+export declare const LogEntrySchema: z.ZodObject<{
+    id: z.ZodString;
+    timestamp: z.ZodString;
+    level: z.ZodEnum<["debug", "info", "warn", "error", "fatal"]>;
+    message: z.ZodString;
+    source: z.ZodOptional<z.ZodString>;
+    framework: z.ZodOptional<z.ZodEnum<["react", "nextjs", "nestjs", "unknown"]>>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    stackTrace: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    message: string;
+    id: string;
+    timestamp: string;
+    level: "debug" | "info" | "warn" | "error" | "fatal";
+    source?: string | undefined;
+    framework?: "react" | "nextjs" | "nestjs" | "unknown" | undefined;
+    metadata?: Record<string, unknown> | undefined;
+    stackTrace?: string | undefined;
+}, {
+    message: string;
+    id: string;
+    timestamp: string;
+    level: "debug" | "info" | "warn" | "error" | "fatal";
+    source?: string | undefined;
+    framework?: "react" | "nextjs" | "nestjs" | "unknown" | undefined;
+    metadata?: Record<string, unknown> | undefined;
+    stackTrace?: string | undefined;
+}>;
+export type LogEntry = z.infer<typeof LogEntrySchema>;
+export declare const HttpRequestSchema: z.ZodObject<{
+    id: z.ZodString;
+    timestamp: z.ZodString;
+    method: z.ZodString;
+    url: z.ZodString;
+    statusCode: z.ZodOptional<z.ZodNumber>;
+    duration: z.ZodOptional<z.ZodNumber>;
+    requestHeaders: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    responseHeaders: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    requestBody: z.ZodOptional<z.ZodUnknown>;
+    responseBody: z.ZodOptional<z.ZodUnknown>;
+    framework: z.ZodOptional<z.ZodEnum<["react", "nextjs", "nestjs", "unknown"]>>;
+    error: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    timestamp: string;
+    method: string;
+    url: string;
+    error?: string | undefined;
+    framework?: "react" | "nextjs" | "nestjs" | "unknown" | undefined;
+    statusCode?: number | undefined;
+    duration?: number | undefined;
+    requestHeaders?: Record<string, string> | undefined;
+    responseHeaders?: Record<string, string> | undefined;
+    requestBody?: unknown;
+    responseBody?: unknown;
+}, {
+    id: string;
+    timestamp: string;
+    method: string;
+    url: string;
+    error?: string | undefined;
+    framework?: "react" | "nextjs" | "nestjs" | "unknown" | undefined;
+    statusCode?: number | undefined;
+    duration?: number | undefined;
+    requestHeaders?: Record<string, string> | undefined;
+    responseHeaders?: Record<string, string> | undefined;
+    requestBody?: unknown;
+    responseBody?: unknown;
+}>;
+export type HttpRequest = z.infer<typeof HttpRequestSchema>;
+export declare const PerformanceMetricSchema: z.ZodObject<{
+    name: z.ZodString;
+    value: z.ZodNumber;
+    unit: z.ZodString;
+    timestamp: z.ZodString;
+    tags: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    value: number;
+    timestamp: string;
+    name: string;
+    unit: string;
+    tags?: Record<string, string> | undefined;
+}, {
+    value: number;
+    timestamp: string;
+    name: string;
+    unit: string;
+    tags?: Record<string, string> | undefined;
+}>;
+export type PerformanceMetric = z.infer<typeof PerformanceMetricSchema>;
+export declare const ProcessInfoSchema: z.ZodObject<{
+    pid: z.ZodNumber;
+    uptime: z.ZodNumber;
+    memoryUsage: z.ZodObject<{
+        rss: z.ZodNumber;
+        heapTotal: z.ZodNumber;
+        heapUsed: z.ZodNumber;
+        external: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        rss: number;
+        heapTotal: number;
+        heapUsed: number;
+        external: number;
+    }, {
+        rss: number;
+        heapTotal: number;
+        heapUsed: number;
+        external: number;
+    }>;
+    cpuUsage: z.ZodObject<{
+        user: z.ZodNumber;
+        system: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        user: number;
+        system: number;
+    }, {
+        user: number;
+        system: number;
+    }>;
+    nodeVersion: z.ZodString;
+    platform: z.ZodString;
+    arch: z.ZodString;
+    cwd: z.ZodString;
+    env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    pid: number;
+    uptime: number;
+    memoryUsage: {
+        rss: number;
+        heapTotal: number;
+        heapUsed: number;
+        external: number;
+    };
+    cpuUsage: {
+        user: number;
+        system: number;
+    };
+    nodeVersion: string;
+    platform: string;
+    arch: string;
+    cwd: string;
+    env?: Record<string, string> | undefined;
+}, {
+    pid: number;
+    uptime: number;
+    memoryUsage: {
+        rss: number;
+        heapTotal: number;
+        heapUsed: number;
+        external: number;
+    };
+    cpuUsage: {
+        user: number;
+        system: number;
+    };
+    nodeVersion: string;
+    platform: string;
+    arch: string;
+    cwd: string;
+    env?: Record<string, string> | undefined;
+}>;
+export type ProcessInfo = z.infer<typeof ProcessInfoSchema>;
+export declare const TailLogsParamsSchema: z.ZodObject<{
+    lines: z.ZodDefault<z.ZodNumber>;
+    level: z.ZodOptional<z.ZodEnum<["debug", "info", "warn", "error", "fatal"]>>;
+    framework: z.ZodOptional<z.ZodEnum<["react", "nextjs", "nestjs", "unknown"]>>;
+    source: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    lines: number;
+    level?: "debug" | "info" | "warn" | "error" | "fatal" | undefined;
+    source?: string | undefined;
+    framework?: "react" | "nextjs" | "nestjs" | "unknown" | undefined;
+}, {
+    level?: "debug" | "info" | "warn" | "error" | "fatal" | undefined;
+    source?: string | undefined;
+    framework?: "react" | "nextjs" | "nestjs" | "unknown" | undefined;
+    lines?: number | undefined;
+}>;
+export type TailLogsParams = z.infer<typeof TailLogsParamsSchema>;
+export declare const SearchLogsParamsSchema: z.ZodObject<{
+    query: z.ZodString;
+    level: z.ZodOptional<z.ZodEnum<["debug", "info", "warn", "error", "fatal"]>>;
+    framework: z.ZodOptional<z.ZodEnum<["react", "nextjs", "nestjs", "unknown"]>>;
+    limit: z.ZodDefault<z.ZodNumber>;
+    since: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    query: string;
+    limit: number;
+    level?: "debug" | "info" | "warn" | "error" | "fatal" | undefined;
+    framework?: "react" | "nextjs" | "nestjs" | "unknown" | undefined;
+    since?: string | undefined;
+}, {
+    query: string;
+    level?: "debug" | "info" | "warn" | "error" | "fatal" | undefined;
+    framework?: "react" | "nextjs" | "nestjs" | "unknown" | undefined;
+    limit?: number | undefined;
+    since?: string | undefined;
+}>;
+export type SearchLogsParams = z.infer<typeof SearchLogsParamsSchema>;
+export declare const GetErrorsParamsSchema: z.ZodObject<{
+    limit: z.ZodDefault<z.ZodNumber>;
+    framework: z.ZodOptional<z.ZodEnum<["react", "nextjs", "nestjs", "unknown"]>>;
+    grouped: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    limit: number;
+    grouped: boolean;
+    framework?: "react" | "nextjs" | "nestjs" | "unknown" | undefined;
+}, {
+    framework?: "react" | "nextjs" | "nestjs" | "unknown" | undefined;
+    limit?: number | undefined;
+    grouped?: boolean | undefined;
+}>;
+export type GetErrorsParams = z.infer<typeof GetErrorsParamsSchema>;
+export declare const InspectRequestParamsSchema: z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    method: z.ZodOptional<z.ZodString>;
+    urlPattern: z.ZodOptional<z.ZodString>;
+    statusCode: z.ZodOptional<z.ZodNumber>;
+    limit: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    limit: number;
+    id?: string | undefined;
+    method?: string | undefined;
+    statusCode?: number | undefined;
+    urlPattern?: string | undefined;
+}, {
+    id?: string | undefined;
+    method?: string | undefined;
+    statusCode?: number | undefined;
+    limit?: number | undefined;
+    urlPattern?: string | undefined;
+}>;
+export type InspectRequestParams = z.infer<typeof InspectRequestParamsSchema>;
+export declare const GetPerformanceParamsSchema: z.ZodObject<{
+    metric: z.ZodOptional<z.ZodString>;
+    since: z.ZodOptional<z.ZodString>;
+    limit: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    limit: number;
+    since?: string | undefined;
+    metric?: string | undefined;
+}, {
+    limit?: number | undefined;
+    since?: string | undefined;
+    metric?: string | undefined;
+}>;
+export type GetPerformanceParams = z.infer<typeof GetPerformanceParamsSchema>;
+export declare const ExecuteInContextParamsSchema: z.ZodObject<{
+    expression: z.ZodString;
+    framework: z.ZodOptional<z.ZodEnum<["react", "nextjs", "nestjs", "unknown"]>>;
+}, "strip", z.ZodTypeAny, {
+    expression: string;
+    framework?: "react" | "nextjs" | "nestjs" | "unknown" | undefined;
+}, {
+    expression: string;
+    framework?: "react" | "nextjs" | "nestjs" | "unknown" | undefined;
+}>;
+export type ExecuteInContextParams = z.infer<typeof ExecuteInContextParamsSchema>;
+export declare const WatchParamsSchema: z.ZodObject<{
+    pattern: z.ZodString;
+    duration: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    duration: number;
+    pattern: string;
+}, {
+    pattern: string;
+    duration?: number | undefined;
+}>;
+export type WatchParams = z.infer<typeof WatchParamsSchema>;
+export declare class RuntimeLensError extends Error {
+    code: string;
+    details?: unknown | undefined;
+    constructor(message: string, code: string, details?: unknown | undefined);
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,QAAQ,wDAAsD,CAAC;AAC5E,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,QAAQ,CAAC,CAAC;AAEhD,eAAO,MAAM,SAAS,qDAAmD,CAAC;AAC1E,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC;AAElD,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;EASzB,CAAC;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAEtD,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAa5B,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;EAMlC,CAAC;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkB5B,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;EAK/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;EAMjC,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,eAAO,MAAM,qBAAqB;;;;;;;;;;;;EAIhC,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;EAMrC,CAAC;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E,eAAO,MAAM,0BAA0B;;;;;;;;;;;;EAIrC,CAAC;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E,eAAO,MAAM,4BAA4B;;;;;;;;;EAGvC,CAAC;AACH,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAElF,eAAO,MAAM,iBAAiB;;;;;;;;;EAG5B,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,qBAAa,gBAAiB,SAAQ,KAAK;IAGhC,IAAI,EAAE,MAAM;IACZ,OAAO,CAAC,EAAE,OAAO;gBAFxB,OAAO,EAAE,MAAM,EACR,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,OAAO,YAAA;CAK3B"}

package/dist/types.js

@@ -0,0 +1,102 @@
+import { z } from "zod";
+export const LogLevel = z.enum(["debug", "info", "warn", "error", "fatal"]);
+export const Framework = z.enum(["react", "nextjs", "nestjs", "unknown"]);
+export const LogEntrySchema = z.object({
+    id: z.string(),
+    timestamp: z.string(),
+    level: LogLevel,
+    message: z.string(),
+    source: z.string().optional(),
+    framework: Framework.optional(),
+    metadata: z.record(z.unknown()).optional(),
+    stackTrace: z.string().optional(),
+});
+export const HttpRequestSchema = z.object({
+    id: z.string(),
+    timestamp: z.string(),
+    method: z.string(),
+    url: z.string(),
+    statusCode: z.number().optional(),
+    duration: z.number().optional(),
+    requestHeaders: z.record(z.string()).optional(),
+    responseHeaders: z.record(z.string()).optional(),
+    requestBody: z.unknown().optional(),
+    responseBody: z.unknown().optional(),
+    framework: Framework.optional(),
+    error: z.string().optional(),
+});
+export const PerformanceMetricSchema = z.object({
+    name: z.string(),
+    value: z.number(),
+    unit: z.string(),
+    timestamp: z.string(),
+    tags: z.record(z.string()).optional(),
+});
+export const ProcessInfoSchema = z.object({
+    pid: z.number(),
+    uptime: z.number(),
+    memoryUsage: z.object({
+        rss: z.number(),
+        heapTotal: z.number(),
+        heapUsed: z.number(),
+        external: z.number(),
+    }),
+    cpuUsage: z.object({
+        user: z.number(),
+        system: z.number(),
+    }),
+    nodeVersion: z.string(),
+    platform: z.string(),
+    arch: z.string(),
+    cwd: z.string(),
+    env: z.record(z.string()).optional(),
+});
+export const TailLogsParamsSchema = z.object({
+    lines: z.number().min(1).max(1000).default(50).describe("Number of recent log lines to retrieve"),
+    level: LogLevel.optional().describe("Filter by log level"),
+    framework: Framework.optional().describe("Filter by framework"),
+    source: z.string().optional().describe("Filter by source file or module"),
+});
+export const SearchLogsParamsSchema = z.object({
+    query: z.string().min(1).describe("Search pattern (supports regex)"),
+    level: LogLevel.optional().describe("Filter by log level"),
+    framework: Framework.optional().describe("Filter by framework"),
+    limit: z.number().min(1).max(500).default(50).describe("Maximum results to return"),
+    since: z.string().optional().describe("ISO timestamp to search from"),
+});
+export const GetErrorsParamsSchema = z.object({
+    limit: z.number().min(1).max(100).default(20).describe("Maximum errors to return"),
+    framework: Framework.optional().describe("Filter by framework"),
+    grouped: z.boolean().default(false).describe("Group similar errors together"),
+});
+export const InspectRequestParamsSchema = z.object({
+    id: z.string().optional().describe("Specific request ID to inspect"),
+    method: z.string().optional().describe("Filter by HTTP method"),
+    urlPattern: z.string().optional().describe("Filter by URL pattern (supports regex)"),
+    statusCode: z.number().optional().describe("Filter by status code"),
+    limit: z.number().min(1).max(100).default(20).describe("Maximum requests to return"),
+});
+export const GetPerformanceParamsSchema = z.object({
+    metric: z.string().optional().describe("Specific metric name to retrieve"),
+    since: z.string().optional().describe("ISO timestamp to get metrics from"),
+    limit: z.number().min(1).max(100).default(20).describe("Maximum metrics to return"),
+});
+export const ExecuteInContextParamsSchema = z.object({
+    expression: z.string().min(1).describe("JavaScript expression to evaluate"),
+    framework: Framework.optional().describe("Target framework context"),
+});
+export const WatchParamsSchema = z.object({
+    pattern: z.string().min(1).describe("File glob pattern or log pattern to watch"),
+    duration: z.number().min(1).max(300).default(30).describe("Watch duration in seconds"),
+});
+export class RuntimeLensError extends Error {
+    code;
+    details;
+    constructor(message, code, details) {
+        super(message);
+        this.code = code;
+        this.details = details;
+        this.name = "RuntimeLensError";
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/eslint.config.js

@@ -0,0 +1,41 @@
+import eslint from '@eslint/js';
+import tseslint from '@typescript-eslint/eslint-plugin';
+import tsparser from '@typescript-eslint/parser';
+
+export default [
+  eslint.configs.recommended,
+  {
+    files: ['src/**/*.ts'],
+    languageOptions: {
+      parser: tsparser,
+      parserOptions: {
+        ecmaVersion: 2022,
+        sourceType: 'module',
+      },
+      globals: {
+        console: 'readonly',
+        process: 'readonly',
+        Buffer: 'readonly',
+        BufferEncoding: 'readonly',
+        __dirname: 'readonly',
+        __filename: 'readonly',
+        global: 'readonly',
+        setTimeout: 'readonly',
+        clearTimeout: 'readonly',
+        setInterval: 'readonly',
+        clearInterval: 'readonly',
+        require: 'readonly',
+      },
+    },
+    plugins: {
+      '@typescript-eslint': tseslint,
+    },
+    rules: {
+      ...tseslint.configs.recommended.rules,
+      'no-redeclare': 'off',
+      '@typescript-eslint/no-unused-vars': 'error',
+      '@typescript-eslint/explicit-function-return-type': 'warn',
+      '@typescript-eslint/no-explicit-any': 'warn',
+    },
+  },
+];

package/extension/decorator.ts

@@ -0,0 +1,144 @@
+import * as vscode from "vscode";
+
+interface InlineValue {
+  file: string;
+  line: number;
+  column: number;
+  text: string;
+  type: "log" | "error" | "warn" | "info" | "debug" | "result";
+  timestamp: number;
+}
+
+const TYPE_COLORS: Record<string, string> = {
+  log: "#6A9955",
+  info: "#569CD6",
+  warn: "#CE9178",
+  error: "#F44747",
+  debug: "#9CDCFE",
+  result: "#DCDCAA",
+};
+
+export class InlineDecorator {
+  private decorationTypes: Map<string, vscode.TextEditorDecorationType> = new Map();
+  private values: Map<string, InlineValue[]> = new Map();
+  private disposables: vscode.Disposable[] = [];
+
+  activate(context: vscode.ExtensionContext): void {
+    this.disposables.push(
+      vscode.window.onDidChangeActiveTextEditor(() => this.refresh()),
+      vscode.workspace.onDidChangeTextDocument((e) => {
+        if (e.document === vscode.window.activeTextEditor?.document) {
+          this.refresh();
+        }
+      })
+    );
+    context.subscriptions.push(...this.disposables);
+  }
+
+  addValue(value: InlineValue): void {
+    const key = value.file;
+    if (!this.values.has(key)) {
+      this.values.set(key, []);
+    }
+
+    const existing = this.values.get(key)!;
+    const idx = existing.findIndex((v) => v.line === value.line);
+    if (idx >= 0) {
+      existing[idx] = value;
+    } else {
+      existing.push(value);
+    }
+
+    if (existing.length > 1000) {
+      existing.splice(0, existing.length - 1000);
+    }
+
+    this.refresh();
+  }
+
+  clearFile(file: string): void {
+    this.values.delete(file);
+    this.refresh();
+  }
+
+  clearAll(): void {
+    this.values.clear();
+    this.clearDecorations();
+  }
+
+  refresh(): void {
+    const editor = vscode.window.activeTextEditor;
+    if (!editor) return;
+
+    this.clearDecorations();
+
+    const filePath = editor.document.uri.fsPath;
+    const fileValues = this.values.get(filePath);
+    if (!fileValues || fileValues.length === 0) return;
+
+    const decorationsByType = new Map<string, vscode.DecorationOptions[]>();
+
+    for (const value of fileValues) {
+      const lineIndex = value.line - 1;
+      if (lineIndex < 0 || lineIndex >= editor.document.lineCount) continue;
+
+      const lineText = editor.document.lineAt(lineIndex).text;
+      const range = new vscode.Range(
+        new vscode.Position(lineIndex, lineText.length),
+        new vscode.Position(lineIndex, lineText.length)
+      );
+
+      const truncated = value.text.length > 80
+        ? value.text.slice(0, 80) + "…"
+        : value.text;
+
+      const decoration: vscode.DecorationOptions = {
+        range,
+        hoverMessage: new vscode.MarkdownString(
+          `**Runtime Lens** (${value.type})\n\n\`\`\`\n${value.text}\n\`\`\`\n\n*${new Date(value.timestamp).toLocaleTimeString()}*`
+        ),
+        renderOptions: {
+          after: {
+            contentText: `  // → ${truncated}`,
+            color: TYPE_COLORS[value.type] || "#6A9955",
+            fontStyle: "italic",
+            margin: "0 0 0 1em",
+          },
+        },
+      };
+
+      const typeKey = value.type;
+      if (!decorationsByType.has(typeKey)) {
+        decorationsByType.set(typeKey, []);
+      }
+      decorationsByType.get(typeKey)!.push(decoration);
+    }
+
+    for (const [typeKey, decorations] of decorationsByType) {
+      const decorationType = vscode.window.createTextEditorDecorationType({
+        after: {
+          color: TYPE_COLORS[typeKey] || "#6A9955",
+          fontStyle: "italic",
+        },
+        isWholeLine: false,
+      });
+
+      this.decorationTypes.set(typeKey, decorationType);
+      editor.setDecorations(decorationType, decorations);
+    }
+  }
+
+  private clearDecorations(): void {
+    for (const decorationType of this.decorationTypes.values()) {
+      decorationType.dispose();
+    }
+    this.decorationTypes.clear();
+  }
+
+  dispose(): void {
+    this.clearDecorations();
+    for (const d of this.disposables) {
+      d.dispose();
+    }
+  }
+}

package/extension/extension.ts

@@ -0,0 +1,98 @@
+import * as vscode from "vscode";
+import { join } from "node:path";
+import { InlineDecorator } from "./decorator.js";
+import { RuntimeBridge } from "./runtime-bridge.js";
+
+let decorator: InlineDecorator;
+let bridge: RuntimeBridge;
+let statusBarItem: vscode.StatusBarItem;
+
+export function activate(context: vscode.ExtensionContext): void {
+  const outputChannel = vscode.window.createOutputChannel("Runtime Lens");
+  const agentPath = join(context.extensionPath, "dist", "agent", "index.js");
+
+  decorator = new InlineDecorator();
+  decorator.activate(context);
+
+  bridge = new RuntimeBridge(decorator, outputChannel);
+
+  statusBarItem = vscode.window.createStatusBarItem(vscode.StatusBarAlignment.Right, 100);
+  statusBarItem.text = "$(eye) Lens";
+  statusBarItem.tooltip = "Runtime Lens - Click to toggle";
+  statusBarItem.command = "runtimeLens.toggle";
+  statusBarItem.show();
+  context.subscriptions.push(statusBarItem);
+
+  const port = vscode.workspace.getConfiguration("runtimeLens").get("port", 9500);
+
+  context.subscriptions.push(
+    vscode.commands.registerCommand("runtimeLens.start", () => {
+      bridge.connect();
+      updateStatusBar(true);
+      vscode.window.showInformationMessage("Runtime Lens: Listening for logs...");
+    }),
+
+    vscode.commands.registerCommand("runtimeLens.stop", () => {
+      bridge.disconnect();
+      decorator.clearAll();
+      updateStatusBar(false);
+      vscode.window.showInformationMessage("Runtime Lens: Stopped");
+    }),
+
+    vscode.commands.registerCommand("runtimeLens.toggle", () => {
+      if (bridge.isConnected()) {
+        vscode.commands.executeCommand("runtimeLens.stop");
+      } else {
+        vscode.commands.executeCommand("runtimeLens.start");
+      }
+    }),
+
+    vscode.commands.registerCommand("runtimeLens.clear", () => {
+      decorator.clearAll();
+      vscode.window.showInformationMessage("Runtime Lens: Cleared");
+    }),
+
+    vscode.commands.registerCommand("runtimeLens.connect", () => {
+      bridge.connect();
+      updateStatusBar(true);
+    }),
+
+    vscode.commands.registerCommand("runtimeLens.showOutput", () => {
+      outputChannel.show();
+    }),
+
+    vscode.commands.registerCommand("runtimeLens.injectEnv", () => {
+      const terminal = vscode.window.activeTerminal;
+      if (!terminal) {
+        vscode.window.showWarningMessage("Runtime Lens: No active terminal");
+        return;
+      }
+      terminal.sendText(`export NODE_OPTIONS="--require ${agentPath}"`, true);
+      terminal.sendText(`export RUNTIME_LENS_PORT="${port}"`, true);
+      vscode.window.showInformationMessage("Runtime Lens: Environment injected. Run your app now.");
+    })
+  );
+
+  const autoStart = vscode.workspace.getConfiguration("runtimeLens").get("autoStart", false);
+  if (autoStart) {
+    vscode.commands.executeCommand("runtimeLens.start");
+  }
+
+  outputChannel.appendLine(`[runtime-lens] Extension activated`);
+  outputChannel.appendLine(`[runtime-lens] Agent path: ${agentPath}`);
+}
+
+function updateStatusBar(active: boolean): void {
+  if (active) {
+    statusBarItem.text = "$(eye) Lens ●";
+    statusBarItem.backgroundColor = new vscode.ThemeColor("statusBarItem.warningBackground");
+  } else {
+    statusBarItem.text = "$(eye) Lens";
+    statusBarItem.backgroundColor = undefined;
+  }
+}
+
+export function deactivate(): void {
+  bridge?.disconnect();
+  decorator?.dispose();
+}