runnerimage

package
v0.7.55-dev.1 Latest Latest
Warning

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

Go to latest
Published: Nov 11, 2026 License: MIT Imports: 10 Imported by: 0

Documentation

Overview

Package runnerimage is the embedded build context of the locally built agentry-runner image. The tree leads a double life: in this repo it is ordinary unit-tested Go source; at first `agentry run` it is written out verbatim and compiled standalone inside `docker build`. Self-containment is the point (first use must need no registry of ours), so everything embedded here is stdlib-only, and TestEmbeddedSourcesStdlibOnly keeps it that way.

Index

Constants

View Source
const ImageTagPrefix = "agentry-runner"

ImageTagPrefix names the locally built runner image; the engine derives container images from ImageTag and never pulls this name from anywhere.

Variables

This section is empty.

Functions

func ContentVersion

func ContentVersion() string

ContentVersion identifies the embedded build context by content: the first 12 hex digits of a SHA-256 over every embedded file's path and bytes (tests excluded, the same set Materialize writes out) and the generated go.mod, whose go line decides the oldest builder that may compile the image. Two clients that embed the same context — the CLI and the desktop app at whatever versions — derive the same tag and therefore share one built image; a change to the context changes the tag and forces a rebuild. Deriving the tag from each client's own release version would have two clients on one machine build two images of identical content, and a plan compiled by one could fail the other's gateway probe with exit 13.

func DefaultImageTag

func DefaultImageTag() string

DefaultImageTag is the tag every client builds and runs by default: ImageTagPrefix + ":" + ContentVersion(). A policy `images.runner` pin still wins (policy.RunnerImageTag).

func ImageTag

func ImageTag(version string) string

ImageTag returns the local image tag for one CLI version, e.g. "agentry-runner:0.3.0". A version that is empty or would not survive docker's tag grammar (charset [A-Za-z0-9_.-], no leading '.' or '-', bounded length) becomes "dev" rather than a build error at run time — the tag only namespaces local builds, it proves nothing.

func Materialize

func Materialize(dir string) error

Materialize writes the standalone build context into dir: the embedded files placed under dir/runnerimage/ (Dockerfile promoted to dir/Dockerfile), *_test.go files skipped, plus a generated dir/go.mod (module github.com/blaktron/agentry-cli, the CLI's go line) so the context compiles with no network access beyond the base images, and a dir/.dockerignore excluding tests. Overwrite-safe: MkdirAll + WriteFile, so re-materializing over an existing context just refreshes it.

Types

This section is empty.

Directories

Path Synopsis
Package applink is the app link: the MCP server through which a persistent agent reaches the application that runs it, and nothing else.
Package applink is the app link: the MCP server through which a persistent agent reaches the application that runs it, and nothing else.
Package beneath holds a name beneath a directory: every open, make, remove, rename and ownership change resolves its path from a directory the caller opened, and a path that would leave it is refused.
Package beneath holds a name beneath a directory: every open, make, remove, rename and ownership change resolves its path from a directory the caller opened, and a path that would leave it is refused.
Package bridge is the runner image's bridge role: a stdio MCP server the gateway launches like any declared server, which forwards each message to one remote MCP server over streamable HTTP, or over the older HTTP+SSE transport where that is all the server speaks.
Package bridge is the runner image's bridge role: a stdio MCP server the gateway launches like any declared server, which forwards each message to one remote MCP server over streamable HTTP, or over the older HTTP+SSE transport where that is all the server speaks.
Package brotli decodes the Brotli compressed data format (RFC 7932).
Package brotli decodes the Brotli compressed data format (RFC 7932).
Package confine holds a declared exec command to the places it may write.
Package confine holds a declared exec command to the places it may write.
Package decode is the runner image's `decode` role: it turns the documents under one directory into plain text under another, before any agent sees them, so a run reads text and no model ever runs a decoder.
Package decode is the runner image's `decode` role: it turns the documents under one directory into plain text under another, before any agent sees them, so a run reads text and no model ever runs a decoder.
Package desktoplink is the desktop link: the MCP servers through which a run reaches the applications installed on the person's own computer, and nothing else.
Package desktoplink is the desktop link: the MCP servers through which a run reaches the applications installed on the person's own computer, and nothing else.
Package docpages is the document a Report Designer run is given to build a design around: one PDF, whose first pages poppler's page renderer turns into PNG images, or one Word document, whose theme part declares its fonts and colours and whose headers, footers and pictures are read as they are.
Package docpages is the document a Report Designer run is given to build a design around: one PDF, whose first pages poppler's page renderer turns into PNG images, or one Word document, whose theme part declares its fonts and colours and whose headers, footers and pictures are read as they are.
docpagestest
Package docpagestest makes the documents the Report Designer's tests read: a PDF of plain pages and a Word document with a theme, running text and a picture.
Package docpagestest makes the documents the Report Designer's tests read: a PDF of plain pages and a Word document with a theme, running text and a picture.
Package hostlink is the runner's host link: the MCP server through which an agent works a target host, a machine the person named when the run started.
Package hostlink is the runner's host link: the MCP server through which an agent works a target host, a machine the person named when the run started.
Package ical reads an iCalendar (RFC 5545) feed, the ICS document a calendar service publishes at a subscription address, and expands its events into the occurrences that fall in a window: recurrences (RRULE, RDATE, EXDATE), the instances a feed overrides (RECURRENCE-ID), all-day events and the time zones events are written in.
Package ical reads an iCalendar (RFC 5545) feed, the ICS document a calendar service publishes at a subscription address, and expands its events into the occurrences that fall in a window: recurrences (RRULE, RDATE, EXDATE), the instances a feed overrides (RECURRENCE-ID), all-day events and the time zones events are written in.
Package judge is the one client for TypeSafe AI's Jev and the question sets it is asked.
Package judge is the one client for TypeSafe AI's Jev and the question sets it is asked.
Package messenger is the messenger role of the runner image: the one container that holds a messenger account's credential and its connection to that messaging service, for a persistent agent the person can talk to from there.
Package messenger is the messenger role of the runner image: the one container that holds a messenger account's credential and its connection to that messaging service, for a persistent agent the person can talk to from there.
Package minimize is the runner image's `minimize` role: run once by `docker build`, it turns the shared runner image into a per-QuickAgent exec image that holds ONLY the declared commands.
Package minimize is the runner image's `minimize` role: run once by `docker build`, it turns the shared runner image into a per-QuickAgent exec image that holds ONLY the declared commands.
Package netaddr is the runner's one rule for a public address: the ranges web_read, the input-source proxy and the browse proxy never connect to, among them the 6to4 relay anycast range, Azure's wireserver, the IPv6 discard prefix and site-local space, and an ISATAP address that carries an IPv4 address that is not public.
Package netaddr is the runner's one rule for a public address: the ranges web_read, the input-source proxy and the browse proxy never connect to, among them the 6to4 relay anycast range, Azure's wireserver, the IPv6 discard prefix and site-local space, and an ISATAP address that carries an IPv4 address that is not public.
Package netproxy is the llm-proxy of the agent-container topology: the run network is created --internal, so the ONLY way anything the agent container runs can reach the outside world is a CONNECT tunnel through this proxy — and the proxy tunnels only to the operator's model endpoints (policy.model.proxyAllow).
Package netproxy is the llm-proxy of the agent-container topology: the run network is created --internal, so the ONLY way anything the agent container runs can reach the outside world is a CONNECT tunnel through this proxy — and the proxy tunnels only to the operator's model endpoints (policy.model.proxyAllow).
Package portrelay carries one TCP connection to a port of the container's own loopback over stdio: the runner execs it in the Coding agent's tools server for each connection to a port published on the person's computer.
Package portrelay carries one TCP connection to a port of the container's own loopback over stdio: the runner execs it in the Coding agent's tools server for each connection to a port published on the person's computer.
Package probe is the runner image's gateway probe: the health check every run makes before its agent starts (an authenticated MCP initialize from inside the run network), and, for a session, the listing of the tools the gateway serves.
Package probe is the runner image's gateway probe: the health check every run makes before its agent starts (an authenticated MCP initialize from inside the run network), and, for a session, the listing of the tools the gateway serves.
Package reportdesign is the one definition of a report design: the theme document version 3 that sets the look of a person's PDF reports, a whole brand.
Package reportdesign is the one definition of a report design: the theme document version 3 that sets the look of a person's PDF reports, a whole brand.
Package send is the runner image's `deliver` role: the delivery step that hands a finished run's deliverables to a destination the person chose.
Package send is the runner image's `deliver` role: the delivery step that hands a finished run's deliverables to a destination the person chose.
Package sockfilter is the per-run filter between a run's MCP gateway and the docker daemon.
Package sockfilter is the per-run filter between a run's MCP gateway and the docker daemon.
Package source is the runner image's `source` role: the fetch step that brings a run's input source in before the run, as plain files under one directory.
Package source is the runner image's `source` role: the fetch step that brings a run's input source in before the run, as plain files under one directory.
Package toolargs decodes the arguments of a model's tool call.
Package toolargs decodes the arguments of a model's tool call.
Package toolsrv implements the Agentry companion tools server: one MCP stdio server whose tool surface is constructed from the manifest's capability contract.
Package toolsrv implements the Agentry companion tools server: one MCP stdio server whose tool surface is constructed from the manifest's capability contract.
Package webscan is AI Review of what the Drafter's web tools bring back, before its model reads any of it.
Package webscan is AI Review of what the Drafter's web tools bring back, before its model reads any of it.
Package websearch is web search behind one small interface.
Package websearch is web search behind one small interface.

Jump to

Keyboard shortcuts

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