helloagents 3.0.38 → 3.1.1

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')
 }