@tschmz/imp 0.1.0

package/dist/runtime/message-mapping.js

@@ -0,0 +1,129 @@
+const TRANSCRIBED_MESSAGE_PREFIX = "[Transcribed from a Telegram voice message. Automatic speech recognition may contain mistakes. If the request seems unclear or inconsistent with the conversation, ask a brief clarifying question before acting on uncertain details.]\n";
+const EMPTY_USAGE = {
+    input: 0,
+    output: 0,
+    cacheRead: 0,
+    cacheWrite: 0,
+    totalTokens: 0,
+    cost: {
+        input: 0,
+        output: 0,
+        cacheRead: 0,
+        cacheWrite: 0,
+        total: 0,
+    },
+};
+export function toAgentMessages(messages, model) {
+    return messages.map((message) => {
+        if (message.role === "user") {
+            return {
+                role: "user",
+                content: renderUserMessageContent(message),
+                timestamp: resolveMessageTimestamp(message),
+            };
+        }
+        if (message.role === "toolResult") {
+            return {
+                role: "toolResult",
+                toolCallId: message.toolCallId,
+                toolName: message.toolName,
+                content: message.content,
+                ...(message.details !== undefined ? { details: message.details } : {}),
+                isError: message.isError ?? false,
+                timestamp: resolveMessageTimestamp(message),
+            };
+        }
+        return {
+            role: "assistant",
+            content: message.content,
+            api: message.api ?? model.api,
+            provider: message.provider ?? model.provider,
+            model: message.model ?? model.id,
+            ...(message.responseId ? { responseId: message.responseId } : {}),
+            usage: message.usage ?? EMPTY_USAGE,
+            stopReason: message.stopReason ?? inferLegacyAssistantStopReason(message),
+            ...(message.errorMessage ? { errorMessage: message.errorMessage } : {}),
+            timestamp: resolveMessageTimestamp(message),
+        };
+    });
+}
+export function toConversationEvents(messages, options) {
+    let assistantIndex = 0;
+    let toolResultIndex = 0;
+    return messages.flatMap((message) => {
+        if (message.role === "user") {
+            return [];
+        }
+        if (message.role === "toolResult") {
+            toolResultIndex += 1;
+            return {
+                kind: "message",
+                id: `${options.parentMessageId}:tool-result:${toolResultIndex}`,
+                role: "toolResult",
+                createdAt: new Date(message.timestamp).toISOString(),
+                correlationId: options.correlationId,
+                timestamp: message.timestamp,
+                toolCallId: message.toolCallId,
+                toolName: message.toolName,
+                content: message.content,
+                ...(message.details !== undefined ? { details: message.details } : {}),
+                isError: message.isError,
+            };
+        }
+        if (message.role !== "assistant") {
+            return [];
+        }
+        assistantIndex += 1;
+        return {
+            kind: "message",
+            id: assistantIndex === 1 && messages.filter((candidate) => candidate.role === "assistant").length === 1
+                ? `${options.parentMessageId}:assistant`
+                : `${options.parentMessageId}:assistant:${assistantIndex}`,
+            role: "assistant",
+            createdAt: new Date(message.timestamp).toISOString(),
+            correlationId: options.correlationId,
+            timestamp: message.timestamp,
+            content: message.content,
+            api: message.api,
+            provider: message.provider,
+            model: message.model,
+            ...(message.responseId ? { responseId: message.responseId } : {}),
+            usage: message.usage,
+            stopReason: message.stopReason,
+            ...(message.errorMessage ? { errorMessage: message.errorMessage } : {}),
+        };
+    });
+}
+function renderUserMessageContent(message) {
+    if (message.source?.kind !== "telegram-voice-transcript") {
+        return message.content;
+    }
+    if (typeof message.content === "string") {
+        return `${TRANSCRIBED_MESSAGE_PREFIX}${message.content}`;
+    }
+    return [
+        { type: "text", text: TRANSCRIBED_MESSAGE_PREFIX.trimEnd() },
+        ...message.content,
+    ];
+}
+function resolveMessageTimestamp(message) {
+    if (typeof message.timestamp === "number" && Number.isFinite(message.timestamp)) {
+        return message.timestamp;
+    }
+    const parsed = Date.parse(message.createdAt);
+    return Number.isNaN(parsed) ? Date.now() : parsed;
+}
+function inferLegacyAssistantStopReason(message) {
+    if (message.errorMessage !== undefined) {
+        return "error";
+    }
+    return message.content.some((content) => content.type === "toolCall") ? "toolUse" : "stop";
+}
+export function getAssistantText(message) {
+    return message.content
+        .filter((content) => content.type === "text")
+        .map((content) => content.text)
+        .join("\n");
+}
+export { EMPTY_USAGE };
+//# sourceMappingURL=message-mapping.js.map

package/dist/runtime/message-mapping.js.map

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

package/dist/runtime/model-resolution.d.ts

@@ -0,0 +1,5 @@
+import { type Api as AiApi, type Model } from "@mariozechner/pi-ai";
+import type { AgentDefinition } from "../domain/agent.js";
+export type ModelResolver = (provider: string, modelId: string) => Model<AiApi> | undefined;
+export declare function defaultResolveModel(provider: string, modelId: string): Model<AiApi> | undefined;
+export declare function resolveModelOrThrow(agent: Pick<AgentDefinition, "id" | "model">, resolveModel: ModelResolver): Model<AiApi>;

package/dist/runtime/model-resolution.js

@@ -0,0 +1,13 @@
+import { getModel } from "@mariozechner/pi-ai";
+export function defaultResolveModel(provider, modelId) {
+    return getModel(provider, modelId);
+}
+export function resolveModelOrThrow(agent, resolveModel) {
+    const model = resolveModel(agent.model.provider, agent.model.modelId);
+    if (!model) {
+        throw new Error(`Unknown model for agent "${agent.id}": ` +
+            `${agent.model.provider}/${agent.model.modelId}`);
+    }
+    return model;
+}
+//# sourceMappingURL=model-resolution.js.map

package/dist/runtime/model-resolution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-resolution.js","sourceRoot":"","sources":["../../src/runtime/model-resolution.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAiC,MAAM,qBAAqB,CAAC;AAK9E,MAAM,UAAU,mBAAmB,CAAC,QAAgB,EAAE,OAAe;IACnE,OAAO,QAAQ,CAAC,QAAiB,EAAE,OAAgB,CAAC,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,KAA4C,EAC5C,YAA2B;IAE3B,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACtE,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CACb,4BAA4B,KAAK,CAAC,EAAE,KAAK;YACvC,GAAG,KAAK,CAAC,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,CACnD,CAAC;IACJ,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/runtime/pipeline/execute-agent-stage.d.ts

@@ -0,0 +1,12 @@
+import type { AgentOptions } from "@mariozechner/pi-agent-core";
+import type { AgentDefinition } from "../../domain/agent.js";
+import type { AgentHandle } from "../agent-execution.js";
+import type { AgentRunResult } from "../context.js";
+import type { ResolveToolsStageContext } from "./resolve-tools-stage.js";
+export interface ExecuteAgentStageContext extends ResolveToolsStageContext {
+    result: AgentRunResult;
+}
+export declare function executeAgentStage(context: ResolveToolsStageContext, dependencies: {
+    createAgent?: (options: AgentOptions) => AgentHandle;
+    getApiKey?: (provider: string, agent: AgentDefinition) => Promise<string | undefined> | string | undefined;
+}): Promise<ExecuteAgentStageContext>;

package/dist/runtime/pipeline/execute-agent-stage.js

@@ -0,0 +1,25 @@
+import { executeAgent } from "../agent-execution.js";
+import { createOnPayloadOverride } from "./resolve-tools-stage.js";
+export async function executeAgentStage(context, dependencies) {
+    const result = await executeAgent({
+        createAgent: dependencies.createAgent,
+        getApiKey: dependencies.getApiKey,
+        agent: context.agent,
+        model: context.model,
+        systemPrompt: context.systemPromptResolution.systemPrompt,
+        tools: context.tools,
+        userText: context.input.message.text,
+        conversationMessages: context.conversation.messages,
+        onPayload: createOnPayloadOverride(context.agent),
+        workingDirectoryState: context.workingDirectoryState,
+        initialWorkingDirectory: context.initialWorkingDirectory,
+        conversation: context.input.message.conversation,
+        parentMessageId: context.input.message.messageId,
+        correlationId: context.input.message.correlationId,
+    });
+    return {
+        ...context,
+        result,
+    };
+}
+//# sourceMappingURL=execute-agent-stage.js.map

package/dist/runtime/pipeline/execute-agent-stage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute-agent-stage.js","sourceRoot":"","sources":["../../../src/runtime/pipeline/execute-agent-stage.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAErD,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAOnE,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,OAAiC,EACjC,YAMC;IAED,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC;QAChC,WAAW,EAAE,YAAY,CAAC,WAAW;QACrC,SAAS,EAAE,YAAY,CAAC,SAAS;QACjC,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,YAAY,EAAE,OAAO,CAAC,sBAAsB,CAAC,YAAY;QACzD,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,QAAQ,EAAE,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI;QACpC,oBAAoB,EAAE,OAAO,CAAC,YAAY,CAAC,QAAQ;QACnD,SAAS,EAAE,uBAAuB,CAAC,OAAO,CAAC,KAAK,CAAC;QACjD,qBAAqB,EAAE,OAAO,CAAC,qBAAqB;QACpD,uBAAuB,EAAE,OAAO,CAAC,uBAAuB;QACxD,YAAY,EAAE,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,YAAY;QAChD,eAAe,EAAE,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS;QAChD,aAAa,EAAE,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,aAAa;KACnD,CAAC,CAAC;IAEH,OAAO;QACL,GAAG,OAAO;QACV,MAAM;KACP,CAAC;AACJ,CAAC"}

package/dist/runtime/pipeline/resolve-model-stage.d.ts

@@ -0,0 +1,8 @@
+import { type ModelResolver } from "../model-resolution.js";
+import type { AgentRunContext } from "../types.js";
+export interface ResolveModelStageContext extends AgentRunContext {
+    model: NonNullable<AgentRunContext["model"]>;
+}
+export declare function resolveModelStage(context: AgentRunContext, dependencies: {
+    resolveModel: ModelResolver;
+}): ResolveModelStageContext;

package/dist/runtime/pipeline/resolve-model-stage.js

@@ -0,0 +1,9 @@
+import { resolveModelOrThrow } from "../model-resolution.js";
+export function resolveModelStage(context, dependencies) {
+    const model = resolveModelOrThrow(context.agent, dependencies.resolveModel);
+    return {
+        ...context,
+        model,
+    };
+}
+//# sourceMappingURL=resolve-model-stage.js.map

package/dist/runtime/pipeline/resolve-model-stage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-model-stage.js","sourceRoot":"","sources":["../../../src/runtime/pipeline/resolve-model-stage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAsB,MAAM,wBAAwB,CAAC;AAOjF,MAAM,UAAU,iBAAiB,CAC/B,OAAwB,EACxB,YAEC;IAED,MAAM,KAAK,GAAG,mBAAmB,CAAC,OAAO,CAAC,KAAK,EAAE,YAAY,CAAC,YAAY,CAAC,CAAC;IAC5E,OAAO;QACL,GAAG,OAAO;QACV,KAAK;KACN,CAAC;AACJ,CAAC"}

package/dist/runtime/pipeline/resolve-prompt-stage.d.ts

@@ -0,0 +1,12 @@
+import { type PromptTemplateSystemContext } from "../prompt-template.js";
+import { resolveSystemPrompt } from "../system-prompt-resolution.js";
+import type { SystemPromptCache } from "../system-prompt-cache.js";
+import type { ResolveModelStageContext } from "./resolve-model-stage.js";
+export interface ResolvePromptStageContext extends ResolveModelStageContext {
+    systemPromptResolution: Awaited<ReturnType<typeof resolveSystemPrompt>>;
+}
+export declare function resolvePromptStage(context: ResolveModelStageContext, dependencies: {
+    readTextFile: (path: string) => Promise<string>;
+    systemPromptCache: SystemPromptCache;
+    promptTemplateSystemContext: PromptTemplateSystemContext;
+}): Promise<ResolvePromptStageContext>;

package/dist/runtime/pipeline/resolve-prompt-stage.js

@@ -0,0 +1,30 @@
+import { createPromptTemplateContext } from "../prompt-template.js";
+import { resolveSystemPrompt } from "../system-prompt-resolution.js";
+export async function resolvePromptStage(context, dependencies) {
+    const promptWorkingDirectory = resolvePromptWorkingDirectory(context.agent, context.conversation);
+    const systemPromptResolution = await resolveSystemPrompt({
+        agent: context.agent,
+        promptWorkingDirectory,
+        templateContext: createPromptTemplateContext({
+            system: dependencies.promptTemplateSystemContext,
+            agent: context.agent,
+            endpointId: context.input.message.endpointId,
+            transportKind: context.input.message.conversation.transport,
+            configPath: context.input.runtime?.configPath,
+            dataRoot: context.input.runtime?.dataRoot,
+            availableSkills: context.input.runtime?.availableSkills,
+        }),
+        availableSkills: context.input.runtime?.availableSkills,
+        readTextFile: dependencies.readTextFile,
+        cache: dependencies.systemPromptCache,
+    });
+    return {
+        ...context,
+        promptWorkingDirectory,
+        systemPromptResolution,
+    };
+}
+function resolvePromptWorkingDirectory(agent, conversation) {
+    return conversation.state.workingDirectory ?? agent.workspace?.cwd;
+}
+//# sourceMappingURL=resolve-prompt-stage.js.map

package/dist/runtime/pipeline/resolve-prompt-stage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-prompt-stage.js","sourceRoot":"","sources":["../../../src/runtime/pipeline/resolve-prompt-stage.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,2BAA2B,EAAoC,MAAM,uBAAuB,CAAC;AACtG,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAQrE,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,OAAiC,EACjC,YAIC;IAED,MAAM,sBAAsB,GAAG,6BAA6B,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IAClG,MAAM,sBAAsB,GAAG,MAAM,mBAAmB,CAAC;QACvD,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,sBAAsB;QACtB,eAAe,EAAE,2BAA2B,CAAC;YAC3C,MAAM,EAAE,YAAY,CAAC,2BAA2B;YAChD,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,UAAU,EAAE,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU;YAC5C,aAAa,EAAE,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,SAAS;YAC3D,UAAU,EAAE,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,UAAU;YAC7C,QAAQ,EAAE,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,QAAQ;YACzC,eAAe,EAAE,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,eAAe;SACxD,CAAC;QACF,eAAe,EAAE,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,eAAe;QACvD,YAAY,EAAE,YAAY,CAAC,YAAY;QACvC,KAAK,EAAE,YAAY,CAAC,iBAAiB;KACtC,CAAC,CAAC;IAEH,OAAO;QACL,GAAG,OAAO;QACV,sBAAsB;QACtB,sBAAsB;KACvB,CAAC;AACJ,CAAC;AAED,SAAS,6BAA6B,CACpC,KAAsB,EACtB,YAAiC;IAEjC,OAAO,YAAY,CAAC,KAAK,CAAC,gBAAgB,IAAI,KAAK,CAAC,SAAS,EAAE,GAAG,CAAC;AACrE,CAAC"}

package/dist/runtime/pipeline/resolve-tools-stage.d.ts

@@ -0,0 +1,27 @@
+import type { AgentDefinition } from "../../domain/agent.js";
+import type { ToolRegistry } from "../../tools/registry.js";
+import type { McpToolCache } from "../mcp-tool-cache.js";
+import { createOnPayloadOverride, type WorkingDirectoryState } from "../tool-resolution.js";
+import type { AgentRunContext } from "../types.js";
+import type { ResolvePromptStageContext } from "./resolve-prompt-stage.js";
+export interface ResolveToolsStageContext extends ResolvePromptStageContext {
+    tools: NonNullable<AgentRunContext["tools"]>;
+    workingDirectoryState: WorkingDirectoryState;
+    initialWorkingDirectory: string;
+    toolResolution: {
+        configuredBuiltInTools: string[];
+        resolvedBuiltInTools: string[];
+        missingBuiltInTools: string[];
+        configuredMcpServers: string[];
+        initializedMcpServers: string[];
+        failedMcpServers: string[];
+        resolvedMcpTools: string[];
+        resolvedTools: string[];
+    };
+}
+export declare function resolveToolsStage(context: ResolvePromptStageContext, dependencies: {
+    toolRegistry?: ToolRegistry;
+    createBuiltInToolRegistry: (workingDirectory: string | WorkingDirectoryState, agent?: AgentDefinition) => ToolRegistry;
+    mcpToolCache: McpToolCache;
+}): Promise<ResolveToolsStageContext>;
+export { createOnPayloadOverride };

package/dist/runtime/pipeline/resolve-tools-stage.js

@@ -0,0 +1,46 @@
+import { createOnPayloadOverride, createLoadSkillTool, createWorkingDirectoryState, resolveAgentTools, resolveWorkingDirectory, } from "../tool-resolution.js";
+export async function resolveToolsStage(context, dependencies) {
+    const initialWorkingDirectory = resolveConversationWorkingDirectory(context.agent, context.conversation);
+    const workingDirectoryState = createWorkingDirectoryState(initialWorkingDirectory);
+    const toolRegistry = dependencies.toolRegistry
+        ?? dependencies.createBuiltInToolRegistry(workingDirectoryState, context.agent);
+    const configuredBuiltInTools = [...context.agent.tools];
+    const configuredTools = resolveAgentTools(context.agent, toolRegistry);
+    const builtInTools = resolveTurnBuiltInTools(configuredTools, context.input.runtime?.availableSkills ?? []);
+    const resolvedBuiltInTools = builtInTools.map((tool) => tool.name);
+    const missingBuiltInTools = configuredBuiltInTools.filter((name) => !resolvedBuiltInTools.includes(name));
+    const mcpToolResolution = await dependencies.mcpToolCache.resolve(context.agent);
+    const configuredMcpServers = context.agent.mcp?.servers.map((server) => server.id) ?? [];
+    const resolvedMcpTools = mcpToolResolution.tools.map((tool) => tool.name);
+    const resolvedTools = [...resolvedBuiltInTools, ...resolvedMcpTools];
+    return {
+        ...context,
+        initialWorkingDirectory,
+        workingDirectoryState,
+        toolResolution: {
+            configuredBuiltInTools,
+            resolvedBuiltInTools,
+            missingBuiltInTools,
+            configuredMcpServers,
+            initializedMcpServers: mcpToolResolution.initializedServerIds,
+            failedMcpServers: mcpToolResolution.failedServerIds,
+            resolvedMcpTools,
+            resolvedTools,
+        },
+        tools: [...builtInTools, ...mcpToolResolution.tools],
+    };
+}
+function resolveTurnBuiltInTools(builtInTools, availableSkills) {
+    if (!availableSkills || availableSkills.length === 0) {
+        return builtInTools;
+    }
+    return [
+        ...builtInTools.filter((tool) => tool.name !== "load_skill"),
+        createLoadSkillTool(availableSkills),
+    ];
+}
+function resolveConversationWorkingDirectory(agent, conversation) {
+    return conversation.state.workingDirectory ?? resolveWorkingDirectory(agent);
+}
+export { createOnPayloadOverride };
+//# sourceMappingURL=resolve-tools-stage.js.map

package/dist/runtime/pipeline/resolve-tools-stage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-tools-stage.js","sourceRoot":"","sources":["../../../src/runtime/pipeline/resolve-tools-stage.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,uBAAuB,EACvB,mBAAmB,EACnB,2BAA2B,EAC3B,iBAAiB,EACjB,uBAAuB,GAExB,MAAM,uBAAuB,CAAC;AAoB/B,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,OAAkC,EAClC,YAOC;IAED,MAAM,uBAAuB,GAAG,mCAAmC,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IACzG,MAAM,qBAAqB,GAAG,2BAA2B,CAAC,uBAAuB,CAAC,CAAC;IACnF,MAAM,YAAY,GAChB,YAAY,CAAC,YAAY;WACtB,YAAY,CAAC,yBAAyB,CAAC,qBAAqB,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IAClF,MAAM,sBAAsB,GAAG,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACxD,MAAM,eAAe,GAAG,iBAAiB,CAAC,OAAO,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC;IACvE,MAAM,YAAY,GAAG,uBAAuB,CAC1C,eAAe,EACf,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,eAAe,IAAI,EAAE,CAC7C,CAAC;IACF,MAAM,oBAAoB,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnE,MAAM,mBAAmB,GAAG,sBAAsB,CAAC,MAAM,CACvD,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,oBAAoB,CAAC,QAAQ,CAAC,IAAI,CAAC,CAC/C,CAAC;IACF,MAAM,iBAAiB,GAAG,MAAM,YAAY,CAAC,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACjF,MAAM,oBAAoB,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC;IACzF,MAAM,gBAAgB,GAAG,iBAAiB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1E,MAAM,aAAa,GAAG,CAAC,GAAG,oBAAoB,EAAE,GAAG,gBAAgB,CAAC,CAAC;IAErE,OAAO;QACL,GAAG,OAAO;QACV,uBAAuB;QACvB,qBAAqB;QACrB,cAAc,EAAE;YACd,sBAAsB;YACtB,oBAAoB;YACpB,mBAAmB;YACnB,oBAAoB;YACpB,qBAAqB,EAAE,iBAAiB,CAAC,oBAAoB;YAC7D,gBAAgB,EAAE,iBAAiB,CAAC,eAAe;YACnD,gBAAgB;YAChB,aAAa;SACd;QACD,KAAK,EAAE,CAAC,GAAG,YAAY,EAAE,GAAG,iBAAiB,CAAC,KAAK,CAAC;KACrD,CAAC;AACJ,CAAC;AAED,SAAS,uBAAuB,CAC9B,YAAkD,EAClD,eAAoF;IAEpF,IAAI,CAAC,eAAe,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrD,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,OAAO;QACL,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,YAAY,CAAC;QAC5D,mBAAmB,CAAC,eAAe,CAAC;KACrC,CAAC;AACJ,CAAC;AAED,SAAS,mCAAmC,CAC1C,KAAsB,EACtB,YAAiC;IAEjC,OAAO,YAAY,CAAC,KAAK,CAAC,gBAAgB,IAAI,uBAAuB,CAAC,KAAK,CAAC,CAAC;AAC/E,CAAC;AAED,OAAO,EAAE,uBAAuB,EAAE,CAAC"}

package/dist/runtime/prompt-template.d.ts

@@ -0,0 +1,54 @@
+import type { AgentDefinition } from "../domain/agent.js";
+import type { SkillDefinition } from "../skills/types.js";
+export interface PromptTemplateSystemContext {
+    os: string;
+    platform: string;
+    arch: string;
+    hostname: string;
+    username: string;
+    homeDir: string;
+}
+export interface PromptTemplateContext {
+    system: PromptTemplateSystemContext;
+    endpoint: {
+        id: string;
+    };
+    agent: {
+        id: string;
+        model: {
+            provider: string;
+            modelId: string;
+        };
+        authFile?: string;
+        workspace: {
+            cwd?: string;
+        };
+    };
+    transport: {
+        kind: string;
+    };
+    imp: {
+        configPath?: string;
+        dataRoot?: string;
+    };
+    skills: PromptTemplateSkillContext[];
+}
+export interface PromptTemplateSkillContext {
+    name: string;
+    description: string;
+    directoryPath: string;
+}
+export declare function createDefaultPromptTemplateSystemContext(): PromptTemplateSystemContext;
+export declare function createPromptTemplateContext(options: {
+    system: PromptTemplateSystemContext;
+    agent: AgentDefinition;
+    endpointId: string;
+    transportKind: string;
+    configPath?: string;
+    dataRoot?: string;
+    availableSkills?: SkillDefinition[];
+}): PromptTemplateContext;
+export declare function renderPromptTemplate(template: string, options: {
+    filePath: string;
+    context: PromptTemplateContext;
+}): string;

package/dist/runtime/prompt-template.js

@@ -0,0 +1,78 @@
+import { arch, homedir, hostname, platform, type, userInfo } from "node:os";
+import Handlebars from "handlebars";
+export function createDefaultPromptTemplateSystemContext() {
+    return {
+        os: type(),
+        platform: platform(),
+        arch: arch(),
+        hostname: hostname(),
+        username: resolveUsername(),
+        homeDir: homedir(),
+    };
+}
+export function createPromptTemplateContext(options) {
+    return {
+        system: options.system,
+        endpoint: {
+            id: options.endpointId,
+        },
+        agent: {
+            id: options.agent.id,
+            model: {
+                provider: options.agent.model.provider,
+                modelId: options.agent.model.modelId,
+            },
+            authFile: options.agent.authFile ?? "",
+            workspace: {
+                cwd: options.agent.workspace?.cwd ?? "",
+            },
+        },
+        transport: {
+            kind: options.transportKind,
+        },
+        imp: {
+            configPath: options.configPath ?? "",
+            dataRoot: options.dataRoot ?? "",
+        },
+        skills: (options.availableSkills ?? []).map((skill) => ({
+            name: skill.name,
+            description: skill.description,
+            directoryPath: skill.directoryPath,
+        })),
+    };
+}
+export function renderPromptTemplate(template, options) {
+    try {
+        return promptHandlebars.compile(template, {
+            knownHelpers: PROMPT_TEMPLATE_KNOWN_HELPERS,
+            knownHelpersOnly: true,
+            noEscape: true,
+            strict: true,
+        })(options.context);
+    }
+    catch (error) {
+        const detail = error instanceof Error ? error.message : String(error);
+        throw new Error(`Failed to render prompt template ${options.filePath}: ${detail}`);
+    }
+}
+const promptHandlebars = Handlebars.create();
+const PROMPT_TEMPLATE_KNOWN_HELPERS = {
+    each: true,
+    if: true,
+    instructionAttr: true,
+    unless: true,
+    with: true,
+};
+promptHandlebars.registerHelper("instructionAttr", (value) => escapeInstructionAttribute(String(value ?? "")));
+function escapeInstructionAttribute(value) {
+    return value.replaceAll("&", "&amp;").replaceAll('"', "&quot;").replaceAll("<", "&lt;");
+}
+function resolveUsername() {
+    try {
+        return userInfo().username;
+    }
+    catch {
+        return process.env.USER ?? process.env.USERNAME ?? "";
+    }
+}
+//# sourceMappingURL=prompt-template.js.map

package/dist/runtime/prompt-template.js.map

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

package/dist/runtime/system-prompt-cache.d.ts

@@ -0,0 +1,33 @@
+import type { AgentDefinition } from "../domain/agent.js";
+import type { SkillDefinition } from "../skills/types.js";
+import type { PromptTemplateContext } from "./prompt-template.js";
+export interface CacheStrategy<Value> {
+    get(key: string): Value | undefined;
+    set(key: string, value: Value): void;
+    delete(key: string): void;
+}
+export declare class InMemoryCacheStrategy<Value> implements CacheStrategy<Value> {
+    #private;
+    get(key: string): Value | undefined;
+    set(key: string, value: Value): void;
+    delete(key: string): void;
+}
+export interface SystemPromptCacheDependencies {
+    getContextFileFingerprint: (path: string) => Promise<string>;
+    readTextFile: (path: string) => Promise<string>;
+    strategy?: CacheStrategy<string>;
+}
+export interface SystemPromptCacheKeyInput {
+    agent: AgentDefinition;
+    promptWorkingDirectory?: string;
+    promptFiles: string[];
+    templateContext: PromptTemplateContext;
+    availableSkills?: SkillDefinition[];
+}
+export declare class SystemPromptCache {
+    #private;
+    constructor(dependencies: SystemPromptCacheDependencies);
+    buildCacheKey(input: SystemPromptCacheKeyInput): Promise<string>;
+    get(cacheKey: string): string | undefined;
+    set(agentId: string, cacheKey: string, systemPrompt: string): void;
+}

package/dist/runtime/system-prompt-cache.js

@@ -0,0 +1,77 @@
+import { createHash } from "node:crypto";
+export class InMemoryCacheStrategy {
+    #entries = new Map();
+    get(key) {
+        return this.#entries.get(key);
+    }
+    set(key, value) {
+        this.#entries.set(key, value);
+    }
+    delete(key) {
+        this.#entries.delete(key);
+    }
+}
+export class SystemPromptCache {
+    #getContextFileFingerprint;
+    #readTextFile;
+    #strategy;
+    #latestCacheKeyByAgentId = new Map();
+    constructor(dependencies) {
+        this.#getContextFileFingerprint = dependencies.getContextFileFingerprint;
+        this.#readTextFile = dependencies.readTextFile;
+        this.#strategy = dependencies.strategy ?? new InMemoryCacheStrategy();
+    }
+    async buildCacheKey(input) {
+        const fileFingerprints = await Promise.all(input.promptFiles.map(async (path) => {
+            try {
+                const fingerprint = await this.#getContextFileFingerprint(path);
+                return `${path}:${fingerprint}`;
+            }
+            catch {
+                try {
+                    const content = await this.#readTextFile(path);
+                    const hash = createHash("sha256").update(content).digest("hex");
+                    return `${path}:sha256:${hash}`;
+                }
+                catch {
+                    return `${path}:unreadable`;
+                }
+            }
+        }));
+        return JSON.stringify({
+            agentId: input.agent.id,
+            prompt: serializePromptSource(input.agent.prompt.base),
+            instructions: (input.agent.prompt.instructions ?? []).map(serializePromptSource),
+            references: (input.agent.prompt.references ?? []).map(serializePromptSource),
+            promptWorkingDirectory: input.promptWorkingDirectory,
+            templateContext: input.templateContext,
+            availableSkills: (input.availableSkills ?? []).map((skill) => ({
+                directoryPath: skill.directoryPath,
+                name: skill.name,
+                description: skill.description,
+            })),
+            files: fileFingerprints,
+        });
+    }
+    get(cacheKey) {
+        return this.#strategy.get(cacheKey);
+    }
+    set(agentId, cacheKey, systemPrompt) {
+        this.#strategy.set(cacheKey, systemPrompt);
+        const previousCacheKey = this.#latestCacheKeyByAgentId.get(agentId);
+        if (previousCacheKey !== undefined && previousCacheKey !== cacheKey) {
+            this.#strategy.delete(previousCacheKey);
+        }
+        this.#latestCacheKeyByAgentId.set(agentId, cacheKey);
+    }
+}
+function serializePromptSource(source) {
+    if (source.file) {
+        return { file: source.file };
+    }
+    if (source.builtIn) {
+        return { builtIn: source.builtIn };
+    }
+    return { text: source.text ?? "" };
+}
+//# sourceMappingURL=system-prompt-cache.js.map

package/dist/runtime/system-prompt-cache.js.map

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

package/dist/runtime/system-prompt-resolution.d.ts

@@ -0,0 +1,22 @@
+import type { AgentDefinition, PromptSource } from "../domain/agent.js";
+import type { SkillDefinition } from "../skills/types.js";
+import { type PromptTemplateContext } from "./prompt-template.js";
+import type { SystemPromptCache } from "./system-prompt-cache.js";
+export interface SystemPromptResolutionOptions {
+    agent: AgentDefinition;
+    promptWorkingDirectory?: string;
+    templateContext: PromptTemplateContext;
+    availableSkills?: SkillDefinition[];
+    readTextFile: (path: string) => Promise<string>;
+    cache: SystemPromptCache;
+}
+export interface SystemPromptResolutionResult {
+    systemPrompt: string;
+    cacheHit: boolean;
+}
+export declare function resolveSystemPrompt(options: SystemPromptResolutionOptions): Promise<SystemPromptResolutionResult>;
+export declare function buildSystemPrompt(agent: AgentDefinition, promptWorkingDirectory: string | undefined, templateContext: PromptTemplateContext, availableSkills: SkillDefinition[], readTextFile: (path: string) => Promise<string>): Promise<string>;
+export declare function resolveInstructionSources(agent: AgentDefinition, promptWorkingDirectory: string | undefined): Array<{
+    source: PromptSource;
+    optional: boolean;
+}>;