promptopskit 0.9.0 → 0.9.1

package/README.md

@@ -5,17 +5,30 @@
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
 [![Node.js](https://img.shields.io/badge/node-%3E%3D20-brightgreen.svg)](https://nodejs.org)
 
-**Turn hardcoded AI prompts into versioned, tested application assets.**
+**Prompts are becoming production code. Manage them that way.**
 
-Your prompts are already in Git. PromptOpsKit makes them manageable.
+AI features often start with a few prompt strings. Then model settings, tools, provider quirks, context limits, environment overrides, tests, and customer-specific behavior start spreading across the codebase.
 
-Keep prompts, model settings, tools, input validation, shared instructions, environment overrides, and tests together in Markdown files that live in Git and ship with your app. Render provider-ready request bodies without giving up your SDK, gateway, auth, retries, routing, observability, or billing.
+PromptOpsKit is an open-source toolkit for turning hardcoded AI prompts into versioned, tested application assets. Keep prompts, model settings, tools, input validation, shared instructions, environment overrides, and tests together in Markdown files that live in Git and ship with your app.
+
+No hosted dashboard. No gateway required. No vendor lock-in. Render provider-ready request bodies while keeping your SDK, auth, routing, retries, observability, and billing.
 
 PromptOpsKit is not a prompt dashboard, LLM gateway, or hosted runtime service. It is the repo-native layer between scattered prompt strings and production AI calls.
 
+## Where this fits in the AI production stack
+
+PromptOpsKit handles the open-source prompt asset layer: prompts, model settings, tools, input rules, overrides, and tests in Git.
+
+As AI features grow, adjacent production concerns usually appear:
+
+- **Provider operations** — routing, caching, cost controls, customer attribution, and gateway reliability. See LLMAsAService.
+- **Customer usage and billing** — usage metering, entitlements, limits, alerts, and usage-based billing. See UsageTap.
+
+PromptOpsKit does not require either service. It keeps the prompt layer repo-native and transport-light so teams can adopt the rest of their AI production stack when they need it.
+
 ## Why PromptOpsKit?
 
-From scattered prompt glue:
+When prototypes become real product features, prompt glue is hard to review and easy to drift:
 
 - Prompt strings live inline in code
 - Model config and tools drift in separate files
@@ -23,7 +36,7 @@ From scattered prompt glue:
 - Environment logic hides in if/else branches
 - Testing is ad hoc and hard to review
 
-To one reviewable asset:
+PromptOpsKit turns that behavior into one reviewable asset:
 
 - Prompt, model, tools, and input rules live together
 - `includes` and `defaults.md` avoid copy-paste drift

package/dist/{chunk-W6XHGSPJ.js → chunk-7GMCNHXJ.js}

@@ -1,11 +1,11 @@
 import {
   openaiAdapter
-} from "./chunk-SVNQNMMV.js";
+} from "./chunk-C5HHTLZX.js";
 import {
   applyRawProviderBody,
   resolveAssetForProvider,
   withPromptInputSupport
-} from "./chunk-NS6OTKY2.js";
+} from "./chunk-QZHR2YMK.js";
 
 // src/providers/llmasaservice.ts
 var LLMASASERVICE_BASE_URL = "https://gateway.llmasaservice.io";
@@ -127,4 +127,4 @@ export {
   createLLMAsAServiceOpenAIConfig,
   llmasaserviceAdapter
 };
-//# sourceMappingURL=chunk-W6XHGSPJ.js.map
+//# sourceMappingURL=chunk-7GMCNHXJ.js.map

package/dist/{chunk-SVNQNMMV.js → chunk-C5HHTLZX.js}

@@ -4,7 +4,7 @@ import {
   renderSections,
   resolveAssetForProvider,
   withPromptInputSupport
-} from "./chunk-NS6OTKY2.js";
+} from "./chunk-QZHR2YMK.js";
 
 // src/providers/openai.ts
 var openaiAdapter = withPromptInputSupport({
@@ -107,4 +107,4 @@ var openaiAdapter = withPromptInputSupport({
 export {
   openaiAdapter
 };
-//# sourceMappingURL=chunk-SVNQNMMV.js.map
+//# sourceMappingURL=chunk-C5HHTLZX.js.map

package/dist/{chunk-Q67E2GGD.js → chunk-D23T3X4V.js}

@@ -4,7 +4,7 @@ import {
   renderSections,
   resolveAssetForProvider,
   withPromptInputSupport
-} from "./chunk-NS6OTKY2.js";
+} from "./chunk-QZHR2YMK.js";
 
 // src/providers/anthropic.ts
 var anthropicAdapter = withPromptInputSupport({
@@ -144,4 +144,4 @@ var anthropicAdapter = withPromptInputSupport({
 export {
   anthropicAdapter
 };
-//# sourceMappingURL=chunk-Q67E2GGD.js.map
+//# sourceMappingURL=chunk-D23T3X4V.js.map

package/dist/{chunk-AAQNCAVA.js → chunk-EDHPVR2F.js}

@@ -1,11 +1,11 @@
 import {
   openaiAdapter
-} from "./chunk-SVNQNMMV.js";
+} from "./chunk-C5HHTLZX.js";
 import {
   applyRawProviderBody,
   resolveAssetForProvider,
   withPromptInputSupport
-} from "./chunk-NS6OTKY2.js";
+} from "./chunk-QZHR2YMK.js";
 
 // src/providers/openrouter.ts
 var openrouterAdapter = withPromptInputSupport({
@@ -58,4 +58,4 @@ var openrouterAdapter = withPromptInputSupport({
 export {
   openrouterAdapter
 };
-//# sourceMappingURL=chunk-AAQNCAVA.js.map
+//# sourceMappingURL=chunk-EDHPVR2F.js.map

package/dist/{chunk-FJ3D76IV.js → chunk-O3SRIDTH.js}

@@ -4,7 +4,7 @@ import {
   renderSections,
   resolveAssetForProvider,
   withPromptInputSupport
-} from "./chunk-NS6OTKY2.js";
+} from "./chunk-QZHR2YMK.js";
 
 // src/providers/gemini.ts
 var geminiAdapter = withPromptInputSupport({
@@ -120,4 +120,4 @@ var geminiAdapter = withPromptInputSupport({
 export {
   geminiAdapter
 };
-//# sourceMappingURL=chunk-FJ3D76IV.js.map
+//# sourceMappingURL=chunk-O3SRIDTH.js.map

package/dist/{chunk-E2AIIPQC.js → chunk-QHAIOVQ3.js}

@@ -4,7 +4,7 @@ import {
   renderSections,
   resolveAssetForProvider,
   withPromptInputSupport
-} from "./chunk-NS6OTKY2.js";
+} from "./chunk-QZHR2YMK.js";
 
 // src/providers/openai-responses.ts
 var openaiResponsesAdapter = withPromptInputSupport({
@@ -112,4 +112,4 @@ var openaiResponsesAdapter = withPromptInputSupport({
 export {
   openaiResponsesAdapter
 };
-//# sourceMappingURL=chunk-E2AIIPQC.js.map
+//# sourceMappingURL=chunk-QHAIOVQ3.js.map

package/dist/{chunk-NS6OTKY2.js → chunk-QZHR2YMK.js}

@@ -1726,10 +1726,29 @@ async function compressWithTheTokenCompany(input, options) {
     );
   }
   const data = await response.json();
-  if (typeof data.output !== "string" || typeof data.output_tokens !== "number" || typeof data.input_tokens !== "number" || typeof data.tokens_saved !== "number" || typeof data.compression_ratio !== "number") {
+  const normalized = normalizeTheTokenCompanyCompressResponse(data);
+  if (!normalized) {
     throw new Error("TheTokenCompany compression returned an invalid response payload.");
   }
-  return data;
+  return normalized;
+}
+function normalizeTheTokenCompanyCompressResponse(data) {
+  if (typeof data.output !== "string" || typeof data.output_tokens !== "number") {
+    return void 0;
+  }
+  const inputTokens = typeof data.input_tokens === "number" ? data.input_tokens : data.original_input_tokens;
+  if (typeof inputTokens !== "number") {
+    return void 0;
+  }
+  const tokensSaved = typeof data.tokens_saved === "number" ? data.tokens_saved : inputTokens - data.output_tokens;
+  const compressionRatio = typeof data.compression_ratio === "number" ? data.compression_ratio : data.output_tokens === 0 ? 0 : inputTokens / data.output_tokens;
+  return {
+    output: data.output,
+    output_tokens: data.output_tokens,
+    input_tokens: inputTokens,
+    tokens_saved: tokensSaved,
+    compression_ratio: compressionRatio
+  };
 }
 function getEnv(name) {
   if (typeof process === "undefined") {
@@ -1838,4 +1857,4 @@ export {
   withPromptInputSupport,
   applyRawProviderBody
 };
-//# sourceMappingURL=chunk-NS6OTKY2.js.map
+//# sourceMappingURL=chunk-QZHR2YMK.js.map