evolcore 0.0.23 → 0.0.25

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/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/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

package/kits/docs/INDEX.md

@@ -1,66 +1,66 @@
-# EvolCore 文档索引
-
-本文件是 `$KITS_DOCS` 下所有文档的索引。
-
-## 路径与机制
-
-| 文档 | 路径 | 说明 |
-|------|------|------|
-| 查阅指南 | `GUIDE.md` | 文档查阅流程 |
-| 路径定义 | `path-registry.md` | 所有预定义路径及派生规则 |
-| 上下文组装机制 | `context-assembly.md` | manifest 装配机制：when 条件/合并覆盖/模板渲染/运行时变量/调试输出 |
-
-## AUN 协议
-
-| 文档 | 路径 | 说明 |
-|------|------|------|
-| 速查表 | `aun/CHEATSHEET.md` | AUN 协议命名空间与常用操作速查 |
-| 同步协议 | `aun/SYNC_PROTOCOL.md` | 上游协议同步 SOP |
-
-## EvolCore 命令
-
-所有 `ec` 命令集的专属目录（用途/触发词/适用场景/文档）见 `evolcore/INDEX.md`。
-运行时由 `commands` fragment 按场景注入精简能力卡。
-
-| 文档 | 路径 | 说明 |
-|------|------|------|
-| 命令集目录 | `evolcore/INDEX.md` | msg/group/agent/aid/storage/ctl/rpc/bench 全集索引 |
-| 联系人命令 | `evolcore/contact.md` | Contact Book 添加申请、拉黑与托管会话权限边界 |
-
-## 身份
-
-| 文档 | 路径 | 说明 |
-|------|------|------|
-| 身份工具 | `identity/identity-tools.md` | 身份识别与环境层工具 |
-| 角色详情 | `identity/ROLE_DETAIL.md` | 角色与场景详细规则 |
-| AID 档案规范 | `identity/AID_PROFILE_SPEC.md` | AID 档案格式规范 |
-| 路径运维 | `identity/PATH_OPS.md` | 路径运维操作 |
-
-## 渠道（知识文档·按需加载，不依赖当前渠道）
-
-| 文档 | 路径 | 说明 |
-|------|------|------|
-| AUN 渠道 | `channels/aun.md` | AUN 渠道配置、参数与特有机制（网关发现/E2EE/群 ID/证书链） |
-| 飞书渠道 | `channels/feishu.md` | 飞书渠道配置、参数与特有机制（appId/合并转发/卡片/user_id） |
-
-## 触发器
-
-| 文档 | 路径 | 说明 |
-|------|------|------|
-| Trigger 命令手册 | `evolcore/trigger.md` | 使用 `create` 创建并管理、运行定时与事件 trigger；`set` 为兼容别名 |
-| EventBus 事件目录 | `evolcore/event.md` | event source 可监听事件、payload、filter 与循环防护规则 |
-
-## ECK 模板
-
-| 文档 | 路径 | 说明 |
-|------|------|------|
-| 运行时配置模板 | `eck_templates/runtime.template.md` | agent 运行时配置模板 |
-| 路径注册表模板 | `eck_templates/path-registry.template.md` | 路径实例模板 |
-| 索引模板 | `eck_templates/INDEX.template.md` | agent 级索引模板 |
-| 指南模板 | `eck_templates/GUIDE.template.md` | agent 级查阅指南模板 |
-
-## Base Agent
-
-| 文档 | 路径 | 说明 |
-|------|------|------|
-| Claude Code 日志 | `baseagent/cc-logs.md` | CC 会话日志查阅（找完整对话/工具调用/注入） |
+# EvolCore 文档索引
+
+本文件是 `$KITS_DOCS` 下所有文档的索引。
+
+## 路径与机制
+
+| 文档 | 路径 | 说明 |
+|------|------|------|
+| 查阅指南 | `GUIDE.md` | 文档查阅流程 |
+| 路径定义 | `path-registry.md` | 所有预定义路径及派生规则 |
+| 上下文组装机制 | `context-assembly.md` | manifest 装配机制：when 条件/合并覆盖/模板渲染/运行时变量/调试输出 |
+
+## AUN 协议
+
+| 文档 | 路径 | 说明 |
+|------|------|------|
+| 速查表 | `aun/CHEATSHEET.md` | AUN 协议命名空间与常用操作速查 |
+| 同步协议 | `aun/SYNC_PROTOCOL.md` | 上游协议同步 SOP |
+
+## EvolCore 命令
+
+所有 `ec` 命令集的专属目录（用途/触发词/适用场景/文档）见 `evolcore/INDEX.md`。
+运行时由 `commands` fragment 按场景注入精简能力卡。
+
+| 文档 | 路径 | 说明 |
+|------|------|------|
+| 命令集目录 | `evolcore/INDEX.md` | msg/group/agent/aid/storage/ctl/rpc/bench 全集索引 |
+| 联系人命令 | `evolcore/contact.md` | Contact Book 添加申请、拉黑与托管会话权限边界 |
+
+## 身份
+
+| 文档 | 路径 | 说明 |
+|------|------|------|
+| 身份工具 | `identity/identity-tools.md` | 身份识别与环境层工具 |
+| 角色详情 | `identity/ROLE_DETAIL.md` | 角色与场景详细规则 |
+| AID 档案规范 | `identity/AID_PROFILE_SPEC.md` | AID 档案格式规范 |
+| 路径运维 | `identity/PATH_OPS.md` | 路径运维操作 |
+
+## 渠道（知识文档·按需加载，不依赖当前渠道）
+
+| 文档 | 路径 | 说明 |
+|------|------|------|
+| AUN 渠道 | `channels/aun.md` | AUN 渠道配置、参数与特有机制（网关发现/E2EE/群 ID/证书链） |
+| 飞书渠道 | `channels/feishu.md` | 飞书渠道配置、参数与特有机制（appId/合并转发/卡片/user_id） |
+
+## 触发器
+
+| 文档 | 路径 | 说明 |
+|------|------|------|
+| Trigger 命令手册 | `evolcore/trigger.md` | 使用 `create` 创建并管理、运行定时与事件 trigger；`set` 为兼容别名 |
+| EventBus 事件目录 | `evolcore/event.md` | event source 可监听事件、payload、filter 与循环防护规则 |
+
+## ECK 模板
+
+| 文档 | 路径 | 说明 |
+|------|------|------|
+| 运行时配置模板 | `eck_templates/runtime.template.md` | agent 运行时配置模板 |
+| 路径注册表模板 | `eck_templates/path-registry.template.md` | 路径实例模板 |
+| 索引模板 | `eck_templates/INDEX.template.md` | agent 级索引模板 |
+| 指南模板 | `eck_templates/GUIDE.template.md` | agent 级查阅指南模板 |
+
+## Base Agent
+
+| 文档 | 路径 | 说明 |
+|------|------|------|
+| Claude Code 日志 | `baseagent/cc-logs.md` | CC 会话日志查阅（找完整对话/工具调用/注入） |