helloagents 3.0.38 → 3.0.39

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "helloagents",
-  "version": "3.0.38",
+  "version": "3.0.39",
   "description": "HelloAGENTS — The orchestration kernel that makes any AI CLI smarter. Adds intelligent routing, unified QA gates, safety guards, and notifications.",
   "author": {
     "name": "HelloWind",

package/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "helloagents",
-  "version": "3.0.38",
+  "version": "3.0.39",
   "description": "HelloAGENTS — Quality-driven orchestration kernel for AI CLIs with intelligent routing, unified QA gates, safety guards, and notifications.",
   "author": {
     "name": "HelloWind",

package/README.md

@@ -8,7 +8,7 @@
 
 **A workflow layer for AI coding CLIs: skills, project knowledge, delivery checks, safer config writes, and resumable execution.**
 
-[![Version](https://img.shields.io/badge/version-3.0.38-orange.svg)](./package.json)
+[![Version](https://img.shields.io/badge/version-3.0.39-orange.svg)](./package.json)
 [![npm](https://img.shields.io/npm/v/helloagents.svg)](https://www.npmjs.com/package/helloagents)
 [![Node](https://img.shields.io/badge/node-%3E%3D18-339933.svg)](./package.json)
 [![Skills](https://img.shields.io/badge/skills-14-6366f1.svg)](./skills)
@@ -189,7 +189,7 @@ HelloAGENTS now resolves the current state file from `state_path`:
 
 `<workspace>` is the current Git branch, `detached-<sha>` for a detached HEAD, or `workspace` for non-Git projects. `<session>` is the current project-local session token. `.helloagents/sessions/active.json` only keeps the latest active workspace/session mapping plus alias bridges, so the same CLI session stays in one directory and `/resume` can reuse it.
 
-For project-local sessions, HelloAGENTS first uses stable host identifiers such as `sessionId`, `conversationId`, `threadId`, or `HELLOAGENTS_NOTIFY_SESSION_ID`. If the host only exposes a window or terminal id such as `WT_SESSION`, `TERM_SESSION_ID`, or `WINDOWID`, HelloAGENTS uses it only as a lightweight alias bridge and reuses the mapped session first instead of fanning out duplicate directories.
+For project-local sessions, HelloAGENTS first uses stable host identifiers such as `sessionId`, `conversationId`, `threadId`, or `HELLOAGENTS_NOTIFY_SESSION_ID`. If the host only exposes a window or terminal id such as `WT_SESSION`, `TERM_SESSION_ID`, or `WINDOWID`, HelloAGENTS uses it only as a lightweight alias bridge and reuses the mapped session first instead of fanning out duplicate directories. If a session starts before a stable host identifier is available, HelloAGENTS can begin in `default` and keep reusing that same active directory after the same CLI session later exposes a stable identifier, instead of splitting into a second session directory.
 
 `STATE.md` records where the current workflow stopped. It is not a universal memory file for every conversation. Codex `/goal` does not replace `state_path`, `turn-state`, or local evidence files; it only handles long-running continuation on the Codex side.
 
@@ -210,7 +210,7 @@ Runtime state now stays intentionally small:
 - `~/.codex/.helloagents/notify-state.json` for Codex-native closeout de-duplication only
 
 `STATE.md` only keeps the human-readable recovery snapshot. `runtime.json` is machine-only and keeps the minimal runtime state. `artifacts/*.json` stays limited to structured receipts. `events.jsonl` remains opt-in trace output and stays off by default.
-Project-local `STATE.md` is now materialized more lazily, and legacy root-level `.helloagents/artifacts/*.log` files are cleaned up automatically instead of growing as a second history system.
+Project-local `STATE.md` is now materialized more lazily.
 
 Standard runtime evidence and transient runtime state now expire after 72 hours. Long-running Codex goal flows still keep their 720-hour upper bound where the workflow explicitly needs it.
 
@@ -660,7 +660,7 @@ Codex is rules-file driven by default.
 - standby creates `~/.codex/helloagents -> ~/.helloagents/helloagents`
 - global mode installs the native local-plugin chain, but keeps `~/.helloagents/helloagents` as the single managed runtime source by linking plugin roots, plugin cache, and `~/.codex/helloagents` back to it
 - for Codex app/plugin discovery, `global` is the native path; `standby` remains the lighter default for explicit project work
-- cleanup removes only the HelloAGENTS-managed hook trust entries and legacy managed notify residues, while keeping user-owned hook state untouched
+- cleanup removes only the HelloAGENTS-managed hook trust entries, while keeping user-owned hook state untouched
 - Codex hooks only synchronize runtime state and enforce Stop gates; they do not inject HelloAGENTS rules or route text through hook output
 - Codex closeout de-duplicates Stop hooks and native `codex-notify`, so one turn does not notify twice, and clientless delegated child-completion events stay silent when the managed Stop hook is active
 - `/goal` remains Codex-native. Enable it explicitly with `helloagents codex goals enable` when long-running plan execution is needed
@@ -681,7 +681,7 @@ The current suite covers:
 - one-shot shell and PowerShell lifecycle dispatch, plus wrapper env cleanup and mode-routing rules for install, update, cleanup, uninstall, and branch switching
 - Claude, Gemini, and Codex host integration behavior, including global-to-standby cleanup and failed native cleanup tracking
 - Codex managed `model_instructions_file`, `notify`, `hooks.json`, hook trust state, local plugin, marketplace, and cache behavior
-- Codex cleanup of legacy managed notify variants on Windows and canonical managed notify restoration rules
+- Codex cleanup and canonical managed notify restoration rules
 - Codex `/goal` feature toggles, long-running route context, and goal-aware command contracts
 - `helloagents doctor`
 - project storage and `repo-shared` behavior

package/README_CN.md

@@ -8,7 +8,7 @@
 
 **面向 AI 编码 CLI 的工作流层：技能、知识库、交付检查、更安全的配置写入，以及可恢复的执行流程。**
 
-[![Version](https://img.shields.io/badge/version-3.0.38-orange.svg)](./package.json)
+[![Version](https://img.shields.io/badge/version-3.0.39-orange.svg)](./package.json)
 [![npm](https://img.shields.io/npm/v/helloagents.svg)](https://www.npmjs.com/package/helloagents)
 [![Node](https://img.shields.io/badge/node-%3E%3D18-339933.svg)](./package.json)
 [![Skills](https://img.shields.io/badge/skills-14-6366f1.svg)](./skills)
@@ -189,7 +189,7 @@ HelloAGENTS 现在只从 `state_path` 解析当前状态文件：
 
 `<workspace>` 是当前 Git 分支、detached HEAD 的 `detached-<sha>`，或非 Git 项目的 `workspace`。`<session>` 是当前项目本地会话标识。`.helloagents/sessions/active.json` 只保留最近一次活跃的工作区/会话映射和 alias 桥接，这样同一个 CLI 会话会稳定落在同一个目录里，`/resume` 也能复用它。
 
-对于项目本地会话目录，HelloAGENTS 会优先使用稳定宿主标识，如 `sessionId`、`conversationId`、`threadId` 或 `HELLOAGENTS_NOTIFY_SESSION_ID`。如果宿主只能提供 `WT_SESSION`、`TERM_SESSION_ID`、`WINDOWID` 这类窗口或终端标识，HelloAGENTS 只把它们当作轻量 alias 桥接，并优先复用已映射的会话目录，而不是继续分裂出重复目录。
+对于项目本地会话目录，HelloAGENTS 会优先使用稳定宿主标识，如 `sessionId`、`conversationId`、`threadId` 或 `HELLOAGENTS_NOTIFY_SESSION_ID`。如果宿主只能提供 `WT_SESSION`、`TERM_SESSION_ID`、`WINDOWID` 这类窗口或终端标识，HelloAGENTS 只把它们当作轻量 alias 桥接，并优先复用已映射的会话目录，而不是继续分裂出重复目录。如果一个会话启动时还拿不到稳定宿主标识，HelloAGENTS 可以先落到 `default`，等同一个 CLI 会话后续拿到稳定标识时，仍继续复用这个活动目录，而不是再拆出第二个会话目录。
 
 `STATE.md` 只记录当前工作流做到哪里，不承担所有对话的统一记忆。Codex `/goal` 也不替代 `state_path`、`turn-state` 或本地证据文件；它只负责 Codex 侧的长程续跑。
 
@@ -210,7 +210,7 @@ HelloAGENTS 不把“命令通过”和“任务完成”简单画等号。交
 - 仅用于 Codex 原生收尾去重的 `~/.codex/.helloagents/notify-state.json`
 
 `STATE.md` 只保留给人看的恢复快照。`runtime.json` 只给机器用，只保存极少量运行态。`artifacts/*.json` 只保留结构化收据。`events.jsonl` 仍是可选 trace 输出，默认不写。
-项目本地 `STATE.md` 现在会更晚创建；旧版残留的项目根 `.helloagents/artifacts/*.log` 也会自动清理，不再继续充当第二套历史系统。
+项目本地 `STATE.md` 现在会更晚创建。
 
 标准运行态证据和临时运行态现在默认 72 小时过期。只有工作流明确需要的长程 Codex goal 链路，才继续保留 720 小时上限。
 
@@ -664,7 +664,7 @@ Codex 默认走规则文件驱动。
 - 标准模式创建 `~/.codex/helloagents -> ~/.helloagents/helloagents`
 - 全局模式安装原生本地插件流程，但仍把 `~/.helloagents/helloagents` 作为唯一受管运行时源；插件根目录、插件缓存和 `~/.codex/helloagents` 都会回链到它
 - 如果你主要看重 Codex app / 插件发现链路，优先使用 `global`；如果你主要看重更轻量、更显式的项目工作流，保留 `standby`
-- 清理时只删除 HelloAGENTS 自己写入的 hook trust 条目和旧式受管 notify 残留，不影响用户已有的 hook 状态
+- 清理时只删除 HelloAGENTS 自己写入的 hook trust 条目，不影响用户已有的 hook 状态
 - Codex hooks 只做静默运行态同步和 Stop 门禁，不通过 hook 注入 HelloAGENTS 规则或路由说明
 - Codex 收尾会对 Stop hook 和原生 `codex-notify` 去重，避免同一轮重复通知；受管 Stop hook 生效时，client 为空的委派子任务完成事件也会保持静默
 - `/goal` 保持 Codex 原生能力；需要长程执行时，用 `helloagents codex goals enable` 显式启用
@@ -685,7 +685,7 @@ npm test
 - shell 与 PowerShell 一键脚本分发链路，以及包装脚本在安装、更新、清理、卸载和分支切换中的环境清理与模式传递规则
 - Claude、Gemini、Codex 的宿主集成行为，包括全局切回标准模式的清理和原生清理失败时的模式保留
 - Codex 受管 `model_instructions_file`、`notify`、`hooks.json`、hook trust 状态、本地插件、marketplace 和缓存行为
-- Windows 下 Codex 旧式受管 notify 变体的清理，以及受管 notify 恢复规则
+- Codex 清理链路，以及受管 notify 恢复规则
 - Codex `/goal` 功能开关、长程路由上下文和 goal 感知命令契约
 - `helloagents doctor`
 - 项目存储和 `repo-shared`

package/gemini-extension.json

@@ -1,6 +1,6 @@
 {
   "name": "helloagents",
-  "version": "3.0.38",
+  "version": "3.0.39",
   "description": "Quality-driven orchestration kernel for AI CLIs",
   "contextFileName": "bootstrap.md",
   "author": "HelloWind",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "helloagents",
-  "version": "3.0.38",
+  "version": "3.0.39",
   "type": "module",
   "description": "HelloAGENTS — The orchestration kernel that makes any AI CLI smarter. Adds intelligent routing, unified QA gates, safety guards, and notifications.",
   "author": "HelloWind",

package/scripts/cli-codex-config.mjs

@@ -13,13 +13,8 @@ export const CODEX_MANAGED_TOML_COMMENT = '# helloagents-managed'
 export const CODEX_MANAGED_MODEL_INSTRUCTIONS_PATH = '~/.codex/AGENTS.md'
 export const CODEX_MANAGED_NOTIFY_COMMAND = 'helloagents-js'
 export const CODEX_MANAGED_NOTIFY_VALUE = `["${CODEX_MANAGED_NOTIFY_COMMAND}", "codex-notify"]`
-const CODEX_MANAGED_NOTIFY_LEGACY_VALUES = [
-  `["${CODEX_MANAGED_NOTIFY_COMMAND}.cmd", "codex-notify"]`,
-  `["${CODEX_MANAGED_NOTIFY_COMMAND}.exe", "codex-notify"]`,
-]
 export const CODEX_MANAGED_TUI_NOTIFICATIONS_VALUE = '["plan-mode-prompt"]'
 export const CODEX_HOOKS_FEATURE_KEY = 'hooks'
-export const CODEX_LEGACY_HOOKS_FEATURE_KEY = 'codex_hooks'
 export const CODEX_GOALS_FEATURE_KEY = 'goals'
 export const CODEX_MANAGED_GOALS_FEATURE_LINE = `${CODEX_GOALS_FEATURE_KEY} = true ${CODEX_MANAGED_TOML_COMMENT}`
 export const CODEX_MANAGED_GOALS_DISABLED_LINE = `${CODEX_GOALS_FEATURE_KEY} = false ${CODEX_MANAGED_TOML_COMMENT}`
@@ -105,10 +100,6 @@ export function readCodexHooksFeatureLine(text) {
   return readCodexFeatureLine(text, CODEX_HOOKS_FEATURE_KEY)
 }
 
-export function readLegacyCodexHooksFeatureLine(text) {
-  return readCodexFeatureLine(text, CODEX_LEGACY_HOOKS_FEATURE_KEY)
-}
-
 export function readCodexGoalsFeatureLine(text) {
   return readCodexFeatureLine(text, CODEX_GOALS_FEATURE_KEY)
 }
@@ -146,15 +137,6 @@ export function removeCodexGoalsFeatureConfig(text) {
   )
 }
 
-export function removeLegacyManagedCodexHooksFeatureConfig(text) {
-  return removeTomlSectionLine(
-    text,
-    CODEX_FEATURES_HEADER,
-    CODEX_LEGACY_HOOKS_FEATURE_KEY,
-    isManagedLegacyCodexHooksFeature,
-  )
-}
-
 export function restoreCodexGoalsFeatureConfig(text, { codexGoalsLine = '' } = {}) {
   if (!codexGoalsLine) return normalizeToml(text)
   return upsertTomlSectionLine(
@@ -173,10 +155,7 @@ export function isManagedCodexModelInstruction(line = '') {
 export function isManagedCodexNotify(line = '') {
   const value = String(line || '').replace(/\\/g, '/')
   return value.includes(CODEX_MANAGED_TOML_COMMENT)
-    && (
-      value.includes(CODEX_MANAGED_NOTIFY_VALUE)
-      || CODEX_MANAGED_NOTIFY_LEGACY_VALUES.some((entry) => value.includes(entry))
-    )
+    && value.includes(CODEX_MANAGED_NOTIFY_VALUE)
 }
 
 export function isManagedCodexTuiNotifications(line = '') {
@@ -193,10 +172,6 @@ export function isManagedCodexHooksFeature(line = '') {
   return isManagedFeatureLine(line, CODEX_HOOKS_FEATURE_KEY)
 }
 
-export function isManagedLegacyCodexHooksFeature(line = '') {
-  return isManagedFeatureLine(line, CODEX_LEGACY_HOOKS_FEATURE_KEY)
-}
-
 export function isManagedCodexGoalsFeature(line = '') {
   return isManagedFeatureLine(line, CODEX_GOALS_FEATURE_KEY)
 }

package/scripts/cli-codex.mjs

@@ -17,12 +17,9 @@ import {
   isManagedCodexGoalsFeature,
   isManagedCodexModelInstruction,
   isManagedCodexNotify,
-  isManagedLegacyCodexHooksFeature,
   readCodexGoalsFeatureLine,
-  readLegacyCodexHooksFeatureLine,
   removeCodexGoalsFeatureConfig,
   removeCodexManagedTuiConfig,
-  removeLegacyManagedCodexHooksFeatureConfig,
   removeCodexPluginConfig,
   restoreCodexGoalsFeatureConfig,
   restoreCodexTopLevelConfig,
@@ -156,12 +153,10 @@ function cleanupCodexManagedConfig(configPath, { removePluginConfig = false } =
   const currentModelInstructions = readTopLevelTomlLine(toml, 'model_instructions_file');
   const currentNotify = readTopLevelTomlBlock(toml, 'notify');
   const currentCodexGoalsFeature = readCodexGoalsFeatureLine(toml);
-  const currentLegacyCodexHooksFeature = readLegacyCodexHooksFeatureLine(toml);
 
   const shouldRestoreModelInstructions = isManagedCodexModelInstruction(currentModelInstructions);
   const shouldRestoreNotify = isManagedCodexNotify(currentNotify);
   const shouldRestoreCodexGoalsFeature = isManagedCodexGoalsFeature(currentCodexGoalsFeature);
-  const shouldRemoveLegacyCodexHooksFeature = isManagedLegacyCodexHooksFeature(currentLegacyCodexHooksFeature);
 
   if (removePluginConfig) {
     toml = removeCodexPluginConfig(toml);
@@ -170,9 +165,6 @@ function cleanupCodexManagedConfig(configPath, { removePluginConfig = false } =
     toml = removeCodexGoalsFeatureConfig(toml);
   }
   toml = removeCodexManagedTuiConfig(toml);
-  if (shouldRemoveLegacyCodexHooksFeature) {
-    toml = removeLegacyManagedCodexHooksFeatureConfig(toml);
-  }
   if (shouldRestoreModelInstructions) {
     toml = removeTopLevelTomlLines(toml, (line) =>
       line.startsWith('model_instructions_file =') && isManagedCodexModelInstruction(line)).text;
@@ -220,7 +212,6 @@ export function installCodexStandby(home, pkgRoot) {
     modelInstructionsPath: CODEX_MANAGED_MODEL_INSTRUCTIONS_PATH,
   });
   toml = installCodexManagedTuiConfig(toml);
-  toml = removeLegacyManagedCodexHooksFeatureConfig(toml);
   safeWrite(configPath, toml);
   installCodexStandaloneHooks(home, pkgRoot);
 
@@ -312,7 +303,6 @@ export function installCodexGlobal(home, pkgRoot) {
     modelInstructionsPath: CODEX_MANAGED_MODEL_INSTRUCTIONS_PATH,
   });
   toml = installCodexManagedTuiConfig(toml);
-  toml = removeLegacyManagedCodexHooksFeatureConfig(toml);
   toml = upsertCodexPluginConfig(toml);
   safeWrite(configPath, toml);
   installCodexStandaloneHooks(home, pkgRoot);

package/scripts/cli-doctor-codex.mjs

@@ -9,7 +9,6 @@ import {
   CODEX_MANAGED_NOTIFY_VALUE,
   readCodexGoalsFeatureLine,
   readCodexHooksFeatureLine,
-  readLegacyCodexHooksFeatureLine,
 } from './cli-codex-config.mjs'
 import {
   buildManagedCodexHookTrustEntries,
@@ -301,8 +300,6 @@ function buildCodexChecks(runtime, settings, trackedMode, detectedMode) {
   )
   const hooksFeatureLine = readCodexHooksFeatureLine(codexConfig)
   const goalsFeatureLine = readCodexGoalsFeatureLine(codexConfig)
-  const legacyHooksFeatureLine = readLegacyCodexHooksFeatureLine(codexConfig)
-
   return {
     checks: {
       carrierMarker: (safeRead(join(codexDir, 'AGENTS.md')) || '').includes('HELLOAGENTS_START'),
@@ -319,10 +316,8 @@ function buildCodexChecks(runtime, settings, trackedMode, detectedMode) {
       modelInstructionsPathMatch: !!modelInstructionsLine && normalizePath(modelInstructionsLine).includes(`"${CODEX_MANAGED_MODEL_INSTRUCTIONS_PATH}"`),
       codexNotify: codexConfig.includes('codex-notify'),
       notifyPathMatch: codexConfig.includes(CODEX_MANAGED_NOTIFY_VALUE),
-      codexHooksFeature: !/^\s*hooks\s*=\s*false\b/.test(hooksFeatureLine)
-        && !/^\s*codex_hooks\s*=\s*false\b/.test(legacyHooksFeatureLine),
+      codexHooksFeature: !/^\s*hooks\s*=\s*false\b/.test(hooksFeatureLine),
       codexGoalsFeature: /^\s*goals\s*=\s*true\b/.test(goalsFeatureLine),
-      legacyCodexHooksFeature: Boolean(legacyHooksFeatureLine),
       standaloneHooks: JSON.stringify(codexHooks.hooks || {}).includes('helloagents'),
       standaloneHooksMatch: managedHooksMatch(codexHooks.hooks || {}, expectedHooks),
       managedHookTrust: expectedHookTrust.every((entry) => managedHookTrust.has(entry.key)),
@@ -369,7 +364,6 @@ export function inspectCodexDoctor(runtime, settings) {
   if (!checks.pluginVersionMatch && !pluginVersion && detectedMode === 'global') notes.push(runtime.msg('未读到 global 插件根目录版本信息', 'Global plugin root version was not readable'))
   if (!checks.pluginCacheVersionMatch && !cacheVersion && detectedMode === 'global') notes.push(runtime.msg('未读到 global 插件缓存版本信息', 'Global plugin cache version was not readable'))
   if (detectedMode !== 'none' && !checks.codexGoalsFeature) notes.push(runtime.msg('Codex /goal 未启用；如需长程执行，可运行 `helloagents codex goals enable`。', 'Codex /goal is not enabled; run `helloagents codex goals enable` if you need long-running goals.'))
-  if (detectedMode !== 'none' && checks.legacyCodexHooksFeature) notes.push(runtime.msg('检测到旧版 `codex_hooks`；HelloAGENTS 只兼容 Codex 最新版，请移除旧 key。', 'Legacy `codex_hooks` was detected; HelloAGENTS targets latest Codex only, so remove the old key.'))
   if (!nativeDoctor.available) notes.push(runtime.msg('未检测到原生 `codex doctor`；当前仅检查 HelloAGENTS 受管覆盖层。', 'Native `codex doctor` was not available; only the HelloAGENTS managed overlay was checked.'))
 
   const status = summarizeDoctorStatus(issues, { trackedMode, detectedMode })

package/scripts/project-session-cleanup.mjs

@@ -23,10 +23,6 @@ function removePath(filePath, result, bucket) {
   }
 }
 
-function isDebugLog(entryName = '') {
-  return /\.log$/i.test(entryName)
-}
-
 function isDirectoryEmptyRecursive(dirPath) {
   const entries = readdirSync(dirPath, { withFileTypes: true })
   if (entries.length === 0) return true
@@ -92,32 +88,6 @@ function cleanupTransientSessionTemps(sessionsDir, result) {
   }
 }
 
-function cleanupLegacyProjectArtifacts(activationDir, result) {
-  const artifactsDir = join(activationDir, 'artifacts')
-  if (!existsSync(artifactsDir)) return
-
-  let removableEntries = []
-  try {
-    removableEntries = readdirSync(artifactsDir, { withFileTypes: true })
-  } catch (error) {
-    result.errors.push(`${artifactsDir}: ${error.message}`)
-    return
-  }
-
-  for (const entry of removableEntries) {
-    if (!entry.isFile() || !isDebugLog(entry.name)) continue
-    removePath(join(artifactsDir, entry.name), result, 'removedLegacyArtifacts')
-  }
-
-  try {
-    if (isDirectoryEmptyRecursive(artifactsDir)) {
-      removePath(artifactsDir, result, 'removedLegacyArtifacts')
-    }
-  } catch (error) {
-    result.errors.push(`${artifactsDir}: ${error.message}`)
-  }
-}
-
 export function cleanupProjectSessions(cwd, { now = Date.now(), minIntervalMs = 0, maxAgeMs = PROJECT_SESSION_MAX_AGE_MS } = {}) {
   const projectRoot = getProjectRoot(cwd)
   const activationDir = getProjectActivationDir(projectRoot)
@@ -131,7 +101,6 @@ export function cleanupProjectSessions(cwd, { now = Date.now(), minIntervalMs =
     removedNoStateDirs: [],
     removedSeedDirs: [],
     removedTempFiles: [],
-    removedLegacyArtifacts: [],
     errors: [],
     skipped: false,
   }
@@ -150,7 +119,6 @@ export function cleanupProjectSessions(cwd, { now = Date.now(), minIntervalMs =
   } catch (error) {
     result.errors.push(`${sessionsDir}: ${error.message}`)
   }
-  cleanupLegacyProjectArtifacts(activationDir, result)
 
   for (const workspaceEntry of readdirSync(sessionsDir, { withFileTypes: true })) {
     if (!workspaceEntry.isDirectory()) continue

package/scripts/runtime-scope.mjs

@@ -5,14 +5,17 @@ import { dirname, join, normalize, resolve } from 'node:path'
 import { homedir } from 'node:os'
 
 import {
+  PROJECT_CONVERSATION_PAYLOAD_KEYS,
+  PROJECT_SESSION_PAYLOAD_KEYS,
+  PROJECT_THREAD_PAYLOAD_KEYS,
   resolveProjectSessionAliasToken,
   resolveProjectSessionToken,
   resolveSessionToken,
+  sanitizeSessionToken,
 } from './session-token.mjs'
 import { USER_RUNTIME_MAX_AGE_MS } from './runtime-ttl.mjs'
 import { cleanupUserRuntimeRoot, getUserRuntimeRoot } from './runtime-user-cleanup.mjs'
 import { FULL_CARRIER_PROFILE_MARKER } from './cli-utils.mjs'
-import { readStateDocument, writeStateDocument } from './state-document.mjs'
 
 export const PROJECT_DIR_NAME = '.helloagents'
 export const PROJECT_SESSIONS_DIR_NAME = 'sessions'
@@ -21,7 +24,6 @@ export const EVENTS_FILE_NAME = 'events.jsonl'
 export const ACTIVE_SESSION_FILE_NAME = 'active.json'
 export const PROJECT_RUNTIME_FILE_NAME = 'runtime.json'
 export const DEFAULT_STATE_SESSION_TOKEN = 'default'
-export const LEGACY_SESSION_POINTERS_FILE_NAME = 'session-pointers.json'
 export const USER_RUNTIME_DIR_NAME = 'runtime'
 export { cleanupUserRuntimeRoot, getUserRuntimeRoot, USER_RUNTIME_MAX_AGE_MS }
 
@@ -267,38 +269,6 @@ function buildInitialStateSnapshot({
   ].join('\n')
 }
 
-function normalizeProjectSessionState(scope) {
-  if (!scope?.statePath) return
-
-  const currentDocument = readStateDocument(scope.statePath)
-  if (currentDocument.hasMetadata) {
-    if (currentDocument.metadata && typeof currentDocument.metadata === 'object' && !existsSync(scope.runtimePath)) {
-      writeJsonFileAtomic(scope.runtimePath, currentDocument.metadata)
-    }
-    writeStateDocument(scope.statePath, {
-      body: currentDocument.body,
-    })
-  }
-
-  const workspaceStatePath = scope.workspaceDir ? join(scope.workspaceDir, 'STATE.md') : ''
-  if (!workspaceStatePath || samePath(workspaceStatePath, scope.statePath) || !existsSync(workspaceStatePath)) return
-
-  const legacyDocument = readStateDocument(workspaceStatePath)
-  if (!existsSync(scope.statePath) && legacyDocument.body.trim()) {
-    writeStateDocument(scope.statePath, {
-      body: legacyDocument.body,
-    })
-  }
-  if (legacyDocument.metadata && typeof legacyDocument.metadata === 'object' && !existsSync(scope.runtimePath)) {
-    writeJsonFileAtomic(scope.runtimePath, legacyDocument.metadata)
-  }
-  if (legacyDocument.hasMetadata) {
-    writeStateDocument(workspaceStatePath, {
-      body: legacyDocument.body,
-    })
-  }
-}
-
 export function ensureProjectLocalRuntime(cwd, options = {}) {
   const normalizedCwd = normalizePath(cwd || process.cwd())
   const localDir = getProjectLocalDir(normalizedCwd)
@@ -310,7 +280,6 @@ export function ensureProjectLocalRuntime(cwd, options = {}) {
   if (!existsSync(scope.statePath)) {
     writeFileSync(scope.statePath, `${buildInitialStateSnapshot(options.stateSeed || {})}\n`, 'utf-8')
   }
-  normalizeProjectSessionState(scope)
 
   return scope
 }
@@ -369,6 +338,31 @@ function resolvePayloadSessionToken(payload = {}) {
   })
 }
 
+function readRawPayloadValue(payload = {}, key = '') {
+  if (!payload || typeof payload !== 'object') return ''
+  const value = payload[key]
+  if (typeof value === 'string') return value.trim()
+  if (typeof value === 'number') return String(value)
+  return ''
+}
+
+function readPayloadSessionIdentity(payload = {}) {
+  const groups = [
+    ['session', PROJECT_SESSION_PAYLOAD_KEYS],
+    ['conversation', PROJECT_CONVERSATION_PAYLOAD_KEYS],
+    ['thread', PROJECT_THREAD_PAYLOAD_KEYS],
+  ]
+
+  for (const [kind, keys] of groups) {
+    for (const key of keys) {
+      const value = sanitizeRuntimeSegment(sanitizeSessionToken(readRawPayloadValue(payload, key)), '')
+      if (value) return { kind, token: value }
+    }
+  }
+
+  return { kind: '', token: '' }
+}
+
 function resolveEnvSessionToken(env = process.env) {
   return resolveProjectSessionToken({ payload: {}, env })
 }
@@ -377,6 +371,17 @@ function resolveEnvSessionAliasToken(env = process.env) {
   return resolveProjectSessionAliasToken({ env })
 }
 
+function resolveProjectSessionHostHint({ env = process.env, ppid = process.ppid } = {}) {
+  const envToken = sanitizeRuntimeSegment(resolveEnvSessionToken(env), '')
+  if (envToken) return `host:${envToken}`
+
+  const envAliasToken = sanitizeRuntimeSegment(resolveEnvSessionAliasToken(env), '')
+  if (envAliasToken) return `alias:${envAliasToken}`
+
+  const parentToken = sanitizeRuntimeSegment(String(ppid || '').trim(), '')
+  return parentToken ? `ppid:${parentToken}` : ''
+}
+
 function resolveTransientSessionToken({ payload = {}, env = process.env, ppid = process.ppid } = {}) {
   return resolveSessionToken({
     payload,
@@ -393,18 +398,33 @@ function buildScopedSessionToken(kind = '', raw = '') {
   return `${normalizedKind}-${value}`
 }
 
-function getActiveSessionPath(activationDir) {
-  return join(activationDir, PROJECT_SESSIONS_DIR_NAME, ACTIVE_SESSION_FILE_NAME)
+function buildSessionAliasKeys({ payload = {}, env = process.env } = {}) {
+  const keys = []
+  const payloadIdentity = readPayloadSessionIdentity(payload)
+  if (payloadIdentity.token) {
+    keys.push(`${payloadIdentity.kind}:${payloadIdentity.token}`)
+  }
+
+  const envSession = sanitizeRuntimeSegment(resolveEnvSessionToken(env), '')
+  if (envSession && !payloadIdentity.token) keys.push(`host:${envSession}`)
+
+  const payloadAlias = sanitizeRuntimeSegment(sanitizeSessionToken(payload?._helloagentsSessionAlias), '')
+  if (payloadAlias) keys.push(`alias:${payloadAlias}`)
+
+  const envAlias = sanitizeRuntimeSegment(resolveEnvSessionAliasToken(env), '')
+  if (envAlias && envSession && envAlias === envSession) {
+    return [...new Set(keys.filter(Boolean))]
+  }
+  if (envAlias) keys.push(`alias:${envAlias}`)
+
+  return [...new Set(keys.filter(Boolean))]
 }
 
-function removeLegacySessionPointersFile(activationDir) {
-  if (!activationDir) return
-  try {
-    rmSync(join(activationDir, PROJECT_SESSIONS_DIR_NAME, LEGACY_SESSION_POINTERS_FILE_NAME), { force: true })
-  } catch {}
+function getActiveSessionPath(activationDir) {
+  return join(activationDir, PROJECT_SESSIONS_DIR_NAME, ACTIVE_SESSION_FILE_NAME)
 }
 
-function resolveActiveSessionToken({ activationDir, projectRoot, workspace, now = Date.now() } = {}) {
+function readActiveProjectSession({ activationDir, projectRoot, workspace, now = Date.now() } = {}) {
   const active = readJsonFile(getActiveSessionPath(activationDir), null)
   if (!active || typeof active !== 'object') return ''
   if (active.cwd && !samePath(active.cwd, projectRoot)) return ''
@@ -415,43 +435,77 @@ function resolveActiveSessionToken({ activationDir, projectRoot, workspace, now
   const updatedAt = Date.parse(active.updatedAt || '')
   if (!Number.isFinite(updatedAt) || now - updatedAt > USER_RUNTIME_MAX_AGE_MS) return ''
 
-  return sanitizeRuntimeSegment(active.session, '')
+  return active
 }
 
 function resolveActiveAliasSession({ activationDir, projectRoot, workspace, alias, now = Date.now() } = {}) {
   if (!alias) return ''
-  const active = readJsonFile(getActiveSessionPath(activationDir), null)
+  const active = readActiveProjectSession({
+    activationDir,
+    projectRoot,
+    workspace,
+    now,
+  })
   if (!active || typeof active !== 'object') return ''
-  if (active.cwd && !samePath(active.cwd, projectRoot)) return ''
 
-  const activeWorkspace = sanitizeRuntimeSegment(active.workspace || active.branch || '', '')
-  if (activeWorkspace && activeWorkspace !== workspace) return ''
+  const aliases = active.aliases && typeof active.aliases === 'object' ? active.aliases : {}
+  const mapped = sanitizeRuntimeSegment(aliases[alias], '')
+  if (mapped) return mapped
+  if (
+    Object.prototype.hasOwnProperty.call(aliases, alias)
+    && resolveActiveSessionToken(active, join(activationDir, PROJECT_SESSIONS_DIR_NAME, workspace)) === DEFAULT_STATE_SESSION_TOKEN
+  ) {
+    return DEFAULT_STATE_SESSION_TOKEN
+  }
+  return ''
+}
 
-  const updatedAt = Date.parse(active.updatedAt || '')
-  if (!Number.isFinite(updatedAt) || now - updatedAt > USER_RUNTIME_MAX_AGE_MS) return ''
+function choosePreferredProjectSession(activeSession = '', candidates = []) {
+  for (const candidate of candidates) {
+    if (!candidate) continue
+    if (activeSession && candidate === activeSession) return candidate
+  }
+  return candidates.find(Boolean) || ''
+}
 
-  const aliases = active.aliases && typeof active.aliases === 'object' ? active.aliases : {}
-  return sanitizeRuntimeSegment(aliases[alias], '')
+function resolveActiveSessionToken(active = {}, workspaceDir = '') {
+  const session = sanitizeRuntimeSegment(active?.session || '', '')
+  if (session) return session
+
+  const defaultStatePath = workspaceDir
+    ? join(workspaceDir, DEFAULT_STATE_SESSION_TOKEN, 'STATE.md')
+    : ''
+  return defaultStatePath && existsSync(defaultStatePath)
+    ? DEFAULT_STATE_SESSION_TOKEN
+    : ''
 }
 
-export function writeActiveProjectSession(scope, { host = '', source = '', env = process.env } = {}) {
+export function writeActiveProjectSession(scope, { host = '', source = '', payload = {}, env = process.env, ppid = process.ppid } = {}) {
   if (!scope?.active || !scope.activationDir || !scope.workspace) return ''
 
   const activePath = getActiveSessionPath(scope.activationDir)
   const current = readJsonFile(activePath, null) || {}
-  const aliases = current.aliases && typeof current.aliases === 'object' ? current.aliases : {}
-  const envToken = sanitizeRuntimeSegment(resolveEnvSessionToken(env), '')
-  if (envToken && envToken !== scope.session) aliases[envToken] = scope.session
-  const aliasToken = sanitizeRuntimeSegment(resolveEnvSessionAliasToken(env), '')
-  if (aliasToken && aliasToken !== scope.session) aliases[aliasToken] = scope.session
+  const aliases = current.aliases && typeof current.aliases === 'object' ? { ...current.aliases } : {}
+  const session = scope.session || DEFAULT_STATE_SESSION_TOKEN
+  const sessionMode = scope.session
+    ? scope.sessionMode
+    : 'default'
+  const hostHint = resolveProjectSessionHostHint({ env, ppid }) || current.hostHint || ''
+  const aliasKeys = buildSessionAliasKeys({ payload, env })
+  for (const aliasKey of aliasKeys) {
+    aliases[aliasKey] = session
+    const [, aliasValue = ''] = String(aliasKey).split(':')
+    if (aliasValue) aliases[aliasValue] = session
+  }
   writeJsonFileAtomic(activePath, {
     version: 1,
     cwd: scope.cwd,
     workspace: scope.workspace || scope.branch,
-    session: scope.session,
-    sessionMode: scope.sessionMode,
+    session,
+    sessionMode,
     host,
     source,
+    ...(hostHint ? { hostHint } : {}),
     aliases,
     ...(current.cleanupCheckedAt ? { cleanupCheckedAt: current.cleanupCheckedAt } : {}),
     updatedAt: new Date().toISOString(),
@@ -459,23 +513,73 @@ export function writeActiveProjectSession(scope, { host = '', source = '', env =
   return activePath
 }
 
-function chooseProjectSession({ payload, env, activationDir, projectRoot, workspace }) {
-  const payloadToken = sanitizeRuntimeSegment(resolvePayloadSessionToken(payload), '')
-  const payloadAlias = sanitizeRuntimeSegment(payload?._helloagentsSessionAlias, '')
+function chooseProjectSession({ payload, env, ppid, activationDir, projectRoot, workspace }) {
+  const workspaceDir = join(activationDir, PROJECT_SESSIONS_DIR_NAME, workspace)
+  const active = readActiveProjectSession({
+    activationDir,
+    projectRoot,
+    workspace,
+  })
+  const activeSession = resolveActiveSessionToken(active, workspaceDir)
+  const payloadIdentity = readPayloadSessionIdentity(payload)
+  const payloadToken = payloadIdentity.token
+  const payloadAlias = sanitizeRuntimeSegment(sanitizeSessionToken(payload?._helloagentsSessionAlias), '')
+  const payloadAliases = [
+    payloadIdentity.token ? `${payloadIdentity.kind}:${payloadIdentity.token}` : '',
+    payloadAlias ? `alias:${payloadAlias}` : '',
+  ].filter(Boolean)
+  const payloadMappedSession = choosePreferredProjectSession(
+    activeSession,
+    payloadAliases.map((alias) => resolveActiveAliasSession({
+      activationDir,
+      projectRoot,
+      workspace,
+      alias,
+    })),
+  )
+  if (payloadMappedSession) {
+    return { session: payloadMappedSession, sessionMode: 'active-session' }
+  }
+
+  const envToken = sanitizeRuntimeSegment(resolveEnvSessionToken(env), '')
+  const envAliasToken = sanitizeRuntimeSegment(resolveEnvSessionAliasToken(env), '')
+  const envMappedSession = choosePreferredProjectSession(
+    activeSession,
+    [
+      envToken ? resolveActiveAliasSession({
+        activationDir,
+        projectRoot,
+        workspace,
+        alias: `host:${envToken}`,
+      }) : '',
+      envAliasToken ? resolveActiveAliasSession({
+        activationDir,
+        projectRoot,
+        workspace,
+        alias: `alias:${envAliasToken}`,
+      }) : '',
+    ],
+  )
+  if (envMappedSession) return { session: envMappedSession, sessionMode: 'active-session' }
+
+  if (
+    activeSession === DEFAULT_STATE_SESSION_TOKEN
+    && active?.hostHint
+    && active.hostHint === resolveProjectSessionHostHint({ env, ppid })
+    && (payloadToken || payloadAlias || envToken || envAliasToken)
+  ) {
+    return {
+      session: activeSession,
+      sessionMode: 'active-session',
+    }
+  }
+
   if (payloadToken) {
     return {
       session: buildScopedSessionToken('host', payloadToken),
       sessionMode: 'host-session',
     }
   }
-
-  const payloadAliasToken = resolveActiveAliasSession({
-    activationDir,
-    projectRoot,
-    workspace,
-    alias: payloadAlias,
-  })
-  if (payloadAliasToken) return { session: payloadAliasToken, sessionMode: 'active-session' }
   if (payloadAlias) {
     return {
       session: buildScopedSessionToken('alias', payloadAlias),
@@ -483,16 +587,6 @@ function chooseProjectSession({ payload, env, activationDir, projectRoot, worksp
     }
   }
 
-  const envToken = sanitizeRuntimeSegment(resolveEnvSessionToken(env), '')
-  const envAliasToken = sanitizeRuntimeSegment(resolveEnvSessionAliasToken(env), '')
-  const aliasToken = resolveActiveAliasSession({
-    activationDir,
-    projectRoot,
-    workspace,
-    alias: envToken,
-  })
-  if (aliasToken) return { session: aliasToken, sessionMode: 'active-session' }
-
   if (envToken) {
     return {
       session: buildScopedSessionToken('host', envToken),
@@ -501,42 +595,33 @@ function chooseProjectSession({ payload, env, activationDir, projectRoot, worksp
   }
 
   if (envAliasToken) {
-    const activeAliasToken = resolveActiveAliasSession({
-      activationDir,
-      projectRoot,
-      workspace,
-      alias: envAliasToken,
-    })
-    if (activeAliasToken) return { session: activeAliasToken, sessionMode: 'active-session' }
     return {
       session: buildScopedSessionToken('alias', envAliasToken),
       sessionMode: 'alias-session',
     }
   }
 
-  return { session: '', sessionMode: 'unidentified' }
-}
+  const source = String(payload?.source || '').trim().toLowerCase()
+  if ((source === 'resume' || source === 'compact') && activeSession) {
+    return {
+      session: activeSession,
+      sessionMode: 'active-session',
+    }
+  }
 
-function removeLegacyProjectArtifacts(activationDir) {
-  if (!activationDir) return
-  const artifactsDir = join(activationDir, PROJECT_ARTIFACTS_DIR_NAME)
-  if (!existsSync(artifactsDir)) return
-  try {
-    rmSync(artifactsDir, { recursive: true, force: true })
-  } catch {}
+  return { session: '', sessionMode: 'unidentified' }
 }
 
 export function getProjectSessionScope(cwd, options = {}) {
   const normalizedCwd = normalizePath(cwd || process.cwd())
   const projectRoot = getProjectRoot(normalizedCwd)
-  const { payload = {}, env = process.env } = normalizeRuntimeOptions(options)
+  const { payload = {}, env = process.env, ppid = process.ppid } = normalizeRuntimeOptions(options)
   const activationDir = getProjectActivationDir(projectRoot)
-  removeLegacyProjectArtifacts(activationDir)
-  removeLegacySessionPointersFile(activationDir)
   const workspace = resolveWorkspaceName(projectRoot)
   const { session, sessionMode } = chooseProjectSession({
     payload,
     env,
+    ppid,
     activationDir,
     projectRoot,
     workspace,

package/scripts/session-capsule.mjs

@@ -1,4 +1,4 @@
-import { existsSync, mkdirSync, readdirSync, rmSync, writeFileSync } from 'node:fs'
+import { existsSync, mkdirSync, rmSync, writeFileSync } from 'node:fs'
 import { basename, dirname, join } from 'node:path'
 
 import {
@@ -43,67 +43,6 @@ function writeRuntimeDocument(filePath, payload) {
   writeJsonFileAtomic(filePath, payload)
 }
 
-function isSamePath(left = '', right = '') {
-  if (process.platform === 'win32') {
-    return left.toLowerCase() === right.toLowerCase()
-  }
-  return left === right
-}
-
-function isSeedOnlyState(body = '') {
-  return String(body || '').includes('由运行时自动创建；后续按实际任务重写')
-}
-
-function looksLikeLegacyFlattenedSessionDir(entryName = '') {
-  return /^[a-z0-9]{8}$/i.test(String(entryName || '').trim())
-}
-
-function migrateLegacyProjectScope(scope) {
-  if (scope.scope !== 'project-session') return
-  const workspaceDir = scope.workspaceDir || join(scope.activationDir, 'sessions', scope.workspace || scope.branch)
-  const legacyStatePath = join(workspaceDir, 'STATE.md')
-  const legacyRuntimePath = join(workspaceDir, 'runtime.json')
-  if (isSamePath(workspaceDir, scope.sessionDir)) return
-
-  const currentDocument = readStateDocument(scope.statePath)
-  const currentCapsule = currentDocument.metadata && typeof currentDocument.metadata === 'object'
-    ? currentDocument.metadata
-    : null
-  const legacyDocument = readStateDocument(legacyStatePath)
-  const legacyCapsule = readRuntimeDocument(legacyRuntimePath)
-  const shouldNormalizeCurrentBody = currentDocument.hasMetadata
-  const shouldWriteBody = (!currentDocument.body.trim() && legacyDocument.body.trim()) || shouldNormalizeCurrentBody
-  const shouldWriteRuntime = (legacyCapsule || currentCapsule) && !readRuntimeDocument(scope.runtimePath)
-
-  if (shouldWriteBody) {
-    writeStateDocument(scope.statePath, {
-      body: currentDocument.body.trim() ? currentDocument.body : legacyDocument.body,
-    })
-  }
-  if (shouldWriteRuntime) {
-    writeRuntimeDocument(scope.runtimePath, legacyCapsule || currentCapsule)
-  }
-
-  if (existsSync(legacyStatePath) && shouldWriteBody) {
-    const legacyCurrent = readStateDocument(legacyStatePath)
-    if (legacyCurrent.hasMetadata) {
-      writeStateDocument(legacyStatePath, {
-        body: legacyCurrent.body,
-      })
-    }
-  }
-  if (existsSync(legacyRuntimePath) && shouldWriteRuntime) {
-    rmSync(legacyRuntimePath, { force: true })
-  }
-  if (existsSync(workspaceDir)) {
-    for (const entry of readdirSync(workspaceDir, { withFileTypes: true })) {
-      if (!entry.isDirectory()) continue
-      if (!looksLikeLegacyFlattenedSessionDir(entry.name)) continue
-      rmSync(join(workspaceDir, entry.name), { recursive: true, force: true })
-    }
-  }
-}
-
 function normalizeOptions(options = {}) {
   if (!options || typeof options !== 'object') return {}
   if (options.payload && typeof options.payload === 'object') return options
@@ -114,7 +53,7 @@ function normalizeOptions(options = {}) {
 }
 
 function getEventSessionAlias(eventPayload = {}) {
-  return eventPayload.sessionId || eventPayload.session_id || eventPayload['session-id'] || ''
+  return eventPayload.sessionAlias || eventPayload.session_alias || eventPayload['session-alias'] || eventPayload._helloagentsSessionAlias || ''
 }
 
 function getScope(cwd, options = {}) {
@@ -182,7 +121,6 @@ export function getSessionArtifactRelativePath(cwd, fileName, options = {}) {
 
 export function readSessionCapsule(cwd = process.cwd(), options = {}) {
   const scope = getScope(cwd, options)
-  migrateLegacyProjectScope(scope)
   const capsule = readRuntimeDocument(scope.runtimePath)
   if (!capsule || Array.isArray(capsule)) return buildEmptyCapsule(scope)
   return {
@@ -201,7 +139,6 @@ export function readSessionCapsule(cwd = process.cwd(), options = {}) {
 export function writeSessionCapsule(cwd, capsule, options = {}) {
   const normalizedOptions = normalizeOptions(options)
   const scope = getScope(cwd, normalizedOptions)
-  migrateLegacyProjectScope(scope)
   const shouldMaterialize = shouldMaterializeSessionState(normalizedOptions)
   const currentDocument = readStateDocument(scope.statePath)
   const hasBody = Boolean(currentDocument.body && currentDocument.body.trim())
@@ -246,7 +183,9 @@ export function writeSessionCapsule(cwd, capsule, options = {}) {
     })
   }
   writeActiveProjectSession(scope, {
+    payload: normalizedOptions.payload,
     env: normalizedOptions.env,
+    ppid: normalizedOptions.ppid,
   })
   return nextCapsule
 }
@@ -305,7 +244,9 @@ export function appendSessionEvent(cwd, eventPayload, options = {}) {
   writeActiveProjectSession(scope, {
     host: eventPayload.host || '',
     source: eventPayload.source || eventName,
+    payload: scopedOptions.payload,
     env: scopedOptions.env,
+    ppid: scopedOptions.ppid,
   })
   if (!shouldRecordSessionEvents(scopedOptions)) return ''
 

package/scripts/session-token.mjs

@@ -17,19 +17,31 @@ const PAYLOAD_SESSION_KEYS = [
   'tab',
 ]
 
-const PROJECT_PAYLOAD_SESSION_KEYS = [
+const PROJECT_SESSION_PAYLOAD_KEYS = [
   'sessionId',
   'session_id',
   'session',
+]
+
+const PROJECT_CONVERSATION_PAYLOAD_KEYS = [
   'conversationId',
   'conversation_id',
   'conversation',
+]
+
+const PROJECT_THREAD_PAYLOAD_KEYS = [
   'threadId',
   'thread_id',
   'thread-id',
   'thread',
 ]
 
+const PROJECT_PAYLOAD_SESSION_KEYS = [
+  ...PROJECT_SESSION_PAYLOAD_KEYS,
+  ...PROJECT_CONVERSATION_PAYLOAD_KEYS,
+  ...PROJECT_THREAD_PAYLOAD_KEYS,
+]
+
 const ENV_SESSION_KEYS = [
   'HELLOAGENTS_NOTIFY_SESSION_ID',
   'WT_SESSION',
@@ -46,7 +58,6 @@ const PROJECT_ENV_SESSION_KEYS = [
 ]
 
 const PROJECT_ALIAS_ENV_SESSION_KEYS = [
-  'HELLOAGENTS_NOTIFY_SESSION_ID',
   'WT_SESSION',
   'TERM_SESSION_ID',
   'KITTY_WINDOW_ID',
@@ -120,6 +131,9 @@ export {
   ENV_SESSION_KEYS,
   PAYLOAD_SESSION_KEYS,
   PROJECT_ALIAS_ENV_SESSION_KEYS,
+  PROJECT_CONVERSATION_PAYLOAD_KEYS,
   PROJECT_ENV_SESSION_KEYS,
   PROJECT_PAYLOAD_SESSION_KEYS,
+  PROJECT_SESSION_PAYLOAD_KEYS,
+  PROJECT_THREAD_PAYLOAD_KEYS,
 }

package/scripts/state-document.mjs

@@ -1,67 +1,23 @@
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs'
 import { dirname } from 'node:path'
 
-const STATE_META_BEGIN = '<!-- HELLOAGENTS_STATE_META'
-const STATE_META_END = 'HELLOAGENTS_STATE_META -->'
 export const AUTO_CREATED_STATE_MARKER = '由运行时自动创建；后续按实际任务重写'
 
 function normalizeText(content = '') {
   return String(content || '').replace(/^\uFEFF/, '')
 }
 
-function splitLines(content = '') {
-  return normalizeText(content).replace(/\r\n/g, '\n').split('\n')
-}
-
-export function parseStateDocument(content = '') {
-  const lines = splitLines(content)
-  if (lines[0]?.trim() !== STATE_META_BEGIN) {
-    return {
-      hasMetadata: false,
-      metadata: null,
-      body: normalizeText(content),
-    }
-  }
-
-  const endIndex = lines.findIndex((line, index) => index > 0 && line.trim() === STATE_META_END)
-  if (endIndex < 0) {
-    return {
-      hasMetadata: false,
-      metadata: null,
-      body: normalizeText(content),
-    }
-  }
-
-  const metadataText = lines.slice(1, endIndex).join('\n').trim()
-  const body = lines.slice(endIndex + 1).join('\n').replace(/^\n+/, '')
-  try {
-    return {
-      hasMetadata: true,
-      metadata: JSON.parse(metadataText),
-      body,
-    }
-  } catch {
-    return {
-      hasMetadata: false,
-      metadata: null,
-      body,
-    }
-  }
-}
-
 export function readStateDocument(filePath) {
   if (!filePath || !existsSync(filePath)) {
-    return {
-      hasMetadata: false,
-      metadata: null,
-      body: '',
-    }
+    return { body: '' }
   }
 
-  return parseStateDocument(readFileSync(filePath, 'utf-8'))
+  return {
+    body: normalizeText(readFileSync(filePath, 'utf-8')),
+  }
 }
 
-export function composeStateDocument({ metadata = {}, body = '' } = {}) {
+export function composeStateDocument({ body = '' } = {}) {
   const normalizedBody = normalizeText(body).replace(/^\n+/, '')
   return normalizedBody ? `${normalizedBody.replace(/\n+$/, '')}\n` : ''
 }
@@ -70,7 +26,7 @@ export function looksLikeAutoCreatedState(body = '') {
   return normalizeText(body).includes(AUTO_CREATED_STATE_MARKER)
 }
 
-export function writeStateDocument(filePath, { metadata = {}, body = '' } = {}) {
+export function writeStateDocument(filePath, { body = '' } = {}) {
   mkdirSync(dirname(filePath), { recursive: true })
-  writeFileSync(filePath, composeStateDocument({ metadata, body }), 'utf-8')
+  writeFileSync(filePath, composeStateDocument({ body }), 'utf-8')
 }