elasticdash-test 0.1.26 → 0.1.27

package/dist/tool-registry.js

@@ -0,0 +1,73 @@
+/**
+ * Global registry for tools defined via edTool().
+ *
+ * Tools registered here are discoverable for reruns regardless of which
+ * module they live in. The helper also applies wrapTool() so telemetry
+ * fires automatically — symmetric with the Python @ed_tool decorator.
+ */
+import { wrapTool } from './interceptors/tool.js';
+const _registry = new Map();
+export function getRegisteredTools() {
+    return Array.from(_registry.values());
+}
+export function getRegisteredTool(name) {
+    return _registry.get(name);
+}
+export function clearToolRegistry() {
+    _registry.clear();
+}
+function inferCallerLocation() {
+    const stack = new Error().stack;
+    if (!stack)
+        return { file: null, line: null };
+    const lines = stack.split('\n');
+    for (let i = 2; i < lines.length; i++) {
+        const m = lines[i].match(/\((.*?):(\d+):\d+\)|at\s+(.*?):(\d+):\d+/);
+        if (!m)
+            continue;
+        const file = m[1] ?? m[3];
+        const line = parseInt(m[2] ?? m[4], 10);
+        if (file && !file.includes('tool-registry')) {
+            return { file: file.replace(/^file:\/\//, ''), line: isNaN(line) ? null : line };
+        }
+    }
+    return { file: null, line: null };
+}
+function inferSignature(fn) {
+    const src = fn.toString();
+    const m = src.match(/^[^(]*\(([^)]*)\)/);
+    if (!m)
+        return '()';
+    const params = m[1]
+        .split(',')
+        .map(p => p.trim().split(/[\s=:]/)[0])
+        .filter(Boolean);
+    return `(${params.join(', ')})`;
+}
+/**
+ * Register a function as a rerunnable tool.
+ *
+ *   export const myTool = edTool('my_tool', async (query: string) => { ... })
+ *
+ * The returned function is the telemetry-wrapped version, so calling it from
+ * normal code paths still produces traces. The CLI `run-tool` command and the
+ * ElasticDash MCP `run_tool` tool will resolve the original by name.
+ */
+export function edTool(name, fn) {
+    const isAsync = fn.constructor.name === 'AsyncFunction';
+    const signature = inferSignature(fn);
+    const { file, line } = inferCallerLocation();
+    const wrapped = wrapTool(name, fn);
+    _registry.set(name, {
+        name,
+        fn: fn,
+        wrapped: wrapped,
+        isAsync,
+        signature,
+        sourceFile: file,
+        lineNumber: line,
+    });
+    return wrapped;
+}
+export const defineTool = edTool;
+//# sourceMappingURL=tool-registry.js.map

package/dist/tool-registry.js.map

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

package/dist/tool-runner-worker.js

@@ -172,9 +172,26 @@ async function main() {
             originalExit(1);
             return;
         }
-        const fn = mod[toolName];
+        // Registry first: covers tools defined via edTool() anywhere in the project,
+        // as long as their containing module is reachable from toolsModulePath's
+        // import graph. Falls back to ed_tools-style module export lookup.
+        let fn;
+        try {
+            const reg = await import('./tool-registry.js');
+            const registered = reg.getRegisteredTool(toolName);
+            if (registered)
+                fn = registered.wrapped;
+        }
+        catch {
+            // Registry module not available (older SDK build); fall through to export lookup.
+        }
+        if (!fn) {
+            const exported = mod[toolName];
+            if (typeof exported === 'function')
+                fn = exported;
+        }
         if (typeof fn !== 'function') {
-            await writeResult({ ok: false, error: `"${toolName}" is not an exported function in the module.` });
+            await writeResult({ ok: false, error: `"${toolName}" not found via edTool() registry or as an exported function in the module.` });
             originalExit(1);
             return;
         }

package/dist/tool-runner-worker.js.map

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

package/dist/utils/debug.d.ts

@@ -1,3 +1,3 @@
-/** Log only when ELASTICDASH_DEBUG=1 is set. Drop-in replacement for console.log in interceptors. */
+/** Log only when ELASTICDASH_DEBUG=1 is set. Writes to stderr so callers parsing stdout (e.g. `elasticdash run-tool`) get a clean JSON channel. */
 export declare function debugLog(...args: unknown[]): void;
 //# sourceMappingURL=debug.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"debug.d.ts","sourceRoot":"","sources":["../../src/utils/debug.ts"],"names":[],"mappings":"AAEA,mJAAmJ;AACnJ,wBAAgB,QAAQ,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAIjD"}

package/dist/utils/debug.js

@@ -1,8 +1,8 @@
 const DEBUG_KEY = 'ELASTICDASH_DEBUG';
-/** Log only when ELASTICDASH_DEBUG=1 is set. Drop-in replacement for console.log in interceptors. */
+/** Log only when ELASTICDASH_DEBUG=1 is set. Writes to stderr so callers parsing stdout (e.g. `elasticdash run-tool`) get a clean JSON channel. */
 export function debugLog(...args) {
     if (typeof process !== 'undefined' && process.env?.[DEBUG_KEY] === '1') {
-        console.log(...args);
+        console.error(...args);
     }
 }
 //# sourceMappingURL=debug.js.map

package/dist/utils/debug.js.map

@@ -1 +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"}
+{"version":3,"file":"debug.js","sourceRoot":"","sources":["../../src/utils/debug.ts"],"names":[],"mappings":"AAAA,MAAM,SAAS,GAAG,mBAAmB,CAAA;AAErC,mJAAmJ;AACnJ,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,KAAK,CAAC,GAAG,IAAI,CAAC,CAAA;IACxB,CAAC;AACH,CAAC"}

package/docs/observability_contract.md

@@ -0,0 +1,192 @@
+# Observability SDK Contract
+
+This document describes the event types the SDK sends and the portal (remote rerun queue) contract between the SDK and the backend.
+
+---
+
+## SDK Event Types
+
+### Events the SDK Sends
+
+| `type` | `name` | When | Key fields |
+|--------|--------|------|------------|
+| `ai` | Model name (e.g. `gpt-4o`) | Every `wrapAI` call | `input`, `output`, `usage`, `durationMs`, `streamed` |
+| `tool` | Tool name (e.g. `searchDB`) | Every `wrapTool` call | `input`, `output`, `durationMs`, `streamed` |
+| `side_effect` | `__heartbeat__` | Every 30s (configurable) | `input.sessionId`, `output.uptime` |
+| `side_effect` | `__session_end__` | On `shutdownObservability()` | `input.sessionId`, `output.uptime` |
+
+### Special Events (do not display in trace UI)
+
+- `__heartbeat__` — update session liveness, do not store as event
+- `__session_end__` — mark session as ended, do not store as event
+
+### Streamed Events
+
+When `streamed === true`:
+- `output` is `null`
+- `streamRaw` contains the full buffered text of the stream
+- Display `streamRaw` as the output in the UI
+
+### Error Events
+
+When a tool or AI call throws:
+- `output` is `{ "error": "Error message string" }`
+- `durationMs` reflects time until failure
+- Display with error styling in the UI
+
+---
+
+## Portal (Remote Rerun Queue) Contract
+
+The SDK's `elasticdash portal` command starts an HTTP server that the backend can push rerun tasks to. The backend also needs endpoints to receive results.
+
+### SDK Portal Endpoints (hosted on user's machine, default port 4574)
+
+These endpoints are served by the SDK. The backend calls them.
+
+#### `POST /api/portal/tasks` — Push a single rerun task
+
+**Request:**
+```json
+{
+  "taskId": "task-uuid-from-backend",
+  "type": "tool",
+  "name": "searchDB",
+  "input": { "query": "pikachu" },
+  "metadata": { "testGroupId": 42, "expectationIds": [1, 2, 3] }
+}
+```
+
+For AI tasks:
+```json
+{
+  "taskId": "task-uuid-from-backend",
+  "type": "ai",
+  "name": "gpt-4o",
+  "input": { "messages": [{ "role": "user", "content": "Hello" }] },
+  "model": "gpt-4o",
+  "provider": "openai",
+  "modelParameters": { "temperature": 0.7, "max_tokens": 512 },
+  "metadata": { "testGroupId": 42 }
+}
+```
+
+**Response:** `202 Accepted`
+```json
+{ "ok": true, "taskId": "task-uuid-from-backend", "position": 3 }
+```
+
+**Auth:** `Authorization: Bearer <api_key>` (validated if portal was started with `--api-key`)
+
+#### `POST /api/portal/tasks/batch` — Push multiple tasks
+
+**Request:**
+```json
+{ "tasks": [ /* PortalTask[] */ ] }
+```
+
+**Response:** `202 Accepted`
+```json
+{ "ok": true, "tasks": [{ "taskId": "...", "position": 1 }, { "taskId": "...", "position": 2 }] }
+```
+
+#### `GET /api/portal/status` — Health check
+
+**Response:**
+```json
+{
+  "ok": true,
+  "queueLength": 5,
+  "processing": "task-uuid-123",
+  "completed": 12,
+  "failed": 1
+}
+```
+
+#### `DELETE /api/portal/tasks/:taskId` — Cancel a pending task
+
+**Response:** `200` if removed, `404` if not found or already processing.
+
+---
+
+### Backend Endpoints (needed for portal to work)
+
+These endpoints must be implemented on the backend. The SDK calls them.
+
+#### `POST /api/portal/register` — Portal registration
+
+Called by the SDK when `elasticdash portal` starts.
+
+**Request:**
+```json
+{
+  "portalUrl": "http://localhost:4574"
+}
+```
+
+**Auth:** `Authorization: Bearer <api_key>`
+
+**Response:** `200 OK`
+```json
+{ "ok": true }
+```
+
+The backend should store this portal URL and use it to push tasks. The registration should be scoped to the project resolved from the API key.
+
+#### `POST /api/portal/results/:taskId` — Receive task result
+
+Called by the SDK after each task completes (success or failure).
+
+**Request:**
+```json
+{
+  "taskId": "task-uuid-from-backend",
+  "ok": true,
+  "output": "The search returned 3 results for pikachu...",
+  "durationMs": 245,
+  "usage": {
+    "inputTokens": 150,
+    "outputTokens": 45,
+    "totalTokens": 195
+  },
+  "metadata": { "testGroupId": 42, "expectationIds": [1, 2, 3] }
+}
+```
+
+For failed tasks:
+```json
+{
+  "taskId": "task-uuid-from-backend",
+  "ok": false,
+  "output": null,
+  "error": "Tool not found: \"searchDB\". Available tools: fetchData, sendEmail",
+  "durationMs": 0,
+  "metadata": { "testGroupId": 42 }
+}
+```
+
+**Auth:** `Authorization: Bearer <api_key>`
+
+**Response:** `200 OK`
+```json
+{ "ok": true }
+```
+
+---
+
+### Error Results Reference
+
+The SDK sends these error patterns:
+
+| Error pattern | Meaning |
+|--------------|---------|
+| `Tool not found: "<name>". Available tools: ...` | Tool doesn't exist in `ed_tools.ts` |
+| `Cannot find ed_tools.ts/js in workspace root.` | No tools module in the project |
+| `Unsupported AI provider: "<name>"` | Unknown provider string |
+| `Missing API key for provider "<name>". Expected environment variable: <VAR>` | LLM API key not configured |
+| `AI task input is empty; cannot execute.` | No prompt could be extracted from input |
+| `AI execution failed: <message>` | LLM API call failed (rate limit, network, invalid model) |
+| `Tool subprocess produced no output.` | Subprocess exited without result |
+| `Failed to spawn tool subprocess: <message>` | Could not start subprocess |
+| `Missing tool name on task.` | Task had no `name` field |
+| `Unknown task type: <type>` | Task type was neither `tool` nor `ai` |

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "elasticdash-test",
-  "version": "0.1.26",
-  "description": "AI-native test runner for ElasticDash workflow testing",
+  "version": "0.1.27",
+  "description": "AI-native SDK for ElasticDash workflow testing, tracing, and observability",
   "type": "module",
   "bin": {
     "elasticdash": "./dist/cli.js",

package/src/cli.ts

@@ -14,6 +14,20 @@ 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'
+import { resolveRuntimeModule, scanTools, buildToolArgs, runToolInSubprocess } from './execution/tool-runner.js'
+
+/** Brief, single-line preview of any value for trace event tables. */
+function previewify(value: unknown, maxLen = 200): string {
+  if (value === null || value === undefined) return ''
+  let str: string
+  try {
+    str = typeof value === 'string' ? value : JSON.stringify(value)
+  } catch {
+    str = String(value)
+  }
+  str = str.replace(/\n/g, ' ').trim()
+  return str.length > maxLen ? str.slice(0, maxLen) + '...' : str
+}
 
 function stripAnsi(input?: string): string | undefined {
   if (!input) return input
@@ -57,6 +71,8 @@ function validateRepoDirectory(cwd: string): boolean {
     'elasticdash.config.js',
     'ed_workflows.ts',
     'ed_workflows.js',
+    'ed_tools.ts',
+    'ed_tools.js',
   ]
   return validFiles.some(file => existsSync(path.join(cwd, file)))
 }
@@ -566,6 +582,174 @@ async function bootstrap(): Promise<void> {
       process.once('SIGTERM', cleanup)
     })
 
+  // elasticdash run-tool <name>
+  program
+    .command('run-tool <name>')
+    .description('Run a single tool by name with given input. Used for rerun validation (e.g. ElasticDash MCP).')
+    .option('--input <json>', 'JSON input to pass to the tool')
+    .option('--input-file <path>', 'Path to JSON file with input')
+    .action(async (name: string, options: { input?: string; inputFile?: string }) => {
+      const toolsModulePath = resolveRuntimeModule(cwd, 'ed_tools')
+      if (!toolsModulePath) {
+        console.error(`[elasticdash] Error: Could not find ed_tools.ts or ed_tools.js in ${cwd}`)
+        process.exit(1)
+      }
+
+      let toolInput: unknown = undefined
+      try {
+        if (options.inputFile) {
+          toolInput = JSON.parse(readFileSync(path.resolve(cwd, options.inputFile), 'utf-8'))
+        } else if (options.input) {
+          toolInput = JSON.parse(options.input)
+        }
+      } catch (err) {
+        console.error(`[elasticdash] Error: Failed to parse input JSON: ${err instanceof Error ? err.message : String(err)}`)
+        process.exit(1)
+      }
+
+      // File-scan is used to compute a positional-arg signature when present,
+      // but a missing scan hit is not fatal: tools defined via edTool() live
+      // in the runtime registry and only resolve once the worker imports the
+      // module. The worker handles "not found" with a clear error.
+      const tools = scanTools(cwd)
+      const tool = tools.find(t => t.name === name)
+
+      const args = buildToolArgs(toolInput, tool)
+      const result = await runToolInSubprocess(toolsModulePath, name, args)
+
+      if (!result.ok) {
+        console.error(`[elasticdash] ${result.error ?? 'Tool execution failed'}`)
+        process.exit(1)
+      }
+
+      const payload = {
+        tool: name,
+        output: result.currentOutput,
+        duration_ms: result.currentDurationMs,
+      }
+      process.stdout.write(JSON.stringify(payload, null, 2) + '\n')
+      // Sentinel line so machine consumers (e.g. ElasticDash MCP) can extract the
+      // result envelope even when project code prints to stdout before us.
+      process.stdout.write('__ED_RUN_TOOL_RESULT__:' + JSON.stringify(payload) + '\n')
+      process.exit(0)
+    })
+
+  // elasticdash run-workflow <name>
+  program
+    .command('run-workflow <name>')
+    .description('Run a single workflow by name with given input. Used for trace-less rerun (e.g. ElasticDash MCP).')
+    .option('--input <json>', 'JSON input to pass to the workflow')
+    .option('--input-file <path>', 'Path to JSON file with input')
+    .option('--timeout-seconds <n>', 'Hard cap on a single run in seconds', (v) => Number(v), 300)
+    .action(async (name: string, options: { input?: string; inputFile?: string; timeoutSeconds: number }) => {
+      const workflowsModulePath = resolveRuntimeModule(cwd, 'ed_workflows')
+      if (!workflowsModulePath) {
+        console.error(`[elasticdash] Error: Could not find ed_workflows.ts or ed_workflows.js in ${cwd}`)
+        process.exit(1)
+      }
+
+      // tsx's in-process `register('tsx/esm', ...)` produces a data:text/javascript URL
+      // that newer Node versions reject as unresolvable. To load TS reliably, re-spawn
+      // ourselves once with `--import tsx` in NODE_OPTIONS so tsx is installed at
+      // process startup (the same approach `runToolInSubprocess` uses for ed_tools.ts).
+      const isTs = workflowsModulePath.endsWith('.ts') || workflowsModulePath.endsWith('.tsx')
+      const nodeOptions = process.env.NODE_OPTIONS ?? ''
+      const tsxAlreadyLoaded = nodeOptions.includes('tsx') || nodeOptions.includes('--import')
+      if (isTs && !tsxAlreadyLoaded) {
+        const { spawn } = await import('node:child_process')
+        const child = spawn(process.execPath, process.argv.slice(1), {
+          env: { ...process.env, NODE_OPTIONS: `${nodeOptions} --import tsx`.trim() },
+          cwd,
+          stdio: 'inherit',
+        })
+        const exitCode: number = await new Promise(resolve => {
+          child.on('exit', code => resolve(code ?? 0))
+          child.on('error', () => resolve(1))
+        })
+        process.exit(exitCode)
+      }
+
+      let workflowInput: unknown = undefined
+      try {
+        if (options.inputFile) {
+          workflowInput = JSON.parse(readFileSync(path.resolve(cwd, options.inputFile), 'utf-8'))
+        } else if (options.input) {
+          workflowInput = JSON.parse(options.input)
+        }
+      } catch (err) {
+        console.error(`[elasticdash] Error: Failed to parse input JSON: ${err instanceof Error ? err.message : String(err)}`)
+        process.exit(1)
+      }
+
+      let mod: Record<string, unknown>
+      try {
+        mod = await import(pathToFileURL(workflowsModulePath).href) as Record<string, unknown>
+      } catch (err) {
+        console.error(`[elasticdash] Error: Failed to import ${workflowsModulePath}: ${err instanceof Error ? err.message : String(err)}`)
+        process.exit(1)
+      }
+
+      const workflowFn = mod[name] as ((input?: unknown) => unknown) | undefined
+      if (typeof workflowFn !== 'function') {
+        console.error(`[elasticdash] Error: Workflow '${name}' not found or not a function in ${workflowsModulePath}`)
+        process.exit(1)
+      }
+
+      const { runWorkflow } = await import('./workflow-runner.js')
+
+      const startedAt = Date.now()
+      let runError: string | undefined
+      let timedOut = false
+      let traceId: string | null = null
+      let output: unknown = null
+      let events: Array<Record<string, unknown>> = []
+
+      try {
+        const runPromise = runWorkflow(async () => workflowFn(workflowInput))
+        const timeoutPromise = new Promise((_, reject) => {
+          setTimeout(() => {
+            timedOut = true
+            reject(new Error(`workflow '${name}' timed out after ${options.timeoutSeconds}s`))
+          }, options.timeoutSeconds * 1000)
+        })
+        const runResult = await Promise.race([runPromise, timeoutPromise]) as { result: unknown; trace: { traceId: string; events: Array<{ id: number; type: string; name: string; input: unknown; output: unknown; durationMs: number }> } }
+        output = runResult.result
+        traceId = runResult.trace?.traceId ?? null
+        events = (runResult.trace?.events ?? []).map((e) => {
+          const out = e.output as Record<string, unknown> | null | undefined
+          const hasError = out !== null && typeof out === 'object' && out !== null && 'error' in out
+          return {
+            id: e.id,
+            type: e.type,
+            name: e.name,
+            duration_ms: e.durationMs,
+            has_error: hasError,
+            input_preview: previewify(e.input),
+            output_preview: previewify(e.output),
+          }
+        })
+      } catch (err) {
+        runError = err instanceof Error ? err.message : String(err)
+      }
+      const endedAt = Date.now()
+
+      const envelope = {
+        workflow: name,
+        trace_id: traceId,
+        output,
+        duration_ms: endedAt - startedAt,
+        started_at: startedAt,
+        ended_at: endedAt,
+        events,
+        status: runError ? (timedOut ? 'timed_out' : 'failed') : 'completed',
+        ...(runError ? { error: runError } : {}),
+      }
+
+      process.stdout.write(JSON.stringify(envelope, null, 2) + '\n')
+      process.stdout.write('__ED_RUN_WORKFLOW_RESULT__:' + JSON.stringify(envelope) + '\n')
+      process.exit(runError ? 1 : 0)
+    })
+
   // elasticdash init-guide
   program
     .command('init-guide')

package/src/index.ts

@@ -22,6 +22,10 @@ export type { CaptureContext } from './capture/recorder.js'
 export { wrapTool } from './interceptors/tool.js'
 export { wrapAI } from './interceptors/workflow-ai.js'
 
+// Tool registry (rerunnable tools defined anywhere in the project)
+export { edTool, defineTool, getRegisteredTool, getRegisteredTools, clearToolRegistry } from './tool-registry.js'
+export type { RegisteredTool } from './tool-registry.js'
+
 // HTTP run context (ALS + global fallback for streaming frameworks)
 export {
   setHttpRunContext,