---
typeId: req
recordId: benac-agt-001
fields:
  title: Machine-readable client API
  statement: >-
    Benac shall provide a machine-readable client API for package import, package
    validation, package inspection, package approval requests, capability requests,
    fixture execution, invocation, evidence inspection, effect inspection, diagnostics,
    and local status queries.

    Client API responses shall distinguish package content validity, package import
    status, operation eligibility, Local Policy grants, denied capabilities, unavailable
    artifacts, unavailable resources, not-currently-mediated operations, not-yet-
    determined status, attempted operations, failed operations, and completed
    operations.

    Client API responses shall not classify packages.

    Client API responses shall not classify how package work is performed.
  rationale: >-
    Agents need machine-readable package facts and operation status without depending on
    UI strings or package classes.
  verification: >-
    Agent API tests inspect packages, request approvals, request capabilities, invoke
    package interfaces, and receive stable machine-readable status and diagnostics.
  testable: true
  status: draft
  area: BENAC-AGT
  sourceDocument: user-requested schema-first requirements cleanup
  sourceVersion: 2026-05-06
  sourceSections:
    - Agent API
  order: 185
---
