harnery 0.30.0 → 0.31.0

package/README.md

@@ -19,9 +19,9 @@
 
 `harnery` keeps multiple AI coding agents from stepping on each other in a shared checkout. It was extracted from years of running several Claude Code / Cursor / Codex sessions at once against the same monorepo:
 
-- **Multi-agent coordination:** per-agent heartbeats in `.harnery/active/`, claim-time and commit-time guards, the canonical event stream, councils, a decision docket, per-agent scratchpads, and harness adapters for Claude Code / Cursor / Codex.
+- **Multi-agent coordination:** per-agent heartbeats in `.harnery/active/`, claim-time and commit-time guards, the canonical event stream, councils, a decision docket, per-agent journals, and adapter adapters for Claude Code / Cursor / Codex.
 - **Cross-machine presence:** sessions on every machine that shares a repo see each other, labeled by machine. Zero-config over the repo's own git remote (presence refs), with an optional live-socket upgrade via an end-to-end-encrypted relay — the public `relay.harnery.com`, or self-host with `harn relay serve` / the bundled Cloudflare Worker (`relay/worker/`). The relay sees only ciphertext in opaquely-named rooms.
-- **Coordination-aware workflows:** `harn workflow run <script>` executes bounded, schema-gated multi-subagent workflow scripts — plain JS stages fanning out to headless harness-CLI subagents that are born coordination-registered (heartbeats, events, claim guards), with deterministic code deciding the routing between stages. An optional host-owned policy gates dispatch and declared external mutations with `ALLOW`, `ASK`, and `DENY`; CLI `ASK` requests park durably for an explicit approve/deny and same-run resume, while library callers remain fail-closed by default.
+- **Coordination-aware workflows:** `harn workflow run <script>` executes bounded, schema-gated multi-subagent workflow scripts — plain JS stages fanning out to headless adapter-CLI subagents that are born coordination-registered (heartbeats, events, claim guards), with deterministic code deciding the routing between stages. An optional host-owned policy gates dispatch and declared external mutations with `ALLOW`, `ASK`, and `DENY`; CLI `ASK` requests park durably for an explicit approve/deny and same-run resume, while library callers remain fail-closed by default.
 - **Optional isolated workspaces:** add `--isolation worktree --workspace-root <dir>` to run a workflow in a host-owned local Git worktree. Harnery freezes the allocation and provider identity, verifies the workspace before execution and resume, requires review and policy authority before fast-forward integration, and keeps cleanup conservative. Inspect with `harn workflow workspace`, then use the separate `workflow integration prepare`, `integration apply`, and `cleanup` phases; shared execution remains the default.
 - **Durable work above attempts:** `harn work` preserves an objective across bounded workflow attempts, dependencies, approval parks, failures, and review. Reusable workflow code receives the exact work ID, title, objective, acceptance criteria, and attempt identity as frozen typed context. A retry also receives the prior run's bounded error and unresolved proof criteria, while retry authority and attempt ceilings remain unchanged. The manifest, proof, and append-only ledger bind the same context, and the one-shot reconciler reports the next explicit action without silently spawning, retrying, or accepting work.
 - **Bounded goal supervision:** `harn supervisor` freezes a mission or existing root graph, specialist team, and safety limits, then runs scheduling cycles until reviewed mission success, human attention, no progress, or budget exhaustion. Its optional planner can create the first milestone, reassess accepted milestone proof, or recover a terminal graph using only a frozen workflow-template catalog. Plans can require independent bounded specialist review before ordinary approval or auto-apply authority, old generations remain immutable evidence, and all attempts still consume the goal budget. Use explicit foreground ticks or enroll goals in the optional heartbeat-backed background service.
@@ -39,7 +39,7 @@ curl -fsSL https://harnery.com/install.sh | bash
 One line, no clone: it installs the `harn` CLI globally (npm preferred, Bun fallback), puts it on your `PATH`, and verifies it. Or drive your package manager directly — `npm install -g harnery` / `bun add -g harnery` (or `npm install harnery` for a project dep). Then wire a project:
 
 ```bash
-harn init     # creates .harnery/ + registers the harness hooks
+harn init     # creates .harnery/ + registers the adapter hooks
 harn doctor   # optional: one-time runtime + dependency check
 ```
 
@@ -52,7 +52,7 @@ harn doctor   # optional: one-time runtime + dependency check
 Two layers. **Unwire a project** (keeps `.harnery/` history by default; on a terminal it asks before deleting it):
 
 ```bash
-harn deinit                 # unwire the harness hooks
+harn deinit                 # unwire the adapter hooks
 harn deinit --purge-state   # also delete .harnery/ (destructive)
 ```
 

package/dist/commander.d.ts

@@ -94,6 +94,14 @@ export interface HarneryProgramContext {
      * zones behind a WAF). harn standalone skips the callback entirely.
      */
     extraHeaders?: (url: string) => Record<string, string>;
+    /**
+     * Host-injected vision-model call for `browse --check-critique`. harnery
+     * ships no model client or API key; a consumer wires this to its own
+     * multimodal provider (OpenAI/Anthropic/etc). Given one page tile + the
+     * rubric, it returns that tile's findings. When omitted, `--check-critique`
+     * reports `skipped` rather than a false pass.
+     */
+    critiqueProvider?: import("./lib/browser/critique.js").CritiqueProvider;
     /**
      * Shell-completion provider-key lookup. Consumers wire this to a function
      * mapping (commandPath, option/positional) to a provider key, so that

package/dist/commander.d.ts.map

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

package/dist/commander.js

@@ -17,15 +17,17 @@ import { readFileSync } from "node:fs";
 import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
 import { Command } from "commander";
-import { registerAgentsCommand } from "./commands/agents.js";
+import { registerAdapterCommand } from "./commands/adapter.js";
+import { registerAgentsCommand, registerCouncilCommands } from "./commands/agents.js";
+import { registerArtifactsCommand } from "./commands/artifacts.js";
 import { registerBackupCommand } from "./commands/backup.js";
 import { registerBrowseCommand } from "./commands/browse.js";
 import { registerBrowseAiCommand } from "./commands/browse-ai.js";
 import { registerCallersCommand } from "./commands/callers.js";
+import { registerCheckpointCommand } from "./commands/checkpoint.js";
 import { registerClaudeDesktopCommand } from "./commands/claude-desktop.js";
 import { registerCompletionCommand } from "./commands/completion.js";
 import { registerConfigGetCommand } from "./commands/config-get.js";
-import { registerContextCommand } from "./commands/context.js";
 import { registerCookiesCommand } from "./commands/cookies.js";
 import { registerDecisionCommand } from "./commands/decision.js";
 import { registerDeinitCommand } from "./commands/deinit.js";
@@ -37,17 +39,15 @@ import { registerEmlCommand } from "./commands/eml.js";
 import { registerEnvCommand } from "./commands/env.js";
 import { registerFetchCommand } from "./commands/fetch.js";
 import { registerFileHistoryCommand } from "./commands/file-history.js";
+import { registerGovernorCommand } from "./commands/governor.js";
 import { registerGrepCommand } from "./commands/grep.js";
-import { registerHarnessCommand } from "./commands/harness.js";
 import { registerInitCommand } from "./commands/init.js";
+import { registerJournalCommand } from "./commands/journal.js";
 import { registerOutlineCommand } from "./commands/outline.js";
 import { registerPolicyCommand } from "./commands/policy.js";
 import { registerPresenceCommand } from "./commands/presence.js";
 import { registerReadCommand } from "./commands/read.js";
 import { registerRelayCommand } from "./commands/relay.js";
-import { registerScratchCommand } from "./commands/scratch.js";
-import { registerSessionCommand } from "./commands/session.js";
-import { registerSupervisorCommand } from "./commands/supervisor.js";
 import { registerSyncCommand } from "./commands/sync.js";
 import { registerSectionCommand, registerTocCommand } from "./commands/toc.js";
 import { registerTokensCommand } from "./commands/tokens.js";
@@ -96,7 +96,7 @@ export function createHarneryProgram(opts = {}) {
     const include = (name) => !skip.has(name);
     program
         .name(opts.binName ?? "harn")
-        .description("Multi-agent coordination + harness adapters + portable CLI utilities.")
+        .description("Multi-agent coordination + adapter adapters + portable CLI utilities.")
         .version(readVersion());
     registerTokensCommand(program, emit);
     registerEmlCommand(program, emit);
@@ -111,22 +111,23 @@ export function createHarneryProgram(opts = {}) {
     registerCallersCommand(program, emit, opts.context);
     registerEditBatchCommand(program, emit);
     registerGrepCommand(program, emit, opts.context);
-    registerHarnessCommand(program, emit);
+    registerAdapterCommand(program, emit);
     registerPolicyCommand(program, emit);
     registerCookiesCommand(program, emit);
     registerFetchCommand(program, emit, opts.context);
     registerReadCommand(program, emit);
     registerBrowseCommand(program, emit, opts.context);
     registerBrowseAiCommand(program, emit);
-    registerSessionCommand(program, emit);
     registerCompletionCommand(program, emit, opts.context);
-    registerContextCommand(program, emit, opts.context);
-    registerScratchCommand(program, emit);
+    registerCheckpointCommand(program, emit, opts.context);
+    registerJournalCommand(program, emit);
+    registerArtifactsCommand(program, emit, opts.context);
     registerDecisionCommand(program, emit);
     registerDevtoolsCommand(program, emit);
     registerTunnelCommand(program, emit, opts.context);
     registerDocsCommand(program, emit, opts.context);
-    registerAgentsCommand(program, emit);
+    registerAgentsCommand(program, emit, opts.context);
+    registerCouncilCommands(program);
     registerDoctorCommand(program, emit);
     registerInitCommand(program, emit, opts.binName);
     registerDeinitCommand(program, emit, opts.binName);
@@ -135,7 +136,7 @@ export function createHarneryProgram(opts = {}) {
     registerSyncCommand(program, emit);
     registerWorkflowCommand(program, emit);
     registerWorkCommand(program, emit);
-    registerSupervisorCommand(program, emit);
+    registerGovernorCommand(program, emit);
     if (include("web"))
         registerWebCommand(program, emit);
     return program;

package/dist/commands/adapter.d.ts

@@ -0,0 +1,12 @@
+import type { Command } from "commander";
+import type { EmitContext } from "../commander.js";
+import { type AdapterAttestationReport, type AdapterBenchReport, type BenchResult } from "../core/adapters/index.js";
+import type { AdapterProfile } from "../core/adapters/types.js";
+export declare function registerAdapterCommand(program: Command, emit: EmitContext): void;
+export declare function renderAttestationReport(report: AdapterAttestationReport): string;
+export declare function renderProfileTable(profiles: readonly AdapterProfile[]): string;
+export declare function renderProfile(profile: AdapterProfile): string;
+export declare function renderBenchReport(report: AdapterBenchReport): string;
+/** Kept exported so command tests can assert row semantics without model calls. */
+export type { BenchResult };
+//# sourceMappingURL=adapter.d.ts.map

package/dist/commands/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../src/commands/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EACL,KAAK,wBAAwB,EAC7B,KAAK,kBAAkB,EACvB,KAAK,WAAW,EAKjB,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAoBhE,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,GAAG,IAAI,CA4JhF;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,wBAAwB,GAAG,MAAM,CAgBhF;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,SAAS,cAAc,EAAE,GAAG,MAAM,CAU9E;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CAkB7D;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,CA6BpE;AAgBD,mFAAmF;AACnF,YAAY,EAAE,WAAW,EAAE,CAAC"}

package/dist/commands/{harness.js → adapter.js}

@@ -1,19 +1,19 @@
+import { createBuiltinAdapterRegistry, listAttestations, runAdapterAttestation, runAdapterBench, } from "../core/adapters/index.js";
 import { workflowSubscriptionOnly } from "../core/config.js";
-import { createBuiltinHarnessRegistry, listAttestations, runHarnessAttestation, runHarnessBench, } from "../core/harnesses/index.js";
-const registry = createBuiltinHarnessRegistry();
-export function registerHarnessCommand(program, emit) {
+const registry = createBuiltinAdapterRegistry();
+export function registerAdapterCommand(program, emit) {
     const command = program
-        .command("harness")
-        .description("Inspect registered harness capabilities and run their conformance bench.");
+        .command("adapter")
+        .description("Inspect registered adapter capabilities and run their conformance bench.");
     command
         .command("list")
-        .description("List registered harness adapters and their high-signal capability claims.")
+        .description("List registered adapter adapters and their high-signal capability claims.")
         .option("--json", "Machine-readable profile catalog")
         .action((opts) => {
         const profiles = registry.list().map((adapter) => adapter.profile);
         if (opts.json) {
             emit.config({ format: "json" });
-            emit.data({ harnesses: profiles });
+            emit.data({ adapters: profiles });
         }
         else {
             emit.text(renderProfileTable(profiles));
@@ -21,14 +21,14 @@ export function registerHarnessCommand(program, emit) {
     });
     command
         .command("show <id>")
-        .description("Show one harness's complete capability declaration.")
+        .description("Show one adapter's complete capability declaration.")
         .option("--json", "Machine-readable profile")
         .action((id, opts) => {
         const adapter = registry.get(id);
         if (!adapter) {
             emit.error({
-                code: "unknown_harness",
-                message: `unknown harness ${JSON.stringify(id)} (registered: ${registry.ids().join(", ")})`,
+                code: "unknown_adapter",
+                message: `unknown adapter ${JSON.stringify(id)} (registered: ${registry.ids().join(", ")})`,
             });
             emit.setExitCode(1);
             return;
@@ -42,13 +42,13 @@ export function registerHarnessCommand(program, emit) {
         }
     });
     command
-        .command("bench [harnesses...]")
+        .command("bench [adapters...]")
         .description("Run the offline adapter-contract bench (no model calls); drift exits non-zero.")
         .option("--require-installed", "Also fail when a registered vendor CLI is missing")
         .option("--json", "Machine-readable conformance report")
-        .action((harnesses, opts) => {
+        .action((adapters, opts) => {
         try {
-            const report = runHarnessBench(registry, { harnesses });
+            const report = runAdapterBench(registry, { adapters });
             if (opts.json) {
                 emit.config({ format: "json" });
                 emit.data(report);
@@ -59,23 +59,23 @@ export function registerHarnessCommand(program, emit) {
             emit.setExitCode(report.drift || (opts.requireInstalled && report.skipped) ? 1 : 0);
         }
         catch (error) {
-            emit.error({ code: "harness_bench_failed", message: error.message });
+            emit.error({ code: "adapter_bench_failed", message: error.message });
             emit.setExitCode(1);
         }
     });
     command
-        .command("attest [harnesses...]")
+        .command("attest [adapters...]")
         .description("Record what the installed vendor CLIs actually do. Runs one real model turn each; needs --yes.")
         .option("--yes", "Confirm that this spends real vendor tokens")
         .option("--subscription-only", "Scrub API-key vars so the child uses its stored login (repo default via config.jsonc workflow.subscriptionOnly)")
-        .option("--timeout <ms>", "Per-harness probe timeout in milliseconds")
-        .option("--projection", "Also probe whether a declared sandbox is enforced; costs two extra turns per capable harness")
+        .option("--timeout <ms>", "Per-adapter probe timeout in milliseconds")
+        .option("--projection", "Also probe whether a declared sandbox is enforced; costs two extra turns per capable adapter")
         .option("--json", "Machine-readable attestation report")
-        .action(async (harnesses, opts) => {
+        .action(async (adapters, opts) => {
         if (!opts.yes) {
             emit.error({
-                code: "harness_attest_unconfirmed",
-                message: "harness attest runs one real model turn per harness and spends vendor tokens. Re-run with --yes.",
+                code: "adapter_attest_unconfirmed",
+                message: "adapter attest runs one real model turn per adapter and spends vendor tokens. Re-run with --yes.",
             });
             emit.setExitCode(1);
             return;
@@ -83,7 +83,7 @@ export function registerHarnessCommand(program, emit) {
         const timeoutMs = opts.timeout ? Number(opts.timeout) : undefined;
         if (timeoutMs !== undefined && (!Number.isFinite(timeoutMs) || timeoutMs <= 0)) {
             emit.error({
-                code: "harness_attest_bad_timeout",
+                code: "adapter_attest_bad_timeout",
                 message: "--timeout must be a positive number",
             });
             emit.setExitCode(1);
@@ -91,8 +91,8 @@ export function registerHarnessCommand(program, emit) {
         }
         try {
             const subscriptionOnly = opts.subscriptionOnly || workflowSubscriptionOnly();
-            const report = await runHarnessAttestation(registry, {
-                harnesses,
+            const report = await runAdapterAttestation(registry, {
+                adapters,
                 timeoutMs,
                 subscriptionOnly,
                 projection: opts.projection === true,
@@ -110,7 +110,7 @@ export function registerHarnessCommand(program, emit) {
             emit.setExitCode(report.recorded === 0 ? 1 : 0);
         }
         catch (error) {
-            emit.error({ code: "harness_attest_failed", message: error.message });
+            emit.error({ code: "adapter_attest_failed", message: error.message });
             emit.setExitCode(1);
         }
     });
@@ -127,11 +127,11 @@ export function registerHarnessCommand(program, emit) {
                 return;
             }
             if (records.length === 0) {
-                emit.text("No attestations recorded. Run `harness attest --yes` to create one.");
+                emit.text("No attestations recorded. Run `adapter attest --yes` to create one.");
                 return;
             }
-            emit.text(renderTable(["HARNESS", "VERSION", "BILLING", "OBSERVED AT", "OBSERVATIONS"], records.map((record) => [
-                record.harness,
+            emit.text(renderTable(["ADAPTER", "VERSION", "BILLING", "OBSERVED AT", "OBSERVATIONS"], records.map((record) => [
+                record.adapter,
                 record.binary_version,
                 record.subscription_only ? "subscription" : "any",
                 record.observed_at,
@@ -141,14 +141,14 @@ export function registerHarnessCommand(program, emit) {
             ])));
         }
         catch (error) {
-            emit.error({ code: "harness_attestations_failed", message: error.message });
+            emit.error({ code: "adapter_attestations_failed", message: error.message });
             emit.setExitCode(1);
         }
     });
 }
 export function renderAttestationReport(report) {
     const rows = report.results.map((result) => [
-        result.harness,
+        result.adapter,
         result.outcome,
         result.binaryVersion ?? "",
         result.observations
@@ -157,10 +157,10 @@ export function renderAttestationReport(report) {
                 .join(" ")
             : result.note,
     ]);
-    const table = renderTable(["HARNESS", "OUTCOME", "VERSION", "OBSERVED"], rows);
+    const table = renderTable(["ADAPTER", "OUTCOME", "VERSION", "OBSERVED"], rows);
     const tail = report.incomplete
-        ? "Some harnesses were not attested; their bench rows keep an adapter basis."
-        : "Every selected harness was attested.";
+        ? "Some adapters were not attested; their bench rows keep an adapter basis."
+        : "Every selected adapter was attested.";
     return `${table}\n\nrecorded: ${report.recorded}/${report.results.length}\n${tail}`;
 }
 export function renderProfileTable(profiles) {
@@ -172,7 +172,7 @@ export function renderProfileTable(profiles) {
         profile.capabilities.sessionId.support,
         profile.capabilities.cost.support,
     ]);
-    return renderTable(["HARNESS", "BINARY", "MODEL", "EFFORT", "SESSION", "COST"], rows);
+    return renderTable(["ADAPTER", "BINARY", "MODEL", "EFFORT", "SESSION", "COST"], rows);
 }
 export function renderProfile(profile) {
     const lines = [
@@ -195,14 +195,14 @@ export function renderProfile(profile) {
 }
 export function renderBenchReport(report) {
     const rows = report.results.map((result) => [
-        result.harness,
+        result.adapter,
         result.dimension,
         result.declared,
         result.observed,
         result.verdict,
         result.basis,
     ]);
-    const table = renderTable(["HARNESS", "DIMENSION", "DECLARED", "OBSERVED", "VERDICT", "BASIS"], rows);
+    const table = renderTable(["ADAPTER", "DIMENSION", "DECLARED", "OBSERVED", "VERDICT", "BASIS"], rows);
     const summary = Object.entries(report.summary)
         .filter(([, count]) => count > 0)
         .map(([verdict, count]) => `${verdict}=${count}`)

package/dist/commands/agents.d.ts

@@ -13,7 +13,7 @@
  *   harn agents health --since 7d --json
  */
 import type { Command } from "commander";
-import type { EmitContext } from "../commander.js";
+import type { EmitContext, HarneryProgramContext } from "../commander.js";
 /**
  * Spawn options for agent-coord child processes: pin the coord root the
  * command already resolved (git-superproject-aware via `monorepoRoot()`), so
@@ -29,7 +29,8 @@ export declare function coordHelperOpts(root: string): {
     cwd: string;
     env: NodeJS.ProcessEnv;
 };
-export declare function registerAgentsCommand(program: Command, emitParam: EmitContext): void;
+export declare function registerAgentsCommand(program: Command, emitParam: EmitContext, programContext?: HarneryProgramContext): void;
+export declare function registerCouncilCommands(parent: Command): void;
 /**
  * Build the copy-pasteable session name from the coord identity + the agent's
  * description parts. Pure (no coord-state reads) so it's unit-testable; collapses

package/dist/commands/agents.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../src/commands/agents.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAeH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAyEnD;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAA;CAAE,CAErF;AAgCD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,WAAW,GAAG,IAAI,CA6PpF;AA0iCD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,MAAM,EACjB,gBAAgB,EAAE,MAAM,EAAE,GACzB;IAAE,aAAa,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAKvD"}
+{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../src/commands/agents.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAeH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AA0E1E;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAA;CAAE,CAErF;AAgCD,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,WAAW,EACtB,cAAc,CAAC,EAAE,qBAAqB,GACrC,IAAI,CA+PN;AAyJD,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAyO7D;AAwqBD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,MAAM,EACjB,gBAAgB,EAAE,MAAM,EAAE,GACzB;IAAE,aAAa,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAKvD"}