Agent Version History

v0.2.0(2026/06/17)¶

This release focuses on beak-agent runtime diagnosability, AI Hub error propagation, Skill invocation chain, and obsycli interaction display. The main updates are as follows:

New Features¶

• obsycli adds a local configuration file ~/.obsycli/config.toml, supporting customization of bottom status bar fields via footer_fields. Options include displaying agent/task, model, token, context, permission, and plan status (b0ebe75)
• obsycli input editor adds local history persistence. Users can retrieve original questions from historical inputs in subsequent interactions after successful or failed sends (b0ebe75)

Bug Fixes¶

• Fixed an issue where Agent only handled structured error codes from AI Hub as generic LLM HTTP errors. Now it prioritizes propagating stable stop_reason such as INVALID_BODY, VALIDATION_ERROR, AUTH_INVALID, AGENT_API_KEY_DISABLED, DAILY_CREDIT_LIMIT_REACHED, MONTHLY_CREDIT_LIMIT_REACHED, PROTECTED_SECRET_INVALID, NO_AUTO_MODEL, and displays corresponding handling suggestions in obsycli (a09dcaa)
• Fixed an issue where OpenAI-compatible LLM responses wrapped in AI Hub envelope could not be parsed correctly. Agent now supports extracting real chat completion content from the data field and retains response model information (b0bc4e2)
• Fixed issues with query_session_events lacking cursor-based pagination and unstable error classification. Added cursor parameter and structured errors like missing parameters, history read failures as tool errors (b0bc4e2)
• Fixed an issue where render_document might overwrite existing files with the same name. Now creates files exclusively when generating documents to avoid accidentally writing to existing files (b0bc4e2)
• Fixed issues where obsycli session list still displayed closed or closing sessions, and empty list display was unclear. Now filters out closed status by default and shows an empty table when no sessions are available (b0ebe75)

Optimizations¶

• Optimized Agent user-visible text language contract. Final answer, tool commentary, progress feedback, approval reason, task insight, Agent UI copy, and closing summary prioritize following the original user question language, avoiding interference from Skill documentation, schema, or repair prompt language (b0ebe75)
• Removed Agent use_skill local tool call. Skills continue to be used via read_skill/read_skill_file and Prompt instruction chain, preventing models from mistakenly calling ordinary Skills as executable tools (b0bc4e2)
• Optimized Python tool exception handling, adding structured error returns for missing code, non-zero exit, timeout, missing python3, and oversized output. Excessively large outputs are truncated as short errors with output_too_large to avoid polluting subsequent context (b0bc4e2)
• Optimized Agent runtime stop results. Added titles, summaries, and actionable next steps for AI Hub errors. Reduced redundant completed/blocker display for scenarios reaching maximum tool call count, improving obsycli/Web UI readability (a09dcaa)
• Optimized token usage and observability events. LLM response models are written to token metadata. obsycli bottom status bar can display actual response models, facilitating troubleshooting of automatic routing and model fallback situations (b0ebe75)
• Optimized beak-agent --version output, adding branch, commit, release date, and Go version to confirm the source of online agent/obsycli releases (b0ebe75)
• Optimized Agent local tool registration implementation. Separated tool registry construction logic and added regression test coverage for tools like send_email, web_search, python, render_document, read_skill (b0bc4e2)
• Added agent/obsycli integration test cases covering LLM error recovery, Plan Mode, Python tools, session event queries, document rendering, Skill reading, email sending, Web Search, stream reconnection, task insight, and session closing summary chains (b0bc4e2)

v0.1.9(2026/06/15)¶

This release focuses on beak-agent default model configuration, completing the uninstall process, and release artifact integrity. The main updates are as follows:

New Features¶

• Agent supports omitting LLM_MODEL configuration. Runtime defaults to using the default model identifier. Installation scripts and Beak install-config no longer require users to provide model configuration (d096537)
• Agent release adds uninstall.sh artifact. Users can fetch the uninstall script online via the release URL. Release, upload, and local verification processes all check for the existence of this uninstall script (1e2c13f)

Bug Fixes¶

• Fixed an issue where the active LLM_MODEL from the old agent.env might persist during upgrades. The installation script removes this old configuration and only retains default comments, preventing old local model values from overriding runtime defaults (d096537)
• Fixed an issue where the response_model of LLM Chat span always equaled the request model. Now prioritizes using the model field from the upstream response body, falling back to the request model on failure or absence (d096537)

Optimizations¶

• Completed Agent uninstall scope. uninstall.sh --yes stops and removes the beak-agent-update-check service/timer, removes updater/update-check binaries and /etc/sudoers.d/beak-agent, and fixes an issue where residual process detection under the test root directory incorrectly scanned host processes (1e2c13f)
• Clarified uninstall boundaries. uninstall.sh does not delete system commands, language runtimes, Python/Node packages, fonts, etc., installed or checked by skill-dep.sh, to avoid accidentally deleting components shared by the host or other services (1e2c13f)
• Synchronously updated agent installation, AgentRunner configuration, self-hosted installation, and uninstallation documentation to ensure consistency with current install/uninstall processes (d096537, 1e2c13f)
• Added tests related to this release's configuration, LLM span, Agent uninstall, release packaging, and OSS upload checklist. test-release-agent.sh no longer depends on python3, adapting to more streamlined CI environments (d096537, 1e2c13f)

v0.1.8(2026/06/12)¶

This release focuses on beak-agent runtime diagnostics, tool loop stability, Skill usage chain, and obsycli display corrections. The main updates are as follows:

New Features¶

• Agent adds a collect_bug_report tool that collects runtime information, recent logs, metric status, sanitized env/config, and profile cache diagnostics, then packages and uploads them to the current task session for troubleshooting Agent issues (7e073a1)

Bug Fixes¶

• Fixed an issue where LLM timeouts, rate limits, upstream errors, and network errors lacked stable stop reasons. Agent runtime now returns structured reasons like llm_timeout, llm_rate_limited, llm_upstream_error, llm_network_error, and actionable suggestions (7e073a1)
• Fixed issues with insufficient diagnostic information for tool call parameter JSON exceptions, repeated calls to the same failed action, and repeated similar tool errors. Stop results now include the most recent successful items, blocking items, and safe_next_actions (7e073a1)
• Fixed an issue where obsycli might double-count incremental token usage when both streaming token usage and final token usage arrived simultaneously. Incremental token events are deduplicated by reply_to_message_uuid (7e073a1)
• Fixed an issue where obsycli might misinterpret arbitrary strings when attaching to a session. Now only accepts sequence numbers or explicit session IDs with session_/session- prefixes (7e073a1)

Optimizations¶

• Optimized Agent tool loop implementation. Split commentary, result envelope, error classification, LLM invocation, Plan Mode, repair, and stop checkpoint into independent modules, reducing runtime maintenance complexity (7e073a1)
• Optimized structured envelope for tool results sent to LLM. Added ToolSuccess/ToolError, schema validation repair, routing repair, and cache hit markers, reducing invalid retries and incorrect tool selection (7e073a1)
• Optimized Skill usage chain. Skills index no longer exposes guessable .beak-skills file paths. Added skill_name, skill_file_path, tool_display_name to tool events. obsycli display for read_skill/read_skill_file is clearer (7e073a1)
• Optimized profile cache synchronization. Added profile cache file locks and stale lock cleanup. Generates skills index from installed version information, reducing the probability of inconsistent cache states due to concurrent synchronization (7e073a1)
• Optimized Agent identity and Prompt rules. Self-introduction prioritizes using runtime agent_name. Avoids exposing underlying LLM provider, model id, internal project names, and code package names (7e073a1)
• Optimized obsycli tool invocation display. Supports tool_display_name, limits display lines for long tool reasons, and only replays recent tool output when a working message exists (7e073a1)
• Optimized metadata for obsycli task/session creation. Explicitly writes session_type=task and source_type=user to help the server distinguish CLI user task sources (57fb449)
• Optimized manual testing scripts. Supports launching multiple manual test instances in parallel to avoid local multi-instance debugging overwriting each other's run directories and states (bd73f2e)
• Added tests for bug report, tool loop stop reason, structured tool envelope, schema/routing repair, Skill reading, profile cache, LLM error classification, obsycli token statistics, and manual testing scripts (7e073a1, 57fb449, bd73f2e)

v0.1.7(2026/06/10)¶

This release focuses on obsycli interaction experience, beak-agent GTrace observability, Skill usage chain, and Plan Mode stability. The main updates are as follows:

New Features¶

• obsycli adds a /save command that downloads internal asset attachments carried in Agent replies to ~/.obsyclis/attachments/ and provides prompts when savable attachments exist (01d75d9)
• obsycli supports directly displaying task_insight and session_summary in the conversation stream, facilitating viewing Agent's phased insights and task closing summaries (316ecf2, 01d75d9)
• Agent adds read_skill and read_skill_file tools for first reading explicitly specified Skill's SKILL.md and referenced files, then executing tasks according to Skill instructions (01d75d9)
• Agent supports user @ entity/explicit Skill request context. Message metadata can carry requested_skills and inject them into the Prompt, avoiding guessing usage solely based on Skill names (d460e73)
• Agent adds automatic task title generation capability. When obsycli creates an unnamed task, Agent can generate a title based on the first user message (6b5618a)

Bug Fixes¶

• Fixed an issue where obsycli's working status disappeared prematurely in some LLM rounds. Ordinary messages sent successfully with a message UUID will continuously track running status (01d75d9)
• Fixed unstable error prompts and tool output display in obsycli. Unified user-visible error format and retained complete single-line tool output to avoid critical errors being truncated and hidden (01d75d9)
• Fixed incompatibility with old beak-agent configuration OTEL_EXPORTER_OTLP_PROTOCOL=grpc. Now normalizes to http/protobuf to avoid startup failures with historical installation configurations (8d663c1)
• Fixed an issue where input_preview of LLM Chat span repeatedly displayed the same original user input across multiple tool loops. Now records the most recent non-runtime prompt message in this LLM request (01d75d9)
• Fixed an issue where Plan Mode structured interaction schema might still rely on unstable action labels. accept/reject/skip/revise are now processed only by stable action IDs (c55f653, 01d75d9)

Optimizations¶

• Optimized beak-agent GTrace/OTEL reporting. Defaults to OTLP HTTP/protobuf, supports OTEL_EXPORTER_OTLP_HEADERS, and adds Agent identifiers, Plan Mode status, and LLM invocation context to logs and traces (01d75d9, 8d663c1)
• Optimized Skill dependency installation flow. Converged asynchronous dependency installation, timeout control, process group cleanup, and changed package filtering into cmd/agent runtime. Profile Client only handles synchronization and indexing (c4be7f0)
• Optimized Agent tools and Prompt rules. Clarified usage constraints for attached session files, uploaded attachments, Skill file reading, working directory writes, and progress_feedback (01d75d9, d460e73)
• Optimized Plan Mode runtime and obsycli display. Enhanced direct answer repair, structured interaction events, history replay, plan state recovery, and compact rendering of tool output (c55f653)
• Optimized obsycli task creation and list experience. /newtask supports custom task names. Unnamed tasks can go through the automatic title process (6b5618a)
• Split Agent Service and obsycli runtime code. Added tests for attachment saving, Task Insight, Skill dependency installation, GTrace/OTEL, Plan Mode, and session title (316ecf2, c4be7f0, 01d75d9, 6b5618a)

v0.1.6(2026/06/03)¶

This release focuses on Plan Mode stability, task closing flow, and obsycli runtime display. The main updates are as follows:

New Features¶

• obsycli adds a /close <number|task_id> command supporting closing the current or specified task. After closing, the task enters closing/completed flow, preventing new messages from being sent (4efd12a)
• Agent adds a session_summary event. When a task closes, a session summary is generated, and the server completes the session state transition (4efd12a)
• Agent adds an agent_runtime_result event. obsycli can display tool loop stop reasons, blocking items, suggested next steps, and recent completed work (845d571)

Bug Fixes¶

• Fixed an issue where Plan Mode structured interactions might fail to attach back to triggering user messages during history replay. Plan events now fallback to associating with historical messages via reply_to_message_uuid (845d571, 713593e)
• Fixed an issue where Plan Mode final state might be reverted by old snapshots, preventing completed/interrupted states from being overwritten by expired planning states (845d571)
• Fixed unstable judgment in Plan Mode interaction confirmation flow. Unified use of accept/reject/skip/revise actions and clarified that after confirmation, the next step should submit the final plan (713593e)
• Fixed an issue where session status API did not support closing. When closing a task, session_close_requested context is published, allowing Agent to generate a closing summary (4efd12a)

Optimizations¶

• Optimized Plan Mode interaction schema. Removed global free_text, replaced with field-level custom_input/comment_input and text_entry, improving CLI/Web UI structured input consistency (713593e)
• Optimized obsycli Plan Mode display. Hides intermediate plan_execution_progress noise, avoids duplicate rendering of structured and text content, and correctly ends current working status when plan events arrive (845d571, 713593e)
• Optimized Agent Prompt and Prompt Builder rules for Plan Mode. Added new interaction actions, text input fields, and session context constraints (713593e)
• Organized documentation directory and Plan Mode Web UI contracts. Added explanations for /close, session_summary, agent_runtime_result, and plan interaction schema (845d571, 713593e, 4efd12a)
• Added tests for Plan Mode, session closing, runtime result, history replay, WSS status update, and obsycli /close command (845d571, 713593e, 4efd12a)

v0.1.5(2026/06/01)¶

This release focuses on Agent MCP Client, Plan Mode, obsycli interaction capabilities, and permission/approval flow improvements. The main updates are as follows:

New Features¶

• Agent adds MCP Client capability, supporting synchronization of MCP configurations and toolkits from profile cache, and unified routing invocation of MCP tools via mcp_list_servers, mcp_list_tools, mcp_call_tool (fcf17e3, 14aad95)
• Agent adds session/task-level Plan Mode, supporting plan draft, structured interaction, final plan confirmation, execution progress, blocking, interruption, completion, and other plan events (c69d29c, d65661d)
• obsycli adds /plan, /plan-approve, /plan-reject, /plan-revise, /plan-interrupt commands, and supports displaying plan status and structured interaction content (c69d29c, d65661d)
• obsycli adds /permission-full and /permission-standard commands for switching the current task's permission mode in CLI (d65661d)

Bug Fixes¶

• Fixed an issue where obsycli /tasks and /attach did not restrict to CLI-created tasks, preventing CLI from accidentally attaching to sessions not created by obsycli (29faa63)
• Fixed an issue where unknown subcommands in obsycli startup parameters did not report errors promptly, preventing erroneous commands from being silently ignored (5d9f923)
• Fixed incompatibility of obsycli recent history message reading with some response structures. Added fallback parsing for content.messages and content.data (5d9f923)
• Fixed an issue where high-risk commands like remote login and database clients in bash did not enter runtime approval judgment (26edc7a)

Optimizations¶

• Optimized MCP tool exposure strategy: By default, only stable routing tools are exposed. Small toolset servers can expand direct tools as needed, while large toolset servers continue routing via mcp_call_tool, reducing tool schema bloat (fcf17e3, 14aad95)
• Optimized Agent Prompt and prompt cache structure. Added rules for MCP, Plan Mode, permission mode, and session context. Included MCP toolset version in cache key calculation (41d0018, fcf17e3, c69d29c)
• Optimized default history message query count for query_session_events, increased from 3 to 20, enhancing multi-turn context recovery capability (26edc7a)
• Optimized obsycli input experience. Supports slash command fuzzy matching, highlighting, Ctrl+L clear screen, double Esc cancel, unified command history, and cleaner startup prompts (26edc7a, c69d29c)
• Optimized Agent tool execution chain. Abstracted composite tool executor and execution plan, unifying handling of tool policy, schema validation, approval, repair, and real execution decisions (fcf17e3, c69d29c)
• Added tests for MCP Client, Plan Mode, obsycli plan/permission, profile sync, tool execution, and approval flow (41d0018, fcf17e3, 14aad95, c69d29c, d65661d)

v0.1.4(2026/05/27)¶

This release focuses on Agent Prompt simplification, obsycli history message display stability, and obsycli code structure splitting. The main updates are as follows:

Bug Fixes¶

• Fixed an issue where obsycli might synchronize early historical answers after startup or reconnection, causing the current interaction area to be overwritten by old messages (6e05c87)
• Fixed an issue where obsycli might output raw JSON of historical events like web_search_evidence to the interaction interface. Such events are still retained in obsycli logs for troubleshooting (6e05c87)

Optimizations¶

• Simplified rules in Agent core prompt that duplicated tool descriptions. Now each tool schema/description carries path scope, required parameters, and usage conditions, reducing default system prompt volume (6e05c87)
• Strengthened exec tool description, clarifying that exec is direct program execution. Shell syntax, redirection, pipes, variable expansion, glob, loops, and conditional statements should use bash (6e05c87)
• Split obsycli's large chat.go into multiple files based on responsibilities like startup, stream, agent event, state, session, render, tool/approval, reducing maintenance cost (6e05c87)
• Added tests for obsycli stream history message suppression, agent event logging, Prompt construction, and exec tool description (6e05c87)

v0.1.3(2026/05/26)¶

This release focuses on agent runtime, obsycli display, and installation/upgrade flow optimizations. The main updates are as follows:

New Features¶

• Agent UI schema overlay is now driven via scripts/prepare.py and scripts/compile.py. Runtime selects overlay based on skill and compiles agent-ui@1 draft blocks (5a1e699)
• submit_agent_ui_blocks supports using tool_input_schema provided by the overlay. Agent only submits draft blocks, no longer needing to submit overlay_id and layout (5a1e699)
• beak-agent adds --default-envs parameter for outputting runtime default environment variable comments. Installation scripts can directly use default values from the binary (823c0bb)
• Added AGENT_REASONING_DISPLAY_MODE configuration supporting hidden/raw reasoning display modes, defaulting to hiding raw reasoning (823c0bb)

Bug Fixes¶

• Fixed unclear layering of tool invocation running events: Human-visible explanations are now written to metadata.commentary, while content of running events remains empty to prevent client misreading (c2cb6e6, 823c0bb)
• Fixed an issue where user-customized active environment variables in agent.env might be lost during Agent upgrades. Upgrades preserve KEY=value and export KEY=value from old files not overwritten by new configurations (823c0bb, 5a1e699)
• Fixed Task Insight event attribution issue, ensuring insights are persisted and published according to reply message relationships (5a1e699)

Optimizations¶

• Optimized obsycli thinking and tool invocation display. Long reasoning, tool explanations, and output previews are folded/truncated to reduce terminal noise (823c0bb)
• Optimized Prompt rules. Final reply language is determined based on the original user task, avoiding leakage of internal information like runtime bookkeeping, repair prompt, tool protocol (823c0bb)
• Optimized Task Insight submission flow. Allows multiple submissions of phased facts, actions, assumptions, and conclusions during a task, using runtime time to generate timestamps (5a1e699)
• Adjusted manual upgrade entry. Documentation now recommends directly using beak-agent-updater to trigger latest or specified version upgrades (5a1e699)
• Added tests for Agent UI schema scripts, installation/upgrade, tool invocation events, reasoning display, and Task Insight (c2cb6e6, 823c0bb, 5a1e699)

v0.1.2(2026/05/25)¶

This release focuses on optimizations for agent and obsycli, with no adjustments to beak server. The main updates are as follows:

New Features¶

• Agent adds tool invocation visualization capability, displaying tool call reasons, batch execution status, output preview in CLI, and supporting Ctrl+T to toggle full tool output (4bd18ed)
• Agent adds Prompt Cache support. Splits system prompt into stable prefix, semi-stable prefix, and dynamic suffix. Adds explicit cache block passing capability for OpenAI-compatible Providers (c9274e7)
• query_session_events tool adds on-demand query capability for recent user conversations and tool execution history, reducing default injected context volume (c9274e7)
• obsycli session page adds display for task, Agent, input/output/cache Token, and remaining context status (c9274e7)
• Added Agent Prompt structure and example documentation explaining cache layering, dynamic context, and tool invocation conventions (c9274e7)

Bug Fixes¶

• Fixed an issue where Agent installation configuration API did not deliver llm_max_tokens, ensuring self-hosted Agent installation correctly passes maximum Token configuration (92e776d)
• Fixed unclear prompts in self-hosted installation scripts for scenarios like error interfaces, HTML/JSON responses, or empty responses. Added HTTP status, response summary, and env file format validation (92e776d)

Optimizations¶

• Optimized /agents and /tasks display. Hides raw UUIDs, retains internal numeric selection capability, improving CLI readability (c9274e7)
• Optimized Agent final reply language rules. Defaults to following the language of the user's latest message, while preserving original commands, code identifiers, and proper nouns (c9274e7)
• Optimized LLM observability data. Added Prompt Cached Tokens, cache hit rate, and context usage to logs and trace attributes (c9274e7)
• Optimized tool invocation event metadata. Added batch and output summary fields for unified frontend and CLI display (4bd18ed)
• Added tests for self-hosted installation scripts, Prompt construction, tool invocation visualization, and configuration API (4bd18ed, 92e776d, c9274e7)