evolcore 0.0.5 → 0.0.6

package/dist/trigger/state.js

@@ -48,6 +48,70 @@ export class TriggerRunStateStore {
         this.write(triggerId, active);
         return run;
     }
+    startExecutionAttempt(triggerId, runId, input) {
+        const active = this.read(triggerId);
+        const run = active.runs[runId];
+        if (!run)
+            return undefined;
+        const attempts = run.attempts ?? (run.attempts = []);
+        const existing = attempts.find(attempt => attempt.attemptId === input.attemptId);
+        if (existing) {
+            if (input.executionSessionId)
+                existing.executionSessionId = input.executionSessionId;
+        }
+        else {
+            attempts.push({
+                attempt: input.attempt,
+                attemptId: input.attemptId,
+                startedAt: input.startedAt,
+                status: 'running',
+                ...(input.executionSessionId ? { executionSessionId: input.executionSessionId } : {}),
+            });
+            run.events.push({
+                seq: run.events.length,
+                event: 'execution.attempt.started',
+                ts: input.startedAt,
+                attempt: input.attempt,
+                attemptId: input.attemptId,
+                ...(input.executionSessionId ? { executionSessionId: input.executionSessionId } : {}),
+            });
+        }
+        run.attempt = input.attempt;
+        run.attemptId = input.attemptId;
+        if (input.executionSessionId)
+            run.executionSessionId = input.executionSessionId;
+        if (input.executionDeadlineAt !== undefined)
+            run.executionDeadlineAt = input.executionDeadlineAt;
+        this.write(triggerId, active);
+        return run;
+    }
+    completeExecutionAttempt(triggerId, runId, attemptId, result) {
+        const active = this.read(triggerId);
+        const run = active.runs[runId];
+        if (!run)
+            return undefined;
+        const attempt = run.attempts?.find(item => item.attemptId === attemptId);
+        if (!attempt || attempt.status !== 'running')
+            return run;
+        const finishedAt = result.finishedAt ?? Date.now();
+        attempt.status = result.status;
+        attempt.finishedAt = finishedAt;
+        if (result.error)
+            attempt.error = result.error;
+        run.events.push({
+            seq: run.events.length,
+            event: result.status === 'completed' || result.status === 'noop'
+                ? 'execution.attempt.completed'
+                : 'execution.attempt.failed',
+            ts: finishedAt,
+            attempt: attempt.attempt,
+            attemptId,
+            status: result.status,
+            ...(result.error ? { error: result.error } : {}),
+        });
+        this.write(triggerId, active);
+        return run;
+    }
     remove(triggerId, runId) {
         const active = this.read(triggerId);
         delete active.runs[runId];

package/dist/trigger/validation.js

@@ -29,6 +29,35 @@ export function normalizeTriggerDefinition(input, opts = {}) {
 export function validateTriggerDefinition(definition) {
     normalizeTriggerDefinition(definition);
 }
+/**
+ * Keep legacy `per_run` definitions byte-stable while giving runtime code one
+ * canonical representation for session selection and validation.
+ */
+export function normalizeExecutionMode(execution) {
+    if (execution.type !== 'trigger_session')
+        return { type: execution.type };
+    return {
+        type: execution.type,
+        thread: execution.thread === 'per_run' || execution.thread === 'by_run'
+            ? 'by_run'
+            : 'by_trigger',
+    };
+}
+/** Validate the run-concurrency policy against the session ownership model. */
+export function validateConcurrencyCombination(execution, reliability) {
+    // Scripts do not share a model session, so all run-level policies remain valid.
+    if (execution.type === 'script')
+        return;
+    if (reliability.concurrency === 'allow') {
+        const mode = normalizeExecutionMode(execution);
+        if (mode.type === 'target_session') {
+            throw new Error('invalid Trigger concurrency: execution.type=target_session, concurrency=allow; allowed values are forbid or replace');
+        }
+        if (mode.thread === 'by_trigger') {
+            throw new Error('invalid Trigger concurrency: execution.type=trigger_session, thread=by_trigger, concurrency=allow; allowed values are forbid or replace');
+        }
+    }
+}
 export function definitionRevision(definition) {
     const stable = stableStringify(definition);
     return `sha256:${sha256(stable)}`;
@@ -381,8 +410,8 @@ function normalizeExecutionThread(value) {
     const thread = optionalString(value);
     if (thread === undefined)
         return undefined;
-    if (thread !== 'per_run' && thread !== 'by_trigger') {
-        throw new Error('execution.thread must be per_run or by_trigger');
+    if (thread !== 'per_run' && thread !== 'by_run' && thread !== 'by_trigger') {
+        throw new Error('execution.thread must be per_run, by_run, or by_trigger');
     }
     return thread;
 }
@@ -572,6 +601,7 @@ function validateTriggerSemantics(definition) {
     if (execution.type !== 'script' && (definition.feedback.onReply || definition.feedback.onNoop || definition.feedback.onFailure)) {
         throw new Error('feedback.onReply/onNoop/onFailure are only allowed when execution.type=script');
     }
+    validateConcurrencyCombination(execution, definition.reliability);
 }
 function generateTriggerId() {
     return `trig_${Date.now()}_${crypto.randomBytes(4).toString('hex')}`;

package/dist/utils/aid-bind.js

@@ -291,7 +291,7 @@ function resolveBaseagentInfo(config) {
     return { active_baseagent, model, effort };
 }
 function pickFirstBaseagent(baseagents) {
-    for (const name of ['claude', 'codex', 'gemini']) {
+    for (const name of ['claude', 'codex', 'gemini', 'ecagent']) {
         if (baseagents[name] !== undefined)
             return name;
     }

package/dist/utils/error-utils.js

@@ -54,6 +54,15 @@ const NON_INFRA_TERMINAL_REASONS = new Set([
     'aborted_streaming',
     'aborted_tools',
 ]);
+/**
+ * SDK terminal reasons that mean the current turn was stopped before normal
+ * completion.  In particular, Claude reports a declined/expired
+ * AskUserQuestion as `aborted_tools`; that is a user interaction outcome, not
+ * an infrastructure or agent execution failure.
+ */
+export function isAbortTerminalReason(terminalReason) {
+    return terminalReason === 'aborted_streaming' || terminalReason === 'aborted_tools';
+}
 export function isInfraError(subtype, terminalReason) {
     // terminalReason 优先级更高（更精确）
     if (terminalReason && NON_INFRA_TERMINAL_REASONS.has(terminalReason)) {

package/dist/utils/welcome.js

@@ -8,8 +8,7 @@
  * - 所有 IM 渠道（Feishu/WeChat/DingTalk/QQBot/WeCom）：首次交互时发送给交互用户（被动响应）
  */
 import fs from 'fs';
-import path from 'path';
-import { resolvePaths } from '../paths.js';
+import { channelStatePath } from '../paths.js';
 import { loadAgent, saveAgent } from '../config-store.js';
 import { withLifecycleForWrite } from '../config/lifecycle.js';
 import { logger } from './logger.js';
@@ -157,7 +156,7 @@ export class FirstInteractionWelcomeManager {
         this.agentAid = agentAid;
         this.channelName = channelName;
         // 每个 channel instance 独立的已欢迎用户记录
-        this.greetedUsersFile = path.join(resolvePaths().dataDir, `${channelType}-greeted-${channelName}.jsonl`);
+        this.greetedUsersFile = channelStatePath(channelName, 'welcome.jsonl');
         this.loadGreetedUsers();
     }
     /**

package/ecagent/LICENSE

@@ -0,0 +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.

package/ecagent/NOTICE

@@ -0,0 +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.

package/ecagent/README.md

@@ -0,0 +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.

package/ecagent/dist/agent-loop.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Agent loop that works with AgentMessage throughout.
+ * Transforms to Message[] only at the LLM call boundary.
+ */
+import { EventStream } from "ecagent/runtime/compat";
+import type { AgentContext, AgentEvent, AgentLoopConfig, AgentMessage, StreamFn } from "./types.ts";
+export type AgentEventSink = (event: AgentEvent) => Promise<void> | void;
+/**
+ * Start an agent loop with a new prompt message.
+ * The prompt is added to the context and events are emitted for it.
+ */
+export declare function agentLoop(prompts: AgentMessage[], context: AgentContext, config: AgentLoopConfig, signal?: AbortSignal, streamFn?: StreamFn): EventStream<AgentEvent, AgentMessage[]>;
+/**
+ * Continue an agent loop from the current context without adding a new message.
+ * Used for retries - context already has user message or tool results.
+ *
+ * **Important:** The last message in context must convert to a `user` or `toolResult` message
+ * via `convertToLlm`. If it doesn't, the LLM provider will reject the request.
+ * This cannot be validated here since `convertToLlm` is only called once per turn.
+ */
+export declare function agentLoopContinue(context: AgentContext, config: AgentLoopConfig, signal?: AbortSignal, streamFn?: StreamFn): EventStream<AgentEvent, AgentMessage[]>;
+export declare function runAgentLoop(prompts: AgentMessage[], context: AgentContext, config: AgentLoopConfig, emit: AgentEventSink, signal?: AbortSignal, streamFn?: StreamFn): Promise<AgentMessage[]>;
+export declare function runAgentLoopContinue(context: AgentContext, config: AgentLoopConfig, emit: AgentEventSink, signal?: AbortSignal, streamFn?: StreamFn): Promise<AgentMessage[]>;
+//# sourceMappingURL=agent-loop.d.ts.map

package/ecagent/dist/agent-loop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-loop.d.ts","sourceRoot":"","sources":["../src/agent-loop.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAGN,WAAW,EAIX,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EACX,YAAY,EACZ,UAAU,EACV,eAAe,EACf,YAAY,EAIZ,QAAQ,EACR,MAAM,YAAY,CAAC;AAEpB,MAAM,MAAM,cAAc,GAAG,CAAC,KAAK,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAEzE;;;GAGG;AACH,wBAAgB,SAAS,CACxB,OAAO,EAAE,YAAY,EAAE,EACvB,OAAO,EAAE,YAAY,EACrB,MAAM,EAAE,eAAe,EACvB,MAAM,CAAC,EAAE,WAAW,EACpB,QAAQ,CAAC,EAAE,QAAQ,GACjB,WAAW,CAAC,UAAU,EAAE,YAAY,EAAE,CAAC,CAiBzC;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAChC,OAAO,EAAE,YAAY,EACrB,MAAM,EAAE,eAAe,EACvB,MAAM,CAAC,EAAE,WAAW,EACpB,QAAQ,CAAC,EAAE,QAAQ,GACjB,WAAW,CAAC,UAAU,EAAE,YAAY,EAAE,CAAC,CAwBzC;AAED,wBAAsB,YAAY,CACjC,OAAO,EAAE,YAAY,EAAE,EACvB,OAAO,EAAE,YAAY,EACrB,MAAM,EAAE,eAAe,EACvB,IAAI,EAAE,cAAc,EACpB,MAAM,CAAC,EAAE,WAAW,EACpB,QAAQ,CAAC,EAAE,QAAQ,GACjB,OAAO,CAAC,YAAY,EAAE,CAAC,CAgBzB;AAED,wBAAsB,oBAAoB,CACzC,OAAO,EAAE,YAAY,EACrB,MAAM,EAAE,eAAe,EACvB,IAAI,EAAE,cAAc,EACpB,MAAM,CAAC,EAAE,WAAW,EACpB,QAAQ,CAAC,EAAE,QAAQ,GACjB,OAAO,CAAC,YAAY,EAAE,CAAC,CAiBzB"}