librechat-data-provider 0.8.500 → 0.8.502

package/dist/types/accessPermissions.d.ts

@@ -38,7 +38,8 @@ export declare enum ResourceType {
     AGENT = "agent",
     PROMPTGROUP = "promptGroup",
     MCPSERVER = "mcpServer",
-    REMOTE_AGENT = "remoteAgent"
+    REMOTE_AGENT = "remoteAgent",
+    SKILL = "skill"
 }
 /**
  * Permission bit constants for bitwise operations
@@ -68,7 +69,10 @@ export declare enum AccessRoleIds {
     MCPSERVER_OWNER = "mcpServer_owner",
     REMOTE_AGENT_VIEWER = "remoteAgent_viewer",
     REMOTE_AGENT_EDITOR = "remoteAgent_editor",
-    REMOTE_AGENT_OWNER = "remoteAgent_owner"
+    REMOTE_AGENT_OWNER = "remoteAgent_owner",
+    SKILL_VIEWER = "skill_viewer",
+    SKILL_EDITOR = "skill_editor",
+    SKILL_OWNER = "skill_owner"
 }
 /**
  * Principal schema - represents a user, group, role, or public access

package/dist/types/api-endpoints.d.ts

@@ -89,6 +89,7 @@ export declare const files: () => string;
 export declare const fileUpload: () => string;
 export declare const fileDelete: () => string;
 export declare const fileDownload: (userId: string, fileId: string) => string;
+export declare const filePreview: (fileId: string) => string;
 export declare const fileConfig: () => string;
 export declare const agentFiles: (agentId: string) => string;
 export declare const images: () => string;
@@ -116,6 +117,22 @@ export declare const deletePrompt: ({ _id, groupId }: {
 }) => string;
 export declare const getCategories: () => string;
 export declare const getAllPromptGroups: () => string;
+export declare const skills: () => string;
+export declare const importSkill: () => string;
+export declare const getSkill: (id: string) => string;
+export declare const listSkillsWithFilters: (filter: Record<string, string | number | undefined | null>) => string;
+export declare const skillFiles: (id: string) => string;
+export declare const skillFile: (id: string, relativePath: string) => string;
+/**
+ * Skill filesystem tree (phase 2). URL shape mirrors the original UI PR so
+ * the tree hooks keep their call surface. `path` is pre-encoded by the
+ * caller (e.g. `${nodeId}/content`).
+ */
+export declare const skillTree: ({ skillId, path }: {
+    skillId: string;
+    path?: string | undefined;
+}) => string;
+export declare const skillStates: () => string;
 export declare const roles: () => string;
 export declare const adminRoles: () => string;
 export declare const getRole: (roleName: string) => string;
@@ -126,6 +143,7 @@ export declare const updatePeoplePickerPermissions: (roleName: string) => string
 export declare const updateMCPServersPermissions: (roleName: string) => string;
 export declare const updateRemoteAgentsPermissions: (roleName: string) => string;
 export declare const updateMarketplacePermissions: (roleName: string) => string;
+export declare const updateSkillPermissions: (roleName: string) => string;
 export declare const conversationTags: (tag?: string) => string;
 export declare const conversationTagsList: (pageNumber: string, sort?: string, order?: string) => string;
 export declare const addTagToConversation: (conversationId: string) => string;

package/dist/types/balance.d.ts

@@ -0,0 +1,3 @@
+export declare const REFILL_INTERVAL_UNITS: readonly ["seconds", "minutes", "hours", "days", "weeks", "months"];
+export type RefillIntervalUnit = (typeof REFILL_INTERVAL_UNITS)[number];
+export declare function getRefillEligibilityDate(lastRefill: Date, value: number, unit: RefillIntervalUnit): Date;

package/dist/types/balance.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/bedrock.d.ts

@@ -1,8 +1,22 @@
 import { z } from 'zod';
 import * as s from './schemas';
+export declare const BEDROCK_OUTPUT_128K_BETA = "output-128k-2025-02-19";
+export declare const BEDROCK_FINE_GRAINED_TOOL_STREAMING_BETA = "fine-grained-tool-streaming-2025-05-14";
+export declare function resolveThinkingDisplay(model: string, explicit?: s.ThinkingDisplay | string | null): s.ThinkingDisplayWireValue | undefined;
 /** Checks if a model supports adaptive thinking (Opus 4.6+, Sonnet 4.6+) */
 export declare function supportsAdaptiveThinking(model: string): boolean;
-/** Checks if a model qualifies for the context-1m beta header (Sonnet 4+, Opus 4.6+, Opus 5+) */
+/**
+ * Checks if a model omits `thinking` content from responses by default.
+ *
+ * Starting with Claude Opus 4.7, the Messages API returns empty `thinking`
+ * blocks unless the request explicitly opts in via `thinking.display =
+ * "summarized"`. This helper narrows the opt-in to Opus 4.7+ (and any future
+ * major Opus version) so older adaptive-thinking models are left untouched.
+ *
+ * See https://platform.claude.com/docs/en/about-claude/models/whats-new-claude-4-7#thinking-content-omitted-by-default
+ */
+export declare function omitsThinkingByDefault(model: string): boolean;
+/** Checks if a model has a 1M context window (Sonnet 4.6+, Opus 4.6+, Opus 5+) */
 export declare function supportsContext1m(model: string): boolean;
 export declare const bedrockInputSchema: z.ZodCatch<z.ZodEffects<z.ZodObject<Pick<{
     conversationId: z.ZodNullable<z.ZodString>;
@@ -131,6 +145,7 @@ export declare const bedrockInputSchema: z.ZodCatch<z.ZodEffects<z.ZodObject<Pic
     verbosity: z.ZodNullable<z.ZodOptional<z.ZodNativeEnum<typeof s.Verbosity>>>;
     useResponsesApi: z.ZodOptional<z.ZodBoolean>;
     effort: z.ZodNullable<z.ZodOptional<z.ZodNativeEnum<typeof s.AnthropicEffort>>>;
+    thinkingDisplay: z.ZodNullable<z.ZodOptional<z.ZodNativeEnum<typeof s.ThinkingDisplay>>>;
     web_search: z.ZodOptional<z.ZodBoolean>;
     disableStreaming: z.ZodOptional<z.ZodBoolean>;
     assistant_id: z.ZodOptional<z.ZodString>;
@@ -198,7 +213,8 @@ export declare const bedrockInputSchema: z.ZodCatch<z.ZodEffects<z.ZodObject<Pic
     fileTokenLimit: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodNumber, z.ZodString]>, number | undefined, string | number>>;
     resendImages: z.ZodOptional<z.ZodBoolean>;
     chatGptLabel: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-}, "modelLabel" | "model" | "promptPrefix" | "temperature" | "topP" | "topK" | "maxOutputTokens" | "maxContextTokens" | "promptCache" | "system" | "thinking" | "thinkingBudget" | "artifacts" | "resendFiles" | "reasoning_effort" | "effort" | "region" | "maxTokens" | "additionalModelRequestFields" | "stop" | "greeting" | "spec" | "iconURL">, "strip", z.ZodTypeAny, {
+}, "thinking" | "modelLabel" | "model" | "promptPrefix" | "temperature" | "topP" | "topK" | "maxOutputTokens" | "maxContextTokens" | "promptCache" | "system" | "thinkingBudget" | "artifacts" | "resendFiles" | "reasoning_effort" | "effort" | "thinkingDisplay" | "region" | "maxTokens" | "additionalModelRequestFields" | "stop" | "greeting" | "spec" | "iconURL">, "strip", z.ZodTypeAny, {
+    thinking?: boolean | undefined;
     modelLabel?: string | null | undefined;
     model?: string | null | undefined;
     promptPrefix?: string | null | undefined;
@@ -209,12 +225,12 @@ export declare const bedrockInputSchema: z.ZodCatch<z.ZodEffects<z.ZodObject<Pic
     maxContextTokens?: number | undefined;
     promptCache?: boolean | undefined;
     system?: string | undefined;
-    thinking?: boolean | undefined;
     thinkingBudget?: number | undefined;
     artifacts?: string | undefined;
     resendFiles?: boolean | undefined;
     reasoning_effort?: s.ReasoningEffort | null | undefined;
     effort?: s.AnthropicEffort | null | undefined;
+    thinkingDisplay?: s.ThinkingDisplay | null | undefined;
     region?: string | undefined;
     maxTokens?: number | undefined;
     additionalModelRequestFields?: (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | any | {
@@ -247,6 +263,7 @@ export declare const bedrockInputSchema: z.ZodCatch<z.ZodEffects<z.ZodObject<Pic
     spec?: string | null | undefined;
     iconURL?: string | null | undefined;
 }, {
+    thinking?: boolean | undefined;
     modelLabel?: string | null | undefined;
     model?: string | null | undefined;
     promptPrefix?: string | null | undefined;
@@ -257,12 +274,12 @@ export declare const bedrockInputSchema: z.ZodCatch<z.ZodEffects<z.ZodObject<Pic
     maxContextTokens?: string | number | undefined;
     promptCache?: boolean | undefined;
     system?: string | undefined;
-    thinking?: boolean | undefined;
     thinkingBudget?: string | number | undefined;
     artifacts?: string | undefined;
     resendFiles?: boolean | undefined;
     reasoning_effort?: s.ReasoningEffort | null | undefined;
     effort?: s.AnthropicEffort | null | undefined;
+    thinkingDisplay?: s.ThinkingDisplay | null | undefined;
     region?: string | undefined;
     maxTokens?: string | number | undefined;
     additionalModelRequestFields?: (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | any | {
@@ -295,6 +312,7 @@ export declare const bedrockInputSchema: z.ZodCatch<z.ZodEffects<z.ZodObject<Pic
     spec?: string | null | undefined;
     iconURL?: string | null | undefined;
 }>, Partial<{
+    thinking?: boolean | undefined;
     modelLabel?: string | null | undefined;
     model?: string | null | undefined;
     promptPrefix?: string | null | undefined;
@@ -305,12 +323,12 @@ export declare const bedrockInputSchema: z.ZodCatch<z.ZodEffects<z.ZodObject<Pic
     maxContextTokens?: number | undefined;
     promptCache?: boolean | undefined;
     system?: string | undefined;
-    thinking?: boolean | undefined;
     thinkingBudget?: number | undefined;
     artifacts?: string | undefined;
     resendFiles?: boolean | undefined;
     reasoning_effort?: s.ReasoningEffort | null | undefined;
     effort?: s.AnthropicEffort | null | undefined;
+    thinkingDisplay?: s.ThinkingDisplay | null | undefined;
     region?: string | undefined;
     maxTokens?: number | undefined;
     additionalModelRequestFields?: (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | any | {
@@ -343,6 +361,7 @@ export declare const bedrockInputSchema: z.ZodCatch<z.ZodEffects<z.ZodObject<Pic
     spec?: string | null | undefined;
     iconURL?: string | null | undefined;
 }>, {
+    thinking?: boolean | undefined;
     modelLabel?: string | null | undefined;
     model?: string | null | undefined;
     promptPrefix?: string | null | undefined;
@@ -353,12 +372,12 @@ export declare const bedrockInputSchema: z.ZodCatch<z.ZodEffects<z.ZodObject<Pic
     maxContextTokens?: string | number | undefined;
     promptCache?: boolean | undefined;
     system?: string | undefined;
-    thinking?: boolean | undefined;
     thinkingBudget?: string | number | undefined;
     artifacts?: string | undefined;
     resendFiles?: boolean | undefined;
     reasoning_effort?: s.ReasoningEffort | null | undefined;
     effort?: s.AnthropicEffort | null | undefined;
+    thinkingDisplay?: s.ThinkingDisplay | null | undefined;
     region?: string | undefined;
     maxTokens?: string | number | undefined;
     additionalModelRequestFields?: (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | any | {
@@ -519,6 +538,7 @@ export declare const bedrockInputParser: z.ZodCatch<z.ZodEffects<z.ZodObject<Pic
     verbosity: z.ZodNullable<z.ZodOptional<z.ZodNativeEnum<typeof s.Verbosity>>>;
     useResponsesApi: z.ZodOptional<z.ZodBoolean>;
     effort: z.ZodNullable<z.ZodOptional<z.ZodNativeEnum<typeof s.AnthropicEffort>>>;
+    thinkingDisplay: z.ZodNullable<z.ZodOptional<z.ZodNativeEnum<typeof s.ThinkingDisplay>>>;
     web_search: z.ZodOptional<z.ZodBoolean>;
     disableStreaming: z.ZodOptional<z.ZodBoolean>;
     assistant_id: z.ZodOptional<z.ZodString>;
@@ -586,7 +606,7 @@ export declare const bedrockInputParser: z.ZodCatch<z.ZodEffects<z.ZodObject<Pic
     fileTokenLimit: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodNumber, z.ZodString]>, number | undefined, string | number>>;
     resendImages: z.ZodOptional<z.ZodBoolean>;
     chatGptLabel: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-}, "modelLabel" | "model" | "promptPrefix" | "temperature" | "topP" | "topK" | "maxOutputTokens" | "maxContextTokens" | "promptCache" | "thinking" | "thinkingBudget" | "artifacts" | "resendFiles" | "reasoning_effort" | "effort" | "region" | "maxTokens" | "additionalModelRequestFields" | "stop" | "greeting" | "spec" | "iconURL">, "strip", z.ZodAny, z.objectOutputType<Pick<{
+}, "thinking" | "modelLabel" | "model" | "promptPrefix" | "temperature" | "topP" | "topK" | "maxOutputTokens" | "maxContextTokens" | "promptCache" | "thinkingBudget" | "artifacts" | "resendFiles" | "reasoning_effort" | "effort" | "thinkingDisplay" | "region" | "maxTokens" | "additionalModelRequestFields" | "stop" | "greeting" | "spec" | "iconURL">, "strip", z.ZodAny, z.objectOutputType<Pick<{
     conversationId: z.ZodNullable<z.ZodString>;
     endpoint: z.ZodNullable<z.ZodNativeEnum<typeof s.EModelEndpoint>>;
     endpointType: z.ZodOptional<z.ZodNullable<z.ZodNativeEnum<typeof s.EModelEndpoint>>>;
@@ -713,6 +733,7 @@ export declare const bedrockInputParser: z.ZodCatch<z.ZodEffects<z.ZodObject<Pic
     verbosity: z.ZodNullable<z.ZodOptional<z.ZodNativeEnum<typeof s.Verbosity>>>;
     useResponsesApi: z.ZodOptional<z.ZodBoolean>;
     effort: z.ZodNullable<z.ZodOptional<z.ZodNativeEnum<typeof s.AnthropicEffort>>>;
+    thinkingDisplay: z.ZodNullable<z.ZodOptional<z.ZodNativeEnum<typeof s.ThinkingDisplay>>>;
     web_search: z.ZodOptional<z.ZodBoolean>;
     disableStreaming: z.ZodOptional<z.ZodBoolean>;
     assistant_id: z.ZodOptional<z.ZodString>;
@@ -780,7 +801,7 @@ export declare const bedrockInputParser: z.ZodCatch<z.ZodEffects<z.ZodObject<Pic
     fileTokenLimit: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodNumber, z.ZodString]>, number | undefined, string | number>>;
     resendImages: z.ZodOptional<z.ZodBoolean>;
     chatGptLabel: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-}, "modelLabel" | "model" | "promptPrefix" | "temperature" | "topP" | "topK" | "maxOutputTokens" | "maxContextTokens" | "promptCache" | "thinking" | "thinkingBudget" | "artifacts" | "resendFiles" | "reasoning_effort" | "effort" | "region" | "maxTokens" | "additionalModelRequestFields" | "stop" | "greeting" | "spec" | "iconURL">, z.ZodAny, "strip">, z.objectInputType<Pick<{
+}, "thinking" | "modelLabel" | "model" | "promptPrefix" | "temperature" | "topP" | "topK" | "maxOutputTokens" | "maxContextTokens" | "promptCache" | "thinkingBudget" | "artifacts" | "resendFiles" | "reasoning_effort" | "effort" | "thinkingDisplay" | "region" | "maxTokens" | "additionalModelRequestFields" | "stop" | "greeting" | "spec" | "iconURL">, z.ZodAny, "strip">, z.objectInputType<Pick<{
     conversationId: z.ZodNullable<z.ZodString>;
     endpoint: z.ZodNullable<z.ZodNativeEnum<typeof s.EModelEndpoint>>;
     endpointType: z.ZodOptional<z.ZodNullable<z.ZodNativeEnum<typeof s.EModelEndpoint>>>;
@@ -907,6 +928,7 @@ export declare const bedrockInputParser: z.ZodCatch<z.ZodEffects<z.ZodObject<Pic
     verbosity: z.ZodNullable<z.ZodOptional<z.ZodNativeEnum<typeof s.Verbosity>>>;
     useResponsesApi: z.ZodOptional<z.ZodBoolean>;
     effort: z.ZodNullable<z.ZodOptional<z.ZodNativeEnum<typeof s.AnthropicEffort>>>;
+    thinkingDisplay: z.ZodNullable<z.ZodOptional<z.ZodNativeEnum<typeof s.ThinkingDisplay>>>;
     web_search: z.ZodOptional<z.ZodBoolean>;
     disableStreaming: z.ZodOptional<z.ZodBoolean>;
     assistant_id: z.ZodOptional<z.ZodString>;
@@ -974,7 +996,8 @@ export declare const bedrockInputParser: z.ZodCatch<z.ZodEffects<z.ZodObject<Pic
     fileTokenLimit: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodNumber, z.ZodString]>, number | undefined, string | number>>;
     resendImages: z.ZodOptional<z.ZodBoolean>;
     chatGptLabel: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-}, "modelLabel" | "model" | "promptPrefix" | "temperature" | "topP" | "topK" | "maxOutputTokens" | "maxContextTokens" | "promptCache" | "thinking" | "thinkingBudget" | "artifacts" | "resendFiles" | "reasoning_effort" | "effort" | "region" | "maxTokens" | "additionalModelRequestFields" | "stop" | "greeting" | "spec" | "iconURL">, z.ZodAny, "strip">>, Partial<{
+}, "thinking" | "modelLabel" | "model" | "promptPrefix" | "temperature" | "topP" | "topK" | "maxOutputTokens" | "maxContextTokens" | "promptCache" | "thinkingBudget" | "artifacts" | "resendFiles" | "reasoning_effort" | "effort" | "thinkingDisplay" | "region" | "maxTokens" | "additionalModelRequestFields" | "stop" | "greeting" | "spec" | "iconURL">, z.ZodAny, "strip">>, Partial<{
+    thinking?: boolean | undefined;
     modelLabel?: string | null | undefined;
     model?: string | null | undefined;
     promptPrefix?: string | null | undefined;
@@ -985,12 +1008,12 @@ export declare const bedrockInputParser: z.ZodCatch<z.ZodEffects<z.ZodObject<Pic
     maxContextTokens?: number | undefined;
     promptCache?: boolean | undefined;
     system?: string | undefined;
-    thinking?: boolean | undefined;
     thinkingBudget?: number | undefined;
     artifacts?: string | undefined;
     resendFiles?: boolean | undefined;
     reasoning_effort?: s.ReasoningEffort | null | undefined;
     effort?: s.AnthropicEffort | null | undefined;
+    thinkingDisplay?: s.ThinkingDisplay | null | undefined;
     region?: string | undefined;
     maxTokens?: number | undefined;
     additionalModelRequestFields?: (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | any | {
@@ -1149,6 +1172,7 @@ export declare const bedrockInputParser: z.ZodCatch<z.ZodEffects<z.ZodObject<Pic
     verbosity: z.ZodNullable<z.ZodOptional<z.ZodNativeEnum<typeof s.Verbosity>>>;
     useResponsesApi: z.ZodOptional<z.ZodBoolean>;
     effort: z.ZodNullable<z.ZodOptional<z.ZodNativeEnum<typeof s.AnthropicEffort>>>;
+    thinkingDisplay: z.ZodNullable<z.ZodOptional<z.ZodNativeEnum<typeof s.ThinkingDisplay>>>;
     web_search: z.ZodOptional<z.ZodBoolean>;
     disableStreaming: z.ZodOptional<z.ZodBoolean>;
     assistant_id: z.ZodOptional<z.ZodString>;
@@ -1216,5 +1240,5 @@ export declare const bedrockInputParser: z.ZodCatch<z.ZodEffects<z.ZodObject<Pic
     fileTokenLimit: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodNumber, z.ZodString]>, number | undefined, string | number>>;
     resendImages: z.ZodOptional<z.ZodBoolean>;
     chatGptLabel: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-}, "modelLabel" | "model" | "promptPrefix" | "temperature" | "topP" | "topK" | "maxOutputTokens" | "maxContextTokens" | "promptCache" | "thinking" | "thinkingBudget" | "artifacts" | "resendFiles" | "reasoning_effort" | "effort" | "region" | "maxTokens" | "additionalModelRequestFields" | "stop" | "greeting" | "spec" | "iconURL">, z.ZodAny, "strip">>>;
+}, "thinking" | "modelLabel" | "model" | "promptPrefix" | "temperature" | "topP" | "topK" | "maxOutputTokens" | "maxContextTokens" | "promptCache" | "thinkingBudget" | "artifacts" | "resendFiles" | "reasoning_effort" | "effort" | "thinkingDisplay" | "region" | "maxTokens" | "additionalModelRequestFields" | "stop" | "greeting" | "spec" | "iconURL">, z.ZodAny, "strip">>>;
 export declare const bedrockOutputParser: (data: Record<string, unknown>) => Record<string, unknown>;

package/dist/types/cloudfront-config.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/codeEnvRef.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Closed set of resource kinds for sandbox file caching. Defined as a
+ * `as const` tuple so the runtime list and the TypeScript union can't
+ * drift on future additions — adding a new kind to the tuple updates
+ * both at once.
+ *
+ * - `skill`: shared per skill identity. Cross-user-within-tenant
+ *   sharing. Code API sessionKey omits the user dimension.
+ *   `version` is required (the skill's monotonic counter scopes the
+ *   cache per revision so any edit invalidates the prior cache
+ *   entry naturally).
+ * - `agent`: shared per agent identity. Same sharing semantic as
+ *   skills (agents are addressable resources accessible to a
+ *   permission-defined audience).
+ * - `user`: user-private. Code API sessionKey is keyed by the
+ *   requesting user from auth context. Used for chat attachments
+ *   and code-output artifacts.
+ */
+export declare const CODE_ENV_KINDS: readonly ["skill", "agent", "user"];
+export type CodeEnvKind = (typeof CODE_ENV_KINDS)[number];
+/**
+ * Typed reference to a file in the code-execution sandbox.
+ *
+ * `storage_session_id` is intentionally distinct from the *execution*
+ * session id at the top level of an execute response — they are
+ * different concepts that historically shared the field name
+ * `session_id`. This is the long-lived storage session keyed by the
+ * resource's identity (skill/agent/user), not the transient
+ * sandbox-run session.
+ *
+ * `kind` and `id` together name the resource that owns this file's
+ * storage session. Code API uses them (plus the auth-context tenant
+ * id) to derive the sessionKey, which determines who shares the
+ * cache. Cross-user sharing for shared resources (skills, agents) is
+ * a designed property of the kind switch, not an emergent side
+ * effect. See codeapi #1455 / agents #148 / LC #12960.
+ *
+ * `version` is statically required when `kind === 'skill'` and
+ * statically forbidden otherwise via the discriminated union below —
+ * the constraint is enforced at compile time, not just by codeapi's
+ * runtime validator.
+ */
+interface CodeEnvRefBase {
+    /** Resource identity. Semantics depend on `kind`:
+     *  - `skill`: skill `_id` (sessionKey-meaningful, cross-user shared).
+     *  - `agent`: agent id (sessionKey-meaningful, cross-user shared).
+     *  - `user`: informational only — sessionKey derivation uses the
+     *    requesting user from auth context. Kept on the type for shape
+     *    uniformity across kinds; do not rely on it for routing. */
+    id: string;
+    storage_session_id: string;
+    file_id: string;
+}
+export type CodeEnvRef = (CodeEnvRefBase & {
+    kind: 'skill';
+    version: number;
+}) | (CodeEnvRefBase & {
+    kind: 'agent';
+}) | (CodeEnvRefBase & {
+    kind: 'user';
+});
+export {};

package/dist/types/codeEnvRef.spec.d.ts

@@ -0,0 +1 @@
+export {};