@epoch-agent/core 2.3.0 → 2.4.0

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { ToolProvider, EpochTool, EpochPlugin, ToolExposure, EpochSkill, HookType, EpochHook, PluginContext, QuestionRequest, QuestionAnswer, ComplianceCategory, ComplianceAction, ToolArtifactInput, ToolArtifact, TrustLevel, TrustManager as TrustManager$1, TokenUsage, EpochConfig, BudgetBreach, NoticeCode, ProviderType, EpochMessage, JsonSchema, ModelSelection, BackgroundTaskInfo, EpochToolCall, Telemetry, HookManager as HookManager$1, Lang, PermissionManager as PermissionManager$1, ApprovalRequest, ApprovalReply, AgentRoleScope, AgentRoleSource, EpochUserContent, EpochContentPart, AgentRole, PermissionLevel, PlanProposal, ScheduleRunnerSpec, ScheduleBackendKind, ScheduleTrigger, OperationType, ScheduleAllowlist, ScheduleDefinition, ScheduleRunStatus, ScheduleRun, SchedulePendingApproval, DiagnosticSink, CustomCommandDef, ModelRef, ExpandedCommand, CustomCommandSource, ContextBreakdown, WireMcpConnector, AgentEvent, SelectionContext, SetSelectionResult, ModelEntry, ReasoningState, ReasoningChoice, PermissionRuleLists, MoneyDigits, CurrencyDisplay, KeybindingTable, Diagnostic, KeybindingReport, FileOmitReason, SessionOmitReason, EpochToolResult, EpochTurnFacts, LocalizedDetail, ApprovalScope, RuleValue, Operation, ApprovalOutcome, PermissionDecision, ScheduleDraft, ScheduleWideningKind, WireAgentEvent, WireAgentEnvelope, HookEvent, LogFn, HookRegistration, HookHandler, HookContext, VerifyResult, EpochFilePart, EpochSessionPart, MentionSet, EpochImagePart, TrustExecGrant, DecidedTrustLevel, TrustScope, TrustGrant, TrustRecord } from '@epoch-agent/protocol';
+import { ToolProvider, EpochTool, EpochPlugin, ToolExposure, EpochSkill, HookType, EpochHook, PluginContext, QuestionRequest, QuestionAnswer, ComplianceCategory, ComplianceAction, ToolArtifactInput, ToolArtifact, TrustLevel, TrustManager as TrustManager$1, TokenUsage, EpochConfig, BudgetBreach, NoticeCode, ProviderType, EpochMessage, JsonSchema, ModelSelection, BackgroundTaskInfo, EpochToolCall, Telemetry, HookManager as HookManager$1, Lang, PermissionManager as PermissionManager$1, ApprovalRequest, ApprovalReply, AgentRoleScope, AgentRoleSource, EpochUserContent, EpochContentPart, AgentRole, PermissionLevel, PlanProposal, ScheduleRunnerSpec, ScheduleBackendKind, ScheduleTrigger, OperationType, ScheduleAllowlist, ScheduleDefinition, ScheduleRunStatus, ScheduleRun, SchedulePendingApproval, DiagnosticSink, CustomCommandDef, ModelRef, ExpandedCommand, CustomCommandSource, ContextBreakdown, WireMcpConnector, AgentEvent, SelectionContext, SetSelectionResult, ModelEntry, ReasoningState, ReasoningChoice, PermissionRuleLists, MoneyDigits, CurrencyDisplay, KeybindingTable, Diagnostic, KeybindingReport, FileOmitReason, SessionOmitReason, EpochToolResult, EpochUserCommand, EpochTurnFacts, LocalizedDetail, ApprovalScope, RuleValue, Operation, ApprovalOutcome, PermissionDecision, ScheduleDraft, ScheduleWideningKind, WireAgentEvent, WireAgentEnvelope, HookEvent, LogFn, HookRegistration, HookHandler, HookContext, VerifyResult, EpochFilePart, EpochSessionPart, MentionSet, EpochImagePart, TrustExecGrant, DecidedTrustLevel, TrustScope, TrustGrant, TrustRecord } from '@epoch-agent/protocol';
 export { API_KEY_ENV_VARS, AgentEvent, AgentEventOf, AgentEventType, ApprovalAnswer, ApprovalOutcome, ApprovalReply, ApprovalRequest, ApprovalScope, BudgetBreach, COMPLIANCE_ACTIONS, COMPLIANCE_CATEGORIES, ComplianceAction, ComplianceCategory, DecidedTrustLevel, EpochConfig, EpochHook, EpochPlugin, EpochSkill, EpochTool, FinishReason, HookContext, HookEvent, HookHandler, HookRegistration, HookType, HookManager as IHookManager, PermissionManager as IPermissionManager, TrustManager as ITrustManager, JsonSchema, MAX_ATTACH_BYTES, MAX_ATTACH_FILES, MAX_ATTACH_TOTAL_BYTES, MAX_SESSION_ATTACH_BYTES, MAX_SESSION_REFS, OPERATION_TYPES, Operation, OperationType, PERMISSION_LEVELS, PLAN_OUTCOMES, PROVIDER_INFOS, PROVIDER_TYPES, PermissionDecision, PermissionLevel, PlanApprovalOutcome, PlanProposal, PluginContext, ProviderInfo, ProviderType, TokenUsage, ToolContext, ToolDefinition, ToolExposure, ToolResult, TrustExecGrant, TrustGrant, TrustLevel, TrustRecord, TrustScope, TrustTier, VerifyResult, apiKeyEnvVar, extractAllMentions, extractMentions, extractSessionMentions, getProviderInfo, isOperationType, isPermissionLevel, isPlanOutcome, isProviderType, normalizeApproval } from '@epoch-agent/protocol';
 import { IsolationBackend, SqliteDatabase, ParseIssue, ShellFlavor } from '@epoch-agent/infra';
 export { BubblewrapOptions, DangerMatch, IS_WINDOWS, IsolationBackend, IsolationOptions, LogLevel, SeatbeltOptions, WINDOWS_HIDE_FLAGS, buildBwrapArgs, buildProfile, checkDangerousCommand, checkObfuscation, createLogger, detectBackend, getDefaultShell, getPythonCommand, isInWorkspace, isReadOnlyCommand, isolate, maskApiKey, probeBubblewrap, probeSeatbelt, complianceDir as resolveComplianceDir, policiesDir as resolvePoliciesDir, setLogLevel } from '@epoch-agent/infra';
@@ -13016,7 +13016,7 @@ declare class ModelFailureTracker {
  *
  * - `design/web-ui/README.md`「8.2 决定 8」那条 ⚠️ 划掉重写，稿子
  *   `index.html` 那枚「估算」徽标上面那段注释同改（它是同一句话的第二处）。
- * - `.agents/plans/README.md`「42 划出来的底座缺口」里那一条划掉。
+ * - `.epoch/plans/README.md`「42 划出来的底座缺口」里那一条划掉。
  *
  * ⚠️ **「要拿掉徽标得先换真 tokenizer」按交代的一个字没动** —— 它是
  * **必要条件**，而充分条件（同一份稿子 `thread.css` 里 `.est` 那条：
@@ -15563,6 +15563,16 @@ interface Message {
     toolResults?: EpochToolResult[];
     /** 多模态部件的落盘形态（图片是路径引用，不是 base64） */
     parts?: PersistedPart[];
+    /**
+     * 这一条是**按哪条自定义斜杠命令**发出来的（会话库 v15，2026-10-21）。
+     *
+     * 只长在 user 行上，而且和 `content` **互不替代**：`content` 是展开之后的正文
+     * （模型看到的那份），这一格是「这行字是怎么来的」。界面上按它画成
+     * 一行 `/命令名 参数`，不再把那一大段正文冒充成用户说的话。
+     *
+     * 缺席 = 普通消息，或者这条是 v15 之前的库写的（那时候就是没有这个信息）。
+     */
+    command?: EpochUserCommand;
     /**
      * 一轮跑完那笔账（`turn_facts` 列，v6）。
      *
@@ -15646,6 +15656,13 @@ interface AppendMessageInput {
     toolResults?: EpochToolResult[];
     /** 已经落过盘的部件。别把带 base64 的 `EpochContentPart` 直接传进来 */
     parts?: PersistedPart[];
+    /**
+     * 这条用户消息是按哪条命令发出来的（2026-10-21）。**只该传给 user 行**。
+     *
+     * 它跟 `content` 一起落盘、一起回放，但两者读者不同：`content` 喂模型，
+     * 这一格喂界面。判据全文在 `EpochUserCommand` 上。
+     */
+    command?: EpochUserCommand;
     /** 一轮的账。**只该传给这一轮最后一条 assistant 行**，见 {@link Message.turnFacts} */
     turnFacts?: EpochTurnFacts;
     toolName?: string;

package/dist/index.js

@@ -6083,6 +6083,7 @@ var CommandFrontmatterSchema = z.object({
 });
 var FRONTMATTER_KEYS3 = Object.keys(CommandFrontmatterSchema.shape);
 var MAX_POSITIONAL = 9;
+var ARG_PREVIEW_MAX = 120;
 var UTILITY_KEYWORD = "utility";
 function loadCommands(files, source, prefix) {
   const commands = [];
@@ -6188,6 +6189,14 @@ function expandCommand(def, args, opts = {}) {
       })
     );
   }
+  if (trimmed !== "" && used.size === 0 && !def.prompt.includes("$ARGUMENTS")) {
+    warnings.push(
+      t("custom_command.unused_args", {
+        name: def.name,
+        args: trimmed.length > ARG_PREVIEW_MAX ? `${trimmed.slice(0, ARG_PREVIEW_MAX)}\u2026` : trimmed
+      })
+    );
+  }
   const model = resolveCommandModel(def, opts, warnings);
   return {
     prompt: out,
@@ -17735,6 +17744,28 @@ function parseTurnFacts(json) {
 function encodeTurnFacts(facts) {
   return facts ? JSON.stringify(facts) : null;
 }
+function parseUserCommand(json) {
+  if (typeof json !== "string" || json.length === 0) return void 0;
+  let raw;
+  try {
+    raw = JSON.parse(json);
+  } catch {
+    return void 0;
+  }
+  if (!isRecord4(raw)) return void 0;
+  const name = str3(raw["name"]);
+  if (!name) return void 0;
+  const displayName = str3(raw["displayName"]);
+  const args = str3(raw["args"]);
+  return {
+    name,
+    ...displayName ? { displayName } : {},
+    ...args ? { args } : {}
+  };
+}
+function encodeUserCommand(command) {
+  return command ? JSON.stringify(command) : null;
+}
 // src/session/db.ts
 var NS3 = "session";
 var log2 = createLogger("session-db");
@@ -18030,7 +18061,7 @@ var FTS_EXTERNAL_SCHEMA = `
 var FTS_EXTERNAL_MIGRATIONS = [
   {
     id: "fts-external-content",
-    version: 14,
+    version: 16,
     description: "\u4E24\u5F20 FTS \u8868\u6539\u6210\u5916\u90E8\u5185\u5BB9\u8868\uFF08\u6B63\u6587\u4E0D\u518D\u5B58\u4E09\u4EFD\uFF0C2026-08-21\uFF09",
     up: (db) => {
       db.exec(FTS_EXTERNAL_SCHEMA);
@@ -18042,6 +18073,14 @@ var FTS_EXTERNAL_MIGRATIONS = [
         db.prepare(`INSERT INTO ${table}(${table}, rank) VALUES('integrity-check', 1)`).run();
       }
     }
+  },
+  {
+    id: "messages-command",
+    version: 15,
+    description: "\u6D88\u606F\u8868\u52A0 command \u4E00\u5217\uFF08\u8FD9\u6761\u7528\u6237\u6D88\u606F\u662F\u6309\u54EA\u6761\u659C\u6760\u547D\u4EE4\u53D1\u7684\uFF0C2026-10-21\uFF09",
+    up: (db) => {
+      db.exec(`ALTER TABLE messages ADD COLUMN command TEXT`);
+    }
   }
 ];
 var SessionDB = class {
@@ -18235,8 +18274,8 @@ var SessionDB = class {
   insertMessage(msg) {
     const info = this.db.prepare(
       `
-      INSERT INTO messages (session_id, role, content, tool_call_id, tool_calls, tool_results, parts, tool_name, timestamp, token_count, finish_reason, reasoning, turn_facts, active, compacted, observed)
-      VALUES (@sessionId, @role, @content, @toolCallId, @toolCalls, @toolResults, @parts, @toolName, @timestamp, @tokenCount, @finishReason, @reasoning, @turnFacts, 1, 0, 0)
+      INSERT INTO messages (session_id, role, content, tool_call_id, tool_calls, tool_results, parts, command, tool_name, timestamp, token_count, finish_reason, reasoning, turn_facts, active, compacted, observed)
+      VALUES (@sessionId, @role, @content, @toolCallId, @toolCalls, @toolResults, @parts, @command, @toolName, @timestamp, @tokenCount, @finishReason, @reasoning, @turnFacts, 1, 0, 0)
     `
     ).run({
       ...msg,
@@ -18244,6 +18283,7 @@ var SessionDB = class {
       toolCalls: encodeColumn(msg.toolCalls),
       toolResults: encodeColumn(msg.toolResults),
       parts: encodeColumn(msg.parts),
+      command: encodeUserCommand(msg.command),
       toolName: msg.toolName ?? null,
       tokenCount: msg.tokenCount ?? null,
       finishReason: msg.finishReason ?? null,
@@ -18509,8 +18549,8 @@ var SessionDB = class {
   forkMessages(fromSessionId, toSessionId, upToIndex) {
     const messages = this.db.prepare("SELECT * FROM messages WHERE session_id = ? AND id <= ? ORDER BY timestamp ASC").all(fromSessionId, upToIndex);
     const stmt = this.db.prepare(`
-      INSERT INTO messages (session_id, role, content, tool_call_id, tool_calls, tool_results, parts, tool_name, timestamp, token_count, finish_reason, reasoning, turn_facts, active, compacted, observed)
-      VALUES (@sessionId, @role, @content, @toolCallId, @toolCalls, @toolResults, @parts, @toolName, @timestamp, @tokenCount, @finishReason, @reasoning, @turnFacts, @active, @compacted, @observed)
+      INSERT INTO messages (session_id, role, content, tool_call_id, tool_calls, tool_results, parts, command, tool_name, timestamp, token_count, finish_reason, reasoning, turn_facts, active, compacted, observed)
+      VALUES (@sessionId, @role, @content, @toolCallId, @toolCalls, @toolResults, @parts, @command, @toolName, @timestamp, @tokenCount, @finishReason, @reasoning, @turnFacts, @active, @compacted, @observed)
     `);
     for (const m of messages) {
       const { id: _id, ...rest } = m;
@@ -18522,6 +18562,7 @@ var SessionDB = class {
         toolCalls: rest["tool_calls"] ?? null,
         toolResults: rest["tool_results"] ?? null,
         parts: rest["parts"] ?? null,
+        command: rest["command"] ?? null,
         toolName: rest["tool_name"] ?? null,
         timestamp: rest["timestamp"] ?? Date.now(),
         tokenCount: rest["token_count"] ?? null,
@@ -18603,6 +18644,7 @@ var SessionDB = class {
       toolCalls: parseToolCalls(row["tool_calls"]),
       toolResults: parseToolResults(row["tool_results"]),
       parts: parseParts(row["parts"]),
+      command: parseUserCommand(row["command"]),
       turnFacts: parseTurnFacts(row["turn_facts"]),
       toolName: row["tool_name"],
       timestamp: row["timestamp"],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@epoch-agent/core",
-  "version": "2.3.0",
+  "version": "2.4.0",
   "private": false,
   "description": "epoch-agent 核心引擎：ReAct 循环、Provider 路由、工具调度、记忆管理",
   "repository": {
@@ -27,8 +27,8 @@
     "gpt-tokenizer": "^3.4.0",
     "js-yaml": "^5.2.3",
     "zod": "^4.4.3",
-    "@epoch-agent/infra": "2.3.0",
-    "@epoch-agent/protocol": "2.3.0"
+    "@epoch-agent/infra": "2.4.0",
+    "@epoch-agent/protocol": "2.4.0"
   },
   "devDependencies": {
     "@ai-sdk/alibaba": "^2.0.69",