arazzo: 1.0.1
info:
  title: DeltaSignal ATLAS-7 Agent Workflows
  summary: Scenario pipelines for agents using DeltaSignal public x402 routes, the MCP JSON-RPC endpoint, and the operator audit-status surface.
  description: >
    This Arazzo document complements the DeltaSignal OpenAPI contract. OpenAPI
    describes individual operations; this file describes the recommended
    scenario pipelines that agents should follow for onboarding, market scans,
    single-issuer diligence, daily monitoring, MCP composite presets, and
    internal operator audit-status checks.
  version: 0.1.0
sourceDescriptions:
  - name: deltasignalOpenAPI
    type: openapi
    url: https://api.aitrailblazer.net/openapi.json
  - name: deltasignalX402
    type: other
    url: https://api.aitrailblazer.net/.well-known/x402
x-deltasignal-contract:
  publicBaseUrl: https://api.aitrailblazer.net
  mcpEndpoint: https://api.aitrailblazer.net/mcp
  publicPaymentRail: x402
  x402:
    network: eip155:8453
    asset: USDC
    payTo: "0x6D91ADF2c545047cbbC5b37a5f457cce081B48d3"
  internalBypass:
    audience: first_party_internal
    headers:
      - x-api-key
      - mcp-api-key
    publicInstallGuidance: Public clients should use x402, not internal key headers.
workflows:
  - workflowId: publicMcpX402Handshake
    summary: Discover MCP tools and validate the public paid tool-call route.
    description: >
      Use this before a public agent attempts paid MCP tool calls. Public MCP
      metadata methods such as tools/list are free for discovery. The first
      actual tools/call without payment is expected to return HTTP 402 so an
      x402-capable client can pay and retry the same tool call.
    x-audience: public
    x-payment-rail: x402
    x-agent-intent:
      - onboarding
      - payment_handshake
      - mcp_discovery
    inputs:
      type: object
      properties: {}
    steps:
      - stepId: postMcpToolsListWithoutPayment
        description: Call the MCP endpoint without payment to inspect public tool metadata.
        operationId: callDeltaSignalMCP
        x-deltasignal-path: /mcp
        x-http-method: POST
        x-payment-rail: none
        x-expected-status: 200
        requestBody:
          payload:
            jsonrpc: "2.0"
            id: tools
            method: tools/list
            params: {}
        successCriteria:
          - condition: $statusCode == 200
          - condition: $.result.tools.length >= 1
      - stepId: postMcpToolCallWithoutPayment
        description: Call a real MCP tool without payment to receive a Base x402 challenge.
        operationId: callDeltaSignalMCP
        x-deltasignal-path: /mcp
        x-http-method: POST
        x-payment-rail: x402
        x-expected-status: 402
        requestBody:
          payload:
            jsonrpc: "2.0"
            id: readiness
            method: tools/call
            params:
              name: deltasignal_readiness
              arguments: {}
        successCriteria:
          - condition: $statusCode == 402
        x-agent-next-action: Retry the same tools/call request through an x402-capable client after payment.

  - workflowId: internalMcpToolSmoke
    summary: First-party no-payment MCP smoke on the same endpoint.
    description: >
      Internal Codex and Claude validation should stay as close as possible to
      the public MCP path by using POST /mcp with x-api-key or mcp-api-key.
      This workflow is not public install guidance.
    x-audience: internal
    x-public-docs: false
    x-payment-rail: internal_api_key_bypass
    x-agent-intent:
      - regression_smoke
      - mcp_tool_inventory
      - readiness_probe
    steps:
      - stepId: listToolsWithInternalBypass
        operationId: callDeltaSignalMCP
        x-deltasignal-path: /mcp
        x-http-method: POST
        x-mcp-method: tools/list
        x-expected-status: 200
        requestBody:
          payload:
            jsonrpc: "2.0"
            id: tools
            method: tools/list
            params: {}
        successCriteria:
          - condition: $statusCode == 200
          - condition: $.result.tools.length >= 21
      - stepId: callReadinessTool
        operationId: callDeltaSignalMCP
        x-deltasignal-path: /mcp
        x-http-method: POST
        x-mcp-tool: deltasignal_readiness
        x-expected-status: 200
        requestBody:
          payload:
            jsonrpc: "2.0"
            id: readiness
            method: tools/call
            params:
              name: deltasignal_readiness
              arguments: {}
        successCriteria:
          - condition: $statusCode == 200
          - condition: $.result.structuredContent.data.status == "ok"

  - workflowId: atlas7AuditStatusCheck
    summary: Verify the Azure-native ATLAS-7 regression audit is healthy.
    description: >
      Use this internal/operator workflow when a user asks whether ATLAS-7 is
      current, healthy, monitored, Azure-native, or fully regression-tested.
      The REST route and MCP tool both read the latest Azure Blob summary from
      the scheduled Go audit job. This is an operational readiness surface, not
      an issuer-analysis or paid data workflow.
    x-audience: internal
    x-public-docs: true
    x-payment-rail: internal_api_key_bypass
    x-agent-intent:
      - audit_status
      - regression_health
      - operator_readiness
      - azure_native_monitoring
    steps:
      - stepId: getAtlas7AuditStatus
        operationId: getAtlas7AuditStatus
        x-deltasignal-path: /v1/atlas7/audit/latest
        x-http-method: GET
        x-mcp-tool: deltasignal_atlas7_audit_status
        x-expected-status: 200
        successCriteria:
          - condition: $statusCode == 200
          - condition: $.status == "healthy"
          - condition: $.stale == false
          - condition: $.issuer_count == 215
          - condition: $.failed_count == 0
          - condition: $.historical_failed_count == 0
          - condition: $.composite_failed_count == 0
    x-agent-output:
      preserveFields:
        - status
        - stale
        - artifact.prefix
        - finished_at_utc
        - issuer_count
        - operation_count
        - failed_count
        - historical_failed_count
        - composite_failed_count
      summaryTemplate: "ATLAS-7 audit status: {status}; stale={stale}; issuers={issuer_count}; operations={operation_count}; failures={failed_count}; historical_failures={historical_failed_count}; composite_failures={composite_failed_count}; artifact={artifact.prefix}."

  - workflowId: marketReadinessScan
    summary: Market-wide operating picture for agents.
    description: >
      Start here when a user asks what is happening across the crypto public
      issuer universe. This avoids issuer-level raw evidence until the agent has
      identified names worth drilling into.
    x-audience: public
    x-payment-rail: x402
    x-agent-intent:
      - market_scan
      - readiness
      - pressure_board
      - alpha_screen
    steps:
      - stepId: getReadiness
        operationId: getX402DeltaSignalReadiness
        x-deltasignal-path: /v1/readiness
        x-http-method: GET
        x-payment-rail: x402
        successCriteria:
          - condition: $statusCode == 200
      - stepId: getRiskDistribution
        operationId: getX402RiskDistribution
        x-deltasignal-path: /v1/risk-distribution
        x-http-method: GET
        x-payment-rail: x402
        successCriteria:
          - condition: $statusCode == 200
      - stepId: getTopStressed
        operationId: getX402TopStressedCryptoIssuers
        x-deltasignal-path: /v1/top-stressed
        x-http-method: GET
        x-payment-rail: x402
        parameters:
          query:
            limit: 10
        successCriteria:
          - condition: $statusCode == 200
      - stepId: getAlphaOpportunities
        operationId: getX402ListAlphaOpportunities
        x-deltasignal-path: /v1/alpha-opportunities
        x-http-method: GET
        x-payment-rail: x402
        parameters:
          query:
            limit: 10
        successCriteria:
          - condition: $statusCode == 200
    x-agent-output:
      recommendedNextTools:
        - deltasignal_company_report
        - deltasignal_quick_ticker_check
        - deltasignal_daily_change_evidence

  - workflowId: singleIssuerDiligence
    summary: Full single-issuer diligence pipeline.
    description: >
      Use this when the user names a ticker and wants a structured issuer view:
      fundamentals, alpha signal, covenant stress, peer rank, and optional
      historical ATLAS context.
    x-audience: public
    x-payment-rail: x402
    x-agent-intent:
      - issuer_diligence
      - company_report
      - risk_and_alpha
    inputs:
      type: object
      required:
        - ticker
      properties:
        ticker:
          type: string
          pattern: "^[A-Z0-9.-]{1,10}$"
    steps:
      - stepId: getCompanyFundamentals
        operationId: getX402CompanyFundamentals
        x-deltasignal-path: /v1/company-fundamentals/{ticker}
        x-http-method: GET
        x-payment-rail: x402
        parameters:
          path:
            ticker: $inputs.ticker
        successCriteria:
          - condition: $statusCode == 200
      - stepId: getAlphaSignals
        operationId: getX402AlphaSignals
        x-deltasignal-path: /v1/alpha-signals/{ticker}
        x-http-method: GET
        x-payment-rail: x402
        parameters:
          path:
            ticker: $inputs.ticker
        successCriteria:
          - condition: $statusCode == 200
      - stepId: getCovenantStress
        operationId: getX402CovenantStress
        x-deltasignal-path: /v1/covenant-stress/{ticker}
        x-http-method: GET
        x-payment-rail: x402
        parameters:
          path:
            ticker: $inputs.ticker
        successCriteria:
          - condition: $statusCode == 200
      - stepId: getPeerRanking
        operationId: getX402PeerCovenantRanking
        x-deltasignal-path: /v1/peer-ranking/{ticker}
        x-http-method: GET
        x-payment-rail: x402
        parameters:
          path:
            ticker: $inputs.ticker
        successCriteria:
          - condition: $statusCode == 200
      - stepId: getAtlasHistory
        operationId: getX402AtlasHistory
        x-deltasignal-path: /v1/atlas-history/{ticker}
        x-http-method: GET
        x-payment-rail: x402
        x-optional: true
        parameters:
          path:
            ticker: $inputs.ticker
          query:
            limit: 30
        successCriteria:
          - condition: $statusCode == 200
    x-mcp-equivalent:
      operationId: callDeltaSignalMCP
      tool: deltasignal_company_report
      arguments:
        ticker: $inputs.ticker

  - workflowId: dailyMonitoringEvidenceDrilldown
    summary: Daily changes followed by explicit evidence drilldown.
    description: >
      Use the compact daily monitor first. Only request raw issuer evidence when
      the user asks why a specific issuer moved or when a downstream workflow
      needs source-level proof.
    x-audience: public
    x-payment-rail: x402
    x-agent-intent:
      - daily_monitoring
      - evidence_drilldown
      - source_proof
    inputs:
      type: object
      properties:
        ticker:
          type: string
          pattern: "^[A-Z0-9.-]{1,10}$"
        source_date:
          type: string
          format: date
    steps:
      - stepId: getLatestDailyChanges
        operationId: getX402LatestDailyChanges
        x-deltasignal-path: /v1/daily-changes/latest
        x-http-method: GET
        x-payment-rail: x402
        successCriteria:
          - condition: $statusCode == 200
      - stepId: getDailyChangeEvidence
        operationId: getX402DailyChangeEvidence
        x-deltasignal-path: /v1/daily-changes/evidence
        x-http-method: GET
        x-payment-rail: x402
        x-run-when: User explicitly requests raw evidence for one issuer/change.
        parameters:
          query:
            ticker: $inputs.ticker
            source_date: $inputs.source_date
            limit: 25
        successCriteria:
          - condition: $statusCode == 200

  - workflowId: mcpCompositePresetSelection
    summary: Preferred MCP composite tools for agent UX.
    description: >
      Use server-enforced composite tools when the user asks for common
      workflows. Do not manually fan out low-level calls unless the user asks
      for a custom analysis or the composite is unavailable.
    x-audience: public
    x-payment-rail: x402
    x-agent-intent:
      - mcp_composite_presets
      - scenario_selection
    steps:
      - stepId: morningBriefPreset
        operationId: callDeltaSignalMCP
        x-deltasignal-path: /mcp
        x-http-method: POST
        x-mcp-tool: deltasignal_morning_brief
        x-price-usd: 0.18
        x-user-intent: Daily market scan.
        requestBody:
          payload:
            jsonrpc: "2.0"
            id: morning_brief
            method: tools/call
            params:
              name: deltasignal_morning_brief
              arguments: {}
      - stepId: companyReportPreset
        operationId: callDeltaSignalMCP
        x-deltasignal-path: /mcp
        x-http-method: POST
        x-mcp-tool: deltasignal_company_report
        x-price-usd: 0.30
        x-user-intent: Full single-ticker diligence package.
        requestBody:
          payload:
            jsonrpc: "2.0"
            id: company_report
            method: tools/call
            params:
              name: deltasignal_company_report
              arguments:
                ticker: $inputs.ticker
      - stepId: pressureBoardPreset
        operationId: callDeltaSignalMCP
        x-deltasignal-path: /mcp
        x-http-method: POST
        x-mcp-tool: deltasignal_pressure_board
        x-price-usd: 0.14
        x-user-intent: Risk-focused monitoring view.
        requestBody:
          payload:
            jsonrpc: "2.0"
            id: pressure_board
            method: tools/call
            params:
              name: deltasignal_pressure_board
              arguments: {}
      - stepId: alphaSweepPreset
        operationId: callDeltaSignalMCP
        x-deltasignal-path: /mcp
        x-http-method: POST
        x-mcp-tool: deltasignal_alpha_sweep
        x-price-usd: 0.14
        x-user-intent: Opportunity-focused market screen.
        requestBody:
          payload:
            jsonrpc: "2.0"
            id: alpha_sweep
            method: tools/call
            params:
              name: deltasignal_alpha_sweep
              arguments: {}
      - stepId: quickTickerCheckPreset
        operationId: callDeltaSignalMCP
        x-deltasignal-path: /mcp
        x-http-method: POST
        x-mcp-tool: deltasignal_quick_ticker_check
        x-price-usd: 0.18
        x-user-intent: Fast single-name sanity check.
        requestBody:
          payload:
            jsonrpc: "2.0"
            id: quick_ticker_check
            method: tools/call
            params:
              name: deltasignal_quick_ticker_check
              arguments:
                ticker: $inputs.ticker