slim

command
v0.10.0 Latest Latest
Warning

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

Go to latest
Published: Oct 30, 2026 License: Apache-2.0 Imports: 15 Imported by: 0

README

Slim embed — reference consumer

This is the reference consumer for the slim-embed guarantee (docs/library-api-design.md, "Slim-embed guarantee"): a single-file host service embedding exactly one mast control loop in-process — a SingleTurn classifier feeding one Task specialist over in-memory sessions — and nothing else.

host process
  └─ ADK runner
       └─ slim_triage (workflow graph root)
            START → classify (SingleTurn) → run_triage (Task specialist)

What matters here is what this program imports, not what it serves. The loop runs over hardcoded sample inputs because the point is the dependency graph, not the transport.

Run it

go run ./examples/deploy/slim

No credentials, no network: the loop runs on mast's offline echo model. Swapping in a real model is one ADK import (google.golang.org/adk/v2/model/gemini) — see the comment in main.go.

Pay for what you import

The slim slice this example pulls:

Import What it buys
pkg/specialists Programmatic specialist Specs + Build (file loading via LoadDir optional)
pkg/budget In-process usage meter + cost ceilings (optional)
ADK v2 (runner, session, workflow, …) + stdlib The loop itself

What it must not pull — enforced in CI by scripts/check-slim-deps.sh, which fails any PR whose changes grow this example's transitive dependency graph:

  • internal/inject (HTTP inject/resume/abort server)
  • internal/observability (Prometheus registry, OTel SDK wiring) — and with it github.com/prometheus/..., the OTel SDK, and the OTLP exporters
  • internal/mcp — and with it github.com/modelcontextprotocol/go-sdk
  • internal/graph, internal/router (workload dispatch shapes)
  • internal/config (.agents/ discovery)

One honest caveat: the OTel API (go.opentelemetry.io/otel, /trace, /metric) is in the graph regardless, because ADK v2's model path (google.golang.org/genai) imports it directly. Those are no-op stubs unless an SDK is installed; the SDK and exporters stay out. The CI check denylists the heavy parts and documents this.

Growing from here

Some of what you might need later is one config value away:

  • Durability: swap session.InMemoryService() for ADK's session/database service over SQLite in the same runner.Config field.
  • Budgets: already here — pkg/budget is part of the slim slice.
  • MCP tools: ADK's own mcptoolset goes into the specialists' BuildOptions.Toolsets like any other toolset. (mast's MCP wiring — the error-body wrap, response digesting — is the daemon's, and is not importable.)
  • HITL pauses: emit RequestInput interrupts from the workflow nodes and feed operator verdicts back through the runner; internal/graph in this repository is a worked example to read, not to import.

The rest is not. The inject server, mast's metric families, the attach and AG-UI surfaces, schedules and the write gate's daemon half live under internal/ and are not importable from outside this module (#301). When you need them, the path is the binary: run mast — and, once #301's cli package ships, build your own main.go around it with your own models and tools — rather than a pile of imports that reassembles the daemon by hand.

If you don't need any of mast's governance or durability and never will, use raw ADK v2 — see the routing note in docs/positioning.md, "Smaller agents, slim embeds".

Documentation

Overview

Command slim is the reference consumer for the slim-embed guarantee (docs/library-api-design.md, "Slim-embed guarantee"): a single-file host service embedding exactly one mast control loop in-process — a SingleTurn classifier feeding one Task specialist — with in-memory sessions and nothing else.

What matters here is what this file IMPORTS, not what it serves: only the slim slice (pkg/specialists, pkg/budget) plus ADK v2 and stdlib. No inject server, no metrics endpoint, no MCP, no dispatch shapes, no .agents/ discovery. CI enforces that this dependency graph stays slim (scripts/check-slim-deps.sh).

Jump to

Keyboard shortcuts

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