End-to-end Coral Cloud workflow — discover registry remote agents, compose and launch a session of agents, then monitor and close it.
--- name: coralos description: End-to-end Coral Cloud workflow — discover registry remote agents, compose and launch a session of agents, then monitor and close it. --- Coral Use this skill to run a complete Coral Cloud session: discover available agents, build and submit a session payload, then monitor and close it. Phase 1 — Discover (Registry) Identify the agent you want to run before composing a session payload. Fast commands: bash scripts/list registry agents.sh bash scripts/inspect registry agent.sh Live endpoints: List: GET https://api.coralcloud.ai/api/v1/registry Inspect: GET https://api.coralcloud.ai/api/v1/registry/{source}/{agentName}/{version} Before moving on, record: source agentName version notable option requirements and constraints If you see {"message":"Not found"}, compare the URL to the current Coral Cloud API guide. --- Phase 2 — Create Session Build and submit a POST /api/v1/local/session payload using the agent identified in Phase 1. Fast commands: bash scripts/create session.sh examples/payloads/echo-session.json bash scripts/create session from simple.sh examples/payloads/simple/echo-session.json Payload notes: Payload shape is strict — start from examples/payloads/echo-session.json or expand from examples/payloads/simple/ using scripts/build coral session payload.py. Required fields: agentGraphRequest, namespaceProvider, execution. Optional: session annotations, extendedEndReport. Custom tool/webhook flows are experimental until callback host policy is confirmed in your environment. Success criteria: Non-error API response Real sessionId in the response --- Phase 3 — Manage Session Monitor progress and clean up after the session is running. Fast command: bash scripts/get session state.sh Live endpoint: State: GET /api/v1/local/session/{namespace}/{sessionId} Verify list and delete routes against your environment before automating cleanup loops. Lifecycle checklist: Session exists Agents connect and begin execution Output appears in Coral Cloud thread when requested Session is closed when no longer needed Success criteria: Real state payload for the target session Evidence of agent progress and/or thread activity