pkg/

Package aetherwire is the Aether transport binding for the chat-stream protocol: the task-message topic and the message envelope that wraps a spec stream event.

Package approval is the human-in-the-loop tool-approval seam: a turn that hits a not-pre-authorized tool emits an approval_request and blocks on the Broker until an inbound approve/deny control resolves it (or the turn's context/timeout fires).

Package atomicfile writes a file durably.

Package authhandoff provides a small, in-process, single-use token→authority registry.

Package autonomy is the in-process foundation for proactive (cron-like) agent behavior.

Package bootstrap defines workspace bootstrap context files (SOUL.md, AGENTS.md, IDENTITY.md, …) injected into the system prompt, and the Loader seam that supplies them.

Package casblob defines the backend-neutral atomic blob contract used by distributed OSS state stores.

Package catalog is the tool/skill/MCP discovery seam: where the set of available tools, skills, and MCP servers comes from.

Package channel is the transport seam: how inbound turns arrive (Receiver) and how streaming events leave (Publisher).

Package commands implements OpenClaw-style slash commands for the harness.

Package configpath defines the operator-supplied path conventions shared by the OSS executable and distributions built on it.

Package dailynotes loads recent workspace daily notes (memory/YYYY-MM-DD.md and YYYY-MM-DD-<label>.md) and formats them as an UNTRUSTED background-context block to inject at the start of a new conversation, mirroring OpenClaw's startup-context behavior.

Package executionledger provides a bounded, branch-aware record of turn execution.

Package goal provides durable, workspace-isolated goal lifecycle storage.

Package hooks defines in-process extension points for the turn loop.

Package ids generates short random identifiers for threads, sessions, and similar keys.

Package imageutil holds shared image transforms for the model-bound image path.

Package memorylayer stores chat threads and transcripts in MemoryLayer instead of on local disk, so every process that shares a MemoryLayer sees the same conversation — the agent worker and any number of attached frontends.

Package model defines a neutral model registry + per-turn model-selection seam.

Package plugin defines the transport-neutral admission contract for Sahara extensions.

Package procgroup starts child processes in their own process group and stops the whole group.

Package promptnotes defines the backend-neutral read contract for reusable, workspace-scoped prompt supplements.

Package protocol is a thin compatibility shim over the authoritative github.com/scitrera/ecosystem-messaging-spec/go module.

Package providerauth is the Sahara OSS credential broker.

Package refinement defines backend-neutral continual-refinement plans, append-only audit records, and an approval-aware workflow over authoritative resource editors.

Package sessionlog provides the OSS reference implementation of resumable session state.

Package shellcontext identifies user-requested shell executions that should be preserved as conversational context.

Package skills discovers workspace skills from the filesystem: a skill is a folder containing a SKILL.md, mirroring OpenClaw's skills-folder model.

Package steering delivers a user's mid-turn chat message INTO the turn that is already running, instead of making it wait for that turn to finish.

Package store provides filesystem reference implementations of the core memory seams: a durable per-thread history store and a workspace bootstrap loader.

Package subagent defines the contract for delegating a bounded sub-task to a nested agent.

Package sysprompt builds the agent's system prompt: a hardcoded base instruction block, the workspace bootstrap files (framed, ordered, capped), an optional tool catalog, and a per-turn runtime line.

Package tasklifecycle decorates a turn executor with an authoritative task's claim and terminal transitions.

Package telemetry instruments the turn loop with OpenTelemetry spans at the key points (turn, LLM request, tool execution, sub-agent).

Package threadindex persists lightweight chat-thread metadata shared by UI transports.

Package turncancel provides a small registry that maps an in-flight turn (keyed by task id) to its cancel func, so an out-of-band cancel control can abort the running turn's context.

Package turnjournal provides durable, workspace-scoped checkpoints for an in-progress parent model/tool loop.

Package verification records bounded, content-free evidence from admitted tool results.

Package version carries the build identity of the agent-harness distribution.

Package workspace resolves local programming projects to stable OSS workspace identities.