stella-ops.org/git.stella-ops.org
1
0
Fork 0
Code Issues Pull Requests Actions 12 Releases Wiki Activity
Files
3f3473ee3a87e3935e0e5a60f3ce481a3b507c1a
git.stella-ops.org/docs/api/gateway/advisory-ai.md
master 3f3473ee3a
Some checks failed
AOC Guard CI / aoc-guard (push) Has been cancelled
Details
AOC Guard CI / aoc-verify (push) Has been cancelled
Details
Concelier Attestation Tests / attestation-tests (push) Has been cancelled
Details
Docs CI / lint-and-preview (push) Has been cancelled
Details
feat: add Reachability Center and Why Drawer components with tests 
- Implemented ReachabilityCenterComponent for displaying asset reachability status with summary and filtering options.
- Added ReachabilityWhyDrawerComponent to show detailed reachability evidence and call paths.
- Created unit tests for both components to ensure functionality and correctness.
- Updated accessibility test results for the new components.
2025-12-12 18:50:35 +02:00

1.3 KiB
Raw Blame History

Gateway Advisory AI API (Web I)

Status: Interim contract shipped by Web I to unblock SDK/UI work. Align to the authoritative Advisory AI OpenAPI when the gateway routing plugin publishes it.

Overview

  • Gateway routes advisory AI traffic under /advisory/ai/*.
  • Web clients must send tenant + trace headers and should avoid sending raw prompts in telemetry; use prompt hashes instead.

Headers

  • X-StellaOps-Tenant (required)
  • X-Stella-Project (optional)
  • X-Stella-Trace-Id (required)
  • X-Stella-Request-Id (required; defaults to trace ID)
  • X-StellaOps-AI-Profile (optional; e.g. standard)
  • X-StellaOps-Prompt-Hash (recommended; send a stable hash, not the prompt)

Scopes

  • Read: advisory-ai:read
  • Write/operate: advisory-ai:write

Endpoints

POST /advisory/ai/jobs

Creates a new advisory AI job.

  • Request: docs/api/gateway/samples/advisory-ai-start-job.json
  • Response: docs/api/gateway/samples/advisory-ai-start-job-response.json

GET /advisory/ai/jobs/{jobId}

Returns job status and optional results once completed.

POST /advisory/ai/jobs/{jobId}/cancel

Cancels a queued/running job.

GET /advisory/ai/jobs/{jobId}/events

Server-sent events stream (JSON payload per message):

  • Sample NDJSON: docs/api/gateway/samples/advisory-ai-job-events.ndjson