@gencode/agents 0.9.2 → 0.9.3-preview.2

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @gencode/agents
 
+## 0.9.3
+
+### Patch Changes
+
+- 4a2a4f7: 修复使用 `apiFormat: "anthropic-messages"` 连接 Anthropic Messages API 或兼容网关时，部分网关只在完整 assistant 消息中返回最终文本、或返回格式正常但没有文本和工具调用的空响应，导致 agent 可能丢失最终回复或静默结束的问题。修复后系统会从完整 assistant 消息中补齐最终文本，并将真正的空响应识别为可重试错误交给既有重试逻辑处理，无需调整 API 配置。
+- 833f2dc: 为 agent 运行的收尾阶段增加超时保护与降级策略，避免因单个步骤阻塞导致整个流程挂起：
+
+  - **Session 标题生成**：增加 5 秒超时上限，超时或生成失败时自动降级为基于首条消息的本地标题，不再阻塞 session 结算流程。
+  - **Agent 运行超时**：启用 agent run 的 10 分钟默认超时（可通过 `timeoutMs` 参数配置），超时后优雅中止并记录诊断日志，而非无限挂起。
+  - **HTTP Callback 回调**：为 callback 事件投递增加 5 秒超时，超时或网络错误时仅记录日志，不再抛出异常导致进程崩溃。
+  - **WebSocket 连接与关闭**：为 WebSocket 建连和关闭分别增加 5 秒超时保护，防止连接异常时事件发送流程阻塞。
+
 ## 0.9.2
 
 ### Patch Changes

package/dist/index.d.ts

@@ -511,6 +511,7 @@ type LlmApiFormat = "openai-completions" | "anthropic-messages";
 //#region src/history/topic-segmentation.d.ts
 type TopicSegmentationConfig = {
   enabled?: boolean;
+  embeddingModelDir?: string;
   minUserTurns?: number;
   minEstimatedTokens?: number;
   recentProtectedTurnCount?: number;
@@ -732,7 +733,20 @@ type AgentRunParamsBase = {
    * Older turns are dropped before the history is sent to the LLM.
    * 0 or undefined means no limit.
    */
-  historyLimit?: number; /** Optional IM-style topic segmentation prefilter. Enabled by default unless enabled=false. */
+  historyLimit?: number;
+  /**
+   * Optional session-scoped environment variables to inject into child processes
+   * spawned by the `exec` / `process` tools and exposed to plugin scripts via
+   * the plugin runtime context.
+   *
+   * Merge order (later entries win):
+   *   process.env < run-level `env` < per-call `exec.env` params
+   *
+   * The values are kept in memory only for the duration of the run; they are
+   * never written to disk and never cross a session boundary. Subagent runs
+   * inherit this map via the standard `subagent_spawn` plumbing.
+   */
+  env?: Record<string, string>; /** Optional IM-style topic segmentation prefilter. Enabled by default unless enabled=false. */
   topicSegmentation?: TopicSegmentationConfig;
   /**
    * Goal to create when this run establishes a new session (CLI `run --goal` without --session-id).
@@ -1064,6 +1078,7 @@ type GenerateTitleParams = {
   signal?: AbortSignal;
   hooks?: PluginHookRegistry;
   hookCtx?: PluginHookAgentContext;
+  onFallback?: (reason: "timeout" | "error") => void;
 };
 declare function generateSessionTitle(params: GenerateTitleParams): Promise<string>;
 //#endregion
@@ -1888,6 +1903,12 @@ type ProcessStartParams = {
   command: string;
   cwd: string;
   env?: Record<string, string>;
+  /**
+   * Run-level baseline env, applied after `process.env` but before `env`.
+   * Used to carry session-scoped env from the AgentRunParams through to
+   * the spawned child process.
+   */
+  baseEnv?: Record<string, string>;
   timeoutSec: number;
   scopeKey?: string;
 };
@@ -1922,6 +1943,12 @@ type ExecToolOptions = {
   scopeKey?: string;
   contextManager?: ContextManager;
   hitlResume?: AgentRunParams["hitlResume"];
+  /**
+   * Run-level baseline environment variables, applied after `process.env`
+   * but before any per-call `params.env`. Used to carry session-scoped
+   * env from `AgentRunParams.env` to the spawned child process.
+   */
+  baseEnv?: Record<string, string>;
 };
 declare function createExecTool(options: ExecToolOptions): AgentTool<typeof execSchema, Record<string, unknown>>;
 //#endregion
@@ -2152,7 +2179,7 @@ type BatchSpawnResult = {
   status: "done" | "partial_error" | "error";
   results: BatchSpawnItemResult[];
 };
-type InheritedRunParams = Pick<AgentRunParams, "plugins" | "skillsLoadPaths" | "memory" | "messaging" | "historyLimit" | "topicSegmentation" | "onProgress" | "messageId" | "sessionStoreName" | "autoSkills" | "agentPolicy">;
+type InheritedRunParams = Pick<AgentRunParams, "plugins" | "skillsLoadPaths" | "memory" | "messaging" | "historyLimit" | "topicSegmentation" | "onProgress" | "messageId" | "sessionStoreName" | "autoSkills" | "agentPolicy" | "projectDir" | "env">;
 /** Formats the announce message injected into the parent session when a subagent completes. */
 declare function buildSubagentAnnounceMessage(params: {
   task: string;
@@ -2299,7 +2326,7 @@ type SubagentToolsContext = {
   depth: number;
   channel: AgentRunParams["channel"];
   llm: AgentRunParams["llm"];
-  inheritedRunParams?: Pick<AgentRunParams, "plugins" | "skillsLoadPaths" | "memory" | "messaging" | "historyLimit" | "topicSegmentation" | "onProgress" | "messageId" | "sessionStoreName" | "autoSkills" | "agentPolicy">;
+  inheritedRunParams?: Pick<AgentRunParams, "plugins" | "skillsLoadPaths" | "memory" | "messaging" | "historyLimit" | "topicSegmentation" | "onProgress" | "messageId" | "sessionStoreName" | "autoSkills" | "agentPolicy" | "projectDir" | "env">;
   loopDetection?: ToolLoopDetectionConfig;
   autoSkillsLoadEnabled?: boolean;
   memoryOptions?: MemoryToolOptions;
@@ -2312,6 +2339,11 @@ type SubagentToolsContext = {
   hitlResume?: AgentRunParams["hitlResume"];
   eventDispatcher?: RunEventDispatcher; /** Callback that runs a child agent; injected to avoid circular imports */
   spawnFn: (params: AgentRunParams) => Promise<AgentRunResult>;
+  /**
+   * Run-level baseline env applied to every spawned child process. Sourced
+   * from `AgentRunParams.env` and inherited by subagent runs.
+   */
+  baseEnv?: Record<string, string>;
 };
 /**
  * Creates the full set of agent tools for a given data directory.
@@ -2447,9 +2479,22 @@ type PluginRuntime = {
       error: (message: string) => void;
     };
   };
+  /**
+   * Read-only view of session-scoped state. Exposed to plugins so they can
+   * discover per-run configuration (e.g. environment variables passed via
+   * `AgentRunParams.env`) without re-plumbing the data through config.
+   */
+  session: {
+    env: Record<string, string>;
+  };
 };
 type CreatePluginRuntimeOptions = {
   pluginId: string;
+  /**
+   * Session-scoped env map mirrored from the current run. Frozen to
+   * prevent plugins from mutating shared state.
+   */
+  env?: Record<string, string>;
 };
 declare function createPluginRuntime(options: CreatePluginRuntimeOptions): PluginRuntime;
 //#endregion
@@ -2500,6 +2545,16 @@ type PluginRuntimeContext = {
   };
   hookCtx?: PluginHookAgentContext;
   llmAllowlist?: string[];
+  /**
+   * Session-scoped environment variables supplied via `AgentRunParams.env`.
+   * Plugins that spawn child processes (e.g. via the `exec` tool) should
+   * merge this map into the child process environment. Plugins may also
+   * read values from this map to discover session-scoped configuration.
+   *
+   * The map is held in memory only for the duration of the run and is
+   * never written to disk; it does not cross session boundaries.
+   */
+  env?: Record<string, string>;
 };
 //#endregion
 //#region src/plugins/loader.d.ts