Aller au contenu
API & SDK

Codable, pas seulement designable.

Tout ce qui est conçu dans le Studio est exportable en code. SDK TypeScript + Python officiels. CLI Orchessia. APIs REST + WebSocket. Six surfaces programmables — capsule, swarm, memory, security, observability, event bus.

Quickstart

5 minutes, premier swarm en prod.

Install CLI · init capsule · deploy. Pas de boilerplate, pas de configuration cachée. Le SDK reflète exactement la sémantique du runtime.

terminal · orchessia cli
v3.2.0
sdk · capsule design
import { Capsule, Memory } from "@orchessia/sdk";

const aurelia = new Capsule({
  identity: "did:orch:finance:aurelia",
  personality: { tone: "concise", role: "analyst" },
  memory: Memory.episodic({ ttl: "30d" }),
  tools: ["search", "db", "email"],
  cognitive: {
    intents: ["detect_anomaly", "draft_report"],
    reasoning: "cot",
  },
  healing: {
    rules: [{ symptom: "p95 > 2000", action: "fallback_llm" }],
  },
});

await aurelia.deploy({ target: "sovereign-fr" });

Capsule API

  • POST/api/mount
  • DELETE/api/mount/:id
  • GET/api/capsules
  • POST/api/capsules/:id/invoke

Swarm API

  • POST/api/swarm/create
  • GET/api/swarm/:id/topology
  • POST/api/swarm/:id/dispatch
  • GET/api/swarm/:id/consensus

Memory API

  • POST/api/memory/recall
  • POST/api/memory/store
  • GET/api/memory/graph/:agent
  • DEL/api/memory/expire

Security API

  • POST/api/auth/revoke
  • GET/api/auth/audit
  • POST/api/policy/check
  • GET/api/sandbox/state

Observability API

  • GET/api/observe/metrics
  • GET/api/observe/logs?stream=1
  • GET/api/observe/cognitive/:id
  • GET/api/observe/lineage/:trace

Event Bus

  • WS/api/events?topic=*
  • POST/api/events/publish
  • GET/api/events/subscriptions
  • POST/api/events/replay/:id

Surfaces programmables

Six APIs. Une seule sémantique.

Capsule API

Créer, déployer, invoquer, lister des capsules. Manifest YAML versionné. Identity Ed25519 obligatoire.

Swarm API

Composer des swarms par topology. Dispatch, consensus, byzantine fault tolerance. HITL gates programmatique.

Memory API

Recall, store, graph, expire. Hybride épisodique + vector + graph. TTL différenciés par sensibilité.

Security API

Auth revoke, audit chain, policy check, sandbox state. Token revocation propagée multi-nodes.

Observability API

Metrics Prometheus, logs SSE stream, cognitive state per capsule, lineage trace navigable.

Event Bus

WebSocket pub/sub structuré. Publish, subscribe, replay. Format JSONL append-only signé.

Standard ouvert

Spec capsule .cap publique.
Interopérable, vendor-neutral.

Le format .cap (manifest YAML + identity Ed25519 + DRM payload) est documenté publiquement. Toute capsule conforme est exécutable sur n'importe quel runtime compatible. Pas de lock-in vendor.

Lire la spec .cap →Documentation complète →

apiVersion: mar.io/v1

kind: Capsule

metadata:

name: aurelia

identity: did:orch:finance:a4f2

spec:

personality: { tone: concise }

memory: { ttl: 30d }

tools: [search, db, email]

cognitive:

reasoning: cot

intents: [detect_anomaly]

healing:

enabled: true

rules: [...]

Prêt à coder ?

Le Studio est gratuit pour démarrer. Pas de carte bancaire, pas de limite sur le SDK. Vous obtenez tout : capsule, swarm, runtime, console, observabilité.

Launch Studio →← Retour à l'accueil