agent-well-known-next 1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Agent Discovery Protocol Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,227 @@
+# agent-well-known-next
+
+Next.js App Router helpers for the [Agent Discovery Protocol](https://github.com/user/agent-discovery-protocol). Serve a `/.well-known/agent` manifest and capability detail endpoints with zero boilerplate.
+
+This package generates spec-v1.0 compliant endpoints so any AI agent can discover and use your service at runtime -- no plugins, no installation, no per-service configuration.
+
+## Install
+
+```bash
+npm install agent-well-known-next
+```
+
+> Requires Next.js 13+ with the App Router.
+
+## Quick Start
+
+### 1. Define your config
+
+Create a shared config file (or inline it):
+
+```ts
+// lib/agent-config.ts
+import type { AgentConfig } from 'agent-well-known-next';
+
+export const agentConfig: AgentConfig = {
+  name: "My API",
+  description: "What my API does, in 2-3 sentences. Write for an LLM to understand.",
+  base_url: "https://api.example.com",
+  auth: {
+    type: "api_key",
+    header: "Authorization",
+    prefix: "Bearer",
+    setup_url: "https://example.com/api-keys",
+  },
+  capabilities: [
+    {
+      name: "send_email",
+      description: "Send an email to one or more recipients.",
+      endpoint: "/api/emails",
+      method: "POST",
+      parameters: [
+        { name: "to", type: "string", required: true, description: "Recipient email address.", example: "alice@example.com" },
+        { name: "subject", type: "string", required: true, description: "Email subject.", example: "Hello" },
+        { name: "body", type: "string", required: true, description: "Email body (plain text or HTML).", example: "<p>Hi!</p>" },
+      ],
+      response_example: {
+        status: 200,
+        body: { success: true, data: { message_id: "msg_abc123", status: "sent" } },
+      },
+      auth_scopes: ["email.send"],
+      rate_limits: { requests_per_minute: 60, daily_limit: 1000 },
+    },
+  ],
+};
+```
+
+### 2. Create the manifest route
+
+```
+app/.well-known/agent/route.ts
+```
+
+```ts
+import { createAgentManifest } from 'agent-well-known-next';
+import { agentConfig } from '@/lib/agent-config';
+
+export const GET = createAgentManifest(agentConfig);
+```
+
+### 3. Create the capability detail route
+
+```
+app/.well-known/agent/capabilities/[name]/route.ts
+```
+
+```ts
+import { createCapabilityDetail } from 'agent-well-known-next';
+import { agentConfig } from '@/lib/agent-config';
+
+export const GET = createCapabilityDetail(agentConfig);
+```
+
+That's it. Your Next.js app now serves:
+
+- `GET /.well-known/agent` -- the service manifest
+- `GET /.well-known/agent/capabilities/send_email` -- capability detail
+
+### Alternative: single-import convenience
+
+```ts
+import { createAgentRoutes } from 'agent-well-known-next';
+import { agentConfig } from '@/lib/agent-config';
+
+export const { manifestHandler, capabilityHandler } = createAgentRoutes(agentConfig);
+
+// app/.well-known/agent/route.ts
+export const GET = manifestHandler;
+
+// app/.well-known/agent/capabilities/[name]/route.ts
+export const GET = capabilityHandler;
+```
+
+## What Gets Generated
+
+### Manifest (`/.well-known/agent`)
+
+```json
+{
+  "spec_version": "1.0",
+  "name": "My API",
+  "description": "What my API does.",
+  "base_url": "https://api.example.com",
+  "auth": { "type": "api_key", "header": "Authorization", "prefix": "Bearer", "setup_url": "https://example.com/api-keys" },
+  "capabilities": [
+    {
+      "name": "send_email",
+      "description": "Send an email to one or more recipients.",
+      "detail_url": "/.well-known/agent/capabilities/send_email"
+    }
+  ]
+}
+```
+
+### Capability Detail (`/.well-known/agent/capabilities/send_email`)
+
+```json
+{
+  "name": "send_email",
+  "description": "Send an email to one or more recipients.",
+  "endpoint": "/api/emails",
+  "method": "POST",
+  "parameters": [
+    { "name": "to", "type": "string", "required": true, "description": "Recipient email address.", "example": "alice@example.com" },
+    { "name": "subject", "type": "string", "required": true, "description": "Email subject.", "example": "Hello" },
+    { "name": "body", "type": "string", "required": true, "description": "Email body (plain text or HTML).", "example": "<p>Hi!</p>" }
+  ],
+  "request_example": {
+    "method": "POST",
+    "url": "https://api.example.com/api/emails",
+    "headers": { "Authorization": "Bearer {api_key}", "Content-Type": "application/json" },
+    "body": { "to": "alice@example.com", "subject": "Hello", "body": "<p>Hi!</p>" }
+  },
+  "response_example": {
+    "status": 200,
+    "body": { "success": true, "data": { "message_id": "msg_abc123", "status": "sent" } }
+  },
+  "auth_scopes": ["email.send"],
+  "rate_limits": { "requests_per_minute": 60, "daily_limit": 1000 }
+}
+```
+
+## Config Reference
+
+### `AgentConfig`
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| `name` | `string` | Yes | Human-readable service name. |
+| `description` | `string` | Yes | 2-3 sentences for LLM understanding. |
+| `base_url` | `string` | Yes | Base URL for all API calls. |
+| `auth` | `AuthConfig` | Yes | Authentication configuration. |
+| `pricing` | `PricingConfig` | No | Pricing information. |
+| `capabilities` | `CapabilityConfig[]` | Yes | Service capabilities. |
+
+### `AuthConfig`
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| `type` | `"oauth2" \| "api_key" \| "none"` | Yes | Auth mechanism. |
+| `authorization_url` | `string` | oauth2 | OAuth2 authorization URL. |
+| `token_url` | `string` | oauth2 | OAuth2 token URL. |
+| `scopes` | `string[]` | No | OAuth2 scopes. |
+| `header` | `string` | No | Header name for API key (default: `Authorization`). |
+| `prefix` | `string` | No | Prefix before the key value (e.g. `Bearer`). |
+| `setup_url` | `string` | No | URL where users manage API keys. |
+
+### `PricingConfig`
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| `type` | `"free" \| "freemium" \| "paid"` | Yes | Pricing model. |
+| `plans` | `Array<{ name, price, limits }>` | No | Available plans. |
+| `plans_url` | `string` | No | URL to full pricing page. |
+
+### `CapabilityConfig`
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| `name` | `string` | Yes | Machine-readable identifier (snake_case). |
+| `description` | `string` | Yes | 1-2 sentences for LLM understanding. |
+| `endpoint` | `string` | Yes | API path relative to `base_url`. |
+| `method` | `string` | Yes | HTTP method: GET, POST, PUT, PATCH, DELETE. |
+| `parameters` | `ParameterConfig[]` | Yes | Parameter definitions. |
+| `request_example` | `object` | No | Explicit request example. Auto-generated if omitted. |
+| `response_example` | `object` | No | Example response with status and body. |
+| `auth_scopes` | `string[]` | No | Scopes required for this capability. |
+| `rate_limits` | `object` | No | Rate limiting info. |
+
+### `ParameterConfig`
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| `name` | `string` | Yes | Parameter name. |
+| `type` | `string` | Yes | Type: string, number, boolean, object, string[], object[]. |
+| `required` | `boolean` | Yes | Whether required. |
+| `description` | `string` | Yes | Human-readable description. |
+| `example` | `any` | No | Example value. Used in auto-generated request examples. |
+
+## Auto-Generation
+
+The SDK automatically handles:
+
+- **`spec_version`**: Always set to `"1.0"`.
+- **`detail_url`**: Generated as `/.well-known/agent/capabilities/{name}` for each capability.
+- **`request_example`**: If not provided, built from `base_url` + `endpoint` + `method` + required parameters with examples + auth headers.
+- **CORS headers**: `Access-Control-Allow-Origin: *` on all responses.
+- **Cache headers**: `Cache-Control: public, max-age=3600` on all responses.
+- **Validation**: Runs once on first request. Issues are logged via `console.warn` -- the server still starts.
+
+## Spec & Registry
+
+- [Agent Discovery Protocol Spec](https://github.com/user/agent-discovery-protocol/tree/main/spec)
+- [Agent Discovery Registry](https://registry.agentdiscovery.dev)
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,175 @@
+/**
+ * agent-well-known-next
+ *
+ * Next.js App Router helpers for the Agent Discovery Protocol.
+ * Generates the two route handlers every service needs:
+ *
+ *   GET /.well-known/agent                          - the service manifest
+ *   GET /.well-known/agent/capabilities/[name]      - capability detail
+ *
+ * Spec: https://github.com/user/agent-discovery-protocol/tree/main/spec
+ */
+/** Parameter definition for a capability. */
+export interface ParameterConfig {
+    /** Parameter name. */
+    name: string;
+    /** Type: string, number, boolean, object, string[], object[]. */
+    type: string;
+    /** Whether this parameter is required. */
+    required: boolean;
+    /** Human-readable description. */
+    description: string;
+    /** Example value used in auto-generated request examples. */
+    example?: unknown;
+}
+/** Authentication configuration. */
+export interface AuthConfig {
+    /** Auth mechanism: oauth2, api_key, or none. */
+    type: "oauth2" | "api_key" | "none";
+    /** OAuth2 authorization URL. Required when type is oauth2. */
+    authorization_url?: string;
+    /** OAuth2 token URL. Required when type is oauth2. */
+    token_url?: string;
+    /** OAuth2 scopes. */
+    scopes?: string[];
+    /** Header name for API key auth. Defaults to "Authorization". */
+    header?: string;
+    /** Prefix before the key value (e.g. "Bearer"). */
+    prefix?: string;
+    /** URL where users can create/manage their API keys. */
+    setup_url?: string;
+}
+/** Pricing plan. */
+export interface PricingPlan {
+    name: string;
+    price: string;
+    limits: string;
+}
+/** Pricing configuration (optional). */
+export interface PricingConfig {
+    /** Pricing model: free, freemium, or paid. */
+    type: "free" | "freemium" | "paid";
+    /** Available plans. */
+    plans?: PricingPlan[];
+    /** URL to the full pricing page. */
+    plans_url?: string;
+}
+/** Rate limit configuration for a capability. */
+export interface RateLimitConfig {
+    requests_per_minute?: number;
+    daily_limit?: number;
+}
+/** Individual capability configuration. */
+export interface CapabilityConfig {
+    /** Machine-readable identifier (snake_case). */
+    name: string;
+    /** 1-2 sentence description for LLM understanding. */
+    description: string;
+    /** API path relative to base_url. */
+    endpoint: string;
+    /** HTTP method: GET, POST, PUT, PATCH, DELETE. */
+    method: string;
+    /** Parameter definitions. */
+    parameters: ParameterConfig[];
+    /** Explicit request example. Auto-generated if omitted. */
+    request_example?: RequestExample;
+    /** Example response. */
+    response_example?: ResponseExample;
+    /** Auth scopes required for this capability. */
+    auth_scopes?: string[];
+    /** Rate limits for this capability. */
+    rate_limits?: RateLimitConfig;
+}
+/** Shape of an auto-generated or user-provided request example. */
+export interface RequestExample {
+    method: string;
+    url: string;
+    headers: Record<string, string>;
+    body?: unknown;
+}
+/** Shape of a response example. */
+export interface ResponseExample {
+    status: number;
+    body: unknown;
+}
+/** Full service configuration passed by the user. */
+export interface AgentConfig {
+    /** Human-readable service name. */
+    name: string;
+    /** 2-3 sentences describing the service, written for an LLM. */
+    description: string;
+    /** Base URL for all API calls. */
+    base_url: string;
+    /** Authentication configuration. */
+    auth: AuthConfig;
+    /** Pricing information (optional). */
+    pricing?: PricingConfig;
+    /** List of capabilities the service exposes. */
+    capabilities: CapabilityConfig[];
+}
+/**
+ * Minimal NextRequest shape. Compatible with next/server NextRequest.
+ * We use a minimal type so the library compiles without requiring next
+ * to be present at build time (it is a peerDependency, resolved at runtime).
+ */
+interface NextRequestLike {
+    url: string;
+    method: string;
+}
+/**
+ * Matches Next.js App Router dynamic route context.
+ * Next.js 13 passes params directly; Next.js 15+ wraps them in a Promise.
+ */
+interface RouteContext {
+    params: {
+        name: string;
+    } | Promise<{
+        name: string;
+    }>;
+}
+/**
+ * Create a Next.js App Router GET handler that serves the Agent Discovery
+ * Protocol manifest at `/.well-known/agent`.
+ *
+ * Usage in `app/.well-known/agent/route.ts`:
+ * ```ts
+ * import { createAgentManifest } from 'agent-well-known-next';
+ *
+ * export const GET = createAgentManifest({ ... });
+ * ```
+ */
+export declare function createAgentManifest(config: AgentConfig): (request: NextRequestLike) => Promise<Response>;
+/**
+ * Create a Next.js App Router GET handler that serves capability detail
+ * at `/.well-known/agent/capabilities/[name]`.
+ *
+ * Usage in `app/.well-known/agent/capabilities/[name]/route.ts`:
+ * ```ts
+ * import { createCapabilityDetail } from 'agent-well-known-next';
+ *
+ * export const GET = createCapabilityDetail(config);
+ * ```
+ */
+export declare function createCapabilityDetail(config: AgentConfig): (request: NextRequestLike, context: RouteContext) => Promise<Response>;
+/**
+ * Convenience function that returns both route handlers and the config
+ * reference, so you can wire up both routes from a single config object.
+ *
+ * Usage:
+ * ```ts
+ * const { manifestHandler, capabilityHandler } = createAgentRoutes({ ... });
+ *
+ * // app/.well-known/agent/route.ts
+ * export const GET = manifestHandler;
+ *
+ * // app/.well-known/agent/capabilities/[name]/route.ts
+ * export const GET = capabilityHandler;
+ * ```
+ */
+export declare function createAgentRoutes(config: AgentConfig): {
+    manifestHandler: (request: NextRequestLike) => Promise<Response>;
+    capabilityHandler: (request: NextRequestLike, context: RouteContext) => Promise<Response>;
+    config: AgentConfig;
+};
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -0,0 +1,323 @@
+"use strict";
+/**
+ * agent-well-known-next
+ *
+ * Next.js App Router helpers for the Agent Discovery Protocol.
+ * Generates the two route handlers every service needs:
+ *
+ *   GET /.well-known/agent                          - the service manifest
+ *   GET /.well-known/agent/capabilities/[name]      - capability detail
+ *
+ * Spec: https://github.com/user/agent-discovery-protocol/tree/main/spec
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAgentManifest = createAgentManifest;
+exports.createCapabilityDetail = createCapabilityDetail;
+exports.createAgentRoutes = createAgentRoutes;
+// ---------------------------------------------------------------------------
+// Validation
+// ---------------------------------------------------------------------------
+const VALID_AUTH_TYPES = ["oauth2", "api_key", "none"];
+const VALID_METHODS = ["GET", "POST", "PUT", "PATCH", "DELETE"];
+/**
+ * Validate the user config and emit console.warn for each issue found.
+ * Returns true if the config is structurally valid enough to serve.
+ */
+function validateConfig(config) {
+    const warnings = [];
+    if (!config) {
+        warnings.push("Config is missing or undefined.");
+        emitWarnings(warnings);
+        return false;
+    }
+    // Top-level required fields
+    if (!config.name || typeof config.name !== "string") {
+        warnings.push('Missing or invalid "name" (expected non-empty string).');
+    }
+    if (!config.description || typeof config.description !== "string") {
+        warnings.push('Missing or invalid "description" (expected non-empty string).');
+    }
+    if (!config.base_url || typeof config.base_url !== "string") {
+        warnings.push('Missing or invalid "base_url" (expected non-empty string).');
+    }
+    // Auth
+    if (!config.auth || typeof config.auth !== "object") {
+        warnings.push('Missing or invalid "auth" object.');
+    }
+    else if (!config.auth.type ||
+        !VALID_AUTH_TYPES.includes(config.auth.type)) {
+        warnings.push(`Invalid "auth.type". Expected one of: ${VALID_AUTH_TYPES.join(", ")}.`);
+    }
+    // Capabilities
+    if (!Array.isArray(config.capabilities) || config.capabilities.length === 0) {
+        warnings.push('Missing or empty "capabilities" array.');
+    }
+    else {
+        config.capabilities.forEach((cap, idx) => {
+            const prefix = `capabilities[${idx}]`;
+            if (!cap.name || typeof cap.name !== "string") {
+                warnings.push(`${prefix}: Missing or invalid "name".`);
+            }
+            if (!cap.description || typeof cap.description !== "string") {
+                warnings.push(`${prefix}: Missing or invalid "description".`);
+            }
+            if (!cap.endpoint || typeof cap.endpoint !== "string") {
+                warnings.push(`${prefix}: Missing or invalid "endpoint".`);
+            }
+            if (!cap.method || typeof cap.method !== "string") {
+                warnings.push(`${prefix}: Missing or invalid "method".`);
+            }
+            else if (!VALID_METHODS.includes(cap.method.toUpperCase())) {
+                warnings.push(`${prefix}: Invalid "method" (${cap.method}). Expected one of: ${VALID_METHODS.join(", ")}.`);
+            }
+            // Parameters
+            if (!Array.isArray(cap.parameters)) {
+                warnings.push(`${prefix}: "parameters" must be an array.`);
+            }
+            else {
+                cap.parameters.forEach((param, pIdx) => {
+                    const pPrefix = `${prefix}.parameters[${pIdx}]`;
+                    if (!param.name || typeof param.name !== "string") {
+                        warnings.push(`${pPrefix}: Missing or invalid "name".`);
+                    }
+                    if (!param.type || typeof param.type !== "string") {
+                        warnings.push(`${pPrefix}: Missing or invalid "type".`);
+                    }
+                    if (typeof param.required !== "boolean") {
+                        warnings.push(`${pPrefix}: Missing or invalid "required" (expected boolean).`);
+                    }
+                    if (!param.description || typeof param.description !== "string") {
+                        warnings.push(`${pPrefix}: Missing or invalid "description".`);
+                    }
+                });
+            }
+        });
+    }
+    emitWarnings(warnings);
+    return warnings.length === 0;
+}
+function emitWarnings(warnings) {
+    for (const w of warnings) {
+        console.warn(`[agent-well-known-next] ${w}`);
+    }
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Build the auth header used in auto-generated request examples.
+ */
+function buildAuthHeaders(auth) {
+    switch (auth.type) {
+        case "oauth2":
+            return { Authorization: "Bearer {access_token}" };
+        case "api_key": {
+            const header = auth.header || "Authorization";
+            const prefix = auth.prefix ? `${auth.prefix} ` : "";
+            return { [header]: `${prefix}{api_key}` };
+        }
+        default:
+            return {};
+    }
+}
+/**
+ * Auto-generate a request_example from the capability definition.
+ */
+function generateRequestExample(cap, config) {
+    const method = cap.method.toUpperCase();
+    const url = `${config.base_url.replace(/\/+$/, "")}${cap.endpoint}`;
+    const headers = {
+        ...buildAuthHeaders(config.auth),
+        "Content-Type": "application/json",
+    };
+    const example = { method, url, headers };
+    // Build body from required parameters with example values
+    if (["POST", "PUT", "PATCH"].includes(method) &&
+        Array.isArray(cap.parameters)) {
+        const body = {};
+        for (const param of cap.parameters) {
+            if (param.required && param.example !== undefined) {
+                body[param.name] = param.example;
+            }
+        }
+        if (Object.keys(body).length > 0) {
+            example.body = body;
+        }
+    }
+    return example;
+}
+// ---------------------------------------------------------------------------
+// Builders
+// ---------------------------------------------------------------------------
+/**
+ * Build the spec v1.0 manifest from user config.
+ */
+function buildManifest(config) {
+    const manifest = {
+        spec_version: "1.0",
+        name: config.name,
+        description: config.description,
+        base_url: config.base_url,
+        auth: config.auth,
+        capabilities: (config.capabilities || []).map((cap) => ({
+            name: cap.name,
+            description: cap.description,
+            detail_url: `/.well-known/agent/capabilities/${cap.name}`,
+        })),
+    };
+    if (config.pricing) {
+        manifest.pricing = config.pricing;
+    }
+    return manifest;
+}
+/**
+ * Build the capability detail JSON for a single capability.
+ */
+function buildCapabilityDetail(cap, config) {
+    const detail = {
+        name: cap.name,
+        description: cap.description,
+        endpoint: cap.endpoint,
+        method: cap.method.toUpperCase(),
+        parameters: (cap.parameters || []).map((p) => {
+            const param = {
+                name: p.name,
+                type: p.type,
+                description: p.description,
+                required: p.required,
+            };
+            if (p.example !== undefined) {
+                param.example = p.example;
+            }
+            return param;
+        }),
+        request_example: cap.request_example || generateRequestExample(cap, config),
+    };
+    if (cap.response_example) {
+        detail.response_example = cap.response_example;
+    }
+    if (cap.auth_scopes) {
+        detail.auth_scopes = cap.auth_scopes;
+    }
+    if (cap.rate_limits) {
+        detail.rate_limits = cap.rate_limits;
+    }
+    return detail;
+}
+// We use the global Response (Web API) which Next.js re-exports.
+// This avoids importing from "next/server" at compile time.
+// ---------------------------------------------------------------------------
+// CORS & cache helpers
+// ---------------------------------------------------------------------------
+const CORS_HEADERS = {
+    "Access-Control-Allow-Origin": "*",
+    "Access-Control-Allow-Methods": "GET, OPTIONS",
+    "Access-Control-Allow-Headers": "Content-Type",
+};
+const CACHE_HEADERS = {
+    "Cache-Control": "public, max-age=3600",
+};
+function jsonResponse(data, status = 200, extraHeaders = {}) {
+    return new Response(JSON.stringify(data), {
+        status,
+        headers: {
+            "Content-Type": "application/json",
+            ...CORS_HEADERS,
+            ...CACHE_HEADERS,
+            ...extraHeaders,
+        },
+    });
+}
+function notFoundResponse(message) {
+    return new Response(JSON.stringify({ error: message }), {
+        status: 404,
+        headers: {
+            "Content-Type": "application/json",
+            ...CORS_HEADERS,
+        },
+    });
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Create a Next.js App Router GET handler that serves the Agent Discovery
+ * Protocol manifest at `/.well-known/agent`.
+ *
+ * Usage in `app/.well-known/agent/route.ts`:
+ * ```ts
+ * import { createAgentManifest } from 'agent-well-known-next';
+ *
+ * export const GET = createAgentManifest({ ... });
+ * ```
+ */
+function createAgentManifest(config) {
+    let validated = false;
+    let manifest = null;
+    return async function manifestHandler(_request) {
+        // Validate once on first request
+        if (!validated) {
+            validateConfig(config);
+            manifest = buildManifest(config);
+            validated = true;
+        }
+        return jsonResponse(manifest);
+    };
+}
+/**
+ * Create a Next.js App Router GET handler that serves capability detail
+ * at `/.well-known/agent/capabilities/[name]`.
+ *
+ * Usage in `app/.well-known/agent/capabilities/[name]/route.ts`:
+ * ```ts
+ * import { createCapabilityDetail } from 'agent-well-known-next';
+ *
+ * export const GET = createCapabilityDetail(config);
+ * ```
+ */
+function createCapabilityDetail(config) {
+    let validated = false;
+    let detailMap = null;
+    return async function capabilityHandler(_request, context) {
+        // Validate once on first request
+        if (!validated) {
+            validateConfig(config);
+            detailMap = {};
+            for (const cap of config.capabilities || []) {
+                detailMap[cap.name] = buildCapabilityDetail(cap, config);
+            }
+            validated = true;
+        }
+        // Resolve params (Next.js 15+ returns a Promise, 13-14 returns plain object)
+        const params = await Promise.resolve(context.params);
+        const name = params.name;
+        const detail = detailMap[name];
+        if (!detail) {
+            return notFoundResponse(`Capability not found: ${name}`);
+        }
+        return jsonResponse(detail);
+    };
+}
+/**
+ * Convenience function that returns both route handlers and the config
+ * reference, so you can wire up both routes from a single config object.
+ *
+ * Usage:
+ * ```ts
+ * const { manifestHandler, capabilityHandler } = createAgentRoutes({ ... });
+ *
+ * // app/.well-known/agent/route.ts
+ * export const GET = manifestHandler;
+ *
+ * // app/.well-known/agent/capabilities/[name]/route.ts
+ * export const GET = capabilityHandler;
+ * ```
+ */
+function createAgentRoutes(config) {
+    return {
+        manifestHandler: createAgentManifest(config),
+        capabilityHandler: createCapabilityDetail(config),
+        config,
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "agent-well-known-next",
+  "version": "1.0.1",
+  "description": "Next.js App Router helpers for the Agent Discovery Protocol. Serve a /.well-known/agent manifest and capability detail endpoints with zero boilerplate.",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "agent-discovery",
+    "well-known",
+    "nextjs",
+    "app-router",
+    "ai-agent",
+    "mcp",
+    "service-discovery",
+    "agent-discovery-protocol"
+  ],
+  "author": "",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/user/agent-discovery-protocol",
+    "directory": "sdks/nextjs"
+  },
+  "homepage": "https://github.com/user/agent-discovery-protocol/tree/main/sdks/nextjs",
+  "bugs": {
+    "url": "https://github.com/user/agent-discovery-protocol/issues"
+  },
+  "peerDependencies": {
+    "next": ">=13.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "next": "^14.0.0",
+    "typescript": "^5.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}