Skip to content

docs: add Embedding Daily Driver guide for host-runtime authors #121

Description

@dgenio

Problem

agent-kernel is an embeddable execution/authorization runtime, not a standalone proxy. The README explains the quickstart and boundaries, but host-runtime authors need a practical daily-use guide for embedding it safely.

Goal

Add a Daily Driver guide for developers adding agent-kernel to an existing agent host or tool runner.

Suggested content

  • When to embed agent-kernel vs use AgentFence at the boundary.
  • Minimal lifecycle: register capability -> grant token -> invoke -> expand frame -> explain trace.
  • How to structure principals, roles, token TTLs, and capability scopes.
  • How to handle failures fail-closed.
  • How to wire policy and audit into a host runtime.
  • How to compose with contextweaver, ChainWeaver, AgentFence, and weaver-spec.
  • Copy-paste instructions for AI coding agents working in this repo.
  • When not to use it: no clear principal model, no reviewed policy, need external proxy only.

Acceptance criteria

  • Add docs/daily-driver.md or equivalent.
  • Link it from README and docs index.
  • Include embedding lifecycle and host-runtime patterns.
  • Include when-not-to-use guidance.
  • Docs/tests pass.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions