v0.19.8 Release Notes

Released 2026-04-25

v0.19.7 -> v0.19.8

Summary

Session lifecycle observability and resource control: per-session concurrency cap (default 3, hard cap 10, env MAX_SESSION_TASKS) plus two new endpoints — GET /v1/session/:session_id/status (reads status.json for online/idle state and active task list) and GET /v1/session/:session_id/log (SSE-streams action.log by polling the trailing 100 lines once per second with last-line dedup, : ping heartbeat after 15 quiet ticks); a per-session action.log records user input and key tool/error events for human audit (1 MB rotation, never enters ToriiDB/embedder); configurable timeouts for invoke_subagent (MAX_SUBAGENT_TIMEOUT_MIN) and external CLI agents (MAX_EXTERNAL_AGENT_TIMEOUT_MIN), default 10 min, hard cap 60; and a fix that allows invoke_subagent to resume an existing persistent session by id (existence-checked, no auto-create).

翻譯

Session 生命週期可觀測性與資源控制：每 session 併發上限（預設 3、硬上限 10，env MAX_SESSION_TASKS）並新增兩支端點 — GET /v1/session/:session_id/status（讀 status.json 提供 online／idle 狀態與進行中任務清單）與 GET /v1/session/:session_id/log（SSE 串流 action.log：每秒讀尾端 100 行、以 last-line 比對去重，連續 15 tick 無事件送 : ping heartbeat）；每 session action.log 紀錄使用者輸入與關鍵 tool／錯誤事件供人工稽核（1 MB rotation，不進 ToriiDB／embedder）；invoke_subagent（MAX_SUBAGENT_TIMEOUT_MIN）與外部 CLI agent（MAX_EXTERNAL_AGENT_TIMEOUT_MIN）超時改為 env 可調，預設 10 分鐘、硬上限 60 分鐘；並修正 invoke_subagent 支援以 session id 續用既有持久化 session（已存在性檢查、不自動建立）。

Changes

FIX

• Support persistent session_id for invoke_subagent (@pardnchiu) [deb674e]

翻譯

• 修正 invoke_subagent 以非空 session_id 續用既有持久化 session（不存在直接 error，不自動建立）

UPDATE

• Add session concurrency limit and status endpoint (@pardnchiu) [215fbfa]
• Add configurable timeout settings for subagent and external agent (@pardnchiu) [16945d8]
• Stream session action.log via SSE endpoint with tail-100 polling (@pardnchiu) [staged]

翻譯

• 新增每 session 併發上限與 GET /v1/session/:session_id/status 端點
• subagent 與外部 agent 超時改為 env 可調（預設 10 分鐘、硬上限 60 分鐘）
• 新增 GET /v1/session/:session_id/log SSE 端點，每秒輪詢 action.log 尾端 100 行並推播新增行

ADD

• Add session action logs for tool and user events (@pardnchiu) [a78ae4e]

翻譯

• 每 session 新增 action.log 紀錄 user 輸入與 tool／錯誤事件（純檔案、不進 DB／embedder）

Scope

• internal/session/concurrent.go — ADD (per-session concurrency slots, buffered channel pattern)
• internal/session/status.go — ADD (per-session status.json with online/idle state and active task list)
• internal/session/actionLog.go — ADD (per-session action.log with 1 MB rotation), UPDATE (ReadRecord tail-N reader for SSE consumers)
• internal/routes/handler/status.go — ADD (GET /v1/session/:session_id/status handler)
• internal/routes/handler/log.go — ADD (GET /v1/session/:session_id/log SSE handler with tail-100 polling and last-line dedup)
• internal/routes/new.go — UPDATE (mount status and log endpoints)
• internal/agents/exec/execute.go — UPDATE (concurrency Enter/Leave hooks, Online/Idle, action.log events tee)
• internal/agents/exec/execWithSubagent.go — UPDATE (MAX_SUBAGENT_TIMEOUT_MIN, persistent session_id existence check)
• internal/agents/external/external.go — UPDATE (MAX_EXTERNAL_AGENT_TIMEOUT_MIN)
• internal/tools/agent/subagent/invokeSubagent.go — FIX (forward session_id to exec layer)
• .env.example — CHORE (document MAX_SESSION_TASKS / MAX_SUBAGENT_TIMEOUT_MIN / MAX_EXTERNAL_AGENT_TIMEOUT_MIN)

---

Version Mapping (SemVer)

---

Generated by SKILL