@tschmz/imp 0.1.0

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

@@ -0,0 +1,170 @@
+import { join } from "node:path";
+import { DEFAULT_AGENT_SYSTEM_PROMPT } from "../agents/default-system-prompt.js";
+import { renderPromptTemplate } from "./prompt-template.js";
+export async function resolveSystemPrompt(options) {
+    const promptFiles = [
+        ...resolvePromptFileSources(options.agent, options.promptWorkingDirectory).map((source) => source.path),
+    ];
+    const cacheKey = await options.cache.buildCacheKey({
+        agent: options.agent,
+        promptWorkingDirectory: options.promptWorkingDirectory,
+        promptFiles,
+        templateContext: options.templateContext,
+        availableSkills: options.availableSkills,
+    });
+    const cachedPrompt = options.cache.get(cacheKey);
+    if (cachedPrompt !== undefined) {
+        return {
+            systemPrompt: cachedPrompt,
+            cacheHit: true,
+        };
+    }
+    const systemPrompt = await buildSystemPrompt(options.agent, options.promptWorkingDirectory, options.templateContext, options.availableSkills ?? [], options.readTextFile);
+    options.cache.set(options.agent.id, cacheKey, systemPrompt);
+    return {
+        systemPrompt,
+        cacheHit: false,
+    };
+}
+export async function buildSystemPrompt(agent, promptWorkingDirectory, templateContext, availableSkills, readTextFile) {
+    const sections = [];
+    const promptTemplateContext = {
+        ...templateContext,
+        skills: availableSkills.map((skill) => ({
+            name: skill.name,
+            description: skill.description,
+            directoryPath: skill.directoryPath,
+        })),
+    };
+    const basePrompt = await resolvePromptSourceContent(agent, agent.prompt.base, readTextFile, {
+        kind: "base prompt",
+        templateFileContent: true,
+        templateContext: promptTemplateContext,
+    });
+    if (!basePrompt) {
+        throw new Error(`Configured base prompt for agent "${agent.id}" must define text, file, or built-in source.`);
+    }
+    sections.push(basePrompt);
+    for (const source of resolveInstructionSources(agent, promptWorkingDirectory)) {
+        const content = await resolvePromptSourceContent(agent, source.source, readTextFile, {
+            kind: "instruction file",
+            optional: source.optional,
+            templateFileContent: true,
+            templateContext: promptTemplateContext,
+        });
+        if (!content) {
+            continue;
+        }
+        sections.push(formatPromptSection("INSTRUCTIONS", describePromptSource(source.source), content));
+    }
+    for (const source of agent.prompt.references ?? []) {
+        const content = await resolvePromptSourceContent(agent, source, readTextFile, {
+            kind: "reference file",
+            templateFileContent: true,
+            templateContext: promptTemplateContext,
+        });
+        if (!content) {
+            continue;
+        }
+        sections.push(formatPromptSection("REFERENCE", describePromptSource(source), content));
+    }
+    return sections.join("\n\n");
+}
+function formatPromptSection(tagName, source, content) {
+    return `<${tagName} from="${escapeInstructionAttribute(source)}">\n\n${content}\n</${tagName}>`;
+}
+function escapeInstructionAttribute(value) {
+    return value.replaceAll("&", "&amp;").replaceAll('"', "&quot;").replaceAll("<", "&lt;");
+}
+export function resolveInstructionSources(agent, promptWorkingDirectory) {
+    const sources = (agent.prompt.instructions ?? []).map((source) => ({ source, optional: false }));
+    const workingDirectoryAgentsFile = resolveWorkingDirectoryAgentsFile(promptWorkingDirectory);
+    if (workingDirectoryAgentsFile &&
+        !sources.some((entry) => entry.source.file === workingDirectoryAgentsFile)) {
+        sources.push({ source: { file: workingDirectoryAgentsFile }, optional: true });
+    }
+    return sources;
+}
+function resolvePromptFileSources(agent, promptWorkingDirectory) {
+    return [
+        ...extractFileSources([agent.prompt.base]),
+        ...extractFileSources(agent.prompt.references ?? []),
+        ...resolveInstructionSources(agent, promptWorkingDirectory)
+            .filter((entry) => entry.source.file)
+            .map((entry) => ({ path: entry.source.file, optional: entry.optional })),
+    ];
+}
+function resolveWorkingDirectoryAgentsFile(workingDirectory) {
+    if (!workingDirectory) {
+        return undefined;
+    }
+    return join(workingDirectory, "AGENTS.md");
+}
+async function resolvePromptSourceContent(agent, source, readTextFile, options) {
+    if (source.text !== undefined) {
+        const trimmedContent = source.text.trim();
+        if (!trimmedContent) {
+            throw new Error(`Configured ${options.kind} for agent "${agent.id}" is empty.`);
+        }
+        return trimmedContent;
+    }
+    if (source.builtIn === "default") {
+        const content = renderPromptTemplate(DEFAULT_AGENT_SYSTEM_PROMPT, {
+            filePath: "built-in:default-system-prompt",
+            context: options.templateContext,
+        });
+        const trimmedContent = content.trim();
+        if (!trimmedContent) {
+            throw new Error(`Built-in ${options.kind} for agent "${agent.id}" is empty.`);
+        }
+        return trimmedContent;
+    }
+    let content;
+    if (!source.file) {
+        throw new Error(`Configured ${options.kind} for agent "${agent.id}" must define text, file, or built-in source.`);
+    }
+    try {
+        content = await readTextFile(source.file);
+    }
+    catch (error) {
+        if (options.optional && isFileNotFoundError(error)) {
+            return undefined;
+        }
+        const detail = error instanceof Error ? error.message : String(error);
+        throw new Error(`Failed to read ${options.kind} for agent "${agent.id}": ${source.file} (${detail})`);
+    }
+    if (options.templateFileContent) {
+        content = renderPromptTemplate(content, {
+            filePath: source.file,
+            context: options.templateContext,
+        });
+    }
+    const trimmedContent = content.trim();
+    if (!trimmedContent) {
+        if (options.kind === "base prompt") {
+            throw new Error(`Configured base prompt file for agent "${agent.id}" is empty: ${source.file}`);
+        }
+        return undefined;
+    }
+    return trimmedContent;
+}
+function extractFileSources(sources) {
+    return sources
+        .filter((source) => typeof source.file === "string")
+        .map((source) => ({ path: source.file, optional: false }));
+}
+function describePromptSource(source) {
+    return source.file ?? source.builtIn ?? "inline";
+}
+function isFileNotFoundError(error) {
+    if (typeof error !== "object" || error === null) {
+        return false;
+    }
+    const code = "code" in error ? error.code : undefined;
+    if (code === "ENOENT") {
+        return true;
+    }
+    const message = "message" in error ? error.message : undefined;
+    return typeof message === "string" && message.includes("ENOENT");
+}
+//# sourceMappingURL=system-prompt-resolution.js.map

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

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

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

@@ -0,0 +1,19 @@
+import type { StreamOptions } from "@mariozechner/pi-ai";
+import type { AgentDefinition } from "../domain/agent.js";
+import type { SkillDefinition } from "../skills/types.js";
+import { type ToolRegistry } from "../tools/registry.js";
+import type { ToolDefinition } from "../tools/types.js";
+export interface WorkingDirectoryState {
+    get(): string;
+    set(path: string): void;
+}
+export declare function resolveWorkingDirectory(agent: AgentDefinition): string;
+export declare function createWorkingDirectoryState(initialWorkingDirectory: string): WorkingDirectoryState;
+export declare function createBuiltInToolRegistry(workingDirectory: string | WorkingDirectoryState, agent?: AgentDefinition): ToolRegistry;
+export declare function createLoadSkillTool(skills: SkillDefinition[]): ToolDefinition;
+export declare function mergeShellPathEntries(env: NodeJS.ProcessEnv, additionalEntries: string[], options?: {
+    delimiter?: string;
+    platform?: NodeJS.Platform;
+}): NodeJS.ProcessEnv;
+export declare function resolveAgentTools(agent: AgentDefinition, toolRegistry: ToolRegistry): ToolDefinition[];
+export declare function createOnPayloadOverride(agent: AgentDefinition): StreamOptions["onPayload"] | undefined;

package/dist/runtime/tool-resolution.js

@@ -0,0 +1,281 @@
+import { readFile, stat } from "node:fs/promises";
+import { delimiter as pathDelimiter } from "node:path";
+import { createFindTool, createGrepTool, createLsTool, createCodingTools } from "@mariozechner/pi-coding-agent";
+import { createToolRegistry } from "../tools/registry.js";
+export function resolveWorkingDirectory(agent) {
+    return agent.workspace?.cwd ?? process.cwd();
+}
+export function createWorkingDirectoryState(initialWorkingDirectory) {
+    let workingDirectory = initialWorkingDirectory;
+    return {
+        get() {
+            return workingDirectory;
+        },
+        set(path) {
+            workingDirectory = path;
+        },
+    };
+}
+export function createBuiltInToolRegistry(workingDirectory, agent) {
+    const workingDirectoryState = typeof workingDirectory === "string"
+        ? createWorkingDirectoryState(workingDirectory)
+        : workingDirectory;
+    return createToolRegistry([
+        ...createDynamicBuiltInTools(workingDirectoryState, agent),
+        ...createConfiguredSkillTools(agent?.skillCatalog ?? []),
+        createGetWorkingDirectoryTool(workingDirectoryState),
+        createSetWorkingDirectoryTool(workingDirectoryState),
+    ]);
+}
+function createDynamicBuiltInTools(workingDirectoryState, agent) {
+    return createBaseBuiltInTools(workingDirectoryState.get(), agent).map((tool) => ({
+        ...tool,
+        async execute(toolCallId, params, signal, onUpdate) {
+            const delegatedTool = createBaseBuiltInTools(workingDirectoryState.get(), agent).find((candidate) => candidate.name === tool.name);
+            if (!delegatedTool) {
+                throw new Error(`Unknown built-in tool: ${tool.name}`);
+            }
+            return delegatedTool.execute(toolCallId, params, signal, onUpdate);
+        },
+    }));
+}
+function createBaseBuiltInTools(workingDirectory, agent) {
+    const toolOptions = resolveBuiltInToolOptions(agent);
+    return [
+        ...createCodingTools(workingDirectory, toolOptions),
+        createGrepTool(workingDirectory),
+        createFindTool(workingDirectory),
+        createLsTool(workingDirectory),
+    ];
+}
+export function createLoadSkillTool(skills) {
+    const skillByName = new Map(skills.map((skill) => [skill.name, skill]));
+    const parameters = {
+        type: "object",
+        properties: {
+            name: {
+                type: "string",
+                minLength: 1,
+                description: "Exact skill name from the available skill catalog.",
+            },
+        },
+        required: ["name"],
+        additionalProperties: false,
+    };
+    return {
+        name: "load_skill",
+        label: "load_skill",
+        description: "Load the full SKILL.md instructions and reference files for an available skill.",
+        parameters,
+        async execute(_toolCallId, params) {
+            const { name } = parseLoadSkillParams(params);
+            const skill = skillByName.get(name);
+            if (!skill) {
+                throw new Error(`Unknown skill: ${name}. Available skills: ${skills.map((entry) => entry.name).join(", ")}`);
+            }
+            const references = await Promise.all(skill.references.map(async (reference) => ({
+                ...reference,
+                content: (await readFile(reference.filePath, "utf8")).trim(),
+            })));
+            const renderedReferences = references.map((reference) => `<SKILL-REFERENCE skill="${escapeToolAttribute(skill.name)}" from="${escapeToolAttribute(reference.filePath)}">\n\n${reference.content}\n</SKILL-REFERENCE>`);
+            const text = [
+                `<SKILL name="${escapeToolAttribute(skill.name)}" from="${escapeToolAttribute(skill.filePath)}">\n\n${skill.body.trim()}\n</SKILL>`,
+                ...renderedReferences,
+            ].join("\n\n");
+            return {
+                content: [{ type: "text", text }],
+                details: {
+                    skillName: skill.name,
+                    skillPath: skill.filePath,
+                    references: references.map((reference) => ({
+                        path: reference.filePath,
+                        relativePath: reference.relativePath,
+                    })),
+                },
+            };
+        },
+    };
+}
+function createConfiguredSkillTools(skills) {
+    return skills.length > 0 ? [createLoadSkillTool(skills)] : [];
+}
+function parseLoadSkillParams(params) {
+    if (typeof params !== "object" || params === null) {
+        throw new Error("load_skill requires an object parameter with a name.");
+    }
+    const name = "name" in params ? params.name : undefined;
+    if (typeof name !== "string" || name.trim().length === 0) {
+        throw new Error("load_skill requires a non-empty string name.");
+    }
+    return { name: name.trim() };
+}
+function escapeToolAttribute(value) {
+    return value.replaceAll("&", "&amp;").replaceAll('"', "&quot;").replaceAll("<", "&lt;");
+}
+function resolveBuiltInToolOptions(agent) {
+    const shellPath = agent?.workspace?.shellPath;
+    if (!shellPath || shellPath.length === 0) {
+        return undefined;
+    }
+    return {
+        bash: {
+            spawnHook: ({ command, cwd, env }) => ({
+                command,
+                cwd,
+                env: mergeShellPathEntries(env, shellPath),
+            }),
+        },
+    };
+}
+export function mergeShellPathEntries(env, additionalEntries, options = {}) {
+    const delimiter = options.delimiter ?? pathDelimiter;
+    const platform = options.platform ?? process.platform;
+    const pathKey = resolvePathEnvironmentKey(env, platform);
+    const currentPath = env[pathKey];
+    const envWithoutDuplicatePathKeys = removeDuplicatePathKeys(env, platform);
+    return {
+        ...envWithoutDuplicatePathKeys,
+        [pathKey]: appendPathEntries(currentPath, additionalEntries, delimiter),
+    };
+}
+function resolvePathEnvironmentKey(env, platform) {
+    if (platform === "win32") {
+        if ("Path" in env) {
+            return "Path";
+        }
+        if ("PATH" in env) {
+            return "PATH";
+        }
+        const existingKey = Object.keys(env).find((key) => key.toLowerCase() === "path");
+        if (existingKey) {
+            return existingKey;
+        }
+        return "Path";
+    }
+    return "PATH";
+}
+function removeDuplicatePathKeys(env, platform) {
+    if (platform !== "win32") {
+        return env;
+    }
+    return Object.fromEntries(Object.entries(env).filter(([key]) => key.toLowerCase() !== "path"));
+}
+function appendPathEntries(currentPath, additionalEntries, delimiter) {
+    const mergedEntries = [
+        ...additionalEntries,
+        ...splitPathEntries(currentPath, delimiter),
+    ];
+    return [...new Set(mergedEntries)].join(delimiter);
+}
+function splitPathEntries(pathValue, delimiter) {
+    if (!pathValue) {
+        return [];
+    }
+    return pathValue
+        .split(delimiter)
+        .map((entry) => entry.trim())
+        .filter((entry) => entry.length > 0);
+}
+function createGetWorkingDirectoryTool(workingDirectoryState) {
+    const parameters = {
+        type: "object",
+        properties: {},
+        additionalProperties: false,
+    };
+    return {
+        name: "pwd",
+        label: "pwd",
+        description: "Return the current working directory used by filesystem and shell tools.",
+        parameters,
+        async execute() {
+            const workingDirectory = workingDirectoryState.get();
+            return {
+                content: [{ type: "text", text: workingDirectory }],
+                details: { workingDirectory },
+            };
+        },
+    };
+}
+function createSetWorkingDirectoryTool(workingDirectoryState) {
+    const parameters = {
+        type: "object",
+        properties: {
+            path: {
+                type: "string",
+                minLength: 1,
+            },
+        },
+        required: ["path"],
+        additionalProperties: false,
+    };
+    return {
+        name: "cd",
+        label: "cd",
+        description: "Set the working directory used by subsequent filesystem and shell tool calls.",
+        parameters,
+        async execute(_toolCallId, params) {
+            const { path } = parseSetWorkingDirectoryParams(params);
+            const directoryStats = await stat(path);
+            if (!directoryStats.isDirectory()) {
+                throw new Error(`Not a directory: ${path}`);
+            }
+            workingDirectoryState.set(path);
+            return {
+                content: [{ type: "text", text: path }],
+                details: { workingDirectory: path },
+            };
+        },
+    };
+}
+function parseSetWorkingDirectoryParams(params) {
+    if (typeof params !== "object" || params === null) {
+        throw new Error("cd requires an object parameter with a path.");
+    }
+    const path = "path" in params ? params.path : undefined;
+    if (typeof path !== "string" || path.length === 0) {
+        throw new Error("cd requires a non-empty string path.");
+    }
+    return { path };
+}
+export function resolveAgentTools(agent, toolRegistry) {
+    if (agent.tools.length === 0) {
+        return [];
+    }
+    const resolvedTools = toolRegistry.pick(agent.tools);
+    const resolvedNames = new Set(resolvedTools.map((tool) => tool.name));
+    const missingTools = agent.tools.filter((name) => !resolvedNames.has(name));
+    if (missingTools.length > 0) {
+        throw new Error(`Unknown tools for agent "${agent.id}": ${missingTools.join(", ")}`);
+    }
+    return resolvedTools;
+}
+export function createOnPayloadOverride(agent) {
+    const maxOutputTokens = agent.inference?.maxOutputTokens;
+    const metadata = agent.inference?.metadata;
+    const request = agent.inference?.request;
+    if (metadata === undefined &&
+        request === undefined &&
+        maxOutputTokens === undefined) {
+        return undefined;
+    }
+    return (payload, model) => {
+        if (model.api !== "openai-responses" &&
+            model.api !== "openai-codex-responses" &&
+            model.api !== "azure-openai-responses") {
+            return undefined;
+        }
+        if (!isRecord(payload)) {
+            return undefined;
+        }
+        return {
+            ...payload,
+            ...(metadata !== undefined ? { metadata } : {}),
+            ...(maxOutputTokens !== undefined ? { max_output_tokens: maxOutputTokens } : {}),
+            ...(request ?? {}),
+        };
+    };
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null;
+}
+//# sourceMappingURL=tool-resolution.js.map

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

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

package/dist/runtime/types.d.ts

@@ -0,0 +1,23 @@
+import type { Api as AiApi, Model } from "@mariozechner/pi-ai";
+import type { AgentDefinition } from "../domain/agent.js";
+import type { ConversationContext } from "../domain/conversation.js";
+import type { ToolDefinition } from "../tools/types.js";
+import type { AgentRunInput, AgentRunResult } from "./context.js";
+import type { SystemPromptResolutionResult } from "./system-prompt-resolution.js";
+import type { WorkingDirectoryState } from "./tool-resolution.js";
+export interface AgentEngine {
+    run(input: AgentRunInput): Promise<AgentRunResult>;
+    close?(): Promise<void>;
+}
+export interface AgentRunContext {
+    input: AgentRunInput;
+    agent: AgentDefinition;
+    conversation: ConversationContext;
+    model?: Model<AiApi>;
+    systemPromptResolution?: SystemPromptResolutionResult;
+    tools?: ToolDefinition[];
+    workingDirectoryState?: WorkingDirectoryState;
+    initialWorkingDirectory?: string;
+    promptWorkingDirectory?: string;
+    result?: AgentRunResult;
+}

package/dist/runtime/types.js

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

package/dist/runtime/types.js.map

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

package/dist/service/install-plan.d.ts

@@ -0,0 +1,21 @@
+export type ServicePlatform = "linux-systemd-user" | "macos-launchd-agent" | "windows-winsw";
+export type ServicePlatformInput = NodeJS.Platform | ServicePlatform;
+export interface ServiceInstallPlan {
+    platform: ServicePlatform;
+    serviceName: string;
+    serviceLabel: string;
+    configPath: string;
+    workingDirectory: string;
+    command: string;
+    args: string[];
+    environmentPath?: string;
+}
+export declare function createServiceInstallPlan(options: {
+    configPath: string;
+    argv?: string[];
+    execPath?: string;
+    platform?: ServicePlatformInput;
+    environmentPath?: string;
+}): ServiceInstallPlan;
+export declare function renderServiceDefinition(plan: ServiceInstallPlan): string;
+export declare function detectServicePlatform(platform?: ServicePlatformInput): ServicePlatform;

package/dist/service/install-plan.js

@@ -0,0 +1,71 @@
+import { dirname, resolve } from "node:path";
+import { RuntimeStateError, UnsupportedPlatformError } from "../domain/errors.js";
+import { getServicePlatformAdapter } from "./platforms/get-service-platform-adapter.js";
+export function createServiceInstallPlan(options) {
+    const configPath = resolve(options.configPath);
+    const platform = detectServicePlatform(options.platform);
+    const commandLine = resolveServiceCommandLine({
+        argv: options.argv,
+        execPath: options.execPath,
+        configPath,
+    });
+    return {
+        platform,
+        serviceName: "imp",
+        serviceLabel: "dev.imp",
+        configPath,
+        workingDirectory: dirname(configPath),
+        command: commandLine.command,
+        args: commandLine.args,
+        environmentPath: platform === "linux-systemd-user"
+            ? resolve(options.environmentPath ?? dirname(configPath), "service.env")
+            : undefined,
+    };
+}
+export function renderServiceDefinition(plan) {
+    return getServicePlatformAdapter(plan.platform).renderDefinition(plan);
+}
+export function detectServicePlatform(platform = process.platform) {
+    if (isServicePlatform(platform)) {
+        return platform;
+    }
+    switch (platform) {
+        case "linux":
+            return "linux-systemd-user";
+        case "darwin":
+            return "macos-launchd-agent";
+        case "win32":
+            return "windows-winsw";
+        default:
+            throw new UnsupportedPlatformError(platform);
+    }
+}
+function isServicePlatform(platform) {
+    return (platform === "linux-systemd-user" ||
+        platform === "macos-launchd-agent" ||
+        platform === "windows-winsw");
+}
+function resolveServiceCommandLine(options) {
+    const argv = options.argv ?? process.argv;
+    const execPath = options.execPath ?? process.execPath;
+    const entrypoint = argv[1];
+    if (!entrypoint) {
+        throw new RuntimeStateError("Could not determine the imp CLI entrypoint for service installation.");
+    }
+    const resolvedEntrypoint = resolve(entrypoint);
+    const args = ["start", "--config", options.configPath];
+    if (shouldInvokeViaNode(execPath, resolvedEntrypoint)) {
+        return {
+            command: execPath,
+            args: [resolvedEntrypoint, ...args],
+        };
+    }
+    return {
+        command: resolvedEntrypoint,
+        args,
+    };
+}
+function shouldInvokeViaNode(execPath, entrypoint) {
+    return entrypoint.endsWith(".js") || entrypoint.endsWith(".mjs") || execPath.includes("node");
+}
+//# sourceMappingURL=install-plan.js.map

package/dist/service/install-plan.js.map

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