pi-subagents 0.69.0 → 0.70.0

package/src/missions/types.d.ts

@@ -0,0 +1,168 @@
+export declare const MISSION_STATUSES: readonly ["planned", "active", "waiting", "needs_decision", "completed", "failed", "cancelled"];
+export type MissionStatus = typeof MISSION_STATUSES[number];
+export type MissionRunMode = "single" | "parallel" | "chain" | "workflow" | "scheduled" | "external";
+export type MissionArtifactKind = "status" | "output" | "patch" | "manifest" | "review" | "note" | "other";
+export type MissionReceiptKind = "pull_request" | "ci" | "deployment" | "release";
+export type MissionReceiptStatus = "pending" | "ready" | "succeeded" | "failed";
+export type MissionGoalStatus = "active" | "paused" | "budget-exhausted";
+export interface MissionGoal {
+    status: MissionGoalStatus;
+}
+export interface MissionTokenBudget {
+    tokens: number;
+}
+export interface MissionTokenUsage {
+    tokens: number;
+}
+export interface MissionRunLink {
+    runId: string;
+    asyncDir?: string;
+    childIndex?: number;
+    agent?: string;
+    mode: MissionRunMode;
+    status?: string;
+    startedAt?: string;
+    completedAt?: string;
+    usage?: MissionTokenUsage;
+}
+export interface MissionDecision {
+    id: string;
+    status: "open" | "resolved";
+    title: string;
+    prompt?: string;
+    options?: string[];
+    recommendation?: string;
+    createdAt: string;
+    resolvedAt?: string;
+    resolution?: string;
+}
+export interface MissionChildHeartbeat {
+    updatedAt: string;
+    status?: string;
+    phase?: string;
+    message?: string;
+}
+export interface MissionWorkflowChild {
+    workflowRunId: string;
+    key: string;
+    status: string;
+    startedAt: string;
+    updatedAt: string;
+    runId?: string;
+    agent?: string;
+    task?: string;
+    label?: string;
+    phase?: string;
+    completedAt?: string;
+    sessionPath?: string;
+    artifactPaths: string[];
+    heartbeat?: MissionChildHeartbeat;
+}
+export type MissionWorkflowChildUpdate = Pick<MissionWorkflowChild, "workflowRunId" | "key" | "status"> & Partial<Omit<MissionWorkflowChild, "workflowRunId" | "key" | "status" | "startedAt" | "updatedAt" | "artifactPaths" | "heartbeat">> & {
+    startedAt?: string;
+    artifactPaths?: string[];
+    heartbeat?: Omit<MissionChildHeartbeat, "updatedAt"> & {
+        updatedAt?: string;
+    };
+};
+export interface MissionArtifact {
+    kind: MissionArtifactKind;
+    path: string;
+    description?: string;
+}
+export interface MissionReceipt {
+    kind: MissionReceiptKind;
+    status: MissionReceiptStatus;
+    title: string;
+    url: string;
+    createdAt: string;
+    description?: string;
+}
+export interface MissionRecord {
+    schemaVersion: 1;
+    id: string;
+    title: string;
+    objective: string;
+    goal?: MissionGoal;
+    budget?: MissionTokenBudget;
+    usage?: MissionTokenUsage;
+    status: MissionStatus;
+    createdAt: string;
+    updatedAt: string;
+    cwd?: string;
+    ownerSessionId?: string;
+    runs: MissionRunLink[];
+    workflowChildren: MissionWorkflowChild[];
+    decisions: MissionDecision[];
+    artifacts: MissionArtifact[];
+    receipts: MissionReceipt[];
+    summary?: string;
+    acceptance?: unknown;
+    labels?: string[];
+}
+export interface MissionIndexEntry {
+    schemaVersion: 1;
+    missionId: string;
+    projectRoot: string;
+    recordPath: string;
+    title: string;
+    status: MissionStatus;
+    updatedAt: string;
+    lastRunId?: string;
+}
+export interface MissionStoreConfig {
+    enabled?: boolean;
+    directory?: string;
+    globalIndex?: boolean;
+    globalIndexDir?: string;
+    retainTerminal?: number;
+}
+export interface MissionStoreLocation {
+    projectRoot: string;
+    missionDir: string;
+    globalIndexDir: string;
+    writeGlobalIndex: boolean;
+    retainTerminal?: number;
+}
+export interface MissionListResult {
+    records: MissionRecord[];
+    warnings: string[];
+}
+export interface GlobalMissionIndexRecord extends MissionIndexEntry {
+    stale: boolean;
+    staleReason?: string;
+}
+export interface GlobalMissionListResult {
+    entries: GlobalMissionIndexRecord[];
+    warnings: string[];
+}
+export interface MissionCreateInput {
+    title: string;
+    objective: string;
+    goal?: boolean;
+    budget?: MissionTokenBudget;
+    status?: MissionStatus;
+    labels?: string[];
+    ownerSessionId?: string;
+}
+export interface MissionUpdateInput {
+    title?: string;
+    objective?: string;
+    goal?: MissionGoal | false;
+    budget?: MissionTokenBudget;
+    usage?: MissionTokenUsage;
+    status?: MissionStatus;
+    summary?: string;
+    labels?: string[];
+    acceptance?: unknown;
+    addRuns?: MissionRunLink[];
+    upsertWorkflowChildren?: MissionWorkflowChildUpdate[];
+    addArtifacts?: MissionArtifact[];
+    addDecisions?: Array<Omit<MissionDecision, "id" | "status" | "createdAt">>;
+    resolveDecision?: {
+        id: string;
+        resolution: string;
+    };
+    addReceipts?: Array<Omit<MissionReceipt, "createdAt">>;
+}
+//# sourceMappingURL=types.d.ts.map

package/src/missions/types.d.ts.map

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

package/src/missions/types.js

@@ -0,0 +1,10 @@
+export const MISSION_STATUSES = [
+    "planned",
+    "active",
+    "waiting",
+    "needs_decision",
+    "completed",
+    "failed",
+    "cancelled",
+];
+//# sourceMappingURL=types.js.map

package/src/missions/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/missions/types.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC/B,SAAS;IACT,QAAQ;IACR,SAAS;IACT,gBAAgB;IAChB,WAAW;IACX,QAAQ;IACR,WAAW;CACF,CAAC"}

package/src/missions/workflow-state.d.ts

@@ -0,0 +1,15 @@
+import type { MissionStoreLocation } from "./types.ts";
+export declare const MISSION_STATE_MAX_BYTES: number;
+export interface MissionWorkflowState {
+    path: string;
+    get(key: string): unknown;
+    set(key: string, value: unknown): void;
+}
+export interface MissionWorkflowStateOptions {
+    isProcessAlive?: (pid: number) => boolean;
+    getProcessStartKey?: (pid: number) => string | undefined;
+    retryDelaysMs?: readonly number[];
+}
+export declare function missionStatePath(location: MissionStoreLocation, missionId: string): string;
+export declare function createMissionWorkflowState(location: MissionStoreLocation, missionId: string, options?: MissionWorkflowStateOptions): MissionWorkflowState;
+//# sourceMappingURL=workflow-state.d.ts.map

package/src/missions/workflow-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-state.d.ts","sourceRoot":"","sources":["../../../src/missions/workflow-state.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAKvD,eAAO,MAAM,uBAAuB,QAAa,CAAC;AAElD,MAAM,WAAW,oBAAoB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAC1B,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;CACvC;AAED,MAAM,WAAW,2BAA2B;IAC3C,cAAc,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;IAC1C,kBAAkB,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IACzD,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAClC;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,oBAAoB,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAE1F;AAmMD,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,oBAAoB,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,GAAE,2BAAgC,GAAG,oBAAoB,CAyD7J"}

package/src/missions/workflow-state.js

@@ -0,0 +1,274 @@
+import { execFileSync } from "node:child_process";
+import { randomUUID } from "node:crypto";
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { writePrivateAtomicJson } from "../shared/atomic-json.js";
+import { DEFAULT_FILE_SYSTEM_RETRY_DELAYS_MS, isRetryableFileSystemError, waitForFileSystemRetry } from "../shared/file-system-retry.js";
+import { assertWorkflowJsonValue } from "../workflows/scripted-workflow.js";
+import { validateMissionId } from "./store.js";
+const STATE_KEY_PATTERN = /^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/;
+const STATE_LOCK_STALE_MS = 60_000;
+export const MISSION_STATE_MAX_BYTES = 256 * 1024;
+export function missionStatePath(location, missionId) {
+    return path.join(location.missionDir, validateMissionId(missionId), "state.json");
+}
+function isProcessAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (error) {
+        return error.code === "EPERM";
+    }
+}
+function linuxProcessStartKey(pid) {
+    try {
+        const raw = fs.readFileSync(`/proc/${pid}/stat`, "utf-8");
+        const tail = raw.slice(raw.lastIndexOf(")") + 2).trim().split(/\s+/);
+        return tail[19] ? `linux:${tail[19]}` : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function psProcessStartKey(pid) {
+    try {
+        const raw = execFileSync("ps", ["-p", String(pid), "-o", "lstart="], { encoding: "utf-8", stdio: ["ignore", "pipe", "ignore"], timeout: 1000 }).trim();
+        return raw ? `ps:${raw}` : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function windowsProcessStartKey(pid) {
+    try {
+        const raw = execFileSync("powershell.exe", ["-NoProfile", "-Command", `(Get-CimInstance Win32_Process -Filter \"ProcessId=${pid}\").CreationDate`], { encoding: "utf-8", stdio: ["ignore", "pipe", "ignore"], timeout: 1000, windowsHide: true }).trim();
+        return raw ? `win:${raw}` : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+let currentProcessKey = null;
+function processStartKey(pid) {
+    // Foreign PIDs can be reused while this process lives, so resolve them afresh.
+    if (pid !== process.pid)
+        return computeProcessStartKey(pid);
+    if (currentProcessKey === null)
+        currentProcessKey = computeProcessStartKey(pid);
+    return currentProcessKey;
+}
+function computeProcessStartKey(pid) {
+    if (process.platform === "linux")
+        return linuxProcessStartKey(pid) ?? psProcessStartKey(pid);
+    if (process.platform === "win32")
+        return windowsProcessStartKey(pid);
+    return undefined;
+}
+function readStateLockOwner(lockPath) {
+    try {
+        const owner = JSON.parse(fs.readFileSync(path.join(lockPath, "owner.json"), "utf-8"));
+        if (Number.isSafeInteger(owner.pid) && owner.pid > 0 && typeof owner.token === "string" && owner.token && Number.isSafeInteger(owner.createdAt)) {
+            return {
+                pid: owner.pid,
+                token: owner.token,
+                createdAt: owner.createdAt,
+                ...(typeof owner.processKey === "string" && owner.processKey ? { processKey: owner.processKey } : {}),
+            };
+        }
+    }
+    catch {
+        return undefined;
+    }
+    return undefined;
+}
+function stateLockIsStale(lockPath, options, now = Date.now()) {
+    const owner = readStateLockOwner(lockPath);
+    if (owner) {
+        if (!options.isProcessAlive(owner.pid))
+            return true;
+        if (owner.processKey) {
+            const observedProcessKey = options.getProcessStartKey(owner.pid);
+            if (observedProcessKey)
+                return owner.processKey !== observedProcessKey;
+            if (owner.pid === process.pid)
+                return true;
+        }
+        return false;
+    }
+    try {
+        return now - fs.statSync(lockPath).mtimeMs > STATE_LOCK_STALE_MS;
+    }
+    catch (error) {
+        if (error.code === "ENOENT")
+            return false;
+        throw error;
+    }
+}
+function removeOwnedStateLock(lockPath, owner) {
+    const current = readStateLockOwner(lockPath);
+    if (current?.token !== owner.token)
+        return;
+    fs.rmSync(lockPath, { recursive: true, force: true });
+}
+function staleDirectoryExists(dirPath, now = Date.now()) {
+    try {
+        return now - fs.statSync(dirPath).mtimeMs > STATE_LOCK_STALE_MS;
+    }
+    catch (error) {
+        if (error.code === "ENOENT")
+            return false;
+        throw error;
+    }
+}
+function tryMakeDirectory(dirPath, mode) {
+    try {
+        fs.mkdirSync(dirPath, { mode });
+        return true;
+    }
+    catch (error) {
+        if (error.code === "EEXIST")
+            return false;
+        throw error;
+    }
+}
+function waitForStateLock(delayMs, lockPath) {
+    if (delayMs === undefined)
+        throw new Error(`Timed out acquiring mission state lock '${lockPath}'.`);
+    waitForFileSystemRetry(delayMs);
+}
+function reclaimStaleStateLock(lockPath, reclaimPath, options) {
+    if (!stateLockIsStale(lockPath, options))
+        return false;
+    if (!tryMakeDirectory(reclaimPath, 0o700))
+        return false;
+    try {
+        if (!stateLockIsStale(lockPath, options))
+            return false;
+        fs.rmSync(lockPath, { recursive: true, force: true });
+        return true;
+    }
+    finally {
+        fs.rmSync(reclaimPath, { recursive: true, force: true });
+    }
+}
+function withStateFileLock(filePath, operation, options) {
+    fs.mkdirSync(path.dirname(filePath), { recursive: true });
+    const lockPath = `${filePath}.lock`;
+    const reclaimPath = `${lockPath}.reclaim`;
+    let owner;
+    for (let attempt = 0;; attempt++) {
+        if (fs.existsSync(reclaimPath)) {
+            if (staleDirectoryExists(reclaimPath)) {
+                fs.rmSync(reclaimPath, { recursive: true, force: true });
+                continue;
+            }
+            waitForStateLock(options.retryDelaysMs[attempt], lockPath);
+            continue;
+        }
+        let acquired = false;
+        try {
+            acquired = tryMakeDirectory(lockPath, 0o700);
+        }
+        catch (error) {
+            if (isRetryableFileSystemError(error)) {
+                waitForStateLock(options.retryDelaysMs[attempt], lockPath);
+                continue;
+            }
+            throw new Error(`Failed to acquire mission state lock '${lockPath}': ${error instanceof Error ? error.message : String(error)}`);
+        }
+        if (!acquired) {
+            if (reclaimStaleStateLock(lockPath, reclaimPath, options))
+                continue;
+            waitForStateLock(options.retryDelaysMs[attempt], lockPath);
+            continue;
+        }
+        const key = options.getProcessStartKey(process.pid);
+        owner = { pid: process.pid, token: randomUUID(), createdAt: Date.now(), ...(key ? { processKey: key } : {}) };
+        try {
+            fs.writeFileSync(path.join(lockPath, "owner.json"), JSON.stringify(owner), { encoding: "utf-8", mode: 0o600 });
+        }
+        catch (error) {
+            fs.rmSync(lockPath, { recursive: true, force: true });
+            owner = undefined;
+            throw error;
+        }
+        break;
+    }
+    try {
+        return operation();
+    }
+    finally {
+        if (owner)
+            removeOwnedStateLock(lockPath, owner);
+    }
+}
+function validateStateKey(value) {
+    if (typeof value !== "string" || !STATE_KEY_PATTERN.test(value)) {
+        throw new Error("state key must be 1-128 characters using letters, numbers, '.', '_' or '-', and start with a letter or number.");
+    }
+    return value;
+}
+export function createMissionWorkflowState(location, missionId, options = {}) {
+    const filePath = missionStatePath(location, missionId);
+    const lockOptions = {
+        isProcessAlive: options.isProcessAlive ?? isProcessAlive,
+        getProcessStartKey: options.getProcessStartKey ?? processStartKey,
+        retryDelaysMs: options.retryDelaysMs ?? DEFAULT_FILE_SYSTEM_RETRY_DELAYS_MS,
+    };
+    let loaded = false;
+    let values = Object.create(null);
+    const readStateFile = () => {
+        let raw;
+        try {
+            raw = fs.readFileSync(filePath, "utf-8");
+        }
+        catch (error) {
+            if (error.code === "ENOENT")
+                return Object.create(null);
+            throw new Error(`Failed to read mission state '${filePath}': ${error instanceof Error ? error.message : String(error)}`);
+        }
+        const bytes = Buffer.byteLength(raw);
+        if (bytes > MISSION_STATE_MAX_BYTES)
+            throw new Error(`Mission state file '${filePath}' exceeds the 256 KiB limit (${bytes} bytes).`);
+        try {
+            const parsed = JSON.parse(raw);
+            if (!parsed || typeof parsed !== "object" || Array.isArray(parsed))
+                throw new Error("root must be a JSON object");
+            assertWorkflowJsonValue(parsed, "mission state");
+            return Object.assign(Object.create(null), parsed);
+        }
+        catch (error) {
+            throw new Error(`Invalid mission state file '${filePath}': ${error instanceof Error ? error.message : String(error)}`);
+        }
+    };
+    const load = () => {
+        if (loaded)
+            return values;
+        values = readStateFile();
+        loaded = true;
+        return values;
+    };
+    return {
+        path: filePath,
+        get(key) {
+            const validKey = validateStateKey(key);
+            const current = load();
+            return Object.hasOwn(current, validKey) ? current[validKey] : undefined;
+        },
+        set(key, value) {
+            const validKey = validateStateKey(key);
+            assertWorkflowJsonValue(value, `state.set('${validKey}') value`);
+            withStateFileLock(filePath, () => {
+                const next = Object.assign(Object.create(null), readStateFile(), { [validKey]: value });
+                const bytes = Buffer.byteLength(JSON.stringify(next, null, 2));
+                if (bytes > MISSION_STATE_MAX_BYTES)
+                    throw new Error(`Mission state exceeds the 256 KiB limit (${bytes} bytes; maximum ${MISSION_STATE_MAX_BYTES} bytes).`);
+                writePrivateAtomicJson(filePath, next);
+                values = next;
+                loaded = true;
+            }, lockOptions);
+        },
+    };
+}
+//# sourceMappingURL=workflow-state.js.map

package/src/missions/workflow-state.js.map

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

package/src/policy/authority.d.ts

@@ -0,0 +1,10 @@
+export declare const AUTHORITY_ACTIONS: readonly ["discardWorktree", "destructiveCleanup", "spawnBudgetGrant", "scheduleCreate", "stopRun", "steerRun", "inspectorOpen", "projectOpen"];
+export type AuthorityAction = typeof AUTHORITY_ACTIONS[number];
+export type AuthorityDecision = "auto" | "confirm" | "forbid";
+export type AuthorityPolicyConfig = Partial<Record<AuthorityAction, AuthorityDecision>>;
+export declare function resolveAuthorityDecision(input: {
+    action: AuthorityAction;
+    policy?: AuthorityPolicyConfig;
+}): AuthorityDecision;
+export declare function validateAuthorityPolicy(value: unknown, label?: string): AuthorityPolicyConfig | undefined;
+//# sourceMappingURL=authority.d.ts.map

package/src/policy/authority.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"authority.d.ts","sourceRoot":"","sources":["../../../src/policy/authority.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,iBAAiB,iJASpB,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,OAAO,iBAAiB,CAAC,MAAM,CAAC,CAAC;AAC/D,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,CAAC;AAC9D,MAAM,MAAM,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC,eAAe,EAAE,iBAAiB,CAAC,CAAC,CAAC;AAaxF,wBAAgB,wBAAwB,CAAC,KAAK,EAAE;IAC/C,MAAM,EAAE,eAAe,CAAC;IACxB,MAAM,CAAC,EAAE,qBAAqB,CAAC;CAC/B,GAAG,iBAAiB,CAEpB;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,SAA2B,GAAG,qBAAqB,GAAG,SAAS,CAgB3H"}

package/src/policy/authority.js

@@ -0,0 +1,42 @@
+export const AUTHORITY_ACTIONS = [
+    "discardWorktree",
+    "destructiveCleanup",
+    "spawnBudgetGrant",
+    "scheduleCreate",
+    "stopRun",
+    "steerRun",
+    "inspectorOpen",
+    "projectOpen",
+];
+const DEFAULT_AUTHORITY_POLICY = {
+    discardWorktree: "confirm",
+    destructiveCleanup: "confirm",
+    spawnBudgetGrant: "confirm",
+    scheduleCreate: "auto",
+    stopRun: "auto",
+    steerRun: "auto",
+    inspectorOpen: "auto",
+    projectOpen: "confirm",
+};
+export function resolveAuthorityDecision(input) {
+    return input.policy?.[input.action] ?? DEFAULT_AUTHORITY_POLICY[input.action];
+}
+export function validateAuthorityPolicy(value, label = "config.authorityPolicy") {
+    if (value === undefined)
+        return undefined;
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        throw new Error(`${label} must be a JSON object`);
+    }
+    const policy = value;
+    const allowedActions = new Set(AUTHORITY_ACTIONS);
+    for (const [action, decision] of Object.entries(policy)) {
+        if (!allowedActions.has(action)) {
+            throw new Error(`${label}.${action} is unknown; expected one of ${AUTHORITY_ACTIONS.join(", ")}`);
+        }
+        if (decision !== "auto" && decision !== "confirm" && decision !== "forbid") {
+            throw new Error(`${label}.${action} must be "auto", "confirm", or "forbid"`);
+        }
+    }
+    return policy;
+}
+//# sourceMappingURL=authority.js.map

package/src/policy/authority.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"authority.js","sourceRoot":"","sources":["../../../src/policy/authority.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAChC,iBAAiB;IACjB,oBAAoB;IACpB,kBAAkB;IAClB,gBAAgB;IAChB,SAAS;IACT,UAAU;IACV,eAAe;IACf,aAAa;CACJ,CAAC;AAMX,MAAM,wBAAwB,GAA+C;IAC5E,eAAe,EAAE,SAAS;IAC1B,kBAAkB,EAAE,SAAS;IAC7B,gBAAgB,EAAE,SAAS;IAC3B,cAAc,EAAE,MAAM;IACtB,OAAO,EAAE,MAAM;IACf,QAAQ,EAAE,MAAM;IAChB,aAAa,EAAE,MAAM;IACrB,WAAW,EAAE,SAAS;CACtB,CAAC;AAEF,MAAM,UAAU,wBAAwB,CAAC,KAGxC;IACA,OAAO,KAAK,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,wBAAwB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;AAC/E,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,KAAc,EAAE,KAAK,GAAG,wBAAwB;IACvF,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC1C,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACjE,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,wBAAwB,CAAC,CAAC;IACnD,CAAC;IACD,MAAM,MAAM,GAAG,KAAgC,CAAC;IAChD,MAAM,cAAc,GAAG,IAAI,GAAG,CAAS,iBAAiB,CAAC,CAAC;IAC1D,KAAK,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACzD,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YACjC,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,IAAI,MAAM,gCAAgC,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACnG,CAAC;QACD,IAAI,QAAQ,KAAK,MAAM,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;YAC5E,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,IAAI,MAAM,yCAAyC,CAAC,CAAC;QAC9E,CAAC;IACF,CAAC;IACD,OAAO,MAA+B,CAAC;AACxC,CAAC"}