pi-subagents 0.69.0 → 0.70.0

package/src/integrations/herdr-status.js

@@ -0,0 +1,371 @@
+import { SUBAGENT_ASYNC_COMPLETE_EVENT, SUBAGENT_ASYNC_STARTED_EVENT, SUBAGENT_CONTROL_EVENT, } from "../shared/types.js";
+import { previewDisplayText, sanitizeDisplayText } from "../shared/display-text.js";
+const DEFAULT_SOURCE = "pi-subagents:herdr";
+const DEFAULT_TTL_MS = 120_000;
+const DEFAULT_REFRESH_MS = 45_000;
+const MAX_TASK_LABEL_CHARS = 80;
+const MAX_TITLE_TASK_CHARS = 42;
+const MAX_WORKFLOW_LABEL_NODES = 128;
+const MAX_WORKFLOW_LABEL_DEPTH = 8;
+let metadataReportSeq = Date.now() * 1000;
+function nextMetadataReportSeq() {
+    metadataReportSeq = Math.max(metadataReportSeq + 1, Date.now() * 1000);
+    return metadataReportSeq;
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function boundedTaskLabel(value, maxChars = MAX_TASK_LABEL_CHARS) {
+    if (typeof value !== "string")
+        return undefined;
+    const normalized = sanitizeDisplayText(value).trim();
+    if (!normalized)
+        return undefined;
+    return previewDisplayText(normalized, maxChars);
+}
+function workflowTaskLabel(data) {
+    const explicit = boundedTaskLabel(data.taskLabel);
+    if (explicit)
+        return explicit;
+    if (!isRecord(data.workflowGraph) || !Array.isArray(data.workflowGraph.nodes))
+        return undefined;
+    const currentNodeId = typeof data.workflowGraph.currentNodeId === "string" ? data.workflowGraph.currentNodeId : undefined;
+    const nodes = [];
+    const collect = (values, depth) => {
+        if (depth > MAX_WORKFLOW_LABEL_DEPTH || nodes.length >= MAX_WORKFLOW_LABEL_NODES)
+            return;
+        for (const value of values) {
+            if (nodes.length >= MAX_WORKFLOW_LABEL_NODES)
+                return;
+            if (!isRecord(value))
+                continue;
+            nodes.push(value);
+            if (Array.isArray(value.children))
+                collect(value.children, depth + 1);
+        }
+    };
+    collect(data.workflowGraph.nodes, 0);
+    const current = currentNodeId ? nodes.find((node) => node.id === currentNodeId) : undefined;
+    const active = current ?? nodes.find((node) => node.status === "running") ?? nodes.find((node) => node.status === "pending");
+    return boundedTaskLabel(active?.label);
+}
+function startedRun(data) {
+    if (!isRecord(data) || typeof data.id !== "string" || !data.id)
+        return undefined;
+    const taskLabel = workflowTaskLabel(data);
+    return {
+        id: data.id,
+        ...(typeof data.agent === "string" ? { agent: data.agent } : {}),
+        ...(Array.isArray(data.agents) && data.agents.every((agent) => typeof agent === "string") ? { agents: data.agents } : {}),
+        ...(taskLabel ? { taskLabel } : {}),
+    };
+}
+function completedRunId(data) {
+    if (!isRecord(data))
+        return undefined;
+    const id = typeof data.runId === "string" ? data.runId : data.id;
+    return typeof id === "string" && id.length > 0 ? id : undefined;
+}
+function attentionNotice(data) {
+    if (!isRecord(data) || data.source !== "async" || !isRecord(data.event))
+        return undefined;
+    if (data.event.type !== "needs_attention" || typeof data.event.runId !== "string" || !data.event.runId)
+        return undefined;
+    const label = typeof data.noticeText === "string" && data.noticeText
+        ? data.noticeText
+        : typeof data.event.message === "string" && data.event.message
+            ? data.event.message
+            : "subagent needs attention";
+    return { runId: data.event.runId, label };
+}
+export function registerHerdrStatusBridge(options) {
+    const env = options.env ?? process.env;
+    const paneId = env.HERDR_PANE_ID;
+    const enabled = env.HERDR_ENV === "1" && typeof paneId === "string" && paneId.length > 0;
+    const runHerdr = options.runHerdr;
+    const ttlMs = options.ttlMs ?? DEFAULT_TTL_MS;
+    const refreshMs = options.refreshMs ?? DEFAULT_REFRESH_MS;
+    const timers = options.timers ?? { setInterval, clearInterval };
+    const runs = new Map();
+    const attentionLabels = new Map();
+    const acknowledgedAttention = new Set();
+    const subscriptions = [];
+    let rootSession = false;
+    let published = false;
+    let busyRaised = false;
+    let busyLabel;
+    let blockedRaised = false;
+    let blockedLabel;
+    let disposed = false;
+    let pendingReport;
+    let draining = false;
+    let drainPromise = Promise.resolve();
+    let refreshTimer;
+    const activeAgentNames = () => [...new Set([...runs.values()].flatMap((run) => run.agents?.length ? run.agents : run.agent ? [run.agent] : []))];
+    const activeSubagentCount = () => [...runs.values()].reduce((total, run) => total + Math.max(1, run.agents?.length ?? (run.agent ? 1 : 0)), 0);
+    const activeTaskLabel = () => [...runs.values()].reverse().find((run) => run.taskLabel)?.taskLabel;
+    const label = (includeAttention = false) => {
+        const agents = activeAgentNames();
+        const activeCount = activeSubagentCount();
+        const who = agents.length > 0
+            ? ` (${agents.slice(0, 3).join(", ")}${agents.length > 3 ? ", …" : ""})`
+            : "";
+        const panes = Math.max(0, options.getProjectPaneCount?.() ?? 0);
+        const paneText = panes > 0 ? ` · ${panes} pane${panes === 1 ? "" : "s"}` : "";
+        const task = activeTaskLabel();
+        const taskText = task ? ` · ${task}` : "";
+        const attention = includeAttention && attentionLabels.size > 0 ? " ⚠" : "";
+        return `⏳ ${activeCount} subagent${activeCount === 1 ? "" : "s"}${who}${paneText}${taskText}${attention}`;
+    };
+    const titleSuffix = () => {
+        if (runs.size === 0)
+            return undefined;
+        const agentNames = activeAgentNames();
+        const activeCount = activeSubagentCount();
+        const task = boundedTaskLabel(activeTaskLabel(), MAX_TITLE_TASK_CHARS);
+        const target = task ?? (activeCount === 1 && agentNames.length === 1 ? agentNames[0] : String(activeCount));
+        return `⏳${target}${attentionLabels.size > 0 ? "⚠" : ""}`;
+    };
+    const enqueue = (args) => {
+        pendingReport = args;
+        if (draining)
+            return;
+        draining = true;
+        drainPromise = (async () => {
+            while (pendingReport) {
+                const next = pendingReport;
+                pendingReport = undefined;
+                try {
+                    await runHerdr(next);
+                }
+                catch {
+                    // Herdr integration is best effort; a later state transition or TTL
+                    // refresh retries with the newest desired snapshot.
+                }
+            }
+        })().finally(() => {
+            draining = false;
+        });
+    };
+    const publish = () => {
+        if (!enabled || !rootSession || disposed || !paneId)
+            return;
+        if (runs.size === 0 && !published)
+            return;
+        const seq = String(nextMetadataReportSeq());
+        if (runs.size === 0) {
+            published = false;
+            enqueue([
+                "pane", "report-metadata", paneId,
+                "--source", DEFAULT_SOURCE,
+                "--agent", "pi",
+                "--applies-to-source", "herdr:pi",
+                "--clear-state-labels",
+                "--clear-token", "summary",
+                "--clear-token", "title-suffix",
+                "--seq", seq,
+            ]);
+            return;
+        }
+        const text = label(true);
+        const suffix = titleSuffix();
+        published = true;
+        enqueue([
+            "pane", "report-metadata", paneId,
+            "--source", DEFAULT_SOURCE,
+            "--agent", "pi",
+            "--applies-to-source", "herdr:pi",
+            "--state-label", `idle=${text}`,
+            "--state-label", `done=${text}`,
+            "--state-label", `working=${text}`,
+            "--token", `summary=${text}`,
+            ...(suffix ? ["--token", `title-suffix=${suffix}`] : []),
+            "--ttl-ms", String(ttlMs),
+            "--seq", seq,
+        ]);
+    };
+    const syncRefreshTimer = () => {
+        if (runs.size > 0 && refreshMs > 0 && !refreshTimer) {
+            refreshTimer = timers.setInterval(() => refresh(), refreshMs);
+            refreshTimer.unref?.();
+        }
+        else if ((runs.size === 0 || refreshMs <= 0) && refreshTimer) {
+            timers.clearInterval(refreshTimer);
+            refreshTimer = undefined;
+        }
+    };
+    const syncBusy = () => {
+        if (!enabled || !rootSession || disposed)
+            return;
+        if (runs.size > 0) {
+            const text = label();
+            if (busyRaised && busyLabel === text)
+                return;
+            if (busyRaised)
+                options.events.emit("herdr:busy", { active: false });
+            busyRaised = true;
+            busyLabel = text;
+            options.events.emit("herdr:busy", { active: true, label: text });
+            return;
+        }
+        if (busyRaised) {
+            busyRaised = false;
+            busyLabel = undefined;
+            options.events.emit("herdr:busy", { active: false });
+        }
+    };
+    const syncBlocked = () => {
+        if (!enabled || !rootSession || disposed)
+            return;
+        const nextLabel = [...attentionLabels.values()].at(-1);
+        if (nextLabel !== undefined) {
+            if (blockedRaised && blockedLabel === nextLabel)
+                return;
+            // Herdr's sibling overlay contract is counted. Lower before changing
+            // the active label so this bridge continues to own exactly one count.
+            if (blockedRaised)
+                options.events.emit("herdr:blocked", { active: false });
+            blockedRaised = true;
+            blockedLabel = nextLabel;
+            options.events.emit("herdr:blocked", { active: true, label: nextLabel });
+            return;
+        }
+        if (blockedRaised) {
+            blockedRaised = false;
+            blockedLabel = undefined;
+            options.events.emit("herdr:blocked", { active: false });
+        }
+    };
+    const clearAttention = () => {
+        attentionLabels.clear();
+        syncBlocked();
+        publish();
+    };
+    const raiseAttention = (runId, labelText) => {
+        if (!rootSession || attentionLabels.has(runId))
+            return;
+        acknowledgedAttention.delete(runId);
+        attentionLabels.set(runId, labelText);
+        syncBlocked();
+        publish();
+    };
+    const replaceRuns = (nextRuns) => {
+        const nextAttention = new Map();
+        const activeIds = new Set();
+        runs.clear();
+        for (const run of nextRuns) {
+            if (!run || typeof run.id !== "string" || !run.id)
+                continue;
+            activeIds.add(run.id);
+            const taskLabel = boundedTaskLabel(run.taskLabel);
+            const { taskLabel: _rawTaskLabel, ...sanitizedRun } = run;
+            runs.set(run.id, { ...sanitizedRun, ...(taskLabel ? { taskLabel } : {}) });
+            if (!run.needsAttention) {
+                acknowledgedAttention.delete(run.id);
+            }
+            else if (!acknowledgedAttention.has(run.id)) {
+                nextAttention.set(run.id, run.attentionLabel || attentionLabels.get(run.id) || "subagent needs attention");
+            }
+        }
+        for (const id of acknowledgedAttention) {
+            if (!activeIds.has(id))
+                acknowledgedAttention.delete(id);
+        }
+        attentionLabels.clear();
+        for (const [id, labelText] of nextAttention)
+            attentionLabels.set(id, labelText);
+        syncBusy();
+        syncRefreshTimer();
+        syncBlocked();
+        publish();
+    };
+    const refresh = () => {
+        if (!options.getRuns) {
+            publish();
+            return;
+        }
+        try {
+            replaceRuns(options.getRuns());
+        }
+        catch {
+            // Keep the last known active projection and retry on the next refresh.
+            publish();
+        }
+    };
+    const subscribe = (event, handler) => {
+        const unsubscribe = options.events.on(event, handler);
+        if (typeof unsubscribe === "function")
+            subscriptions.push(unsubscribe);
+    };
+    if (enabled) {
+        subscribe(SUBAGENT_ASYNC_STARTED_EVENT, (data) => {
+            if (!rootSession)
+                return;
+            const run = startedRun(data);
+            if (!run)
+                return;
+            acknowledgedAttention.delete(run.id);
+            runs.set(run.id, run);
+            syncBusy();
+            syncRefreshTimer();
+            publish();
+        });
+        subscribe(SUBAGENT_ASYNC_COMPLETE_EVENT, (data) => {
+            if (!rootSession)
+                return;
+            const id = completedRunId(data);
+            if (!id || !runs.delete(id))
+                return;
+            acknowledgedAttention.delete(id);
+            if (attentionLabels.delete(id))
+                syncBlocked();
+            syncBusy();
+            syncRefreshTimer();
+            publish();
+        });
+        subscribe(SUBAGENT_CONTROL_EVENT, (data) => {
+            if (!rootSession)
+                return;
+            const notice = attentionNotice(data);
+            if (!notice || !runs.has(notice.runId))
+                return;
+            raiseAttention(notice.runId, notice.label);
+        });
+    }
+    return {
+        agentStarted() {
+            for (const id of attentionLabels.keys())
+                acknowledgedAttention.add(id);
+            clearAttention();
+        },
+        sessionStarted({ hasUI, runs: restoredRuns }) {
+            if (!enabled || disposed || hasUI !== true)
+                return;
+            rootSession = true;
+            replaceRuns(restoredRuns);
+        },
+        syncRuns() {
+            if (!enabled || !rootSession || disposed)
+                return;
+            refresh();
+        },
+        async flush() {
+            while (draining || pendingReport)
+                await drainPromise;
+        },
+        dispose() {
+            if (disposed)
+                return;
+            clearAttention();
+            acknowledgedAttention.clear();
+            runs.clear();
+            syncBusy();
+            syncRefreshTimer();
+            publish();
+            for (const unsubscribe of subscriptions)
+                unsubscribe();
+            disposed = true;
+        },
+    };
+}
+//# sourceMappingURL=herdr-status.js.map

package/src/integrations/herdr-status.js.map

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

package/src/integrations/pi-web-session-liveness.d.ts

@@ -0,0 +1,20 @@
+import type { NestedRouteInfo, SubagentState } from "../shared/types.ts";
+export declare const PI_WEB_SESSION_LIVENESS_REGISTRY_KEY = "@agegr/pi-web/session-liveness/v1";
+interface PiWebSessionLivenessProvider {
+    name: string;
+    sessionId: string;
+    sessionFile?: string;
+    isActive(): boolean;
+}
+type SessionLivenessRegistration = Omit<PiWebSessionLivenessProvider, "name">;
+export interface PiWebSessionLivenessHandle {
+    /** True only when the compatible host accepted the provider registration. */
+    registered: boolean;
+    release: () => void;
+}
+type LiveWorkState = Pick<SubagentState, "asyncJobs" | "foregroundControls" | "retainedForegroundNestedRoutes">;
+export declare function retainLiveForegroundNestedRoute(state: Pick<SubagentState, "retainedForegroundNestedRoutes">, route: NestedRouteInfo): boolean;
+export declare function hasLiveSubagentWork(state: LiveWorkState): boolean;
+export declare function registerPiWebSessionLiveness(registration: SessionLivenessRegistration): PiWebSessionLivenessHandle;
+export {};
+//# sourceMappingURL=pi-web-session-liveness.d.ts.map

package/src/integrations/pi-web-session-liveness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pi-web-session-liveness.d.ts","sourceRoot":"","sources":["../../../src/integrations/pi-web-session-liveness.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEzE,eAAO,MAAM,oCAAoC,sCAAsC,CAAC;AAGxF,UAAU,4BAA4B;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,IAAI,OAAO,CAAC;CACpB;AAOD,KAAK,2BAA2B,GAAG,IAAI,CAAC,4BAA4B,EAAE,MAAM,CAAC,CAAC;AAE9E,MAAM,WAAW,0BAA0B;IAC1C,6EAA6E;IAC7E,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,MAAM,IAAI,CAAC;CACpB;AAED,KAAK,aAAa,GAAG,IAAI,CAAC,aAAa,EAAE,WAAW,GAAG,oBAAoB,GAAG,gCAAgC,CAAC,CAAC;AAUhH,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,IAAI,CAAC,aAAa,EAAE,gCAAgC,CAAC,EAAE,KAAK,EAAE,eAAe,GAAG,OAAO,CAM7I;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAUjE;AAED,wBAAgB,4BAA4B,CAAC,YAAY,EAAE,2BAA2B,GAAG,0BAA0B,CAgBlH"}

package/src/integrations/pi-web-session-liveness.js

@@ -0,0 +1,54 @@
+import { hasLiveNestedDescendants, projectNestedEvents } from "../runs/shared/nested-events.js";
+export const PI_WEB_SESSION_LIVENESS_REGISTRY_KEY = "@agegr/pi-web/session-liveness/v1";
+const PI_WEB_SESSION_LIVENESS_PROTOCOL_VERSION = 1;
+function resolveRegistry() {
+    const value = globalThis[Symbol.for(PI_WEB_SESSION_LIVENESS_REGISTRY_KEY)];
+    if (!value || typeof value !== "object")
+        return null;
+    const registry = value;
+    if (registry.version !== PI_WEB_SESSION_LIVENESS_PROTOCOL_VERSION || typeof registry.register !== "function")
+        return null;
+    return registry;
+}
+export function retainLiveForegroundNestedRoute(state, route) {
+    const nested = projectNestedEvents(route);
+    if (!hasLiveNestedDescendants(nested.children))
+        return false;
+    state.retainedForegroundNestedRoutes ??= new Map();
+    state.retainedForegroundNestedRoutes.set(route.rootRunId, route);
+    return true;
+}
+export function hasLiveSubagentWork(state) {
+    for (const job of state.asyncJobs.values()) {
+        if (job.status === "queued" || job.status === "running" || hasLiveNestedDescendants(job.nestedChildren))
+            return true;
+    }
+    for (const control of state.foregroundControls.values()) {
+        if ((control.schedulingOwners ?? 0) > 0
+            || (control.activeChildren?.size ?? 0) > 0
+            || hasLiveNestedDescendants(control.nestedChildren))
+            return true;
+    }
+    return (state.retainedForegroundNestedRoutes?.size ?? 0) > 0;
+}
+export function registerPiWebSessionLiveness(registration) {
+    const registry = resolveRegistry();
+    if (!registry)
+        return { registered: false, release: () => { } };
+    try {
+        const release = registry.register({
+            name: "pi-subagents",
+            sessionId: registration.sessionId,
+            ...(registration.sessionFile ? { sessionFile: registration.sessionFile } : {}),
+            isActive: registration.isActive,
+        });
+        if (typeof release === "function")
+            return { registered: true, release };
+        console.error("Failed to register pi-web session liveness: host registry returned no release function.");
+    }
+    catch (error) {
+        console.error("Failed to register pi-web session liveness:", error);
+    }
+    return { registered: false, release: () => { } };
+}
+//# sourceMappingURL=pi-web-session-liveness.js.map

package/src/integrations/pi-web-session-liveness.js.map

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

package/src/intercom/intercom-bridge.d.ts

@@ -0,0 +1,59 @@
+import type { AgentConfig } from "../agents/agents.ts";
+import type { ExtensionConfig, IntercomBridgeConfig, IntercomBridgeMode } from "../shared/types.ts";
+export declare const NATIVE_INTERCOM_EXTENSION_DIR = "native:pi-subagents-supervisor-channel";
+export declare const PI_INTERCOM_SESSION_ID_ENV = "PI_INTERCOM_SESSION_ID";
+export declare const INTERCOM_BRIDGE_MARKER = "Intercom orchestration channel:";
+export interface IntercomBridgeState {
+    active: boolean;
+    mode: IntercomBridgeMode;
+    resultDelivery: boolean;
+    orchestratorTarget?: string;
+    extensionDir: string;
+    instruction: string;
+    /** True when the instruction template names the supervisor session, which ties the child prompt to the parent session. */
+    interpolatesOrchestratorTarget: boolean;
+}
+export type IntercomBridgeConfigValidation = {
+    ok: true;
+    value: IntercomBridgeConfig;
+} | {
+    ok: false;
+    error: string;
+};
+/** Validates untrusted bridge config from descriptors or delegation requests; `label` prefixes each error. */
+export declare function validateIntercomBridgeConfig({ value, label }: {
+    value: unknown;
+    label: string;
+}): IntercomBridgeConfigValidation;
+export interface IntercomBridgeDiagnostic {
+    active: boolean;
+    mode: IntercomBridgeMode;
+    wantsIntercom: boolean;
+    supervisorChannelAvailable: boolean;
+    extensionDir: string;
+    orchestratorTarget?: string;
+    reason?: string;
+}
+interface ResolveIntercomBridgeInput {
+    config: ExtensionConfig["intercomBridge"];
+    /** Per-run config replaces the global config when supplied. */
+    override?: IntercomBridgeConfig;
+    context: "fresh" | "fork" | undefined;
+    orchestratorTarget?: string;
+    cwd?: string;
+    settingsDir?: string;
+    agentDir?: string;
+}
+export declare function resolveIntercomSessionTarget(sessionName: string | undefined, sessionId: string, intercomSessionId?: string | undefined): string;
+export declare function resolveSubagentIntercomTarget(runId: string, agent: string, index?: number): string;
+export declare function resolveIntercomBridgeMode(value: unknown): IntercomBridgeMode;
+export declare function diagnoseIntercomBridge(input: ResolveIntercomBridgeInput): IntercomBridgeDiagnostic;
+export declare function resolveIntercomBridge(input: ResolveIntercomBridgeInput): IntercomBridgeState;
+/**
+ * Rewrites the launch prompt and tools for an active bridge. The parsed
+ * definition digest is captured first so launch identity keeps describing the
+ * agent file rather than this runtime overlay.
+ */
+export declare function applyIntercomBridgeToAgent(agent: AgentConfig, bridge: IntercomBridgeState): AgentConfig;
+export {};
+//# sourceMappingURL=intercom-bridge.d.ts.map

package/src/intercom/intercom-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intercom-bridge.d.ts","sourceRoot":"","sources":["../../../src/intercom/intercom-bridge.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,OAAO,KAAK,EAAE,eAAe,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAGpG,eAAO,MAAM,6BAA6B,2CAA2C,CAAC;AAWtF,eAAO,MAAM,0BAA0B,2BAA2B,CAAC;AACnE,eAAO,MAAM,sBAAsB,oCAAoC,CAAC;AAgBxE,MAAM,WAAW,mBAAmB;IACnC,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,kBAAkB,CAAC;IACzB,cAAc,EAAE,OAAO,CAAC;IACxB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,0HAA0H;IAC1H,8BAA8B,EAAE,OAAO,CAAC;CACxC;AAED,MAAM,MAAM,8BAA8B,GACvC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,oBAAoB,CAAA;CAAE,GACzC;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEhC,8GAA8G;AAC9G,wBAAgB,4BAA4B,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,8BAA8B,CAiBhI;AAED,MAAM,WAAW,wBAAwB;IACxC,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,kBAAkB,CAAC;IACzB,aAAa,EAAE,OAAO,CAAC;IACvB,0BAA0B,EAAE,OAAO,CAAC;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,0BAA0B;IACnC,MAAM,EAAE,eAAe,CAAC,gBAAgB,CAAC,CAAC;IAC1C,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAChC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC;IACtC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,4BAA4B,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,iBAAiB,qBAA0C,GAAG,MAAM,CASpK;AAMD,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAGlG;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,kBAAkB,CAG5E;AA4CD,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,0BAA0B,GAAG,wBAAwB,CAelG;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,0BAA0B,GAAG,mBAAmB,CA2B5F;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,mBAAmB,GAAG,WAAW,CAsBvG"}