librechat-data-provider 0.8.504 → 0.8.506

package/dist/types/schemas.d.ts

@@ -42,6 +42,19 @@ export declare enum Providers {
  */
 export declare const documentSupportedProviders: Set<string>;
 export declare const isOpenAILikeProvider: (provider?: string | null) => boolean;
+/**
+ * Providers whose `usage_metadata.input_tokens` ALREADY INCLUDES cached tokens
+ * (`input_token_details.cache_*` is a subset, not an additional charge):
+ * Google/Vertex (`promptTokenCount`), OpenAI/Azure (`prompt_tokens`), and the
+ * OpenAI-compatible family. `@librechat/agents`' `getAnthropicUsageMetadata`
+ * folds `cache_creation` + `cache_read` into `input_tokens`, so Anthropic is a
+ * subset provider too; without this the cache portion is billed twice. Bedrock
+ * stays additive — its Converse path passes AWS `inputTokens` through unmodified.
+ * Single source of truth shared by the backend billing path
+ * (`packages/api/src/agents/usage.ts`) and the client usage normalization.
+ */
+export declare const cacheSubsetProviders: Set<string>;
+export declare const inputTokensIncludesCache: (provider?: string | null) => boolean;
 export declare const isDocumentSupportedProvider: (provider?: string | null) => boolean;
 export declare const paramEndpoints: Set<string>;
 export declare enum BedrockProviders {
@@ -328,6 +341,9 @@ export declare const anthropicSettings: {
     promptCache: {
         default: true;
     };
+    promptCacheTtl: {
+        default: undefined;
+    };
     thinking: {
         default: true;
     };
@@ -528,6 +544,9 @@ export declare const endpointSettings: {
         promptCache: {
             default: true;
         };
+        promptCacheTtl: {
+            default: undefined;
+        };
         thinking: {
             default: true;
         };
@@ -829,6 +848,8 @@ export declare const tMessageSchema: z.ZodObject<{
     }>>;
     /** metadata */
     metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    /** Output tokens for assistant messages, calibrated prompt-side estimate for user messages */
+    tokenCount: z.ZodOptional<z.ZodNumber>;
     contextMeta: z.ZodOptional<z.ZodObject<{
         calibrationRatio: z.ZodOptional<z.ZodNumber>;
         encoding: z.ZodOptional<z.ZodString>;
@@ -889,6 +910,7 @@ export declare const tMessageSchema: z.ZodObject<{
         text?: string | undefined;
     } | undefined;
     metadata?: Record<string, unknown> | undefined;
+    tokenCount?: number | undefined;
     contextMeta?: {
         calibrationRatio?: number | undefined;
         encoding?: string | undefined;
@@ -928,6 +950,7 @@ export declare const tMessageSchema: z.ZodObject<{
         text?: string | undefined;
     } | undefined;
     metadata?: Record<string, unknown> | undefined;
+    tokenCount?: number | undefined;
     contextMeta?: {
         calibrationRatio?: number | undefined;
         encoding?: string | undefined;
@@ -979,6 +1002,7 @@ export declare const tConversationSchema: z.ZodObject<{
     endpoint: z.ZodNullable<z.ZodNativeEnum<typeof EModelEndpoint>>;
     endpointType: z.ZodOptional<z.ZodNullable<z.ZodNativeEnum<typeof EModelEndpoint>>>;
     isArchived: z.ZodOptional<z.ZodBoolean>;
+    pinned: z.ZodOptional<z.ZodBoolean>;
     title: z.ZodDefault<z.ZodUnion<[z.ZodNullable<z.ZodString>, z.ZodLiteral<"New Chat">]>>;
     user: z.ZodOptional<z.ZodString>;
     messages: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -1059,6 +1083,7 @@ export declare const tConversationSchema: z.ZodObject<{
     maxContextTokens: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodNumber, z.ZodString]>, number | undefined, string | number>>;
     max_tokens: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodNumber, z.ZodString]>, number | undefined, string | number>>;
     promptCache: z.ZodOptional<z.ZodBoolean>;
+    promptCacheTtl: z.ZodOptional<z.ZodEnum<["5m", "1h"]>>;
     system: z.ZodOptional<z.ZodString>;
     thinking: z.ZodOptional<z.ZodBoolean>;
     thinkingBudget: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodNumber, z.ZodString]>, number | undefined, string | number>>;
@@ -1143,6 +1168,7 @@ export declare const tConversationSchema: z.ZodObject<{
     model?: string | null | undefined;
     endpointType?: EModelEndpoint | null | undefined;
     isArchived?: boolean | undefined;
+    pinned?: boolean | undefined;
     messages?: string[] | undefined;
     tools?: string[] | {
         name: string;
@@ -1175,6 +1201,7 @@ export declare const tConversationSchema: z.ZodObject<{
     maxContextTokens?: number | undefined;
     max_tokens?: number | undefined;
     promptCache?: boolean | undefined;
+    promptCacheTtl?: "5m" | "1h" | undefined;
     system?: string | undefined;
     thinking?: boolean | undefined;
     thinkingBudget?: number | undefined;
@@ -1230,6 +1257,7 @@ export declare const tConversationSchema: z.ZodObject<{
     model?: string | null | undefined;
     endpointType?: EModelEndpoint | null | undefined;
     isArchived?: boolean | undefined;
+    pinned?: boolean | undefined;
     title?: string | null | undefined;
     messages?: string[] | undefined;
     tools?: string[] | {
@@ -1263,6 +1291,7 @@ export declare const tConversationSchema: z.ZodObject<{
     maxContextTokens?: string | number | undefined;
     max_tokens?: string | number | undefined;
     promptCache?: boolean | undefined;
+    promptCacheTtl?: "5m" | "1h" | undefined;
     system?: string | undefined;
     thinking?: boolean | undefined;
     thinkingBudget?: string | number | undefined;
@@ -1315,6 +1344,7 @@ export declare const tPresetSchema: z.ZodObject<{
     model: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     endpointType: z.ZodOptional<z.ZodNullable<z.ZodNativeEnum<typeof EModelEndpoint>>>;
     isArchived: z.ZodOptional<z.ZodBoolean>;
+    pinned: z.ZodOptional<z.ZodBoolean>;
     messages: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     tools: z.ZodOptional<z.ZodUnion<[z.ZodArray<z.ZodObject<{
         name: z.ZodString;
@@ -1392,6 +1422,7 @@ export declare const tPresetSchema: z.ZodObject<{
     maxContextTokens: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodNumber, z.ZodString]>, number | undefined, string | number>>;
     max_tokens: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodNumber, z.ZodString]>, number | undefined, string | number>>;
     promptCache: z.ZodOptional<z.ZodBoolean>;
+    promptCacheTtl: z.ZodOptional<z.ZodEnum<["5m", "1h"]>>;
     system: z.ZodOptional<z.ZodString>;
     thinking: z.ZodOptional<z.ZodBoolean>;
     thinkingBudget: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodNumber, z.ZodString]>, number | undefined, string | number>>;
@@ -1473,6 +1504,7 @@ export declare const tPresetSchema: z.ZodObject<{
     conversationId?: string | null | undefined;
     endpointType?: EModelEndpoint | null | undefined;
     isArchived?: boolean | undefined;
+    pinned?: boolean | undefined;
     title?: string | null | undefined;
     messages?: string[] | undefined;
     tools?: string[] | {
@@ -1506,6 +1538,7 @@ export declare const tPresetSchema: z.ZodObject<{
     maxContextTokens?: number | undefined;
     max_tokens?: number | undefined;
     promptCache?: boolean | undefined;
+    promptCacheTtl?: "5m" | "1h" | undefined;
     system?: string | undefined;
     thinking?: boolean | undefined;
     thinkingBudget?: number | undefined;
@@ -1561,6 +1594,7 @@ export declare const tPresetSchema: z.ZodObject<{
     conversationId?: string | null | undefined;
     endpointType?: EModelEndpoint | null | undefined;
     isArchived?: boolean | undefined;
+    pinned?: boolean | undefined;
     title?: string | null | undefined;
     messages?: string[] | undefined;
     tools?: string[] | {
@@ -1594,6 +1628,7 @@ export declare const tPresetSchema: z.ZodObject<{
     maxContextTokens?: string | number | undefined;
     max_tokens?: string | number | undefined;
     promptCache?: boolean | undefined;
+    promptCacheTtl?: "5m" | "1h" | undefined;
     system?: string | undefined;
     thinking?: boolean | undefined;
     thinkingBudget?: string | number | undefined;
@@ -1646,6 +1681,7 @@ export declare const tConvoUpdateSchema: z.ZodObject<{
     conversationId: z.ZodNullable<z.ZodString>;
     endpointType: z.ZodOptional<z.ZodNullable<z.ZodNativeEnum<typeof EModelEndpoint>>>;
     isArchived: z.ZodOptional<z.ZodBoolean>;
+    pinned: z.ZodOptional<z.ZodBoolean>;
     title: z.ZodDefault<z.ZodUnion<[z.ZodNullable<z.ZodString>, z.ZodLiteral<"New Chat">]>>;
     user: z.ZodOptional<z.ZodString>;
     messages: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -1726,6 +1762,7 @@ export declare const tConvoUpdateSchema: z.ZodObject<{
     maxContextTokens: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodNumber, z.ZodString]>, number | undefined, string | number>>;
     max_tokens: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodNumber, z.ZodString]>, number | undefined, string | number>>;
     promptCache: z.ZodOptional<z.ZodBoolean>;
+    promptCacheTtl: z.ZodOptional<z.ZodEnum<["5m", "1h"]>>;
     system: z.ZodOptional<z.ZodString>;
     thinking: z.ZodOptional<z.ZodBoolean>;
     thinkingBudget: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodNumber, z.ZodString]>, number | undefined, string | number>>;
@@ -1807,6 +1844,7 @@ export declare const tConvoUpdateSchema: z.ZodObject<{
     model?: string | null | undefined;
     endpointType?: EModelEndpoint | null | undefined;
     isArchived?: boolean | undefined;
+    pinned?: boolean | undefined;
     messages?: string[] | undefined;
     tools?: string[] | {
         name: string;
@@ -1839,6 +1877,7 @@ export declare const tConvoUpdateSchema: z.ZodObject<{
     maxContextTokens?: number | undefined;
     max_tokens?: number | undefined;
     promptCache?: boolean | undefined;
+    promptCacheTtl?: "5m" | "1h" | undefined;
     system?: string | undefined;
     thinking?: boolean | undefined;
     thinkingBudget?: number | undefined;
@@ -1894,6 +1933,7 @@ export declare const tConvoUpdateSchema: z.ZodObject<{
     model?: string | null | undefined;
     endpointType?: EModelEndpoint | null | undefined;
     isArchived?: boolean | undefined;
+    pinned?: boolean | undefined;
     title?: string | null | undefined;
     messages?: string[] | undefined;
     tools?: string[] | {
@@ -1927,6 +1967,7 @@ export declare const tConvoUpdateSchema: z.ZodObject<{
     maxContextTokens?: string | number | undefined;
     max_tokens?: string | number | undefined;
     promptCache?: boolean | undefined;
+    promptCacheTtl?: "5m" | "1h" | undefined;
     system?: string | undefined;
     thinking?: boolean | undefined;
     thinkingBudget?: string | number | undefined;
@@ -1980,6 +2021,7 @@ export declare const tQueryParamsSchema: z.ZodObject<Pick<{
     endpoint: z.ZodNullable<z.ZodNativeEnum<typeof EModelEndpoint>>;
     endpointType: z.ZodOptional<z.ZodNullable<z.ZodNativeEnum<typeof EModelEndpoint>>>;
     isArchived: z.ZodOptional<z.ZodBoolean>;
+    pinned: z.ZodOptional<z.ZodBoolean>;
     title: z.ZodDefault<z.ZodUnion<[z.ZodNullable<z.ZodString>, z.ZodLiteral<"New Chat">]>>;
     user: z.ZodOptional<z.ZodString>;
     messages: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -2060,6 +2102,7 @@ export declare const tQueryParamsSchema: z.ZodObject<Pick<{
     maxContextTokens: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodNumber, z.ZodString]>, number | undefined, string | number>>;
     max_tokens: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodNumber, z.ZodString]>, number | undefined, string | number>>;
     promptCache: z.ZodOptional<z.ZodBoolean>;
+    promptCacheTtl: z.ZodOptional<z.ZodEnum<["5m", "1h"]>>;
     system: z.ZodOptional<z.ZodString>;
     thinking: z.ZodOptional<z.ZodBoolean>;
     thinkingBudget: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodNumber, z.ZodString]>, number | undefined, string | number>>;
@@ -2133,7 +2176,7 @@ export declare const tQueryParamsSchema: z.ZodObject<Pick<{
     resendImages: z.ZodOptional<z.ZodBoolean>;
     /** @deprecated Prefer `modelLabel` over `chatGptLabel` */
     chatGptLabel: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-}, "model" | "promptPrefix" | "temperature" | "topP" | "topK" | "top_p" | "frequency_penalty" | "presence_penalty" | "maxOutputTokens" | "maxContextTokens" | "max_tokens" | "promptCache" | "thinking" | "thinkingBudget" | "thinkingLevel" | "resendFiles" | "imageDetail" | "reasoning_effort" | "reasoning_summary" | "verbosity" | "useResponsesApi" | "effort" | "thinkingDisplay" | "web_search" | "disableStreaming" | "assistant_id" | "agent_id" | "region" | "maxTokens" | "instructions" | "append_current_datetime" | "stop" | "spec" | "fileTokenLimit"> & {
+}, "model" | "promptPrefix" | "temperature" | "topP" | "topK" | "top_p" | "frequency_penalty" | "presence_penalty" | "maxOutputTokens" | "maxContextTokens" | "max_tokens" | "promptCache" | "promptCacheTtl" | "thinking" | "thinkingBudget" | "thinkingLevel" | "resendFiles" | "imageDetail" | "reasoning_effort" | "reasoning_summary" | "verbosity" | "useResponsesApi" | "effort" | "thinkingDisplay" | "web_search" | "disableStreaming" | "assistant_id" | "agent_id" | "region" | "maxTokens" | "instructions" | "append_current_datetime" | "stop" | "spec" | "fileTokenLimit"> & {
     /** @endpoints openAI, custom, azureOpenAI, google, anthropic, assistants, azureAssistants, bedrock, agents */
     endpoint: z.ZodNullable<z.ZodUnion<[z.ZodNativeEnum<typeof EModelEndpoint>, z.ZodString]>>;
 }, "strip", z.ZodTypeAny, {
@@ -2150,6 +2193,7 @@ export declare const tQueryParamsSchema: z.ZodObject<Pick<{
     maxContextTokens?: number | undefined;
     max_tokens?: number | undefined;
     promptCache?: boolean | undefined;
+    promptCacheTtl?: "5m" | "1h" | undefined;
     thinking?: boolean | undefined;
     thinkingBudget?: number | undefined;
     thinkingLevel?: ThinkingLevel | undefined;
@@ -2186,6 +2230,7 @@ export declare const tQueryParamsSchema: z.ZodObject<Pick<{
     maxContextTokens?: string | number | undefined;
     max_tokens?: string | number | undefined;
     promptCache?: boolean | undefined;
+    promptCacheTtl?: "5m" | "1h" | undefined;
     thinking?: boolean | undefined;
     thinkingBudget?: string | number | undefined;
     thinkingLevel?: ThinkingLevel | undefined;
@@ -2222,6 +2267,7 @@ export declare const tModelSpecPresetSchema: z.ZodObject<Omit<{
     model: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     endpointType: z.ZodOptional<z.ZodNullable<z.ZodNativeEnum<typeof EModelEndpoint>>>;
     isArchived: z.ZodOptional<z.ZodBoolean>;
+    pinned: z.ZodOptional<z.ZodBoolean>;
     messages: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     tools: z.ZodOptional<z.ZodUnion<[z.ZodArray<z.ZodObject<{
         name: z.ZodString;
@@ -2299,6 +2345,7 @@ export declare const tModelSpecPresetSchema: z.ZodObject<Omit<{
     maxContextTokens: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodNumber, z.ZodString]>, number | undefined, string | number>>;
     max_tokens: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodNumber, z.ZodString]>, number | undefined, string | number>>;
     promptCache: z.ZodOptional<z.ZodBoolean>;
+    promptCacheTtl: z.ZodOptional<z.ZodEnum<["5m", "1h"]>>;
     system: z.ZodOptional<z.ZodString>;
     thinking: z.ZodOptional<z.ZodBoolean>;
     thinkingBudget: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodNumber, z.ZodString]>, number | undefined, string | number>>;
@@ -2376,6 +2423,7 @@ export declare const tModelSpecPresetSchema: z.ZodObject<Omit<{
     endpoint: string | null;
     model?: string | null | undefined;
     endpointType?: EModelEndpoint | null | undefined;
+    pinned?: boolean | undefined;
     tools?: string[] | {
         name: string;
         pluginKey: string;
@@ -2406,6 +2454,7 @@ export declare const tModelSpecPresetSchema: z.ZodObject<Omit<{
     maxContextTokens?: number | undefined;
     max_tokens?: number | undefined;
     promptCache?: boolean | undefined;
+    promptCacheTtl?: "5m" | "1h" | undefined;
     system?: string | undefined;
     thinking?: boolean | undefined;
     thinkingBudget?: number | undefined;
@@ -2448,6 +2497,7 @@ export declare const tModelSpecPresetSchema: z.ZodObject<Omit<{
     endpoint: string | null;
     model?: string | null | undefined;
     endpointType?: EModelEndpoint | null | undefined;
+    pinned?: boolean | undefined;
     tools?: string[] | {
         name: string;
         pluginKey: string;
@@ -2478,6 +2528,7 @@ export declare const tModelSpecPresetSchema: z.ZodObject<Omit<{
     maxContextTokens?: string | number | undefined;
     max_tokens?: string | number | undefined;
     promptCache?: boolean | undefined;
+    promptCacheTtl?: "5m" | "1h" | undefined;
     system?: string | undefined;
     thinking?: boolean | undefined;
     thinkingBudget?: string | number | undefined;
@@ -2584,6 +2635,7 @@ export declare const googleBaseSchema: z.ZodObject<Pick<{
     endpoint: z.ZodNullable<z.ZodNativeEnum<typeof EModelEndpoint>>;
     endpointType: z.ZodOptional<z.ZodNullable<z.ZodNativeEnum<typeof EModelEndpoint>>>;
     isArchived: z.ZodOptional<z.ZodBoolean>;
+    pinned: z.ZodOptional<z.ZodBoolean>;
     title: z.ZodDefault<z.ZodUnion<[z.ZodNullable<z.ZodString>, z.ZodLiteral<"New Chat">]>>;
     user: z.ZodOptional<z.ZodString>;
     messages: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -2664,6 +2716,7 @@ export declare const googleBaseSchema: z.ZodObject<Pick<{
     maxContextTokens: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodNumber, z.ZodString]>, number | undefined, string | number>>;
     max_tokens: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodNumber, z.ZodString]>, number | undefined, string | number>>;
     promptCache: z.ZodOptional<z.ZodBoolean>;
+    promptCacheTtl: z.ZodOptional<z.ZodEnum<["5m", "1h"]>>;
     system: z.ZodOptional<z.ZodString>;
     thinking: z.ZodOptional<z.ZodBoolean>;
     thinkingBudget: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodNumber, z.ZodString]>, number | undefined, string | number>>;
@@ -2797,6 +2850,7 @@ export declare const googleSchema: z.ZodCatch<z.ZodEffects<z.ZodObject<Pick<{
     endpoint: z.ZodNullable<z.ZodNativeEnum<typeof EModelEndpoint>>;
     endpointType: z.ZodOptional<z.ZodNullable<z.ZodNativeEnum<typeof EModelEndpoint>>>;
     isArchived: z.ZodOptional<z.ZodBoolean>;
+    pinned: z.ZodOptional<z.ZodBoolean>;
     title: z.ZodDefault<z.ZodUnion<[z.ZodNullable<z.ZodString>, z.ZodLiteral<"New Chat">]>>;
     user: z.ZodOptional<z.ZodString>;
     messages: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -2877,6 +2931,7 @@ export declare const googleSchema: z.ZodCatch<z.ZodEffects<z.ZodObject<Pick<{
     maxContextTokens: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodNumber, z.ZodString]>, number | undefined, string | number>>;
     max_tokens: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodNumber, z.ZodString]>, number | undefined, string | number>>;
     promptCache: z.ZodOptional<z.ZodBoolean>;
+    promptCacheTtl: z.ZodOptional<z.ZodEnum<["5m", "1h"]>>;
     system: z.ZodOptional<z.ZodString>;
     thinking: z.ZodOptional<z.ZodBoolean>;
     thinkingBudget: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodNumber, z.ZodString]>, number | undefined, string | number>>;
@@ -3095,6 +3150,7 @@ export declare const assistantSchema: z.ZodCatch<z.ZodEffects<z.ZodObject<Pick<{
     endpoint: z.ZodNullable<z.ZodNativeEnum<typeof EModelEndpoint>>;
     endpointType: z.ZodOptional<z.ZodNullable<z.ZodNativeEnum<typeof EModelEndpoint>>>;
     isArchived: z.ZodOptional<z.ZodBoolean>;
+    pinned: z.ZodOptional<z.ZodBoolean>;
     title: z.ZodDefault<z.ZodUnion<[z.ZodNullable<z.ZodString>, z.ZodLiteral<"New Chat">]>>;
     user: z.ZodOptional<z.ZodString>;
     messages: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -3175,6 +3231,7 @@ export declare const assistantSchema: z.ZodCatch<z.ZodEffects<z.ZodObject<Pick<{
     maxContextTokens: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodNumber, z.ZodString]>, number | undefined, string | number>>;
     max_tokens: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodNumber, z.ZodString]>, number | undefined, string | number>>;
     promptCache: z.ZodOptional<z.ZodBoolean>;
+    promptCacheTtl: z.ZodOptional<z.ZodEnum<["5m", "1h"]>>;
     system: z.ZodOptional<z.ZodString>;
     thinking: z.ZodOptional<z.ZodBoolean>;
     thinkingBudget: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodNumber, z.ZodString]>, number | undefined, string | number>>;
@@ -3298,6 +3355,7 @@ export declare const compactAssistantSchema: z.ZodCatch<z.ZodEffects<z.ZodObject
     endpoint: z.ZodNullable<z.ZodNativeEnum<typeof EModelEndpoint>>;
     endpointType: z.ZodOptional<z.ZodNullable<z.ZodNativeEnum<typeof EModelEndpoint>>>;
     isArchived: z.ZodOptional<z.ZodBoolean>;
+    pinned: z.ZodOptional<z.ZodBoolean>;
     title: z.ZodDefault<z.ZodUnion<[z.ZodNullable<z.ZodString>, z.ZodLiteral<"New Chat">]>>;
     user: z.ZodOptional<z.ZodString>;
     messages: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -3378,6 +3436,7 @@ export declare const compactAssistantSchema: z.ZodCatch<z.ZodEffects<z.ZodObject
     maxContextTokens: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodNumber, z.ZodString]>, number | undefined, string | number>>;
     max_tokens: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodNumber, z.ZodString]>, number | undefined, string | number>>;
     promptCache: z.ZodOptional<z.ZodBoolean>;
+    promptCacheTtl: z.ZodOptional<z.ZodEnum<["5m", "1h"]>>;
     system: z.ZodOptional<z.ZodString>;
     thinking: z.ZodOptional<z.ZodBoolean>;
     thinkingBudget: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodNumber, z.ZodString]>, number | undefined, string | number>>;
@@ -3497,6 +3556,7 @@ export declare const agentsBaseSchema: z.ZodObject<Pick<{
     endpoint: z.ZodNullable<z.ZodNativeEnum<typeof EModelEndpoint>>;
     endpointType: z.ZodOptional<z.ZodNullable<z.ZodNativeEnum<typeof EModelEndpoint>>>;
     isArchived: z.ZodOptional<z.ZodBoolean>;
+    pinned: z.ZodOptional<z.ZodBoolean>;
     title: z.ZodDefault<z.ZodUnion<[z.ZodNullable<z.ZodString>, z.ZodLiteral<"New Chat">]>>;
     user: z.ZodOptional<z.ZodString>;
     messages: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -3577,6 +3637,7 @@ export declare const agentsBaseSchema: z.ZodObject<Pick<{
     maxContextTokens: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodNumber, z.ZodString]>, number | undefined, string | number>>;
     max_tokens: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodNumber, z.ZodString]>, number | undefined, string | number>>;
     promptCache: z.ZodOptional<z.ZodBoolean>;
+    promptCacheTtl: z.ZodOptional<z.ZodEnum<["5m", "1h"]>>;
     system: z.ZodOptional<z.ZodString>;
     thinking: z.ZodOptional<z.ZodBoolean>;
     thinkingBudget: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodNumber, z.ZodString]>, number | undefined, string | number>>;
@@ -3688,6 +3749,7 @@ export declare const agentsSchema: z.ZodCatch<z.ZodEffects<z.ZodObject<Pick<{
     endpoint: z.ZodNullable<z.ZodNativeEnum<typeof EModelEndpoint>>;
     endpointType: z.ZodOptional<z.ZodNullable<z.ZodNativeEnum<typeof EModelEndpoint>>>;
     isArchived: z.ZodOptional<z.ZodBoolean>;
+    pinned: z.ZodOptional<z.ZodBoolean>;
     title: z.ZodDefault<z.ZodUnion<[z.ZodNullable<z.ZodString>, z.ZodLiteral<"New Chat">]>>;
     user: z.ZodOptional<z.ZodString>;
     messages: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -3768,6 +3830,7 @@ export declare const agentsSchema: z.ZodCatch<z.ZodEffects<z.ZodObject<Pick<{
     maxContextTokens: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodNumber, z.ZodString]>, number | undefined, string | number>>;
     max_tokens: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodNumber, z.ZodString]>, number | undefined, string | number>>;
     promptCache: z.ZodOptional<z.ZodBoolean>;
+    promptCacheTtl: z.ZodOptional<z.ZodEnum<["5m", "1h"]>>;
     system: z.ZodOptional<z.ZodString>;
     thinking: z.ZodOptional<z.ZodBoolean>;
     thinkingBudget: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodNumber, z.ZodString]>, number | undefined, string | number>>;
@@ -3911,6 +3974,7 @@ export declare const openAIBaseSchema: z.ZodObject<Pick<{
     endpoint: z.ZodNullable<z.ZodNativeEnum<typeof EModelEndpoint>>;
     endpointType: z.ZodOptional<z.ZodNullable<z.ZodNativeEnum<typeof EModelEndpoint>>>;
     isArchived: z.ZodOptional<z.ZodBoolean>;
+    pinned: z.ZodOptional<z.ZodBoolean>;
     title: z.ZodDefault<z.ZodUnion<[z.ZodNullable<z.ZodString>, z.ZodLiteral<"New Chat">]>>;
     user: z.ZodOptional<z.ZodString>;
     messages: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -3991,6 +4055,7 @@ export declare const openAIBaseSchema: z.ZodObject<Pick<{
     maxContextTokens: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodNumber, z.ZodString]>, number | undefined, string | number>>;
     max_tokens: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodNumber, z.ZodString]>, number | undefined, string | number>>;
     promptCache: z.ZodOptional<z.ZodBoolean>;
+    promptCacheTtl: z.ZodOptional<z.ZodEnum<["5m", "1h"]>>;
     system: z.ZodOptional<z.ZodString>;
     thinking: z.ZodOptional<z.ZodBoolean>;
     thinkingBudget: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodNumber, z.ZodString]>, number | undefined, string | number>>;
@@ -4122,6 +4187,7 @@ export declare const openAISchema: z.ZodCatch<z.ZodEffects<z.ZodObject<Pick<{
     endpoint: z.ZodNullable<z.ZodNativeEnum<typeof EModelEndpoint>>;
     endpointType: z.ZodOptional<z.ZodNullable<z.ZodNativeEnum<typeof EModelEndpoint>>>;
     isArchived: z.ZodOptional<z.ZodBoolean>;
+    pinned: z.ZodOptional<z.ZodBoolean>;
     title: z.ZodDefault<z.ZodUnion<[z.ZodNullable<z.ZodString>, z.ZodLiteral<"New Chat">]>>;
     user: z.ZodOptional<z.ZodString>;
     messages: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -4202,6 +4268,7 @@ export declare const openAISchema: z.ZodCatch<z.ZodEffects<z.ZodObject<Pick<{
     maxContextTokens: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodNumber, z.ZodString]>, number | undefined, string | number>>;
     max_tokens: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodNumber, z.ZodString]>, number | undefined, string | number>>;
     promptCache: z.ZodOptional<z.ZodBoolean>;
+    promptCacheTtl: z.ZodOptional<z.ZodEnum<["5m", "1h"]>>;
     system: z.ZodOptional<z.ZodString>;
     thinking: z.ZodOptional<z.ZodBoolean>;
     thinkingBudget: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodNumber, z.ZodString]>, number | undefined, string | number>>;
@@ -4359,6 +4426,7 @@ export declare const openRouterSchema: z.ZodCatch<z.ZodEffects<z.ZodObject<Pick<
     endpoint: z.ZodNullable<z.ZodNativeEnum<typeof EModelEndpoint>>;
     endpointType: z.ZodOptional<z.ZodNullable<z.ZodNativeEnum<typeof EModelEndpoint>>>;
     isArchived: z.ZodOptional<z.ZodBoolean>;
+    pinned: z.ZodOptional<z.ZodBoolean>;
     title: z.ZodDefault<z.ZodUnion<[z.ZodNullable<z.ZodString>, z.ZodLiteral<"New Chat">]>>;
     user: z.ZodOptional<z.ZodString>;
     messages: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -4439,6 +4507,7 @@ export declare const openRouterSchema: z.ZodCatch<z.ZodEffects<z.ZodObject<Pick<
     maxContextTokens: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodNumber, z.ZodString]>, number | undefined, string | number>>;
     max_tokens: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodNumber, z.ZodString]>, number | undefined, string | number>>;
     promptCache: z.ZodOptional<z.ZodBoolean>;
+    promptCacheTtl: z.ZodOptional<z.ZodEnum<["5m", "1h"]>>;
     system: z.ZodOptional<z.ZodString>;
     thinking: z.ZodOptional<z.ZodBoolean>;
     thinkingBudget: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodNumber, z.ZodString]>, number | undefined, string | number>>;
@@ -4517,6 +4586,7 @@ export declare const openRouterSchema: z.ZodCatch<z.ZodEffects<z.ZodObject<Pick<
     endpoint: z.ZodNullable<z.ZodNativeEnum<typeof EModelEndpoint>>;
     endpointType: z.ZodOptional<z.ZodNullable<z.ZodNativeEnum<typeof EModelEndpoint>>>;
     isArchived: z.ZodOptional<z.ZodBoolean>;
+    pinned: z.ZodOptional<z.ZodBoolean>;
     title: z.ZodDefault<z.ZodUnion<[z.ZodNullable<z.ZodString>, z.ZodLiteral<"New Chat">]>>;
     user: z.ZodOptional<z.ZodString>;
     messages: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -4597,6 +4667,7 @@ export declare const openRouterSchema: z.ZodCatch<z.ZodEffects<z.ZodObject<Pick<
     maxContextTokens: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodNumber, z.ZodString]>, number | undefined, string | number>>;
     max_tokens: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodNumber, z.ZodString]>, number | undefined, string | number>>;
     promptCache: z.ZodOptional<z.ZodBoolean>;
+    promptCacheTtl: z.ZodOptional<z.ZodEnum<["5m", "1h"]>>;
     system: z.ZodOptional<z.ZodString>;
     thinking: z.ZodOptional<z.ZodBoolean>;
     thinkingBudget: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodNumber, z.ZodString]>, number | undefined, string | number>>;
@@ -4670,7 +4741,7 @@ export declare const openRouterSchema: z.ZodCatch<z.ZodEffects<z.ZodObject<Pick<
     resendImages: z.ZodOptional<z.ZodBoolean>;
     /** @deprecated Prefer `modelLabel` over `chatGptLabel` */
     chatGptLabel: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-}, "promptCache">, "strip", z.ZodTypeAny, {
+}, "promptCache" | "promptCacheTtl">, "strip", z.ZodTypeAny, {
     model?: string | null | undefined;
     modelLabel?: string | null | undefined;
     promptPrefix?: string | null | undefined;
@@ -4681,6 +4752,7 @@ export declare const openRouterSchema: z.ZodCatch<z.ZodEffects<z.ZodObject<Pick<
     maxContextTokens?: number | undefined;
     max_tokens?: number | undefined;
     promptCache?: boolean | undefined;
+    promptCacheTtl?: "5m" | "1h" | undefined;
     artifacts?: string | undefined;
     chatProjectId?: string | null | undefined;
     resendFiles?: boolean | undefined;
@@ -4708,6 +4780,7 @@ export declare const openRouterSchema: z.ZodCatch<z.ZodEffects<z.ZodObject<Pick<
     maxContextTokens?: string | number | undefined;
     max_tokens?: string | number | undefined;
     promptCache?: boolean | undefined;
+    promptCacheTtl?: "5m" | "1h" | undefined;
     artifacts?: string | undefined;
     chatProjectId?: string | null | undefined;
     resendFiles?: boolean | undefined;
@@ -4735,6 +4808,7 @@ export declare const openRouterSchema: z.ZodCatch<z.ZodEffects<z.ZodObject<Pick<
     maxContextTokens?: string | number | undefined;
     max_tokens?: string | number | undefined;
     promptCache?: boolean | undefined;
+    promptCacheTtl?: "5m" | "1h" | undefined;
     artifacts?: string | undefined;
     chatProjectId?: string | null | undefined;
     resendFiles?: boolean | undefined;
@@ -4757,6 +4831,7 @@ export declare const compactGoogleSchema: z.ZodCatch<z.ZodEffects<z.ZodObject<Pi
     endpoint: z.ZodNullable<z.ZodNativeEnum<typeof EModelEndpoint>>;
     endpointType: z.ZodOptional<z.ZodNullable<z.ZodNativeEnum<typeof EModelEndpoint>>>;
     isArchived: z.ZodOptional<z.ZodBoolean>;
+    pinned: z.ZodOptional<z.ZodBoolean>;
     title: z.ZodDefault<z.ZodUnion<[z.ZodNullable<z.ZodString>, z.ZodLiteral<"New Chat">]>>;
     user: z.ZodOptional<z.ZodString>;
     messages: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -4837,6 +4912,7 @@ export declare const compactGoogleSchema: z.ZodCatch<z.ZodEffects<z.ZodObject<Pi
     maxContextTokens: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodNumber, z.ZodString]>, number | undefined, string | number>>;
     max_tokens: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodNumber, z.ZodString]>, number | undefined, string | number>>;
     promptCache: z.ZodOptional<z.ZodBoolean>;
+    promptCacheTtl: z.ZodOptional<z.ZodEnum<["5m", "1h"]>>;
     system: z.ZodOptional<z.ZodString>;
     thinking: z.ZodOptional<z.ZodBoolean>;
     thinkingBudget: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodNumber, z.ZodString]>, number | undefined, string | number>>;
@@ -4997,6 +5073,7 @@ export declare const anthropicBaseSchema: z.ZodObject<Pick<{
     endpoint: z.ZodNullable<z.ZodNativeEnum<typeof EModelEndpoint>>;
     endpointType: z.ZodOptional<z.ZodNullable<z.ZodNativeEnum<typeof EModelEndpoint>>>;
     isArchived: z.ZodOptional<z.ZodBoolean>;
+    pinned: z.ZodOptional<z.ZodBoolean>;
     title: z.ZodDefault<z.ZodUnion<[z.ZodNullable<z.ZodString>, z.ZodLiteral<"New Chat">]>>;
     user: z.ZodOptional<z.ZodString>;
     messages: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -5077,6 +5154,7 @@ export declare const anthropicBaseSchema: z.ZodObject<Pick<{
     maxContextTokens: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodNumber, z.ZodString]>, number | undefined, string | number>>;
     max_tokens: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodNumber, z.ZodString]>, number | undefined, string | number>>;
     promptCache: z.ZodOptional<z.ZodBoolean>;
+    promptCacheTtl: z.ZodOptional<z.ZodEnum<["5m", "1h"]>>;
     system: z.ZodOptional<z.ZodString>;
     thinking: z.ZodOptional<z.ZodBoolean>;
     thinkingBudget: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodNumber, z.ZodString]>, number | undefined, string | number>>;
@@ -5150,7 +5228,7 @@ export declare const anthropicBaseSchema: z.ZodObject<Pick<{
     resendImages: z.ZodOptional<z.ZodBoolean>;
     /** @deprecated Prefer `modelLabel` over `chatGptLabel` */
     chatGptLabel: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-}, "model" | "modelLabel" | "promptPrefix" | "temperature" | "topP" | "topK" | "maxOutputTokens" | "maxContextTokens" | "promptCache" | "thinking" | "thinkingBudget" | "stream" | "artifacts" | "chatProjectId" | "resendFiles" | "effort" | "thinkingDisplay" | "web_search" | "stop" | "greeting" | "spec" | "iconURL" | "fileTokenLimit">, "strip", z.ZodTypeAny, {
+}, "model" | "modelLabel" | "promptPrefix" | "temperature" | "topP" | "topK" | "maxOutputTokens" | "maxContextTokens" | "promptCache" | "promptCacheTtl" | "thinking" | "thinkingBudget" | "stream" | "artifacts" | "chatProjectId" | "resendFiles" | "effort" | "thinkingDisplay" | "web_search" | "stop" | "greeting" | "spec" | "iconURL" | "fileTokenLimit">, "strip", z.ZodTypeAny, {
     model?: string | null | undefined;
     modelLabel?: string | null | undefined;
     promptPrefix?: string | null | undefined;
@@ -5160,6 +5238,7 @@ export declare const anthropicBaseSchema: z.ZodObject<Pick<{
     maxOutputTokens?: number | null | undefined;
     maxContextTokens?: number | undefined;
     promptCache?: boolean | undefined;
+    promptCacheTtl?: "5m" | "1h" | undefined;
     thinking?: boolean | undefined;
     thinkingBudget?: number | undefined;
     stream?: boolean | undefined;
@@ -5184,6 +5263,7 @@ export declare const anthropicBaseSchema: z.ZodObject<Pick<{
     maxOutputTokens?: string | number | null | undefined;
     maxContextTokens?: string | number | undefined;
     promptCache?: boolean | undefined;
+    promptCacheTtl?: "5m" | "1h" | undefined;
     thinking?: boolean | undefined;
     thinkingBudget?: string | number | undefined;
     stream?: boolean | undefined;
@@ -5204,6 +5284,7 @@ export declare const anthropicSchema: z.ZodCatch<z.ZodEffects<z.ZodObject<Pick<{
     endpoint: z.ZodNullable<z.ZodNativeEnum<typeof EModelEndpoint>>;
     endpointType: z.ZodOptional<z.ZodNullable<z.ZodNativeEnum<typeof EModelEndpoint>>>;
     isArchived: z.ZodOptional<z.ZodBoolean>;
+    pinned: z.ZodOptional<z.ZodBoolean>;
     title: z.ZodDefault<z.ZodUnion<[z.ZodNullable<z.ZodString>, z.ZodLiteral<"New Chat">]>>;
     user: z.ZodOptional<z.ZodString>;
     messages: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -5284,6 +5365,7 @@ export declare const anthropicSchema: z.ZodCatch<z.ZodEffects<z.ZodObject<Pick<{
     maxContextTokens: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodNumber, z.ZodString]>, number | undefined, string | number>>;
     max_tokens: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodNumber, z.ZodString]>, number | undefined, string | number>>;
     promptCache: z.ZodOptional<z.ZodBoolean>;
+    promptCacheTtl: z.ZodOptional<z.ZodEnum<["5m", "1h"]>>;
     system: z.ZodOptional<z.ZodString>;
     thinking: z.ZodOptional<z.ZodBoolean>;
     thinkingBudget: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodNumber, z.ZodString]>, number | undefined, string | number>>;
@@ -5357,7 +5439,7 @@ export declare const anthropicSchema: z.ZodCatch<z.ZodEffects<z.ZodObject<Pick<{
     resendImages: z.ZodOptional<z.ZodBoolean>;
     /** @deprecated Prefer `modelLabel` over `chatGptLabel` */
     chatGptLabel: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-}, "model" | "modelLabel" | "promptPrefix" | "temperature" | "topP" | "topK" | "maxOutputTokens" | "maxContextTokens" | "promptCache" | "thinking" | "thinkingBudget" | "stream" | "artifacts" | "chatProjectId" | "resendFiles" | "effort" | "thinkingDisplay" | "web_search" | "stop" | "greeting" | "spec" | "iconURL" | "fileTokenLimit">, "strip", z.ZodTypeAny, {
+}, "model" | "modelLabel" | "promptPrefix" | "temperature" | "topP" | "topK" | "maxOutputTokens" | "maxContextTokens" | "promptCache" | "promptCacheTtl" | "thinking" | "thinkingBudget" | "stream" | "artifacts" | "chatProjectId" | "resendFiles" | "effort" | "thinkingDisplay" | "web_search" | "stop" | "greeting" | "spec" | "iconURL" | "fileTokenLimit">, "strip", z.ZodTypeAny, {
     model?: string | null | undefined;
     modelLabel?: string | null | undefined;
     promptPrefix?: string | null | undefined;
@@ -5367,6 +5449,7 @@ export declare const anthropicSchema: z.ZodCatch<z.ZodEffects<z.ZodObject<Pick<{
     maxOutputTokens?: number | null | undefined;
     maxContextTokens?: number | undefined;
     promptCache?: boolean | undefined;
+    promptCacheTtl?: "5m" | "1h" | undefined;
     thinking?: boolean | undefined;
     thinkingBudget?: number | undefined;
     stream?: boolean | undefined;
@@ -5391,6 +5474,7 @@ export declare const anthropicSchema: z.ZodCatch<z.ZodEffects<z.ZodObject<Pick<{
     maxOutputTokens?: string | number | null | undefined;
     maxContextTokens?: string | number | undefined;
     promptCache?: boolean | undefined;
+    promptCacheTtl?: "5m" | "1h" | undefined;
     thinking?: boolean | undefined;
     thinkingBudget?: string | number | undefined;
     stream?: boolean | undefined;
@@ -5415,6 +5499,7 @@ export declare const anthropicSchema: z.ZodCatch<z.ZodEffects<z.ZodObject<Pick<{
     maxOutputTokens?: number | null | undefined;
     maxContextTokens?: number | undefined;
     promptCache?: boolean | undefined;
+    promptCacheTtl?: "5m" | "1h" | undefined;
     thinking?: boolean | undefined;
     thinkingBudget?: number | undefined;
     stream?: boolean | undefined;
@@ -5439,6 +5524,7 @@ export declare const anthropicSchema: z.ZodCatch<z.ZodEffects<z.ZodObject<Pick<{
     maxOutputTokens?: string | number | null | undefined;
     maxContextTokens?: string | number | undefined;
     promptCache?: boolean | undefined;
+    promptCacheTtl?: "5m" | "1h" | undefined;
     thinking?: boolean | undefined;
     thinkingBudget?: string | number | undefined;
     stream?: boolean | undefined;
@@ -5488,6 +5574,7 @@ export declare const compactAgentsBaseSchema: z.ZodObject<Pick<{
     endpoint: z.ZodNullable<z.ZodNativeEnum<typeof EModelEndpoint>>;
     endpointType: z.ZodOptional<z.ZodNullable<z.ZodNativeEnum<typeof EModelEndpoint>>>;
     isArchived: z.ZodOptional<z.ZodBoolean>;
+    pinned: z.ZodOptional<z.ZodBoolean>;
     title: z.ZodDefault<z.ZodUnion<[z.ZodNullable<z.ZodString>, z.ZodLiteral<"New Chat">]>>;
     user: z.ZodOptional<z.ZodString>;
     messages: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -5568,6 +5655,7 @@ export declare const compactAgentsBaseSchema: z.ZodObject<Pick<{
     maxContextTokens: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodNumber, z.ZodString]>, number | undefined, string | number>>;
     max_tokens: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodNumber, z.ZodString]>, number | undefined, string | number>>;
     promptCache: z.ZodOptional<z.ZodBoolean>;
+    promptCacheTtl: z.ZodOptional<z.ZodEnum<["5m", "1h"]>>;
     system: z.ZodOptional<z.ZodString>;
     thinking: z.ZodOptional<z.ZodBoolean>;
     thinkingBudget: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodNumber, z.ZodString]>, number | undefined, string | number>>;
@@ -5663,6 +5751,7 @@ export declare const compactAgentsSchema: z.ZodCatch<z.ZodEffects<z.ZodObject<Pi
     endpoint: z.ZodNullable<z.ZodNativeEnum<typeof EModelEndpoint>>;
     endpointType: z.ZodOptional<z.ZodNullable<z.ZodNativeEnum<typeof EModelEndpoint>>>;
     isArchived: z.ZodOptional<z.ZodBoolean>;
+    pinned: z.ZodOptional<z.ZodBoolean>;
     title: z.ZodDefault<z.ZodUnion<[z.ZodNullable<z.ZodString>, z.ZodLiteral<"New Chat">]>>;
     user: z.ZodOptional<z.ZodString>;
     messages: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -5743,6 +5832,7 @@ export declare const compactAgentsSchema: z.ZodCatch<z.ZodEffects<z.ZodObject<Pi
     maxContextTokens: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodNumber, z.ZodString]>, number | undefined, string | number>>;
     max_tokens: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodNumber, z.ZodString]>, number | undefined, string | number>>;
     promptCache: z.ZodOptional<z.ZodBoolean>;
+    promptCacheTtl: z.ZodOptional<z.ZodEnum<["5m", "1h"]>>;
     system: z.ZodOptional<z.ZodString>;
     thinking: z.ZodOptional<z.ZodBoolean>;
     thinkingBudget: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodNumber, z.ZodString]>, number | undefined, string | number>>;

package/dist/types/types/agents.d.ts

@@ -1,4 +1,5 @@
 import type { FunctionToolCall, SummaryContentPart } from './assistants';
+import type { TTokenUsageEvent, TContextUsageEvent } from './runs';
 import type { TAttachment, TPlugin } from 'src/schemas';
 import { StepTypes, ContentTypes, ToolCallTypes } from './runs';
 export declare namespace Agents {
@@ -202,6 +203,10 @@ export declare namespace Agents {
             data?: unknown;
             [key: string]: unknown;
         }>;
+        /** Cumulative provider-reported usage for the run; backfills usage totals on resume */
+        collectedUsage?: TTokenUsageEvent[];
+        /** Latest context window snapshot; restores the usage gauge on resume */
+        contextUsage?: TContextUsageEvent;
     }
     /**
      * Represents a run step delta i.e. any changed fields on a run step during

package/dist/types/types/mutations.d.ts

@@ -111,6 +111,7 @@ export type RevertAgentVersionVariables = {
 export type RevertAgentVersionOptions = MutationOptions<Agent, RevertAgentVersionVariables>;
 export type DeleteConversationOptions = MutationOptions<types.TDeleteConversationResponse, types.TDeleteConversationRequest>;
 export type ArchiveConversationOptions = MutationOptions<types.TArchiveConversationResponse, types.TArchiveConversationRequest>;
+export type PinConversationOptions = MutationOptions<types.TPinConversationResponse, types.TPinConversationRequest>;
 export type DuplicateConvoOptions = MutationOptions<types.TDuplicateConvoResponse, types.TDuplicateConvoRequest>;
 export type ForkConvoOptions = MutationOptions<types.TForkConvoResponse, types.TForkConvoRequest>;
 export type CreateSharedLinkOptions = MutationOptions<types.TSharedLink, Partial<types.TSharedLink>>;