Documentation v0.28.0

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

翻譯
  • 修正 invoke_subagent 以非空 session_id 續用既有持久化 session(不存在直接 error,不自動建立)

UPDATE

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

ADD

翻譯
  • 每 session 新增 action.log 紀錄 user 輸入與 tool/錯誤事件(純檔案、不進 DB/embedder)

Scope


Version Mapping (SemVer)

Detected Tag Version Impact
FIX / UPDATE / SECURITY / REFACTOR / PERF / ADD / REMOVE PATCH (+0.0.1)
STYLE / DOC / TEST / CHORE No bump (type: none, skip index)

Generated by SKILL