@quilltap/plugin-types 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,41 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.0.0] - 2024-12-30
+
+### Added
+
+- Initial release of `@quilltap/plugin-types`
+- Core LLM types:
+  - `LLMProvider` interface
+  - `LLMParams`, `LLMResponse`, `StreamChunk` types
+  - `LLMMessage`, `FileAttachment` types
+  - `ImageGenParams`, `ImageGenResponse` types
+  - `ModelMetadata`, `ModelWarning` types
+- Tool/function calling types:
+  - `OpenAIToolDefinition`, `AnthropicToolDefinition`, `GoogleToolDefinition`
+  - `UniversalTool` (alias for OpenAI format)
+  - `ToolCall`, `ToolCallRequest`, `ToolResult`
+- Plugin interface types:
+  - `LLMProviderPlugin` main interface
+  - `ProviderMetadata`, `ProviderCapabilities`
+  - `AttachmentSupport`, `ModelInfo`
+  - `EmbeddingModelInfo`, `ImageGenerationModelInfo`
+- Plugin manifest types:
+  - `PluginManifest` schema
+  - `PluginCapability`, `PluginCategory`, `PluginStatus`
+  - `InstalledPluginInfo`
+- Common utilities:
+  - Error classes: `PluginError`, `ApiKeyError`, `ProviderApiError`, `RateLimitError`
+  - Additional errors: `ConfigurationError`, `ModelNotFoundError`, `AttachmentError`, `ToolExecutionError`
+  - Logger interface: `PluginLogger`
+  - Logger factories: `createConsoleLogger`, `createNoopLogger`
+- Submodule exports for granular imports:
+  - `@quilltap/plugin-types/llm`
+  - `@quilltap/plugin-types/plugins`
+  - `@quilltap/plugin-types/common`
+- `PLUGIN_TYPES_VERSION` export for runtime compatibility checks

package/README.md

@@ -0,0 +1,187 @@
+# @quilltap/plugin-types
+
+Type definitions for building Quilltap plugins.
+
+## Installation
+
+```bash
+npm install --save-dev @quilltap/plugin-types
+```
+
+## Usage
+
+### Basic Plugin
+
+```typescript
+import type {
+  LLMProviderPlugin,
+  LLMProvider,
+  LLMParams,
+  LLMResponse
+} from '@quilltap/plugin-types';
+
+export const plugin: LLMProviderPlugin = {
+  metadata: {
+    providerName: 'MY_PROVIDER',
+    displayName: 'My Provider',
+    description: 'A custom LLM provider',
+    abbreviation: 'MYP',
+    colors: {
+      bg: 'bg-blue-100',
+      text: 'text-blue-800',
+      icon: 'text-blue-600',
+    },
+  },
+  config: {
+    requiresApiKey: true,
+    requiresBaseUrl: false,
+    apiKeyLabel: 'API Key',
+  },
+  capabilities: {
+    chat: true,
+    imageGeneration: false,
+    embeddings: false,
+    webSearch: false,
+  },
+  attachmentSupport: {
+    supportsAttachments: false,
+    supportedMimeTypes: [],
+    description: 'No file attachments supported',
+  },
+  createProvider: () => new MyProvider(),
+  getAvailableModels: async (apiKey) => ['model-1', 'model-2'],
+  validateApiKey: async (apiKey) => true,
+  renderIcon: ({ className }) => <MyIcon className={className} />,
+};
+```
+
+### Submodule Imports
+
+You can import from specific submodules for more granular imports:
+
+```typescript
+// LLM types only
+import type { LLMProvider, LLMParams, LLMResponse } from '@quilltap/plugin-types/llm';
+
+// Plugin types only
+import type { LLMProviderPlugin, PluginManifest } from '@quilltap/plugin-types/plugins';
+
+// Common utilities
+import { createConsoleLogger, PluginError } from '@quilltap/plugin-types/common';
+```
+
+### Error Handling
+
+The package provides standard error classes for consistent error handling:
+
+```typescript
+import {
+  PluginError,
+  ApiKeyError,
+  ProviderApiError,
+  RateLimitError
+} from '@quilltap/plugin-types';
+
+// Throwing errors
+throw new ApiKeyError('Invalid API key', 'my-plugin');
+throw new RateLimitError('Rate limited', 60, 'my-plugin');
+
+// Catching errors
+try {
+  await provider.sendMessage(params, apiKey);
+} catch (error) {
+  if (error instanceof RateLimitError) {
+    console.log(`Retry after ${error.retryAfter} seconds`);
+  } else if (error instanceof ProviderApiError) {
+    console.log(`API error: ${error.statusCode}`);
+  }
+}
+```
+
+### Logging
+
+Use the built-in logger for development:
+
+```typescript
+import { createConsoleLogger } from '@quilltap/plugin-types';
+
+const logger = createConsoleLogger('my-plugin', 'debug');
+
+logger.debug('Initializing plugin', { version: '1.0.0' });
+logger.info('Plugin ready');
+logger.warn('Deprecated feature used');
+logger.error('Failed to connect', { endpoint: 'api.example.com' }, error);
+```
+
+## Type Reference
+
+### LLM Types
+
+| Type | Description |
+|------|-------------|
+| `LLMProvider` | Core provider interface |
+| `LLMParams` | Request parameters |
+| `LLMResponse` | Complete response |
+| `StreamChunk` | Streaming response chunk |
+| `LLMMessage` | Conversation message |
+| `FileAttachment` | File attachment for multimodal |
+| `ToolCall` | Tool/function call |
+| `ImageGenParams` | Image generation parameters |
+| `ImageGenResponse` | Image generation response |
+
+### Plugin Types
+
+| Type | Description |
+|------|-------------|
+| `LLMProviderPlugin` | Main plugin interface |
+| `ProviderMetadata` | UI display metadata |
+| `ProviderCapabilities` | Capability flags |
+| `AttachmentSupport` | File attachment config |
+| `PluginManifest` | Plugin manifest schema |
+
+### Common Types
+
+| Type | Description |
+|------|-------------|
+| `PluginLogger` | Logger interface |
+| `LogLevel` | Log level type |
+| `PluginError` | Base error class |
+| `ApiKeyError` | API key validation error |
+| `ProviderApiError` | Provider API error |
+| `RateLimitError` | Rate limit error |
+
+## Plugin Manifest
+
+Every Quilltap plugin needs a `quilltap-manifest.json` file:
+
+```json
+{
+  "$schema": "https://quilltap.io/schemas/plugin-manifest.json",
+  "name": "qtap-plugin-my-provider",
+  "title": "My Provider",
+  "description": "A custom LLM provider for Quilltap",
+  "version": "1.0.0",
+  "author": {
+    "name": "Your Name",
+    "email": "you@example.com"
+  },
+  "license": "MIT",
+  "compatibility": {
+    "quilltapVersion": ">=1.7.0"
+  },
+  "capabilities": ["LLM_PROVIDER"],
+  "category": "PROVIDER",
+  "main": "dist/index.js",
+  "status": "STABLE"
+}
+```
+
+## Documentation
+
+- [Plugin Development Guide](https://docs.quilltap.io/plugins/development)
+- [API Reference](https://docs.quilltap.io/plugins/api)
+- [Example Plugins](https://github.com/foundry-9/quilltap/tree/main/plugins/dist)
+
+## License
+
+MIT

package/dist/common/index.d.mts

@@ -0,0 +1,158 @@
+/**
+ * Logger types for Quilltap plugin development
+ *
+ * @module @quilltap/plugin-types/common/logger
+ */
+/**
+ * Log level type
+ */
+type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+/**
+ * Log context metadata
+ */
+interface LogContext {
+    /** Context identifier (e.g., module name) */
+    context?: string;
+    /** Additional metadata */
+    [key: string]: unknown;
+}
+/**
+ * Logger interface that plugins can implement or receive
+ *
+ * This interface is compatible with Quilltap's built-in logger.
+ * Plugins can use this interface to accept a logger from the host
+ * application or implement their own logging.
+ */
+interface PluginLogger {
+    /**
+     * Log a debug message
+     * @param message Message to log
+     * @param context Optional context metadata
+     */
+    debug(message: string, context?: LogContext): void;
+    /**
+     * Log an info message
+     * @param message Message to log
+     * @param context Optional context metadata
+     */
+    info(message: string, context?: LogContext): void;
+    /**
+     * Log a warning message
+     * @param message Message to log
+     * @param context Optional context metadata
+     */
+    warn(message: string, context?: LogContext): void;
+    /**
+     * Log an error message
+     * @param message Message to log
+     * @param context Optional context metadata
+     * @param error Optional error object
+     */
+    error(message: string, context?: LogContext, error?: Error): void;
+}
+/**
+ * Simple console-based logger for standalone plugin development
+ *
+ * This logger writes to the console and is useful for local
+ * plugin development and testing.
+ *
+ * @param prefix Prefix to add to all log messages
+ * @param minLevel Minimum log level to output (default: 'info')
+ * @returns A PluginLogger instance
+ *
+ * @example
+ * ```typescript
+ * const logger = createConsoleLogger('my-plugin', 'debug');
+ * logger.debug('Initializing plugin', { version: '1.0.0' });
+ * logger.info('Plugin ready');
+ * logger.error('Failed to connect', { endpoint: 'api.example.com' }, new Error('Connection refused'));
+ * ```
+ */
+declare function createConsoleLogger(prefix: string, minLevel?: LogLevel): PluginLogger;
+/**
+ * No-op logger for production or when logging is disabled
+ *
+ * @returns A PluginLogger that does nothing
+ */
+declare function createNoopLogger(): PluginLogger;
+
+/**
+ * Common error types for Quilltap plugin development
+ *
+ * @module @quilltap/plugin-types/common/errors
+ */
+/**
+ * Base plugin error
+ *
+ * All plugin-specific errors should extend this class.
+ */
+declare class PluginError extends Error {
+    readonly code: string;
+    readonly pluginName?: string | undefined;
+    constructor(message: string, code: string, pluginName?: string | undefined);
+}
+/**
+ * API key validation error
+ *
+ * Thrown when an API key is invalid or has insufficient permissions.
+ */
+declare class ApiKeyError extends PluginError {
+    constructor(message: string, pluginName?: string);
+}
+/**
+ * Provider API error
+ *
+ * Thrown when the provider API returns an error.
+ */
+declare class ProviderApiError extends PluginError {
+    readonly statusCode?: number | undefined;
+    readonly response?: unknown | undefined;
+    constructor(message: string, statusCode?: number | undefined, response?: unknown | undefined, pluginName?: string);
+}
+/**
+ * Rate limit error
+ *
+ * Thrown when the provider rate limits the request.
+ */
+declare class RateLimitError extends ProviderApiError {
+    readonly retryAfter?: number | undefined;
+    readonly code = "RATE_LIMIT_ERROR";
+    constructor(message: string, retryAfter?: number | undefined, pluginName?: string);
+}
+/**
+ * Configuration error
+ *
+ * Thrown when plugin configuration is invalid.
+ */
+declare class ConfigurationError extends PluginError {
+    constructor(message: string, pluginName?: string);
+}
+/**
+ * Model not found error
+ *
+ * Thrown when a requested model is not available.
+ */
+declare class ModelNotFoundError extends PluginError {
+    readonly modelId?: string | undefined;
+    constructor(message: string, modelId?: string | undefined, pluginName?: string);
+}
+/**
+ * Attachment error
+ *
+ * Thrown when there's an issue processing file attachments.
+ */
+declare class AttachmentError extends PluginError {
+    readonly attachmentId?: string | undefined;
+    constructor(message: string, attachmentId?: string | undefined, pluginName?: string);
+}
+/**
+ * Tool execution error
+ *
+ * Thrown when a tool call fails to execute.
+ */
+declare class ToolExecutionError extends PluginError {
+    readonly toolName?: string | undefined;
+    constructor(message: string, toolName?: string | undefined, pluginName?: string);
+}
+
+export { ApiKeyError, AttachmentError, ConfigurationError, type LogContext, type LogLevel, ModelNotFoundError, PluginError, type PluginLogger, ProviderApiError, RateLimitError, ToolExecutionError, createConsoleLogger, createNoopLogger };

package/dist/common/index.d.ts

@@ -0,0 +1,158 @@
+/**
+ * Logger types for Quilltap plugin development
+ *
+ * @module @quilltap/plugin-types/common/logger
+ */
+/**
+ * Log level type
+ */
+type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+/**
+ * Log context metadata
+ */
+interface LogContext {
+    /** Context identifier (e.g., module name) */
+    context?: string;
+    /** Additional metadata */
+    [key: string]: unknown;
+}
+/**
+ * Logger interface that plugins can implement or receive
+ *
+ * This interface is compatible with Quilltap's built-in logger.
+ * Plugins can use this interface to accept a logger from the host
+ * application or implement their own logging.
+ */
+interface PluginLogger {
+    /**
+     * Log a debug message
+     * @param message Message to log
+     * @param context Optional context metadata
+     */
+    debug(message: string, context?: LogContext): void;
+    /**
+     * Log an info message
+     * @param message Message to log
+     * @param context Optional context metadata
+     */
+    info(message: string, context?: LogContext): void;
+    /**
+     * Log a warning message
+     * @param message Message to log
+     * @param context Optional context metadata
+     */
+    warn(message: string, context?: LogContext): void;
+    /**
+     * Log an error message
+     * @param message Message to log
+     * @param context Optional context metadata
+     * @param error Optional error object
+     */
+    error(message: string, context?: LogContext, error?: Error): void;
+}
+/**
+ * Simple console-based logger for standalone plugin development
+ *
+ * This logger writes to the console and is useful for local
+ * plugin development and testing.
+ *
+ * @param prefix Prefix to add to all log messages
+ * @param minLevel Minimum log level to output (default: 'info')
+ * @returns A PluginLogger instance
+ *
+ * @example
+ * ```typescript
+ * const logger = createConsoleLogger('my-plugin', 'debug');
+ * logger.debug('Initializing plugin', { version: '1.0.0' });
+ * logger.info('Plugin ready');
+ * logger.error('Failed to connect', { endpoint: 'api.example.com' }, new Error('Connection refused'));
+ * ```
+ */
+declare function createConsoleLogger(prefix: string, minLevel?: LogLevel): PluginLogger;
+/**
+ * No-op logger for production or when logging is disabled
+ *
+ * @returns A PluginLogger that does nothing
+ */
+declare function createNoopLogger(): PluginLogger;
+
+/**
+ * Common error types for Quilltap plugin development
+ *
+ * @module @quilltap/plugin-types/common/errors
+ */
+/**
+ * Base plugin error
+ *
+ * All plugin-specific errors should extend this class.
+ */
+declare class PluginError extends Error {
+    readonly code: string;
+    readonly pluginName?: string | undefined;
+    constructor(message: string, code: string, pluginName?: string | undefined);
+}
+/**
+ * API key validation error
+ *
+ * Thrown when an API key is invalid or has insufficient permissions.
+ */
+declare class ApiKeyError extends PluginError {
+    constructor(message: string, pluginName?: string);
+}
+/**
+ * Provider API error
+ *
+ * Thrown when the provider API returns an error.
+ */
+declare class ProviderApiError extends PluginError {
+    readonly statusCode?: number | undefined;
+    readonly response?: unknown | undefined;
+    constructor(message: string, statusCode?: number | undefined, response?: unknown | undefined, pluginName?: string);
+}
+/**
+ * Rate limit error
+ *
+ * Thrown when the provider rate limits the request.
+ */
+declare class RateLimitError extends ProviderApiError {
+    readonly retryAfter?: number | undefined;
+    readonly code = "RATE_LIMIT_ERROR";
+    constructor(message: string, retryAfter?: number | undefined, pluginName?: string);
+}
+/**
+ * Configuration error
+ *
+ * Thrown when plugin configuration is invalid.
+ */
+declare class ConfigurationError extends PluginError {
+    constructor(message: string, pluginName?: string);
+}
+/**
+ * Model not found error
+ *
+ * Thrown when a requested model is not available.
+ */
+declare class ModelNotFoundError extends PluginError {
+    readonly modelId?: string | undefined;
+    constructor(message: string, modelId?: string | undefined, pluginName?: string);
+}
+/**
+ * Attachment error
+ *
+ * Thrown when there's an issue processing file attachments.
+ */
+declare class AttachmentError extends PluginError {
+    readonly attachmentId?: string | undefined;
+    constructor(message: string, attachmentId?: string | undefined, pluginName?: string);
+}
+/**
+ * Tool execution error
+ *
+ * Thrown when a tool call fails to execute.
+ */
+declare class ToolExecutionError extends PluginError {
+    readonly toolName?: string | undefined;
+    constructor(message: string, toolName?: string | undefined, pluginName?: string);
+}
+
+export { ApiKeyError, AttachmentError, ConfigurationError, type LogContext, type LogLevel, ModelNotFoundError, PluginError, type PluginLogger, ProviderApiError, RateLimitError, ToolExecutionError, createConsoleLogger, createNoopLogger };

package/dist/common/index.js

@@ -0,0 +1,120 @@
+'use strict';
+
+// src/common/errors.ts
+var PluginError = class extends Error {
+  constructor(message, code, pluginName) {
+    super(message);
+    this.code = code;
+    this.pluginName = pluginName;
+    this.name = "PluginError";
+  }
+};
+var ApiKeyError = class extends PluginError {
+  constructor(message, pluginName) {
+    super(message, "API_KEY_ERROR", pluginName);
+    this.name = "ApiKeyError";
+  }
+};
+var ProviderApiError = class extends PluginError {
+  constructor(message, statusCode, response, pluginName) {
+    super(message, "PROVIDER_API_ERROR", pluginName);
+    this.statusCode = statusCode;
+    this.response = response;
+    this.name = "ProviderApiError";
+  }
+};
+var RateLimitError = class extends ProviderApiError {
+  constructor(message, retryAfter, pluginName) {
+    super(message, 429, void 0, pluginName);
+    this.retryAfter = retryAfter;
+    this.code = "RATE_LIMIT_ERROR";
+    this.name = "RateLimitError";
+  }
+};
+var ConfigurationError = class extends PluginError {
+  constructor(message, pluginName) {
+    super(message, "CONFIGURATION_ERROR", pluginName);
+    this.name = "ConfigurationError";
+  }
+};
+var ModelNotFoundError = class extends PluginError {
+  constructor(message, modelId, pluginName) {
+    super(message, "MODEL_NOT_FOUND", pluginName);
+    this.modelId = modelId;
+    this.name = "ModelNotFoundError";
+  }
+};
+var AttachmentError = class extends PluginError {
+  constructor(message, attachmentId, pluginName) {
+    super(message, "ATTACHMENT_ERROR", pluginName);
+    this.attachmentId = attachmentId;
+    this.name = "AttachmentError";
+  }
+};
+var ToolExecutionError = class extends PluginError {
+  constructor(message, toolName, pluginName) {
+    super(message, "TOOL_EXECUTION_ERROR", pluginName);
+    this.toolName = toolName;
+    this.name = "ToolExecutionError";
+  }
+};
+
+// src/common/logger.ts
+function createConsoleLogger(prefix, minLevel = "info") {
+  const levels = ["debug", "info", "warn", "error"];
+  const shouldLog = (level) => levels.indexOf(level) >= levels.indexOf(minLevel);
+  const formatContext = (context) => {
+    if (!context) return "";
+    const entries = Object.entries(context).filter(([key]) => key !== "context").map(([key, value]) => `${key}=${JSON.stringify(value)}`).join(" ");
+    return entries ? ` ${entries}` : "";
+  };
+  return {
+    debug: (message, context) => {
+      if (shouldLog("debug")) {
+        console.debug(`[${prefix}] ${message}${formatContext(context)}`);
+      }
+    },
+    info: (message, context) => {
+      if (shouldLog("info")) {
+        console.info(`[${prefix}] ${message}${formatContext(context)}`);
+      }
+    },
+    warn: (message, context) => {
+      if (shouldLog("warn")) {
+        console.warn(`[${prefix}] ${message}${formatContext(context)}`);
+      }
+    },
+    error: (message, context, error) => {
+      if (shouldLog("error")) {
+        console.error(
+          `[${prefix}] ${message}${formatContext(context)}`,
+          error ? `
+${error.stack || error.message}` : ""
+        );
+      }
+    }
+  };
+}
+function createNoopLogger() {
+  const noop = () => {
+  };
+  return {
+    debug: noop,
+    info: noop,
+    warn: noop,
+    error: noop
+  };
+}
+
+exports.ApiKeyError = ApiKeyError;
+exports.AttachmentError = AttachmentError;
+exports.ConfigurationError = ConfigurationError;
+exports.ModelNotFoundError = ModelNotFoundError;
+exports.PluginError = PluginError;
+exports.ProviderApiError = ProviderApiError;
+exports.RateLimitError = RateLimitError;
+exports.ToolExecutionError = ToolExecutionError;
+exports.createConsoleLogger = createConsoleLogger;
+exports.createNoopLogger = createNoopLogger;
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/common/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/common/errors.ts","../../src/common/logger.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Common error types for Quilltap plugin development\n *\n * @module @quilltap/plugin-types/common/errors\n */\n\n/**\n * Base plugin error\n *\n * All plugin-specific errors should extend this class.\n */\nexport class PluginError extends Error {\n  constructor(\n    message: string,\n    public readonly code: string,\n    public readonly pluginName?: string\n  ) {\n    super(message);\n    this.name = 'PluginError';\n  }\n}\n\n/**\n * API key validation error\n *\n * Thrown when an API key is invalid or has insufficient permissions.\n */\nexport class ApiKeyError extends PluginError {\n  constructor(message: string, pluginName?: string) {\n    super(message, 'API_KEY_ERROR', pluginName);\n    this.name = 'ApiKeyError';\n  }\n}\n\n/**\n * Provider API error\n *\n * Thrown when the provider API returns an error.\n */\nexport class ProviderApiError extends PluginError {\n  constructor(\n    message: string,\n    public readonly statusCode?: number,\n    public readonly response?: unknown,\n    pluginName?: string\n  ) {\n    super(message, 'PROVIDER_API_ERROR', pluginName);\n    this.name = 'ProviderApiError';\n  }\n}\n\n/**\n * Rate limit error\n *\n * Thrown when the provider rate limits the request.\n */\nexport class RateLimitError extends ProviderApiError {\n  public override readonly code = 'RATE_LIMIT_ERROR';\n\n  constructor(\n    message: string,\n    public readonly retryAfter?: number,\n    pluginName?: string\n  ) {\n    super(message, 429, undefined, pluginName);\n    this.name = 'RateLimitError';\n  }\n}\n\n/**\n * Configuration error\n *\n * Thrown when plugin configuration is invalid.\n */\nexport class ConfigurationError extends PluginError {\n  constructor(message: string, pluginName?: string) {\n    super(message, 'CONFIGURATION_ERROR', pluginName);\n    this.name = 'ConfigurationError';\n  }\n}\n\n/**\n * Model not found error\n *\n * Thrown when a requested model is not available.\n */\nexport class ModelNotFoundError extends PluginError {\n  constructor(\n    message: string,\n    public readonly modelId?: string,\n    pluginName?: string\n  ) {\n    super(message, 'MODEL_NOT_FOUND', pluginName);\n    this.name = 'ModelNotFoundError';\n  }\n}\n\n/**\n * Attachment error\n *\n * Thrown when there's an issue processing file attachments.\n */\nexport class AttachmentError extends PluginError {\n  constructor(\n    message: string,\n    public readonly attachmentId?: string,\n    pluginName?: string\n  ) {\n    super(message, 'ATTACHMENT_ERROR', pluginName);\n    this.name = 'AttachmentError';\n  }\n}\n\n/**\n * Tool execution error\n *\n * Thrown when a tool call fails to execute.\n */\nexport class ToolExecutionError extends PluginError {\n  constructor(\n    message: string,\n    public readonly toolName?: string,\n    pluginName?: string\n  ) {\n    super(message, 'TOOL_EXECUTION_ERROR', pluginName);\n    this.name = 'ToolExecutionError';\n  }\n}\n","/**\n * Logger types for Quilltap plugin development\n *\n * @module @quilltap/plugin-types/common/logger\n */\n\n/**\n * Log level type\n */\nexport type LogLevel = 'debug' | 'info' | 'warn' | 'error';\n\n/**\n * Log context metadata\n */\nexport interface LogContext {\n  /** Context identifier (e.g., module name) */\n  context?: string;\n  /** Additional metadata */\n  [key: string]: unknown;\n}\n\n/**\n * Logger interface that plugins can implement or receive\n *\n * This interface is compatible with Quilltap's built-in logger.\n * Plugins can use this interface to accept a logger from the host\n * application or implement their own logging.\n */\nexport interface PluginLogger {\n  /**\n   * Log a debug message\n   * @param message Message to log\n   * @param context Optional context metadata\n   */\n  debug(message: string, context?: LogContext): void;\n\n  /**\n   * Log an info message\n   * @param message Message to log\n   * @param context Optional context metadata\n   */\n  info(message: string, context?: LogContext): void;\n\n  /**\n   * Log a warning message\n   * @param message Message to log\n   * @param context Optional context metadata\n   */\n  warn(message: string, context?: LogContext): void;\n\n  /**\n   * Log an error message\n   * @param message Message to log\n   * @param context Optional context metadata\n   * @param error Optional error object\n   */\n  error(message: string, context?: LogContext, error?: Error): void;\n}\n\n/**\n * Simple console-based logger for standalone plugin development\n *\n * This logger writes to the console and is useful for local\n * plugin development and testing.\n *\n * @param prefix Prefix to add to all log messages\n * @param minLevel Minimum log level to output (default: 'info')\n * @returns A PluginLogger instance\n *\n * @example\n * ```typescript\n * const logger = createConsoleLogger('my-plugin', 'debug');\n * logger.debug('Initializing plugin', { version: '1.0.0' });\n * logger.info('Plugin ready');\n * logger.error('Failed to connect', { endpoint: 'api.example.com' }, new Error('Connection refused'));\n * ```\n */\nexport function createConsoleLogger(prefix: string, minLevel: LogLevel = 'info'): PluginLogger {\n  const levels: LogLevel[] = ['debug', 'info', 'warn', 'error'];\n  const shouldLog = (level: LogLevel): boolean =>\n    levels.indexOf(level) >= levels.indexOf(minLevel);\n\n  const formatContext = (context?: LogContext): string => {\n    if (!context) return '';\n    const entries = Object.entries(context)\n      .filter(([key]) => key !== 'context')\n      .map(([key, value]) => `${key}=${JSON.stringify(value)}`)\n      .join(' ');\n    return entries ? ` ${entries}` : '';\n  };\n\n  return {\n    debug: (message: string, context?: LogContext): void => {\n      if (shouldLog('debug')) {\n        console.debug(`[${prefix}] ${message}${formatContext(context)}`);\n      }\n    },\n\n    info: (message: string, context?: LogContext): void => {\n      if (shouldLog('info')) {\n        console.info(`[${prefix}] ${message}${formatContext(context)}`);\n      }\n    },\n\n    warn: (message: string, context?: LogContext): void => {\n      if (shouldLog('warn')) {\n        console.warn(`[${prefix}] ${message}${formatContext(context)}`);\n      }\n    },\n\n    error: (message: string, context?: LogContext, error?: Error): void => {\n      if (shouldLog('error')) {\n        console.error(\n          `[${prefix}] ${message}${formatContext(context)}`,\n          error ? `\\n${error.stack || error.message}` : ''\n        );\n      }\n    },\n  };\n}\n\n/**\n * No-op logger for production or when logging is disabled\n *\n * @returns A PluginLogger that does nothing\n */\nexport function createNoopLogger(): PluginLogger {\n  const noop = (): void => {};\n  return {\n    debug: noop,\n    info: noop,\n    warn: noop,\n    error: noop,\n  };\n}\n"]}