@lingxiao-office/sdk 1.0.0

package/dist/core/ContextMemoryIndex.js

@@ -0,0 +1,431 @@
+import { existsSync, readFileSync, readdirSync, statSync } from 'fs';
+import { join } from 'path';
+import { getContextRuntimeStateKey } from './ContextRuntimeState.js';
+import { buildCompressedWorkerSnapshot } from './compress/BlackboardCompressor.js';
+import { countTokens } from '../llm/token_counter.js';
+import { Workspace } from './Workspace.js';
+import { normalizeTaskStatus } from './StateSemantics.js';
+import { buildTeamMessageAwarenessBlock, buildWorkNoteAwarenessBlock, metadataHasArtifactAwareness } from './ArtifactAwareness.js';
+import { getTeamMailbox } from './TeamMailbox.js';
+const DEFAULT_TOKEN_BUDGET = 4_000;
+const DEFAULT_MAX_ITEMS = 12;
+const MAX_ITEM_CHARS = 1_600;
+const MAX_ARCHIVE_CHARS = 2_400;
+const MAX_TASK_RESULT_CHARS = 1_200;
+const MAX_ARTIFACT_AWARENESS_CHARS = 1_400;
+const MAX_NOTE_CHARS = 1_200;
+const MAX_SCRATCHPAD_CHARS = 2_000;
+const MAX_TEAM_ARTIFACT_MESSAGES = 30;
+const MIN_ITEM_CHARS = 240;
+/**
+ * token→char 换算系数：recall 在 token 预算（remaining）将耗尽时，反推该条记忆的 char 截断上限。
+ * 取 3.2 是英文（~4 chars/token）、代码（~3-4）、中文（~1-2）的折中估计，保证剩余预算能塞下精简后的
+ * 记忆而非整体丢弃。单一常量、确定性，避免散落的魔术数字。
+ */
+const CHARS_PER_TOKEN_RATIO = 3.2;
+function truncate(text, maxChars) {
+    if (text.length <= maxChars)
+        return text;
+    return `${text.slice(0, maxChars)}\n...(truncated ${text.length - maxChars} chars)`;
+}
+/**
+ * 取尾部内容：scratchpad 最新进展在文件末尾，截断时优先保留尾部。
+ */
+function truncateTail(text, maxChars) {
+    if (text.length <= maxChars)
+        return text;
+    return `...(truncated ${text.length - maxChars} chars)\n${text.slice(-maxChars)}`;
+}
+function timestampMs(value) {
+    if (!value)
+        return 0;
+    return value < 10_000_000_000 ? value * 1000 : value;
+}
+/**
+ * 内容派生的稳定版本号（FNV-1a 32-bit → 31-bit 正整数）。
+ * 用于 blackboard 等"无天然 timestamp"的条目：同一内容 → 同一值，内容变化 → 值变化。
+ *
+ * 之前 recallBlackboard 用 Date.now() 作为 timestamp，而 buildMemoryItemsFingerprint
+ * 把 timestamp 纳入指纹 → 每个 leader think-cycle 指纹都不同 → 重注入闸门永不短路 →
+ * 每轮追加一条新的 manifest 系统消息，单调膨胀会话并击穿 prompt cache。
+ * 改用内容指纹后：blackboard 内容未变 → 指纹不变 → 闸门短路，不再重注入。
+ * blackboard 得分固定为 60（最高），排序不受 timestamp 数值影响，故用哈希作 timestamp 安全。
+ */
+function stableContentVersion(content) {
+    let hash = 0x811c9dc5;
+    for (let i = 0; i < content.length; i++) {
+        hash ^= content.charCodeAt(i);
+        hash = Math.imul(hash, 0x01000193);
+    }
+    return (hash >>> 0) % 0x7fffffff;
+}
+function renderNote(note) {
+    return truncate(buildWorkNoteAwarenessBlock(note), MAX_NOTE_CHARS);
+}
+function normalizeTaskResult(result) {
+    if (result == null || result === '')
+        return '';
+    const text = typeof result === 'string' ? result : JSON.stringify(result);
+    return truncate(text, MAX_TASK_RESULT_CHARS);
+}
+function extractArtifactAwareness(result) {
+    if (result == null || result === '')
+        return '';
+    const text = typeof result === 'string' ? result : JSON.stringify(result);
+    const marker = '### Cross-Agent Artifact Awareness';
+    const index = text.indexOf(marker);
+    if (index >= 0) {
+        const remainder = text.slice(index);
+        const nextSection = remainder.indexOf('\n### Worker Result');
+        const block = nextSection >= 0 ? remainder.slice(0, nextSection) : remainder;
+        return truncate(block, MAX_ARTIFACT_AWARENESS_CHARS);
+    }
+    const artifactLines = text
+        .split(/\r?\n/)
+        .filter(line => /files_created:|files_modified:|commands_run:|verification:|next_steps:/i.test(line))
+        .slice(0, 20);
+    return artifactLines.length > 0 ? truncate(artifactLines.join('\n'), MAX_ARTIFACT_AWARENESS_CHARS) : '';
+}
+function itemKey(item) {
+    return `${item.source}:${item.taskId || ''}:${item.agentId || ''}:${item.title}:${item.content.slice(0, 120)}`;
+}
+export class ContextMemoryIndex {
+    db;
+    workNoteManager;
+    constructor(db, workNoteManager) {
+        this.db = db;
+        this.workNoteManager = workNoteManager;
+    }
+    async recall(input) {
+        const blockedBy = new Set(input.blockedByTaskIds || []);
+        const items = [];
+        items.push(...this.recallTaskResults(input.sessionId, blockedBy));
+        items.push(...this.recallTeamArtifactMessages(input.sessionId, blockedBy));
+        items.push(...await this.recallWorkNotes(input.sessionId, blockedBy));
+        items.push(...this.recallCompactArchives(input.sessionId));
+        items.push(...this.recallScratchpads(input.sessionId, input.workspace, blockedBy));
+        if (input.includeBlackboard !== false && input.blackboardSnapshot) {
+            const blackboard = this.recallBlackboard(input.blackboardSnapshot);
+            if (blackboard)
+                items.push(blackboard);
+        }
+        const deduped = new Map();
+        for (const item of items) {
+            const key = itemKey(item);
+            const existing = deduped.get(key);
+            if (!existing || item.score > existing.score) {
+                deduped.set(key, item);
+            }
+        }
+        const sorted = this.rankItems([...deduped.values()]);
+        const selected = [];
+        const budget = input.tokenBudget ?? DEFAULT_TOKEN_BUDGET;
+        const maxItems = input.maxItems ?? DEFAULT_MAX_ITEMS;
+        let used = 0;
+        for (const item of sorted) {
+            if (selected.length >= maxItems)
+                break;
+            // scratchpad 的最新进展在尾部，截断时保留尾部；其余源保留头部。
+            let clipped = this.clipItemToChars(item, MAX_ITEM_CHARS);
+            let cost = countTokens(`${clipped.title}\n${clipped.content}`);
+            const remaining = Math.max(0, budget - used);
+            if (cost > remaining) {
+                const maxCharsForRemaining = Math.max(MIN_ITEM_CHARS, Math.floor(remaining * CHARS_PER_TOKEN_RATIO) - clipped.title.length);
+                clipped = this.clipItemToChars(item, Math.min(MAX_ITEM_CHARS, maxCharsForRemaining));
+                cost = countTokens(`${clipped.title}\n${clipped.content}`);
+            }
+            if (cost > remaining) {
+                continue;
+            }
+            selected.push(clipped);
+            used += cost;
+            if (used >= budget)
+                break;
+        }
+        return {
+            items: selected,
+            rendered: this.render(selected),
+            estimatedTokens: used,
+            dropped: Math.max(0, sorted.length - selected.length),
+        };
+    }
+    /**
+     * 确定性排序：score 降序，并列时按时间戳降序（最新优先）。无 LLM、无语义重排、无置信度——
+     * 旧的 opt-in 语义重排（runStructuredJudgment + buildMemoryQuery query）从未被任何调用方启用，
+     * 是死代码且引入非确定性，已移除。recall 结果完全可复现。
+     */
+    rankItems(items) {
+        return [...items].sort((a, b) => b.score - a.score || timestampMs(b.timestamp) - timestampMs(a.timestamp));
+    }
+    recallTaskResults(sessionId, blockedBy) {
+        const tasks = this.db.getTasksBySession(sessionId);
+        const items = [];
+        for (const task of tasks) {
+            const result = normalizeTaskResult(task.result);
+            const dependencyBoost = blockedBy.has(task.id) ? 30 : 0;
+            const normalizedStatus = normalizeTaskStatus(task);
+            const terminalBoost = normalizedStatus === 'completed' ? 8
+                : normalizedStatus === 'failed' ? 5 : 0;
+            const artifactAwareness = extractArtifactAwareness(task.result);
+            if (artifactAwareness) {
+                items.push({
+                    id: `artifact:${task.id}`,
+                    source: 'artifact_awareness',
+                    title: `[${task.id}] artifact awareness: ${task.subject}`,
+                    content: artifactAwareness,
+                    score: 34 + dependencyBoost + terminalBoost,
+                    timestamp: task.updated_at || task.created_at,
+                    taskId: task.id,
+                    agentId: task.assigned_agent,
+                });
+            }
+            if (!result)
+                continue;
+            if (blockedBy.size > 0 && !blockedBy.has(task.id))
+                continue;
+            items.push({
+                id: `task:${task.id}`,
+                source: 'task_result',
+                title: `[${task.id}] ${task.subject}`,
+                content: result,
+                score: dependencyBoost + terminalBoost,
+                timestamp: task.updated_at || task.created_at,
+                taskId: task.id,
+                agentId: task.assigned_agent,
+            });
+        }
+        return items;
+    }
+    clipItemToChars(item, maxChars) {
+        const safeMax = Math.max(MIN_ITEM_CHARS, maxChars);
+        const content = item.source === 'scratchpad'
+            ? truncateTail(item.content, safeMax)
+            : truncate(item.content, safeMax);
+        return { ...item, content };
+    }
+    recallTeamArtifactMessages(sessionId, blockedBy) {
+        let messages = [];
+        try {
+            const mailbox = getTeamMailbox();
+            const teams = mailbox.getAllTeams(sessionId);
+            const seen = new Set();
+            for (const team of teams) {
+                for (const message of mailbox.getMessages(team.name, { sessionId })) {
+                    if (seen.has(message.id))
+                        continue;
+                    seen.add(message.id);
+                    messages.push(message);
+                }
+            }
+        }
+        catch { /* expected: data source unavailable */
+            return [];
+        }
+        messages = messages
+            .filter((message) => metadataHasArtifactAwareness(message.metadata))
+            .sort((a, b) => b.timestamp - a.timestamp)
+            .slice(0, MAX_TEAM_ARTIFACT_MESSAGES);
+        const items = [];
+        for (const message of messages) {
+            const metadata = message.metadata ?? {};
+            const taskIds = [metadata.taskId, metadata.sourceTaskId, metadata.targetTaskId].filter(Boolean);
+            const taskId = taskIds[0];
+            const dependencyBoost = taskIds.some((id) => blockedBy.has(id)) ? 26 : 0;
+            const content = buildTeamMessageAwarenessBlock(message);
+            if (!content)
+                continue;
+            items.push({
+                id: `team-artifact:${message.id}`,
+                source: 'artifact_awareness',
+                title: `[team] ${metadata.intent || 'message'} from ${message.fromMember || 'system'}`,
+                content: truncate(content, MAX_ARTIFACT_AWARENESS_CHARS),
+                score: 31 + dependencyBoost,
+                timestamp: message.timestamp,
+                taskId,
+                agentId: message.fromMember,
+                artifact: metadata.artifactPaths?.[0],
+            });
+        }
+        return items;
+    }
+    async recallWorkNotes(sessionId, blockedBy) {
+        const notes = await this.workNoteManager.getAllNotes(sessionId);
+        return notes.map((note) => {
+            const noteContent = renderNote(note);
+            const awareness = buildWorkNoteAwarenessBlock(note);
+            const hasArtifactSignals = (note.artifacts?.length ?? 0) > 0 ||
+                (note.keyFindings?.length ?? 0) > 0 ||
+                (note.nextSteps?.length ?? 0) > 0 ||
+                (note.blockers?.length ?? 0) > 0 ||
+                Boolean(note.impactAnalysis?.trim());
+            const content = hasArtifactSignals && awareness
+                ? truncate(awareness, MAX_ARTIFACT_AWARENESS_CHARS)
+                : noteContent;
+            const dependencyBoost = blockedBy.has(note.taskId) ? 24 : 0;
+            const phaseBoost = note.phase === 'testing' || note.phase === 'reviewing' ? 4 : 2;
+            const artifactBoost = hasArtifactSignals ? 10 : 0;
+            return {
+                id: `note:${note.id}`,
+                source: hasArtifactSignals ? 'artifact_awareness' : 'work_note',
+                title: `[${note.taskId}] ${note.phase} by ${note.agentId}`,
+                content,
+                score: artifactBoost + dependencyBoost + phaseBoost,
+                timestamp: note.timestamp,
+                taskId: note.taskId,
+                agentId: note.agentId,
+                artifact: note.artifacts?.[0],
+            };
+        }).filter((item) => item.score > 0);
+    }
+    recallCompactArchives(sessionId) {
+        const states = [
+            this.db.getSessionState(sessionId, getContextRuntimeStateKey({ kind: 'leader' })),
+        ];
+        const items = [];
+        for (const state of states) {
+            if (!state || typeof state !== 'object')
+                continue;
+            const compactHistory = Array.isArray(state.compactHistory)
+                ? state.compactHistory
+                : [];
+            for (const record of compactHistory) {
+                if (!record.archivePath)
+                    continue;
+                const content = this.readArchivePreview(record.archivePath);
+                if (!content)
+                    continue;
+                items.push({
+                    id: `archive:${record.archivePath}`,
+                    source: 'compact_archive',
+                    title: `Context archive ${new Date(timestampMs(record.timestamp)).toISOString()}`,
+                    content,
+                    score: 6,
+                    timestamp: record.timestamp,
+                    artifact: record.archivePath,
+                });
+            }
+        }
+        return items;
+    }
+    recallBlackboard(snapshot) {
+        const content = typeof snapshot === 'string'
+            ? snapshot
+            : buildCompressedWorkerSnapshot(snapshot, 1_500);
+        if (!content.trim())
+            return null;
+        return {
+            id: 'blackboard:latest',
+            source: 'blackboard',
+            title: 'Blackboard latest compressed snapshot (contracts/design docs included)',
+            content: truncate(content, MAX_ITEM_CHARS),
+            score: 60,
+            // 内容派生的稳定版本号（非 wall-clock）：见 stableContentVersion 注释。
+            // 保证 blackboard 内容不变时指纹稳定，避免每轮重注入击穿 prompt cache。
+            timestamp: stableContentVersion(content),
+        };
+    }
+    /**
+     * 召回上游依赖任务的 scratchpad 笔记。
+     *
+     * 仅在提供 workspace 时启用，且仅读取 blocked_by 精确命中的任务文件
+     * （命名约定见 worker prompt：`<taskId>.md` / `<taskId>_<role>.md`）。
+     * 依赖关系是精确的 task-id 前缀匹配。
+     * 内容取文件尾部（最新进展），并交由统一的 tokenBudget + maxItems 防爆炸。
+     */
+    recallScratchpads(sessionId, workspace, blockedBy) {
+        if (!workspace || blockedBy.size === 0)
+            return [];
+        let dir;
+        try {
+            dir = Workspace.getScratchpadDir(sessionId, workspace);
+        }
+        catch { /* expected: data source unavailable */
+            return [];
+        }
+        if (!existsSync(dir))
+            return [];
+        let entries;
+        try {
+            entries = readdirSync(dir);
+        }
+        catch { /* expected: data source unavailable */
+            return [];
+        }
+        const items = [];
+        for (const file of entries) {
+            if (!file.endsWith('.md'))
+                continue;
+            const taskId = this.matchScratchpadTaskId(file, blockedBy);
+            if (!taskId)
+                continue;
+            const fullPath = join(dir, file);
+            let content;
+            let mtimeMs;
+            try {
+                const stat = statSync(fullPath);
+                if (!stat.isFile())
+                    continue;
+                mtimeMs = stat.mtimeMs;
+                content = readFileSync(fullPath, 'utf-8');
+            }
+            catch { /* expected: skip invalid entry */
+                continue;
+            }
+            if (!content.trim())
+                continue;
+            const tail = truncateTail(content, MAX_SCRATCHPAD_CHARS);
+            items.push({
+                id: `scratchpad:${file}`,
+                source: 'scratchpad',
+                title: `[${taskId}] scratchpad ${file}`,
+                content: tail,
+                score: 22,
+                timestamp: mtimeMs,
+                taskId,
+                artifact: fullPath,
+            });
+        }
+        return items;
+    }
+    /**
+     * 文件名是否对应某个上游依赖任务。
+     * 命名约定：`<taskId>.md` 或 `<taskId>_<role>.md`，与 buildScratchpadSection 一致。
+     */
+    matchScratchpadTaskId(file, blockedBy) {
+        const base = file.slice(0, -'.md'.length);
+        for (const taskId of blockedBy) {
+            if (base === taskId || base.startsWith(`${taskId}_`)) {
+                return taskId;
+            }
+        }
+        return undefined;
+    }
+    readArchivePreview(archivePath) {
+        try {
+            const raw = readFileSync(archivePath, 'utf-8');
+            const metaMatch = raw.match(/<!-- lingxiao-context-archive\n([\s\S]*?)\n-->/);
+            const metadata = metaMatch?.[1] ? `metadata: ${metaMatch[1].trim()}` : '';
+            const summaryMatch = raw.match(/## Summary\n([\s\S]*?)(?:\n## Original Messages|\n## Algorithmic Records|$)/);
+            const recordsMatch = raw.match(/## Algorithmic Records\n([\s\S]*?)(?:\n## Summary|$)/);
+            const selected = [
+                metadata,
+                summaryMatch?.[1]?.trim(),
+                recordsMatch?.[1]?.trim(),
+            ].filter(Boolean).join('\n\n');
+            return truncate(selected || raw, MAX_ARCHIVE_CHARS);
+        }
+        catch { /* expected: fallback to default */
+            return '';
+        }
+    }
+    render(items) {
+        if (items.length === 0)
+            return '';
+        const lines = ['### 相关上下文记忆（系统自动召回）'];
+        for (const item of items) {
+            lines.push('', `#### ${item.title}`, `source=${item.source}${item.taskId ? ` task=${item.taskId}` : ''}${item.agentId ? ` agent=${item.agentId}` : ''}${item.artifact ? ` artifact=${item.artifact}` : ''}`, item.content);
+        }
+        return lines.join('\n');
+    }
+}
+//# sourceMappingURL=ContextMemoryIndex.js.map

package/dist/core/ContextMemoryIndex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContextMemoryIndex.js","sourceRoot":"","sources":["../../src/core/ContextMemoryIndex.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,IAAI,CAAC;AACrE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAI5B,OAAO,EAAE,yBAAyB,EAA6B,MAAM,0BAA0B,CAAC;AAChG,OAAO,EAAE,6BAA6B,EAAE,MAAM,oCAAoC,CAAC;AAEnF,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,8BAA8B,EAAE,2BAA2B,EAAE,4BAA4B,EAAE,MAAM,wBAAwB,CAAC;AACnI,OAAO,EAAE,cAAc,EAAoB,MAAM,kBAAkB,CAAC;AAgDpE,MAAM,oBAAoB,GAAG,KAAK,CAAC;AACnC,MAAM,iBAAiB,GAAG,EAAE,CAAC;AAC7B,MAAM,cAAc,GAAG,KAAK,CAAC;AAC7B,MAAM,iBAAiB,GAAG,KAAK,CAAC;AAChC,MAAM,qBAAqB,GAAG,KAAK,CAAC;AACpC,MAAM,4BAA4B,GAAG,KAAK,CAAC;AAC3C,MAAM,cAAc,GAAG,KAAK,CAAC;AAC7B,MAAM,oBAAoB,GAAG,KAAK,CAAC;AACnC,MAAM,0BAA0B,GAAG,EAAE,CAAC;AACtC,MAAM,cAAc,GAAG,GAAG,CAAC;AAC3B;;;;GAIG;AACH,MAAM,qBAAqB,GAAG,GAAG,CAAC;AAElC,SAAS,QAAQ,CAAC,IAAY,EAAE,QAAgB;IAC9C,IAAI,IAAI,CAAC,MAAM,IAAI,QAAQ;QAAE,OAAO,IAAI,CAAC;IACzC,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,mBAAmB,IAAI,CAAC,MAAM,GAAG,QAAQ,SAAS,CAAC;AACtF,CAAC;AAED;;GAEG;AACH,SAAS,YAAY,CAAC,IAAY,EAAE,QAAgB;IAClD,IAAI,IAAI,CAAC,MAAM,IAAI,QAAQ;QAAE,OAAO,IAAI,CAAC;IACzC,OAAO,iBAAiB,IAAI,CAAC,MAAM,GAAG,QAAQ,YAAY,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC;AACpF,CAAC;AAED,SAAS,WAAW,CAAC,KAAc;IACjC,IAAI,CAAC,KAAK;QAAE,OAAO,CAAC,CAAC;IACrB,OAAO,KAAK,GAAG,cAAc,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC;AACvD,CAAC;AAED;;;;;;;;;GASG;AACH,SAAS,oBAAoB,CAAC,OAAe;IAC3C,IAAI,IAAI,GAAG,UAAU,CAAC;IACtB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACxC,IAAI,IAAI,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAC9B,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IACrC,CAAC;IACD,OAAO,CAAC,IAAI,KAAK,CAAC,CAAC,GAAG,UAAU,CAAC;AACnC,CAAC;AAED,SAAS,UAAU,CAAC,IAAc;IAChC,OAAO,QAAQ,CAAC,2BAA2B,CAAC,IAAI,CAAC,EAAE,cAAc,CAAC,CAAC;AACrE,CAAC;AAED,SAAS,mBAAmB,CAAC,MAAe;IAC1C,IAAI,MAAM,IAAI,IAAI,IAAI,MAAM,KAAK,EAAE;QAAE,OAAO,EAAE,CAAC;IAC/C,MAAM,IAAI,GAAG,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAC1E,OAAO,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC,CAAC;AAC/C,CAAC;AAED,SAAS,wBAAwB,CAAC,MAAe;IAC/C,IAAI,MAAM,IAAI,IAAI,IAAI,MAAM,KAAK,EAAE;QAAE,OAAO,EAAE,CAAC;IAC/C,MAAM,IAAI,GAAG,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAC1E,MAAM,MAAM,GAAG,oCAAoC,CAAC;IACpD,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACnC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;QACf,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACpC,MAAM,WAAW,GAAG,SAAS,CAAC,OAAO,CAAC,qBAAqB,CAAC,CAAC;QAC7D,MAAM,KAAK,GAAG,WAAW,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC7E,OAAO,QAAQ,CAAC,KAAK,EAAE,4BAA4B,CAAC,CAAC;IACvD,CAAC;IACD,MAAM,aAAa,GAAG,IAAI;SACvB,KAAK,CAAC,OAAO,CAAC;SACd,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,yEAAyE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;SACpG,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAChB,OAAO,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,4BAA4B,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AAC1G,CAAC;AAED,SAAS,OAAO,CAAC,IAAuB;IACtC,OAAO,GAAG,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,IAAI,EAAE,IAAI,IAAI,CAAC,OAAO,IAAI,EAAE,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;AACjH,CAAC;AAGD,MAAM,OAAO,kBAAkB;IAEV;IACA;IAFnB,YACmB,EAAkE,EAClE,eAAqD;QADrD,OAAE,GAAF,EAAE,CAAgE;QAClE,oBAAe,GAAf,eAAe,CAAsC;IACrE,CAAC;IAEJ,KAAK,CAAC,MAAM,CAAC,KAA+B;QAC1C,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,gBAAgB,IAAI,EAAE,CAAC,CAAC;QACxD,MAAM,KAAK,GAAwB,EAAE,CAAC;QAEtC,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC;QAClE,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,0BAA0B,CAAC,KAAK,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC;QAC3E,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC;QACtE,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,qBAAqB,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;QAC3D,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC;QAEnF,IAAI,KAAK,CAAC,iBAAiB,KAAK,KAAK,IAAI,KAAK,CAAC,kBAAkB,EAAE,CAAC;YAClE,MAAM,UAAU,GAAG,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;YACnE,IAAI,UAAU;gBAAE,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACzC,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,GAAG,EAA6B,CAAC;QACrD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;YAC1B,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAClC,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,KAAK,GAAG,QAAQ,CAAC,KAAK,EAAE,CAAC;gBAC7C,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YACzB,CAAC;QACH,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QACrD,MAAM,QAAQ,GAAwB,EAAE,CAAC;QACzC,MAAM,MAAM,GAAG,KAAK,CAAC,WAAW,IAAI,oBAAoB,CAAC;QACzD,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,IAAI,iBAAiB,CAAC;QACrD,IAAI,IAAI,GAAG,CAAC,CAAC;QAEb,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;YAC1B,IAAI,QAAQ,CAAC,MAAM,IAAI,QAAQ;gBAAE,MAAM;YACvC,uCAAuC;YACvC,IAAI,OAAO,GAAG,IAAI,CAAC,eAAe,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;YACzD,IAAI,IAAI,GAAG,WAAW,CAAC,GAAG,OAAO,CAAC,KAAK,KAAK,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;YAC/D,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC;YAE7C,IAAI,IAAI,GAAG,SAAS,EAAE,CAAC;gBACrB,MAAM,oBAAoB,GAAG,IAAI,CAAC,GAAG,CACnC,cAAc,EACd,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,qBAAqB,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,CACrE,CAAC;gBACF,OAAO,GAAG,IAAI,CAAC,eAAe,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,cAAc,EAAE,oBAAoB,CAAC,CAAC,CAAC;gBACrF,IAAI,GAAG,WAAW,CAAC,GAAG,OAAO,CAAC,KAAK,KAAK,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;YAC7D,CAAC;YAED,IAAI,IAAI,GAAG,SAAS,EAAE,CAAC;gBACrB,SAAS;YACX,CAAC;YACD,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACvB,IAAI,IAAI,IAAI,CAAC;YACb,IAAI,IAAI,IAAI,MAAM;gBAAE,MAAM;QAC5B,CAAC;QAED,OAAO;YACL,KAAK,EAAE,QAAQ;YACf,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC;YAC/B,eAAe,EAAE,IAAI;YACrB,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC;SACtD,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACK,SAAS,CAAC,KAA0B;QAC1C,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAC9B,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,IAAI,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CACzE,CAAC;IACJ,CAAC;IAEO,iBAAiB,CAAC,SAAiB,EAAE,SAAsB;QACjE,MAAM,KAAK,GAAG,IAAI,CAAC,EAAE,CAAC,iBAAiB,CAAC,SAAS,CAAW,CAAC;QAC7D,MAAM,KAAK,GAAwB,EAAE,CAAC;QACtC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,MAAM,GAAG,mBAAmB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAChD,MAAM,eAAe,GAAG,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;YACxD,MAAM,gBAAgB,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC;YACnD,MAAM,aAAa,GAAG,gBAAgB,KAAK,WAAW,CAAC,CAAC,CAAC,CAAC;gBACxD,CAAC,CAAC,gBAAgB,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC1C,MAAM,iBAAiB,GAAG,wBAAwB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAChE,IAAI,iBAAiB,EAAE,CAAC;gBACtB,KAAK,CAAC,IAAI,CAAC;oBACT,EAAE,EAAE,YAAY,IAAI,CAAC,EAAE,EAAE;oBACzB,MAAM,EAAE,oBAAoB;oBAC5B,KAAK,EAAE,IAAI,IAAI,CAAC,EAAE,yBAAyB,IAAI,CAAC,OAAO,EAAE;oBACzD,OAAO,EAAE,iBAAiB;oBAC1B,KAAK,EAAE,EAAE,GAAG,eAAe,GAAG,aAAa;oBAC3C,SAAS,EAAE,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,UAAU;oBAC7C,MAAM,EAAE,IAAI,CAAC,EAAE;oBACf,OAAO,EAAE,IAAI,CAAC,cAAc;iBAC7B,CAAC,CAAC;YACL,CAAC;YACD,IAAI,CAAC,MAAM;gBAAE,SAAS;YACtB,IAAI,SAAS,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBAAE,SAAS;YAC5D,KAAK,CAAC,IAAI,CAAC;gBACT,EAAE,EAAE,QAAQ,IAAI,CAAC,EAAE,EAAE;gBACrB,MAAM,EAAE,aAAa;gBACrB,KAAK,EAAE,IAAI,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,OAAO,EAAE;gBACrC,OAAO,EAAE,MAAM;gBACf,KAAK,EAAE,eAAe,GAAG,aAAa;gBACtC,SAAS,EAAE,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,UAAU;gBAC7C,MAAM,EAAE,IAAI,CAAC,EAAE;gBACf,OAAO,EAAE,IAAI,CAAC,cAAc;aAC7B,CAAC,CAAC;QACL,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAEO,eAAe,CAAC,IAAuB,EAAE,QAAgB;QAC/D,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC;QACnD,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,KAAK,YAAY;YAC1C,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC;YACrC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACpC,OAAO,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,CAAC;IAC9B,CAAC;IAEO,0BAA0B,CAAC,SAAiB,EAAE,SAAsB;QAC1E,IAAI,QAAQ,GAAkB,EAAE,CAAC;QACjC,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,cAAc,EAAE,CAAC;YACjC,MAAM,KAAK,GAAG,OAAO,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;YAC7C,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;YAC/B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,KAAK,MAAM,OAAO,IAAI,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;oBACpE,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;wBAAE,SAAS;oBACnC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;oBACrB,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBACzB,CAAC;YACH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC,CAAA,uCAAuC;YAC9C,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,QAAQ,GAAG,QAAQ;aAChB,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,4BAA4B,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;aACnE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC;aACzC,KAAK,CAAC,CAAC,EAAE,0BAA0B,CAAC,CAAC;QAExC,MAAM,KAAK,GAAwB,EAAE,CAAC;QACtC,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC;YACxC,MAAM,OAAO,GAAG,CAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,YAAY,EAAE,QAAQ,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC,OAAO,CAAa,CAAC;YAC5G,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;YAC1B,MAAM,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;YACzE,MAAM,OAAO,GAAG,8BAA8B,CAAC,OAAO,CAAC,CAAC;YACxD,IAAI,CAAC,OAAO;gBAAE,SAAS;YACvB,KAAK,CAAC,IAAI,CAAC;gBACT,EAAE,EAAE,iBAAiB,OAAO,CAAC,EAAE,EAAE;gBACjC,MAAM,EAAE,oBAAoB;gBAC5B,KAAK,EAAE,UAAU,QAAQ,CAAC,MAAM,IAAI,SAAS,SAAS,OAAO,CAAC,UAAU,IAAI,QAAQ,EAAE;gBACtF,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,4BAA4B,CAAC;gBACxD,KAAK,EAAE,EAAE,GAAG,eAAe;gBAC3B,SAAS,EAAE,OAAO,CAAC,SAAS;gBAC5B,MAAM;gBACN,OAAO,EAAE,OAAO,CAAC,UAAU;gBAC3B,QAAQ,EAAE,QAAQ,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC;aACtC,CAAC,CAAC;QACL,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAEO,KAAK,CAAC,eAAe,CAAC,SAAiB,EAAE,SAAsB;QACrE,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;QAChE,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;YACxB,MAAM,WAAW,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;YACrC,MAAM,SAAS,GAAG,2BAA2B,CAAC,IAAI,CAAC,CAAC;YACpD,MAAM,kBAAkB,GACtB,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC;gBACjC,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC;gBACnC,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC;gBACjC,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC;gBAChC,OAAO,CAAC,IAAI,CAAC,cAAc,EAAE,IAAI,EAAE,CAAC,CAAC;YACvC,MAAM,OAAO,GAAG,kBAAkB,IAAI,SAAS;gBAC7C,CAAC,CAAC,QAAQ,CAAC,SAAS,EAAE,4BAA4B,CAAC;gBACnD,CAAC,CAAC,WAAW,CAAC;YAChB,MAAM,eAAe,GAAG,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;YAC5D,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,KAAK,SAAS,IAAI,IAAI,CAAC,KAAK,KAAK,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAClF,MAAM,aAAa,GAAG,kBAAkB,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;YAClD,OAAO;gBACL,EAAE,EAAE,QAAQ,IAAI,CAAC,EAAE,EAAE;gBACrB,MAAM,EAAE,kBAAkB,CAAC,CAAC,CAAC,oBAA6B,CAAC,CAAC,CAAC,WAAoB;gBACjF,KAAK,EAAE,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC,KAAK,OAAO,IAAI,CAAC,OAAO,EAAE;gBAC1D,OAAO;gBACP,KAAK,EAAE,aAAa,GAAG,eAAe,GAAG,UAAU;gBACnD,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,QAAQ,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;aAC9B,CAAC;QACJ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;IACtC,CAAC;IAEO,qBAAqB,CAAC,SAAiB;QAC7C,MAAM,MAAM,GAAG;YACb,IAAI,CAAC,EAAE,CAAC,eAAe,CAAC,SAAS,EAAE,yBAAyB,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;SAClF,CAAC;QACF,MAAM,KAAK,GAAwB,EAAE,CAAC;QACtC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;gBAAE,SAAS;YAClD,MAAM,cAAc,GAAG,KAAK,CAAC,OAAO,CAAE,KAAsC,CAAC,cAAc,CAAC;gBAC1F,CAAC,CAAE,KAAoD,CAAC,cAAc;gBACtE,CAAC,CAAC,EAAE,CAAC;YACP,KAAK,MAAM,MAAM,IAAI,cAAc,EAAE,CAAC;gBACpC,IAAI,CAAC,MAAM,CAAC,WAAW;oBAAE,SAAS;gBAClC,MAAM,OAAO,GAAG,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;gBAC5D,IAAI,CAAC,OAAO;oBAAE,SAAS;gBACvB,KAAK,CAAC,IAAI,CAAC;oBACT,EAAE,EAAE,WAAW,MAAM,CAAC,WAAW,EAAE;oBACnC,MAAM,EAAE,iBAAiB;oBACzB,KAAK,EAAE,mBAAmB,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,EAAE,EAAE;oBACjF,OAAO;oBACP,KAAK,EAAE,CAAC;oBACR,SAAS,EAAE,MAAM,CAAC,SAAS;oBAC3B,QAAQ,EAAE,MAAM,CAAC,WAAW;iBAC7B,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAEO,gBAAgB,CAAC,QAAgC;QACvD,MAAM,OAAO,GAAG,OAAO,QAAQ,KAAK,QAAQ;YAC1C,CAAC,CAAC,QAAQ;YACV,CAAC,CAAC,6BAA6B,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QACnD,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE;YAAE,OAAO,IAAI,CAAC;QACjC,OAAO;YACL,EAAE,EAAE,mBAAmB;YACvB,MAAM,EAAE,YAAY;YACpB,KAAK,EAAE,wEAAwE;YAC/E,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;YAC1C,KAAK,EAAE,EAAE;YACT,sDAAsD;YACtD,kDAAkD;YAClD,SAAS,EAAE,oBAAoB,CAAC,OAAO,CAAC;SACzC,CAAC;IACJ,CAAC;IAED;;;;;;;OAOG;IACK,iBAAiB,CACvB,SAAiB,EACjB,SAA6B,EAC7B,SAAsB;QAEtB,IAAI,CAAC,SAAS,IAAI,SAAS,CAAC,IAAI,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QAElD,IAAI,GAAW,CAAC;QAChB,IAAI,CAAC;YACH,GAAG,GAAG,SAAS,CAAC,gBAAgB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QACzD,CAAC;QAAC,MAAM,CAAC,CAAA,uCAAuC;YAC9C,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,OAAO,EAAE,CAAC;QAEhC,IAAI,OAAiB,CAAC;QACtB,IAAI,CAAC;YACH,OAAO,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;QAC7B,CAAC;QAAC,MAAM,CAAC,CAAA,uCAAuC;YAC9C,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,KAAK,GAAwB,EAAE,CAAC;QACtC,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;YAC3B,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;gBAAE,SAAS;YACpC,MAAM,MAAM,GAAG,IAAI,CAAC,qBAAqB,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;YAC3D,IAAI,CAAC,MAAM;gBAAE,SAAS;YAEtB,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YACjC,IAAI,OAAe,CAAC;YACpB,IAAI,OAAe,CAAC;YACpB,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;gBAChC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE;oBAAE,SAAS;gBAC7B,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;gBACvB,OAAO,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YAC5C,CAAC;YAAC,MAAM,CAAC,CAAA,kCAAkC;gBACzC,SAAS;YACX,CAAC;YACD,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE;gBAAE,SAAS;YAE9B,MAAM,IAAI,GAAG,YAAY,CAAC,OAAO,EAAE,oBAAoB,CAAC,CAAC;YACzD,KAAK,CAAC,IAAI,CAAC;gBACT,EAAE,EAAE,cAAc,IAAI,EAAE;gBACxB,MAAM,EAAE,YAAY;gBACpB,KAAK,EAAE,IAAI,MAAM,gBAAgB,IAAI,EAAE;gBACvC,OAAO,EAAE,IAAI;gBACb,KAAK,EAAE,EAAE;gBACT,SAAS,EAAE,OAAO;gBAClB,MAAM;gBACN,QAAQ,EAAE,QAAQ;aACnB,CAAC,CAAC;QACL,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;OAGG;IACK,qBAAqB,CAAC,IAAY,EAAE,SAAsB;QAChE,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC1C,KAAK,MAAM,MAAM,IAAI,SAAS,EAAE,CAAC;YAC/B,IAAI,IAAI,KAAK,MAAM,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,MAAM,GAAG,CAAC,EAAE,CAAC;gBACrD,OAAO,MAAM,CAAC;YAChB,CAAC;QACH,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAEO,kBAAkB,CAAC,WAAmB;QAC5C,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;YAC/C,MAAM,SAAS,GAAG,GAAG,CAAC,KAAK,CAAC,gDAAgD,CAAC,CAAC;YAC9E,MAAM,QAAQ,GAAG,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC1E,MAAM,YAAY,GAAG,GAAG,CAAC,KAAK,CAAC,6EAA6E,CAAC,CAAC;YAC9G,MAAM,YAAY,GAAG,GAAG,CAAC,KAAK,CAAC,sDAAsD,CAAC,CAAC;YACvF,MAAM,QAAQ,GAAG;gBACf,QAAQ;gBACR,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE;gBACzB,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE;aAC1B,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAC/B,OAAO,QAAQ,CAAC,QAAQ,IAAI,GAAG,EAAE,iBAAiB,CAAC,CAAC;QACtD,CAAC;QAAC,MAAM,CAAC,CAAA,mCAAmC;YAC1C,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAEO,MAAM,CAAC,KAA0B;QACvC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QAClC,MAAM,KAAK,GAAG,CAAC,qBAAqB,CAAC,CAAC;QACtC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,KAAK,CAAC,IAAI,CACR,EAAE,EACF,QAAQ,IAAI,CAAC,KAAK,EAAE,EACpB,UAAU,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,aAAa,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EACtK,IAAI,CAAC,OAAO,CACb,CAAC;QACJ,CAAC;QACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;CACF"}

package/dist/core/ContextRuntimeState.d.ts

@@ -0,0 +1,43 @@
+export interface ContextRuntimeOwner {
+    kind: 'leader' | 'agent';
+    workspace?: string;
+    agentId?: string;
+    agentName?: string;
+}
+export interface RecentFileSnapshot {
+    path: string;
+    timestamp: number;
+    charCount: number;
+    tokenEstimate: number;
+}
+export interface ContextCompactRecord {
+    timestamp: number;
+    oldTokens: number;
+    newTokens: number;
+    compactType: string;
+    archivePath?: string;
+    messageCount: number;
+}
+export interface ContextRuntimeState {
+    owner: ContextRuntimeOwner;
+    sessionId?: string;
+    maxTokens: number;
+    threshold: number;
+    currentTokens: number;
+    warningLevel: 'ok' | 'warning' | 'critical';
+    consecutiveFailures: number;
+    recentFileCount: number;
+    recentFiles: RecentFileSnapshot[];
+    lastArchivePath?: string;
+    lastCompact?: ContextCompactRecord;
+    compactHistory: ContextCompactRecord[];
+}
+export declare function getContextRuntimeStateKey(owner: ContextRuntimeOwner): string;
+export declare function getContextWarningLevel(currentTokens: number, threshold: number): ContextRuntimeState['warningLevel'];
+export declare function createInitialContextRuntimeState(owner: ContextRuntimeOwner, threshold: number, sessionId?: string, maxTokens?: number): ContextRuntimeState;
+export declare function updateContextRuntimeObservation(state: ContextRuntimeState, patch: Partial<Omit<ContextRuntimeState, 'owner' | 'sessionId' | 'compactHistory' | 'lastCompact'>>): ContextRuntimeState;
+export declare function recordContextCompaction(state: ContextRuntimeState, record: ContextCompactRecord): ContextRuntimeState;
+export declare function loadPersistedContextRuntimeState(db: {
+    getSessionState(sessionId: string, key: string): unknown | null;
+}, sessionId: string, owner: ContextRuntimeOwner): ContextRuntimeState | null;
+//# sourceMappingURL=ContextRuntimeState.d.ts.map

package/dist/core/ContextRuntimeState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContextRuntimeState.d.ts","sourceRoot":"","sources":["../../src/core/ContextRuntimeState.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAID,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,mBAAmB,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,IAAI,GAAG,SAAS,GAAG,UAAU,CAAC;IAC5C,mBAAmB,EAAE,MAAM,CAAC;IAC5B,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,kBAAkB,EAAE,CAAC;IAClC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,oBAAoB,CAAC;IACnC,cAAc,EAAE,oBAAoB,EAAE,CAAC;CACxC;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,mBAAmB,GAAG,MAAM,CAK5E;AAED,wBAAgB,sBAAsB,CACpC,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,MAAM,GAChB,mBAAmB,CAAC,cAAc,CAAC,CAYrC;AAED,wBAAgB,gCAAgC,CAC9C,KAAK,EAAE,mBAAmB,EAC1B,SAAS,EAAE,MAAM,EACjB,SAAS,CAAC,EAAE,MAAM,EAClB,SAAS,SAAY,GACpB,mBAAmB,CAarB;AAED,wBAAgB,+BAA+B,CAC7C,KAAK,EAAE,mBAAmB,EAC1B,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,mBAAmB,EAAE,OAAO,GAAG,WAAW,GAAG,gBAAgB,GAAG,aAAa,CAAC,CAAC,GAClG,mBAAmB,CAUrB;AAED,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,mBAAmB,EAC1B,MAAM,EAAE,oBAAoB,GAC3B,mBAAmB,CASrB;AAED,wBAAgB,gCAAgC,CAC9C,EAAE,EAAE;IAAE,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAAA;CAAE,EACvE,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,mBAAmB,GACzB,mBAAmB,GAAG,IAAI,CA2B5B"}

package/dist/core/ContextRuntimeState.js

@@ -0,0 +1,79 @@
+const MAX_COMPACT_HISTORY = 8;
+export function getContextRuntimeStateKey(owner) {
+    if (owner.kind === 'agent') {
+        return `context_runtime:agent:${owner.agentId || owner.agentName || 'unknown'}`;
+    }
+    return 'context_runtime:leader';
+}
+export function getContextWarningLevel(currentTokens, threshold) {
+    if (threshold <= 0) {
+        return 'ok';
+    }
+    const ratio = currentTokens / threshold;
+    if (ratio >= 1) {
+        return 'critical';
+    }
+    if (ratio >= 0.7) {
+        return 'warning';
+    }
+    return 'ok';
+}
+export function createInitialContextRuntimeState(owner, threshold, sessionId, maxTokens = threshold) {
+    return {
+        owner,
+        sessionId,
+        maxTokens,
+        threshold,
+        currentTokens: 0,
+        warningLevel: 'ok',
+        consecutiveFailures: 0,
+        recentFileCount: 0,
+        recentFiles: [],
+        compactHistory: [],
+    };
+}
+export function updateContextRuntimeObservation(state, patch) {
+    const currentTokens = patch.currentTokens ?? state.currentTokens;
+    const threshold = patch.threshold ?? state.threshold;
+    return {
+        ...state,
+        ...patch,
+        currentTokens,
+        threshold,
+        warningLevel: patch.warningLevel ?? getContextWarningLevel(currentTokens, threshold),
+    };
+}
+export function recordContextCompaction(state, record) {
+    return {
+        ...state,
+        currentTokens: record.newTokens,
+        warningLevel: getContextWarningLevel(record.newTokens, state.threshold),
+        lastArchivePath: record.archivePath,
+        lastCompact: record,
+        compactHistory: [...state.compactHistory, record].slice(-MAX_COMPACT_HISTORY),
+    };
+}
+export function loadPersistedContextRuntimeState(db, sessionId, owner) {
+    const raw = db.getSessionState(sessionId, getContextRuntimeStateKey(owner));
+    if (!raw || typeof raw !== 'object') {
+        return null;
+    }
+    const candidate = raw;
+    return {
+        owner,
+        sessionId,
+        maxTokens: typeof candidate.maxTokens === 'number' ? candidate.maxTokens : 0,
+        threshold: typeof candidate.threshold === 'number' ? candidate.threshold : 0,
+        currentTokens: typeof candidate.currentTokens === 'number' ? candidate.currentTokens : 0,
+        warningLevel: candidate.warningLevel === 'warning' || candidate.warningLevel === 'critical'
+            ? candidate.warningLevel
+            : getContextWarningLevel(typeof candidate.currentTokens === 'number' ? candidate.currentTokens : 0, typeof candidate.threshold === 'number' ? candidate.threshold : 0),
+        consecutiveFailures: typeof candidate.consecutiveFailures === 'number' ? candidate.consecutiveFailures : 0,
+        recentFileCount: typeof candidate.recentFileCount === 'number' ? candidate.recentFileCount : 0,
+        recentFiles: Array.isArray(candidate.recentFiles) ? candidate.recentFiles : [],
+        lastArchivePath: typeof candidate.lastArchivePath === 'string' ? candidate.lastArchivePath : undefined,
+        lastCompact: candidate.lastCompact,
+        compactHistory: Array.isArray(candidate.compactHistory) ? candidate.compactHistory : [],
+    };
+}
+//# sourceMappingURL=ContextRuntimeState.js.map

package/dist/core/ContextRuntimeState.js.map

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

package/dist/core/ContractAllowedScope.d.ts

@@ -0,0 +1,67 @@
+/**
+ * 契约结构化允许面(Contract Allowed Scope)
+ *
+ * 把契约从"渲染进 system prompt 的软约束"升级为"写工具执行前的硬校验"。
+ * 复用既有 `isPathInside`(utils.ts,带分隔符边界)做目录前缀判定,零新依赖。
+ *
+ * intersect 语义(只缩不放):写工具最终允许面 = taskWriteScope ∩ allow − forbid。
+ * 契约层永远不可能放行 allowedRoots 之外的路径。
+ *
+ * undefined vs { allow: [] } 的严格区分:
+ *  - undefined(契约未声明 allowedScope)= 维持现状,向后兼容,强制层不激活
+ *  - { allow: [] }            = 契约明确声明"本任务只读不改",写工具全拒
+ *
+ * 作为纯类型定义独立成文件,避免 types.ts ↔ ContractPack.ts 的循环依赖(两者都要引用)。
+ */
+export interface ContractAllowedScope {
+    /**
+     * 允许写入/创建的目录前缀(绝对路径,或相对 workspaceRoot)。
+     * 目标路径必须 isPathInside 某个前缀才放行。
+     * 空数组 = 收紧到 0(契约声明了允许面但什么都不许改)。
+     */
+    allow: string[];
+    /**
+     * 显式禁止的目录前缀(优先于 allow:路径命中 forbid 直接拒,即便也命中 allow)。
+     * 典型用途:保护架构核心目录(src/core/blackboard、StateSemantics 等)。
+     */
+    forbid?: string[];
+    /**
+     * 是否允许创建新文件(而非只改既有文件)。默认 false(收紧)。
+     */
+    allowCreate?: boolean;
+}
+/**
+ * 多契约 allowedScope 取交集,用于一个 task 匹配多个契约 surface 时合并约束。
+ *
+ * 语义(只缩不放):
+ *  - allow 取所有契约的交集(只允许所有契约都允许的路径)。
+ *  - forbid 取并集(任一契约禁止的路径都禁)。
+ *  - allowCreate 取最严(所有契约都允许才允许)。
+ *
+ * 边界:
+ *  - 无契约声明(或 allow 为空)→ 返回 undefined(维持现状,契约硬执行不激活)。
+ *  - 契约冲突(各契约 allow 交集为空)→ 返回 {allow:[]}(写入全锁)→ worker 改任何路径都被拒,
+ *    必须先升级契约消除冲突——这是正确行为,契约间矛盾就该显式暴露而非静默放过。
+ */
+export declare function intersectContractScopes(scopes: Array<ContractAllowedScope | undefined>): ContractAllowedScope | undefined;
+export interface ScopeOrthogonality {
+    /** 组内两两正交的 task id 分组(贪心分组,供并发视图提示"可同层并行")。 */
+    orthogonalGroups: string[][];
+    /** scope 两两重叠的 task id 对(供视图标注需串行/缩窄 scope 的冲突)。 */
+    overlaps: Array<[string, string]>;
+}
+/**
+ * 计算一组任务的 write_scope 正交性(确定性,非启发式)。
+ *
+ * 把"并行度 = scope 正交宽度"这个确定性关系投影给 Leader:
+ * 落在同一 orthogonalGroup 内的任务 write_scope 两两正交,可同层并行派发;
+ * 出现在 overlaps 中的对 write_scope 重叠,需用 blocked_by 串行或缩窄 scope。
+ *
+ * 用于 Leader 并发概览视图(LeaderContextBuilder),不做派发 gate——
+ * 是否串行化由 Leader 决策,这里只提供确定性信号。
+ */
+export declare function computeScopeOrthogonality(input: Array<{
+    id: string;
+    write_scope: string[];
+}>): ScopeOrthogonality;
+//# sourceMappingURL=ContractAllowedScope.d.ts.map