https://go-steer.github.io/core-agent/docs/library/Recent content in Using the library on core-agentHugoen-ushttps://go-steer.github.io/core-agent/docs/library/guide/Mon, 01 Jan 0001 00:00:00 +0000https://go-steer.github.io/core-agent/docs/library/guide/<p>This guide is for Go engineers embedding <code>core-agent</code> in their own binary. Where the <a href="../user-guide/">user guide</a> is about configuring the bundled CLI, this one is about <em>extending</em> the library — replacing the CLI&rsquo;s defaults with your own UI, tools, providers, and runtime topology.</p> <p>The full API reference lives in <a href="../library-api/">Library API</a>. This guide is the narrative path through it, organized by extension point with worked examples for each.</p> <h2 id="who-this-is-for">Who this is for</h2> <p>You&rsquo;re a Go engineer building one of:</p>https://go-steer.github.io/core-agent/docs/library/api/Mon, 01 Jan 0001 00:00:00 +0000https://go-steer.github.io/core-agent/docs/library/api/<p><code>core-agent</code> is designed to be embedded as a Go library. The bundled <code>cmd/core-agent</code> is a thin reference wrapper; production consumers will typically write their own binary that composes these packages.</p> <hr> <h2 id="package-overview">Package overview</h2> <table> <thead> <tr> <th>Import path</th> <th>Purpose</th> </tr> </thead> <tbody> <tr> <td><code>github.com/go-steer/core-agent/agent</code></td> <td>Multi-turn agent wrapping ADK&rsquo;s <code>llmagent + runner</code>.</td> </tr> <tr> <td><code>github.com/go-steer/core-agent/instruction</code></td> <td><code>AGENTS.md</code> / <code>CLAUDE.md</code> / <code>GEMINI.md</code> fallback loader.</td> </tr> <tr> <td><code>github.com/go-steer/core-agent/config</code></td> <td><code>.agents/config.json</code> schema, discovery, atomic persist.</td> </tr> <tr> <td><code>github.com/go-steer/core-agent/permissions</code></td> <td>Ask / allow / yolo gate; bash denylist; path scope.</td> </tr> <tr> <td><code>github.com/go-steer/core-agent/tools</code></td> <td><code>GateToolset</code> wrapper bridging permissions to ADK toolsets.</td> </tr> <tr> <td><code>github.com/go-steer/core-agent/mcp</code></td> <td>MCP server lifecycle from <code>.agents/mcp.json</code>.</td> </tr> <tr> <td><code>github.com/go-steer/core-agent/skills</code></td> <td><code>SKILL.md</code> discovery → ADK <code>skilltoolset</code>.</td> </tr> <tr> <td><code>github.com/go-steer/core-agent/models</code></td> <td><code>Provider</code> interface + registry / <code>Resolve()</code>.</td> </tr> <tr> <td><code>github.com/go-steer/core-agent/pkg/models/gemini</code></td> <td>Gemini API + Vertex AI provider.</td> </tr> <tr> <td><code>github.com/go-steer/core-agent/pkg/models/anthropic</code></td> <td>Anthropic / Claude provider (first-party + Vertex).</td> </tr> <tr> <td><code>github.com/go-steer/core-agent/telemetry</code></td> <td>OpenTelemetry exporter setup.</td> </tr> <tr> <td><code>github.com/go-steer/core-agent/usage</code></td> <td>Per-turn token + cost tracker.</td> </tr> <tr> <td><code>github.com/go-steer/core-agent/session</code></td> <td>Transcript persistence (<code>.agents/sessions/</code>).</td> </tr> <tr> <td><code>github.com/go-steer/core-agent/runner</code></td> <td>Headless (one-shot) + REPL (multi-turn) drivers.</td> </tr> </tbody> </table> <hr> <h2 id="minimal-example">Minimal example</h2> <p>The shortest possible program: pick a Gemini model, run one turn, print partial text:</p>