@tschmz/imp 0.1.0

package/dist/logging/view-logs.js

@@ -0,0 +1,171 @@
+import { readFile, watch } from "node:fs/promises";
+export async function viewDaemonLogs(options) {
+    const stdout = options.stdout ?? process.stdout;
+    const readFileImpl = options.dependencies?.readFile ?? readFile;
+    const watchImpl = options.dependencies?.watch ?? watch;
+    const lines = options.lines ?? 50;
+    assertPositiveLineCount(lines);
+    const targets = resolveLogTargets(options.runtimeConfig, options.endpointId);
+    const multiEndpoint = targets.length > 1;
+    for (const target of targets) {
+        const recentLines = await readRecentLogLines(target.logFilePath, lines, readFileImpl);
+        writeLogLines(stdout, target.endpointId, recentLines, multiEndpoint);
+    }
+    if (!options.follow) {
+        return;
+    }
+    await followLogTargets({
+        targets,
+        stdout,
+        signal: options.signal,
+        multiEndpoint,
+        readFile: readFileImpl,
+        watch: watchImpl,
+    });
+}
+export function resolveLogTargets(runtimeConfig, endpointId) {
+    if (endpointId) {
+        const targetBot = runtimeConfig.activeEndpoints.find((endpoint) => endpoint.id === endpointId);
+        if (!targetBot) {
+            throw new Error(`Unknown endpoint ID: ${endpointId}`);
+        }
+        return [
+            {
+                endpointId: targetBot.id,
+                logFilePath: targetBot.paths.logFilePath,
+            },
+        ];
+    }
+    return runtimeConfig.activeEndpoints.map((endpoint) => ({
+        endpointId: endpoint.id,
+        logFilePath: endpoint.paths.logFilePath,
+    }));
+}
+export async function readRecentLogLines(logFilePath, lines, readFileImpl = readFile) {
+    try {
+        const content = await readFileImpl(logFilePath, "utf8");
+        const allLines = content
+            .split("\n")
+            .map((line) => line.trimEnd())
+            .filter((line) => line.length > 0);
+        return allLines.slice(-lines);
+    }
+    catch (error) {
+        if (isMissingFileError(error)) {
+            throw new Error(`Log file not found: ${logFilePath}`);
+        }
+        throw error;
+    }
+}
+async function followLogTargets(options) {
+    const abortController = options.signal ? undefined : new AbortController();
+    const signal = options.signal ?? abortController?.signal;
+    const cleanup = registerFollowCleanup(abortController);
+    const offsets = new Map();
+    const watchers = [];
+    const pendingWatchTasks = [];
+    try {
+        for (const target of options.targets) {
+            const content = await options.readFile(target.logFilePath, "utf8");
+            offsets.set(target.endpointId, content.length);
+            const watcher = options.watch(target.logFilePath, {
+                signal,
+            });
+            watchers.push(watcher);
+            pendingWatchTasks.push(watchTarget(watcher, target, options, offsets));
+        }
+        if (!signal) {
+            return;
+        }
+        await waitForAbort(signal);
+    }
+    finally {
+        cleanup.dispose();
+        await Promise.allSettled(watchers.map((watcher) => closeWatcher(watcher)));
+        await Promise.allSettled(pendingWatchTasks);
+    }
+}
+async function watchTarget(watcher, target, options, offsets) {
+    try {
+        for await (const event of watcher) {
+            if (event.eventType !== "change") {
+                continue;
+            }
+            const content = await options.readFile(target.logFilePath, "utf8");
+            const previousOffset = offsets.get(target.endpointId) ?? 0;
+            const nextChunk = content.slice(previousOffset);
+            offsets.set(target.endpointId, content.length);
+            const newLines = nextChunk
+                .split("\n")
+                .map((line) => line.trimEnd())
+                .filter((line) => line.length > 0);
+            writeLogLines(options.stdout, target.endpointId, newLines, options.multiEndpoint);
+        }
+    }
+    catch (error) {
+        if (isAbortError(error)) {
+            return;
+        }
+        throw error;
+    }
+}
+function writeLogLines(stdout, endpointId, lines, multiEndpoint) {
+    for (const line of lines) {
+        stdout.write(multiEndpoint ? `[${endpointId}] ${line}\n` : `${line}\n`);
+    }
+}
+function assertPositiveLineCount(lines) {
+    if (!Number.isInteger(lines) || lines <= 0) {
+        throw new Error("`--lines` must be a positive integer.");
+    }
+}
+function registerFollowCleanup(abortController) {
+    if (!abortController) {
+        return {
+            dispose() { },
+        };
+    }
+    const abort = () => {
+        abortController.abort();
+    };
+    process.once("SIGINT", abort);
+    process.once("SIGTERM", abort);
+    return {
+        dispose() {
+            process.off("SIGINT", abort);
+            process.off("SIGTERM", abort);
+        },
+    };
+}
+function waitForAbort(signal) {
+    if (signal.aborted) {
+        return Promise.resolve();
+    }
+    return new Promise((resolve) => {
+        signal.addEventListener("abort", () => resolve(), { once: true });
+    });
+}
+async function closeWatcher(watcher) {
+    const iterator = watcher[Symbol.asyncIterator]();
+    if (typeof iterator.return !== "function") {
+        return;
+    }
+    try {
+        await iterator.return();
+    }
+    catch (error) {
+        if (isAbortError(error)) {
+            return;
+        }
+        throw error;
+    }
+}
+function isMissingFileError(error) {
+    return error instanceof Error && "code" in error && error.code === "ENOENT";
+}
+function isAbortError(error) {
+    return (error instanceof Error &&
+        (error.name === "AbortError" ||
+            (error.name === "Error" && error.message.includes("This operation was aborted"))));
+}
+//# sourceMappingURL=view-logs.js.map

package/dist/logging/view-logs.js.map

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

package/dist/main.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/main.js

@@ -0,0 +1,109 @@
+#!/usr/bin/env node
+import { createBackupUseCases } from "./application/backup-use-cases.js";
+import { createGetConfigValueUseCase } from "./application/get-config-value-use-case.js";
+import { createInitConfigUseCase } from "./application/init-config-use-case.js";
+import { createReloadConfigUseCase } from "./application/reload-config-use-case.js";
+import { createRunDaemonUseCase } from "./application/run-daemon-use-case.js";
+import { createServiceUseCases } from "./application/service-use-cases.js";
+import { createSetConfigValueUseCase } from "./application/set-config-value-use-case.js";
+import { createValidateConfigUseCase } from "./application/validate-config-use-case.js";
+import { createViewLogsUseCase } from "./application/view-logs-use-case.js";
+import { createCli } from "./cli/create-cli.js";
+import { ConfigurationError, RuntimeStateError, TransportResolutionError, UnsupportedPlatformError, } from "./domain/errors.js";
+import { createDaemonStartupFailureReporter } from "./logging/daemon-startup-failure-reporter.js";
+const EXIT_CODES = {
+    unknown: 1,
+    configuration: 2,
+    unsupportedPlatform: 3,
+    transportResolution: 4,
+    runtimeState: 5,
+};
+async function main() {
+    const serviceUseCases = createServiceUseCases();
+    const startupFailureReporter = createDaemonStartupFailureReporter();
+    const runDaemonUseCase = createRunDaemonUseCase({ startupFailureReporter });
+    const validateConfigUseCase = createValidateConfigUseCase();
+    const backupUseCases = createBackupUseCases();
+    const cli = createCli({
+        startDaemon: async (options) => {
+            const outcome = await runDaemonUseCase(options);
+            presentRunDaemonOutcome(outcome);
+        },
+        viewLogs: createViewLogsUseCase(),
+        validateConfig: validateConfigUseCase,
+        reloadConfig: createReloadConfigUseCase(),
+        getConfigValue: createGetConfigValueUseCase(),
+        setConfigValue: createSetConfigValueUseCase(),
+        initConfig: createInitConfigUseCase(),
+        createBackup: backupUseCases.createBackup,
+        restoreBackup: backupUseCases.restoreBackup,
+        installService: serviceUseCases.installService,
+        uninstallService: serviceUseCases.uninstallService,
+        startService: serviceUseCases.startService,
+        stopService: serviceUseCases.stopService,
+        restartService: serviceUseCases.restartService,
+        statusService: serviceUseCases.statusService,
+    });
+    if (process.argv.length <= 2) {
+        cli.outputHelp();
+        return;
+    }
+    await cli.parseAsync(process.argv);
+}
+function presentRunDaemonOutcome(outcome) {
+    if (outcome.status === "started") {
+        return;
+    }
+    presentCliError(outcome.error);
+}
+function presentCliError(error) {
+    const normalizedError = normalizeCliError(error);
+    console.error(`${normalizedError.label}: ${normalizedError.message}`);
+    process.exitCode = normalizedError.exitCode;
+}
+function normalizeCliError(error) {
+    if (error instanceof ConfigurationError) {
+        return {
+            label: "Configuration error",
+            message: error.message,
+            exitCode: EXIT_CODES.configuration,
+        };
+    }
+    if (error instanceof UnsupportedPlatformError) {
+        return {
+            label: "Unsupported platform",
+            message: error.message,
+            exitCode: EXIT_CODES.unsupportedPlatform,
+        };
+    }
+    if (error instanceof TransportResolutionError) {
+        return {
+            label: "Transport resolution error",
+            message: error.message,
+            exitCode: EXIT_CODES.transportResolution,
+        };
+    }
+    if (error instanceof RuntimeStateError) {
+        return {
+            label: "Runtime state error",
+            message: error.message,
+            exitCode: EXIT_CODES.runtimeState,
+        };
+    }
+    if (error instanceof Error) {
+        return {
+            label: "Unexpected error",
+            message: error.message,
+            exitCode: EXIT_CODES.unknown,
+        };
+    }
+    return {
+        label: "Unexpected error",
+        message: String(error),
+        exitCode: EXIT_CODES.unknown,
+    };
+}
+main().catch((error) => {
+    presentCliError(error);
+});
+//# sourceMappingURL=main.js.map

package/dist/main.js.map

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

package/dist/plugins/hook-runner.d.ts

@@ -0,0 +1,11 @@
+import type { Logger } from "../logging/types.js";
+import type { HookRegistration, MaybePromise } from "./types.js";
+export type HookFn<TContext> = (context: TContext) => MaybePromise<void>;
+export interface HookRunnerOptions {
+    logger?: Logger;
+}
+export interface HookRunner<THooks> {
+    run<TContext>(hookName: string, selectHook: (hooks: THooks) => HookFn<TContext> | undefined, context: TContext): Promise<void>;
+    runErrorHook<TContext>(hookName: string, selectHook: (hooks: THooks) => HookFn<TContext> | undefined, context: TContext): Promise<void>;
+}
+export declare function createHookRunner<THooks>(registrations?: ReadonlyArray<HookRegistration<THooks>>, options?: HookRunnerOptions): HookRunner<THooks>;

package/dist/plugins/hook-runner.js

@@ -0,0 +1,41 @@
+export function createHookRunner(registrations = [], options = {}) {
+    return {
+        async run(hookName, selectHook, context) {
+            for (const registration of registrations) {
+                const hook = selectHook(registration.hooks);
+                if (!hook) {
+                    continue;
+                }
+                try {
+                    await hook(context);
+                }
+                catch (error) {
+                    await logHookFailure(options.logger, hookName, registration.name, error);
+                    throw error;
+                }
+            }
+        },
+        async runErrorHook(hookName, selectHook, context) {
+            for (const registration of registrations) {
+                const hook = selectHook(registration.hooks);
+                if (!hook) {
+                    continue;
+                }
+                try {
+                    await hook(context);
+                }
+                catch (error) {
+                    await logHookFailure(options.logger, hookName, registration.name, error);
+                }
+            }
+        },
+    };
+}
+async function logHookFailure(logger, hookName, registrationName, error) {
+    await logger?.error("plugin hook failed", {
+        hookName,
+        hookRegistrationName: registrationName,
+        errorType: error instanceof Error ? error.name : typeof error,
+    }, error instanceof Error ? error : new Error(String(error ?? "Unknown hook error")));
+}
+//# sourceMappingURL=hook-runner.js.map

package/dist/plugins/hook-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-runner.js","sourceRoot":"","sources":["../../src/plugins/hook-runner.ts"],"names":[],"mappings":"AAsBA,MAAM,UAAU,gBAAgB,CAC9B,gBAAyD,EAAE,EAC3D,UAA6B,EAAE;IAE/B,OAAO;QACL,KAAK,CAAC,GAAG,CACP,QAAgB,EAChB,UAA2D,EAC3D,OAAiB;YAEjB,KAAK,MAAM,YAAY,IAAI,aAAa,EAAE,CAAC;gBACzC,MAAM,IAAI,GAAG,UAAU,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;gBAC5C,IAAI,CAAC,IAAI,EAAE,CAAC;oBACV,SAAS;gBACX,CAAC;gBAED,IAAI,CAAC;oBACH,MAAM,IAAI,CAAC,OAAO,CAAC,CAAC;gBACtB,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,MAAM,cAAc,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,EAAE,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;oBACzE,MAAM,KAAK,CAAC;gBACd,CAAC;YACH,CAAC;QACH,CAAC;QAED,KAAK,CAAC,YAAY,CAChB,QAAgB,EAChB,UAA2D,EAC3D,OAAiB;YAEjB,KAAK,MAAM,YAAY,IAAI,aAAa,EAAE,CAAC;gBACzC,MAAM,IAAI,GAAG,UAAU,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;gBAC5C,IAAI,CAAC,IAAI,EAAE,CAAC;oBACV,SAAS;gBACX,CAAC;gBAED,IAAI,CAAC;oBACH,MAAM,IAAI,CAAC,OAAO,CAAC,CAAC;gBACtB,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,MAAM,cAAc,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,EAAE,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;gBAC3E,CAAC;YACH,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,cAAc,CAC3B,MAA0B,EAC1B,QAAgB,EAChB,gBAAwB,EACxB,KAAc;IAEd,MAAM,MAAM,EAAE,KAAK,CACjB,oBAAoB,EACpB;QACE,QAAQ;QACR,oBAAoB,EAAE,gBAAgB;QACtC,SAAS,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,KAAK;KAC9D,EACD,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,IAAI,oBAAoB,CAAC,CAAC,CAClF,CAAC;AACJ,CAAC"}

package/dist/plugins/index.d.ts

@@ -0,0 +1,2 @@
+export { createHookRunner, type HookFn, type HookRunner } from "./hook-runner.js";
+export type { AgentEngineLifecycleHooks, AgentEngineRunErrorContext, AgentEngineRunStartContext, AgentEngineRunSuccessContext, CommandContribution, HookRegistration, ImpPlugin, InboundMessageErrorContext, InboundMessageLifecycleHooks, InboundMessageStartContext, InboundMessageSuccessContext, MaybePromise, PluginContributions, PluginHooks, ToolContribution, } from "./types.js";

package/dist/plugins/index.js

@@ -0,0 +1,2 @@
+export { createHookRunner } from "./hook-runner.js";
+//# sourceMappingURL=index.js.map

package/dist/plugins/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/plugins/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAgC,MAAM,kBAAkB,CAAC"}

package/dist/plugins/types.d.ts

@@ -0,0 +1,64 @@
+import type { InboundCommandHandler } from "../application/commands/types.js";
+import type { AgentRunInput, AgentRunResult } from "../runtime/context.js";
+import type { ToolDefinition } from "../tools/types.js";
+import type { IncomingMessage, OutgoingMessage } from "../domain/message.js";
+export type MaybePromise<T> = T | Promise<T>;
+export interface InboundMessageStartContext {
+    message: IncomingMessage;
+}
+export interface InboundMessageSuccessContext {
+    message: IncomingMessage;
+    response: OutgoingMessage;
+    durationMs: number;
+}
+export interface InboundMessageErrorContext {
+    message: IncomingMessage;
+    error: unknown;
+    durationMs: number;
+}
+export interface InboundMessageLifecycleHooks {
+    onInboundMessageStart?(context: InboundMessageStartContext): MaybePromise<void>;
+    onInboundMessageSuccess?(context: InboundMessageSuccessContext): MaybePromise<void>;
+    onInboundMessageError?(context: InboundMessageErrorContext): MaybePromise<void>;
+}
+export interface AgentEngineRunStartContext {
+    input: AgentRunInput;
+}
+export interface AgentEngineRunSuccessContext {
+    input: AgentRunInput;
+    result: AgentRunResult;
+    durationMs: number;
+}
+export interface AgentEngineRunErrorContext {
+    input: AgentRunInput;
+    error: unknown;
+    durationMs: number;
+}
+export interface AgentEngineLifecycleHooks {
+    onAgentEngineRunStart?(context: AgentEngineRunStartContext): MaybePromise<void>;
+    onAgentEngineRunSuccess?(context: AgentEngineRunSuccessContext): MaybePromise<void>;
+    onAgentEngineRunError?(context: AgentEngineRunErrorContext): MaybePromise<void>;
+}
+export interface CommandContribution {
+    inboundCommands: ReadonlyArray<InboundCommandHandler>;
+}
+export interface ToolContribution {
+    tools: ReadonlyArray<ToolDefinition>;
+}
+export interface PluginHooks {
+    inboundMessage?: InboundMessageLifecycleHooks;
+    agentEngine?: AgentEngineLifecycleHooks;
+}
+export interface PluginContributions {
+    commands?: CommandContribution;
+    tools?: ToolContribution;
+}
+export interface ImpPlugin {
+    id: string;
+    hooks?: PluginHooks;
+    contributions?: PluginContributions;
+}
+export interface HookRegistration<THooks> {
+    name: string;
+    hooks: THooks;
+}

package/dist/plugins/types.js

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

package/dist/plugins/types.js.map

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

package/dist/runtime/agent-execution.d.ts

@@ -0,0 +1,42 @@
+import { Agent, type AgentOptions } from "@mariozechner/pi-agent-core";
+import type { Api as AiApi, Model } from "@mariozechner/pi-ai";
+import type { AgentDefinition } from "../domain/agent.js";
+import type { ConversationEvent } from "../domain/conversation.js";
+import type { ToolDefinition } from "../tools/types.js";
+import { toAgentMessages } from "./message-mapping.js";
+import type { WorkingDirectoryState } from "./tool-resolution.js";
+export type AgentHandle = Pick<Agent, "prompt"> & {
+    state: Pick<Agent["state"], "messages">;
+} & Partial<Pick<Agent, "subscribe">>;
+export interface ExecuteAgentOptions {
+    createAgent?: (options: AgentOptions) => AgentHandle;
+    getApiKey?: (provider: string, agent: AgentDefinition) => Promise<string | undefined> | string | undefined;
+    agent: AgentDefinition;
+    model: Model<AiApi>;
+    systemPrompt: string;
+    tools: ToolDefinition[];
+    userText: string;
+    conversationMessages: Parameters<typeof toAgentMessages>[0];
+    onPayload: AgentOptions["onPayload"];
+    workingDirectoryState: WorkingDirectoryState;
+    initialWorkingDirectory: string;
+    conversation: {
+        transport: string;
+        externalId: string;
+    };
+    parentMessageId: string;
+    correlationId: string;
+}
+export interface ExecuteAgentResult {
+    message: {
+        conversation: {
+            transport: string;
+            externalId: string;
+        };
+        text: string;
+    };
+    conversationEvents: ConversationEvent[];
+    workingDirectory?: string;
+}
+export declare function defaultCreateAgent(options: AgentOptions): AgentHandle;
+export declare function executeAgent(options: ExecuteAgentOptions): Promise<ExecuteAgentResult>;

package/dist/runtime/agent-execution.js

@@ -0,0 +1,109 @@
+import { Agent, } from "@mariozechner/pi-agent-core";
+import { getAssistantText, toAgentMessages, toConversationEvents } from "./message-mapping.js";
+export function defaultCreateAgent(options) {
+    return new Agent(options);
+}
+export async function executeAgent(options) {
+    const createAgent = options.createAgent ?? defaultCreateAgent;
+    const initialMessages = toAgentMessages(options.conversationMessages, options.model);
+    const agent = createAgent({
+        initialState: {
+            systemPrompt: options.systemPrompt,
+            model: options.model,
+            thinkingLevel: "off",
+            tools: options.tools,
+            messages: initialMessages,
+        },
+        ...(options.getApiKey
+            ? {
+                getApiKey: (provider) => options.getApiKey?.(provider, options.agent),
+            }
+            : {}),
+        ...(options.onPayload ? { onPayload: options.onPayload } : {}),
+    });
+    const eventMessages = collectConversationEventMessages(agent);
+    try {
+        await agent.prompt(options.userText);
+    }
+    finally {
+        eventMessages.unsubscribe?.();
+    }
+    const appendedMessages = eventMessages.messages.length > 0
+        ? eventMessages.messages
+        : agent.state.messages.slice(initialMessages.length);
+    const assistantMessage = [...agent.state.messages]
+        .reverse()
+        .find((message) => message.role === "assistant");
+    if (!assistantMessage) {
+        throw new Error(`Agent "${options.agent.id}" did not produce an assistant message.`);
+    }
+    if (assistantMessage.stopReason === "error" || assistantMessage.stopReason === "aborted") {
+        throw new Error(`Agent "${options.agent.id}" failed: ` +
+            `${assistantMessage.errorMessage ?? "unknown upstream error"}`);
+    }
+    const responseText = getAssistantText(assistantMessage);
+    if (!responseText.trim()) {
+        throw new Error(`Agent "${options.agent.id}" produced an assistant message without text content.`);
+    }
+    return {
+        message: {
+            conversation: options.conversation,
+            text: responseText,
+        },
+        conversationEvents: toConversationEvents(appendedMessages, {
+            parentMessageId: options.parentMessageId,
+            correlationId: options.correlationId,
+        }),
+        ...(options.workingDirectoryState.get() !== options.initialWorkingDirectory
+            ? { workingDirectory: options.workingDirectoryState.get() }
+            : {}),
+    };
+}
+function collectConversationEventMessages(agent) {
+    const messages = [];
+    const seen = new Set();
+    const recordMessage = (message) => {
+        if (message.role !== "assistant" && message.role !== "toolResult") {
+            return;
+        }
+        const key = getAgentMessageKey(message);
+        if (seen.has(key)) {
+            return;
+        }
+        seen.add(key);
+        messages.push(message);
+    };
+    const unsubscribe = agent.subscribe?.((event) => {
+        if (isConversationMessageEvent(event)) {
+            recordMessage(event.message);
+        }
+    });
+    return { messages, unsubscribe };
+}
+function isConversationMessageEvent(event) {
+    return event.type === "message_end";
+}
+function getAgentMessageKey(message) {
+    if (message.role === "toolResult") {
+        return JSON.stringify([
+            message.role,
+            message.timestamp,
+            message.toolCallId,
+            message.toolName,
+            message.isError,
+            message.content,
+            message.details ?? null,
+        ]);
+    }
+    return JSON.stringify([
+        message.role,
+        message.timestamp,
+        message.responseId ?? null,
+        message.provider,
+        message.model,
+        message.stopReason,
+        message.errorMessage ?? null,
+        message.content,
+    ]);
+}
+//# sourceMappingURL=agent-execution.js.map

package/dist/runtime/agent-execution.js.map

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

package/dist/runtime/context.d.ts

@@ -0,0 +1,20 @@
+import type { AgentDefinition } from "../domain/agent.js";
+import type { ConversationContext, ConversationEvent } from "../domain/conversation.js";
+import type { IncomingMessage, OutgoingMessage } from "../domain/message.js";
+import type { SkillDefinition } from "../skills/types.js";
+export interface AgentRunRuntimeContext {
+    configPath?: string;
+    dataRoot?: string;
+    availableSkills?: SkillDefinition[];
+}
+export interface AgentRunInput {
+    agent: AgentDefinition;
+    conversation: ConversationContext;
+    message: IncomingMessage;
+    runtime?: AgentRunRuntimeContext;
+}
+export interface AgentRunResult {
+    message: OutgoingMessage;
+    conversationEvents: ConversationEvent[];
+    workingDirectory?: string;
+}

package/dist/runtime/context.js

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

package/dist/runtime/context.js.map

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

package/dist/runtime/create-oauth-api-key-resolver.d.ts

@@ -0,0 +1,9 @@
+import { getOAuthApiKey } from "@mariozechner/pi-ai/oauth";
+import type { Logger } from "../logging/types.js";
+interface OAuthApiKeyResolverDependencies {
+    readTextFile?: (path: string) => Promise<string>;
+    writeTextFile?: (path: string, content: string) => Promise<void>;
+    getOAuthApiKeyFn?: typeof getOAuthApiKey;
+}
+export declare function createOAuthApiKeyResolver(authFilePath: string | undefined, logger?: Logger, dependencies?: OAuthApiKeyResolverDependencies): (provider: string) => Promise<string | undefined>;
+export {};