mirror of
https://github.com/danny-avila/LibreChat.git
synced 2026-07-04 05:13:52 +00:00
c67e2b54dc
* feat: Mint CodeAPI auth tokens * style: Format CodeAPI download route * fix: Prune CodeAPI token cache * fix: Propagate CodeAPI managed auth * test: Mock CodeAPI auth in traversal suite * fix: Pass auth context to invoked skill cache * feat: Mint CodeAPI plan context * chore: Refresh CodeAPI auth guidance * fix: Guard OpenID JWT fallback * fix: Default CodeAPI JWT tenant in single-tenant mode * chore: Update @librechat/agents to version 3.1.84 in package-lock.json and package.json files * chore: Standardize references to Code API in comments and tests
59 lines
2.6 KiB
TypeScript
59 lines
2.6 KiB
TypeScript
/**
|
|
* 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 const CODE_ENV_KINDS = ['skill', 'agent', 'user'] as const;
|
|
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' });
|