@tschmz/imp 0.1.0

package/dist/config/secret-value.js

@@ -0,0 +1,69 @@
+import { readFile } from "node:fs/promises";
+import { isAbsolute, resolve } from "node:path";
+import { z } from "zod";
+const environmentVariableNamePattern = /^[A-Z_][A-Z0-9_]*$/i;
+const secretReferenceSchema = z
+    .object({
+    env: z.string().min(1).regex(environmentVariableNamePattern, {
+        message: "Environment variable names must match /^[A-Z_][A-Z0-9_]*$/i.",
+    }).optional(),
+    file: z.string().min(1).optional(),
+})
+    .strict()
+    .superRefine((value, ctx) => {
+    const hasEnv = typeof value.env === "string";
+    const hasFile = typeof value.file === "string";
+    if (hasEnv === hasFile) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "Specify exactly one of env or file.",
+        });
+    }
+});
+export const secretValueConfigSchema = z.union([z.string().min(1), secretReferenceSchema]);
+export async function resolveSecretValue(value, options) {
+    if (typeof value === "string") {
+        return value;
+    }
+    if ("env" in value && value.env) {
+        const resolvedValue = (options.env ?? process.env)[value.env];
+        if (typeof resolvedValue !== "string" || resolvedValue.length === 0) {
+            throw new Error(`${options.fieldLabel} references environment variable ${value.env}, but it is not set.`);
+        }
+        return resolvedValue;
+    }
+    if (!("file" in value) || !value.file) {
+        throw new Error(`${options.fieldLabel} secret reference is invalid.`);
+    }
+    const secretPath = resolveConfigPath(value.file, options.configDir);
+    const readTextFile = options.readTextFile ?? defaultReadTextFile;
+    let rawSecret;
+    try {
+        rawSecret = await readTextFile(secretPath);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`${options.fieldLabel} references secret file ${secretPath}, but it could not be read: ${message}`);
+    }
+    const normalizedSecret = stripSingleTrailingLineEnding(rawSecret);
+    if (normalizedSecret.length === 0) {
+        throw new Error(`${options.fieldLabel} references secret file ${secretPath}, but it is empty.`);
+    }
+    return normalizedSecret;
+}
+export function resolveConfigPath(path, configDir) {
+    return isAbsolute(path) ? path : resolve(configDir, path);
+}
+async function defaultReadTextFile(path) {
+    return readFile(path, "utf8");
+}
+function stripSingleTrailingLineEnding(value) {
+    if (value.endsWith("\r\n")) {
+        return value.slice(0, -2);
+    }
+    if (value.endsWith("\n")) {
+        return value.slice(0, -1);
+    }
+    return value;
+}
+//# sourceMappingURL=secret-value.js.map

package/dist/config/secret-value.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"secret-value.js","sourceRoot":"","sources":["../../src/config/secret-value.ts"],"names":[],"mappings":"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"}

package/dist/config/types.d.ts

@@ -0,0 +1,76 @@
+import type { AgentMcpConfig, AgentWorkspaceConfig, InferenceSettings, ModelRef, PromptSource } from "../domain/agent.js";
+import type { LogLevel } from "../logging/types.js";
+import type { SecretValueConfig } from "./secret-value.js";
+export interface InstanceConfig {
+    name: string;
+}
+export interface PathsConfig {
+    dataRoot: string;
+}
+export interface LoggingConfig {
+    level: LogLevel;
+}
+export interface DefaultsConfig {
+    agentId: string;
+}
+export type ModelConfig = ModelRef;
+export interface AgentToolsConfigObject {
+    builtIn?: string[];
+    mcp?: AgentMcpConfig;
+}
+export type AgentToolsConfig = string[] | AgentToolsConfigObject;
+export interface AgentSkillsConfig {
+    paths: string[];
+}
+export interface AgentPromptConfigInput {
+    base?: PromptSource;
+    instructions?: PromptSource[];
+    references?: PromptSource[];
+}
+export interface AgentConfig {
+    id: string;
+    name?: string;
+    prompt?: AgentPromptConfigInput;
+    model?: ModelConfig;
+    authFile?: string;
+    inference?: InferenceSettings;
+    workspace?: AgentWorkspaceConfig;
+    tools?: AgentToolsConfig;
+    skills?: AgentSkillsConfig;
+}
+interface BaseEndpointConfig {
+    id: string;
+    enabled: boolean;
+    routing?: EndpointRoutingConfig;
+}
+export interface TelegramEndpointConfig extends BaseEndpointConfig {
+    type: "telegram";
+    token: SecretValueConfig;
+    access: TelegramAccessConfig;
+    voice?: TelegramVoiceConfig;
+}
+export type EndpointConfig = TelegramEndpointConfig;
+export interface TelegramAccessConfig {
+    allowedUserIds: string[];
+}
+export interface TelegramVoiceConfig {
+    enabled: boolean;
+    transcription: TelegramTranscriptionConfig;
+}
+export interface TelegramTranscriptionConfig {
+    provider: "openai";
+    model: string;
+    language?: string;
+}
+export interface EndpointRoutingConfig {
+    defaultAgentId?: string;
+}
+export interface AppConfig {
+    instance: InstanceConfig;
+    paths: PathsConfig;
+    logging?: LoggingConfig;
+    defaults: DefaultsConfig;
+    agents: AgentConfig[];
+    endpoints: EndpointConfig[];
+}
+export {};

package/dist/config/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/config/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/config/types.ts"],"names":[],"mappings":""}

package/dist/config/validate-secret-references.d.ts

@@ -0,0 +1,7 @@
+import type { AppConfig } from "./types.js";
+interface ValidateSecretReferencesOptions {
+    env?: NodeJS.ProcessEnv;
+    readTextFile?: (path: string) => Promise<string>;
+}
+export declare function validateAppConfigSecretReferences(appConfig: AppConfig, configPath: string, options?: ValidateSecretReferencesOptions): Promise<void>;
+export {};

package/dist/config/validate-secret-references.js

@@ -0,0 +1,14 @@
+import { dirname } from "node:path";
+import { resolveSecretValue } from "./secret-value.js";
+export async function validateAppConfigSecretReferences(appConfig, configPath, options = {}) {
+    const configDir = dirname(configPath);
+    await Promise.all(appConfig.endpoints.map(async (endpoint, index) => {
+        await resolveSecretValue(endpoint.token, {
+            configDir,
+            env: options.env,
+            readTextFile: options.readTextFile,
+            fieldLabel: `endpoints.${index}.token`,
+        });
+    }));
+}
+//# sourceMappingURL=validate-secret-references.js.map

package/dist/config/validate-secret-references.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-secret-references.js","sourceRoot":"","sources":["../../src/config/validate-secret-references.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAQvD,MAAM,CAAC,KAAK,UAAU,iCAAiC,CACrD,SAAoB,EACpB,UAAkB,EAClB,UAA2C,EAAE;IAE7C,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAEtC,MAAM,OAAO,CAAC,GAAG,CACf,SAAS,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE;QAChD,MAAM,kBAAkB,CAAC,QAAQ,CAAC,KAAK,EAAE;YACvC,SAAS;YACT,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,YAAY,EAAE,OAAO,CAAC,YAAY;YAClC,UAAU,EAAE,aAAa,KAAK,QAAQ;SACvC,CAAC,CAAC;IACL,CAAC,CAAC,CACH,CAAC;AACJ,CAAC"}

package/dist/daemon/bootstrap/acquire-runtime-state.d.ts

@@ -0,0 +1,6 @@
+import type { ActiveEndpointRuntimeConfig, DaemonConfig } from "../types.js";
+export interface PreparedRuntime {
+    stateAcquired: boolean;
+}
+export declare function acquireRuntimeState(config: DaemonConfig, endpointConfig: ActiveEndpointRuntimeConfig): Promise<PreparedRuntime>;
+export declare function cleanupPreparedRuntime(prepared: PreparedRuntime, endpointConfig: ActiveEndpointRuntimeConfig): Promise<void>;

package/dist/daemon/bootstrap/acquire-runtime-state.js

@@ -0,0 +1,19 @@
+import { cleanupRuntimeState, assertNoRunningInstance, writeRuntimeState } from "../runtime-state.js";
+export async function acquireRuntimeState(config, endpointConfig) {
+    await assertNoRunningInstance(endpointConfig.paths.runtimeStatePath);
+    await writeRuntimeState(endpointConfig.paths.runtimeStatePath, {
+        pid: process.pid,
+        endpointId: endpointConfig.id,
+        startedAt: new Date().toISOString(),
+        configPath: config.configPath,
+        logFilePath: endpointConfig.paths.logFilePath,
+    });
+    return { stateAcquired: true };
+}
+export async function cleanupPreparedRuntime(prepared, endpointConfig) {
+    if (!prepared.stateAcquired) {
+        return;
+    }
+    await cleanupRuntimeState(endpointConfig.paths.runtimeStatePath);
+}
+//# sourceMappingURL=acquire-runtime-state.js.map

package/dist/daemon/bootstrap/acquire-runtime-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"acquire-runtime-state.js","sourceRoot":"","sources":["../../../src/daemon/bootstrap/acquire-runtime-state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAOtG,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,MAAoB,EACpB,cAA2C;IAE3C,MAAM,uBAAuB,CAAC,cAAc,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;IACrE,MAAM,iBAAiB,CAAC,cAAc,CAAC,KAAK,CAAC,gBAAgB,EAAE;QAC7D,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,UAAU,EAAE,cAAc,CAAC,EAAE;QAC7B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,WAAW,EAAE,cAAc,CAAC,KAAK,CAAC,WAAW;KAC9C,CAAC,CAAC;IAEH,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;AACjC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,QAAyB,EACzB,cAA2C;IAE3C,IAAI,CAAC,QAAQ,CAAC,aAAa,EAAE,CAAC;QAC5B,OAAO;IACT,CAAC;IAED,MAAM,mBAAmB,CAAC,cAAc,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;AACnE,CAAC"}

package/dist/daemon/bootstrap/build-runtime-components.d.ts

@@ -0,0 +1,21 @@
+import type { AgentDefinition } from "../../domain/agent.js";
+import type { LogLevel, Logger } from "../../logging/types.js";
+import { type WorkingDirectoryState } from "../../runtime/create-pi-agent-engine.js";
+import type { AgentEngine } from "../../runtime/types.js";
+import type { ConversationStore } from "../../storage/types.js";
+import type { ToolRegistry } from "../../tools/registry.js";
+import type { ActiveEndpointRuntimeConfig, DaemonConfig, RuntimePaths } from "../types.js";
+export interface RuntimeComponents {
+    loggingLevel: LogLevel;
+    logger: Logger;
+    conversationStore: ConversationStore;
+    engine: AgentEngine;
+}
+export interface BuildRuntimeComponentsDependencies {
+    engine?: AgentEngine;
+    toolRegistry?: ToolRegistry;
+    createBuiltInToolRegistry?: (workingDirectory: string | WorkingDirectoryState, agent?: AgentDefinition) => ToolRegistry;
+    createLogger?: (path: string, level: DaemonConfig["logging"]["level"]) => Logger;
+    createConversationStore?: (paths: RuntimePaths) => ConversationStore;
+}
+export declare function buildRuntimeComponents(config: DaemonConfig, endpointConfig: ActiveEndpointRuntimeConfig, dependencies?: BuildRuntimeComponentsDependencies): RuntimeComponents;

package/dist/daemon/bootstrap/build-runtime-components.js

@@ -0,0 +1,26 @@
+import { createFileLogger } from "../../logging/file-logger.js";
+import { createBuiltInToolRegistry, createPiAgentEngine, } from "../../runtime/create-pi-agent-engine.js";
+import { createOAuthApiKeyResolver } from "../../runtime/create-oauth-api-key-resolver.js";
+import { createFsConversationStore } from "../../storage/fs-store.js";
+export function buildRuntimeComponents(config, endpointConfig, dependencies = {}) {
+    const createLogger = dependencies.createLogger ?? createFileLogger;
+    const createConversationStore = dependencies.createConversationStore ?? createFsConversationStore;
+    const createBuiltInRegistry = dependencies.createBuiltInToolRegistry ?? createBuiltInToolRegistry;
+    const logger = createLogger(endpointConfig.paths.logFilePath, config.logging.level);
+    const conversationStore = createConversationStore(endpointConfig.paths);
+    const getApiKey = async (provider, agent) => createOAuthApiKeyResolver(agent.authFile, logger)(provider);
+    const engine = dependencies.engine ??
+        createPiAgentEngine({
+            logger,
+            getApiKey,
+            ...(dependencies.toolRegistry ? { toolRegistry: dependencies.toolRegistry } : {}),
+            createBuiltInToolRegistry: createBuiltInRegistry,
+        });
+    return {
+        loggingLevel: config.logging.level,
+        logger,
+        conversationStore,
+        engine,
+    };
+}
+//# sourceMappingURL=build-runtime-components.js.map

package/dist/daemon/bootstrap/build-runtime-components.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-runtime-components.js","sourceRoot":"","sources":["../../../src/daemon/bootstrap/build-runtime-components.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAEhE,OAAO,EACL,yBAAyB,EAEzB,mBAAmB,GACpB,MAAM,yCAAyC,CAAC;AACjD,OAAO,EAAE,yBAAyB,EAAE,MAAM,gDAAgD,CAAC;AAE3F,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AAuBtE,MAAM,UAAU,sBAAsB,CACpC,MAAoB,EACpB,cAA2C,EAC3C,eAAmD,EAAE;IAErD,MAAM,YAAY,GAAG,YAAY,CAAC,YAAY,IAAI,gBAAgB,CAAC;IACnE,MAAM,uBAAuB,GAC3B,YAAY,CAAC,uBAAuB,IAAI,yBAAyB,CAAC;IACpE,MAAM,qBAAqB,GACzB,YAAY,CAAC,yBAAyB,IAAI,yBAAyB,CAAC;IAEtE,MAAM,MAAM,GAAG,YAAY,CAAC,cAAc,CAAC,KAAK,CAAC,WAAW,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACpF,MAAM,iBAAiB,GAAG,uBAAuB,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;IAExE,MAAM,SAAS,GAAG,KAAK,EAAE,QAAgB,EAAE,KAAsB,EAAE,EAAE,CACnE,yBAAyB,CAAC,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,CAAC;IAC9D,MAAM,MAAM,GACV,YAAY,CAAC,MAAM;QACnB,mBAAmB,CAAC;YAClB,MAAM;YACN,SAAS;YACT,GAAG,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,YAAY,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACjF,yBAAyB,EAAE,qBAAqB;SACjD,CAAC,CAAC;IACL,OAAO;QACL,YAAY,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK;QAClC,MAAM;QACN,iBAAiB;QACjB,MAAM;KACP,CAAC;AACJ,CAAC"}

package/dist/daemon/bootstrap/prepare-runtime-filesystem.d.ts

@@ -0,0 +1,2 @@
+import type { RuntimePaths } from "../types.js";
+export declare function prepareRuntimeFilesystem(paths: RuntimePaths): Promise<void>;

package/dist/daemon/bootstrap/prepare-runtime-filesystem.js

@@ -0,0 +1,11 @@
+import { mkdir } from "node:fs/promises";
+import { rotateLogFileOnStartup } from "../../logging/file-logger.js";
+export async function prepareRuntimeFilesystem(paths) {
+    await mkdir(paths.dataRoot, { recursive: true });
+    await mkdir(paths.endpointRoot, { recursive: true });
+    await mkdir(paths.conversationsDir, { recursive: true });
+    await mkdir(paths.logsDir, { recursive: true });
+    await mkdir(paths.runtimeDir, { recursive: true });
+    await rotateLogFileOnStartup(paths.logFilePath);
+}
+//# sourceMappingURL=prepare-runtime-filesystem.js.map

package/dist/daemon/bootstrap/prepare-runtime-filesystem.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prepare-runtime-filesystem.js","sourceRoot":"","sources":["../../../src/daemon/bootstrap/prepare-runtime-filesystem.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AAGtE,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAAC,KAAmB;IAChE,MAAM,KAAK,CAAC,KAAK,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACjD,MAAM,KAAK,CAAC,KAAK,CAAC,YAAY,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACrD,MAAM,KAAK,CAAC,KAAK,CAAC,gBAAgB,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACzD,MAAM,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAChD,MAAM,KAAK,CAAC,KAAK,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACnD,MAAM,sBAAsB,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;AAClD,CAAC"}

package/dist/daemon/create-daemon.d.ts

@@ -0,0 +1,13 @@
+import { createAgentRegistry } from "../agents/registry.js";
+import type { Logger } from "../logging/types.js";
+import type { TransportFactory } from "../transports/types.js";
+import { type RuntimeBootstrapDependencies } from "./runtime-bootstrap.js";
+import { type RuntimeLifecycleProcess } from "./runtime-shutdown.js";
+import type { ActiveEndpointRuntimeConfig, Daemon, DaemonConfig } from "./types.js";
+interface DaemonDependencies extends RuntimeBootstrapDependencies {
+    agentRegistry?: ReturnType<typeof createAgentRegistry>;
+    createTransport: TransportFactory<ActiveEndpointRuntimeConfig, Logger>;
+    runtimeProcess?: RuntimeLifecycleProcess;
+}
+export declare function createDaemon(config: DaemonConfig, dependencies: DaemonDependencies): Daemon;
+export {};

package/dist/daemon/create-daemon.js

@@ -0,0 +1,98 @@
+import { createAgentRegistry } from "../agents/registry.js";
+import { ConfigurationError } from "../domain/errors.js";
+import { createBuiltInToolRegistry, resolveAgentTools, resolveWorkingDirectory, } from "../runtime/create-pi-agent-engine.js";
+import { bootstrapRuntime, } from "./runtime-bootstrap.js";
+import { createRuntimeEntries, runRuntimeEntries, } from "./runtime-runner.js";
+import { createRuntimeShutdown, } from "./runtime-shutdown.js";
+import { cleanupRuntimeState } from "./runtime-state.js";
+export function createDaemon(config, dependencies) {
+    const agentRegistry = dependencies.agentRegistry ?? createAgentRegistry(buildAgents(config.agents));
+    const createBuiltInRegistry = dependencies.createBuiltInToolRegistry ?? createBuiltInToolRegistry;
+    return {
+        async start() {
+            validateAgentRegistry(agentRegistry, dependencies.toolRegistry, createBuiltInRegistry);
+            const runtimes = [];
+            try {
+                for (const endpointConfig of config.activeEndpoints) {
+                    runtimes.push(await bootstrapRuntime(config, endpointConfig, dependencies));
+                }
+            }
+            catch (error) {
+                await Promise.all(runtimes.map(async (runtime) => {
+                    try {
+                        await runtime.engine.close?.();
+                    }
+                    finally {
+                        await cleanupRuntimeState(runtime.endpointConfig.paths.runtimeStatePath);
+                    }
+                }));
+                throw error;
+            }
+            const runtimeControl = {
+                requestAction: (() => { }),
+            };
+            const runtimeEntries = createRuntimeEntries(runtimes, {
+                agentRegistry,
+                createTransport: dependencies.createTransport,
+                requestControlAction: (action) => {
+                    runtimeControl.requestAction(action);
+                },
+            });
+            const shutdown = createRuntimeShutdown(runtimeEntries, runtimes.map((runtime) => runtime.endpointConfig.paths.runtimeStatePath), dependencies.runtimeProcess);
+            runtimeControl.requestAction = (action) => {
+                shutdown.requestControlAction(action);
+            };
+            const registeredSignals = shutdown.registerSignalHandlers();
+            try {
+                await runRuntimeEntries(runtimeEntries);
+            }
+            finally {
+                registeredSignals.dispose();
+                await shutdown.shutdown();
+            }
+        },
+    };
+}
+function validateAgentRegistry(agentRegistry, toolRegistry, createBuiltInRegistry) {
+    for (const agent of agentRegistry.list()) {
+        validateAgentPrompt(agent);
+        const registry = toolRegistry ?? createBuiltInRegistry(resolveWorkingDirectory(agent), agent);
+        resolveAgentTools(agent, registry);
+    }
+}
+function buildAgents(configuredAgents) {
+    return configuredAgents.map((configuredAgent) => {
+        validatePromptBase(configuredAgent.id, configuredAgent.prompt.base);
+        if (!configuredAgent.model) {
+            throw new ConfigurationError(`Configured agent "${configuredAgent.id}" must define model.`);
+        }
+        return {
+            id: configuredAgent.id,
+            name: configuredAgent.name ?? configuredAgent.id,
+            prompt: configuredAgent.prompt,
+            model: configuredAgent.model,
+            ...(configuredAgent.authFile ? { authFile: configuredAgent.authFile } : {}),
+            ...(configuredAgent.inference ? { inference: configuredAgent.inference } : {}),
+            ...(configuredAgent.workspace ? { workspace: configuredAgent.workspace } : {}),
+            ...(configuredAgent.skills ? { skills: configuredAgent.skills } : {}),
+            ...(configuredAgent.skillCatalog ? { skillCatalog: configuredAgent.skillCatalog } : {}),
+            ...(configuredAgent.skillIssues ? { skillIssues: configuredAgent.skillIssues } : {}),
+            ...(configuredAgent.mcp ? { mcp: configuredAgent.mcp } : {}),
+            tools: configuredAgent.tools ?? [],
+            extensions: [],
+        };
+    });
+}
+function validateAgentPrompt(agent) {
+    validatePromptBase(agent.id, agent.prompt.base);
+}
+function validatePromptBase(agentId, basePrompt) {
+    const hasText = typeof basePrompt.text === "string" && basePrompt.text.trim().length > 0;
+    const hasFile = typeof basePrompt.file === "string" && basePrompt.file.trim().length > 0;
+    const hasBuiltIn = basePrompt.builtIn === "default";
+    if (hasText || hasFile || hasBuiltIn) {
+        return;
+    }
+    throw new ConfigurationError(`Configured agent "${agentId}" must define prompt.base.text, prompt.base.file, or a built-in base prompt.`);
+}
+//# sourceMappingURL=create-daemon.js.map

package/dist/daemon/create-daemon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-daemon.js","sourceRoot":"","sources":["../../src/daemon/create-daemon.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAEzD,OAAO,EACL,yBAAyB,EACzB,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,sCAAsC,CAAC;AAG9C,OAAO,EACL,gBAAgB,GAGjB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,qBAAqB,GAEtB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AASzD,MAAM,UAAU,YAAY,CAC1B,MAAoB,EACpB,YAAgC;IAEhC,MAAM,aAAa,GACjB,YAAY,CAAC,aAAa,IAAI,mBAAmB,CAAC,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;IAChF,MAAM,qBAAqB,GACzB,YAAY,CAAC,yBAAyB,IAAI,yBAAyB,CAAC;IAEtE,OAAO;QACL,KAAK,CAAC,KAAK;YACT,qBAAqB,CAAC,aAAa,EAAE,YAAY,CAAC,YAAY,EAAE,qBAAqB,CAAC,CAAC;YACvF,MAAM,QAAQ,GAA0B,EAAE,CAAC;YAE3C,IAAI,CAAC;gBACH,KAAK,MAAM,cAAc,IAAI,MAAM,CAAC,eAAe,EAAE,CAAC;oBACpD,QAAQ,CAAC,IAAI,CAAC,MAAM,gBAAgB,CAAC,MAAM,EAAE,cAAc,EAAE,YAAY,CAAC,CAAC,CAAC;gBAC9E,CAAC;YACH,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,OAAO,CAAC,GAAG,CACf,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;oBAC7B,IAAI,CAAC;wBACH,MAAM,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC;oBACjC,CAAC;4BAAS,CAAC;wBACT,MAAM,mBAAmB,CAAC,OAAO,CAAC,cAAc,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;oBAC3E,CAAC;gBACH,CAAC,CAAC,CACH,CAAC;gBACF,MAAM,KAAK,CAAC;YACd,CAAC;YACD,MAAM,cAAc,GAAG;gBACrB,aAAa,EAAE,CAAC,GAAG,EAAE,GAAE,CAAC,CAA2C;aACpE,CAAC;YACF,MAAM,cAAc,GAAG,oBAAoB,CAAC,QAAQ,EAAE;gBACpD,aAAa;gBACb,eAAe,EAAE,YAAY,CAAC,eAAe;gBAC7C,oBAAoB,EAAE,CAAC,MAAM,EAAE,EAAE;oBAC/B,cAAc,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;gBACvC,CAAC;aACF,CAAC,CAAC;YACH,MAAM,QAAQ,GAAG,qBAAqB,CACpC,cAAc,EACd,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,cAAc,CAAC,KAAK,CAAC,gBAAgB,CAAC,EACxE,YAAY,CAAC,cAAc,CAC5B,CAAC;YACF,cAAc,CAAC,aAAa,GAAG,CAAC,MAAM,EAAE,EAAE;gBACxC,QAAQ,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC;YACxC,CAAC,CAAC;YACF,MAAM,iBAAiB,GAAG,QAAQ,CAAC,sBAAsB,EAAE,CAAC;YAE5D,IAAI,CAAC;gBACH,MAAM,iBAAiB,CAAC,cAAc,CAAC,CAAC;YAC1C,CAAC;oBAAS,CAAC;gBACT,iBAAiB,CAAC,OAAO,EAAE,CAAC;gBAC5B,MAAM,QAAQ,CAAC,QAAQ,EAAE,CAAC;YAC5B,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC;AAED,SAAS,qBAAqB,CAC5B,aAAqD,EACrD,YAAsC,EACtC,qBAA0F;IAE1F,KAAK,MAAM,KAAK,IAAI,aAAa,CAAC,IAAI,EAAE,EAAE,CAAC;QACzC,mBAAmB,CAAC,KAAK,CAAC,CAAC;QAC3B,MAAM,QAAQ,GAAG,YAAY,IAAI,qBAAqB,CAAC,uBAAuB,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC;QAC9F,iBAAiB,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IACrC,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAAC,gBAAwC;IAC3D,OAAO,gBAAgB,CAAC,GAAG,CAAC,CAAC,eAAe,EAAE,EAAE;QAC9C,kBAAkB,CAAC,eAAe,CAAC,EAAE,EAAE,eAAe,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAEpE,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,CAAC;YAC3B,MAAM,IAAI,kBAAkB,CAAC,qBAAqB,eAAe,CAAC,EAAE,sBAAsB,CAAC,CAAC;QAC9F,CAAC;QAED,OAAO;YACL,EAAE,EAAE,eAAe,CAAC,EAAE;YACtB,IAAI,EAAE,eAAe,CAAC,IAAI,IAAI,eAAe,CAAC,EAAE;YAChD,MAAM,EAAE,eAAe,CAAC,MAAM;YAC9B,KAAK,EAAE,eAAe,CAAC,KAAK;YAC5B,GAAG,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,eAAe,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3E,GAAG,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,eAAe,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC9E,GAAG,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,eAAe,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC9E,GAAG,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,eAAe,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACrE,GAAG,CAAC,eAAe,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,eAAe,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACvF,GAAG,CAAC,eAAe,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,eAAe,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACpF,GAAG,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,eAAe,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC5D,KAAK,EAAE,eAAe,CAAC,KAAK,IAAI,EAAE;YAClC,UAAU,EAAE,EAAE;SACf,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAsB;IACjD,kBAAkB,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AAClD,CAAC;AAED,SAAS,kBAAkB,CACzB,OAAe,EACf,UAIC;IAED,MAAM,OAAO,GAAG,OAAO,UAAU,CAAC,IAAI,KAAK,QAAQ,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;IACzF,MAAM,OAAO,GAAG,OAAO,UAAU,CAAC,IAAI,KAAK,QAAQ,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;IACzF,MAAM,UAAU,GAAG,UAAU,CAAC,OAAO,KAAK,SAAS,CAAC;IAEpD,IAAI,OAAO,IAAI,OAAO,IAAI,UAAU,EAAE,CAAC;QACrC,OAAO;IACT,CAAC;IAED,MAAM,IAAI,kBAAkB,CAAC,qBAAqB,OAAO,8EAA8E,CAAC,CAAC;AAC3I,CAAC"}

package/dist/daemon/runtime-bootstrap.d.ts

@@ -0,0 +1,12 @@
+import { buildRuntimeComponents, type BuildRuntimeComponentsDependencies } from "./bootstrap/build-runtime-components.js";
+import type { ActiveEndpointRuntimeConfig, DaemonConfig } from "./types.js";
+export interface BootstrappedRuntime {
+    endpointConfig: ActiveEndpointRuntimeConfig;
+    configPath: string;
+    logger: ReturnType<typeof buildRuntimeComponents>["logger"];
+    loggingLevel: ReturnType<typeof buildRuntimeComponents>["loggingLevel"];
+    conversationStore: ReturnType<typeof buildRuntimeComponents>["conversationStore"];
+    engine: ReturnType<typeof buildRuntimeComponents>["engine"];
+}
+export type RuntimeBootstrapDependencies = BuildRuntimeComponentsDependencies;
+export declare function bootstrapRuntime(config: DaemonConfig, endpointConfig: ActiveEndpointRuntimeConfig, dependencies?: RuntimeBootstrapDependencies): Promise<BootstrappedRuntime>;

package/dist/daemon/runtime-bootstrap.js

@@ -0,0 +1,24 @@
+import { acquireRuntimeState, cleanupPreparedRuntime, } from "./bootstrap/acquire-runtime-state.js";
+import { buildRuntimeComponents, } from "./bootstrap/build-runtime-components.js";
+import { prepareRuntimeFilesystem } from "./bootstrap/prepare-runtime-filesystem.js";
+export async function bootstrapRuntime(config, endpointConfig, dependencies = {}) {
+    let preparedRuntime = { stateAcquired: false };
+    try {
+        await prepareRuntimeFilesystem(endpointConfig.paths);
+        preparedRuntime = await acquireRuntimeState(config, endpointConfig);
+        const components = buildRuntimeComponents(config, endpointConfig, dependencies);
+        await components.logger.debug("initialized endpoint runtime state", {
+            endpointId: endpointConfig.id,
+        });
+        return {
+            endpointConfig,
+            configPath: config.configPath,
+            ...components,
+        };
+    }
+    catch (error) {
+        await cleanupPreparedRuntime(preparedRuntime, endpointConfig);
+        throw error;
+    }
+}
+//# sourceMappingURL=runtime-bootstrap.js.map

package/dist/daemon/runtime-bootstrap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-bootstrap.js","sourceRoot":"","sources":["../../src/daemon/runtime-bootstrap.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,sBAAsB,GAEvB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EACL,sBAAsB,GAEvB,MAAM,yCAAyC,CAAC;AACjD,OAAO,EAAE,wBAAwB,EAAE,MAAM,2CAA2C,CAAC;AAcrF,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,MAAoB,EACpB,cAA2C,EAC3C,eAA6C,EAAE;IAE/C,IAAI,eAAe,GAAoB,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC;IAEhE,IAAI,CAAC;QACH,MAAM,wBAAwB,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;QACrD,eAAe,GAAG,MAAM,mBAAmB,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;QAEpE,MAAM,UAAU,GAAG,sBAAsB,CAAC,MAAM,EAAE,cAAc,EAAE,YAAY,CAAC,CAAC;QAEhF,MAAM,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,oCAAoC,EAAE;YAClE,UAAU,EAAE,cAAc,CAAC,EAAE;SAC9B,CAAC,CAAC;QAEH,OAAO;YACL,cAAc;YACd,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,GAAG,UAAU;SACd,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,sBAAsB,CAAC,eAAe,EAAE,cAAc,CAAC,CAAC;QAC9D,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/daemon/runtime-runner.d.ts

@@ -0,0 +1,18 @@
+import { createAgentRegistry } from "../agents/registry.js";
+import type { TransportFactory } from "../transports/types.js";
+import type { BootstrappedRuntime } from "./runtime-bootstrap.js";
+import type { RuntimeControlAction } from "./runtime-shutdown.js";
+import type { ActiveEndpointRuntimeConfig } from "./types.js";
+export interface RuntimeEntry {
+    start(): Promise<void>;
+    stop(): Promise<void>;
+}
+interface RuntimeRunnerDependencies {
+    agentRegistry: ReturnType<typeof createAgentRegistry>;
+    createTransport: TransportFactory<ActiveEndpointRuntimeConfig, BootstrappedRuntime["logger"]>;
+    requestControlAction?: (action: RuntimeControlAction) => void;
+}
+export declare function createRuntimeEntries(runtimes: BootstrappedRuntime[], dependencies: RuntimeRunnerDependencies): RuntimeEntry[];
+export declare function runRuntimeEntries(entries: RuntimeEntry[]): Promise<void>;
+export declare function stopRuntimeEntries(entries: RuntimeEntry[]): Promise<void>;
+export {};

package/dist/daemon/runtime-runner.js

@@ -0,0 +1,126 @@
+import { parseInboundCommand } from "../application/commands/parse-inbound-command.js";
+import { priorityInboundCommands } from "../application/commands/priority-inbound-commands.js";
+import { createHandleIncomingMessage } from "../application/handle-incoming-message.js";
+import { createMessageProcessor } from "../application/message-processor.js";
+export function createRuntimeEntries(runtimes, dependencies) {
+    return runtimes.map((runtime) => {
+        const handleIncomingMessage = createHandleIncomingMessage({
+            agentRegistry: dependencies.agentRegistry,
+            conversationStore: runtime.conversationStore,
+            engine: runtime.engine,
+            defaultAgentId: runtime.endpointConfig.defaultAgentId,
+            runtimeInfo: {
+                endpointId: runtime.endpointConfig.id,
+                configPath: runtime.configPath,
+                dataRoot: runtime.endpointConfig.paths.dataRoot,
+                logFilePath: runtime.endpointConfig.paths.logFilePath,
+                loggingLevel: runtime.loggingLevel,
+                activeEndpointIds: runtimes.map((entry) => entry.endpointConfig.id),
+            },
+            logger: runtime.logger,
+        });
+        const messageProcessor = createMessageProcessor({
+            handler: handleIncomingMessage,
+            logger: runtime.logger,
+            prepareEvent: async (event) => {
+                if (event.message.command && priorityInboundCommands.has(event.message.command)) {
+                    return event;
+                }
+                if (!event.message.command) {
+                    const command = parseInboundCommand(event.message.text, {
+                        allowedCommands: priorityInboundCommands,
+                    });
+                    if (command) {
+                        return {
+                            ...event,
+                            message: {
+                                ...event.message,
+                                ...command,
+                            },
+                        };
+                    }
+                }
+                const conversation = await runtime.conversationStore.ensureActive(event.message.conversation, {
+                    agentId: runtime.endpointConfig.defaultAgentId,
+                    now: event.message.receivedAt,
+                });
+                return {
+                    ...event,
+                    message: {
+                        ...event.message,
+                        conversation: conversation.state.conversation,
+                    },
+                };
+            },
+            afterDeliveryAction: dependencies.requestControlAction,
+        });
+        let transport;
+        let stopped = false;
+        return {
+            async start() {
+                const defaultAgent = dependencies.agentRegistry.get(runtime.endpointConfig.defaultAgentId);
+                await runtime.logger.info(`starting daemon with default agent "${defaultAgent?.id ?? "unknown"}"`);
+                await runtime.logger.info(`data root: ${runtime.endpointConfig.paths.dataRoot}`);
+                await runtime.logger.info(`endpoint root: ${runtime.endpointConfig.paths.endpointRoot}`);
+                await runtime.logger.info(`conversations dir: ${runtime.endpointConfig.paths.conversationsDir}`);
+                await runtime.logger.info(`logs dir: ${runtime.endpointConfig.paths.logsDir}`);
+                await runtime.logger.info(`log file: ${runtime.endpointConfig.paths.logFilePath}`);
+                await runtime.logger.info(`runtime dir: ${runtime.endpointConfig.paths.runtimeDir}`);
+                await runtime.logger.info(`runtime file: ${runtime.endpointConfig.paths.runtimeStatePath}`);
+                await runtime.logger.info(`active endpoint: ${runtime.endpointConfig.id}`);
+                for (const agent of dependencies.agentRegistry.list()) {
+                    await runtime.logger.info("discovered agent skills", {
+                        endpointId: runtime.endpointConfig.id,
+                        agentId: agent.id,
+                        skillCount: agent.skillCatalog?.length ?? 0,
+                        skillNames: (agent.skillCatalog ?? []).map((skill) => skill.name),
+                    });
+                    for (const issue of agent.skillIssues ?? []) {
+                        await runtime.logger.info(issue, { endpointId: runtime.endpointConfig.id, agentId: agent.id });
+                    }
+                }
+                await runtime.logger.debug("starting transport for endpoint", {
+                    endpointId: runtime.endpointConfig.id,
+                });
+                if (stopped) {
+                    return;
+                }
+                transport = dependencies.createTransport(runtime.endpointConfig, runtime.logger);
+                if (stopped) {
+                    await transport.stop?.();
+                    return;
+                }
+                await transport.start(messageProcessor);
+            },
+            async stop() {
+                if (stopped) {
+                    return;
+                }
+                stopped = true;
+                try {
+                    await transport?.stop?.();
+                }
+                finally {
+                    await runtime.engine.close?.();
+                }
+            },
+        };
+    });
+}
+export async function runRuntimeEntries(entries) {
+    const startPromises = entries.map(async (entry) => entry.start());
+    try {
+        await Promise.all(startPromises);
+    }
+    catch (error) {
+        await stopRuntimeEntries(entries);
+        await Promise.allSettled(startPromises);
+        throw error;
+    }
+}
+export async function stopRuntimeEntries(entries) {
+    await Promise.all([...entries].reverse().map(async (entry) => {
+        await entry.stop();
+    }));
+}
+//# sourceMappingURL=runtime-runner.js.map

package/dist/daemon/runtime-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-runner.js","sourceRoot":"","sources":["../../src/daemon/runtime-runner.ts"],"names":[],"mappings":"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"}

package/dist/daemon/runtime-shutdown.d.ts

@@ -0,0 +1,15 @@
+import { type RuntimeEntry } from "./runtime-runner.js";
+export type RuntimeControlAction = "reload" | "restart";
+export interface RuntimeLifecycleProcess {
+    once(event: "SIGINT" | "SIGTERM", listener: () => void): void;
+    off(event: "SIGINT" | "SIGTERM", listener: () => void): void;
+    exit(code?: number): never;
+}
+export interface RuntimeShutdown {
+    registerSignalHandlers(): {
+        dispose(): void;
+    };
+    shutdown(): Promise<void>;
+    requestControlAction(action: RuntimeControlAction): void;
+}
+export declare function createRuntimeShutdown(entries: RuntimeEntry[], runtimeStatePaths: string[], runtimeProcess?: RuntimeLifecycleProcess): RuntimeShutdown;