longer-agent 0.1.0

package/dist/templates/loader.js

@@ -0,0 +1,514 @@
+/**
+ * Agent template loader with multi-file prompt assembly.
+ *
+ * Provides `loadTemplate` / `loadTemplates` for agent templates.
+ *
+ * Template folder layout:
+ *
+ *   agent_templates/
+ *   +-- main/
+ *   |   +-- agent.yaml          # required
+ *   |   +-- system_prompt.md    # referenced by system_prompt_file
+ *   |   +-- knowledge/          # optional -- files appended to system prompt
+ *   |       +-- style_guide.md
+ *   +-- executor/
+ *       +-- agent.yaml
+ *       +-- system_prompt.md
+ *
+ * Prompt assembly pipeline (per template):
+ *
+ *   1. Read core system prompt from system_prompt.md
+ *   2. Assemble tool prompts from prompts/tools/{name}.md
+ *      (ordered by TOOL_PROMPT_ORDER, filtered by template's declared tools)
+ *   3. Assemble section prompts from prompts/sections/{name}.md
+ *      (controlled by template's prompt_sections field)
+ *   4. Append knowledge/ files (existing mechanism)
+ */
+import { existsSync, readdirSync, readFileSync, statSync } from "node:fs";
+import { basename, dirname, join } from "node:path";
+import * as yaml from "js-yaml";
+import { Agent } from "../agents/agent.js";
+import { BASIC_TOOLS, BASIC_TOOLS_MAP } from "../tools/basic.js";
+// ------------------------------------------------------------------
+// Constants
+// ------------------------------------------------------------------
+const AGENT_YAML = "agent.yaml";
+const REQUIRED_TEMPLATE_TYPE = "agent";
+const MIN_TEMPLATE_MAX_TOOL_ROUNDS = 100;
+/**
+ * Canonical ordering for tool prompt assembly.
+ * Tools not in this list are appended alphabetically after these.
+ */
+export const TOOL_PROMPT_ORDER = [
+    // File I/O
+    "read_file",
+    "write_file",
+    "edit_file",
+    "apply_patch",
+    "list_dir",
+    "glob",
+    "grep",
+    "diff",
+    // Shell
+    "bash",
+    "bash_background",
+    "bash_output",
+    "kill_shell",
+    "test",
+    // Web
+    "web_search",
+    "web_fetch",
+    // Orchestration
+    "spawn_agent",
+    "wait",
+    "kill_agent",
+    "check_status",
+    // Context
+    "show_context",
+    "summarize_context",
+    // Planning
+    "plan",
+    // Interaction
+    "ask",
+    "skill",
+    "reload_skills",
+];
+/**
+ * Paired tool dependencies.
+ * If a tool (key) is in the list, all its required companions (value) must also be present.
+ */
+export const TOOL_REQUIRES = {
+    bash_output: ["bash_background"],
+    kill_shell: ["bash_background"],
+    bash_background: ["bash_output"],
+};
+/**
+ * Default tools for custom templates that omit `tools` in agent.yaml.
+ * Same set as the executor template.
+ */
+export const EXECUTOR_DEFAULT_TOOLS = [
+    "read_file",
+    "write_file",
+    "edit_file",
+    "apply_patch",
+    "list_dir",
+    "glob",
+    "grep",
+    "diff",
+    "bash",
+    "bash_background",
+    "bash_output",
+    "kill_shell",
+    "test",
+    "web_search",
+    "web_fetch",
+];
+// ------------------------------------------------------------------
+// Public API
+// ------------------------------------------------------------------
+/**
+ * Load a single agent template from `templateDir`.
+ *
+ * @param templateDir  Path to the template folder (must contain `agent.yaml`).
+ * @param config       Global Config instance (provides model resolution).
+ * @param nameOverride If given, replaces the `name` field from the YAML.
+ * @param mcpManager   Optional MCP client manager for MCP tool resolution.
+ * @param promptsDirs  Ordered list of `prompts/` directories (user override first, bundled second).
+ *                     If omitted or empty, no tool/section prompts are assembled.
+ * @returns            Fully constructed Agent, ready to use.
+ */
+export function loadTemplate(templateDir, config, nameOverride, mcpManager, promptsDirs) {
+    const yamlPath = join(templateDir, AGENT_YAML);
+    if (!existsSync(yamlPath)) {
+        throw new Error(`Template config not found: ${yamlPath}`);
+    }
+    const raw = readFileSync(yamlPath, "utf-8");
+    const spec = yaml.load(raw) ?? {};
+    const typeError = validateTemplateType(spec);
+    if (typeError) {
+        throw new Error(typeError);
+    }
+    const name = nameOverride ??
+        spec["name"] ??
+        basename(templateDir);
+    const model = spec["model"];
+    // --- 1. Resolve core system prompt ---
+    let systemPrompt = resolveSystemPrompt(spec, templateDir);
+    // --- 2. Assemble tool prompts ---
+    if (promptsDirs && promptsDirs.length > 0) {
+        const toolNames = resolveToolNames(spec);
+        validateToolDependencies(toolNames);
+        const toolPrompts = assembleToolPrompts(toolNames, promptsDirs);
+        if (toolPrompts) {
+            systemPrompt = systemPrompt.trimEnd() + "\n\n---\n\n# Tools\n\n" + toolPrompts;
+        }
+        // --- 3. Assemble section prompts ---
+        const sections = resolveSections(spec);
+        const sectionPrompts = assembleSectionPrompts(sections, promptsDirs);
+        if (sectionPrompts) {
+            systemPrompt = systemPrompt.trimEnd() + "\n\n" + sectionPrompts;
+        }
+    }
+    // --- 4. Append knowledge files (if any) ---
+    const knowledgeDir = join(templateDir, "knowledge");
+    if (existsSync(knowledgeDir) && statSync(knowledgeDir).isDirectory()) {
+        const knowledgeParts = [];
+        const entries = readdirSync(knowledgeDir).sort();
+        for (const entry of entries) {
+            if (entry.startsWith("."))
+                continue;
+            const fullPath = join(knowledgeDir, entry);
+            try {
+                if (!statSync(fullPath).isFile())
+                    continue;
+            }
+            catch {
+                continue;
+            }
+            knowledgeParts.push(readFileSync(fullPath, "utf-8"));
+        }
+        if (knowledgeParts.length > 0) {
+            systemPrompt =
+                systemPrompt.trimEnd() + "\n\n" + knowledgeParts.join("\n\n");
+        }
+    }
+    return buildAgent(spec, name, model, systemPrompt, config, mcpManager);
+}
+/**
+ * Scan template directories and load all templates with layered override.
+ *
+ * When both `bundledRoot` and `userRoot` are provided, user templates override
+ * bundled templates with the same folder name. User-only templates are also loaded.
+ *
+ * @param bundledRoot  Bundled templates root (always available from the package).
+ * @param config       Global Config instance.
+ * @param mcpManager   Optional MCP client manager.
+ * @param promptsDirs  Ordered prompts directories (user first, bundled second).
+ * @param userRoot     Optional user override templates root (~/.longeragent/agent_templates/).
+ * @returns `{ name: agent }` record.
+ */
+export function loadTemplates(bundledRoot, config, mcpManager, promptsDirs, userRoot) {
+    if (!existsSync(bundledRoot) || !statSync(bundledRoot).isDirectory()) {
+        throw new Error(`Bundled templates root not found: ${bundledRoot}`);
+    }
+    // Discover template dirs: bundled first, user overrides on top
+    const templateDirs = {};
+    for (const child of readdirSync(bundledRoot).sort()) {
+        const childPath = join(bundledRoot, child);
+        if (isTemplateDir(childPath)) {
+            templateDirs[child] = childPath;
+        }
+    }
+    if (userRoot && existsSync(userRoot) && statSync(userRoot).isDirectory()) {
+        for (const child of readdirSync(userRoot).sort()) {
+            const childPath = join(userRoot, child);
+            if (isTemplateDir(childPath)) {
+                templateDirs[child] = childPath; // override bundled
+            }
+        }
+    }
+    const resolvedPromptsDirs = promptsDirs && promptsDirs.length > 0
+        ? promptsDirs
+        : [resolvePromptsDir(bundledRoot)].filter((d) => !!d);
+    const agents = {};
+    for (const name of Object.keys(templateDirs).sort()) {
+        const agent = loadTemplate(templateDirs[name], config, undefined, mcpManager, resolvedPromptsDirs);
+        agents[agent.name] = agent;
+    }
+    return agents;
+}
+function isTemplateDir(p) {
+    try {
+        return statSync(p).isDirectory() && existsSync(join(p, AGENT_YAML));
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Validate a template directory without loading it.
+ * Returns null if valid, or an error message string if invalid.
+ */
+export function validateTemplate(templateDir) {
+    const yamlPath = join(templateDir, AGENT_YAML);
+    if (!existsSync(yamlPath)) {
+        return `Missing agent.yaml in ${templateDir}`;
+    }
+    let spec;
+    try {
+        const raw = readFileSync(yamlPath, "utf-8");
+        spec = yaml.load(raw) ?? {};
+    }
+    catch (e) {
+        return `Invalid YAML in agent.yaml: ${e}`;
+    }
+    const typeError = validateTemplateType(spec);
+    if (typeError) {
+        return typeError;
+    }
+    if (!spec["system_prompt"] && !spec["system_prompt_file"]) {
+        return "agent.yaml must have either 'system_prompt' or 'system_prompt_file'";
+    }
+    if (typeof spec["system_prompt_file"] === "string") {
+        const promptPath = join(templateDir, spec["system_prompt_file"]);
+        if (!existsSync(promptPath)) {
+            return `system_prompt_file not found: ${spec["system_prompt_file"]}`;
+        }
+    }
+    const toolsSpec = spec["tools"];
+    if (toolsSpec != null && toolsSpec !== "all" && !Array.isArray(toolsSpec)) {
+        return `Invalid tools spec: must be "all", a list of tool names, or omitted`;
+    }
+    const maxRoundsError = validateTemplateMaxToolRounds(spec);
+    if (maxRoundsError) {
+        return maxRoundsError;
+    }
+    return null;
+}
+// ------------------------------------------------------------------
+// Prompt assembly
+// ------------------------------------------------------------------
+/**
+ * Resolve the prompts/ directory as a sibling of the templates root.
+ * Returns the path if found, or undefined if not.
+ */
+export function resolvePromptsDir(templatesRoot) {
+    const candidate = join(dirname(templatesRoot), "prompts");
+    if (existsSync(candidate) && statSync(candidate).isDirectory()) {
+        return candidate;
+    }
+    return undefined;
+}
+/**
+ * Resolve tool names from the `tools` field in agent.yaml.
+ *
+ * - `"all"` → all tools in TOOL_PROMPT_ORDER
+ * - Array of names → as-is
+ * - Absent / null → EXECUTOR_DEFAULT_TOOLS (for custom templates)
+ */
+export function resolveToolNames(spec) {
+    const toolsSpec = spec["tools"];
+    if (toolsSpec == null)
+        return [...EXECUTOR_DEFAULT_TOOLS];
+    if (toolsSpec === "all")
+        return [...TOOL_PROMPT_ORDER];
+    if (Array.isArray(toolsSpec))
+        return toolsSpec;
+    throw new Error(`Invalid tools spec: ${JSON.stringify(toolsSpec)}`);
+}
+/**
+ * Validate that paired tool dependencies are satisfied.
+ */
+export function validateToolDependencies(toolNames) {
+    const nameSet = new Set(toolNames);
+    for (const [tool, requires] of Object.entries(TOOL_REQUIRES)) {
+        if (!nameSet.has(tool))
+            continue;
+        for (const req of requires) {
+            if (!nameSet.has(req)) {
+                throw new Error(`Tool '${tool}' requires '${req}' to be included in the tools list.`);
+            }
+        }
+    }
+}
+/**
+ * Read and concatenate tool prompt files in canonical order.
+ * For each tool, the first matching file across `promptsDirs` is used (user override first).
+ * Tools without a corresponding prompt file are silently skipped.
+ */
+export function assembleToolPrompts(toolNames, promptsDirs) {
+    // Sort by TOOL_PROMPT_ORDER, unknowns go to the end alphabetically
+    const orderIndex = new Map(TOOL_PROMPT_ORDER.map((n, i) => [n, i]));
+    const sorted = [...toolNames].sort((a, b) => {
+        const ia = orderIndex.get(a) ?? Infinity;
+        const ib = orderIndex.get(b) ?? Infinity;
+        if (ia !== ib)
+            return ia - ib;
+        return a.localeCompare(b);
+    });
+    const parts = [];
+    for (const name of sorted) {
+        const filePath = resolveLayeredFile(promptsDirs, "tools", `${name}.md`);
+        if (!filePath)
+            continue;
+        try {
+            parts.push(readFileSync(filePath, "utf-8").trimEnd());
+        }
+        catch {
+            // Skip unreadable files
+        }
+    }
+    return parts.join("\n\n");
+}
+/**
+ * Resolve prompt_sections from the spec.
+ * Defaults to ["important_log"] if omitted.
+ */
+function resolveSections(spec) {
+    const sections = spec["prompt_sections"];
+    if (sections == null)
+        return ["important_log"];
+    if (Array.isArray(sections))
+        return sections;
+    return ["important_log"];
+}
+/**
+ * Read and concatenate section prompt files.
+ * For each section, the first matching file across `promptsDirs` is used.
+ */
+export function assembleSectionPrompts(sections, promptsDirs) {
+    if (sections.length === 0)
+        return "";
+    const parts = [];
+    for (const name of sections) {
+        const filePath = resolveLayeredFile(promptsDirs, "sections", `${name}.md`);
+        if (!filePath)
+            continue;
+        try {
+            parts.push(readFileSync(filePath, "utf-8").trimEnd());
+        }
+        catch {
+            // Skip unreadable files
+        }
+    }
+    return parts.join("\n\n");
+}
+/**
+ * Resolve a file across multiple directories, returning the first match.
+ * Directories are checked in order (user override first, bundled second).
+ */
+function resolveLayeredFile(dirs, subdir, filename) {
+    for (const dir of dirs) {
+        const filePath = join(dir, subdir, filename);
+        if (existsSync(filePath))
+            return filePath;
+    }
+    return null;
+}
+// ------------------------------------------------------------------
+// Internal helpers
+// ------------------------------------------------------------------
+/**
+ * Return the system prompt string from inline text or an external file.
+ */
+function resolveSystemPrompt(spec, templateDir) {
+    if (typeof spec["system_prompt"] === "string") {
+        return spec["system_prompt"];
+    }
+    if (typeof spec["system_prompt_file"] === "string") {
+        const promptPath = join(templateDir, spec["system_prompt_file"]);
+        if (!existsSync(promptPath)) {
+            throw new Error(`system_prompt_file not found: ${promptPath}`);
+        }
+        return readFileSync(promptPath, "utf-8");
+    }
+    return "";
+}
+function validateTemplateType(spec) {
+    const type = spec["type"];
+    if (typeof type !== "string" || !type.trim()) {
+        return `agent.yaml must set type: ${REQUIRED_TEMPLATE_TYPE}`;
+    }
+    if (type !== REQUIRED_TEMPLATE_TYPE) {
+        return `Invalid template type '${type}': expected '${REQUIRED_TEMPLATE_TYPE}'`;
+    }
+    return null;
+}
+function validateTemplateMaxToolRounds(spec) {
+    const raw = spec["max_tool_rounds"];
+    if (typeof raw !== "number" || !Number.isInteger(raw)) {
+        return `agent.yaml must set integer max_tool_rounds >= ${MIN_TEMPLATE_MAX_TOOL_ROUNDS}`;
+    }
+    if (raw < MIN_TEMPLATE_MAX_TOOL_ROUNDS) {
+        return `max_tool_rounds must be >= ${MIN_TEMPLATE_MAX_TOOL_ROUNDS} (got ${raw})`;
+    }
+    return null;
+}
+/**
+ * Resolve the `tools` field to a list of ToolDef objects.
+ *
+ * - `"all"` => all built-in tools
+ * - A list of name strings => resolve each from BASIC_TOOLS_MAP
+ * - Absent / null => empty list (custom templates get defaults via resolveToolNames)
+ */
+function resolveTools(spec) {
+    const toolsSpec = spec["tools"];
+    if (toolsSpec == null)
+        return [];
+    if (toolsSpec === "all") {
+        // BASIC_TOOLS includes all basic tools.
+        // Comm tools (spawn_agent, wait, etc.) are injected by Session at runtime.
+        return [...BASIC_TOOLS];
+    }
+    if (Array.isArray(toolsSpec)) {
+        const resolved = [];
+        for (const name of toolsSpec) {
+            const tool = BASIC_TOOLS_MAP[name];
+            if (!tool) {
+                throw new Error(`Unknown tool '${name}'. Available: ${Object.keys(BASIC_TOOLS_MAP).join(", ")}`);
+            }
+            resolved.push(tool);
+        }
+        return resolved;
+    }
+    throw new Error(`Invalid tools spec: ${JSON.stringify(toolsSpec)}`);
+}
+/**
+ * Resolve the `mcp_tools` field to MCP ToolDef objects.
+ */
+function resolveMcpTools(spec, mcpManager) {
+    if (!mcpManager)
+        return [];
+    const mcpSpec = spec["mcp_tools"];
+    if (!mcpSpec || mcpSpec === "none")
+        return [];
+    if (mcpSpec === "all") {
+        return mcpManager.getAllTools();
+    }
+    if (Array.isArray(mcpSpec)) {
+        const tools = [];
+        for (const serverName of mcpSpec) {
+            const serverTools = mcpManager.getToolsForServer(serverName);
+            if (serverTools.length === 0) {
+                console.warn(`MCP server '${serverName}' has no tools or is not connected`);
+            }
+            tools.push(...serverTools);
+        }
+        return tools;
+    }
+    return [];
+}
+/**
+ * Build a fully configured Agent from the parsed YAML spec.
+ */
+function buildAgent(spec, name, model, systemPrompt, config, mcpManager) {
+    const typeError = validateTemplateType(spec);
+    if (typeError) {
+        throw new Error(typeError);
+    }
+    const maxRoundsError = validateTemplateMaxToolRounds(spec);
+    if (maxRoundsError) {
+        throw new Error(maxRoundsError);
+    }
+    const resolvedModel = model ?? config.defaultModel;
+    if (!resolvedModel) {
+        throw new Error(`No model specified for template '${name}' and no default model in config.`);
+    }
+    const tools = [...resolveTools(spec), ...resolveMcpTools(spec, mcpManager)];
+    const opts = {
+        name,
+        role: systemPrompt,
+        model: resolvedModel,
+        config,
+        tools,
+    };
+    opts.maxToolRounds = spec["max_tool_rounds"];
+    if (typeof spec["description"] === "string") {
+        opts.description = spec["description"];
+    }
+    const agent = new Agent(opts);
+    // Keep MCP selection intent for runtime lazy wiring in Session._ensureMcp().
+    agent._mcpToolsSpec = spec["mcp_tools"] ?? undefined;
+    return agent;
+}
+//# sourceMappingURL=loader.js.map

package/dist/templates/loader.js.map

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

package/dist/tools/basic.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Built-in tool definitions and executors.
+ *
+ * 15 tools: read_file, list_dir, glob, grep, edit_file, write_file,
+ * apply_patch, bash, bash_background, bash_output, kill_shell,
+ * diff, test, web_search, web_fetch.
+ */
+import type { ToolDef } from "../providers/base.js";
+import { ToolResult } from "../providers/base.js";
+export declare const BASH_BACKGROUND_TOOL: ToolDef;
+export declare const BASH_OUTPUT_TOOL: ToolDef;
+export declare const KILL_SHELL_TOOL: ToolDef;
+export declare const BASIC_TOOLS: ToolDef[];
+export declare const BASIC_TOOLS_MAP: Record<string, ToolDef>;
+export declare function buildBashEnv(): NodeJS.ProcessEnv;
+export interface ExecuteToolContext {
+    projectRoot?: string;
+    externalPathAllowlist?: string[];
+    sessionArtifactsDir?: string;
+    supportsMultimodal?: boolean;
+}
+/**
+ * Execute a tool by name and return a `ToolResult`.
+ *
+ * Tool functions may return either a plain `string` (wrapped automatically)
+ * or a `ToolResult` with optional action hints, tags, and metadata.
+ */
+export declare function executeTool(name: string, args: Record<string, unknown>, ctx?: ExecuteToolContext): Promise<ToolResult>;
+//# sourceMappingURL=basic.d.ts.map

package/dist/tools/basic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"basic.d.ts","sourceRoot":"","sources":["../../src/tools/basic.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AA2XlD,eAAO,MAAM,oBAAoB,EAAE,OAkBlC,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,OAsB9B,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,OAqB7B,CAAC;AAMF,eAAO,MAAM,WAAW,EAAE,OAAO,EAgBhC,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAEnD,CAAC;AAyzBF,wBAAgB,YAAY,IAAI,MAAM,CAAC,UAAU,CAahD;AAmWD,MAAM,WAAW,kBAAkB;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAC;IACjC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AA4vBD;;;;;GAKG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,GAAG,CAAC,EAAE,kBAAkB,GACvB,OAAO,CAAC,UAAU,CAAC,CAgBrB"}