@xenosystem/agent-interface-host 0.1.3

package/dist/durableRuntimeEventStore.js

@@ -0,0 +1,364 @@
+import { createHash } from 'node:crypto';
+import { mkdir, open, readFile, truncate } from 'node:fs/promises';
+import { join } from 'node:path';
+import { AgentHostProtocolError, isAgentRuntimeEventEnvelope, } from '@xenosystem/agent-interface-contract';
+export class DurableRuntimeEventStoreCorruptionError extends Error {
+    streamPath;
+    line;
+    constructor(streamPath, line, message) {
+        super(message);
+        this.name = 'DurableRuntimeEventStoreCorruptionError';
+        this.streamPath = streamPath;
+        this.line = line;
+    }
+}
+const DEFAULT_MAX_EVENT_BYTES = 4 * 1024 * 1024;
+const DEFAULT_MAX_LIST_LIMIT = 5_000;
+/**
+ * Append-only runtime-event journal used by the single Agent host authority.
+ * Writes are serialized per conversation and fsynced by default. A partial
+ * final line is repaired on reopen; corruption before the tail fails closed.
+ */
+export class DurableRuntimeEventStore {
+    rootDirectory;
+    streamDirectory;
+    syncWrites;
+    maxEventBytes;
+    maxListLimit;
+    loaded = new Map();
+    queues = new Map();
+    constructor(options) {
+        if (!options.rootDirectory.trim())
+            throw new Error('Durable event-store rootDirectory is required.');
+        this.rootDirectory = options.rootDirectory;
+        this.streamDirectory = join(this.rootDirectory, 'runtime-events');
+        this.syncWrites = options.syncWrites !== false;
+        this.maxEventBytes = positiveInteger(options.maxEventBytes) || DEFAULT_MAX_EVENT_BYTES;
+        this.maxListLimit = positiveInteger(options.maxListLimit) || DEFAULT_MAX_LIST_LIMIT;
+    }
+    async initialize() {
+        await mkdir(this.streamDirectory, { recursive: true });
+    }
+    async append(event) {
+        assertSafeRuntimeEvent(event);
+        const serialized = stableSerialize(event);
+        return this.withConversationLock(event.conversationId, async () => {
+            const stream = await this.loadStream(event.conversationId);
+            return this.appendToLoadedStream(stream, event, serialized);
+        });
+    }
+    async appendGenerated(event) {
+        assertSafeRuntimeEventDraft(event);
+        return this.withConversationLock(event.conversationId, async () => {
+            const stream = await this.loadStream(event.conversationId);
+            const previous = stream.events[stream.events.length - 1];
+            const existing = stream.byId.get(event.event.id);
+            const envelope = {
+                id: event.event.id,
+                sequence: existing?.sequence || (previous?.sequence || 0) + 1,
+                timestamp: event.event.timestamp,
+                conversationId: event.conversationId,
+                requestId: event.requestId,
+                ...(event.workspaceId ? { workspaceId: event.workspaceId } : {}),
+                ...(event.teamId ? { teamId: event.teamId } : {}),
+                ...(event.agentId ? { agentId: event.agentId } : {}),
+                ...(event.parentRunId ? { parentRunId: event.parentRunId } : {}),
+                ...(event.subagentRunId ? { subagentRunId: event.subagentRunId } : {}),
+                ...(event.providerKind ? { providerKind: event.providerKind } : {}),
+                ...(event.providerId ? { providerId: event.providerId } : {}),
+                type: event.event.type,
+                source: event.source || 'host',
+                schemaVersion: event.schemaVersion || '1',
+                redactionState: event.redactionState || 'safe',
+                event: structuredClone(event.event),
+            };
+            assertSafeRuntimeEvent(envelope);
+            return this.appendToLoadedStream(stream, envelope, stableSerialize(envelope));
+        });
+    }
+    async appendGeneratedBatch(events) {
+        if (events.length === 0)
+            return [];
+        for (const event of events)
+            assertSafeRuntimeEventDraft(event);
+        const conversationId = events[0].conversationId;
+        if (events.some((event) => event.conversationId !== conversationId)) {
+            throw new AgentHostProtocolError('invalid_response', 'Generated runtime-event batches must use one conversation.');
+        }
+        return this.withConversationLock(conversationId, async () => {
+            const stream = await this.loadStream(conversationId);
+            const pending = [];
+            const results = [];
+            let nextSequence = (stream.events.at(-1)?.sequence || 0) + 1;
+            const pendingIds = new Set();
+            for (const event of events) {
+                if (pendingIds.has(event.event.id)) {
+                    throw new AgentHostProtocolError('invalid_response', `Generated runtime-event batch repeats id ${event.event.id}.`);
+                }
+                pendingIds.add(event.event.id);
+                const existing = stream.byId.get(event.event.id);
+                const envelope = generatedEnvelope(event, existing?.sequence || nextSequence);
+                const serialized = stableSerialize(envelope);
+                if (existing) {
+                    if (stableSerialize(existing) !== serialized) {
+                        throw new AgentHostProtocolError('invalid_response', `Runtime event id ${event.event.id} conflicts with durable history.`);
+                    }
+                    results.push({ inserted: false, event: structuredClone(existing) });
+                    continue;
+                }
+                const encoded = `${serialized}\n`;
+                if (Buffer.byteLength(encoded, 'utf8') > this.maxEventBytes) {
+                    throw new AgentHostProtocolError('invalid_response', 'Runtime event exceeds the durable event-size limit.');
+                }
+                pending.push({ envelope, serialized, encoded });
+                results.push({ inserted: true, event: structuredClone(envelope) });
+                nextSequence += 1;
+            }
+            if (pending.length > 0) {
+                const handle = await open(stream.path, 'a', 0o600);
+                try {
+                    await handle.writeFile(pending.map((entry) => entry.encoded).join(''), { encoding: 'utf8' });
+                    if (this.syncWrites)
+                        await handle.sync();
+                }
+                finally {
+                    await handle.close();
+                }
+                for (const { envelope } of pending) {
+                    const copy = structuredClone(envelope);
+                    stream.events.push(copy);
+                    stream.byId.set(copy.id, copy);
+                }
+            }
+            return results.map((result) => ({
+                inserted: result.inserted,
+                event: structuredClone(result.event),
+            }));
+        });
+    }
+    async list(input) {
+        if (!input.conversationId.trim()) {
+            throw new AgentHostProtocolError('invalid_response', 'conversationId is required to list runtime events.');
+        }
+        const stream = await this.withConversationLock(input.conversationId, () => this.loadStream(input.conversationId));
+        const limit = typeof input.limit === 'number' && Number.isFinite(input.limit)
+            ? Math.min(this.maxListLimit, Math.max(1, Math.floor(input.limit)))
+            : Math.min(500, this.maxListLimit);
+        const events = stream.events
+            .filter((event) => !input.requestId || event.requestId === input.requestId)
+            .filter((event) => !input.subagentRunId || event.subagentRunId === input.subagentRunId)
+            .filter((event) => !input.type || event.type === input.type)
+            .filter((event) => input.afterSequence === undefined || event.sequence > input.afterSequence)
+            .slice(0, limit)
+            .map((event) => structuredClone(event));
+        return {
+            events,
+            nextSequence: events.length > 0 ? events[events.length - 1].sequence : null,
+        };
+    }
+    async repairReport(conversationId) {
+        const stream = await this.withConversationLock(conversationId, () => this.loadStream(conversationId));
+        return { ...stream.repair };
+    }
+    streamPath(conversationId) {
+        if (!conversationId.trim())
+            throw new Error('conversationId is required.');
+        const digest = createHash('sha256').update(conversationId, 'utf8').digest('hex');
+        return join(this.streamDirectory, `${digest}.jsonl`);
+    }
+    async loadStream(conversationId) {
+        const cached = this.loaded.get(conversationId);
+        if (cached)
+            return cached;
+        await this.initialize();
+        const path = this.streamPath(conversationId);
+        let bytes;
+        try {
+            bytes = await readFile(path);
+        }
+        catch (error) {
+            if (isNodeError(error, 'ENOENT')) {
+                const empty = createLoadedStream(conversationId, path, [], false, 0);
+                this.loaded.set(conversationId, empty);
+                return empty;
+            }
+            throw error;
+        }
+        const text = bytes.toString('utf8');
+        const lines = text.split('\n');
+        const completeLineCount = text.endsWith('\n') ? lines.length - 1 : lines.length;
+        const events = [];
+        let validByteLength = 0;
+        let repaired = false;
+        for (let index = 0; index < completeLineCount; index += 1) {
+            const line = lines[index];
+            if (!line) {
+                validByteLength += 1;
+                continue;
+            }
+            let value;
+            try {
+                value = JSON.parse(line);
+            }
+            catch {
+                const isPartialTail = index === completeLineCount - 1 && !text.endsWith('\n');
+                if (!isPartialTail) {
+                    throw new DurableRuntimeEventStoreCorruptionError(path, index + 1, 'Runtime event journal contains invalid JSON before the tail.');
+                }
+                repaired = true;
+                break;
+            }
+            if (!isAgentRuntimeEventEnvelope(value) || value.conversationId !== conversationId) {
+                throw new DurableRuntimeEventStoreCorruptionError(path, index + 1, 'Runtime event journal contains an invalid or cross-conversation event.');
+            }
+            const previous = events[events.length - 1];
+            if (previous && value.sequence <= previous.sequence) {
+                throw new DurableRuntimeEventStoreCorruptionError(path, index + 1, 'Runtime event journal sequence is not strictly increasing.');
+            }
+            events.push(structuredClone(value));
+            validByteLength += Buffer.byteLength(`${line}\n`, 'utf8');
+        }
+        const truncatedBytes = repaired ? bytes.byteLength - validByteLength : 0;
+        if (repaired)
+            await truncate(path, validByteLength);
+        const loaded = createLoadedStream(conversationId, path, events, repaired, truncatedBytes);
+        this.loaded.set(conversationId, loaded);
+        return loaded;
+    }
+    async withConversationLock(conversationId, operation) {
+        const prior = this.queues.get(conversationId) || Promise.resolve();
+        let release;
+        const gate = new Promise((resolve) => { release = resolve; });
+        const tail = prior.then(() => gate);
+        this.queues.set(conversationId, tail);
+        await prior;
+        try {
+            return await operation();
+        }
+        finally {
+            release();
+            if (this.queues.get(conversationId) === tail)
+                this.queues.delete(conversationId);
+        }
+    }
+    async appendToLoadedStream(stream, event, serialized) {
+        const encoded = `${serialized}\n`;
+        if (Buffer.byteLength(encoded, 'utf8') > this.maxEventBytes) {
+            throw new AgentHostProtocolError('invalid_response', 'Runtime event exceeds the durable event-size limit.');
+        }
+        const existing = stream.byId.get(event.id);
+        if (existing) {
+            if (stableSerialize(existing) !== serialized) {
+                throw new AgentHostProtocolError('invalid_response', `Runtime event id ${event.id} conflicts with durable history.`);
+            }
+            return { inserted: false, event: structuredClone(existing) };
+        }
+        const previous = stream.events[stream.events.length - 1];
+        if (previous && event.sequence <= previous.sequence) {
+            throw new AgentHostProtocolError('invalid_response', `Runtime event sequence ${event.sequence} is not greater than durable sequence ${previous.sequence}.`);
+        }
+        const handle = await open(stream.path, 'a', 0o600);
+        try {
+            await handle.writeFile(encoded, { encoding: 'utf8' });
+            if (this.syncWrites)
+                await handle.sync();
+        }
+        finally {
+            await handle.close();
+        }
+        const copy = structuredClone(event);
+        stream.events.push(copy);
+        stream.byId.set(copy.id, copy);
+        return { inserted: true, event: structuredClone(copy) };
+    }
+}
+function createLoadedStream(conversationId, path, events, repaired, truncatedBytes) {
+    const byId = new Map();
+    for (const event of events) {
+        const prior = byId.get(event.id);
+        if (prior) {
+            throw new DurableRuntimeEventStoreCorruptionError(path, events.indexOf(event) + 1, `Duplicate runtime event id ${event.id}.`);
+        }
+        byId.set(event.id, event);
+    }
+    return {
+        path,
+        events,
+        byId,
+        repair: {
+            conversationId,
+            streamPath: path,
+            repaired,
+            truncatedBytes,
+            retainedEvents: events.length,
+        },
+    };
+}
+function assertSafeRuntimeEvent(value) {
+    if (!isAgentRuntimeEventEnvelope(value)) {
+        throw new AgentHostProtocolError('invalid_response', 'Runtime event does not satisfy the host contract.');
+    }
+    if (value.redactionState === 'unsafe') {
+        throw new AgentHostProtocolError('invalid_response', 'Unsafe runtime events cannot enter the durable journal.');
+    }
+}
+function assertSafeRuntimeEventDraft(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        throw new AgentHostProtocolError('invalid_response', 'Runtime event draft must be an object.');
+    }
+    const draft = value;
+    const event = draft.event;
+    if (!draft.conversationId?.trim()
+        || !draft.requestId?.trim()
+        || !event
+        || typeof event.id !== 'string'
+        || !event.id.trim()
+        || typeof event.type !== 'string'
+        || !event.type.trim()
+        || typeof event.timestamp !== 'string'
+        || !Number.isFinite(Date.parse(event.timestamp))) {
+        throw new AgentHostProtocolError('invalid_response', 'Runtime event draft is invalid.');
+    }
+    if (draft.redactionState === 'unsafe') {
+        throw new AgentHostProtocolError('invalid_response', 'Unsafe runtime events cannot enter the durable journal.');
+    }
+}
+function generatedEnvelope(event, sequence) {
+    const envelope = {
+        id: event.event.id,
+        sequence,
+        timestamp: event.event.timestamp,
+        conversationId: event.conversationId,
+        requestId: event.requestId,
+        ...(event.workspaceId ? { workspaceId: event.workspaceId } : {}),
+        ...(event.teamId ? { teamId: event.teamId } : {}),
+        ...(event.agentId ? { agentId: event.agentId } : {}),
+        ...(event.parentRunId ? { parentRunId: event.parentRunId } : {}),
+        ...(event.subagentRunId ? { subagentRunId: event.subagentRunId } : {}),
+        ...(event.providerKind ? { providerKind: event.providerKind } : {}),
+        ...(event.providerId ? { providerId: event.providerId } : {}),
+        type: event.event.type,
+        source: event.source || 'host',
+        schemaVersion: event.schemaVersion || '1',
+        redactionState: event.redactionState || 'safe',
+        event: structuredClone(event.event),
+    };
+    assertSafeRuntimeEvent(envelope);
+    return envelope;
+}
+function stableSerialize(value) {
+    if (Array.isArray(value))
+        return `[${value.map(stableSerialize).join(',')}]`;
+    if (value && typeof value === 'object') {
+        const record = value;
+        return `{${Object.keys(record).sort().map((key) => `${JSON.stringify(key)}:${stableSerialize(record[key])}`).join(',')}}`;
+    }
+    return JSON.stringify(value) ?? 'null';
+}
+function positiveInteger(value) {
+    return typeof value === 'number' && Number.isInteger(value) && value > 0 ? value : undefined;
+}
+function isNodeError(error, code) {
+    return error instanceof Error && 'code' in error && error.code === code;
+}
+//# sourceMappingURL=durableRuntimeEventStore.js.map

package/dist/durableRuntimeEventStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"durableRuntimeEventStore.js","sourceRoot":"","sources":["../src/durableRuntimeEventStore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACxC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAClE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EACL,sBAAsB,EACtB,2BAA2B,GAK5B,MAAM,sCAAsC,CAAA;AAsB7C,MAAM,OAAO,uCAAwC,SAAQ,KAAK;IACvD,UAAU,CAAQ;IAClB,IAAI,CAAQ;IAErB,YAAY,UAAkB,EAAE,IAAY,EAAE,OAAe;QAC3D,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,yCAAyC,CAAA;QACrD,IAAI,CAAC,UAAU,GAAG,UAAU,CAAA;QAC5B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;IAClB,CAAC;CACF;AASD,MAAM,uBAAuB,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAA;AAC/C,MAAM,sBAAsB,GAAG,KAAK,CAAA;AAEpC;;;;GAIG;AACH,MAAM,OAAO,wBAAwB;IAClB,aAAa,CAAQ;IACrB,eAAe,CAAQ;IACvB,UAAU,CAAS;IACnB,aAAa,CAAQ;IACrB,YAAY,CAAQ;IACpB,MAAM,GAAG,IAAI,GAAG,EAAwB,CAAA;IACxC,MAAM,GAAG,IAAI,GAAG,EAAyB,CAAA;IAE1D,YAAY,OAAwC;QAClD,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,IAAI,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAA;QACpG,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC,aAAa,CAAA;QAC1C,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,gBAAgB,CAAC,CAAA;QACjE,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,KAAK,KAAK,CAAA;QAC9C,IAAI,CAAC,aAAa,GAAG,eAAe,CAAC,OAAO,CAAC,aAAa,CAAC,IAAI,uBAAuB,CAAA;QACtF,IAAI,CAAC,YAAY,GAAG,eAAe,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,sBAAsB,CAAA;IACrF,CAAC;IAED,KAAK,CAAC,UAAU;QACd,MAAM,KAAK,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IACxD,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,KAAgC;QAC3C,sBAAsB,CAAC,KAAK,CAAC,CAAA;QAC7B,MAAM,UAAU,GAAG,eAAe,CAAC,KAAK,CAAC,CAAA;QACzC,OAAO,IAAI,CAAC,oBAAoB,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,IAAI,EAAE;YAChE,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,cAAc,CAAC,CAAA;YAC1D,OAAO,IAAI,CAAC,oBAAoB,CAAC,MAAM,EAAE,KAAK,EAAE,UAAU,CAAC,CAAA;QAC7D,CAAC,CAAC,CAAA;IACJ,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,KAA6B;QACjD,2BAA2B,CAAC,KAAK,CAAC,CAAA;QAClC,OAAO,IAAI,CAAC,oBAAoB,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,IAAI,EAAE;YAChE,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,cAAc,CAAC,CAAA;YAC1D,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;YACxD,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;YAChD,MAAM,QAAQ,GAA8B;gBAC1C,EAAE,EAAE,KAAK,CAAC,KAAK,CAAC,EAAE;gBAClB,QAAQ,EAAE,QAAQ,EAAE,QAAQ,IAAI,CAAC,QAAQ,EAAE,QAAQ,IAAI,CAAC,CAAC,GAAG,CAAC;gBAC7D,SAAS,EAAE,KAAK,CAAC,KAAK,CAAC,SAAS;gBAChC,cAAc,EAAE,KAAK,CAAC,cAAc;gBACpC,SAAS,EAAE,KAAK,CAAC,SAAS;gBAC1B,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAChE,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACjD,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACpD,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAChE,GAAG,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,KAAK,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACtE,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,KAAK,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACnE,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC7D,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,IAAI;gBACtB,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,MAAM;gBAC9B,aAAa,EAAE,KAAK,CAAC,aAAa,IAAI,GAAG;gBACzC,cAAc,EAAE,KAAK,CAAC,cAAc,IAAI,MAAM;gBAC9C,KAAK,EAAE,eAAe,CAAC,KAAK,CAAC,KAAK,CAAC;aACpC,CAAA;YACD,sBAAsB,CAAC,QAAQ,CAAC,CAAA;YAChC,OAAO,IAAI,CAAC,oBAAoB,CAAC,MAAM,EAAE,QAAQ,EAAE,eAAe,CAAC,QAAQ,CAAC,CAAC,CAAA;QAC/E,CAAC,CAAC,CAAA;IACJ,CAAC;IAED,KAAK,CAAC,oBAAoB,CAAC,MAAgC;QACzD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAA;QAClC,KAAK,MAAM,KAAK,IAAI,MAAM;YAAE,2BAA2B,CAAC,KAAK,CAAC,CAAA;QAC9D,MAAM,cAAc,GAAG,MAAM,CAAC,CAAC,CAAE,CAAC,cAAc,CAAA;QAChD,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,cAAc,KAAK,cAAc,CAAC,EAAE,CAAC;YACpE,MAAM,IAAI,sBAAsB,CAAC,kBAAkB,EAAE,4DAA4D,CAAC,CAAA;QACpH,CAAC;QACD,OAAO,IAAI,CAAC,oBAAoB,CAAC,cAAc,EAAE,KAAK,IAAI,EAAE;YAC1D,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,CAAA;YACpD,MAAM,OAAO,GAIR,EAAE,CAAA;YACP,MAAM,OAAO,GAAsC,EAAE,CAAA;YACrD,IAAI,YAAY,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,IAAI,CAAC,CAAC,GAAG,CAAC,CAAA;YAC5D,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,CAAA;YAEpC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;gBAC3B,IAAI,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;oBACnC,MAAM,IAAI,sBAAsB,CAAC,kBAAkB,EAAE,4CAA4C,KAAK,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAA;gBACrH,CAAC;gBACD,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;gBAC9B,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;gBAChD,MAAM,QAAQ,GAAG,iBAAiB,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,IAAI,YAAY,CAAC,CAAA;gBAC7E,MAAM,UAAU,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAA;gBAC5C,IAAI,QAAQ,EAAE,CAAC;oBACb,IAAI,eAAe,CAAC,QAAQ,CAAC,KAAK,UAAU,EAAE,CAAC;wBAC7C,MAAM,IAAI,sBAAsB,CAAC,kBAAkB,EAAE,oBAAoB,KAAK,CAAC,KAAK,CAAC,EAAE,kCAAkC,CAAC,CAAA;oBAC5H,CAAC;oBACD,OAAO,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,eAAe,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAA;oBACnE,SAAQ;gBACV,CAAC;gBACD,MAAM,OAAO,GAAG,GAAG,UAAU,IAAI,CAAA;gBACjC,IAAI,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;oBAC5D,MAAM,IAAI,sBAAsB,CAAC,kBAAkB,EAAE,qDAAqD,CAAC,CAAA;gBAC7G,CAAC;gBACD,OAAO,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,CAAA;gBAC/C,OAAO,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,eAAe,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAA;gBAClE,YAAY,IAAI,CAAC,CAAA;YACnB,CAAC;YAED,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACvB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAA;gBAClD,IAAI,CAAC;oBACH,MAAM,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAA;oBAC5F,IAAI,IAAI,CAAC,UAAU;wBAAE,MAAM,MAAM,CAAC,IAAI,EAAE,CAAA;gBAC1C,CAAC;wBAAS,CAAC;oBACT,MAAM,MAAM,CAAC,KAAK,EAAE,CAAA;gBACtB,CAAC;gBACD,KAAK,MAAM,EAAE,QAAQ,EAAE,IAAI,OAAO,EAAE,CAAC;oBACnC,MAAM,IAAI,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAA;oBACtC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;oBACxB,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAA;gBAChC,CAAC;YACH,CAAC;YACD,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;gBAC9B,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,KAAK,EAAE,eAAe,CAAC,MAAM,CAAC,KAAK,CAAC;aACrC,CAAC,CAAC,CAAA;QACL,CAAC,CAAC,CAAA;IACJ,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,KAAmC;QAC5C,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,IAAI,EAAE,EAAE,CAAC;YACjC,MAAM,IAAI,sBAAsB,CAAC,kBAAkB,EAAE,oDAAoD,CAAC,CAAA;QAC5G,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,oBAAoB,CAAC,KAAK,CAAC,cAAc,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,CAAA;QACjH,MAAM,KAAK,GAAG,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC;YAC3E,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;YACnE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,YAAY,CAAC,CAAA;QACpC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM;aACzB,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,SAAS,IAAI,KAAK,CAAC,SAAS,KAAK,KAAK,CAAC,SAAS,CAAC;aAC1E,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,aAAa,IAAI,KAAK,CAAC,aAAa,KAAK,KAAK,CAAC,aAAa,CAAC;aACtF,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI,CAAC;aAC3D,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,aAAa,KAAK,SAAS,IAAI,KAAK,CAAC,QAAQ,GAAG,KAAK,CAAC,aAAa,CAAC;aAC5F,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC;aACf,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAA;QACzC,OAAO;YACL,MAAM;YACN,YAAY,EAAE,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI;SAC7E,CAAA;IACH,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,cAAsB;QACvC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,oBAAoB,CAAC,cAAc,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC,CAAA;QACrG,OAAO,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,CAAA;IAC7B,CAAC;IAED,UAAU,CAAC,cAAsB;QAC/B,IAAI,CAAC,cAAc,CAAC,IAAI,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAA;QAC1E,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;QAChF,OAAO,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,GAAG,MAAM,QAAQ,CAAC,CAAA;IACtD,CAAC;IAEO,KAAK,CAAC,UAAU,CAAC,cAAsB;QAC7C,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC,CAAA;QAC9C,IAAI,MAAM;YAAE,OAAO,MAAM,CAAA;QACzB,MAAM,IAAI,CAAC,UAAU,EAAE,CAAA;QACvB,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,CAAA;QAC5C,IAAI,KAAa,CAAA;QACjB,IAAI,CAAC;YACH,KAAK,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAA;QAC9B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,WAAW,CAAC,KAAK,EAAE,QAAQ,CAAC,EAAE,CAAC;gBACjC,MAAM,KAAK,GAAG,kBAAkB,CAAC,cAAc,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,CAAA;gBACpE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,cAAc,EAAE,KAAK,CAAC,CAAA;gBACtC,OAAO,KAAK,CAAA;YACd,CAAC;YACD,MAAM,KAAK,CAAA;QACb,CAAC;QAED,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAA;QACnC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;QAC9B,MAAM,iBAAiB,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAA;QAC/E,MAAM,MAAM,GAAgC,EAAE,CAAA;QAC9C,IAAI,eAAe,GAAG,CAAC,CAAA;QACvB,IAAI,QAAQ,GAAG,KAAK,CAAA;QAEpB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,iBAAiB,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;YAC1D,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAE,CAAA;YAC1B,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,eAAe,IAAI,CAAC,CAAA;gBACpB,SAAQ;YACV,CAAC;YACD,IAAI,KAAc,CAAA;YAClB,IAAI,CAAC;gBACH,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;YAC1B,CAAC;YAAC,MAAM,CAAC;gBACP,MAAM,aAAa,GAAG,KAAK,KAAK,iBAAiB,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;gBAC7E,IAAI,CAAC,aAAa,EAAE,CAAC;oBACnB,MAAM,IAAI,uCAAuC,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC,EAAE,8DAA8D,CAAC,CAAA;gBACpI,CAAC;gBACD,QAAQ,GAAG,IAAI,CAAA;gBACf,MAAK;YACP,CAAC;YACD,IAAI,CAAC,2BAA2B,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,cAAc,KAAK,cAAc,EAAE,CAAC;gBACnF,MAAM,IAAI,uCAAuC,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC,EAAE,wEAAwE,CAAC,CAAA;YAC9I,CAAC;YACD,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;YAC1C,IAAI,QAAQ,IAAI,KAAK,CAAC,QAAQ,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;gBACpD,MAAM,IAAI,uCAAuC,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC,EAAE,4DAA4D,CAAC,CAAA;YAClI,CAAC;YACD,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAA;YACnC,eAAe,IAAI,MAAM,CAAC,UAAU,CAAC,GAAG,IAAI,IAAI,EAAE,MAAM,CAAC,CAAA;QAC3D,CAAC;QAED,MAAM,cAAc,GAAG,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC,CAAA;QACxE,IAAI,QAAQ;YAAE,MAAM,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC,CAAA;QACnD,MAAM,MAAM,GAAG,kBAAkB,CAAC,cAAc,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,CAAC,CAAA;QACzF,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,cAAc,EAAE,MAAM,CAAC,CAAA;QACvC,OAAO,MAAM,CAAA;IACf,CAAC;IAEO,KAAK,CAAC,oBAAoB,CAAI,cAAsB,EAAE,SAA2B;QACvF,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,OAAO,CAAC,OAAO,EAAE,CAAA;QAClE,IAAI,OAAoB,CAAA;QACxB,MAAM,IAAI,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,GAAG,OAAO,GAAG,OAAO,CAAA,CAAC,CAAC,CAAC,CAAA;QAClE,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAA;QACnC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,cAAc,EAAE,IAAI,CAAC,CAAA;QACrC,MAAM,KAAK,CAAA;QACX,IAAI,CAAC;YACH,OAAO,MAAM,SAAS,EAAE,CAAA;QAC1B,CAAC;gBAAS,CAAC;YACT,OAAO,EAAE,CAAA;YACT,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC,KAAK,IAAI;gBAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,CAAA;QAClF,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,oBAAoB,CAChC,MAAoB,EACpB,KAAgC,EAChC,UAAkB;QAElB,MAAM,OAAO,GAAG,GAAG,UAAU,IAAI,CAAA;QACjC,IAAI,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;YAC5D,MAAM,IAAI,sBAAsB,CAAC,kBAAkB,EAAE,qDAAqD,CAAC,CAAA;QAC7G,CAAC;QACD,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;QAC1C,IAAI,QAAQ,EAAE,CAAC;YACb,IAAI,eAAe,CAAC,QAAQ,CAAC,KAAK,UAAU,EAAE,CAAC;gBAC7C,MAAM,IAAI,sBAAsB,CAAC,kBAAkB,EAAE,oBAAoB,KAAK,CAAC,EAAE,kCAAkC,CAAC,CAAA;YACtH,CAAC;YACD,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,eAAe,CAAC,QAAQ,CAAC,EAAE,CAAA;QAC9D,CAAC;QACD,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;QACxD,IAAI,QAAQ,IAAI,KAAK,CAAC,QAAQ,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;YACpD,MAAM,IAAI,sBAAsB,CAC9B,kBAAkB,EAClB,0BAA0B,KAAK,CAAC,QAAQ,yCAAyC,QAAQ,CAAC,QAAQ,GAAG,CACtG,CAAA;QACH,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAA;QAClD,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAA;YACrD,IAAI,IAAI,CAAC,UAAU;gBAAE,MAAM,MAAM,CAAC,IAAI,EAAE,CAAA;QAC1C,CAAC;gBAAS,CAAC;YACT,MAAM,MAAM,CAAC,KAAK,EAAE,CAAA;QACtB,CAAC;QACD,MAAM,IAAI,GAAG,eAAe,CAAC,KAAK,CAAC,CAAA;QACnC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACxB,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAA;QAC9B,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,eAAe,CAAC,IAAI,CAAC,EAAE,CAAA;IACzD,CAAC;CACF;AAED,SAAS,kBAAkB,CACzB,cAAsB,EACtB,IAAY,EACZ,MAAmC,EACnC,QAAiB,EACjB,cAAsB;IAEtB,MAAM,IAAI,GAAG,IAAI,GAAG,EAAqC,CAAA;IACzD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;QAChC,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,IAAI,uCAAuC,CAAC,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,8BAA8B,KAAK,CAAC,EAAE,GAAG,CAAC,CAAA;QAC/H,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,CAAA;IAC3B,CAAC;IACD,OAAO;QACL,IAAI;QACJ,MAAM;QACN,IAAI;QACJ,MAAM,EAAE;YACN,cAAc;YACd,UAAU,EAAE,IAAI;YAChB,QAAQ;YACR,cAAc;YACd,cAAc,EAAE,MAAM,CAAC,MAAM;SAC9B;KACF,CAAA;AACH,CAAC;AAED,SAAS,sBAAsB,CAAC,KAAc;IAC5C,IAAI,CAAC,2BAA2B,CAAC,KAAK,CAAC,EAAE,CAAC;QACxC,MAAM,IAAI,sBAAsB,CAAC,kBAAkB,EAAE,mDAAmD,CAAC,CAAA;IAC3G,CAAC;IACD,IAAI,KAAK,CAAC,cAAc,KAAK,QAAQ,EAAE,CAAC;QACtC,MAAM,IAAI,sBAAsB,CAAC,kBAAkB,EAAE,yDAAyD,CAAC,CAAA;IACjH,CAAC;AACH,CAAC;AAED,SAAS,2BAA2B,CAAC,KAAc;IACjD,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAChE,MAAM,IAAI,sBAAsB,CAAC,kBAAkB,EAAE,wCAAwC,CAAC,CAAA;IAChG,CAAC;IACD,MAAM,KAAK,GAAG,KAAwC,CAAA;IACtD,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAA;IACzB,IAAI,CAAC,KAAK,CAAC,cAAc,EAAE,IAAI,EAAE;WAC5B,CAAC,KAAK,CAAC,SAAS,EAAE,IAAI,EAAE;WACxB,CAAC,KAAK;WACN,OAAO,KAAK,CAAC,EAAE,KAAK,QAAQ;WAC5B,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE;WAChB,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ;WAC9B,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE;WAClB,OAAO,KAAK,CAAC,SAAS,KAAK,QAAQ;WACnC,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC;QACnD,MAAM,IAAI,sBAAsB,CAAC,kBAAkB,EAAE,iCAAiC,CAAC,CAAA;IACzF,CAAC;IACD,IAAI,KAAK,CAAC,cAAc,KAAK,QAAQ,EAAE,CAAC;QACtC,MAAM,IAAI,sBAAsB,CAAC,kBAAkB,EAAE,yDAAyD,CAAC,CAAA;IACjH,CAAC;AACH,CAAC;AAED,SAAS,iBAAiB,CACxB,KAA6B,EAC7B,QAAgB;IAEhB,MAAM,QAAQ,GAA8B;QAC1C,EAAE,EAAE,KAAK,CAAC,KAAK,CAAC,EAAE;QAClB,QAAQ;QACR,SAAS,EAAE,KAAK,CAAC,KAAK,CAAC,SAAS;QAChC,cAAc,EAAE,KAAK,CAAC,cAAc;QACpC,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAChE,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjD,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACpD,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAChE,GAAG,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,KAAK,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACtE,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,KAAK,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACnE,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7D,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,IAAI;QACtB,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,MAAM;QAC9B,aAAa,EAAE,KAAK,CAAC,aAAa,IAAI,GAAG;QACzC,cAAc,EAAE,KAAK,CAAC,cAAc,IAAI,MAAM;QAC9C,KAAK,EAAE,eAAe,CAAC,KAAK,CAAC,KAAK,CAAC;KACpC,CAAA;IACD,sBAAsB,CAAC,QAAQ,CAAC,CAAA;IAChC,OAAO,QAAQ,CAAA;AACjB,CAAC;AAED,SAAS,eAAe,CAAC,KAAc;IACrC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,KAAK,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAA;IAC5E,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvC,MAAM,MAAM,GAAG,KAAgC,CAAA;QAC/C,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,eAAe,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAA;IAC3H,CAAC;IACD,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,MAAM,CAAA;AACxC,CAAC;AAED,SAAS,eAAe,CAAC,KAAyB;IAChD,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAA;AAC9F,CAAC;AAED,SAAS,WAAW,CAAC,KAAc,EAAE,IAAY;IAC/C,OAAO,KAAK,YAAY,KAAK,IAAI,MAAM,IAAI,KAAK,IAAK,KAA+B,CAAC,IAAI,KAAK,IAAI,CAAA;AACpG,CAAC"}

package/dist/engineering/EngineeringWorkbenchService.d.ts

@@ -0,0 +1,142 @@
+import type { AgentEngineeringHostMethod, AgentHostInput, AgentHostOutput, EngineeringBackgroundRunListResponse, EngineeringBackgroundRunLookupRequest, EngineeringBackgroundRunRequest, EngineeringBackgroundRunResponse, EngineeringCheckpointCompareRequest, EngineeringCheckpointCompareResponse, EngineeringCheckpointListResponse, EngineeringCheckpointRestoreRequest, EngineeringCheckpointRestoreResponse, EngineeringCheckDiscoveryResponse, EngineeringDiagnosticsResponse, EngineeringRequestBase, EngineeringRunListResponse, EngineeringRunRequest, EngineeringRunResponse, EngineeringRuntimeTimelineRequest, EngineeringRuntimeTimelineResponse, EngineeringSessionListResponse, GitCommitRequest, GitDiffRequest, GitDiffResponse, GitStageRequest, GitStatusResponse, GitBranchRequest, GitPushRequest, GitPushResponse, GitPullRequestCreateRequest, GitPullRequestCreateResponse, LandingEnqueueRequest, LandingLandRequest, LandingLandResponse, LandingQueueResponse, LandingRemoveRequest, LandingVerifyRequest, LandingVerifyResponse, PatchReviewListResponse, PatchReviewMutationResponse, PatchReviewSelectionRequest, PatchReviewSelectionResponse, PatchReviewUpdateRequest, PatchReviewUpsertRequest } from './engineeringTypes.js';
+import { type RuntimeEventStore } from '../runtime/RuntimeEventStore.js';
+export declare class EngineeringWorkbenchService {
+    private activeBackgroundRuns;
+    private runtimeEventStore;
+    /**
+     * The landing queue, when the composition mounted one.
+     *
+     * Optional in the same way the host's observation service is: landing consults
+     * observed diffs and verification results, and a host with neither has nothing
+     * to gate with. Answering `unavailable` is honest; answering "landed" after
+     * consulting nothing is the merge-debt failure with extra steps.
+     */
+    private landingService;
+    constructor(options?: {
+        runtimeEventStore?: Pick<RuntimeEventStore, 'append' | 'project'>;
+        landingService?: LandingServicePort;
+    });
+    /** Mounted after construction when the composition builds the queue later. */
+    configureLandingService(landingService: LandingServicePort): void;
+    configureRuntimeEventStore(runtimeEventStore: Pick<RuntimeEventStore, 'append' | 'project'>): void;
+    close(): void;
+    request<M extends AgentEngineeringHostMethod>(method: M, input: AgentHostInput<M>): Promise<AgentHostOutput<M>>;
+    gitStatus(request: EngineeringRequestBase): Promise<GitStatusResponse>;
+    gitDiff(request: GitDiffRequest): Promise<GitDiffResponse>;
+    gitStage(request: GitStageRequest): Promise<GitStatusResponse>;
+    gitUnstage(request: GitStageRequest): Promise<GitStatusResponse>;
+    /**
+     * Create or switch to a branch.
+     *
+     * Local and reversible, so unlike push and PR creation it needs no
+     * confirmation. The NAME is validated rather than trusted: it reaches a
+     * command line, and git itself accepts things a caller rarely means —
+     * a leading dash reads as a flag.
+     */
+    gitBranch(request: GitBranchRequest): Promise<GitStatusResponse>;
+    /**
+     * Push a branch to a remote.
+     *
+     * 🔴 The first verb here whose effect leaves the machine, and the first that
+     * refuses without `confirmed`. The host cannot otherwise distinguish an agent
+     * deciding to publish from a human asking it to, and those are different acts
+     * with different consequences — a push is visible to other people and, unlike
+     * every other verb on this surface, cannot be undone locally.
+     *
+     * There is no `--force`, by construction rather than by policy: it destroys
+     * history others may already hold, every XENO repo rule forbids it, and a
+     * command that cannot express it cannot be talked into it.
+     */
+    gitPush(request: GitPushRequest): Promise<GitPushResponse>;
+    /**
+     * Open a pull request, through the `gh` CLI.
+     *
+     * `gh` rather than a GitHub API client on purpose: it already holds the
+     * operator's credential, so this adds no token storage, no scope decisions and
+     * no second place a credential can leak. The cost is a dependency on `gh`
+     * being installed, which is reported plainly when it is not — a missing tool
+     * is a legible failure, while a stored token is a permanent liability.
+     *
+     * Outward-facing, so confirmed like a push. `draft` defaults to TRUE: opening
+     * a review request notifies people, and an action taken on someone's behalf
+     * should default to the quieter form.
+     */
+    gitCreatePullRequest(request: GitPullRequestCreateRequest): Promise<GitPullRequestCreateResponse>;
+    /**
+     * Routes a landing call, or says plainly that landing is not mounted.
+     *
+     * 🔴 An unmounted queue reports `success: false` with a reason, never an empty
+     * queue. An empty queue reads as "nothing is waiting", which is a fact about
+     * the world; "no queue exists here" is a fact about this installation. A
+     * caller that cannot tell them apart will wait for a landing that can never
+     * be attempted.
+     */
+    private landing;
+    /**
+     * The merge behind a landing — deliberately NOT a host method.
+     *
+     * There is no `engineering.git.merge` in the contract: a free-standing merge
+     * verb would sit beside the gate rather than behind it, and a gate that can be
+     * walked around is documentation. This is reachable only from
+     * `engineering.landing.land`, which runs it after the queue admitted the run.
+     *
+     * `--no-ff` on purpose. A landing is a decision, and a decision should appear
+     * in the history as one revertable commit rather than dissolving into trunk.
+     */
+    gitMergeForLanding(request: EngineeringRequestBase & {
+        branch: string;
+    }): Promise<{
+        merged: boolean;
+        error?: string;
+    }>;
+    /** A failed git response that still reports where it was looking. */
+    private gitFailure;
+    gitCommit(request: GitCommitRequest): Promise<GitStatusResponse>;
+    discoverChecks(request: EngineeringRequestBase): EngineeringCheckDiscoveryResponse;
+    runCheck(request: EngineeringRunRequest): Promise<EngineeringRunResponse>;
+    listRuns(request: EngineeringRequestBase): EngineeringRunListResponse;
+    startBackgroundCheck(request: EngineeringBackgroundRunRequest): EngineeringBackgroundRunResponse;
+    listBackgroundRuns(request: EngineeringRequestBase): EngineeringBackgroundRunListResponse;
+    readBackgroundRunOutput(request: EngineeringBackgroundRunLookupRequest): EngineeringBackgroundRunResponse;
+    stopBackgroundRun(request: EngineeringBackgroundRunLookupRequest): EngineeringBackgroundRunResponse;
+    diagnostics(request: EngineeringRequestBase): Promise<EngineeringDiagnosticsResponse>;
+    listPatchReviews(request: EngineeringRequestBase): PatchReviewListResponse;
+    enqueuePatchReview(request: PatchReviewUpsertRequest): PatchReviewMutationResponse;
+    updatePatchReview(request: PatchReviewUpdateRequest): PatchReviewMutationResponse;
+    reviewPatchSelection(request: PatchReviewSelectionRequest): PatchReviewSelectionResponse;
+    listCheckpoints(request: EngineeringRequestBase): EngineeringCheckpointListResponse;
+    compareCheckpoints(request: EngineeringCheckpointCompareRequest): EngineeringCheckpointCompareResponse;
+    restoreCheckpoint(request: EngineeringCheckpointRestoreRequest): EngineeringCheckpointRestoreResponse;
+    listSessions(request: EngineeringRequestBase): EngineeringSessionListResponse;
+    runtimeTimeline(request: EngineeringRuntimeTimelineRequest): EngineeringRuntimeTimelineResponse;
+    private resolveRoot;
+    private buildCheckpointSummaries;
+    private buildEngineeringSessions;
+    private isGitRepo;
+    private validateRelativePaths;
+    private runGitMutation;
+    private appendRun;
+    private readRunStore;
+    private runStorePath;
+    private readBackgroundRunStore;
+    private writeBackgroundRun;
+    private backgroundRunStorePath;
+    private readPatchReviewStore;
+    private writePatchReviewStore;
+    private patchReviewStorePath;
+}
+export declare function getEngineeringWorkbenchService(): EngineeringWorkbenchService;
+/**
+ * What this service needs of a landing queue — declared here rather than
+ * imported from `LandingService`, so the workbench does not depend on the
+ * implementation it dispatches to. `LandingService` lives in the node entry and
+ * runs git; this file must stay usable without it.
+ */
+export interface LandingServicePort {
+    enqueue(request: LandingEnqueueRequest): LandingQueueResponse;
+    remove(request: LandingRemoveRequest): LandingQueueResponse;
+    status(request: EngineeringRequestBase): LandingQueueResponse;
+    land(request: LandingLandRequest): Promise<LandingLandResponse>;
+    verify(request: LandingVerifyRequest): Promise<LandingVerifyResponse>;
+}
+//# sourceMappingURL=EngineeringWorkbenchService.d.ts.map

package/dist/engineering/EngineeringWorkbenchService.d.ts.map

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