librechat-data-provider 0.8.521 → 0.8.523

package/dist/types/code/worker.d.ts

@@ -0,0 +1,10 @@
+import type { TCodeEnvironmentPairingResponse } from '../types';
+export type CodeWorkerShell = 'posix' | 'powershell';
+export type CodeWorkerPairing = TCodeEnvironmentPairingResponse['pairing'];
+export interface CodeWorkerRunOptions {
+    defaultWorkspace?: boolean;
+    allowWorkspaceWrites?: boolean;
+    allowWorkspaceCommands?: boolean;
+}
+export declare function isCodeWorkerShell(value: string): value is CodeWorkerShell;
+export declare function createCodeWorkerSetupCommand(pairing: CodeWorkerPairing, shell: CodeWorkerShell, options?: CodeWorkerRunOptions): string;

package/dist/types/code/workspace.d.ts

@@ -0,0 +1,28 @@
+export declare const CODE_WORKSPACE_ID_PATTERN: RegExp;
+/** Protocol-v1 ceiling enforced by the worker and Code API. */
+export declare const CODE_WORKSPACE_MAX_COUNT = 32;
+/** API/client protocol for immutable conversation-owned environment decisions. */
+export declare const CODE_ENVIRONMENT_DECISION_VERSION: 1;
+export declare const CODE_WORKSPACE_OPERATIONS: readonly ["read_file", "search_text", "list_files", "write_file", "preview_edit", "edit_file", "execute_command"];
+export declare const CODE_WORKSPACE_SELECTION_ERROR_REASONS: readonly ["required", "invalid", "worker_unavailable", "unsupported", "missing", "locked"];
+export declare const CODE_ENVIRONMENT_MODES: readonly ["attached", "without_attached"];
+export type CodeWorkspaceOperation = (typeof CODE_WORKSPACE_OPERATIONS)[number];
+export type CodeWorkspaceSelectionErrorReason = (typeof CODE_WORKSPACE_SELECTION_ERROR_REASONS)[number];
+export type CodeEnvironmentMode = (typeof CODE_ENVIRONMENT_MODES)[number];
+/** Public, path-free description of one root registered by an attached worker. */
+export interface CodeWorkspaceDescriptor {
+    id: string;
+    name?: string;
+    /** Omitted when every worker-level operation applies to this workspace. */
+    operations?: CodeWorkspaceOperation[];
+}
+/** Conversation-owned selection, bound to the environment that advertised it. */
+export interface CodeWorkspaceSelection {
+    environmentId: string;
+    workspaceId: string;
+}
+export declare function isCodeEnvironmentMode(value: unknown): value is CodeEnvironmentMode;
+export declare function isCodeWorkspaceSelectionErrorReason(value: unknown): value is CodeWorkspaceSelectionErrorReason;
+export declare function isCodeWorkspaceSelection(value: unknown): value is CodeWorkspaceSelection;
+/** One exact workspace per attached environment used by a conversation. */
+export declare function isCodeWorkspaceSelections(value: unknown): value is CodeWorkspaceSelection[];

package/dist/types/codeEnvRef.d.ts

@@ -50,7 +50,20 @@ interface CodeEnvRefBase {
     id: string;
     storage_session_id: string;
     file_id: string;
+    /** Code API deployment that owns this storage pointer. Legacy refs omit
+     *  the field and are treated as `default`; new writes always persist it. */
+    executionProfile?: CodeExecutionProfile;
+    /** Deployment-specific namespace. Configured stateful environments share
+     * the same wire profile, so this key prevents their file IDs from being
+     * reused against a different Code API server. */
+    executionRouteKey?: string;
+    /** Epoch ms when the file was uploaded to the code env; drives the liveness
+     *  fast-path (distinct from the usage-bumped `updatedAt`). */
+    provisionedAt?: number;
+    /** Actual destination used when uploading this storage object. */
+    sandboxFilename?: string;
 }
+export type CodeExecutionProfile = 'default' | 'stateful';
 export type CodeEnvRef = (CodeEnvRefBase & {
     kind: 'skill';
     version: number;
@@ -59,4 +72,17 @@ export type CodeEnvRef = (CodeEnvRefBase & {
 }) | (CodeEnvRefBase & {
     kind: 'user';
 });
+/** Deployment-local pointers for a resource that may be used by both Code API profiles. */
+export type CodeEnvRefMap = Partial<Record<string, CodeEnvRef>>;
+export interface CodeEnvReferenceSet {
+    /** Compatibility pointer for readers that have not adopted profile-aware refs yet. */
+    codeEnvRef?: CodeEnvRef;
+    /** Canonical deployment-local pointers, keyed by trusted execution profile. */
+    codeEnvRefs?: CodeEnvRefMap;
+}
+export declare function getCodeEnvRefForProfile(refs: CodeEnvReferenceSet | null | undefined, routeKey: string): CodeEnvRef | undefined;
+/** Adds one profile pointer without discarding the other profile's storage object. */
+export declare function mergeCodeEnvRef(refs: CodeEnvReferenceSet | null | undefined, ref: CodeEnvRef): Required<Pick<CodeEnvReferenceSet, 'codeEnvRef' | 'codeEnvRefs'>>;
+/** Enumerates every deployment-local pointer, including legacy single-pointer records. */
+export declare function getCodeEnvRefs(refs: CodeEnvReferenceSet | null | undefined): Array<[string, CodeEnvRef]>;
 export {};