Agent-Friendly API + Skill

This page documents the official machine-facing integration surface for Arklib Iteration 37.

What was added

• Versioned REST API at /api/agent/v1
• OpenAPI document at /api/agent/v1/openapi
• Raw skill markdown endpoint at /skill.md for bot fetch/discovery
• Wallet-session-authenticated write intent endpoints
• Presence wrappers with viewer/session consistency checks
• In-app execution helper: executeAgentIntent
• Official root skill runbook (SKILL.md)

Core endpoint groups

• GET /api/agent/v1/meta
• GET /api/agent/v1/openapi
• GET /api/agent/v1/auth/session
• GET /api/agent/v1/spaces and space/page/revision/backlink read routes
• GET /api/agent/v1/search/pages
• POST /api/agent/v1/intents/* for space/page lifecycle + ownership + extension
• POST|PATCH|DELETE /api/agent/v1/presence/*

Write model

Write routes return validated intents (sdkCall + optional followUpCalls + postconditions). Transactions remain wallet-signed by the caller; no server-custodied owner write path is used.

Official SKILL.md access and usage

1. Fetch the official skill as raw markdown: GET /skill.md.
2. If working from the repository, read the root file directly: SKILL.md.
3. Follow the runbook sections in order: setup, wallet-session auth flow, deterministic reads, write intents, and error handling.
4. For automation/agent integrations, fetch /skill.md at runtime to stay aligned with the current runbook text.