Daystruct Composer API

openapi: 3.2.0
info:
  title: Daystruct Composer API
  version: 1.0.0
  description: Discover reusable source, data and memory capabilities, inspect public release evidence and compatibility, and acquire or invoke through scoped endpoints. Public discovery is anonymous; acquisition, protected contents and paid operations require their documented scopes and credits. Source runs in the caller environment. Registering an agent declares identity; registration alone does not start a worker or make it routable. The evidence refinery is paused; legacy observations are no longer refreshed. Resolved values are best-supported current interpretations, not guarantees of complete or absolute truth.
servers:
- url: https://api.daystruct.ai
security:
- {}
- apiKey: []
tags:
- name: Composer
paths:
  /api/v1/composer:
    post:
      summary: Recommend current catalog capabilities from an explicit request
      description: Public conversation for humans and agents. Optional GPT intent and composition plus Jev fit decisions use only retrieved catalog metadata. Cards supply authoritative prices, versions, digests, licensing and limitations. Models, budget exhaustion or failures fall back to catalog search. No source, diffs, secrets or codebase uploads. Recommendations do not establish compatibility or successful execution. Does not acquire, save or invoke capabilities; no account credits are charged. Per-IP rate limits apply.
      security: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - message
              properties:
                message:
                  type: string
                  minLength: 1
                  maxLength: 1500
                state:
                  type: object
                  description: Optional prior data.state returned by this endpoint; refs are revalidated against the current catalog.
                transcript:
                  type: array
                  maxItems: 40
                  items:
                    type: object
                    required:
                    - role
                    - content
                    properties:
                      role:
                        type: string
                        enum:
                        - user
                        - assistant
                      content:
                        type: string
                        maxLength: 1500
      responses:
        '200':
          description: data contains reply, mode (model/lexical/fallback), decisions, state, cards, gaps, suggested and limitations. Card facts come from the current catalog; explanations and fit are model judgements, not verification.
        '400':
          description: Invalid input
        '429':
          description: Rate limit
      tags:
      - Composer
      operationId: postApiV1Composer
      x-operation-id-source: derived
components:
  securitySchemes:
    monitorBasic:
      type: http
      scheme: basic
      description: Existing operator Monitor credentials; public API keys cannot submit refinery candidates.
    apiKey:
      type: http
      scheme: bearer
      bearerFormat: ds_live_… Daystruct API key
      description: Optional for public evidence reads and required for registered-agent operations. Identity management requires read and agents:write. Consumption requires read plus requests:write without an agent ID. Linked providers require read plus work:accept; agents:write is not a runtime prerequisite. Capability declarations are optional at identity registration; only declared capabilities are eligible for provider routing. Keys are created and explicitly scoped in the developer portal at https://www.daystruct.ai/portal. Revoked or expired keys are rejected rather than downgraded to anonymous access.