internal/

directory
v0.5.1 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Sep 25, 2026 License: MIT

Directories

Path Synopsis
Package adapters defines the HarnessAdapter interface and shared types for harness-specific agent protocol implementations.
Package adapters defines the HarnessAdapter interface and shared types for harness-specific agent protocol implementations.
claude
Package claude implements adapters.HarnessAdapter for Claude Code.
Package claude implements adapters.HarnessAdapter for Claude Code.
codex
Package codex implements adapters.HarnessAdapter for the Codex CLI.
Package codex implements adapters.HarnessAdapter for the Codex CLI.
opencode
Package opencode implements adapters.HarnessAdapter for the opencode CLI.
Package opencode implements adapters.HarnessAdapter for the opencode CLI.
registry
Package registry maps sandbox.HarnessType to a HarnessAdapter implementation.
Package registry maps sandbox.HarnessType to a HarnessAdapter implementation.
shell
Package shell implements adapters.HarnessAdapter for plain shell / exec jobs that do not embed an agent harness.
Package shell implements adapters.HarnessAdapter for plain shell / exec jobs that do not embed an agent harness.
sigutil
Package sigutil hosts the small signal-forwarding loop every harness adapter runs while its child process is alive, so the claude / codex / opencode / shell adapters do not all carry their own copy of the same select-loop boilerplate.
Package sigutil hosts the small signal-forwarding loop every harness adapter runs while its child process is alive, so the claude / codex / opencode / shell adapters do not all carry their own copy of the same select-loop boilerplate.
api
Package apigateway implements the authenticating reverse proxy that lets a sandboxed job reach configured HTTP APIs without ever holding the credential itself.
Package apigateway implements the authenticating reverse proxy that lets a sandboxed job reach configured HTTP APIs without ever holding the credential itself.
Package apiwire holds the daemon↔client wire contract: the request and response shapes both internal/api (server side) and internal/client + cmd (client side) encode and decode, plus the few validators that DEFINE a field's canonical form (NormalizePublicURL).
Package apiwire holds the daemon↔client wire contract: the request and response shapes both internal/api (server side) and internal/client + cmd (client side) encode and decode, plus the few validators that DEFINE a field's canonical form (NormalizePublicURL).
Package atomicfile provides the write-temp + os.Link publish-if-absent primitive used by boid's "load or generate and persist" secret files, so two daemon instances racing to boot against the same fresh data dir can never clobber each other's write (see docs/plans/volume-only-daemon.md §論点 d).
Package atomicfile provides the write-temp + os.Link publish-if-absent primitive used by boid's "load or generate and persist" secret files, so two daemon instances racing to boot against the same fresh data dir can never clobber each other's write (see docs/plans/volume-only-daemon.md §論点 d).
Package daemon provides helpers for daemonizing the boid server process.
Package daemon provides helpers for daemonizing the boid server process.
db
Package dockerres is the single source of truth for the names and labels boid puts on the docker resources it creates, shared by internal/reap, internal/dispatcher, and internal/sandbox/dockerproxy so their naming and containment rules cannot drift apart (see docs/plans/workspace-home-volume-persistence.md 論点 a).
Package dockerres is the single source of truth for the names and labels boid puts on the docker resources it creates, shared by internal/reap, internal/dispatcher, and internal/sandbox/dockerproxy so their naming and containment rules cannot drift apart (see docs/plans/workspace-home-volume-persistence.md 論点 a).
Package gitgateway implements the authenticating reverse proxy that sits between a sandbox's credential-less git and the real upstream forge (GitHub / Bitbucket).
Package gitgateway implements the authenticating reverse proxy that sits between a sandbox's credential-less git and the real upstream forge (GitHub / Bitbucket).
Package gwtransport builds the outbound (gateway → upstream) http.Transport shared by internal/gitgateway and internal/apigateway.
Package gwtransport builds the outbound (gateway → upstream) http.Transport shared by internal/gitgateway and internal/apigateway.
Package humanize renders byte counts as human-readable strings and sums a directory tree's apparent (logical) size, for boid's workspace-home size reporting (`boid workspace show`, `boid gc`'s workspace_homes listing, and the confirmation prompt on `boid workspace remove`).
Package humanize renders byte counts as human-readable strings and sums a directory tree's apparent (logical) size, for boid's workspace-home size reporting (`boid workspace show`, `boid gc`'s workspace_homes listing, and the confirmation prompt on `boid workspace remove`).
Package install provides the daemon's install identity: a plain UUID persisted once per boid installation and stamped as the boid.install_id label on every container/network/volume the daemon creates.
Package install provides the daemon's install identity: a plain UUID persisted once per boid installation and stamped as the boid.install_id label on every container/network/volume the daemon creates.
Package integrationpack implements the Integration Pack manifest schema, loader, and "脱糖" (desugaring) that turns a services.<name>.uses reference into the apigateway.ServiceConfig the API gateway already understands.
Package integrationpack implements the Integration Pack manifest schema, loader, and "脱糖" (desugaring) that turns a services.<name>.uses reference into the apigateway.ServiceConfig the API gateway already understands.
Package logrotate provides a size-based rotating log writer.
Package logrotate provides a size-based rotating log writer.
Package mtls provides a small per-daemon self-signed certificate authority used to secure the broker / git-gateway / dockerproxy TCP listeners (docs/plans/phase6-container-backend.md §決定5).
Package mtls provides a small per-daemon self-signed certificate authority used to secure the broker / git-gateway / dockerproxy TCP listeners (docs/plans/phase6-container-backend.md §決定5).
Package notify exec's a user-configured command for agent-driven notifications.
Package notify exec's a user-configured command for agent-driven notifications.
Package orchestrator's state-machine layer is split into TWO machines — NewExecutionMachine and NewCardMachine (machine_execution.go / machine_card.go) — because the pending/executing/awaiting statuses and the parked/working/done/dropped card statuses share only their terminal statuses and never reach each other.
Package orchestrator's state-machine layer is split into TWO machines — NewExecutionMachine and NewCardMachine (machine_execution.go / machine_card.go) — because the pending/executing/awaiting statuses and the parked/working/done/dropped card statuses share only their terminal statuses and never reach each other.
refname
Package refname generates random "adjective_noun" style names for task refs.
Package refname generates random "adjective_noun" style names for task refs.
Package profiles resolves which boid daemon a CLI invocation should talk to: the local UNIX socket (today's sole, and still default, behavior) or a remote daemon over HTTPS + Bearer auth, per a named "profile" in ~/.config/boid/config.yaml.
Package profiles resolves which boid daemon a CLI invocation should talk to: the local UNIX socket (today's sole, and still default, behavior) or a remote daemon over HTTPS + Bearer auth, per a named "profile" in ~/.config/boid/config.yaml.
Package reap implements the destroy logic behind the daemon-independent `boid reap` subcommand (cmd/reap.go): it talks to the docker engine directly, never through boid's own daemon API, so it can stop/destroy every sibling job container an install created even when the daemon itself is down or unreachable.
Package reap implements the destroy logic behind the daemon-independent `boid reap` subcommand (cmd/reap.go): it talks to the docker engine directly, never through boid's own daemon API, so it can stop/destroy every sibling job container an install created even when the daemon itself is down or unreachable.
backend
Package backend defines the SandboxBackend/SandboxSession seam that separates "how a sandboxed agent process is launched and attached to" from the dispatcher's job orchestration.
Package backend defines the SandboxBackend/SandboxSession seam that separates "how a sandboxed agent process is launched and attached to" from the dispatcher's job orchestration.
brokerclient
Package brokerclient holds the low-level transport for talking to the boid broker over its UNIX socket or its TCP(mTLS) listener, plus a self-contained JobDone helper.
Package brokerclient holds the low-level transport for talking to the boid broker over its UNIX socket or its TCP(mTLS) listener, plus a self-contained JobDone helper.
realization
Package realization translates a backend-neutral sandbox.Spec into the intermediate representation a container backend needs to build a `docker create` call: volumes/binds, tmpfs mounts, environment, working directory and argv.
Package realization translates a backend-neutral sandbox.Spec into the intermediate representation a container backend needs to build a `docker create` call: volumes/binds, tmpfs mounts, environment, working directory and argv.
runner
Package runner is the container-backend sandbox runner entry point (`boid runner-container`, runner_container_linux.go's RunContainer).
Package runner is the container-backend sandbox runner entry point (`boid runner-container`, runner_container_linux.go's RunContainer).
Package selfuser registers a synthetic /etc/passwd entry for the container's runtime uid: the arbitrary-uid image no longer bakes a fixed `useradd` entry, so a container started as an arbitrary `--user <uid>:0` (the OpenShift-style gid-0 convention) has no matching /etc/passwd row, which breaks any tooling that does an os/user-style lookup (ssh, some git credential helpers, `id`, coreutils' `whoami`).
Package selfuser registers a synthetic /etc/passwd entry for the container's runtime uid: the arbitrary-uid image no longer bakes a fixed `useradd` entry, so a container started as an arbitrary `--user <uid>:0` (the OpenShift-style gid-0 convention) has no matching /etc/passwd row, which breaks any tooling that does an os/user-style lookup (ssh, some git credential helpers, `id`, coreutils' `whoami`).
Package terminaltitle extracts window titles from a streaming UTF-8 PTY.
Package terminaltitle extracts window titles from a streaming UTF-8 PTY.
Package timeline builds the unified task-detail timeline consumed by both the TUI and the Web UI.
Package timeline builds the unified task-detail timeline consumed by both the TUI and the Web UI.
Package version resolves boid's own version identity.
Package version resolves boid's own version identity.
Package vtsnapshot resolves a recorded PTY byte stream into the screen it would have painted, so a client attaching mid-session can be handed the current screen instead of the whole recording.
Package vtsnapshot resolves a recorded PTY byte stream into the screen it would have painted, so a client attaching mid-session can be handed the current screen instead of the whole recording.
Package yamlutil holds small, dependency-free helpers shared between packages that decode agent/hook-authored YAML into Go values destined for json.Marshal.
Package yamlutil holds small, dependency-free helpers shared between packages that decode agent/hook-authored YAML into Go values destined for json.Marshal.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL