macro-agent 0.2.4 → 0.2.6

package/dist/steering/index.js

@@ -0,0 +1,11 @@
+/**
+ * Steering Module
+ *
+ * Context injection and in-flight steering for agents.
+ *
+ * @module steering
+ * @see s-9rld In-Flight Steering spec
+ */
+// Core functions
+export { injectContext, createInjector, formatInjectedContent, } from "./inject.js";
+//# sourceMappingURL=index.js.map

package/dist/steering/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/steering/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAYH,iBAAiB;AACjB,OAAO,EACL,aAAa,EACb,cAAc,EACd,qBAAqB,GACtB,MAAM,aAAa,CAAC"}

package/dist/steering/inject.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Context Injection
+ *
+ * Implements the core injectContext() function with full fallback chain:
+ * 1. Try session.inject() if supported
+ * 2. Fall back to session.interruptWith() if allowed
+ * 3. Fall back to high-priority message
+ *
+ * @module steering/inject
+ * @see s-9rld In-Flight Steering spec section 3.1
+ */
+import type { AgentId } from "../store/types/index.js";
+import type { InjectionOptions, InjectionResult, InjectionDeps } from "./types.js";
+/**
+ * Format injected content with metadata for context.
+ */
+export declare function formatInjectedContent(content: string, options: InjectionOptions): string;
+/**
+ * Inject context into an agent's session.
+ *
+ * Uses a fallback chain:
+ * 1. If urgent, prefer interrupt for immediate effect
+ * 2. Try session.inject() if supported (queues for next turn)
+ * 3. Fall back to session.interruptWith() if allowInterrupt is true
+ * 4. Fall back to sending a high-priority message
+ *
+ * @param deps - Dependencies for session access and messaging
+ * @param targetAgentId - The agent to inject context into
+ * @param content - The context to inject
+ * @param options - Injection options
+ * @returns Result of the injection attempt
+ */
+export declare function injectContext(deps: InjectionDeps, targetAgentId: AgentId, content: string, options?: InjectionOptions): Promise<InjectionResult>;
+/**
+ * Create an injection function bound to specific dependencies.
+ * Useful for creating a pre-configured injector.
+ */
+export declare function createInjector(deps: InjectionDeps): (targetAgentId: AgentId, content: string, options?: InjectionOptions) => Promise<InjectionResult>;
+//# sourceMappingURL=inject.d.ts.map

package/dist/steering/inject.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inject.d.ts","sourceRoot":"","sources":["../../src/steering/inject.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,KAAK,EACV,gBAAgB,EAChB,eAAe,EACf,aAAa,EAEd,MAAM,YAAY,CAAC;AAepB;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,gBAAgB,GACxB,MAAM,CAsBR;AAqFD;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,aAAa,EACnB,aAAa,EAAE,OAAO,EACtB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,eAAe,CAAC,CAoD1B;AAiCD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,aAAa,IAE9C,eAAe,OAAO,EACtB,SAAS,MAAM,EACf,UAAU,gBAAgB,8BAE7B"}

package/dist/steering/inject.js

@@ -0,0 +1,197 @@
+/**
+ * Context Injection
+ *
+ * Implements the core injectContext() function with full fallback chain:
+ * 1. Try session.inject() if supported
+ * 2. Fall back to session.interruptWith() if allowed
+ * 3. Fall back to high-priority message
+ *
+ * @module steering/inject
+ * @see s-9rld In-Flight Steering spec section 3.1
+ */
+// =============================================================================
+// Default Options
+// =============================================================================
+const DEFAULT_OPTIONS = {
+    allowInterrupt: true,
+    urgent: false,
+};
+// =============================================================================
+// Context Formatting
+// =============================================================================
+/**
+ * Format injected content with metadata for context.
+ */
+export function formatInjectedContent(content, options) {
+    const lines = [];
+    // Add header based on source
+    if (options.source?.type === "human") {
+        lines.push("[Context Injection from User]");
+    }
+    else if (options.source?.type === "agent") {
+        lines.push(`[Context Injection from Agent: ${options.source.agentId}]`);
+    }
+    else {
+        lines.push("[Context Injection]");
+    }
+    // Add reason if provided
+    if (options.reason) {
+        lines.push(`Reason: ${options.reason}`);
+    }
+    // Add the actual content
+    lines.push("");
+    lines.push(content);
+    return lines.join("\n");
+}
+// =============================================================================
+// Core Injection Logic
+// =============================================================================
+/**
+ * Attempt to inject via session.inject().
+ * Returns null if not supported or failed.
+ */
+async function tryInject(session, content) {
+    // Check if inject is supported
+    if (!session.supportsInject()) {
+        // Try to verify with actual probe
+        const supported = await session.checkInjectSupport();
+        if (!supported) {
+            return null;
+        }
+    }
+    try {
+        const result = await session.inject(content);
+        if (result.success) {
+            return {
+                success: true,
+                method: "inject",
+                note: "Queued for next turn",
+            };
+        }
+        // Inject returned failure
+        return null;
+    }
+    catch {
+        // Inject threw an error
+        return null;
+    }
+}
+/**
+ * Attempt to inject via session.interruptWith().
+ * This cancels current work and restarts with the new content.
+ */
+async function tryInterrupt(session, content) {
+    try {
+        // Prepend context to explain the interruption
+        const interruptContent = `[PRIORITY UPDATE - Previous work interrupted]\n\n${content}\n\nPlease incorporate this context and continue.`;
+        // Drive the async iterator to completion
+        // We don't need to process the updates, just ensure the interrupt happens
+        const iterable = session.interruptWith(interruptContent);
+        const iterator = iterable[Symbol.asyncIterator]();
+        // Consume the first update to ensure the interrupt is processed
+        // Then let it run in the background
+        const firstUpdate = await iterator.next();
+        if (firstUpdate.done === false) {
+            // Interrupt started successfully, let it continue in background
+            // We don't await all updates to avoid blocking
+            (async () => {
+                try {
+                    for await (const _ of iterable) {
+                        // Just drive the iterator to completion
+                    }
+                }
+                catch {
+                    // Ignore errors during background iteration
+                }
+            })();
+        }
+        return {
+            success: true,
+            method: "interrupt",
+            note: "Cancelled current work and restarted with context",
+        };
+    }
+    catch (error) {
+        return null;
+    }
+}
+/**
+ * Inject context into an agent's session.
+ *
+ * Uses a fallback chain:
+ * 1. If urgent, prefer interrupt for immediate effect
+ * 2. Try session.inject() if supported (queues for next turn)
+ * 3. Fall back to session.interruptWith() if allowInterrupt is true
+ * 4. Fall back to sending a high-priority message
+ *
+ * @param deps - Dependencies for session access and messaging
+ * @param targetAgentId - The agent to inject context into
+ * @param content - The context to inject
+ * @param options - Injection options
+ * @returns Result of the injection attempt
+ */
+export async function injectContext(deps, targetAgentId, content, options = {}) {
+    const opts = { ...DEFAULT_OPTIONS, ...options };
+    const formattedContent = formatInjectedContent(content, options);
+    // Get the target agent's session
+    const session = deps.getSession(targetAgentId);
+    // If no session, fall back to message
+    if (!session) {
+        return await sendFallbackMessage(deps, targetAgentId, formattedContent, options.source, "Agent has no active session");
+    }
+    // Check if agent is currently prompting
+    const isPrompting = deps.isPrompting(targetAgentId);
+    // If urgent, prefer interrupt for immediate effect
+    if (opts.urgent && isPrompting) {
+        const result = await tryInterrupt(session, formattedContent);
+        if (result) {
+            return result;
+        }
+        // If interrupt failed, try inject as fallback
+    }
+    // Try inject first (if not urgent or interrupt failed)
+    const injectResult = await tryInject(session, formattedContent);
+    if (injectResult) {
+        return injectResult;
+    }
+    // Try interrupt as fallback (if allowed and agent is prompting)
+    if (opts.allowInterrupt && isPrompting) {
+        const interruptResult = await tryInterrupt(session, formattedContent);
+        if (interruptResult) {
+            return interruptResult;
+        }
+    }
+    // Fall back to high-priority message
+    return await sendFallbackMessage(deps, targetAgentId, formattedContent, options.source, "Inject and interrupt not available");
+}
+/**
+ * Send a high-priority message as fallback.
+ */
+async function sendFallbackMessage(deps, targetAgentId, content, source, reason) {
+    try {
+        const fromAgentId = source?.type === "agent" ? source.agentId : undefined;
+        await deps.sendMessage(fromAgentId, targetAgentId, content, "high");
+        return {
+            success: true,
+            method: "message",
+            note: `Sent as high-priority message (${reason})`,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: `Failed to send message: ${error instanceof Error ? error.message : String(error)}`,
+        };
+    }
+}
+// =============================================================================
+// Convenience Wrappers
+// =============================================================================
+/**
+ * Create an injection function bound to specific dependencies.
+ * Useful for creating a pre-configured injector.
+ */
+export function createInjector(deps) {
+    return (targetAgentId, content, options) => injectContext(deps, targetAgentId, content, options);
+}
+//# sourceMappingURL=inject.js.map

package/dist/steering/inject.js.map

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

package/dist/steering/types.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Context Injection Types
+ *
+ * Types for the context injection system that enables steering agents
+ * mid-execution via inject, interrupt, or message fallback.
+ *
+ * @module steering/types
+ * @see s-9rld In-Flight Steering spec section 3.1
+ */
+import type { AgentId } from "../store/types/index.js";
+/**
+ * Source of a context injection for audit tracking
+ */
+export type InjectionSource = {
+    type: "human";
+} | {
+    type: "agent";
+    agentId: AgentId;
+};
+/**
+ * Options for context injection
+ */
+export interface InjectionOptions {
+    /**
+     * Allow falling back to interruptWith() if inject() fails.
+     * Warning: This will cancel the agent's current work.
+     * @default true
+     */
+    allowInterrupt?: boolean;
+    /**
+     * Force interrupt even if inject is available.
+     * Use for urgent redirects that need immediate effect.
+     * @default false
+     */
+    urgent?: boolean;
+    /**
+     * Source of the injection for audit logging.
+     */
+    source?: InjectionSource;
+    /**
+     * Optional reason for the injection (for audit logs).
+     */
+    reason?: string;
+}
+/**
+ * Method used to deliver the context
+ */
+export type InjectionMethod = "inject" | "interrupt" | "message" | "queued";
+/**
+ * Result of a context injection attempt
+ */
+export interface InjectionResult {
+    /** Whether the injection was successful */
+    success: boolean;
+    /** Method used to deliver the context (if successful) */
+    method?: InjectionMethod;
+    /** Error message (if not successful) */
+    error?: string;
+    /** Additional notes about the injection */
+    note?: string;
+}
+/**
+ * Minimal session interface needed for injection.
+ * Matches acp-factory's Session type.
+ */
+export interface InjectableSession {
+    /** Inject content to be queued for next turn */
+    inject(content: string, options?: {
+        throwOnUnsupported?: boolean;
+    }): Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+    /** Check if inject is supported (cached check) */
+    supportsInject(): boolean;
+    /** Check if inject is supported (probes the agent) */
+    checkInjectSupport(): Promise<boolean>;
+    /** Interrupt current work and restart with new content */
+    interruptWith(content: string): AsyncIterable<unknown>;
+}
+/**
+ * Dependencies needed by the injection handler
+ */
+export interface InjectionDeps {
+    /**
+     * Get a session for an agent.
+     * Returns null if agent has no active session.
+     */
+    getSession(agentId: AgentId): InjectableSession | null;
+    /**
+     * Check if an agent is currently processing a prompt.
+     */
+    isPrompting(agentId: AgentId): boolean;
+    /**
+     * Send a high-priority message to an agent.
+     * Used as fallback when inject/interrupt are not available.
+     */
+    sendMessage(fromAgentId: AgentId | undefined, toAgentId: AgentId, content: string, priority: "high"): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/steering/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAMvD;;GAEG;AACH,MAAM,MAAM,eAAe,GACvB;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC;AAMxC;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;OAIG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB;;;;OAIG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,MAAM,CAAC,EAAE,eAAe,CAAC;IAEzB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAMD;;GAEG;AACH,MAAM,MAAM,eAAe,GACvB,QAAQ,GACR,WAAW,GACX,SAAS,GACT,QAAQ,CAAC;AAEb;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,2CAA2C;IAC3C,OAAO,EAAE,OAAO,CAAC;IAEjB,yDAAyD;IACzD,MAAM,CAAC,EAAE,eAAe,CAAC;IAEzB,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,2CAA2C;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAMD;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,gDAAgD;IAChD,MAAM,CACJ,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QAAE,kBAAkB,CAAC,EAAE,OAAO,CAAA;KAAE,GACzC,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAEjD,kDAAkD;IAClD,cAAc,IAAI,OAAO,CAAC;IAE1B,sDAAsD;IACtD,kBAAkB,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAEvC,0DAA0D;IAC1D,aAAa,CACX,OAAO,EAAE,MAAM,GACd,aAAa,CAAC,OAAO,CAAC,CAAC;CAC3B;AAMD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,iBAAiB,GAAG,IAAI,CAAC;IAEvD;;OAEG;IACH,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC;IAEvC;;;OAGG;IACH,WAAW,CACT,WAAW,EAAE,OAAO,GAAG,SAAS,EAChC,SAAS,EAAE,OAAO,EAClB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CAAC;CAClB"}

package/dist/steering/types.js

@@ -0,0 +1,11 @@
+/**
+ * Context Injection Types
+ *
+ * Types for the context injection system that enables steering agents
+ * mid-execution via inject, interrupt, or message fallback.
+ *
+ * @module steering/types
+ * @see s-9rld In-Flight Steering spec section 3.1
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/steering/types.js.map

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

package/dist/store/backends/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Storage Backends Module
+ *
+ * Provides pluggable storage backends for the EventStore.
+ */
+export { type StorageBackend, type StorageBackendConfig, type StorageBackendFactory, type BackendType, STORAGE_TABLES, type StorageTable, type ExportedEvent, type ExportOptions, type ImportResult, } from './types.js';
+export { createMemoryBackend } from './memory-backend.js';
+export { createSqliteBackend, createSqliteBackendFromPath, type SqliteBackendOptions, } from './sqlite-backend.js';
+export { createJsonBackend, createJsonBackendFromPath, type JsonBackendOptions, } from './json-backend.js';
+export { createTinyBaseBackend, type TinyBaseBackendOptions, } from './tinybase-backend.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/store/backends/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/store/backends/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAEL,KAAK,cAAc,EAGnB,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,KAAK,WAAW,EAGhB,cAAc,EACd,KAAK,YAAY,EAGjB,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,YAAY,GAClB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EACL,mBAAmB,EACnB,2BAA2B,EAC3B,KAAK,oBAAoB,GAC1B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,iBAAiB,EACjB,yBAAyB,EACzB,KAAK,kBAAkB,GACxB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,qBAAqB,EACrB,KAAK,sBAAsB,GAC5B,MAAM,uBAAuB,CAAC"}

package/dist/store/backends/index.js

@@ -0,0 +1,15 @@
+/**
+ * Storage Backends Module
+ *
+ * Provides pluggable storage backends for the EventStore.
+ */
+// Types and interfaces
+export { 
+// Table constants
+STORAGE_TABLES, } from './types.js';
+// Backend implementations
+export { createMemoryBackend } from './memory-backend.js';
+export { createSqliteBackend, createSqliteBackendFromPath, } from './sqlite-backend.js';
+export { createJsonBackend, createJsonBackendFromPath, } from './json-backend.js';
+export { createTinyBaseBackend, } from './tinybase-backend.js';
+//# sourceMappingURL=index.js.map

package/dist/store/backends/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/store/backends/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,uBAAuB;AACvB,OAAO;AASL,kBAAkB;AAClB,cAAc,GAOf,MAAM,YAAY,CAAC;AAEpB,0BAA0B;AAC1B,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EACL,mBAAmB,EACnB,2BAA2B,GAE5B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,iBAAiB,EACjB,yBAAyB,GAE1B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,qBAAqB,GAEtB,MAAM,uBAAuB,CAAC"}

package/dist/store/backends/json-backend.d.ts

@@ -0,0 +1,23 @@
+/**
+ * JSON File Storage Backend
+ *
+ * Uses TinyBase with file persister for backward compatibility
+ * with the legacy `path` option.
+ */
+import type { StorageBackend } from './types.js';
+/**
+ * Options for the JSON backend
+ */
+export interface JsonBackendOptions {
+    /** Path to the JSON file */
+    path: string;
+}
+/**
+ * Create a JSON file storage backend using TinyBase
+ */
+export declare function createJsonBackend(options: JsonBackendOptions): Promise<StorageBackend>;
+/**
+ * Create a JSON backend from a file path (convenience function)
+ */
+export declare function createJsonBackendFromPath(filePath: string): Promise<StorageBackend>;
+//# sourceMappingURL=json-backend.d.ts.map

package/dist/store/backends/json-backend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-backend.d.ts","sourceRoot":"","sources":["../../../src/store/backends/json-backend.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,cAAc,CAAC,CAkQzB;AAED;;GAEG;AACH,wBAAsB,yBAAyB,CAC7C,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,cAAc,CAAC,CAEzB"}

package/dist/store/backends/json-backend.js

@@ -0,0 +1,220 @@
+/**
+ * JSON File Storage Backend
+ *
+ * Uses TinyBase with file persister for backward compatibility
+ * with the legacy `path` option.
+ */
+import { createStore } from 'tinybase';
+import { createFilePersister } from 'tinybase/persisters/persister-file';
+import * as fs from 'fs';
+import * as path from 'path';
+/**
+ * Create a JSON file storage backend using TinyBase
+ */
+export async function createJsonBackend(options) {
+    const store = createStore();
+    // Ensure directory exists
+    const dir = path.dirname(options.path);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    // Set up persister
+    const persister = createFilePersister(store, options.path);
+    await persister.load();
+    // Change listeners
+    const listeners = new Map();
+    /**
+     * Notify listeners of a change
+     */
+    function notifyChange(table, key, value) {
+        const tableListeners = listeners.get(table);
+        if (tableListeners) {
+            for (const callback of tableListeners) {
+                callback(key, value);
+            }
+        }
+    }
+    /**
+     * Parse an event from a TinyBase row
+     */
+    function parseEventRow(row) {
+        return {
+            id: row.id,
+            version: row.version ?? 1,
+            timestamp: row.timestamp,
+            type: row.type,
+            source: JSON.parse(row.source),
+            target: row.target ? JSON.parse(row.target) : undefined,
+            payload: JSON.parse(row.payload),
+            metadata: row.metadata ? JSON.parse(row.metadata) : undefined,
+        };
+    }
+    /**
+     * Match an event against a filter
+     */
+    function matchesFilter(event, filter) {
+        if (!filter)
+            return true;
+        if (filter.type && event.type !== filter.type)
+            return false;
+        if (filter.source_agent_id &&
+            event.source.agent_id !== filter.source_agent_id)
+            return false;
+        if (filter.target_agent_id &&
+            event.target?.agent_id !== filter.target_agent_id)
+            return false;
+        if (filter.after && event.timestamp <= filter.after)
+            return false;
+        if (filter.before && event.timestamp >= filter.before)
+            return false;
+        return true;
+    }
+    const backend = {
+        type: 'json',
+        supportsReactivity: true,
+        // ─────────────────────────────────────────────────────────────────────────
+        // Event Log Operations
+        // ─────────────────────────────────────────────────────────────────────────
+        async appendEvent(event) {
+            // Check for duplicate
+            const existing = store.getRow('events', event.id);
+            if (existing.id)
+                return;
+            store.setRow('events', event.id, {
+                id: event.id,
+                version: event.version,
+                timestamp: event.timestamp,
+                type: event.type,
+                source: JSON.stringify(event.source),
+                target: event.target ? JSON.stringify(event.target) : '',
+                payload: JSON.stringify(event.payload),
+                metadata: event.metadata ? JSON.stringify(event.metadata) : '',
+            });
+        },
+        async queryEvents(filter) {
+            const events = [];
+            const rowIds = store.getRowIds('events');
+            for (const rowId of rowIds) {
+                const row = store.getRow('events', rowId);
+                if (!row.id)
+                    continue;
+                const event = parseEventRow(row);
+                if (matchesFilter(event, filter)) {
+                    events.push(event);
+                }
+            }
+            // Sort by timestamp ascending
+            events.sort((a, b) => a.timestamp - b.timestamp);
+            // Apply limit
+            if (filter?.limit) {
+                return events.slice(0, filter.limit);
+            }
+            return events;
+        },
+        async importEvent(event) {
+            // Same as append - skip if exists
+            await backend.appendEvent(event);
+        },
+        async getEventCount() {
+            return store.getRowIds('events').length;
+        },
+        async deleteEvents(filter) {
+            const events = await backend.queryEvents(filter);
+            for (const event of events) {
+                store.delRow('events', event.id);
+            }
+            return events.length;
+        },
+        // ─────────────────────────────────────────────────────────────────────────
+        // Key-Value Operations
+        // ─────────────────────────────────────────────────────────────────────────
+        async get(table, key) {
+            const row = store.getRow(table, key);
+            if (!row._value)
+                return null;
+            return JSON.parse(row._value);
+        },
+        async set(table, key, value) {
+            store.setRow(table, key, { _value: JSON.stringify(value) });
+            notifyChange(table, key, value);
+        },
+        async setPartial(table, key, partial) {
+            const existing = await backend.get(table, key);
+            const merged = existing ? { ...existing, ...partial } : partial;
+            await backend.set(table, key, merged);
+        },
+        async delete(table, key) {
+            store.delRow(table, key);
+            notifyChange(table, key, null);
+        },
+        async list(table, filter) {
+            const results = [];
+            const rowIds = store.getRowIds(table);
+            for (const key of rowIds) {
+                const row = store.getRow(table, key);
+                if (!row._value)
+                    continue;
+                const value = JSON.parse(row._value);
+                // Apply filter
+                if (filter) {
+                    let matches = true;
+                    for (const [filterKey, filterValue] of Object.entries(filter)) {
+                        if (value[filterKey] !== filterValue) {
+                            matches = false;
+                            break;
+                        }
+                    }
+                    if (!matches)
+                        continue;
+                }
+                results.push({ key, value });
+            }
+            return results;
+        },
+        async keys(table) {
+            return store.getRowIds(table);
+        },
+        async clear(table) {
+            const keys = store.getRowIds(table);
+            for (const key of keys) {
+                store.delRow(table, key);
+                notifyChange(table, key, null);
+            }
+        },
+        // ─────────────────────────────────────────────────────────────────────────
+        // Reactivity
+        // ─────────────────────────────────────────────────────────────────────────
+        onChange(table, callback) {
+            let tableListeners = listeners.get(table);
+            if (!tableListeners) {
+                tableListeners = new Set();
+                listeners.set(table, tableListeners);
+            }
+            tableListeners.add(callback);
+            return () => {
+                tableListeners.delete(callback);
+                if (tableListeners.size === 0) {
+                    listeners.delete(table);
+                }
+            };
+        },
+        // ─────────────────────────────────────────────────────────────────────────
+        // Lifecycle
+        // ─────────────────────────────────────────────────────────────────────────
+        async flush() {
+            await persister.save();
+        },
+        async close() {
+            await persister.save();
+            persister.destroy();
+        },
+    };
+    return backend;
+}
+/**
+ * Create a JSON backend from a file path (convenience function)
+ */
+export async function createJsonBackendFromPath(filePath) {
+    return createJsonBackend({ path: filePath });
+}
+//# sourceMappingURL=json-backend.js.map