aixyz 0.23.0 → 0.25.0

package/README.md

@@ -0,0 +1,302 @@
+# aixyz
+
+Framework for bundling AI agents into deployable services with A2A, MCP, x402 payments, and ERC-8004 identity.
+
+Write your agent logic. aixyz wires up the protocols, payments, and deployment.
+
+## Prerequisites
+
+Install [Bun](https://bun.sh) if you don't have it:
+
+```bash
+curl -fsSL https://bun.sh/install | bash
+```
+
+## Quick Start
+
+```bash
+bunx create-aixyz-app my-agent
+cd my-agent
+bun install
+bun run dev
+```
+
+Your agent is running. It exposes:
+
+| Endpoint                       | Protocol | What it does                         |
+| ------------------------------ | -------- | ------------------------------------ |
+| `/.well-known/agent-card.json` | A2A      | Agent discovery card                 |
+| `/agent`                       | A2A      | JSON-RPC endpoint, x402 payment gate |
+| `/mcp`                         | MCP      | Tool sharing with MCP clients        |
+
+## How It Works
+
+An aixyz agent has three parts: a config, an agent, and tools.
+
+### 1. Config
+
+`aixyz.config.ts` declares your agent's identity, payment address, and skills:
+
+```ts
+import type { AixyzConfig } from "aixyz/config";
+
+const config: AixyzConfig = {
+  name: "Weather Agent",
+  description: "Get current weather for any location worldwide.",
+  version: "0.1.0",
+  x402: {
+    payTo: "0x...",
+    network: "eip155:8453", // Base mainnet
+  },
+  skills: [
+    {
+      id: "get-weather",
+      name: "Get Weather",
+      description: "Get current weather conditions for any city or location",
+      tags: ["weather"],
+      examples: ["What's the weather in Tokyo?"],
+    },
+  ],
+};
+
+export default config;
+```
+
+### 2. Agent
+
+`app/agent.ts` defines your agent, its payment price, and A2A capabilities:
+
+```ts
+import { openai } from "@ai-sdk/openai";
+import { stepCountIs, ToolLoopAgent } from "ai";
+import type { Accepts } from "aixyz/accepts";
+import type { Capabilities } from "aixyz/app/plugins/a2a";
+import weather from "./tools/weather";
+
+export const accepts: Accepts = {
+  scheme: "exact",
+  price: "$0.005",
+};
+
+export const capabilities: Capabilities = {
+  streaming: true, // default: true — set to false to use generate() instead of stream()
+  pushNotifications: false, // default: false
+};
+
+export default new ToolLoopAgent({
+  model: openai("gpt-4o-mini"),
+  instructions: "You are a helpful weather assistant.",
+  tools: { weather },
+  stopWhen: stepCountIs(10),
+});
+```
+
+### 3. Tools
+
+Each file in `app/tools/` exports a Vercel AI SDK `tool` and an optional `accepts` for MCP payment gating:
+
+```ts
+import { tool } from "ai";
+import { z } from "zod";
+import type { Accepts } from "aixyz/accepts";
+
+export const accepts: Accepts = {
+  scheme: "exact",
+  price: "$0.0001",
+};
+
+export default tool({
+  description: "Get current weather conditions for a city.",
+  inputSchema: z.object({
+    location: z.string().describe("City name"),
+  }),
+  execute: async ({ location }) => {
+    // your logic here
+  },
+});
+```
+
+That's it. Run `bun run dev` and aixyz auto-generates the server, wires up A2A + MCP + x402, and starts serving.
+
+## Custom Server
+
+For full control, create `app/server.ts` instead. This takes precedence over auto-generation:
+
+```ts
+import { AixyzApp } from "aixyz/app";
+import { IndexPagePlugin } from "aixyz/app/plugins/index-page";
+import { A2APlugin } from "aixyz/app/plugins/a2a";
+import { MCPPlugin } from "aixyz/app/plugins/mcp";
+
+import * as agent from "./agent";
+import lookup from "./tools/lookup";
+
+const server = new AixyzApp();
+
+// Index page: human-readable agent info
+await server.withPlugin(new IndexPagePlugin());
+
+// A2A: agent discovery + JSON-RPC endpoint
+await server.withPlugin(new A2APlugin(agent));
+
+// MCP: expose tools to MCP clients
+await server.withPlugin(
+  new MCPPlugin([
+    {
+      name: "lookup",
+      exports: {
+        default: lookup,
+        accepts: { scheme: "exact", price: "$0.001" },
+      },
+    },
+  ]),
+);
+
+await server.initialize();
+
+export default server;
+```
+
+## Configuration
+
+| Field          | Type           | Required | Description                                        |
+| -------------- | -------------- | -------- | -------------------------------------------------- |
+| `name`         | `string`       | Yes      | Agent display name                                 |
+| `description`  | `string`       | Yes      | What the agent does                                |
+| `version`      | `string`       | Yes      | Semver version                                     |
+| `url`          | `string`       | No       | Agent base URL. Auto-detected on Vercel            |
+| `x402.payTo`   | `string`       | Yes      | EVM address to receive payments                    |
+| `x402.network` | `string`       | Yes      | Payment network (`eip155:8453` for Base)           |
+| `skills`       | `AgentSkill[]` | No       | Skills your agent exposes (used in A2A agent card) |
+
+Environment variables are loaded in the same order as Next.js: `.env`, `.env.local`, `.env.$(NODE_ENV)`,
+`.env.$(NODE_ENV).local`.
+
+### Payment (Accepts)
+
+Each agent and tool declares an `accepts` export to control payment:
+
+```ts
+// Require x402 payment
+export const accepts: Accepts = {
+  scheme: "exact",
+  price: "$0.005", // USD-denominated
+  network: "eip155:8453", // optional, defaults to config.x402.network
+  payTo: "0x...", // optional, defaults to config.x402.payTo
+};
+```
+
+Agents and tools without an `accepts` export are not registered.
+
+## CLI
+
+### `aixyz dev`
+
+Starts a local dev server with hot reload. Watches `app/` and `aixyz.config.ts` for changes.
+
+```bash
+aixyz dev          # default port 3000
+aixyz dev -p 4000  # custom port
+```
+
+### `aixyz build`
+
+Bundles your agent for deployment. Default output goes to `.aixyz/output/server.js`.
+
+```bash
+aixyz build                      # standalone (default), outputs to .aixyz/output/server.js
+bun .aixyz/output/server.js      # run the standalone build
+
+aixyz build --output vercel      # Vercel Build Output API v3, outputs to .vercel/output/
+vercel deploy                    # deploy the Vercel build
+
+aixyz build --output executable  # self-contained binary, no Bun runtime required
+./.aixyz/output/server           # run directly
+```
+
+### `aixyz erc-8004 register`
+
+Register your agent's on-chain identity (ERC-8004). Creates
+`app/erc-8004.ts` if it doesn't exist, asks for your deployment URL, and writes the registration back to the file after a successful on-chain transaction.
+
+```bash
+aixyz erc-8004 register --url "https://my-agent.vercel.app" --chain base-sepolia --broadcast
+```
+
+### `aixyz erc-8004 update`
+
+Update the metadata URI of a registered agent. Reads registrations from
+`app/erc-8004.ts` and lets you select which one to update.
+
+```bash
+aixyz erc-8004 update --url "https://new-domain.example.com" --broadcast
+```
+
+## Protocols
+
+**A2A (Agent-to-Agent)** — Generates an agent card at `/.well-known/agent-card.json` and a JSON-RPC endpoint at
+`/agent`. Protocol version 0.3.0. Other agents discover yours and send tasks via JSON-RPC.
+
+**MCP (Model Context Protocol)** — Exposes your tools at `/mcp` using
+`WebStandardStreamableHTTPServerTransport`. Any MCP client (Claude Desktop, VS Code, Cursor) can connect and call your tools.
+
+**x402** — HTTP 402 micropayments. Clients pay per-request with an
+`X-Payment` header containing cryptographic payment proof. No custodial wallets, no subscriptions. Payments are verified on-chain via a facilitator.
+
+**ERC-8004** — On-chain agent identity. Register your agent on Ethereum, Base, Polygon, Scroll, Monad, BSC, or Gnosis so other agents and contracts can reference it.
+
+## Agent File Structure
+
+```
+my-agent/
+  aixyz.config.ts     # Agent config (required)
+  app/
+    agent.ts          # Agent definition (required if no server.ts)
+    server.ts         # Custom server (optional, overrides auto-generation)
+    erc-8004.ts       # ERC-8004 identity registration (optional)
+    tools/
+      weather.ts      # Tool exports (files starting with _ are ignored)
+    icon.png          # Agent icon (served as static asset)
+  public/             # Static assets
+  vercel.json         # Vercel deployment config
+  .env.local          # Local environment variables
+```
+
+## Environment Variables
+
+| Variable               | Description                                                              |
+| ---------------------- | ------------------------------------------------------------------------ |
+| `X402_PAY_TO`          | Default payment recipient address                                        |
+| `X402_NETWORK`         | Default payment network (e.g. `eip155:8453`)                             |
+| `X402_FACILITATOR_URL` | Custom facilitator (default: `https://x402.use-agently.com/facilitator`) |
+| `CDP_API_KEY_ID`       | Coinbase CDP API key ID (uses Coinbase facilitator)                      |
+| `CDP_API_KEY_SECRET`   | Coinbase CDP API key secret                                              |
+| `STRIPE_SECRET_KEY`    | Enable experimental Stripe payment adapter                               |
+| `OPENAI_API_KEY`       | OpenAI API key (for agents using OpenAI models)                          |
+
+## Examples
+
+| Example                   | Description                                     |
+| ------------------------- | ----------------------------------------------- |
+| `boilerplate`             | Minimal starter (auto-generated server)         |
+| `chainlink`               | Chainlink data feeds with custom server         |
+| `flight-search`           | Flight search with Stripe payments              |
+| `local-llm`               | Local LLM via Docker (no external API)          |
+| `with-custom-facilitator` | Bring-your-own x402 facilitator                 |
+| `with-custom-server`      | Custom server setup                             |
+| `with-express`            | Express middleware integration                  |
+| `sub-agents`              | Multiple A2A endpoints from one deployment      |
+| `with-tests`              | Agent with test examples                        |
+| `fake-llm`                | Fully deterministic testing with `fake()` model |
+
+## Contributing
+
+```bash
+bun install
+bun run build
+bun run format
+```
+
+## License
+
+MIT

package/app/index.ts

@@ -86,6 +86,11 @@ export class AixyzApp {
     return this.middlewares;
   }
 
+  /** Find a registered plugin by name. Returns a read-only reference. */
+  getPlugin<T extends BasePlugin>(name: string): Readonly<T> | undefined {
+    return this.plugins.find((p) => p.name === name) as Readonly<T> | undefined;
+  }
+
   /** Dispatch a web-standard Request through payment verification, middleware, and route handler. */
   fetch = async (request: Request): Promise<Response> => {
     const response = await this.dispatch(request);

package/app/plugins/a2a.ts

@@ -200,13 +200,41 @@ export class A2APlugin<TOOLS extends ToolSet = ToolSet> extends BasePlugin {
         const body = await request.json();
         const result = await jsonRpcTransport.handle(body);
 
-        // If result is an AsyncGenerator (streaming), collect all chunks
+        // If result is an AsyncGenerator (streaming), return as SSE
         if (Symbol.asyncIterator in Object(result)) {
-          const chunks: unknown[] = [];
-          for await (const chunk of result as AsyncGenerator) {
-            chunks.push(chunk);
-          }
-          return Response.json(chunks[chunks.length - 1]);
+          const stream = result as AsyncGenerator;
+          const readable = new ReadableStream({
+            async start(controller) {
+              const encoder = new TextEncoder();
+              try {
+                for await (const event of stream) {
+                  controller.enqueue(encoder.encode(`data: ${JSON.stringify(event)}\n\n`));
+                }
+              } catch (error) {
+                const errorResponse = {
+                  jsonrpc: "2.0",
+                  id: body?.id ?? null,
+                  error: {
+                    code: -32603,
+                    message: error instanceof Error ? error.message : "Streaming error.",
+                  },
+                };
+                controller.enqueue(encoder.encode(`event: error\ndata: ${JSON.stringify(errorResponse)}\n\n`));
+              } finally {
+                controller.close();
+              }
+            },
+            cancel() {
+              stream.return?.(undefined);
+            },
+          });
+          return new Response(readable, {
+            headers: {
+              "Content-Type": "text/event-stream",
+              "Cache-Control": "no-cache",
+              "X-Accel-Buffering": "no",
+            },
+          });
         }
 
         return Response.json(result);

package/app/plugins/index-page/html.tsx

@@ -0,0 +1,624 @@
+/** @jsxImportSource @kitajs/html */
+import Html from "@kitajs/html";
+import type { AixyzConfigRuntime, Entrypoint, ProtocolInfo } from "./index";
+
+// ---------------------------------------------------------------------------
+// Icons (Lucide-style, matching shadcn conventions)
+// ---------------------------------------------------------------------------
+
+const COPY_ICON = `<svg xmlns="http://www.w3.org/2000/svg" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><rect width="14" height="14" x="8" y="8" rx="2" ry="2"/><path d="M4 16c-1.1 0-2-.9-2-2V4c0-1.1.9-2 2-2h10c1.1 0 2 .9 2 2"/></svg>`;
+const SPARKLES_ICON = `<svg xmlns="http://www.w3.org/2000/svg" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M9.937 15.5A2 2 0 0 0 8.5 14.063l-6.135-1.582a.5.5 0 0 1 0-.962L8.5 9.936A2 2 0 0 0 9.937 8.5l1.582-6.135a.5.5 0 0 1 .963 0L14.063 8.5A2 2 0 0 0 15.5 9.937l6.135 1.581a.5.5 0 0 1 0 .964L15.5 14.063a2 2 0 0 0-1.437 1.437l-1.582 6.135a.5.5 0 0 1-.963 0z"/></svg>`;
+
+// ---------------------------------------------------------------------------
+// Chip class constants (shared between JSX and inline script)
+// ---------------------------------------------------------------------------
+
+const CHIP_ACTIVE = "border-primary/50 bg-primary/10 text-primary";
+const CHIP_INACTIVE = "border-border bg-transparent text-muted-foreground hover:bg-accent hover:text-accent-foreground";
+
+// ---------------------------------------------------------------------------
+// Safe JSON serialization for embedding in <script> tags.
+// JSON.stringify alone doesn't prevent the HTML parser from seeing </script>
+// or <!-- sequences inside string literals, which can break out of the tag.
+// ---------------------------------------------------------------------------
+
+function safeJsonStringify(value: unknown): string {
+  return JSON.stringify(value).replace(/</g, "\\u003c");
+}
+
+// ---------------------------------------------------------------------------
+// shadcn-style Primitives
+// ---------------------------------------------------------------------------
+
+function Badge({
+  children,
+  variant = "secondary",
+}: {
+  children: string;
+  variant?: "secondary" | "outline" | "destructive" | "success";
+}) {
+  const styles: Record<string, string> = {
+    secondary: "bg-secondary text-secondary-foreground border-transparent",
+    outline: "bg-transparent text-muted-foreground border-border",
+    destructive: "bg-chart-4/10 text-chart-4 border-chart-4/20",
+    success: "bg-success/10 text-success border-success/20",
+  };
+  return (
+    <span
+      class={`inline-flex items-center rounded-md border px-2 py-0.5 text-[10px] font-semibold tracking-wider uppercase font-mono transition-colors ${styles[variant]}`}
+    >
+      {children}
+    </span>
+  );
+}
+
+function Button({
+  children,
+  variant = "default",
+  size = "sm",
+  onclick,
+}: {
+  children: string;
+  variant?: "default" | "secondary" | "ghost" | "outline";
+  size?: "sm" | "xs" | "icon";
+  onclick?: string;
+}) {
+  const base =
+    "inline-flex items-center justify-center gap-1.5 whitespace-nowrap font-medium transition-colors focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-ring disabled:pointer-events-none disabled:opacity-50 cursor-pointer border-none";
+  const variants: Record<string, string> = {
+    default: "bg-primary text-primary-foreground shadow-sm hover:bg-primary/90",
+    secondary: "bg-secondary text-secondary-foreground shadow-sm hover:bg-secondary/80",
+    ghost: "bg-transparent text-muted-foreground hover:bg-accent hover:text-accent-foreground",
+    outline:
+      "border border-border bg-background text-muted-foreground shadow-sm hover:bg-accent hover:text-accent-foreground",
+  };
+  const sizes: Record<string, string> = {
+    sm: "h-8 rounded-md px-3 text-[12px]",
+    xs: "h-7 rounded-md px-2.5 text-[11px]",
+    icon: "h-8 w-8 rounded-md",
+  };
+  return (
+    <button class={`${base} ${variants[variant]} ${sizes[size]}`} onclick={onclick}>
+      {children}
+    </button>
+  );
+}
+
+function Card({ children, className = "" }: { children: JSX.Element; className?: string }) {
+  return (
+    <div class={`rounded-xl border border-border bg-card text-card-foreground shadow-sm ${className}`}>{children}</div>
+  );
+}
+
+function Separator() {
+  return <div class="shrink-0 bg-border h-px w-full" />;
+}
+
+// ---------------------------------------------------------------------------
+// Sections
+// ---------------------------------------------------------------------------
+
+function TopNav({ config, protocolBadges }: { config: AixyzConfigRuntime; protocolBadges: string[] }) {
+  return (
+    <nav class="flex items-center justify-between h-14 border-b border-border">
+      <div class="flex items-center gap-3">
+        <img
+          src="/icon.png"
+          alt=""
+          class="w-7 h-7 rounded-lg object-cover"
+          // On error, hide the image and show the fallback svg
+          onerror="this.style.display='none';this.nextElementSibling.style.display='flex'"
+        />
+        <div class="w-7 h-7 rounded-lg items-center justify-center overflow-hidden" style="display:none">
+          <svg width="256" height="256" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
+            <rect width="24" height="24" rx="3" fill="black" />
+            <path
+              fill-rule="evenodd"
+              clip-rule="evenodd"
+              d="M6.96388 5.15701C7.13522 5.05191 7.33432 4.99702 7.53297 5.00012C7.73163 5.00323 7.91978 5.06416 8.07077 5.1743L17.1705 11.8148C17.3129 11.9186 17.4156 12.0614 17.4657 12.2251C17.5158 12.3888 17.5109 12.5659 17.4518 12.7342C17.3927 12.9024 17.2819 13.0541 17.1335 13.1702C16.9851 13.2862 16.8058 13.3613 16.6182 13.386L13.9133 13.7438L16.5299 17.6214C16.6588 17.8126 16.6964 18.0487 16.6343 18.2779C16.5722 18.507 16.4155 18.7103 16.1988 18.8431C15.982 18.9759 15.723 19.0274 15.4785 18.9861C15.2341 18.9448 15.0244 18.8142 14.8954 18.623L12.2804 14.7461L10.817 16.9431C10.7157 17.0957 10.5696 17.2201 10.3973 17.3008C10.2249 17.3814 10.0341 17.4146 9.84892 17.3961C9.66375 17.3776 9.49259 17.3083 9.35712 17.1969C9.22166 17.0855 9.12798 16.9371 9.08796 16.7704L6.52209 6.12374C6.47934 5.94713 6.49896 5.75862 6.57819 5.58491C6.65742 5.41121 6.79223 5.26112 6.96353 5.15591L6.96388 5.15701Z"
+              fill="#ffffff"
+            />
+          </svg>
+        </div>
+        <div class="flex items-baseline gap-2">
+          <span class="text-[14px] font-semibold text-foreground">{Html.escapeHtml(config.name)}</span>
+          <span class="text-[11px] font-mono text-muted-foreground hidden xs:inline">
+            {"v" + Html.escapeHtml(config.version)}
+          </span>
+        </div>
+      </div>
+      {protocolBadges.length > 0 && <div class="flex items-center gap-1.5 flex-wrap">{protocolBadges.join("")}</div>}
+    </nav>
+  );
+}
+
+function HeroBanner({ config }: { config: AixyzConfigRuntime }) {
+  return (
+    <div class="py-8 sm:py-14 text-center">
+      <h1 class="text-[1.75rem] sm:text-[2rem] font-bold tracking-[-0.025em] text-foreground leading-[1.2]">
+        {Html.escapeHtml(config.name)}
+      </h1>
+      <p class="text-[15px] text-muted-foreground leading-relaxed mt-3 max-w-[420px] mx-auto">
+        {Html.escapeHtml(config.description)}
+      </p>
+    </div>
+  );
+}
+
+// ---------------------------------------------------------------------------
+// Prompt script builder
+// ---------------------------------------------------------------------------
+
+type ContinuationWithMessages = {
+  label: string;
+  protocol: string;
+  text: string;
+  hasMessage: boolean;
+  messages: string[];
+};
+
+function buildPromptScript(
+  basePrompt: string,
+  continuations: ContinuationWithMessages[],
+  id: string,
+  defaultMsg: string,
+  hasExamples: boolean,
+): string {
+  return `
+(function(){
+  var base=${safeJsonStringify(basePrompt)};
+  var conts=${safeJsonStringify(continuations.map((c) => c.text))};
+  var hasMsg=${safeJsonStringify(continuations.map((c) => c.hasMessage))};
+  var msgSets=${safeJsonStringify(continuations.map((c) => c.messages))};
+  var activeChipIdx=0;
+  var activeMsg=${safeJsonStringify(defaultMsg)};
+  var isCustom=${hasExamples ? "false" : "true"};
+  window.__promptBase=base;
+  var ACT=${safeJsonStringify(CHIP_ACTIVE)};
+  var INACT=${safeJsonStringify(CHIP_INACTIVE)};
+  function animateHeight(el){
+    var oldH=el.scrollHeight;
+    el.style.maxHeight=oldH+'px';
+    return function(){
+      requestAnimationFrame(function(){
+        var newH=el.scrollHeight;
+        if(newH!==oldH){el.style.maxHeight=newH+'px';}
+        setTimeout(function(){el.style.maxHeight='none';},250);
+      });
+    };
+  }
+  function render(animate){
+    var el=document.getElementById(${safeJsonStringify(id)});
+    var finish=animate&&el?animateHeight(el):null;
+    var t=conts[activeChipIdx]||'';
+    if(hasMsg[activeChipIdx]){t=t.replaceAll('%MSG%',activeMsg);}
+    window.__promptCont=t;
+    if(el)el.textContent=base+t;
+    if(finish)finish();
+  }
+  render(false);
+  function swapClass(el,from,to){el.className=el.className.replace(from,to);}
+  function rebuildMsgChips(idx){
+    var msgs=msgSets[idx]||[];
+    var container=document.getElementById('msg-chips');
+    if(!container)return;
+    var finishChips=animateHeight(container);
+    container.innerHTML='';
+    for(var i=0;i<msgs.length;i++){
+      var btn=document.createElement('button');
+      btn.className='msg-chip inline-flex items-center gap-1.5 rounded-md px-2.5 py-1.5 sm:py-1 text-[11px] font-medium font-mono transition-colors cursor-pointer border w-full text-left '+(i===0?ACT:INACT);
+      btn.dataset.msgIndex=String(i);
+      btn.onclick=function(){window.__selectMessage(this);};
+      btn.textContent=msgs[i];
+      container.appendChild(btn);
+    }
+    var custom=document.createElement('button');
+    custom.className='msg-chip inline-flex items-center gap-1.5 rounded-md px-2.5 py-1.5 sm:py-1 text-[11px] font-medium font-mono transition-colors cursor-pointer border w-full text-left '+(msgs.length===0?ACT:INACT);
+    custom.dataset.msgIndex='custom';
+    custom.onclick=function(){window.__selectMessage(this);};
+    custom.innerHTML='&#9998; Custom';
+    container.appendChild(custom);
+    finishChips();
+    var customRow=document.getElementById('custom-input-row');
+    if(msgs.length===0){
+      isCustom=true;
+      if(customRow){customRow.classList.remove('collapsed');customRow.style.maxHeight='60px';}
+      var inp=document.getElementById('custom-msg-input');
+      activeMsg=inp?inp.value||'<your message>':'<your message>';
+    } else {
+      isCustom=false;
+      if(customRow){customRow.style.maxHeight='0';customRow.classList.add('collapsed');}
+      activeMsg=msgs[0];
+    }
+  }
+  window.__selectChip=function(el){
+    var idx=parseInt(el.dataset.index,10);
+    activeChipIdx=idx;
+    var chips=document.querySelectorAll('.prompt-chip');
+    for(var i=0;i<chips.length;i++){
+      if(i===idx){swapClass(chips[i],INACT,ACT);}
+      else{swapClass(chips[i],ACT,INACT);}
+    }
+    rebuildMsgChips(idx);
+    render(true);
+  };
+  window.__selectMessage=function(el){
+    var midx=el.dataset.msgIndex;
+    var chips=document.querySelectorAll('.msg-chip');
+    for(var i=0;i<chips.length;i++){swapClass(chips[i],ACT,INACT);}
+    swapClass(el,INACT,ACT);
+    var customRow=document.getElementById('custom-input-row');
+    var msgs=msgSets[activeChipIdx]||[];
+    if(midx==='custom'){
+      isCustom=true;
+      if(customRow){customRow.classList.remove('collapsed');customRow.style.maxHeight='60px';}
+      var inp=document.getElementById('custom-msg-input');
+      activeMsg=inp?inp.value||'<your message>':'<your message>';
+    } else {
+      isCustom=false;
+      if(customRow){customRow.style.maxHeight='0';customRow.classList.add('collapsed');}
+      activeMsg=msgs[parseInt(midx,10)]||'<your message>';
+    }
+    render(true);
+  };
+  window.__onCustomInput=function(el){
+    activeMsg=el.value||'<your message>';
+    render(true);
+  };
+})();
+          `;
+}
+
+// ---------------------------------------------------------------------------
+// Prompt Section
+// ---------------------------------------------------------------------------
+
+function PromptSection({
+  basePrompt,
+  continuations,
+  id,
+}: {
+  basePrompt: string;
+  continuations: ContinuationWithMessages[];
+  id: string;
+}) {
+  const hasContinuations = continuations.length > 0;
+  const firstCont = hasContinuations ? continuations[0] : null;
+  const firstMessages = firstCont?.messages ?? [];
+  const defaultMsg = firstMessages.length > 0 ? firstMessages[0] : "<your message>";
+  const defaultContinuation = firstCont
+    ? firstCont.hasMessage
+      ? firstCont.text.replaceAll("%MSG%", defaultMsg)
+      : firstCont.text
+    : "";
+  const fullPrompt = basePrompt + defaultContinuation;
+
+  return (
+    <Card>
+      <>
+        <div class="flex items-center justify-between px-3.5 sm:px-5 py-3 border-b border-border">
+          <div class="flex items-center gap-2">
+            <span class="text-primary">{SPARKLES_ICON}</span>
+            <span class="text-[13px] font-semibold text-foreground">System Prompt</span>
+            <span class="text-[11px] text-muted-foreground hidden sm:inline">— paste into any LLM</span>
+          </div>
+          <Button
+            variant="default"
+            size="xs"
+            onclick={`navigator.clipboard.writeText(window.__promptBase+(window.__promptCont||'')).then(()=>{this.querySelector('.cp-l').textContent='Copied!';setTimeout(()=>{this.querySelector('.cp-l').textContent='Copy'},1500)})`}
+          >
+            {COPY_ICON + '<span class="cp-l">Copy</span>'}
+          </Button>
+        </div>
+        <div class={`p-3.5 sm:p-5 bg-muted/30${hasContinuations ? "" : " rounded-b-xl"}`}>
+          <code
+            class="block text-[11.5px] sm:text-[12.5px] leading-[1.7] sm:leading-[1.8] font-mono text-muted-foreground whitespace-pre-wrap break-words"
+            id={id}
+          >
+            {Html.escapeHtml(fullPrompt)}
+          </code>
+        </div>
+        {hasContinuations && (
+          <div class="px-3.5 sm:px-5 py-3 border-t border-border">
+            <span class="block text-[11px] text-muted-foreground font-medium mb-1.5">Use via:</span>
+            <div class="flex flex-wrap gap-1.5">
+              {continuations.map((c, i) => (
+                <button
+                  class={`prompt-chip inline-flex items-center gap-1.5 rounded-md px-2.5 py-1.5 sm:py-1 text-[11px] font-medium font-mono transition-colors cursor-pointer border ${i === 0 ? CHIP_ACTIVE : CHIP_INACTIVE}`}
+                  data-index={String(i)}
+                  onclick="window.__selectChip(this)"
+                >
+                  {Html.escapeHtml(c.label) +
+                    " " +
+                    `<span class="text-[9px] opacity-60 uppercase">${Html.escapeHtml(c.protocol)}</span>`}
+                </button>
+              ))}
+            </div>
+          </div>
+        )}
+        {hasContinuations && (
+          <div id="msg-row" class="px-3.5 sm:px-5 pb-3 border-t-0">
+            <span class="block text-[11px] text-muted-foreground font-medium mb-1.5">Message:</span>
+            <div id="msg-chips" class="grid grid-cols-1 sm:grid-cols-2 gap-1.5">
+              {firstMessages.map((m, i) => (
+                <button
+                  class={`msg-chip inline-flex items-center gap-1.5 rounded-md px-2.5 py-1.5 sm:py-1 text-[11px] font-medium font-mono transition-colors cursor-pointer border w-full text-left ${i === 0 ? CHIP_ACTIVE : CHIP_INACTIVE}`}
+                  data-msg-index={String(i)}
+                  onclick="window.__selectMessage(this)"
+                >
+                  {Html.escapeHtml(m)}
+                </button>
+              ))}
+              <button
+                class={`msg-chip inline-flex items-center gap-1.5 rounded-md px-2.5 py-1.5 sm:py-1 text-[11px] font-medium font-mono transition-colors cursor-pointer border w-full text-left ${firstMessages.length === 0 ? CHIP_ACTIVE : CHIP_INACTIVE}`}
+                data-msg-index="custom"
+                onclick="window.__selectMessage(this)"
+              >
+                {"&#9998; Custom"}
+              </button>
+            </div>
+            <div
+              id="custom-input-row"
+              class={`mt-2${firstMessages.length === 0 ? "" : " collapsed"}`}
+              style={firstMessages.length === 0 ? "max-height:60px" : "max-height:0"}
+            >
+              <input
+                type="text"
+                id="custom-msg-input"
+                placeholder="Type your message..."
+                class="w-full rounded-md border border-border bg-background px-2.5 py-2 sm:py-1.5 text-[12px] sm:text-[11px] font-mono text-foreground placeholder:text-muted-foreground/50 focus:outline-none focus:ring-1 focus:ring-ring"
+                oninput="window.__onCustomInput(this)"
+              />
+            </div>
+          </div>
+        )}
+        {hasContinuations && (
+          <script>{buildPromptScript(basePrompt, continuations, id, defaultMsg, firstMessages.length > 0)}</script>
+        )}
+      </>
+    </Card>
+  );
+}
+
+// ---------------------------------------------------------------------------
+// Skill-to-tool matching
+// ---------------------------------------------------------------------------
+
+type Skill = NonNullable<AixyzConfigRuntime["skills"]>[number];
+
+export function getExamplesForTool(toolName: string, skills: Skill[]): string[] {
+  const name = toolName.toLowerCase();
+  const matched = skills.filter((s) => {
+    const sId = s.id.toLowerCase();
+    const sName = s.name.toLowerCase();
+    const sTags = (s.tags ?? []).map((t) => t.toLowerCase());
+    return (
+      sId.includes(name) ||
+      sName.includes(name) ||
+      name.includes(sId.replace(/-/g, "")) ||
+      sTags.some((t) => name.includes(t) || t.includes(name))
+    );
+  });
+  const examples =
+    matched.length > 0 ? matched.flatMap((s) => s.examples ?? []) : skills.flatMap((s) => s.examples ?? []);
+  return examples;
+}
+
+// ---------------------------------------------------------------------------
+// Prompt builder
+// ---------------------------------------------------------------------------
+
+function buildAgentPrompt(config: AixyzConfigRuntime): string {
+  const agentUrl = config.url ?? "AGENT_URL";
+  const skillsList =
+    config.skills && config.skills.length > 0
+      ? config.skills.map((s) => `- ${s.name}: ${s.description}`).join("\n")
+      : "";
+
+  let prompt = `You have access to an AI agent called "${config.name}" at ${agentUrl} — ${config.description.replace(/\.$/, "").toLowerCase()}. Use the \`use-agently\` CLI (npx use-agently) to interact with it.`;
+  if (skillsList) prompt += `\n\nSkills:\n${skillsList}`;
+  return prompt;
+}
+
+const CONTINUATION_SUFFIX = `\n\nWhen I ask for something this agent can help with, send it a clear message using the command above. Share the agent's response with me. You can send multiple messages to follow up or refine.`;
+
+function buildContinuation(
+  entry: Entrypoint,
+  agentUrl: string,
+  configName: string,
+): { label: string; protocol: string; text: string; hasMessage: boolean } {
+  if (entry.protocol === "a2a") {
+    const prefix = entry.path.slice(1, -"/agent".length);
+    const uri = prefix ? new URL(`${prefix}/`, agentUrl).toString() : agentUrl;
+    const label = prefix || configName;
+    return {
+      label,
+      protocol: "A2A",
+      text:
+        `\n\nTo call this agent, run:\nnpx use-agently a2a send --uri ${uri} -m "<your message>"\n\nMy request: "%MSG%"` +
+        CONTINUATION_SUFFIX,
+      hasMessage: true,
+    };
+  }
+  const uri = new URL(entry.path, agentUrl).toString();
+  const args = (entry.inputSchema ? JSON.stringify(entry.inputSchema) : "{}").replaceAll("'", "'\\''");
+  return {
+    label: entry.name,
+    protocol: "MCP",
+    text:
+      `\n\nTo call the "${entry.name}" tool, run:\nnpx use-agently mcp call --uri ${uri} --tool ${entry.name} --args '${args}'` +
+      `\n\nMy request: "%MSG%"` +
+      `\n\nWhen I ask for something this tool can help with, determine the appropriate --args from my request and run the command above. Share the tool's response with me. You can run the command multiple times to refine.`,
+    hasMessage: true,
+  };
+}
+
+// ---------------------------------------------------------------------------
+// Page
+// ---------------------------------------------------------------------------
+
+export function renderHtml(config: AixyzConfigRuntime, protocols: ProtocolInfo): string {
+  const agentUrl = config.url ?? "AGENT_URL";
+  const basePrompt = buildAgentPrompt(config);
+
+  const rawContinuations = protocols.entrypoints.map((e) => buildContinuation(e, agentUrl, config.name));
+
+  const allSkills = config.skills ?? [];
+  const allExamples = allSkills.flatMap((s) => s.examples ?? []);
+  const continuations: ContinuationWithMessages[] = rawContinuations.map((c, i) => ({
+    ...c,
+    messages:
+      protocols.entrypoints[i].protocol === "a2a"
+        ? allExamples
+        : getExamplesForTool(protocols.entrypoints[i].name, allSkills),
+  }));
+
+  const protocolBadges: string[] = [];
+  if (protocols.a2a) protocolBadges.push((<Badge variant="secondary">A2A</Badge>) as string);
+  if (protocols.mcp) protocolBadges.push((<Badge variant="secondary">MCP</Badge>) as string);
+  if (protocols.entrypoints.some((e) => e.paid))
+    protocolBadges.push((<Badge variant="destructive">x402</Badge>) as string);
+
+  return (
+    "<!doctype html>" +
+    (
+      <html lang="en" class="dark">
+        <head>
+          <meta charset="utf-8" />
+          <meta name="viewport" content="width=device-width,initial-scale=1" />
+          <title>{Html.escapeHtml(config.name)}</title>
+          <link rel="icon" href="/favicon.ico" />
+          <script src="https://cdn.jsdelivr.net/npm/@tailwindcss/browser@4"></script>
+          <style type="text/tailwindcss">{`
+            @theme {
+              --font-sans: "Inter", system-ui, -apple-system, "Segoe UI", sans-serif;
+              --font-mono: ui-monospace, SFMono-Regular, "Cascadia Code", "Fira Code", monospace;
+              --radius: 0.625rem;
+
+              --color-background: hsl(240 6% 6%);
+              --color-foreground: hsl(240 5% 90%);
+              --color-card: hsl(240 5% 8%);
+              --color-card-foreground: hsl(240 5% 90%);
+              --color-popover: hsl(240 5% 8%);
+              --color-popover-foreground: hsl(240 5% 90%);
+              --color-primary: hsl(239 84% 67%);
+              --color-primary-foreground: hsl(0 0% 100%);
+              --color-secondary: hsl(240 5% 13%);
+              --color-secondary-foreground: hsl(240 4% 65%);
+              --color-muted: hsl(240 5% 13%);
+              --color-muted-foreground: hsl(240 4% 55%);
+              --color-accent: hsl(240 5% 15%);
+              --color-accent-foreground: hsl(240 5% 90%);
+              --color-destructive: hsl(0 63% 31%);
+              --color-destructive-foreground: hsl(0 0% 98%);
+              --color-border: hsl(240 4% 14%);
+              --color-input: hsl(240 4% 14%);
+              --color-ring: hsl(239 84% 67%);
+              --color-chart-1: hsl(239 84% 67%);
+              --color-chart-4: hsl(38 92% 50%);
+              --color-success: hsl(142 71% 45%);
+            }
+
+            body {
+              background: var(--color-background);
+              color: var(--color-foreground);
+              font-feature-settings: "cv11", "ss01";
+              -webkit-font-smoothing: antialiased;
+              -moz-osx-font-smoothing: grayscale;
+            }
+
+            /* Top accent bar */
+            body::before {
+              content: "";
+              position: fixed;
+              top: 0;
+              left: 0;
+              right: 0;
+              height: 1px;
+              background: linear-gradient(
+                90deg,
+                transparent 5%,
+                color-mix(in srgb, var(--color-primary) 40%, transparent) 20%,
+                var(--color-primary) 50%,
+                color-mix(in srgb, var(--color-primary) 40%, transparent) 80%,
+                transparent 95%
+              );
+              z-index: 9999;
+            }
+
+            /* Glow */
+            .glow {
+              background: radial-gradient(
+                ellipse 450px 160px at 50% 0%,
+                color-mix(in srgb, var(--color-primary) 4%, transparent),
+                transparent
+              );
+            }
+
+            /* Smooth layout transitions */
+            #agent-prompt, #msg-chips {
+              transition: max-height 0.2s ease-out;
+              overflow: hidden;
+            }
+            #custom-input-row {
+              transition: max-height 0.2s ease-out, opacity 0.15s ease-out, margin 0.2s ease-out;
+              overflow: hidden;
+            }
+            #custom-input-row.collapsed {
+              max-height: 0 !important;
+              opacity: 0;
+              margin-top: 0;
+            }
+
+            /* Entrance */
+            @keyframes enter {
+              from { opacity: 0; transform: translateY(4px); }
+              to { opacity: 1; transform: translateY(0); }
+            }
+            .anim { animation: enter 0.25s ease-out both; }
+
+            /* Scrollbar */
+            ::-webkit-scrollbar { width: 5px; }
+            ::-webkit-scrollbar-track { background: transparent; }
+            ::-webkit-scrollbar-thumb { background: var(--color-border); border-radius: 9999px; }
+
+            /* Selection */
+            ::selection {
+              background: color-mix(in srgb, var(--color-primary) 20%, transparent);
+              color: var(--color-foreground);
+            }
+          `}</style>
+        </head>
+        <body class="font-sans min-h-screen">
+          <div class="glow fixed inset-x-0 top-0 h-[300px] pointer-events-none" />
+
+          <div class="relative max-w-[620px] mx-auto px-4 sm:px-5 py-5 sm:py-8">
+            {/* ── Nav ─────────────────────────────────── */}
+            <div class="anim" style="animation-delay: 0ms">
+              <TopNav config={config} protocolBadges={protocolBadges} />
+            </div>
+
+            {/* ── Hero ────────────────────────────────── */}
+            <div class="anim" style="animation-delay: 30ms">
+              <HeroBanner config={config} />
+            </div>
+
+            {/* ── Prompt ──────────────────────────────── */}
+            <div class="anim" style="animation-delay: 60ms">
+              <PromptSection basePrompt={basePrompt} continuations={continuations} id="agent-prompt" />
+            </div>
+
+            {/* ── Footer ──────────────────────────────── */}
+            <footer class="mt-14 pb-6 anim" style="animation-delay: 120ms">
+              <Separator />
+              <div class="flex items-center justify-center gap-1.5 mt-5">
+                <span class="text-[11px] text-muted-foreground/60">powered by</span>
+                <span class="text-[11px] text-primary font-semibold">aixyz</span>
+              </div>
+            </footer>
+          </div>
+        </body>
+      </html>
+    )
+  );
+}

package/app/plugins/index-page/index.ts

@@ -0,0 +1,184 @@
+import { getAixyzConfigRuntime } from "@aixyz/config";
+import { z } from "zod";
+import { BasePlugin } from "../../plugin";
+import type { AixyzApp } from "../../index";
+import type { MCPPlugin } from "../mcp";
+import { renderHtml } from "./html";
+
+export type AixyzConfigRuntime = ReturnType<typeof getAixyzConfigRuntime>;
+
+export interface Entrypoint {
+  protocol: "a2a" | "mcp";
+  name: string;
+  path: string;
+  description?: string;
+  paid: boolean;
+  inputSchema?: Record<string, unknown>;
+}
+
+export interface ProtocolInfo {
+  a2a: boolean;
+  mcp: boolean;
+  entrypoints: Entrypoint[];
+}
+
+function prefersHtml(request: Request): boolean {
+  const accept = request.headers.get("accept") ?? "";
+  if (!/text\/html/i.test(accept)) return false;
+  return !/text\/html\s*;\s*q\s*=\s*0(\.0*)?\s*(,|$)/i.test(accept);
+}
+
+function renderMarkdown(config: AixyzConfigRuntime, protocols: ProtocolInfo): string {
+  const url = config.url ?? "AGENT_URL";
+
+  let md = `# ${config.name}\n\n`;
+  md += `${config.description} Use the \`use-agently\` CLI (npx use-agently) to interact with this agent.\n\n`;
+  md += `> v${config.version}`;
+  if (config.url) md += ` · ${config.url}`;
+  md += `\n\n`;
+
+  const badges: string[] = [];
+  if (protocols.a2a) badges.push("A2A");
+  if (protocols.mcp) badges.push("MCP");
+  if (protocols.entrypoints.some((e) => e.paid)) badges.push("x402");
+  if (badges.length > 0) md += `${badges.join(" · ")}\n\n`;
+
+  if (config.skills && config.skills.length > 0) {
+    md += `## Skills\n\n`;
+    for (const skill of config.skills) {
+      md += `### ${skill.name}\n\n`;
+      md += `${skill.description}\n\n`;
+      if (skill.tags && skill.tags.length > 0) {
+        md += `Tags: ${skill.tags.map((t) => `\`${t}\``).join(", ")}\n\n`;
+      }
+      if (skill.examples && skill.examples.length > 0 && protocols.a2a) {
+        md += `**Examples:**\n\n`;
+        md += `\`\`\`sh\n`;
+        for (const example of skill.examples) {
+          const safeExample = example.replace(/'/g, "'\\''");
+          md += `npx use-agently a2a send --uri ${url} -m '${safeExample}'\n`;
+        }
+        md += `\`\`\`\n\n`;
+      }
+    }
+  }
+
+  if (protocols.entrypoints.length > 0) {
+    md += `## Entrypoints\n\n`;
+    const a2aEntries = protocols.entrypoints.filter((e) => e.protocol === "a2a");
+    const mcpEntries = protocols.entrypoints.filter((e) => e.protocol === "mcp");
+    if (a2aEntries.length > 0) {
+      md += `### A2A Agents\n\n`;
+      for (const e of a2aEntries) {
+        md += `- **${e.name}** \`${e.path}\`${e.description ? ` — ${e.description}` : ""} (${e.paid ? "paid" : "free"})\n`;
+      }
+      md += `\n`;
+    }
+    if (mcpEntries.length > 0) {
+      md += `### MCP Tools\n\n`;
+      for (const e of mcpEntries) {
+        md += `- **${e.name}** \`${e.path}\`${e.description ? ` — ${e.description}` : ""} (${e.paid ? "paid" : "free"})\n`;
+      }
+      md += `\n`;
+    }
+  }
+
+  md += `---\n\n`;
+  md += `Use this agent:\n\n`;
+  md += `\`\`\`sh\n`;
+  if (protocols.a2a) {
+    md += `# Send a message via A2A\n`;
+    md += `npx use-agently a2a send --uri ${url} -m "your prompt here"\n\n`;
+    md += `# View agent card\n`;
+    md += `npx use-agently a2a card --uri ${url}\n`;
+  }
+  if (protocols.mcp) {
+    if (protocols.a2a) md += `\n`;
+    md += `# List tools via MCP\n`;
+    md += `npx use-agently mcp tools --uri ${url}\n`;
+  }
+  md += `\`\`\`\n`;
+
+  return md;
+}
+
+/** Plugin that serves agent info with content negotiation: markdown for agents, HTML for humans. */
+export class IndexPagePlugin extends BasePlugin {
+  readonly name = "index-page";
+  private protocols: ProtocolInfo = { a2a: false, mcp: false, entrypoints: [] };
+
+  constructor(private path = "/") {
+    super();
+  }
+
+  register(app: AixyzApp): void {
+    const config = getAixyzConfigRuntime();
+    if (!this.path.startsWith("/")) {
+      throw new Error(`Invalid path: ${this.path}. Path must start with "/"`);
+    }
+
+    // Default to serve markdown, else explicitly asked for HTML (which browsers do by default)
+    app.route("GET", this.path, (request: Request) => {
+      if (prefersHtml(request)) {
+        return new Response(renderHtml(config, this.protocols), {
+          headers: { "Content-Type": "text/html; charset=utf-8", Vary: "Accept" },
+        });
+      }
+      return new Response(renderMarkdown(config, this.protocols), {
+        headers: { "Content-Type": "text/markdown; charset=utf-8", Vary: "Accept" },
+      });
+    });
+  }
+
+  initialize(app: AixyzApp): void {
+    const entrypoints: Entrypoint[] = [];
+
+    // Detect A2A agents from routes (POST */agent pattern)
+    for (const [key, entry] of app.routes) {
+      if (key.startsWith("POST ") && entry.path.endsWith("/agent")) {
+        const prefix = entry.path.slice(1, -"/agent".length); // e.g. "" or "foo"
+        const name = prefix || "agent";
+        entrypoints.push({
+          protocol: "a2a",
+          name,
+          path: entry.path,
+          paid: entry.payment?.scheme === "exact",
+        });
+      }
+    }
+
+    // Detect MCP tools from MCPPlugin
+    const mcpPlugin = app.getPlugin<MCPPlugin>("mcp");
+    if (mcpPlugin?.registeredTools) {
+      for (const tool of mcpPlugin.registeredTools) {
+        let inputSchema: Record<string, unknown> | undefined;
+        try {
+          const jsonSchema = z.toJSONSchema(tool.tool.inputSchema as z.ZodType);
+          const props = (jsonSchema as any).properties as
+            | Record<string, { type?: string; description?: string }>
+            | undefined;
+          if (props && Object.keys(props).length > 0) {
+            const example: Record<string, unknown> = {};
+            for (const [key, val] of Object.entries(props)) {
+              example[key] = `<${val.description || key}>`;
+            }
+            inputSchema = example;
+          }
+        } catch {}
+
+        entrypoints.push({
+          protocol: "mcp",
+          name: tool.name,
+          path: "/mcp",
+          description: tool.tool.description,
+          paid: tool.accepts?.scheme === "exact",
+          inputSchema,
+        });
+      }
+    }
+
+    this.protocols.a2a = entrypoints.some((e) => e.protocol === "a2a");
+    this.protocols.mcp = entrypoints.some((e) => e.protocol === "mcp");
+    this.protocols.entrypoints = entrypoints;
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aixyz",
-  "version": "0.23.0",
+  "version": "0.25.0",
   "description": "Payment-native SDK for AI Agent",
   "keywords": [
     "ai",
@@ -23,11 +23,13 @@
     "./app": "./app/index.ts",
     "./app/*": "./app/*.ts",
     "./app/adapters/*": "./app/adapters/*.ts",
+    "./app/plugins/index-page": "./app/plugins/index-page/index.ts",
     "./app/plugins/*": "./app/plugins/*.ts"
   },
   "bin": "bin.js",
   "files": [
     "**/*.ts",
+    "**/*.tsx",
     "!**/*.test.ts",
     "!test/**"
   ],
@@ -36,9 +38,10 @@
   },
   "dependencies": {
     "@a2a-js/sdk": "^0.3.10",
-    "@aixyz/cli": "0.23.0",
-    "@aixyz/config": "0.23.0",
-    "@aixyz/erc-8004": "0.23.0",
+    "@aixyz/cli": "0.25.0",
+    "@aixyz/config": "0.25.0",
+    "@aixyz/erc-8004": "0.25.0",
+    "@kitajs/html": "^4.2.13",
     "@modelcontextprotocol/sdk": "^1.27.1",
     "@next/env": "^16.1.6",
     "@x402/core": "^2.3.1",

package/app/plugins/index-page.ts

@@ -1,46 +0,0 @@
-import { getAixyzConfigRuntime } from "@aixyz/config";
-import { BasePlugin } from "../plugin";
-import type { AixyzApp } from "../index";
-
-/** Plugin that registers a plain-text index page displaying the agent's name, description, version, and skills. */
-export class IndexPagePlugin extends BasePlugin {
-  readonly name = "index-page";
-
-  constructor(private path = "/") {
-    super();
-  }
-
-  register(app: AixyzApp): void {
-    const config = getAixyzConfigRuntime();
-    if (!this.path.startsWith("/")) {
-      throw new Error(`Invalid path: ${this.path}. Path must start with "/"`);
-    }
-
-    app.route("GET", this.path, () => {
-      let text = `${config.name}\n`;
-      text += `${"=".repeat(config.name.length)}\n\n`;
-      text += `Description: ${config.description}\n`;
-      text += `Version: ${config.version}\n\n`;
-
-      if (config.skills && config.skills.length > 0) {
-        text += `Skills:\n`;
-        config.skills.forEach((skill, index) => {
-          text += `\n${index + 1}. ${skill.name}\n`;
-          text += `   ID: ${skill.id}\n`;
-          text += `   Description: ${skill.description}\n`;
-          if (skill.tags && skill.tags.length > 0) {
-            text += `   Tags: ${skill.tags.join(", ")}\n`;
-          }
-          if (skill.examples && skill.examples.length > 0) {
-            text += `   Examples:\n`;
-            skill.examples.forEach((example) => {
-              text += `   - ${example}\n`;
-            });
-          }
-        });
-      }
-
-      return new Response(text, { headers: { "Content-Type": "text/plain" } });
-    });
-  }
-}