Skip to content
Arka Platform

Extending arka-deck

Audience: developer who wants to add a capability to arka-deck — an addon, an AI provider, a headless worker, an external connector.

Contents

Section titled “Contents”

Tutorials (step-by-step)

Section titled “Tutorials (step-by-step)”
  • ecrire-un-addon.md — build a first-party addon from scratch: manifest, register, EventBus subscription, before-turn context augmentation, tests, composition wiring
  • ecrire-un-provider.md — wire a new AI provider: SDK, chat runtime, key management, registry
  • ecrire-un-worker.md — design a 1-shot headless worker: manifest, prompt source, runtime, integration from a parent addon
  • ecrire-un-connecteur.md — add an external connector (Notion, Zapier, etc.): OAuth, actions, audit trail

Reference

Section titled “Reference”
  • contrat-addon.md — formal manifest schema, available dependencies, EventBus API, event catalogue, storage conventions
  • catalogue-addons-firstparty.md — overview of embedded addons and link to their fact sheet

Before you start

Section titled “Before you start”
  • First read ../architecture/overview.md to understand the layers.
  • Check the relevant ADRs: 0002 Addon contract for addons, 0003 Materializer for agent artifacts, 0006 Anti-SSRF for providers.
  • Run the existing tests to confirm a healthy environment (npm test).

Documentation status

Section titled “Documentation status”

The skeleton is in place. ecrire-un-addon.md and contrat-addon.md are migrated from docs/dev/addons/guide-creation-addon.md and docs/dev/addons/contrat-addon.md during lot P3. Other tutorials are written during lot P4.