@quilltap/plugin-utils 2.2.17 → 2.2.19

package/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 All notable changes to @quilltap/plugin-utils will be documented in this file.
 
+## [2.2.19] - 2026-08-03
+
+### Fixed
+
+- `PLUGIN_UTILS_VERSION` no longer drifts from the published version. The constant was a hand-written literal and had been stale since 2.2.1 while the package shipped 2.2.18, so any consumer using it for a runtime compatibility check got a wrong answer. It is now generated into `src/version.generated.ts` from the `version` field in package.json by `scripts/generate-version.mjs`, which runs from `prebuild` and `pretypecheck` — bumping package.json is the only step. Both the runtime value and the literal type in `dist/index.d.ts` follow automatically.
+
 ## [2.2.0] - 2026-04-09
 
 ### Removed

package/dist/index.d.mts

@@ -1,7 +1,7 @@
 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 { DEFAULT_REQUEST_TIMEOUT_MS, OpenAICompatibleProvider, OpenAICompatibleProviderConfig, buildRequestAbortSignal, buildSdkClientOptions, buildSdkRequestOptions, resolveRequestTimeoutMs } from './providers/index.mjs';
 export { CreateSystemPromptPluginOptions, createSystemPromptPlugin, validateSystemPromptPlugin } from './system-prompts/index.mjs';
 export { isVMEnvironment, resolveHostGateway, rewriteLocalhostUrl } from './host-rewrite.mjs';
 import 'openai';
@@ -114,25 +114,16 @@ declare function getQuilltapVersion(): string;
 declare function getQuilltapUserAgent(): string;
 
 /**
- * @quilltap/plugin-utils
+ * GENERATED FILE — DO NOT EDIT.
  *
- * Utility functions for Quilltap plugin development.
- *
- * This package provides runtime utilities that complement the type definitions
- * in @quilltap/plugin-types. It includes:
- *
- * - **Tool Parsing**: Parse tool calls from any LLM provider's response format
- * - **Tool Conversion**: Convert between OpenAI, Anthropic, and Google tool formats
- * - **Logger Bridge**: Logging that integrates with Quilltap's core or runs standalone
- *
- * @packageDocumentation
- * @module @quilltap/plugin-utils
+ * Written by scripts/generate-version.mjs from the "version" field in
+ * package.json. Bump the version there; this file follows automatically on
+ * `npm run build` / `npm run typecheck`.
  */
-
 /**
  * Version of the plugin-utils package.
  * Can be used at runtime to check compatibility.
  */
-declare const PLUGIN_UTILS_VERSION = "2.2.1";
+declare const PLUGIN_UTILS_VERSION = "2.2.19";
 
 export { BUILTIN_TOOL_NAMES, PLUGIN_UTILS_VERSION, __clearQuilltapVersion, __injectQuilltapVersion, getBuiltinToolNames, getQuilltapUserAgent, getQuilltapVersion };

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 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 { DEFAULT_REQUEST_TIMEOUT_MS, OpenAICompatibleProvider, OpenAICompatibleProviderConfig, buildRequestAbortSignal, buildSdkClientOptions, buildSdkRequestOptions, resolveRequestTimeoutMs } from './providers/index.js';
 export { CreateSystemPromptPluginOptions, createSystemPromptPlugin, validateSystemPromptPlugin } from './system-prompts/index.js';
 export { isVMEnvironment, resolveHostGateway, rewriteLocalhostUrl } from './host-rewrite.js';
 import 'openai';
@@ -114,25 +114,16 @@ declare function getQuilltapVersion(): string;
 declare function getQuilltapUserAgent(): string;
 
 /**
- * @quilltap/plugin-utils
+ * GENERATED FILE — DO NOT EDIT.
  *
- * Utility functions for Quilltap plugin development.
- *
- * This package provides runtime utilities that complement the type definitions
- * in @quilltap/plugin-types. It includes:
- *
- * - **Tool Parsing**: Parse tool calls from any LLM provider's response format
- * - **Tool Conversion**: Convert between OpenAI, Anthropic, and Google tool formats
- * - **Logger Bridge**: Logging that integrates with Quilltap's core or runs standalone
- *
- * @packageDocumentation
- * @module @quilltap/plugin-utils
+ * Written by scripts/generate-version.mjs from the "version" field in
+ * package.json. Bump the version there; this file follows automatically on
+ * `npm run build` / `npm run typecheck`.
  */
-
 /**
  * Version of the plugin-utils package.
  * Can be used at runtime to check compatibility.
  */
-declare const PLUGIN_UTILS_VERSION = "2.2.1";
+declare const PLUGIN_UTILS_VERSION = "2.2.19";
 
 export { BUILTIN_TOOL_NAMES, PLUGIN_UTILS_VERSION, __clearQuilltapVersion, __injectQuilltapVersion, getBuiltinToolNames, getQuilltapUserAgent, getQuilltapVersion };

package/dist/index.js

@@ -31,6 +31,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var src_exports = {};
 __export(src_exports, {
   BUILTIN_TOOL_NAMES: () => BUILTIN_TOOL_NAMES,
+  DEFAULT_REQUEST_TIMEOUT_MS: () => DEFAULT_REQUEST_TIMEOUT_MS,
   OpenAICompatibleProvider: () => OpenAICompatibleProvider,
   PLUGIN_UTILS_VERSION: () => PLUGIN_UTILS_VERSION,
   __clearCoreLoggerFactory: () => __clearCoreLoggerFactory,
@@ -38,6 +39,9 @@ __export(src_exports, {
   __injectCoreLoggerFactory: () => __injectCoreLoggerFactory,
   __injectQuilltapVersion: () => __injectQuilltapVersion,
   applyDescriptionLimit: () => applyDescriptionLimit,
+  buildRequestAbortSignal: () => buildRequestAbortSignal,
+  buildSdkClientOptions: () => buildSdkClientOptions,
+  buildSdkRequestOptions: () => buildSdkRequestOptions,
   convertFromAnthropicFormat: () => convertFromAnthropicFormat,
   convertFromGoogleFormat: () => convertFromGoogleFormat,
   convertOpenAIToAnthropicFormat: () => convertOpenAIToAnthropicFormat,
@@ -63,6 +67,7 @@ __export(src_exports, {
   parseOpenAIToolCalls: () => parseOpenAIToolCalls,
   parseToolCalls: () => parseToolCalls,
   resolveHostGateway: () => resolveHostGateway,
+  resolveRequestTimeoutMs: () => resolveRequestTimeoutMs,
   rewriteLocalhostUrl: () => rewriteLocalhostUrl,
   validateSystemPromptPlugin: () => validateSystemPromptPlugin
 });
@@ -400,8 +405,29 @@ function getQuilltapUserAgent() {
   return `Quilltap/${getQuilltapVersion()}`;
 }
 
-// src/providers/openai-compatible.ts
+// src/providers/request-budget.ts
 var DEFAULT_REQUEST_TIMEOUT_MS = 3e5;
+function resolveRequestTimeoutMs(params, defaultMs = DEFAULT_REQUEST_TIMEOUT_MS) {
+  const requested = params.requestTimeoutMs;
+  return typeof requested === "number" && requested > 0 ? requested : defaultMs;
+}
+function buildSdkRequestOptions(params) {
+  const requested = params.requestTimeoutMs;
+  if (typeof requested !== "number" || requested <= 0) return void 0;
+  return { timeout: requested, maxRetries: 0 };
+}
+function buildSdkClientOptions(params, defaultMs = DEFAULT_REQUEST_TIMEOUT_MS) {
+  const capped = typeof params.requestTimeoutMs === "number" && params.requestTimeoutMs > 0;
+  return {
+    timeout: resolveRequestTimeoutMs(params, defaultMs),
+    maxRetries: capped ? 0 : 2
+  };
+}
+function buildRequestAbortSignal(params, defaultMs = DEFAULT_REQUEST_TIMEOUT_MS) {
+  return AbortSignal.timeout(resolveRequestTimeoutMs(params, defaultMs));
+}
+
+// src/providers/openai-compatible.ts
 var DEFAULT_MAX_RETRIES = 2;
 var OpenAICompatibleProvider = class {
   /**
@@ -501,10 +527,7 @@ var OpenAICompatibleProvider = class {
    * @returns Request options for the OpenAI SDK, or undefined to use defaults
    */
   buildRequestOptions(params) {
-    if (typeof params.requestTimeoutMs !== "number" || params.requestTimeoutMs <= 0) {
-      return void 0;
-    }
-    return { timeout: params.requestTimeoutMs, maxRetries: 0 };
+    return buildSdkRequestOptions(params);
   }
   /**
    * Sends a message and returns the complete response.
@@ -953,11 +976,12 @@ function rewriteLocalhostUrl(url) {
   return rewritten;
 }
 
-// src/index.ts
-var PLUGIN_UTILS_VERSION = "2.2.1";
+// src/version.generated.ts
+var PLUGIN_UTILS_VERSION = "2.2.19";
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   BUILTIN_TOOL_NAMES,
+  DEFAULT_REQUEST_TIMEOUT_MS,
   OpenAICompatibleProvider,
   PLUGIN_UTILS_VERSION,
   __clearCoreLoggerFactory,
@@ -965,6 +989,9 @@ var PLUGIN_UTILS_VERSION = "2.2.1";
   __injectCoreLoggerFactory,
   __injectQuilltapVersion,
   applyDescriptionLimit,
+  buildRequestAbortSignal,
+  buildSdkClientOptions,
+  buildSdkRequestOptions,
   convertFromAnthropicFormat,
   convertFromGoogleFormat,
   convertOpenAIToAnthropicFormat,
@@ -990,6 +1017,7 @@ var PLUGIN_UTILS_VERSION = "2.2.1";
   parseOpenAIToolCalls,
   parseToolCalls,
   resolveHostGateway,
+  resolveRequestTimeoutMs,
   rewriteLocalhostUrl,
   validateSystemPromptPlugin
 });