runner/

directory
v0.7.39-dev.1 Latest Latest
Warning

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

Go to latest
Published: Nov 9, 2026 License: MIT

Directories

Path Synopsis
Package acpagent is the agent side of the Agent Client Protocol: it lets an editor or an orchestrating agent drive one QuickAgent over a pair of pipes, as the runner itself drives a harness (the other direction, in pkg/runner/adapter).
Package acpagent is the agent side of the Agent Client Protocol: it lets an editor or an orchestrating agent drive one QuickAgent over a pair of pipes, as the runner itself drives a harness (the other direction, in pkg/runner/adapter).
Package adapter defines the harness adapter interface and its registry.
Package adapter defines the harness adapter interface and its registry.
copilottest
Package copilottest is a fake Copilot CLI server mode for tests: the JSON-RPC 2.0 server of `copilot --headless --stdio`, framed by Content-Length, in the shapes Copilot CLI 1.0.95 answers with (recorded against the real binary with no account) and copilot-sdk go/v1.0.19 names.
Package copilottest is a fake Copilot CLI server mode for tests: the JSON-RPC 2.0 server of `copilot --headless --stdio`, framed by Content-Length, in the shapes Copilot CLI 1.0.95 answers with (recorded against the real binary with no account) and copilot-sdk go/v1.0.19 names.
signintest
Package signintest is a fake harness adapter for tests of model sign-ins: a container harness that reads its model credential from the file or directory a model sign-in hands it, and speaks a small NDJSON event stream the tests script.
Package signintest is a fake harness adapter for tests of model sign-ins: a container harness that reads its model credential from the file or directory a model sign-in hands it, and speaks a small NDJSON event stream the tests script.
Package browser holds what the runner knows of the browser server, the gateway-launched container a release that declares capabilities.browser gets: Microsoft's @playwright/mcp on the agentry-browser image, driving a headless Chromium whose only route out is the run's browse proxy.
Package browser holds what the runner knows of the browser server, the gateway-launched container a release that declares capabilities.browser gets: Microsoft's @playwright/mcp on the agentry-browser image, driving a headless Chromium whose only route out is the run's browse proxy.
Package clamdb keeps this machine's copy of the ClamAV signature bundle the decode step checks every input against.
Package clamdb keeps this machine's copy of the ClamAV signature bundle the decode step checks every input against.
Package claudesignin is "Use your Claude subscription (runs Claude Code)": Claude Code's own sign-in into a config directory of Agentry's, and its removal.
Package claudesignin is "Use your Claude subscription (runs Claude Code)": Claude Code's own sign-in into a config directory of Agentry's, and its removal.
Package compile is the capability compiler: it turns manifest + operator policy into the run plan — generated gateway file set, tools-server spec, harness definition, and container topology.
Package compile is the capability compiler: it turns manifest + operator policy into the run plan — generated gateway file set, tools-server spec, harness definition, and container topology.
Package connection keeps a person's OAuth connections to remote MCP servers on this machine: one per QuickAgent release (ref plus archive digest) and server, never opened for another QuickAgent or another version of the same one, always kept until the person removes it or the version is uninstalled.
Package connection keeps a person's OAuth connections to remote MCP servers on this machine: one per QuickAgent release (ref plus archive digest) and server, never opened for another QuickAgent or another version of the same one, always kept until the person removes it or the version is uninstalled.
Package copilotmodels lists the models a person's Copilot plan offers for `agentry setup` and the desktop's model setup, so there is one implementation per machine: the Copilot sign-in kept on this computer, the images a Copilot run needs made present as setup makes them, then Copilot CLI's own list in a run's container (engine.ListCopilotModels).
Package copilotmodels lists the models a person's Copilot plan offers for `agentry setup` and the desktop's model setup, so there is one implementation per machine: the Copilot sign-in kept on this computer, the images a Copilot run needs made present as setup makes them, then Copilot CLI's own list in a run's container (engine.ListCopilotModels).
Package decode is the runner's decode step: the documents a run is given are turned into plain text before any agent starts, by the runner image's own `decode` role in an image that holds the decoders and content detectors (the files image, pulled by digest, with the runner binary added), in a container with no network and no capabilities, the documents mounted read-only.
Package decode is the runner's decode step: the documents a run is given are turned into plain text before any agent starts, by the runner image's own `decode` role in an image that holds the decoders and content detectors (the files image, pulled by digest, with the runner binary added), in a container with no network and no capabilities, the documents mounted read-only.
Package deliver copies a run's deliverables out of its output folder to a folder the person chose.
Package deliver copies a run's deliverables out of its output folder to a folder the person chose.
Package desktop is how a run reaches Agentry Desktop's link service, the far end of the desktop link: the socket Agentry Desktop serves in the runner home while it runs, and the three messages on it.
Package desktop is how a run reaches Agentry Desktop's link service, the far end of the desktop link: the socket Agentry Desktop serves in the runner home while it runs, and the three messages on it.
Package destination is where the person keeps the places a run's deliverables may be sent.
Package destination is where the person keeps the places a run's deliverables may be sent.
Package dockerx wraps the docker CLI behind the smallest interface the engine needs.
Package dockerx wraps the docker CLI behind the smallest interface the engine needs.
Package engine executes a compiled run plan: render the plan's placeholder-bearing files into a per-run directory, resolve secrets, stand up the run-scoped network + proxy + gateway + agent containers, stream and budget the harness event stream, collect the result envelope, and tear everything down on every exit path.
Package engine executes a compiled run plan: render the plan's placeholder-bearing files into a per-run directory, resolve secrets, stand up the run-scoped network + proxy + gateway + agent containers, stream and budget the harness event stream, collect the result envelope, and tear everything down on every exit path.
Package gateway owns the "installed on first agent use" half: making sure the pinned docker-mcp-gateway and harness images are present and the local runner image is built, before any run needs them.
Package gateway owns the "installed on first agent use" half: making sure the pinned docker-mcp-gateway and harness images are present and the local runner image is built, before any run needs them.
Package harnessbuild makes the harness images that are built on this machine from a vendor artifact and never published.
Package harnessbuild makes the harness images that are built on this machine from a vendor artifact and never published.
Package harnessprobe describes the host-run harness behind an adapter name on this machine: whether its executable resolves (from the operator policy's harness.<name>.path, PATH, or the adapter's well-known install locations), which release it is, and whether the endpoint the policy points it at is one the run's proxy would let through.
Package harnessprobe describes the host-run harness behind an adapter name on this machine: whether its executable resolves (from the operator policy's harness.<name>.path, PATH, or the adapter's well-known install locations), which release it is, and whether the endpoint the policy points it at is one the run's proxy would let through.
Package hostpin pins the hosts a proxy may reach to the addresses this machine resolves for them, as --add-host entries for the proxy's /etc/hosts.
Package hostpin pins the hosts a proxy may reach to the addresses this machine resolves for them, as --add-host entries for the proxy's /etc/hosts.
Package hybrid looks up a run's risky inputs on CrowdStrike's Hybrid Analysis by SHA-256 alone.
Package hybrid looks up a run's risky inputs on CrowdStrike's Hybrid Analysis by SHA-256 alone.
Package imagelabel names the label every image the runner builds carries: org.agentry.image=<kind>.
Package imagelabel names the label every image the runner builds carries: org.agentry.image=<kind>.
Package inference is the client of a registry's credits sessions: the sessions a run, or a persistent agent, pays for its model with when its policy names model provider agentry.
Package inference is the client of a registry's credits sessions: the sessions a run, or a persistent agent, pays for its model with when its policy names model provider agentry.
inferencetest
Package inferencetest is a fake registry's credits sessions for tests: it opens, renews and ends sessions as a SecureAgentry registry does, and records each call.
Package inferencetest is a fake registry's credits sessions for tests: it opens, renews and ends sessions as a SecureAgentry registry does, and records each call.
Package installdir is the runner home's per-release directory: where a verified release is laid down for runs, and where `agentry install` and the desktop put a QuickAgent by default.
Package installdir is the runner home's per-release directory: where a verified release is laid down for runs, and where `agentry install` and the desktop put a QuickAgent by default.
Package intake collects a QuickAgent's up-front questions (manifest v2 `intake`): asked before the sandbox starts, in either run mode, through the same prompter that collects MCP profile secrets, or answered non-interactively with --intake id=value.
Package intake collects a QuickAgent's up-front questions (manifest v2 `intake`): asked before the sandbox starts, in either run mode, through the same prompter that collects MCP profile secrets, or answered non-interactively with --intake id=value.
Package integritykey is the runner home's integrity key: 32 random bytes in <runner home>/plan-integrity.key (0600), outside every install directory.
Package integritykey is the runner home's integrity key: 32 random bytes in <runner home>/plan-integrity.key (0600), outside every install directory.
Package localinstall installs a QuickAgent from a folder on this machine that was never published, into the runner home, where it lists among the installed QuickAgents and runs by name.
Package localinstall installs a QuickAgent from a folder on this machine that was never published, into the runner home, where it lists among the installed QuickAgents and runs by name.
Package localrun holds what a run needs besides the registry: the plan's reuse or compile for any run, a release's or not (EnsurePlan); the manifest and the tree digest a local package is read and keyed by; and the built-in run — a package this binary embeds, run with the attestation state builtin, no registry resolve and no consent prompt for a contract the application declares itself.
Package localrun holds what a run needs besides the registry: the plan's reuse or compile for any run, a release's or not (EnsurePlan); the manifest and the tree digest a local package is read and keyed by; and the built-in run — a package this binary embeds, run with the attestation state builtin, no registry resolve and no consent prompt for a contract the application declares itself.
Package mcpinstall resolves and installs the MCP servers a QuickAgent declares: resolution turns each manifest pin into the exact registry artifact (npm / PyPI metadata, integrity recorded); installation materializes the dependency closure into the signature's server store inside a pinned runtime container.
Package mcpinstall resolves and installs the MCP servers a QuickAgent declares: resolution turns each manifest pin into the exact registry artifact (npm / PyPI metadata, integrity recorded); installation materializes the dependency closure into the signature's server store inside a pinned runtime container.
Package modelcheck checks a saved model before it is saved: that its provider can be reached with the credential the provider names, and that the model id is one the provider offers.
Package modelcheck checks a saved model before it is saved: that its provider can be reached with the credential the provider names, and that the model id is one the provider offers.
Package modelkey keeps a model provider's API key in the OS keychain — Keychain on macOS, Credential Manager on Windows, the Secret Service on Linux — for the runs a person launches from somewhere with no shell environment of its own: a desktop app opened from the dock or the Start Menu.
Package modelkey keeps a model provider's API key in the OS keychain — Keychain on macOS, Credential Manager on Windows, the Secret Service on Linux — for the runs a person launches from somewhere with no shell environment of its own: a desktop app opened from the dock or the Start Menu.
Package modelsignin keeps a person's model sign-ins on this machine: the grants that let their local runs spend a model vendor's plan, one per vendor, apart from the MCP connections of pkg/runner/connection.
Package modelsignin keeps a person's model sign-ins on this machine: the grants that let their local runs spend a model vendor's plan, one per vendor, apart from the MCP connections of pkg/runner/connection.
Package osvdb keeps this machine's copy of OSV's vulnerability databases, which the Coding agent's dependency scan reads offline.
Package osvdb keeps this machine's copy of OSV's vulnerability databases, which the Coding agent's dependency scan reads offline.
Package owner labels the docker objects a run creates with the process that created them, and tells a live owner from a dead one, so a later run on the same host can remove what a crashed run left behind without touching a sibling run that is still going.
Package owner labels the docker objects a run creates with the process that created them, and tells a live owner from a dead one, so a later run on the same host can remove what a crashed run left behind without touching a sibling run that is still going.
Package persistent runs a persistent agent: a built-in QuickAgent the runner keeps between the person's conversations.
Package persistent runs a persistent agent: a built-in QuickAgent the runner keeps between the person's conversations.
Package policy loads the operator policy — the machine-side half of every run plan.
Package policy loads the operator policy — the machine-side half of every run plan.
Package procx holds what every process the runner starts has in common — one place, so a new spawn site has one call to make rather than a flag to remember (nothing enforces the call).
Package procx holds what every process the runner starts has in common — one place, so a new spawn site has one call to make rather than a flag to remember (nothing enforces the call).
Package profile stores a QuickAgent's MCP profile: the persistent, credentialed half of its gateway configuration, keyed by signature — ns/name@version plus the archive digest, the same identity the install cache uses.
Package profile stores a QuickAgent's MCP profile: the persistent, credentialed half of its gateway configuration, keyed by signature — ns/name@version plus the archive digest, the same identity the install cache uses.
Package receipt defines the run result envelope — the runtime counterpart of the registry's public scan report.
Package receipt defines the run result envelope — the runtime counterpart of the registry's public scan report.
internal/genexitclasses command
Command genexitclasses writes the exit-class table as exit-classes.json, the rendering receipt.ExitClassesJSON makes of receipt.ExitClasses, into the file named by its one argument (exit-classes.json in the working folder by default).
Command genexitclasses writes the exit-class table as exit-classes.json, the rendering receipt.ExitClassesJSON makes of receipt.ExitClasses, into the file named by its one argument (exit-classes.json in the working folder by default).
Package session is the interactive run API: what a chat surface — the CLI's TUI, the desktop app — talks to.
Package session is the interactive run API: what a chat surface — the CLI's TUI, the desktop app — talks to.
protocol
Package protocol is the session protocol: an interactive session driven by a program rather than a person, over pipes and with no terminal.
Package protocol is the session protocol: an interactive session driven by a program rather than a person, over pipes and with no terminal.
TTYPrompter: the CLI's Prompter over stdin/stderr.
TTYPrompter: the CLI's Prompter over stdin/stderr.
Package skill reads Agent Skills folders: a SKILL.md whose frontmatter names the skill and says when to use it, and the files it uses.
Package skill reads Agent Skills folders: a SKILL.md whose frontmatter names the skill and says when to use it, and the files it uses.
Package sources is the input-source seam.
Package sources is the input-source seam.
Package spec defines the run plan — the deterministic artifact the capability compiler produces at install time and the engine executes.
Package spec defines the run plan — the deterministic artifact the capability compiler produces at install time and the engine executes.
Package targethost readies a run's target hosts before anything starts: a target host is a machine the person names when a run starts, as the answer to an intake question of type host, and the runner reaches it over SSH from the host link (runnerimage/hostlink), never from the agent's containers.
Package targethost readies a run's target hosts before anything starts: a target host is a machine the person names when a run starts, as the answer to an intake question of type host, and the runner reaches it over SSH from the host link (runnerimage/hostlink), never from the agent's containers.
Package unsafeexec is the data side of Unsafe Mode: the unsafe base image's command index, extras list and ambiguous list, read out of the pulled image and held to a grammar, and the placement of a manifest's declared commands through them.
Package unsafeexec is the data side of Unsafe Mode: the unsafe base image's command index, extras list and ambiguous list, read out of the pulled image and held to a grammar, and the placement of a manifest's declared commands through them.

Jump to

Keyboard shortcuts

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