elasticdash-test 0.1.17 → 0.1.18-alpha-2

package/dist/trigger-executor.js

@@ -0,0 +1,83 @@
+import { executePortalTask, checkToolAvailability, checkAIAvailability } from './portal-executor.js';
+import { scanTools } from './execution/tool-runner.js';
+import { debugLog } from './utils/debug.js';
+/**
+ * Executes a trigger received from the backend's event batch response.
+ *
+ * For each step:
+ * 1. Pre-validates availability (tool exists? API key set?)
+ * 2. If unavailable: reports `available: false` with reason, skips execution
+ * 3. If available: re-executes `runCount` times, collects results
+ * 4. POSTs all results to `POST /api/observability/triggers/:triggerId/results`
+ */
+export async function executeTrigger(serverUrl, apiKey, trigger) {
+    const cwd = process.cwd();
+    const tools = scanTools(cwd);
+    debugLog(`[elasticdash] Executing trigger ${trigger.triggerId}: ${trigger.steps.length} steps × ${trigger.runCount} runs`);
+    const stepResults = [];
+    for (const step of trigger.steps) {
+        // Pre-validate availability
+        const availability = step.eventType === 'ai'
+            ? checkAIAvailability(step.provider, step.model ?? step.eventName)
+            : checkToolAvailability(step.eventName, cwd, tools);
+        if (!availability.available) {
+            debugLog(`[elasticdash] Trigger ${trigger.triggerId} step=${step.eventName} unavailable: ${availability.reason}`);
+            stepResults.push({
+                originalEventDbId: step.originalEventDbId,
+                eventType: step.eventType,
+                eventName: step.eventName,
+                available: false,
+                unavailableReason: availability.reason,
+                runs: [],
+            });
+            continue;
+        }
+        // Execute runs
+        const runs = [];
+        for (let i = 0; i < trigger.runCount; i++) {
+            const result = await executePortalTask({
+                taskId: `trigger-${trigger.triggerId}-${step.eventName}-${i}`,
+                type: step.eventType === 'ai' ? 'ai' : 'tool',
+                name: step.eventName,
+                input: step.input,
+                model: step.eventType === 'ai' ? (step.model ?? step.eventName) : undefined,
+                provider: step.provider,
+            }, cwd, tools);
+            runs.push({
+                runIndex: i,
+                input: step.input,
+                output: result.output,
+                durationMs: result.durationMs,
+                error: result.error,
+                usageInputTokens: result.usage?.inputTokens,
+                usageOutputTokens: result.usage?.outputTokens,
+                usageTotalTokens: result.usage?.totalTokens,
+            });
+            debugLog(`[elasticdash] Trigger ${trigger.triggerId} step=${step.eventName} run=${i} ok=${result.ok}`);
+        }
+        stepResults.push({
+            originalEventDbId: step.originalEventDbId,
+            eventType: step.eventType,
+            eventName: step.eventName,
+            available: true,
+            runs,
+        });
+    }
+    // POST results to backend
+    const url = `${serverUrl.replace(/\/$/, '')}/api/observability/triggers/${trigger.triggerId}/results`;
+    const headers = { 'Content-Type': 'application/json' };
+    if (apiKey)
+        headers['Authorization'] = `Bearer ${apiKey}`;
+    try {
+        const res = await fetch(url, {
+            method: 'POST',
+            headers,
+            body: JSON.stringify({ steps: stepResults }),
+        });
+        debugLog(`[elasticdash] Trigger ${trigger.triggerId} results posted (status ${res.status})`);
+    }
+    catch (err) {
+        debugLog(`[elasticdash] Trigger ${trigger.triggerId} results POST failed: ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+//# sourceMappingURL=trigger-executor.js.map

package/dist/trigger-executor.js.map

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

package/dist/types/portal.d.ts

@@ -0,0 +1,64 @@
+export interface PortalTask {
+    /** Unique task ID assigned by the backend */
+    taskId: string;
+    /** What to rerun */
+    type: 'tool' | 'ai';
+    /** Tool name or model name */
+    name: string;
+    /** Tool arguments or LLM prompt/messages */
+    input: unknown;
+    /** Model name (for AI tasks) */
+    model?: string;
+    /** LLM provider: openai, anthropic, gemini, grok, etc. */
+    provider?: string;
+    /** LLM generation parameters */
+    modelParameters?: {
+        temperature?: number;
+        max_tokens?: number;
+    };
+    /** Passthrough metadata (test group ID, expectation IDs, etc.) */
+    metadata?: Record<string, unknown>;
+}
+export interface PortalTaskResult {
+    taskId: string;
+    ok: boolean;
+    output: unknown;
+    error?: string;
+    durationMs: number;
+    usage?: {
+        inputTokens?: number;
+        outputTokens?: number;
+        totalTokens?: number;
+    };
+    /** Echoed from the original task */
+    metadata?: Record<string, unknown>;
+}
+export interface PortalServerOptions {
+    /** Port to listen on (default 4574) */
+    port?: number;
+    /** Backend URL to POST results to */
+    backendUrl: string;
+    /** Auth token for incoming and outgoing requests */
+    apiKey?: string;
+    /** Project root directory (default process.cwd()) */
+    cwd?: string;
+    /**
+     * Allowed origin domains that may send requests to this portal.
+     * By default only the `backendUrl` domain and localhost are allowed.
+     * Provide additional origins (e.g. 'https://app.elasticdash.com') to extend.
+     */
+    allowedOrigins?: string[];
+}
+export interface PortalServerHandle {
+    port: number;
+    url: string;
+    close: () => Promise<void>;
+}
+export interface PortalStatus {
+    ok: boolean;
+    queueLength: number;
+    processing: string | null;
+    completed: number;
+    failed: number;
+}
+//# sourceMappingURL=portal.d.ts.map

package/dist/types/portal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"portal.d.ts","sourceRoot":"","sources":["../../src/types/portal.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAA;IACd,oBAAoB;IACpB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,4CAA4C;IAC5C,KAAK,EAAE,OAAO,CAAA;IACd,gCAAgC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,gCAAgC;IAChC,eAAe,CAAC,EAAE;QAChB,WAAW,CAAC,EAAE,MAAM,CAAA;QACpB,UAAU,CAAC,EAAE,MAAM,CAAA;KACpB,CAAA;IACD,kEAAkE;IAClE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACnC;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAA;IACd,EAAE,EAAE,OAAO,CAAA;IACX,MAAM,EAAE,OAAO,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,CAAC,EAAE;QACN,WAAW,CAAC,EAAE,MAAM,CAAA;QACpB,YAAY,CAAC,EAAE,MAAM,CAAA;QACrB,WAAW,CAAC,EAAE,MAAM,CAAA;KACrB,CAAA;IACD,oCAAoC;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACnC;AAED,MAAM,WAAW,mBAAmB;IAClC,uCAAuC;IACvC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,qCAAqC;IACrC,UAAU,EAAE,MAAM,CAAA;IAClB,oDAAoD;IACpD,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,qDAAqD;IACrD,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;CAC1B;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC3B;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,OAAO,CAAA;IACX,WAAW,EAAE,MAAM,CAAA;IACnB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,MAAM,CAAA;CACf"}

package/dist/types/portal.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=portal.js.map

package/dist/types/portal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"portal.js","sourceRoot":"","sources":["../../src/types/portal.ts"],"names":[],"mappings":""}

package/dist/utils/debug.d.ts

@@ -0,0 +1,3 @@
+/** Log only when ELASTICDASH_DEBUG=1 is set. Drop-in replacement for console.log in interceptors. */
+export declare function debugLog(...args: unknown[]): void;
+//# sourceMappingURL=debug.d.ts.map

package/dist/utils/debug.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug.d.ts","sourceRoot":"","sources":["../../src/utils/debug.ts"],"names":[],"mappings":"AAEA,qGAAqG;AACrG,wBAAgB,QAAQ,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAIjD"}

package/dist/utils/debug.js

@@ -0,0 +1,8 @@
+const DEBUG_KEY = 'ELASTICDASH_DEBUG';
+/** Log only when ELASTICDASH_DEBUG=1 is set. Drop-in replacement for console.log in interceptors. */
+export function debugLog(...args) {
+    if (typeof process !== 'undefined' && process.env?.[DEBUG_KEY] === '1') {
+        console.log(...args);
+    }
+}
+//# sourceMappingURL=debug.js.map

package/dist/utils/debug.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug.js","sourceRoot":"","sources":["../../src/utils/debug.ts"],"names":[],"mappings":"AAAA,MAAM,SAAS,GAAG,mBAAmB,CAAA;AAErC,qGAAqG;AACrG,MAAM,UAAU,QAAQ,CAAC,GAAG,IAAe;IACzC,IAAI,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,KAAK,GAAG,EAAE,CAAC;QACvE,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAA;IACtB,CAAC;AACH,CAAC"}

package/dist/utils/redact.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Deep-clones a value and replaces any object property whose key matches
+ * one of `keys` (case-insensitive) with "[REDACTED]".
+ * Returns the original value when `keys` is empty.
+ */
+export declare function redactPayload(value: unknown, keys: string[]): unknown;
+//# sourceMappingURL=redact.d.ts.map

package/dist/utils/redact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redact.d.ts","sourceRoot":"","sources":["../../src/utils/redact.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAIrE"}

package/dist/utils/redact.js

@@ -0,0 +1,26 @@
+/**
+ * Deep-clones a value and replaces any object property whose key matches
+ * one of `keys` (case-insensitive) with "[REDACTED]".
+ * Returns the original value when `keys` is empty.
+ */
+export function redactPayload(value, keys) {
+    if (keys.length === 0)
+        return value;
+    const lowerKeys = new Set(keys.map((k) => k.toLowerCase()));
+    return redact(value, lowerKeys);
+}
+function redact(value, keys) {
+    if (value === null || value === undefined)
+        return value;
+    if (typeof value !== 'object')
+        return value;
+    if (Array.isArray(value)) {
+        return value.map((item) => redact(item, keys));
+    }
+    const out = {};
+    for (const [k, v] of Object.entries(value)) {
+        out[k] = keys.has(k.toLowerCase()) ? '[REDACTED]' : redact(v, keys);
+    }
+    return out;
+}
+//# sourceMappingURL=redact.js.map

package/dist/utils/redact.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redact.js","sourceRoot":"","sources":["../../src/utils/redact.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,KAAc,EAAE,IAAc;IAC1D,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAA;IACnC,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAA;IAC3D,OAAO,MAAM,CAAC,KAAK,EAAE,SAAS,CAAC,CAAA;AACjC,CAAC;AAED,SAAS,MAAM,CAAC,KAAc,EAAE,IAAiB;IAC/C,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAA;IACvD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAA;IAE3C,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAA;IAChD,CAAC;IAED,MAAM,GAAG,GAA4B,EAAE,CAAA;IACvC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAgC,CAAC,EAAE,CAAC;QACtE,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,IAAI,CAAC,CAAA;IACrE,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "elasticdash-test",
-  "version": "0.1.17",
+  "version": "0.1.18-alpha-2",
   "description": "AI-native test runner for ElasticDash workflow testing",
   "type": "module",
   "bin": {
@@ -17,6 +17,14 @@
     "./http": {
       "types": "./dist/http.d.ts",
       "default": "./dist/http.js"
+    },
+    "./observability": {
+      "types": "./dist/observability.d.ts",
+      "default": "./dist/observability.js"
+    },
+    "./portal": {
+      "types": "./dist/portal-server.d.ts",
+      "default": "./dist/portal-server.js"
     }
   },
   "files": [
@@ -43,6 +51,7 @@
     "expect": "^29.7.0",
     "express": "^5.2.1",
     "fast-glob": "^3.3.2",
+    "socket.io-client": "^4.8.3",
     "tsx": "^4.15.6"
   },
   "devDependencies": {

package/src/capture/event.ts

@@ -1,4 +1,4 @@
-export type WorkflowEventType = 'ai' | 'tool' | 'http' | 'db' | 'side_effect'
+export type WorkflowEventType = 'ai' | 'tool' | 'http' | 'db' | 'side_effect' | 'workflow'
 
 export interface WorkflowEvent {
   id: number
@@ -18,6 +18,10 @@ export interface WorkflowEvent {
   streamed?: boolean
   /** Raw buffered text of a streamed response (used for replay) */
   streamRaw?: string
+  /** Schema version for forward compatibility (default 1) */
+  schemaVersion?: number
+  /** Optional request-level trace ID for grouping events within a session */
+  traceId?: string
 }
 
 export interface WorkflowTrace {

package/src/cli.ts

@@ -12,6 +12,8 @@ import { runFiles } from './runner.js'
 import { reportResults } from './reporter.js'
 import { startBrowserUiServer, type UiEvent } from './browser-ui.js'
 import { startDashboardServer } from './dashboard-server.js'
+import { initObservability, shutdownObservability } from './observability.js'
+import { startPortalServer } from './portal-server.js'
 
 function stripAnsi(input?: string): string | undefined {
   if (!input) return input
@@ -306,6 +308,113 @@ async function bootstrap(): Promise<void> {
       process.once('SIGTERM', cleanup)
     })
 
+  // elasticdash observe
+  program
+    .command('observe')
+    .description('Start observability mode — stream trace events to ElasticDash backend')
+    .option('--server <url>', 'ElasticDash backend API URL', process.env.ELASTICDASH_API_URL)
+    .option('--api-key <key>', 'Project API key', process.env.ELASTICDASH_API_KEY)
+    .option('--service-id <id>', 'Service identifier', process.env.ELASTICDASH_SERVICE_ID)
+    .action(async (options: { server?: string; apiKey?: string; serviceId?: string }) => {
+      const serverUrl = options.server
+      if (!serverUrl) {
+        console.error('[elasticdash] Error: --server or ELASTICDASH_API_URL is required')
+        process.exit(1)
+      }
+
+      const handle = initObservability({
+        serverUrl,
+        apiKey: options.apiKey,
+        serviceId: options.serviceId,
+      })
+
+      console.log(`[elasticdash] Observability active`)
+      console.log(`  Session ID : ${handle.sessionId}`)
+      console.log(`  Server     : ${serverUrl}`)
+      console.log(`  Service    : ${options.serviceId ?? process.env.ELASTICDASH_SERVICE_ID ?? 'unknown-service'}`)
+      console.log(`[elasticdash] Press Ctrl+C to stop`)
+
+      let isShuttingDown = false
+      const cleanup = async () => {
+        if (isShuttingDown) {
+          process.exit(1)
+        }
+        isShuttingDown = true
+        console.log('\n[elasticdash] Shutting down observability...')
+        await shutdownObservability()
+        process.exit(0)
+      }
+
+      process.once('SIGINT', cleanup)
+      process.once('SIGTERM', cleanup)
+    })
+
+  // elasticdash portal
+  program
+    .command('portal')
+    .description('Start a portal server to receive and execute rerun tasks from ElasticDash backend')
+    .option('--server <url>', 'ElasticDash backend API URL to POST results to', process.env.ELASTICDASH_API_URL)
+    .option('--api-key <key>', 'Project API key', process.env.ELASTICDASH_API_KEY)
+    .option('--port <port>', 'Portal server port', (v) => Number(v), process.env.ELASTICDASH_PORTAL_PORT ? Number(process.env.ELASTICDASH_PORTAL_PORT) : 4574)
+    .option('--allowed-origins <origins>', 'Comma-separated list of additional allowed origin domains', process.env.ELASTICDASH_ALLOWED_ORIGINS)
+    .action(async (options: { server?: string; apiKey?: string; port: number; allowedOrigins?: string }) => {
+      const backendUrl = options.server
+      if (!backendUrl) {
+        console.error('[elasticdash] Error: --server or ELASTICDASH_API_URL is required')
+        process.exit(1)
+      }
+
+      const allowedOrigins = options.allowedOrigins
+        ? options.allowedOrigins.split(',').map(s => s.trim()).filter(Boolean)
+        : undefined
+
+      const handle = await startPortalServer({
+        port: options.port,
+        backendUrl,
+        apiKey: options.apiKey,
+        cwd,
+        allowedOrigins,
+      })
+
+      console.log(`[elasticdash] Portal server running`)
+      console.log(`  URL     : ${handle.url}`)
+      console.log(`  Backend : ${backendUrl}`)
+      console.log(`  Port    : ${handle.port}`)
+      console.log(`[elasticdash] Waiting for tasks from backend... Press Ctrl+C to stop`)
+
+      // Register with backend
+      try {
+        const headers: Record<string, string> = { 'Content-Type': 'application/json' }
+        if (options.apiKey) headers['Authorization'] = `Bearer ${options.apiKey}`
+        const res = await fetch(`${backendUrl}/api/portal/register`, {
+          method: 'POST',
+          headers,
+          body: JSON.stringify({ portalUrl: handle.url }),
+        })
+        if (res.ok) {
+          console.log(`[elasticdash] Registered with backend`)
+        } else {
+          console.warn(`[elasticdash] Backend registration returned ${res.status} — portal will still accept tasks directly`)
+        }
+      } catch {
+        console.warn(`[elasticdash] Could not register with backend — portal will still accept tasks directly`)
+      }
+
+      let isShuttingDown = false
+      const cleanup = async () => {
+        if (isShuttingDown) {
+          process.exit(1)
+        }
+        isShuttingDown = true
+        console.log('\n[elasticdash] Shutting down portal...')
+        await handle.close()
+        process.exit(0)
+      }
+
+      process.once('SIGINT', cleanup)
+      process.once('SIGTERM', cleanup)
+    })
+
   await program.parseAsync(process.argv)
 }