Live route · source preview

Inspect an agent. Preflight its action. Verify the record.

Agent Control Developer Kit v0.1 turns the existing Ryntra Agent Control slices into one typed local developer contract. It reads bounded public evidence, drafts strict intents, runs deterministic preview policy and verifies integrity. It has no write tool.

Run the local source example Open the sample workbench

HTTP: 7 operations
MCP: 7 local tools
Network scope: BSC Testnet · 97
Write surface: 0 tools

Run the complete non-executing reference flow

Start the Ryntra application locally, then run the workspace example against that origin. The example inspects an agent, drafts an intent, runs preflight and verifies the resulting Action Passport Preview.

No package download

Local source command

AGENTVERSE_ADDRESS=<EXACT_AGENTVERSE_ADDRESS> \
RYNTRA_BASE_URL=http://localhost:3000 \
node examples/agent-control-builder/example.ts

AGENTVERSE_ADDRESS is required and selects the exact public record to inspect. RYNTRA_BASE_URL is optional and defaults to https://ryntra.io; the command above pins it to the local origin explicitly.

01
Inspect
agentPassport(address)
Separate provider declarations from Ryntra observations, conflicts and unknowns.
02
Draft
draft_agent_action_intent
Create a strict versioned proposal without creating a provider job.
03
Preflight
preflight(input)
Run deterministic policy and keep the human decision outside the verdict.
04
Verify
verifyActionPassportPreview(passport)
Recompute preview integrity while outcome and finalization remain unavailable.

Known-reference BNB observer

Supply one decimal jobId and its exact 32-byte transaction hash. The server fixes chain 97, the RPC and contract allowlist. Placeholder values must be replaced before the request is valid.

HTTP observer template

curl -sS -X POST http://localhost:3000/api/agents/bnb-apex/observe \
  -H "content-type: application/json" \
  --data '{"jobId":"<KNOWN_JOB_ID>","txHash":"<KNOWN_TX_HASH>"}'

This read can observe a missing, failed, non-terminal or contradictory reference. None creates a finalized Outcome Receipt.

One bounded contract, two local transports

The SDK and MCP server expose the same read and preview boundary. HTTP responses are private and no-store; MCP runs over local stdio with protocol output isolated from diagnostics.

No write tools

HTTP operations

7 exact routes

GET/api/agents/demo

Create a fresh source-only Action Passport Preview from the bounded sample.

demo()PREVIEW

Sample data; no provider or chain request.

GET/api/agents/passport?address=...

Inspect one exact Agentverse address through fixed public read origins.

agentPassport(address)READ ONLY

No ownership, endpoint probe, chat, registration or score.

POST/api/agents/preflight

Validate AgentActionIntent 1.0.0 and run the deterministic source-preview policy path.

preflight(input)PREVIEW

No authorization, signing, provider submission or execution.

POST/api/agents/verify

Recompute the integrity of a Action Passport Preview.

verifyActionPassportPreview(passport)PREVIEW

Integrity does not prove execution, settlement or outcome.

GET/api/agents/agent-launch/tokens

List Agent Launch public token records for the server-fixed BSC Testnet scope.

agentLaunchTokens()READ ONLY

No query parameters; server-fixed chainId 97; an honest empty response remains ZERO_STATE.

GET/api/agents/agent-launch/tokens/{address}

Inspect one exact 20-byte token address in the BSC Testnet public record set.

agentLaunchToken(address)READ ONLY

One 20-byte EVM path address, no query; no launch, tokenization, holder or graduation claim.

POST/api/agents/bnb-apex/observe

Observe one explicitly supplied BNB APEX job and transaction reference.

observeBnbApex({ jobId, txHash })READ ONLY

Exactly jobId + txHash; no extra keys, caller RPC/chain/origin, open log scan or write.

Local MCP tools

7 exact names

draft_agent_action_intent

Draft a strict AgentActionIntent 1.0.0 from bounded caller input.

Local construction only; it does not create a provider job.

inspect_agentverse_agent

Inspect one exact Agentverse address and preserve claims, observations and unknowns.

No endpoint call, ownership claim, chat or registration.

list_agent_launch_testnet_tokens

List normalized public token records for Agent Launch BSC Testnet.

Fixed chainId 97; ZERO_STATE remains a valid result.

inspect_agent_launch_testnet_token

Inspect one exact Agent Launch BSC Testnet token address.

Read-only provider record; no launch or adoption inference.

run_agent_action_preflight

Run the deterministic Agent Control source-preview policy path.

No model verdict, authorization, signer or execution path.

verify_action_passport_preview

Recompute Action Passport Preview integrity from caller-supplied JSON.

A valid digest is not a finalized Outcome Receipt.

observe_bnb_apex_testnet_job

Read one known BNB APEX BSC Testnet job and transaction reference.

Exact jobId + txHash and allowlisted contracts only; never scans broadly.

Four truths stay separate

Route availability, provider capability, Ryntra maturity and user eligibility answer different questions. A mounted source route does not make an external integration live, and a provider response does not promote Ryntra maturity.

Route availability: The seven HTTP routes are live on this Ryntra deployment and the seven MCP tools run locally over stdio. Route availability does not promote provider capability or Ryntra maturity.
Provider capability: Agentverse, Agent Launch and BNB APEX reads can return bounded observations for exact caller-supplied references, or fail closed.
Ryntra maturity: Every state below comes from publicCapabilityRow at render time, including any freshness downgrade to Re-verifying.
User eligibility: The kit makes no account, ownership or eligibility decision. Provider and jurisdiction rules remain external, current and user-specific.

Capability	Exact input	Output	Registry state	Registry limitation
Agentverse public Agent Passport`agentverse-public-passport`	Exact Agentverse address	Claims · observations · conflicts · unknowns · digest	PreviewAgentverse · agent-profile-registration-and-protocol-metadataReviewed 2026-08-14	A bounded read-only adapter resolves one exact public Agentverse address, preserves registry/search/manifest provenance, and exposes provider-declared facts, conflicts and unknowns. It does not authenticate ownership, test declared endpoints, prove liveness, invoke ASI:One, register an agent, score trust or execute an action.
Agent action intent normalization`agent-control-intent`	Bounded action proposal	AgentActionIntent 1.0.0	Previewsample-unfunded-agent-job-draftReviewed 2026-08-14	A strict, versioned AgentActionIntent normalizes a sample agent request in source. It does not prove that Agentverse or ASI:One delivered the request, and it creates, funds or submits no external job.
Agent Control deterministic preflight`agent-control-preflight`	Strict intent	Evidence and versioned policy result	Previewsample-unfunded-agent-job-draftReviewed 2026-08-14	The source preview evaluates one immutable local policy and emits the shared Guard PolicyResult vocabulary. Execution is hard-disabled; an allowed result is not a provider signature, wallet authorization, job or settlement.
Agent Action Passport Preview`agent-decision-passport-preview`	Action Passport Preview	Recomputed validity and exact issues	Previewsample-unfunded-agent-job-draftReviewed 2026-08-14	The verifier can recompute a source-preview passport that always states OUTCOME_NOT_OBSERVED. It is not a finalized receipt and carries no job id, transaction hash, provider result, evaluator result or independently observed effect.
Agent Launch public token read adapter`agent-launch-public-read`	List or exact token address	Normalized chainId 97 provider records	Previewbsc-testnet-token-zero-stateReviewed 2026-08-14	A bounded adapter normalizes Agent Launch public token list/detail GET responses for explicit chainId 97, preserves raw provider data and surfaces controller/schema drift. It exposes no authentication, tokenization, trading, payment, signing or deployment path; the observed chain-97 list was an honest zero state.
BNB APEX read-only observer`bnb-apex-read-observer`	Decimal jobId + 32-byte txHash	Transaction binding and observed job state	Previewdeployment-metadata · known-job-observationReviewed 2026-08-14	A bounded read-only adapter verifies the allowlisted BSC testnet deployment and can inspect one known transaction hash plus job id without broad log scans. It surfaces provider address/payment-asset drift, signs nothing, and no Ryntra-owned job, transaction or terminal outcome has been observed.

The missing actions are part of the contract

The kit is useful before it can move value because it makes identity evidence, intent shape, policy and integrity inspectable without asking a developer to trust a simulated settlement.

Fails closed

What this source kit can establish

The exact public record and the source that supplied each claim.
Unknown, conflicting, stale or unavailable evidence without collapsing it into a score.
A strict versioned intent and a deterministic source-preview policy result.
Action Passport Preview integrity recomputed by an independent caller.
One known BNB APEX testnet job/transaction binding when the caller supplies both references.

What remains outside v0.1

No provider account, Agentverse ownership, registration, endpoint call or ASI:One invocation.
No wallet connection, signature, server signer, custody, funding or transaction broadcast.
No Agent Launch tokenization, handoff, launch, trading or holder claim.
No BNB APEX create, submit, evaluate, settle or refund write.
No finalized Outcome Receipt without independently observed terminal effects.
No npm package and no remote MCP service; the published repository is a source release, not a hosted endpoint.

Absence and failure stay explicit: ZERO_STATE means a successful empty list, NOT_FOUND means the exact record was not observed, stale or unavailable evidence remains non-positive, and UPSTREAM_FAILURE returns no raw provider error. This page itself performs no provider request. Reads happen only when a developer runs the local example, calls an HTTP route or invokes one of the listed stdio tools.