promptopskit 0.9.1 → 0.10.0

package/dist/index.cjs

@@ -33,7 +33,6 @@ __export(src_exports, {
   LLMASASERVICE_BASE_URL: () => LLMASASERVICE_BASE_URL,
   LLMASASERVICE_DEFAULT_MODEL: () => LLMASASERVICE_DEFAULT_MODEL,
   LLMASASERVICE_RESPONSE_HEADER_NAMES: () => LLMASASERVICE_RESPONSE_HEADER_NAMES,
-  LLMASASERVICE_SDK_PLACEHOLDER_API_KEY: () => LLMASASERVICE_SDK_PLACEHOLDER_API_KEY,
   PromptAssetOverridesSchema: () => PromptAssetOverridesSchema,
   PromptAssetSchema: () => PromptAssetSchema,
   PromptOpsKit: () => PromptOpsKit,
@@ -1480,6 +1479,7 @@ var LLMAsAServiceCustomerSchema = import_zod.z.object({
 });
 var LLMAsAServiceProviderOptionsSchema = import_zod.z.object({
   base_url: import_zod.z.string().url().optional(),
+  // Deprecated compatibility fields; the gateway no longer requires project routing.
   project_id: import_zod.z.string().optional(),
   customer: LLMAsAServiceCustomerSchema.optional(),
   conversationId: import_zod.z.string().optional(),
@@ -2536,6 +2536,7 @@ async function applyPromptCompressionForRender(asset, runtime) {
       aggressiveness: theTokenCompanyConfig?.aggressiveness
     });
     promptTemplate = result.output;
+    warnings.push(...result.warnings ?? []);
     compression.push({
       provider: "thetokencompany",
       model,
@@ -2601,41 +2602,80 @@ function reportHeuristicCompressionWarnings2(warnings, compressionWarnings, scop
 async function compressWithTheTokenCompany(input, options) {
   const apiKey = options.apiKey ?? getEnv("THETOKENCOMPANY_API_KEY") ?? getEnv("TTC_API_KEY");
   if (!apiKey) {
-    throw new Error(
-      "TheTokenCompany compression is enabled, but no API key was provided. Pass theTokenCompany.apiKey to renderPrompt() or set THETOKENCOMPANY_API_KEY."
+    return createTheTokenCompanyFallback(
+      input,
+      "no API key was provided"
     );
   }
   const fetchImpl = options.fetch ?? globalThis.fetch;
   if (!fetchImpl) {
-    throw new Error("TheTokenCompany compression requires a runtime with fetch support.");
+    return createTheTokenCompanyFallback(
+      input,
+      "fetch is unavailable in this runtime"
+    );
   }
   const baseURL = (options.baseURL ?? THETOKENCOMPANY_DEFAULT_BASE_URL).replace(/\/+$/, "");
   const compressionSettings = options.aggressiveness === void 0 ? void 0 : { aggressiveness: options.aggressiveness };
-  const response = await fetchImpl(`${baseURL}/v1/compress`, {
-    method: "POST",
-    headers: {
-      Authorization: `Bearer ${apiKey}`,
-      "Content-Type": "application/json"
-    },
-    body: JSON.stringify({
-      model: options.model,
+  let response;
+  try {
+    response = await fetchImpl(`${baseURL}/v1/compress`, {
+      method: "POST",
+      headers: {
+        Authorization: `Bearer ${apiKey}`,
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify({
+        model: options.model,
+        input,
+        ...compressionSettings ? { compression_settings: compressionSettings } : {}
+      })
+    });
+  } catch (error) {
+    return createTheTokenCompanyFallback(
       input,
-      ...compressionSettings ? { compression_settings: compressionSettings } : {}
-    })
-  });
+      `request failed: ${toErrorMessage(error)}`
+    );
+  }
   if (!response.ok) {
-    const body = await response.text().catch(() => "");
-    throw new Error(
-      `TheTokenCompany compression failed with HTTP ${response.status}` + (body ? `: ${body}` : ".")
+    return createTheTokenCompanyFallback(
+      input,
+      `service returned HTTP ${response.status}`
+    );
+  }
+  let data;
+  try {
+    data = await response.json();
+  } catch (error) {
+    return createTheTokenCompanyFallback(
+      input,
+      `response body was not valid JSON: ${toErrorMessage(error)}`
     );
   }
-  const data = await response.json();
   const normalized = normalizeTheTokenCompanyCompressResponse(data);
   if (!normalized) {
-    throw new Error("TheTokenCompany compression returned an invalid response payload.");
+    return createTheTokenCompanyFallback(
+      input,
+      "response payload was invalid"
+    );
   }
   return normalized;
 }
+function createTheTokenCompanyFallback(input, reason) {
+  const tokens = estimateHeuristicTokens(input);
+  return {
+    output: input,
+    output_tokens: tokens,
+    input_tokens: tokens,
+    tokens_saved: 0,
+    compression_ratio: tokens === 0 ? 0 : 1,
+    warnings: [
+      `POK057: TheTokenCompany compression skipped; using uncompressed prompt with zero token savings (${reason}).`
+    ]
+  };
+}
+function toErrorMessage(error) {
+  return error instanceof Error && error.message ? error.message : "unknown error";
+}
 function normalizeTheTokenCompanyCompressResponse(data) {
   if (typeof data.output !== "string" || typeof data.output_tokens !== "number") {
     return void 0;
@@ -3232,20 +3272,17 @@ var openrouterAdapter = withPromptInputSupport({
 
 // src/providers/llmasaservice.ts
 var LLMASASERVICE_BASE_URL = "https://gateway.llmasaservice.io";
-var LLMASASERVICE_SDK_PLACEHOLDER_API_KEY = "not-used-by-llm-gateway";
 var LLMASASERVICE_DEFAULT_MODEL = "group:standard";
 var LLMASASERVICE_RESPONSE_HEADER_NAMES = [
   "x-request-id",
   "x-llm-model-id",
   "x-llm-model-group"
 ];
-function createLLMAsAServiceOpenAIConfig(options = {}) {
+function createLLMAsAServiceOpenAIConfig(options) {
   return {
     baseURL: options.baseURL ?? LLMASASERVICE_BASE_URL,
-    apiKey: LLMASASERVICE_SDK_PLACEHOLDER_API_KEY,
-    defaultHeaders: {
-      "x-project-id": options.projectId ?? ""
-    }
+    apiKey: options.apiKey,
+    ...options.projectId ? { defaultHeaders: { "x-project-id": options.projectId } } : {}
   };
 }
 function isGPT5ModelSelector(model) {
@@ -3262,9 +3299,6 @@ function rawCustomerId(asset) {
   const customer = isRecord(asset.raw?.llmasaservice?.customer) ? asset.raw.llmasaservice.customer : void 0;
   return customer?.customer_id;
 }
-function isGatewayRenderValidation(runtime) {
-  return runtime?.runtime !== void 0;
-}
 var llmasaserviceAdapter = withPromptInputSupport({
   name: "llmasaservice",
   validate(asset, runtime) {
@@ -3281,12 +3315,12 @@ var llmasaserviceAdapter = withPromptInputSupport({
     );
     const errors = [...validation.errors];
     const gatewayOptions = resolvedAsset.provider_options?.llmasaservice;
-    const missingProjectId = !gatewayOptions?.project_id;
+    const missingApiKey = !runtime?.llmasaservice?.apiKey;
     const missingCustomerId = !gatewayOptions?.customer?.customer_id && typeof rawCustomerId(resolvedAsset) !== "string";
-    const validateRenderMetadata = isGatewayRenderValidation(runtime);
-    if (missingProjectId && validateRenderMetadata) {
+    const validateRenderMetadata = runtime !== void 0;
+    if (missingApiKey && validateRenderMetadata) {
       errors.push(
-        "LLMAsAService adapter requires provider_options.llmasaservice.project_id for x-project-id routing."
+        "LLMAsAService adapter requires llmasaservice.apiKey for Authorization Bearer authentication."
       );
     }
     if (missingCustomerId && validateRenderMetadata) {
@@ -3294,9 +3328,9 @@ var llmasaserviceAdapter = withPromptInputSupport({
         "LLMAsAService adapter requires customer.customer_id in provider_options.llmasaservice.customer or raw.llmasaservice.customer."
       );
     }
-    if ((missingProjectId || missingCustomerId) && !validateRenderMetadata) {
+    if ((missingApiKey || missingCustomerId) && !validateRenderMetadata) {
       warnings.push(
-        "LLMAsAService project_id and customer.customer_id must be supplied before rendering, usually through runtime provider_options."
+        "LLMAsAService apiKey and customer.customer_id must be supplied before rendering."
       );
     }
     return {
@@ -3329,14 +3363,21 @@ var llmasaserviceAdapter = withPromptInputSupport({
     if (options?.conversationTitle !== void 0) body.conversationTitle = options.conversationTitle;
     if (options?.projectId !== void 0) body.projectId = options.projectId;
     body = applyRawProviderBody(body, resolvedAsset, "llmasaservice");
-    const projectId = options?.project_id ?? "";
+    const apiKey = runtime.llmasaservice?.apiKey;
+    if (!apiKey) {
+      throw new Error(
+        "LLMAsAService adapter requires llmasaservice.apiKey for Authorization Bearer authentication."
+      );
+    }
+    const projectId = options?.project_id;
     return {
       body,
       provider: "llmasaservice",
       model,
       baseURL: options?.base_url ?? LLMASASERVICE_BASE_URL,
       headers: {
-        "x-project-id": projectId
+        Authorization: `Bearer ${apiKey}`,
+        ...projectId ? { "x-project-id": projectId } : {}
       }
     };
   }
@@ -4188,7 +4229,8 @@ var PromptOpsKit = class {
     }
     const adapter = getAdapter(options.provider);
     const validation = adapter.validate(resolved, {
-      openaiResponses: options.openaiResponses
+      openaiResponses: options.openaiResponses,
+      llmasaservice: options.llmasaservice
     });
     if (!validation.valid) {
       throw new Error(
@@ -4225,6 +4267,7 @@ var PromptOpsKit = class {
       toolRegistry: options.toolRegistry,
       strict: options.strict,
       openaiResponses: options.openaiResponses,
+      llmasaservice: options.llmasaservice,
       theTokenCompany: options.theTokenCompany
     });
     const request = adapter.render(prepared.asset, prepared.runtime);
@@ -4298,7 +4341,6 @@ async function renderPrompt(options) {
   LLMASASERVICE_BASE_URL,
   LLMASASERVICE_DEFAULT_MODEL,
   LLMASASERVICE_RESPONSE_HEADER_NAMES,
-  LLMASASERVICE_SDK_PLACEHOLDER_API_KEY,
   PromptAssetOverridesSchema,
   PromptAssetSchema,
   PromptOpsKit,