Skip to content

Create docs pages for Runtime, MCP, Schemas, and API; rebuild runtime page #237

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
GsCommand merged 1 commit into from
May 21, 2026
Merged

Create docs pages for Runtime, MCP, Schemas, and API; rebuild runtime page #237

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 7 additions & 0 deletions public/api.html
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
<!doctype html><html lang="en"><head><meta charset="utf-8" /><meta name="viewport" content="width=device-width,initial-scale=1" /><title>CommandLayer API Reference</title><link rel="icon" href="/icon2.png" /><link rel="stylesheet" href="/css/site.css" /><style>.brand img{height:68px}.brand span{display:none}.nav-links{display:flex;gap:2px;list-style:none}.nav-links a{color:var(--muted);padding:7px 12px;border-radius:8px;text-decoration:none}.nav-drop{position:relative}.nav-drop-menu{display:none;position:absolute;left:0;top:100%;background:#fff;border:1px solid var(--border);border-radius:12px;padding:8px;min-width:260px}.nav-drop:hover .nav-drop-menu{display:grid}.doc-shell{padding:64px 0}.doc-card{background:#fff;border:1px solid var(--border);border-radius:18px;padding:24px;margin-bottom:18px}.doc-card ul{padding-left:20px}.code{background:#0E1322;color:#E2E8F0;border-radius:14px;padding:18px;white-space:pre-wrap;font:13px/1.7 ui-monospace}footer{border-top:1px solid var(--border)}.footer-grid{display:grid;grid-template-columns:repeat(3,minmax(0,1fr));gap:24px;padding:36px 0}</style></head><body><nav><div class="container nav-inner"><a href="/" class="brand"><img src="/commandlayer-logo.png" alt="CommandLayer" /><span>CommandLayer</span></a><ul class="nav-links"><li><a href="/">Home</a></li><li><a href="/protocol.html">Protocol</a></li><li><a href="/capabilities.html">Capabilities</a></li><li><a href="/verify.html">Verifier</a></li><li><a href="/sdk-records.html">SDK</a></li><li class="nav-drop"><a href="/docs.html" class="active">Docs ▾</a><div class="nav-drop-menu"><a href="/docs.html">Docs Home</a><a href="/docs/wrap-your-agent.html">Wrap Your Agent</a><a href="/stack-proof-demo.html">Production Proof</a><a href="/runtime.html">Runtime</a><a href="/mcp.html">MCP Bridge</a><a href="/schemas.html">Schemas</a><a href="/api.html">API Reference</a><a href="/trust-verification.html">Trust Verification</a><a href="/claim.html">Claim / Namespace Activation</a></div></li><li><a href="/claim.html">Claim</a></li><li><a href="https://github.com/commandlayer" target="_blank" rel="noopener">GitHub</a></li></ul></div></nav><section class="hero"><div class="container"><div class="hero-badge"><span class="badge-dot"></span>API</div><h1 class="hero-h1">API surfaces for verifiable agent actions.</h1><p class="hero-sub">CommandLayer APIs expose runtime signing, verification, and verifier surfaces.</p></div></section><main class="container doc-shell"><section class="doc-card"><h2>Runtime endpoints</h2><ul><li>GET /health</li><li>POST /verify</li><li>POST /trust-verification/{verb}/v1.0.0</li></ul></section><section class="doc-card"><h2>MCP endpoint</h2><ul><li>GET https://mcp.commandlayer.org/health</li><li>POST https://mcp.commandlayer.org/mcp</li></ul></section><section class="doc-card"><h2>Website verifier surfaces</h2><ul><li>/verify.html</li><li>/api/verify (public route; treat production canonical status cautiously until separately validated)</li><li>/api/agents/verifyagent</li></ul></section><section class="doc-card"><h2>Example curl</h2><div class="code">curl -X POST https://runtime.commandlayer.org/trust-verification/sign/v1.0.0 \
-H "Content-Type: application/json" \
-d '{"agent":"runtime.commandlayer.eth","action":"sign","payload":{}}'

curl -X POST https://runtime.commandlayer.org/verify \
-H "Content-Type: application/json" \
-d '{"receipt":{}}'</div></section><section class="doc-card"><h2>Response states</h2><ul><li>VALID / VERIFIED</li><li>INVALID</li><li>TRANSPORT_ERROR</li></ul></section><section class="doc-card"><h2>Trust boundary</h2><ul><li>Runtime signs.</li><li>Verifier validates.</li><li>MCP bridges.</li><li>SDK wraps.</li></ul><div class="hero-actions"><a class="btn btn-primary" href="/verify.html">Try Verifier</a><a class="btn btn-secondary" href="/stack-proof-demo.html">View Production Proof</a></div></section></main><footer><div class="container footer-grid"><div><h4>Product</h4><a href="/protocol.html">Protocol</a><a href="/capabilities.html">Capabilities</a><a href="/verify.html">Verifier</a><a href="/runtime.html">Runtime</a><a href="/mcp.html">MCP</a><a href="/claim.html">Claim</a></div><div><h4>Developers</h4><a href="/docs.html">Docs</a><a href="/sdk-records.html">SDK</a><a href="/schemas.html">Schemas</a><a href="/api.html">API</a><a href="https://github.com/commandlayer" target="_blank" rel="noopener">GitHub</a></div><div><h4>Proof</h4><a href="/stack-proof-demo.html">Production Proof</a><a href="/verify.html">VerifyAgent</a><a href="/trust-verification.html">Trust Verification</a><a href="/receipts/">Canonical Receipts</a></div></div></footer></body></html>
13 changes: 13 additions & 0 deletions public/mcp.html
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,13 @@
<!doctype html><html lang="en"><head><meta charset="utf-8" /><meta name="viewport" content="width=device-width,initial-scale=1" /><title>CommandLayer MCP Bridge</title><meta name="description" content="MCP bridge documentation for CommandLayer runtime tool access." /><link rel="icon" href="/icon2.png" /><link rel="preconnect" href="https://fonts.googleapis.com" /><link rel="preconnect" href="https://fonts.gstatic.com" crossorigin /><link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700;800&display=swap" rel="stylesheet" /><link rel="stylesheet" href="/css/site.css" /><style>.brand{gap:0}.brand img{height:68px;width:auto;object-fit:contain}.brand span{display:none}.nav-links{display:flex;align-items:center;gap:2px;list-style:none;flex-wrap:wrap;margin:0;padding:0}.nav-links a{color:var(--muted);text-decoration:none;font-size:14px;font-weight:500;padding:7px 12px;border-radius:8px}.nav-links a:hover,.nav-drop:hover>a,.nav-drop:focus-within>a,.nav-drop>a.active{color:var(--text);background:var(--surface)}.nav-drop{position:relative}.nav-drop-menu{position:absolute;top:calc(100% - 1px);left:0;background:#fff;border:1px solid var(--border);border-radius:12px;box-shadow:0 10px 34px rgba(15,23,42,.12);padding:8px;display:none;min-width:260px;z-index:200}.nav-drop:hover .nav-drop-menu,.nav-drop:focus-within .nav-drop-menu{display:grid}.doc-shell{padding:64px 0 88px}.doc-card{background:#fff;border:1px solid var(--border);border-radius:18px;padding:24px;margin-bottom:18px}.doc-card p,.doc-card li{color:var(--text-2);line-height:1.7}.doc-card ul{padding-left:20px}.code-panel{background:#0E1322;color:#E2E8F0;border-radius:14px;padding:18px;overflow:auto;font:13px/1.7 ui-monospace,SFMono-Regular,Menlo,Consolas,monospace}footer{border-top:1px solid var(--border);background:#fff}.footer-grid{display:grid;grid-template-columns:repeat(3,minmax(0,1fr));gap:24px;padding:36px 0}</style></head><body><nav><div class="container nav-inner"><a href="/" class="brand"><img src="/commandlayer-logo.png" alt="CommandLayer" /><span>CommandLayer</span></a><ul class="nav-links"><li><a href="/">Home</a></li><li><a href="/protocol.html">Protocol</a></li><li><a href="/capabilities.html">Capabilities</a></li><li><a href="/verify.html">Verifier</a></li><li><a href="/sdk-records.html">SDK</a></li><li class="nav-drop"><a href="/docs.html" class="active">Docs ▾</a><div class="nav-drop-menu"><a href="/docs.html">Docs Home</a><a href="/docs/wrap-your-agent.html">Wrap Your Agent</a><a href="/stack-proof-demo.html">Production Proof</a><a href="/runtime.html">Runtime</a><a href="/mcp.html">MCP Bridge</a><a href="/schemas.html">Schemas</a><a href="/api.html">API Reference</a><a href="/trust-verification.html">Trust Verification</a><a href="/claim.html">Claim / Namespace Activation</a></div></li><li><a href="/claim.html">Claim</a></li><li><a href="https://github.com/commandlayer" target="_blank" rel="noopener">GitHub</a></li></ul></div></nav><section class="hero"><div class="container"><div class="hero-badge"><span class="badge-dot"></span>MCP Bridge</div><h1 class="hero-h1">MCP bridges agent clients to CommandLayer runtime actions.</h1><p class="hero-sub">MCP exposes CommandLayer tools to MCP clients, but MCP is a bridge, not the signer.</p><div class="hero-actions"><a class="btn btn-primary btn-lg" href="/stack-proof-demo.html">View Production Proof</a><a class="btn btn-secondary btn-lg" href="/capabilities.html">Explore Capabilities</a></div></div></section><main class="container doc-shell"><section class="doc-card"><h2>What MCP does</h2><ul><li>Exposes tools.</li><li>Forwards payloads to runtime.</li><li>Blocks private key fields.</li><li>Returns runtime receipts.</li><li>Supports automatic verification workflows.</li></ul></section><section class="doc-card"><h2>What MCP does not do</h2><ul><li>Does not hold private keys.</li><li>Does not sign receipts.</li><li>Is not the trust root.</li><li>Does not make schema-valid equal verified.</li></ul></section><section class="doc-card"><h2>Transport</h2><pre class="code-panel"><code>GET https://mcp.commandlayer.org/health
POST https://mcp.commandlayer.org/mcp

Note: /mcp is POST-only MCP transport. GET /mcp is not expected to work.</code></pre></section><section class="doc-card"><h2>Tools</h2><pre class="code-panel"><code>clas.trust-verification.verify
clas.trust-verification.sign
clas.trust-verification.attest
clas.trust-verification.authorize
clas.trust-verification.approve
clas.trust-verification.reject
clas.trust-verification.permit
clas.trust-verification.grant
clas.trust-verification.authenticate
clas.trust-verification.endorse</code></pre></section><section class="doc-card"><h2>Flow</h2><p>MCP client -> mcp.commandlayer.org -> runtime.commandlayer.org -> signed receipt -> verifier -> VALID / INVALID</p></section></main><footer><div class="container footer-grid"><div><h4>Product</h4><a href="/protocol.html">Protocol</a><a href="/capabilities.html">Capabilities</a><a href="/verify.html">Verifier</a><a href="/runtime.html">Runtime</a><a href="/mcp.html">MCP</a><a href="/claim.html">Claim</a></div><div><h4>Developers</h4><a href="/docs.html">Docs</a><a href="/sdk-records.html">SDK</a><a href="/schemas.html">Schemas</a><a href="/api.html">API</a><a href="https://github.com/commandlayer" target="_blank" rel="noopener">GitHub</a></div><div><h4>Proof</h4><a href="/stack-proof-demo.html">Production Proof</a><a href="/verify.html">VerifyAgent</a><a href="/trust-verification.html">Trust Verification</a><a href="/receipts/">Canonical Receipts</a></div></div></footer></body></html>
Loading
Loading