@taxdao/fintax-mcp 0.2.0

package/dist/policies/idempotency.js

@@ -0,0 +1,155 @@
+import { FinTaxError } from '../errors/fintax-error.js';
+import { hashOperationValue } from './operation-plan.js';
+const DEFAULT_TTL_MS = 24 * 60 * 60 * 1000;
+const DEFAULT_MAX_ENTRIES = 10_000;
+function storedFailure(error) {
+    return {
+        code: error.code,
+        message: error.message,
+        retryable: error.retryable,
+        fieldErrors: error.fieldErrors,
+        ...(error.status === undefined ? {} : { status: error.status }),
+        ...(error.recovery === undefined ? {} : { recovery: error.recovery }),
+    };
+}
+function restoreFailure(failure) {
+    return new FinTaxError(failure.code, failure.message, {
+        retryable: failure.retryable,
+        fieldErrors: failure.fieldErrors,
+        ...(failure.status === undefined ? {} : { status: failure.status }),
+        ...(failure.recovery === undefined ? {} : { recovery: failure.recovery }),
+    });
+}
+export class IdempotencyManager {
+    #locks;
+    #ttlMs;
+    #maxEntries;
+    #now;
+    #records = new Map();
+    constructor(locks, options = {}) {
+        this.#locks = locks;
+        this.#ttlMs = options.ttlMs ?? DEFAULT_TTL_MS;
+        this.#maxEntries = options.maxEntries ?? DEFAULT_MAX_ENTRIES;
+        this.#now = options.now ?? Date.now;
+    }
+    begin(binding) {
+        const scope = this.#scope(binding);
+        return this.#locks.withLock(`idempotency:${digestScope(scope)}`, () => {
+            const now = this.#now();
+            this.#prune(now);
+            const existing = this.#records.get(scope);
+            if (existing === undefined) {
+                this.#records.set(scope, {
+                    state: 'in_progress',
+                    fingerprint: binding.fingerprint,
+                    ...(binding.recovery === undefined
+                        ? {}
+                        : { recovery: binding.recovery }),
+                    updatedAt: now,
+                });
+                return Promise.resolve({ kind: 'started' });
+            }
+            if (existing.fingerprint !== binding.fingerprint) {
+                throw new FinTaxError('CONFLICT', 'The idempotency key was used for a different operation; generate a new idempotency_key for the new operation');
+            }
+            if (existing.state === 'completed') {
+                return Promise.resolve({
+                    kind: 'replayed',
+                    result: existing.result,
+                });
+            }
+            if (existing.state === 'failed')
+                throw restoreFailure(existing.failure);
+            if (existing.updatedAt < now - this.#ttlMs) {
+                const failure = new FinTaxError('UPSTREAM_UNAVAILABLE', 'The idempotent request state has expired and the result is unknown; follow the recovery guidance to query the final state and do not retry execution', {
+                    retryable: false,
+                    ...(existing.recovery === undefined
+                        ? {}
+                        : { recovery: existing.recovery }),
+                });
+                this.#records.set(scope, {
+                    state: 'failed',
+                    fingerprint: existing.fingerprint,
+                    failure: storedFailure(failure),
+                    updatedAt: now,
+                });
+                throw failure;
+            }
+            throw new FinTaxError('CONFLICT', 'The same idempotent request is already being processed; do not execute it again', {
+                retryable: false,
+                ...(existing.recovery === undefined
+                    ? {}
+                    : { recovery: existing.recovery }),
+            });
+        });
+    }
+    complete(binding, result) {
+        return this.#replace(binding, {
+            state: 'completed',
+            fingerprint: binding.fingerprint,
+            result,
+            updatedAt: this.#now(),
+        });
+    }
+    fail(binding, error) {
+        return this.#replace(binding, {
+            state: 'failed',
+            fingerprint: binding.fingerprint,
+            failure: storedFailure(error),
+            updatedAt: this.#now(),
+        });
+    }
+    abandon(binding) {
+        const scope = this.#scope(binding);
+        return this.#locks.withLock(`idempotency:${digestScope(scope)}`, () => {
+            const existing = this.#records.get(scope);
+            if (existing?.state === 'in_progress' &&
+                existing.fingerprint === binding.fingerprint) {
+                this.#records.delete(scope);
+            }
+            return Promise.resolve();
+        });
+    }
+    #replace(binding, replacement) {
+        const scope = this.#scope(binding);
+        return this.#locks.withLock(`idempotency:${digestScope(scope)}`, () => {
+            const existing = this.#records.get(scope);
+            if (existing?.state !== 'in_progress' ||
+                existing.fingerprint !== binding.fingerprint) {
+                throw new Error('Idempotency claim is not active');
+            }
+            this.#records.set(scope, replacement);
+            return Promise.resolve();
+        });
+    }
+    #scope(binding) {
+        return [
+            binding.tool,
+            binding.userId,
+            binding.tenantId,
+            binding.orgId ?? 'no-org',
+            binding.key,
+        ].join(':');
+    }
+    #prune(now) {
+        const cutoff = now - this.#ttlMs;
+        for (const [scope, record] of this.#records) {
+            if (record.state !== 'in_progress' && record.updatedAt < cutoff) {
+                this.#records.delete(scope);
+            }
+        }
+        if (this.#records.size < this.#maxEntries)
+            return;
+        const oldest = [...this.#records.entries()].sort(([, left], [, right]) => left.updatedAt - right.updatedAt);
+        for (const [scope, record] of oldest) {
+            if (this.#records.size < this.#maxEntries)
+                break;
+            if (record.state !== 'in_progress')
+                this.#records.delete(scope);
+        }
+    }
+}
+function digestScope(scope) {
+    return hashOperationValue({ namespace: 'idempotency-scope', scope });
+}
+//# sourceMappingURL=idempotency.js.map

package/dist/policies/idempotency.js.map

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

package/dist/policies/job-reference.d.ts

@@ -0,0 +1,16 @@
+export declare function createFndImportJobId(batchId: string): string;
+export declare function parseFndImportJobId(jobId: string): string;
+export declare function createPnlCalculationJobId(runId: string): string;
+export declare function createAutoFlowJobId(flowId: string, loopSeq: number): string;
+export type ParsedJobReference = {
+    readonly type: 'fnd-import';
+    readonly id: string;
+} | {
+    readonly type: 'pnl-calculation';
+    readonly id: string;
+} | {
+    readonly type: 'auto-flow';
+    readonly id: string;
+    readonly loopSeq: number;
+};
+export declare function parseJobReference(jobId: string): ParsedJobReference;

package/dist/policies/job-reference.js

@@ -0,0 +1,62 @@
+import { z } from 'zod/v4';
+import { FinTaxError } from '../errors/fintax-error.js';
+const FND_IMPORT_JOB_PREFIX = 'fnd-import:';
+const PNL_CALCULATION_JOB_PREFIX = 'pnl-calculation:';
+const AUTO_FLOW_JOB_PREFIX = 'auto-flow:';
+function createJobId(prefix, id) {
+    return `${prefix}${z.uuid().parse(id)}`;
+}
+function parseJobId(jobId, prefix) {
+    if (!jobId.startsWith(prefix)) {
+        throw new FinTaxError('VALIDATION_FAILED', 'Unsupported job_id type');
+    }
+    const parsed = z.uuid().safeParse(jobId.slice(prefix.length));
+    if (!parsed.success) {
+        throw new FinTaxError('VALIDATION_FAILED', 'Invalid job_id format', {
+            cause: parsed.error,
+        });
+    }
+    return parsed.data;
+}
+export function createFndImportJobId(batchId) {
+    return createJobId(FND_IMPORT_JOB_PREFIX, batchId);
+}
+export function parseFndImportJobId(jobId) {
+    return parseJobId(jobId, FND_IMPORT_JOB_PREFIX);
+}
+export function createPnlCalculationJobId(runId) {
+    return createJobId(PNL_CALCULATION_JOB_PREFIX, runId);
+}
+export function createAutoFlowJobId(flowId, loopSeq) {
+    return `${createJobId(AUTO_FLOW_JOB_PREFIX, flowId)}:${z
+        .number()
+        .int()
+        .positive()
+        .parse(loopSeq)}`;
+}
+export function parseJobReference(jobId) {
+    if (jobId.startsWith(FND_IMPORT_JOB_PREFIX)) {
+        return { type: 'fnd-import', id: parseFndImportJobId(jobId) };
+    }
+    if (jobId.startsWith(PNL_CALCULATION_JOB_PREFIX)) {
+        return {
+            type: 'pnl-calculation',
+            id: parseJobId(jobId, PNL_CALCULATION_JOB_PREFIX),
+        };
+    }
+    if (jobId.startsWith(AUTO_FLOW_JOB_PREFIX)) {
+        const [id, loopSeq, ...extra] = jobId
+            .slice(AUTO_FLOW_JOB_PREFIX.length)
+            .split(':');
+        if (id === undefined || loopSeq === undefined || extra.length > 0) {
+            throw new FinTaxError('VALIDATION_FAILED', 'Invalid job_id format');
+        }
+        return {
+            type: 'auto-flow',
+            id: z.uuid().parse(id),
+            loopSeq: z.coerce.number().int().positive().parse(loopSeq),
+        };
+    }
+    throw new FinTaxError('VALIDATION_FAILED', 'Unsupported job_id type');
+}
+//# sourceMappingURL=job-reference.js.map

package/dist/policies/job-reference.js.map

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

package/dist/policies/operation-plan.d.ts

@@ -0,0 +1,27 @@
+import type { LockManager } from '../concurrency/lock-manager.js';
+export interface OperationBinding {
+    readonly tool: string;
+    readonly subject_id: string;
+    readonly subject_version: string;
+    readonly user_id: string;
+    readonly tenant_id: string;
+    readonly org_id?: string;
+    readonly parameter_hash: string;
+    readonly preview_hash: string;
+    readonly file_id?: string;
+    readonly file_hash?: string;
+    readonly payload?: Readonly<Record<string, unknown>>;
+}
+export interface IssuedOperationPlan {
+    readonly operationPlanId: string;
+    readonly confirmationToken: string;
+    readonly expiresAt: string;
+}
+export declare function hashOperationValue(value: unknown): string;
+export declare class OperationPlanManager {
+    #private;
+    constructor(locks: LockManager);
+    issue(binding: OperationBinding, ttlMs?: number): IssuedOperationPlan;
+    consume(operationPlanId: string, confirmationToken: string, expectedTool: string): Promise<OperationBinding>;
+    inspect(operationPlanId: string, confirmationToken: string, expectedTool: string): OperationBinding;
+}

package/dist/policies/operation-plan.js

@@ -0,0 +1,99 @@
+import { createHmac, randomBytes, timingSafeEqual } from 'node:crypto';
+import { FinTaxError } from '../errors/fintax-error.js';
+function canonicalize(value) {
+    if (Array.isArray(value)) {
+        return `[${value.map((entry) => canonicalize(entry)).join(',')}]`;
+    }
+    if (value !== null && typeof value === 'object') {
+        return `{${Object.entries(value)
+            .filter(([, entry]) => entry !== undefined)
+            .sort(([left], [right]) => left.localeCompare(right))
+            .map(([key, entry]) => `${JSON.stringify(key)}:${canonicalize(entry)}`)
+            .join(',')}}`;
+    }
+    return JSON.stringify(value);
+}
+export function hashOperationValue(value) {
+    return createHmac('sha256', 'fintax-mcp-canonical-hash')
+        .update(canonicalize(value))
+        .digest('hex');
+}
+export class OperationPlanManager {
+    #locks;
+    #plans = new Map();
+    constructor(locks) {
+        this.#locks = locks;
+    }
+    issue(binding, ttlMs = 10 * 60 * 1000) {
+        const now = Date.now();
+        this.#pruneExpired(now);
+        const expiresAtMs = now + ttlMs;
+        const expiresAt = new Date(expiresAtMs).toISOString();
+        let operationPlanId = this.#newHandle();
+        while (this.#plans.has(operationPlanId)) {
+            operationPlanId = this.#newHandle();
+        }
+        let confirmationToken = this.#newHandle();
+        while (confirmationToken === operationPlanId) {
+            confirmationToken = this.#newHandle();
+        }
+        this.#plans.set(operationPlanId, {
+            confirmationToken,
+            binding: Object.freeze({ ...binding }),
+            expiresAtMs,
+            consumed: false,
+        });
+        return {
+            operationPlanId,
+            confirmationToken,
+            expiresAt,
+        };
+    }
+    async consume(operationPlanId, confirmationToken, expectedTool) {
+        return this.#locks.withLock(`confirmation:${hashOperationValue(confirmationToken)}`, () => {
+            const plan = this.#inspectPair(operationPlanId, confirmationToken, expectedTool);
+            if (plan.consumed) {
+                throw new FinTaxError('CONFIRMATION_REQUIRED', 'The confirmation credential has already been used; run the preparation step again');
+            }
+            plan.consumed = true;
+            return Promise.resolve({ ...plan.binding });
+        });
+    }
+    inspect(operationPlanId, confirmationToken, expectedTool) {
+        return {
+            ...this.#inspectPair(operationPlanId, confirmationToken, expectedTool)
+                .binding,
+        };
+    }
+    #inspectPair(operationPlanId, confirmationToken, expectedTool) {
+        const now = Date.now();
+        this.#pruneExpired(now);
+        const plan = this.#plans.get(operationPlanId);
+        if (plan === undefined ||
+            plan.expiresAtMs <= now ||
+            plan.binding.tool !== expectedTool ||
+            !this.#equalHandles(plan.confirmationToken, confirmationToken)) {
+            if (plan !== undefined && plan.expiresAtMs <= now) {
+                this.#plans.delete(operationPlanId);
+            }
+            throw new FinTaxError('CONFIRMATION_REQUIRED', 'The operation plan or confirmation credential is invalid or expired; run the preparation step again');
+        }
+        return plan;
+    }
+    #newHandle() {
+        return randomBytes(32).toString('base64url');
+    }
+    #equalHandles(expected, actual) {
+        const expectedBytes = Buffer.from(expected);
+        const actualBytes = Buffer.from(actual);
+        return (expectedBytes.length === actualBytes.length &&
+            timingSafeEqual(expectedBytes, actualBytes));
+    }
+    #pruneExpired(now) {
+        for (const [operationPlanId, plan] of this.#plans) {
+            if (plan.expiresAtMs <= now)
+                this.#plans.delete(operationPlanId);
+        }
+    }
+}
+//# sourceMappingURL=operation-plan.js.map

package/dist/policies/operation-plan.js.map

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

package/dist/policies/redaction.d.ts

@@ -0,0 +1,2 @@
+export declare function redact(value: unknown): unknown;
+export declare function shortHash(value: string): string;

package/dist/policies/redaction.js

@@ -0,0 +1,29 @@
+const SENSITIVE_KEYS = new Set([
+    'access_token',
+    'authorization',
+    'confirmation_token',
+    'cookie',
+    'password',
+    'refresh_token',
+    'set-cookie',
+    'token',
+]);
+const OMITTED_KEYS = new Set(['file_content', 'lines', 'raw_file']);
+export function redact(value) {
+    if (Array.isArray(value))
+        return value.map((entry) => redact(entry));
+    if (value === null || typeof value !== 'object')
+        return value;
+    return Object.fromEntries(Object.entries(value).map(([key, entry]) => {
+        const normalized = key.toLowerCase();
+        if (SENSITIVE_KEYS.has(normalized))
+            return [key, '[REDACTED]'];
+        if (OMITTED_KEYS.has(normalized))
+            return [key, '[OMITTED]'];
+        return [key, redact(entry)];
+    }));
+}
+export function shortHash(value) {
+    return value.length <= 12 ? value : `${value.slice(0, 8)}...`;
+}
+//# sourceMappingURL=redaction.js.map

package/dist/policies/redaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redaction.js","sourceRoot":"","sources":["../../src/policies/redaction.ts"],"names":[],"mappings":"AAAA,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC;IAC7B,cAAc;IACd,eAAe;IACf,oBAAoB;IACpB,QAAQ;IACR,UAAU;IACV,eAAe;IACf,YAAY;IACZ,OAAO;CACR,CAAC,CAAC;AAEH,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,CAAC,cAAc,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC;AAEpE,MAAM,UAAU,MAAM,CAAC,KAAc;IACnC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IACrE,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAE9D,OAAO,MAAM,CAAC,WAAW,CACvB,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;QACzC,MAAM,UAAU,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;QACrC,IAAI,cAAc,CAAC,GAAG,CAAC,UAAU,CAAC;YAAE,OAAO,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;QAC/D,IAAI,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC;YAAE,OAAO,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;QAC5D,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IAC9B,CAAC,CAAC,CACH,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,KAAa;IACrC,OAAO,KAAK,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC;AAChE,CAAC"}

package/dist/policies/retry.d.ts

@@ -0,0 +1,8 @@
+export interface RetryOptions {
+    readonly retries: number;
+    readonly baseDelayMs?: number;
+    readonly shouldRetry: (error: unknown, attempt: number) => boolean;
+    readonly sleep?: (milliseconds: number) => Promise<void>;
+    readonly random?: () => number;
+}
+export declare function withRetry<T>(operation: (attempt: number) => Promise<T>, options: RetryOptions): Promise<T>;

package/dist/policies/retry.js

@@ -0,0 +1,19 @@
+const defaultSleep = (milliseconds) => new Promise((resolve) => setTimeout(resolve, milliseconds));
+export async function withRetry(operation, options) {
+    const sleep = options.sleep ?? defaultSleep;
+    const random = options.random ?? Math.random;
+    const baseDelayMs = options.baseDelayMs ?? 100;
+    for (let attempt = 0;; attempt += 1) {
+        try {
+            return await operation(attempt);
+        }
+        catch (error) {
+            if (attempt >= options.retries || !options.shouldRetry(error, attempt)) {
+                throw error;
+            }
+            const jitter = 0.5 + random();
+            await sleep(baseDelayMs * 2 ** attempt * jitter);
+        }
+    }
+}
+//# sourceMappingURL=retry.js.map

package/dist/policies/retry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.js","sourceRoot":"","sources":["../../src/policies/retry.ts"],"names":[],"mappings":"AAQA,MAAM,YAAY,GAAG,CAAC,YAAoB,EAAE,EAAE,CAC5C,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC;AAEpE,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,SAA0C,EAC1C,OAAqB;IAErB,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,YAAY,CAAC;IAC5C,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC;IAC7C,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,GAAG,CAAC;IAE/C,KAAK,IAAI,OAAO,GAAG,CAAC,GAAI,OAAO,IAAI,CAAC,EAAE,CAAC;QACrC,IAAI,CAAC;YACH,OAAO,MAAM,SAAS,CAAC,OAAO,CAAC,CAAC;QAClC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,OAAO,IAAI,OAAO,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,CAAC;gBACvE,MAAM,KAAK,CAAC;YACd,CAAC;YACD,MAAM,MAAM,GAAG,GAAG,GAAG,MAAM,EAAE,CAAC;YAC9B,MAAM,KAAK,CAAC,WAAW,GAAG,CAAC,IAAI,OAAO,GAAG,MAAM,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/responses/tool-response.d.ts

@@ -0,0 +1,4 @@
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import type { FinTaxError } from '../errors/fintax-error.js';
+export declare function createToolSuccess(output: Record<string, unknown>, summary: string): CallToolResult;
+export declare function createToolFailure(error: FinTaxError, traceId: string): CallToolResult;

package/dist/responses/tool-response.js

@@ -0,0 +1,24 @@
+export function createToolSuccess(output, summary) {
+    return {
+        content: [{ type: 'text', text: summary }],
+        structuredContent: output,
+    };
+}
+export function createToolFailure(error, traceId) {
+    const failure = {
+        ok: false,
+        error: {
+            code: error.code,
+            message: error.message,
+            retryable: error.retryable,
+            field_errors: [...error.fieldErrors],
+            ...(error.recovery === undefined ? {} : { recovery: error.recovery }),
+        },
+        trace_id: traceId,
+    };
+    return {
+        content: [{ type: 'text', text: JSON.stringify(failure) }],
+        isError: true,
+    };
+}
+//# sourceMappingURL=tool-response.js.map

package/dist/responses/tool-response.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-response.js","sourceRoot":"","sources":["../../src/responses/tool-response.ts"],"names":[],"mappings":"AAKA,MAAM,UAAU,iBAAiB,CAC/B,MAA+B,EAC/B,OAAe;IAEf,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;QAC1C,iBAAiB,EAAE,MAAM;KAC1B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,KAAkB,EAClB,OAAe;IAEf,MAAM,OAAO,GAAgB;QAC3B,EAAE,EAAE,KAAK;QACT,KAAK,EAAE;YACL,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,YAAY,EAAE,CAAC,GAAG,KAAK,CAAC,WAAW,CAAC;YACpC,GAAG,CAAC,KAAK,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC;SACtE;QACD,QAAQ,EAAE,OAAO;KAClB,CAAC;IAEF,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;QAC1D,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC"}