@roj-ai/sdk 0.0.2

package/dist/core/agents/state.d.ts

@@ -0,0 +1,255 @@
+import z4 from 'zod/v4';
+import type { AgentId } from '../../core/agents/schema.js';
+import type { ToolResultContent } from '../../core/llm/llm-log-types.js';
+import type { ChatMessageContentItem } from '../../core/llm/llm-log-types.js';
+import type { PendingToolResult, ToolCallId } from '../../core/tools/schema.js';
+import { MessageId } from '../../plugins/mailbox/schema';
+export { MessageId };
+/**
+ * Union of all possible handler results (stored in handler_completed event).
+ */
+export type HandlerResult = null | {
+    action: 'skip';
+    response: {
+        content: string | null;
+        toolCalls: Array<{
+            id: string;
+            name: string;
+            input: unknown;
+        }>;
+    };
+} | {
+    action: 'modify';
+    response: {
+        content: string | null;
+        toolCalls: Array<{
+            id: string;
+            name: string;
+            input: unknown;
+        }>;
+    };
+} | {
+    action: 'retry';
+} | {
+    action: 'block';
+    reason: string;
+} | {
+    action: 'replace';
+    toolCall: {
+        id: string;
+        name: string;
+        input: unknown;
+    };
+} | {
+    action: 'modify';
+    result: {
+        isError: boolean;
+        content: unknown;
+    };
+} | {
+    action: 'pause';
+    reason?: string;
+};
+export declare const agentEvents: import("../../core/events/types").EventsFactory<{
+    agent_spawned: z4.ZodObject<{
+        agentId: z4.core.$ZodBranded<z4.ZodString, "AgentId", "out">;
+        definitionName: z4.ZodString;
+        parentId: z4.ZodNullable<z4.core.$ZodBranded<z4.ZodString, "AgentId", "out">>;
+        typedInput: z4.ZodOptional<z4.ZodUnknown>;
+    }, z4.core.$strip>;
+    agent_state_changed: z4.ZodObject<{
+        agentId: z4.core.$ZodBranded<z4.ZodString, "AgentId", "out">;
+        fromState: z4.ZodEnum<{
+            pending: "pending";
+            inferring: "inferring";
+            tool_exec: "tool_exec";
+            errored: "errored";
+            paused: "paused";
+        }>;
+        toState: z4.ZodEnum<{
+            pending: "pending";
+            inferring: "inferring";
+            tool_exec: "tool_exec";
+            errored: "errored";
+            paused: "paused";
+        }>;
+    }, z4.core.$strip>;
+    handler_started: z4.ZodObject<{
+        agentId: z4.core.$ZodBranded<z4.ZodString, "AgentId", "out">;
+        handlerName: z4.ZodEnum<{
+            onComplete: "onComplete";
+            onStart: "onStart";
+            beforeInference: "beforeInference";
+            afterInference: "afterInference";
+            beforeToolCall: "beforeToolCall";
+            afterToolCall: "afterToolCall";
+            onError: "onError";
+        }>;
+    }, z4.core.$strip>;
+    handler_completed: z4.ZodObject<{
+        agentId: z4.core.$ZodBranded<z4.ZodString, "AgentId", "out">;
+        handlerName: z4.ZodEnum<{
+            onComplete: "onComplete";
+            onStart: "onStart";
+            beforeInference: "beforeInference";
+            afterInference: "afterInference";
+            beforeToolCall: "beforeToolCall";
+            afterToolCall: "afterToolCall";
+            onError: "onError";
+        }>;
+        result: z4.ZodUnknown;
+    }, z4.core.$strip>;
+    preamble_added: z4.ZodObject<{
+        agentId: z4.core.$ZodBranded<z4.ZodString, "AgentId", "out">;
+        messages: z4.ZodArray<z4.ZodCustom<LLMMessage, LLMMessage>>;
+    }, z4.core.$strip>;
+    agent_paused: z4.ZodObject<{
+        agentId: z4.core.$ZodBranded<z4.ZodString, "AgentId", "out">;
+        reason: z4.ZodEnum<{
+            limit: "limit";
+            handler: "handler";
+            manual: "manual";
+        }>;
+        message: z4.ZodOptional<z4.ZodString>;
+    }, z4.core.$strip>;
+    agent_resumed: z4.ZodObject<{
+        agentId: z4.core.$ZodBranded<z4.ZodString, "AgentId", "out">;
+    }, z4.core.$strip>;
+    communicator_linked: z4.ZodObject<{
+        communicatorId: z4.core.$ZodBranded<z4.ZodString, "AgentId", "out">;
+        orchestratorId: z4.core.$ZodBranded<z4.ZodString, "AgentId", "out">;
+    }, z4.core.$strip>;
+    agent_conversation_spliced: z4.ZodObject<{
+        agentId: z4.core.$ZodBranded<z4.ZodString, "AgentId", "out">;
+        start: z4.ZodNumber;
+        deleteCount: z4.ZodNumber;
+        insert: z4.ZodOptional<z4.ZodArray<z4.ZodCustom<LLMMessage, LLMMessage>>>;
+    }, z4.core.$strip>;
+}>;
+export type AgentSpawnedEvent = (typeof agentEvents)['Events']['agent_spawned'];
+export type AgentStateChangedEvent = (typeof agentEvents)['Events']['agent_state_changed'];
+export type HandlerStartedEvent = (typeof agentEvents)['Events']['handler_started'];
+export type HandlerCompletedEvent = (typeof agentEvents)['Events']['handler_completed'];
+export type PreambleAddedEvent = (typeof agentEvents)['Events']['preamble_added'];
+export type AgentPausedEvent = (typeof agentEvents)['Events']['agent_paused'];
+export type AgentResumedEvent = (typeof agentEvents)['Events']['agent_resumed'];
+export type CommunicatorLinkedEvent = (typeof agentEvents)['Events']['communicator_linked'];
+export type AgentConversationSplicedEvent = (typeof agentEvents)['Events']['agent_conversation_spliced'];
+export type AgentStatus = 'pending' | 'inferring' | 'tool_exec' | 'errored' | 'paused';
+/**
+ * Reason why an agent was paused.
+ * - 'limit' — agent hit a hard limit (replaces limitStopped)
+ * - 'handler' — handler returned { action: 'pause' }
+ * - 'manual' — paused via API call
+ */
+export type AgentPauseReason = 'limit' | 'handler' | 'manual';
+/**
+ * Prompt cache breakpoint marker.
+ * When set on an LLMMessage, providers place `cache_control: { type: 'ephemeral' }`
+ * on the LAST content block of the mapped message (regardless of block type),
+ * marking it as a prompt cache checkpoint.
+ */
+export type LLMMessageCacheControl = {
+    type: 'ephemeral';
+};
+/**
+ * User message - from mailbox or direct input.
+ * Supports multimodal content (text + images).
+ */
+export interface UserLLMMessage {
+    role: 'user';
+    content: string | ChatMessageContentItem[];
+    /** Track which mailbox messages were included (conversation metadata) */
+    sourceMessageIds?: MessageId[];
+    /** Marks this message as a prompt cache breakpoint. */
+    cacheControl?: LLMMessageCacheControl;
+}
+/**
+ * Assistant message - LLM response.
+ */
+export interface AssistantLLMMessage {
+    role: 'assistant';
+    content: string;
+    toolCalls?: ToolCall[];
+    /** Marks this message as a prompt cache breakpoint. */
+    cacheControl?: LLMMessageCacheControl;
+}
+/**
+ * Tool result message - response from tool execution.
+ */
+export interface ToolLLMMessage {
+    role: 'tool';
+    content: ToolResultContent;
+    toolCallId: ToolCallId;
+    /** Tool name (conversation metadata) */
+    toolName?: string;
+    /** Whether the tool execution failed (conversation metadata) */
+    isError?: boolean;
+    /** When the tool completed (conversation metadata) */
+    timestamp?: number;
+    /** Marks this message as a prompt cache breakpoint. */
+    cacheControl?: LLMMessageCacheControl;
+}
+/**
+ * System message - injected context (e.g., from context compaction).
+ */
+export interface SystemLLMMessage {
+    role: 'system';
+    content: string;
+    /** Marks this message as a prompt cache breakpoint. */
+    cacheControl?: LLMMessageCacheControl;
+}
+/**
+ * Unified message type for LLM communication and conversation history.
+ */
+export type LLMMessage = UserLLMMessage | AssistantLLMMessage | ToolLLMMessage | SystemLLMMessage;
+export interface AgentState {
+    id: AgentId;
+    definitionName: string;
+    parentId: AgentId | null;
+    status: AgentStatus;
+    conversationHistory: LLMMessage[];
+    /** Immutable preamble messages from onStart handlers - never compacted, always prepended before conversation */
+    preamble: LLMMessage[];
+    pendingToolCalls: ToolCall[];
+    /** Currently executing tool call (set by tool_started, cleared by tool_completed/tool_failed) */
+    executingToolCall?: {
+        toolCallId: ToolCallId;
+        toolName: string;
+        startedAt: number;
+    };
+    /** Tool results awaiting LLM processing (set by tool_completed/tool_failed, cleared by inference_completed) */
+    pendingToolResults: PendingToolResult[];
+    /** Messages pending addition to history (set by inference_started, committed by inference_completed) */
+    pendingMessages: LLMMessage[];
+    /** Typed input for agents with inputSchema (set by agent_spawned event) */
+    typedInput?: unknown;
+    /** Whether onStart handler has been executed (for first-run initialization) */
+    onStartCalled?: boolean;
+    /** Reason for pause (set when status is 'paused') */
+    pauseReason?: AgentPauseReason;
+    /** Human-readable pause message */
+    pauseMessage?: string;
+}
+export interface ToolCall {
+    id: ToolCallId;
+    name: string;
+    input: unknown;
+}
+export interface ToolResult {
+    toolCallId: ToolCallId;
+    result: unknown;
+    isError: boolean;
+}
+export declare const getChildren: (session: {
+    agents: Map<AgentId, AgentState>;
+}, parentId: AgentId) => AgentState[];
+export declare const getParent: (session: {
+    agents: Map<AgentId, AgentState>;
+}, agent: AgentState) => AgentState | null;
+/**
+ * Create a new AgentState with default values.
+ * Useful for tests to avoid maintaining inline mocks when new fields are added.
+ */
+export declare const createAgentState: (id: AgentId, definitionName: string, overrides?: Partial<AgentState>) => AgentState;
+//# sourceMappingURL=state.d.ts.map

package/dist/core/agents/state.d.ts.map

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

package/dist/core/context/state.d.ts

@@ -0,0 +1,28 @@
+import z4 from 'zod/v4';
+/**
+ * Conversation message stored in event for reconstruction.
+ */
+export type CompactedConversationMessage = {
+    role: 'user' | 'assistant' | 'system';
+    content: string;
+};
+export declare const contextEvents: import("../../core/events/types").EventsFactory<{
+    context_compacted: z4.ZodObject<{
+        agentId: z4.core.$ZodBranded<z4.ZodString, "AgentId", "out">;
+        compactedContent: z4.ZodString;
+        newConversationHistory: z4.ZodArray<z4.ZodObject<{
+            role: z4.ZodEnum<{
+                user: "user";
+                assistant: "assistant";
+                system: "system";
+            }>;
+            content: z4.ZodString;
+        }, z4.core.$strip>>;
+        originalTokens: z4.ZodNumber;
+        compactedTokens: z4.ZodNumber;
+        messagesRemoved: z4.ZodNumber;
+        historyPath: z4.ZodOptional<z4.ZodString>;
+    }, z4.core.$strip>;
+}>;
+export type ContextCompactedEvent = (typeof contextEvents)['Events']['context_compacted'];
+//# sourceMappingURL=state.d.ts.map

package/dist/core/context/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../src/core/context/state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,QAAQ,CAAA;AAQvB;;GAEG;AACH,MAAM,MAAM,4BAA4B,GAAG;IAC1C,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAA;IACrC,OAAO,EAAE,MAAM,CAAA;CACf,CAAA;AAMD,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;EAexB,CAAA;AAEF,MAAM,MAAM,qBAAqB,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,QAAQ,CAAC,CAAC,mBAAmB,CAAC,CAAA"}

package/dist/core/errors.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Self-describing domain errors.
+ *
+ * Each error carries its own HTTP status and message — no central switch needed.
+ * Plugins can define any error type they want without touching central files.
+ */
+export interface DomainError {
+    readonly type: string;
+    readonly message: string;
+    readonly httpStatus: number;
+}
+export declare function createDomainError(type: string, message: string, httpStatus: number): DomainError;
+export declare function isDomainError(value: unknown): value is DomainError;
+export declare const SessionErrors: {
+    notFound: (id: string) => DomainError;
+    closed: (id: string) => DomainError;
+    alreadyExists: (id: string) => DomainError;
+};
+export declare const AgentErrors: {
+    notFound: (id: string) => DomainError;
+    invalidState: (id: string, currentState: string, expectedState: string) => DomainError;
+};
+export declare const PresetErrors: {
+    notFound: (id: string) => DomainError;
+};
+export declare const ValidationErrors: {
+    invalid: (message: string) => DomainError;
+};
+//# sourceMappingURL=errors.d.ts.map

package/dist/core/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,MAAM,WAAW,WAAW;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAC3B;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,WAAW,CAEhG;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,CASlE;AAMD,eAAO,MAAM,aAAa;mBACV,MAAM;iBACR,MAAM;wBACC,MAAM;CAC1B,CAAA;AAED,eAAO,MAAM,WAAW;mBACR,MAAM;uBACF,MAAM,gBAAgB,MAAM,iBAAiB,MAAM;CAEtE,CAAA;AAED,eAAO,MAAM,YAAY;mBACT,MAAM;CACrB,CAAA;AAED,eAAO,MAAM,gBAAgB;uBACT,MAAM;CACzB,CAAA"}

package/dist/core/event-sourcing.integration.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=event-sourcing.integration.test.d.ts.map

package/dist/core/event-sourcing.integration.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-sourcing.integration.test.d.ts","sourceRoot":"","sources":["../../src/core/event-sourcing.integration.test.ts"],"names":[],"mappings":""}

package/dist/core/events/base-event-store.d.ts

@@ -0,0 +1,55 @@
+import type { DomainEvent } from '../../core/events/types.js';
+import type { ListSessionsOptions, SessionId, SessionMetadata } from '../../core/sessions/schema.js';
+import { type EventStore, type LoadRangeOptions, type LoadRangeResult } from './event-store.js';
+/**
+ * Abstract base class for EventStore implementations.
+ *
+ * Provides shared logic for metadata processing, filtering/sorting/pagination,
+ * and reconciliation. Subclasses only implement storage primitives.
+ */
+export declare abstract class BaseEventStore implements EventStore {
+    append(sessionId: SessionId, event: DomainEvent): Promise<void>;
+    appendBatch(sessionId: SessionId, events: DomainEvent[]): Promise<void>;
+    protected abstract doAppend(sessionId: SessionId, event: DomainEvent): Promise<void>;
+    protected abstract doAppendBatch(sessionId: SessionId, events: DomainEvent[]): Promise<void>;
+    abstract load(sessionId: SessionId): Promise<DomainEvent[]>;
+    abstract loadRange(sessionId: SessionId, options?: LoadRangeOptions): Promise<LoadRangeResult>;
+    abstract exists(sessionId: SessionId): Promise<boolean>;
+    abstract listSessions(): Promise<SessionId[]>;
+    protected abstract readMetadata(sessionId: SessionId): Promise<SessionMetadata | null>;
+    protected abstract writeMetadata(sessionId: SessionId, metadata: SessionMetadata): Promise<void>;
+    protected abstract getAllSessionMetadata(): Promise<SessionMetadata[]>;
+    getMetadata(sessionId: SessionId): Promise<SessionMetadata | null>;
+    updateMetadata(sessionId: SessionId, update: Partial<SessionMetadata>): Promise<void>;
+    listSessionsWithMetadata(options?: ListSessionsOptions): Promise<{
+        sessions: SessionMetadata[];
+        total: number;
+    }>;
+    reconcileMetadata(sessionId: SessionId, events: DomainEvent[]): Promise<boolean>;
+    /**
+     * Update metadata incrementally from events.
+     * Aggregates all metric deltas and writes once.
+     */
+    protected updateMetadataFromEvents(sessionId: SessionId, events: DomainEvent[]): Promise<void>;
+    /**
+     * Reject session-level hook events on closed sessions.
+     *
+     * Closed sessions must be prevented from re-running session-level plugin hooks
+     * (the `session_handler_*` events) because those hooks have no place operating
+     * on an immutable artifact — and when they do, every read / restart of the closed
+     * session appends two events, which is how we observed 7866 handler_started events
+     * on a single closed session over 4.9 days in production.
+     *
+     * Other event types are deliberately allowed even after session_closed:
+     *   - in-flight agent events (inference_*, tool_*) finishing after close
+     *   - mailbox_message deliveries racing close
+     *   - service_status_changed from cleanup hooks stopping services
+     *
+     * The invariant we guard is narrow: "session-level plugin hooks never emit on
+     * closed sessions." See the loadSession / skipReadyHooks path in session-manager
+     * for the primary fix; this is the storage-boundary backup that catches any
+     * future code path that somehow slips through.
+     */
+    protected guardWriteToClosed(sessionId: SessionId, events: DomainEvent[]): Promise<void>;
+}
+//# sourceMappingURL=base-event-store.d.ts.map

package/dist/core/events/base-event-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-event-store.d.ts","sourceRoot":"","sources":["../../../src/core/events/base-event-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AACzD,OAAO,KAAK,EAAE,mBAAmB,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAA;AAChG,OAAO,EAAmB,KAAK,UAAU,EAAE,KAAK,gBAAgB,EAAE,KAAK,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAYhH;;;;;GAKG;AACH,8BAAsB,cAAe,YAAW,UAAU;IAGnD,MAAM,CAAC,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAO/D,WAAW,CAAC,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAU7E,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IACpF,SAAS,CAAC,QAAQ,CAAC,aAAa,CAAC,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAC5F,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAC3D,QAAQ,CAAC,SAAS,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC;IAC9F,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC;IACvD,QAAQ,CAAC,YAAY,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAI7C,SAAS,CAAC,QAAQ,CAAC,YAAY,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IACtF,SAAS,CAAC,QAAQ,CAAC,aAAa,CAAC,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAChG,SAAS,CAAC,QAAQ,CAAC,qBAAqB,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;IAIhE,WAAW,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAIlE,cAAc,CACnB,SAAS,EAAE,SAAS,EACpB,MAAM,EAAE,OAAO,CAAC,eAAe,CAAC,GAC9B,OAAO,CAAC,IAAI,CAAC;IAYV,wBAAwB,CAC7B,OAAO,CAAC,EAAE,mBAAmB,GAC3B,OAAO,CAAC;QAAE,QAAQ,EAAE,eAAe,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAgCpD,iBAAiB,CACtB,SAAS,EAAE,SAAS,EACpB,MAAM,EAAE,WAAW,EAAE,GACnB,OAAO,CAAC,OAAO,CAAC;IAyBnB;;;OAGG;cACa,wBAAwB,CACvC,SAAS,EAAE,SAAS,EACpB,MAAM,EAAE,WAAW,EAAE,GACnB,OAAO,CAAC,IAAI,CAAC;IAuFhB;;;;;;;;;;;;;;;;;;OAkBG;cACa,kBAAkB,CAAC,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAc9F"}

package/dist/core/events/event-store.d.ts

@@ -0,0 +1,108 @@
+import type { DomainEvent } from '../../core/events/types.js';
+import type { ListSessionsOptions, SessionId, SessionMetadata } from '../../core/sessions/schema.js';
+export type { ListSessionsOptions, SessionMetadata };
+/**
+ * Options for loading a range of events.
+ */
+export interface LoadRangeOptions {
+    /** Skip events with index <= since (0-indexed). Default: -1 (load from start) */
+    since?: number;
+    /** Max events to return. Default: no limit */
+    limit?: number;
+}
+/**
+ * Result of loading a range of events.
+ */
+export interface LoadRangeResult {
+    events: DomainEvent[];
+    /** Index of first returned event (-1 if no events returned) */
+    fromIndex: number;
+    /** Index of last event in the store, used as cursor for polling (-1 only if store is empty) */
+    toIndex: number;
+}
+/**
+ * EventStore interface pro persistenci domain events.
+ *
+ * Implementace:
+ * - FileEventStore - JSONL soubory (production)
+ * - MemoryEventStore - in-memory (testy)
+ */
+export interface EventStore {
+    /**
+     * Přidá jeden event do store.
+     */
+    append(sessionId: SessionId, event: DomainEvent): Promise<void>;
+    /**
+     * Přidá více eventů atomicky.
+     * Všechny eventy musí být uloženy, nebo žádný.
+     */
+    appendBatch(sessionId: SessionId, events: DomainEvent[]): Promise<void>;
+    /**
+     * Načte všechny eventy pro session.
+     * Eventy jsou vráceny v pořadí jak byly uloženy.
+     */
+    load(sessionId: SessionId): Promise<DomainEvent[]>;
+    /**
+     * Zkontroluje zda session existuje.
+     */
+    exists(sessionId: SessionId): Promise<boolean>;
+    /**
+     * Vrátí seznam všech session IDs.
+     * Použito při restartu pro načtení všech sessions.
+     */
+    listSessions(): Promise<SessionId[]>;
+    /**
+     * Načte metadata session.
+     * Vrátí null pokud session neexistuje nebo nemá metadata.
+     */
+    getMetadata(sessionId: SessionId): Promise<SessionMetadata | null>;
+    /**
+     * Aktualizuje metadata session.
+     * Merge s existujícími hodnotami.
+     */
+    updateMetadata(sessionId: SessionId, update: Partial<SessionMetadata>): Promise<void>;
+    /**
+     * Vrátí seznam sessions s metadata.
+     * Podporuje filtrování, řazení a paginaci.
+     */
+    listSessionsWithMetadata(options?: ListSessionsOptions): Promise<{
+        sessions: SessionMetadata[];
+        total: number;
+    }>;
+    /**
+     * Načte rozsah eventů pro session.
+     * Optimalizováno pro polling - čte z konce souboru pokud je to efektivní.
+     */
+    loadRange(sessionId: SessionId, options?: LoadRangeOptions): Promise<LoadRangeResult>;
+    /**
+     * Validates and reconciles metadata against actual events.
+     * If metadata is out of sync (e.g., after crash), recomputes it from events.
+     * Returns true if metadata was reconciled (was out of sync).
+     */
+    reconcileMetadata(sessionId: SessionId, events: DomainEvent[]): Promise<boolean>;
+}
+/**
+ * EventStore s podporou pro streaming (optional rozšíření).
+ */
+export interface StreamingEventStore extends EventStore {
+    /**
+     * Streamuje eventy pro session.
+     * Užitečné pro velké sessions.
+     */
+    stream(sessionId: SessionId): AsyncIterable<DomainEvent>;
+}
+/**
+ * Error types pro EventStore
+ */
+export declare class EventStoreError extends Error {
+    readonly sessionId: SessionId;
+    readonly cause?: unknown | undefined;
+    constructor(message: string, sessionId: SessionId, cause?: unknown | undefined);
+}
+export declare class SessionNotFoundError extends EventStoreError {
+    constructor(sessionId: SessionId);
+}
+export declare class EventAppendError extends EventStoreError {
+    constructor(sessionId: SessionId, cause?: unknown);
+}
+//# sourceMappingURL=event-store.d.ts.map

package/dist/core/events/event-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-store.d.ts","sourceRoot":"","sources":["../../../src/core/events/event-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AACzD,OAAO,KAAK,EAAE,mBAAmB,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAA;AAEhG,YAAY,EAAE,mBAAmB,EAAE,eAAe,EAAE,CAAA;AAEpD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAChC,iFAAiF;IACjF,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,8CAA8C;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAA;CACd;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC/B,MAAM,EAAE,WAAW,EAAE,CAAA;IACrB,+DAA+D;IAC/D,SAAS,EAAE,MAAM,CAAA;IACjB,+FAA+F;IAC/F,OAAO,EAAE,MAAM,CAAA;CACf;AAED;;;;;;GAMG;AACH,MAAM,WAAW,UAAU;IAC1B;;OAEG;IACH,MAAM,CAAC,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAE/D;;;OAGG;IACH,WAAW,CAAC,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAEvE;;;OAGG;IACH,IAAI,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAAA;IAElD;;OAEG;IACH,MAAM,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAE9C;;;OAGG;IACH,YAAY,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC,CAAA;IAEpC;;;OAGG;IACH,WAAW,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAAA;IAElE;;;OAGG;IACH,cAAc,CACb,SAAS,EAAE,SAAS,EACpB,MAAM,EAAE,OAAO,CAAC,eAAe,CAAC,GAC9B,OAAO,CAAC,IAAI,CAAC,CAAA;IAEhB;;;OAGG;IACH,wBAAwB,CACvB,OAAO,CAAC,EAAE,mBAAmB,GAC3B,OAAO,CAAC;QAAE,QAAQ,EAAE,eAAe,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAE1D;;;OAGG;IACH,SAAS,CACR,SAAS,EAAE,SAAS,EACpB,OAAO,CAAC,EAAE,gBAAgB,GACxB,OAAO,CAAC,eAAe,CAAC,CAAA;IAE3B;;;;OAIG;IACH,iBAAiB,CAChB,SAAS,EAAE,SAAS,EACpB,MAAM,EAAE,WAAW,EAAE,GACnB,OAAO,CAAC,OAAO,CAAC,CAAA;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAoB,SAAQ,UAAU;IACtD;;;OAGG;IACH,MAAM,CAAC,SAAS,EAAE,SAAS,GAAG,aAAa,CAAC,WAAW,CAAC,CAAA;CACxD;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,KAAK;aAGxB,SAAS,EAAE,SAAS;aACpB,KAAK,CAAC,EAAE,OAAO;gBAF/B,OAAO,EAAE,MAAM,EACC,SAAS,EAAE,SAAS,EACpB,KAAK,CAAC,EAAE,OAAO,YAAA;CAKhC;AAED,qBAAa,oBAAqB,SAAQ,eAAe;gBAC5C,SAAS,EAAE,SAAS;CAIhC;AAED,qBAAa,gBAAiB,SAAQ,eAAe;gBACxC,SAAS,EAAE,SAAS,EAAE,KAAK,CAAC,EAAE,OAAO;CAIjD"}

package/dist/core/events/file.d.ts

@@ -0,0 +1,50 @@
+import type { DomainEvent } from '../../core/events/types.js';
+import type { FileSystem } from '../../platform/fs.js';
+import { SessionId } from '../../core/sessions/schema.js';
+import type { SessionMetadata } from '../../core/sessions/schema.js';
+import { BaseEventStore } from './base-event-store.js';
+import type { LoadRangeOptions, LoadRangeResult } from './event-store.js';
+/**
+ * FileEventStore - Persists domain events to JSONL files.
+ *
+ * File structure:
+ * ```
+ * {basePath}/
+ *   sessions/
+ *     {sessionId}/
+ *       .events/
+ *         events.jsonl
+ *         meta.json
+ *         uploads/
+ *         calls/
+ *       (agent workspace files)
+ * ```
+ *
+ * Each line in events.jsonl is a JSON-serialized domain event.
+ * meta.json contains session metadata for quick access.
+ */
+export declare class FileEventStore extends BaseEventStore {
+    private readonly basePath;
+    private readonly fs;
+    private readonly sessionLocks;
+    constructor(basePath: string, fs: FileSystem);
+    /**
+     * Get or create a mutex for a specific session.
+     * Ensures serialized access to each session's event file.
+     */
+    private getLock;
+    private getSessionDir;
+    private getEventsDir;
+    private getEventsPath;
+    private getMetaPath;
+    protected doAppend(sessionId: SessionId, event: DomainEvent): Promise<void>;
+    protected doAppendBatch(sessionId: SessionId, events: DomainEvent[]): Promise<void>;
+    load(sessionId: SessionId): Promise<DomainEvent[]>;
+    exists(sessionId: SessionId): Promise<boolean>;
+    listSessions(): Promise<SessionId[]>;
+    loadRange(sessionId: SessionId, options?: LoadRangeOptions): Promise<LoadRangeResult>;
+    protected readMetadata(sessionId: SessionId): Promise<SessionMetadata | null>;
+    protected writeMetadata(sessionId: SessionId, metadata: SessionMetadata): Promise<void>;
+    protected getAllSessionMetadata(): Promise<SessionMetadata[]>;
+}
+//# sourceMappingURL=file.d.ts.map

package/dist/core/events/file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.d.ts","sourceRoot":"","sources":["../../../src/core/events/file.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AACzD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAClD,OAAO,EAAqB,SAAS,EAAyB,MAAM,2BAA2B,CAAA;AAC/F,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAA;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AACtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AA8FzE;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,cAAe,SAAQ,cAAc;IAGrC,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAAU,OAAO,CAAC,QAAQ,CAAC,EAAE;IAFlE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAmC;gBAEnC,QAAQ,EAAE,MAAM,EAAmB,EAAE,EAAE,UAAU;IAI9E;;;OAGG;IACH,OAAO,CAAC,OAAO;IASf,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,WAAW;cAIH,QAAQ,CAAC,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;cAsBjE,aAAa,CAAC,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAwBnF,IAAI,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAiClD,MAAM,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC;IAI9C,YAAY,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAgBpC,SAAS,CACd,SAAS,EAAE,SAAS,EACpB,OAAO,CAAC,EAAE,gBAAgB,GACxB,OAAO,CAAC,eAAe,CAAC;cAqEX,YAAY,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;cAgBnE,aAAa,CAAC,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;cAM7E,qBAAqB,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;CAsBnE"}

package/dist/core/events/file.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=file.test.d.ts.map

package/dist/core/events/file.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.test.d.ts","sourceRoot":"","sources":["../../../src/core/events/file.test.ts"],"names":[],"mappings":""}

package/dist/core/events/index.d.ts

@@ -0,0 +1,4 @@
+export type { EventStore, LoadRangeOptions, LoadRangeResult } from './event-store.js';
+export { FileEventStore } from './file.js';
+export { MemoryEventStore } from './memory.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/events/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/events/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,UAAU,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AACrF,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA"}

package/dist/core/events/memory.d.ts

@@ -0,0 +1,43 @@
+import type { DomainEvent } from '../../core/events/types.js';
+import type { SessionId, SessionMetadata } from '../../core/sessions/schema.js';
+import { BaseEventStore } from './base-event-store.js';
+import type { LoadRangeOptions, LoadRangeResult } from './event-store.js';
+/**
+ * MemoryEventStore - In-memory event store for testing.
+ *
+ * Provides simple in-memory storage with test helpers for inspecting events.
+ */
+export declare class MemoryEventStore extends BaseEventStore {
+    private events;
+    private metadata;
+    protected doAppend(sessionId: SessionId, event: DomainEvent): Promise<void>;
+    protected doAppendBatch(sessionId: SessionId, events: DomainEvent[]): Promise<void>;
+    load(sessionId: SessionId): Promise<DomainEvent[]>;
+    exists(sessionId: SessionId): Promise<boolean>;
+    listSessions(): Promise<SessionId[]>;
+    loadRange(sessionId: SessionId, options?: LoadRangeOptions): Promise<LoadRangeResult>;
+    protected readMetadata(sessionId: SessionId): Promise<SessionMetadata | null>;
+    protected writeMetadata(sessionId: SessionId, metadata: SessionMetadata): Promise<void>;
+    protected getAllSessionMetadata(): Promise<SessionMetadata[]>;
+    /**
+     * Clears all events and metadata.
+     */
+    clear(): void;
+    /**
+     * Returns all events for inspection in tests.
+     */
+    getAll(): Map<SessionId, DomainEvent[]>;
+    /**
+     * Returns event count for a session.
+     */
+    getEventCount(sessionId: SessionId): number;
+    /**
+     * Returns the last event for a session.
+     */
+    getLastEvent(sessionId: SessionId): DomainEvent | undefined;
+    /**
+     * Returns events of a given type.
+     */
+    getEventsByType(sessionId: SessionId, type: string): DomainEvent[];
+}
+//# sourceMappingURL=memory.d.ts.map

package/dist/core/events/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../../src/core/events/memory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAA;AAC3E,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AACtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAEzE;;;;GAIG;AACH,qBAAa,gBAAiB,SAAQ,cAAc;IACnD,OAAO,CAAC,MAAM,CAAsC;IACpD,OAAO,CAAC,QAAQ,CAAwC;cAExC,QAAQ,CAAC,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;cAMjE,aAAa,CAAC,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAQnF,IAAI,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAIlD,MAAM,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC;IAI9C,YAAY,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAIpC,SAAS,CACd,SAAS,EAAE,SAAS,EACpB,OAAO,CAAC,EAAE,gBAAgB,GACxB,OAAO,CAAC,eAAe,CAAC;cA+BX,YAAY,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;cAInE,aAAa,CAAC,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;cAI7E,qBAAqB,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;IAQnE;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;OAEG;IACH,MAAM,IAAI,GAAG,CAAC,SAAS,EAAE,WAAW,EAAE,CAAC;IAIvC;;OAEG;IACH,aAAa,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM;IAI3C;;OAEG;IACH,YAAY,CAAC,SAAS,EAAE,SAAS,GAAG,WAAW,GAAG,SAAS;IAK3D;;OAEG;IACH,eAAe,CACd,SAAS,EAAE,SAAS,EACpB,IAAI,EAAE,MAAM,GACV,WAAW,EAAE;CAIhB"}

package/dist/core/events/memory.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=memory.test.d.ts.map

package/dist/core/events/memory.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.test.d.ts","sourceRoot":"","sources":["../../../src/core/events/memory.test.ts"],"names":[],"mappings":""}