@jamesaphoenix/tx-core 0.4.2 → 0.4.3

package/dist/worker/hooks.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Worker Hooks - PRD-018
+ *
+ * Type definitions for the headless worker hooks system.
+ * Two hooks. That's it. Extensible context for user customization.
+ *
+ * See PRD-018 "Worker Hooks (Customization Points)" section and
+ * DD-018 "Worker Hooks Interface" section.
+ */
+import type { Task } from "@jamesaphoenix/tx-types";
+/**
+ * Result from executing a task.
+ */
+export interface ExecutionResult {
+    /** Whether the execution succeeded */
+    readonly success: boolean;
+    /** Optional output from the execution */
+    readonly output?: string;
+    /** Error message if execution failed */
+    readonly error?: string;
+}
+/**
+ * IO capture paths for run tracking.
+ */
+export interface IOCapture {
+    /** Path to transcript file */
+    readonly transcriptPath?: string;
+    /** Path to stderr capture file */
+    readonly stderrPath?: string;
+    /** Path to stdout capture file */
+    readonly stdoutPath?: string;
+}
+/**
+ * Context provided to the execute hook by tx.
+ * Contains tx primitives and mutable state.
+ */
+export interface WorkerContext {
+    /** ID of the worker processing this task */
+    readonly workerId: string;
+    /** Unique ID for this run/execution */
+    readonly runId: string;
+    /** Renew the lease on the current task to prevent expiration */
+    readonly renewLease: () => Promise<void>;
+    /** Log a message (associated with this worker/run) */
+    readonly log: (message: string) => void;
+    /** Mutable state that persists across calls within a single task execution */
+    readonly state: Record<string, unknown>;
+}
+/**
+ * Worker hooks interface.
+ * Two hooks. That's it.
+ *
+ * @template TContext - Custom context type merged with WorkerContext
+ */
+export interface WorkerHooks<TContext = object> {
+    /**
+     * Execute the work - YOUR logic lives here.
+     * Called for each task claimed by the worker.
+     *
+     * @param task - The task to execute
+     * @param ctx - Combined WorkerContext + your custom TContext
+     * @returns ExecutionResult indicating success/failure
+     */
+    readonly execute: (task: Task, ctx: WorkerContext & TContext) => Promise<ExecutionResult>;
+    /**
+     * Where to capture IO (optional).
+     * Called before execute to determine where to store run output.
+     *
+     * @param runId - The unique run ID
+     * @param task - The task being executed
+     * @returns IOCapture with paths for transcript/stderr/stdout
+     */
+    readonly captureIO?: (runId: string, task: Task) => IOCapture;
+}
+/**
+ * Configuration for runWorker().
+ * Combines hooks with worker settings and custom context.
+ *
+ * @template TContext - Custom context type merged with WorkerContext
+ */
+export interface WorkerConfig<TContext = object> {
+    /** Optional worker name. Defaults to auto-generated name. */
+    readonly name?: string;
+    /** Heartbeat interval in seconds. Should match orchestrator config. Default: 30 */
+    readonly heartbeatIntervalSeconds?: number;
+    /**
+     * Your custom context - merged into ctx.
+     * Use this to pass your own primitives (db clients, LLM clients, etc.)
+     */
+    readonly context?: TContext;
+    /**
+     * Execute hook - YOUR logic lives here.
+     * Called for each task claimed by the worker.
+     */
+    readonly execute: WorkerHooks<TContext>["execute"];
+    /**
+     * Optional IO capture hook.
+     * Called before execute to determine where to store run output.
+     */
+    readonly captureIO?: WorkerHooks<TContext>["captureIO"];
+}
+//# sourceMappingURL=hooks.d.ts.map

package/dist/worker/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/worker/hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAA;AAEnD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,sCAAsC;IACtC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,yCAAyC;IACzC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,wCAAwC;IACxC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,8BAA8B;IAC9B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAA;IAChC,kCAAkC;IAClC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,kCAAkC;IAClC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAC7B;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,4CAA4C;IAC5C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,uCAAuC;IACvC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,gEAAgE;IAChE,QAAQ,CAAC,UAAU,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IACxC,sDAAsD;IACtD,QAAQ,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;IACvC,8EAA8E;IAC9E,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACxC;AAED;;;;;GAKG;AACH,MAAM,WAAW,WAAW,CAAC,QAAQ,GAAG,MAAM;IAC5C;;;;;;;OAOG;IACH,QAAQ,CAAC,OAAO,EAAE,CAChB,IAAI,EAAE,IAAI,EACV,GAAG,EAAE,aAAa,GAAG,QAAQ,KAC1B,OAAO,CAAC,eAAe,CAAC,CAAA;IAE7B;;;;;;;OAOG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,KAAK,SAAS,CAAA;CAC9D;AAED;;;;;GAKG;AACH,MAAM,WAAW,YAAY,CAAC,QAAQ,GAAG,MAAM;IAC7C,6DAA6D;IAC7D,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,mFAAmF;IACnF,QAAQ,CAAC,wBAAwB,CAAC,EAAE,MAAM,CAAA;IAC1C;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAA;IAC3B;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,QAAQ,CAAC,CAAC,SAAS,CAAC,CAAA;IAClD;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,WAAW,CAAC,QAAQ,CAAC,CAAC,WAAW,CAAC,CAAA;CACxD"}

package/dist/worker/hooks.js

@@ -0,0 +1,11 @@
+/**
+ * Worker Hooks - PRD-018
+ *
+ * Type definitions for the headless worker hooks system.
+ * Two hooks. That's it. Extensible context for user customization.
+ *
+ * See PRD-018 "Worker Hooks (Customization Points)" section and
+ * DD-018 "Worker Hooks Interface" section.
+ */
+export {};
+//# sourceMappingURL=hooks.js.map

package/dist/worker/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../src/worker/hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/worker/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @tx/core/worker - Worker exports
+ *
+ * Headless worker primitives for agent orchestration.
+ * See PRD-018 and DD-018 for design specification.
+ */
+export { type ExecutionResult, type IOCapture, type WorkerContext, type WorkerHooks, type WorkerConfig } from "./hooks.js";
+export { runWorker } from "./run-worker.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/worker/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,SAAS,EACd,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,YAAY,EAClB,MAAM,YAAY,CAAA;AAEnB,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA"}

package/dist/worker/index.js

@@ -0,0 +1,8 @@
+/**
+ * @tx/core/worker - Worker exports
+ *
+ * Headless worker primitives for agent orchestration.
+ * See PRD-018 and DD-018 for design specification.
+ */
+export { runWorker } from "./run-worker.js";
+//# sourceMappingURL=index.js.map

package/dist/worker/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/worker/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAUH,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA"}

package/dist/worker/run-worker.d.ts

@@ -0,0 +1,33 @@
+/**
+ * runWorker - PRD-018
+ *
+ * Headless worker that executes tasks using user-provided hooks.
+ * Two hooks: execute (required), captureIO (optional).
+ * Extensible context for user customization.
+ *
+ * See PRD-018 "Worker Hooks (Customization Points)" section and
+ * DD-018 "Headless Worker Design" section.
+ */
+import { Effect } from "effect";
+import { WorkerService } from "../services/worker-service.js";
+import { ClaimService } from "../services/claim-service.js";
+import { ReadyService } from "../services/ready-service.js";
+import { RunRepository } from "../repo/run-repo.js";
+import type { WorkerConfig } from "./hooks.js";
+/**
+ * Run a headless worker that executes tasks using user-provided hooks.
+ *
+ * This function:
+ * 1. Registers the worker with the orchestrator
+ * 2. Starts a background heartbeat fiber
+ * 3. Runs a work loop that claims and processes tasks
+ * 4. Calls user's execute hook for each task with merged context
+ * 5. Creates run records with optional IO capture
+ * 6. Handles graceful shutdown via SIGTERM/SIGINT
+ *
+ * @template TContext - Custom context type merged with WorkerContext
+ * @param config - Worker configuration with hooks and optional custom context
+ * @returns Effect that runs until shutdown is requested
+ */
+export declare const runWorker: <TContext = object>(config: WorkerConfig<TContext>) => Effect.Effect<void, import("../errors.js").DatabaseError | import("../errors.js").WorkerNotFoundError | import("../errors.js").RegistrationError, ReadyService | RunRepository | WorkerService | ClaimService>;
+//# sourceMappingURL=run-worker.d.ts.map

package/dist/worker/run-worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-worker.d.ts","sourceRoot":"","sources":["../../src/worker/run-worker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,MAAM,EAAwB,MAAM,QAAQ,CAAA;AAErD,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAA;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAA;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAA;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACnD,OAAO,KAAK,EAAE,YAAY,EAA6C,MAAM,YAAY,CAAA;AAoBzF;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,SAAS,GAAI,QAAQ,GAAG,MAAM,EACzC,QAAQ,YAAY,CAAC,QAAQ,CAAC,mNAsO5B,CAAA"}

package/dist/worker/run-worker.js

@@ -0,0 +1,265 @@
+/**
+ * runWorker - PRD-018
+ *
+ * Headless worker that executes tasks using user-provided hooks.
+ * Two hooks: execute (required), captureIO (optional).
+ * Extensible context for user customization.
+ *
+ * See PRD-018 "Worker Hooks (Customization Points)" section and
+ * DD-018 "Headless Worker Design" section.
+ */
+import { Effect, Duration, Fiber, Ref } from "effect";
+import * as os from "os";
+import { WorkerService } from "../services/worker-service.js";
+import { ClaimService } from "../services/claim-service.js";
+import { ReadyService } from "../services/ready-service.js";
+import { RunRepository } from "../repo/run-repo.js";
+/**
+ * Default heartbeat interval in seconds.
+ */
+const DEFAULT_HEARTBEAT_INTERVAL = 30;
+/**
+ * Default lease renewal interval multiplier (10x heartbeat = 5 minutes at default).
+ */
+const LEASE_RENEWAL_MULTIPLIER = 10;
+/**
+ * Run a headless worker that executes tasks using user-provided hooks.
+ *
+ * This function:
+ * 1. Registers the worker with the orchestrator
+ * 2. Starts a background heartbeat fiber
+ * 3. Runs a work loop that claims and processes tasks
+ * 4. Calls user's execute hook for each task with merged context
+ * 5. Creates run records with optional IO capture
+ * 6. Handles graceful shutdown via SIGTERM/SIGINT
+ *
+ * @template TContext - Custom context type merged with WorkerContext
+ * @param config - Worker configuration with hooks and optional custom context
+ * @returns Effect that runs until shutdown is requested
+ */
+export const runWorker = (config) => Effect.gen(function* () {
+    const workerService = yield* WorkerService;
+    const claimService = yield* ClaimService;
+    const readyService = yield* ReadyService;
+    const runRepo = yield* RunRepository;
+    const heartbeatInterval = config.heartbeatIntervalSeconds ?? DEFAULT_HEARTBEAT_INTERVAL;
+    // Shutdown state ref (mutable, shared with signal handlers)
+    const shutdownState = yield* Ref.make({
+        requested: false
+    });
+    // Register with orchestrator
+    const worker = yield* workerService.register({
+        name: config.name,
+        hostname: os.hostname(),
+        pid: process.pid
+    });
+    const workerId = worker.id;
+    yield* Effect.log(`runWorker: Worker ${workerId} registered`);
+    // Set up signal handlers for graceful shutdown
+    const handleSignal = (signal) => {
+        console.log(`runWorker: Worker ${workerId} received ${signal}`);
+        // Mark shutdown as requested (sync since signal handlers can't use async)
+        Effect.runSync(Ref.update(shutdownState, (state) => ({
+            ...state,
+            requested: true
+        })));
+    };
+    const sigTermHandler = () => handleSignal("SIGTERM");
+    const sigIntHandler = () => handleSignal("SIGINT");
+    process.on("SIGTERM", sigTermHandler);
+    process.on("SIGINT", sigIntHandler);
+    // Completed tasks counter for metrics
+    const tasksCompletedRef = yield* Ref.make(0);
+    // Heartbeat fiber - runs continuously in background
+    const heartbeatFiber = yield* Effect.fork(runHeartbeatLoop(workerId, heartbeatInterval, shutdownState, tasksCompletedRef));
+    try {
+        // Main work loop
+        while (true) {
+            // Check if shutdown was requested
+            const state = yield* Ref.get(shutdownState);
+            if (state.requested) {
+                yield* Effect.log(`runWorker: Worker ${workerId} shutting down gracefully`);
+                break;
+            }
+            // Update status to idle
+            yield* workerService.updateStatus(workerId, "idle");
+            // Check for available work
+            const readyTasks = yield* readyService.getReady(1);
+            if (readyTasks.length === 0) {
+                // No work available, wait and try again
+                yield* Effect.sleep(Duration.seconds(5));
+                continue;
+            }
+            const task = readyTasks[0];
+            // Try to claim the task
+            const claimResult = yield* claimService.claim(task.id, workerId).pipe(Effect.either);
+            if (claimResult._tag === "Left") {
+                // Someone else claimed it, try again
+                yield* Effect.log(`runWorker: Worker ${workerId} failed to claim task ${task.id}: ${claimResult.left._tag}`);
+                continue;
+            }
+            yield* Effect.log(`runWorker: Worker ${workerId} claimed task ${task.id}`);
+            // Create run record (this generates the run ID)
+            const runRecord = yield* runRepo.create({
+                taskId: task.id,
+                agent: workerId,
+                pid: process.pid
+            });
+            const runId = runRecord.id;
+            // Get IO capture paths from user's hook if provided
+            const ioCapture = config.captureIO?.(runId, task) ?? {};
+            // Update run record with IO paths if provided
+            if (ioCapture.transcriptPath || ioCapture.stderrPath || ioCapture.stdoutPath) {
+                yield* runRepo.update(runId, {
+                    transcriptPath: ioCapture.transcriptPath,
+                    stderrPath: ioCapture.stderrPath,
+                    stdoutPath: ioCapture.stdoutPath
+                });
+            }
+            // Update worker status to busy
+            const tasksCompleted = yield* Ref.get(tasksCompletedRef);
+            yield* workerService.heartbeat({
+                workerId,
+                timestamp: new Date(),
+                status: "busy",
+                currentTaskId: task.id,
+                metrics: {
+                    cpuPercent: process.cpuUsage().user / 1000000,
+                    memoryMb: process.memoryUsage().heapUsed / 1024 / 1024,
+                    tasksCompleted
+                }
+            });
+            // Start lease renewal fiber
+            const renewalInterval = heartbeatInterval * LEASE_RENEWAL_MULTIPLIER;
+            const renewFiber = yield* Effect.fork(runLeaseRenewalLoop(task.id, workerId, renewalInterval, shutdownState));
+            // Build worker context with tx primitives
+            const baseContext = {
+                workerId,
+                runId,
+                renewLease: async () => {
+                    await Effect.runPromise(claimService.renew(task.id, workerId).pipe(Effect.catchAll((error) => {
+                        console.error(`runWorker: renewLease failed: ${error._tag}`);
+                        return Effect.void;
+                    })));
+                },
+                log: (message) => {
+                    console.log(`[${workerId}] ${message}`);
+                },
+                state: {}
+            };
+            // Merge user's custom context
+            const mergedContext = {
+                ...baseContext,
+                ...(config.context ?? {})
+            };
+            let result;
+            try {
+                // USER HOOK: Execute (all your logic here)
+                // Use Effect.tryPromise to properly handle the async execute hook
+                result = yield* Effect.tryPromise({
+                    try: () => config.execute(task, mergedContext),
+                    catch: (error) => error
+                }).pipe(Effect.catchAll((error) => {
+                    const errorMessage = error instanceof Error ? error.message : String(error);
+                    return Effect.succeed({
+                        success: false,
+                        error: errorMessage
+                    });
+                }));
+                // Update run status based on result
+                yield* runRepo.update(runId, {
+                    status: result.success ? "completed" : "failed",
+                    endedAt: new Date(),
+                    exitCode: result.success ? 0 : 1,
+                    summary: result.output,
+                    errorMessage: result.error
+                });
+                if (result.success) {
+                    yield* Ref.update(tasksCompletedRef, (n) => n + 1);
+                    yield* Effect.log(`runWorker: Task ${task.id} completed successfully`);
+                }
+                else {
+                    yield* Effect.log(`runWorker: Task ${task.id} failed: ${result.error ?? "Unknown error"}`);
+                }
+            }
+            finally {
+                // Stop renewal fiber
+                yield* Fiber.interrupt(renewFiber);
+            }
+            // Release the claim
+            yield* claimService.release(task.id, workerId).pipe(Effect.catchAll((error) => Effect.log(`runWorker: Failed to release claim for task ${task.id}: ${error.message}`)));
+        }
+        // Graceful shutdown: mark as stopping
+        yield* workerService.updateStatus(workerId, "stopping");
+    }
+    finally {
+        // Remove signal handlers to prevent accumulation across multiple runWorker calls
+        process.removeListener("SIGTERM", sigTermHandler);
+        process.removeListener("SIGINT", sigIntHandler);
+        // Cleanup: stop heartbeat fiber and deregister
+        yield* Fiber.interrupt(heartbeatFiber);
+        // Release any active claims before deregistering
+        yield* claimService.releaseByWorker(workerId).pipe(Effect.catchAll((error) => Effect.log(`runWorker: Failed to release claims for worker ${workerId}: ${error.message}`).pipe(Effect.as(0))));
+        yield* workerService.deregister(workerId).pipe(Effect.catchAll((error) => Effect.log(`runWorker: Failed to deregister worker ${workerId}: ${error.message}`)));
+        yield* Effect.log(`runWorker: Worker ${workerId} shutdown complete`);
+    }
+});
+/**
+ * Run the heartbeat loop.
+ * Sends periodic heartbeats to the orchestrator.
+ */
+const runHeartbeatLoop = (workerId, intervalSeconds, shutdownState, tasksCompletedRef) => Effect.gen(function* () {
+    const workerService = yield* WorkerService;
+    while (true) {
+        // Check shutdown before heartbeat
+        const state = yield* Ref.get(shutdownState);
+        if (state.requested)
+            break;
+        const tasksCompleted = yield* Ref.get(tasksCompletedRef);
+        yield* workerService
+            .heartbeat({
+            workerId,
+            timestamp: new Date(),
+            status: "idle", // Will be updated by main loop when busy
+            currentTaskId: undefined,
+            metrics: {
+                cpuPercent: process.cpuUsage().user / 1000000,
+                memoryMb: process.memoryUsage().heapUsed / 1024 / 1024,
+                tasksCompleted
+            }
+        })
+            .pipe(Effect.catchAll((error) => Effect.log(`runWorker: Heartbeat failed for ${workerId}: ${error.message}`)));
+        yield* Effect.sleep(Duration.seconds(intervalSeconds));
+    }
+});
+/**
+ * Run the lease renewal loop.
+ * Periodically renews the lease on a claimed task.
+ */
+const runLeaseRenewalLoop = (taskId, workerId, intervalSeconds, shutdownState) => Effect.gen(function* () {
+    const claimService = yield* ClaimService;
+    while (true) {
+        // Wait before first renewal
+        yield* Effect.sleep(Duration.seconds(intervalSeconds));
+        // Check shutdown before renewal
+        const state = yield* Ref.get(shutdownState);
+        if (state.requested)
+            break;
+        const renewResult = yield* claimService
+            .renew(taskId, workerId)
+            .pipe(Effect.tap(() => Effect.log(`runWorker: Renewed lease on task ${taskId}`)), Effect.map(() => true), Effect.catchAll((error) => Effect.gen(function* () {
+            yield* Effect.log(`runWorker: CRITICAL: Lease renewal failed for task ${taskId}: ${error.message}. Stopping worker to prevent duplicate execution.`);
+            // Stop the worker to prevent duplicate task execution
+            // Another worker may have claimed this task after lease expiry
+            yield* Ref.update(shutdownState, (state) => ({
+                ...state,
+                requested: true
+            }));
+            return false;
+        })));
+        // Exit renewal loop if renewal failed
+        if (!renewResult)
+            break;
+    }
+});
+//# sourceMappingURL=run-worker.js.map

package/dist/worker/run-worker.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jamesaphoenix/tx-core",
-  "version": "0.4.2",
+  "version": "0.4.3",
   "description": "Core business logic for tx - Effect-TS services and repositories",
   "type": "module",
   "main": "./dist/index.js",
@@ -32,35 +32,37 @@
     }
   },
   "files": [
-    "dist"
+    "dist",
+    "README.md"
   ],
   "scripts": {
     "build": "tsc -b",
     "typecheck": "tsc --noEmit",
     "lint": "eslint src/",
-    "test": "vitest run --passWithNoTests"
+    "test": "bun vitest run --passWithNoTests"
   },
   "dependencies": {
-    "@jamesaphoenix/tx-types": "^0.4.1",
+    "@jamesaphoenix/tx-types": "*",
     "chokidar": "^5.0.0",
-    "effect": "^3.19.15"
+    "effect": "^3.19.15",
+    "yaml": "^2.7.0"
   },
   "peerDependencies": {
-    "@anthropic-ai/sdk": "^0.52.0",
-    "better-sqlite3": "^11.0.0"
+    "@anthropic-ai/claude-agent-sdk": ">=0.1.0",
+    "@anthropic-ai/sdk": "^0.52.0"
   },
   "peerDependenciesMeta": {
-    "@anthropic-ai/sdk": {
+    "@anthropic-ai/claude-agent-sdk": {
       "optional": true
     },
-    "better-sqlite3": {
-      "optional": false
+    "@anthropic-ai/sdk": {
+      "optional": true
     }
   },
   "devDependencies": {
-    "@types/better-sqlite3": "^7.6.0",
+    "@types/bun": "^1.2.0",
     "typescript": "^5.7.0",
-    "vitest": "^3.0.0"
+    "vitest": "^4.0.18"
   },
   "repository": {
     "type": "git",