internal/

Package agent implements the reusable LLM + tool-loop runtime shared by chat turns and workflow steps: the first model call, the tool-calling loop, plugin hooks, consecutive-call protection, and tool auditing.

Package auth provides single-user login proof validation and JWT sessions.

Package bootstrap loads process-level configuration from the environment.

Package channel bridges external channels to the chat and command services.

Package chat implements the per-session turn pipeline: assembling context, calling the LLM, running the tool loop, invoking Plugin hooks at each stage, and persisting the turn once (and only once) it completes.

Package chatrun owns durable, reconnectable chat turn execution.

Package command implements the platform's slash-command surface (/help, /status, /list, /switch, ...).

Package fsutil provides small filesystem helpers shared across packages.

Package interaction coordinates runtime requests that require a user's response, such as permission prompts from a tool invocation.

Package job orchestrates Job scheduling definitions: it claims eligible runs transactionally, executes their bound Workflows sequentially with per-binding retries, and persists durable run/state records.

Package llm adapts the platform's Identity config and ChatMessage history onto github.com/Cyvadra/ds4's DeepSeek chat-completions client.

Package media classifies attachment media types.

Package notify provides global warning/error reporting to a WeCom webhook plus an in-memory ring buffer of recent warnings for the /status command.

Package plugin implements the platform's side-channel extension points.

Package project implements Project: a named, on-disk folder the Agent may create (gated behind an opt-in ToolGroup, so creation only happens with the user's explicit authorization) to scope file/shell tools and take memory-retrieval priority over raw chat history.

Package registry loads, persists, and validates identity, impression, toolgroup, concierge, workflow, and job configuration.

Package resume delivers background-subagent completion events to their root parent session as durable user messages.

Package runctrl owns the cancellation lifecycle shared by the long-running executors (workflows and jobs): a registry of active runs and their cancel functions, plus the terminal-state guard used by Cancel.

Package server exposes the platform over HTTP using Gin, with Swagger documentation generated from the handler annotations below (run `make swagger` to regenerate).

Package session implements Session lifecycle, active-path reconstruction and the compression-cache validator described in the design doc.

Package sshutil holds the small SSH helpers shared by configuration loading and the SSH shell backend.

Package steering manages pending human instructions for active chat runs.

Package store defines the GORM-backed runtime data models (session, chat history, compression) and their Postgres migration.

Package subagent owns delegated agent execution and its durable lifecycle.

Package toolkit defines the platform's tool runtime: the Tool capability contract, the ToolResult value, the Registry that holds tools, and the validation/execution helpers that run a single tool call.

Package transform centralizes every platform-internal, single-shot LLM text transform: conversation compression, web-content summarization, and (over time) other structured rewrites.

Package upload persists chat attachments and prepares their prompt context.

Package workflow implements durable, isolated execution of a Workflow: each natural-language step runs as its own agent/tool loop in a selected Project, persisting its transcript and output before the next step starts.