agent-well-known-express 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,234 @@
+# agent-well-known-express
+
+Express middleware that auto-generates [Agent Discovery Protocol](https://github.com/user/agent-discovery-protocol/tree/main/spec) endpoints so any AI agent can discover and use your API at runtime.
+
+## Install
+
+```bash
+npm install agent-well-known-express
+```
+
+> **Peer dependency:** Express 4.x or 5.x must be installed in your project.
+
+## Quick Start
+
+```js
+const express = require('express');
+const { agentManifest } = require('agent-well-known-express');
+
+const app = express();
+
+app.use(agentManifest({
+  name: "Acme Email",
+  description: "Send and receive emails programmatically. Supports HTML content, attachments, and inbox management.",
+  base_url: "https://api.acme-email.com",
+  auth: {
+    type: "api_key",
+    header: "Authorization",
+    prefix: "Bearer",
+    setup_url: "https://acme-email.com/api-keys"
+  },
+  pricing: {
+    type: "freemium",
+    plans: [
+      { name: "Free", price: "$0/mo", limits: "100 emails/day" },
+      { name: "Pro", price: "$9/mo", limits: "Unlimited" }
+    ],
+    plans_url: "https://acme-email.com/pricing"
+  },
+  capabilities: [
+    {
+      name: "send_email",
+      description: "Send an email to one or more recipients with subject, body (plain text or HTML), and optional attachments.",
+      handler: {
+        endpoint: "/v1/emails/send",
+        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 line.", example: "Hello" },
+        { name: "body", type: "string", required: true, description: "Email body content.", example: "Hi there!" }
+      ],
+      response_example: {
+        status: 200,
+        body: {
+          success: true,
+          data: { message_id: "msg_abc123", status: "sent" }
+        }
+      },
+      auth_scopes: ["email.send"],
+      rate_limits: { requests_per_minute: 60 }
+    },
+    {
+      name: "list_inbox",
+      description: "List recent emails in the authenticated user's inbox with optional filtering.",
+      handler: {
+        endpoint: "/v1/emails/inbox",
+        method: "GET"
+      },
+      parameters: [
+        { name: "limit", type: "number", required: false, description: "Max emails to return.", example: 20 },
+        { name: "sender", type: "string", required: false, description: "Filter by sender address.", example: "bob@example.com" }
+      ],
+      auth_scopes: ["email.read"],
+      rate_limits: { requests_per_minute: 120 }
+    }
+  ]
+}));
+
+app.listen(3000, () => console.log('Listening on :3000'));
+```
+
+This registers two endpoints automatically:
+
+| Endpoint | Description |
+|----------|-------------|
+| `GET /.well-known/agent` | The service manifest (JSON) |
+| `GET /.well-known/agent/capabilities/:name` | Detail for a single capability |
+
+Both endpoints include `Access-Control-Allow-Origin: *` and `Cache-Control: public, max-age=3600` headers.
+
+## Configuration Reference
+
+### Top-level fields
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| `name` | `string` | Yes | Human-readable service name. |
+| `description` | `string` | Yes | 2-3 sentences describing the service. Written for an LLM to understand what this service does and when to use it. |
+| `base_url` | `string` | Yes | Base URL for all API calls. |
+| `auth` | `object` | Yes | Authentication configuration (see below). |
+| `pricing` | `object` | No | Pricing information (see below). |
+| `capabilities` | `array` | Yes | List of capability objects (see below). |
+
+### Auth object
+
+**OAuth 2.0:**
+
+```js
+{
+  type: "oauth2",
+  authorization_url: "https://auth.example.com/authorize",
+  token_url: "https://auth.example.com/token",
+  scopes: ["read", "write"]
+}
+```
+
+**API Key:**
+
+```js
+{
+  type: "api_key",
+  header: "Authorization",   // optional, defaults to "Authorization"
+  prefix: "Bearer",          // optional
+  setup_url: "https://example.com/api-keys"  // optional
+}
+```
+
+**None (public API):**
+
+```js
+{ type: "none" }
+```
+
+### Pricing object (optional)
+
+```js
+{
+  type: "free",       // "free" | "freemium" | "paid"
+  plans: [
+    { name: "Free", price: "$0/mo", limits: "1000 requests/day" }
+  ],
+  plans_url: "https://example.com/pricing"
+}
+```
+
+### Capability object
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| `name` | `string` | Yes | Machine-readable identifier (snake_case). |
+| `description` | `string` | Yes | 1-2 sentence description for LLM understanding. |
+| `handler` | `object` | Yes | `{ endpoint: string, method: string }` — the real API route. |
+| `parameters` | `array` | No | Parameter definitions (see below). |
+| `request_example` | `object` | No | Complete request example. Auto-generated if omitted. |
+| `response_example` | `object` | No | Complete response example. |
+| `auth_scopes` | `string[]` | No | OAuth scopes needed for this capability. |
+| `rate_limits` | `object` | No | Rate limiting info (e.g. `{ requests_per_minute: 60 }`). |
+
+### Parameter object
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| `name` | `string` | Yes | Parameter name. |
+| `type` | `string` | Yes | Type: `string`, `number`, `boolean`, `object`, `string[]`, `object[]`. |
+| `required` | `boolean` | Yes | Whether this parameter is required. |
+| `description` | `string` | Yes | What this parameter does. |
+| `example` | `any` | No | Example value (used in auto-generated request_example). |
+
+## What Gets Generated
+
+### Manifest (`GET /.well-known/agent`)
+
+Returns a spec-v1.0 manifest with `detail_url` auto-populated for each capability:
+
+```json
+{
+  "spec_version": "1.0",
+  "name": "Acme Email",
+  "description": "Send and receive emails programmatically...",
+  "base_url": "https://api.acme-email.com",
+  "auth": { "type": "api_key", "header": "Authorization", "prefix": "Bearer", "setup_url": "..." },
+  "pricing": { "type": "freemium", "plans": [...], "plans_url": "..." },
+  "capabilities": [
+    {
+      "name": "send_email",
+      "description": "Send an email to one or more recipients...",
+      "detail_url": "/.well-known/agent/capabilities/send_email"
+    }
+  ]
+}
+```
+
+### Capability Detail (`GET /.well-known/agent/capabilities/:name`)
+
+Returns everything an agent needs to call the API:
+
+```json
+{
+  "name": "send_email",
+  "description": "Send an email to one or more recipients...",
+  "endpoint": "/v1/emails/send",
+  "method": "POST",
+  "parameters": [
+    { "name": "to", "type": "string", "description": "Recipient email address.", "required": true, "example": "alice@example.com" }
+  ],
+  "request_example": {
+    "method": "POST",
+    "url": "https://api.acme-email.com/v1/emails/send",
+    "headers": { "Authorization": "Bearer {api_key}", "Content-Type": "application/json" },
+    "body": { "to": "alice@example.com", "subject": "Hello", "body": "Hi there!" }
+  },
+  "response_example": { "status": 200, "body": { "success": true, "data": { "message_id": "msg_abc123" } } },
+  "auth_scopes": ["email.send"],
+  "rate_limits": { "requests_per_minute": 60 }
+}
+```
+
+If you omit `request_example` from a capability, the middleware generates one automatically from `base_url`, `handler`, `auth`, and the required parameters' example values.
+
+## Startup Validation
+
+The middleware validates your configuration on startup and logs warnings via `console.warn` for any issues (missing fields, invalid types, etc.). It does **not** throw or crash — your server will still start even with a misconfigured manifest.
+
+## Spec
+
+This middleware implements the [Agent Discovery Protocol Specification v1.0](https://github.com/user/agent-discovery-protocol/tree/main/spec).
+
+## Registry
+
+Register your service in the [Agent Discovery Registry](https://registry.agentdiscovery.dev) so AI agents can find it.
+
+## License
+
+MIT

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "agent-well-known-express",
+  "version": "1.0.1",
+  "description": "Express middleware to serve the Agent Discovery Protocol (/.well-known/agent) manifest and capability detail endpoints.",
+  "main": "src/index.js",
+  "types": "src/index.d.ts",
+  "files": [
+    "src/",
+    "LICENSE",
+    "README.md"
+  ],
+  "keywords": [
+    "agent-discovery",
+    "well-known",
+    "express",
+    "middleware",
+    "ai-agent",
+    "mcp",
+    "service-discovery",
+    "agent-discovery-protocol"
+  ],
+  "author": "",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/user/agent-discovery-protocol",
+    "directory": "sdks/express"
+  },
+  "homepage": "https://github.com/user/agent-discovery-protocol/tree/main/sdks/express",
+  "bugs": {
+    "url": "https://github.com/user/agent-discovery-protocol/issues"
+  },
+  "peerDependencies": {
+    "express": "^4.0.0 || ^5.0.0"
+  },
+  "engines": {
+    "node": ">=14.0.0"
+  }
+}

package/src/index.d.ts

@@ -0,0 +1,140 @@
+import { Router } from 'express';
+
+/**
+ * Auth configuration for the service manifest.
+ */
+export interface AuthOAuth2 {
+  type: 'oauth2';
+  authorization_url: string;
+  token_url: string;
+  scopes?: string[];
+}
+
+export interface AuthApiKey {
+  type: 'api_key';
+  header?: string;
+  prefix?: string;
+  setup_url?: string;
+}
+
+export interface AuthNone {
+  type: 'none';
+}
+
+export type AuthConfig = AuthOAuth2 | AuthApiKey | AuthNone;
+
+/**
+ * A pricing plan entry.
+ */
+export interface PricingPlan {
+  name: string;
+  price: string;
+  limits?: string;
+}
+
+/**
+ * Pricing configuration for the service manifest.
+ */
+export interface PricingConfig {
+  type: 'free' | 'freemium' | 'paid';
+  plans?: PricingPlan[];
+  plans_url?: string;
+}
+
+/**
+ * A parameter definition for a capability.
+ */
+export interface ParameterConfig {
+  name: string;
+  type: string;
+  required: boolean;
+  description: string;
+  example?: any;
+}
+
+/**
+ * Handler configuration specifying the actual API endpoint.
+ */
+export interface HandlerConfig {
+  endpoint: string;
+  method: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+}
+
+/**
+ * Rate limit configuration for a capability.
+ */
+export interface RateLimitConfig {
+  requests_per_minute?: number;
+  daily_limit?: number;
+  [key: string]: any;
+}
+
+/**
+ * Example request object following the spec.
+ */
+export interface RequestExample {
+  method: string;
+  url: string;
+  headers?: Record<string, string>;
+  body?: any;
+}
+
+/**
+ * Example response object following the spec.
+ */
+export interface ResponseExample {
+  status: number;
+  body?: any;
+}
+
+/**
+ * A capability definition provided by the user.
+ */
+export interface CapabilityConfig {
+  /** Machine-readable identifier (snake_case). */
+  name: string;
+  /** 1-2 sentence description for LLM understanding. */
+  description: string;
+  /** The real API endpoint and HTTP method for this capability. */
+  handler: HandlerConfig;
+  /** Parameter definitions. */
+  parameters?: ParameterConfig[];
+  /** A complete request example. Auto-generated from parameters if omitted. */
+  request_example?: RequestExample;
+  /** A complete response example. */
+  response_example?: ResponseExample;
+  /** OAuth scopes needed for this capability. */
+  auth_scopes?: string[];
+  /** Rate limiting information. */
+  rate_limits?: RateLimitConfig;
+}
+
+/**
+ * Full service configuration passed to `agentManifest()`.
+ */
+export interface AgentManifestConfig {
+  /** Human-readable service name. */
+  name: string;
+  /** 2-3 sentence description of 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[];
+}
+
+/**
+ * Create an Express Router that serves Agent Discovery Protocol endpoints.
+ *
+ * Registers:
+ *   GET /.well-known/agent                        — service manifest (JSON)
+ *   GET /.well-known/agent/capabilities/:name      — capability detail (JSON)
+ *
+ * @param config  Service configuration following the Agent Discovery Protocol spec v1.0.
+ * @returns       An Express Router to mount with `app.use()`.
+ */
+export function agentManifest(config: AgentManifestConfig): Router;

package/src/index.js

@@ -0,0 +1,340 @@
+'use strict';
+
+/**
+ * agent-well-known-express
+ *
+ * Express middleware that auto-generates Agent Discovery Protocol endpoints:
+ *   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
+ */
+
+// ---------------------------------------------------------------------------
+// Validation
+// ---------------------------------------------------------------------------
+
+const VALID_AUTH_TYPES = ['oauth2', 'api_key', 'none'];
+const VALID_METHODS = ['GET', 'POST', 'PUT', 'PATCH', 'DELETE'];
+
+/**
+ * Validate the user-supplied config and return an array of warning strings.
+ * Does NOT throw — issues are advisory so the server can still start.
+ */
+function validateConfig(config) {
+  const warnings = [];
+
+  if (!config) {
+    warnings.push('Config is missing or undefined.');
+    return warnings;
+  }
+
+  // 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(function (cap, idx) {
+      var 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.handler || typeof cap.handler !== 'object') {
+        warnings.push(prefix + ': Missing or invalid "handler" object.');
+      } else {
+        if (!cap.handler.endpoint || typeof cap.handler.endpoint !== 'string') {
+          warnings.push(prefix + ': Missing "handler.endpoint".');
+        }
+        if (!cap.handler.method || typeof cap.handler.method !== 'string') {
+          warnings.push(prefix + ': Missing "handler.method".');
+        } else if (!VALID_METHODS.includes(cap.handler.method.toUpperCase())) {
+          warnings.push(
+            prefix +
+              ': Invalid "handler.method" (' +
+              cap.handler.method +
+              '). Expected one of: ' +
+              VALID_METHODS.join(', ') +
+              '.'
+          );
+        }
+      }
+
+      // Parameters
+      if (cap.parameters) {
+        if (!Array.isArray(cap.parameters)) {
+          warnings.push(prefix + ': "parameters" must be an array.');
+        } else {
+          cap.parameters.forEach(function (param, pIdx) {
+            var 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".');
+            }
+          });
+        }
+      }
+    });
+  }
+
+  return warnings;
+}
+
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+
+/**
+ * Build the auth header representation used in auto-generated request examples.
+ */
+function buildAuthHeader(auth) {
+  if (!auth) return {};
+  switch (auth.type) {
+    case 'oauth2':
+      return { Authorization: 'Bearer {access_token}' };
+    case 'api_key': {
+      var header = auth.header || 'Authorization';
+      var prefix = auth.prefix ? auth.prefix + ' ' : '';
+      var obj = {};
+      obj[header] = prefix + '{api_key}';
+      return obj;
+    }
+    default:
+      return {};
+  }
+}
+
+/**
+ * Auto-generate a request_example from the capability definition when the user
+ * has not provided one explicitly.
+ */
+function generateRequestExample(cap, config) {
+  var handler = cap.handler || {};
+  var method = (handler.method || 'GET').toUpperCase();
+  var baseUrl = (config.base_url || '').replace(/\/+$/, '');
+  var url = baseUrl + (handler.endpoint || '');
+
+  var headers = Object.assign(
+    {},
+    buildAuthHeader(config.auth),
+    { 'Content-Type': 'application/json' }
+  );
+
+  var example = {
+    method: method,
+    url: url,
+    headers: headers,
+  };
+
+  // Build body from parameters using their example values
+  if (['POST', 'PUT', 'PATCH'].includes(method) && Array.isArray(cap.parameters)) {
+    var body = {};
+    cap.parameters.forEach(function (param) {
+      if (param.required && param.example !== undefined) {
+        body[param.name] = param.example;
+      }
+    });
+    if (Object.keys(body).length > 0) {
+      example.body = body;
+    }
+  }
+
+  return example;
+}
+
+// ---------------------------------------------------------------------------
+// Manifest builder
+// ---------------------------------------------------------------------------
+
+/**
+ * Build the spec-v1.0 manifest JSON from the user config.
+ */
+function buildManifest(config) {
+  var manifest = {
+    spec_version: '1.0',
+    name: config.name,
+    description: config.description,
+    base_url: config.base_url,
+    auth: config.auth,
+  };
+
+  if (config.pricing) {
+    manifest.pricing = config.pricing;
+  }
+
+  manifest.capabilities = (config.capabilities || []).map(function (cap) {
+    var name = cap.name || '';
+    return {
+      name: name,
+      description: cap.description || '',
+      detail_url: '/.well-known/agent/capabilities/' + name,
+    };
+  });
+
+  return manifest;
+}
+
+/**
+ * Build the capability detail JSON for a single capability.
+ */
+function buildCapabilityDetail(cap, config) {
+  var handler = cap.handler || {};
+  var detail = {
+    name: cap.name || '',
+    description: cap.description || '',
+    endpoint: handler.endpoint || '',
+    method: (handler.method || 'GET').toUpperCase(),
+    parameters: (cap.parameters || []).map(function (p) {
+      var 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;
+}
+
+// ---------------------------------------------------------------------------
+// Middleware
+// ---------------------------------------------------------------------------
+
+/**
+ * Create and return an Express Router that serves the Agent Discovery Protocol
+ * endpoints for the given service configuration.
+ *
+ * @param {object} config — service configuration (see README for full reference)
+ * @returns {import('express').Router}
+ */
+function agentManifest(config) {
+  // We require express at call-time so it's resolved from the host app's
+  // node_modules (peer dependency).
+  var express;
+  try {
+    express = require('express');
+  } catch (_err) {
+    throw new Error(
+      'agent-well-known-express: "express" is a peer dependency and must be installed in your project.'
+    );
+  }
+
+  // --- Validate --------------------------------------------------------
+  var warnings = validateConfig(config);
+  if (warnings.length > 0) {
+    warnings.forEach(function (w) {
+      console.warn('[agent-well-known-express] ' + w);
+    });
+  }
+
+  // --- Pre-compute manifest & detail map --------------------------------
+  var manifest = buildManifest(config);
+  var manifestJSON = JSON.stringify(manifest);
+
+  var capabilityDetails = {};
+  (config.capabilities || []).forEach(function (cap) {
+    capabilityDetails[cap.name] = buildCapabilityDetail(cap, config);
+  });
+
+  // --- Router -----------------------------------------------------------
+  var router = express.Router();
+
+  // CORS preflight for /.well-known/agent paths
+  router.options('/.well-known/agent', function (_req, res) {
+    res.set('Access-Control-Allow-Origin', '*');
+    res.set('Access-Control-Allow-Methods', 'GET, OPTIONS');
+    res.set('Access-Control-Allow-Headers', 'Content-Type');
+    res.status(204).end();
+  });
+
+  router.options('/.well-known/agent/capabilities/:name', function (_req, res) {
+    res.set('Access-Control-Allow-Origin', '*');
+    res.set('Access-Control-Allow-Methods', 'GET, OPTIONS');
+    res.set('Access-Control-Allow-Headers', 'Content-Type');
+    res.status(204).end();
+  });
+
+  // GET /.well-known/agent — the manifest
+  router.get('/.well-known/agent', function (_req, res) {
+    res.set('Content-Type', 'application/json');
+    res.set('Access-Control-Allow-Origin', '*');
+    res.set('Cache-Control', 'public, max-age=3600');
+    res.status(200).send(manifestJSON);
+  });
+
+  // GET /.well-known/agent/capabilities/:name — capability detail
+  router.get('/.well-known/agent/capabilities/:name', function (req, res) {
+    var name = req.params.name;
+    var detail = capabilityDetails[name];
+
+    if (!detail) {
+      res.set('Content-Type', 'application/json');
+      res.set('Access-Control-Allow-Origin', '*');
+      res.status(404).json({
+        error: 'Capability not found: ' + name,
+      });
+      return;
+    }
+
+    res.set('Content-Type', 'application/json');
+    res.set('Access-Control-Allow-Origin', '*');
+    res.set('Cache-Control', 'public, max-age=3600');
+    res.status(200).json(detail);
+  });
+
+  return router;
+}
+
+// ---------------------------------------------------------------------------
+// Exports
+// ---------------------------------------------------------------------------
+
+module.exports = { agentManifest };