evolcore 0.0.25 → 0.0.27

package/ecagent/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2025 Mario Zechner
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2025 Mario Zechner
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/ecagent/NOTICE

@@ -1,11 +1,11 @@
-This distribution contains modified packaging of @earendil-works/pi-agent-core.
-
-Upstream project: https://github.com/earendil-works/pi
-Upstream version: 0.80.7
-Upstream commit: 818d67457cdd6b60bce6b121d16b23141c252dd8
-
-Modification: TypeScript sources from @earendil-works/pi-agent-core and the
-provider-free protocol subset of @earendil-works/pi-ai are maintained together
-in this package. Provider SDK implementations and dependencies are excluded.
-Callers supply a custom model stream function or use the included pi-messages
-protocol runtime.
+This distribution contains modified packaging of @earendil-works/pi-agent-core.
+
+Upstream project: https://github.com/earendil-works/pi
+Upstream version: 0.80.7
+Upstream commit: 818d67457cdd6b60bce6b121d16b23141c252dd8
+
+Modification: TypeScript sources from @earendil-works/pi-agent-core and the
+provider-free protocol subset of @earendil-works/pi-ai are maintained together
+in this package. Provider SDK implementations and dependencies are excluded.
+Callers supply a custom model stream function or use the included pi-messages
+protocol runtime.

package/ecagent/README.md

@@ -1,61 +1,61 @@
-# ecagent
-
-`ecagent` is an unofficial lightweight distribution of
-[`@earendil-works/pi-agent-core`](https://github.com/earendil-works/pi). It
-includes the Pi agent loop, tools, sessions, compaction, skills, and execution
-environment abstractions together with an embedded provider-free model runtime.
-The published package includes both the TypeScript source in `src/` and the
-compiled ESM output in `dist/`.
-
-## Install
-
-```bash
-npm install ecagent
-
-# Or install it globally for a shared Node.js runtime
-npm install --global ecagent
-```
-
-Supply a custom model stream function. No model provider SDK is installed by
-default:
-
-```typescript
-import { Agent } from "ecagent";
-
-const agent = new Agent({
-  initialState: {
-    model,
-    systemPrompt: "You are a coding agent.",
-  },
-  streamFn: evolcoreModelStream,
-});
-```
-
-The `streamFn` must implement the Pi stream contract exported by
-`ecagent/runtime`:
-
-```typescript
-import { AssistantMessageEventStream } from "ecagent/runtime";
-```
-
-EvolCore uses this boundary to connect its own credentials, gateway, streaming,
-and abort handling.
-
-## Build from source
-
-```bash
-npm install
-npm run build
-```
-
-The build runs TypeScript directly over the checked-in source. It does not
-download precompiled upstream artifacts.
-
-## Upstream
-
-- Package: `@earendil-works/pi-agent-core@0.80.7`
-- Runtime: `@earendil-works/pi-ai@0.80.7`
-- Commit: `818d67457cdd6b60bce6b121d16b23141c252dd8`
-- License: MIT
-
-This package is not affiliated with or endorsed by the Pi maintainers.
+# ecagent
+
+`ecagent` is an unofficial lightweight distribution of
+[`@earendil-works/pi-agent-core`](https://github.com/earendil-works/pi). It
+includes the Pi agent loop, tools, sessions, compaction, skills, and execution
+environment abstractions together with an embedded provider-free model runtime.
+The published package includes both the TypeScript source in `src/` and the
+compiled ESM output in `dist/`.
+
+## Install
+
+```bash
+npm install ecagent
+
+# Or install it globally for a shared Node.js runtime
+npm install --global ecagent
+```
+
+Supply a custom model stream function. No model provider SDK is installed by
+default:
+
+```typescript
+import { Agent } from "ecagent";
+
+const agent = new Agent({
+  initialState: {
+    model,
+    systemPrompt: "You are a coding agent.",
+  },
+  streamFn: evolcoreModelStream,
+});
+```
+
+The `streamFn` must implement the Pi stream contract exported by
+`ecagent/runtime`:
+
+```typescript
+import { AssistantMessageEventStream } from "ecagent/runtime";
+```
+
+EvolCore uses this boundary to connect its own credentials, gateway, streaming,
+and abort handling.
+
+## Build from source
+
+```bash
+npm install
+npm run build
+```
+
+The build runs TypeScript directly over the checked-in source. It does not
+download precompiled upstream artifacts.
+
+## Upstream
+
+- Package: `@earendil-works/pi-agent-core@0.80.7`
+- Runtime: `@earendil-works/pi-ai@0.80.7`
+- Commit: `818d67457cdd6b60bce6b121d16b23141c252dd8`
+- License: MIT
+
+This package is not affiliated with or endorsed by the Pi maintainers.

package/ecagent/dist/harness/agent-harness.js

@@ -412,6 +412,9 @@ export class AgentHarness {
     }
     async handleAgentEvent(event, signal) {
         if (event.type === "message_end") {
+            // Persist the same multimodal message that was sent to the provider.
+            // Provider rollouts (Claude/Codex) retain image bytes in their own
+            // session files, so ecagent must do the same for resumable context.
             await this.session.appendMessage(event.message);
             await this.emitAny(event, signal);
             return;

package/ecagent/dist/harness/compaction/branch-summarization.js

@@ -90,37 +90,37 @@ export function prepareBranchEntries(entries, tokenBudget = 0) {
     }
     return { messages, fileOps, totalTokens };
 }
-const BRANCH_SUMMARY_PREAMBLE = `The user explored a different conversation branch before returning here.
-Summary of that exploration:
-
+const BRANCH_SUMMARY_PREAMBLE = `The user explored a different conversation branch before returning here.
+Summary of that exploration:
+
 `;
-const BRANCH_SUMMARY_PROMPT = `Create a structured summary of this conversation branch for context when returning later.
-
-Use this EXACT format:
-
-## Goal
-[What was the user trying to accomplish in this branch?]
-
-## Constraints & Preferences
-- [Any constraints, preferences, or requirements mentioned]
-- [Or "(none)" if none were mentioned]
-
-## Progress
-### Done
-- [x] [Completed tasks/changes]
-
-### In Progress
-- [ ] [Work that was started but not finished]
-
-### Blocked
-- [Issues preventing progress, if any]
-
-## Key Decisions
-- **[Decision]**: [Brief rationale]
-
-## Next Steps
-1. [What should happen next to continue this work]
-
+const BRANCH_SUMMARY_PROMPT = `Create a structured summary of this conversation branch for context when returning later.
+
+Use this EXACT format:
+
+## Goal
+[What was the user trying to accomplish in this branch?]
+
+## Constraints & Preferences
+- [Any constraints, preferences, or requirements mentioned]
+- [Or "(none)" if none were mentioned]
+
+## Progress
+### Done
+- [x] [Completed tasks/changes]
+
+### In Progress
+- [ ] [Work that was started but not finished]
+
+### Blocked
+- [Issues preventing progress, if any]
+
+## Key Decisions
+- **[Decision]**: [Brief rationale]
+
+## Next Steps
+1. [What should happen next to continue this work]
+
 Keep each section concise. Preserve exact file paths, function names, and error messages.`;
 /** Generate a summary for abandoned branch entries. */
 export async function generateBranchSummary(entries, options) {

package/ecagent/dist/harness/compaction/compaction.js

@@ -281,78 +281,78 @@ export function findCutPoint(entries, startIndex, endIndex, keepRecentTokens) {
         isSplitTurn: !isUserMessage && turnStartIndex !== -1,
     };
 }
-export const SUMMARIZATION_SYSTEM_PROMPT = `You are a context summarization assistant. Your task is to read a conversation between a user and an AI assistant, then produce a structured summary following the exact format specified.
-
+export const SUMMARIZATION_SYSTEM_PROMPT = `You are a context summarization assistant. Your task is to read a conversation between a user and an AI assistant, then produce a structured summary following the exact format specified.
+
 Do NOT continue the conversation. Do NOT respond to any questions in the conversation. ONLY output the structured summary.`;
-const SUMMARIZATION_PROMPT = `The messages above are a conversation to summarize. Create a structured context checkpoint summary that another LLM will use to continue the work.
-
-Use this EXACT format:
-
-## Goal
-[What is the user trying to accomplish? Can be multiple items if the session covers different tasks.]
-
-## Constraints & Preferences
-- [Any constraints, preferences, or requirements mentioned by user]
-- [Or "(none)" if none were mentioned]
-
-## Progress
-### Done
-- [x] [Completed tasks/changes]
-
-### In Progress
-- [ ] [Current work]
-
-### Blocked
-- [Issues preventing progress, if any]
-
-## Key Decisions
-- **[Decision]**: [Brief rationale]
-
-## Next Steps
-1. [Ordered list of what should happen next]
-
-## Critical Context
-- [Any data, examples, or references needed to continue]
-- [Or "(none)" if not applicable]
-
+const SUMMARIZATION_PROMPT = `The messages above are a conversation to summarize. Create a structured context checkpoint summary that another LLM will use to continue the work.
+
+Use this EXACT format:
+
+## Goal
+[What is the user trying to accomplish? Can be multiple items if the session covers different tasks.]
+
+## Constraints & Preferences
+- [Any constraints, preferences, or requirements mentioned by user]
+- [Or "(none)" if none were mentioned]
+
+## Progress
+### Done
+- [x] [Completed tasks/changes]
+
+### In Progress
+- [ ] [Current work]
+
+### Blocked
+- [Issues preventing progress, if any]
+
+## Key Decisions
+- **[Decision]**: [Brief rationale]
+
+## Next Steps
+1. [Ordered list of what should happen next]
+
+## Critical Context
+- [Any data, examples, or references needed to continue]
+- [Or "(none)" if not applicable]
+
 Keep each section concise. Preserve exact file paths, function names, and error messages.`;
-const UPDATE_SUMMARIZATION_PROMPT = `The messages above are NEW conversation messages to incorporate into the existing summary provided in <previous-summary> tags.
-
-Update the existing structured summary with new information. RULES:
-- PRESERVE all existing information from the previous summary
-- ADD new progress, decisions, and context from the new messages
-- UPDATE the Progress section: move items from "In Progress" to "Done" when completed
-- UPDATE "Next Steps" based on what was accomplished
-- PRESERVE exact file paths, function names, and error messages
-- If something is no longer relevant, you may remove it
-
-Use this EXACT format:
-
-## Goal
-[Preserve existing goals, add new ones if the task expanded]
-
-## Constraints & Preferences
-- [Preserve existing, add new ones discovered]
-
-## Progress
-### Done
-- [x] [Include previously done items AND newly completed items]
-
-### In Progress
-- [ ] [Current work - update based on progress]
-
-### Blocked
-- [Current blockers - remove if resolved]
-
-## Key Decisions
-- **[Decision]**: [Brief rationale] (preserve all previous, add new)
-
-## Next Steps
-1. [Update based on current state]
-
-## Critical Context
-- [Preserve important context, add new if needed]
-
+const UPDATE_SUMMARIZATION_PROMPT = `The messages above are NEW conversation messages to incorporate into the existing summary provided in <previous-summary> tags.
+
+Update the existing structured summary with new information. RULES:
+- PRESERVE all existing information from the previous summary
+- ADD new progress, decisions, and context from the new messages
+- UPDATE the Progress section: move items from "In Progress" to "Done" when completed
+- UPDATE "Next Steps" based on what was accomplished
+- PRESERVE exact file paths, function names, and error messages
+- If something is no longer relevant, you may remove it
+
+Use this EXACT format:
+
+## Goal
+[Preserve existing goals, add new ones if the task expanded]
+
+## Constraints & Preferences
+- [Preserve existing, add new ones discovered]
+
+## Progress
+### Done
+- [x] [Include previously done items AND newly completed items]
+
+### In Progress
+- [ ] [Current work - update based on progress]
+
+### Blocked
+- [Current blockers - remove if resolved]
+
+## Key Decisions
+- **[Decision]**: [Brief rationale] (preserve all previous, add new)
+
+## Next Steps
+1. [Update based on current state]
+
+## Critical Context
+- [Preserve important context, add new if needed]
+
 Keep each section concise. Preserve exact file paths, function names, and error messages.`;
 /** Generate or update a conversation summary for compaction. */
 export async function generateSummary(currentMessages, models, model, reserveTokens, signal, customInstructions, previousSummary, thinkingLevel) {
@@ -451,19 +451,19 @@ export function prepareCompaction(pathEntries, settings) {
         settings,
     });
 }
-const TURN_PREFIX_SUMMARIZATION_PROMPT = `This is the PREFIX of a turn that was too large to keep. The SUFFIX (recent work) is retained.
-
-Summarize the prefix to provide context for the retained suffix:
-
-## Original Request
-[What did the user ask for in this turn?]
-
-## Early Progress
-- [Key decisions and work done in the prefix]
-
-## Context for Suffix
-- [Information needed to understand the retained recent work]
-
+const TURN_PREFIX_SUMMARIZATION_PROMPT = `This is the PREFIX of a turn that was too large to keep. The SUFFIX (recent work) is retained.
+
+Summarize the prefix to provide context for the retained suffix:
+
+## Original Request
+[What did the user ask for in this turn?]
+
+## Early Progress
+- [Key decisions and work done in the prefix]
+
+## Context for Suffix
+- [Information needed to understand the retained recent work]
+
 Be concise. Focus on what's needed to understand the kept suffix.`;
 export { serializeConversation } from "./utils.js";
 /** Generate compaction summary data from prepared session history. */

package/ecagent/dist/harness/messages.js

@@ -1,12 +1,12 @@
-export const COMPACTION_SUMMARY_PREFIX = `The conversation history before this point was compacted into the following summary:
-
-<summary>
+export const COMPACTION_SUMMARY_PREFIX = `The conversation history before this point was compacted into the following summary:
+
+<summary>
 `;
-export const COMPACTION_SUMMARY_SUFFIX = `
+export const COMPACTION_SUMMARY_SUFFIX = `
 </summary>`;
-export const BRANCH_SUMMARY_PREFIX = `The following is a summary of a branch that this conversation came back from:
-
-<summary>
+export const BRANCH_SUMMARY_PREFIX = `The following is a summary of a branch that this conversation came back from:
+
+<summary>
 `;
 export const BRANCH_SUMMARY_SUFFIX = `</summary>`;
 export function bashExecutionToText(msg) {

package/ecagent/dist/harness/session/jsonl-storage.js

@@ -1,6 +1,25 @@
 import { SessionError, toError } from "../types.js";
 import { getFileSystemResultOrThrow } from "./repo-utils.js";
 import { uuidv7 } from "./uuid.js";
+// Multiple harness instances can briefly reference the same session during a
+// replacement turn. Node's appendFile does not guarantee that large writes
+// from separate calls stay contiguous, so serialize appends per physical file.
+const appendQueues = new Map();
+async function appendSerialized(fs, filePath, content) {
+    const previous = appendQueues.get(filePath) ?? Promise.resolve();
+    let release;
+    const current = new Promise((resolve) => { release = resolve; });
+    appendQueues.set(filePath, current);
+    try {
+        await previous.catch(() => undefined);
+        getFileSystemResultOrThrow(await fs.appendFile(filePath, content), `Failed to append session entry ${filePath}`);
+    }
+    finally {
+        release();
+        if (appendQueues.get(filePath) === current)
+            appendQueues.delete(filePath);
+    }
+}
 function updateLabelCache(labelsById, entry) {
     if (entry.type !== "label")
         return;
@@ -185,7 +204,7 @@ export class JsonlSessionStorage {
             timestamp: new Date().toISOString(),
             targetId: leafId,
         };
-        getFileSystemResultOrThrow(await this.fs.appendFile(this.filePath, `${JSON.stringify(entry)}\n`), `Failed to append session leaf ${entry.id}`);
+        await appendSerialized(this.fs, this.filePath, `${JSON.stringify(entry)}\n`);
         this.entries.push(entry);
         this.byId.set(entry.id, entry);
         this.currentLeafId = leafId;
@@ -194,7 +213,7 @@ export class JsonlSessionStorage {
         return generateEntryId(this.byId);
     }
     async appendEntry(entry) {
-        getFileSystemResultOrThrow(await this.fs.appendFile(this.filePath, `${JSON.stringify(entry)}\n`), `Failed to append session entry ${entry.id}`);
+        await appendSerialized(this.fs, this.filePath, `${JSON.stringify(entry)}\n`);
         this.entries.push(entry);
         this.byId.set(entry.id, entry);
         updateLabelCache(this.labelsById, entry);

package/kits/docs/GUIDE.md

@@ -1,20 +1,20 @@
-# 文档查阅指南
-
-## 查阅流程
-
-1. 先看 `$KITS_RULES`（自动加载的 6 个规则文件 01-06）了解机制骨架
-2. 需要详细信息时，按 `INDEX.md` 找到对应文档路径
-3. Read 对应文档
-
-## 路径解析
-
-文档中用 `$名称` 引用路径。解析步骤：
-1. 查 `$KITS_RULES/02-navigation.md` 的路径体系速查表
-2. 如需完整定义，Read `$KITS_DOCS/path-registry.md`
-3. 如需运行时实际值，Read `$ECK/path-registry.md`
-
-## 不要做的事
-
-- 不要一次性加载所有文档——按需逐个 Read
-- 不要猜测路径——查注册表
-- 不要在当前会话输出对外消息——用 CLI
+# 文档查阅指南
+
+## 查阅流程
+
+1. 先看 `$KITS_RULES`（自动加载的 6 个规则文件 01-06）了解机制骨架
+2. 需要详细信息时，按 `INDEX.md` 找到对应文档路径
+3. Read 对应文档
+
+## 路径解析
+
+文档中用 `$名称` 引用路径。解析步骤：
+1. 查 `$KITS_RULES/02-navigation.md` 的路径体系速查表
+2. 如需完整定义，Read `$KITS_DOCS/path-registry.md`
+3. 如需运行时实际值，Read `$ECK/path-registry.md`
+
+## 不要做的事
+
+- 不要一次性加载所有文档——按需逐个 Read
+- 不要猜测路径——查注册表
+- 不要在当前会话输出对外消息——用 CLI