@gencode/agents 0.0.3 → 0.0.5

package/dist/runner/announce-loop.d.ts

@@ -0,0 +1,41 @@
+import type { Agent } from "@mariozechner/pi-agent-core";
+import type { AgentRunParams, AssistantEntry, ToolResultEntry } from "../types.js";
+import type { PluginHookRegistry } from "../plugins/hooks.js";
+import type { SubagentRegistry } from "../subagent/registry.js";
+import { RunEventDispatcher } from "./event-dispatcher.js";
+import { SkillUsageTracker } from "./skill-usage.js";
+/**
+ * Feeds completed subagent results back into the parent agent until no more
+ * announcements are pending or the safety cap is reached. This keeps the
+ * multi-agent follow-up protocol out of the main runner loop.
+ */
+export declare function runAnnounceLoop(params: {
+    agent: Agent;
+    registry: SubagentRegistry;
+    sessionId: string;
+    resolvedModelId: string;
+    eventDispatcher: RunEventDispatcher;
+    skillUsageTracker: SkillUsageTracker;
+    hookRegistry: PluginHookRegistry;
+    hookContext: {
+        sessionId?: string;
+        workspaceDir?: string;
+        channel?: AgentRunParams["channel"];
+    };
+    abortSignal?: AbortSignal;
+    appendEntry: (entry: AssistantEntry | ToolResultEntry | {
+        role: "assistant";
+        content: string;
+        timestamp: string;
+    } | {
+        role: "user";
+        content: string;
+        timestamp: string;
+    }) => Promise<void>;
+}): Promise<{
+    text: string;
+    inputTokens: number;
+    outputTokens: number;
+    error?: string;
+}>;
+//# sourceMappingURL=announce-loop.d.ts.map

package/dist/runner/announce-loop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"announce-loop.d.ts","sourceRoot":"","sources":["../../src/runner/announce-loop.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAC;AAEzD,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAGhE,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAKrD;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,MAAM,EAAE;IAC5C,KAAK,EAAE,KAAK,CAAC;IACb,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,kBAAkB,CAAC;IACpC,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,YAAY,EAAE,kBAAkB,CAAC;IACjC,WAAW,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,cAAc,CAAC,SAAS,CAAC,CAAA;KAAE,CAAC;IAChG,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,WAAW,EAAE,CACX,KAAK,EACD,cAAc,GACd,eAAe,GACf;QAAE,IAAI,EAAE,WAAW,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,GACzD;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,KACrD,OAAO,CAAC,IAAI,CAAC,CAAC;CACpB,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAkFvF"}

package/dist/runner/announce-loop.js

@@ -0,0 +1,94 @@
+import { buildSubagentAnnounceMessage } from "../tools/subagent-spawn.js";
+import { RunEventDispatcher } from "./event-dispatcher.js";
+import { SkillUsageTracker } from "./skill-usage.js";
+import { executeAgentTurn, persistTurnEntriesWithWriter } from "./turn-executor.js";
+const MAX_ANNOUNCE_ROUNDS = 10;
+/**
+ * Feeds completed subagent results back into the parent agent until no more
+ * announcements are pending or the safety cap is reached. This keeps the
+ * multi-agent follow-up protocol out of the main runner loop.
+ */
+export async function runAnnounceLoop(params) {
+    const { agent, registry, sessionId, resolvedModelId, eventDispatcher, skillUsageTracker, hookRegistry, hookContext, abortSignal, appendEntry, } = params;
+    let announceRound = 0;
+    let lastResponseText = "";
+    let totalInputTokens = 0;
+    let totalOutputTokens = 0;
+    let runError;
+    // Multiple child runs may complete between turns, so announce them in
+    // batches to minimize extra parent turns.
+    while (!abortSignal?.aborted &&
+        registry.needsAnnounce(sessionId) &&
+        announceRound < MAX_ANNOUNCE_ROUNDS) {
+        announceRound++;
+        await registry.waitForAll(sessionId);
+        const completed = registry.consumeCompleted(sessionId);
+        if (completed.length === 0) {
+            break;
+        }
+        for (const record of completed) {
+            await eventDispatcher.dispatchProgress(sessionId, {
+                type: "subagent_complete",
+                childSessionId: record.childSessionId,
+                task: record.task,
+                status: record.status,
+            });
+        }
+        const announceMsg = buildBatchAnnounceMessage(completed);
+        await appendEntry({
+            role: "user",
+            content: announceMsg,
+            timestamp: new Date().toISOString(),
+        });
+        const announceTurn = await executeAgentTurn({
+            agent,
+            message: announceMsg,
+            sessionId,
+            modelId: resolvedModelId,
+            historyMessages: [],
+            eventDispatcher,
+            skillUsageTracker,
+            hooks: hookRegistry,
+            hookCtx: hookContext,
+            abortSignal,
+        });
+        lastResponseText = announceTurn.text;
+        totalInputTokens += announceTurn.inputTokens;
+        totalOutputTokens += announceTurn.outputTokens;
+        if (announceTurn.error && !runError) {
+            runError = announceTurn.error;
+        }
+        await persistTurnEntriesWithWriter(appendEntry, announceTurn);
+    }
+    return {
+        text: lastResponseText,
+        inputTokens: totalInputTokens,
+        outputTokens: totalOutputTokens,
+        error: runError,
+    };
+}
+/**
+ * Preserves the single-subagent announce format while still supporting a
+ * batched representation when several children finish together.
+ */
+function buildBatchAnnounceMessage(completed) {
+    if (completed.length === 1) {
+        const r = completed[0];
+        return buildSubagentAnnounceMessage({
+            task: r.task,
+            label: r.label,
+            status: r.status,
+            result: r.result,
+            error: r.error,
+        });
+    }
+    const parts = completed.map((r) => buildSubagentAnnounceMessage({
+        task: r.task,
+        label: r.label,
+        status: r.status,
+        result: r.result,
+        error: r.error,
+    }));
+    return `[${completed.length} subagents completed]\n\n${parts.join("\n\n---\n\n")}`;
+}
+//# sourceMappingURL=announce-loop.js.map

package/dist/runner/announce-loop.js.map

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

package/dist/runner/event-dispatcher.d.ts

@@ -0,0 +1,31 @@
+import type { AgentRunParams, AgentProgressEvent, CallbackPayload } from "../types.js";
+type EventDispatchParams = Pick<AgentRunParams, "onProgress" | "callbackUrl" | "messageId" | "channel">;
+type RunDoneResult = {
+    text: string;
+    usage: {
+        input: number;
+        output: number;
+        total: number;
+    };
+    durationMs: number;
+};
+/**
+ * Emits runner events to in-process listeners and optional HTTP callbacks.
+ * Callback failures are intentionally ignored so they do not interrupt the run.
+ */
+export declare class RunEventDispatcher {
+    private readonly params;
+    constructor(params: EventDispatchParams);
+    sendCallback(url: string, payload: CallbackPayload): Promise<void>;
+    dispatchProgress(sessionId: string, event: AgentProgressEvent): Promise<void>;
+    dispatchStart(sessionId: string, message: string): Promise<void>;
+    dispatchDone(sessionId: string, result: RunDoneResult): Promise<void>;
+    dispatchError(sessionId: string, message: string): Promise<void>;
+    dispatchSessionReset(sessionId: string, payload: {
+        action: "new" | "reset";
+        previousSessionId?: string;
+        message: string;
+    }): Promise<void>;
+}
+export {};
+//# sourceMappingURL=event-dispatcher.d.ts.map

package/dist/runner/event-dispatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-dispatcher.d.ts","sourceRoot":"","sources":["../../src/runner/event-dispatcher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEvF,KAAK,mBAAmB,GAAG,IAAI,CAAC,cAAc,EAAE,YAAY,GAAG,aAAa,GAAG,WAAW,GAAG,SAAS,CAAC,CAAC;AACxG,KAAK,aAAa,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnH;;;GAGG;AACH,qBAAa,kBAAkB;IACjB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,mBAAmB;IAElD,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAYlE,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAiB7E,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAchE,YAAY,CAChB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,aAAa,GACpB,OAAO,CAAC,IAAI,CAAC;IAcV,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAchE,oBAAoB,CACxB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE;QAAE,MAAM,EAAE,KAAK,GAAG,OAAO,CAAC;QAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAChF,OAAO,CAAC,IAAI,CAAC;CAejB"}

package/dist/runner/event-dispatcher.js

@@ -0,0 +1,87 @@
+/**
+ * Emits runner events to in-process listeners and optional HTTP callbacks.
+ * Callback failures are intentionally ignored so they do not interrupt the run.
+ */
+export class RunEventDispatcher {
+    params;
+    constructor(params) {
+        this.params = params;
+    }
+    async sendCallback(url, payload) {
+        try {
+            await fetch(url, {
+                method: "POST",
+                headers: { "content-type": "application/json" },
+                body: JSON.stringify(payload),
+            });
+        }
+        catch {
+            // Callback failures are non-fatal
+        }
+    }
+    async dispatchProgress(sessionId, event) {
+        const eventWithMessageId = this.params.messageId ? { ...event, messageId: this.params.messageId } : event;
+        await this.params.onProgress?.(eventWithMessageId);
+        if (!this.params.callbackUrl) {
+            return;
+        }
+        await this.sendCallback(this.params.callbackUrl, {
+            sessionId,
+            channel: this.params.channel,
+            messageId: this.params.messageId,
+            type: "progress",
+            event: eventWithMessageId,
+        });
+    }
+    async dispatchStart(sessionId, message) {
+        if (!this.params.callbackUrl) {
+            return;
+        }
+        await this.sendCallback(this.params.callbackUrl, {
+            sessionId,
+            channel: this.params.channel,
+            messageId: this.params.messageId,
+            type: "start",
+            message,
+        });
+    }
+    async dispatchDone(sessionId, result) {
+        if (!this.params.callbackUrl) {
+            return;
+        }
+        await this.sendCallback(this.params.callbackUrl, {
+            sessionId,
+            channel: this.params.channel,
+            messageId: this.params.messageId,
+            type: "done",
+            result,
+        });
+    }
+    async dispatchError(sessionId, message) {
+        if (!this.params.callbackUrl) {
+            return;
+        }
+        await this.sendCallback(this.params.callbackUrl, {
+            sessionId,
+            channel: this.params.channel,
+            messageId: this.params.messageId,
+            type: "error",
+            message,
+        });
+    }
+    async dispatchSessionReset(sessionId, payload) {
+        if (!this.params.callbackUrl) {
+            return;
+        }
+        await this.sendCallback(this.params.callbackUrl, {
+            sessionId,
+            channel: this.params.channel,
+            messageId: this.params.messageId,
+            type: "session_reset",
+            action: payload.action,
+            previousSessionId: payload.previousSessionId,
+            message: payload.message,
+        });
+    }
+}
+//# sourceMappingURL=event-dispatcher.js.map

package/dist/runner/event-dispatcher.js.map

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

package/dist/runner/finalizer.d.ts

@@ -0,0 +1,30 @@
+import type { PluginHookAgentContext, PluginHookRegistry } from "../plugins/hooks.js";
+import type { AgentRunParams, AgentRunResult, CompactionEntry } from "../types.js";
+import { RunEventDispatcher } from "./event-dispatcher.js";
+type Usage = {
+    input: number;
+    output: number;
+    total: number;
+};
+type FinalizeSharedParams = {
+    sessionId: string;
+    isNewSession: boolean;
+    transcriptMessage: string;
+    runParams: AgentRunParams;
+    hookRegistry: PluginHookRegistry;
+    hookContext: PluginHookAgentContext;
+    startTime: number;
+    eventDispatcher: RunEventDispatcher;
+};
+export declare function finalizeShortCircuitRun(params: FinalizeSharedParams & {
+    replyText: string;
+    initialUserEntryPersisted?: boolean;
+    compactionEntry?: CompactionEntry;
+}): Promise<AgentRunResult>;
+export declare function finalizeCompletedRun(params: FinalizeSharedParams & {
+    text: string;
+    usage: Usage;
+    error?: string;
+}): Promise<AgentRunResult>;
+export {};
+//# sourceMappingURL=finalizer.d.ts.map

package/dist/runner/finalizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"finalizer.d.ts","sourceRoot":"","sources":["../../src/runner/finalizer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACtF,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnF,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAI3D,KAAK,KAAK,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAE9D,KAAK,oBAAoB,GAAG;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,OAAO,CAAC;IACtB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,SAAS,EAAE,cAAc,CAAC;IAC1B,YAAY,EAAE,kBAAkB,CAAC;IACjC,WAAW,EAAE,sBAAsB,CAAC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,kBAAkB,CAAC;CACrC,CAAC;AAEF,wBAAsB,uBAAuB,CAAC,MAAM,EAAE,oBAAoB,GAAG;IAC3E,SAAS,EAAE,MAAM,CAAC;IAClB,yBAAyB,CAAC,EAAE,OAAO,CAAC;IACpC,eAAe,CAAC,EAAE,eAAe,CAAC;CACnC,GAAG,OAAO,CAAC,cAAc,CAAC,CA2D1B;AAED,wBAAsB,oBAAoB,CAAC,MAAM,EAAE,oBAAoB,GAAG;IACxE,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,KAAK,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,cAAc,CAAC,CAyC1B"}

package/dist/runner/finalizer.js

@@ -0,0 +1,75 @@
+import { appendTranscriptEntry, saveSessionMetadata } from "../session/session.js";
+import { generateSessionTitle } from "./title.js";
+import { RunEventDispatcher } from "./event-dispatcher.js";
+import { buildNewSessionMetadata } from "./run-context.js";
+import { finishSessionLifecycle } from "./session-lifecycle.js";
+export async function finalizeShortCircuitRun(params) {
+    const { replyText, sessionId, isNewSession, transcriptMessage, initialUserEntryPersisted = false, runParams, hookRegistry, hookContext, startTime, compactionEntry, eventDispatcher, } = params;
+    if (!initialUserEntryPersisted) {
+        await appendTranscriptEntry(runParams.dataDir, sessionId, {
+            role: "user",
+            content: transcriptMessage,
+            timestamp: new Date().toISOString(),
+        });
+    }
+    if (compactionEntry) {
+        await appendTranscriptEntry(runParams.dataDir, sessionId, compactionEntry);
+    }
+    await appendTranscriptEntry(runParams.dataDir, sessionId, {
+        role: "assistant",
+        content: replyText,
+        timestamp: new Date().toISOString(),
+    });
+    if (isNewSession) {
+        const titleSource = transcriptMessage.trim() ? transcriptMessage : "New session";
+        await saveSessionMetadata(runParams.dataDir, buildNewSessionMetadata({
+            sessionId,
+            title: generateSessionTitle(titleSource),
+            channel: runParams.channel,
+        }));
+    }
+    const durationMs = Date.now() - startTime;
+    const usage = { input: 0, output: 0, total: 0 };
+    const result = {
+        sessionId,
+        text: replyText,
+        usage,
+        durationMs,
+    };
+    await finishSessionLifecycle({
+        sessionId,
+        result,
+        runParams,
+        hookRegistry,
+        hookContext,
+        eventDispatcher,
+    });
+    return result;
+}
+export async function finalizeCompletedRun(params) {
+    const { sessionId, isNewSession, transcriptMessage, runParams, hookRegistry, hookContext, startTime, text, usage, error, eventDispatcher, } = params;
+    if (isNewSession) {
+        await saveSessionMetadata(runParams.dataDir, buildNewSessionMetadata({
+            sessionId,
+            title: generateSessionTitle(transcriptMessage),
+            channel: runParams.channel,
+        }));
+    }
+    const result = {
+        sessionId,
+        text,
+        usage,
+        durationMs: Date.now() - startTime,
+        error,
+    };
+    await finishSessionLifecycle({
+        sessionId,
+        result,
+        runParams,
+        hookRegistry,
+        hookContext,
+        eventDispatcher,
+    });
+    return result;
+}
+//# sourceMappingURL=finalizer.js.map

package/dist/runner/finalizer.js.map

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

package/dist/runner/invocation-resolver.d.ts

@@ -0,0 +1,67 @@
+import type { Message } from "@mariozechner/pi-ai";
+import type { Skill } from "../skills/skills.js";
+import type { AgentRunParams, AgentRunResult } from "../types.js";
+import type { PluginHookRegistry } from "../plugins/hooks.js";
+import { RunEventDispatcher } from "./event-dispatcher.js";
+export type PreparedInvocation = {
+    inputMode: "text" | "messages";
+    rawMessage?: string;
+    promptInput: string | Message[];
+    transcriptMessage: string;
+    slashCommandSource?: string;
+    messageForRun?: string;
+    requestedSessionId?: string;
+    previousSessionId?: string;
+    resetCommand?: {
+        action: "new" | "reset";
+        remainder: string;
+    };
+    resetShortCircuit: boolean;
+};
+export type ResolvedSlashInvocation = {
+    kind: "run";
+    effectivePrompt: string | Message[];
+    transcriptMessage: string;
+} | {
+    kind: "reply";
+    replyText: string;
+    transcriptMessage: string;
+    initialUserEntryPersisted?: boolean;
+} | {
+    kind: "compact";
+    transcriptMessage: string;
+    instructions?: string;
+    initialUserEntryPersisted?: boolean;
+} | {
+    kind: "reset_reply";
+    action: "new" | "reset";
+    transcriptMessage: string;
+    initialUserEntryPersisted: true;
+};
+export type InvocationExecutionResult = {
+    kind: "continue";
+    effectivePrompt: string | Message[];
+    transcriptMessage: string;
+} | {
+    kind: "completed";
+    result: AgentRunResult;
+};
+export declare function prepareInvocation(params: AgentRunParams): PreparedInvocation;
+export declare function resolveSlashInvocation(invocation: PreparedInvocation, skills: Skill[]): ResolvedSlashInvocation;
+export declare function handleInvocation(params: {
+    invocation: PreparedInvocation;
+    skills: Skill[];
+    sessionId: string;
+    isNewSession: boolean;
+    initialUserEntryPersisted: boolean;
+    runParams: AgentRunParams;
+    hookRegistry: PluginHookRegistry;
+    hookContext: {
+        sessionId?: string;
+        workspaceDir?: string;
+        channel?: AgentRunParams["channel"];
+    };
+    startTime: number;
+    eventDispatcher: RunEventDispatcher;
+}): Promise<InvocationExecutionResult>;
+//# sourceMappingURL=invocation-resolver.d.ts.map

package/dist/runner/invocation-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invocation-resolver.d.ts","sourceRoot":"","sources":["../../src/runner/invocation-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAMnD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAE9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAO3D,MAAM,MAAM,kBAAkB,GAAG;IAC/B,SAAS,EAAE,MAAM,GAAG,UAAU,CAAC;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,GAAG,OAAO,EAAE,CAAC;IAChC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,YAAY,CAAC,EAAE;QACb,MAAM,EAAE,KAAK,GAAG,OAAO,CAAC;QACxB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,iBAAiB,EAAE,OAAO,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAC/B;IACE,IAAI,EAAE,KAAK,CAAC;IACZ,eAAe,EAAE,MAAM,GAAG,OAAO,EAAE,CAAC;IACpC,iBAAiB,EAAE,MAAM,CAAC;CAC3B,GACD;IACE,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,yBAAyB,CAAC,EAAE,OAAO,CAAC;CACrC,GACD;IACE,IAAI,EAAE,SAAS,CAAC;IAChB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yBAAyB,CAAC,EAAE,OAAO,CAAC;CACrC,GACD;IACE,IAAI,EAAE,aAAa,CAAC;IACpB,MAAM,EAAE,KAAK,GAAG,OAAO,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,yBAAyB,EAAE,IAAI,CAAC;CACjC,CAAC;AAEN,MAAM,MAAM,yBAAyB,GACjC;IACE,IAAI,EAAE,UAAU,CAAC;IACjB,eAAe,EAAE,MAAM,GAAG,OAAO,EAAE,CAAC;IACpC,iBAAiB,EAAE,MAAM,CAAC;CAC3B,GACD;IACE,IAAI,EAAE,WAAW,CAAC;IAClB,MAAM,EAAE,cAAc,CAAC;CACxB,CAAC;AAEN,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,cAAc,GAAG,kBAAkB,CAiC5E;AAED,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,kBAAkB,EAC9B,MAAM,EAAE,KAAK,EAAE,GACd,uBAAuB,CAsDzB;AAED,wBAAsB,gBAAgB,CAAC,MAAM,EAAE;IAC7C,UAAU,EAAE,kBAAkB,CAAC;IAC/B,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,OAAO,CAAC;IACtB,yBAAyB,EAAE,OAAO,CAAC;IACnC,SAAS,EAAE,cAAc,CAAC;IAC1B,YAAY,EAAE,kBAAkB,CAAC;IACjC,WAAW,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,cAAc,CAAC,SAAS,CAAC,CAAA;KAAE,CAAC;IAChG,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,kBAAkB,CAAC;CACrC,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAoFrC"}