@posthog/ai 7.9.5 → 7.10.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.9.5";
+var version = "7.10.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.9.5";
+var version = "7.10.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.9.5";
+var version = "7.10.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.9.5";
+var version = "7.10.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.9.5";
+var version = "7.10.0";
 
 // Type guards for safer type checking
 const isString = value => {
@@ -5186,6 +5186,11 @@ function isPromptsWithPostHog(options) {
  *   fallback: 'You are a helpful assistant.',
  * })
  *
+ * // Or fetch an exact published version
+ * const v3Template = await prompts.get('support-system-prompt', {
+ *   version: 3,
+ * })
+ *
  * // Compile with variables
  * const systemPrompt = prompts.compile(template, {
  *   company: 'Acme Corp',
@@ -5208,19 +5213,28 @@ class Prompts {
       this.host = options.host ?? 'https://us.posthog.com';
     }
   }
+  getCacheKey(name, version) {
+    return version === undefined ? `${name}::latest` : `${name}::version:${version}`;
+  }
+  getPromptLabel(name, version) {
+    return version === undefined ? `"${name}"` : `"${name}" version ${version}`;
+  }
   /**
    * Fetch a prompt by name from the PostHog API
    *
    * @param name - The name of the prompt to fetch
-   * @param options - Optional settings for caching and fallback
+   * @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
    */
   async get(name, options) {
     const cacheTtlSeconds = options?.cacheTtlSeconds ?? this.defaultCacheTtlSeconds;
     const fallback = options?.fallback;
+    const version = options?.version;
+    const cacheKey = this.getCacheKey(name, version);
+    const promptLabel = this.getPromptLabel(name, version);
     // Check cache first
-    const cached = this.cache.get(name);
+    const cached = this.cache.get(cacheKey);
     const now = Date.now();
     if (cached) {
       const isFresh = now - cached.fetchedAt < cacheTtlSeconds * 1000;
@@ -5230,10 +5244,10 @@ class Prompts {
     }
     // Try to fetch from API
     try {
-      const prompt = await this.fetchPromptFromApi(name);
+      const prompt = await this.fetchPromptFromApi(name, version);
       const fetchedAt = Date.now();
       // Update cache
-      this.cache.set(name, {
+      this.cache.set(cacheKey, {
         prompt,
         fetchedAt
       });
@@ -5242,12 +5256,12 @@ class Prompts {
       // Fallback order:
       // 1. Return stale cache (with warning)
       if (cached) {
-        console.warn(`[PostHog Prompts] Failed to fetch prompt "${name}", using stale cache:`, error);
+        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 "${name}", using fallback:`, error);
+        console.warn(`[PostHog Prompts] Failed to fetch prompt ${promptLabel}, using fallback:`, error);
         return fallback;
       }
       // 3. Throw error
@@ -5275,16 +5289,26 @@ class Prompts {
   /**
    * Clear the cache for a specific prompt or all prompts
    *
-   * @param name - Optional prompt name to clear. If not provided, clears all cached prompts.
+   * @param name - Optional prompt name to clear. If provided, clears all cached versions for that prompt.
    */
   clearCache(name) {
     if (name !== undefined) {
-      this.cache.delete(name);
+      const latestKey = this.getCacheKey(name);
+      const versionPrefix = `${name}::version:`;
+      for (const key of this.cache.keys()) {
+        if (key === latestKey) {
+          this.cache.delete(key);
+          continue;
+        }
+        if (key.startsWith(versionPrefix) && /^\d+$/.test(key.slice(versionPrefix.length))) {
+          this.cache.delete(key);
+        }
+      }
     } else {
       this.cache.clear();
     }
   }
-  async fetchPromptFromApi(name) {
+  async fetchPromptFromApi(name, version) {
     if (!this.personalApiKey) {
       throw new Error('[PostHog Prompts] personalApiKey is required to fetch prompts. ' + 'Please provide it when initializing the Prompts instance.');
     }
@@ -5293,7 +5317,9 @@ class Prompts {
     }
     const encodedPromptName = encodeURIComponent(name);
     const encodedProjectApiKey = encodeURIComponent(this.projectApiKey);
-    const url = `${this.host}/api/environments/@current/llm_prompts/name/${encodedPromptName}/?token=${encodedProjectApiKey}`;
+    const versionQuery = version === undefined ? '' : `&version=${encodeURIComponent(String(version))}`;
+    const promptLabel = this.getPromptLabel(name, version);
+    const url = `${this.host}/api/environments/@current/llm_prompts/name/${encodedPromptName}/?token=${encodedProjectApiKey}${versionQuery}`;
     const response = await fetch(url, {
       method: 'GET',
       headers: {
@@ -5302,16 +5328,16 @@ class Prompts {
     });
     if (!response.ok) {
       if (response.status === 404) {
-        throw new Error(`[PostHog Prompts] Prompt "${name}" not found`);
+        throw new Error(`[PostHog Prompts] Prompt ${promptLabel} not found`);
       }
       if (response.status === 403) {
-        throw new Error(`[PostHog Prompts] Access denied for prompt "${name}". ` + 'Check that your personalApiKey has the correct permissions and the LLM prompts feature is enabled.');
+        throw new Error(`[PostHog Prompts] Access denied for prompt ${promptLabel}. ` + 'Check that your personalApiKey has the correct permissions and the LLM prompts feature is enabled.');
       }
-      throw new Error(`[PostHog Prompts] Failed to fetch prompt "${name}": HTTP ${response.status}`);
+      throw new Error(`[PostHog Prompts] Failed to fetch prompt ${promptLabel}: HTTP ${response.status}`);
     }
     const data = await response.json();
     if (!isPromptApiResponse(data)) {
-      throw new Error(`[PostHog Prompts] Invalid response format for prompt "${name}"`);
+      throw new Error(`[PostHog Prompts] Invalid response format for prompt ${promptLabel}`);
     }
     return data.prompt;
   }