@debian777/kairos-mcp 3.0.1-beta.14

package/dist/tools/kairos_next.js

@@ -0,0 +1,285 @@
+import { kairosNextInputSchema, kairosNextOutputSchema } from './kairos_next_schema.js';
+import { structuredLogger } from '../utils/structured-logger.js';
+import { resolveChainNextStep, resolveChainPreviousStep } from '../services/chain-utils.js';
+import { getToolDoc } from '../resources/embedded-mcp-resources.js';
+import { mcpToolCalls, mcpToolDuration, mcpToolErrors, mcpToolInputSize, mcpToolOutputSize } from '../services/metrics/mcp-metrics.js';
+import { getTenantId, getSpaceContextFromStorage } from '../utils/tenant-context.js';
+import { redisCacheService } from '../services/redis-cache.js';
+import { extractMemoryBody } from '../utils/memory-body.js';
+import { proofOfWorkStore } from '../services/proof-of-work-store.js';
+import { buildChallenge, handleProofSubmission, tryUserInputElicitation, GENESIS_HASH } from './kairos_next-pow-helpers.js';
+import { tryApplySolutionToPreviousStep, tryApplySolutionToPreviousStepWhenSolutionMatchesPrevious, ensurePreviousProofCompleted } from './kairos_next-previous-step.js';
+import { buildMissingProofPayload } from './kairos_next-missing-proof-payload.js';
+import { modelStats } from '../services/stats/model-stats.js';
+import { kairosQualityUpdateErrors } from '../services/metrics/mcp-metrics.js';
+async function loadMemoryWithCache(memoryStore, uuid) {
+    const cached = await redisCacheService.getMemoryResource(uuid);
+    if (cached) {
+        return cached;
+    }
+    const memory = await memoryStore.getMemory(uuid);
+    if (memory) {
+        await redisCacheService.setMemoryResource(memory);
+    }
+    return memory;
+}
+function normalizeMemoryUri(value) {
+    const normalized = (value || '').trim();
+    const uuid = normalized.split('/').pop();
+    if (!uuid) {
+        throw new Error('Invalid kairos://mem URI');
+    }
+    const uri = normalized.startsWith('kairos://mem/')
+        ? normalized
+        : `kairos://mem/${uuid}`;
+    return { uuid, uri };
+}
+function buildCurrentStep(memory, requestedUri) {
+    const uri = memory ? `kairos://mem/${memory.memory_uuid}` : requestedUri;
+    const content = memory ? extractMemoryBody(memory.text) : '';
+    return {
+        uri,
+        content,
+        mimeType: 'text/markdown'
+    };
+}
+async function buildKairosNextPayload(memory, requestedUri, nextStepUri, proof) {
+    const current_step = buildCurrentStep(memory, requestedUri);
+    const challenge = await buildChallenge(memory, proof);
+    const payload = {
+        must_obey: true,
+        current_step,
+        challenge
+    };
+    if (nextStepUri) {
+        payload.next_action = `call kairos_next with ${nextStepUri} and solution matching challenge`;
+    }
+    else {
+        payload.message = 'Protocol steps complete. Call kairos_attest to finalize.';
+        payload.next_action = `call kairos_attest with ${requestedUri} and outcome (success or failure) and message to complete the protocol`;
+    }
+    return payload;
+}
+/** Update quality_metadata and quality_metrics for the completed step. Log and continue on error; do not fail the request. Shared by MCP and HTTP kairos_next. */
+export async function updateStepQuality(qdrantService, memory, outcome, tenantId) {
+    try {
+        const qdrantUuid = memory.memory_uuid;
+        const currentPoint = await qdrantService.retrieveById(qdrantUuid);
+        const payload = currentPoint?.payload;
+        const description_short = payload?.['description_short'] || 'Knowledge step';
+        const domain = payload?.['domain'] || 'general';
+        const task = payload?.['task'] || 'general';
+        const type = payload?.['type'] || 'context';
+        const tags = Array.isArray(payload?.['tags']) ? payload['tags'] : [];
+        const metricsUpdate = {
+            retrievalCount: 1,
+            successCount: outcome === 'success' ? 1 : 0,
+            failureCount: outcome === 'failure' ? 1 : 0,
+            lastRated: new Date().toISOString(),
+            lastRater: 'kairos_next',
+            qualityBonus: outcome === 'success' ? 1 : -0.2
+        };
+        await qdrantService.updateQualityMetrics(qdrantUuid, metricsUpdate);
+        const updatedQualityMetadata = modelStats.calculateStepQualityMetadata(description_short, domain, task, type, tags, outcome);
+        await qdrantService.updateQualityMetadata(qdrantUuid, {
+            step_quality_score: updatedQualityMetadata.step_quality_score,
+            step_quality: updatedQualityMetadata.step_quality
+        });
+        structuredLogger.debug(`kairos_next: Updated quality for ${memory.memory_uuid} outcome=${outcome}`);
+    }
+    catch (err) {
+        kairosQualityUpdateErrors.inc({ tenant_id: tenantId });
+        structuredLogger.warn(`kairos_next: Quality update failed for ${memory.memory_uuid}: ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+export function registerKairosNextTool(server, memoryStore, options = {}) {
+    const toolName = options.toolName || 'kairos_next';
+    structuredLogger.debug(`kairos_next registration inputSchema: ${JSON.stringify(kairosNextInputSchema)}`);
+    structuredLogger.debug(`kairos_next registration outputSchema: ${JSON.stringify(kairosNextOutputSchema)}`);
+    server.registerTool(toolName, {
+        title: 'Submit solution and get next step',
+        description: getToolDoc('kairos_next') || 'Submit proof that current challenge was solved. Returns next step + next challenge.',
+        inputSchema: kairosNextInputSchema,
+        outputSchema: kairosNextOutputSchema
+    }, async (params) => {
+        const tenantId = getTenantId();
+        const spaceId = getSpaceContextFromStorage()?.defaultWriteSpaceId ?? 'default';
+        structuredLogger.debug(`kairos_next space_id=${spaceId}`);
+        const inputSize = JSON.stringify(params).length;
+        mcpToolInputSize.observe({ tool: toolName, tenant_id: tenantId }, inputSize);
+        const timer = mcpToolDuration.startTimer({
+            tool: toolName,
+            tenant_id: tenantId
+        });
+        const respond = (payload) => {
+            const structured = {
+                content: [{
+                        type: 'text', text: JSON.stringify(payload)
+                    }],
+                structuredContent: payload
+            };
+            mcpToolCalls.inc({
+                tool: toolName,
+                status: 'success',
+                tenant_id: tenantId
+            });
+            const outputSize = JSON.stringify(structured).length;
+            mcpToolOutputSize.observe({ tool: toolName, tenant_id: tenantId }, outputSize);
+            timer({
+                tool: toolName,
+                status: 'success',
+                tenant_id: tenantId
+            });
+            return structured;
+        };
+        try {
+            const { uri, solution } = params;
+            const { uuid, uri: requestedUri } = normalizeMemoryUri(uri);
+            // Validate solution is provided
+            if (!solution) {
+                const retryCount = await proofOfWorkStore.incrementRetry(uuid);
+                const noSolChallenge = await buildChallenge(null, undefined);
+                return respond({
+                    must_obey: retryCount < 3,
+                    current_step: buildCurrentStep(null, requestedUri),
+                    challenge: noSolChallenge,
+                    message: 'Solution is required for steps 2+. Use kairos_begin for step 1.',
+                    next_action: `retry kairos_next with ${requestedUri} -- include solution matching challenge`,
+                    error_code: 'MISSING_FIELD',
+                    retry_count: retryCount
+                });
+            }
+            const memory = await loadMemoryWithCache(memoryStore, uuid);
+            let solutionToUse = solution;
+            if (memory) {
+                const elicitResult = await tryUserInputElicitation(server, memory, solution, requestedUri, buildCurrentStep);
+                if ('payload' in elicitResult)
+                    return respond(elicitResult.payload);
+                solutionToUse = elicitResult.solution;
+            }
+            let submissionOutcome;
+            if (memory) {
+                if (!memory.proof_of_work && solutionToUse) {
+                    const prevResult = await tryApplySolutionToPreviousStep(memory, solutionToUse, (id) => loadMemoryWithCache(memoryStore, id), options.qdrantService);
+                    if (prevResult.applied) {
+                        if (prevResult.outcome.blockedPayload) {
+                            if (options.qdrantService) {
+                                await updateStepQuality(options.qdrantService, prevResult.prevMemory, 'failure', tenantId);
+                            }
+                            return respond(prevResult.outcome.blockedPayload);
+                        }
+                        const previousBlock = await ensurePreviousProofCompleted(memory, (id) => loadMemoryWithCache(memoryStore, id), options.qdrantService);
+                        if (!previousBlock && options.qdrantService && !prevResult.outcome.alreadyRecorded) {
+                            await updateStepQuality(options.qdrantService, prevResult.prevMemory, 'success', tenantId);
+                        }
+                        if (!previousBlock) {
+                            const nextFromRequested = await resolveChainNextStep(memory, options.qdrantService);
+                            const nextStepUri = nextFromRequested?.uuid
+                                ? `kairos://mem/${nextFromRequested.uuid}`
+                                : null;
+                            const output = await buildKairosNextPayload(memory, requestedUri, nextStepUri, undefined);
+                            if (prevResult.outcome.proofHash)
+                                output.proof_hash = prevResult.outcome.proofHash;
+                            return respond(output);
+                        }
+                    }
+                }
+                if (memory.proof_of_work && solutionToUse) {
+                    const prevResultWhenMatch = await tryApplySolutionToPreviousStepWhenSolutionMatchesPrevious(memory, solutionToUse, (id) => loadMemoryWithCache(memoryStore, id), options.qdrantService);
+                    if (prevResultWhenMatch.applied) {
+                        if (prevResultWhenMatch.outcome.blockedPayload) {
+                            if (options.qdrantService) {
+                                await updateStepQuality(options.qdrantService, prevResultWhenMatch.prevMemory, 'failure', tenantId);
+                            }
+                            return respond(prevResultWhenMatch.outcome.blockedPayload);
+                        }
+                        if (options.qdrantService && !prevResultWhenMatch.outcome.alreadyRecorded) {
+                            await updateStepQuality(options.qdrantService, prevResultWhenMatch.prevMemory, 'success', tenantId);
+                        }
+                        const nextFromRequested = await resolveChainNextStep(memory, options.qdrantService);
+                        const nextStepUri = nextFromRequested?.uuid
+                            ? `kairos://mem/${nextFromRequested.uuid}`
+                            : null;
+                        const nextMemory = nextFromRequested ? await loadMemoryWithCache(memoryStore, nextFromRequested.uuid) : null;
+                        const challengeProof = nextMemory?.proof_of_work ?? memory?.proof_of_work;
+                        const output = await buildKairosNextPayload(memory, requestedUri, nextStepUri, challengeProof);
+                        if (prevResultWhenMatch.outcome.proofHash)
+                            output.proof_hash = prevResultWhenMatch.outcome.proofHash;
+                        return respond(output);
+                    }
+                }
+                const isStep1 = !memory.chain || memory.chain.step_index <= 1;
+                let expectedPreviousHash;
+                if (isStep1) {
+                    expectedPreviousHash = GENESIS_HASH;
+                }
+                else {
+                    const prev = await resolveChainPreviousStep(memory, options.qdrantService);
+                    const prevHash = prev?.uuid ? await proofOfWorkStore.getProofHash(prev.uuid) : null;
+                    expectedPreviousHash = prevHash ?? GENESIS_HASH;
+                }
+                submissionOutcome = await handleProofSubmission(solutionToUse, memory, { expectedPreviousHash });
+                if (submissionOutcome.blockedPayload) {
+                    if (options.qdrantService) {
+                        await updateStepQuality(options.qdrantService, memory, 'failure', tenantId);
+                    }
+                    return respond(submissionOutcome.blockedPayload);
+                }
+                const previousBlock = await ensurePreviousProofCompleted(memory, (id) => loadMemoryWithCache(memoryStore, id), options.qdrantService);
+                if (previousBlock) {
+                    if (options.qdrantService) {
+                        await updateStepQuality(options.qdrantService, memory, 'failure', tenantId);
+                    }
+                    const payload = await buildMissingProofPayload(memory, previousBlock, requestedUri, uuid, (id) => loadMemoryWithCache(memoryStore, id), options.qdrantService);
+                    return respond({
+                        must_obey: payload.retry_count < 3,
+                        current_step: payload.current_step,
+                        challenge: payload.challenge,
+                        message: previousBlock.message,
+                        next_action: payload.next_action,
+                        error_code: previousBlock.error_code || 'MISSING_PROOF',
+                        retry_count: payload.retry_count
+                    });
+                }
+                if (options.qdrantService && !submissionOutcome.alreadyRecorded) {
+                    await updateStepQuality(options.qdrantService, memory, 'success', tenantId);
+                }
+            }
+            // Resolve next step
+            const nextStepInfo = memory ? await resolveChainNextStep(memory, options.qdrantService) : undefined;
+            const nextMemory = nextStepInfo ? await loadMemoryWithCache(memoryStore, nextStepInfo.uuid) : null;
+            const displayMemory = nextMemory ?? memory;
+            const challengeProof = nextMemory?.proof_of_work ?? memory?.proof_of_work;
+            const displayUri = nextStepInfo ? `kairos://mem/${nextStepInfo.uuid}` : requestedUri;
+            // Resolve the step AFTER the display step to get next_action URI
+            const nextFromDisplay = displayMemory ? await resolveChainNextStep(displayMemory, options.qdrantService) : undefined;
+            const nextStepUri = nextFromDisplay?.uuid
+                ? `kairos://mem/${nextFromDisplay.uuid}`
+                : null;
+            const output = await buildKairosNextPayload(displayMemory, displayUri, nextStepUri, challengeProof);
+            if (submissionOutcome?.proofHash) {
+                output.proof_hash = submissionOutcome.proofHash;
+            }
+            return respond(output);
+        }
+        catch (error) {
+            mcpToolCalls.inc({
+                tool: toolName,
+                status: 'error',
+                tenant_id: tenantId
+            });
+            mcpToolErrors.inc({
+                tool: toolName,
+                status: 'error',
+                tenant_id: tenantId
+            });
+            timer({
+                tool: toolName,
+                status: 'error',
+                tenant_id: tenantId
+            });
+            throw error;
+        }
+    });
+}
+//# sourceMappingURL=kairos_next.js.map

package/dist/tools/kairos_next.js.map

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

package/dist/tools/kairos_next_schema.d.ts

@@ -0,0 +1,80 @@
+/**
+ * kairos_next input/output schemas (zod-only).
+ * V2: removed next_step, protocol_status, attest_required, final_challenge.
+ * Renamed genesis_hash -> proof_hash, previousProofHash -> proof_hash, last_proof_hash -> proof_hash.
+ * Added error_code, retry_count for two-phase retry escalation.
+ */
+import { z } from 'zod';
+declare const memoryUriSchema: z.ZodString;
+export declare const kairosNextInputSchema: z.ZodObject<{
+    uri: z.ZodString;
+    solution: z.ZodObject<{
+        type: z.ZodEnum<{
+            shell: "shell";
+            mcp: "mcp";
+            user_input: "user_input";
+            comment: "comment";
+        }>;
+        nonce: z.ZodOptional<z.ZodString>;
+        proof_hash: z.ZodOptional<z.ZodString>;
+        shell: z.ZodOptional<z.ZodObject<{
+            exit_code: z.ZodNumber;
+            stdout: z.ZodOptional<z.ZodString>;
+            stderr: z.ZodOptional<z.ZodString>;
+            duration_seconds: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+        mcp: z.ZodOptional<z.ZodObject<{
+            tool_name: z.ZodString;
+            arguments: z.ZodOptional<z.ZodAny>;
+            result: z.ZodAny;
+            success: z.ZodBoolean;
+        }, z.core.$strip>>;
+        user_input: z.ZodOptional<z.ZodObject<{
+            confirmation: z.ZodString;
+            timestamp: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        comment: z.ZodOptional<z.ZodObject<{
+            text: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export declare const kairosNextOutputSchema: z.ZodObject<{
+    must_obey: z.ZodBoolean;
+    current_step: z.ZodNullable<z.ZodOptional<z.ZodObject<{
+        uri: z.ZodString;
+        content: z.ZodString;
+        mimeType: z.ZodLiteral<"text/markdown">;
+    }, z.core.$strip>>>;
+    challenge: z.ZodObject<{
+        type: z.ZodEnum<{
+            shell: "shell";
+            mcp: "mcp";
+            user_input: "user_input";
+            comment: "comment";
+        }>;
+        description: z.ZodString;
+        nonce: z.ZodOptional<z.ZodString>;
+        proof_hash: z.ZodOptional<z.ZodString>;
+        shell: z.ZodOptional<z.ZodObject<{
+            cmd: z.ZodString;
+            timeout_seconds: z.ZodNumber;
+        }, z.core.$strip>>;
+        mcp: z.ZodOptional<z.ZodObject<{
+            tool_name: z.ZodString;
+            expected_result: z.ZodOptional<z.ZodAny>;
+        }, z.core.$strip>>;
+        user_input: z.ZodOptional<z.ZodObject<{
+            prompt: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        comment: z.ZodOptional<z.ZodObject<{
+            min_length: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+    next_action: z.ZodString;
+    proof_hash: z.ZodOptional<z.ZodString>;
+    message: z.ZodOptional<z.ZodString>;
+    error_code: z.ZodOptional<z.ZodString>;
+    retry_count: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export { memoryUriSchema };
+//# sourceMappingURL=kairos_next_schema.d.ts.map

package/dist/tools/kairos_next_schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kairos_next_schema.d.ts","sourceRoot":"","sources":["../../src/tools/kairos_next_schema.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,QAAA,MAAM,eAAe,aAEyD,CAAC;AA0D/E,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAGhC,CAAC;AAEH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAajC,CAAC;AAEH,OAAO,EAAE,eAAe,EAAE,CAAC"}

package/dist/tools/kairos_next_schema.js

@@ -0,0 +1,82 @@
+/**
+ * kairos_next input/output schemas (zod-only).
+ * V2: removed next_step, protocol_status, attest_required, final_challenge.
+ * Renamed genesis_hash -> proof_hash, previousProofHash -> proof_hash, last_proof_hash -> proof_hash.
+ * Added error_code, retry_count for two-phase retry escalation.
+ */
+import { z } from 'zod';
+const memoryUriSchema = z
+    .string()
+    .regex(/^kairos:\/\/mem\/[0-9a-f-]{36}$/i, 'must match kairos://mem/{uuid}');
+const solutionSchema = z.object({
+    type: z.enum(['shell', 'mcp', 'user_input', 'comment']).describe('Must match challenge.type'),
+    nonce: z.string().optional().describe('Echo nonce from challenge'),
+    proof_hash: z.string().optional().describe('Echo proof_hash from previous challenge or response'),
+    shell: z.object({
+        exit_code: z.number(),
+        stdout: z.string().optional(),
+        stderr: z.string().optional(),
+        duration_seconds: z.number().optional()
+    }).optional(),
+    mcp: z.object({
+        tool_name: z.string(),
+        arguments: z.any().optional(),
+        result: z.any(),
+        success: z.boolean()
+    }).optional(),
+    user_input: z.object({
+        confirmation: z.string(),
+        timestamp: z.string().optional()
+    }).optional(),
+    comment: z.object({ text: z.string() }).optional()
+}).refine((data) => !!(data.shell || data.mcp || data.user_input || data.comment), { message: 'At least one type-specific field (shell, mcp, user_input, or comment) must be provided' }).refine((data) => {
+    if (data.type === 'shell' && !data.shell)
+        return false;
+    if (data.type === 'mcp' && !data.mcp)
+        return false;
+    if (data.type === 'user_input' && !data.user_input)
+        return false;
+    if (data.type === 'comment' && !data.comment)
+        return false;
+    return true;
+}, { message: 'The type-specific field must match the solution type' });
+const challengeSchema = z.object({
+    type: z.enum(['shell', 'mcp', 'user_input', 'comment']),
+    description: z.string(),
+    nonce: z.string().optional().describe('Echo back as solution.nonce'),
+    proof_hash: z.string().optional().describe('Echo back as solution.proof_hash'),
+    shell: z.object({
+        cmd: z.string(),
+        timeout_seconds: z.number()
+    }).optional(),
+    mcp: z.object({
+        tool_name: z.string(),
+        expected_result: z.any().optional()
+    }).optional(),
+    user_input: z.object({
+        prompt: z.string().optional()
+    }).optional(),
+    comment: z.object({
+        min_length: z.number().optional()
+    }).optional()
+});
+export const kairosNextInputSchema = z.object({
+    uri: memoryUriSchema.describe('Current step URI (from next_action of previous response)'),
+    solution: solutionSchema.describe('Proof matching challenge.type: shell/mcp/user_input/comment')
+});
+export const kairosNextOutputSchema = z.object({
+    must_obey: z.boolean().describe('true for success and recoverable errors, false after max retries'),
+    current_step: z.object({
+        uri: memoryUriSchema,
+        content: z.string(),
+        mimeType: z.literal('text/markdown')
+    }).optional().nullable(),
+    challenge: challengeSchema,
+    next_action: z.string().describe('Next tool call with embedded kairos://mem/ URI'),
+    proof_hash: z.string().optional().describe('Hash of proof just stored. Use as solution.proof_hash for next step.'),
+    message: z.string().optional(),
+    error_code: z.string().optional().describe('Machine-readable error code (e.g., NONCE_MISMATCH, MAX_RETRIES_EXCEEDED)'),
+    retry_count: z.number().optional().describe('Number of retries on this step (present on error responses)')
+});
+export { memoryUriSchema };
+//# sourceMappingURL=kairos_next_schema.js.map

package/dist/tools/kairos_next_schema.js.map

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

package/dist/tools/kairos_search.d.ts

@@ -0,0 +1,15 @@
+import type { MemoryQdrantStore } from '../services/memory/store.js';
+import type { QdrantService } from '../services/qdrant/service.js';
+interface RegisterSearchOptions {
+    toolName?: string;
+    qdrantService?: QdrantService;
+}
+/**
+ * Register kairos_search tool
+ *
+ * V2 unified response: always must_obey: true, choices array with score/role,
+ * creation protocol always available as fallback.
+ */
+export declare function registerSearchTool(server: any, memoryStore: MemoryQdrantStore, options?: RegisterSearchOptions): void;
+export {};
+//# sourceMappingURL=kairos_search.d.ts.map

package/dist/tools/kairos_search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kairos_search.d.ts","sourceRoot":"","sources":["../../src/tools/kairos_search.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAenE,UAAU,qBAAqB;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B;AAsKD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,iBAAiB,EAAE,OAAO,GAAE,qBAA0B,QAiJlH"}