# PlatPhorm AgentUI

Version: 0.10.0

Human and agent interface layer, MCP tool UI renderer, workflow artifact builder, schema-to-form preview, OpenAPI operation renderer, webhook form renderer, Phorm preview handoff, Layout/ASCII output viewer, delegation packet creator, and platphormctl workflow validation for PlatPhormNews.

## Overview

AgentUI turns machine-readable tools, APIs, MCP schemas, prompts, resources, workflows, evals, sandbox outputs, browser journeys, monitor checks, docs reports, sheets matrices, webhook payloads, Layout packets, ASCII outputs, and generated interface plans into usable forms, workflows, dashboards, approvals, reports, and shareable artifacts.

It is not the MCP gateway, API gateway, Evals, Sandbox, BrowserOps, Claws, Docs, Monitor, or Phorm. Those are integrations.

## Quick Links

- Documentation: https://agentui.platphormnews.com/api/docs
- OpenAPI YAML: https://agentui.platphormnews.com/openapi.yaml
- OpenAPI JSON: https://agentui.platphormnews.com/openapi.json
- AsyncAPI YAML: https://agentui.platphormnews.com/asyncapi.yaml
- MCP Endpoint: https://agentui.platphormnews.com/api/mcp
- Web Status: https://agentui.platphormnews.com/api/web/status
- Route Evidence: https://agentui.platphormnews.com/api/web/route-evidence
- Web Status Manifest: https://agentui.platphormnews.com/.well-known/web.json
- Legacy Web4 Manifest Alias: https://agentui.platphormnews.com/.well-known/web4.json
- Provenance Index: https://agentui.platphormnews.com/.well-known/provenance.json
- AI Plugin Compatibility: https://agentui.platphormnews.com/.well-known/ai-plugin.json
- Fingerprints: https://agentui.platphormnews.com/api/web/fingerprints
- Health Check: https://agentui.platphormnews.com/api/health
- v1 Health: https://agentui.platphormnews.com/api/v1/health
- RSS Feed: https://agentui.platphormnews.com/rss.xml
- Atom Feed: https://agentui.platphormnews.com/atom.xml
- Full Sitemap: https://agentui.platphormnews.com/sitemap-full.xml
- Network Sitemap: https://agentui.platphormnews.com/sitemap-network.xml
- Attribution: https://agentui.platphormnews.com/attribution.json
- JSON-LD: https://agentui.platphormnews.com/index.jsonld
- Builder: https://agentui.platphormnews.com/builder
- Templates: https://agentui.platphormnews.com/templates
- Integrations: https://agentui.platphormnews.com/integrations
- CLI: https://agentui.platphormnews.com/clients/cli
- IDE: https://agentui.platphormnews.com/clients/ide
- Storage Status: https://agentui.platphormnews.com/api/v1/storage/status (append ?probe=true for public-safe DB accessibility and table-count evidence)
- Emoji Selector: https://agentui.platphormnews.com/api/v1/selectors/emoji
- SVG Selector: https://agentui.platphormnews.com/api/v1/selectors/svg

## Current Inventory

- Public workflows: degraded
- Total registry workflows: degraded
- Persisted runs: degraded
- Workflow templates: 47
- Local AgentUI MCP tools: 91
- Discovered network MCP tools: 276
- Metrics source: live
- Storage mode: server_protected
- Server persistence: available
- Storage note: server persistence available

## API Endpoints

- GET  /api/v1/workflows
- POST /api/v1/workflows (protected)
- GET  /api/v1/runs
- GET  /api/v1/runs/{id}
- GET  /api/v1/runs/{id}/steps
- GET  /api/v1/runs/{id}/steps/{stepId}
- GET  /api/v1/runs/{id}/blocks/{blockId}
- GET  /api/v1/templates
- GET/POST /api/v1/tool-specs
- GET  /api/v1/artifacts
- GET  /api/v1/artifacts/{id}/view
- POST /api/v1/artifacts
- GET  /api/v1/storage/status
- GET  /api/v1/storage/status?probe=true
- GET  /api/v1/storage/modes
- GET  /api/v1/selectors/emoji
- GET  /api/v1/selectors/svg
- POST /api/v1/render/mcp-tool
- POST /api/v1/render/openapi-operation
- POST /api/v1/render/json-schema
- POST /api/v1/render/webhook-schema
- POST /api/v1/render/artifact
- POST /api/v1/validate/form-input
- GET  /api/v1/delegations
- POST /api/v1/delegate/{service}
- GET  /api/v1/demo/suite
- GET/POST /api/agentui/receive-handoff
- GET/POST /api/v1/receive-handoff
- POST /api/v1/workflows/{id}/blocks/{blockId}/dry-run
- POST /api/v1/workflows/{id}/blocks/{blockId}/run
- GET  /api/v1/integrations
- GET  /api/v1/cli/examples
- GET  /api/v1/agent-policy
- GET  /api/v1/approvals
- GET/POST /api/mcp (JSON-RPC 2.0)
- GET  /api/web/status
- GET  /api/web/scorecard
- GET  /api/web/fingerprints
- GET  /api/web/route-evidence
- GET  /api/provenance/lookup
- GET  /api/provenance/verify
- GET  /.well-known/web.json
- GET  /.well-known/web4.json
- GET  /.well-known/provenance.json
- GET  /.well-known/ai-plugin.json

## Protected Actions

Protected actions require PLATPHORM_API_KEY:
- Authorization: Bearer $PLATPHORM_API_KEY
- X-PlatPhorm-API-Key: $PLATPHORM_API_KEY
- The workflow builder also accepts a workflow/write/admin scoped credential issued by https://keys.platphormnews.com through either standard header. AgentUI validates it server-to-server and does not persist it.

Public read-only routes include the builder shell, workflow/template/run summaries, docs, discovery, health, feeds, sitemaps, and MCP introspection.

AWS Aurora persistence, mutation, run, approval, publish, target-service execution, registry mutation, and private report actions are protected. The public builder exposes protected controls only after the operator enters an authorized credential; it never stores that credential. Validation and public-safe reads remain public.

Delegation dry-runs return preview_ready handoff envelopes and do not call remote protected systems. Live protected delegation requests require PLATPHORM_API_KEY and return protected_required when auth is missing. Result references stay null until the target service confirms completion.

## Block Input / Output View

The builder review pane exposes the selected step, its configuration, real run status, exact input, exact output, result reference, and confirmed error reason. Unexecuted steps say "Not run yet" and do not synthesize preview results.

## Optional Model Assistance

PLATPHORM_API_KEY remains the only platform protected-action key. Vercel AI Gateway / PLATPHORM_AI / SEARCH_URL are optional server-side configuration for labeled model-assisted drafts, summaries, labels, and search context. They do not replace confirmed block output, target-service execution, or persistence truth.

## Web Status And Provenance

AgentUI Web Status means rendered interfaces, workflows, approvals, artifacts, dry-runs, delegation packets, evidence panels, and result views are discoverable, inspectable, machine-readable, human-verifiable, provenance-ready, and safe to hand off.

Public-safe fingerprints cover templates, manifests, policies, integration registry, OpenAPI, AsyncAPI, MCP manifest, and route evidence. Visitor, browser, device, behavioral, request-header, private workflow, protected tool, private approval, and private artifact fingerprints are excluded from public provenance.

## CLI

- Docs: https://cli.platphormnews.com
- Example: platphormctl site inspect agentui --best-effort

## Contact

Support: support@platphormnews.com