@hualinge/relay-mcp-server 0.1.3

package/dist/tools/schedule-tools.js

@@ -0,0 +1,397 @@
+/*
+ * *
+ *  * Copyright (C) Huawei Technologies Co., Ltd. 2026. All rights reserved.
+ *
+ */
+/**
+ * F139 Phase 3A: Schedule MCP Tools (AC-G2)
+ *
+ * office_claw_list_schedule_templates  — list available task templates
+ * office_claw_register_scheduled_task  — create a dynamic scheduled task from template
+ * office_claw_set_scheduled_task_enabled — enable/disable a dynamic scheduled task
+ * office_claw_remove_scheduled_task    — delete a dynamic scheduled task
+ */
+import { normalizeScheduleTaskLabel } from '@openjiuwen/relay-shared/utils';
+import { z } from 'zod';
+import { callbackGet, callbackPost } from './callback-tools.js';
+import { errorResult } from './file-tools.js';
+const MIN_INTERVAL_MS = 10_000;
+const MIN_ONCE_DELAY_MS = 1_000;
+// ─── callbackDelete (schedule-specific) ──────────────────────
+async function callbackDelete(path) {
+    const { getCallbackConfig, NO_CONFIG_ERROR } = await import('./callback-tools.js');
+    const config = getCallbackConfig();
+    if (!config)
+        return errorResult(NO_CONFIG_ERROR);
+    try {
+        const response = await fetch(`${config.apiUrl}${path}`, {
+            method: 'DELETE',
+            headers: {
+                'Content-Type': 'application/json',
+                'x-invocation-id': config.invocationId,
+                'x-callback-token': config.callbackToken,
+            },
+        });
+        if (!response.ok) {
+            const text = await response.text();
+            return errorResult(`Delete failed (${response.status}): ${text}`);
+        }
+        const { successResult: ok } = await import('./file-tools.js');
+        return ok(JSON.stringify(await response.json()));
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return errorResult(`Delete request failed: ${message}`);
+    }
+}
+async function callbackPatch(path, body) {
+    const { getCallbackConfig, NO_CONFIG_ERROR } = await import('./callback-tools.js');
+    const config = getCallbackConfig();
+    if (!config)
+        return errorResult(NO_CONFIG_ERROR);
+    try {
+        const response = await fetch(`${config.apiUrl}${path}`, {
+            method: 'PATCH',
+            headers: {
+                'Content-Type': 'application/json',
+                'x-invocation-id': config.invocationId,
+                'x-callback-token': config.callbackToken,
+            },
+            body: JSON.stringify(body),
+        });
+        if (!response.ok) {
+            const text = await response.text();
+            return errorResult(`Patch failed (${response.status}): ${text}`);
+        }
+        const { successResult: ok } = await import('./file-tools.js');
+        return ok(JSON.stringify(await response.json()));
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return errorResult(`Patch request failed: ${message}`);
+    }
+}
+// ─── List registered tasks ──────────────────────────────────
+export const listScheduledTasksInputSchema = {};
+export async function handleListScheduledTasks(_input) {
+    return callbackGet('/api/schedule/tasks');
+}
+// ─── List templates ──────────────────────────────────────────
+export const listScheduleTemplatesInputSchema = {};
+export async function handleListScheduleTemplates(_input) {
+    return callbackGet('/api/schedule/templates');
+}
+function validateTriggerConfig(trigger) {
+    if (!trigger || typeof trigger !== 'object' || Array.isArray(trigger)) {
+        return 'Invalid trigger JSON — must be a JSON object';
+    }
+    const record = trigger;
+    const type = typeof record.type === 'string' ? record.type : undefined;
+    if (!type)
+        return 'Invalid trigger JSON — trigger.type is required';
+    if (type === 'interval') {
+        const ms = typeof record.ms === 'number' ? record.ms : Number.NaN;
+        if (!Number.isFinite(ms) || ms < MIN_INTERVAL_MS) {
+            return `Invalid trigger JSON — interval trigger ms must be a finite number >= ${MIN_INTERVAL_MS}`;
+        }
+        return null;
+    }
+    if (type === 'cron') {
+        return typeof record.expression === 'string' && record.expression.trim().length > 0
+            ? null
+            : 'Invalid trigger JSON — cron trigger expression must be a non-empty string';
+    }
+    if (type === 'once') {
+        const delayMs = typeof record.delayMs === 'number' ? record.delayMs : undefined;
+        const fireAt = typeof record.fireAt === 'number' ? record.fireAt : undefined;
+        if (delayMs != null) {
+            return Number.isFinite(delayMs) && delayMs >= MIN_ONCE_DELAY_MS
+                ? null
+                : `Invalid trigger JSON — once trigger delayMs must be a finite number >= ${MIN_ONCE_DELAY_MS}`;
+        }
+        if (fireAt != null) {
+            return Number.isFinite(fireAt) && fireAt >= Date.now()
+                ? null
+                : 'Invalid trigger JSON — once trigger fireAt must be a finite epoch ms in the future';
+        }
+        return 'Invalid trigger JSON — once trigger requires either delayMs or fireAt';
+    }
+    return `Invalid trigger JSON — unsupported trigger type: ${type}`;
+}
+function normalizeToolLabel(label) {
+    const result = normalizeScheduleTaskLabel(label);
+    if ('error' in result)
+        return { error: result.error.replace('display.label', 'label') };
+    return result.value;
+}
+// ─── Register scheduled task ────────────────────────────────
+export const registerScheduledTaskInputSchema = {
+    templateId: z
+        .string()
+        .min(1)
+        .describe('Template ID from list_schedule_templates (e.g. "reminder", "web-digest", "repo-activity")'),
+    trigger: z
+        .string()
+        .describe('Trigger config as JSON string. Choose type by intent: ' +
+        'interval — "every N hours/minutes" repeating from now, e.g. {"type":"interval","ms":7200000}. interval.ms must be >= 10000 (10s); ' +
+        'cron — specific wall-clock times/days, e.g. {"type":"cron","expression":"0 9 * * *","timezone":"Asia/Shanghai"}; ' +
+        'once — fire once after delay or at exact time. PREFER delayMs (relative) over fireAt (absolute) because model clocks may drift, e.g. {"type":"once","delayMs":120000}. delayMs must be >= 1000 (1s); fireAt must be a future epoch ms. ' +
+        'PREFER interval over cron when user says "every N hours/minutes".'),
+    params: z
+        .string()
+        .optional()
+        .describe('Template-specific parameters as JSON string (e.g. {"message":"检查 backlog"})'),
+    deliveryThreadId: z
+        .string()
+        .optional()
+        .describe('Thread ID to deliver results to. If omitted, results go to the default channel'),
+    label: z
+        .string()
+        .refine((value) => !('error' in normalizeScheduleTaskLabel(value)), 'label must be at most 64 characters')
+        .optional()
+        .describe('Human-readable task label (defaults to template label)'),
+    category: z.string().optional().describe('Display category: pr | repo | thread | system | external'),
+    description: z.string().optional().describe('Short description of this task instance'),
+};
+export async function handleRegisterScheduledTask(input) {
+    let trigger;
+    try {
+        trigger = JSON.parse(input.trigger);
+    }
+    catch {
+        return errorResult('Invalid trigger JSON — must be a valid JSON object');
+    }
+    {
+        const validationError = validateTriggerConfig(trigger);
+        if (validationError)
+            return errorResult(validationError);
+    }
+    let params = {};
+    if (input.params) {
+        try {
+            const parsed = JSON.parse(input.params);
+            if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed)) {
+                return errorResult('Invalid params JSON — must be a JSON object (not null, array, or primitive)');
+            }
+            params = parsed;
+        }
+        catch {
+            return errorResult('Invalid params JSON — must be a valid JSON object');
+        }
+    }
+    // Auto-inject current agent's ID so reminder tasks wake the registering agent, not default opus
+    const currentAgentId = process.env['OFFICE_CLAW_AGENT_ID'];
+    if (!params.targetAgentId && currentAgentId) {
+        params.targetAgentId = currentAgentId;
+    }
+    const body = {
+        templateId: input.templateId,
+        trigger,
+        params,
+    };
+    if (input.deliveryThreadId)
+        body.deliveryThreadId = input.deliveryThreadId;
+    if (currentAgentId)
+        body.createdBy = currentAgentId;
+    let normalizedLabel;
+    if (input.label !== undefined) {
+        const label = normalizeToolLabel(input.label);
+        if (typeof label !== 'string')
+            return errorResult(label.error);
+        normalizedLabel = label;
+    }
+    if (input.label || input.category || input.description) {
+        body.display = {
+            label: normalizedLabel ?? input.templateId,
+            category: input.category ?? 'system',
+            ...(input.description ? { description: input.description } : {}),
+        };
+    }
+    return callbackPost('/api/schedule/tasks', body);
+}
+// ─── Preview scheduled task (AC-G2: draft step) ────────────
+export const previewScheduledTaskInputSchema = {
+    templateId: z.string().min(1).describe('Template ID from list_schedule_templates'),
+    trigger: z
+        .string()
+        .describe('Trigger config as JSON string. Choose type by intent: ' +
+        'interval — "every N hours/minutes" repeating from now, e.g. {"type":"interval","ms":7200000}. interval.ms must be >= 10000 (10s); ' +
+        'cron — specific wall-clock times/days, e.g. {"type":"cron","expression":"0 9 * * *","timezone":"Asia/Shanghai"}; ' +
+        'once — fire once after delay or at exact time. PREFER delayMs (relative) over fireAt (absolute) because model clocks may drift, e.g. {"type":"once","delayMs":120000}. delayMs must be >= 1000 (1s); fireAt must be a future epoch ms. ' +
+        'PREFER interval over cron when user says "every N hours/minutes".'),
+    params: z.string().optional().describe('Template-specific parameters as JSON string'),
+    deliveryThreadId: z.string().optional().describe('Thread ID to deliver results to'),
+};
+export async function handlePreviewScheduledTask(input) {
+    let trigger;
+    try {
+        trigger = JSON.parse(input.trigger);
+    }
+    catch {
+        return errorResult('Invalid trigger JSON');
+    }
+    {
+        const validationError = validateTriggerConfig(trigger);
+        if (validationError)
+            return errorResult(validationError);
+    }
+    let params = {};
+    if (input.params) {
+        try {
+            params = JSON.parse(input.params);
+        }
+        catch {
+            return errorResult('Invalid params JSON');
+        }
+    }
+    const body = {
+        templateId: input.templateId,
+        trigger,
+        params,
+    };
+    if (input.deliveryThreadId)
+        body.deliveryThreadId = input.deliveryThreadId;
+    return callbackPost('/api/schedule/tasks/preview', body);
+}
+// ─── Update scheduled task ──────────────────────────────────
+export const updateScheduledTaskInputSchema = {
+    taskId: z.string().min(1).describe('The dynamic task ID to update (e.g. "dyn-1711504800000-abc123")'),
+    enabled: z.boolean().optional().describe('Whether the task should be enabled'),
+    trigger: z.string().optional().describe('Trigger config as JSON string, same format as register_scheduled_task'),
+    params: z.string().optional().describe('Template-specific parameters as JSON string; replaces existing params'),
+    deliveryThreadId: z.string().optional().describe('Thread ID to deliver results to'),
+    label: z
+        .string()
+        .refine((value) => !('error' in normalizeScheduleTaskLabel(value)), 'label must be at most 64 characters')
+        .optional()
+        .describe('Human-readable task label'),
+    category: z.string().optional().describe('Display category: pr | repo | thread | system | external'),
+    description: z.string().optional().describe('Short description of this task instance'),
+};
+export async function handleUpdateScheduledTask(input) {
+    const body = {};
+    if (input.enabled !== undefined)
+        body.enabled = input.enabled;
+    if (input.trigger) {
+        let trigger;
+        try {
+            trigger = JSON.parse(input.trigger);
+        }
+        catch {
+            return errorResult('Invalid trigger JSON — must be a valid JSON object');
+        }
+        const validationError = validateTriggerConfig(trigger);
+        if (validationError)
+            return errorResult(validationError);
+        body.trigger = trigger;
+    }
+    if (input.params) {
+        try {
+            const parsed = JSON.parse(input.params);
+            if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed)) {
+                return errorResult('Invalid params JSON — must be a JSON object (not null, array, or primitive)');
+            }
+            body.params = parsed;
+        }
+        catch {
+            return errorResult('Invalid params JSON — must be a valid JSON object');
+        }
+    }
+    if (input.deliveryThreadId)
+        body.deliveryThreadId = input.deliveryThreadId;
+    let normalizedLabel;
+    if (input.label !== undefined) {
+        const label = normalizeToolLabel(input.label);
+        if (typeof label !== 'string')
+            return errorResult(label.error);
+        normalizedLabel = label;
+    }
+    if (input.label || input.category || input.description) {
+        body.display = {
+            ...(normalizedLabel ? { label: normalizedLabel } : {}),
+            ...(input.category ? { category: input.category } : {}),
+            ...(input.description ? { description: input.description } : {}),
+        };
+    }
+    if (Object.keys(body).length === 0) {
+        return errorResult('No fields to update — provide enabled, trigger, params, deliveryThreadId, label, category, or description');
+    }
+    return callbackPatch(`/api/schedule/tasks/${encodeURIComponent(input.taskId)}`, body);
+}
+// ─── Remove scheduled task ──────────────────────────────────
+export const removeScheduledTaskInputSchema = {
+    taskId: z.string().min(1).describe('The dynamic task ID to remove (e.g. "dyn-1711504800000-abc123")'),
+};
+export async function handleRemoveScheduledTask(input) {
+    return callbackDelete(`/api/schedule/tasks/${encodeURIComponent(input.taskId)}`);
+}
+// ─── Enable/disable scheduled task ─────────────────────────
+export const setScheduledTaskEnabledInputSchema = {
+    taskId: z.string().min(1).describe('The dynamic task ID to update (e.g. "dyn-1711504800000-abc123")'),
+    enabled: z.boolean().describe('Whether the task should be enabled. false pauses the task without deleting it.'),
+};
+export async function handleSetScheduledTaskEnabled(input) {
+    return callbackPatch(`/api/schedule/tasks/${encodeURIComponent(input.taskId)}`, { enabled: input.enabled });
+}
+// ─── Tool definitions ───────────────────────────────────────
+export const scheduleTools = [
+    {
+        name: 'office_claw_list_scheduled_tasks',
+        description: 'List all currently registered scheduled tasks (both builtin and user-created dynamic tasks). ' +
+            'Returns task IDs, labels, triggers, last run info, and enabled state. ' +
+            'Use this to check what tasks are active before registering or removing tasks.',
+        inputSchema: listScheduledTasksInputSchema,
+        handler: handleListScheduledTasks,
+    },
+    {
+        name: 'office_claw_list_schedule_templates',
+        description: 'List available schedule task templates. Each template defines a reusable task type (e.g. reminder, web-digest, repo-activity) ' +
+            'with its parameter schema and default trigger. Use this to discover what kinds of scheduled tasks can be created. ' +
+            'When a task fires, it wakes a agent via invokeTrigger — the woken agent has FULL capabilities (rich blocks, search, image generation, etc.).',
+        inputSchema: listScheduleTemplatesInputSchema,
+        handler: handleListScheduleTemplates,
+    },
+    {
+        name: 'office_claw_preview_scheduled_task',
+        description: 'Preview a scheduled task BEFORE creating it (draft step). Returns a draft with resolved template info, trigger, and params ' +
+            'WITHOUT persisting anything. Show this draft to the user for confirmation before calling register_scheduled_task. ' +
+            'REQUIRED: Always preview first, then register only after user confirms.',
+        inputSchema: previewScheduledTaskInputSchema,
+        handler: handlePreviewScheduledTask,
+    },
+    {
+        name: 'office_claw_register_scheduled_task',
+        description: 'Create a new scheduled task from a template (confirm step). The task will be persisted and run automatically on schedule. ' +
+            'Supports recurring (cron/interval) and one-shot (once) triggers. Once tasks auto-retire after execution. ' +
+            'When the task fires, a agent is woken with full capabilities — it can send rich blocks (images, audio, cards), search the web, generate content, etc. ' +
+            'IMPORTANT: You MUST call preview_scheduled_task first and get user confirmation before calling this. ' +
+            'trigger and params must be JSON strings, not objects.',
+        inputSchema: registerScheduledTaskInputSchema,
+        handler: handleRegisterScheduledTask,
+    },
+    {
+        name: 'office_claw_update_scheduled_task',
+        description: 'Update a dynamic scheduled task by task ID. Supports changing enabled state, trigger, params, delivery thread, label, category, and description. ' +
+            'Use set_scheduled_task_enabled for simple pause/resume, and this tool when editing task configuration. ' +
+            'trigger and params must be JSON strings, not objects.',
+        inputSchema: updateScheduledTaskInputSchema,
+        handler: handleUpdateScheduledTask,
+    },
+    {
+        name: 'office_claw_set_scheduled_task_enabled',
+        description: 'Enable or disable a dynamic scheduled task by task ID without deleting it. ' +
+            'Use enabled=false when the user asks to cancel, stop, pause, or disable a scheduled task; this preserves the task record and prevents future runs. ' +
+            'Use enabled=true to resume it. Call remove_scheduled_task only when the user explicitly asks to delete/remove the task permanently.',
+        inputSchema: setScheduledTaskEnabledInputSchema,
+        handler: handleSetScheduledTaskEnabled,
+    },
+    {
+        name: 'office_claw_remove_scheduled_task',
+        description: 'Permanently delete a user-created dynamic scheduled task by its task ID. ' +
+            'Do NOT use this when the user asks to cancel, stop, pause, or disable a scheduled task; use office_claw_set_scheduled_task_enabled with enabled=false instead. ' +
+            'Only call this when the user explicitly asks to delete/remove the task record permanently. Does not work for builtin system tasks.',
+        inputSchema: removeScheduledTaskInputSchema,
+        handler: handleRemoveScheduledTask,
+    },
+];
+//# sourceMappingURL=schedule-tools.js.map

package/dist/tools/schedule-tools.js.map

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

package/dist/tools/session-chain-tools.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Session Chain MCP Tools — F24 Phase D + F98
+ * Tools for cats to read sealed session transcripts.
+ *
+ * Tools:
+ * - list_session_chain: List sessions for a thread
+ * - read_session_events: Paginated event read (view=raw|chat|handoff)
+ * - read_session_digest: Read extractive digest
+ * - read_invocation_detail: Read all events for a specific invocation
+ * - session_search: Full-text search across transcripts/digests
+ */
+import { z } from 'zod';
+import type { ToolResult } from './file-tools.js';
+export declare const listSessionChainInputSchema: {
+    threadId: z.ZodString;
+    agentId: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
+};
+export declare function handleListSessionChain(input: {
+    threadId: string;
+    agentId?: string | undefined;
+    limit?: number | undefined;
+}): Promise<ToolResult>;
+export declare const readSessionEventsInputSchema: {
+    sessionId: z.ZodString;
+    cursor: z.ZodOptional<z.ZodNumber>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    view: z.ZodOptional<z.ZodEnum<["raw", "chat", "handoff"]>>;
+};
+export declare function handleReadSessionEvents(input: {
+    sessionId: string;
+    cursor?: number | undefined;
+    limit?: number | undefined;
+    view?: string | undefined;
+}): Promise<ToolResult>;
+export declare const readSessionDigestInputSchema: {
+    sessionId: z.ZodString;
+};
+export declare function handleReadSessionDigest(input: {
+    sessionId: string;
+}): Promise<ToolResult>;
+export declare const readInvocationDetailInputSchema: {
+    sessionId: z.ZodString;
+    invocationId: z.ZodString;
+};
+export declare function handleReadInvocationDetail(input: {
+    sessionId: string;
+    invocationId: string;
+}): Promise<ToolResult>;
+export declare const sessionSearchInputSchema: {
+    threadId: z.ZodString;
+    query: z.ZodString;
+    agents: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    scope: z.ZodOptional<z.ZodEnum<["digests", "transcripts", "both"]>>;
+};
+export declare function handleSessionSearch(input: {
+    threadId: string;
+    query: string;
+    agents?: string | undefined;
+    limit?: number | undefined;
+    scope?: string | undefined;
+}): Promise<ToolResult>;
+export declare const sessionChainTools: readonly [{
+    readonly name: "office_claw_list_session_chain";
+    readonly description: string;
+    readonly inputSchema: {
+        threadId: z.ZodString;
+        agentId: z.ZodOptional<z.ZodString>;
+        limit: z.ZodOptional<z.ZodNumber>;
+    };
+    readonly handler: typeof handleListSessionChain;
+}, {
+    readonly name: "office_claw_read_session_events";
+    readonly description: string;
+    readonly inputSchema: {
+        sessionId: z.ZodString;
+        cursor: z.ZodOptional<z.ZodNumber>;
+        limit: z.ZodOptional<z.ZodNumber>;
+        view: z.ZodOptional<z.ZodEnum<["raw", "chat", "handoff"]>>;
+    };
+    readonly handler: typeof handleReadSessionEvents;
+}, {
+    readonly name: "office_claw_read_session_digest";
+    readonly description: string;
+    readonly inputSchema: {
+        sessionId: z.ZodString;
+    };
+    readonly handler: typeof handleReadSessionDigest;
+}, {
+    readonly name: "office_claw_read_invocation_detail";
+    readonly description: string;
+    readonly inputSchema: {
+        sessionId: z.ZodString;
+        invocationId: z.ZodString;
+    };
+    readonly handler: typeof handleReadInvocationDetail;
+}];
+//# sourceMappingURL=session-chain-tools.d.ts.map

package/dist/tools/session-chain-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-chain-tools.d.ts","sourceRoot":"","sources":["../../src/tools/session-chain-tools.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAwBlD,eAAO,MAAM,2BAA2B;;;;CAIvC,CAAC;AAEF,wBAAsB,sBAAsB,CAAC,KAAK,EAAE;IAClD,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5B,GAAG,OAAO,CAAC,UAAU,CAAC,CAwBtB;AAID,eAAO,MAAM,4BAA4B;;;;;CAUxC,CAAC;AAEF,wBAAsB,uBAAuB,CAAC,KAAK,EAAE;IACnD,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B,GAAG,OAAO,CAAC,UAAU,CAAC,CAkFtB;AAID,eAAO,MAAM,4BAA4B;;CAExC,CAAC;AAEF,wBAAsB,uBAAuB,CAAC,KAAK,EAAE;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,UAAU,CAAC,CAkB/F;AAID,eAAO,MAAM,+BAA+B;;;CAG3C,CAAC;AAEF,wBAAsB,0BAA0B,CAAC,KAAK,EAAE;IACtD,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;CACtB,GAAG,OAAO,CAAC,UAAU,CAAC,CA8BtB;AAID,eAAO,MAAM,wBAAwB;;;;;;CAMpC,CAAC;AAEF,wBAAsB,mBAAmB,CAAC,KAAK,EAAE;IAC/C,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5B,GAAG,OAAO,CAAC,UAAU,CAAC,CAiDtB;AAID,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgDpB,CAAC"}