@jaypie/llm 1.3.17 → 1.3.19

package/dist/esm/types/LlmProvider.interface.d.ts

@@ -290,7 +290,8 @@ export interface LlmExchangeEnvelope {
 export type LlmExchangeCallback = (envelope: LlmExchangeEnvelope) => unknown | Promise<unknown>;
 /**
  * Prompt-caching control for operate()/stream().
- * - `true` / omitted → caching enabled at the default `"5m"` TTL
+ * - `true` / omitted → caching enabled at the adapter's default TTL: `"1h"` on
+ *   Anthropic, `"5m"` everywhere else
  * - `false` / `0` → caching disabled
  * - `"5m"` / `"1h"` → enabled at that TTL (TTL honored by Anthropic/OpenRouter;
  *   other providers ignore it and cache with their own defaults)

package/dist/esm/util/cacheControl.d.ts

@@ -1,5 +1,11 @@
 import { type LlmCache } from "../types/LlmProvider.interface.js";
 export declare const CACHE_TTL_DEFAULT: "5m";
+/**
+ * Anthropic bills a 1h cache write at 2x input (vs 1.25x for 5m) but reads at
+ * the same ~0.1x, so an hour of reuse pays for itself after ~three reads and
+ * survives the gaps between turns in a long agentic session.
+ */
+export declare const CACHE_TTL_ANTHROPIC_DEFAULT: "1h";
 export type CacheTtl = "5m" | "1h";
 export interface ResolvedCache {
     enabled: boolean;
@@ -7,11 +13,13 @@ export interface ResolvedCache {
 }
 /**
  * Normalize the caller-facing `cache` option into a concrete decision.
- * - `undefined` / `true` → enabled at the default TTL
+ * - `undefined` / `true` → enabled at `defaultTtl`
  * - `false` / `0` → disabled
  * - `"5m"` / `"1h"` → enabled at that TTL
  */
-export declare function resolveCache(cache: LlmCache | undefined): ResolvedCache;
+export declare function resolveCache(cache: LlmCache | undefined, { defaultTtl }?: {
+    defaultTtl?: CacheTtl;
+}): ResolvedCache;
 /**
  * Deterministic short key for providers with automatic, prefix-based caching
  * (e.g. OpenAI `prompt_cache_key`). Derived from the stable prefix so the same

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jaypie/llm",
-  "version": "1.3.17",
+  "version": "1.3.19",
   "description": "Large language model utilities",
   "repository": {
     "type": "git",