longer-agent 0.1.0

package/dist/summarize-context.js

@@ -0,0 +1,247 @@
+/**
+ * Log-native summarize_context implementation.
+ *
+ * The session log is the single source of truth. summarize_context works
+ * directly on LogEntry[] and inserts summary entries into the active window.
+ */
+import { createSummary } from "./log-entry.js";
+function getLogContextId(entry) {
+    if (entry.discarded || entry.summarized)
+        return null;
+    const ctxId = entry.meta["contextId"];
+    if (ctxId === undefined || ctxId === null)
+        return null;
+    return String(ctxId);
+}
+function isTransparentLogEntry(entry) {
+    if (entry.discarded || entry.summarized)
+        return true;
+    return getLogContextId(entry) === null;
+}
+function buildLogSpatialIndex(entries) {
+    const index = new Map();
+    for (let i = 0; i < entries.length; i++) {
+        const ctxId = getLogContextId(entries[i]);
+        if (!ctxId)
+            continue;
+        registerIndex(index, ctxId, i);
+        if (ctxId.includes(".")) {
+            registerIndex(index, ctxId.split(".")[0], i);
+        }
+    }
+    return index;
+}
+function registerIndex(index, key, idx) {
+    const entry = index.get(key);
+    if (entry) {
+        if (!entry.indices.includes(idx))
+            entry.indices.push(idx);
+        return;
+    }
+    index.set(key, { indices: [idx] });
+}
+function findLastCompactMarkerEntryIdx(entries) {
+    for (let i = entries.length - 1; i >= 0; i--) {
+        if (entries[i].type === "compact_marker" && !entries[i].discarded)
+            return i;
+    }
+    return -1;
+}
+function collectNearbyLogContextIds(entries, minIdx, maxIdx) {
+    const ids = [];
+    const seen = new Set();
+    const start = Math.max(0, minIdx - 2);
+    const end = Math.min(entries.length - 1, maxIdx + 2);
+    for (let i = start; i <= end; i++) {
+        const ctxId = getLogContextId(entries[i]);
+        if (!ctxId || seen.has(ctxId))
+            continue;
+        seen.add(ctxId);
+        ids.push(ctxId);
+    }
+    return ids;
+}
+function parseOperations(args) {
+    const operations = args["operations"] ?? [];
+    return operations.map((raw) => ({
+        context_ids: (raw["context_ids"] ?? []).map(String),
+        summary: typeof raw["summary"] === "string" ? raw["summary"] : "",
+        reason: typeof raw["reason"] === "string" && raw["reason"].trim()
+            ? raw["reason"]
+            : undefined,
+    }));
+}
+function validateLogOperation(op, spatialIndex, entries, lastCompactMarkerIdx) {
+    const { context_ids, summary } = op;
+    if (!context_ids.length) {
+        return { valid: false, error: "Empty context_ids array." };
+    }
+    if (!summary.trim()) {
+        return { valid: false, error: "Empty summary. Provide a non-empty summary string." };
+    }
+    for (const id of context_ids) {
+        if (!spatialIndex.has(id)) {
+            return { valid: false, error: `context_id "${id}" not found.` };
+        }
+    }
+    const allIndices = new Set();
+    for (const id of context_ids) {
+        for (const idx of spatialIndex.get(id).indices) {
+            allIndices.add(idx);
+        }
+    }
+    const sorted = [...allIndices].sort((a, b) => a - b);
+    const minIdx = sorted[0];
+    const maxIdx = sorted[sorted.length - 1];
+    if (lastCompactMarkerIdx >= 0 && minIdx <= lastCompactMarkerIdx) {
+        return {
+            valid: false,
+            error: "context_id(s) include entries before the last compact marker (not visible to the model).",
+        };
+    }
+    for (let i = minIdx; i <= maxIdx; i++) {
+        if (allIndices.has(i))
+            continue;
+        if (isTransparentLogEntry(entries[i]))
+            continue;
+        const nearbyIds = collectNearbyLogContextIds(entries, minIdx, maxIdx);
+        return {
+            valid: false,
+            error: `Not spatially contiguous. Current spatial order near that region: ` +
+                `${nearbyIds.join(", ")} — did you mean [${context_ids.join(", ")}] ` +
+                `to include the gaps, or split into separate operations?`,
+        };
+    }
+    return { valid: true, mergeRange: [minIdx, maxIdx] };
+}
+function executeLogOperation(op, entries, allocateContextId, allocateLogId, turnIndex, validation) {
+    const [startIdx, endIdx] = validation.mergeRange;
+    const newContextId = allocateContextId();
+    const summaryEntryId = allocateLogId();
+    let summaryDepth = 1;
+    const summarizedContextIds = [];
+    for (let i = startIdx; i <= endIdx; i++) {
+        const entry = entries[i];
+        if (entry.type === "summary") {
+            const depth = Number(entry.meta["summaryDepth"] ?? 1);
+            summaryDepth = Math.max(summaryDepth, depth + 1);
+        }
+        const ctxId = getLogContextId(entry);
+        if (ctxId && !summarizedContextIds.includes(ctxId)) {
+            summarizedContextIds.push(ctxId);
+        }
+    }
+    let display = `[Summary of ${op.context_ids.join(", ")} ]\n`;
+    display = display.replace(" )", ")");
+    if (op.reason) {
+        display += `Reason: ${op.reason}\n`;
+    }
+    const content = `${display}Summary: ${op.summary}`;
+    display += `Summary: ${op.summary}`;
+    const summaryEntry = createSummary(summaryEntryId, turnIndex, display, content, newContextId, summarizedContextIds, summaryDepth);
+    for (let i = startIdx; i <= endIdx; i++) {
+        if (entries[i].discarded)
+            continue;
+        entries[i].summarized = true;
+        entries[i].summarizedBy = summaryEntryId;
+    }
+    entries.splice(startIdx, 0, summaryEntry);
+    return {
+        success: true,
+        contextIds: op.context_ids,
+        newContextId,
+    };
+}
+function formatExecutionOutput(ops, results) {
+    const succeeded = results.filter((r) => r.success).length;
+    const failed = results.filter((r) => !r.success).length;
+    const lines = [];
+    lines.push(`Operations: ${ops.length} submitted, ${succeeded} succeeded, ${failed} failed.`);
+    lines.push("");
+    for (const result of results) {
+        const idsLabel = result.contextIds.join(", ");
+        if (result.success) {
+            lines.push(`\u2713 [context_ids: ${idsLabel}] \u2192 Replaced with context_id ${String(result.newContextId)}.`);
+        }
+        else {
+            lines.push(`\u2717 [context_ids: ${idsLabel}] \u2192 Error: ${result.error}`);
+        }
+    }
+    return lines.join("\n");
+}
+/**
+ * Truncate long summary text in projected tool arguments.
+ * The tool result still keeps the full summary; this only shrinks provider input.
+ */
+export function truncateSummaryText(summary, newContextId) {
+    if (summary.length <= 100)
+        return summary;
+    let cutPoint = 100;
+    const spaceIdx = summary.indexOf(" ", 100);
+    if (spaceIdx >= 0 && spaceIdx <= 150) {
+        cutPoint = spaceIdx;
+    }
+    else {
+        cutPoint = Math.min(summary.length, 150);
+    }
+    const kept = summary.slice(0, cutPoint);
+    const ctxRef = newContextId !== undefined ? ` in context_id ${String(newContextId)}` : "";
+    return `${kept}...{Truncated, first ${cutPoint} chars kept, full version${ctxRef}}`;
+}
+export function execSummarizeContextOnLog(args, entries, contextIdAllocator, logIdAllocator, turnIndex) {
+    const ops = parseOperations(args);
+    if (!ops.length) {
+        const results = [{
+                success: false,
+                contextIds: [],
+                error: "Error: no operations provided.",
+            }];
+        return {
+            output: "Error: no operations provided.",
+            results,
+        };
+    }
+    const spatialIndex = buildLogSpatialIndex(entries);
+    const lastCompactMarkerIdx = findLastCompactMarkerEntryIdx(entries);
+    const validations = [];
+    const orderedResults = new Array(ops.length);
+    const claimedIds = new Set();
+    for (let opIndex = 0; opIndex < ops.length; opIndex++) {
+        const op = ops[opIndex];
+        const duplicates = op.context_ids.filter((id) => claimedIds.has(id));
+        if (duplicates.length > 0) {
+            orderedResults[opIndex] = {
+                success: false,
+                contextIds: op.context_ids,
+                error: `context_id(s) ${duplicates.map((d) => `"${d}"`).join(", ")} already referenced by another operation in this call.`,
+            };
+            continue;
+        }
+        const validation = validateLogOperation(op, spatialIndex, entries, lastCompactMarkerIdx);
+        if (!validation.valid) {
+            orderedResults[opIndex] = {
+                success: false,
+                contextIds: op.context_ids,
+                error: validation.error,
+            };
+            continue;
+        }
+        validations.push({ op, validation, opIndex });
+        for (const id of op.context_ids)
+            claimedIds.add(id);
+    }
+    validations.sort((a, b) => b.validation.mergeRange[0] - a.validation.mergeRange[0]);
+    for (const { op, validation, opIndex } of validations) {
+        orderedResults[opIndex] = executeLogOperation(op, entries, contextIdAllocator, logIdAllocator, turnIndex, validation);
+    }
+    const finalizedResults = orderedResults.map((result, idx) => result ?? ({
+        success: false,
+        contextIds: ops[idx].context_ids,
+        error: "Internal error: missing operation result.",
+    }));
+    return {
+        output: formatExecutionOutput(ops, finalizedResults),
+        results: finalizedResults,
+    };
+}
+//# sourceMappingURL=summarize-context.js.map

package/dist/summarize-context.js.map

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

package/dist/templates/loader.d.ts

@@ -0,0 +1,104 @@
+/**
+ * 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 { Agent } from "../agents/agent.js";
+import type { Config } from "../config.js";
+import type { MCPClientManager } from "../mcp-client.js";
+/**
+ * Canonical ordering for tool prompt assembly.
+ * Tools not in this list are appended alphabetically after these.
+ */
+export declare const TOOL_PROMPT_ORDER: string[];
+/**
+ * Paired tool dependencies.
+ * If a tool (key) is in the list, all its required companions (value) must also be present.
+ */
+export declare const TOOL_REQUIRES: Record<string, string[]>;
+/**
+ * Default tools for custom templates that omit `tools` in agent.yaml.
+ * Same set as the executor template.
+ */
+export declare const EXECUTOR_DEFAULT_TOOLS: string[];
+/**
+ * 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 declare function loadTemplate(templateDir: string, config: Config, nameOverride?: string, mcpManager?: MCPClientManager, promptsDirs?: string[]): Agent;
+/**
+ * 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 declare function loadTemplates(bundledRoot: string, config: Config, mcpManager?: MCPClientManager, promptsDirs?: string[], userRoot?: string): Record<string, Agent>;
+/**
+ * Validate a template directory without loading it.
+ * Returns null if valid, or an error message string if invalid.
+ */
+export declare function validateTemplate(templateDir: string): string | null;
+/**
+ * Resolve the prompts/ directory as a sibling of the templates root.
+ * Returns the path if found, or undefined if not.
+ */
+export declare function resolvePromptsDir(templatesRoot: string): string | 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 declare function resolveToolNames(spec: Record<string, unknown>): string[];
+/**
+ * Validate that paired tool dependencies are satisfied.
+ */
+export declare function validateToolDependencies(toolNames: string[]): void;
+/**
+ * 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 declare function assembleToolPrompts(toolNames: string[], promptsDirs: string[]): string;
+/**
+ * Read and concatenate section prompt files.
+ * For each section, the first matching file across `promptsDirs` is used.
+ */
+export declare function assembleSectionPrompts(sections: string[], promptsDirs: string[]): string;
+//# sourceMappingURL=loader.d.ts.map

package/dist/templates/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/templates/loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAMH,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAG3C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAUzD;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,EAiCrC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAIlD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,sBAAsB,EAAE,MAAM,EAgB1C,CAAC;AAMF;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAC1B,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,YAAY,CAAC,EAAE,MAAM,EACrB,UAAU,CAAC,EAAE,gBAAgB,EAC7B,WAAW,CAAC,EAAE,MAAM,EAAE,GACrB,KAAK,CAoEP;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAC3B,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,UAAU,CAAC,EAAE,gBAAgB,EAC7B,WAAW,CAAC,EAAE,MAAM,EAAE,EACtB,QAAQ,CAAC,EAAE,MAAM,GAChB,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAiCvB;AAUD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAyCnE;AAMD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAM3E;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,EAAE,CAMxE;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI,CAYlE;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,EAAE,EACnB,WAAW,EAAE,MAAM,EAAE,GACpB,MAAM,CAsBR;AAaD;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,MAAM,EAAE,EAClB,WAAW,EAAE,MAAM,EAAE,GACpB,MAAM,CAeR"}