@escalay/kit 0.0.0-stage → 1.8.0

package/registry.json

@@ -0,0 +1,548 @@
+{
+  "$schema": "https://ui.shadcn.com/schema/registry.json",
+  "name": "escalay",
+  "homepage": "https://github.com/escalay/api-kit",
+  "items": [
+    {
+      "name": "core",
+      "type": "registry:item",
+      "title": "Core",
+      "description": "createAgentApi: OpenAPI 3.1 + Scalar docs, HAL links, problem+json, API keys + Access, ETags and Cache-Control, Idempotency-Key and rate limits, discovery (api-catalog, Link headers, robots.txt, Markdown for agents), a key-value store type; an OAuth server plugs in from the `oauth` part",
+      "dependencies": [
+        "hono@^4.13.14",
+        "@hono/zod-openapi@^1.6.3",
+        "zod@^4.6.7",
+        "jose@^6.2.14",
+        "@scalar/hono-api-reference@^0.12.17"
+      ],
+      "files": [
+        {
+          "path": "src/core/api.ts",
+          "type": "registry:file",
+          "target": "~/src/kit/core/api.ts"
+        },
+        {
+          "path": "src/core/auth.ts",
+          "type": "registry:file",
+          "target": "~/src/kit/core/auth.ts"
+        },
+        {
+          "path": "src/core/cache.ts",
+          "type": "registry:file",
+          "target": "~/src/kit/core/cache.ts"
+        },
+        {
+          "path": "src/core/discovery.ts",
+          "type": "registry:file",
+          "target": "~/src/kit/core/discovery.ts"
+        },
+        {
+          "path": "src/core/guards.ts",
+          "type": "registry:file",
+          "target": "~/src/kit/core/guards.ts"
+        },
+        {
+          "path": "src/core/hal.ts",
+          "type": "registry:file",
+          "target": "~/src/kit/core/hal.ts"
+        },
+        {
+          "path": "src/core/kv.ts",
+          "type": "registry:file",
+          "target": "~/src/kit/core/kv.ts"
+        },
+        {
+          "path": "src/core/problem.ts",
+          "type": "registry:file",
+          "target": "~/src/kit/core/problem.ts"
+        },
+        {
+          "path": "src/core/README.md",
+          "type": "registry:file",
+          "target": "~/src/kit/core/README.md"
+        }
+      ]
+    },
+    {
+      "name": "db",
+      "type": "registry:item",
+      "title": "Database",
+      "description": "The app's database through Drizzle: `openDb` (node:sqlite, Turso/libSQL, or any async Drizzle SQLite database), `migrate` (each feature's steps, recorded in `kit_migrations`), `testDb`; `dbGuardStore` (idempotency and rate limits shared by every instance)",
+      "dependencies": [
+        "drizzle-orm@^0.45.4"
+      ],
+      "registryDependencies": [
+        "escalay/api-kit/core"
+      ],
+      "files": [
+        {
+          "path": "src/db/index.ts",
+          "type": "registry:file",
+          "target": "~/src/kit/db/index.ts"
+        },
+        {
+          "path": "src/db/guards.ts",
+          "type": "registry:file",
+          "target": "~/src/kit/db/guards.ts"
+        },
+        {
+          "path": "src/db/README.md",
+          "type": "registry:file",
+          "target": "~/src/kit/db/README.md"
+        }
+      ]
+    },
+    {
+      "name": "oauth",
+      "type": "registry:item",
+      "title": "OAuth server",
+      "description": "The app as its own OAuth server: metadata, `/oauth/*`, agent registration (auth.md), ES256 tokens; `createOAuth`, `dbOAuthStore`, `memoryOAuthStore`, `generateOAuthKey`",
+      "registryDependencies": [
+        "escalay/api-kit/core",
+        "escalay/api-kit/db"
+      ],
+      "files": [
+        {
+          "path": "src/oauth/index.ts",
+          "type": "registry:file",
+          "target": "~/src/kit/oauth/index.ts"
+        },
+        {
+          "path": "src/oauth/schema.ts",
+          "type": "registry:file",
+          "target": "~/src/kit/oauth/schema.ts"
+        },
+        {
+          "path": "src/oauth/store.ts",
+          "type": "registry:file",
+          "target": "~/src/kit/oauth/store.ts"
+        },
+        {
+          "path": "src/oauth/README.md",
+          "type": "registry:file",
+          "target": "~/src/kit/oauth/README.md"
+        }
+      ]
+    },
+    {
+      "name": "pagination",
+      "type": "registry:item",
+      "title": "Pagination",
+      "description": "Cursor pages and sorting: limitQuery, cursorQuery, sortQuery, pageOf, pageSchema",
+      "registryDependencies": [
+        "escalay/api-kit/core"
+      ],
+      "files": [
+        {
+          "path": "src/pagination/index.ts",
+          "type": "registry:file",
+          "target": "~/src/kit/pagination/index.ts"
+        },
+        {
+          "path": "src/pagination/README.md",
+          "type": "registry:file",
+          "target": "~/src/kit/pagination/README.md"
+        }
+      ]
+    },
+    {
+      "name": "guide",
+      "type": "registry:item",
+      "title": "Agent guide",
+      "description": "The agent guide from Markdown templates (llms.txt, agents/, skills/), its generated parts (endpoints, tools, playbooks, how to get unstuck) and the skills discovery index",
+      "registryDependencies": [
+        "escalay/api-kit/core"
+      ],
+      "files": [
+        {
+          "path": "src/guide/guide.ts",
+          "type": "registry:file",
+          "target": "~/src/kit/guide/guide.ts"
+        },
+        {
+          "path": "src/guide/reference.ts",
+          "type": "registry:file",
+          "target": "~/src/kit/guide/reference.ts"
+        },
+        {
+          "path": "src/guide/README.md",
+          "type": "registry:file",
+          "target": "~/src/kit/guide/README.md"
+        }
+      ]
+    },
+    {
+      "name": "mcp",
+      "type": "registry:item",
+      "title": "MCP server",
+      "description": "An MCP server (2026-07-28) over the app's own routes: tools, resources, prompts, skills, and its Server Card",
+      "dependencies": [
+        "@modelcontextprotocol/server@^2.4.0"
+      ],
+      "registryDependencies": [
+        "escalay/api-kit/core"
+      ],
+      "files": [
+        {
+          "path": "src/mcp/index.ts",
+          "type": "registry:file",
+          "target": "~/src/kit/mcp/index.ts"
+        },
+        {
+          "path": "src/mcp/README.md",
+          "type": "registry:file",
+          "target": "~/src/kit/mcp/README.md"
+        }
+      ],
+      "meta": {
+        "entry": true
+      }
+    },
+    {
+      "name": "a2a",
+      "type": "registry:item",
+      "title": "A2A",
+      "description": "A2A 1.0 over the MCP tools: the Agent Card at /.well-known/agent-card.json and a JSON-RPC endpoint (SendMessage, GetTask, ListTasks, CancelTask) whose skills are tools",
+      "registryDependencies": [
+        "escalay/api-kit/mcp"
+      ],
+      "files": [
+        {
+          "path": "src/a2a/index.ts",
+          "type": "registry:file",
+          "target": "~/src/kit/a2a/index.ts"
+        },
+        {
+          "path": "src/a2a/README.md",
+          "type": "registry:file",
+          "target": "~/src/kit/a2a/README.md"
+        }
+      ],
+      "meta": {
+        "entry": true
+      }
+    },
+    {
+      "name": "vectors",
+      "type": "registry:item",
+      "title": "Vectors",
+      "description": "Gemini Embedding 2 through OpenRouter: look (image) and meaning (text) vectors, append-only ledgers that never pay twice, budgets and spend caps, nearest and standouts search (sharp, for pictures only)",
+      "files": [
+        {
+          "path": "src/vectors/index.ts",
+          "type": "registry:file",
+          "target": "~/src/kit/vectors/index.ts"
+        },
+        {
+          "path": "src/vectors/README.md",
+          "type": "registry:file",
+          "target": "~/src/kit/vectors/README.md"
+        }
+      ],
+      "meta": {
+        "optionalDependencies": {
+          "sharp": "^0.34.5"
+        }
+      }
+    },
+    {
+      "name": "vector-search",
+      "type": "registry:item",
+      "title": "Vector search",
+      "description": "Search by words, by picture and by likeness over the vectors: three documented routes (rate-limited where they cost) and the MCP tools that call them",
+      "registryDependencies": [
+        "escalay/api-kit/vectors",
+        "escalay/api-kit/mcp"
+      ],
+      "files": [
+        {
+          "path": "src/vector-search/index.ts",
+          "type": "registry:file",
+          "target": "~/src/kit/vector-search/index.ts"
+        },
+        {
+          "path": "src/vector-search/README.md",
+          "type": "registry:file",
+          "target": "~/src/kit/vector-search/README.md"
+        }
+      ],
+      "meta": {
+        "entry": true
+      }
+    },
+    {
+      "name": "web",
+      "type": "registry:item",
+      "title": "Front door",
+      "description": "The front door: a public landing page at /, the browser app under /app behind the sign-in, old addresses redirected, and the paths auth must leave open",
+      "dependencies": [
+        "@hono/node-server@^2.1.5"
+      ],
+      "registryDependencies": [
+        "escalay/api-kit/core"
+      ],
+      "files": [
+        {
+          "path": "src/web/index.ts",
+          "type": "registry:file",
+          "target": "~/src/kit/web/index.ts"
+        },
+        {
+          "path": "src/web/README.md",
+          "type": "registry:file",
+          "target": "~/src/kit/web/README.md"
+        }
+      ]
+    },
+    {
+      "name": "boards",
+      "type": "registry:item",
+      "title": "Boards",
+      "description": "The owner's collections of the app's items: boards with notes in SQLite, their routes (idempotent saves, where an item is saved, optional suggestions) and MCP tools",
+      "registryDependencies": [
+        "escalay/api-kit/db",
+        "escalay/api-kit/mcp"
+      ],
+      "files": [
+        {
+          "path": "src/boards/index.ts",
+          "type": "registry:file",
+          "target": "~/src/kit/boards/index.ts"
+        },
+        {
+          "path": "src/boards/handlers.ts",
+          "type": "registry:file",
+          "target": "~/src/kit/boards/handlers.ts"
+        },
+        {
+          "path": "src/boards/refs.ts",
+          "type": "registry:file",
+          "target": "~/src/kit/boards/refs.ts"
+        },
+        {
+          "path": "src/boards/repo.ts",
+          "type": "registry:file",
+          "target": "~/src/kit/boards/repo.ts"
+        },
+        {
+          "path": "src/boards/routes.ts",
+          "type": "registry:file",
+          "target": "~/src/kit/boards/routes.ts"
+        },
+        {
+          "path": "src/boards/schema.ts",
+          "type": "registry:file",
+          "target": "~/src/kit/boards/schema.ts"
+        },
+        {
+          "path": "src/boards/tools.ts",
+          "type": "registry:file",
+          "target": "~/src/kit/boards/tools.ts"
+        },
+        {
+          "path": "src/boards/README.md",
+          "type": "registry:file",
+          "target": "~/src/kit/boards/README.md"
+        }
+      ],
+      "meta": {
+        "entry": true
+      }
+    },
+    {
+      "name": "testing",
+      "type": "registry:item",
+      "title": "Testing",
+      "description": "Checks for an app's tests: lintOpenApi, guideRoutes, guideGaps, toolRoutes",
+      "registryDependencies": [
+        "escalay/api-kit/guide"
+      ],
+      "files": [
+        {
+          "path": "src/testing/index.ts",
+          "type": "registry:file",
+          "target": "~/src/kit/testing/index.ts"
+        },
+        {
+          "path": "src/testing/README.md",
+          "type": "registry:file",
+          "target": "~/src/kit/testing/README.md"
+        }
+      ],
+      "meta": {
+        "entry": true
+      }
+    },
+    {
+      "name": "search-client",
+      "type": "registry:item",
+      "title": "Search client",
+      "description": "Browser, no framework: a typed client for vector-search's routes, a controller for one search's state (debounced, cancelling), paste and drop of pictures",
+      "files": [
+        {
+          "path": "src/browser/search-client.ts",
+          "type": "registry:file",
+          "target": "~/src/kit/browser/search-client.ts"
+        },
+        {
+          "path": "src/browser/README.md",
+          "type": "registry:file",
+          "target": "~/src/kit/browser/README.md"
+        }
+      ],
+      "meta": {
+        "entry": true,
+        "web": true
+      }
+    },
+    {
+      "name": "search-react",
+      "type": "registry:item",
+      "title": "Search hooks",
+      "description": "Browser, React: useVectorSearch, usePictureInput, useSimilar over search-client; headless, each app draws its own UI",
+      "dependencies": [
+        "react"
+      ],
+      "registryDependencies": [
+        "escalay/api-kit/search-client"
+      ],
+      "files": [
+        {
+          "path": "src/browser/search-react.ts",
+          "type": "registry:file",
+          "target": "~/src/kit/browser/search-react.ts"
+        },
+        {
+          "path": "src/browser/README.md",
+          "type": "registry:file",
+          "target": "~/src/kit/browser/README.md"
+        }
+      ],
+      "meta": {
+        "entry": true,
+        "web": true
+      }
+    },
+    {
+      "name": "vector-search-ui",
+      "type": "registry:item",
+      "title": "Vector search block",
+      "description": "Browser, React + shadcn: an optional search block (field with a picture chip, look/meaning switch, results grid) over search-react",
+      "dependencies": [
+        "react"
+      ],
+      "registryDependencies": [
+        "button",
+        "input",
+        "escalay/api-kit/search-react"
+      ],
+      "files": [
+        {
+          "path": "src/browser/vector-search-block.tsx",
+          "type": "registry:file",
+          "target": "~/src/kit/browser/vector-search-block.tsx"
+        },
+        {
+          "path": "src/browser/README.md",
+          "type": "registry:file",
+          "target": "~/src/kit/browser/README.md"
+        }
+      ],
+      "meta": {
+        "entry": true,
+        "web": true
+      }
+    },
+    {
+      "name": "boards-client",
+      "type": "registry:item",
+      "title": "Boards client",
+      "description": "Browser, no framework: a typed client for the board routes",
+      "files": [
+        {
+          "path": "src/browser/boards-client.ts",
+          "type": "registry:file",
+          "target": "~/src/kit/browser/boards-client.ts"
+        },
+        {
+          "path": "src/boards/refs.ts",
+          "type": "registry:file",
+          "target": "~/src/kit/boards/refs.ts"
+        },
+        {
+          "path": "src/browser/README.md",
+          "type": "registry:file",
+          "target": "~/src/kit/browser/README.md"
+        }
+      ],
+      "meta": {
+        "entry": true,
+        "web": true
+      }
+    },
+    {
+      "name": "boards-react",
+      "type": "registry:item",
+      "title": "Boards hooks",
+      "description": "Browser, React: useBoards, useItemBoards over boards-client (headless)",
+      "dependencies": [
+        "react"
+      ],
+      "registryDependencies": [
+        "escalay/api-kit/boards-client"
+      ],
+      "files": [
+        {
+          "path": "src/browser/boards-react.ts",
+          "type": "registry:file",
+          "target": "~/src/kit/browser/boards-react.ts"
+        },
+        {
+          "path": "src/browser/README.md",
+          "type": "registry:file",
+          "target": "~/src/kit/browser/README.md"
+        }
+      ],
+      "meta": {
+        "entry": true,
+        "web": true
+      }
+    },
+    {
+      "name": "npm-release",
+      "type": "registry:item",
+      "title": "npm release",
+      "description": "Releases of an npm package with no manual step: release-please keeps a release pull request, merging it publishes every public package from GitHub Actions with npm trusted publishing and provenance, waits until npm serves them and publishes the GitHub release; with a read-only release check and the standard that explains it. For any pnpm repo; its files go to the repo root",
+      "files": [
+        {
+          "path": ".github/workflows/release.yml",
+          "type": "registry:file",
+          "target": "~/.github/workflows/release.yml"
+        },
+        {
+          "path": "templates/npm-release/release-please-config.json",
+          "type": "registry:file",
+          "target": "~/release-please-config.json"
+        },
+        {
+          "path": "templates/npm-release/release-please-manifest.json",
+          "type": "registry:file",
+          "target": "~/.release-please-manifest.json"
+        },
+        {
+          "path": "scripts/release-check.mjs",
+          "type": "registry:file",
+          "target": "~/scripts/release-check.mjs"
+        },
+        {
+          "path": "docs/releasing.md",
+          "type": "registry:file",
+          "target": "~/docs/releasing.md"
+        }
+      ],
+      "meta": {
+        "root": true
+      }
+    }
+  ]
+}

package/src/a2a/README.md

@@ -0,0 +1,25 @@
+# a2a
+
+A2A 1.0 over the MCP tools: an Agent Card at `/.well-known/agent-card.json` and a JSON-RPC endpoint at `/a2a` whose
+skills are tools. Another agent sends a message naming a skill; a slow route leaves the task working and `GetTask`
+asks again.
+
+Needs: `mcp`.
+
+```ts
+import { mountA2A } from './kit/a2a/index.js'
+
+mountA2A(app, {
+  info: { name: 'Recipes', description: 'Finds recipes for a description.', version },
+  skills: [{ tool: tools.find((t) => t.name === 'search_recipes')!, text: 'q', tags: ['recipes'], examples: ['a quick soup'] }],
+  callApi: inProcess(app),
+  store: oauthStore,        // any KeyValueStore; tasks are kept a day
+  oauth: !!oauth,           // advertise the OAuth server beside keys
+})
+```
+
+## Rules
+
+- Pick the 1–3 tools another agent would delegate to; the first skill answers a message that names none.
+- Spec source of truth: `a2aproject/A2A` `specification/a2a.proto` (JSON is camelCase, enums SCREAMING_CASE, header
+  `A2A-Version: 1.0`).