Enhanced ChatGPT Clone: Features Agents, MCP, Skills, DeepSeek, Anthropic, AWS, OpenAI, Responses API, Azure, Groq, o1, GPT-5, Mistral, OpenRouter, Vertex AI, Gemini, Artifacts, AI model switching, message search, Code Interpreter, langchain, DALL-E-3, OpenAPI Actions, Functions, Secure Multi-User Auth, Presets, open-source for self-hosting. Active
TypeScript aianthropicartifactsawsazurechatgptchatgpt-cloneclaudeclonedeepseekgeminigooglegpt-5librechatmcpo1openairesponses-apivisionwebui
import type {
SubagentDigest,
SubagentDigestNode,
BackgroundTaskDelivery,
} from 'librechat-data-provider';
import type { WakeupTaskStatus } from './wakeup';
export function formatBackgroundCodeOutput(output: string): string {
if (output.length > 64_000 || !output.includes('\n')) {
return output;
}
const lines = output.split('\n');
if (lines.length > 500) {
return output;
}
return lines
.map((line) => {
const trimmed = line.trim();
if (
trimmed.length < 2 ||
trimmed.length > 8_000 ||
!(
(trimmed.startsWith('{') && trimmed.endsWith('}')) ||
(trimmed.startsWith('[') && trimmed.endsWith(']'))
)
) {
return line;
}
try {
const value: unknown = JSON.parse(trimmed);
if (value == null || typeof value !== 'object') {
return line;
}
const indent = line.slice(0, line.length - line.trimStart().length);
return `${indent}${JSON.stringify(value, null, 2).replace(/\n/g, `\n${indent}`)}`;
} catch {
return line;
}
})
.join('\n');
}
export type BackgroundTaskStatus =
| WakeupTaskStatus
| 'running'
| 'stopping'
| 'accepted'
| 'claimed'
| 'not_running'
| 'control_not_found'
| 'dispatched'
| 'failed'
| 'interrupted';
export type BackgroundTaskView = {
taskId: string;
toolName: string;
status: BackgroundTaskStatus;
result?: string;
error?: string;
note?: string;
message?: string;
subagentType?: string;
resultAvailable?: boolean;
resultClaimed?: boolean;
delivery?: BackgroundTaskDelivery;
/** Durable child thread of a subagent task, for opening its activity panel. */
threadId?: string;
/** Folded progress tree of a subagent task. */
activity?: SubagentDigest;
};
export type BackgroundTaskDisplay =
| { kind: 'task'; task: BackgroundTaskView }
| {
kind: 'list';
tasks: BackgroundTaskView[];
partial: boolean;
warning?: string;
message?: string;
}
| { kind: 'notice'; message: string; status: string };
const PENDING_NOTICES = new Set(['delivery_scheduled', 'result_persisting']);
/** The poll step succeeding is not proof that its underlying task or control succeeded. */
export function backgroundTaskOutcome(
display: BackgroundTaskDisplay | null,
): 'failed' | 'cancelled' | undefined {
if (display == null) {
return;
}
if (display.kind === 'notice') {
if (display.status === 'cancelled') {
return 'cancelled';
}
return PENDING_NOTICES.has(display.status) ? undefined : 'failed';
}
if (display.kind === 'list') {
return display.partial || display.warning ? 'failed' : undefined;
}
const status = display.task.status;
if (status === 'cancelled') {
return 'cancelled';
}
return status === 'error' ||
status === 'failed' ||
status === 'interrupted' ||
status === 'not_running' ||
status === 'control_not_found'
? 'failed'
: undefined;
}
const isRecord = (value: unknown): value is Record<string, unknown> =>
value != null && typeof value === 'object' && !Array.isArray(value);
const optionalString = (value: unknown): value is string | undefined =>
value === undefined || typeof value === 'string';
const taskStatus = (value: unknown): BackgroundTaskStatus | null => {
if (value === 'cancellation_requested') {
return 'stopping';
}
if (
value === 'running' ||
value === 'accepted' ||
value === 'claimed' ||
value === 'not_running' ||
value === 'control_not_found' ||
value === 'completed' ||
value === 'error' ||
value === 'cancelled' ||
value === 'dispatched' ||
value === 'failed' ||
value === 'interrupted'
) {
return value;
}
return null;
};
const deliveryStatus = (value: unknown): value is BackgroundTaskDelivery | undefined =>
value === undefined || value === 'pending' || value === 'failed' || value === 'delivered';
const DIGEST_KINDS = new Set(['turn', 'range', 'tool', 'text']);
const DIGEST_STATUSES = new Set(['running', 'ok', 'error', 'cancelled']);
const DIGEST_PATH = /^\d+(?:\.\d+)*(?:-\d+)?$/;
const MAX_DIGEST_NODES = 200;
const count = (value: unknown): value is number =>
typeof value === 'number' && Number.isFinite(value) && value >= 0;
const boundedText = (value: unknown, maxChars: number): string | undefined =>
typeof value === 'string' && value !== '' ? value.slice(0, maxChars) : undefined;
function parseDigestNode(value: unknown): SubagentDigestNode | null {
if (
!isRecord(value) ||
typeof value.path !== 'string' ||
value.path.length > 64 ||
!DIGEST_PATH.test(value.path) ||
typeof value.kind !== 'string' ||
!DIGEST_KINDS.has(value.kind)
) {
return null;
}
const name = boundedText(value.name, 128);
const label = boundedText(value.label, 256);
const summary = boundedText(value.summary, 512);
return {
path: value.path,
kind: value.kind as SubagentDigestNode['kind'],
...(typeof value.status === 'string' && DIGEST_STATUSES.has(value.status)
? { status: value.status as SubagentDigestNode['status'] }
: {}),
...(name == null ? {} : { name }),
...(label == null ? {} : { label }),
...(summary == null ? {} : { summary }),
...(count(value.ms) ? { ms: value.ms } : {}),
...(count(value.chars) ? { chars: value.chars } : {}),
...(count(value.errors) && value.errors > 0 ? { errors: value.errors } : {}),
...(value.folded === true ? { folded: true as const } : {}),
...(value.evicted === true ? { evicted: true as const } : {}),
};
}
/** Progress is optional decoration: a malformed digest is dropped, never the card. */
function parseDigest(value: unknown): SubagentDigest | undefined {
if (
!isRecord(value) ||
!count(value.turns) ||
!count(value.tools) ||
!count(value.errors) ||
!Array.isArray(value.nodes) ||
value.nodes.length > MAX_DIGEST_NODES
) {
return undefined;
}
const nodes = value.nodes.map(parseDigestNode);
if (nodes.some((node) => node == null)) {
return undefined;
}
const active = boundedText(value.active, 64);
return {
turns: value.turns,
tools: value.tools,
errors: value.errors,
nodes: nodes as SubagentDigestNode[],
...(active != null && DIGEST_PATH.test(active) ? { active } : {}),
...(value.phase === 'thinking' ? { phase: 'thinking' as const } : {}),
...(count(value.idle_ms) ? { idle_ms: value.idle_ms } : {}),
...(value.truncated === true ? { truncated: true as const } : {}),
};
}
function parseTask(value: unknown): BackgroundTaskView | null {
if (!isRecord(value)) {
return null;
}
const status = taskStatus(value.status);
if (
typeof value.background_task_id !== 'string' ||
value.background_task_id === '' ||
typeof value.tool !== 'string' ||
value.tool === '' ||
status == null ||
!optionalString(value.result) ||
!optionalString(value.error) ||
!optionalString(value.note) ||
!optionalString(value.message) ||
!optionalString(value.subagent_type) ||
(value.result_available != null && typeof value.result_available !== 'boolean') ||
(value.result_claimed != null && typeof value.result_claimed !== 'boolean') ||
!deliveryStatus(value.delivery)
) {
return null;
}
return {
taskId: value.background_task_id,
toolName: value.tool,
status: status === 'running' && value.cancellation_requested === true ? 'stopping' : status,
...(typeof value.result === 'string' ? { result: value.result } : {}),
...(typeof value.error === 'string' ? { error: value.error } : {}),
...(typeof value.note === 'string' ? { note: value.note } : {}),
...(typeof value.message === 'string' ? { message: value.message } : {}),
...(typeof value.subagent_type === 'string' ? { subagentType: value.subagent_type } : {}),
...(value.result_available === true ? { resultAvailable: true } : {}),
...(value.result_claimed === true ? { resultClaimed: true } : {}),
...(value.delivery != null ? { delivery: value.delivery } : {}),
...(typeof value.subagent_thread_id === 'string' && value.subagent_thread_id !== ''
? { threadId: value.subagent_thread_id }
: {}),
...withDigest(value.activity),
};
}
function withDigest(value: unknown): Pick<BackgroundTaskView, 'activity'> {
const activity = value == null ? undefined : parseDigest(value);
return activity == null ? {} : { activity };
}
/** Only host-shaped results become cards. Unknown or partial output stays visible as raw tool output. */
export function parseBackgroundTaskOutput(output?: string | null): BackgroundTaskDisplay | null {
if (!output || output.length > 2_000_000) {
return null;
}
const text = output.trim();
if (!text.startsWith('{') || !text.endsWith('}')) {
return null;
}
let payload: unknown;
try {
payload = JSON.parse(text) as unknown;
} catch {
return null;
}
if (!isRecord(payload)) {
return null;
}
if ('tasks' in payload && !Array.isArray(payload.tasks)) {
return null;
}
if (Array.isArray(payload.tasks)) {
const tasks = payload.tasks.map(parseTask);
if (tasks.some((task) => task == null)) {
return null;
}
return {
kind: 'list',
tasks: tasks as BackgroundTaskView[],
partial: payload.partial === true,
...(typeof payload.warning === 'string' ? { warning: payload.warning } : {}),
...(typeof payload.message === 'string' ? { message: payload.message } : {}),
};
}
const task = parseTask(payload);
if (task != null) {
return { kind: 'task', task };
}
if (typeof payload.status === 'string' && typeof payload.message === 'string') {
return { kind: 'notice', status: payload.status, message: payload.message };
}
return null;
}