@posthog/ai 7.15.0 → 7.16.0

package/dist/anthropic/index.cjs

@@ -10,7 +10,7 @@ function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
 
 var AnthropicOriginal__default = /*#__PURE__*/_interopDefault(AnthropicOriginal);
 
-var version = "7.15.0";
+var version = "7.16.0";
 
 // Type guards for safer type checking
 

package/dist/anthropic/index.mjs

@@ -2,7 +2,7 @@ import AnthropicOriginal from '@anthropic-ai/sdk';
 import { v4 } from 'uuid';
 import { uuidv7 } from '@posthog/core';
 
-var version = "7.15.0";
+var version = "7.16.0";
 
 // Type guards for safer type checking
 

package/dist/gemini/index.cjs

@@ -6,7 +6,7 @@ var genai = require('@google/genai');
 var uuid = require('uuid');
 var core = require('@posthog/core');
 
-var version = "7.15.0";
+var version = "7.16.0";
 
 // Type guards for safer type checking
 

package/dist/gemini/index.mjs

@@ -2,7 +2,7 @@ import { GoogleGenAI } from '@google/genai';
 import { v4 } from 'uuid';
 import { uuidv7 } from '@posthog/core';
 
-var version = "7.15.0";
+var version = "7.16.0";
 
 // Type guards for safer type checking
 

package/dist/index.cjs

@@ -29,7 +29,7 @@ function _interopNamespace(e) {
 var uuid__namespace = /*#__PURE__*/_interopNamespace(uuid);
 var AnthropicOriginal__default = /*#__PURE__*/_interopDefault(AnthropicOriginal);
 
-var version = "7.15.0";
+var version = "7.16.0";
 
 // Type guards for safer type checking
 const isString = value => {
@@ -4461,7 +4461,11 @@ class LangChainCallbackHandler extends BaseCallbackHandler {
 /// <reference lib="dom" />
 const DEFAULT_CACHE_TTL_SECONDS = 300; // 5 minutes
 function isPromptApiResponse(data) {
-  return typeof data === 'object' && data !== null && 'prompt' in data && typeof data.prompt === 'string';
+  if (typeof data !== 'object' || data === null) {
+    return false;
+  }
+  const record = data;
+  return typeof record.prompt === 'string' && typeof record.name === 'string' && typeof record.version === 'number';
 }
 function isPromptsWithPostHog(options) {
   return 'posthog' in options;
@@ -4502,6 +4506,7 @@ function isPromptsWithPostHog(options) {
 class Prompts {
   constructor(options) {
     this.cache = new Map();
+    this.hasWarnedDeprecation = false;
     this.defaultCacheTtlSeconds = options.defaultCacheTtlSeconds ?? DEFAULT_CACHE_TTL_SECONDS;
     if (isPromptsWithPostHog(options)) {
       this.personalApiKey = options.posthog.options.personalApiKey ?? '';
@@ -4529,17 +4534,42 @@ class Prompts {
   getPromptLabel(name, version) {
     return version === undefined ? `"${name}"` : `"${name}" version ${version}`;
   }
+  async get(name, options) {
+    const withMetadata = options?.withMetadata;
+    if (withMetadata === undefined && !this.hasWarnedDeprecation) {
+      this.hasWarnedDeprecation = true;
+      console.warn('[PostHog Prompts] Calling get() without { withMetadata: true } is deprecated and will be ' + 'removed in a future major version. Pass { withMetadata: true } to receive a PromptResult ' + 'object with source, name, and version metadata. ' + 'You can pass { withMetadata: false } to silence this warning, but the plain-string return ' + 'will still be removed in the next major version.');
+    }
+    try {
+      const result = await this.getInternal(name, options);
+      if (withMetadata) {
+        return result;
+      }
+      return result.prompt;
+    } catch (error) {
+      const fallback = options?.fallback;
+      if (fallback !== undefined) {
+        const promptLabel = this.getPromptLabel(name, options?.version);
+        console.warn(`[PostHog Prompts] Failed to fetch prompt ${promptLabel}, using fallback:`, error);
+        if (withMetadata) {
+          return {
+            source: 'code_fallback',
+            prompt: fallback,
+            name: undefined,
+            version: undefined
+          };
+        }
+        return fallback;
+      }
+      throw error;
+    }
+  }
   /**
-   * Fetch a prompt by name from the PostHog API
-   *
-   * @param name - The name of the prompt to fetch
-   * @param options - Optional settings for caching, fallback, and exact version selection
-   * @returns The prompt string
-   * @throws Error if the prompt cannot be fetched and no fallback is provided
+   * Internal method that handles cache + fetch logic, returning full metadata.
+   * Does NOT handle the string `fallback` option — callers handle that.
    */
-  async get(name, options) {
+  async getInternal(name, options) {
     const cacheTtlSeconds = options?.cacheTtlSeconds ?? this.defaultCacheTtlSeconds;
-    const fallback = options?.fallback;
     const version = options?.version;
     const promptLabel = this.getPromptLabel(name, version);
     // Check cache first
@@ -4548,32 +4578,41 @@ class Prompts {
     if (cached) {
       const isFresh = now - cached.fetchedAt < cacheTtlSeconds * 1000;
       if (isFresh) {
-        return cached.prompt;
+        const {
+          fetchedAt: _,
+          ...cachedResult
+        } = cached;
+        return {
+          source: 'cache',
+          ...cachedResult
+        };
       }
     }
     // Try to fetch from API
     try {
-      const prompt = await this.fetchPromptFromApi(name, version);
-      const fetchedAt = Date.now();
+      const fetched = await this.fetchPromptFromApi(name, version);
       // Update cache
       this.getOrCreatePromptCache(name).set(version, {
-        prompt,
-        fetchedAt
+        ...fetched,
+        fetchedAt: Date.now()
       });
-      return prompt;
+      return {
+        source: 'api',
+        ...fetched
+      };
     } catch (error) {
-      // Fallback order:
-      // 1. Return stale cache (with warning)
+      // Return stale cache (with warning)
       if (cached) {
+        const {
+          fetchedAt: _,
+          ...cachedResult
+        } = cached;
         console.warn(`[PostHog Prompts] Failed to fetch prompt ${promptLabel}, using stale cache:`, error);
-        return cached.prompt;
-      }
-      // 2. Return fallback (with warning)
-      if (fallback !== undefined) {
-        console.warn(`[PostHog Prompts] Failed to fetch prompt ${promptLabel}, using fallback:`, error);
-        return fallback;
+        return {
+          source: 'stale_cache',
+          ...cachedResult
+        };
       }
-      // 3. Throw error
       throw error;
     }
   }
@@ -4650,7 +4689,11 @@ class Prompts {
     if (!isPromptApiResponse(data)) {
       throw new Error(`[PostHog Prompts] Invalid response format for prompt ${promptLabel}`);
     }
-    return data.prompt;
+    return {
+      prompt: data.prompt,
+      name: data.name,
+      version: data.version
+    };
   }
 }