@mcoda/codali 0.1.88 → 0.1.89

package/dist/gateway/GatewayTraceReplay.d.ts

@@ -0,0 +1,120 @@
+import type { CodaliContextPack, CodaliEvidenceItem, CodaliGatewayRequest, CodaliGatewayTraceEvent } from "./CodaliGatewayTypes.js";
+import { type CodaliGatewayRunTrace, type CodaliGatewayStore, type CodaliGatewayStoredArtifact, type CodaliGatewayStoredModelCall, type CodaliGatewayStoredTask, type CodaliGatewayStoredToolCall } from "./CodaliGatewayStore.js";
+export declare const CODALI_GATEWAY_TRACE_SCHEMA_VERSION: 1;
+export declare const CODALI_GATEWAY_REPLAY_FIXTURE_SCHEMA_VERSION: 1;
+export declare const CODALI_GATEWAY_TRACE_EVENT_NAMES: {
+    readonly RUN_CREATED: "codali.gateway.run.created";
+    readonly RUN_STATUS: "codali.gateway.run.status";
+    readonly TASK_STATUS: "codali.gateway.task.status";
+    readonly TOOL_CALL: "codali.gateway.tool.call";
+    readonly MODEL_CALL: "codali.gateway.model.call";
+    readonly EVIDENCE_RECORDED: "codali.gateway.evidence.recorded";
+    readonly CONTEXT_PACK_BUILT: "codali.gateway.context_pack.built";
+    readonly ARTIFACT_CREATED: "codali.gateway.artifact.created";
+    readonly FINAL_SYNTHESIS: "codali.gateway.final_synthesis";
+};
+export interface CodaliGatewayDebugSummary {
+    runId: string;
+    status: string;
+    mode?: string;
+    product?: string;
+    tenantId?: string;
+    tenantSlug?: string;
+    conversationId?: string;
+    taskCount: number;
+    evidenceCount: number;
+    toolCallCount: number;
+    modelCallCount: number;
+    artifactCount: number;
+    sourceCount: number;
+    calledTools: string[];
+    failedTools: string[];
+    modelRoles: string[];
+    finalModel?: {
+        role: string;
+        agentSlug?: string;
+        model?: string;
+        provider?: string;
+        status: string;
+    };
+    warnings: string[];
+    errors: string[];
+}
+export interface CodaliGatewayTraceReadResult {
+    schemaVersion: typeof CODALI_GATEWAY_TRACE_SCHEMA_VERSION;
+    runId: string;
+    status: string;
+    run: CodaliGatewayRunTrace["run"];
+    tasks: CodaliGatewayStoredTask[];
+    evidence: CodaliEvidenceItem[];
+    toolCalls: CodaliGatewayStoredToolCall[];
+    modelCalls: CodaliGatewayStoredModelCall[];
+    contextPack?: CodaliContextPack;
+    artifacts: CodaliGatewayStoredArtifact[];
+    finalAnswer?: string;
+    debugSummary: CodaliGatewayDebugSummary;
+    events: CodaliGatewayTraceEvent[];
+}
+export interface CodaliGatewayTraceReadInput {
+    store: CodaliGatewayStore;
+    runId: string;
+}
+export interface CodaliGatewayReplayFixtureToolCall {
+    id: string;
+    taskId?: string;
+    tool: string;
+    status: string;
+    args?: unknown;
+    result?: unknown;
+    errorCode?: string;
+    errorMessage?: string;
+    latencyMs?: number;
+}
+export interface CodaliGatewayReplayFixtureModelCall {
+    id: string;
+    taskId?: string;
+    role: string;
+    status: string;
+    agentSlug?: string;
+    model?: string;
+    provider?: string;
+    input?: unknown;
+    output?: unknown;
+    errorCode?: string;
+    errorMessage?: string;
+    latencyMs?: number;
+}
+export interface CodaliGatewayReplayFixture {
+    schemaVersion: typeof CODALI_GATEWAY_REPLAY_FIXTURE_SCHEMA_VERSION;
+    fixtureId: string;
+    runId: string;
+    exportedAt: string;
+    request?: CodaliGatewayRequest | Record<string, unknown>;
+    planner: {
+        classifierOutput?: unknown;
+        plannerOutput?: unknown;
+    };
+    contextPack?: CodaliContextPack;
+    evidence: CodaliEvidenceItem[];
+    toolFixtures: CodaliGatewayReplayFixtureToolCall[];
+    modelFixtures: CodaliGatewayReplayFixtureModelCall[];
+    finalAnswer?: string;
+    debugSummary: CodaliGatewayDebugSummary;
+    events: CodaliGatewayTraceEvent[];
+}
+export interface CodaliGatewayReplayFixtureOptions {
+    fixtureId?: string;
+    includeModelInputs?: boolean;
+    includeModelOutputs?: boolean;
+    includeToolResults?: boolean;
+}
+export interface CodaliGatewayReplayFixtureInput {
+    store: CodaliGatewayStore;
+    runId: string;
+    options?: CodaliGatewayReplayFixtureOptions;
+}
+export declare const summarizeCodaliGatewayTrace: (trace: CodaliGatewayRunTrace) => CodaliGatewayDebugSummary;
+export declare const buildCodaliGatewayTraceEvents: (trace: CodaliGatewayRunTrace | undefined) => CodaliGatewayTraceEvent[];
+export declare const readCodaliGatewayTrace: ({ store, runId, }: CodaliGatewayTraceReadInput) => Promise<CodaliGatewayTraceReadResult | undefined>;
+export declare const exportCodaliGatewayReplayFixture: ({ store, runId, options, }: CodaliGatewayReplayFixtureInput) => Promise<CodaliGatewayReplayFixture | undefined>;
+//# sourceMappingURL=GatewayTraceReplay.d.ts.map

package/dist/gateway/GatewayTraceReplay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GatewayTraceReplay.d.ts","sourceRoot":"","sources":["../../src/gateway/GatewayTraceReplay.ts"],"names":[],"mappings":"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"}

package/dist/gateway/GatewayTraceReplay.js

@@ -0,0 +1,273 @@
+import { randomUUID } from "node:crypto";
+import { redactCodaliGatewaySecrets, } from "./CodaliGatewayStore.js";
+export const CODALI_GATEWAY_TRACE_SCHEMA_VERSION = 1;
+export const CODALI_GATEWAY_REPLAY_FIXTURE_SCHEMA_VERSION = 1;
+export const CODALI_GATEWAY_TRACE_EVENT_NAMES = {
+    RUN_CREATED: "codali.gateway.run.created",
+    RUN_STATUS: "codali.gateway.run.status",
+    TASK_STATUS: "codali.gateway.task.status",
+    TOOL_CALL: "codali.gateway.tool.call",
+    MODEL_CALL: "codali.gateway.model.call",
+    EVIDENCE_RECORDED: "codali.gateway.evidence.recorded",
+    CONTEXT_PACK_BUILT: "codali.gateway.context_pack.built",
+    ARTIFACT_CREATED: "codali.gateway.artifact.created",
+    FINAL_SYNTHESIS: "codali.gateway.final_synthesis",
+};
+const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+const cloneRedacted = (value) => redactCodaliGatewaySecrets(value);
+const uniqueInOrder = (values) => {
+    const seen = new Set();
+    const output = [];
+    for (const value of values) {
+        if (!value || seen.has(value)) {
+            continue;
+        }
+        seen.add(value);
+        output.push(value);
+    }
+    return output;
+};
+const metadataString = (metadata, key) => {
+    const value = metadata?.[key];
+    return typeof value === "string" && value.length > 0 ? value : undefined;
+};
+const requestMode = (request, metadata) => {
+    if (isRecord(request) && typeof request.mode === "string") {
+        return request.mode;
+    }
+    return metadataString(metadata, "mode");
+};
+const requestProduct = (request, metadata) => {
+    if (isRecord(request) && isRecord(request.product)) {
+        const productName = request.product.name;
+        if (typeof productName === "string" && productName.length > 0) {
+            return productName;
+        }
+    }
+    return metadataString(metadata, "product");
+};
+const requestTenantValue = (request, key) => {
+    if (!isRecord(request) || !isRecord(request.tenant)) {
+        return undefined;
+    }
+    const value = request.tenant[key];
+    return typeof value === "string" && value.length > 0 ? value : undefined;
+};
+const requestConversationId = (request) => {
+    if (!isRecord(request) || !isRecord(request.conversation)) {
+        return undefined;
+    }
+    const value = request.conversation.id;
+    return typeof value === "string" && value.length > 0 ? value : undefined;
+};
+const collectSourceIds = (contextPack) => {
+    if (!contextPack) {
+        return [];
+    }
+    return uniqueInOrder([
+        ...contextPack.decisionFacts.map((fact) => fact.sourceId),
+        ...contextPack.decisionFacts.map((fact) => fact.sourceUri),
+        ...contextPack.selectedExcerpts.map((excerpt) => excerpt.evidenceId),
+    ]);
+};
+const finalModelCall = (modelCalls) => [...modelCalls]
+    .reverse()
+    .find((call) => call.role === "final_synthesizer")
+    ?? [...modelCalls].reverse().find((call) => call.role === "final");
+const finalAnswerFromTrace = (modelCalls) => {
+    const call = finalModelCall(modelCalls);
+    return typeof call?.output === "string" ? call.output : undefined;
+};
+const event = (kind, message, metadata, timestamp) => ({
+    kind,
+    timestamp: timestamp ?? new Date(0).toISOString(),
+    message,
+    metadata: cloneRedacted(metadata),
+});
+export const summarizeCodaliGatewayTrace = (trace) => {
+    const metadata = trace.run.metadata;
+    const finalCall = finalModelCall(trace.modelCalls);
+    return {
+        runId: trace.run.runId,
+        status: trace.run.status,
+        mode: requestMode(trace.run.request, metadata),
+        product: requestProduct(trace.run.request, metadata),
+        tenantId: requestTenantValue(trace.run.request, "id"),
+        tenantSlug: requestTenantValue(trace.run.request, "slug"),
+        conversationId: requestConversationId(trace.run.request),
+        taskCount: trace.tasks.length,
+        evidenceCount: trace.evidence.length,
+        toolCallCount: trace.toolCalls.length,
+        modelCallCount: trace.modelCalls.length,
+        artifactCount: trace.artifacts.length,
+        sourceCount: collectSourceIds(trace.contextPack).length,
+        calledTools: uniqueInOrder(trace.toolCalls.map((call) => call.tool)),
+        failedTools: uniqueInOrder(trace.toolCalls
+            .filter((call) => call.status !== "success")
+            .map((call) => call.tool)),
+        modelRoles: uniqueInOrder(trace.modelCalls.map((call) => call.role)),
+        finalModel: finalCall
+            ? {
+                role: finalCall.role,
+                agentSlug: finalCall.agentSlug,
+                model: finalCall.model,
+                provider: finalCall.provider,
+                status: finalCall.status,
+            }
+            : undefined,
+        warnings: [...trace.run.warnings],
+        errors: [...trace.run.errors],
+    };
+};
+export const buildCodaliGatewayTraceEvents = (trace) => {
+    if (!trace) {
+        return [];
+    }
+    const events = [
+        event(CODALI_GATEWAY_TRACE_EVENT_NAMES.RUN_CREATED, "Gateway run created", { runId: trace.run.runId, status: trace.run.status }, trace.run.createdAt),
+        event(CODALI_GATEWAY_TRACE_EVENT_NAMES.RUN_STATUS, "Gateway run status updated", { runId: trace.run.runId, status: trace.run.status }, trace.run.updatedAt),
+    ];
+    for (const task of trace.tasks) {
+        events.push(event(CODALI_GATEWAY_TRACE_EVENT_NAMES.TASK_STATUS, "Gateway task status updated", {
+            runId: trace.run.runId,
+            taskId: task.id,
+            status: task.status,
+            workerRole: task.workerRole,
+        }, task.updatedAt));
+    }
+    if (trace.evidence.length > 0) {
+        events.push(event(CODALI_GATEWAY_TRACE_EVENT_NAMES.EVIDENCE_RECORDED, "Gateway evidence recorded", {
+            runId: trace.run.runId,
+            evidenceCount: trace.evidence.length,
+            evidenceIds: trace.evidence.map((item) => item.id),
+        }, trace.run.updatedAt));
+    }
+    for (const call of trace.toolCalls) {
+        events.push(event(CODALI_GATEWAY_TRACE_EVENT_NAMES.TOOL_CALL, "Gateway tool call recorded", {
+            runId: trace.run.runId,
+            toolCallId: call.id,
+            taskId: call.taskId,
+            tool: call.tool,
+            status: call.status,
+            latencyMs: call.latencyMs,
+            errorCode: call.errorCode,
+        }, call.endedAt ?? call.startedAt));
+    }
+    for (const call of trace.modelCalls) {
+        events.push(event(CODALI_GATEWAY_TRACE_EVENT_NAMES.MODEL_CALL, "Gateway model call recorded", {
+            runId: trace.run.runId,
+            modelCallId: call.id,
+            taskId: call.taskId,
+            role: call.role,
+            status: call.status,
+            agentSlug: call.agentSlug,
+            model: call.model,
+            provider: call.provider,
+            latencyMs: call.latencyMs,
+            errorCode: call.errorCode,
+        }, call.endedAt ?? call.startedAt));
+    }
+    if (trace.contextPack) {
+        events.push(event(CODALI_GATEWAY_TRACE_EVENT_NAMES.CONTEXT_PACK_BUILT, "Gateway context pack built", {
+            runId: trace.run.runId,
+            contextPackId: trace.contextPack.id,
+            evidenceCount: trace.contextPack.decisionFacts.length,
+            tokenEstimate: trace.contextPack.tokenEstimate,
+            sourceCount: collectSourceIds(trace.contextPack).length,
+        }, trace.run.updatedAt));
+    }
+    for (const artifact of trace.artifacts) {
+        events.push(event(CODALI_GATEWAY_TRACE_EVENT_NAMES.ARTIFACT_CREATED, "Gateway artifact created", {
+            runId: trace.run.runId,
+            artifactId: artifact.id,
+            taskId: artifact.taskId,
+            type: artifact.type,
+            uri: artifact.uri,
+            path: artifact.path,
+            model: artifact.model,
+        }, artifact.createdAt));
+    }
+    const finalCall = finalModelCall(trace.modelCalls);
+    if (finalCall || isRecord(trace.run.metadata?.finalSynthesis)) {
+        events.push(event(CODALI_GATEWAY_TRACE_EVENT_NAMES.FINAL_SYNTHESIS, "Gateway final synthesis recorded", {
+            runId: trace.run.runId,
+            modelCallId: finalCall?.id,
+            status: finalCall?.status ?? trace.run.status,
+            finalSynthesis: trace.run.metadata?.finalSynthesis,
+        }, finalCall?.endedAt ?? trace.run.updatedAt));
+    }
+    return events;
+};
+export const readCodaliGatewayTrace = async ({ store, runId, }) => {
+    const trace = await store.readRunTrace(runId);
+    if (!trace) {
+        return undefined;
+    }
+    const redacted = cloneRedacted(trace);
+    const debugSummary = summarizeCodaliGatewayTrace(redacted);
+    return {
+        schemaVersion: CODALI_GATEWAY_TRACE_SCHEMA_VERSION,
+        runId,
+        status: redacted.run.status,
+        run: redacted.run,
+        tasks: redacted.tasks,
+        evidence: redacted.evidence,
+        toolCalls: redacted.toolCalls,
+        modelCalls: redacted.modelCalls,
+        contextPack: redacted.contextPack,
+        artifacts: redacted.artifacts,
+        finalAnswer: finalAnswerFromTrace(redacted.modelCalls),
+        debugSummary,
+        events: buildCodaliGatewayTraceEvents(redacted),
+    };
+};
+export const exportCodaliGatewayReplayFixture = async ({ store, runId, options = {}, }) => {
+    const trace = await readCodaliGatewayTrace({ store, runId });
+    if (!trace) {
+        return undefined;
+    }
+    const classifierCall = trace.modelCalls.find((call) => call.role === "classifier");
+    const plannerCall = trace.modelCalls.find((call) => call.role === "planner");
+    const includeModelOutputs = options.includeModelOutputs === true;
+    return cloneRedacted({
+        schemaVersion: CODALI_GATEWAY_REPLAY_FIXTURE_SCHEMA_VERSION,
+        fixtureId: options.fixtureId ?? `gateway-replay-${randomUUID()}`,
+        runId: trace.runId,
+        exportedAt: new Date().toISOString(),
+        request: trace.run.request,
+        planner: {
+            classifierOutput: includeModelOutputs ? classifierCall?.output : undefined,
+            plannerOutput: includeModelOutputs ? plannerCall?.output : undefined,
+        },
+        contextPack: trace.contextPack,
+        evidence: trace.evidence,
+        toolFixtures: trace.toolCalls.map((call) => ({
+            id: call.id,
+            taskId: call.taskId,
+            tool: call.tool,
+            status: call.status,
+            args: call.args,
+            result: options.includeToolResults === false ? undefined : call.result,
+            errorCode: call.errorCode,
+            errorMessage: call.errorMessage,
+            latencyMs: call.latencyMs,
+        })),
+        modelFixtures: trace.modelCalls.map((call) => ({
+            id: call.id,
+            taskId: call.taskId,
+            role: call.role,
+            status: call.status,
+            agentSlug: call.agentSlug,
+            model: call.model,
+            provider: call.provider,
+            input: options.includeModelInputs === true ? call.input : undefined,
+            output: includeModelOutputs ? call.output : undefined,
+            errorCode: call.errorCode,
+            errorMessage: call.errorMessage,
+            latencyMs: call.latencyMs,
+        })),
+        finalAnswer: includeModelOutputs ? trace.finalAnswer : undefined,
+        debugSummary: trace.debugSummary,
+        events: trace.events,
+    });
+};

package/dist/gateway/ToolCapabilityCompiler.d.ts

@@ -0,0 +1,50 @@
+import type { CodaliRuntimeAppToolContract, CodaliRuntimeAppToolGatewayContract, CodaliRuntimeDocdexInput, CodaliRuntimeToolManifest } from "../runtime/CodaliRuntime.js";
+import type { CodaliGatewayPolicy, CodaliGatewayToolRiskCategory } from "./CodaliGatewayTypes.js";
+export type CodaliGatewayToolCapabilityKind = "actual" | "virtual" | "app_contract" | "app_gateway" | "builtin";
+export type CodaliGatewayToolCapabilityStatus = "allowed" | "denied" | "skipped";
+export interface CodaliGatewayCompilerIssue {
+    code: string;
+    message: string;
+    tool?: string;
+    severity: "warning" | "error";
+    details?: Record<string, unknown>;
+}
+export interface CodaliGatewaySkippedTool {
+    name: string;
+    reason: string;
+    details?: Record<string, unknown>;
+}
+export interface CodaliGatewayCompiledToolCapability {
+    name: string;
+    kind: CodaliGatewayToolCapabilityKind;
+    status: CodaliGatewayToolCapabilityStatus;
+    readOnly: boolean;
+    riskCategory: CodaliGatewayToolRiskCategory;
+    approvalRequired: boolean;
+    backingTools: string[];
+    reasons: string[];
+}
+export interface ToolCapabilityCompilerInput {
+    policy: CodaliGatewayPolicy;
+    docdex?: CodaliRuntimeDocdexInput;
+    tools?: CodaliRuntimeToolManifest;
+    requiredDocdexOperations?: string[];
+    allowedBackingTools?: string[];
+}
+export interface ToolCapabilityCompilation {
+    allowedTools: string[];
+    deniedTools: string[];
+    visibleTools: string[];
+    appVirtualTools: string[];
+    appToolContracts: Record<string, CodaliRuntimeAppToolContract>;
+    appToolGateway?: CodaliRuntimeAppToolGatewayContract;
+    capabilities: CodaliGatewayCompiledToolCapability[];
+    skippedTools: CodaliGatewaySkippedTool[];
+    warnings: CodaliGatewayCompilerIssue[];
+    errors: CodaliGatewayCompilerIssue[];
+    requiredDocdexOperations: string[];
+}
+export declare const CODALI_GATEWAY_READ_ONLY_BACKING_TOOLS: readonly ["docdex_search", "docdex_batch_search", "docdex_open", "docdex_files", "docdex_tree", "docdex_stats"];
+export declare const CODALI_GATEWAY_RESERVED_TOOL_ARG_KEYS: readonly ["apiKey", "api_key", "baseUrl", "base_url", "credentialSource", "credential_source", "docdex", "repo", "repoId", "repo_id", "repoRoot", "repo_root", "tenant", "tenantId", "tenant_id"];
+export declare const compileToolCapabilities: (input: ToolCapabilityCompilerInput) => ToolCapabilityCompilation;
+//# sourceMappingURL=ToolCapabilityCompiler.d.ts.map

package/dist/gateway/ToolCapabilityCompiler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolCapabilityCompiler.d.ts","sourceRoot":"","sources":["../../src/gateway/ToolCapabilityCompiler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,4BAA4B,EAE5B,mCAAmC,EACnC,wBAAwB,EACxB,yBAAyB,EAC1B,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EACV,mBAAmB,EACnB,6BAA6B,EAC9B,MAAM,yBAAyB,CAAC;AAEjC,MAAM,MAAM,+BAA+B,GACvC,QAAQ,GACR,SAAS,GACT,cAAc,GACd,aAAa,GACb,SAAS,CAAC;AAEd,MAAM,MAAM,iCAAiC,GACzC,SAAS,GACT,QAAQ,GACR,SAAS,CAAC;AAEd,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,SAAS,GAAG,OAAO,CAAC;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,mCAAmC;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,+BAA+B,CAAC;IACtC,MAAM,EAAE,iCAAiC,CAAC;IAC1C,QAAQ,EAAE,OAAO,CAAC;IAClB,YAAY,EAAE,6BAA6B,CAAC;IAC5C,gBAAgB,EAAE,OAAO,CAAC;IAC1B,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,2BAA2B;IAC1C,MAAM,EAAE,mBAAmB,CAAC;IAC5B,MAAM,CAAC,EAAE,wBAAwB,CAAC;IAClC,KAAK,CAAC,EAAE,yBAAyB,CAAC;IAClC,wBAAwB,CAAC,EAAE,MAAM,EAAE,CAAC;IACpC,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;CAChC;AAED,MAAM,WAAW,yBAAyB;IACxC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,4BAA4B,CAAC,CAAC;IAC/D,cAAc,CAAC,EAAE,mCAAmC,CAAC;IACrD,YAAY,EAAE,mCAAmC,EAAE,CAAC;IACpD,YAAY,EAAE,wBAAwB,EAAE,CAAC;IACzC,QAAQ,EAAE,0BAA0B,EAAE,CAAC;IACvC,MAAM,EAAE,0BAA0B,EAAE,CAAC;IACrC,wBAAwB,EAAE,MAAM,EAAE,CAAC;CACpC;AAED,eAAO,MAAM,sCAAsC,iHAOzC,CAAC;AAEX,eAAO,MAAM,qCAAqC,mMAgBxC,CAAC;AAqVX,eAAO,MAAM,uBAAuB,GAClC,OAAO,2BAA2B,KACjC,yBAkRF,CAAC"}