elasticdash-test 0.1.11-alpha-1 → 0.1.11-alpha-3

package/README.md

@@ -285,6 +285,99 @@ aiTest('user lookup flow', async (ctx) => {
 
 **Libraries using `https.request` directly** (older versions of some SDKs) are not covered by fetch interception. Use manual `ctx.trace.recordLLMStep()` for those.
 
+## Automatic Tool Recording
+
+Tool functions are automatically wrapped and recorded when imported and called during workflow execution. This gives you tracing and replay support without any manual instrumentation.
+
+### How to use tools
+
+Define your tools in `ed_tools.ts` and export them:
+
+```ts
+// ed_tools.ts
+import { wrapTool } from 'elasticdash-test'
+
+export const chargeCard = wrapTool('chargeCard', async (input: { amount: number; cardToken: string }) => {
+  // your actual implementation
+  return { success: true, transactionId: 'txn-123' }
+})
+
+export const fetchOrderStatus = wrapTool('fetchOrderStatus', async (input: { orderId: string }) => {
+  // query your database or API
+  return { status: 'shipped', tracking: 'track-456' }
+})
+```
+
+In your workflows or agents, simply import and call them — the runner automatically wraps them and records each call:
+
+```ts
+import { chargeCard, fetchOrderStatus } from './ed_tools'
+
+export async function checkoutFlow(orderId: string, cardToken: string) {
+  const order = await fetchOrderStatus({ orderId })
+  const charge = await chargeCard({ amount: order.total, cardToken })
+  return { orderId, chargeId: charge.transactionId }
+}
+```
+
+Each call to a tool is automatically recorded to `ctx.trace` with:
+- Tool name
+- Input arguments
+- Output result
+- Timestamp and duration
+
+No `ctx.trace.recordToolCall()` needed — it happens behind the scenes.
+
+Runtime behavior by mode:
+- Local/normal execution: wrapped tools run normally (no replay context).
+- Trace capture mode: wrapped tools run normally and are recorded.
+- Replay mode (`Run from here`): pre-checkpoint wrapped calls return historical results and skip tool body execution.
+
+### Tool replay and freezing in "Run from here"
+
+When you use the dashboard's "Run from here" feature to replay a workflow from a checkpoint:
+
+1. **Tools called before the checkpoint** are **frozen** — their recorded results are returned instantly without re-executing the actual function.
+2. **Tools called after the checkpoint** execute normally with live dependencies.
+
+This means:
+- If a tool made 3 API calls before the checkpoint, those calls won't happen again on replay.
+- If the tool is slow (waiting for external services), frozen calls are instant.
+- The tool's frozen status is visible in the dashboard with a frozen tag/styling, matching AI step behavior.
+- Side-effect replay is type-checked (`Date.now` vs `Math.random`) and malformed observation timestamps are auto-sanitized.
+
+Example:
+```
+Task 1: fetchOrderStatus()          ↓ frozen (checkpoint before this)
+  │─ API call to orders service      ↓ frozen
+  └─ Result: { status: shipped }     ↓ frozen
+
+→ You modify input for Task 2 and re-run
+  The fetchOrderStatus API call is skipped; the original result is reused instantly.
+```
+
+### Recording tool calls manually
+
+If you need to record tools outside the normal import flow or for providers not in `ed_tools.ts`, use:
+
+```ts
+ctx.trace.recordToolCall({
+  name: 'customTool',
+  args: { param: 'value' },
+  result: { success: true }
+})
+```
+
+Manual recording is best-effort trace logging. For full replay/freeze semantics in "Run from here" (including frozen tool tags and deterministic replay), run tools through the replay-aware wrapper path (auto-wrapped worker tools or `wrapTool(...)`).
+
+```ts
+import { wrapTool } from 'elasticdash-test'
+
+export const customTool = wrapTool('customTool', async (input: { param: string }) => {
+  return await doWork(input)
+})
+```
+
 ### Recording flow steps without passing `ctx.trace` (AsyncLocalStorage)
 
 The runner now sets a per-test `currentTrace` using Node’s `AsyncLocalStorage`, so your app code can record steps without threading `ctx.trace` through every function. This remains safe under parallel execution.
@@ -377,12 +470,26 @@ elasticdash dashboard --port 4572  # use custom port
 elasticdash dashboard --no-open    # skip auto-opening browser
 ```
 
-The dashboard scans `ed_workflow.ts` or `ed_workflow.js` and displays:
-- **Function names** — all exported functions in the module
-- **Signatures** — function parameters and return types
-- **Async indicator** — marks async vs sync functions
-- **Source module** — where the function is imported from (if re-exported)
-- **File path** — location of the workflow file
+The dashboard scans your workflow/tool files and displays:
+  - If both `.ts` and `.js` versions of a file exist (e.g., `ed_workflows.ts` and `ed_workflows.js`), the dashboard will always use the `.ts` file.
+  - If only `.ts` exists, it will be automatically transpiled to `.js` before scanning/importing—no manual build step required.
+  - If only `.js` exists, it will be used directly.
+
+This means you can write your workflows and tools in TypeScript, and the dashboard will handle transpilation automatically. You do not need to run `tsc` or build manually for dashboard usage.
+
+**Example file selection logic:**
+| Scenario                | File Used         |
+|-------------------------|------------------|
+| Only `ed_workflows.ts`   | Transpiled `.ts` |
+| Only `ed_workflows.js`   | `.js`            |
+| Both exist              | `.ts` (preferred)|
+
+The dashboard displays:
+  - **Function names** — all exported functions in the module
+  - **Signatures** — function parameters and return types
+  - **Async indicator** — marks async vs sync functions
+  - **Source module** — where the function is imported from (if re-exported)
+  - **File path** — location of the workflow file
 
 Use the search field to filter workflows by:
 - **Name** — find workflow by function name (e.g., `checkoutFlow`)
@@ -391,16 +498,16 @@ Use the search field to filter workflows by:
 
 This is useful for discovering available workflows, understanding their signatures, and identifying where functions are defined before calling them in tests.
 
-### `ed_workflow.ts`, `ed_tools.ts`, `ed_agents.ts`
+### `ed_workflows.ts`, `ed_tools.ts`, `ed_agents.ts`
 
 These optional files bundle and re-export existing functions from your codebase for use in tests.
 
-#### `ed_workflow.ts`
+#### `ed_workflows.ts`
 
 Re-export workflow functions from your application:
 
 ```ts
-// ed_workflow.ts
+// ed_workflows.ts
 export { orderWorkflow, refundWorkflow } from './src/workflows'
 export { userLookupFlow } from './src/user-flows'
 ```
@@ -408,7 +515,7 @@ export { userLookupFlow } from './src/user-flows'
 Access in tests:
 
 ```ts
-import { orderWorkflow } from './ed_workflow'
+import { orderWorkflow } from './ed_workflows'
 
 aiTest('full order workflow', async (ctx) => {
   const result = await orderWorkflow('order-123', 'cust-456')
@@ -422,7 +529,12 @@ Re-export tool functions that agents or workflows can invoke:
 
 ```ts
 // ed_tools.ts
-export { chargeCard, fetchOrderStatus, sendNotification } from './src/tools'
+import { wrapTool } from 'elasticdash-test'
+import { chargeCard as chargeCardRaw, fetchOrderStatus as fetchOrderStatusRaw, sendNotification as sendNotificationRaw } from './src/tools'
+
+export const chargeCard = wrapTool('chargeCard', chargeCardRaw)
+export const fetchOrderStatus = wrapTool('fetchOrderStatus', fetchOrderStatusRaw)
+export const sendNotification = wrapTool('sendNotification', sendNotificationRaw)
 ```
 
 #### `ed_agents.ts`
@@ -444,6 +556,111 @@ The dashboard command will scan these files and display all exported functions w
 
 ---
 
+## Agent Mid-Trace Replay
+
+ElasticDash supports resuming a long-running agent from any task in its plan — without re-executing already-completed steps. This is useful for:
+
+- **Resuming after failures**: If task 3 of 5 fails, fix the issue and re-run from task 3 only.
+- **Pausing for approval**: Capture state after task 2, get human sign-off, then continue.
+- **Debugging in isolation**: Re-run a single task with modified input to diagnose a problem.
+
+### How it works
+
+Agents are structured as an **AgentPlan** — an ordered list of **AgentTask** objects, each with a tool name, input, and output. When serialized, the plan plus all captured trace events form an **AgentState** that can be saved to disk/database and replayed later.
+
+### Quick start
+
+```ts
+import { plannerAgent, executorAgent, resumeAgentFromTrace } from './ed_agents'
+import { serializeAgentState, deserializeAgentState } from 'elasticdash-test'
+import fs from 'node:fs'
+
+// 1. Generate a plan
+const plan = await plannerAgent('Show me sales for Q1', { userToken: 'tok-abc' })
+
+// 2. Execute the plan (runs all tasks sequentially)
+const completedPlan = await executorAgent(plan)
+
+// 3. Serialize and save state (e.g., after partial execution)
+const state = serializeAgentState(completedPlan, [] /* pass recorder.events in worker context */)
+fs.writeFileSync('agent-state.json', JSON.stringify(state, null, 2))
+
+// 4. Later: load saved state and resume from task 2 (0-based index 1)
+const savedState = JSON.parse(fs.readFileSync('agent-state.json', 'utf8'))
+const stateToResume = deserializeAgentState({ ...savedState, resumeFromTaskIndex: 1 })
+const resumedPlan = await resumeAgentFromTrace(stateToResume)
+
+console.log('Resumed plan status:', resumedPlan.status)
+console.log('Task outputs:', resumedPlan.tasks.map((t) => ({ id: t.id, status: t.status })))
+```
+
+### AgentState structure
+
+```ts
+interface AgentState {
+  plan: AgentPlan               // Full plan with all tasks (completed and pending)
+  trace: WorkflowEvent[]        // Captured trace events from previous execution
+  resumeFromTaskIndex: number   // Zero-based index — tasks before this are loaded from cache
+}
+
+interface AgentPlan {
+  id: string
+  tasks: AgentTask[]
+  status: 'planning' | 'executing' | 'completed' | 'failed' | 'paused'
+  currentTaskIndex: number
+  context: Record<string, unknown>
+  metadata: Record<string, unknown>
+}
+
+interface AgentTask {
+  id: string
+  status: 'pending' | 'in-progress' | 'completed' | 'failed'
+  description: string
+  tool: string          // Name of the tool function to invoke
+  input: unknown        // May contain { $ref: "task-N.output.fieldName" } placeholders
+  output?: unknown      // Populated after execution
+  error?: string
+  startedAt?: number
+  completedAt?: number
+}
+```
+
+### Task input placeholders
+
+Task inputs can reference previous task outputs using `{ $ref: "taskId.output.fieldPath" }`:
+
+```ts
+// task-2 uses the embedding produced by task-1
+{
+  id: 'task-2',
+  tool: 'taskSelectorService',
+  input: {
+    queryEmbedding: { $ref: 'task-1.output.embedding' },
+    topK: 3,
+  }
+}
+```
+
+Placeholders are resolved at execution time by `resolveTaskInput()`.
+
+### Dashboard integration
+
+When running an agent workflow through the dashboard:
+
+1. Agent task observations are **visually highlighted** with a purple background and left border, making them easy to identify.
+2. Each agent observation shows a **T1 / T2 / T3** badge indicating which task it belongs to.
+3. In the observation detail panel, a **"Resume from Task N"** button appears (agent steps only — non-agent steps have no button).
+4. Clicking it calls `/api/resume-agent-from-task` with the serialized `AgentState` and the chosen `taskIndex`, then adds the resumed run as a new trace in the comparison table.
+
+### Best practices for resumable agents
+
+- **Keep tasks idempotent** where possible — if a task must be re-run, ensure it produces the same result.
+- **Store minimal outputs** — only record what downstream tasks need, not full API responses.
+- **Version your state schema** — if tool interfaces change, old states may need migration.
+- **Use sequential tasks** — the current implementation runs tasks one-by-one; parallel task support is a planned future enhancement.
+
+---
+
 ## Project Structure
 
 ```
@@ -481,6 +698,34 @@ uninstallAIInterceptor() // restore original fetch when done
 
 ---
 
+## Recording Tool Calls Explicitly
+
+If you want to ensure tool calls are always recorded in the workflow trace—regardless of how your tools are imported or used—you can use the `recordToolCall` utility provided by this SDK.
+
+### How to Use
+
+
+1. Import the function in your tool implementation:
+
+```ts
+import { recordToolCall } from 'elasticdash-test'
+
+export async function myTool(input: string) {
+  // ...tool logic...
+  const result = `Hello, ${input}!`
+  recordToolCall('myTool', { input }, result)
+  return result
+}
+```
+
+2. When running under ElasticDash, all calls to `recordToolCall` will be captured in the workflow trace. When running locally or outside the runner, this function is a no-op and will not affect your code.
+
+**This approach is robust and works with both imported and global tools.**
+
+**Summary:**
+- Use tools as globals (no import) for full traceability and automatic tool call capture.
+- This approach keeps your workflow code clean and enables powerful debugging and analytics in ElasticDash.
+
 ## Non-Goals
 
 This runner intentionally does not support:

package/dist/browser-ui.js

@@ -1,7 +1,5 @@
 import http from 'node:http';
-import path from 'node:path';
 import os from 'node:os';
-import { fileURLToPath } from 'node:url';
 import { spawn } from 'node:child_process';
 const defaultHtml = `<!doctype html>
 <html lang="en">
@@ -149,8 +147,6 @@ const defaultHtml = `<!doctype html>
 export async function startBrowserUiServer(opts = {}) {
     const autoOpen = opts.autoOpen !== false;
     let port = opts.port ?? 4571;
-    // Ensure base dir for potential static assets (none now)
-    const __dirname = path.dirname(fileURLToPath(import.meta.url));
     const clients = [];
     const eventBuffer = [];
     const handler = (req, res) => {

package/dist/browser-ui.js.map

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

package/dist/capture/event.d.ts

@@ -0,0 +1,19 @@
+export type WorkflowEventType = 'ai' | 'tool' | 'http' | 'db' | 'side_effect';
+export interface WorkflowEvent {
+    id: number;
+    type: WorkflowEventType;
+    name: string;
+    input: unknown;
+    output: unknown;
+    timestamp: number;
+    durationMs: number;
+    /** Optional: ID of the agent task that produced this event */
+    agentTaskId?: string;
+    /** Optional: Zero-based index of the agent task that produced this event */
+    agentTaskIndex?: number;
+}
+export interface WorkflowTrace {
+    traceId: string;
+    events: WorkflowEvent[];
+}
+//# sourceMappingURL=event.d.ts.map

package/dist/capture/event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event.d.ts","sourceRoot":"","sources":["../../src/capture/event.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,aAAa,CAAA;AAE7E,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,iBAAiB,CAAA;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,OAAO,CAAA;IACd,MAAM,EAAE,OAAO,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,CAAA;IAClB,8DAA8D;IAC9D,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,4EAA4E;IAC5E,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,aAAa,EAAE,CAAA;CACxB"}

package/dist/capture/event.js

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

package/dist/capture/event.js.map

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

package/dist/capture/index.d.ts

@@ -0,0 +1,4 @@
+export * from './event.js';
+export * from './recorder.js';
+export * from './replay.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/capture/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/capture/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,eAAe,CAAA;AAC7B,cAAc,aAAa,CAAA"}

package/dist/capture/index.js

@@ -0,0 +1,4 @@
+export * from './event.js';
+export * from './recorder.js';
+export * from './replay.js';
+//# sourceMappingURL=index.js.map

package/dist/capture/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/capture/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,eAAe,CAAA;AAC7B,cAAc,aAAa,CAAA"}

package/dist/capture/recorder.d.ts

@@ -0,0 +1,19 @@
+import type { WorkflowEvent, WorkflowTrace } from './event.js';
+import type { ReplayController } from './replay.js';
+export declare class TraceRecorder {
+    events: WorkflowEvent[];
+    private _counter;
+    private _sideEffectCounter;
+    record(event: WorkflowEvent): void;
+    nextId(): number;
+    /** Separate counter for Date.now / Math.random — never shares IDs with main events. */
+    nextSideEffectId(): number;
+    toTrace(traceId?: string): WorkflowTrace;
+}
+export interface CaptureContext {
+    recorder: TraceRecorder;
+    replay: ReplayController;
+}
+export declare function setCaptureContext(ctx: CaptureContext | undefined): void;
+export declare function getCaptureContext(): CaptureContext | undefined;
+//# sourceMappingURL=recorder.d.ts.map

package/dist/capture/recorder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recorder.d.ts","sourceRoot":"","sources":["../../src/capture/recorder.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAEnD,qBAAa,aAAa;IACxB,MAAM,EAAE,aAAa,EAAE,CAAK;IAC5B,OAAO,CAAC,QAAQ,CAAI;IACpB,OAAO,CAAC,kBAAkB,CAAI;IAE9B,MAAM,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI;IAIlC,MAAM,IAAI,MAAM;IAIhB,uFAAuF;IACvF,gBAAgB,IAAI,MAAM;IAI1B,OAAO,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,aAAa;CAMzC;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,aAAa,CAAA;IACvB,MAAM,EAAE,gBAAgB,CAAA;CACzB;AASD,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,cAAc,GAAG,SAAS,GAAG,IAAI,CAEvE;AAED,wBAAgB,iBAAiB,IAAI,cAAc,GAAG,SAAS,CAE9D"}

package/dist/capture/recorder.js

@@ -0,0 +1,36 @@
+import { AsyncLocalStorage } from 'node:async_hooks';
+import { randomUUID } from 'node:crypto';
+export class TraceRecorder {
+    events = [];
+    _counter = 0;
+    _sideEffectCounter = 0;
+    record(event) {
+        this.events.push(event);
+    }
+    nextId() {
+        return ++this._counter;
+    }
+    /** Separate counter for Date.now / Math.random — never shares IDs with main events. */
+    nextSideEffectId() {
+        return ++this._sideEffectCounter;
+    }
+    toTrace(traceId) {
+        return {
+            traceId: traceId ?? randomUUID(),
+            events: [...this.events],
+        };
+    }
+}
+const g = globalThis;
+const CAPTURE_ALS_KEY = '__elasticdash_capture_als__';
+const captureAls = g[CAPTURE_ALS_KEY] ??
+    new AsyncLocalStorage();
+if (!g[CAPTURE_ALS_KEY])
+    g[CAPTURE_ALS_KEY] = captureAls;
+export function setCaptureContext(ctx) {
+    captureAls.enterWith(ctx);
+}
+export function getCaptureContext() {
+    return captureAls.getStore();
+}
+//# sourceMappingURL=recorder.js.map

package/dist/capture/recorder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recorder.js","sourceRoot":"","sources":["../../src/capture/recorder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAIxC,MAAM,OAAO,aAAa;IACxB,MAAM,GAAoB,EAAE,CAAA;IACpB,QAAQ,GAAG,CAAC,CAAA;IACZ,kBAAkB,GAAG,CAAC,CAAA;IAE9B,MAAM,CAAC,KAAoB;QACzB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IACzB,CAAC;IAED,MAAM;QACJ,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAA;IACxB,CAAC;IAED,uFAAuF;IACvF,gBAAgB;QACd,OAAO,EAAE,IAAI,CAAC,kBAAkB,CAAA;IAClC,CAAC;IAED,OAAO,CAAC,OAAgB;QACtB,OAAO;YACL,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE;YAChC,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC;SACzB,CAAA;IACH,CAAC;CACF;AAOD,MAAM,CAAC,GAAG,UAAqC,CAAA;AAC/C,MAAM,eAAe,GAAG,6BAA6B,CAAA;AACrD,MAAM,UAAU,GACb,CAAC,CAAC,eAAe,CAAmD;IACrE,IAAI,iBAAiB,EAA8B,CAAA;AACrD,IAAI,CAAC,CAAC,CAAC,eAAe,CAAC;IAAE,CAAC,CAAC,eAAe,CAAC,GAAG,UAAU,CAAA;AAExD,MAAM,UAAU,iBAAiB,CAAC,GAA+B;IAC/D,UAAU,CAAC,SAAS,CAAC,GAAG,CAAC,CAAA;AAC3B,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,OAAO,UAAU,CAAC,QAAQ,EAAE,CAAA;AAC9B,CAAC"}

package/dist/capture/replay.d.ts

@@ -0,0 +1,20 @@
+import type { WorkflowEvent } from './event.js';
+export declare class ReplayController {
+    replayMode: boolean;
+    checkpoint: number;
+    history: WorkflowEvent[];
+    private historyMap;
+    /** Side effects keyed by their assigned sideEffectId, independent of main event IDs */
+    private sideEffectMap;
+    constructor(replayMode: boolean, checkpoint: number, history: WorkflowEvent[]);
+    shouldReplay(eventId: number): boolean;
+    getRecordedEvent(eventId: number): WorkflowEvent | undefined;
+    getRecordedResult(eventId: number): unknown;
+    /** Returns true if the side effect with this sideEffectId has a recorded value to replay */
+    shouldReplaySideEffect(n: number): boolean;
+    getSideEffectResult(n: number): unknown;
+    getRecordedSideEffectEvent(n: number): WorkflowEvent | undefined;
+    shouldReplaySideEffectOfType(n: number, expectedName: string): boolean;
+    getSideEffectResultOfType(n: number, expectedName: string): unknown;
+}
+//# sourceMappingURL=replay.d.ts.map

package/dist/capture/replay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replay.d.ts","sourceRoot":"","sources":["../../src/capture/replay.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE/C,qBAAa,gBAAgB;IAMlB,UAAU,EAAE,OAAO;IACnB,UAAU,EAAE,MAAM;IAClB,OAAO,EAAE,aAAa,EAAE;IAPjC,OAAO,CAAC,UAAU,CAA4B;IAC9C,uFAAuF;IACvF,OAAO,CAAC,aAAa,CAA4B;gBAGxC,UAAU,EAAE,OAAO,EACnB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,aAAa,EAAE;IAQjC,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAItC,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAI5D,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAI3C,4FAA4F;IAC5F,sBAAsB,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO;IAI1C,mBAAmB,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO;IAIvC,0BAA0B,CAAC,CAAC,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAIhE,4BAA4B,CAAC,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO;IAMtE,yBAAyB,CAAC,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO;CAKpE"}

package/dist/capture/replay.js

@@ -0,0 +1,47 @@
+export class ReplayController {
+    replayMode;
+    checkpoint;
+    history;
+    historyMap;
+    /** Side effects keyed by their assigned sideEffectId, independent of main event IDs */
+    sideEffectMap;
+    constructor(replayMode, checkpoint, history) {
+        this.replayMode = replayMode;
+        this.checkpoint = checkpoint;
+        this.history = history;
+        this.historyMap = new Map(history.map(e => [e.id, e]));
+        this.sideEffectMap = new Map(history.filter(e => e.type === 'side_effect').map(e => [e.id, e]));
+    }
+    shouldReplay(eventId) {
+        return this.replayMode && eventId <= this.checkpoint;
+    }
+    getRecordedEvent(eventId) {
+        return this.historyMap.get(eventId);
+    }
+    getRecordedResult(eventId) {
+        return this.historyMap.get(eventId)?.output;
+    }
+    /** Returns true if the side effect with this sideEffectId has a recorded value to replay */
+    shouldReplaySideEffect(n) {
+        return this.replayMode && this.sideEffectMap.has(n);
+    }
+    getSideEffectResult(n) {
+        return this.sideEffectMap.get(n)?.output;
+    }
+    getRecordedSideEffectEvent(n) {
+        return this.sideEffectMap.get(n);
+    }
+    shouldReplaySideEffectOfType(n, expectedName) {
+        if (!this.replayMode)
+            return false;
+        const event = this.sideEffectMap.get(n);
+        return !!event && event.type === 'side_effect' && event.name === expectedName;
+    }
+    getSideEffectResultOfType(n, expectedName) {
+        const event = this.sideEffectMap.get(n);
+        if (!event || event.type !== 'side_effect' || event.name !== expectedName)
+            return undefined;
+        return event.output;
+    }
+}
+//# sourceMappingURL=replay.js.map

package/dist/capture/replay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"replay.js","sourceRoot":"","sources":["../../src/capture/replay.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,gBAAgB;IAMlB;IACA;IACA;IAPD,UAAU,CAA4B;IAC9C,uFAAuF;IAC/E,aAAa,CAA4B;IAEjD,YACS,UAAmB,EACnB,UAAkB,EAClB,OAAwB;QAFxB,eAAU,GAAV,UAAU,CAAS;QACnB,eAAU,GAAV,UAAU,CAAQ;QAClB,YAAO,GAAP,OAAO,CAAiB;QAE/B,IAAI,CAAC,UAAU,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAA;QACtD,IAAI,CAAC,aAAa,GAAG,IAAI,GAAG,CAC1B,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,aAAa,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAClE,CAAA;IACH,CAAC;IAED,YAAY,CAAC,OAAe;QAC1B,OAAO,IAAI,CAAC,UAAU,IAAI,OAAO,IAAI,IAAI,CAAC,UAAU,CAAA;IACtD,CAAC;IAED,gBAAgB,CAAC,OAAe;QAC9B,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;IACrC,CAAC;IAED,iBAAiB,CAAC,OAAe;QAC/B,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IAC7C,CAAC;IAED,4FAA4F;IAC5F,sBAAsB,CAAC,CAAS;QAC9B,OAAO,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;IACrD,CAAC;IAED,mBAAmB,CAAC,CAAS;QAC3B,OAAO,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,MAAM,CAAA;IAC1C,CAAC;IAED,0BAA0B,CAAC,CAAS;QAClC,OAAO,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;IAClC,CAAC;IAED,4BAA4B,CAAC,CAAS,EAAE,YAAoB;QAC1D,IAAI,CAAC,IAAI,CAAC,UAAU;YAAE,OAAO,KAAK,CAAA;QAClC,MAAM,KAAK,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;QACvC,OAAO,CAAC,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,aAAa,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,CAAA;IAC/E,CAAC;IAED,yBAAyB,CAAC,CAAS,EAAE,YAAoB;QACvD,MAAM,KAAK,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;QACvC,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,aAAa,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY;YAAE,OAAO,SAAS,CAAA;QAC3F,OAAO,KAAK,CAAC,MAAM,CAAA;IACrB,CAAC;CACF"}

package/dist/core/agent-state.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Agent state serialization, deserialization, and utility functions.
+ *
+ * Enables capturing agent plan state during execution and resuming
+ * agents from any task in the plan without re-executing completed steps.
+ */
+import type { AgentPlan, AgentState, AgentTask } from '../types/agent.js';
+import type { WorkflowEvent } from '../capture/event.js';
+/**
+ * Serializes an agent plan and its captured trace events into an AgentState
+ * that can be persisted and later used for resumption.
+ *
+ * The resumeFromTaskIndex is automatically determined as the index of the
+ * first non-completed task. If all tasks are completed, it equals tasks.length.
+ */
+export declare function serializeAgentState(plan: AgentPlan, trace: WorkflowEvent[]): AgentState;
+/**
+ * Validates and hydrates an AgentState from a parsed JSON object.
+ * Throws if the state is invalid or cannot be safely used for resumption.
+ */
+export declare function deserializeAgentState(raw: unknown): AgentState;
+/**
+ * Extracts all completed task outputs into a flat map keyed by task ID.
+ * Used for resolving placeholder references in subsequent task inputs.
+ */
+export declare function extractTaskOutputs(plan: AgentPlan): Record<string, unknown>;
+/**
+ * Resolves placeholder references in a task input.
+ *
+ * Placeholders use the form: `{ $ref: "task-N.output.fieldName" }`
+ * where "task-N" is a task ID and "fieldName" is a dot-separated path
+ * into that task's output.
+ *
+ * Example:
+ *   previousOutputs = { "task-1": { userId: "abc" } }
+ *   input = { $ref: "task-1.output.userId" }
+ *   → returns "abc"
+ *
+ * Works recursively on nested objects and arrays.
+ */
+export declare function resolveTaskInput(input: unknown, previousOutputs: Record<string, unknown>): unknown;
+/**
+ * Clones a task and marks it as completed with the given output.
+ * Used internally when skipping already-completed tasks during resumption.
+ */
+export declare function markTaskCompleted(task: AgentTask, output: unknown): AgentTask;
+//# sourceMappingURL=agent-state.d.ts.map

package/dist/core/agent-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-state.d.ts","sourceRoot":"","sources":["../../src/core/agent-state.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAExD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,aAAa,EAAE,GAAG,UAAU,CASvF;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,GAAG,UAAU,CAuC9D;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAQ3E;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,OAAO,EACd,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACvC,OAAO,CAwBT;AAsBD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,GAAG,SAAS,CAO7E"}