@ashdev/codex-plugin-metadata-echo 1.0.0

package/README.md

@@ -0,0 +1,212 @@
+# @ashdev/codex-plugin-metadata-echo
+
+A minimal test metadata plugin for the Codex plugin system. Echoes back search queries and provides predictable responses for testing and development.
+
+## Purpose
+
+This plugin serves two purposes:
+
+1. **Protocol Validation**: Demonstrates correct implementation of the Codex plugin protocol
+2. **Development Testing**: Provides predictable responses for testing the plugin UI without external API dependencies
+
+## Installation
+
+```bash
+npm install -g @ashdev/codex-plugin-metadata-echo
+```
+
+Or run directly with npx (no installation required).
+
+## Adding the Plugin to Codex
+
+### Using npx (Recommended)
+
+1. Log in to Codex as an administrator
+2. Navigate to **Settings** > **Plugins**
+3. Click **Add Plugin**
+4. Fill in the form:
+   - **Name**: `metadata-echo`
+   - **Display Name**: `Echo Metadata Plugin`
+   - **Command**: `npx`
+   - **Arguments**: `-y @ashdev/codex-plugin-metadata-echo@1.0.0`
+   - **Scopes**: Select `series:detail`
+5. Click **Save**
+6. Click **Test Connection** to verify the plugin works
+7. Toggle **Enabled** to activate the plugin
+
+### npx Options
+
+| Configuration | Arguments | Description |
+|--------------|-----------|-------------|
+| Latest version | `-y @ashdev/codex-plugin-metadata-echo` | Always uses latest |
+| Pinned version | `-y @ashdev/codex-plugin-metadata-echo@1.0.0` | Recommended for production |
+| Fast startup | `-y --prefer-offline @ashdev/codex-plugin-metadata-echo@1.0.0` | Skips version check if cached |
+
+**Flags:**
+- `-y`: Auto-confirms installation (required for containers)
+- `--prefer-offline`: Uses cached version without checking npm registry
+
+### Using Docker
+
+For Docker deployments, use npx with `--prefer-offline` for faster startup:
+
+```
+Command: npx
+Arguments: -y --prefer-offline @ashdev/codex-plugin-metadata-echo@1.0.0
+```
+
+### Manual Installation (Alternative)
+
+For maximum performance, install globally:
+
+```bash
+npm install -g @ashdev/codex-plugin-metadata-echo
+```
+
+Then configure:
+- **Command**: `codex-plugin-metadata-echo`
+- **Arguments**: (leave empty)
+
+## Using the Plugin
+
+Once enabled, the Echo plugin appears in the series detail page:
+
+1. Navigate to any series in your library
+2. Click the **Metadata** button (or look for the plugin icon)
+3. Click **Search Echo Metadata Plugin**
+4. Enter any search query
+5. The plugin will echo your query back as search results
+6. Select a result to see the preview
+7. Click **Apply** to test the metadata apply flow
+
+This is useful for:
+- Testing the plugin UI without needing real API credentials
+- Verifying the metadata preview and apply workflow
+- Debugging plugin integration issues
+
+## Response Behavior
+
+### Search (`metadata/search`)
+
+Returns two results for any query:
+
+1. **Primary result**: Title is `"Echo: {query}"` with `relevanceScore: 1.0`
+2. **Secondary result**: Title is `"Echo Result 2 for: {query}"` with `relevanceScore: 0.8`
+
+### Get (`metadata/get`)
+
+Returns metadata with the external ID embedded in the title and URL:
+
+- Title: `"Echo Series: {externalId}"`
+- External URL: `https://echo.example.com/series/{externalId}`
+- Includes sample genres, tags, authors, and rating
+
+### Match (`metadata/match`)
+
+Returns a match based on the normalized title:
+
+- External ID: `match-{normalized-title}`
+- Confidence: `0.85`
+- Includes one alternative match
+
+## As a Reference Implementation
+
+Use this plugin as a template for building your own metadata plugins:
+
+```typescript
+import {
+  createMetadataPlugin,
+  type MetadataProvider,
+} from "@ashdev/codex-plugin-sdk";
+
+const provider: MetadataProvider = {
+  async search(params) {
+    return {
+      results: [
+        {
+          externalId: "123",
+          title: "Example",
+          alternateTitles: [],
+          relevanceScore: 0.95,
+          preview: {
+            status: "ongoing",
+            genres: ["Action"],
+          },
+        },
+      ],
+    };
+  },
+
+  async get(params) {
+    return {
+      externalId: params.externalId,
+      externalUrl: `https://example.com/${params.externalId}`,
+      alternateTitles: [],
+      genres: [],
+      tags: [],
+      authors: [],
+      artists: [],
+      externalLinks: [],
+    };
+  },
+
+  // Optional: implement match for auto-matching
+  async match(params) {
+    return {
+      match: null,
+      confidence: 0,
+    };
+  },
+};
+
+createMetadataPlugin({
+  manifest: {
+    name: "metadata-my-plugin",
+    displayName: "My Metadata Plugin",
+    version: "1.0.0",
+    description: "My custom metadata plugin",
+    author: "Me",
+    protocolVersion: "1.0",
+    capabilities: { metadataProvider: true },
+    contentTypes: ["series"],
+    scopes: ["series:detail"],
+  },
+  provider,
+});
+```
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Build the plugin
+npm run build
+
+# Type check
+npm run typecheck
+
+# Run tests
+npm test
+
+# Lint
+npm run lint
+```
+
+## Project Structure
+
+```
+plugins/metadata-echo/
+├── src/
+│   └── index.ts      # Plugin implementation
+├── dist/
+│   └── index.js      # Built bundle (excluded from git)
+├── package.json
+├── tsconfig.json
+└── README.md
+```
+
+## License
+
+MIT

package/dist/index.js

@@ -0,0 +1,461 @@
+#!/usr/bin/env node
+
+// ../sdk-typescript/dist/types/rpc.js
+var JSON_RPC_ERROR_CODES = {
+  /** Invalid JSON was received */
+  PARSE_ERROR: -32700,
+  /** The JSON sent is not a valid Request object */
+  INVALID_REQUEST: -32600,
+  /** The method does not exist / is not available */
+  METHOD_NOT_FOUND: -32601,
+  /** Invalid method parameter(s) */
+  INVALID_PARAMS: -32602,
+  /** Internal JSON-RPC error */
+  INTERNAL_ERROR: -32603
+};
+
+// ../sdk-typescript/dist/errors.js
+var PluginError = class extends Error {
+  data;
+  constructor(message, data) {
+    super(message);
+    this.name = this.constructor.name;
+    this.data = data;
+  }
+  /**
+   * Convert to JSON-RPC error format
+   */
+  toJsonRpcError() {
+    return {
+      code: this.code,
+      message: this.message,
+      data: this.data
+    };
+  }
+};
+
+// ../sdk-typescript/dist/logger.js
+var LOG_LEVELS = {
+  debug: 0,
+  info: 1,
+  warn: 2,
+  error: 3
+};
+var Logger = class {
+  name;
+  minLevel;
+  timestamps;
+  constructor(options) {
+    this.name = options.name;
+    this.minLevel = LOG_LEVELS[options.level ?? "info"];
+    this.timestamps = options.timestamps ?? true;
+  }
+  shouldLog(level) {
+    return LOG_LEVELS[level] >= this.minLevel;
+  }
+  format(level, message, data) {
+    const parts = [];
+    if (this.timestamps) {
+      parts.push((/* @__PURE__ */ new Date()).toISOString());
+    }
+    parts.push(`[${level.toUpperCase()}]`);
+    parts.push(`[${this.name}]`);
+    parts.push(message);
+    if (data !== void 0) {
+      if (data instanceof Error) {
+        parts.push(`- ${data.message}`);
+        if (data.stack) {
+          parts.push(`
+${data.stack}`);
+        }
+      } else if (typeof data === "object") {
+        parts.push(`- ${JSON.stringify(data)}`);
+      } else {
+        parts.push(`- ${String(data)}`);
+      }
+    }
+    return parts.join(" ");
+  }
+  log(level, message, data) {
+    if (this.shouldLog(level)) {
+      process.stderr.write(`${this.format(level, message, data)}
+`);
+    }
+  }
+  debug(message, data) {
+    this.log("debug", message, data);
+  }
+  info(message, data) {
+    this.log("info", message, data);
+  }
+  warn(message, data) {
+    this.log("warn", message, data);
+  }
+  error(message, data) {
+    this.log("error", message, data);
+  }
+};
+function createLogger(options) {
+  return new Logger(options);
+}
+
+// ../sdk-typescript/dist/server.js
+import { createInterface } from "node:readline";
+function validateStringFields(params, fields) {
+  if (params === null || params === void 0) {
+    return { field: "params", message: "params is required" };
+  }
+  if (typeof params !== "object") {
+    return { field: "params", message: "params must be an object" };
+  }
+  const obj = params;
+  for (const field of fields) {
+    const value = obj[field];
+    if (value === void 0 || value === null) {
+      return { field, message: `${field} is required` };
+    }
+    if (typeof value !== "string") {
+      return { field, message: `${field} must be a string` };
+    }
+    if (value.trim() === "") {
+      return { field, message: `${field} cannot be empty` };
+    }
+  }
+  return null;
+}
+function validateSearchParams(params) {
+  return validateStringFields(params, ["query"]);
+}
+function validateGetParams(params) {
+  return validateStringFields(params, ["externalId"]);
+}
+function validateMatchParams(params) {
+  return validateStringFields(params, ["title"]);
+}
+function invalidParamsError(id, error) {
+  return {
+    jsonrpc: "2.0",
+    id,
+    error: {
+      code: JSON_RPC_ERROR_CODES.INVALID_PARAMS,
+      message: `Invalid params: ${error.message}`,
+      data: { field: error.field }
+    }
+  };
+}
+function createMetadataPlugin(options) {
+  const { manifest: manifest2, provider: provider2, onInitialize, logLevel = "info" } = options;
+  const logger = createLogger({ name: manifest2.name, level: logLevel });
+  logger.info(`Starting plugin: ${manifest2.displayName} v${manifest2.version}`);
+  const rl = createInterface({
+    input: process.stdin,
+    terminal: false
+  });
+  rl.on("line", (line) => {
+    void handleLine(line, manifest2, provider2, onInitialize, logger);
+  });
+  rl.on("close", () => {
+    logger.info("stdin closed, shutting down");
+    process.exit(0);
+  });
+  process.on("uncaughtException", (error) => {
+    logger.error("Uncaught exception", error);
+    process.exit(1);
+  });
+  process.on("unhandledRejection", (reason) => {
+    logger.error("Unhandled rejection", reason);
+  });
+}
+async function handleLine(line, manifest2, provider2, onInitialize, logger) {
+  const trimmed = line.trim();
+  if (!trimmed)
+    return;
+  let id = null;
+  try {
+    const request = JSON.parse(trimmed);
+    id = request.id;
+    logger.debug(`Received request: ${request.method}`, { id: request.id });
+    const response = await handleRequest(request, manifest2, provider2, onInitialize, logger);
+    if (response !== null) {
+      writeResponse(response);
+    }
+  } catch (error) {
+    if (error instanceof SyntaxError) {
+      writeResponse({
+        jsonrpc: "2.0",
+        id: null,
+        error: {
+          code: JSON_RPC_ERROR_CODES.PARSE_ERROR,
+          message: "Parse error: invalid JSON"
+        }
+      });
+    } else if (error instanceof PluginError) {
+      writeResponse({
+        jsonrpc: "2.0",
+        id,
+        error: error.toJsonRpcError()
+      });
+    } else {
+      const message = error instanceof Error ? error.message : "Unknown error";
+      logger.error("Request failed", error);
+      writeResponse({
+        jsonrpc: "2.0",
+        id,
+        error: {
+          code: JSON_RPC_ERROR_CODES.INTERNAL_ERROR,
+          message
+        }
+      });
+    }
+  }
+}
+async function handleRequest(request, manifest2, provider2, onInitialize, logger) {
+  const { method, params, id } = request;
+  switch (method) {
+    case "initialize":
+      if (onInitialize) {
+        await onInitialize(params);
+      }
+      return {
+        jsonrpc: "2.0",
+        id,
+        result: manifest2
+      };
+    case "ping":
+      return {
+        jsonrpc: "2.0",
+        id,
+        result: "pong"
+      };
+    case "shutdown": {
+      logger.info("Shutdown requested");
+      const response = {
+        jsonrpc: "2.0",
+        id,
+        result: null
+      };
+      process.stdout.write(`${JSON.stringify(response)}
+`, () => {
+        process.exit(0);
+      });
+      return null;
+    }
+    // Series metadata methods (scoped by content type)
+    case "metadata/series/search": {
+      const validationError = validateSearchParams(params);
+      if (validationError) {
+        return invalidParamsError(id, validationError);
+      }
+      return {
+        jsonrpc: "2.0",
+        id,
+        result: await provider2.search(params)
+      };
+    }
+    case "metadata/series/get": {
+      const validationError = validateGetParams(params);
+      if (validationError) {
+        return invalidParamsError(id, validationError);
+      }
+      return {
+        jsonrpc: "2.0",
+        id,
+        result: await provider2.get(params)
+      };
+    }
+    case "metadata/series/match": {
+      if (!provider2.match) {
+        return {
+          jsonrpc: "2.0",
+          id,
+          error: {
+            code: JSON_RPC_ERROR_CODES.METHOD_NOT_FOUND,
+            message: "This plugin does not support match"
+          }
+        };
+      }
+      const validationError = validateMatchParams(params);
+      if (validationError) {
+        return invalidParamsError(id, validationError);
+      }
+      return {
+        jsonrpc: "2.0",
+        id,
+        result: await provider2.match(params)
+      };
+    }
+    // Future: book metadata methods
+    // case "metadata/book/search":
+    // case "metadata/book/get":
+    // case "metadata/book/match":
+    default:
+      return {
+        jsonrpc: "2.0",
+        id,
+        error: {
+          code: JSON_RPC_ERROR_CODES.METHOD_NOT_FOUND,
+          message: `Method not found: ${method}`
+        }
+      };
+  }
+}
+function writeResponse(response) {
+  process.stdout.write(`${JSON.stringify(response)}
+`);
+}
+
+// src/index.ts
+var manifest = {
+  name: "metadata-echo",
+  displayName: "Echo Metadata Plugin",
+  version: "1.0.0",
+  description: "Test metadata plugin that echoes back search queries",
+  author: "Codex",
+  homepage: "https://github.com/AshDevFr/codex",
+  protocolVersion: "1.0",
+  capabilities: {
+    metadataProvider: ["series"]
+  }
+};
+var provider = {
+  async search(params) {
+    return {
+      results: [
+        {
+          externalId: "echo-1",
+          title: `Echo: ${params.query}`,
+          alternateTitles: [`Echoed Query: ${params.query}`],
+          year: (/* @__PURE__ */ new Date()).getFullYear(),
+          relevanceScore: 1,
+          // Perfect match for echo
+          preview: {
+            status: "ended",
+            genres: ["Test", "Echo"],
+            rating: 10,
+            description: `Search query echoed: "${params.query}"`
+          }
+        },
+        {
+          externalId: "echo-2",
+          title: `Echo Result 2 for: ${params.query}`,
+          alternateTitles: [],
+          relevanceScore: 0.8,
+          preview: {
+            status: "ongoing",
+            genres: ["Test"],
+            description: "A second result for testing pagination"
+          }
+        }
+      ]
+    };
+  },
+  async get(params) {
+    return {
+      externalId: params.externalId,
+      externalUrl: `https://echo.example.com/series/${params.externalId}`,
+      title: `Echo Series: ${params.externalId}`,
+      alternateTitles: [
+        { title: `Echo Series: ${params.externalId}`, language: "en", titleType: "english" },
+        { title: `\u30A8\u30B3\u30FC\u30B7\u30EA\u30FC\u30BA: ${params.externalId}`, language: "ja", titleType: "native" },
+        { title: `Echo Romanized: ${params.externalId}`, language: "ja-Latn", titleType: "romaji" }
+      ],
+      summary: `This is the full metadata for external ID: ${params.externalId}. It includes a detailed description to test summary handling.`,
+      status: "ended",
+      year: 2024,
+      // Extended metadata fields
+      totalBookCount: 10,
+      language: "en",
+      ageRating: 13,
+      readingDirection: "ltr",
+      // Taxonomy
+      genres: ["Action", "Comedy", "Test", "Echo"],
+      tags: ["plugin-test", "echo", "automation", "development"],
+      // Credits
+      authors: ["Echo Author", "Test Writer"],
+      artists: ["Echo Artist"],
+      publisher: "Echo Publisher",
+      // Media
+      coverUrl: "https://picsum.photos/300/450",
+      bannerUrl: "https://picsum.photos/800/200",
+      // Primary rating
+      rating: {
+        score: 85,
+        voteCount: 100,
+        source: "echo"
+      },
+      // Multiple external ratings for testing aggregation
+      externalRatings: [
+        {
+          score: 85,
+          voteCount: 100,
+          source: "echo"
+        },
+        {
+          score: 92,
+          voteCount: 5e3,
+          source: "anilist"
+        },
+        {
+          score: 88,
+          voteCount: 2500,
+          source: "mal"
+        }
+      ],
+      // External links
+      externalLinks: [
+        {
+          url: `https://echo.example.com/series/${params.externalId}`,
+          label: "Echo Provider",
+          linkType: "provider"
+        },
+        {
+          url: "https://official-echo.example.com",
+          label: "Official Site",
+          linkType: "official"
+        },
+        {
+          url: "https://twitter.com/echo_series",
+          label: "Twitter",
+          linkType: "social"
+        },
+        {
+          url: "https://store.example.com/echo",
+          label: "Buy",
+          linkType: "purchase"
+        }
+      ]
+    };
+  },
+  async match(params) {
+    const normalizedTitle = params.title.toLowerCase().replace(/\s+/g, "-");
+    return {
+      match: {
+        externalId: `match-${normalizedTitle}`,
+        title: params.title,
+        alternateTitles: [],
+        year: params.year,
+        relevanceScore: 0.9,
+        preview: {
+          status: "ended",
+          genres: ["Matched"],
+          description: `Matched from title: "${params.title}"`
+        }
+      },
+      confidence: 0.85,
+      alternatives: [
+        {
+          externalId: "alt-1",
+          title: `Alternative: ${params.title}`,
+          alternateTitles: [],
+          relevanceScore: 0.6
+        }
+      ]
+    };
+  }
+};
+createMetadataPlugin({
+  manifest,
+  provider,
+  logLevel: "debug"
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../sdk-typescript/src/types/rpc.ts", "../../sdk-typescript/src/errors.ts", "../../sdk-typescript/src/logger.ts", "../../sdk-typescript/src/server.ts", "../src/index.ts"],
+  "sourcesContent": ["/**\n * JSON-RPC 2.0 types for plugin communication\n */\n\nexport interface JsonRpcRequest {\n  jsonrpc: \"2.0\";\n  id: string | number | null;\n  method: string;\n  params?: unknown;\n}\n\nexport interface JsonRpcSuccessResponse {\n  jsonrpc: \"2.0\";\n  id: string | number | null;\n  result: unknown;\n}\n\nexport interface JsonRpcErrorResponse {\n  jsonrpc: \"2.0\";\n  id: string | number | null;\n  error: JsonRpcError;\n}\n\nexport interface JsonRpcError {\n  code: number;\n  message: string;\n  data?: unknown;\n}\n\nexport type JsonRpcResponse = JsonRpcSuccessResponse | JsonRpcErrorResponse;\n\n/**\n * Standard JSON-RPC error codes\n */\nexport const JSON_RPC_ERROR_CODES = {\n  /** Invalid JSON was received */\n  PARSE_ERROR: -32700,\n  /** The JSON sent is not a valid Request object */\n  INVALID_REQUEST: -32600,\n  /** The method does not exist / is not available */\n  METHOD_NOT_FOUND: -32601,\n  /** Invalid method parameter(s) */\n  INVALID_PARAMS: -32602,\n  /** Internal JSON-RPC error */\n  INTERNAL_ERROR: -32603,\n} as const;\n\n/**\n * Plugin-specific error codes (in the -32000 to -32099 range)\n */\nexport const PLUGIN_ERROR_CODES = {\n  /** Rate limited by external API */\n  RATE_LIMITED: -32001,\n  /** Resource not found (e.g., series ID doesn't exist) */\n  NOT_FOUND: -32002,\n  /** Authentication failed (invalid credentials) */\n  AUTH_FAILED: -32003,\n  /** External API error */\n  API_ERROR: -32004,\n  /** Plugin configuration error */\n  CONFIG_ERROR: -32005,\n} as const;\n", "/**\n * Plugin error classes for structured error handling\n */\n\nimport { type JsonRpcError, PLUGIN_ERROR_CODES } from \"./types/rpc.js\";\n\n/**\n * Base class for plugin errors that map to JSON-RPC errors\n */\nexport abstract class PluginError extends Error {\n  abstract readonly code: number;\n  readonly data?: unknown;\n\n  constructor(message: string, data?: unknown) {\n    super(message);\n    this.name = this.constructor.name;\n    this.data = data;\n  }\n\n  /**\n   * Convert to JSON-RPC error format\n   */\n  toJsonRpcError(): JsonRpcError {\n    return {\n      code: this.code,\n      message: this.message,\n      data: this.data,\n    };\n  }\n}\n\n/**\n * Thrown when rate limited by an external API\n */\nexport class RateLimitError extends PluginError {\n  readonly code = PLUGIN_ERROR_CODES.RATE_LIMITED;\n  /** Seconds to wait before retrying */\n  readonly retryAfterSeconds: number;\n\n  constructor(retryAfterSeconds: number, message?: string) {\n    super(message ?? `Rate limited, retry after ${retryAfterSeconds}s`, {\n      retryAfterSeconds,\n    });\n    this.retryAfterSeconds = retryAfterSeconds;\n  }\n}\n\n/**\n * Thrown when a requested resource is not found\n */\nexport class NotFoundError extends PluginError {\n  readonly code = PLUGIN_ERROR_CODES.NOT_FOUND;\n}\n\n/**\n * Thrown when authentication fails (invalid credentials)\n */\nexport class AuthError extends PluginError {\n  readonly code = PLUGIN_ERROR_CODES.AUTH_FAILED;\n\n  constructor(message?: string) {\n    super(message ?? \"Authentication failed\");\n  }\n}\n\n/**\n * Thrown when an external API returns an error\n */\nexport class ApiError extends PluginError {\n  readonly code = PLUGIN_ERROR_CODES.API_ERROR;\n  readonly statusCode: number | undefined;\n\n  constructor(message: string, statusCode?: number) {\n    super(message, statusCode !== undefined ? { statusCode } : undefined);\n    this.statusCode = statusCode;\n  }\n}\n\n/**\n * Thrown when the plugin is misconfigured\n */\nexport class ConfigError extends PluginError {\n  readonly code = PLUGIN_ERROR_CODES.CONFIG_ERROR;\n}\n", "/**\n * Logging utilities for plugins\n *\n * IMPORTANT: Plugins must ONLY write to stderr for logging.\n * stdout is reserved for JSON-RPC communication.\n */\n\nexport type LogLevel = \"debug\" | \"info\" | \"warn\" | \"error\";\n\nconst LOG_LEVELS: Record<LogLevel, number> = {\n  debug: 0,\n  info: 1,\n  warn: 2,\n  error: 3,\n};\n\nexport interface LoggerOptions {\n  /** Plugin name to prefix log messages */\n  name: string;\n  /** Minimum log level (default: \"info\") */\n  level?: LogLevel;\n  /** Whether to include timestamps (default: true) */\n  timestamps?: boolean;\n}\n\n/**\n * Logger that writes to stderr (safe for plugins)\n */\nexport class Logger {\n  private readonly name: string;\n  private readonly minLevel: number;\n  private readonly timestamps: boolean;\n\n  constructor(options: LoggerOptions) {\n    this.name = options.name;\n    this.minLevel = LOG_LEVELS[options.level ?? \"info\"];\n    this.timestamps = options.timestamps ?? true;\n  }\n\n  private shouldLog(level: LogLevel): boolean {\n    return LOG_LEVELS[level] >= this.minLevel;\n  }\n\n  private format(level: LogLevel, message: string, data?: unknown): string {\n    const parts: string[] = [];\n\n    if (this.timestamps) {\n      parts.push(new Date().toISOString());\n    }\n\n    parts.push(`[${level.toUpperCase()}]`);\n    parts.push(`[${this.name}]`);\n    parts.push(message);\n\n    if (data !== undefined) {\n      if (data instanceof Error) {\n        parts.push(`- ${data.message}`);\n        if (data.stack) {\n          parts.push(`\\n${data.stack}`);\n        }\n      } else if (typeof data === \"object\") {\n        parts.push(`- ${JSON.stringify(data)}`);\n      } else {\n        parts.push(`- ${String(data)}`);\n      }\n    }\n\n    return parts.join(\" \");\n  }\n\n  private log(level: LogLevel, message: string, data?: unknown): void {\n    if (this.shouldLog(level)) {\n      // Write to stderr (not stdout!) - stdout is for JSON-RPC only\n      process.stderr.write(`${this.format(level, message, data)}\\n`);\n    }\n  }\n\n  debug(message: string, data?: unknown): void {\n    this.log(\"debug\", message, data);\n  }\n\n  info(message: string, data?: unknown): void {\n    this.log(\"info\", message, data);\n  }\n\n  warn(message: string, data?: unknown): void {\n    this.log(\"warn\", message, data);\n  }\n\n  error(message: string, data?: unknown): void {\n    this.log(\"error\", message, data);\n  }\n}\n\n/**\n * Create a logger for a plugin\n */\nexport function createLogger(options: LoggerOptions): Logger {\n  return new Logger(options);\n}\n", "/**\n * Plugin server - handles JSON-RPC communication over stdio\n */\n\nimport { createInterface } from \"node:readline\";\nimport { PluginError } from \"./errors.js\";\nimport { createLogger, type Logger } from \"./logger.js\";\nimport type { MetadataContentType, MetadataProvider } from \"./types/capabilities.js\";\nimport type { PluginManifest } from \"./types/manifest.js\";\nimport type {\n  MetadataGetParams,\n  MetadataMatchParams,\n  MetadataSearchParams,\n} from \"./types/protocol.js\";\nimport {\n  JSON_RPC_ERROR_CODES,\n  type JsonRpcError,\n  type JsonRpcRequest,\n  type JsonRpcResponse,\n} from \"./types/rpc.js\";\n\n// =============================================================================\n// Parameter Validation\n// =============================================================================\n\ninterface ValidationError {\n  field: string;\n  message: string;\n}\n\n/**\n * Validate that the required string fields are present and non-empty\n */\nfunction validateStringFields(params: unknown, fields: string[]): ValidationError | null {\n  if (params === null || params === undefined) {\n    return { field: \"params\", message: \"params is required\" };\n  }\n  if (typeof params !== \"object\") {\n    return { field: \"params\", message: \"params must be an object\" };\n  }\n\n  const obj = params as Record<string, unknown>;\n  for (const field of fields) {\n    const value = obj[field];\n    if (value === undefined || value === null) {\n      return { field, message: `${field} is required` };\n    }\n    if (typeof value !== \"string\") {\n      return { field, message: `${field} must be a string` };\n    }\n    if (value.trim() === \"\") {\n      return { field, message: `${field} cannot be empty` };\n    }\n  }\n\n  return null;\n}\n\n/**\n * Validate MetadataSearchParams\n */\nfunction validateSearchParams(params: unknown): ValidationError | null {\n  return validateStringFields(params, [\"query\"]);\n}\n\n/**\n * Validate MetadataGetParams\n */\nfunction validateGetParams(params: unknown): ValidationError | null {\n  return validateStringFields(params, [\"externalId\"]);\n}\n\n/**\n * Validate MetadataMatchParams\n */\nfunction validateMatchParams(params: unknown): ValidationError | null {\n  return validateStringFields(params, [\"title\"]);\n}\n\n/**\n * Create an INVALID_PARAMS error response\n */\nfunction invalidParamsError(id: string | number | null, error: ValidationError): JsonRpcResponse {\n  return {\n    jsonrpc: \"2.0\",\n    id,\n    error: {\n      code: JSON_RPC_ERROR_CODES.INVALID_PARAMS,\n      message: `Invalid params: ${error.message}`,\n      data: { field: error.field },\n    } as JsonRpcError,\n  };\n}\n\n/**\n * Initialize parameters received from Codex\n */\nexport interface InitializeParams {\n  /** Plugin configuration */\n  config?: Record<string, unknown>;\n  /** Plugin credentials (API keys, tokens, etc.) */\n  credentials?: Record<string, string>;\n}\n\n/**\n * Options for creating a metadata plugin\n */\nexport interface MetadataPluginOptions {\n  /** Plugin manifest - must have capabilities.metadataProvider with content types */\n  manifest: PluginManifest & {\n    capabilities: { metadataProvider: MetadataContentType[] };\n  };\n  /** MetadataProvider implementation */\n  provider: MetadataProvider;\n  /** Called when plugin receives initialize with credentials/config */\n  onInitialize?: (params: InitializeParams) => void | Promise<void>;\n  /** Log level (default: \"info\") */\n  logLevel?: \"debug\" | \"info\" | \"warn\" | \"error\";\n}\n\n/**\n * Create and run a metadata provider plugin\n *\n * Creates a plugin server that handles JSON-RPC communication over stdio.\n * The TypeScript compiler will ensure you implement all required methods.\n *\n * @example\n * ```typescript\n * import { createMetadataPlugin, type MetadataProvider } from \"@ashdev/codex-plugin-sdk\";\n *\n * const provider: MetadataProvider = {\n *   async search(params) {\n *     return {\n *       results: [{\n *         externalId: \"123\",\n *         title: \"Example\",\n *         alternateTitles: [],\n *         relevanceScore: 0.95,\n *       }],\n *     };\n *   },\n *   async get(params) {\n *     return {\n *       externalId: params.externalId,\n *       externalUrl: \"https://example.com/123\",\n *       alternateTitles: [],\n *       genres: [],\n *       tags: [],\n *       authors: [],\n *       artists: [],\n *       externalLinks: [],\n *     };\n *   },\n * };\n *\n * createMetadataPlugin({\n *   manifest: {\n *     name: \"my-plugin\",\n *     displayName: \"My Plugin\",\n *     version: \"1.0.0\",\n *     description: \"Example plugin\",\n *     author: \"Me\",\n *     protocolVersion: \"1.0\",\n *     capabilities: { metadataProvider: [\"series\"] },\n *   },\n *   provider,\n * });\n * ```\n */\nexport function createMetadataPlugin(options: MetadataPluginOptions): void {\n  const { manifest, provider, onInitialize, logLevel = \"info\" } = options;\n  const logger = createLogger({ name: manifest.name, level: logLevel });\n\n  logger.info(`Starting plugin: ${manifest.displayName} v${manifest.version}`);\n\n  const rl = createInterface({\n    input: process.stdin,\n    terminal: false,\n  });\n\n  rl.on(\"line\", (line) => {\n    void handleLine(line, manifest, provider, onInitialize, logger);\n  });\n\n  rl.on(\"close\", () => {\n    logger.info(\"stdin closed, shutting down\");\n    process.exit(0);\n  });\n\n  // Handle uncaught errors\n  process.on(\"uncaughtException\", (error) => {\n    logger.error(\"Uncaught exception\", error);\n    process.exit(1);\n  });\n\n  process.on(\"unhandledRejection\", (reason) => {\n    logger.error(\"Unhandled rejection\", reason);\n  });\n}\n\n// =============================================================================\n// Backwards Compatibility (deprecated)\n// =============================================================================\n\n/**\n * @deprecated Use createMetadataPlugin instead\n */\nexport function createSeriesMetadataPlugin(options: SeriesMetadataPluginOptions): void {\n  // Convert legacy options to new format\n  const newOptions: MetadataPluginOptions = {\n    ...options,\n    manifest: {\n      ...options.manifest,\n      capabilities: {\n        ...options.manifest.capabilities,\n        metadataProvider: [\"series\"] as MetadataContentType[],\n      },\n    },\n  };\n  createMetadataPlugin(newOptions);\n}\n\n/**\n * @deprecated Use MetadataPluginOptions instead\n */\nexport interface SeriesMetadataPluginOptions {\n  /** Plugin manifest - must have capabilities.seriesMetadataProvider: true */\n  manifest: PluginManifest & {\n    capabilities: { seriesMetadataProvider: true };\n  };\n  /** SeriesMetadataProvider implementation */\n  provider: MetadataProvider;\n  /** Called when plugin receives initialize with credentials/config */\n  onInitialize?: (params: InitializeParams) => void | Promise<void>;\n  /** Log level (default: \"info\") */\n  logLevel?: \"debug\" | \"info\" | \"warn\" | \"error\";\n}\n\n// =============================================================================\n// Internal Implementation\n// =============================================================================\n\nasync function handleLine(\n  line: string,\n  manifest: PluginManifest,\n  provider: MetadataProvider,\n  onInitialize: ((params: InitializeParams) => void | Promise<void>) | undefined,\n  logger: Logger,\n): Promise<void> {\n  const trimmed = line.trim();\n  if (!trimmed) return;\n\n  let id: string | number | null = null;\n\n  try {\n    const request = JSON.parse(trimmed) as JsonRpcRequest;\n    id = request.id;\n\n    logger.debug(`Received request: ${request.method}`, { id: request.id });\n\n    const response = await handleRequest(request, manifest, provider, onInitialize, logger);\n    // Shutdown handler writes response directly and returns null\n    if (response !== null) {\n      writeResponse(response);\n    }\n  } catch (error) {\n    if (error instanceof SyntaxError) {\n      // JSON parse error\n      writeResponse({\n        jsonrpc: \"2.0\",\n        id: null,\n        error: {\n          code: JSON_RPC_ERROR_CODES.PARSE_ERROR,\n          message: \"Parse error: invalid JSON\",\n        },\n      });\n    } else if (error instanceof PluginError) {\n      writeResponse({\n        jsonrpc: \"2.0\",\n        id,\n        error: error.toJsonRpcError(),\n      });\n    } else {\n      const message = error instanceof Error ? error.message : \"Unknown error\";\n      logger.error(\"Request failed\", error);\n      writeResponse({\n        jsonrpc: \"2.0\",\n        id,\n        error: {\n          code: JSON_RPC_ERROR_CODES.INTERNAL_ERROR,\n          message,\n        },\n      });\n    }\n  }\n}\n\nasync function handleRequest(\n  request: JsonRpcRequest,\n  manifest: PluginManifest,\n  provider: MetadataProvider,\n  onInitialize: ((params: InitializeParams) => void | Promise<void>) | undefined,\n  logger: Logger,\n): Promise<JsonRpcResponse> {\n  const { method, params, id } = request;\n\n  switch (method) {\n    case \"initialize\":\n      // Call onInitialize callback if provided (to receive credentials/config)\n      if (onInitialize) {\n        await onInitialize(params as InitializeParams);\n      }\n      return {\n        jsonrpc: \"2.0\",\n        id,\n        result: manifest,\n      };\n\n    case \"ping\":\n      return {\n        jsonrpc: \"2.0\",\n        id,\n        result: \"pong\",\n      };\n\n    case \"shutdown\": {\n      logger.info(\"Shutdown requested\");\n      // Write response directly with callback to ensure it's flushed before exit\n      const response: JsonRpcResponse = {\n        jsonrpc: \"2.0\",\n        id,\n        result: null,\n      };\n      process.stdout.write(`${JSON.stringify(response)}\\n`, () => {\n        // Callback is called after the write is flushed to the OS\n        process.exit(0);\n      });\n      // Return a sentinel that handleLine will recognize and skip normal writeResponse\n      return null as unknown as JsonRpcResponse;\n    }\n\n    // Series metadata methods (scoped by content type)\n    case \"metadata/series/search\": {\n      const validationError = validateSearchParams(params);\n      if (validationError) {\n        return invalidParamsError(id, validationError);\n      }\n      return {\n        jsonrpc: \"2.0\",\n        id,\n        result: await provider.search(params as MetadataSearchParams),\n      };\n    }\n\n    case \"metadata/series/get\": {\n      const validationError = validateGetParams(params);\n      if (validationError) {\n        return invalidParamsError(id, validationError);\n      }\n      return {\n        jsonrpc: \"2.0\",\n        id,\n        result: await provider.get(params as MetadataGetParams),\n      };\n    }\n\n    case \"metadata/series/match\": {\n      if (!provider.match) {\n        return {\n          jsonrpc: \"2.0\",\n          id,\n          error: {\n            code: JSON_RPC_ERROR_CODES.METHOD_NOT_FOUND,\n            message: \"This plugin does not support match\",\n          },\n        };\n      }\n      const validationError = validateMatchParams(params);\n      if (validationError) {\n        return invalidParamsError(id, validationError);\n      }\n      return {\n        jsonrpc: \"2.0\",\n        id,\n        result: await provider.match(params as MetadataMatchParams),\n      };\n    }\n\n    // Future: book metadata methods\n    // case \"metadata/book/search\":\n    // case \"metadata/book/get\":\n    // case \"metadata/book/match\":\n\n    default:\n      return {\n        jsonrpc: \"2.0\",\n        id,\n        error: {\n          code: JSON_RPC_ERROR_CODES.METHOD_NOT_FOUND,\n          message: `Method not found: ${method}`,\n        },\n      };\n  }\n}\n\nfunction writeResponse(response: JsonRpcResponse): void {\n  // Write to stdout - this is the JSON-RPC channel\n  process.stdout.write(`${JSON.stringify(response)}\\n`);\n}\n", "/**\n * Echo Plugin - A minimal plugin for testing the Codex plugin protocol\n *\n * This plugin demonstrates the plugin SDK usage and serves as a protocol\n * validation tool. It echoes back search parameters and provides predictable\n * responses for testing.\n */\n\nimport {\n  createMetadataPlugin,\n  type MetadataContentType,\n  type MetadataGetParams,\n  type MetadataMatchParams,\n  type MetadataMatchResponse,\n  type MetadataProvider,\n  type MetadataSearchParams,\n  type MetadataSearchResponse,\n  type PluginManifest,\n  type PluginSeriesMetadata,\n} from \"@ashdev/codex-plugin-sdk\";\n\nconst manifest = {\n  name: \"metadata-echo\",\n  displayName: \"Echo Metadata Plugin\",\n  version: \"1.0.0\",\n  description: \"Test metadata plugin that echoes back search queries\",\n  author: \"Codex\",\n  homepage: \"https://github.com/AshDevFr/codex\",\n  protocolVersion: \"1.0\",\n  capabilities: {\n    metadataProvider: [\"series\"] as MetadataContentType[],\n  },\n} as const satisfies PluginManifest & {\n  capabilities: { metadataProvider: MetadataContentType[] };\n};\n\nconst provider: MetadataProvider = {\n  async search(params: MetadataSearchParams): Promise<MetadataSearchResponse> {\n    // Echo back the query as search results\n    return {\n      results: [\n        {\n          externalId: \"echo-1\",\n          title: `Echo: ${params.query}`,\n          alternateTitles: [`Echoed Query: ${params.query}`],\n          year: new Date().getFullYear(),\n          relevanceScore: 1.0, // Perfect match for echo\n          preview: {\n            status: \"ended\",\n            genres: [\"Test\", \"Echo\"],\n            rating: 10.0,\n            description: `Search query echoed: \"${params.query}\"`,\n          },\n        },\n        {\n          externalId: \"echo-2\",\n          title: `Echo Result 2 for: ${params.query}`,\n          alternateTitles: [],\n          relevanceScore: 0.8,\n          preview: {\n            status: \"ongoing\",\n            genres: [\"Test\"],\n            description: \"A second result for testing pagination\",\n          },\n        },\n      ],\n    };\n  },\n\n  async get(params: MetadataGetParams): Promise<PluginSeriesMetadata> {\n    // Return metadata based on the external ID with all fields populated for testing\n    return {\n      externalId: params.externalId,\n      externalUrl: `https://echo.example.com/series/${params.externalId}`,\n      title: `Echo Series: ${params.externalId}`,\n      alternateTitles: [\n        { title: `Echo Series: ${params.externalId}`, language: \"en\", titleType: \"english\" },\n        { title: `\u30A8\u30B3\u30FC\u30B7\u30EA\u30FC\u30BA: ${params.externalId}`, language: \"ja\", titleType: \"native\" },\n        { title: `Echo Romanized: ${params.externalId}`, language: \"ja-Latn\", titleType: \"romaji\" },\n      ],\n      summary: `This is the full metadata for external ID: ${params.externalId}. It includes a detailed description to test summary handling.`,\n      status: \"ended\",\n      year: 2024,\n\n      // Extended metadata fields\n      totalBookCount: 10,\n      language: \"en\",\n      ageRating: 13,\n      readingDirection: \"ltr\",\n\n      // Taxonomy\n      genres: [\"Action\", \"Comedy\", \"Test\", \"Echo\"],\n      tags: [\"plugin-test\", \"echo\", \"automation\", \"development\"],\n\n      // Credits\n      authors: [\"Echo Author\", \"Test Writer\"],\n      artists: [\"Echo Artist\"],\n      publisher: \"Echo Publisher\",\n\n      // Media\n      coverUrl: \"https://picsum.photos/300/450\",\n      bannerUrl: \"https://picsum.photos/800/200\",\n\n      // Primary rating\n      rating: {\n        score: 85,\n        voteCount: 100,\n        source: \"echo\",\n      },\n\n      // Multiple external ratings for testing aggregation\n      externalRatings: [\n        {\n          score: 85,\n          voteCount: 100,\n          source: \"echo\",\n        },\n        {\n          score: 92,\n          voteCount: 5000,\n          source: \"anilist\",\n        },\n        {\n          score: 88,\n          voteCount: 2500,\n          source: \"mal\",\n        },\n      ],\n\n      // External links\n      externalLinks: [\n        {\n          url: `https://echo.example.com/series/${params.externalId}`,\n          label: \"Echo Provider\",\n          linkType: \"provider\",\n        },\n        {\n          url: \"https://official-echo.example.com\",\n          label: \"Official Site\",\n          linkType: \"official\",\n        },\n        {\n          url: \"https://twitter.com/echo_series\",\n          label: \"Twitter\",\n          linkType: \"social\",\n        },\n        {\n          url: \"https://store.example.com/echo\",\n          label: \"Buy\",\n          linkType: \"purchase\",\n        },\n      ],\n    };\n  },\n\n  async match(params: MetadataMatchParams): Promise<MetadataMatchResponse> {\n    // Return a match based on the title\n    const normalizedTitle = params.title.toLowerCase().replace(/\\s+/g, \"-\");\n    return {\n      match: {\n        externalId: `match-${normalizedTitle}`,\n        title: params.title,\n        alternateTitles: [],\n        year: params.year,\n        relevanceScore: 0.9,\n        preview: {\n          status: \"ended\",\n          genres: [\"Matched\"],\n          description: `Matched from title: \"${params.title}\"`,\n        },\n      },\n      confidence: 0.85,\n      alternatives: [\n        {\n          externalId: \"alt-1\",\n          title: `Alternative: ${params.title}`,\n          alternateTitles: [],\n          relevanceScore: 0.6,\n        },\n      ],\n    };\n  },\n};\n\ncreateMetadataPlugin({\n  manifest,\n  provider,\n  logLevel: \"debug\",\n});\n"],
+  "mappings": "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",
+  "names": ["manifest", "provider", "manifest", "provider"]
+}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@ashdev/codex-plugin-metadata-echo",
+  "version": "1.0.0",
+  "description": "Echo metadata plugin for testing Codex plugin protocol",
+  "main": "dist/index.js",
+  "bin": "dist/index.js",
+  "type": "module",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/AshDevFr/codex.git",
+    "directory": "plugins/metadata-echo"
+  },
+  "scripts": {
+    "build": "esbuild src/index.ts --bundle --platform=node --target=node22 --format=esm --outfile=dist/index.js --sourcemap --banner:js='#!/usr/bin/env node'",
+    "dev": "npm run build -- --watch",
+    "clean": "rm -rf dist",
+    "start": "node dist/index.js",
+    "lint": "biome check .",
+    "lint:fix": "biome check --write .",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run --passWithNoTests",
+    "test:watch": "vitest",
+    "prepublishOnly": "npm run lint && npm run build"
+  },
+  "keywords": [
+    "codex",
+    "plugin",
+    "echo",
+    "testing"
+  ],
+  "author": "Codex",
+  "license": "MIT",
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "dependencies": {
+    "@ashdev/codex-plugin-sdk": "^1.0.0"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.3.13",
+    "@types/node": "^22.0.0",
+    "esbuild": "^0.24.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  }
+}