@tschmz/imp 0.1.0

package/dist/application/get-config-value-use-case.d.ts

@@ -0,0 +1,4 @@
+export declare function createGetConfigValueUseCase(): (options: {
+    configPath?: string;
+    keyPath: string;
+}) => Promise<void>;

package/dist/application/get-config-value-use-case.js

@@ -0,0 +1,30 @@
+import { discoverConfigPath } from "../config/discover-config-path.js";
+import { loadAppConfig } from "../config/load-app-config.js";
+import { getValueAtKeyPath } from "./config-key-path.js";
+export function createGetConfigValueUseCase() {
+    return async ({ configPath, keyPath }) => {
+        const { configPath: resolvedConfigPath } = await discoverConfigPath({
+            cliConfigPath: configPath,
+        });
+        const config = await loadAppConfig(resolvedConfigPath);
+        const value = getValueAtKeyPath(config, keyPath);
+        if (value === undefined) {
+            throw new Error(`Config key not found: ${keyPath}`);
+        }
+        console.log(formatConfigValue(value));
+    };
+}
+function formatConfigValue(value) {
+    if (value === null) {
+        return "null";
+    }
+    switch (typeof value) {
+        case "string":
+        case "number":
+        case "boolean":
+            return String(value);
+        default:
+            return JSON.stringify(value, null, 2);
+    }
+}
+//# sourceMappingURL=get-config-value-use-case.js.map

package/dist/application/get-config-value-use-case.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-config-value-use-case.js","sourceRoot":"","sources":["../../src/application/get-config-value-use-case.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AACvE,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAEzD,MAAM,UAAU,2BAA2B;IAIzC,OAAO,KAAK,EAAE,EAAE,UAAU,EAAE,OAAO,EAAE,EAAE,EAAE;QACvC,MAAM,EAAE,UAAU,EAAE,kBAAkB,EAAE,GAAG,MAAM,kBAAkB,CAAC;YAClE,aAAa,EAAE,UAAU;SAC1B,CAAC,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,kBAAkB,CAAC,CAAC;QACvD,MAAM,KAAK,GAAG,iBAAiB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAEjD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,yBAAyB,OAAO,EAAE,CAAC,CAAC;QACtD,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC,CAAC;IACxC,CAAC,CAAC;AACJ,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAc;IACvC,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,QAAQ,OAAO,KAAK,EAAE,CAAC;QACrB,KAAK,QAAQ,CAAC;QACd,KAAK,QAAQ,CAAC;QACd,KAAK,SAAS;YACZ,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;QACvB;YACE,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAC1C,CAAC;AACH,CAAC"}

package/dist/application/handle-incoming-message.d.ts

@@ -0,0 +1,7 @@
+import type { IncomingMessage, OutgoingMessage } from "../domain/message.js";
+import type { HandleIncomingMessageDependencies } from "./commands/types.js";
+export type { HandleIncomingMessageDependencies, RuntimeCommandInfo } from "./commands/types.js";
+export interface HandleIncomingMessage {
+    handle(message: IncomingMessage): Promise<OutgoingMessage>;
+}
+export declare function createHandleIncomingMessage(dependencies: HandleIncomingMessageDependencies): HandleIncomingMessage;

package/dist/application/handle-incoming-message.js

@@ -0,0 +1,56 @@
+import { loadAppConfig } from "../config/load-app-config.js";
+import { readRecentLogLines } from "../logging/view-logs.js";
+import { createHookRunner } from "../plugins/hook-runner.js";
+import { inboundCommandHandlers } from "./commands/registry.js";
+import { dispatchCommand } from "./inbound/dispatch-command.js";
+import { executeAgent } from "./inbound/execute-agent.js";
+import { persistConversation } from "./inbound/persist-conversation.js";
+import { resolveConversation } from "./inbound/resolve-conversation.js";
+import { resolveSkills } from "./inbound/resolve-skills.js";
+import { runHooksStart } from "./inbound/run-hooks-start.js";
+import { runHooksError, runHooksSuccess } from "./inbound/run-hooks-success-error.js";
+export function createHandleIncomingMessage(dependencies) {
+    const defaultAgent = dependencies.agentRegistry.get(dependencies.defaultAgentId);
+    const availableCommands = dependencies.availableCommands ?? inboundCommandHandlers;
+    const loadAppConfigImpl = dependencies.loadAppConfig ?? loadAppConfig;
+    const readRecentLogLinesImpl = dependencies.readRecentLogLines ?? readRecentLogLines;
+    const hookRunner = createHookRunner(dependencies.inboundMessageHooks, {
+        logger: dependencies.logger,
+    });
+    if (!defaultAgent) {
+        throw new Error(`Unknown default agent: ${dependencies.defaultAgentId}`);
+    }
+    return {
+        async handle(message) {
+            const context = {
+                message,
+                dependencies,
+                defaultAgent,
+                availableCommands,
+                loadAppConfig: loadAppConfigImpl,
+                readRecentLogLines: readRecentLogLinesImpl,
+                hookRunner,
+                startedAt: Date.now(),
+                availableSkills: [],
+            };
+            try {
+                await runHooksStart(context);
+                await dispatchCommand(context);
+                await resolveConversation(context);
+                await resolveSkills(context);
+                await executeAgent(context);
+                await persistConversation(context);
+                await runHooksSuccess(context);
+                if (!context.response) {
+                    throw new Error("Inbound processing completed without a response");
+                }
+                return context.response;
+            }
+            catch (error) {
+                await runHooksError(context, error);
+                throw error;
+            }
+        },
+    };
+}
+//# sourceMappingURL=handle-incoming-message.js.map

package/dist/application/handle-incoming-message.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handle-incoming-message.js","sourceRoot":"","sources":["../../src/application/handle-incoming-message.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAE7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAEhE,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AACxE,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AACxE,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AAStF,MAAM,UAAU,2BAA2B,CACzC,YAA+C;IAE/C,MAAM,YAAY,GAAG,YAAY,CAAC,aAAa,CAAC,GAAG,CAAC,YAAY,CAAC,cAAc,CAAC,CAAC;IACjF,MAAM,iBAAiB,GAAG,YAAY,CAAC,iBAAiB,IAAI,sBAAsB,CAAC;IACnF,MAAM,iBAAiB,GAAG,YAAY,CAAC,aAAa,IAAI,aAAa,CAAC;IACtE,MAAM,sBAAsB,GAAG,YAAY,CAAC,kBAAkB,IAAI,kBAAkB,CAAC;IACrF,MAAM,UAAU,GAAG,gBAAgB,CAAC,YAAY,CAAC,mBAAmB,EAAE;QACpE,MAAM,EAAE,YAAY,CAAC,MAAM;KAC5B,CAAC,CAAC;IAEH,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,0BAA0B,YAAY,CAAC,cAAc,EAAE,CAAC,CAAC;IAC3E,CAAC;IAED,OAAO;QACL,KAAK,CAAC,MAAM,CAAC,OAAwB;YACnC,MAAM,OAAO,GAA6B;gBACxC,OAAO;gBACP,YAAY;gBACZ,YAAY;gBACZ,iBAAiB;gBACjB,aAAa,EAAE,iBAAiB;gBAChC,kBAAkB,EAAE,sBAAsB;gBAC1C,UAAU;gBACV,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;gBACrB,eAAe,EAAE,EAAE;aACpB,CAAC;YAEF,IAAI,CAAC;gBACH,MAAM,aAAa,CAAC,OAAO,CAAC,CAAC;gBAC7B,MAAM,eAAe,CAAC,OAAO,CAAC,CAAC;gBAC/B,MAAM,mBAAmB,CAAC,OAAO,CAAC,CAAC;gBACnC,MAAM,aAAa,CAAC,OAAO,CAAC,CAAC;gBAC7B,MAAM,YAAY,CAAC,OAAO,CAAC,CAAC;gBAC5B,MAAM,mBAAmB,CAAC,OAAO,CAAC,CAAC;gBACnC,MAAM,eAAe,CAAC,OAAO,CAAC,CAAC;gBAE/B,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;oBACtB,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;gBACrE,CAAC;gBAED,OAAO,OAAO,CAAC,QAAQ,CAAC;YAC1B,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,aAAa,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;gBACpC,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/application/inbound/dispatch-command.d.ts

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

package/dist/application/inbound/dispatch-command.js

@@ -0,0 +1,23 @@
+export async function dispatchCommand(context) {
+    if (!context.message.command) {
+        return;
+    }
+    const handler = context.availableCommands.find((candidate) => candidate.canHandle(context.message.command));
+    if (!handler) {
+        return;
+    }
+    const commandResponse = await handler.handle({
+        message: context.message,
+        dependencies: {
+            ...context.dependencies,
+            availableCommands: context.availableCommands,
+        },
+        logger: context.dependencies.logger,
+        loadAppConfig: context.loadAppConfig,
+        readRecentLogLines: context.readRecentLogLines,
+    });
+    if (commandResponse) {
+        context.response = commandResponse;
+    }
+}
+//# sourceMappingURL=dispatch-command.js.map

package/dist/application/inbound/dispatch-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch-command.js","sourceRoot":"","sources":["../../../src/application/inbound/dispatch-command.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,OAAiC;IACrE,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QAC7B,OAAO;IACT,CAAC;IAED,MAAM,OAAO,GAAG,OAAO,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAC3D,SAAS,CAAC,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAC7C,CAAC;IAEF,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO;IACT,CAAC;IAED,MAAM,eAAe,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC;QAC3C,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,YAAY,EAAE;YACZ,GAAG,OAAO,CAAC,YAAY;YACvB,iBAAiB,EAAE,OAAO,CAAC,iBAAiB;SAC7C;QACD,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC,MAAM;QACnC,aAAa,EAAE,OAAO,CAAC,aAAa;QACpC,kBAAkB,EAAE,OAAO,CAAC,kBAAkB;KAC/C,CAAC,CAAC;IAEH,IAAI,eAAe,EAAE,CAAC;QACpB,OAAO,CAAC,QAAQ,GAAG,eAAe,CAAC;IACrC,CAAC;AACH,CAAC"}

package/dist/application/inbound/execute-agent.d.ts

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

package/dist/application/inbound/execute-agent.js

@@ -0,0 +1,41 @@
+export async function executeAgent(context) {
+    if (context.response || !context.agent || !context.conversation) {
+        return;
+    }
+    const result = await context.dependencies.engine.run({
+        agent: context.agent,
+        conversation: context.conversation,
+        message: context.message,
+        runtime: {
+            configPath: context.dependencies.runtimeInfo.configPath,
+            dataRoot: context.dependencies.runtimeInfo.dataRoot,
+            ...(context.availableSkills.length > 0 ? { availableSkills: context.availableSkills } : {}),
+        },
+    });
+    context.response = result.message;
+    context.conversation = {
+        state: {
+            ...context.conversation.state,
+            ...(result.workingDirectory ? { workingDirectory: result.workingDirectory } : {}),
+            updatedAt: new Date().toISOString(),
+        },
+        messages: [
+            ...context.conversation.messages,
+            toUserConversationMessage(context.message),
+            ...result.conversationEvents,
+        ],
+    };
+}
+function toUserConversationMessage(message) {
+    return {
+        kind: "message",
+        id: message.messageId,
+        role: "user",
+        content: message.text,
+        timestamp: Date.parse(message.receivedAt),
+        createdAt: message.receivedAt,
+        correlationId: message.correlationId,
+        ...(message.source ? { source: message.source } : {}),
+    };
+}
+//# sourceMappingURL=execute-agent.js.map

package/dist/application/inbound/execute-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute-agent.js","sourceRoot":"","sources":["../../../src/application/inbound/execute-agent.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAAiC;IAClE,IAAI,OAAO,CAAC,QAAQ,IAAI,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC;QAChE,OAAO;IACT,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,GAAG,CAAC;QACnD,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,YAAY,EAAE,OAAO,CAAC,YAAY;QAClC,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,OAAO,EAAE;YACP,UAAU,EAAE,OAAO,CAAC,YAAY,CAAC,WAAW,CAAC,UAAU;YACvD,QAAQ,EAAE,OAAO,CAAC,YAAY,CAAC,WAAW,CAAC,QAAQ;YACnD,GAAG,CAAC,OAAO,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC5F;KACF,CAAC,CAAC;IAEH,OAAO,CAAC,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC;IAClC,OAAO,CAAC,YAAY,GAAG;QACrB,KAAK,EAAE;YACL,GAAG,OAAO,CAAC,YAAY,CAAC,KAAK;YAC7B,GAAG,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,gBAAgB,EAAE,MAAM,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACjF,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC;QACD,QAAQ,EAAE;YACR,GAAG,OAAO,CAAC,YAAY,CAAC,QAAQ;YAChC,yBAAyB,CAAC,OAAO,CAAC,OAAO,CAAC;YAC1C,GAAG,MAAM,CAAC,kBAAkB;SAC7B;KACF,CAAC;AACJ,CAAC;AAED,SAAS,yBAAyB,CAAC,OAA4C;IAC7E,OAAO;QACL,IAAI,EAAE,SAAkB;QACxB,EAAE,EAAE,OAAO,CAAC,SAAS;QACrB,IAAI,EAAE,MAAe;QACrB,OAAO,EAAE,OAAO,CAAC,IAAI;QACrB,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC;QACzC,SAAS,EAAE,OAAO,CAAC,UAAU;QAC7B,aAAa,EAAE,OAAO,CAAC,aAAa;QACpC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACtD,CAAC;AACJ,CAAC"}

package/dist/application/inbound/persist-conversation.d.ts

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

package/dist/application/inbound/persist-conversation.js

@@ -0,0 +1,7 @@
+export async function persistConversation(context) {
+    if (!context.conversation || !context.agent || !context.response) {
+        return;
+    }
+    await context.dependencies.conversationStore.put(context.conversation);
+}
+//# sourceMappingURL=persist-conversation.js.map

package/dist/application/inbound/persist-conversation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"persist-conversation.js","sourceRoot":"","sources":["../../../src/application/inbound/persist-conversation.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,OAAiC;IACzE,IAAI,CAAC,OAAO,CAAC,YAAY,IAAI,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;QACjE,OAAO;IACT,CAAC;IAED,MAAM,OAAO,CAAC,YAAY,CAAC,iBAAiB,CAAC,GAAG,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;AACzE,CAAC"}

package/dist/application/inbound/resolve-conversation.d.ts

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

package/dist/application/inbound/resolve-conversation.js

@@ -0,0 +1,19 @@
+import { getOrCreateConversationContext } from "../commands/conversation-context.js";
+export async function resolveConversation(context) {
+    if (context.response) {
+        return;
+    }
+    const conversation = await getOrCreateConversationContext(context.message, context.defaultAgent.id, context.dependencies.conversationStore, context.dependencies.logger);
+    const agent = context.dependencies.agentRegistry.get(conversation.state.agentId) ?? context.defaultAgent;
+    await context.dependencies.logger?.debug("resolved conversation context", {
+        endpointId: context.message.endpointId,
+        transport: context.message.conversation.transport,
+        conversationId: context.message.conversation.externalId,
+        messageId: context.message.messageId,
+        correlationId: context.message.correlationId,
+        agentId: agent.id,
+    });
+    context.conversation = conversation;
+    context.agent = agent;
+}
+//# sourceMappingURL=resolve-conversation.js.map

package/dist/application/inbound/resolve-conversation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-conversation.js","sourceRoot":"","sources":["../../../src/application/inbound/resolve-conversation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,8BAA8B,EAAE,MAAM,qCAAqC,CAAC;AAGrF,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,OAAiC;IACzE,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;QACrB,OAAO;IACT,CAAC;IAED,MAAM,YAAY,GAAG,MAAM,8BAA8B,CACvD,OAAO,CAAC,OAAO,EACf,OAAO,CAAC,YAAY,CAAC,EAAE,EACvB,OAAO,CAAC,YAAY,CAAC,iBAAiB,EACtC,OAAO,CAAC,YAAY,CAAC,MAAM,CAC5B,CAAC;IAEF,MAAM,KAAK,GAAG,OAAO,CAAC,YAAY,CAAC,aAAa,CAAC,GAAG,CAAC,YAAY,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,YAAY,CAAC;IAEzG,MAAM,OAAO,CAAC,YAAY,CAAC,MAAM,EAAE,KAAK,CAAC,+BAA+B,EAAE;QACxE,UAAU,EAAE,OAAO,CAAC,OAAO,CAAC,UAAU;QACtC,SAAS,EAAE,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,SAAS;QACjD,cAAc,EAAE,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,UAAU;QACvD,SAAS,EAAE,OAAO,CAAC,OAAO,CAAC,SAAS;QACpC,aAAa,EAAE,OAAO,CAAC,OAAO,CAAC,aAAa;QAC5C,OAAO,EAAE,KAAK,CAAC,EAAE;KAClB,CAAC,CAAC;IAEH,OAAO,CAAC,YAAY,GAAG,YAAY,CAAC;IACpC,OAAO,CAAC,KAAK,GAAG,KAAK,CAAC;AACxB,CAAC"}

package/dist/application/inbound/resolve-skills.d.ts

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

package/dist/application/inbound/resolve-skills.js

@@ -0,0 +1,73 @@
+import { join } from "node:path";
+import { discoverSkills, mergeSkillCatalogs } from "../../skills/discovery.js";
+export async function resolveSkills(context) {
+    if (context.response || !context.agent) {
+        return;
+    }
+    const configuredSkillCatalog = context.agent.skillCatalog ?? [];
+    const workspaceDirectory = resolveWorkspaceDirectory(context);
+    const workspaceSkillsPath = workspaceDirectory ? join(workspaceDirectory, ".skills") : undefined;
+    try {
+        const workspaceSkillCatalog = workspaceSkillsPath
+            ? await discoverSkills([workspaceSkillsPath], { ignoreMissingPaths: true })
+            : { skills: [], issues: [] };
+        const mergedSkillCatalog = mergeSkillCatalogs(configuredSkillCatalog, workspaceSkillCatalog.skills);
+        const skillCatalog = mergedSkillCatalog.skills;
+        context.availableSkills = skillCatalog;
+        for (const issue of workspaceSkillCatalog.issues) {
+            await context.dependencies.logger?.info(issue, {
+                endpointId: context.message.endpointId,
+                transport: context.message.conversation.transport,
+                conversationId: context.message.conversation.externalId,
+                messageId: context.message.messageId,
+                correlationId: context.message.correlationId,
+                agentId: context.agent.id,
+                workspaceDirectory,
+                workspaceSkillsPath,
+            });
+        }
+        if (mergedSkillCatalog.overriddenSkillNames.length > 0) {
+            await context.dependencies.logger?.info("workspace skills override configured agent skills for turn", {
+                endpointId: context.message.endpointId,
+                transport: context.message.conversation.transport,
+                conversationId: context.message.conversation.externalId,
+                messageId: context.message.messageId,
+                correlationId: context.message.correlationId,
+                agentId: context.agent.id,
+                workspaceDirectory,
+                workspaceSkillsPath,
+                overriddenSkillNames: mergedSkillCatalog.overriddenSkillNames,
+            });
+        }
+        await context.dependencies.logger?.debug("resolved available agent skills for turn", {
+            endpointId: context.message.endpointId,
+            transport: context.message.conversation.transport,
+            conversationId: context.message.conversation.externalId,
+            messageId: context.message.messageId,
+            correlationId: context.message.correlationId,
+            agentId: context.agent.id,
+            skillCount: skillCatalog.length,
+            skillNames: skillCatalog.map((skill) => skill.name),
+            ...(workspaceDirectory ? { workspaceDirectory, workspaceSkillsPath } : {}),
+            ...(mergedSkillCatalog.overriddenSkillNames.length > 0
+                ? { overriddenSkillNames: mergedSkillCatalog.overriddenSkillNames }
+                : {}),
+        });
+    }
+    catch (error) {
+        context.availableSkills = [];
+        void context.dependencies.logger?.error("failed to resolve available agent skills for turn; continuing without skills", {
+            endpointId: context.message.endpointId,
+            transport: context.message.conversation.transport,
+            conversationId: context.message.conversation.externalId,
+            messageId: context.message.messageId,
+            correlationId: context.message.correlationId,
+            agentId: context.agent.id,
+            ...(workspaceDirectory ? { workspaceDirectory, workspaceSkillsPath } : {}),
+        }, error);
+    }
+}
+function resolveWorkspaceDirectory(context) {
+    return context.conversation?.state.workingDirectory ?? context.agent?.workspace?.cwd;
+}
+//# sourceMappingURL=resolve-skills.js.map

package/dist/application/inbound/resolve-skills.js.map

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

package/dist/application/inbound/run-hooks-start.d.ts

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

package/dist/application/inbound/run-hooks-start.js

@@ -0,0 +1,4 @@
+export async function runHooksStart(context) {
+    await context.hookRunner.run("onInboundMessageStart", (hooks) => hooks.onInboundMessageStart, { message: context.message });
+}
+//# sourceMappingURL=run-hooks-start.js.map

package/dist/application/inbound/run-hooks-start.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-hooks-start.js","sourceRoot":"","sources":["../../../src/application/inbound/run-hooks-start.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,OAAiC;IACnE,MAAM,OAAO,CAAC,UAAU,CAAC,GAAG,CAC1B,uBAAuB,EACvB,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,qBAAqB,EACtC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAC7B,CAAC;AACJ,CAAC"}

package/dist/application/inbound/run-hooks-success-error.d.ts

@@ -0,0 +1,3 @@
+import type { InboundProcessingContext } from "./types.js";
+export declare function runHooksSuccess(context: InboundProcessingContext): Promise<void>;
+export declare function runHooksError(context: InboundProcessingContext, error: unknown): Promise<void>;

package/dist/application/inbound/run-hooks-success-error.js

@@ -0,0 +1,18 @@
+export async function runHooksSuccess(context) {
+    if (!context.response) {
+        return;
+    }
+    await context.hookRunner.run("onInboundMessageSuccess", (hooks) => hooks.onInboundMessageSuccess, {
+        message: context.message,
+        response: context.response,
+        durationMs: Date.now() - context.startedAt,
+    });
+}
+export async function runHooksError(context, error) {
+    await context.hookRunner.runErrorHook("onInboundMessageError", (hooks) => hooks.onInboundMessageError, {
+        message: context.message,
+        error,
+        durationMs: Date.now() - context.startedAt,
+    });
+}
+//# sourceMappingURL=run-hooks-success-error.js.map

package/dist/application/inbound/run-hooks-success-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-hooks-success-error.js","sourceRoot":"","sources":["../../../src/application/inbound/run-hooks-success-error.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,OAAiC;IACrE,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;QACtB,OAAO;IACT,CAAC;IAED,MAAM,OAAO,CAAC,UAAU,CAAC,GAAG,CAC1B,yBAAyB,EACzB,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,uBAAuB,EACxC;QACE,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,SAAS;KAC3C,CACF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,OAAiC,EACjC,KAAc;IAEd,MAAM,OAAO,CAAC,UAAU,CAAC,YAAY,CACnC,uBAAuB,EACvB,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,qBAAqB,EACtC;QACE,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,KAAK;QACL,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,SAAS;KAC3C,CACF,CAAC;AACJ,CAAC"}

package/dist/application/inbound/types.d.ts

@@ -0,0 +1,21 @@
+import type { AgentDefinition } from "../../domain/agent.js";
+import type { ConversationContext } from "../../domain/conversation.js";
+import type { IncomingMessage, OutgoingMessage } from "../../domain/message.js";
+import type { HookRunner } from "../../plugins/hook-runner.js";
+import type { InboundMessageLifecycleHooks } from "../../plugins/types.js";
+import type { SkillDefinition } from "../../skills/types.js";
+import type { HandleIncomingMessageDependencies, InboundCommandHandler } from "../commands/types.js";
+export interface InboundProcessingContext {
+    message: IncomingMessage;
+    dependencies: HandleIncomingMessageDependencies;
+    defaultAgent: AgentDefinition;
+    availableCommands: ReadonlyArray<InboundCommandHandler>;
+    loadAppConfig: NonNullable<HandleIncomingMessageDependencies["loadAppConfig"]>;
+    readRecentLogLines: NonNullable<HandleIncomingMessageDependencies["readRecentLogLines"]>;
+    hookRunner: HookRunner<InboundMessageLifecycleHooks>;
+    startedAt: number;
+    response?: OutgoingMessage;
+    conversation?: ConversationContext;
+    agent?: AgentDefinition;
+    availableSkills: SkillDefinition[];
+}

package/dist/application/inbound/types.js

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

package/dist/application/inbound/types.js.map

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

package/dist/application/init-config-use-case.d.ts

@@ -0,0 +1,5 @@
+export declare function createInitConfigUseCase(): (options: {
+    configPath?: string;
+    force: boolean;
+    defaults: boolean;
+}) => Promise<void>;

package/dist/application/init-config-use-case.js

@@ -0,0 +1,62 @@
+import { createDefaultAppConfig } from "../config/default-app-config.js";
+import { assertInitConfigCanBeCreated, initAppConfig } from "../config/init-app-config.js";
+import { getProviderEnvironmentVariables, promptForInitialAppConfig } from "../config/prompt-init-config.js";
+import { installService } from "../service/install-service.js";
+export function createInitConfigUseCase() {
+    return async ({ configPath, force, defaults }) => {
+        const resolvedConfigPath = await assertInitConfigCanBeCreated({ configPath, force });
+        const initSetup = defaults
+            ? {
+                config: undefined,
+                installService: process.platform !== "win32",
+                serviceEnvironment: resolveDefaultServiceEnvironment(),
+            }
+            : await resolveInitConfig();
+        const createdConfigPath = await initAppConfig({
+            configPath: resolvedConfigPath,
+            force,
+            config: initSetup.config,
+        });
+        console.log(`Created config at ${createdConfigPath}`);
+        if (initSetup.installService) {
+            const result = await installService({
+                configPath: createdConfigPath,
+                force,
+                serviceEnvironment: initSetup.serviceEnvironment,
+            });
+            console.log(`Installed ${result.operation.platform} service at ${result.operation.definitionPath}`);
+        }
+    };
+}
+function resolveDefaultServiceEnvironment() {
+    const defaultAgent = createDefaultAppConfig(process.env).agents[0];
+    const provider = defaultAgent?.model?.provider;
+    if (!provider) {
+        return undefined;
+    }
+    const entries = getProviderEnvironmentVariables(provider)
+        .map((name) => [name, process.env[name]?.trim()])
+        .filter((entry) => Boolean(entry[1] && entry[1].length > 0));
+    if (entries.length === 0) {
+        return undefined;
+    }
+    return Object.fromEntries(entries);
+}
+async function resolveInitConfig() {
+    if (!process.stdin.isTTY || !process.stdout.isTTY) {
+        throw new Error("`imp init` requires an interactive terminal. Re-run with --defaults to skip prompts.");
+    }
+    try {
+        return await promptForInitialAppConfig();
+    }
+    catch (error) {
+        if (isPromptExitError(error)) {
+            throw new Error("Config initialization cancelled.");
+        }
+        throw error;
+    }
+}
+function isPromptExitError(error) {
+    return error instanceof Error && error.name === "ExitPromptError";
+}
+//# sourceMappingURL=init-config-use-case.js.map

package/dist/application/init-config-use-case.js.map

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

package/dist/application/message-processor.d.ts

@@ -0,0 +1,19 @@
+import type { IncomingMessage } from "../domain/message.js";
+import type { OutgoingMessageDeliveryAction } from "../domain/message.js";
+import type { Logger } from "../logging/types.js";
+import type { TransportHandler, TransportInboundEvent } from "../transports/types.js";
+export interface MessageProcessorDependencies {
+    handler: {
+        handle(message: IncomingMessage): Promise<import("../domain/message.js").OutgoingMessage>;
+    };
+    logger?: Logger;
+    maxParallel?: number;
+    shouldRetry?: (error: unknown, attempt: number, event: TransportInboundEvent) => boolean | Promise<boolean>;
+    retryDelayMs?: (attempt: number, event: TransportInboundEvent) => number | Promise<number>;
+    onError?: (error: unknown, attempt: number, event: TransportInboundEvent) => Promise<void> | void;
+    onRetry?: (error: unknown, attempt: number, event: TransportInboundEvent) => Promise<void> | void;
+    prepareEvent?: (event: TransportInboundEvent) => Promise<TransportInboundEvent> | TransportInboundEvent;
+    afterDeliveryAction?: (action: OutgoingMessageDeliveryAction, event: TransportInboundEvent) => Promise<void> | void;
+}
+export type MessageProcessor = TransportHandler;
+export declare function createMessageProcessor(dependencies: MessageProcessorDependencies): MessageProcessor;

package/dist/application/message-processor.js

@@ -0,0 +1,122 @@
+import { priorityInboundCommands } from "./commands/priority-inbound-commands.js";
+export function createMessageProcessor(dependencies) {
+    const semaphore = createSemaphore(Math.max(1, dependencies.maxParallel ?? 4));
+    const conversationQueues = new Map();
+    return {
+        async handle(event) {
+            const preparedEvent = await dependencies.prepareEvent?.(event) ?? event;
+            if (shouldBypassConversationQueue(preparedEvent.message)) {
+                await semaphore.withPermit(async () => {
+                    await processEvent(preparedEvent, dependencies);
+                });
+                return;
+            }
+            await enqueueByConversation(preparedEvent, async () => {
+                await semaphore.withPermit(async () => {
+                    await processEvent(preparedEvent, dependencies);
+                });
+            });
+        },
+    };
+    async function enqueueByConversation(event, operation) {
+        const key = "sessionId" in event.message.conversation && event.message.conversation.sessionId
+            ? `${event.message.conversation.transport}/${event.message.conversation.externalId}/${event.message.conversation.sessionId}`
+            : `${event.message.conversation.transport}/${event.message.conversation.externalId}`;
+        const previous = conversationQueues.get(key) ?? Promise.resolve();
+        let release;
+        const current = new Promise((resolve) => {
+            release = resolve;
+        });
+        const next = previous.catch(() => undefined).then(() => current);
+        conversationQueues.set(key, next);
+        await previous.catch(() => undefined);
+        try {
+            await operation();
+        }
+        finally {
+            release?.();
+            if (conversationQueues.get(key) === next) {
+                conversationQueues.delete(key);
+            }
+        }
+    }
+}
+function shouldBypassConversationQueue(message) {
+    return Boolean(message.command && priorityInboundCommands.has(message.command));
+}
+async function processEvent(event, dependencies) {
+    let attempt = 1;
+    for (;;) {
+        try {
+            await event.runWithProcessing(async () => {
+                const response = await dependencies.handler.handle(event.message);
+                await event.deliver(response);
+                if (response.deliveryAction) {
+                    await dependencies.afterDeliveryAction?.(response.deliveryAction, event);
+                }
+            });
+            return;
+        }
+        catch (error) {
+            const shouldRetry = await dependencies.shouldRetry?.(error, attempt, event);
+            if (shouldRetry) {
+                await dependencies.onRetry?.(error, attempt, event);
+                const retryDelayMs = (await dependencies.retryDelayMs?.(attempt, event)) ?? 0;
+                if (retryDelayMs > 0) {
+                    await delay(retryDelayMs);
+                }
+                attempt += 1;
+                continue;
+            }
+            await dependencies.logger?.error("failed to process inbound message", {
+                endpointId: event.message.endpointId,
+                transport: event.message.conversation.transport,
+                conversationId: event.message.conversation.externalId,
+                messageId: event.message.messageId,
+                correlationId: event.message.correlationId,
+                errorType: error instanceof Error ? error.name : typeof error,
+            }, error);
+            await dependencies.onError?.(error, attempt, event);
+            await event.deliverError?.(error);
+            return;
+        }
+    }
+}
+function createSemaphore(maxPermits) {
+    let activePermits = 0;
+    const waiters = [];
+    async function acquirePermit() {
+        if (activePermits < maxPermits && waiters.length === 0) {
+            activePermits += 1;
+            return;
+        }
+        await new Promise((resolve) => {
+            waiters.push(() => {
+                activePermits += 1;
+                resolve();
+            });
+        });
+    }
+    function releasePermit() {
+        activePermits -= 1;
+        const next = waiters.shift();
+        next?.();
+    }
+    return {
+        async withPermit(operation) {
+            await acquirePermit();
+            try {
+                return await operation();
+            }
+            finally {
+                releasePermit();
+            }
+        },
+    };
+}
+async function delay(ms) {
+    await new Promise((resolve) => {
+        setTimeout(resolve, ms);
+    });
+}
+//# sourceMappingURL=message-processor.js.map