opencode-swarm-plugin 0.56.0 → 0.57.0

package/claude-plugin/dist/post-compaction-tracker.d.ts

@@ -0,0 +1,133 @@
+/**
+ * Post-Compaction Tool Call Tracker
+ *
+ * Tracks tool calls after compaction resumption to detect coordinator violations
+ * and provide learning signals for eval-driven development.
+ *
+ * ## Purpose
+ *
+ * When context is compacted, the continuation agent needs observation to learn
+ * if it's following coordinator discipline. This tracker:
+ *
+ * 1. Emits resumption_started on first tool call (marks compaction exit)
+ * 2. Tracks up to N tool calls (default 20) with violation detection
+ * 3. Stops tracking after limit to avoid noise in long sessions
+ *
+ * ## Coordinator Violations Detected
+ *
+ * - **Edit/Write**: Coordinators NEVER edit files - spawn worker instead
+ * - **swarmmail_reserve/agentmail_reserve**: Workers reserve, not coordinators
+ *
+ * ## Integration
+ *
+ * Used by compaction hook to wire tool.call events → eval capture.
+ *
+ * @example
+ * ```typescript
+ * const tracker = createPostCompactionTracker({
+ *   sessionId: "session-123",
+ *   epicId: "bd-epic-456",
+ *   onEvent: captureCompactionEvent,
+ * });
+ *
+ * // Wire to OpenCode hook
+ * hooks["tool.call"] = (input) => {
+ *   tracker.trackToolCall({
+ *     tool: input.tool,
+ *     args: input.args,
+ *     timestamp: Date.now(),
+ *   });
+ * };
+ * ```
+ */
+/**
+ * Tool call event structure
+ */
+export interface ToolCallEvent {
+    tool: string;
+    args: Record<string, unknown>;
+    timestamp: number;
+}
+/**
+ * Compaction event payload (matches eval-capture.ts structure)
+ */
+export interface CompactionEvent {
+    session_id: string;
+    epic_id: string;
+    compaction_type: "detection_complete" | "prompt_generated" | "context_injected" | "resumption_started" | "tool_call_tracked";
+    payload: {
+        session_id?: string;
+        epic_id?: string;
+        tool?: string;
+        args?: Record<string, unknown>;
+        call_number?: number;
+        is_coordinator_violation?: boolean;
+        violation_reason?: string;
+        timestamp?: number;
+    };
+}
+/**
+ * Tracker configuration
+ */
+export interface PostCompactionTrackerConfig {
+    sessionId: string;
+    epicId: string;
+    onEvent: (event: CompactionEvent) => void;
+    maxCalls?: number;
+}
+/**
+ * Post-compaction tracker instance
+ */
+export interface PostCompactionTracker {
+    trackToolCall(event: ToolCallEvent): void;
+    isTracking(): boolean;
+}
+/**
+ * Default maximum number of tool calls to track
+ *
+ * Chosen to balance:
+ * - Enough data for pattern detection (20 calls is ~2-3 minutes of coordinator work)
+ * - Avoiding noise pollution in long sessions
+ */
+export declare const DEFAULT_MAX_TRACKED_CALLS = 20;
+/**
+ * Check if tool call is a coordinator violation
+ *
+ * @param tool - Tool name from OpenCode tool.call hook
+ * @returns Violation status with reason if forbidden
+ *
+ * @example
+ * ```typescript
+ * const result = isCoordinatorViolation("edit");
+ * // { isViolation: true, reason: "Coordinators NEVER edit..." }
+ *
+ * const result = isCoordinatorViolation("read");
+ * // { isViolation: false }
+ * ```
+ */
+export declare function isCoordinatorViolation(tool: string): {
+    isViolation: boolean;
+    reason?: string;
+};
+/**
+ * Create a post-compaction tool call tracker
+ *
+ * @example
+ * ```typescript
+ * const tracker = createPostCompactionTracker({
+ *   sessionId: "session-123",
+ *   epicId: "bd-epic-456",
+ *   onEvent: (event) => captureCompactionEvent(event),
+ *   maxCalls: 20
+ * });
+ *
+ * // Track tool calls
+ * tracker.trackToolCall({
+ *   tool: "read",
+ *   args: { filePath: "/test.ts" },
+ *   timestamp: Date.now()
+ * });
+ * ```
+ */
+export declare function createPostCompactionTracker(config: PostCompactionTrackerConfig): PostCompactionTracker;
+//# sourceMappingURL=post-compaction-tracker.d.ts.map

package/claude-plugin/dist/post-compaction-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"post-compaction-tracker.d.ts","sourceRoot":"","sources":["../src/post-compaction-tracker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AAEH;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EACX,oBAAoB,GACpB,kBAAkB,GAClB,kBAAkB,GAClB,oBAAoB,GACpB,mBAAmB,CAAC;IACxB,OAAO,EAAE;QACP,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,wBAAwB,CAAC,EAAE,OAAO,CAAC;QACnC,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAC;IAC1C,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,aAAa,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,CAAC;IAC1C,UAAU,IAAI,OAAO,CAAC;CACvB;AAMD;;;;;;GAMG;AACH,eAAO,MAAM,yBAAyB,KAAK,CAAC;AAoB5C;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG;IACpD,WAAW,EAAE,OAAO,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAMA;AAMD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,2BAA2B,GAClC,qBAAqB,CA2DvB"}

package/claude-plugin/dist/query-tools.d.ts

@@ -0,0 +1,90 @@
+/**
+ * GREEN PHASE: SQL Query Tools Implementation
+ *
+ * Provides:
+ * - 13 preset queries for observability insights (10 base + 3 decision trace)
+ * - Custom SQL execution with timing
+ * - 3 output formats: Table (box-drawing), CSV, JSON
+ */
+import type { DatabaseAdapter } from "swarm-mail";
+export type PresetQueryName = "failed_decompositions" | "duration_by_strategy" | "file_conflicts" | "worker_success_rate" | "review_rejections" | "blocked_tasks" | "agent_activity" | "event_frequency" | "error_patterns" | "compaction_stats" | "decision_quality" | "strategy_success_rates" | "decisions_by_pattern";
+export interface QueryResult {
+    columns: string[];
+    rows: Record<string, unknown>[];
+    rowCount: number;
+    executionTimeMs: number;
+}
+export declare const presetQueries: Record<PresetQueryName, string>;
+/**
+ * Get database path from project path.
+ * Uses global database (~/.config/swarm-tools/swarm.db)
+ */
+export declare function getDbPath(): string;
+/**
+ * Execute custom SQL against the events table (low-level).
+ *
+ * @param db - DatabaseAdapter instance
+ * @param sql - SQL query string
+ * @param params - Optional parameterized query values
+ * @returns QueryResult with rows, columns, timing
+ */
+export declare function executeQuery(db: DatabaseAdapter, sql: string, params?: unknown[]): Promise<QueryResult>;
+/**
+ * Execute a preset query by name (low-level, requires DatabaseAdapter).
+ *
+ * @param db - DatabaseAdapter instance
+ * @param presetName - Name of the preset query
+ * @returns QueryResult with rows, columns, timing
+ */
+export declare function executePresetQuery(db: DatabaseAdapter, presetName: string): Promise<QueryResult>;
+/**
+ * Execute custom SQL query (CLI wrapper).
+ * Creates database adapter automatically.
+ *
+ * @param projectPath - Project path (unused, queries global database)
+ * @param sql - SQL query string
+ * @returns Raw rows array for CLI formatting
+ */
+export declare function executeQueryCLI(projectPath: string, sql: string): Promise<any[]>;
+/**
+ * Execute a preset query by name (CLI wrapper).
+ * Creates database adapter automatically.
+ *
+ * @param projectPath - Project path (unused, queries global database)
+ * @param presetName - Name of the preset query
+ * @returns Raw rows array for CLI formatting
+ */
+export declare function executePreset(projectPath: string, presetName: string): Promise<any[]>;
+/**
+ * Format query result as aligned table with box-drawing characters.
+ *
+ * Example output:
+ * ┌──────────┬───────┐
+ * │ name     │ count │
+ * ├──────────┼───────┤
+ * │ AgentA   │     5 │
+ * │ AgentB   │     3 │
+ * └──────────┴───────┘
+ * 2 rows (12.5ms)
+ */
+export declare function formatAsTable(result: QueryResult): string;
+/**
+ * Format query result as CSV with proper escaping.
+ *
+ * Escapes:
+ * - Commas → wrap in quotes
+ * - Quotes → double them
+ * - Newlines → wrap in quotes
+ */
+export declare function formatAsCSV(result: QueryResult): string;
+/**
+ * Format query result as pretty-printed JSON array.
+ *
+ * Example:
+ * [
+ *   { "name": "AgentA", "count": 5 },
+ *   { "name": "AgentB", "count": 3 }
+ * ]
+ */
+export declare function formatAsJSON(result: QueryResult): string;
+//# sourceMappingURL=query-tools.d.ts.map

package/claude-plugin/dist/query-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-tools.d.ts","sourceRoot":"","sources":["../src/query-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAOlD,MAAM,MAAM,eAAe,GACxB,uBAAuB,GACvB,sBAAsB,GACtB,gBAAgB,GAChB,qBAAqB,GACrB,mBAAmB,GACnB,eAAe,GACf,gBAAgB,GAChB,iBAAiB,GACjB,gBAAgB,GAChB,kBAAkB,GAClB,kBAAkB,GAClB,wBAAwB,GACxB,sBAAsB,CAAC;AAE1B,MAAM,WAAW,WAAW;IAC3B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;CACxB;AAMD,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,eAAe,EAAE,MAAM,CAgKzD,CAAC;AAMF;;;GAGG;AACH,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAeD;;;;;;;GAOG;AACH,wBAAsB,YAAY,CACjC,EAAE,EAAE,eAAe,EACnB,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,OAAO,EAAE,GAChB,OAAO,CAAC,WAAW,CAAC,CAiBtB;AAED;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CACvC,EAAE,EAAE,eAAe,EACnB,UAAU,EAAE,MAAM,GAChB,OAAO,CAAC,WAAW,CAAC,CAStB;AAED;;;;;;;GAOG;AACH,wBAAsB,eAAe,CACpC,WAAW,EAAE,MAAM,EACnB,GAAG,EAAE,MAAM,GACT,OAAO,CAAC,GAAG,EAAE,CAAC,CAIhB;AAED;;;;;;;GAOG;AACH,wBAAsB,aAAa,CAClC,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,GAChB,OAAO,CAAC,GAAG,EAAE,CAAC,CAIhB;AAMD;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAkEzD;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CA2BvD;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAExD"}

package/claude-plugin/dist/rate-limiter.d.ts

@@ -0,0 +1,218 @@
+/**
+ * Rate Limiter Module - Distributed rate limiting for Agent Mail
+ *
+ * Provides sliding window rate limiting with dual backends:
+ * - Redis (primary) - Distributed, uses sorted sets for sliding window
+ * - SQLite (fallback) - Local, file-based persistence
+ *
+ * Features:
+ * - Dual window enforcement: per-minute AND per-hour limits
+ * - Automatic backend fallback (Redis → SQLite)
+ * - Configurable limits per endpoint via env vars
+ * - Auto-cleanup of expired entries
+ *
+ * @example
+ * ```typescript
+ * // Create rate limiter (auto-selects backend)
+ * const limiter = await createRateLimiter();
+ *
+ * // Check if request is allowed
+ * const result = await limiter.checkLimit("BlueLake", "send");
+ * if (!result.allowed) {
+ *   console.log(`Rate limited. Reset at ${result.resetAt}`);
+ * }
+ *
+ * // Record a request after it completes
+ * await limiter.recordRequest("BlueLake", "send");
+ * ```
+ */
+import Redis from "ioredis";
+/**
+ * Result of checking a rate limit
+ */
+export interface RateLimitResult {
+    /** Whether the request is allowed */
+    allowed: boolean;
+    /** Remaining requests in the most restrictive window */
+    remaining: number;
+    /** Unix timestamp (ms) when the limit resets */
+    resetAt: number;
+}
+/**
+ * Rate limiter interface
+ */
+export interface RateLimiter {
+    /**
+     * Check if a request is allowed under rate limits
+     * Checks BOTH minute and hour windows - both must pass
+     *
+     * @param agentName - The agent making the request
+     * @param endpoint - The endpoint being accessed
+     * @returns Rate limit check result
+     */
+    checkLimit(agentName: string, endpoint: string): Promise<RateLimitResult>;
+    /**
+     * Record a request against the rate limit
+     * Should be called AFTER the request succeeds
+     *
+     * @param agentName - The agent making the request
+     * @param endpoint - The endpoint being accessed
+     */
+    recordRequest(agentName: string, endpoint: string): Promise<void>;
+    /**
+     * Close the rate limiter and release resources
+     */
+    close(): Promise<void>;
+}
+/**
+ * Rate limit configuration for an endpoint
+ */
+export interface EndpointLimits {
+    /** Requests allowed per minute */
+    perMinute: number;
+    /** Requests allowed per hour */
+    perHour: number;
+}
+/**
+ * Default rate limits per endpoint
+ * Can be overridden via OPENCODE_RATE_LIMIT_{ENDPOINT}_PER_MIN and _PER_HOUR
+ */
+export declare const DEFAULT_LIMITS: Record<string, EndpointLimits>;
+/**
+ * Get rate limits for an endpoint, with env var overrides
+ *
+ * @param endpoint - The endpoint name
+ * @returns Rate limits for the endpoint
+ */
+export declare function getLimitsForEndpoint(endpoint: string): EndpointLimits;
+/**
+ * Redis-backed rate limiter using sorted sets
+ *
+ * Uses sliding window algorithm:
+ * 1. Store each request as a member with timestamp as score
+ * 2. Remove expired entries (outside window)
+ * 3. Count remaining entries
+ *
+ * Key format: ratelimit:{agent}:{endpoint}:{window}
+ * Window values: "minute" or "hour"
+ */
+export declare class RedisRateLimiter implements RateLimiter {
+    private redis;
+    private connected;
+    constructor(redis: Redis);
+    /**
+     * Build Redis key for rate limiting
+     */
+    private buildKey;
+    /**
+     * Get window duration in milliseconds
+     */
+    private getWindowDuration;
+    checkLimit(agentName: string, endpoint: string): Promise<RateLimitResult>;
+    /**
+     * Check a single window's rate limit
+     */
+    private checkWindow;
+    recordRequest(agentName: string, endpoint: string): Promise<void>;
+    close(): Promise<void>;
+}
+/**
+ * SQLite-backed rate limiter for local/fallback use
+ *
+ * Table schema:
+ * - agent_name: TEXT
+ * - endpoint: TEXT
+ * - window: TEXT ('minute' or 'hour')
+ * - timestamp: INTEGER (Unix ms)
+ *
+ * Uses sliding window via COUNT query with timestamp filter.
+ */
+export declare class SqliteRateLimiter implements RateLimiter {
+    private db;
+    constructor(dbPath: string);
+    /**
+     * Initialize the database schema and cleanup old entries
+     */
+    private initialize;
+    checkLimit(agentName: string, endpoint: string): Promise<RateLimitResult>;
+    /**
+     * Check a single window's rate limit
+     */
+    private checkWindow;
+    /**
+     * Clean up old rate limit entries in bounded batches
+     *
+     * Limits cleanup to prevent blocking recordRequest on large datasets:
+     * - BATCH_SIZE: 1000 rows per iteration
+     * - MAX_BATCHES: 10 (max 10k rows per cleanup invocation)
+     *
+     * Stops early if fewer than BATCH_SIZE rows deleted (no more to clean).
+     */
+    private cleanup;
+    recordRequest(agentName: string, endpoint: string): Promise<void>;
+    close(): Promise<void>;
+}
+/**
+ * In-memory rate limiter for testing
+ *
+ * Uses Map storage with timestamp arrays per key.
+ * No persistence - resets on process restart.
+ */
+export declare class InMemoryRateLimiter implements RateLimiter {
+    private storage;
+    private buildKey;
+    checkLimit(agentName: string, endpoint: string): Promise<RateLimitResult>;
+    private checkWindow;
+    recordRequest(agentName: string, endpoint: string): Promise<void>;
+    close(): Promise<void>;
+    /**
+     * Reset all rate limits (for testing)
+     */
+    reset(): void;
+}
+/**
+ * Create a rate limiter with automatic backend selection
+ *
+ * Tries Redis first, falls back to SQLite on connection failure.
+ * Warns once when falling back to SQLite.
+ *
+ * @returns Configured rate limiter instance
+ *
+ * @example
+ * ```typescript
+ * // Auto-select backend
+ * const limiter = await createRateLimiter();
+ *
+ * // Force SQLite
+ * const limiter = await createRateLimiter({ backend: "sqlite" });
+ *
+ * // Force in-memory (testing)
+ * const limiter = await createRateLimiter({ backend: "memory" });
+ * ```
+ */
+export declare function createRateLimiter(options?: {
+    backend?: "redis" | "sqlite" | "memory";
+    redisUrl?: string;
+    sqlitePath?: string;
+}): Promise<RateLimiter>;
+/**
+ * Reset the fallback warning flag (for testing)
+ */
+export declare function resetFallbackWarning(): void;
+/**
+ * Get or create the global rate limiter instance
+ *
+ * Uses auto-selection (Redis → SQLite) by default.
+ */
+export declare function getRateLimiter(): Promise<RateLimiter>;
+/**
+ * Set the global rate limiter instance
+ *
+ * Useful for testing or custom configurations.
+ */
+export declare function setRateLimiter(limiter: RateLimiter): void;
+/**
+ * Reset the global rate limiter instance
+ */
+export declare function resetRateLimiter(): Promise<void>;
+//# sourceMappingURL=rate-limiter.d.ts.map

package/claude-plugin/dist/rate-limiter.d.ts.map

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

package/claude-plugin/dist/regression-detection.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Regression detection result
+ */
+export interface RegressionResult {
+    /** Name of the eval that regressed */
+    evalName: string;
+    /** Previous run score */
+    oldScore: number;
+    /** Latest run score */
+    newScore: number;
+    /** Absolute delta (oldScore - newScore) */
+    delta: number;
+    /** Percentage change ((newScore - oldScore) / oldScore * 100) */
+    deltaPercent: number;
+}
+/**
+ * Detect regressions by comparing latest run to previous run
+ *
+ * Scans all evals in eval-history.jsonl and compares the last two runs
+ * for each eval. Returns evals where the score dropped more than the
+ * threshold.
+ *
+ * **Algorithm**:
+ * 1. Read all eval history records
+ * 2. Group by eval name
+ * 3. For each eval with ≥2 runs:
+ *    - Get last 2 runs
+ *    - Calculate delta and deltaPercent
+ *    - If delta exceeds threshold AND score dropped, record regression
+ * 4. Sort results by severity (largest delta first)
+ *
+ * **Delta calculation**:
+ * - delta = oldScore - newScore (absolute drop)
+ * - deltaPercent = (newScore - oldScore) / oldScore * 100 (negative for regression)
+ *
+ * **Threshold**: Specified as absolute value (e.g., 0.10 = 10% drop required to report)
+ *
+ * @param projectPath - Absolute path to project root
+ * @param threshold - Minimum delta to report (default: 0.10 = 10%)
+ * @returns List of regressions sorted by severity (largest delta first)
+ *
+ * @example
+ * ```typescript
+ * import { detectRegressions } from "./regression-detection.js";
+ *
+ * const regressions = detectRegressions("/path/to/project", 0.10);
+ *
+ * if (regressions.length > 0) {
+ *   console.error("⚠️ REGRESSION DETECTED");
+ *   for (const reg of regressions) {
+ *     console.error(`├── ${reg.evalName}: ${(reg.oldScore * 100).toFixed(1)}% → ${(reg.newScore * 100).toFixed(1)}% (${reg.deltaPercent.toFixed(1)}%)`);
+ *   }
+ *   console.error(`└── Threshold: ${(threshold * 100).toFixed(0)}%`);
+ * }
+ * ```
+ */
+export declare function detectRegressions(projectPath: string, threshold?: number): RegressionResult[];
+//# sourceMappingURL=regression-detection.d.ts.map

package/claude-plugin/dist/regression-detection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"regression-detection.d.ts","sourceRoot":"","sources":["../src/regression-detection.ts"],"names":[],"mappings":"AAWA;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,sCAAsC;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,yBAAyB;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,uBAAuB;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,2CAA2C;IAC3C,KAAK,EAAE,MAAM,CAAC;IACd,iEAAiE;IACjE,YAAY,EAAE,MAAM,CAAC;CACtB;AA6CD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,MAAM,EACnB,SAAS,GAAE,MAAY,GACtB,gBAAgB,EAAE,CA0CpB"}

package/claude-plugin/dist/replay-tools.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Replay Tools - Event replay with timing simulation
+ *
+ * TDD GREEN: Minimal implementation to pass tests
+ */
+export type ReplaySpeed = "1x" | "2x" | "instant";
+export interface ReplayEvent {
+    session_id: string;
+    epic_id: string;
+    timestamp: string;
+    event_type: "DECISION" | "VIOLATION" | "OUTCOME" | "COMPACTION";
+    decision_type?: string;
+    violation_type?: string;
+    outcome_type?: string;
+    payload: Record<string, unknown>;
+    delta_ms: number;
+}
+export interface ReplayFilter {
+    type?: Array<"DECISION" | "VIOLATION" | "OUTCOME" | "COMPACTION">;
+    agent?: string;
+    since?: Date;
+    until?: Date;
+}
+export declare function fetchEpicEvents(epicId: string, sessionFile: string): Promise<ReplayEvent[]>;
+export declare function filterEvents(events: ReplayEvent[], filter: ReplayFilter): ReplayEvent[];
+export declare function replayWithTiming(events: ReplayEvent[], speed: ReplaySpeed): AsyncGenerator<ReplayEvent>;
+export declare function formatReplayEvent(event: ReplayEvent): string;
+//# sourceMappingURL=replay-tools.d.ts.map

package/claude-plugin/dist/replay-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replay-tools.d.ts","sourceRoot":"","sources":["../src/replay-tools.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AASH,MAAM,MAAM,WAAW,GAAG,IAAI,GAAG,IAAI,GAAG,SAAS,CAAC;AAElD,MAAM,WAAW,WAAW;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,UAAU,GAAG,WAAW,GAAG,SAAS,GAAG,YAAY,CAAC;IAChE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC5B,IAAI,CAAC,EAAE,KAAK,CAAC,UAAU,GAAG,WAAW,GAAG,SAAS,GAAG,YAAY,CAAC,CAAC;IAClE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,IAAI,CAAC;IACb,KAAK,CAAC,EAAE,IAAI,CAAC;CACb;AAMD,wBAAsB,eAAe,CACpC,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,GACjB,OAAO,CAAC,WAAW,EAAE,CAAC,CA4CxB;AAMD,wBAAgB,YAAY,CAC3B,MAAM,EAAE,WAAW,EAAE,EACrB,MAAM,EAAE,YAAY,GAClB,WAAW,EAAE,CAiCf;AAMD,wBAAuB,gBAAgB,CACtC,MAAM,EAAE,WAAW,EAAE,EACrB,KAAK,EAAE,WAAW,GAChB,cAAc,CAAC,WAAW,CAAC,CAuC7B;AAMD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CA0D5D"}