@probelabs/visor 0.1.96 → 0.1.97

package/dist/xds/xds/data/orca/v3/orca_load_report.proto

@@ -0,0 +1,58 @@
+syntax = "proto3";
+
+package xds.data.orca.v3;
+
+option java_outer_classname = "OrcaLoadReportProto";
+option java_multiple_files = true;
+option java_package = "com.github.xds.data.orca.v3";
+option go_package = "github.com/cncf/xds/go/xds/data/orca/v3";
+
+import "validate/validate.proto";
+
+// See section `ORCA load report format` of the design document in
+// :ref:`https://github.com/envoyproxy/envoy/issues/6614`.
+
+message OrcaLoadReport {
+  // CPU utilization expressed as a fraction of available CPU resources. This
+  // should be derived from the latest sample or measurement. The value may be
+  // larger than 1.0 when the usage exceeds the reporter dependent notion of
+  // soft limits.
+  double cpu_utilization = 1 [(validate.rules).double.gte = 0];
+
+  // Memory utilization expressed as a fraction of available memory
+  // resources. This should be derived from the latest sample or measurement.
+  double mem_utilization = 2 [(validate.rules).double.gte = 0, (validate.rules).double.lte = 1];
+
+  // Total RPS being served by an endpoint. This should cover all services that an endpoint is
+  // responsible for.
+  // Deprecated -- use ``rps_fractional`` field instead.
+  uint64 rps = 3 [deprecated = true];
+
+  // Application specific requests costs. Each value is an absolute cost (e.g. 3487 bytes of
+  // storage) associated with the request.
+  map<string, double> request_cost = 4;
+
+  // Resource utilization values. Each value is expressed as a fraction of total resources
+  // available, derived from the latest sample or measurement.
+  map<string, double> utilization = 5
+      [(validate.rules).map.values.double.gte = 0, (validate.rules).map.values.double.lte = 1];
+
+  // Total RPS being served by an endpoint. This should cover all services that an endpoint is
+  // responsible for.
+  double rps_fractional = 6 [(validate.rules).double.gte = 0];
+
+  // Total EPS (errors/second) being served by an endpoint. This should cover
+  // all services that an endpoint is responsible for.
+  double eps = 7 [(validate.rules).double.gte = 0];
+
+  // Application specific opaque metrics.
+  map<string, double> named_metrics = 8;
+
+  // Application specific utilization expressed as a fraction of available
+  // resources. For example, an application may report the max of CPU and memory
+  // utilization for better load balancing if it is both CPU and memory bound.
+  // This should be derived from the latest sample or measurement.
+  // The value may be larger than 1.0 when the usage exceeds the reporter
+  // dependent notion of soft limits.
+  double application_utilization = 9 [(validate.rules).double.gte = 0];
+}

package/dist/xds/xds/service/orca/v3/orca.proto

@@ -0,0 +1,36 @@
+syntax = "proto3";
+
+package xds.service.orca.v3;
+
+option java_outer_classname = "OrcaProto";
+option java_multiple_files = true;
+option java_package = "com.github.xds.service.orca.v3";
+option go_package = "github.com/cncf/xds/go/xds/service/orca/v3";
+
+import "xds/data/orca/v3/orca_load_report.proto";
+
+import "google/protobuf/duration.proto";
+
+// See section `Out-of-band (OOB) reporting` of the design document in
+// :ref:`https://github.com/envoyproxy/envoy/issues/6614`.
+
+// Out-of-band (OOB) load reporting service for the additional load reporting
+// agent that does not sit in the request path. Reports are periodically sampled
+// with sufficient frequency to provide temporal association with requests.
+// OOB reporting compensates the limitation of in-band reporting in revealing
+// costs for backends that do not provide a steady stream of telemetry such as
+// long running stream operations and zero QPS services. This is a server
+// streaming service, client needs to terminate current RPC and initiate
+// a new call to change backend reporting frequency.
+service OpenRcaService {
+  rpc StreamCoreMetrics(OrcaLoadReportRequest) returns (stream xds.data.orca.v3.OrcaLoadReport);
+}
+
+message OrcaLoadReportRequest {
+  // Interval for generating Open RCA core metric responses.
+  google.protobuf.Duration report_interval = 1;
+  // Request costs to collect. If this is empty, all known requests costs tracked by
+  // the load reporting agent will be returned. This provides an opportunity for
+  // the client to selectively obtain a subset of tracked costs.
+  repeated string request_cost_names = 2;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@probelabs/visor",
-  "version": "0.1.96",
+  "version": "0.1.97",
   "main": "dist/index.js",
   "bin": {
     "visor": "./dist/index.js"
@@ -31,7 +31,7 @@
     "registry": "https://registry.npmjs.org/"
   },
   "scripts": {
-    "build:cli": "ncc build src/index.ts -o dist && cp -r defaults dist/ && node scripts/inject-version.js && echo '#!/usr/bin/env node' | cat - dist/index.js > temp && mv temp dist/index.js && chmod +x dist/index.js",
+    "build:cli": "ncc build src/index.ts -o dist && cp -r defaults dist/ && cp -r output dist/ && node scripts/inject-version.js && echo '#!/usr/bin/env node' | cat - dist/index.js > temp && mv temp dist/index.js && chmod +x dist/index.js",
     "build:sdk": "tsup src/sdk.ts --dts --sourcemap --format esm,cjs --out-dir dist/sdk",
     "build": "npm run build:cli && npm run build:sdk",
     "test": "jest",
@@ -85,12 +85,23 @@
   "homepage": "https://github.com/probelabs/visor#readme",
   "dependencies": {
     "@actions/core": "^1.11.1",
+    "@modelcontextprotocol/sdk": "^1.20.1",
     "@nyariv/sandboxjs": "^0.8.25",
     "@octokit/action": "^8.0.2",
     "@octokit/auth-app": "^8.1.0",
     "@octokit/core": "^7.0.3",
     "@octokit/rest": "^22.0.0",
-    "@probelabs/probe": "^0.6.0-rc146",
+    "@opentelemetry/api": "^1.9.0",
+    "@opentelemetry/core": "^1.30.1",
+    "@opentelemetry/exporter-trace-otlp-grpc": "^0.203.0",
+    "@opentelemetry/exporter-trace-otlp-http": "^0.203.0",
+    "@opentelemetry/instrumentation": "^0.203.0",
+    "@opentelemetry/resources": "^1.30.1",
+    "@opentelemetry/sdk-metrics": "^1.30.1",
+    "@opentelemetry/sdk-node": "^0.203.0",
+    "@opentelemetry/sdk-trace-base": "^1.30.1",
+    "@opentelemetry/semantic-conventions": "^1.30.1",
+    "@probelabs/probe": "^0.6.0-rc148",
     "@types/commander": "^2.12.0",
     "@types/uuid": "^10.0.0",
     "ajv": "^8.17.1",
@@ -131,15 +142,11 @@
     "wrangler": "^3.0.0"
   },
   "peerDependencies": {
-    "@anthropic/claude-code-sdk": "^1.0.0",
-    "@modelcontextprotocol/sdk": "^1.0.0"
+    "@anthropic/claude-code-sdk": "^1.0.0"
   },
   "peerDependenciesMeta": {
     "@anthropic/claude-code-sdk": {
       "optional": true
-    },
-    "@modelcontextprotocol/sdk": {
-      "optional": true
     }
   },
   "directories": {

package/dist/sdk/check-execution-engine-NMPXJ7FQ.mjs

@@ -1,11 +0,0 @@
-import {
-  CheckExecutionEngine
-} from "./chunk-Q4S5A5TO.mjs";
-import "./chunk-KVHVCGY6.mjs";
-import "./chunk-I3GQJIR7.mjs";
-import "./chunk-TWJKAYT6.mjs";
-import "./chunk-WMJKH4XE.mjs";
-export {
-  CheckExecutionEngine
-};
-//# sourceMappingURL=check-execution-engine-NMPXJ7FQ.mjs.map

package/dist/sdk/chunk-KVHVCGY6.mjs

@@ -1,103 +0,0 @@
-import {
-  __esm
-} from "./chunk-WMJKH4XE.mjs";
-
-// src/utils/tracer-init.ts
-import * as path from "path";
-import * as fs from "fs";
-import { TelemetryConfig, AppTracer, SimpleTelemetry, SimpleAppTracer } from "@probelabs/probe";
-async function initializeTracer(sessionId, checkName) {
-  try {
-    if (TelemetryConfig && AppTracer) {
-      const sanitizedCheckName = checkName ? path.basename(checkName) : "check";
-      const timestamp = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
-      const traceDir = process.env.GITHUB_WORKSPACE ? path.join(process.env.GITHUB_WORKSPACE, "debug-artifacts") : path.join(process.cwd(), "debug-artifacts");
-      if (!fs.existsSync(traceDir)) {
-        fs.mkdirSync(traceDir, { recursive: true });
-      }
-      const traceFilePath = path.join(traceDir, `trace-${sanitizedCheckName}-${timestamp}.jsonl`);
-      const resolvedTracePath = path.resolve(traceFilePath);
-      const resolvedTraceDir = path.resolve(traceDir);
-      if (!resolvedTracePath.startsWith(resolvedTraceDir)) {
-        console.error(
-          `\u26A0\uFE0F Security: Attempted path traversal detected. Check name: ${checkName}, resolved path: ${resolvedTracePath}`
-        );
-        return null;
-      }
-      const telemetryConfig = new TelemetryConfig({
-        serviceName: "visor-ai",
-        serviceVersion: "1.0.0",
-        enableFile: true,
-        filePath: traceFilePath,
-        enableConsole: false,
-        // Disable console to reduce noise
-        enableRemote: false
-        // Can be enabled via OTEL_EXPORTER_OTLP_ENDPOINT env var
-      });
-      telemetryConfig.initialize();
-      const tracer = new AppTracer(telemetryConfig, sessionId);
-      console.error(`\u{1F4CA} OpenTelemetry tracing enabled for visor-ai, saving to: ${traceFilePath}`);
-      console.error(
-        `\u{1F332} Trace spans will show hierarchical relationships between visor checks and probe agent operations`
-      );
-      if (process.env.GITHUB_ACTIONS) {
-        console.log(
-          `::notice title=AI Trace::OpenTelemetry trace will be saved to ${traceFilePath}`
-        );
-        console.log(`::set-output name=trace-path::${traceFilePath}`);
-      }
-      return { tracer, telemetryConfig, filePath: traceFilePath };
-    }
-    if (SimpleTelemetry && SimpleAppTracer) {
-      console.warn(
-        "\u26A0\uFE0F Using SimpleTelemetry fallback - hierarchical span relationships may not be available"
-      );
-      const sanitizedCheckName = checkName ? path.basename(checkName) : "check";
-      const timestamp = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
-      const traceDir = process.env.GITHUB_WORKSPACE ? path.join(process.env.GITHUB_WORKSPACE, "debug-artifacts") : path.join(process.cwd(), "debug-artifacts");
-      if (!fs.existsSync(traceDir)) {
-        fs.mkdirSync(traceDir, { recursive: true });
-      }
-      const traceFilePath = path.join(traceDir, `trace-${sanitizedCheckName}-${timestamp}.jsonl`);
-      const resolvedTracePath = path.resolve(traceFilePath);
-      const resolvedTraceDir = path.resolve(traceDir);
-      if (!resolvedTracePath.startsWith(resolvedTraceDir)) {
-        console.error(
-          `\u26A0\uFE0F Security: Attempted path traversal detected. Check name: ${checkName}, resolved path: ${resolvedTracePath}`
-        );
-        return null;
-      }
-      const telemetry = new SimpleTelemetry({
-        enableFile: true,
-        filePath: traceFilePath,
-        enableConsole: false
-      });
-      const tracer = new SimpleAppTracer(telemetry, sessionId);
-      console.error(`\u{1F4CA} Simple tracing enabled, will save to: ${traceFilePath}`);
-      if (process.env.GITHUB_ACTIONS) {
-        console.log(`::notice title=AI Trace::Trace will be saved to ${traceFilePath}`);
-        console.log(`::set-output name=trace-path::${traceFilePath}`);
-      }
-      return {
-        tracer,
-        telemetryConfig: telemetry,
-        filePath: traceFilePath
-      };
-    }
-    console.error("\u26A0\uFE0F Telemetry classes not available in ProbeAgent, skipping tracing");
-    return null;
-  } catch (error) {
-    console.error("\u26A0\uFE0F Warning: Failed to initialize tracing:", error);
-    return null;
-  }
-}
-var init_tracer_init = __esm({
-  "src/utils/tracer-init.ts"() {
-  }
-});
-
-export {
-  initializeTracer,
-  init_tracer_init
-};
-//# sourceMappingURL=chunk-KVHVCGY6.mjs.map

package/dist/sdk/chunk-KVHVCGY6.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/utils/tracer-init.ts"],"sourcesContent":["import * as path from 'path';\nimport * as fs from 'fs';\nimport { TelemetryConfig, AppTracer, SimpleTelemetry, SimpleAppTracer } from '@probelabs/probe';\n\n/**\n * Safely initialize a tracer for ProbeAgent with proper path sanitization\n * Uses full OpenTelemetry integration for hierarchical span relationships\n * This prevents path traversal vulnerabilities by sanitizing the checkName\n */\nexport async function initializeTracer(\n  sessionId: string,\n  checkName?: string\n): Promise<{ tracer: AppTracer; telemetryConfig: TelemetryConfig; filePath: string } | null> {\n  try {\n    // Try to use full OpenTelemetry integration first (provides proper span hierarchy)\n    if (TelemetryConfig && AppTracer) {\n      // SECURITY: Sanitize checkName to prevent path traversal attacks\n      // Use path.basename to strip any directory traversal characters (../, etc.)\n      const sanitizedCheckName = checkName ? path.basename(checkName) : 'check';\n\n      // Create trace file path in debug-artifacts directory\n      const timestamp = new Date().toISOString().replace(/[:.]/g, '-');\n      const traceDir = process.env.GITHUB_WORKSPACE\n        ? path.join(process.env.GITHUB_WORKSPACE, 'debug-artifacts')\n        : path.join(process.cwd(), 'debug-artifacts');\n\n      // Create traces directory if it doesn't exist\n      if (!fs.existsSync(traceDir)) {\n        fs.mkdirSync(traceDir, { recursive: true });\n      }\n\n      // SECURITY: Use path.join to safely construct the path\n      // This ensures the final path is within traceDir\n      const traceFilePath = path.join(traceDir, `trace-${sanitizedCheckName}-${timestamp}.jsonl`);\n\n      // SECURITY: Verify the resolved path is within the intended directory\n      const resolvedTracePath = path.resolve(traceFilePath);\n      const resolvedTraceDir = path.resolve(traceDir);\n      if (!resolvedTracePath.startsWith(resolvedTraceDir)) {\n        console.error(\n          `⚠️ Security: Attempted path traversal detected. Check name: ${checkName}, resolved path: ${resolvedTracePath}`\n        );\n        return null;\n      }\n\n      // Initialize OpenTelemetry with file exporter\n      // This provides proper span hierarchy and parent-child relationships\n      const telemetryConfig = new TelemetryConfig({\n        serviceName: 'visor-ai',\n        serviceVersion: '1.0.0',\n        enableFile: true,\n        filePath: traceFilePath,\n        enableConsole: false, // Disable console to reduce noise\n        enableRemote: false, // Can be enabled via OTEL_EXPORTER_OTLP_ENDPOINT env var\n      });\n\n      // Initialize the OpenTelemetry SDK\n      telemetryConfig.initialize();\n\n      // Create the AppTracer with session ID for consistent tracing\n      const tracer = new AppTracer(telemetryConfig, sessionId);\n\n      console.error(`📊 OpenTelemetry tracing enabled for visor-ai, saving to: ${traceFilePath}`);\n      console.error(\n        `🌲 Trace spans will show hierarchical relationships between visor checks and probe agent operations`\n      );\n\n      // If in GitHub Actions, log the path for artifact upload\n      if (process.env.GITHUB_ACTIONS) {\n        console.log(\n          `::notice title=AI Trace::OpenTelemetry trace will be saved to ${traceFilePath}`\n        );\n        console.log(`::set-output name=trace-path::${traceFilePath}`);\n      }\n\n      return { tracer, telemetryConfig, filePath: traceFilePath };\n    }\n\n    // Fallback to SimpleTelemetry if full OpenTelemetry is not available\n    if (SimpleTelemetry && SimpleAppTracer) {\n      console.warn(\n        '⚠️ Using SimpleTelemetry fallback - hierarchical span relationships may not be available'\n      );\n\n      // SECURITY: Sanitize checkName to prevent path traversal attacks\n      const sanitizedCheckName = checkName ? path.basename(checkName) : 'check';\n\n      // Create trace file path in debug-artifacts directory\n      const timestamp = new Date().toISOString().replace(/[:.]/g, '-');\n      const traceDir = process.env.GITHUB_WORKSPACE\n        ? path.join(process.env.GITHUB_WORKSPACE, 'debug-artifacts')\n        : path.join(process.cwd(), 'debug-artifacts');\n\n      // Create traces directory if it doesn't exist\n      if (!fs.existsSync(traceDir)) {\n        fs.mkdirSync(traceDir, { recursive: true });\n      }\n\n      // SECURITY: Use path.join to safely construct the path\n      const traceFilePath = path.join(traceDir, `trace-${sanitizedCheckName}-${timestamp}.jsonl`);\n\n      // SECURITY: Verify the resolved path is within the intended directory\n      const resolvedTracePath = path.resolve(traceFilePath);\n      const resolvedTraceDir = path.resolve(traceDir);\n      if (!resolvedTracePath.startsWith(resolvedTraceDir)) {\n        console.error(\n          `⚠️ Security: Attempted path traversal detected. Check name: ${checkName}, resolved path: ${resolvedTracePath}`\n        );\n        return null;\n      }\n\n      // Initialize simple telemetry\n      const telemetry = new SimpleTelemetry({\n        enableFile: true,\n        filePath: traceFilePath,\n        enableConsole: false,\n      });\n\n      const tracer = new SimpleAppTracer(telemetry, sessionId);\n\n      console.error(`📊 Simple tracing enabled, will save to: ${traceFilePath}`);\n\n      // If in GitHub Actions, log the path for artifact upload\n      if (process.env.GITHUB_ACTIONS) {\n        console.log(`::notice title=AI Trace::Trace will be saved to ${traceFilePath}`);\n        console.log(`::set-output name=trace-path::${traceFilePath}`);\n      }\n\n      // Return with proper typing for SimpleTelemetry\n      return {\n        tracer: tracer as any as AppTracer,\n        telemetryConfig: telemetry as any as TelemetryConfig,\n        filePath: traceFilePath,\n      };\n    }\n\n    console.error('⚠️ Telemetry classes not available in ProbeAgent, skipping tracing');\n    return null;\n  } catch (error) {\n    console.error('⚠️ Warning: Failed to initialize tracing:', error);\n    return null;\n  }\n}\n"],"mappings":"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","names":[]}