Skip to content

A desktop coding agent with free access to frontier models.

TypeScript
1.8 KB
Raw Blame
export type McpAppDiagnosticStage =
  | "resource-resolution"
  | "sandbox-proxy"
  | "resource-delivery"
  | "app-initialization"
  | "tool-result-delivery"

export type McpAppDiagnostic = {
  code: string
  causeCode?: string
  stage: McpAppDiagnosticStage
  message: string
  toolName: string
  resourceUri?: string
  sandboxOrigin?: string
  elapsedMs: number
  checkpoints: string[]
  sandboxDocument?: {
    readyState: string | null
    hasHtmlRoot: boolean | null
    scriptCount: number | null
  }
}

export function safeMcpAppDiagnosticMessage(cause: unknown, fallback: string): string {
  const raw = cause instanceof Error ? cause.message : typeof cause === "string" ? cause : fallback
  return raw
    .replace(/Bearer\s+[^\s]+/giu, "Bearer [redacted]")
    .replace(/([?&](?:token|access_token|authorization)=)[^&#\s]+/giu, "$1[redacted]")
    .replace(/[\r\n\t]+/gu, " ")
    .slice(0, 500)
}

export function formatMcpAppDiagnostic(diagnostic: McpAppDiagnostic): string {
  const document = diagnostic.sandboxDocument
  return [
    `Code: ${diagnostic.code}`,
    diagnostic.causeCode ? `Cause code: ${diagnostic.causeCode}` : null,
    `Stage: ${diagnostic.stage}`,
    `Message: ${diagnostic.message}`,
    `Tool: ${diagnostic.toolName}`,
    diagnostic.resourceUri ? `Resource: ${diagnostic.resourceUri}` : null,
    diagnostic.sandboxOrigin ? `Sandbox origin: ${diagnostic.sandboxOrigin}` : null,
    `Elapsed: ${diagnostic.elapsedMs} ms`,
    document ? `Document: readyState=${document.readyState ?? "unknown"}, htmlRoot=${document.hasHtmlRoot ?? "unknown"}, scripts=${document.scriptCount ?? "unknown"}` : null,
    `Checkpoints: ${diagnostic.checkpoints.length ? diagnostic.checkpoints.join(" -> ") : "none"}`,
  ].filter((line): line is string => line !== null).join("\n")
}