@caeliq/llms 1.0.70 → 1.0.71

package/dist/utils/anthropic-client-policy.d.ts

@@ -37,6 +37,18 @@ export declare function inspectAnthropicClientFingerprint(headers: Record<string
  */
 export declare function getAnthropicProviderMode(provider: any, endpointTransformerName?: string): AnthropicProviderMode;
 export declare function isNativeAnthropicClient(kind: AnthropicClientKind): boolean;
+/** `CLAUDE_AUTH_NATIVE_CACHE_TTL` values: `1h` (default) or `client`. */
+export type NativeClaudeOAuthCacheTtlMode = "1h" | "client";
+export declare function resolveNativeClaudeOAuthCacheTtlMode(value: unknown): NativeClaudeOAuthCacheTtlMode;
+/**
+ * Native Desktop/CLI on claude-auth OAuth: extend the client's default-TTL
+ * (5m) ephemeral breakpoints to 1h, the TTL the third-party profile already
+ * uses on this route. Breakpoint placement is untouched. A body that already
+ * sets a TTL on any breakpoint is left exactly as sent (an explicit client
+ * choice), as is every body when the mode is `client`. Returns whether the
+ * body changed.
+ */
+export declare function applyNativeClaudeOAuthCacheTtl(body: any, context: AnthropicClientPolicyContext | undefined, mode?: NativeClaudeOAuthCacheTtlMode): boolean;
 /**
  * Apply the one and only system transformation allowed by the gateway policy.
  * This runs after routing has identified an in-scope Anthropic destination and

package/dist/utils/cache-prefix-debug.d.ts

@@ -5,10 +5,14 @@
  * transformer chain without a bisect.
  */
 export type CachePrefixStage = "client" | "wire";
+/**
+ * Routing headers that pin prompt-cache affinity. `x-client-request-id` is
+ * deliberately absent: claude-auth mints a fresh one per request (as Claude
+ * Code does), and Codex sets it equal to `thread-id`, which is tracked here.
+ */
 export type CacheAffinityHeaders = {
     sessionId?: string;
     threadId?: string;
-    clientRequestId?: string;
 };
 export type CachePrefixSegment = {
     path: string;

package/dist/utils/claude-billing.d.ts

@@ -25,6 +25,15 @@ export declare function buildClaudeBillingHeaderValue(messages: UnifiedMessage[]
 export declare function normalizeSystemToArray(request: UnifiedChatRequest): TextContent[];
 /** Drop any existing billing entry (dedupe) and prepend a fresh one at system[0]. */
 export declare function applyClaudeBillingSystemBlock(system: TextContent[], messages: UnifiedMessage[] | undefined): void;
+/**
+ * Drop any existing billing entry (dedupe) and reserve system[0] for a fresh
+ * one, so applyClaudeSystemIdentity places identity right after it. The value
+ * samples the first user text as sent, which relocation may still change, so
+ * fill it afterwards with fillClaudeBillingSystemBlock.
+ */
+export declare function reserveClaudeBillingSystemBlock(system: TextContent[]): TextContent;
+/** Fill a reserved billing block; remove it when attribution is disabled. */
+export declare function fillClaudeBillingSystemBlock(system: TextContent[], block: TextContent, messages: UnifiedMessage[] | undefined): void;
 /**
  * Insert SYSTEM_IDENTITY after the billing block (normally system[1], or
  * system[0] when attribution is disabled). Any remaining caller system
@@ -45,8 +54,13 @@ export declare function applyClaudeSystemIdentity(system: TextContent[]): void;
  * A no-op when there is no user message to attach the content to, so nothing
  * is silently dropped — the caller's system content stays in `system[]`
  * instead.
+ *
+ * Returns the inserted block unless the first user message has non-empty
+ * string content (the relocated text is then a standalone block a cache
+ * breakpoint can end on); non-empty string content is prefixed in place and
+ * returns undefined.
  */
-export declare function relocateForeignSystemContent(system: TextContent[], messages: UnifiedMessage[] | undefined): void;
+export declare function relocateForeignSystemContent(system: TextContent[], messages: UnifiedMessage[] | undefined): TextContent | undefined;
 /**
  * Claude Code's OAuth validator expects tool names in the mcp_PascalCase
  * spelling used by the official CLI. Non-Claude-Code clients commonly send

package/dist/utils/tool-content.d.ts

@@ -39,6 +39,12 @@ export declare function unifiedToolTextOnly(content: unknown): string;
 export declare function unifiedToolHasMedia(content: unknown): boolean;
 /** Anthropic tool_result.content: string or (text|image|document)[]. */
 export declare function unifiedToolContentToAnthropic(content: unknown): string | any[];
+/**
+ * Anthropic blocks for one Unified user content part. Empty when the part is
+ * not sent (empty text, image without URL, file without data or URL, unknown
+ * type), so callers placing cache breakpoints can skip it.
+ */
+export declare function unifiedUserPartToAnthropic(part: any): any[];
 /**
  * Anthropic inbound tool_result.content → Unified tool content
  * (string or text/image_url/file parts).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@caeliq/llms",
-  "version": "1.0.70",
+  "version": "1.0.71",
   "description": "A universal LLM API transformation server",
   "main": "dist/cjs/server.cjs",
   "module": "dist/esm/server.mjs",
@@ -30,7 +30,7 @@
   ],
   "dependencies": {
     "@anthropic-ai/sdk": "^0.120.0",
-    "@caeliq/ccr-shared": "^2.1.12",
+    "@caeliq/ccr-shared": "^2.1.13",
     "@cursor/sdk": "^1.0.32",
     "@fastify/cors": "^11.3.0",
     "@fastify/rate-limit": "^11.2.0",