@abot-ai/runtime 1.2.0 → 1.3.0

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>;

package/dist/src/runtime/local-application.js

@@ -0,0 +1,81 @@
+import { join } from "node:path";
+import { loadRuntimeConfig } from "./config.js";
+import { createLocalRuntimeConnection } from "./local-host/transport.js";
+import { resolveLocalRuntimeIdentity } from "./local-host/client-identity.js";
+import { createLocalRuntimeOwner } from "./local-host/app-owner.js";
+import { LocalRuntimeClientRequests } from "./local-host/client-requests.js";
+import { createLocalMemoryClient } from "./local-host/client-memory.js";
+import { createLocalServiceClients } from "./local-host/client-services.js";
+/** Managed library entry: attach to the environment owner or create it once. */
+export function createLocalRuntimeApplication(config = loadRuntimeConfig(), options = {}) {
+    let connection;
+    let startup;
+    let stopped = false;
+    const call = async (method, args) => {
+        await start();
+        return connection.call(method, args);
+    };
+    const client = new LocalRuntimeClientRequests(call, options.scheduledRequestOptions);
+    const memory = createLocalMemoryClient(call, config.longTermMemory?.enabled === true);
+    const services = Object.freeze({
+        config,
+        ...createLocalServiceClients(call),
+        longTermMemory: memory.service,
+    });
+    async function connect() {
+        const current = await createLocalRuntimeConnection({
+            directory: join(config.paths.runtimeDir, "local-host"),
+            identity: resolveLocalRuntimeIdentity(config),
+            createOwner: () => createLocalRuntimeOwner(config),
+        });
+        connection = current;
+        try {
+            current.onClose(() => client.close(true));
+            current.setClientHandler(async (method, args) => {
+                if (method === "memory.event") {
+                    memory.handleEvent(args);
+                    return null;
+                }
+                return client.handleCallback(method, args);
+            });
+            current.subscribe((event) => client.receive(event));
+            if (options.scheduledRequestOptions) {
+                await current.call("controls.register", []);
+            }
+        }
+        catch (error) {
+            await current.close();
+            throw error;
+        }
+    }
+    function start() {
+        if (stopped)
+            return Promise.reject(new Error("local_runtime_stopped"));
+        startup ??= connect().catch(clearFailedInitialStartup);
+        return startup;
+    }
+    function clearFailedInitialStartup(error) {
+        // A later explicit call may reconnect only if no transport was established.
+        // Established connection loss or uncertain RPC work must never be replayed.
+        if (!connection)
+            startup = undefined;
+        throw error;
+    }
+    return Object.freeze({
+        services,
+        requests: client.requests,
+        start,
+        async stop() {
+            stopped = true;
+            try {
+                await startup;
+            }
+            finally {
+                client.close();
+                await connection?.close();
+            }
+        },
+        getOwnership: () => connection?.ownership,
+        subscribeScheduledEvents: client.subscribe.bind(client),
+    });
+}

package/dist/src/runtime/local-host/app-memory-dispatch.d.ts

@@ -0,0 +1,11 @@
+import type { LongTermMemoryService } from "../long-term-memory/contracts.js";
+import type { LocalRuntimePeer } from "./contracts.js";
+export declare class LocalMemoryDispatcher {
+    private readonly memory;
+    private readonly active;
+    constructor(memory: LongTermMemoryService);
+    call(method: string, args: readonly unknown[], peer: LocalRuntimePeer): Promise<unknown>;
+    stop(): void;
+    private cancel;
+    private bindContext;
+}