@abot-ai/runtime 1.2.0 → 1.3.1

package/dist/src/runtime/config.js

@@ -6,11 +6,12 @@ import { buildLongTermMemoryConfig } from "./config/long-term-memory.js";
 import { DEFAULT_RUNTIME_AGENT_BRIDGE_URL, DEFAULT_RUNTIME_CONFIG_FILE, } from "./config/constants.js";
 import { validateEffectiveRuntimeModelConfig } from "./config/effective-model-config-validation.js";
 import { resolveRuntimeEnvironmentProfileSelection } from "./config/environment.js";
+import { resolveEnvironmentRuntimeDirectory } from "./config/environment-paths.js";
 import { RUNTIME_CONFIG_SCHEMA_FIELDS } from "./config/fields.js";
 import { loadRuntimeConfigFileWithMeta } from "./config/loader.js";
 import { resolveRequestRunnerConfigReference } from "./config/request-runner-config.js";
 import { loadRequestRunnerConfig } from "./config/runner/loader.js";
-import { DEFAULT_RUNTIME_COMPILED_DIR, DEFAULT_RUNTIME_SHARED_DIR, DEFAULT_AGENT_WORK_DIR, DEFAULT_RUNTIME_STATE_DIR, DEFAULT_WORKSPACE_SOURCE_DIR, RUNTIME_ATTACHMENTS_DIR_NAME, RUNTIME_LOGS_DIR_NAME, RUNTIME_SESSIONS_DIR_NAME, } from "./config/layout.js";
+import { DEFAULT_RUNTIME_COMPILED_DIR, DEFAULT_RUNTIME_SHARED_DIR, DEFAULT_AGENT_WORK_DIR, DEFAULT_WORKSPACE_SOURCE_DIR, RUNTIME_ATTACHMENTS_DIR_NAME, RUNTIME_LOGS_DIR_NAME, RUNTIME_SESSIONS_DIR_NAME, } from "./config/layout.js";
 import { createRuntimeConfigJsonSchema, RUNTIME_CONFIG_JSON_SCHEMA, } from "./config/schema.js";
 import { readConfigPositiveInt, readConfigString, readFirstString, readNestedConfigString, readPositiveInt, resolveRuntimePath, } from "./config/utils.js";
 import { RuntimeConfigValidationError } from "./config/validation.js";
@@ -54,10 +55,13 @@ export function loadRuntimeConfig(options = {}) {
         profileId: options.profileId,
     });
     const basePaths = profileSelection.basePaths ?? fileConfig.paths;
-    const runtimeDir = resolveRuntimePath(rootDir, readFirstString(env, ["LLM_RUNTIME_DIR"]) ??
-        readNestedConfigString(profileSelection.profilePaths, "runtimeDir") ??
-        readNestedConfigString(basePaths, "runtimeDir") ??
-        DEFAULT_RUNTIME_STATE_DIR);
+    const runtimeDir = resolveEnvironmentRuntimeDirectory({
+        rootDir,
+        env,
+        config: fileConfig,
+        configPath: loadedConfig.path,
+        selection: profileSelection,
+    });
     const agentWorkDir = resolveRuntimePath(rootDir, readFirstString(env, ["LLM_RUNTIME_AGENT_WORK_DIR"]) ??
         readNestedConfigString(profileSelection.profilePaths, "agentWorkDir") ??
         readNestedConfigString(basePaths, "agentWorkDir") ??

package/dist/src/runtime/context/scheduled-execution-context.d.ts

@@ -0,0 +1,10 @@
+import type { ChatMessage } from "../../model-gateway/types.js";
+import type { RequestExecutionSeed } from "../request/contracts.js";
+export declare const SCHEDULED_EXECUTION_CONTEXT_KIND: "runtime_scheduled_execution_v1";
+type ScheduledExecutionPhase = "decision" | "response";
+export declare function projectScheduledExecutionContext(request: Pick<RequestExecutionSeed, "requestId" | "scheduledExecution">, instructions: string, phase: ScheduledExecutionPhase): Readonly<{
+    instructions: string;
+    referenceMessages: readonly ChatMessage[];
+}>;
+export declare function isScheduledExecutionContextMessage(message: ChatMessage): boolean;
+export {};

package/dist/src/runtime/context/scheduled-execution-context.js

@@ -0,0 +1,52 @@
+export const SCHEDULED_EXECUTION_CONTEXT_KIND = "runtime_scheduled_execution_v1";
+const SCHEDULED_EXECUTION_CONTEXT_POLICY = [
+    "runtime_scheduled_execution_v1 is trusted request-local state from the runtime scheduler, bound to this request and Job run. The current user message contains the saved task to execute now.",
+    "This Job run has already been triggered; do not reinterpret its saved task as a new request to create or configure this schedule.",
+    "Preserve who performs the requested action: a reminder asks you to notify the user; a task delegated to you asks you to perform the assigned work. Execution origin does not change the saved task or its actor.",
+    "This state does not add user intent, grant additional authorization, or establish completion. It is not a user fact or a memory candidate.",
+].join("\n");
+const SCHEDULED_EXECUTION_PHASE_POLICY = Object.freeze({
+    decision: "Choose the action needed for this current run under the saved task and existing authority; the origin does not select a capability or require an external action for a reminder notification.",
+    response: "Present the requested outcome of this current run, preserving the task's actor. Do not claim you were asked to perform an action that the saved task asks the user to perform.",
+});
+export function projectScheduledExecutionContext(request, instructions, phase) {
+    const reference = request.scheduledExecution;
+    if (!hasScheduledExecutionOrigin(reference)) {
+        return Object.freeze({
+            instructions,
+            referenceMessages: Object.freeze([]),
+        });
+    }
+    const capsule = Object.freeze({
+        kind: SCHEDULED_EXECUTION_CONTEXT_KIND,
+        authority: "runtime_scheduler",
+        purpose: "execute_saved_task_for_current_run",
+        requestId: request.requestId,
+        jobId: reference.jobId,
+        runId: reference.runId,
+        scheduledAt: reference.scheduledAt,
+        triggerType: reference.triggerType,
+        presenceEffect: "execution_origin_only_not_new_intent_authorization_or_completion",
+    });
+    return Object.freeze({
+        instructions: [
+            instructions,
+            SCHEDULED_EXECUTION_CONTEXT_POLICY,
+            SCHEDULED_EXECUTION_PHASE_POLICY[phase],
+        ].join("\n\n"),
+        referenceMessages: Object.freeze([
+            Object.freeze({
+                role: "system",
+                content: JSON.stringify(capsule),
+            }),
+        ]),
+    });
+}
+function hasScheduledExecutionOrigin(reference) {
+    return reference !== undefined;
+}
+export function isScheduledExecutionContextMessage(message) {
+    if (message.role !== "system")
+        return false;
+    return message.content.startsWith(`{"kind":${JSON.stringify(SCHEDULED_EXECUTION_CONTEXT_KIND)},`);
+}

package/dist/src/runtime/default-adapters.d.ts

@@ -1,32 +1,3 @@
-import { type RuntimeAttachmentStore } from "./attachments/store.js";
-import type { ConversationContextProvider, EventSink, EventSinkFactory, ModelGatewayClient, RuntimeConfig, RuntimeHost, SessionStore, SkillProvider, ToolRegistry, WorkspaceProvider } from "./ports.js";
-import type { RuntimeEnvironmentServices, RuntimeRequestHandler } from "./composition.js";
-import { type LongTermMemoryService } from "./long-term-memory/index.js";
-export declare function createDefaultRuntimeHost(config?: RuntimeConfig, defaults?: DefaultRuntimeHostBindings): RuntimeHost;
-export type DefaultRuntimeHostBindings = Readonly<{
-    runtimeId?: string;
-    agentBridgeUrl?: string;
-    agentBridgeToken?: string;
-    eventSinkFactory?: EventSinkFactory;
-    modelGatewayClient?: ModelGatewayClient;
-    sessionStore?: SessionStore;
-    attachmentStore?: RuntimeAttachmentStore;
-    toolRegistry?: ToolRegistry;
-    longTermMemoryService?: LongTermMemoryService;
-    services?: RuntimeEnvironmentServices;
-    requestHandler?: RuntimeRequestHandler;
-    requestHandlerFactory?: (services: RuntimeEnvironmentServices) => RuntimeRequestHandler;
-}>;
-export declare function createBoundRuntimeRequestHandler(services: RuntimeEnvironmentServices): RuntimeRequestHandler;
-export declare function createDefaultAttachmentStore(config: RuntimeConfig): RuntimeAttachmentStore;
-export declare function createDefaultSessionStore(config?: RuntimeConfig): SessionStore;
-export declare function createDefaultConversationContextProvider(): ConversationContextProvider;
-export declare function createDefaultToolRegistry(config?: RuntimeConfig): ToolRegistry;
-export declare function createDefaultSkillProvider(config?: RuntimeConfig, options?: {
-    toolRegistry?: Pick<ToolRegistry, "listDefinitions">;
-}): SkillProvider;
-export declare function createDefaultWorkspaceProvider(config?: RuntimeConfig): WorkspaceProvider;
-export declare function createDefaultModelGatewayClient(config?: RuntimeConfig): ModelGatewayClient;
-export declare function createDefaultLongTermMemoryService(config: RuntimeConfig | undefined, models: ModelGatewayClient): LongTermMemoryService;
-export declare function createDefaultEventSinkFactory(config?: RuntimeConfig): EventSinkFactory;
-export declare function createNoopEventSink(): EventSink;
+export { createDefaultAttachmentStore, createDefaultConversationContextProvider, createDefaultEventSinkFactory, createDefaultLongTermMemoryService, createDefaultModelGatewayClient, createDefaultSessionStore, createDefaultSkillProvider, createDefaultToolRegistry, createDefaultWorkspaceProvider, createNoopEventSink, } from "./default-environment-adapters.js";
+export { createDefaultRuntimeHost, type DefaultRuntimeHostBindings, } from "./runtime-host.js";
+export { createBoundRuntimeRequestHandler } from "./request/bound-runtime-handler.js";

package/dist/src/runtime/default-adapters.js

@@ -1,270 +1,3 @@
-import { join } from "node:path";
-import { startAgentBridge } from "../bridge/start-agent-bridge.js";
-import { buildContextBuckets, buildContextWindow } from "../sessions/index.js";
-import { createModelGatewayClient, embedModelGateway, invokeModelGateway, invokeRawModelGateway, } from "../model-gateway/client.js";
-import { MAX_MODEL_GATEWAY_EMBEDDING_BATCH_SIZE } from "../model-gateway/embeddings/constants.js";
-import { createBundledPluginSkillProvider, createConfiguredSkillProvider, } from "./adapters/configured-skill-provider.js";
-import { createFileSessionStore } from "./adapters/file-session-store.js";
-import { createFileAttachmentStore, } from "./attachments/store.js";
-import { createSourceWorkspaceProvider } from "./adapters/source-workspace-provider.js";
-import { createRuntimeEventBus } from "./events/runtime-emitter.js";
-import { configureDebugLogger } from "./observability/debug-logger.js";
-import { createConfiguredToolRegistry } from "./capabilities/configured-tool-registry.js";
-import { loadBundledRuntimePlugins, loadConfiguredRuntimePlugins, runtimePluginsToToolModules, } from "./plugins/loader.js";
-import { handleRunRequest } from "./request/handler.js";
-import { createModelSessionMemoryCompactor } from "./context/session-memory/index.js";
-import { createFileLongTermMemoryRepository } from "./adapters/long-term-memory/file-repository.js";
-import { createInMemoryLongTermMemoryRepository } from "./adapters/long-term-memory/in-memory-repository.js";
-import { createLongTermMemoryService, } from "./long-term-memory/index.js";
-export function createDefaultRuntimeHost(config, defaults = {}) {
-    return {
-        start(options = {}) {
-            const services = resolveRuntimeHostEnvironmentServices({
-                config,
-                defaults,
-                options,
-            });
-            const runtimeConfig = services?.config ?? options.runtimeConfig ?? config;
-            const defaultRuntimeConfig = defaults.services?.config ?? config;
-            const runtimeConfigIdentityChanged = runtimeConfig !== undefined && runtimeConfig !== defaultRuntimeConfig;
-            const requestHandler = services
-                ? resolveRuntimeHostRequestHandler(services, defaults)
-                : defaults.requestHandler;
-            return startAgentBridge({
-                runtimeConfig,
-                runtimeId: options.runtimeId ??
-                    (runtimeConfigIdentityChanged
-                        ? runtimeConfig.runtimeId
-                        : defaults.runtimeId),
-                token: options.agentBridgeToken ??
-                    (runtimeConfigIdentityChanged
-                        ? runtimeConfig.agentBridgeToken
-                        : defaults.agentBridgeToken),
-                url: options.agentBridgeUrl ??
-                    (runtimeConfigIdentityChanged
-                        ? runtimeConfig.agentBridgeUrl
-                        : defaults.agentBridgeUrl),
-                eventSinkFactory: services?.events ??
-                    options.eventSinkFactory ??
-                    defaults.eventSinkFactory,
-                modelGatewayClient: services?.models ??
-                    options.modelGatewayClient ??
-                    defaults.modelGatewayClient,
-                sessionStore: services?.sessions ?? options.sessionStore ?? defaults.sessionStore,
-                attachmentStore: services?.attachments ??
-                    options.attachmentStore ??
-                    defaults.attachmentStore ??
-                    (runtimeConfig
-                        ? createDefaultAttachmentStore(runtimeConfig)
-                        : undefined),
-                toolRegistry: services?.tools ??
-                    options.toolRegistry ??
-                    defaults.toolRegistry ??
-                    createDefaultToolRegistry(runtimeConfig),
-                requestHandler,
-            });
-        },
-    };
-}
-function resolveRuntimeHostEnvironmentServices(params) {
-    const bound = params.defaults.services;
-    const runtimeConfig = params.options.runtimeConfig ?? bound?.config ?? params.config;
-    if (!runtimeConfig) {
-        return undefined;
-    }
-    const mayReuseBound = bound?.config === runtimeConfig;
-    const mayUseLegacyDefaults = !bound && params.config === runtimeConfig;
-    const sessions = params.options.sessionStore ??
-        (mayReuseBound ? bound.sessions : undefined) ??
-        (mayUseLegacyDefaults ? params.defaults.sessionStore : undefined) ??
-        createDefaultSessionStore(runtimeConfig);
-    const attachments = params.options.attachmentStore ??
-        (mayReuseBound ? bound.attachments : undefined) ??
-        (mayUseLegacyDefaults ? params.defaults.attachmentStore : undefined) ??
-        createDefaultAttachmentStore(runtimeConfig);
-    const tools = params.options.toolRegistry ??
-        (mayReuseBound ? bound.tools : undefined) ??
-        (mayUseLegacyDefaults ? params.defaults.toolRegistry : undefined) ??
-        createDefaultToolRegistry(runtimeConfig);
-    const models = params.options.modelGatewayClient ??
-        (mayReuseBound ? bound.models : undefined) ??
-        (mayUseLegacyDefaults ? params.defaults.modelGatewayClient : undefined) ??
-        createDefaultModelGatewayClient(runtimeConfig);
-    const events = params.options.eventSinkFactory ??
-        (mayReuseBound ? bound.events : undefined) ??
-        (mayUseLegacyDefaults ? params.defaults.eventSinkFactory : undefined) ??
-        createDefaultEventSinkFactory(runtimeConfig);
-    const sessionMemoryCompactor = bound?.sessionMemoryCompactor ?? createModelSessionMemoryCompactor();
-    const mayReuseBoundLongTermMemory = mayReuseBound && models === bound?.models;
-    const longTermMemory = params.options.longTermMemoryService ??
-        (mayReuseBoundLongTermMemory ? bound?.longTermMemory : undefined) ??
-        createDefaultLongTermMemoryService(runtimeConfig, models);
-    const reusesAllBoundServices = mayReuseBound &&
-        sessions === bound.sessions &&
-        attachments === bound.attachments &&
-        tools === bound.tools &&
-        models === bound.models &&
-        events === bound.events &&
-        sessionMemoryCompactor === bound.sessionMemoryCompactor &&
-        longTermMemory === bound.longTermMemory;
-    if (reusesAllBoundServices) {
-        return bound;
-    }
-    return Object.freeze({
-        config: runtimeConfig,
-        sessions,
-        attachments,
-        tools,
-        models,
-        events,
-        sessionMemoryCompactor,
-        longTermMemory,
-    });
-}
-function resolveRuntimeHostRequestHandler(services, defaults) {
-    if (services === defaults.services && defaults.requestHandler) {
-        return defaults.requestHandler;
-    }
-    return (defaults.requestHandlerFactory ?? createBoundRuntimeRequestHandler)(services);
-}
-export function createBoundRuntimeRequestHandler(services) {
-    const environmentOptions = {
-        runtimeConfig: services.config,
-        eventSinkFactory: services.events,
-        modelGatewayClient: services.models,
-        sessionStore: services.sessions,
-        attachmentStore: services.attachments,
-        toolRegistry: services.tools,
-        sessionMemoryCompactor: services.sessionMemoryCompactor,
-        longTermMemory: services.longTermMemory,
-    };
-    return Object.freeze({
-        handle(ws, message, requestOptions = {}) {
-            return handleRunRequest(ws, message, {
-                ...environmentOptions,
-                ...requestOptions,
-            });
-        },
-    });
-}
-export function createDefaultAttachmentStore(config) {
-    return createFileAttachmentStore({
-        attachmentsDir: config.paths.attachmentsDir,
-    });
-}
-export function createDefaultSessionStore(config) {
-    return createFileSessionStore(config ? { sessionsDir: config.paths.sessionsDir } : {});
-}
-export function createDefaultConversationContextProvider() {
-    return {
-        buildContextBuckets,
-        buildContextWindow,
-    };
-}
-export function createDefaultToolRegistry(config) {
-    const plugins = config
-        ? loadConfiguredRuntimePlugins(config)
-        : loadBundledRuntimePlugins();
-    return createConfiguredToolRegistry(config, runtimePluginsToToolModules(plugins));
-}
-export function createDefaultSkillProvider(config, options = {}) {
-    const toolRegistry = options.toolRegistry ??
-        (config ? createDefaultToolRegistry(config) : undefined);
-    const listToolDefinitions = toolRegistry?.listDefinitions;
-    if (config) {
-        return createConfiguredSkillProvider({ config, listToolDefinitions });
-    }
-    return createBundledPluginSkillProvider({ listToolDefinitions });
-}
-export function createDefaultWorkspaceProvider(config) {
-    return createSourceWorkspaceProvider(config ? { workspaceDir: config.paths.workspaceDir } : {});
-}
-export function createDefaultModelGatewayClient(config) {
-    if (!config) {
-        return {
-            invoke: invokeModelGateway,
-            invokeRaw: invokeRawModelGateway,
-            embed: embedModelGateway,
-        };
-    }
-    return createModelGatewayClient({
-        baseUrl: config.modelGatewayUrl,
-        streamInactivityTimeoutMs: config.timeouts?.streamInactivityTimeoutMs,
-        ...(config.models ? { modelPolicy: config.models } : {}),
-    });
-}
-export function createDefaultLongTermMemoryService(config, models) {
-    const memoryConfig = config?.longTermMemory ?? {
-        enabled: false,
-        emitClientEvents: false,
-    };
-    const repository = config
-        ? createFileLongTermMemoryRepository(join(config.paths.runtimeDir, "long-term-memory"))
-        : createInMemoryLongTermMemoryRepository();
-    const embeddings = memoryConfig.enabled && config
-        ? createLongTermMemoryEmbeddingClient({ config, models })
-        : undefined;
-    return createLongTermMemoryService({
-        repository,
-        enabled: memoryConfig.enabled,
-        emitClientEvents: memoryConfig.emitClientEvents,
-        ...(embeddings ? { embeddings } : {}),
-    });
-}
-function createLongTermMemoryEmbeddingClient(params) {
-    const profileId = params.config.longTermMemory?.embeddingProfileId;
-    if (!profileId) {
-        throw new Error("long_term_memory_embedding_profile_required");
-    }
-    if (!params.models.embed) {
-        throw new Error("long_term_memory_embedding_gateway_unavailable");
-    }
-    const embed = params.models.embed;
-    return Object.freeze({
-        maxBatchSize: MAX_MODEL_GATEWAY_EMBEDDING_BATCH_SIZE,
-        async embed(input) {
-            const result = await embed({
-                profileId,
-                texts: input.texts,
-                modelPolicy: params.config.models,
-                abortSignal: input.abortSignal,
-                ...(input.debugRequestId
-                    ? { debugRequestId: input.debugRequestId }
-                    : {}),
-            });
-            return Object.freeze({
-                modelFingerprint: result.modelFingerprint,
-                dimensions: result.dimensions,
-                vectors: result.vectors,
-            });
-        },
-    });
-}
-export function createDefaultEventSinkFactory(config) {
-    if (config) {
-        configureDebugLogger({
-            traceFile: config.paths.traceFile,
-            enabled: config.logging?.enabled,
-            rotation: config.logging?.rotation,
-        });
-    }
-    return {
-        create(options) {
-            return createRuntimeEventBus(options);
-        },
-    };
-}
-export function createNoopEventSink() {
-    return {
-        publish: () => { },
-        event: () => { },
-        runtimeState: () => { },
-        token: () => { },
-        legacyToken: () => { },
-        thinkingDelta: () => { },
-        completed: () => { },
-        failed: () => { },
-        drain: async () => { },
-        dispose: () => { },
-    };
-}
+export { createDefaultAttachmentStore, createDefaultConversationContextProvider, createDefaultEventSinkFactory, createDefaultLongTermMemoryService, createDefaultModelGatewayClient, createDefaultSessionStore, createDefaultSkillProvider, createDefaultToolRegistry, createDefaultWorkspaceProvider, createNoopEventSink, } from "./default-environment-adapters.js";
+export { createDefaultRuntimeHost, } from "./runtime-host.js";
+export { createBoundRuntimeRequestHandler } from "./request/bound-runtime-handler.js";

package/dist/src/runtime/default-environment-adapters.d.ts

@@ -0,0 +1,19 @@
+import { type RuntimeAttachmentStore } from "./attachments/store.js";
+import type { ConversationContextProvider, EventSink, EventSinkFactory, ModelGatewayClient, RuntimeConfig, SessionStore, SkillProvider, ToolRegistry, WorkspaceProvider } from "./ports.js";
+import type { SchedulerService } from "./scheduler/contracts.js";
+import { type LongTermMemoryService } from "./long-term-memory/index.js";
+export declare function createDefaultAttachmentStore(config: RuntimeConfig): RuntimeAttachmentStore;
+export declare function createDefaultSessionStore(config?: RuntimeConfig): SessionStore;
+export declare function createDefaultConversationContextProvider(): ConversationContextProvider;
+export declare function createDefaultToolRegistry(config?: RuntimeConfig, scheduling?: {
+    service: SchedulerService;
+    ready: () => Promise<void>;
+}): ToolRegistry;
+export declare function createDefaultSkillProvider(config?: RuntimeConfig, options?: {
+    toolRegistry?: Pick<ToolRegistry, "listDefinitions">;
+}): SkillProvider;
+export declare function createDefaultWorkspaceProvider(config?: RuntimeConfig): WorkspaceProvider;
+export declare function createDefaultModelGatewayClient(config?: RuntimeConfig): ModelGatewayClient;
+export declare function createDefaultLongTermMemoryService(config: RuntimeConfig | undefined, models: ModelGatewayClient): LongTermMemoryService;
+export declare function createDefaultEventSinkFactory(config?: RuntimeConfig): EventSinkFactory;
+export declare function createNoopEventSink(): EventSink;

package/dist/src/runtime/default-environment-adapters.js

@@ -0,0 +1,144 @@
+import { join } from "node:path";
+import { buildContextBuckets, buildContextWindow } from "../sessions/index.js";
+import { createModelGatewayClient, embedModelGateway, invokeModelGateway, invokeRawModelGateway, } from "../model-gateway/client.js";
+import { MAX_MODEL_GATEWAY_EMBEDDING_BATCH_SIZE } from "../model-gateway/embeddings/constants.js";
+import { createBundledPluginSkillProvider, createConfiguredSkillProvider, } from "./adapters/configured-skill-provider.js";
+import { createFileSessionStore } from "./adapters/file-session-store.js";
+import { createFileAttachmentStore, } from "./attachments/store.js";
+import { createSourceWorkspaceProvider } from "./adapters/source-workspace-provider.js";
+import { createRuntimeEventBus } from "./events/runtime-emitter.js";
+import { configureDebugLogger } from "./observability/debug-logger.js";
+import { createConfiguredToolRegistry } from "./capabilities/configured-tool-registry.js";
+import { loadBundledRuntimePlugins, loadConfiguredRuntimePlugins, runtimePluginsToToolModules, } from "./plugins/loader.js";
+import { createSchedulingToolModule } from "./capabilities/scheduling/tool-module.js";
+import { createFileLongTermMemoryRepository } from "./adapters/long-term-memory/file-repository.js";
+import { createInMemoryLongTermMemoryRepository } from "./adapters/long-term-memory/in-memory-repository.js";
+import { createLongTermMemoryService, } from "./long-term-memory/index.js";
+export function createDefaultAttachmentStore(config) {
+    return createFileAttachmentStore({
+        attachmentsDir: config.paths.attachmentsDir,
+    });
+}
+export function createDefaultSessionStore(config) {
+    return createFileSessionStore(config ? { sessionsDir: config.paths.sessionsDir } : {});
+}
+export function createDefaultConversationContextProvider() {
+    return {
+        buildContextBuckets,
+        buildContextWindow,
+    };
+}
+export function createDefaultToolRegistry(config, scheduling) {
+    const plugins = config
+        ? loadConfiguredRuntimePlugins(config)
+        : loadBundledRuntimePlugins();
+    return createConfiguredToolRegistry(config, [
+        ...runtimePluginsToToolModules(plugins),
+        ...(config && scheduling
+            ? [
+                createSchedulingToolModule(scheduling.service, config, scheduling.ready),
+            ]
+            : []),
+    ]);
+}
+export function createDefaultSkillProvider(config, options = {}) {
+    const toolRegistry = options.toolRegistry ??
+        (config ? createDefaultToolRegistry(config) : undefined);
+    const listToolDefinitions = toolRegistry?.listDefinitions;
+    if (config) {
+        return createConfiguredSkillProvider({ config, listToolDefinitions });
+    }
+    return createBundledPluginSkillProvider({ listToolDefinitions });
+}
+export function createDefaultWorkspaceProvider(config) {
+    return createSourceWorkspaceProvider(config ? { workspaceDir: config.paths.workspaceDir } : {});
+}
+export function createDefaultModelGatewayClient(config) {
+    if (!config) {
+        return {
+            invoke: invokeModelGateway,
+            invokeRaw: invokeRawModelGateway,
+            embed: embedModelGateway,
+        };
+    }
+    return createModelGatewayClient({
+        baseUrl: config.modelGatewayUrl,
+        streamInactivityTimeoutMs: config.timeouts?.streamInactivityTimeoutMs,
+        ...(config.models ? { modelPolicy: config.models } : {}),
+    });
+}
+export function createDefaultLongTermMemoryService(config, models) {
+    const memoryConfig = config?.longTermMemory ?? {
+        enabled: false,
+        emitClientEvents: false,
+    };
+    const repository = config
+        ? createFileLongTermMemoryRepository(join(config.paths.runtimeDir, "long-term-memory"))
+        : createInMemoryLongTermMemoryRepository();
+    const embeddings = memoryConfig.enabled && config
+        ? createLongTermMemoryEmbeddingClient({ config, models })
+        : undefined;
+    return createLongTermMemoryService({
+        repository,
+        enabled: memoryConfig.enabled,
+        emitClientEvents: memoryConfig.emitClientEvents,
+        ...(embeddings ? { embeddings } : {}),
+    });
+}
+function createLongTermMemoryEmbeddingClient(params) {
+    const profileId = params.config.longTermMemory?.embeddingProfileId;
+    if (!profileId) {
+        throw new Error("long_term_memory_embedding_profile_required");
+    }
+    if (!params.models.embed) {
+        throw new Error("long_term_memory_embedding_gateway_unavailable");
+    }
+    const embed = params.models.embed;
+    return Object.freeze({
+        maxBatchSize: MAX_MODEL_GATEWAY_EMBEDDING_BATCH_SIZE,
+        async embed(input) {
+            const result = await embed({
+                profileId,
+                texts: input.texts,
+                modelPolicy: params.config.models,
+                abortSignal: input.abortSignal,
+                ...(input.debugRequestId
+                    ? { debugRequestId: input.debugRequestId }
+                    : {}),
+            });
+            return Object.freeze({
+                modelFingerprint: result.modelFingerprint,
+                dimensions: result.dimensions,
+                vectors: result.vectors,
+            });
+        },
+    });
+}
+export function createDefaultEventSinkFactory(config) {
+    if (config) {
+        configureDebugLogger({
+            traceFile: config.paths.traceFile,
+            enabled: config.logging?.enabled,
+            rotation: config.logging?.rotation,
+        });
+    }
+    return {
+        create(options) {
+            return createRuntimeEventBus(options);
+        },
+    };
+}
+export function createNoopEventSink() {
+    return {
+        publish: () => { },
+        event: () => { },
+        runtimeState: () => { },
+        token: () => { },
+        legacyToken: () => { },
+        thinkingDelta: () => { },
+        completed: () => { },
+        failed: () => { },
+        drain: async () => { },
+        dispose: () => { },
+    };
+}

package/dist/src/runtime/index.d.ts

@@ -10,4 +10,9 @@ export * from "./adapters/multi-workspace-provider.js";
 export * from "./adapters/source-workspace-provider.js";
 export * from "./attachments/store.js";
 export * from "./long-term-memory/index.js";
+export * from "./scheduler/contracts.js";
+export * from "./scheduler/scheduler-service.js";
+export * from "./scheduler/file-store.js";
 export * from "./observability/debug-logger.js";
+export { createLocalRuntimeApplication } from "./local-application.js";
+export type { LocalRuntimeApplication, LocalRuntimeApplicationOptions, } from "./local-application.js";

package/dist/src/runtime/index.js

@@ -10,4 +10,8 @@ export * from "./adapters/multi-workspace-provider.js";
 export * from "./adapters/source-workspace-provider.js";
 export * from "./attachments/store.js";
 export * from "./long-term-memory/index.js";
+export * from "./scheduler/contracts.js";
+export * from "./scheduler/scheduler-service.js";
+export * from "./scheduler/file-store.js";
 export * from "./observability/debug-logger.js";
+export { createLocalRuntimeApplication } from "./local-application.js";

package/dist/src/runtime/local-application.d.ts

@@ -0,0 +1,22 @@
+import type { RuntimeConfig } from "./ports.js";
+import type { RuntimeRequestHandler, RuntimeRequestOptions } from "./composition.js";
+import type { SchedulerRun } from "./scheduler/contracts.js";
+export type LocalRuntimeApplicationOptions = Readonly<{
+    scheduledRequestOptions?: (run: SchedulerRun) => RuntimeRequestOptions;
+}>;
+/** Managed library entry: attach to the environment owner or create it once. */
+export declare function createLocalRuntimeApplication(config?: RuntimeConfig, options?: LocalRuntimeApplicationOptions): Readonly<{
+    services: Readonly<{
+        longTermMemory: import("./index.js").LongTermMemoryService;
+        sessions: import("./ports.js").SessionStore;
+        attachments: import("./index.js").RuntimeAttachmentStore;
+        scheduler: Omit<import("./scheduler/contracts.js").SchedulerService, "stop" | "start">;
+        config: RuntimeConfig;
+    }>;
+    requests: RuntimeRequestHandler;
+    start: () => Promise<void>;
+    stop(): Promise<void>;
+    getOwnership: () => "owner" | "client" | undefined;
+    subscribeScheduledEvents: (listener: (event: Record<string, unknown>) => void) => () => void;
+}>;
+export type LocalRuntimeApplication = ReturnType<typeof createLocalRuntimeApplication>;