UNPKG

@copilotkit/shared

Version:

<img src="https://github.com/user-attachments/assets/0a6b64d9-e193-4940-a3f6-60334ac34084" alt="banner" style="border-radius: 12px; border: 2px solid #d6d4fa;" />

1 lines 2.17 kB
{"version":3,"file":"debug.cjs","names":[],"sources":["../src/debug.ts"],"sourcesContent":["/**\n * Granular debug configuration for CopilotKit runtime and client.\n * Pass `true` to enable events + lifecycle logging (but NOT verbose payloads),\n * or an object for granular control including `verbose: true` for full payloads.\n */\nexport type DebugConfig =\n | boolean\n | {\n /** Log every event emitted/received. Default: true */\n events?: boolean;\n /** Log request/run lifecycle. Default: true */\n lifecycle?: boolean;\n /** Log full event payloads instead of summaries. Default: false — must be explicitly opted in */\n verbose?: boolean;\n };\n\n/** Normalized debug configuration — all fields resolved to booleans. */\nexport interface ResolvedDebugConfig {\n enabled: boolean;\n events: boolean;\n lifecycle: boolean;\n verbose: boolean;\n}\n\n/** The all-off config used when debug is falsy. */\nconst DEBUG_OFF: ResolvedDebugConfig = {\n enabled: false,\n events: false,\n lifecycle: false,\n verbose: false,\n};\n\n/**\n * Normalizes a DebugConfig value into a ResolvedDebugConfig.\n *\n * - `false` / `undefined` → all off\n * - `true` → events + lifecycle on, verbose off (no PII in logs)\n * - object → merges with defaults (events: true, lifecycle: true, verbose: false)\n */\nexport function resolveDebugConfig(\n debug: DebugConfig | undefined,\n): ResolvedDebugConfig {\n if (!debug) return DEBUG_OFF;\n\n if (debug === true) {\n return { enabled: true, events: true, lifecycle: true, verbose: false };\n }\n\n const events = debug.events ?? true;\n const lifecycle = debug.lifecycle ?? true;\n const enabled = events || lifecycle;\n const verbose = enabled && (debug.verbose ?? false);\n\n return { enabled, events, lifecycle, verbose };\n}\n"],"mappings":";;;AAyBA,MAAM,YAAiC;CACrC,SAAS;CACT,QAAQ;CACR,WAAW;CACX,SAAS;CACV;;;;;;;;AASD,SAAgB,mBACd,OACqB;AACrB,KAAI,CAAC,MAAO,QAAO;AAEnB,KAAI,UAAU,KACZ,QAAO;EAAE,SAAS;EAAM,QAAQ;EAAM,WAAW;EAAM,SAAS;EAAO;CAGzE,MAAM,SAAS,MAAM,UAAU;CAC/B,MAAM,YAAY,MAAM,aAAa;CACrC,MAAM,UAAU,UAAU;AAG1B,QAAO;EAAE;EAAS;EAAQ;EAAW,SAFrB,YAAY,MAAM,WAAW;EAEC"}