@roj-ai/sdk 0.0.2

package/dist/core/sessions/apply-event.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Composed event reducer — core reducer + plugin state slices.
+ *
+ * This file is the composition root for the event-sourced reducer.
+ * Core SessionState stays free of plugin imports; each plugin owns a
+ * dynamic state slice accessed via `selectPluginState()`.
+ *
+ * The default `applyEvent` includes core + always-enabled plugins (mailbox).
+ * Additional plugin reducers are composed via `createApplyEvent()`.
+ */
+import type { ConfiguredPlugin } from '../../core/plugins/plugin-builder.js';
+import type { SessionReducer } from './reducer.js';
+export declare const applyEvent: SessionReducer;
+/**
+ * Create a composed reducer that handles core + all plugin events.
+ * Use this when additional plugins are available (e.g. in SessionStore).
+ */
+export declare const createApplyEvent: (plugins: ConfiguredPlugin[]) => SessionReducer;
+//# sourceMappingURL=apply-event.d.ts.map

package/dist/core/sessions/apply-event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply-event.d.ts","sourceRoot":"","sources":["../../../src/core/sessions/apply-event.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAA;AAExE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAalD,eAAO,MAAM,UAAU,EAAE,cAA4B,CAAA;AAErD;;;GAGG;AACH,eAAO,MAAM,gBAAgB,GAAI,SAAS,gBAAgB,EAAE,KAAG,cAa9D,CAAA"}

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

@@ -0,0 +1,34 @@
+import type { EventStore } from '../../core/events/event-store';
+import type { BaseEvent } from '../../core/events/types';
+import type { LLMLogger } from '../../core/llm/logger';
+import type { LLMProvider } from '../../core/llm/provider';
+import type { Logger } from '../../lib/logger/logger';
+import type { Platform } from '../../platform/index.js';
+import type { FileStore } from '../file-store/types';
+import type { SessionId } from './schema';
+import type { SessionEnvironment } from './session-environment';
+import type { SessionState } from './state';
+export type SessionContext<TSessionInput = unknown> = {
+    readonly sessionId: SessionId;
+    /** The full session state (readonly) */
+    readonly sessionState: SessionState;
+    /** The typed input if agent has inputSchema, otherwise the task string */
+    readonly sessionInput: TSessionInput;
+    /** Session environment directories */
+    readonly environment: SessionEnvironment;
+    /** LLM inference client for handlers that need LLM access */
+    readonly llm: LLMProvider;
+    /** FileStore with full access - resolves agent-visible paths */
+    readonly files: FileStore;
+    /** Event store for loading/querying events */
+    readonly eventStore: EventStore;
+    /** LLM call logger for debugging and audit */
+    readonly llmLogger?: LLMLogger;
+    /** Host-environment adapters (filesystem, process). */
+    readonly platform: Platform;
+    readonly logger: Logger;
+    emitEvent: (event: Omit<BaseEvent<string>, 'sessionId'>) => Promise<void>;
+    /** Send a notification to connected clients via transport (ephemeral, not persisted) */
+    notify: (type: string, payload: unknown) => void;
+};
+//# sourceMappingURL=context.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/core/sessions/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAA;AAC3D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AACpD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AACtD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AACjD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AACnD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AACpD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AACzC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAA;AAC/D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAE3C,MAAM,MAAM,cAAc,CAAC,aAAa,GAAG,OAAO,IAAI;IACrD,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAA;IAC7B,wCAAwC;IACxC,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAA;IACnC,0EAA0E;IAC1E,QAAQ,CAAC,YAAY,EAAE,aAAa,CAAA;IACpC,sCAAsC;IACtC,QAAQ,CAAC,WAAW,EAAE,kBAAkB,CAAA;IACxC,6DAA6D;IAC7D,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAA;IACzB,gEAAgE;IAChE,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAA;IACzB,8CAA8C;IAC9C,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAA;IAC/B,8CAA8C;IAC9C,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,CAAA;IAC9B,uDAAuD;IACvD,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAA;IAE3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IAEvB,SAAS,EAAE,CAAC,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACzE,wFAAwF;IACxF,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,CAAA;CAChD,CAAA"}

package/dist/core/sessions/fork-utils.d.ts

@@ -0,0 +1,20 @@
+import type { DomainEvent } from '../../core/events/types.js';
+import type { SessionId } from '../../core/sessions/schema.js';
+/**
+ * Rewrite events for a fork: slice to eventIndex (inclusive), rewrite sessionId,
+ * and add forkedFrom to the session_created event.
+ */
+export declare function rewriteEventsForFork(sourceEvents: DomainEvent[], eventIndex: number, newSessionId: SessionId, sourceSessionId: SessionId): DomainEvent[];
+/**
+ * Snapshot refs found at a given event index.
+ */
+export interface SnapshotRefsAtIndex {
+    sessionRef?: string;
+    workspaceRef?: string;
+}
+/**
+ * Scan backwards from eventIndex to find the most recent sessionRef and workspaceRef
+ * from tool_completed or tool_failed events.
+ */
+export declare function findSnapshotRefsAtIndex(events: DomainEvent[], eventIndex: number): SnapshotRefsAtIndex;
+//# sourceMappingURL=fork-utils.d.ts.map

package/dist/core/sessions/fork-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fork-utils.d.ts","sourceRoot":"","sources":["../../../src/core/sessions/fork-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAoB,MAAM,wBAAwB,CAAA;AAC3E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAA;AAK1D;;;GAGG;AACH,wBAAgB,oBAAoB,CACnC,YAAY,EAAE,WAAW,EAAE,EAC3B,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,SAAS,EACvB,eAAe,EAAE,SAAS,GACxB,WAAW,EAAE,CAaf;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IACnC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,YAAY,CAAC,EAAE,MAAM,CAAA;CACrB;AAID;;;GAGG;AACH,wBAAgB,uBAAuB,CACtC,MAAM,EAAE,WAAW,EAAE,EACrB,UAAU,EAAE,MAAM,GAChB,mBAAmB,CAuBrB"}

package/dist/core/sessions/fork-utils.test.d.ts

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

package/dist/core/sessions/fork-utils.test.d.ts.map

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

package/dist/core/sessions/reducer.d.ts

@@ -0,0 +1,50 @@
+import type { DomainEvent } from '../../core/events/types.js';
+import type { BaseEvent } from '../../core/events/types.js';
+import type { SessionState } from './state.js';
+export type SessionReducer = (state: SessionState, event: DomainEvent) => SessionState;
+/**
+ * Structural supertype for any EventsFactory — used to infer event types from factories.
+ */
+type EventSourceRef = {
+    create(type: string, input: unknown): unknown;
+    EventType: unknown;
+    Events: unknown;
+};
+export interface StateSlice<TKey extends string = string, TState = unknown> {
+    key: TKey;
+    initialState: () => TState;
+    select: (state: SessionState) => TState;
+    reducer: SessionReducer;
+}
+/**
+ * Create a typed state slice that owns a specific key on SessionState.
+ *
+ * Each slice stores its state under a dynamic key on SessionState.
+ * Use `selectPluginState()` to read plugin state from outside the plugin.
+ *
+ * The `events` field declares which EventsFactory instances this reducer depends on.
+ * The event type for `apply` is inferred from the factories — use a switch on
+ * `event.type` for TypeScript narrowing.
+ */
+export declare function createStateSlice<TKey extends string, TState, const TFactories extends readonly EventSourceRef[]>(config: {
+    key: TKey;
+    events: TFactories;
+    initialState: () => TState;
+    apply: (state: TState, event: TFactories[number]['EventType'] & BaseEvent<string>, sessionState: SessionState) => TState;
+}): StateSlice<TKey, TState>;
+/**
+ * Create a typed session reducer that narrows DomainEvent to the union of events
+ * from the provided factories. Same casting pattern as createStateSlice.
+ */
+export declare function createTypedReducer<const TFactories extends readonly EventSourceRef[]>(events: TFactories, apply: (state: SessionState, event: TFactories[number]['EventType'] & BaseEvent<string>) => SessionState): SessionReducer;
+/**
+ * Read a plugin-owned state slice from SessionState by dynamic key.
+ *
+ * Plugin state is stored under dynamic keys (e.g. 'todos', 'workers') that are
+ * not part of the core SessionState interface. This helper performs the same
+ * dynamic record access that createStateSlice uses internally.
+ */
+export declare function selectPluginState<TState>(state: SessionState, key: string): TState | undefined;
+export declare const composeReducers: (...reducers: SessionReducer[]) => SessionReducer;
+export {};
+//# sourceMappingURL=reducer.d.ts.map

package/dist/core/sessions/reducer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reducer.d.ts","sourceRoot":"","sources":["../../../src/core/sessions/reducer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAA;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAM9C,MAAM,MAAM,cAAc,GAAG,CAAC,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,WAAW,KAAK,YAAY,CAAA;AAEtF;;GAEG;AACH,KAAK,cAAc,GAAG;IACrB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAA;IAC7C,SAAS,EAAE,OAAO,CAAA;IAClB,MAAM,EAAE,OAAO,CAAA;CACf,CAAA;AAMD,MAAM,WAAW,UAAU,CAAC,IAAI,SAAS,MAAM,GAAG,MAAM,EAAE,MAAM,GAAG,OAAO;IACzE,GAAG,EAAE,IAAI,CAAA;IACT,YAAY,EAAE,MAAM,MAAM,CAAA;IAC1B,MAAM,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,MAAM,CAAA;IACvC,OAAO,EAAE,cAAc,CAAA;CACvB;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,SAAS,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,UAAU,SAAS,SAAS,cAAc,EAAE,EAAE,MAAM,EAAE;IACzH,GAAG,EAAE,IAAI,CAAA;IACT,MAAM,EAAE,UAAU,CAAA;IAClB,YAAY,EAAE,MAAM,MAAM,CAAA;IAC1B,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC,WAAW,CAAC,GAAG,SAAS,CAAC,MAAM,CAAC,EAAE,YAAY,EAAE,YAAY,KAAK,MAAM,CAAA;CACxH,GAAG,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,CAoB3B;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,CAAC,UAAU,SAAS,SAAS,cAAc,EAAE,EACpF,MAAM,EAAE,UAAU,EAClB,KAAK,EAAE,CAAC,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC,WAAW,CAAC,GAAG,SAAS,CAAC,MAAM,CAAC,KAAK,YAAY,GACtG,cAAc,CAEhB;AAMD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAG9F;AAED,eAAO,MAAM,eAAe,GAAI,GAAG,UAAU,cAAc,EAAE,KAAG,cAAiF,CAAA"}

package/dist/core/sessions/schema.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Session domain types and schemas
+ *
+ * Contains all types related to sessions:
+ * - Branded ID type and constructor
+ * - Session metadata schemas
+ * - Zod schemas for validation
+ */
+import z from 'zod/v4';
+/** SessionId schema - validates any string and brands as SessionId. */
+export declare const sessionIdSchema: z.core.$ZodBranded<z.ZodString, "SessionId", "out">;
+/** Branded SessionId type */
+export type SessionId = z.infer<typeof sessionIdSchema>;
+/** Constructor for SessionId */
+export declare const SessionId: (id: string) => SessionId;
+/** Generate a new SessionId (UUIDv7) */
+export declare const generateSessionId: () => SessionId;
+export declare const sessionMetadataMetricsSchema: z.ZodObject<{
+    totalEvents: z.ZodNumber;
+    totalAgents: z.ZodNumber;
+    totalTokens: z.ZodNumber;
+    totalLLMCalls: z.ZodNumber;
+    inputTokens: z.ZodOptional<z.ZodNumber>;
+    outputTokens: z.ZodOptional<z.ZodNumber>;
+    totalCost: z.ZodOptional<z.ZodNumber>;
+    totalMessages: z.ZodOptional<z.ZodNumber>;
+    totalToolCalls: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const sessionMetadataSchema: z.ZodObject<{
+    sessionId: z.core.$ZodBranded<z.ZodString, "SessionId", "out">;
+    presetId: z.ZodString;
+    createdAt: z.ZodNumber;
+    lastActivityAt: z.ZodNumber;
+    status: z.ZodEnum<{
+        active: "active";
+        closed: "closed";
+        errored: "errored";
+    }>;
+    name: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    metrics: z.ZodOptional<z.ZodObject<{
+        totalEvents: z.ZodNumber;
+        totalAgents: z.ZodNumber;
+        totalTokens: z.ZodNumber;
+        totalLLMCalls: z.ZodNumber;
+        inputTokens: z.ZodOptional<z.ZodNumber>;
+        outputTokens: z.ZodOptional<z.ZodNumber>;
+        totalCost: z.ZodOptional<z.ZodNumber>;
+        totalMessages: z.ZodOptional<z.ZodNumber>;
+        totalToolCalls: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    custom: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export declare const listSessionsOptionsSchema: z.ZodObject<{
+    status: z.ZodOptional<z.ZodEnum<{
+        active: "active";
+        closed: "closed";
+        errored: "errored";
+    }>>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    offset: z.ZodOptional<z.ZodNumber>;
+    orderBy: z.ZodOptional<z.ZodEnum<{
+        createdAt: "createdAt";
+        lastActivityAt: "lastActivityAt";
+    }>>;
+    order: z.ZodOptional<z.ZodEnum<{
+        asc: "asc";
+        desc: "desc";
+    }>>;
+}, z.core.$strip>;
+export type SessionMetadata = z.infer<typeof sessionMetadataSchema>;
+export type SessionMetadataMetrics = z.infer<typeof sessionMetadataMetricsSchema>;
+export type ListSessionsOptions = z.infer<typeof listSessionsOptionsSchema>;
+export declare const domainEventSchema: z.ZodObject<{
+    type: z.ZodString;
+    sessionId: z.ZodString;
+    timestamp: z.ZodNumber;
+}, z.core.$loose>;
+export type DomainEventInput = z.infer<typeof domainEventSchema>;
+export type SessionMetadataInput = z.infer<typeof sessionMetadataSchema>;
+//# sourceMappingURL=schema.d.ts.map

package/dist/core/sessions/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/core/sessions/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,CAAC,MAAM,QAAQ,CAAA;AAMtB,uEAAuE;AACvE,eAAO,MAAM,eAAe,qDAAgC,CAAA;AAE5D,6BAA6B;AAC7B,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAA;AAEvD,gCAAgC;AAChC,eAAO,MAAM,SAAS,GAAI,IAAI,MAAM,KAAG,SAA4B,CAAA;AAEnE,wCAAwC;AACxC,eAAO,MAAM,iBAAiB,QAAO,SAAgC,CAAA;AAUrE,eAAO,MAAM,4BAA4B;;;;;;;;;;iBAUvC,CAAA;AAEF,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;iBAUhC,CAAA;AAEF,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;iBAOpC,CAAA;AAMF,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAA;AACnE,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAA;AACjF,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAA;AAM3E,eAAO,MAAM,iBAAiB;;;;iBAMf,CAAA;AAEf,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAA;AAChE,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAA"}

package/dist/core/sessions/session-environment.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Session environment directories.
+ * Shared between agent-server tools and handler contexts.
+ */
+export interface SessionEnvironment {
+    /** Absolute path to the session directory */
+    sessionDir: string;
+    /** Absolute path to the workspace directory (optional) */
+    workspaceDir?: string;
+    /** When true, agents see virtual paths instead of real filesystem paths */
+    sandboxed: boolean;
+}
+//# sourceMappingURL=session-environment.d.ts.map

package/dist/core/sessions/session-environment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-environment.d.ts","sourceRoot":"","sources":["../../../src/core/sessions/session-environment.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IAClC,6CAA6C;IAC7C,UAAU,EAAE,MAAM,CAAA;IAClB,0DAA0D;IAC1D,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,2EAA2E;IAC3E,SAAS,EAAE,OAAO,CAAA;CAClB"}

package/dist/core/sessions/session-manager.d.ts

@@ -0,0 +1,183 @@
+/**
+ * SessionManager - Session lifecycle and cache management.
+ *
+ * Responsibilities:
+ * - Create and cache sessions
+ * - Load sessions from event store
+ * - Shutdown and cleanup
+ */
+import z4 from 'zod/v4';
+import type { AgentId } from '../../core/agents/schema.js';
+import { type DomainError } from '../../core/errors.js';
+import type { FileStore } from '../../core/file-store/types.js';
+import type { LLMLogger } from '../../core/llm/logger.js';
+import type { LLMProvider } from '../../core/llm/provider.js';
+import type { CallerContext, PluginDefinition } from '../../core/plugins/plugin-builder.js';
+import type { Preset } from '../../core/preset/index.js';
+import type { SessionId } from '../../core/sessions/schema.js';
+import type { ToolExecutor } from '../../core/tools';
+import type { Logger } from '../../lib/logger/logger.js';
+import type { Platform } from '../../platform/index.js';
+import type { Result } from '../../lib/utils/result.js';
+import type { PortPool } from '../../plugins/services/port-pool.js';
+import { type SessionStatsState } from '../../plugins/session-stats/index.js';
+import type { PreprocessorRegistry } from '../../plugins/uploads/preprocessor.js';
+import { EventStore } from '../events/event-store.js';
+import { Session, type UserOutputCallback } from './session.js';
+export interface SessionManagerOptions {
+    eventStore: EventStore;
+    llmProvider: LLMProvider;
+    /** Named provider instances for middleware routing */
+    llmProviders?: ReadonlyMap<string, LLMProvider>;
+    toolExecutor: ToolExecutor;
+    presets: Map<string, Preset>;
+    logger: Logger;
+    basePath: string;
+    dataFileStore: FileStore;
+    onUserOutput?: UserOutputCallback;
+    preprocessorRegistry?: PreprocessorRegistry;
+    llmLogger?: LLMLogger;
+    portPool?: PortPool;
+    /** Host-environment adapters (filesystem, process). */
+    platform: Platform;
+    systemPlugins?: readonly PluginDefinition<string, any, any, any, any>[];
+}
+/**
+ * SessionManager manages session lifecycle and caching.
+ */
+export declare class SessionManager {
+    private readonly sessions;
+    /** Unsubscribe functions for session event listeners, keyed by sessionId */
+    private readonly sessionListenerCleanup;
+    /** Manager-level methods collected from plugin definitions across all presets */
+    private readonly managerMethods;
+    private readonly eventStore;
+    private readonly llmProvider;
+    private readonly llmProviders;
+    private readonly toolExecutor;
+    private readonly presets;
+    private readonly logger;
+    private readonly basePath;
+    private readonly dataFileStore;
+    private readonly onUserOutput?;
+    private readonly preprocessorRegistry?;
+    private readonly llmLogger?;
+    private readonly portPool?;
+    private readonly platform;
+    private readonly systemPlugins;
+    constructor(options: SessionManagerOptions);
+    /** Expose platform adapters (used by Session for building contexts). */
+    getPlatform(): Platform;
+    /**
+     * Create a new session with the given preset.
+     */
+    createSession(presetId: string, options?: {
+        workspaceDir?: string;
+        sessionId?: string;
+    }): Promise<Result<Session, DomainError>>;
+    /**
+     * Fork a session from a specific event index into a new independent session.
+     * The forked session gets a copy of all events up to the fork point.
+     */
+    forkSession(sourceSessionId: SessionId, eventIndex: number): Promise<Result<Session, DomainError>>;
+    /**
+     * Get a session by ID - from cache or load from event store.
+     */
+    getSession(sessionId: SessionId): Promise<Result<Session, DomainError>>;
+    /**
+     * Internal session loading - throws SessionLoadError on domain errors.
+     */
+    private loadSession;
+    /**
+     * Call a plugin method on a session.
+     * @param sessionId - Session ID
+     * @param method - Full method name (e.g., "services.start")
+     * @param input - Method input (must include sessionId field)
+     * @param agentId - Agent ID (optional — some methods don't operate on a specific agent)
+     */
+    callPluginMethod(sessionId: SessionId, method: string, input: unknown, agentId?: AgentId, caller?: CallerContext): Promise<Result<unknown, DomainError>>;
+    /**
+     * Call a manager-level plugin method.
+     * These methods operate outside session context (e.g., session creation, listing).
+     */
+    callManagerMethod(method: string, input: unknown): Promise<Result<unknown, DomainError>>;
+    /**
+     * Get all registered manager methods.
+     */
+    getManagerMethods(): Map<string, {
+        input: z4.ZodType;
+        output: z4.ZodType;
+    }>;
+    /**
+     * Load all active sessions from event store (for restart recovery).
+     *
+     * Closed sessions are skipped — they have no runtime to restore. Loading them
+     * would trigger callSessionReadyHooks and emit events to an immutable session log,
+     * causing write amplification on every agent startup.
+     */
+    loadAllSessions(): Promise<void>;
+    /**
+     * Get runtime stats including last activity timestamp and per-session metrics.
+     *
+     * Only open (non-closed) sessions contribute to activity metrics. Closed sessions
+     * are immutable artifacts — their event log timestamps must not be interpreted as
+     * "the sandbox is doing work", otherwise the worker alarm sees stale activity and
+     * keeps the sandbox alive forever.
+     */
+    getStats(): Promise<{
+        sessionCount: number;
+        pendingAgents: number;
+        processingAgents: number;
+        lastActivityAt: number | null;
+        sessions: Array<{
+            id: SessionId;
+            presetId: string;
+            status: string;
+            metrics: SessionStatsState;
+        }>;
+    }>;
+    /**
+     * Shutdown - clean up all sessions.
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Build ConfiguredPlugin[] for a session.
+     *
+     * Iterates all system-registered plugins. For each:
+     * 1. Check if preset has explicit SessionPluginConfig → use that config
+     * 2. If not, try auto-deriving infrastructure config (agents, uploads, services)
+     * 3. If no config at all → call .create() with no args (void config)
+     * 4. Check isSessionEnabled — skip plugin if not enabled
+     */
+    private buildPlugins;
+    /**
+     * Build infrastructure-derived plugin configs from preset data.
+     * These are auto-derived for well-known plugins that need preset-level data.
+     */
+    private buildInfraConfigs;
+    /**
+     * Create a Session instance with all dependencies.
+     * Plugins must be pre-built via buildPlugins() so the composed reducer
+     * can be used for SessionStore before this method is called.
+     *
+     * @param opts.skipReadyHooks - Skip onSessionReady hooks. Used for closed sessions,
+     *   which must remain immutable: running hooks would emit session_handler_* events
+     *   to a sealed event log on every introspection / restart cycle.
+     */
+    private createSessionInstance;
+    /**
+     * Collect manager methods from all system plugin definitions.
+     */
+    private collectManagerMethods;
+    /**
+     * Register event listener on a session's store for automatic cache eviction.
+     * When session_closed or session_reopened events fire, the session is evicted
+     * so next getSession() triggers a full load with recovery.
+     *
+     * Cleans up any previous listener for this sessionId (from a prior load)
+     * to prevent duplicate listeners firing on old stores.
+     */
+    private registerSessionEventListener;
+    private getSessionDir;
+}
+//# sourceMappingURL=session-manager.d.ts.map

package/dist/core/sessions/session-manager.d.ts.map

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

package/dist/core/sessions/session-store.d.ts

@@ -0,0 +1,69 @@
+/**
+ * SessionStore - Wrapper over EventStore with in-memory state.
+ *
+ * Provides a clean API for emitting events and reading state.
+ * The state is automatically updated when events are emitted.
+ */
+import type { AgentId } from '../../core/agents/schema.js';
+import type { AgentState } from '../../core/agents/state.js';
+import type { EventStore } from '../../core/events/event-store.js';
+import type { DomainEvent } from '../../core/events/types.js';
+import type { SessionReducer } from '../../core/sessions/reducer.js';
+import type { SessionId } from '../../core/sessions/schema.js';
+import type { SessionState } from '../../core/sessions/state.js';
+/**
+ * SessionStore wraps EventStore and provides:
+ * - Event emission with automatic state updates
+ * - In-memory state access
+ * - Agent state lookup
+ */
+export declare class SessionStore {
+    readonly sessionId: SessionId;
+    private readonly eventStore;
+    private _state;
+    private readonly eventListeners;
+    private readonly applyEvent;
+    constructor(sessionId: SessionId, eventStore: EventStore, initialState: SessionState, applyEvent?: SessionReducer);
+    /**
+     * Register a listener that is called after each event is emitted and state is updated.
+     * Returns an unsubscribe function to remove the listener.
+     */
+    onEvent(listener: (event: DomainEvent) => void): () => void;
+    /**
+     * Remove all event listeners. Called on session close to prevent leaks.
+     */
+    clearListeners(): void;
+    /**
+     * Create a new SessionStore by loading events from EventStore.
+     * Also validates and reconciles metadata if out of sync (e.g., after crash).
+     */
+    static load(sessionId: SessionId, eventStore: EventStore, applyEvent?: SessionReducer): Promise<SessionStore | null>;
+    /**
+     * Emit a single event - writes to EventStore and applies to state.
+     */
+    emit(event: DomainEvent): Promise<void>;
+    /**
+     * Emit multiple events atomically - writes to EventStore and applies to state.
+     * Listener errors are isolated per-listener so one failure cannot prevent
+     * state application for subsequent events in the batch.
+     */
+    emitBatch(events: DomainEvent[]): Promise<void>;
+    /**
+     * Notify all listeners about an event, catching per-listener errors
+     * so one failing listener doesn't prevent others from being notified.
+     */
+    private notifyListeners;
+    /**
+     * Get the current session state.
+     */
+    getState(): SessionState;
+    /**
+     * Get a specific agent's state.
+     */
+    getAgentState(agentId: AgentId): AgentState | null;
+    /**
+     * Check if the session is closed.
+     */
+    isClosed(): boolean;
+}
+//# sourceMappingURL=session-store.d.ts.map

package/dist/core/sessions/session-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-store.d.ts","sourceRoot":"","sources":["../../../src/core/sessions/session-store.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAA;AACtD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAA;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AAEzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAA;AAChE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAA;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAO5D;;;;;GAKG;AACH,qBAAa,YAAY;IAMvB,QAAQ,CAAC,SAAS,EAAE,SAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAN5B,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA0C;IACzE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAgB;gBAGjC,SAAS,EAAE,SAAS,EACZ,UAAU,EAAE,UAAU,EACvC,YAAY,EAAE,YAAY,EAC1B,UAAU,GAAE,cAA+B;IAM5C;;;OAGG;IACH,OAAO,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,GAAG,MAAM,IAAI;IAQ3D;;OAEG;IACH,cAAc,IAAI,IAAI;IAItB;;;OAGG;WACU,IAAI,CAChB,SAAS,EAAE,SAAS,EACpB,UAAU,EAAE,UAAU,EACtB,UAAU,CAAC,EAAE,cAAc,GACzB,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAa/B;;OAEG;IACG,IAAI,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAM7C;;;;OAIG;IACG,SAAS,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAUrD;;;OAGG;IACH,OAAO,CAAC,eAAe;IAUvB;;OAEG;IACH,QAAQ,IAAI,YAAY;IAIxB;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,UAAU,GAAG,IAAI;IAIlD;;OAEG;IACH,QAAQ,IAAI,OAAO;CAGnB"}