@pickle-pee/runtime 0.0.0

package/dist/planning/plan-orchestrator.js

@@ -0,0 +1,167 @@
+"use strict";
+/**
+ * Plan orchestration runtime integration.
+ *
+ * Connects the plan engine, path scope checking, stop condition evaluation,
+ * and result aggregation into a single service that enforces all P4 safety
+ * guarantees. This is the runtime integration point — external callers
+ * (CLI commands, plan execution drivers) interact with plans through this.
+ *
+ * Safety guarantees enforced by submitResult():
+ *   1. Boundary check: modifiedPaths are validated against the assigned task's scope
+ *   2. Stop condition check: runtime state is evaluated against stop conditions
+ *   3. Both checks cause auto-fail before completeStep is called
+ *   4. Rework decisions are made automatically for failed steps
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createPlanOrchestrator = createPlanOrchestrator;
+const aggregation_js_1 = require("../subagent/aggregation.js");
+const path_scope_js_1 = require("../subagent/path-scope.js");
+const stop_condition_js_1 = require("../subagent/stop-condition.js");
+const task_validator_js_1 = require("../subagent/task-validator.js");
+const plan_events_js_1 = require("./plan-events.js");
+// ---------------------------------------------------------------------------
+// Factory
+// ---------------------------------------------------------------------------
+function createPlanOrchestrator(engine, sessionBus, globalBus, sessionId) {
+    let activePlan = null;
+    const assignedTasks = new Map();
+    const runtimeStates = new Map();
+    function emit(event) {
+        sessionBus.emit(event);
+        globalBus.emit(event);
+    }
+    function handleStepFailure(plan, stepIndex, reason, result, task) {
+        const step = plan.steps[stepIndex];
+        const decision = (0, aggregation_js_1.decideRework)(task, result, plan.maxReworkAttempts, step.reworkCount);
+        const failed = engine.failStep(plan, stepIndex, result);
+        emit((0, plan_events_js_1.planStepFailed)(sessionId, plan.planId, step.stepId, reason, decision.type === "rework"));
+        if (decision.type === "rework") {
+            emit((0, plan_events_js_1.planRework)(sessionId, plan.planId, step.stepId, step.reworkCount + 1, decision.focusAreas));
+        }
+        // If plan failed entirely, emit plan_completed
+        if (failed.status === "failed") {
+            emit((0, plan_events_js_1.planCompleted)(sessionId, failed.planId, failed.goal, false, engine.summarize(failed)));
+        }
+        activePlan = failed;
+        return failed;
+    }
+    return {
+        get engine() {
+            return engine;
+        },
+        get activePlan() {
+            return activePlan;
+        },
+        createAndActivate(planId, goal, steps) {
+            const draft = engine.createDraft(planId, goal, steps);
+            activePlan = engine.activate(draft);
+            emit((0, plan_events_js_1.planCreated)(sessionId, planId, goal, steps.length));
+            return activePlan;
+        },
+        assignTask(stepIndex, task) {
+            if (!activePlan || activePlan.status !== "active") {
+                throw new Error("No active plan to assign task to");
+            }
+            // Validate the task contract
+            const validation = (0, task_validator_js_1.validateTask)(task);
+            if (!validation.valid) {
+                throw new Error(`Invalid task: ${validation.errors.join("; ")}`);
+            }
+            const step = activePlan.steps[stepIndex];
+            if (!step) {
+                throw new Error(`Step index ${stepIndex} out of range`);
+            }
+            // Start the step
+            activePlan = engine.startStep(activePlan, stepIndex, task.taskId);
+            // Track task and runtime state
+            assignedTasks.set(stepIndex, task);
+            runtimeStates.set(stepIndex, (0, stop_condition_js_1.createInitialRuntimeState)());
+            emit((0, plan_events_js_1.planStepStarted)(sessionId, activePlan.planId, step.stepId, step.description));
+            return activePlan;
+        },
+        submitResult(stepIndex, result) {
+            if (!activePlan || activePlan.status !== "active") {
+                throw new Error("No active plan to submit result to");
+            }
+            const task = assignedTasks.get(stepIndex);
+            if (!task) {
+                throw new Error(`No task assigned to step ${stepIndex}. Call assignTask first.`);
+            }
+            const step = activePlan.steps[stepIndex];
+            if (step.status !== "in_progress") {
+                throw new Error(`Step ${stepIndex} is ${step.status}, expected in_progress`);
+            }
+            if (result.taskId !== task.taskId || result.taskId !== step.taskId) {
+                throw new Error(`Result taskId "${result.taskId}" does not match assigned task "${task.taskId}" for step ${stepIndex}`);
+            }
+            // --- Safety Gate ---
+            if (result.status === "completed") {
+                // 1. Boundary check
+                const boundaryViolations = result.modifiedPaths.filter((p) => (0, path_scope_js_1.wouldViolateBoundary)(task.scope, p));
+                if (boundaryViolations.length > 0) {
+                    const violationResult = {
+                        ...result,
+                        status: "boundary_violation",
+                    };
+                    return handleStepFailure(activePlan, stepIndex, "boundary_violation", violationResult, task);
+                }
+                // 2. Stop condition check
+                let rtState = runtimeStates.get(stepIndex) ?? (0, stop_condition_js_1.createInitialRuntimeState)();
+                for (const p of result.modifiedPaths) {
+                    rtState = (0, stop_condition_js_1.recordModification)(rtState, p);
+                }
+                rtState = {
+                    ...rtState,
+                    elapsedMs: Math.max(rtState.elapsedMs, result.runtime?.elapsedMs ?? 0),
+                    errorCount: rtState.errorCount + Math.max(0, result.runtime?.errorCount ?? 0),
+                    boundaryViolations: rtState.boundaryViolations + Math.max(0, result.runtime?.boundaryViolations ?? 0),
+                };
+                runtimeStates.set(stepIndex, rtState);
+                const stopEval = (0, stop_condition_js_1.evaluateStopConditions)(task.stopConditions, rtState);
+                if (stopEval.triggered) {
+                    const stopResult = {
+                        ...result,
+                        status: "stop_condition_triggered",
+                    };
+                    return handleStepFailure(activePlan, stepIndex, `stop_condition: ${stopEval.triggeredCondition?.type ?? "unknown"}`, stopResult, task);
+                }
+                // 3. All checks passed — complete the step
+                activePlan = engine.completeStep(activePlan, stepIndex, result);
+                emit((0, plan_events_js_1.planStepCompleted)(sessionId, activePlan.planId, step.stepId, true));
+                // 4. Check plan completion
+                if (activePlan.status === "completed") {
+                    emit((0, plan_events_js_1.planCompleted)(sessionId, activePlan.planId, activePlan.goal, true, engine.summarize(activePlan)));
+                }
+                return activePlan;
+            }
+            // Non-completed result → fail
+            return handleStepFailure(activePlan, stepIndex, result.status, result, task);
+        },
+        skipStep(stepIndex) {
+            if (!activePlan) {
+                throw new Error("No active plan");
+            }
+            activePlan = engine.skipStep(activePlan, stepIndex);
+            // Check plan completion after skip
+            if (activePlan.status === "completed") {
+                emit((0, plan_events_js_1.planCompleted)(sessionId, activePlan.planId, activePlan.goal, true, engine.summarize(activePlan)));
+            }
+            return activePlan;
+        },
+        abandonPlan(_reason) {
+            if (!activePlan) {
+                throw new Error("No active plan");
+            }
+            activePlan = engine.abandon(activePlan, "user_abandoned");
+            emit((0, plan_events_js_1.planCompleted)(sessionId, activePlan.planId, activePlan.goal, false, engine.summarize(activePlan)));
+            return activePlan;
+        },
+        summarize() {
+            if (!activePlan)
+                return null;
+            return engine.summarize(activePlan);
+        },
+    };
+}
+//# sourceMappingURL=plan-orchestrator.js.map

package/dist/planning/plan-orchestrator.js.map

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

package/dist/planning/plan-types.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Plan domain types.
+ *
+ * Foundation types for the plan state machine and subagent task orchestration.
+ * The plan engine itself is in plan-engine.ts; event factories are in plan-events.ts.
+ */
+import type { SubagentResult } from "../subagent/result-types.js";
+/** Status of a plan in its lifecycle. */
+export type PlanStatus = "draft" | "active" | "completed" | "failed" | "abandoned";
+/** The reason a plan reached a terminal state, if applicable. */
+export type PlanOutcomeReason = "all_steps_completed" | "step_failed" | "user_abandoned" | "boundary_violation" | "stop_condition_triggered" | "rework_limit_exceeded";
+/** Status of a single plan step. */
+export type PlanStepStatus = "pending" | "in_progress" | "completed" | "failed" | "skipped";
+/** A step in a plan — minimal representation for summaries. */
+export interface PlanStep {
+    readonly stepId: string;
+    readonly description: string;
+    readonly status: PlanStepStatus;
+}
+/** Rich plan step with subagent task linkage. */
+export interface PlanStepDetail extends PlanStep {
+    /** The subagent task this step corresponds to, if dispatched. */
+    readonly taskId?: string;
+    /** The result returned by the subagent, if completed. */
+    readonly result?: SubagentResult;
+    /** Number of rework attempts for this step. */
+    readonly reworkCount: number;
+}
+/** Lightweight plan summary for embedding in session state. */
+export interface PlanSummary {
+    readonly planId: string;
+    readonly goal: string;
+    readonly status: PlanStatus;
+    readonly stepCount: number;
+    readonly completedSteps: number;
+}

package/dist/planning/plan-types.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * Plan domain types.
+ *
+ * Foundation types for the plan state machine and subagent task orchestration.
+ * The plan engine itself is in plan-engine.ts; event factories are in plan-events.ts.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=plan-types.js.map

package/dist/planning/plan-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-types.js","sourceRoot":"","sources":["../../src/planning/plan-types.ts"],"names":[],"mappings":";AAAA;;;;;GAKG"}

package/dist/runtime-context.d.ts

@@ -0,0 +1,21 @@
+/**
+ * RuntimeContext factory and helpers.
+ *
+ * RuntimeContext is an immutable value object that holds the execution context
+ * available to all runtime consumers. State changes produce new instances.
+ */
+import type { CliMode, ModelDescriptor, RuntimeContext, SessionId, TaskState, ToolSetDescriptor } from "./types/index.js";
+export interface RuntimeContextParams {
+    readonly sessionId: SessionId;
+    readonly workingDirectory: string;
+    readonly agentDir?: string;
+    readonly configSources?: Readonly<Record<string, {
+        layer: string;
+        detail: string;
+    }>>;
+    readonly mode: CliMode;
+    readonly model: ModelDescriptor;
+    readonly toolSet: ToolSetDescriptor;
+}
+export declare function createRuntimeContext(params: RuntimeContextParams): RuntimeContext;
+export declare function updateTaskState(context: RuntimeContext, taskState: TaskState): RuntimeContext;

package/dist/runtime-context.js

@@ -0,0 +1,37 @@
+"use strict";
+/**
+ * RuntimeContext factory and helpers.
+ *
+ * RuntimeContext is an immutable value object that holds the execution context
+ * available to all runtime consumers. State changes produce new instances.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createRuntimeContext = createRuntimeContext;
+exports.updateTaskState = updateTaskState;
+// ---------------------------------------------------------------------------
+// Factory
+// ---------------------------------------------------------------------------
+const IDLE_TASK = {
+    status: "idle",
+    currentTaskId: null,
+    startedAt: null,
+};
+function createRuntimeContext(params) {
+    return {
+        sessionId: params.sessionId,
+        workingDirectory: params.workingDirectory,
+        agentDir: params.agentDir,
+        configSources: params.configSources,
+        mode: params.mode,
+        model: params.model,
+        toolSet: params.toolSet,
+        taskState: IDLE_TASK,
+    };
+}
+// ---------------------------------------------------------------------------
+// Updaters — return new instances
+// ---------------------------------------------------------------------------
+function updateTaskState(context, taskState) {
+    return { ...context, taskState };
+}
+//# sourceMappingURL=runtime-context.js.map

package/dist/runtime-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-context.js","sourceRoot":"","sources":["../src/runtime-context.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AAmCH,oDAWC;AAMD,0CAEC;AA7BD,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E,MAAM,SAAS,GAAc;IAC5B,MAAM,EAAE,MAAM;IACd,aAAa,EAAE,IAAI;IACnB,SAAS,EAAE,IAAI;CACN,CAAC;AAEX,SAAgB,oBAAoB,CAAC,MAA4B;IAChE,OAAO;QACN,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;QACzC,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,aAAa,EAAE,MAAM,CAAC,aAAa;QACnC,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,SAAS,EAAE,SAAS;KACpB,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,kCAAkC;AAClC,8EAA8E;AAE9E,SAAgB,eAAe,CAAC,OAAuB,EAAE,SAAoB;IAC5E,OAAO,EAAE,GAAG,OAAO,EAAE,SAAS,EAAE,CAAC;AAClC,CAAC"}

package/dist/services/event-normalizer.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Translates raw upstream events into standardized product-layer RuntimeEvents.
+ *
+ * This is the single point of translation. Unrecognized raw events return `null`
+ * and are silently dropped — they are never leaked to consumers.
+ *
+ * The mapping table is a P2 skeleton. It will be refined when pi-mono is
+ * integrated and the actual upstream event types are known.
+ */
+import type { RawUpstreamEvent } from "../adapters/kernel-session-adapter.js";
+import type { RuntimeEvent } from "../events/runtime-event.js";
+import type { SessionId } from "../types/index.js";
+export declare class EventNormalizer {
+    private readonly sessionId;
+    constructor(sessionId: SessionId);
+    /**
+     * Map a raw upstream event to a product-layer RuntimeEvent.
+     *
+     * Returns `null` for unrecognized events (they are silently dropped).
+     */
+    normalize(raw: RawUpstreamEvent): RuntimeEvent | null;
+}

package/dist/services/event-normalizer.js

@@ -0,0 +1,162 @@
+"use strict";
+/**
+ * Translates raw upstream events into standardized product-layer RuntimeEvents.
+ *
+ * This is the single point of translation. Unrecognized raw events return `null`
+ * and are silently dropped — they are never leaked to consumers.
+ *
+ * The mapping table is a P2 skeleton. It will be refined when pi-mono is
+ * integrated and the actual upstream event types are known.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EventNormalizer = void 0;
+const session_events_js_1 = require("../session/session-events.js");
+class EventNormalizer {
+    sessionId;
+    constructor(sessionId) {
+        this.sessionId = sessionId;
+    }
+    /**
+     * Map a raw upstream event to a product-layer RuntimeEvent.
+     *
+     * Returns `null` for unrecognized events (they are silently dropped).
+     */
+    normalize(raw) {
+        const base = {
+            id: (0, session_events_js_1.generateEventId)(),
+            timestamp: raw.timestamp,
+            sessionId: this.sessionId,
+        };
+        switch (raw.type) {
+            // -- Session lifecycle --
+            case "agent_start":
+                return {
+                    ...base,
+                    category: "session",
+                    type: "session_created",
+                    model: raw.payload?.model ?? {
+                        id: "unknown",
+                        provider: "unknown",
+                    },
+                    toolSet: raw.payload?.toolSet ?? [],
+                };
+            case "agent_end":
+                return {
+                    ...base,
+                    category: "session",
+                    type: "session_closed",
+                    recoveryData: {
+                        sessionId: this.sessionId,
+                        model: { id: "unknown", provider: "unknown" },
+                        toolSet: [],
+                        planSummary: null,
+                        compactionSummary: null,
+                        taskState: { status: "idle", currentTaskId: null, startedAt: null },
+                    },
+                };
+            // -- Tool execution --
+            case "tool_execution_start":
+                return {
+                    ...base,
+                    category: "tool",
+                    type: "tool_started",
+                    toolName: raw.payload?.toolName ?? "unknown",
+                    toolCallId: raw.payload?.toolCallId ?? "",
+                    parameters: raw.payload?.parameters ?? {},
+                };
+            case "tool_execution_update":
+                return {
+                    ...base,
+                    category: "tool",
+                    type: "tool_update",
+                    toolName: raw.payload?.toolName ?? "unknown",
+                    toolCallId: raw.payload?.toolCallId ?? "",
+                    update: raw.payload?.update ?? "",
+                };
+            case "tool_execution_end": {
+                const status = raw.payload?.status ?? "success";
+                return {
+                    ...base,
+                    category: "tool",
+                    type: "tool_completed",
+                    toolName: raw.payload?.toolName ?? "unknown",
+                    toolCallId: raw.payload?.toolCallId ?? "",
+                    status,
+                    result: raw.payload?.result,
+                    durationMs: raw.payload?.durationMs ?? 0,
+                };
+            }
+            case "tool_execution_denied":
+                return {
+                    ...base,
+                    category: "tool",
+                    type: "tool_denied",
+                    toolName: raw.payload?.toolName ?? "unknown",
+                    toolCallId: raw.payload?.toolCallId ?? "",
+                    reason: raw.payload?.reason ?? "Tool execution denied",
+                };
+            // -- Compaction --
+            case "compaction_start":
+                return {
+                    ...base,
+                    category: "compaction",
+                    type: "compaction_started",
+                };
+            case "compaction_end":
+                return {
+                    ...base,
+                    category: "compaction",
+                    type: "compaction_completed",
+                    summary: {
+                        compressedAt: raw.timestamp,
+                        originalMessageCount: raw.payload?.originalMessageCount ?? 0,
+                        retainedMessageCount: raw.payload?.retainedMessageCount ?? 0,
+                        estimatedTokensSaved: raw.payload?.estimatedTokensSaved ?? 0,
+                    },
+                };
+            // -- Text stream --
+            case "message_update": {
+                const kind = raw.payload?.kind;
+                if (kind === "thinking") {
+                    return {
+                        ...base,
+                        category: "text",
+                        type: "thinking_delta",
+                        content: raw.payload?.content ?? "",
+                    };
+                }
+                return {
+                    ...base,
+                    category: "text",
+                    type: "text_delta",
+                    content: raw.payload?.content ?? "",
+                };
+            }
+            // -- Permission --
+            case "permission_request":
+                return {
+                    ...base,
+                    category: "permission",
+                    type: "permission_requested",
+                    toolName: raw.payload?.toolName ?? "unknown",
+                    toolCallId: raw.payload?.toolCallId ?? "",
+                    riskLevel: raw.payload?.riskLevel ?? "L0",
+                    reason: raw.payload?.reason,
+                    targetPath: raw.payload?.targetPath,
+                };
+            case "permission_resolve":
+                return {
+                    ...base,
+                    category: "permission",
+                    type: "permission_resolved",
+                    toolName: raw.payload?.toolName ?? "unknown",
+                    toolCallId: raw.payload?.toolCallId ?? "",
+                    decision: raw.payload?.decision ?? "deny",
+                };
+            default:
+                return null;
+        }
+    }
+}
+exports.EventNormalizer = EventNormalizer;
+//# sourceMappingURL=event-normalizer.js.map

package/dist/services/event-normalizer.js.map

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

package/dist/services/index.d.ts

@@ -0,0 +1 @@
+export { EventNormalizer } from "./event-normalizer.js";

package/dist/services/index.js

@@ -0,0 +1,7 @@
+"use strict";
+// services/ — Business logic combining domain models and adapters.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EventNormalizer = void 0;
+var event_normalizer_js_1 = require("./event-normalizer.js");
+Object.defineProperty(exports, "EventNormalizer", { enumerable: true, get: function () { return event_normalizer_js_1.EventNormalizer; } });
+//# sourceMappingURL=index.js.map

package/dist/services/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":";AAAA,mEAAmE;;;AAEnE,6DAAwD;AAA/C,sHAAA,eAAe,OAAA"}

package/dist/session/session-events.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Factory functions for session lifecycle events.
+ *
+ * Auto-fills `id` and `timestamp` so callers don't repeat boilerplate.
+ */
+import type { SessionClosedEvent, SessionCreatedEvent, SessionResumedEvent } from "../events/runtime-event.js";
+import type { ModelDescriptor, SessionId, SessionRecoveryData } from "../types/index.js";
+export declare function generateEventId(): string;
+export declare function sessionCreated(sessionId: SessionId, model: ModelDescriptor, toolSet: readonly string[]): SessionCreatedEvent;
+export declare function sessionResumed(sessionId: SessionId, recoveryData: SessionRecoveryData): SessionResumedEvent;
+export declare function sessionClosed(sessionId: SessionId, recoveryData: SessionRecoveryData): SessionClosedEvent;

package/dist/session/session-events.js

@@ -0,0 +1,52 @@
+"use strict";
+/**
+ * Factory functions for session lifecycle events.
+ *
+ * Auto-fills `id` and `timestamp` so callers don't repeat boilerplate.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateEventId = generateEventId;
+exports.sessionCreated = sessionCreated;
+exports.sessionResumed = sessionResumed;
+exports.sessionClosed = sessionClosed;
+// ---------------------------------------------------------------------------
+// ID generation
+// ---------------------------------------------------------------------------
+function generateEventId() {
+    return crypto.randomUUID();
+}
+// ---------------------------------------------------------------------------
+// Event factories
+// ---------------------------------------------------------------------------
+function sessionCreated(sessionId, model, toolSet) {
+    return {
+        id: generateEventId(),
+        timestamp: Date.now(),
+        sessionId,
+        category: "session",
+        type: "session_created",
+        model,
+        toolSet,
+    };
+}
+function sessionResumed(sessionId, recoveryData) {
+    return {
+        id: generateEventId(),
+        timestamp: Date.now(),
+        sessionId,
+        category: "session",
+        type: "session_resumed",
+        recoveryData,
+    };
+}
+function sessionClosed(sessionId, recoveryData) {
+    return {
+        id: generateEventId(),
+        timestamp: Date.now(),
+        sessionId,
+        category: "session",
+        type: "session_closed",
+        recoveryData,
+    };
+}
+//# sourceMappingURL=session-events.js.map

package/dist/session/session-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-events.js","sourceRoot":"","sources":["../../src/session/session-events.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;AASH,0CAEC;AAMD,wCAcC;AAED,wCASC;AAED,sCASC;AAhDD,8EAA8E;AAC9E,gBAAgB;AAChB,8EAA8E;AAE9E,SAAgB,eAAe;IAC9B,OAAO,MAAM,CAAC,UAAU,EAAE,CAAC;AAC5B,CAAC;AAED,8EAA8E;AAC9E,kBAAkB;AAClB,8EAA8E;AAE9E,SAAgB,cAAc,CAC7B,SAAoB,EACpB,KAAsB,EACtB,OAA0B;IAE1B,OAAO;QACN,EAAE,EAAE,eAAe,EAAE;QACrB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;QACrB,SAAS;QACT,QAAQ,EAAE,SAAS;QACnB,IAAI,EAAE,iBAAiB;QACvB,KAAK;QACL,OAAO;KACP,CAAC;AACH,CAAC;AAED,SAAgB,cAAc,CAAC,SAAoB,EAAE,YAAiC;IACrF,OAAO;QACN,EAAE,EAAE,eAAe,EAAE;QACrB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;QACrB,SAAS;QACT,QAAQ,EAAE,SAAS;QACnB,IAAI,EAAE,iBAAiB;QACvB,YAAY;KACZ,CAAC;AACH,CAAC;AAED,SAAgB,aAAa,CAAC,SAAoB,EAAE,YAAiC;IACpF,OAAO;QACN,EAAE,EAAE,eAAe,EAAE;QACrB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;QACrB,SAAS;QACT,QAAQ,EAAE,SAAS;QACnB,IAAI,EAAE,gBAAgB;QACtB,YAAY;KACZ,CAAC;AACH,CAAC"}