pi-harness-runtime 0.9.4 → 0.9.6

package/packages/codex-adapter/src/provider.ts

@@ -0,0 +1,213 @@
+/**
+ * Codex Adapter — Provider (RFC-0070)
+ */
+
+import type { CodexConfig, CodexOptions, CodexResponse } from "./types.js";
+import { DEFAULT_TOOLS } from "./types.js";
+
+export { DEFAULT_TOOLS };
+
+/**
+ * OpenAI Codex Provider for pi-harness
+ */
+export class CodexProvider {
+	readonly id = "codex";
+	readonly name = "OpenAI Codex";
+
+	readonly provider = {
+		complete: (prompt: string, options?: unknown) =>
+			this.complete(prompt, options as CodexOptions),
+		stream: undefined,
+		embed: undefined,
+	};
+
+	private apiKey: string;
+	private cfg: Required<Omit<CodexConfig, "apiKey">>;
+
+	constructor(config: CodexConfig) {
+		if (!config.apiKey?.trim()) {
+			throw new Error("CodexProvider requires an API key");
+		}
+		this.apiKey = config.apiKey;
+		this.cfg = {
+			model: config.model ?? "gpt-4o",
+			baseUrl: config.baseUrl ?? "https://api.openai.com/v1",
+			maxTokens: config.maxTokens ?? 8192,
+			temperature: config.temperature ?? 0.7,
+			timeout: config.timeout ?? 60000,
+		};
+	}
+
+	async complete(
+		prompt: string,
+		options?: CodexOptions,
+	): Promise<CodexResponse> {
+		const model = options?.model ?? this.cfg.model;
+		const maxTokens = options?.maxTokens ?? this.cfg.maxTokens;
+		const temperature = options?.temperature ?? this.cfg.temperature;
+		const tools = options?.tools ?? DEFAULT_TOOLS;
+
+		const body: Record<string, unknown> = {
+			model,
+			messages: [{ role: "user", content: prompt }],
+			max_tokens: maxTokens,
+			temperature,
+		};
+
+		if (tools.length > 0) {
+			body.tools = tools;
+			body.tool_choice = options?.toolChoice ?? "auto";
+		}
+
+		const response = await fetch(`${this.cfg.baseUrl}/chat/completions`, {
+			method: "POST",
+			headers: {
+				"Content-Type": "application/json",
+				Authorization: `Bearer ${this.apiKey}`,
+			},
+			body: JSON.stringify(body),
+			signal: AbortSignal.timeout(this.cfg.timeout),
+		});
+
+		if (!response.ok) {
+			const text = await response.text();
+			throw new Error(`OpenAI API error ${response.status}: ${text}`);
+		}
+
+		const data = (await response.json()) as {
+			choices: Array<{
+				message: {
+					content: string | null;
+					tool_calls?: Array<{ function: { name: string; arguments: string } }>;
+				};
+				finish_reason: string;
+			}>;
+			usage?: {
+				prompt_tokens: number;
+				completion_tokens: number;
+				total_tokens: number;
+			};
+		};
+
+		const choice = data.choices[0];
+		let content = choice.message.content ?? "";
+
+		if (choice.message.tool_calls && choice.message.tool_calls.length > 0) {
+			content +=
+				"\n\n[Tool calls: " +
+				choice.message.tool_calls
+					.map((tc) => `${tc.function.name}(${tc.function.arguments})`)
+					.join(", ") +
+				"]";
+		}
+
+		return {
+			content,
+			finishReason: choice.finish_reason,
+			usage: data.usage
+				? {
+						inputTokens: data.usage.prompt_tokens,
+						outputTokens: data.usage.completion_tokens,
+						totalTokens: data.usage.total_tokens,
+					}
+				: undefined,
+		};
+	}
+
+	async *stream(
+		prompt: string,
+		options?: CodexOptions,
+	): AsyncGenerator<string> {
+		const model = options?.model ?? this.cfg.model;
+		const maxTokens = options?.maxTokens ?? this.cfg.maxTokens;
+		const temperature = options?.temperature ?? this.cfg.temperature;
+		const tools = options?.tools ?? DEFAULT_TOOLS;
+
+		const body: Record<string, unknown> = {
+			model,
+			messages: [{ role: "user", content: prompt }],
+			max_tokens: maxTokens,
+			temperature,
+			stream: true,
+		};
+
+		if (tools.length > 0) {
+			body.tools = tools;
+			body.tool_choice = options?.toolChoice ?? "auto";
+		}
+
+		const response = await fetch(`${this.cfg.baseUrl}/chat/completions`, {
+			method: "POST",
+			headers: {
+				"Content-Type": "application/json",
+				Authorization: `Bearer ${this.apiKey}`,
+			},
+			body: JSON.stringify(body),
+			signal: AbortSignal.timeout(this.cfg.timeout),
+		});
+
+		if (!response.ok) {
+			const text = await response.text();
+			throw new Error(`OpenAI API error ${response.status}: ${text}`);
+		}
+
+		if (!response.body) throw new Error("No response body");
+
+		const reader = response.body.getReader();
+		const decoder = new TextDecoder();
+		let buffer = "";
+
+		try {
+			while (true) {
+				const { done, value } = await reader.read();
+				if (done) break;
+				buffer += decoder.decode(value, { stream: true });
+				const lines = buffer.split("\n");
+				buffer = lines.pop() ?? "";
+				for (const line of lines) {
+					if (line.startsWith("data: ")) {
+						const raw = line.slice(6);
+						if (raw === "[DONE]") continue;
+						try {
+							const chunk = JSON.parse(raw) as {
+								choices: Array<{ delta: { content?: string } }>;
+							};
+							if (chunk.choices[0]?.delta?.content) {
+								yield chunk.choices[0].delta.content;
+							}
+						} catch {
+							// ignore parse errors
+						}
+					}
+				}
+			}
+		} finally {
+			reader.releaseLock();
+		}
+	}
+
+	async healthCheck(): Promise<boolean> {
+		try {
+			const response = await fetch(`${this.cfg.baseUrl}/models`, {
+				headers: { Authorization: `Bearer ${this.apiKey}` },
+				signal: AbortSignal.timeout(10000),
+			});
+			return response.ok;
+		} catch {
+			return false;
+		}
+	}
+
+	estimateCost(inputTokens: number, outputTokens: number): number {
+		const pricing: Record<string, { input: number; output: number }> = {
+			"gpt-4o": { input: 2.5, output: 10.0 },
+			o3: { input: 10.0, output: 40.0 },
+			"o4-mini": { input: 1.0, output: 4.0 },
+		};
+		const p = pricing[this.cfg.model] ?? pricing["gpt-4o"];
+		return (
+			(inputTokens / 1_000_000) * p.input +
+			(outputTokens / 1_000_000) * p.output
+		);
+	}
+}

package/packages/codex-adapter/src/types.ts

@@ -0,0 +1,118 @@
+/**
+ * Codex Adapter — Types (RFC-0070)
+ */
+
+export type CodexModel = "gpt-4o" | "o3" | "o4-mini";
+
+export interface CodexConfig {
+	apiKey: string;
+	model?: CodexModel;
+	baseUrl?: string;
+	maxTokens?: number;
+	temperature?: number;
+	timeout?: number;
+}
+
+export interface CodexOptions {
+	model?: CodexModel;
+	maxTokens?: number;
+	temperature?: number;
+	tools?: CodexTool[];
+	toolChoice?: "auto" | "none";
+}
+
+export interface CodexTool {
+	type: "function";
+	name: string;
+	description: string;
+	parameters: {
+		type: "object";
+		properties: Record<string, unknown>;
+		required?: string[];
+	};
+}
+
+export interface CodexResponse {
+	content: string;
+	finishReason: string;
+	usage?: {
+		inputTokens: number;
+		outputTokens: number;
+		totalTokens: number;
+	};
+}
+
+export interface ExecutionResult {
+	stdout: string;
+	stderr: string;
+	exitCode: number;
+	durationMs: number;
+}
+
+export interface ExecutionConfig {
+	timeout?: number;
+	memoryLimitMB?: number;
+	cwd?: string;
+	env?: Record<string, string>;
+}
+
+// Default Codex tools
+export const DEFAULT_TOOLS: CodexTool[] = [
+	{
+		type: "function",
+		name: "Read",
+		description: "Read the complete contents of a file from the filesystem",
+		parameters: {
+			type: "object",
+			properties: {
+				path: { type: "string", description: "Absolute path to the file" },
+			},
+			required: ["path"],
+		},
+	},
+	{
+		type: "function",
+		name: "Write",
+		description: "Write content to a file, creating directories if needed",
+		parameters: {
+			type: "object",
+			properties: {
+				path: { type: "string", description: "Absolute path to write to" },
+				content: { type: "string", description: "Content to write" },
+			},
+			required: ["path", "content"],
+		},
+	},
+	{
+		type: "function",
+		name: "Bash",
+		description: "Execute a shell command in a sandboxed environment",
+		parameters: {
+			type: "object",
+			properties: {
+				command: { type: "string", description: "Shell command to execute" },
+				timeout: {
+					type: "number",
+					description: "Max execution time in seconds",
+				},
+			},
+			required: ["command"],
+		},
+	},
+	{
+		type: "function",
+		name: "WebSearch",
+		description: "Search the web for information",
+		parameters: {
+			type: "object",
+			properties: {
+				query: { type: "string", description: "Search query" },
+				max_results: {
+					type: "number",
+					description: "Max results (default: 5)",
+				},
+			},
+			required: ["query"],
+		},
+	},
+];

package/packages/codex-adapter/test/provider.test.ts

@@ -0,0 +1,142 @@
+/**
+ * Codex Adapter Tests (RFC-0070)
+ */
+
+import { describe, it, expect } from "bun:test";
+import { CodexProvider } from "../src/provider.js";
+import { ExecutionSandbox } from "../src/executor.js";
+import { DEFAULT_TOOLS } from "../src/types.js";
+
+describe("CodexProvider", () => {
+	it("creates provider with API key", () => {
+		const provider = new CodexProvider({ apiKey: "sk-test-key" });
+		expect(provider.id).toBe("codex");
+		expect(provider.name).toBe("OpenAI Codex");
+		expect(provider.provider).toBeDefined();
+	});
+
+	it("creates provider with custom config", () => {
+		const provider = new CodexProvider({
+			apiKey: "sk-test",
+			model: "o3",
+			maxTokens: 4096,
+			temperature: 0.5,
+		});
+		expect(provider).toBeDefined();
+	});
+
+	it("throws without API key", () => {
+		expect(() => new CodexProvider({ apiKey: "" })).toThrow();
+		expect(() => new CodexProvider({ apiKey: "   " })).toThrow();
+	});
+
+	it("healthCheck returns false for invalid key", async () => {
+		const provider = new CodexProvider({
+			apiKey: "sk-invalid-key-for-health-check-test",
+			timeout: 5000,
+		});
+		const healthy = await provider.healthCheck();
+		expect(healthy).toBe(false);
+	});
+
+	it("estimateCost calculates correctly for gpt-4o", () => {
+		const provider = new CodexProvider({ apiKey: "sk-test" });
+		const cost = provider.estimateCost(1000, 500);
+		// gpt-4o: 1000/1M * $2.5 + 500/1M * $10 = $0.0025 + $0.005 = $0.0075
+		expect(cost).toBeCloseTo(0.0075, 4);
+	});
+
+	it("estimateCost calculates correctly for o4-mini", () => {
+		const provider = new CodexProvider({ apiKey: "sk-test", model: "o4-mini" });
+		const cost = provider.estimateCost(1000, 500);
+		// o4-mini: 1000/1M * $1 + 500/1M * $4 = $0.001 + $0.002 = $0.003
+		expect(cost).toBeCloseTo(0.003, 4);
+	});
+});
+
+describe("DEFAULT_TOOLS", () => {
+	it("has 4 default tools", () => {
+		expect(DEFAULT_TOOLS).toHaveLength(4);
+		const names = DEFAULT_TOOLS.map((t) => t.name);
+		expect(names).toContain("Read");
+		expect(names).toContain("Write");
+		expect(names).toContain("Bash");
+		expect(names).toContain("WebSearch");
+	});
+
+	it("all tools have required fields", () => {
+		for (const tool of DEFAULT_TOOLS) {
+			expect(tool.type).toBe("function");
+			expect(typeof tool.name).toBe("string");
+			expect(typeof tool.description).toBe("string");
+			expect(tool.parameters).toBeDefined();
+			expect(tool.parameters.type).toBe("object");
+		}
+	});
+});
+
+describe("ExecutionSandbox", () => {
+	it("creates sandbox with defaults", () => {
+		const sandbox = new ExecutionSandbox();
+		expect(sandbox).toBeDefined();
+	});
+
+	it("creates sandbox with custom config", () => {
+		const sandbox = new ExecutionSandbox({
+			timeout: 10000,
+			memoryLimitMB: 256,
+			cwd: "/tmp",
+			env: { TEST: "1" },
+		});
+		expect(sandbox).toBeDefined();
+	});
+
+	it("executes echo command", async () => {
+		const sandbox = new ExecutionSandbox({ timeout: 5000 });
+		const result = await sandbox.execute("echo 'hello world'");
+		expect(result.exitCode).toBe(0);
+		expect(result.stdout.trim()).toBe("hello world");
+		expect(result.durationMs).toBeGreaterThan(0);
+		expect(result.durationMs).toBeLessThan(5000);
+	});
+
+	it("captures stderr", async () => {
+		const sandbox = new ExecutionSandbox({ timeout: 5000 });
+		const result = await sandbox.execute("echo 'error' >&2");
+		expect(result.stderr.trim()).toBe("error");
+	});
+
+	it("handles non-zero exit code", async () => {
+		const sandbox = new ExecutionSandbox({ timeout: 5000 });
+		const result = await sandbox.execute("exit 42");
+		expect(result.exitCode).toBe(42);
+	});
+
+	it("executeCode runs python", async () => {
+		const sandbox = new ExecutionSandbox({ timeout: 5000 });
+		const result = await sandbox.executeCode("print(2 + 2)", "python");
+		expect(result.exitCode).toBe(0);
+		expect(result.stdout.trim()).toBe("4");
+	});
+
+	it("executeCode runs javascript", async () => {
+		const sandbox = new ExecutionSandbox({ timeout: 5000 });
+		const result = await sandbox.executeCode(
+			"console.log(2 + 2)",
+			"javascript",
+		);
+		expect(result.exitCode).toBe(0);
+		expect(result.stdout.trim()).toBe("4");
+	});
+
+	it(
+		"respects timeout",
+		async () => {
+			const sandbox = new ExecutionSandbox({ timeout: 500 });
+			const result = await sandbox.execute("sleep 5");
+			expect(result.exitCode).toBe(-1);
+			expect(result.durationMs).toBeGreaterThan(400);
+		},
+		{ timeout: 10000 },
+	);
+});

package/packages/codex-adapter/tsconfig.json

@@ -0,0 +1,5 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": { "outDir": "dist", "rootDir": "src", "types": ["node"] },
+  "include": ["src/**/*"]
+}

package/packages/context-compiler/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/context-compiler",
-  "version": "0.9.4",
+  "version": "0.9.6",
   "description": "Bounded context selection engine for pi-harness-runtime",
   "type": "module",
   "main": "./dist/index.js",

package/packages/context-manager/dist/compaction.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Context Manager — Compaction Engine (RFC-0010)
+ */
+import type { ContextItem, CompactionResult, ResumePrompt, TriggerPolicy } from "./types.js";
+/** Compact context by extracting durable state and keeping high-priority items. */
+export declare function compactContext(messages: ContextItem[], maxTokens: number, policy?: TriggerPolicy): CompactionResult;
+/** Generate a resume prompt from compaction result. */
+export declare function generateResumePrompt(result: CompactionResult, nextAction?: string): ResumePrompt;
+/** Format resume prompt as markdown string. */
+export declare function formatResumeMarkdown(prompt: ResumePrompt): string;
+//# sourceMappingURL=compaction.d.ts.map

package/packages/context-manager/dist/compaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compaction.d.ts","sourceRoot":"","sources":["../src/compaction.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACX,WAAW,EACX,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACb,MAAM,YAAY,CAAC;AAuDpB,mFAAmF;AACnF,wBAAgB,cAAc,CAC7B,QAAQ,EAAE,WAAW,EAAE,EACvB,SAAS,EAAE,MAAM,EACjB,MAAM,GAAE,aAA8B,GACpC,gBAAgB,CA0BlB;AAED,uDAAuD;AACvD,wBAAgB,oBAAoB,CACnC,MAAM,EAAE,gBAAgB,EACxB,UAAU,CAAC,EAAE,MAAM,GACjB,YAAY,CAed;AAED,+CAA+C;AAC/C,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAmBjE"}

package/packages/context-manager/dist/compaction.js

@@ -0,0 +1,110 @@
+/**
+ * Context Manager — Compaction Engine (RFC-0010)
+ */
+import { DEFAULT_POLICY } from "./core.js";
+import { prioritize } from "./core.js";
+/** Extract decisions from messages (lines starting with DECISION markers). */
+function extractDecisions(messages) {
+    const decisions = [];
+    for (const msg of messages) {
+        for (const line of msg.content.split("\n")) {
+            const trimmed = line.trim();
+            if (trimmed.startsWith("- DECISION:") ||
+                trimmed.startsWith("**DECISION**") ||
+                /^(?:decision|decided):/i.test(trimmed)) {
+                decisions.push(trimmed.replace(/^[*>-]+\s*/i, "").trim());
+            }
+        }
+    }
+    return [...new Set(decisions)];
+}
+/** Extract open questions (lines with ?, TODO, TBD, OPEN markers). */
+function extractQuestions(messages) {
+    const questions = [];
+    for (const msg of messages) {
+        for (const line of msg.content.split("\n")) {
+            const trimmed = line.trim();
+            if (trimmed.includes("?") ||
+                /\bTODO\b/i.test(trimmed) ||
+                /\bTBD\b/i.test(trimmed)) {
+                const cleaned = trimmed.replace(/^[*>-]+\s*/, "").trim();
+                if (cleaned.length > 5)
+                    questions.push(cleaned);
+            }
+        }
+    }
+    return [...new Set(questions)];
+}
+/** Extract task progress from messages. */
+function extractTaskProgress(messages) {
+    const progress = {};
+    for (const msg of messages) {
+        for (const line of msg.content.split("\n")) {
+            const match = line.match(/^(?:progress|task|step)[:\s]+([^|]+)\|\s*(.+)/i);
+            if (match)
+                progress[match[1].trim()] = match[2].trim();
+        }
+    }
+    return progress;
+}
+/** Compact context by extracting durable state and keeping high-priority items. */
+export function compactContext(messages, maxTokens, policy = DEFAULT_POLICY) {
+    const decisions = extractDecisions(messages);
+    const openQuestions = extractQuestions(messages);
+    const taskProgress = extractTaskProgress(messages);
+    const prioritized = prioritize(messages, Math.floor(messages.length * 0.6));
+    let tokenCount = 0;
+    const kept = [];
+    for (const msg of prioritized) {
+        if (tokenCount + msg.tokens <=
+            Math.floor(maxTokens * policy.compactThreshold)) {
+            kept.push(msg.content);
+            tokenCount += msg.tokens;
+        }
+    }
+    return {
+        decisions,
+        openQuestions,
+        taskProgress,
+        remainingTokens: tokenCount,
+        compactedContent: kept.join("\n\n"),
+    };
+}
+/** Generate a resume prompt from compaction result. */
+export function generateResumePrompt(result, nextAction) {
+    const summary = [
+        "## Session Summary",
+        `Decisions: ${result.decisions.length > 0 ? result.decisions.join("; ") : "none"}`,
+        `Questions: ${result.openQuestions.length > 0 ? result.openQuestions.join("; ") : "none"}`,
+        `Context size: ${result.remainingTokens} tokens`,
+    ].join("\n");
+    return {
+        summary,
+        decisions: result.decisions,
+        openQuestions: result.openQuestions,
+        taskProgress: result.taskProgress,
+        nextAction: nextAction ?? "Continue from last position",
+    };
+}
+/** Format resume prompt as markdown string. */
+export function formatResumeMarkdown(prompt) {
+    const lines = [
+        "# Resume Prompt",
+        "",
+        prompt.summary,
+        "",
+        "## Decisions",
+        ...prompt.decisions.map((d) => `- ${d}`),
+        "",
+        "## Open Questions",
+        ...prompt.openQuestions.map((q) => `- ${q}`),
+        "",
+        "## Task Progress",
+        ...Object.entries(prompt.taskProgress).map(([k, v]) => `- **${k}**: ${v}`),
+        "",
+        "## Next Action",
+        `- ${prompt.nextAction}`,
+    ];
+    return lines.filter((l) => l).join("\n");
+}
+//# sourceMappingURL=compaction.js.map

package/packages/context-manager/dist/compaction.js.map

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

package/packages/context-manager/dist/core.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Context Manager Core — pressure estimation, TTL, prioritization (RFC-0010)
+ */
+import type { PressureLevel, TriggerPolicy, ContextItem, SessionScope } from "./types.js";
+export declare const DEFAULT_POLICY: TriggerPolicy;
+/** Estimate context pressure as a ratio (0-1). */
+export declare function estimatePressure(currentTokens: number, maxTokens: number): number;
+/** Determine pressure level from a ratio. */
+export declare function getPressureLevel(pressure: number, policy?: TriggerPolicy): PressureLevel;
+/** Create a new session-scoped context bucket. */
+export declare function createSessionScope(id: string): SessionScope;
+/** Set TTL on a scope (in milliseconds). */
+export declare function setTTL(scope: SessionScope, ttlMs: number): SessionScope;
+/** Add an item to a session scope. */
+export declare function addToScope(scope: SessionScope, item: ContextItem): SessionScope;
+/** Remove expired items from a scope based on TTL. */
+export declare function evictExpired(scope: SessionScope): SessionScope;
+/** Prioritize items: lower priority number = higher importance. */
+export declare function prioritize(items: ContextItem[], limit?: number): ContextItem[];
+/** Count tokens using a simple word-based estimator (4 chars/token). */
+export declare function estimateTokens(text: string): number;
+/** Calculate total tokens in a list of items. */
+export declare function calculateTotalTokens(items: ContextItem[]): number;
+//# sourceMappingURL=core.d.ts.map

package/packages/context-manager/dist/core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACX,aAAa,EACb,aAAa,EACb,WAAW,EACX,YAAY,EACZ,MAAM,YAAY,CAAC;AAEpB,eAAO,MAAM,cAAc,EAAE,aAI5B,CAAC;AAEF,kDAAkD;AAClD,wBAAgB,gBAAgB,CAC/B,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,MAAM,GACf,MAAM,CAGR;AAED,6CAA6C;AAC7C,wBAAgB,gBAAgB,CAC/B,QAAQ,EAAE,MAAM,EAChB,MAAM,GAAE,aAA8B,GACpC,aAAa,CAKf;AAED,kDAAkD;AAClD,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,CAE3D;AAED,4CAA4C;AAC5C,wBAAgB,MAAM,CAAC,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,GAAG,YAAY,CAEvE;AAED,sCAAsC;AACtC,wBAAgB,UAAU,CACzB,KAAK,EAAE,YAAY,EACnB,IAAI,EAAE,WAAW,GACf,YAAY,CAEd;AAED,sDAAsD;AACtD,wBAAgB,YAAY,CAAC,KAAK,EAAE,YAAY,GAAG,YAAY,CAS9D;AAED,mEAAmE;AACnE,wBAAgB,UAAU,CACzB,KAAK,EAAE,WAAW,EAAE,EACpB,KAAK,CAAC,EAAE,MAAM,GACZ,WAAW,EAAE,CAGf;AAED,wEAAwE;AACxE,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,iDAAiD;AACjD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,MAAM,CAEjE"}