Skip to content
Emdash Mika Docs

LLMs And Manifest

The ⓐ copyable Astro template files include two agent-readable public surfaces:

  • /llms.txt for concise agent context.
  • /.well-known/mika-agent.json for public Mika operation descriptors.

These surfaces describe capabilities and boundaries. They do not grant tool access and do not replace host-owned auth, confirmation, provider wiring, or idempotency.

Public metadata may include route hints for catalog and stock reads. It must not include runnable checkout, account, admin, webhook, payment, or protected agent tools unless the host has built the required auth and policy layer.

Copied Storefront llms.txt

Section titled “Copied Storefront llms.txt”

The template pages/llms.txt.ts returns plain text. It links to the agent manifest, names the public read operations (catalog.sellables and stock.availability), and states that browser mutations use Astro Actions rather than public plugin JSON mutation routes.

Use it as a storefront summary. Keep product pages, cart, checkout, account, wishlist, downloads, and protected tools described as host-owned routes and policies.

Copied Agent Manifest

Section titled “Copied Agent Manifest”

The template pages/.well-known/mika-agent.json.ts returns JSON with:

  • a schema ID from mikaAgentManifestJsonSchema;
  • version from MIKA_AGENT_MANIFEST_VERSION;
  • routeBasePath: "/_emdash/api/plugins/mika";
  • manifest: createMikaAgentManifest({ include: ["public"] });
  • protected-flow summaries for checkout and invoice-style account flows.

The include: ["public"] filter is intentional. createMikaAgentManifest() can include trusted descriptors when used as source material for protected projections, but the public endpoint should only publish safe read descriptors unless the host has built auth, confirmation, replay storage, rate limits, and provider policy around the mutation tools.

Verify the public manifest includes public reads and protected-flow summaries, not mutation tool execution details.

Docs Site LLM Routes

Section titled “Docs Site LLM Routes”

This documentation site also serves /llms.txt, /llms-small.txt, and /llms-full.txt. Those routes are documentation indexes, not storefront metadata. They summarize this Starlight docs collection and keep the same host-owned boundary explicit for retrieval.

Next: Agent Manifest lists exact manifest helpers. Operations lists visibility and idempotency metadata.

Source Anchors

Section titled “Source Anchors”
  • ⓐ ../emdash-mika/src/templates/astro/pages/llms.txt.ts
  • ⓐ ../emdash-mika/src/templates/astro/pages/.well-known/mika-agent.json.ts
  • ⓟ ../emdash-mika/src/agent.ts
  • src/pages/llms.txt.ts
  • src/pages/llms-small.txt.ts
  • src/pages/llms-full.txt.ts