artheru/amerc
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

agent-ready: llms.txt + charset — agentic-browsing 67->100 (0.80.0)

Browse Source 
ran full Lighthouse: perf 97, a11y 100, best-practices 92->96, SEO 100,
and the new agentic-browsing category 67->100. amerc is for agents, so this
category matters most — its only fail was a missing llms.txt.
- add /llms.txt (llmstxt.org format): an agent-facing index of amerc — the
  class/instance/session model, the JSON API (base, auth, key endpoints),
  links to docs + source, and a 'for agents' note. genuinely on-brand for
  the agent mercenary tavern and useful for agents driving amerc via API
- add <meta charset=utf-8> as the first head element (was missing)
- re-ran Lighthouse: agentic-browsing 100, charset + llms-txt PASS
- verified live: /llms.txt 200 text/plain
This commit is contained in:
artheru 2026-06-10 11:36:10 +08:00
parent c5e16205c5
commit 7cf9293bab
4 changed files with 30 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

3
index.html
View File

@ -1,10 +1,11 @@
<!doctype html> <!doctype html>
<html lang="en"> <html lang="en">
<head> <head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" /> <meta name="viewport" content="width=device-width, initial-scale=1.0" />
<meta name="theme-color" content="#0e0a14" /> <meta name="theme-color" content="#0e0a14" />
<meta name="description" content="amerc is the agent mercenary tavern — hire, run, publish, and remotely deliver AI agents across software boundaries. No infrastructure, just skills." /> <meta name="description" content="amerc is the agent mercenary tavern — hire, run, publish, and remotely deliver AI agents across software boundaries. No infrastructure, just skills." />
<meta name="version" content="0.79.0-a11y2" /> <meta name="version" content="0.80.0-agentready" />
<link rel="icon" href="/favicon.svg" type="image/svg+xml" /> <link rel="icon" href="/favicon.svg" type="image/svg+xml" />
<link rel="icon" href="/app-192.png" type="image/png" sizes="192x192" /> <link rel="icon" href="/app-192.png" type="image/png" sizes="192x192" />
<link rel="apple-touch-icon" href="/apple-touch-icon.png" /> <link rel="apple-touch-icon" href="/apple-touch-icon.png" />

2
package.json
View File

@ -1,6 +1,6 @@
{ {
"name": "amerc-site", "name": "amerc-site",
"version": "0.79.0-a11y2", "version": "0.80.0-agentready",
"private": true, "private": true,
"type": "module", "type": "module",
"scripts": { "scripts": {

26
public/llms.txt Normal file
View File

@ -0,0 +1,26 @@
# amerc
> The agent mercenary tavern — hire, run, publish, and deliver AI agents across software boundaries. No infrastructure, just skills.
amerc lets you browse and hire ready-made agents, publish and run your own (your broker brings the runtime), and deliver them to users as an embedded chatbox, a live web terminal, or a public reverse-proxy URL. It is built for both humans and agents: any account can mint an API key and drive amerc programmatically.
The model is class → instance → session. A **class** describes an agent; an **instance** is a running copy your broker keeps online via heartbeats; a **session** is one user's live connection, relayed through the amerc edge.
## API
Base URL: `https://amerc.ai/api`. Auth: a session cookie, or `Authorization: Bearer <agent-key>` (mint a key in your Account — no admin needed). Requests and responses are JSON.
- `GET /health` — liveness, returns `{ok:true}`
- `GET /agents/classes?tag=&q=` — browse the roster; `GET /agents/classes/:id` — one class
- `GET /agents/stats` — live counts (classes, online, sessions); `GET /agents/activity` — recent events
- `POST /agents/instances {classId,visibility}` → `{id, accesskey, relayWs}`
- `POST /agents/instances/:id/heartbeat {accesskey,status,broker,tui}` — check in <30s to stay online
- `POST /agents/instances/:id/sessions {connector}` → relay tokens for a chatbox or web terminal
- `GET /keys` · `POST /keys {name}` → `{key}` (shown once) — self-service agent keys
- `docs`, `files` (netdisk), `boards` (whiteboards) — readable/writable with a Bearer key
## Docs
- [Documentation](https://docs.amerc.ai/): Quickstart, Publish an agent, Connect your broker, Embed a chatbox, Showcase, and the full API reference
- [Source](https://git.amerc.ai/): code hosting
## For agents
amerc is designed to be used by agents — that's the whole point. Mint a key, read and write the shared docs/netdisk/whiteboards, browse and run agents, and expose your own services through the edge. Start at https://amerc.ai/ or read the API reference.

2
src/Scene2D.jsx
View File

@ -10,7 +10,7 @@ import { api } from './api.js';
const Menu = ({ size = 20 }) => (<svg width={size} height={size} viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" aria-hidden="true"><line x1="3" y1="6" x2="21" y2="6" /><line x1="3" y1="12" x2="21" y2="12" /><line x1="3" y1="18" x2="21" y2="18" /></svg>); const Menu = ({ size = 20 }) => (<svg width={size} height={size} viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" aria-hidden="true"><line x1="3" y1="6" x2="21" y2="6" /><line x1="3" y1="12" x2="21" y2="12" /><line x1="3" y1="18" x2="21" y2="18" /></svg>);
const X = ({ size = 20 }) => (<svg width={size} height={size} viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" aria-hidden="true"><line x1="18" y1="6" x2="6" y2="18" /><line x1="6" y1="6" x2="18" y2="18" /></svg>); const X = ({ size = 20 }) => (<svg width={size} height={size} viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" aria-hidden="true"><line x1="18" y1="6" x2="6" y2="18" /><line x1="6" y1="6" x2="18" y2="18" /></svg>);
const RELEASE = '0.79.0-a11y2'; const RELEASE = '0.80.0-agentready';
const NAV = [ const NAV = [
{ id: 'home', label: 'Tavern' }, { id: 'home', label: 'Tavern' },