refactor chat run socket (#739)

This commit is contained in:
ekko
2026-05-15 10:08:52 +08:00
committed by GitHub
parent 6add32feff
commit da067a5a78
16 changed files with 2499 additions and 77 deletions
+1 -1
View File
@@ -19,7 +19,7 @@ import { registerRoutes } from './routes'
import { setGroupChatServer } from './routes/hermes/group-chat'
import { setChatRunServer } from './routes/hermes/chat-run'
import { GroupChatServer } from './services/hermes/group-chat'
import { ChatRunSocket } from './services/hermes/chat-run-socket'
import { ChatRunSocket } from './services/hermes/run-chat'
import { startAgentBridgeManager } from './services/hermes/agent-bridge'
import { logger } from './services/logger'
@@ -1,4 +1,4 @@
import type { ChatRunSocket } from '../../services/hermes/chat-run-socket'
import type { ChatRunSocket } from '../../services/hermes/run-chat'
let chatRunServer: ChatRunSocket | null = null
@@ -353,6 +353,7 @@ class AgentPool:
self._sessions: dict[str, AgentSession] = {}
self._runs: dict[str, RunRecord] = {}
self._lock = threading.RLock()
self._run_lock = threading.Lock()
self._db = SessionDbHolder()
self._approval_requests: dict[str, queue.Queue[str]] = {}
self._compression_requests: dict[str, queue.Queue[dict[str, Any]]] = {}
@@ -755,87 +756,88 @@ class AgentPool:
return record
def _run_chat(self, session: AgentSession, record: RunRecord, message: Any, instructions: str | None = None, conversation_history: list[dict[str, Any]] | None = None, profile: str | None = None, force_compress: bool = False) -> None:
def stream_callback(delta: str) -> None:
with self._lock:
record.deltas.append(str(delta))
with self._run_lock:
def stream_callback(delta: str) -> None:
with self._lock:
record.deltas.append(str(delta))
try:
previous_approval_callback = None
previous_exec_ask = os.environ.get("HERMES_EXEC_ASK")
approval_session_token = None
try:
from tools.terminal_tool import _get_approval_callback, set_approval_callback
from tools.approval import set_current_session_key
previous_approval_callback = _get_approval_callback()
set_approval_callback(self._approval_callback(session.session_id))
approval_session_token = set_current_session_key(session.session_id)
os.environ["HERMES_EXEC_ASK"] = "1"
except Exception:
previous_approval_callback = None
self._prepersist_user_message(session, message, conversation_history, profile)
if force_compress:
compress = getattr(session.agent, "_compress_context", None)
if callable(compress):
compressed_history, compressed_system = compress(
conversation_history if isinstance(conversation_history, list) else [],
instructions,
approx_tokens=None,
focus_topic="debug_force_compress",
)
if isinstance(compressed_history, list):
conversation_history = compressed_history
if isinstance(compressed_system, str):
instructions = compressed_system
kwargs: dict[str, Any] = dict(
task_id=session.session_id,
stream_callback=stream_callback,
)
if instructions:
kwargs["system_message"] = instructions
if conversation_history is not None:
kwargs["conversation_history"] = conversation_history
result = session.agent.run_conversation(
message,
**kwargs,
)
result = _jsonable(result if isinstance(result, dict) else {"value": result})
with session.lock:
if isinstance(result.get("messages"), list):
session.history = result["messages"]
record.status = "interrupted" if result.get("interrupted") else "complete"
record.result = result
record.ended_at = time.time()
session.running = False
session.current_run_id = None
session.last_used_at = time.time()
except Exception as exc:
with session.lock:
record.status = "error"
record.error = str(exc)
record.result = {"error": str(exc), "traceback": traceback.format_exc()}
record.ended_at = time.time()
session.running = False
session.current_run_id = None
session.last_used_at = time.time()
finally:
try:
from tools.terminal_tool import set_approval_callback
set_approval_callback(previous_approval_callback)
except Exception:
pass
if approval_session_token is not None:
previous_exec_ask = os.environ.get("HERMES_EXEC_ASK")
approval_session_token = None
try:
from tools.approval import reset_current_session_key
from tools.terminal_tool import _get_approval_callback, set_approval_callback
from tools.approval import set_current_session_key
reset_current_session_key(approval_session_token)
previous_approval_callback = _get_approval_callback()
set_approval_callback(self._approval_callback(session.session_id))
approval_session_token = set_current_session_key(session.session_id)
os.environ["HERMES_EXEC_ASK"] = "1"
except Exception:
previous_approval_callback = None
self._prepersist_user_message(session, message, conversation_history, profile)
if force_compress:
compress = getattr(session.agent, "_compress_context", None)
if callable(compress):
compressed_history, compressed_system = compress(
conversation_history if isinstance(conversation_history, list) else [],
instructions,
approx_tokens=None,
focus_topic="debug_force_compress",
)
if isinstance(compressed_history, list):
conversation_history = compressed_history
if isinstance(compressed_system, str):
instructions = compressed_system
kwargs: dict[str, Any] = dict(
task_id=session.session_id,
stream_callback=stream_callback,
)
if instructions:
kwargs["system_message"] = instructions
if conversation_history is not None:
kwargs["conversation_history"] = conversation_history
result = session.agent.run_conversation(
message,
**kwargs,
)
result = _jsonable(result if isinstance(result, dict) else {"value": result})
with session.lock:
if isinstance(result.get("messages"), list):
session.history = result["messages"]
record.status = "interrupted" if result.get("interrupted") else "complete"
record.result = result
record.ended_at = time.time()
session.running = False
session.current_run_id = None
session.last_used_at = time.time()
except Exception as exc:
with session.lock:
record.status = "error"
record.error = str(exc)
record.result = {"error": str(exc), "traceback": traceback.format_exc()}
record.ended_at = time.time()
session.running = False
session.current_run_id = None
session.last_used_at = time.time()
finally:
try:
from tools.terminal_tool import set_approval_callback
set_approval_callback(previous_approval_callback)
except Exception:
pass
if previous_exec_ask is None:
os.environ.pop("HERMES_EXEC_ASK", None)
else:
os.environ["HERMES_EXEC_ASK"] = previous_exec_ask
if approval_session_token is not None:
try:
from tools.approval import reset_current_session_key
reset_current_session_key(approval_session_token)
except Exception:
pass
if previous_exec_ask is None:
os.environ.pop("HERMES_EXEC_ASK", None)
else:
os.environ["HERMES_EXEC_ASK"] = previous_exec_ask
def interrupt(self, session_id: str, message: str | None = None) -> dict[str, Any]:
with self._lock:
@@ -845,7 +847,15 @@ class AgentPool:
if not hasattr(session.agent, "interrupt"):
raise RuntimeError("agent does not support interrupt")
session.agent.interrupt(message)
return {"status": "interrupted", "session_id": session_id}
deadline = time.time() + 10.0
synced = False
while time.time() < deadline:
with session.lock:
if not session.running:
synced = True
break
time.sleep(0.05)
return {"status": "interrupted", "session_id": session_id, "synced": synced}
def steer(self, session_id: str, text: str) -> dict[str, Any]:
with self._lock:
@@ -0,0 +1,149 @@
/**
* Abort handler — cancels in-progress runs (both API server and CLI bridge).
*/
import type { Server, Socket } from 'socket.io'
import { updateSessionStats } from '../../../db/hermes/session-store'
import { logger } from '../../logger'
import { flushBridgePendingToDb } from './bridge-message'
import { flushResponseRunToDb } from './response-stream'
import { replaceState } from './compression'
import { calcAndUpdateUsage } from './usage'
import type { QueuedRun, SessionState } from './types'
export async function handleAbort(
nsp: ReturnType<Server['of']>,
socket: Socket,
sessionId: string,
sessionMap: Map<string, SessionState>,
bridge: any,
runQueuedItem: (socket: Socket, sessionId: string, next: QueuedRun, fallbackProfile?: string) => void,
) {
const state = sessionMap.get(sessionId)
if (!state?.isWorking || (!state.runId && !state.abortController)) {
logger.info({ sessionId }, '[chat-run-socket][abort] ignored: no active run')
if (state) {
state.isWorking = false
state.isAborting = false
state.abortController = undefined
state.runId = undefined
state.events = []
}
emitToSession(nsp, socket, sessionId, 'abort.completed', {
event: 'abort.completed',
synced: false,
ignored: true,
})
return
}
const runId = state.runId
state.isAborting = true
replaceState(sessionMap, sessionId, 'abort.started', {
event: 'abort.started',
run_id: runId,
graceMs: 5000,
})
emitToSession(nsp, socket, sessionId, 'abort.started', {
event: 'abort.started',
run_id: runId,
graceMs: 5000,
})
logger.info({ sessionId, runId }, '[chat-run-socket][abort] started')
// Flush in-memory assistant text to DB before aborting the stream.
if (state.source === 'cli') {
flushBridgePendingToDb(state, sessionId)
} else {
flushResponseRunToDb(state, sessionId)
}
if (state.source === 'cli') {
try {
await bridge.interrupt(sessionId, 'Aborted by user')
} catch (err) {
logger.warn(err, '[chat-run-socket][abort] failed to interrupt CLI bridge for session %s', sessionId)
}
} else if (state.abortController) {
state.abortController.abort()
}
await markAbortCompleted(nsp, socket, sessionId, runId || 'response_stream', sessionMap, runQueuedItem)
}
export async function markAbortCompleted(
nsp: ReturnType<Server['of']>,
socket: Socket,
sessionId: string,
runId: string,
sessionMap: Map<string, SessionState>,
runQueuedItem: (socket: Socket, sessionId: string, next: QueuedRun, fallbackProfile?: string) => void,
) {
const state = sessionMap.get(sessionId)
if (!state) return
const profile = state.profile
updateSessionStats(sessionId)
const emit = (event: string, payload: any) => {
nsp.to(`session:${sessionId}`).emit(event, { ...payload, session_id: sessionId })
}
await calcAndUpdateUsage(sessionId, state, emit)
state.isWorking = false
state.isAborting = false
state.profile = undefined
state.abortController = undefined
state.runId = undefined
state.responseRun = undefined
state.activeRunMarker = undefined
// Process queued messages after abort completes
if (state.queue.length > 0) {
const next = state.queue.shift()!
state.isWorking = true
state.isAborting = false
state.profile = next.profile || profile
state.source = next.source
logger.info('[chat-run-socket][abort] dequeuing queued run for session %s (remaining: %d)', sessionId, state.queue.length)
replaceState(sessionMap, sessionId, 'abort.completed', {
event: 'abort.completed',
run_id: runId,
synced: true,
queue_length: state.queue.length + 1,
})
emitToSession(nsp, socket, sessionId, 'abort.completed', {
event: 'abort.completed',
run_id: runId,
synced: true,
queue_length: state.queue.length + 1,
})
emitToSession(nsp, socket, sessionId, 'run.queued', {
event: 'run.queued',
queue_length: state.queue.length,
})
state.events = []
runQueuedItem(socket, sessionId, next, profile || 'default')
return
}
state.events = []
replaceState(sessionMap, sessionId, 'abort.completed', {
event: 'abort.completed',
run_id: runId,
synced: true,
})
emitToSession(nsp, socket, sessionId, 'abort.completed', {
event: 'abort.completed',
run_id: runId,
synced: true,
})
logger.info({ sessionId, runId, synced: true }, '[chat-run-socket][abort] completed')
}
function emitToSession(nsp: ReturnType<Server['of']>, socket: Socket, sessionId: string, event: string, payload: any) {
const tagged = { ...payload, session_id: sessionId }
nsp.to(`session:${sessionId}`).emit(event, tagged)
if (!nsp.adapter.rooms.get(`session:${sessionId}`)?.size && socket.connected) {
socket.emit(event, tagged)
}
}
@@ -0,0 +1,203 @@
/**
* Bridge message management — flush pending content to DB,
* track tool calls, manage assistant message lifecycle.
*/
import { addMessage } from '../../../db/hermes/session-store'
import { logger } from '../../logger'
import type { SessionMessage, SessionState } from './types'
export function flushBridgePendingToDb(state: SessionState, sessionId: string, runMarker?: string) {
const content = state.bridgePendingAssistantContent || ''
const reasoning = state.bridgePendingReasoningContent || ''
if (!content.trim()) return
if (runMarker) {
const last = findOpenBridgeAssistantMessage(state, runMarker)
if (last) syncBridgeReasoningToMessage(last, reasoning)
}
addMessage({
session_id: sessionId,
role: 'assistant',
content,
reasoning: reasoning || null,
reasoning_content: reasoning || null,
timestamp: Math.floor(Date.now() / 1000),
})
state.bridgePendingAssistantContent = ''
state.bridgePendingReasoningContent = ''
if (runMarker) {
const last = findOpenBridgeAssistantMessage(state, runMarker)
if (last && last.finish_reason == null) last.finish_reason = 'stop'
}
}
export function findOpenBridgeAssistantMessage(state: SessionState, runMarker: string): SessionMessage | undefined {
return [...state.messages]
.reverse()
.find(m => m.runMarker === runMarker && m.role === 'assistant' && m.finish_reason == null)
}
export function ensureOpenBridgeAssistantMessage(
state: SessionState,
sessionId: string,
runMarker: string,
): SessionMessage {
const existing = findOpenBridgeAssistantMessage(state, runMarker)
if (existing) return existing
const message: SessionMessage = {
id: state.messages.length + 1,
session_id: sessionId,
runMarker,
role: 'assistant',
content: '',
timestamp: Math.floor(Date.now() / 1000),
}
state.messages.push(message)
return message
}
export function syncBridgeReasoningToMessage(message: SessionMessage, reasoning?: string) {
if (!reasoning) return
message.reasoning = reasoning
message.reasoning_content = reasoning
}
export function recordBridgeToolStarted(
state: SessionState,
sessionId: string,
runMarker: string,
toolName: string,
args: Record<string, unknown> | undefined,
rawToolCallId: unknown,
): { id: string; name: string; arguments: string } {
const id = bridgeToolCallId(state, rawToolCallId, toolName)
const argsString = args ? JSON.stringify(args) : '{}'
const reasoning = state.bridgePendingReasoningContent || ''
const toolCall = {
id,
type: 'function',
function: {
name: toolName,
arguments: argsString,
},
}
const timestamp = Math.floor(Date.now() / 1000)
state.bridgePendingTools = state.bridgePendingTools || []
state.bridgePendingTools.push({
id,
name: toolName,
arguments: argsString,
startedAt: Date.now(),
})
const openMessage = findOpenBridgeAssistantMessage(state, runMarker)
if (openMessage && !openMessage.content && !openMessage.tool_calls?.length) {
openMessage.tool_calls = [toolCall]
openMessage.finish_reason = 'tool_calls'
openMessage.reasoning = reasoning || openMessage.reasoning || null
openMessage.reasoning_content = reasoning || openMessage.reasoning_content || null
openMessage.timestamp = timestamp
} else {
state.messages.push({
id: state.messages.length + 1,
session_id: sessionId,
runMarker,
role: 'assistant',
content: '',
tool_calls: [toolCall],
finish_reason: 'tool_calls',
reasoning: reasoning || null,
reasoning_content: reasoning || null,
timestamp,
})
}
addMessage({
session_id: sessionId,
role: 'assistant',
content: '',
tool_calls: [toolCall],
finish_reason: 'tool_calls',
reasoning: reasoning || null,
reasoning_content: reasoning || null,
timestamp,
})
state.bridgePendingReasoningContent = ''
return { id, name: toolName, arguments: argsString }
}
export function recordBridgeToolCompleted(
state: SessionState,
sessionId: string,
runMarker: string,
toolName: string,
ev: Record<string, unknown>,
): { id: string; output: string; duration?: number } {
state.bridgePendingTools = state.bridgePendingTools || []
const rawId = ev.tool_call_id
let idx = rawId
? state.bridgePendingTools.findIndex(tool => tool.id === String(rawId))
: -1
if (idx < 0 && toolName) {
idx = state.bridgePendingTools.findIndex(tool => tool.name === toolName)
}
if (idx < 0) {
idx = state.bridgePendingTools.length - 1
}
const pending = idx >= 0 ? state.bridgePendingTools.splice(idx, 1)[0] : undefined
const id = pending?.id || bridgeToolCallId(state, rawId, toolName)
const output = bridgeToolOutput(ev)
const timestamp = Math.floor(Date.now() / 1000)
logger.info(
'[chat-run-socket][bridge] recording CLI tool result session=%s tool=%s tool_call_id=%s raw_tool_call_id=%s output_len=%d has_result=%s has_output=%s has_result_preview=%s has_preview=%s event_keys=%s',
sessionId,
toolName,
id,
String(rawId || ''),
output.length,
String(ev.result != null),
String(ev.output != null),
String(ev.result_preview != null),
String(ev.preview != null),
Object.keys(ev).join(','),
)
state.messages.push({
id: state.messages.length + 1,
session_id: sessionId,
runMarker,
role: 'tool',
content: output,
tool_call_id: id,
tool_name: toolName || pending?.name || null,
timestamp,
})
addMessage({
session_id: sessionId,
role: 'tool',
content: output,
tool_call_id: id,
tool_name: toolName || pending?.name || null,
timestamp,
})
const duration = pending?.startedAt
? Math.round((Date.now() - pending.startedAt) / 10) / 100
: undefined
return { id, output, duration }
}
export function bridgeToolCallId(state: SessionState, rawToolCallId: unknown, toolName: string): string {
const raw = String(rawToolCallId || '').trim()
if (raw) return raw
state.bridgeToolCounter = (state.bridgeToolCounter || 0) + 1
const safeName = (toolName || 'tool').replace(/[^a-zA-Z0-9_-]/g, '_')
return `cli_${safeName}_${state.bridgeToolCounter}`
}
export function bridgeToolOutput(ev: Record<string, unknown>): string {
const value = ev.result ?? ev.output ?? ev.result_preview ?? ev.preview ?? ''
return typeof value === 'string' ? value : JSON.stringify(value ?? '')
}
@@ -0,0 +1,299 @@
/**
* Context compression — build conversation history from DB,
* apply snapshot-aware compression and LLM summarization.
*/
import {
getSessionDetail,
} from '../../../db/hermes/session-store'
import { getCompressionSnapshot } from '../../../db/hermes/compression-snapshot'
import { ChatContextCompressor, countTokens, SUMMARY_PREFIX } from '../../../lib/context-compressor'
import { getModelContextLength } from '../model-context'
import { logger } from '../../logger'
import { bridgeLogger } from '../../logger'
import { calcAndUpdateUsage } from './usage'
import type { ChatMessage } from '../../../lib/context-compressor'
import type { SessionState, BridgeCompressionResult } from './types'
const compressor = new ChatContextCompressor()
/**
* Load conversation history from DB with full message structure (user/assistant/tool).
*/
export async function buildDbHistory(
sessionId: string,
options: { excludeLastUser?: boolean } = {},
): Promise<ChatMessage[]> {
const detail = getSessionDetail(sessionId)
if (!detail?.messages?.length) return []
const validMessages = detail.messages.filter(m =>
(m.role === 'user' || m.role === 'assistant' || m.role === 'tool') && m.content !== undefined,
)
const sourceMessages = options.excludeLastUser
? (() => {
const lastUserMsgIndex = [...validMessages].reverse().findIndex(m => m.role === 'user')
return lastUserMsgIndex >= 0
? validMessages.slice(0, validMessages.length - lastUserMsgIndex - 1)
: validMessages
})()
: validMessages
return sourceMessages.map((m, idx, arr) => {
const msg: any = { role: m.role, content: m.content || '' }
if (m.reasoning_content) msg.reasoning_content = m.reasoning_content
if (m.tool_calls?.length) {
const cleanedToolCalls = m.tool_calls
.filter((tc: any) => tc.id && tc.id.length > 0)
.map((tc: any) => ({ id: tc.id, type: tc.type, function: tc.function }))
if (cleanedToolCalls.length > 0) msg.tool_calls = cleanedToolCalls
}
if (m.role === 'tool') {
let callId = m.tool_call_id
if (!callId || callId.length === 0) {
const prevMsg = arr[idx - 1]
if (prevMsg?.role === 'assistant' && prevMsg.tool_calls?.length) {
const tc = prevMsg.tool_calls.find((t: any) => t.function?.name === m.tool_name)
if (tc?.id) callId = tc.id
}
}
if (!callId || callId.length === 0) return null
msg.tool_call_id = callId
}
if (m.tool_name) msg.name = m.tool_name
return msg
}).filter((m): m is ChatMessage => m !== null)
}
export async function buildCompressedHistory(
sessionId: string,
profile: string,
upstream: string,
apiKey: string | undefined,
emit: (event: string, payload: any) => void,
sessionMap: Map<string, SessionState>,
): Promise<ChatMessage[]> {
try {
let history = await buildDbHistory(sessionId, { excludeLastUser: true })
if (history.length === 0) return []
const contextLength = getModelContextLength(profile)
const triggerTokens = Math.floor(contextLength / 2)
const cState = getOrCreateSession(sessionMap, sessionId)
const assembledTokens = await calcAndUpdateUsage(sessionId, cState, emit)
const totalTokens = assembledTokens.inputTokens + assembledTokens.outputTokens
const snapshot = getCompressionSnapshot(sessionId)
if (snapshot) {
const newMessages = history.slice(snapshot.lastMessageIndex + 1)
logger.info('[context-compress] session=%s: snapshot at %d, %d new messages, assembled ~%d tokens (threshold %d)',
sessionId, snapshot.lastMessageIndex, newMessages.length, totalTokens, triggerTokens)
if (totalTokens <= triggerTokens && newMessages.length <= 150) {
history = [
{ role: 'user', content: SUMMARY_PREFIX + '\n\n' + snapshot.summary },
...newMessages,
] as ChatMessage[]
} else {
history = await compressHistory(history, newMessages, sessionId, upstream, apiKey, cState, totalTokens, emit, sessionMap)
}
} else if (history.length > 4) {
if (totalTokens <= triggerTokens && history.length <= 150) {
logger.info('[context-compress] session=%s: %d messages, ~%d tokens — under threshold, skip', sessionId, history.length, totalTokens)
} else {
history = await compressHistory(history, null, sessionId, upstream, apiKey, cState, totalTokens, emit, sessionMap)
}
}
return history
} catch (err) {
logger.warn(err, '[chat-run-socket] failed to build compressed history for session %s', sessionId)
return []
}
}
export async function compressHistory(
history: ChatMessage[],
newMessagesOnly: ChatMessage[] | null,
sessionId: string,
upstream: string,
apiKey: string | undefined,
cState: SessionState,
totalTokens: number,
emit: (event: string, payload: any) => void,
sessionMap: Map<string, SessionState>,
): Promise<ChatMessage[]> {
const msgCount = newMessagesOnly ? newMessagesOnly.length : history.length
pushState(sessionMap, sessionId, 'compression.started', {
event: 'compression.started', message_count: msgCount, token_count: totalTokens,
})
emit('compression.started', {
event: 'compression.started', message_count: msgCount, token_count: totalTokens,
})
try {
const result = await compressor.compress(history, upstream, apiKey, sessionId)
const afterTokens = await calcAndUpdateUsage(sessionId, cState, emit)
const compressedMeta = {
event: 'compression.completed' as const,
compressed: result.meta.compressed,
llmCompressed: result.meta.llmCompressed,
totalMessages: result.meta.totalMessages,
resultMessages: result.messages.length,
beforeTokens: totalTokens,
afterTokens: afterTokens.inputTokens + afterTokens.outputTokens,
summaryTokens: result.meta.summaryTokenEstimate,
verbatimCount: result.meta.verbatimCount,
compressedStartIndex: result.meta.compressedStartIndex,
}
replaceState(sessionMap, sessionId, 'compression.completed', compressedMeta)
logger.info('[context-compress] AFTER session=%s: %d messages, ~%d tokens (was %d)',
sessionId, result.messages.length, afterTokens.inputTokens + afterTokens.outputTokens, totalTokens)
emit('compression.completed', compressedMeta)
const compressed = result.messages.map(m => {
const msg: any = { role: m.role, content: m.content, tool_call_id: m.tool_call_id, name: m.name }
if (m.reasoning_content) msg.reasoning_content = m.reasoning_content
if (m.tool_calls?.length) {
const cleanedToolCalls = m.tool_calls
.filter((tc: any) => tc.id && tc.id.length > 0)
.map((tc: any) => ({ id: tc.id, type: tc.type, function: tc.function }))
if (cleanedToolCalls.length > 0) msg.tool_calls = cleanedToolCalls
}
return msg
})
await calcAndUpdateUsage(sessionId, cState, emit)
return compressed
} catch (err: any) {
const failedMeta = {
event: 'compression.completed' as const,
compressed: false,
totalMessages: msgCount,
resultMessages: msgCount,
beforeTokens: totalTokens,
afterTokens: totalTokens,
summaryTokens: 0,
verbatimCount: msgCount,
compressedStartIndex: -1,
error: err.message,
}
replaceState(sessionMap, sessionId, 'compression.completed', failedMeta)
logger.warn(err, '[chat-run-socket] compression failed for session %s, using assembled context', sessionId)
emit('compression.completed', failedMeta)
return history
}
}
export async function forceCompressBridgeHistory(
sessionId: string,
profile: string,
_messages: ChatMessage[],
getUpstream: (profile: string) => string,
getApiKey: (profile: string) => string | undefined,
): Promise<BridgeCompressionResult> {
const history = await buildDbHistory(sessionId, { excludeLastUser: true })
if (history.length === 0) {
return {
messages: [],
beforeMessages: 0,
resultMessages: 0,
beforeTokens: 0,
afterTokens: 0,
compressed: false,
llmCompressed: false,
summaryTokens: 0,
verbatimCount: 0,
compressedStartIndex: -1,
}
}
const upstream = getUpstream(profile).replace(/\/$/, '')
const apiKey = getApiKey(profile) || undefined
const totalTokens = countTokens(JSON.stringify(history))
bridgeLogger.info({
sessionId,
profile,
historyMessages: history.length,
bridgeProvidedMessages: Array.isArray(_messages) ? _messages.length : 0,
tokenEstimate: totalTokens,
snapshotAware: true,
}, '[chat-run-socket] bridge forced compression started')
const result = await compressor.compress(history, upstream, apiKey, sessionId, profile)
const compressedMessages = result.messages.map(m => {
const msg: any = { role: m.role, content: m.content }
if (m.reasoning_content) msg.reasoning_content = m.reasoning_content
if (m.tool_calls?.length) {
const cleanedToolCalls = m.tool_calls
.filter((tc: any) => tc.id && tc.id.length > 0)
.map((tc: any) => ({ id: tc.id, type: tc.type, function: tc.function }))
if (cleanedToolCalls.length > 0) msg.tool_calls = cleanedToolCalls
}
if (m.tool_call_id) msg.tool_call_id = m.tool_call_id
if (m.name) msg.name = m.name
return msg
})
const afterTokens = countTokens(JSON.stringify(compressedMessages))
bridgeLogger.info({
sessionId,
profile,
beforeMessages: history.length,
resultMessages: result.messages.length,
beforeTokens: totalTokens,
afterTokens,
compressed: result.meta.compressed,
llmCompressed: result.meta.llmCompressed,
verbatimCount: result.meta.verbatimCount,
compressedStartIndex: result.meta.compressedStartIndex,
compressedHistory: result.messages.map((m) => ({
role: m.role,
content: m.content,
reasoning_content: m.reasoning_content,
tool_calls: m.tool_calls,
tool_call_id: m.tool_call_id,
name: m.name,
})),
}, '[chat-run-socket] bridge forced compression completed')
return {
messages: compressedMessages,
beforeMessages: history.length,
resultMessages: compressedMessages.length,
beforeTokens: totalTokens,
afterTokens,
compressed: result.meta.compressed,
llmCompressed: result.meta.llmCompressed,
summaryTokens: result.meta.summaryTokenEstimate,
verbatimCount: result.meta.verbatimCount,
compressedStartIndex: result.meta.compressedStartIndex,
}
}
// --- Shared state helpers (used by compression) ---
export function getOrCreateSession(sessionMap: Map<string, SessionState>, sessionId: string): SessionState {
let state = sessionMap.get(sessionId)
if (!state) {
state = { messages: [], isWorking: false, events: [], queue: [] }
sessionMap.set(sessionId, state)
}
return state
}
export function pushState(sessionMap: Map<string, SessionState>, sessionId: string, event: string, data: any) {
const state = getOrCreateSession(sessionMap, sessionId)
state.events.push({ event, data })
}
export function replaceState(sessionMap: Map<string, SessionState>, sessionId: string, event: string, data: any) {
const state = sessionMap.get(sessionId)
if (state) {
const idx = state.events.findIndex(s => s.event === event)
if (idx >= 0) {
state.events[idx] = { event, data }
return
}
}
pushState(sessionMap, sessionId, event, data)
}
@@ -0,0 +1,56 @@
import type { ContentBlock } from './types'
/**
* Convert ContentBlock[] to string for display/storage
*/
export function contentBlocksToString(input: string | ContentBlock[]): string {
if (typeof input === 'string') return input
return JSON.stringify(input)
}
/**
* Extract text content from ContentBlock[] for title preview
*/
export function extractTextForPreview(input: string | ContentBlock[]): string {
if (typeof input === 'string') return input
return input
.filter(block => block.type === 'text')
.map(block => block.text)
.join('\n')
}
/**
* Check if input is ContentBlock array
*/
export function isContentBlockArray(input: any): input is ContentBlock[] {
return Array.isArray(input) && input.length > 0 && ('type' in input[0])
}
/**
* Convert ContentBlock[] to multimodal format for /v1/responses API.
*/
export async function convertContentBlocks(blocks: ContentBlock[]): Promise<Array<{ type: string; text?: string; image_url?: string }>> {
const parts: Array<{ type: string; text?: string; image_url?: string }> = []
const fs = await import('fs/promises')
const path = await import('path')
for (const block of blocks) {
if (block.type === 'text') {
parts.push({ type: 'input_text', text: block.text })
} else if (block.type === 'image') {
try {
const buf = await fs.readFile(block.path)
const ext = path.extname(block.path).toLowerCase().replace('.', '')
const mime = ext === 'jpg' ? 'jpeg' : ext || 'png'
const base64 = buf.toString('base64')
parts.push({ type: 'input_image', image_url: `data:image/${mime};base64,${base64}` })
} catch {
parts.push({ type: 'input_text', text: `[Image: ${block.path}]` })
}
} else if (block.type === 'file') {
parts.push({ type: 'input_text', text: `[File: ${block.name || block.path}]` })
}
}
return parts
}
@@ -0,0 +1,386 @@
/**
* API Server run handler — handles runs that stream from upstream /v1/responses.
*/
import type { Server, Socket } from 'socket.io'
import { getSystemPrompt } from '../../../lib/llm-prompt'
import {
getSession,
createSession,
addMessage,
updateSessionStats,
getSessionDetailPaginated,
} from '../../../db/hermes/session-store'
import { updateUsage } from '../../../db/hermes/usage-store'
import { logger } from '../../logger'
import { contentBlocksToString, extractTextForPreview, isContentBlockArray, convertContentBlocks } from './content-blocks'
import { convertHistoryFormat } from './message-format'
import { readSseFrames } from './sse-utils'
import { extractResponseText } from './response-utils'
import { applyResponseStreamEvent, flushResponseRunToDb } from './response-stream'
import { buildCompressedHistory, getOrCreateSession } from './compression'
import { calcAndUpdateUsage } from './usage'
import { handleMessage } from './message-format'
import { countTokens, SUMMARY_PREFIX } from '../../../lib/context-compressor'
import { getCompressionSnapshot } from '../../../db/hermes/compression-snapshot'
import type { ContentBlock, SessionState, ChatRunSource } from './types'
export function resolveRunSource(source?: string, sessionId?: string): ChatRunSource {
const normalized = String(source || '').trim()
if (normalized === 'cli') return 'cli'
if (normalized === 'api_server') return 'api_server'
if (sessionId) {
const existing = getSession(sessionId)
if (existing?.source === 'cli') return 'cli'
}
return 'api_server'
}
export async function loadSessionStateFromDb(sid: string, _sessionMap: Map<string, SessionState>): Promise<SessionState> {
try {
const actualDetail = getSessionDetailPaginated(sid)
const messages = actualDetail?.messages ? handleMessage(actualDetail.messages, sid) : []
let inputTokens: number
let outputTokens: number
const snapshot = getCompressionSnapshot(sid)
if (snapshot) {
const newMessages = messages.slice(snapshot.lastMessageIndex + 1)
inputTokens = countTokens(SUMMARY_PREFIX + snapshot.summary) +
newMessages.filter(m => m.role === 'user').reduce((sum, m) => sum + countTokens(m.content || ''), 0)
outputTokens = newMessages
.filter(m => m.role === 'assistant' || m.role === 'tool')
.reduce((sum, m) => sum + countTokens(m.content || '') + countTokens(m.tool_calls + '' || ''), 0)
} else {
inputTokens = messages.filter(m => m.role === 'user').reduce((sum, m) => sum + countTokens(m.content || ''), 0)
outputTokens = messages
.filter(m => m.role === 'assistant' || m.role === 'tool')
.reduce((sum, m) => sum + countTokens(m.content || '') + countTokens(m.tool_calls + '' || ''), 0)
}
logger.info('[chat-run-socket] loaded session %s from DB (%d messages)', sid, messages.length)
return {
messages,
isWorking: false,
events: [],
inputTokens,
outputTokens,
queue: [],
}
} catch (err) {
logger.warn(err, '[chat-run-socket] failed to load session %s from DB', sid)
return { messages: [], isWorking: false, events: [], queue: [] }
}
}
export async function handleApiRun(
nsp: ReturnType<Server['of']>,
socket: Socket,
data: { input: string | ContentBlock[]; session_id?: string; model?: string; instructions?: string; source?: string },
profile: string,
sessionMap: Map<string, SessionState>,
gatewayManager: any,
skipUserMessage = false,
dequeueNextQueuedRun: (socket: Socket, sessionId: string, fallbackProfile?: string) => void,
) {
const { input, session_id, model, instructions } = data
// Build full instructions with system prompt + workspace context
let fullInstructions = instructions
? `${getSystemPrompt()}\n${instructions}`
: getSystemPrompt()
if (session_id) {
const sessionRow = getSession(session_id)
if (sessionRow?.workspace) {
const workspaceCtx = `[Current working directory: ${sessionRow.workspace}]`
fullInstructions = `\n${workspaceCtx}\n${fullInstructions}`
}
}
const upstream = gatewayManager.getUpstream(profile).replace(/\/$/, '')
const apiKey = gatewayManager.getApiKey(profile) || undefined
const runMarker = session_id
? `resp_run_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 8)}`
: undefined
const now = Math.floor(Date.now() / 1000)
if (session_id) {
let state = sessionMap.get(session_id)
if (!state) {
state = getSession(session_id)
? await loadSessionStateFromDb(session_id, sessionMap)
: { messages: [], isWorking: false, events: [], queue: [] }
sessionMap.set(session_id, state)
}
state.isWorking = true
state.profile = profile
state.source = 'api_server'
state.activeRunMarker = runMarker
if (!skipUserMessage) {
const inputStr = contentBlocksToString(input)
state.messages.push({
id: state.messages.length + 1,
session_id,
runMarker,
role: 'user',
content: inputStr,
timestamp: now,
})
if (!getSession(session_id)) {
const previewText = extractTextForPreview(input)
const preview = previewText.replace(/[\r\n]/g, ' ').substring(0, 100)
createSession({ id: session_id, profile, source: 'api_server', model, title: preview })
}
addMessage({
session_id,
role: 'user',
content: inputStr,
timestamp: now,
})
} else {
const inputStr = contentBlocksToString(input)
state.messages.push({
id: state.messages.length + 1,
session_id,
runMarker,
role: 'user',
content: inputStr,
timestamp: now,
})
if (!getSession(session_id)) {
const previewText = extractTextForPreview(input)
const preview = previewText.replace(/[\r\n]/g, ' ').substring(0, 100)
createSession({ id: session_id, profile, source: 'api_server', model, title: preview })
}
addMessage({
session_id,
role: 'user',
content: inputStr,
timestamp: now,
})
}
socket.join(`session:${session_id}`)
}
const emit = (event: string, payload: any) => {
const tagged = session_id ? { ...payload, session_id } : payload
if (session_id) {
nsp.to(`session:${session_id}`).emit(event, tagged)
} else if (socket.connected) {
socket.emit(event, tagged)
}
}
try {
const body: Record<string, any> = { input }
if (model) body.model = model
body.instructions = fullInstructions
if (session_id) {
const compressed = await buildCompressedHistory(session_id, profile, upstream, apiKey, emit, sessionMap)
if (compressed.length > 0) {
body.conversation_history = compressed
}
}
const headers: Record<string, string> = { 'Content-Type': 'application/json' }
if (apiKey) headers['Authorization'] = `Bearer ${apiKey}`
if (isContentBlockArray(input)) {
const parts = await convertContentBlocks(input)
body.input = [{ role: 'user', content: parts }]
}
if (body.conversation_history && Array.isArray(body.conversation_history)) {
body.conversation_history = convertHistoryFormat(body.conversation_history)
}
body.stream = true
body.store = false
const abortController = new AbortController()
if (session_id) {
const state = getOrCreateSession(sessionMap, session_id)
state.isWorking = true
state.runId = undefined
state.abortController = abortController
}
const res = await fetch(`${upstream}/v1/responses`, {
method: 'POST',
headers,
body: JSON.stringify(body),
signal: abortController.signal,
})
if (!res.ok) {
const text = await res.text().catch(() => '')
const queueLen = session_id ? sessionMap.get(session_id)?.queue?.length ?? 0 : 0
if (session_id) await markApiCompleted(nsp, socket, session_id, sessionMap, { event: 'run.failed' })
emit('run.failed', { event: 'run.failed', error: `Upstream ${res.status}: ${text}`, queue_remaining: queueLen })
if (session_id && queueLen > 0) dequeueNextQueuedRun(socket, session_id)
return
}
if (!res.body) {
const queueLen = session_id ? sessionMap.get(session_id)?.queue?.length ?? 0 : 0
if (session_id) await markApiCompleted(nsp, socket, session_id, sessionMap, { event: 'run.failed' })
emit('run.failed', { event: 'run.failed', error: 'Upstream response stream missing', queue_remaining: queueLen })
if (session_id && queueLen > 0) dequeueNextQueuedRun(socket, session_id)
return
}
let responseId: string | undefined
for await (const frame of readSseFrames(res.body)) {
let parsed: any
try {
parsed = JSON.parse(frame.data)
} catch {
continue
}
const upstreamEvent = parsed.type || frame.event || parsed.event
logger.info('[chat-run-socket] upstream response event: %s', upstreamEvent)
if (session_id) {
const state = sessionMap.get(session_id)
if (state) {
const mapped = applyResponseStreamEvent(state, session_id, runMarker, upstreamEvent, parsed)
if (mapped) {
if (mapped.runId) {
responseId = mapped.runId
state.runId = responseId
}
emit(mapped.event, mapped.payload)
}
}
}
if (upstreamEvent === 'response.completed' || upstreamEvent === 'response.failed') {
if (session_id && sessionMap.get(session_id)?.activeRunMarker !== runMarker) {
logger.info({
sessionId: session_id,
runId: responseId,
event: upstreamEvent,
}, '[chat-run-socket] suppressing stale API terminal event')
return
}
if (session_id && sessionMap.get(session_id)?.isAborting) {
logger.info({
sessionId: session_id,
runId: responseId,
event: upstreamEvent,
}, '[chat-run-socket][abort] suppressing upstream terminal event during abort')
return
}
const queueLen = session_id ? sessionMap.get(session_id)?.queue?.length ?? 0 : 0
const nextQueuedRun = session_id && queueLen > 0
? sessionMap.get(session_id)?.queue?.[0]
: undefined
if (session_id) await markApiCompleted(nsp, socket, session_id, sessionMap, {
event: upstreamEvent === 'response.completed' ? 'run.completed' : 'run.failed',
run_id: responseId,
keepWorking: Boolean(nextQueuedRun),
nextSource: nextQueuedRun?.source,
})
const finalOutput = parsed.response || parsed
const finalText = extractResponseText(finalOutput)
if (upstreamEvent === 'response.completed' && session_id) {
const usage = finalOutput.usage || {}
updateUsage(session_id, {
inputTokens: usage.input_tokens ?? usage.inputTokens ?? 0,
outputTokens: usage.output_tokens ?? usage.outputTokens ?? 0,
cacheReadTokens: usage.cache_read_tokens ?? usage.cacheReadTokens ?? 0,
cacheWriteTokens: usage.cache_write_tokens ?? usage.cacheWriteTokens ?? 0,
reasoningTokens: usage.reasoning_tokens ?? usage.reasoningTokens ?? 0,
model: finalOutput.model || '',
profile: sessionMap.get(session_id)?.profile,
})
}
const eventName = upstreamEvent === 'response.completed' ? 'run.completed' : 'run.failed'
emit(eventName, {
event: eventName,
run_id: responseId || finalOutput.id,
response_id: responseId || finalOutput.id,
output: finalText,
usage: finalOutput.usage,
error: finalOutput.error || parsed.error,
queue_remaining: queueLen,
})
if (session_id && queueLen > 0) dequeueNextQueuedRun(socket, session_id)
return
}
}
const queueLen = session_id ? sessionMap.get(session_id)?.queue?.length ?? 0 : 0
if (session_id && sessionMap.get(session_id)?.activeRunMarker !== runMarker) {
logger.info({
sessionId: session_id,
runId: responseId,
}, '[chat-run-socket] suppressing stale API stream end')
return
}
if (session_id) await markApiCompleted(nsp, socket, session_id, sessionMap, { event: 'run.failed', run_id: responseId })
emit('run.failed', {
event: 'run.failed',
run_id: responseId,
response_id: responseId,
error: 'Response stream ended without a terminal event',
queue_remaining: queueLen,
})
if (session_id && queueLen > 0) dequeueNextQueuedRun(socket, session_id)
} catch (err: any) {
const queueLen = session_id ? sessionMap.get(session_id)?.queue?.length ?? 0 : 0
if (session_id) {
const state = sessionMap.get(session_id)
if (state?.activeRunMarker !== runMarker || err?.name === 'AbortError') {
logger.info({
sessionId: session_id,
runMarker,
error: err?.message || String(err),
}, '[chat-run-socket] suppressing stale/aborted API stream error')
return
}
void markApiCompleted(nsp, socket, session_id, sessionMap, { event: 'run.failed' }).then(() => {
emit('run.failed', { event: 'run.failed', error: err.message, queue_remaining: queueLen })
if (queueLen > 0) dequeueNextQueuedRun(socket, session_id)
})
} else {
emit('run.failed', { event: 'run.failed', error: err.message })
}
}
}
async function markApiCompleted(
nsp: ReturnType<Server['of']>,
_socket: Socket,
sessionId: string,
sessionMap: Map<string, SessionState>,
info: { event: string; run_id?: string; keepWorking?: boolean; nextSource?: ChatRunSource },
) {
const state = sessionMap.get(sessionId)
if (state) {
if (state.isAborting) {
logger.info({
sessionId,
runId: state.runId,
}, '[chat-run-socket][abort] terminal upstream event observed; abort handler will finish cleanup')
return
}
state.isWorking = Boolean(info.keepWorking)
state.abortController = undefined
state.runId = undefined
state.events = []
flushResponseRunToDb(state, sessionId)
state.responseRun = undefined
state.activeRunMarker = undefined
if (info.keepWorking) {
state.source = info.nextSource
} else {
state.profile = undefined
}
updateSessionStats(sessionId)
const emit = (event: string, payload: any) => {
nsp.to(`session:${sessionId}`).emit(event, { ...payload, session_id: sessionId })
}
await calcAndUpdateUsage(sessionId, state, emit)
}
}
@@ -0,0 +1,430 @@
/**
* CLI Bridge run handler — handles runs that use the agent bridge
* to communicate with Hermes CLI agent.
*/
import type { Server, Socket } from 'socket.io'
import { getSession, createSession, addMessage, updateSessionStats } from '../../../db/hermes/session-store'
import { updateUsage } from '../../../db/hermes/usage-store'
import { countTokens } from '../../../lib/context-compressor'
import { logger, bridgeLogger } from '../../logger'
import { AgentBridgeClient, type AgentBridgeMessage, type AgentBridgeOutput } from '../agent-bridge'
import { contentBlocksToString, extractTextForPreview } from './content-blocks'
import { buildCompressedHistory } from './compression'
import { pushState, replaceState } from './compression'
import { calcAndUpdateUsage } from './usage'
import {
flushBridgePendingToDb,
ensureOpenBridgeAssistantMessage,
syncBridgeReasoningToMessage,
recordBridgeToolStarted,
recordBridgeToolCompleted,
} from './bridge-message'
import { forceCompressBridgeHistory } from './compression'
import { summarizeToolArguments } from './response-utils'
import { buildDbHistory } from './compression'
import type { ContentBlock, SessionState } from './types'
import type { ChatMessage } from '../../../lib/context-compressor'
const BRIDGE_USAGE_FLUSH_DELAY_MS = 200
export async function handleBridgeRun(
nsp: ReturnType<Server['of']>,
socket: Socket,
data: { input: string | ContentBlock[]; session_id?: string; model?: string; instructions?: string; source?: string },
profile: string,
sessionMap: Map<string, SessionState>,
gatewayManager: any,
bridge: AgentBridgeClient,
_skipUserMessage = false,
loadSessionStateFromDbFn: (sid: string, sessionMap: Map<string, SessionState>) => Promise<SessionState>,
dequeueNextQueuedRun: (socket: Socket, sessionId: string, fallbackProfile?: string) => void,
) {
const { input, session_id, model, instructions } = data
if (!session_id) {
socket.emit('run.failed', { event: 'run.failed', error: 'session_id is required for cli source' })
return
}
const runMarker = `cli_run_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 8)}`
const now = Math.floor(Date.now() / 1000)
let state = sessionMap.get(session_id)
if (!state) {
state = getSession(session_id)
? await loadSessionStateFromDbFn(session_id, sessionMap)
: { messages: [], isWorking: false, events: [], queue: [] }
sessionMap.set(session_id, state)
}
state.isWorking = true
state.isAborting = false
state.profile = profile
state.source = 'cli'
state.activeRunMarker = runMarker
state.runId = undefined
state.abortController = undefined
state.bridgeOutput = ''
state.bridgePendingAssistantContent = ''
state.bridgePendingReasoningContent = ''
state.bridgeToolCounter = 0
state.bridgePendingTools = []
state.responseRun = undefined
const inputStr = contentBlocksToString(input)
state.messages.push({
id: state.messages.length + 1,
session_id,
runMarker,
role: 'user',
content: inputStr,
timestamp: now,
})
if (!getSession(session_id)) {
const previewText = extractTextForPreview(input)
const preview = previewText.replace(/[\r\n]/g, ' ').substring(0, 100)
createSession({ id: session_id, profile, source: 'cli', model, title: preview })
}
addMessage({
session_id,
role: 'user',
content: inputStr,
timestamp: now,
})
socket.join(`session:${session_id}`)
const emit = (event: string, payload: any) => {
const tagged = { ...payload, session_id }
nsp.to(`session:${session_id}`).emit(event, tagged)
if (!nsp.adapter.rooms.get(`session:${session_id}`)?.size && socket.connected) {
socket.emit(event, tagged)
}
}
const history = await buildCompressedHistory(
session_id, profile,
gatewayManager.getUpstream(profile).replace(/\/$/, ''),
gatewayManager.getApiKey(profile) || undefined,
emit,
sessionMap,
)
try {
logger.info('[chat-run-socket] starting CLI bridge run for session %s', session_id)
bridgeLogger.info({
sessionId: session_id,
profile,
inputChars: inputStr.length,
historyMessages: history.length,
hasInstructions: Boolean(instructions),
}, '[chat-run-socket] starting CLI bridge run')
const started = await bridge.chat(session_id, input as AgentBridgeMessage, history, instructions, profile)
state.runId = started.run_id
bridgeLogger.info({
sessionId: session_id,
runId: started.run_id,
status: started.status,
}, '[chat-run-socket] CLI bridge run started')
pushState(sessionMap, session_id, 'run.started', {
event: 'run.started',
run_id: started.run_id,
queue_length: state.queue.length || 0,
})
emit('run.started', {
event: 'run.started',
run_id: started.run_id,
queue_length: state.queue.length || 0,
})
for await (const chunk of bridge.streamOutput(started.run_id)) {
await applyBridgeChunkAsync(nsp, socket, state, session_id, runMarker, chunk, emit, profile, sessionMap, gatewayManager, bridge, dequeueNextQueuedRun)
if (chunk.done) break
}
} catch (err: any) {
if (state.activeRunMarker !== runMarker) return
if (!state.isWorking) return
const queueLen = state.queue?.length ?? 0
state.isWorking = false
state.isAborting = false
state.profile = undefined
state.runId = undefined
state.activeRunMarker = undefined
state.events = []
flushBridgePendingToDb(state, session_id)
updateSessionStats(session_id)
const message = err instanceof Error ? err.message : String(err)
emit('run.failed', { event: 'run.failed', error: message, queue_remaining: queueLen })
const errUsage = await calcAndUpdateUsage(session_id, state, emit)
updateUsage(session_id, {
inputTokens: errUsage.inputTokens,
outputTokens: errUsage.outputTokens,
profile: state.profile,
})
if (queueLen > 0) dequeueNextQueuedRun(socket, session_id)
}
}
async function applyBridgeChunkAsync(
nsp: ReturnType<Server['of']>,
socket: Socket,
state: SessionState,
sessionId: string,
runMarker: string,
chunk: AgentBridgeOutput,
emit: (event: string, payload: any) => void,
profile: string,
sessionMap: Map<string, SessionState>,
gatewayManager: any,
bridge: AgentBridgeClient,
dequeueNextQueuedRun: (socket: Socket, sessionId: string, fallbackProfile?: string) => void,
): Promise<void> {
if (state.activeRunMarker !== runMarker) {
bridgeLogger.info({
sessionId,
runId: chunk.run_id,
runMarker,
activeRunMarker: state.activeRunMarker,
}, '[chat-run-socket] ignoring stale CLI bridge chunk')
return
}
state.runId = chunk.run_id
for (const ev of chunk.events || []) {
const evType = ev.event as string | undefined
if (evType === 'tool.started') {
flushBridgePendingToDb(state, sessionId, runMarker)
const toolName = (ev.tool_name as string) || ''
const args = ev.args as Record<string, unknown> | undefined
const tool = recordBridgeToolStarted(state, sessionId, runMarker, toolName, args, ev.tool_call_id)
const payload = {
event: 'tool.started',
run_id: chunk.run_id,
tool_call_id: tool.id,
tool: toolName,
name: toolName,
arguments: tool.arguments,
preview: ev.preview || summarizeToolArguments(tool.arguments),
}
pushState(sessionMap, sessionId, 'tool.started', payload)
emit('tool.started', payload)
} else if (evType === 'tool.completed') {
const toolName = (ev.tool_name as string) || ''
const completed = recordBridgeToolCompleted(state, sessionId, runMarker, toolName, ev)
const payload = {
event: 'tool.completed',
run_id: chunk.run_id,
tool_call_id: completed.id,
tool: toolName,
name: toolName,
output: completed.output,
duration: completed.duration ?? ev.duration,
error: ev.is_error || undefined,
}
pushState(sessionMap, sessionId, 'tool.completed', payload)
emit('tool.completed', payload)
} else if (evType === 'turn.boundary') {
flushBridgePendingToDb(state, sessionId, runMarker)
} else if (evType === 'reasoning.delta' || evType === 'thinking.delta') {
const text = String(ev.text || '')
if (text) {
state.bridgePendingReasoningContent = (state.bridgePendingReasoningContent || '') + text
const message = ensureOpenBridgeAssistantMessage(state, sessionId, runMarker)
message.reasoning = (message.reasoning || '') + text
message.reasoning_content = (message.reasoning_content || '') + text
}
emit(evType, {
event: evType,
run_id: chunk.run_id,
text,
})
} else if (evType === 'reasoning.available') {
emit('reasoning.available', {
event: 'reasoning.available',
run_id: chunk.run_id,
})
} else if (evType === 'approval.requested') {
const payload = {
event: 'approval.requested',
run_id: chunk.run_id,
approval_id: ev.approval_id,
command: ev.command,
description: ev.description,
choices: ev.choices,
allow_permanent: ev.allow_permanent,
timeout_ms: ev.timeout_ms,
}
replaceState(sessionMap, sessionId, 'approval.requested', payload)
emit('approval.requested', payload)
} else if (evType === 'approval.resolved') {
const payload = {
event: 'approval.resolved',
run_id: chunk.run_id,
approval_id: ev.approval_id,
choice: ev.choice,
}
replaceState(sessionMap, sessionId, 'approval.resolved', payload)
emit('approval.resolved', payload)
} else if (evType === 'bridge.compression.requested') {
const bridgeHistory = await buildDbHistory(sessionId, { excludeLastUser: true })
const tokenCount = bridgeHistory.length > 0
? countTokens(JSON.stringify(bridgeHistory))
: ev.approx_tokens
const payload = {
event: 'compression.started',
run_id: chunk.run_id,
request_id: ev.request_id,
message_count: bridgeHistory.length || ev.message_count,
token_count: tokenCount,
source: 'bridge',
}
replaceState(sessionMap, sessionId, 'compression.started', payload)
emit('compression.started', payload)
if (ev.request_id && Array.isArray(ev.messages)) {
try {
const compressed = await forceCompressBridgeHistory(
sessionId,
profile,
ev.messages as ChatMessage[],
(p: string) => gatewayManager.getUpstream(p),
(p: string) => gatewayManager.getApiKey(p),
)
state.bridgeCompressionResults = state.bridgeCompressionResults || {}
state.bridgeCompressionResults[String(ev.request_id)] = compressed
await bridge.compressionRespond(String(ev.request_id), { messages: compressed.messages })
} catch (err: any) {
await bridge.compressionRespond(String(ev.request_id), {
error: err?.message || String(err),
}).catch(() => undefined)
}
}
} else if (evType === 'bridge.compression.completed') {
const compressionResult = ev.request_id
? state.bridgeCompressionResults?.[String(ev.request_id)]
: undefined
const payload = {
event: 'compression.completed',
run_id: chunk.run_id,
request_id: ev.request_id,
compressed: compressionResult?.compressed ?? ev.compressed !== false,
llmCompressed: compressionResult?.llmCompressed,
totalMessages: compressionResult?.beforeMessages ?? ev.message_count,
resultMessages: compressionResult?.resultMessages ?? ev.result_messages,
beforeTokens: compressionResult?.beforeTokens ?? ev.approx_tokens,
afterTokens: compressionResult?.afterTokens,
summaryTokens: compressionResult?.summaryTokens,
verbatimCount: compressionResult?.verbatimCount,
compressedStartIndex: compressionResult?.compressedStartIndex,
source: 'bridge',
}
if (ev.request_id && state.bridgeCompressionResults) {
delete state.bridgeCompressionResults[String(ev.request_id)]
}
replaceState(sessionMap, sessionId, 'compression.completed', payload)
emit('compression.completed', payload)
await calcAndUpdateUsage(sessionId, state, emit)
} else if (evType === 'bridge.compression.failed') {
const payload = {
event: 'compression.completed',
run_id: chunk.run_id,
request_id: ev.request_id,
compressed: false,
totalMessages: ev.message_count,
resultMessages: ev.message_count,
beforeTokens: ev.approx_tokens,
error: ev.error,
source: 'bridge',
}
if (ev.request_id && state.bridgeCompressionResults) {
delete state.bridgeCompressionResults[String(ev.request_id)]
}
replaceState(sessionMap, sessionId, 'compression.completed', payload)
emit('compression.completed', payload)
} else if (evType === 'status') {
emit('agent.event', {
event: 'agent.event',
run_id: chunk.run_id,
...ev,
})
}
}
if (chunk.delta) {
state.bridgeOutput = (state.bridgeOutput || '') + chunk.delta
state.bridgePendingAssistantContent = (state.bridgePendingAssistantContent || '') + chunk.delta
const last = [...state.messages].reverse().find(m => m.runMarker === runMarker)
if (last?.role === 'assistant' && last.finish_reason == null) {
last.content += chunk.delta
syncBridgeReasoningToMessage(last, state.bridgePendingReasoningContent)
} else {
state.messages.push({
id: state.messages.length + 1,
session_id: sessionId,
runMarker,
role: 'assistant',
content: chunk.delta,
reasoning: state.bridgePendingReasoningContent || null,
reasoning_content: state.bridgePendingReasoningContent || null,
timestamp: Math.floor(Date.now() / 1000),
})
}
emit('message.delta', {
event: 'message.delta',
run_id: chunk.run_id,
delta: chunk.delta,
output: state.bridgeOutput,
})
}
if (!chunk.done) return
if (!state.isWorking) return
if (state.isAborting) {
bridgeLogger.info({
sessionId,
runId: chunk.run_id,
status: chunk.status,
}, '[chat-run-socket][abort] suppressing CLI bridge terminal chunk during abort')
return
}
flushBridgePendingToDb(state, sessionId)
updateSessionStats(sessionId)
await delay(BRIDGE_USAGE_FLUSH_DELAY_MS)
const usage = await calcAndUpdateUsage(sessionId, state, emit)
updateUsage(sessionId, {
inputTokens: usage.inputTokens,
outputTokens: usage.outputTokens,
profile: state.profile,
})
const nextQueuedRun = state.queue.length > 0 ? state.queue[0] : undefined
state.isWorking = Boolean(nextQueuedRun)
state.isAborting = false
if (nextQueuedRun) {
state.profile = nextQueuedRun.profile || profile
state.source = nextQueuedRun.source
} else {
state.profile = undefined
}
state.runId = undefined
state.activeRunMarker = undefined
state.events = []
const eventName = chunk.status === 'error' ? 'run.failed' : 'run.completed'
const payload = {
event: eventName,
run_id: chunk.run_id,
output: chunk.output || state.bridgeOutput || '',
result: chunk.result,
error: chunk.error,
inputTokens: usage.inputTokens,
outputTokens: usage.outputTokens,
queue_remaining: state.queue.length,
}
emit(eventName, payload)
if (state.queue.length > 0) {
dequeueNextQueuedRun(socket, sessionId)
}
}
function delay(ms: number): Promise<void> {
return new Promise(resolve => setTimeout(resolve, ms))
}
@@ -0,0 +1,277 @@
/**
* ChatRunSocket — Socket.IO namespace /chat-run.
*
* Thin orchestrator that delegates to specialized modules:
* - handle-api-run.ts → upstream /v1/responses streaming
* - handle-bridge-run.ts → CLI bridge runs
* - abort.ts → run cancellation
* - compression.ts → context window management
*/
import type { Server, Socket } from 'socket.io'
import { logger } from '../../logger'
import { getSystemPrompt } from '../../../lib/llm-prompt'
import { getSession } from '../../../db/hermes/session-store'
import { getActiveProfileName } from '../hermes-profile'
import { AgentBridgeClient } from '../agent-bridge'
import { handleApiRun, resolveRunSource, loadSessionStateFromDb } from './handle-api-run'
import { handleBridgeRun } from './handle-bridge-run'
import { handleAbort } from './abort'
import { getOrCreateSession } from './compression'
import type { ContentBlock, QueuedRun, SessionState } from './types'
export type { ContentBlock } from './types'
export class ChatRunSocket {
private nsp: ReturnType<Server['of']>
private gatewayManager: any
private bridge = new AgentBridgeClient()
/** sessionId → session state (messages, working status, events, run tracking) */
private sessionMap = new Map<string, SessionState>()
constructor(io: Server, gatewayManager: any) {
this.nsp = io.of('/chat-run')
this.gatewayManager = gatewayManager
}
init() {
this.nsp.use(this.authMiddleware.bind(this))
this.nsp.on('connection', this.onConnection.bind(this))
logger.info('[chat-run-socket] Socket.IO ready at /chat-run')
}
// --- Auth middleware ---
private async authMiddleware(socket: Socket, next: (err?: Error) => void) {
const token = socket.handshake.auth?.token as string | undefined
if (!process.env.AUTH_DISABLED && process.env.AUTH_DISABLED !== '1') {
const { getToken } = await import('../../auth')
const serverToken = await getToken()
if (serverToken && token !== serverToken) {
return next(new Error('Authentication failed'))
}
}
next()
}
// --- Connection handler ---
private onConnection(socket: Socket) {
const socketProfile = (socket.handshake.query?.profile as string) || 'default'
const currentProfile = () => getActiveProfileName() || socketProfile || 'default'
socket.on('run', async (data: {
input: string | ContentBlock[]
session_id?: string
model?: string
instructions?: string
queue_id?: string
source?: string
}) => {
if (data.session_id) {
const state = getOrCreateSession(this.sessionMap, data.session_id)
if (state.isWorking) {
state.queue.push({
queue_id: data.queue_id || `queue_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 8)}`,
input: data.input,
model: data.model,
instructions: data.instructions,
profile: currentProfile(),
source: resolveRunSource(data.source, data.session_id),
})
this.nsp.to(`session:${data.session_id}`).emit('run.queued', {
event: 'run.queued',
session_id: data.session_id,
queue_length: state.queue.length,
})
logger.info('[chat-run-socket] queued run for session %s (queue: %d)', data.session_id, state.queue.length)
return
}
state.isWorking = true
state.profile = currentProfile()
state.source = resolveRunSource(data.source, data.session_id)
}
try {
await this.handleRun(socket, data, currentProfile())
} catch (err) {
if (data.session_id) {
const state = this.sessionMap.get(data.session_id)
if (state && !state.runId && !state.abortController && !state.activeRunMarker) {
state.isWorking = false
state.profile = undefined
}
}
socket.emit('run.failed', {
event: 'run.failed',
session_id: data.session_id,
error: err instanceof Error ? err.message : String(err),
})
}
})
socket.on('cancel_queued_run', (data: { session_id?: string; queue_id?: string }) => {
if (!data.session_id || !data.queue_id) return
const state = this.sessionMap.get(data.session_id)
if (!state?.queue.length) return
const before = state.queue.length
state.queue = state.queue.filter(item => item.queue_id !== data.queue_id)
if (state.queue.length === before) return
this.nsp.to(`session:${data.session_id}`).emit('run.queued', {
event: 'run.queued',
session_id: data.session_id,
queue_length: state.queue.length,
})
logger.info('[chat-run-socket] cancelled queued run %s for session %s (queue: %d)',
data.queue_id, data.session_id, state.queue.length)
})
socket.on('resume', async (data: { session_id?: string }) => {
if (!data.session_id) return
const sid = data.session_id
socket.join(`session:${sid}`)
this.resumeSession(socket, sid)
})
socket.on('abort', (data: { session_id?: string }) => {
if (data.session_id) {
void handleAbort(this.nsp, socket, data.session_id, this.sessionMap, this.bridge, this.runQueuedItem.bind(this))
}
})
socket.on('approval.respond', async (data: { session_id?: string; approval_id?: string; choice?: string }) => {
if (!data.session_id || !data.approval_id) return
try {
const result = await this.bridge.approvalRespond(data.approval_id, data.choice || 'deny')
this.emitToSession(socket, data.session_id, 'approval.resolved', {
event: 'approval.resolved',
approval_id: data.approval_id,
choice: data.choice || 'deny',
resolved: Boolean(result.resolved),
})
} catch (err) {
this.emitToSession(socket, data.session_id, 'approval.resolved', {
event: 'approval.resolved',
approval_id: data.approval_id,
choice: data.choice || 'deny',
resolved: false,
error: err instanceof Error ? err.message : String(err),
})
}
})
}
// --- Run dispatcher ---
private async handleRun(
socket: Socket,
data: { input: string | ContentBlock[]; session_id?: string; model?: string; instructions?: string; source?: string },
profile: string,
skipUserMessage = false,
) {
const source = resolveRunSource(data.source, data.session_id)
if (source === 'cli') {
let fullInstructions = data.instructions
? `${getSystemPrompt()}\n${data.instructions}`
: getSystemPrompt()
if (data.session_id) {
const sessionRow = getSession(data.session_id)
if (sessionRow?.workspace) {
const workspaceCtx = `[Current working directory: ${sessionRow.workspace}]`
fullInstructions = `\n${workspaceCtx}\n${fullInstructions}`
}
}
await handleBridgeRun(
this.nsp, socket, { ...data, instructions: fullInstructions }, profile,
this.sessionMap, this.gatewayManager, this.bridge,
skipUserMessage,
loadSessionStateFromDb,
this.dequeueNextQueuedRun.bind(this),
)
return
}
await handleApiRun(
this.nsp, socket, data, profile,
this.sessionMap, this.gatewayManager,
skipUserMessage,
this.dequeueNextQueuedRun.bind(this),
)
}
// --- Resume ---
private async resumeSession(socket: Socket, sid: string) {
let state = this.sessionMap.get(sid)
if (!state) {
state = await loadSessionStateFromDb(sid, this.sessionMap)
this.sessionMap.set(sid, state)
}
socket.emit('resumed', {
session_id: sid,
messages: state.messages,
isWorking: state.isWorking,
isAborting: state.isAborting || false,
events: state.isWorking ? state.events : [],
inputTokens: state.inputTokens,
outputTokens: state.outputTokens,
queueLength: state.queue?.length || 0,
})
logger.info('[chat-run-socket] socket %s resumed session %s (working: %s, messages: %d)',
socket.id, sid, state.isWorking, state.messages.length)
}
// --- Queue ---
private dequeueNextQueuedRun(socket: Socket, sessionId: string, fallbackProfile = 'default') {
const state = this.sessionMap.get(sessionId)
if (!state?.queue.length) return false
const next = state.queue.shift()!
logger.info('[chat-run-socket] dequeuing queued run for session %s (remaining: %d)', sessionId, state.queue.length)
this.nsp.to(`session:${sessionId}`).emit('run.queued', {
event: 'run.queued',
session_id: sessionId,
queue_length: state.queue.length,
})
this.runQueuedItem(socket, sessionId, next, fallbackProfile)
return true
}
private runQueuedItem(socket: Socket, sessionId: string, next: QueuedRun, fallbackProfile = 'default') {
void this.handleRun(socket, {
input: next.input,
session_id: sessionId,
model: next.model,
instructions: next.instructions,
source: next.source,
}, next.profile || fallbackProfile, true)
}
// --- Helpers ---
private emitToSession(socket: Socket, sessionId: string, event: string, payload: any) {
const tagged = { ...payload, session_id: sessionId }
this.nsp.to(`session:${sessionId}`).emit(event, tagged)
if (!this.nsp.adapter.rooms.get(`session:${sessionId}`)?.size && socket.connected) {
socket.emit(event, tagged)
}
}
/** Close all active upstream response streams */
close() {
for (const [sessionId, state] of this.sessionMap.entries()) {
if (state.abortController) {
try {
state.abortController.abort()
} catch (e) {
logger.warn(e, '[chat-run-socket] failed to abort controller for session %s', sessionId)
}
}
}
this.sessionMap.clear()
logger.info('[chat-run-socket] closed all connections and cleared state')
}
}
@@ -0,0 +1,162 @@
import { parseAnthropicContentArray } from '../../../lib/llm-json'
import { logger } from '../../logger'
import type { SessionMessage } from './types'
/**
* Convert OpenAI format conversation history to Anthropic format.
*/
export function convertHistoryFormat(messages: any[]): any[] {
const result: any[] = []
for (const m of messages) {
const role = m.role
const content = m.content || ''
delete m.reasoning_content
if (role === 'tool') {
let pushItem = { ...m }
pushItem.role = 'user'
pushItem.content = `[Tool result: ${content}]`
result.push(pushItem)
continue
}
if (role === 'user') {
if (typeof content === 'string') {
result.push({ role: 'user', content: content })
} else if (Array.isArray(content)) {
const textParts = content
.filter((b: any) => b.type === 'text')
.map((b: any) => b.text)
.join('\n')
result.push({ role: 'user', content: textParts || JSON.stringify(content) })
}
continue
}
if (role === 'assistant') {
result.push({ ...m })
continue
}
}
return result
}
/**
* Process raw DB messages into client-ready format.
* Parses Anthropic content blocks, reconstructs tool_call_ids, etc.
*/
export function handleMessage(messages: SessionMessage[], sid: string): any[] {
let _messages = []
try {
_messages = messages
.filter(m => (m.role === 'user' || m.role === 'assistant' || m.role === 'tool') && m.content !== undefined)
.map((m, idx, arr) => {
const msg: any = {
id: m.id,
session_id: sid,
role: m.role,
content: m.content || '',
reasoning: m.reasoning || '',
timestamp: m.timestamp,
}
// Convert Anthropic format content to OpenAI format
if (m.role === 'assistant' && typeof m.content === 'string') {
let contentToParse = m.content
const trimmed = m.content.trim()
if (trimmed.startsWith('"') && trimmed.endsWith('"') && trimmed.length >= 2) {
contentToParse = trimmed.slice(1, -1)
logger.info('[chat-run-socket] resume message %s: double-serialized, removed outer quotes', m.id)
}
if (contentToParse.startsWith('[') && contentToParse.endsWith(']')) {
try {
const parsedContent = parseAnthropicContentArray(contentToParse)
const textBlocks: string[] = []
const toolCalls: any[] = []
let reasoningContent: string | null = null
for (const block of parsedContent) {
if (block.type === 'thinking') {
reasoningContent = block.thinking || null
} else if (block.type === 'text') {
textBlocks.push(block.text || '')
} else if (block.type === 'tool_use') {
toolCalls.push({
id: block.id,
type: 'function',
function: {
name: block.name,
arguments: typeof block.input === 'object' ? JSON.stringify(block.input) : (block.input ?? '{}'),
},
})
}
}
msg.content = textBlocks.join('') || ''
if (toolCalls.length > 0) msg.tool_calls = toolCalls
if (reasoningContent) msg.reasoning = reasoningContent
} catch (e) {
logger.warn(e, '[chat-run-socket] failed to parse array content for message %s, keeping original', m.id)
msg.content = m.content
}
}
} else if (Array.isArray(m.content)) {
const textBlocks: string[] = []
const toolCalls: any[] = []
let reasoningContent: string | null = null
for (const block of m.content) {
if (block.type === 'thinking') {
reasoningContent = block.thinking
} else if (block.type === 'text') {
textBlocks.push(block.text)
} else if (block.type === 'tool_use') {
toolCalls.push({
id: block.id,
type: 'function',
function: {
name: block.name,
arguments: JSON.stringify(block.input ?? {}),
},
})
}
}
msg.content = textBlocks.join('') || ''
if (toolCalls.length > 0) msg.tool_calls = toolCalls
if (reasoningContent) msg.reasoning = reasoningContent
}
if (m.tool_calls?.length) {
const cleanedToolCalls = m.tool_calls
.filter((tc: any) => tc.id && tc.id.length > 0)
.map((tc: any) => ({
id: tc.id,
type: tc.type,
function: tc.function,
}))
if (cleanedToolCalls.length > 0) msg.tool_calls = cleanedToolCalls
}
// For tool messages, ensure tool_call_id exists
if (m.role === 'tool') {
let callId = m.tool_call_id
if (!callId || callId.length === 0) {
const prevMsg = arr[idx - 1]
if (prevMsg?.role === 'assistant' && prevMsg.tool_calls?.length) {
const tc = prevMsg.tool_calls.find((t: any) => t.function?.name === m.tool_name)
if (tc?.id) callId = tc.id
}
}
if (!callId || callId.length === 0) return null
msg.tool_call_id = callId
}
if (m.tool_name) msg.tool_name = m.tool_name
if (m.reasoning) msg.reasoning = m.reasoning
return msg
})
.filter(m => m !== null)
} catch (error) {
}
return _messages
}
@@ -0,0 +1,210 @@
/**
* Response stream event handling — maps upstream /v1/responses events
* to client-facing events and updates in-memory session state.
*/
import { addMessage } from '../../../db/hermes/session-store'
import { logger } from '../../logger'
import { summarizeToolArguments, responseFunctionCallToToolCall } from './response-utils'
import type { SessionState, ResponseRunState } from './types'
export function applyResponseStreamEvent(
state: SessionState,
sessionId: string,
runMarker: string | undefined,
eventType: string,
parsed: any,
): { event: string; payload: any; runId?: string } | null {
const run = getResponseRunState(state, runMarker)
const now = () => Math.floor(Date.now() / 1000)
if (eventType === 'response.created') {
const response = parsed.response || parsed
run.responseId = response.id || run.responseId
return {
event: 'run.started',
runId: run.responseId,
payload: {
event: 'run.started',
run_id: run.responseId,
response_id: run.responseId,
status: response.status || 'in_progress',
queue_length: state.queue.length || 0,
},
}
}
if (eventType === 'response.output_text.delta') {
const deltaText = parsed.delta || parsed.text || ''
if (!deltaText) return null
const last = [...state.messages].reverse().find(m => m.runMarker === runMarker)
if (last?.role === 'assistant' && last.finish_reason == null && !last.tool_calls?.length) {
last.content += deltaText
} else {
state.messages.push({
id: state.messages.length + 1,
session_id: sessionId,
runMarker,
role: 'assistant',
content: deltaText,
timestamp: now(),
})
}
return {
event: 'message.delta',
payload: {
event: 'message.delta',
run_id: run.responseId,
response_id: run.responseId,
delta: deltaText,
},
}
}
if (eventType === 'response.output_text.done') {
const last = [...state.messages].reverse().find(m => m.runMarker === runMarker)
if (last?.role === 'assistant' && last.finish_reason == null) {
last.finish_reason = 'stop'
}
return null
}
if (eventType === 'response.output_item.added') {
const item = parsed.item || parsed.output_item || parsed
if (item.type !== 'function_call') return null
const callId = item.call_id || item.id
if (!callId) return null
const toolCall = responseFunctionCallToToolCall(item)
run.toolCalls.set(callId, { ...toolCall, startedAt: Date.now() })
return {
event: 'tool.started',
payload: {
event: 'tool.started',
run_id: run.responseId,
response_id: run.responseId,
tool_call_id: callId,
tool: toolCall.function.name,
name: toolCall.function.name,
arguments: toolCall.function.arguments,
preview: summarizeToolArguments(toolCall.function.arguments),
},
}
}
if (eventType === 'response.output_item.done') {
const item = parsed.item || parsed.output_item || parsed
if (item.type === 'function_call') {
const callId = item.call_id || item.id
if (!callId) return null
const toolCall = responseFunctionCallToToolCall(item)
const existing = run.toolCalls.get(callId)
run.toolCalls.set(callId, { ...toolCall, startedAt: existing?.startedAt || Date.now() })
const key = `assistant:${callId}`
if (!run.insertedKeys.has(key)) {
run.insertedKeys.add(key)
state.messages.push({
id: state.messages.length + 1,
session_id: sessionId,
runMarker,
role: 'assistant',
content: '',
tool_calls: [toolCall],
finish_reason: 'tool_calls',
timestamp: now(),
})
}
return null
}
if (item.type === 'function_call_output') {
const callId = item.call_id || item.id
if (!callId) return null
const key = `tool:${callId}`
const output = typeof item.output === 'string' ? item.output : JSON.stringify(item.output ?? '')
const toolCallEntry = run.toolCalls.get(callId)
const toolName = toolCallEntry?.function?.name || null
const startedAt = toolCallEntry?.startedAt
const duration = startedAt ? Math.round((Date.now() - startedAt) / 10) / 100 : undefined
const hasError = typeof item.output === 'string' && item.output.startsWith('Error')
if (!run.insertedKeys.has(key)) {
run.insertedKeys.add(key)
state.messages.push({
id: state.messages.length + 1,
session_id: sessionId,
runMarker,
role: 'tool',
content: output,
tool_call_id: callId,
tool_name: toolName,
timestamp: now(),
})
}
return {
event: 'tool.completed',
payload: {
event: 'tool.completed',
run_id: run.responseId,
response_id: run.responseId,
tool_call_id: callId,
tool: toolName,
name: toolName,
output,
duration,
error: hasError || undefined,
},
}
}
}
if (eventType === 'response.completed') {
const response = parsed.response || parsed
run.responseId = response.id || run.responseId
const output = Array.isArray(response.output) ? response.output : []
for (const item of output) {
if (item.type === 'function_call') {
applyResponseStreamEvent(state, sessionId, runMarker, 'response.output_item.added', { item })
applyResponseStreamEvent(state, sessionId, runMarker, 'response.output_item.done', { item })
} else if (item.type === 'function_call_output') {
applyResponseStreamEvent(state, sessionId, runMarker, 'response.output_item.done', { item })
}
}
}
return null
}
export function getResponseRunState(state: SessionState, runMarker?: string): ResponseRunState {
if (!state.responseRun || state.responseRun.runMarker !== runMarker) {
state.responseRun = {
runMarker,
insertedKeys: new Set<string>(),
toolCalls: new Map<string, any>(),
}
}
return state.responseRun
}
/** Flush all non-user messages for this run to DB in order. */
export function flushResponseRunToDb(state: SessionState, sessionId: string) {
const run = state.responseRun
if (!run?.runMarker) return
let flushed = 0
for (const msg of state.messages) {
if (msg.runMarker !== run.runMarker) continue
if (msg.role === 'user') continue
addMessage({
session_id: sessionId,
role: msg.role,
content: msg.content || '',
tool_call_id: msg.tool_call_id ?? null,
tool_calls: msg.tool_calls ?? null,
tool_name: msg.tool_name ?? null,
finish_reason: msg.finish_reason ?? null,
timestamp: msg.timestamp,
})
flushed++
}
logger.info('[chat-run-socket] flushResponseRunToDb: flushed %d messages for session %s', flushed, sessionId)
}
@@ -0,0 +1,56 @@
/**
* Response utility functions for processing upstream API responses.
*/
export function responseFunctionCallToToolCall(item: any): any {
const callId = item.call_id || item.id || ''
const name = item.name || item.function?.name || ''
let args = item.arguments ?? item.function?.arguments ?? '{}'
if (typeof args !== 'string') {
args = JSON.stringify(args ?? {})
}
return {
id: callId,
type: 'function',
function: {
name,
arguments: args || '{}',
},
}
}
export function summarizeToolArguments(args: string): string | undefined {
if (!args) return undefined
try {
const parsed = JSON.parse(args)
if (!parsed || typeof parsed !== 'object') return args.slice(0, 120)
const preferredKeys = ['cmd', 'command', 'code', 'query', 'path', 'url', 'prompt']
for (const key of preferredKeys) {
const value = parsed[key]
if (typeof value === 'string' && value.trim()) {
return value.replace(/\s+/g, ' ').slice(0, 160)
}
}
const first = Object.entries(parsed).find(([, value]) => typeof value === 'string' && value.trim())
if (first) return String(first[1]).replace(/\s+/g, ' ').slice(0, 160)
return JSON.stringify(parsed).slice(0, 160)
} catch {
return args.replace(/\s+/g, ' ').slice(0, 160)
}
}
export function extractResponseText(response: any): string {
const output = Array.isArray(response?.output) ? response.output : []
const parts: string[] = []
for (const item of output) {
if (item.type !== 'message') continue
const content = Array.isArray(item.content) ? item.content : []
for (const part of content) {
if (part.type === 'output_text' || part.type === 'text') {
parts.push(part.text || '')
}
}
}
if (parts.length > 0) return parts.join('')
return typeof response?.output_text === 'string' ? response.output_text : ''
}
@@ -0,0 +1,47 @@
/**
* SSE frame reading utilities for parsing upstream streaming responses.
*/
export async function* readSseFrames(stream: ReadableStream<Uint8Array>): AsyncGenerator<{ event?: string; data: string }> {
const decoder = new TextDecoder()
const reader = stream.getReader()
let buffer = ''
try {
while (true) {
const { done, value } = await reader.read()
if (done) break
buffer += decoder.decode(value, { stream: true })
let boundary = buffer.indexOf('\n\n')
while (boundary >= 0) {
const raw = buffer.slice(0, boundary)
buffer = buffer.slice(boundary + 2)
const frame = parseSseFrame(raw)
if (frame?.data) yield frame
boundary = buffer.indexOf('\n\n')
}
}
buffer += decoder.decode()
const frame = parseSseFrame(buffer)
if (frame?.data) yield frame
} finally {
reader.releaseLock()
}
}
export function parseSseFrame(raw: string): { event?: string; data: string } | null {
let event: string | undefined
const data: string[] = []
for (const line of raw.split(/\r?\n/)) {
if (!line || line.startsWith(':')) continue
if (line.startsWith('event:')) {
event = line.slice(6).trim()
} else if (line.startsWith('data:')) {
data.push(line.slice(5).trimStart())
}
}
if (data.length === 0) return null
return { event, data: data.join('\n') }
}
@@ -0,0 +1,84 @@
import type { ChatMessage } from '../../../lib/context-compressor'
/**
* Content block types for Anthropic-compatible message format
*/
export type ContentBlock =
| { type: 'text'; text: string }
| { type: 'image'; name: string; path: string; media_type: string }
| { type: 'file'; name: string; path: string; media_type?: string }
export interface SessionMessage {
id: number | string
session_id: string
role: string
content: string
runMarker?: string
tool_call_id?: string | null
tool_calls?: any[] | null
tool_name?: string | null
timestamp: number
token_count?: number | null
finish_reason?: string | null
reasoning?: string | null
reasoning_details?: string | null
reasoning_content?: string | null
}
export interface QueuedRun {
queue_id: string
input: string | ContentBlock[]
model?: string
instructions?: string
profile: string
source?: ChatRunSource
}
export interface SessionState {
messages: SessionMessage[]
isWorking: boolean
events: Array<{ event: string; data: any }>
abortController?: AbortController
runId?: string
activeRunMarker?: string
profile?: string
inputTokens?: number
outputTokens?: number
isAborting?: boolean
queue: QueuedRun[]
responseRun?: ResponseRunState
source?: ChatRunSource
bridgePendingAssistantContent?: string
bridgePendingReasoningContent?: string
bridgeOutput?: string
bridgeToolCounter?: number
bridgePendingTools?: Array<{
id: string
name: string
arguments: string
startedAt: number
}>
bridgeCompressionResults?: Record<string, BridgeCompressionResult>
}
export interface ResponseRunState {
runMarker?: string
responseId?: string
insertedKeys: Set<string>
toolCalls: Map<string, any>
}
export type ChatRunSource = 'api_server' | 'cli'
export interface BridgeCompressionResult {
messages: ChatMessage[]
beforeMessages: number
resultMessages: number
beforeTokens: number
afterTokens: number
compressed: boolean
llmCompressed: boolean
summaryTokens: number
verbatimCount: number
compressedStartIndex: number
}
@@ -0,0 +1,53 @@
/**
* Usage calculation — token counting from DB messages,
* snapshot-aware computation, client notification.
*/
import {
getSessionDetail,
} from '../../../db/hermes/session-store'
import { getCompressionSnapshot } from '../../../db/hermes/compression-snapshot'
import { countTokens, SUMMARY_PREFIX } from '../../../lib/context-compressor'
import { logger } from '../../logger'
import type { SessionState } from './types'
export async function calcAndUpdateUsage(
sid: string,
state: SessionState,
emit: (event: string, payload: any) => void,
): Promise<{ inputTokens: number; outputTokens: number }> {
try {
const detail = getSessionDetail(sid)
const msgs = detail?.messages
?.filter(m => m.role === 'user' || m.role === 'assistant' || m.role === 'tool') || []
const snapshot = getCompressionSnapshot(sid)
let inputTokens: number
let outputTokens: number
if (snapshot && msgs.length) {
const newMessages = msgs.slice(snapshot.lastMessageIndex + 1)
inputTokens = countTokens(SUMMARY_PREFIX + snapshot.summary) +
newMessages.filter(m => m.role === 'user').reduce((sum, m) => sum + countTokens(m.content || ''), 0)
outputTokens = newMessages
.filter(m => m.role === 'assistant' || m.role === 'tool')
.reduce((sum, m) => sum + countTokens(m.content || '') + countTokens(m.tool_calls + '' || ''), 0)
} else {
inputTokens = msgs.filter(m => m.role === 'user').reduce((sum, m) => sum + countTokens(m.content || ''), 0)
outputTokens = msgs
.filter(m => m.role === 'assistant' || m.role === 'tool')
.reduce((sum, m) => sum + countTokens(m.content || '') + countTokens(m.tool_calls + '' || ''), 0)
}
state.inputTokens = inputTokens
state.outputTokens = outputTokens
emit('usage.updated', {
event: 'usage.updated',
session_id: sid,
inputTokens,
outputTokens,
})
return { inputTokens, outputTokens }
} catch (err: any) {
logger.warn(err, '[chat-run-socket] failed to calculate usage for session %s', sid)
return { inputTokens: 0, outputTokens: 0 }
}
}