@quilltap/plugin-utils 2.1.0 → 2.2.1

package/CHANGELOG.md

@@ -2,6 +2,15 @@
 
 All notable changes to @quilltap/plugin-utils will be documented in this file.
 
+## [2.2.0] - 2026-04-09
+
+### Removed
+
+- **Breaking:** Removed roleplay template utilities from main exports — `createRoleplayTemplatePlugin`, `createSingleTemplatePlugin`, `validateTemplateConfig`, `validateRoleplayTemplatePlugin` are no longer exported
+- Removed `./roleplay-templates` export path from package.json
+- Roleplay templates are now native first-class entities in Quilltap v4.2.0, no plugin needed
+- Updated `@quilltap/plugin-types` dependency to `^2.2.0`
+
 ## [1.4.0] - 2026-02-25
 
 ### Added

package/README.md

@@ -150,61 +150,6 @@ This gives you a complete `LLMProvider` implementation with:
 npm install openai
 ```
 
-### Roleplay Template Plugin Utilities
-
-Create roleplay template plugins with built-in validation and logging:
-
-```typescript
-import { createSingleTemplatePlugin } from '@quilltap/plugin-utils';
-
-// Simple single-template plugin
-export const plugin = createSingleTemplatePlugin({
-  templateId: 'my-rp-format',
-  displayName: 'My RP Format',
-  description: 'A custom roleplay formatting style',
-  systemPrompt: `[FORMATTING INSTRUCTIONS]
-1. DIALOGUE: Use quotation marks
-2. ACTIONS: Use asterisks *like this*
-3. THOUGHTS: Use angle brackets <like this>`,
-  tags: ['custom', 'roleplay'],
-  enableLogging: true,
-});
-```
-
-For plugins providing multiple templates:
-
-```typescript
-import { createRoleplayTemplatePlugin } from '@quilltap/plugin-utils';
-
-export const plugin = createRoleplayTemplatePlugin({
-  metadata: {
-    templateId: 'rp-format-pack',
-    displayName: 'RP Format Pack',
-    description: 'A collection of roleplay formats',
-  },
-  templates: [
-    {
-      name: 'Screenplay',
-      description: 'Screenplay-style formatting',
-      systemPrompt: '...',
-    },
-    {
-      name: 'Novel',
-      description: 'Novel-style prose',
-      systemPrompt: '...',
-    },
-  ],
-  enableLogging: true,
-});
-```
-
-| Function | Description |
-|----------|-------------|
-| `createRoleplayTemplatePlugin(options)` | Create a plugin with full control over metadata and templates |
-| `createSingleTemplatePlugin(options)` | Simplified helper for plugins with a single template |
-| `validateTemplateConfig(template)` | Validate an individual template configuration |
-| `validateRoleplayTemplatePlugin(plugin)` | Validate a complete roleplay template plugin |
-
 ### System Prompt Plugin Utilities
 
 Create system prompt plugins that provide character prompt templates from `.md` files:

package/dist/index.d.mts

@@ -1,8 +1,7 @@
-export { AnthropicToolDefinition, GoogleToolDefinition, LogContext, LogLevel, OpenAIToolDefinition, PluginLogger, ToolCall, ToolCallRequest, ToolFormatOptions, ToolResult, UniversalTool, createConsoleLogger, createNoopLogger } from '@quilltap/plugin-types';
+export { AnthropicToolDefinition, CharacterPluginDataEntry, CharacterPluginDataMap, GoogleToolDefinition, LogContext, LogLevel, OpenAIToolDefinition, PluginLogger, ToolCall, ToolCallRequest, ToolFormatOptions, ToolResult, UniversalTool, createConsoleLogger, createNoopLogger } from '@quilltap/plugin-types';
 export { T as ToolCallFormat, a as ToolConvertTarget, b as applyDescriptionLimit, c as convertFromAnthropicFormat, d as convertFromGoogleFormat, e as convertOpenAIToAnthropicFormat, f as convertOpenAIToGoogleFormat, g as convertToAnthropicFormat, h as convertToGoogleFormat, i as convertToolTo, j as convertToolsTo, k as detectToolCallFormat, l as hasToolCalls, p as parseAnthropicToolCalls, m as parseGoogleToolCalls, n as parseOpenAIToolCalls, o as parseToolCalls } from './converters-BPYo8xdH.mjs';
 export { PluginLoggerWithChild, __clearCoreLoggerFactory, __injectCoreLoggerFactory, createPluginLogger, getLogLevelFromEnv, hasCoreLogger } from './logging/index.mjs';
 export { OpenAICompatibleProvider, OpenAICompatibleProviderConfig } from './providers/index.mjs';
-export { CreateRoleplayTemplatePluginOptions, CreateSingleTemplatePluginOptions, createRoleplayTemplatePlugin, createSingleTemplatePlugin, validateRoleplayTemplatePlugin, validateTemplateConfig } from './roleplay-templates/index.mjs';
 export { CreateSystemPromptPluginOptions, createSystemPromptPlugin, validateSystemPromptPlugin } from './system-prompts/index.mjs';
 export { isVMEnvironment, resolveHostGateway, rewriteLocalhostUrl } from './host-rewrite.mjs';
 import 'openai';
@@ -135,6 +134,6 @@ declare function getQuilltapUserAgent(): string;
  * Version of the plugin-utils package.
  * Can be used at runtime to check compatibility.
  */
-declare const PLUGIN_UTILS_VERSION = "1.7.0";
+declare const PLUGIN_UTILS_VERSION = "2.2.1";
 
 export { BUILTIN_TOOL_NAMES, PLUGIN_UTILS_VERSION, __clearQuilltapVersion, __injectQuilltapVersion, getBuiltinToolNames, getQuilltapUserAgent, getQuilltapVersion };

package/dist/index.d.ts

@@ -1,8 +1,7 @@
-export { AnthropicToolDefinition, GoogleToolDefinition, LogContext, LogLevel, OpenAIToolDefinition, PluginLogger, ToolCall, ToolCallRequest, ToolFormatOptions, ToolResult, UniversalTool, createConsoleLogger, createNoopLogger } from '@quilltap/plugin-types';
+export { AnthropicToolDefinition, CharacterPluginDataEntry, CharacterPluginDataMap, GoogleToolDefinition, LogContext, LogLevel, OpenAIToolDefinition, PluginLogger, ToolCall, ToolCallRequest, ToolFormatOptions, ToolResult, UniversalTool, createConsoleLogger, createNoopLogger } from '@quilltap/plugin-types';
 export { T as ToolCallFormat, a as ToolConvertTarget, b as applyDescriptionLimit, c as convertFromAnthropicFormat, d as convertFromGoogleFormat, e as convertOpenAIToAnthropicFormat, f as convertOpenAIToGoogleFormat, g as convertToAnthropicFormat, h as convertToGoogleFormat, i as convertToolTo, j as convertToolsTo, k as detectToolCallFormat, l as hasToolCalls, p as parseAnthropicToolCalls, m as parseGoogleToolCalls, n as parseOpenAIToolCalls, o as parseToolCalls } from './converters-BPYo8xdH.js';
 export { PluginLoggerWithChild, __clearCoreLoggerFactory, __injectCoreLoggerFactory, createPluginLogger, getLogLevelFromEnv, hasCoreLogger } from './logging/index.js';
 export { OpenAICompatibleProvider, OpenAICompatibleProviderConfig } from './providers/index.js';
-export { CreateRoleplayTemplatePluginOptions, CreateSingleTemplatePluginOptions, createRoleplayTemplatePlugin, createSingleTemplatePlugin, validateRoleplayTemplatePlugin, validateTemplateConfig } from './roleplay-templates/index.js';
 export { CreateSystemPromptPluginOptions, createSystemPromptPlugin, validateSystemPromptPlugin } from './system-prompts/index.js';
 export { isVMEnvironment, resolveHostGateway, rewriteLocalhostUrl } from './host-rewrite.js';
 import 'openai';
@@ -135,6 +134,6 @@ declare function getQuilltapUserAgent(): string;
  * Version of the plugin-utils package.
  * Can be used at runtime to check compatibility.
  */
-declare const PLUGIN_UTILS_VERSION = "1.7.0";
+declare const PLUGIN_UTILS_VERSION = "2.2.1";
 
 export { BUILTIN_TOOL_NAMES, PLUGIN_UTILS_VERSION, __clearQuilltapVersion, __injectQuilltapVersion, getBuiltinToolNames, getQuilltapUserAgent, getQuilltapVersion };

package/dist/index.js

@@ -49,8 +49,6 @@ __export(src_exports, {
   createConsoleLogger: () => import_plugin_types.createConsoleLogger,
   createNoopLogger: () => import_plugin_types.createNoopLogger,
   createPluginLogger: () => createPluginLogger,
-  createRoleplayTemplatePlugin: () => createRoleplayTemplatePlugin,
-  createSingleTemplatePlugin: () => createSingleTemplatePlugin,
   createSystemPromptPlugin: () => createSystemPromptPlugin,
   detectToolCallFormat: () => detectToolCallFormat,
   getBuiltinToolNames: () => getBuiltinToolNames,
@@ -66,9 +64,7 @@ __export(src_exports, {
   parseToolCalls: () => parseToolCalls,
   resolveHostGateway: () => resolveHostGateway,
   rewriteLocalhostUrl: () => rewriteLocalhostUrl,
-  validateRoleplayTemplatePlugin: () => validateRoleplayTemplatePlugin,
-  validateSystemPromptPlugin: () => validateSystemPromptPlugin,
-  validateTemplateConfig: () => validateTemplateConfig
+  validateSystemPromptPlugin: () => validateSystemPromptPlugin
 });
 module.exports = __toCommonJS(src_exports);
 
@@ -689,135 +685,6 @@ var OpenAICompatibleProvider = class {
   }
 };
 
-// src/roleplay-templates/builder.ts
-function createRoleplayTemplatePlugin(options) {
-  const { metadata, templates, initialize, enableLogging: _enableLogging = false } = options;
-  const templateArray = Array.isArray(templates) ? templates : [templates];
-  if (templateArray.length === 0) {
-    throw new Error("At least one template is required");
-  }
-  for (const template of templateArray) {
-    if (!template.name || template.name.trim() === "") {
-      throw new Error("Template name is required");
-    }
-    if (!template.systemPrompt || template.systemPrompt.trim() === "") {
-      throw new Error(`Template "${template.name}" requires a systemPrompt`);
-    }
-  }
-  const plugin = {
-    metadata: {
-      ...metadata,
-      // Ensure tags from templates are included in metadata if not already set
-      tags: metadata.tags ?? Array.from(
-        new Set(templateArray.flatMap((t) => t.tags ?? []))
-      )
-    },
-    templates: templateArray
-  };
-  if (initialize) {
-    plugin.initialize = async () => {
-      await initialize();
-    };
-  }
-  return plugin;
-}
-function createSingleTemplatePlugin(options) {
-  const {
-    templateId,
-    displayName,
-    description,
-    systemPrompt,
-    author,
-    tags,
-    narrationDelimiters,
-    version,
-    initialize,
-    enableLogging
-  } = options;
-  return createRoleplayTemplatePlugin({
-    metadata: {
-      templateId,
-      displayName,
-      description,
-      author,
-      tags,
-      version
-    },
-    templates: {
-      name: displayName,
-      description,
-      systemPrompt,
-      tags,
-      narrationDelimiters
-    },
-    initialize,
-    enableLogging
-  });
-}
-function validateTemplateConfig(template) {
-  if (!template.name || template.name.trim() === "") {
-    throw new Error("Template name is required");
-  }
-  if (template.name.length > 100) {
-    throw new Error("Template name must be 100 characters or less");
-  }
-  if (!template.systemPrompt || template.systemPrompt.trim() === "") {
-    throw new Error("Template systemPrompt is required");
-  }
-  if (template.description && template.description.length > 500) {
-    throw new Error("Template description must be 500 characters or less");
-  }
-  if (template.tags) {
-    if (!Array.isArray(template.tags)) {
-      throw new Error("Template tags must be an array");
-    }
-    for (const tag of template.tags) {
-      if (typeof tag !== "string") {
-        throw new Error("All tags must be strings");
-      }
-    }
-  }
-  if (!template.narrationDelimiters) {
-    throw new Error("Template narrationDelimiters is required");
-  }
-  if (typeof template.narrationDelimiters === "string") {
-    if (template.narrationDelimiters.length === 0) {
-      throw new Error("Template narrationDelimiters string must not be empty");
-    }
-  } else if (Array.isArray(template.narrationDelimiters)) {
-    if (template.narrationDelimiters.length !== 2) {
-      throw new Error("Template narrationDelimiters array must have exactly 2 elements [open, close]");
-    }
-    if (!template.narrationDelimiters[0] || !template.narrationDelimiters[1]) {
-      throw new Error("Template narrationDelimiters array elements must not be empty");
-    }
-  } else {
-    throw new Error("Template narrationDelimiters must be a string or [string, string] tuple");
-  }
-  return true;
-}
-function validateRoleplayTemplatePlugin(plugin) {
-  if (!plugin.metadata) {
-    throw new Error("Plugin metadata is required");
-  }
-  if (!plugin.metadata.templateId || plugin.metadata.templateId.trim() === "") {
-    throw new Error("Plugin metadata.templateId is required");
-  }
-  if (!/^[a-z0-9-]+$/.test(plugin.metadata.templateId)) {
-    throw new Error("Plugin templateId must be lowercase alphanumeric with hyphens only");
-  }
-  if (!plugin.metadata.displayName || plugin.metadata.displayName.trim() === "") {
-    throw new Error("Plugin metadata.displayName is required");
-  }
-  if (!plugin.templates || !Array.isArray(plugin.templates) || plugin.templates.length === 0) {
-    throw new Error("Plugin must have at least one template");
-  }
-  for (const template of plugin.templates) {
-    validateTemplateConfig(template);
-  }
-  return true;
-}
-
 // src/system-prompts/builder.ts
 function createSystemPromptPlugin(options) {
   const { metadata, prompts, initialize } = options;
@@ -1040,7 +907,7 @@ function rewriteLocalhostUrl(url) {
 }
 
 // src/index.ts
-var PLUGIN_UTILS_VERSION = "1.7.0";
+var PLUGIN_UTILS_VERSION = "2.2.1";
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   BUILTIN_TOOL_NAMES,
@@ -1062,8 +929,6 @@ var PLUGIN_UTILS_VERSION = "1.7.0";
   createConsoleLogger,
   createNoopLogger,
   createPluginLogger,
-  createRoleplayTemplatePlugin,
-  createSingleTemplatePlugin,
   createSystemPromptPlugin,
   detectToolCallFormat,
   getBuiltinToolNames,
@@ -1079,8 +944,6 @@ var PLUGIN_UTILS_VERSION = "1.7.0";
   parseToolCalls,
   resolveHostGateway,
   rewriteLocalhostUrl,
-  validateRoleplayTemplatePlugin,
-  validateSystemPromptPlugin,
-  validateTemplateConfig
+  validateSystemPromptPlugin
 });
 //# sourceMappingURL=index.js.map