internal/

Package acp implements the Agent Client Protocol (https://agentclientprotocol.com) transport: a stdio JSON-RPC 2.0 agent that editors and other host clients speak to drive fairpeer.

Package agent wires a Provider, a tool Registry, and a Session into the harness loop that drives a coding task to completion.

Package apihelper provides a small set of shared HTTP helpers reused by the scheduler LLM time-parser, the RAG ask path, and the RAG extractor.

Package assets embeds the built-in, cross-platform skill payloads that fairpeer ships with its binary.

Package boot assembles a ready-to-drive control.Controller from configuration: it loads config, resolves the model(s), builds the tool registry (built-ins + plugins), wires the permission gate, and constructs the executor.

Package bot 实现 fairpeer 多渠道 IM bot 消息网关，支持 QQ、飞书、微信、Telegram。

Package browserlaunch launches a system-installed Chromium-based browser (Chrome / Edge / Brave / Chromium) with a CDP remote-debugging endpoint and exposes the resulting websocket URL so a driver — the Python browser-use sidecar, or chromedp elsewhere — can attach to the very same browser instead of each driver spawning its own.

Package browseruse is the Go client for the Python browser-use sidecar (browseruse_server.py).

Package builtinmcp defines MCP servers that ship with fairpeer without requiring user configuration.

Package calendar provides a local SQLite-backed calendar for FairPeer.

Package checkpoint is fairpeer's snapshot-based edit safety net.

Package cli implements fairpeer's command-line entry: subcommand routing, flag parsing, assembly from config, and exit codes.

Package codegraph integrates the CodeGraph code-intelligence engine (https://github.com/colbymchenry/codegraph) as a built-in MCP server.

Package command loads custom slash commands from Markdown files.

Package compose implements fairpeer's structured development workflow: after a plan is approved, a multi-task feature runs through Implement → Verify → (Review) with bounded retries, instead of a single execution turn that never validates the result.

Package config loads fairpeer's runtime configuration from TOML.

Package control is the transport-agnostic session driver.

Package diff computes a line-level diff between two versions of a file and renders it as a unified diff, with added/removed line counts.

Package docconv centralizes the external Python-script document-conversion helpers (markitdown via doc_converter.py, and PDF OCR via ocr_pdf.py) that were previously duplicated across three packages (rag, tool/builtin, control).

Package doctor collects local, redacted diagnostics for issue reports.

Package event defines the typed event stream the agent emits as it runs a turn, and the Sink it emits to.

Package frontmatter provides a minimal, dependency-free parser for the ---fenced "key: value" blocks that prefix skill, command, and memory files.

Package hook runs user-configured shell-command hooks around the agent loop: PreToolUse / PostToolUse fire around each tool call, UserPromptSubmit before a turn, Stop after it.

Package i18n holds the CLI's translatable strings and a small detection helper.

Package installsource implements the `install_source` tool: a two-phase installer for fairpeer skills and MCP servers.

Package jobs is the session-scoped background-job registry behind the agent's background tools (bash run_in_background, task run_in_background) and the bash_output / kill_shell / wait tools.

Package lsp is a minimal Language Server Protocol client: it spawns a language server per language on demand, syncs queried documents from disk, and adapts a few read-only capabilities (definition, references, hover, diagnostics) to the tool.Tool interface.

Package memory implements fairpeer's persistent memory.

Package netclient builds HTTP clients and proxy resolvers that share fairpeer's user-facing proxy settings.

Package outputstyle adds a selectable "output style" — a block of persona / tone instructions appended to (or replacing) the system prompt — so the user can shift how the agent communicates without rewriting the system prompt.

Package permission decides, per tool call, whether to allow it, deny it, or ask the user first.

Package-internal cache for MCP handshake results.

Package ppttemplate provides PPT template rendering utilities.

Package provider defines the model-backend abstraction and a registry mapping a provider "kind" to a factory.

Package rag implements a knowledge-base store for the coWork profile: import documents, chunk them, and search them.

Package sandbox wraps a shell command in an OS-level jail so the model's `bash` calls are confined: it may read freely but write only inside the workspace (plus temp and toolchain caches) and reach the network only when allowed.

Package scheduler is a persistent, session-independent task scheduler for the coWork profile.

Package serve exposes a control.Controller over HTTP: the typed event stream as Server-Sent Events, and the commands as small JSON POST endpoints.

Package skill loads invokable playbooks ("skills") from Markdown files.

Package sysproxy resolves the OS-level proxy (Windows system/PAC settings) for a target URL.

Package tool defines the Tool abstraction and a Registry.

Package validation provides pre-write syntax validation for the editor tools (write_file/edit_file/multi_edit).