Developers / integration contract
Inspect a proposed AI action before it reaches an external system.
EthosGate is a controlled pilot for governed evaluation. The current release provides an authenticated workbench for evaluating a structured action request and retaining a reviewable decision record. Execution remains disabled.
Runtime sequence
A decision is more than a score.
- 1. Submit an evaluation request. Provide an identified agent, objective, evidence, and exact proposed action in the workbench.
- 2. Retrieve and evaluate. EthosGate attaches corpus provenance, factual confidence, TIS, HAI, SRQ, and invariant findings.
- 3. Return an evaluation. The workbench presents ALLOW, MODIFY, QUESTION, REVIEW, or REFUSE; it does not execute external actions.
- 4. Record review context. The decision and any human-review state are retained with an audit record.
Current interface
The live, supported interface is the authenticated Convex-backed workbench. A public HTTP endpoint, SDK, provider credential vault, and execution-token verifier are not published in this release, so they are not represented as available APIs.
DecisionRequest {
agentName, objective,
modelInput, modelOutput,
proposedAction, toolMetadata,
declaredUncertainty
}
DecisionResponse {
outcome, directive,
tis, hai, srq,
sources, currentHash
}Request fields
- agentName
- The identified originating agent.
- objective
- The agent's declared goal for this decision.
- modelInput / modelOutput
- Available evidence and a reviewable reasoning summary.
- proposedAction
- The exact downstream action that the workbench evaluates.
- toolMetadata
- Optional tool, target, reversibility, permission, or adapter context.
- declaredUncertainty
- A bounded 0–1 uncertainty declaration from the originating runtime.
Reviewable response
- outcome
- ALLOW, MODIFY, QUESTION, ESCALATE, or REFUSE.
- directive
- A non-executing evaluation outcome, decision stage, and suggested next action.
- tis / hai / srq
- Decomposable operational evaluation signals with evidence.
- sources
- Retrieved canonical corpus snapshots and provenance.
- currentHash
- The SHA-256 hash binding this decision into the ledger.
A public integration is not published yet.
The current release has no public HTTP endpoint, SDK, provider connection, credential vault, or execution-token verifier. The governed learning foundation does not perform training, calibration, adaptive operation, or remote dataset ingestion.