@epoch-agent/runtime 0.4.0 → 0.5.0

package/dist/index.d.ts

@@ -2,7 +2,7 @@ import { GoalRoundResult, Goal, GoalWrite, GoalClear, Workspace, TrustDecision,
 export { DEFAULT_GOAL_MAX_ROUNDS, MAX_GOAL_MAX_ROUNDS, MAX_OBJECTIVE_CHARS, MAX_REASON_CHARS, SANDBOX_COVERS, SANDBOX_EXCLUDES, SCHEDULE_DEFAULTS, SCHEDULE_DEFAULT_ALLOWLIST, nextRunAt, readRecording, skillIndexDescription } from '@epoch-agent/core';
 import { McpServerConfig, McpServerStatus, McpServerSource, McpTransport, McpAuthStatus } from '@epoch-agent/plugin-mcp';
 export { McpAuthState, McpAuthStatus, McpServerConfig } from '@epoch-agent/plugin-mcp';
-import { Lang, DiagnosticSink, EpochContentPart, EpochToolCall, EpochToolResult, EpochTurnFacts, TokenUsage, EpochMessage, ApprovalRequest, ApprovalReply, QuestionRequest, QuestionAnswer, EpochUserContent, AgentEvent, CustomCommandDef, ExpandedCommand, ToolProvider, ModelRef, SetSelectionResult, EpochTool, AgentRole, ProviderType, SecretStore, WireModelSource, WireModelProbeStatus, PermissionLevel, ModelSelection, SelectionContext, ScheduleRunStatus, ScheduleRun, ScheduleDefinition, ScheduleBackendKind, ScheduleRunnerSpec, LogFn, EpochConfig, ActiveAgentRole, ApprovalOutcome, PermissionManager as PermissionManager$1, TrustManager as TrustManager$1, ContextBreakdown, Diagnostic } from '@epoch-agent/protocol';
+import { Lang, DiagnosticSink, EpochContentPart, EpochToolCall, EpochToolResult, EpochTurnFacts, FinishReason, TokenUsage, EpochMessage, ApprovalRequest, ApprovalReply, QuestionRequest, QuestionAnswer, EpochUserContent, AgentEvent, CustomCommandDef, ExpandedCommand, ToolProvider, ModelRef, SetSelectionResult, EpochTool, AgentRole, ProviderType, SecretStore, WireModelSource, WireModelProbeStatus, PermissionLevel, ModelSelection, SelectionContext, ScheduleRunStatus, ScheduleRun, ScheduleDefinition, ScheduleBackendKind, ScheduleRunnerSpec, LogFn, EpochConfig, ActiveAgentRole, ApprovalOutcome, PermissionManager as PermissionManager$1, TrustManager as TrustManager$1, ContextBreakdown, Diagnostic } from '@epoch-agent/protocol';
 export { BackgroundTaskInfo, BackgroundTaskStatus } from '@epoch-agent/protocol';
 export { t } from '@epoch-agent/infra';
 export { taskOutput as backgroundTaskOutput, listTasks as listBackgroundTasks } from '@epoch-agent/plugin-terminal';
@@ -720,6 +720,23 @@ interface TurnDetail {
      * 整个不画，而不是画一行 0。判据全文在 protocol 的 `EpochTurnFacts` 上。
      */
     facts?: EpochTurnFacts;
+    /**
+     * 这一轮为什么停（`finish` 事件的 `reason`，2026-09-04）。落在**最后一条
+     * assistant 行**的 `finish_reason` 列上，同 {@link facts}。
+     *
+     * ## 这一列以前是全 NULL
+     *
+     * 建表时就有（`core/src/session/db.ts` 的 `finish_reason TEXT`），
+     * `insertMessage` 也一直在写 `msg.finishReason ?? null` —— 缺的只是**没有任何
+     * 生产调用方往下传过它**。一台真机上量过：687 条消息，这一列 687 个 NULL。
+     *
+     * 后果是「这一轮为什么停」这个问题**事后无解**，而它是所有「模型半路停下」类
+     * 问题的第一个分诊问题：`'stop'`（自己收工）和 `'length'`（被 provider 按
+     * max output tokens 切了）在界面上长得一模一样，都是「这一轮没有工具调用」。
+     *
+     * 不给就照旧写 NULL —— 那一轮只是答不出这个问题，别的一切不变。
+     */
+    finishReason?: FinishReason;
     /**
      * 本轮模型请求过的全部工具调用，按事件到达顺序。
      *
@@ -1804,7 +1821,7 @@ interface HostAgentRole {
      * `echo > file` 绕开「没有 file_write」）。宿主别拿它当沙箱。
      */
     tools?: string[];
-    /** 轮次预算。不给则沿用 `max(4, floor(父 maxTurns / 2))` */
+    /** 轮次预算。不给则沿用 `config.maxTurns`（2026-09-04 前是它的一半） */
     maxTurns?: number;
 }
 /**

package/dist/index.js

@@ -1,4 +1,4 @@
-import { loadCommandDefinitions, SLASH_COMMANDS_DIAG_MODULE, createToolScope, expandCommand, RecentWorkspaces, clearModelCache, discoverModels, substitutePluginRoot, ScheduleStore, isWithinWindow, acquireScheduleLock, triggerPeriodMs, ScheduleRecorder, pruneRecordings, suggestRuleFromApproval, needsAllowlist, isNonInteractive, loadPlugins, assertLevelAllowed, discoverProject, ProviderRouter, ProviderError, PROVIDER_NO_CREDENTIAL, SessionManager, GoalService, MemoryManager, MemoryReviewer, resolveSkillDirs, SkillSystem, SkillLearner, HookManager, loadHookSources, ApprovalCache, PermissionManager, resolvePolicyDirs, resolvePoliciesDir, loadPolicyFiles, checkShadowing, compileRuleLists, ContextCompressor, compressionOptions, TrackerDB, getConfigOrigins, resolveComplianceDirs, resolveComplianceDir, loadLexiconFiles, ComplianceEngine, DEFAULT_COMPLIANCE_SETTINGS, mapOperationType, affectedPaths, workspaceDisplayPath, persistParts, persistToolResults, ToolRegistry, createTodoTool, createGoalTool, createMemoryTool, createCodeExecTool, createRunCodeTool, createSkillViewTool, createSkillWriteTools, createToolSearchTool, createToolRevealState, createAskQuestionTool, resolveWorkspace, unloadedInstructionFiles, resolveProjectRoot, loadConfig, CodeSandbox, CheckpointManager, createDelegateTool, findRole, persistedUsage, systemOpenArgv, resolveInWorkspace, listWorkspaceFiles, loadRoleDefinitions, mergeRoles, AGENT_ROLE_DIAG_MODULE, builtinRoles, unknownRoleTools, BLOCKED_TOOLS, blockedRoleTools, unknownRoleSkills, BudgetStore, mergeHeadlessPolicy, describeHeadlessPolicy, importSkills, previewSkillImport, removeSessionArtifacts, gateForTool, managedSwitchNotes, originOf, EpochConfigSchema, defaultConfig, SettingsFileSchema, isWritableSettingKey, writeSettingValue, SETTING_WRITE_APPLY, resolveSettings, SETTING_WRITE_LAYERS, readProviderKeyEnv, validateSchedule, createAllowAllGate, setTrustGate, TrustManager, createTrustGate, createDenyAllGate, getImportGate, setImportGate, createAllowAllImportGate, ImportTrustStore, createDenyAllImportGate, createImportGate, getCapability, restoreParts, createSessionSearchTools, PlanModeState, createPlanModeTools, toolTableTokens, explainSetting, settingWriteTargets, settingValueKind, settingValueChoices, uninstallPlugin, removeMarketplace, addMarketplace, readMarketplaces, searchMarketplaces, resolveEntrySource, resolveSource, readPluginRecords, createRoleFile, AgentLoop, resolveArtifactRetention, roleScopedProvider, createRoleScope, revealScopedProvider, withGoalPrompt, withGoalCompression, ScheduleRegistrar, resolveScheduleBackend, updateMarketplace, SETTINGS_LAYER_ORDER, resolveMarketplaceRef, BudgetGuard, installPlugin, currentEpochVersion } from '@epoch-agent/core';
+import { loadCommandDefinitions, SLASH_COMMANDS_DIAG_MODULE, createToolScope, expandCommand, RecentWorkspaces, clearModelCache, discoverModels, substitutePluginRoot, ScheduleStore, isWithinWindow, acquireScheduleLock, triggerPeriodMs, ScheduleRecorder, pruneRecordings, suggestRuleFromApproval, needsAllowlist, isNonInteractive, loadPlugins, assertLevelAllowed, discoverProject, ProviderRouter, ProviderError, PROVIDER_NO_CREDENTIAL, SessionManager, GoalService, MemoryManager, MemoryReviewer, resolveSkillDirs, SkillSystem, SkillLearner, HookManager, loadHookSources, ApprovalCache, PermissionManager, resolvePolicyDirs, resolvePoliciesDir, loadPolicyFiles, checkShadowing, compileRuleLists, ContextCompressor, compressionOptions, TrackerDB, getConfigOrigins, resolveComplianceDirs, resolveComplianceDir, loadLexiconFiles, ComplianceEngine, DEFAULT_COMPLIANCE_SETTINGS, mapOperationType, affectedPaths, workspaceDisplayPath, persistParts, persistToolResults, ToolRegistry, createTodoTool, createGoalTool, createMemoryTool, createCodeExecTool, createRunCodeTool, createSkillViewTool, createSkillWriteTools, createToolSearchTool, createToolRevealState, createAskQuestionTool, resolveWorkspace, unloadedInstructionFiles, resolveProjectRoot, loadConfig, CodeSandbox, CheckpointManager, createDelegateTool, findRole, persistedUsage, systemOpenArgv, resolveInWorkspace, listWorkspaceFiles, loadRoleDefinitions, mergeRoles, AGENT_ROLE_DIAG_MODULE, builtinRoles, unknownRoleTools, BLOCKED_TOOLS, blockedRoleTools, unknownRoleSkills, BudgetStore, mergeHeadlessPolicy, describeHeadlessPolicy, importSkills, previewSkillImport, removeSessionArtifacts, gateForTool, managedSwitchNotes, originOf, EpochConfigSchema, defaultConfig, SettingsFileSchema, isWritableSettingKey, writeSettingValue, SETTING_WRITE_APPLY, resolveSettings, SETTING_WRITE_LAYERS, readProviderKeyEnv, validateSchedule, SCHEDULE_DEFAULTS, createAllowAllGate, setTrustGate, TrustManager, createTrustGate, createDenyAllGate, getImportGate, setImportGate, createAllowAllImportGate, ImportTrustStore, createDenyAllImportGate, createImportGate, getCapability, restoreParts, createSessionSearchTools, PlanModeState, createPlanModeTools, toolTableTokens, explainSetting, settingWriteTargets, settingValueKind, settingValueChoices, uninstallPlugin, removeMarketplace, addMarketplace, readMarketplaces, searchMarketplaces, resolveEntrySource, resolveSource, readPluginRecords, createRoleFile, AgentLoop, resolveArtifactRetention, roleScopedProvider, createRoleScope, revealScopedProvider, withGoalPrompt, withGoalCompression, ScheduleRegistrar, resolveScheduleBackend, updateMarketplace, SETTINGS_LAYER_ORDER, resolveMarketplaceRef, BudgetGuard, installPlugin, currentEpochVersion } from '@epoch-agent/core';
 export { DEFAULT_GOAL_MAX_ROUNDS, MAX_GOAL_MAX_ROUNDS, MAX_OBJECTIVE_CHARS, MAX_REASON_CHARS, SANDBOX_COVERS, SANDBOX_EXCLUDES, SCHEDULE_DEFAULTS, SCHEDULE_DEFAULT_ALLOWLIST, nextRunAt, readRecording, skillIndexDescription } from '@epoch-agent/core';
 import { projectCommandsDir, commandsDir, t, issueDetails, resolveHomeDir, configPath, readKey, setScalar, setSectionField, mcpConfigPath, workspacesPath, writeProviderSecret, envPath, maskApiKey, dbPath, automationLogsDir, pluginsStatePath, safeInit, memoriesDir, skillsDir, claudeUserSettingsPath, hooksPath, artifactsDir, resolveRipgrep, withTimeout, createProcessTable, marketplacesPath, pluginsDir, agentsDir, budgetStatePath, createSecretStore, setSecretStore, prefetchProviderSecrets, setSecretValues, migrateEnvSecrets, setDataKey, parseDataKey, generateDataKey, i18nDiagnostics, automationWorkDir, trustPath, trustedImportsPath, setShell, probeShell } from '@epoch-agent/infra';
 export { t } from '@epoch-agent/infra';
@@ -1730,9 +1730,9 @@ function createScheduleControl(opts) {
         prompt: input.prompt,
         permission: input.permission,
         workDir,
-        maxTurns: input.maxTurns ?? 20,
+        maxTurns: input.maxTurns ?? SCHEDULE_DEFAULTS.maxTurns,
         maxBudgetUsd: input.maxBudgetUsd,
-        timeoutMs: input.timeoutMs ?? 15 * 60 * 1e3,
+        timeoutMs: input.timeoutMs ?? SCHEDULE_DEFAULTS.timeoutMs,
         trigger: input.trigger,
         ...input.startDate !== void 0 ? { startDate: input.startDate } : {},
         ...input.endDate !== void 0 ? { endDate: input.endDate } : {},
@@ -2411,6 +2411,7 @@ var init_agent_session = __esm({
       }
       async *run(userMessage, opts = {}) {
         let assistantText = "";
+        let finishReason;
         const userText = contentToText(userMessage);
         const parts = typeof userMessage === "string" ? void 0 : userMessage;
         const turn = new TurnStepCollector(Date.now());
@@ -2453,6 +2454,7 @@ var init_agent_session = __esm({
             if (done2) break;
             pendingNext = iter.next();
             if (event.type === "text-delta") assistantText += event.text;
+            if (event.type === "finish") finishReason = event.reason;
             turn.observe(event);
             publishAgentEvent(this.sessionId, event);
             yield event;
@@ -2474,7 +2476,8 @@ var init_agent_session = __esm({
         this.store?.record(this.sessionId, userText, assistantText, {
           ...parts ? { parts } : {},
           ...steps.length > 0 ? { steps } : {},
-          ...facts ? { facts } : {}
+          ...facts ? { facts } : {},
+          ...finishReason ? { finishReason } : {}
         });
       }
       markRoleHandoff() {
@@ -2725,7 +2728,8 @@ var init_session_store = __esm({
               content: step.text ?? "",
               ...toolCalls ? { toolCalls } : {},
               ...step.reasoning ? { reasoning: step.reasoning } : {},
-              ...last && detail.facts ? { turnFacts: detail.facts } : {}
+              ...last && detail.facts ? { turnFacts: detail.facts } : {},
+              ...last && detail.finishReason ? { finishReason: detail.finishReason } : {}
             });
             for (const result of persistToolResults(step.toolResults ?? [])) {
               this.sessions.appendMessage(sessionId, {
@@ -4020,7 +4024,7 @@ var init_session_factory = __esm({
             telemetry: this.opts.telemetry,
             workDir,
             projectContext,
-            maxTurns: role?.maxTurns ?? Math.max(4, Math.floor(config.maxTurns / 2)),
+            maxTurns: role?.maxTurns ?? config.maxTurns,
             contextLength: services.contextLength,
             artifactRetention: resolveArtifactRetention(config.artifacts),
             sandboxTerminal: config.sandbox?.terminal !== false,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@epoch-agent/runtime",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "private": false,
   "description": "epoch-agent 组装层：把 core / plugins / MCP 装配成可运行的 agent",
   "repository": {
@@ -22,14 +22,14 @@
     "dist"
   ],
   "dependencies": {
-    "@epoch-agent/core": "0.4.0",
-    "@epoch-agent/infra": "0.4.0",
-    "@epoch-agent/plugin-web": "^0.4.0",
-    "@epoch-agent/plugin-lsp": "0.4.0",
-    "@epoch-agent/plugin-mcp": "0.4.0",
-    "@epoch-agent/plugin-terminal": "^0.4.0",
-    "@epoch-agent/protocol": "0.4.0",
-    "@epoch-agent/plugin-file": "^0.4.0"
+    "@epoch-agent/core": "0.5.0",
+    "@epoch-agent/infra": "0.5.0",
+    "@epoch-agent/plugin-file": "^0.5.0",
+    "@epoch-agent/plugin-mcp": "0.5.0",
+    "@epoch-agent/plugin-terminal": "^0.5.0",
+    "@epoch-agent/protocol": "0.5.0",
+    "@epoch-agent/plugin-web": "^0.5.0",
+    "@epoch-agent/plugin-lsp": "0.5.0"
   },
   "devDependencies": {
     "@opentelemetry/api": "^1.9.0",