@roj-ai/sdk 0.0.2

package/dist/transport/http/middleware/error-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler.d.ts","sourceRoot":"","sources":["../../../../src/transport/http/middleware/error-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAInC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAA;AAEvC;;GAEG;AACH,eAAO,MAAM,YAAY,GAAI,OAAO,KAAK,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;;;;;gXAwD5D,CAAA"}

package/dist/transport/http/routes/files.d.ts

@@ -0,0 +1,16 @@
+/**
+ * File Proxy Routes
+ *
+ * Serves session files (e.g. screenshots from tools) via HTTP.
+ * Used by the debug UI to display images from LLM call logs.
+ */
+import { Hono } from 'hono';
+import { type AppEnv } from '../app.js';
+/**
+ * Creates file proxy routes.
+ *
+ * GET /:sessionId/files/*path              - Serve session file
+ * GET /:sessionId/workspace/*path          - Serve workspace file
+ */
+export declare function createFileRoutes(): Hono<AppEnv>;
+//# sourceMappingURL=files.d.ts.map

package/dist/transport/http/routes/files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../../../../src/transport/http/routes/files.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAG3B,OAAO,EAAmB,KAAK,MAAM,EAAe,MAAM,WAAW,CAAA;AAoMrE;;;;;GAKG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAAC,MAAM,CAAC,CA6D/C"}

package/dist/transport/http/routes/resources.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Resource injection routes.
+ *
+ * POST /sessions/:sessionId/inject-resource
+ * Downloads a file from a URL and injects it directly into the session workspace
+ * (ZIP files are extracted, other files are copied). Used by the worker to inject
+ * organization resources into sessions, bypassing the uploads/attachment pipeline.
+ */
+import { Hono } from 'hono';
+import type { AppEnv } from '../app.js';
+export declare function createResourceRoutes(): Hono<AppEnv>;
+//# sourceMappingURL=resources.d.ts.map

package/dist/transport/http/routes/resources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../../../../src/transport/http/routes/resources.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAC3B,OAAO,KAAK,EAAc,MAAM,EAAE,MAAM,WAAW,CAAA;AAInD,wBAAgB,oBAAoB,IAAI,IAAI,CAAC,MAAM,CAAC,CAoGnD"}

package/dist/transport/http/routes/rpc.d.ts

@@ -0,0 +1,22 @@
+/**
+ * RPC Routes — Generic Dispatcher
+ *
+ * Single POST /rpc endpoint that auto-routes to plugin methods.
+ * No hardcoded handlers — all business logic lives in plugins.
+ *
+ * Supports both single calls and batch calls:
+ * - Single: { method, input } → { ok: true, value } | { ok: false, error }
+ * - Batch:  { batch: [{ method, input }, ...] } → { results: [{ ok: true, value } | { ok: false, error }, ...] }
+ *
+ * Routing order:
+ * 1. Manager methods (session creation, listing, etc.)
+ * 2. Session plugin methods (require sessionId in input)
+ * 3. 404 if not found
+ */
+import { Hono } from 'hono';
+import type { AppEnv } from '../app.js';
+/**
+ * Creates the RPC routes.
+ */
+export declare function createRpcRoutes(): Hono<AppEnv>;
+//# sourceMappingURL=rpc.d.ts.map

package/dist/transport/http/routes/rpc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc.d.ts","sourceRoot":"","sources":["../../../../src/transport/http/routes/rpc.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAQ3B,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAA;AAwEvC;;GAEG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAAC,MAAM,CAAC,CAwD9C"}

package/dist/transport/http/routes/rpc.integration.test.d.ts

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

package/dist/transport/http/routes/rpc.integration.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc.integration.test.d.ts","sourceRoot":"","sources":["../../../../src/transport/http/routes/rpc.integration.test.ts"],"names":[],"mappings":""}

package/dist/transport/http/routes/rpc.test.d.ts

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

package/dist/transport/http/routes/rpc.test.d.ts.map

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

package/dist/transport/http/routes/upload.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Upload Routes
+ *
+ * Multipart file upload endpoint for session attachments.
+ * Separate from RPC as multipart is more efficient for binary data.
+ * Business logic delegated to uploads plugin.
+ */
+import { Hono } from 'hono';
+import { type AppEnv } from '../app.js';
+/**
+ * Creates upload routes.
+ */
+export declare function createUploadRoutes(): Hono<AppEnv>;
+//# sourceMappingURL=upload.d.ts.map

package/dist/transport/http/routes/upload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload.d.ts","sourceRoot":"","sources":["../../../../src/transport/http/routes/upload.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAE3B,OAAO,EAAmB,KAAK,MAAM,EAAe,MAAM,WAAW,CAAA;AAMrE;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAAC,MAAM,CAAC,CA0QjD"}

package/dist/transport/rpc/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * RPC Module
+ *
+ * Re-exports for type-safe RPC between agent-server and SPA client.
+ */
+export type { AgentChatMessage, AskUserChatMessage, ChatMessage, UserChatMessage } from '../../plugins/user-chat/index.js';
+export type { RpcInput, RpcMethodDef, RpcMethodName, RpcMethods, RpcOutput } from './methods.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/transport/rpc/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/transport/rpc/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,YAAY,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAA;AAGtH,YAAY,EAAE,QAAQ,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA"}

package/dist/transport/rpc/methods.d.ts

@@ -0,0 +1,25 @@
+/**
+ * RPC Method Types
+ *
+ * Types are inferred from plugin definitions via the system composition.
+ * Method schemas carry pre-resolved TS types (not Zod wrappers), so no z.infer needed.
+ */
+import type { BuiltinMethodSchemas } from '../../bootstrap.js';
+import type { MethodSchema } from '../../core/system.js';
+export type RpcMethods = BuiltinMethodSchemas;
+export type RpcMethodName = string & keyof RpcMethods;
+type RemoveIndexSignature<T> = {
+    [K in keyof T as string extends K ? never : K]: T[K];
+};
+export type RpcInput<M extends RpcMethodName> = RpcMethods[M] extends {
+    __session: true;
+} ? RemoveIndexSignature<RpcMethods[M]['input']> & {
+    sessionId: string;
+} : RpcMethods[M]['input'];
+export type RpcOutput<M extends RpcMethodName> = RpcMethods[M]['output'];
+export type RpcMethodDef<M extends RpcMethodName> = {
+    input: RpcMethods[M]['input'];
+    output: RpcMethods[M]['output'];
+};
+export type { MethodSchema };
+//# sourceMappingURL=methods.d.ts.map

package/dist/transport/rpc/methods.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"methods.d.ts","sourceRoot":"","sources":["../../../src/transport/rpc/methods.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAA;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAMpD,MAAM,MAAM,UAAU,GAAG,oBAAoB,CAAA;AAC7C,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,MAAM,UAAU,CAAA;AAGrD,KAAK,oBAAoB,CAAC,CAAC,IAAI;KAC7B,CAAC,IAAI,MAAM,CAAC,IAAI,MAAM,SAAS,CAAC,GAAG,KAAK,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CACpD,CAAA;AAKD,MAAM,MAAM,QAAQ,CAAC,CAAC,SAAS,aAAa,IAAI,UAAU,CAAC,CAAC,CAAC,SAAS;IAAE,SAAS,EAAE,IAAI,CAAA;CAAE,GACtF,oBAAoB,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,GACpE,UAAU,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAA;AACzB,MAAM,MAAM,SAAS,CAAC,CAAC,SAAS,aAAa,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAA;AAGxE,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,aAAa,IAAI;IACnD,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAA;IAC7B,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAA;CAC/B,CAAA;AAGD,YAAY,EAAE,YAAY,EAAE,CAAA"}

package/dist/user-config.d.ts

@@ -0,0 +1,29 @@
+/**
+ * User Configuration type + defineConfig helper.
+ *
+ * The runtime loader (`loadUserConfig`) lives in the Bun runtime package
+ * since it performs dynamic imports that require a runtime context.
+ */
+import type { Preset } from './core/preset/index.js';
+import type { ExtraBind } from './plugins/shell/plugin.js';
+/**
+ * User configuration for the agent server.
+ */
+export interface RojConfig {
+    /** Base directory for sessions (default: cwd) */
+    sessionsDir?: string;
+    /** Whether sandbox (bwrap) is active (default: true) */
+    sandboxed?: boolean;
+    /** Enable snapshotter for tracking file changes (e.g. 'jj' for Jujutsu VCS) */
+    snapshotter?: 'jj';
+    /** Extra paths to bind-mount inside bwrap sandbox */
+    extraBinds?: ExtraBind[];
+    /** Presets available in this configuration */
+    presets: Preset[];
+}
+/**
+ * Type sugar for defining configuration (like Vite, Vitest, etc.).
+ * Provides better DX with type inference.
+ */
+export declare function defineConfig(config: RojConfig): RojConfig;
+//# sourceMappingURL=user-config.d.ts.map

package/dist/user-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-config.d.ts","sourceRoot":"","sources":["../src/user-config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAA;AACpD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAA;AAE1D;;GAEG;AACH,MAAM,WAAW,SAAS;IACzB,iDAAiD;IACjD,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,wDAAwD;IACxD,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,+EAA+E;IAC/E,WAAW,CAAC,EAAE,IAAI,CAAA;IAClB,qDAAqD;IACrD,UAAU,CAAC,EAAE,SAAS,EAAE,CAAA;IACxB,8CAA8C;IAC9C,OAAO,EAAE,MAAM,EAAE,CAAA;CACjB;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS,CAEzD"}

package/package.json

@@ -0,0 +1,154 @@
+{
+	"name": "@roj-ai/sdk",
+	"version": "0.0.2",
+	"type": "module",
+	"main": "./src/index.ts",
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"import": "./src/index.ts",
+			"default": "./src/index.ts"
+		},
+		"./platform": {
+			"types": "./dist/platform/index.d.ts",
+			"import": "./src/platform/index.ts",
+			"default": "./src/platform/index.ts"
+		},
+		"./bun-platform": {
+			"types": "./dist/bun-platform/index.d.ts",
+			"import": "./src/bun-platform/index.ts",
+			"default": "./src/bun-platform/index.ts"
+		},
+		"./bootstrap": {
+			"types": "./dist/bootstrap.d.ts",
+			"import": "./src/bootstrap.ts",
+			"default": "./src/bootstrap.ts"
+		},
+		"./config": {
+			"types": "./dist/config.d.ts",
+			"import": "./src/config.ts",
+			"default": "./src/config.ts"
+		},
+		"./user-config": {
+			"types": "./dist/user-config.d.ts",
+			"import": "./src/user-config.ts",
+			"default": "./src/user-config.ts"
+		},
+		"./tools": {
+			"types": "./dist/core/tools/index.d.ts",
+			"import": "./src/core/tools/index.ts",
+			"default": "./src/core/tools/index.ts"
+		},
+		"./transport/http/app": {
+			"types": "./dist/transport/http/app.d.ts",
+			"import": "./src/transport/http/app.ts",
+			"default": "./src/transport/http/app.ts"
+		},
+		"./transport/adapter": {
+			"types": "./dist/transport/adapter/index.d.ts",
+			"import": "./src/transport/adapter/index.ts",
+			"default": "./src/transport/adapter/index.ts"
+		},
+		"./session-manager": {
+			"types": "./dist/core/sessions/session-manager.d.ts",
+			"import": "./src/core/sessions/session-manager.ts",
+			"default": "./src/core/sessions/session-manager.ts"
+		},
+		"./llm/provider": {
+			"types": "./dist/core/llm/provider.d.ts",
+			"import": "./src/core/llm/provider.ts",
+			"default": "./src/core/llm/provider.ts"
+		},
+		"./llm/mock": {
+			"types": "./dist/core/llm/mock.d.ts",
+			"import": "./src/core/llm/mock.ts",
+			"default": "./src/core/llm/mock.ts"
+		},
+		"./llm/snapshot-middleware": {
+			"types": "./dist/core/llm/snapshot-middleware.d.ts",
+			"import": "./src/core/llm/snapshot-middleware.ts",
+			"default": "./src/core/llm/snapshot-middleware.ts"
+		},
+		"./testing": {
+			"types": "./dist/testing/index.d.ts",
+			"import": "./src/testing/index.ts",
+			"default": "./src/testing/index.ts"
+		},
+		"./tools/filesystem": {
+			"types": "./dist/plugins/filesystem/index.d.ts",
+			"import": "./src/plugins/filesystem/index.ts",
+			"default": "./src/plugins/filesystem/index.ts"
+		},
+		"./tools/shell": {
+			"types": "./dist/plugins/shell/index.d.ts",
+			"import": "./src/plugins/shell/index.ts",
+			"default": "./src/plugins/shell/index.ts"
+		},
+		"./workers": {
+			"types": "./dist/plugins/workers/index.d.ts",
+			"import": "./src/plugins/workers/index.ts",
+			"default": "./src/plugins/workers/index.ts"
+		},
+		"./workers/context": {
+			"types": "./dist/plugins/workers/context.d.ts",
+			"import": "./src/plugins/workers/context.ts",
+			"default": "./src/plugins/workers/context.ts"
+		},
+		"./workers/definition": {
+			"types": "./dist/plugins/workers/definition.d.ts",
+			"import": "./src/plugins/workers/definition.ts",
+			"default": "./src/plugins/workers/definition.ts"
+		},
+		"./file-store": {
+			"types": "./dist/core/file-store/file-store.d.ts",
+			"import": "./src/core/file-store/file-store.ts",
+			"default": "./src/core/file-store/file-store.ts"
+		},
+		"./prompts": {
+			"types": "./dist/prompts/index.d.ts",
+			"import": "./src/prompts/index.ts",
+			"default": "./src/prompts/index.ts"
+		},
+		"./protocols": {
+			"types": "./dist/transport/protocols/index.d.ts",
+			"import": "./src/transport/protocols/index.ts",
+			"default": "./src/transport/protocols/index.ts"
+		},
+		"./rpc": {
+			"types": "./dist/transport/rpc/index.d.ts",
+			"import": "./src/transport/rpc/index.ts",
+			"default": "./src/transport/rpc/index.ts"
+		},
+		"./projections": {
+			"types": "./dist/projections/index.d.ts",
+			"import": "./src/projections/index.ts",
+			"default": "./src/projections/index.ts"
+		}
+	},
+	"files": [
+		"src",
+		"dist"
+	],
+	"publishConfig": {
+		"access": "public"
+	},
+	"scripts": {
+		"type-check": "tsc --noEmit"
+	},
+	"dependencies": {
+		"@roj-ai/transport": "^0.0.2",
+		"@hono/zod-validator": "0.7.6",
+		"hono": "4.12.5",
+		"ignore": "7.0.5",
+		"tokenx": "^1.3.0",
+		"uuidv7": "^1.1.0",
+		"ws": "^8.18.0",
+		"zod": "4.3.6"
+	},
+	"devDependencies": {
+		"@types/bun": "latest",
+		"@types/ws": "^8.5.10",
+		"typescript": "^5.7.2"
+	},
+	"types": "./dist/index.d.ts"
+}

package/src/bootstrap.ts

@@ -0,0 +1,268 @@
+/**
+ * Bootstrap - Composition Root for Agent Server
+ *
+ * Creates and wires all services together based on configuration.
+ */
+
+import type { EventStore } from '~/core/events/event-store.js'
+import { FileEventStore, MemoryEventStore } from '~/core/events/index.js'
+import type { FileStore } from '~/core/file-store/types.js'
+import { DefaultImageProcessor } from '~/core/image/image-processor.js'
+import { VipsImageResizer } from '~/core/image/vips-resizer.js'
+import { AnthropicProvider } from '~/core/llm/anthropic.js'
+import { LLMLogger, LoggingLLMProvider, MockLLMProvider } from '~/core/llm/index.js'
+import { OpenRouterProvider } from '~/core/llm/openrouter.js'
+import type { LLMProvider } from '~/core/llm/provider.js'
+import { RoutingLLMProvider } from '~/core/llm/routing-provider.js'
+import type { RoutableLLMProvider } from '~/core/llm/routing-provider.js'
+import type { Preset } from '~/core/preset/index.js'
+import type { Platform } from '~/platform/index.js'
+import { PreprocessorRegistry } from '~/plugins/uploads/preprocessor.js'
+import { ImageClassifierPreprocessor, MarkitdownPreprocessor, ZipPreprocessor } from '~/plugins/uploads/preprocessors/index.js'
+import type { Config } from './config.js'
+import { SessionFileStore } from './core/file-store/file-store.js'
+import type { SessionManager } from './core/sessions/session-manager.js'
+import type { UserOutputCallback } from './core/sessions/session.js'
+import { type AllMethodSchemas, createSystem, type System } from './core/system.js'
+import type { ToolExecutor } from './core/tools/executor.js'
+import { ToolExecutor as ToolExecutorImpl } from './core/tools/executor.js'
+import { ConsoleLogger, JsonLogger } from './lib/logger/index.js'
+import type { Logger } from './lib/logger/logger.js'
+import { agentStatusPlugin } from './plugins/agent-status/plugin.js'
+import { agentsPlugin } from './plugins/agents/plugin.js'
+import { filesystemPlugin } from './plugins/filesystem/index.js'
+import { gitStatusPlugin } from './plugins/git-status/index.js'
+import { llmDebugPlugin } from './plugins/llm-debug/plugin.js'
+import { logsPlugin } from './plugins/logs/index.js'
+import { mailboxPlugin } from './plugins/mailbox/plugin.js'
+import { servicePlugin } from './plugins/services/plugin.js'
+import { PortPool } from './plugins/services/port-pool.js'
+import { presetsPlugin, sessionLifecyclePlugin } from './plugins/session-lifecycle/index.js'
+import { sessionStatsPlugin } from './plugins/session-stats/index.js'
+import { sessionStatePlugin } from './plugins/session-state/plugin.js'
+import { resourcesPlugin } from './plugins/resources/plugin.js'
+import { uploadsPlugin } from './plugins/uploads/plugin.js'
+import { userChatPlugin } from './plugins/user-chat/plugin.js'
+import type { RojConfig } from './user-config.js'
+
+/**
+ * All built-in plugin definitions passed to createSystem for type inference.
+ * These are always registered in every session (see SessionManager.createSessionInstance).
+ */
+const builtinPlugins = [
+	sessionLifecyclePlugin,
+	presetsPlugin,
+	mailboxPlugin,
+	agentsPlugin,
+	agentStatusPlugin,
+	userChatPlugin,
+	uploadsPlugin,
+	resourcesPlugin,
+	llmDebugPlugin,
+	servicePlugin,
+	filesystemPlugin,
+	logsPlugin,
+	sessionStatsPlugin,
+	sessionStatePlugin,
+	gitStatusPlugin,
+] as const
+
+/** Method schemas inferred from all built-in plugins */
+export type BuiltinMethodSchemas = AllMethodSchemas<typeof builtinPlugins>
+
+/**
+ * Container for all bootstrapped services
+ */
+export interface Services {
+	eventStore: EventStore
+	llmProvider: LLMProvider
+	/** Named provider instances for middleware routing (e.g. useProvider('anthropic')) */
+	llmProviders: ReadonlyMap<string, LLMProvider>
+	llmLogger?: LLMLogger
+	toolExecutor: ToolExecutor
+	logger: Logger
+	presets: Map<string, Preset>
+	/** FileStore rooted at dataPath for upload/infrastructure file operations */
+	dataFileStore: FileStore
+	/** Configuration (needed by upload routes) */
+	config: Config
+	/** Global port pool shared across all sessions */
+	portPool: PortPool
+	/** Preprocessor registry for upload content extraction */
+	preprocessorRegistry: PreprocessorRegistry
+	/** Host-environment adapters (filesystem, process). */
+	platform: Platform
+}
+
+/**
+ * Bootstrap all services based on configuration.
+ *
+ * `platform` provides runtime adapters (fs, process). Callers pass concrete
+ * impls from their runtime package (e.g. `createBunPlatform()` from
+ * `@roj-ai/sdk/bun-platform`).
+ */
+export function bootstrap(config: Config, userConfig: RojConfig, platform: Platform): Services {
+	const logger = createLogger(config)
+	logger.info('Bootstrapping agent server', { persistence: config.persistence, logLevel: config.logLevel })
+
+	const eventStore = config.persistence === 'memory'
+		? new MemoryEventStore()
+		: new FileEventStore(config.dataPath, platform.fs)
+
+	const { llmProvider, llmProviders, llmLogger } = createLLMProvider(config, logger, platform)
+
+	const presets = new Map(userConfig.presets.map(p => [p.id, p]))
+	logger.info('Loaded presets', { count: presets.size })
+
+	const toolExecutor = new ToolExecutorImpl(logger)
+	const dataFileStore = new SessionFileStore(config.dataPath, undefined, false, platform.fs, 'session')
+	const portPool = new PortPool()
+
+	const preprocessorRegistry = new PreprocessorRegistry()
+	preprocessorRegistry.register(new ImageClassifierPreprocessor({ llmProvider, logger, fs: platform.fs }))
+	preprocessorRegistry.register(new MarkitdownPreprocessor({ registry: preprocessorRegistry, logger, fs: platform.fs, process: platform.process }))
+	preprocessorRegistry.register(new ZipPreprocessor({ registry: preprocessorRegistry, logger, process: platform.process }))
+
+	logger.info('Bootstrap complete')
+
+	return {
+		eventStore,
+		llmProvider,
+		llmProviders,
+		llmLogger,
+		toolExecutor,
+		logger,
+		presets,
+		dataFileStore,
+		config,
+		portPool,
+		preprocessorRegistry,
+		platform,
+	}
+}
+
+function createLogger(config: Config): Logger {
+	return config.logFormat === 'json'
+		? new JsonLogger(config.logLevel)
+		: new ConsoleLogger({ level: config.logLevel })
+}
+
+function createLLMProvider(config: Config, logger: Logger, platform: Platform): {
+	llmProvider: LLMProvider
+	llmProviders: ReadonlyMap<string, LLMProvider>
+	llmLogger?: LLMLogger
+} {
+	if (config.llmMock) {
+		const mock = new MockLLMProvider(config.llmMock)
+		return { llmProvider: mock, llmProviders: new Map([['mock', mock]]) }
+	}
+
+	const imageResizer = new VipsImageResizer({ fs: platform.fs, process: platform.process, tmpDir: platform.tmpDir })
+	const imageProcessor = new DefaultImageProcessor(imageResizer, platform.fs)
+
+	const routableProviders: RoutableLLMProvider[] = []
+	let fallbackProvider: LLMProvider | undefined
+
+	// Named provider registry for middleware useProvider()
+	const namedProviders = new Map<string, LLMProvider>()
+
+	// Register Anthropic provider if API key is set
+	if (config.anthropicApiKey) {
+		const anthropic = new AnthropicProvider({
+			apiKey: config.anthropicApiKey,
+			defaultModel: config.defaultModel,
+			logger,
+			imageProcessor,
+			thinkingBudget: config.thinkingBudget,
+		})
+		routableProviders.push(anthropic)
+		namedProviders.set('anthropic', anthropic)
+		logger.info('Registered Anthropic provider')
+	}
+
+	// Register OpenRouter as fallback if API key is set
+	if (config.openRouterApiKey) {
+		fallbackProvider = new OpenRouterProvider({
+			apiKey: config.openRouterApiKey,
+			defaultModel: config.defaultModel,
+			logger,
+			imageProcessor,
+		})
+		namedProviders.set('openrouter', fallbackProvider)
+		logger.info('Registered OpenRouter provider (fallback)')
+	}
+
+	// If only Anthropic is configured (no fallback), use it directly
+	const baseProvider: LLMProvider = routableProviders.length > 0 || fallbackProvider
+		? new RoutingLLMProvider(routableProviders, fallbackProvider)
+		: routableProviders[0]
+
+	logger.info('LLM routing configured', {
+		providers: routableProviders.map((p) => p.name),
+		fallback: fallbackProvider?.name ?? 'none',
+		defaultModel: config.defaultModel,
+	})
+
+	if (config.llmLoggingEnabled === false) {
+		return { llmProvider: baseProvider, llmProviders: namedProviders }
+	}
+
+	const llmLogger = new LLMLogger({ basePath: config.dataPath, enabled: true, fs: platform.fs })
+	logger.info('LLM request logging enabled', { path: config.dataPath })
+
+	return {
+		llmProvider: new LoggingLLMProvider(baseProvider, llmLogger, logger),
+		llmProviders: namedProviders,
+		llmLogger,
+	}
+}
+
+/**
+ * Create a System wired to bootstrapped services.
+ * Returns the full System object with SessionManager, typed method schemas, and lifecycle methods.
+ */
+export function createSystemFromServices(
+	services: Services,
+	options?: {
+		onUserOutput?: UserOutputCallback
+	},
+): System<BuiltinMethodSchemas, typeof builtinPlugins> {
+	return createSystem({
+		plugins: builtinPlugins,
+		eventStore: services.eventStore,
+		llmProvider: services.llmProvider,
+		llmProviders: services.llmProviders,
+		toolExecutor: services.toolExecutor,
+		presets: services.presets,
+		logger: services.logger,
+		basePath: services.config.dataPath,
+		dataFileStore: services.dataFileStore,
+		onUserOutput: options?.onUserOutput,
+		preprocessorRegistry: services.preprocessorRegistry,
+		llmLogger: services.llmLogger,
+		portPool: services.portPool,
+		platform: services.platform,
+	})
+}
+
+/**
+ * Create a SessionManager wired to bootstrapped services.
+ * @deprecated Use createSystemFromServices() instead for typed method registry.
+ */
+export function createSessionManager(
+	services: Services,
+	options?: {
+		onUserOutput?: UserOutputCallback
+	},
+): SessionManager {
+	return createSystemFromServices(services, options).sessionManager
+}
+
+/**
+ * Bootstrap for testing with memory store and mock LLM.
+ *
+ * @param mockHandler - Optional custom mock handler for LLM responses
+ * @param presets - Optional presets array (defaults to empty)
+ */
+// Note: bootstrapForTesting lives in `src/testing/bootstrap-for-testing.ts`
+// so production bootstrap has no dependency on the node test-platform helper.

package/src/builtin-events.ts

@@ -0,0 +1,25 @@
+/**
+ * BuiltinEvent — Union of all built-in plugin event types.
+ *
+ * This type is the client-side equivalent of ProjectionEvent in projections.ts.
+ * Use it to narrow DomainEvent to access event-specific properties after type checks.
+ */
+
+import type { agentEvents } from '~/core/agents/state.js'
+import type { contextEvents } from '~/core/context/state.js'
+import type { FactoryEventType } from '~/core/events/types.js'
+import type { llmEvents } from '~/core/llm/state.js'
+import type { sessionEvents } from '~/core/sessions/state.js'
+import type { toolEvents } from '~/core/tools/state.js'
+import type { mailboxEvents } from '~/plugins/mailbox/state.js'
+import type { userChatEvents } from '~/plugins/user-chat/plugin.js'
+
+export type BuiltinEvent = FactoryEventType<
+	| typeof agentEvents
+	| typeof sessionEvents
+	| typeof toolEvents
+	| typeof llmEvents
+	| typeof contextEvents
+	| typeof mailboxEvents
+	| typeof userChatEvents
+>