@mandible-ai/mandible 0.2.0 → 0.3.1

package/README.md

@@ -27,43 +27,110 @@ Stigmergy sidesteps all of that. The environment carries the state. Agents are s
 ## Quick start
 
 ```bash
-npm install mandible
+npm install @mandible-ai/mandible
 ```
 
 ```typescript
-import { colony, createRuntime, FilesystemEnvironment, withClaudeCode } from 'mandible';
+import { mandible, FilesystemEnvironment } from '@mandible-ai/mandible';
 
 const env = new FilesystemEnvironment({ root: './.mandible/signals' });
 
-const shaper = colony('shaper')
-  .in(env)
-  .sense('task:ready', { unclaimed: true })
-  .do(withClaudeCode({
-    systemPrompt: 'You are a code shaper. Given a task, write the implementation.',
-    allowedTools: ['Read', 'Write', 'Bash'],
-  }))
-  .concurrency(2)
-  .claim('lease', 30_000)
-  .build();
+const host = await mandible('code-review')
+  .environment(env)
+  .colony('shaper', c => c
+    .sense('task:ready', { unclaimed: true })
+    .do('shape-code', async (signal, ctx) => {
+      const result = await shapeCode(signal.payload);
+      await ctx.deposit('artifact:shaped', result, { causedBy: [signal.id] });
+      await ctx.withdraw(signal.id);
+    })
+    .concurrency(2)
+    .claim('lease', 30_000)
+  )
+  .colony('critic', c => c
+    .sense('artifact:shaped', { unclaimed: true })
+    .do('review-code', async (signal, ctx) => {
+      const review = await reviewCode(signal.payload);
+      await ctx.deposit('review:approved', review, { causedBy: [signal.id] });
+      await ctx.withdraw(signal.id);
+    })
+    .claim('exclusive')
+  )
+  .start();
+```
+
+No colony references any other colony. They coordinate entirely through signals in the environment.
+
+### Hosting models
+
+The **environment** (where signals live) is orthogonal to the **host** (where colony code runs). Colony definitions stay the same across all hosts — only the `.host()` call changes.
+
+#### Local (default)
 
-const critic = colony('critic')
-  .in(env)
-  .sense('task:shaped', { unclaimed: true })
-  .do(withClaudeCode({
-    systemPrompt: 'You are a code critic. Review the implementation for correctness and style.',
-    allowedTools: ['Read'],
+Runs colonies as Node runtimes in the current process. This is the default when `.host()` is omitted:
+
+```typescript
+import { mandible, FilesystemEnvironment } from '@mandible-ai/mandible';
+
+const env = new FilesystemEnvironment({ root: './.mandible/signals' });
+
+const host = await mandible('code-pipeline')
+  .environment(env)
+  .colony('shaper', shaper)
+  .colony('critic', critic)
+  .colony('keeper', keeper)
+  .start();
+
+await host.stop();
+```
+
+#### Docker
+
+Runs each colony as a Docker container via the Mandible Cloud API:
+
+```typescript
+import { mandible, FilesystemEnvironment, docker } from '@mandible-ai/mandible';
+
+const env = new FilesystemEnvironment({ root: './.mandible/signals' });
+
+const host = await mandible('code-pipeline')
+  .environment(env)
+  .host(docker({
+    apiUrl: process.env.MANDIBLE_API_URL!,
+    apiKey: process.env.MANDIBLE_API_KEY!,
+    image: 'mandible-colony:latest',
   }))
-  .claim('exclusive')
-  .build();
+  .colony('shaper', shaper)
+  .colony('critic', critic)
+  .colony('keeper', keeper)
+  .start();
 
-// Start them — they self-organize from here
-const shaperRuntime = createRuntime(shaper);
-const criticRuntime = createRuntime(critic);
-await shaperRuntime.start();
-await criticRuntime.start();
+console.log(host.metadata.projectId);
+await host.stop();
 ```
 
-No colony references any other colony. They coordinate entirely through signals in the environment.
+#### Cloud (Edera microVMs)
+
+For production workloads, run colonies in isolated Edera zones via [Mandible Cloud](https://mandible.dev):
+
+```typescript
+import { mandible, FilesystemEnvironment } from '@mandible-ai/mandible';
+import { cloud } from '@mandible-ai/cloud';
+
+const env = new FilesystemEnvironment({ root: './.mandible/signals' });
+
+const host = await mandible('code-pipeline')
+  .environment(env)
+  .host(cloud({ apiKey: process.env.MANDIBLE_API_KEY!, project: 'code-review' }))
+  .colony('shaper', shaper)
+  .colony('critic', critic)
+  .colony('keeper', keeper)
+  .start();
+
+await host.stop();
+```
+
+Same colonies, same environment, different host.
 
 ### Run with the dashboard
 
@@ -134,14 +201,37 @@ sense → match rules → claim → execute action → deposit → (others sense
 
 Other colonies sense those deposited signals and the cycle continues. Complex workflows emerge from simple local rules.
 
-## Colony DSL
+## Mandible DSL
+
+The `mandible()` function is the top-level entry point for defining and starting multi-colony systems:
+
+```typescript
+const host = await mandible('my-swarm')
+  .environment(env)                               // where colonies operate
+  .colony('name', c => c                          // define a colony inline
+    .sense('type:pattern', { unclaimed: true })   // what to watch for
+    .do('action-name', handler)                   // what to do
+    .concurrency(3)                               // max parallel agents
+    .claim('lease', 30_000)                       // claim strategy
+  )
+  .start();                                       // start everything
+```
+
+`start()` delegates to the host — `local()` starts Node runtimes in the current process, `docker()` launches containers, `cloud()` launches Edera microVMs. Returns the host for lifecycle control (`host.stop()`, `host.dashboard()`).
+
+### Colony builder
+
+For lower-level control, use the `colony()` builder directly:
 
 ```typescript
 colony('name')
   .in(env)                                        // which environment
   .sense('type:pattern', { unclaimed: true })     // what to watch for
   .when(signal => signal.payload.priority > 0)    // optional guard
-  .do(withClaudeCode({ allowedTools: ['Read', 'Write'] }))  // action provider
+  .do('shape', withClaudeCode({                   // action provider
+    prompt: signal => `Implement: ${signal.payload.name}`,
+    allowedTools: ['Read', 'Write'],
+  }))
   .concurrency(3)                                 // max parallel agents
   .claim('lease', 30_000)                         // claim strategy
   .poll(2000)                                     // sensor poll interval (ms)
@@ -204,7 +294,7 @@ Any shared substrate that supports observe/deposit/withdraw/claim/watch can be a
 Signals are JSON files. Claims use atomic file operations. History lives in a `withdrawn/` directory.
 
 ```typescript
-import { FilesystemEnvironment } from 'mandible';
+import { FilesystemEnvironment } from '@mandible-ai/mandible';
 
 const env = new FilesystemEnvironment({
   root: './.mandible/signals',
@@ -217,7 +307,7 @@ const env = new FilesystemEnvironment({
 Issues, pull requests, comments, and labels mapped as signals. Colonies can sense repository activity and deposit responses.
 
 ```typescript
-import { GitHubEnvironment } from 'mandible';
+import { GitHubEnvironment } from '@mandible-ai/mandible';
 
 const env = new GitHubEnvironment({
   owner: 'mandible-ai',
@@ -226,21 +316,6 @@ const env = new GitHubEnvironment({
 });
 ```
 
-### Remote (implemented)
-
-WebSocket-based environment for distributed deployments. Multiple machines share a single signal namespace over the network.
-
-```typescript
-import { RemoteEnvironment } from 'mandible';
-
-const env = new RemoteEnvironment({
-  url: 'ws://coordinator:4041',
-  apiKey: process.env.MANDIBLE_API_KEY,
-  project: 'my-project',
-  name: 'distributed',
-});
-```
-
 ### Dolt (stubbed)
 
 [Dolt](https://www.dolthub.com/) is a SQL database with Git-like versioning. Signals become rows, branching enables parallel work, and `dolt_history` provides queryable time travel for the full signal history.
@@ -264,6 +339,22 @@ interface Environment {
 }
 ```
 
+Hosts are orthogonal to Environments. To run colonies somewhere other than the local process, implement the `Host` interface:
+
+```typescript
+interface Host {
+  name: string;
+  start(colonies: ColonyDefinition[]): Promise<void>;
+  stop(): Promise<void>;
+  dashboard(options?: DashboardOptions): Promise<void>;
+  metadata: HostMetadata;
+  colonies: Array<{ name: string; state: string }>;
+  environments: Environment[];
+}
+```
+
+Built-in hosts: `local()` (in-process), `docker()` (containers). Cloud hosts live in `@mandible-ai/cloud`.
+
 ## Patterns
 
 Reusable coordination patterns built on top of the core primitives.
@@ -273,7 +364,7 @@ Reusable coordination patterns built on top of the core primitives.
 Cross-environment signal mirroring with attestation chains. Bridges watch for signals in one environment and mirror them to another, appending a signed attestation to preserve provenance across boundaries.
 
 ```typescript
-import { createBridge } from 'mandible';
+import { createBridge } from '@mandible-ai/mandible';
 
 const bridge = createBridge({
   name: 'local-to-github',
@@ -290,7 +381,7 @@ await bridge.start();
 Trust monitoring colony that watches an environment for signals with invalid or missing provenance. When violations are detected, the sentinel deposits `trust:violation` report signals that other colonies can react to.
 
 ```typescript
-import { createSentinel } from 'mandible';
+import { createSentinel } from '@mandible-ai/mandible';
 
 const sentinel = createSentinel({
   name: 'trust-guard',
@@ -317,11 +408,14 @@ src/
     attestation.ts      Ed25519 signing & verification (@noble/ed25519)
   dsl/
     builder.ts          Fluent colony definition DSL
+    mandible.ts         mandible() — multi-colony orchestration + start
   environments/
     filesystem/         Filesystem adapter (JSON files + atomic claims)
     github/             GitHub adapter (issues, PRs, comments, labels as signals)
-    remote/             Remote adapter (WebSocket-based distributed environments)
     dolt/               Dolt adapter (stub)
+  hosts/
+    local.ts            LocalHost — runs colonies in current process
+    docker.ts           DockerHost — runs colonies as Docker containers
   providers/
     claude-code.ts      withClaudeCode — Claude Code SDK (live)
     structured-output.ts withStructuredOutput — multi-model
@@ -333,12 +427,17 @@ src/
 
 tests/
   core/                 Signal, runtime, attestation tests
-  environments/         Filesystem, GitHub, remote adapter tests
+  environments/         Filesystem, GitHub adapter tests
+  dsl/                  DSL and mandible() builder tests
   providers/            Agent, structured output, bash provider tests
   colonies/             Integration tests for colony workflows
 
 examples/
-  code-pipeline/        Shaper → Critic → Keeper pipeline demo
+  code-pipeline/
+    colonies.ts         Shared colony definitions (shaper, critic, keeper)
+    index.ts            Local host — runs in current process
+    docker.ts           Docker host — runs as containers
+    with-providers.ts   Real LLM providers (Claude Code, Anthropic, Bash)
   repo-maintenance/     Scout + Fixer repo maintenance demo
 ```
 
@@ -346,16 +445,26 @@ examples/
 
 ### Code pipeline
 
-The included demo seeds 5 coding tasks into a filesystem environment. Three colonies self-organize to process them:
+Three colonies coordinate through a shared filesystem environment:
 
-- **Shaper** (concurrency: 2) — picks up `task:ready` signals, produces `task:shaped` signals
-- **Critic** (concurrency: 2) — reviews shaped artifacts, deposits `review:approved` or `review:rejected`
-- **Keeper** (concurrency: 1) — commits approved work, deposits `task:complete`
+- **Shaper** (concurrency: 2) — picks up `task:ready` signals, produces `artifact:shaped`
+- **Critic** (concurrency: 2) — reviews shaped artifacts, deposits `review:approved` or `review:changes-needed`
+- **Keeper** (concurrency: 1) — merges approved work, deposits `artifact:merged`
 
-No orchestrator. No message broker. No routing logic. The colonies discover work through the environment and coordinate through signals.
+Colony definitions live in `colonies.ts` and are shared across all hosting modes:
 
 ```bash
-npm run demo
+# Local host (default)
+npx tsx examples/code-pipeline/index.ts
+
+# Docker host
+export MANDIBLE_API_URL=http://localhost:9091
+export MANDIBLE_API_KEY=your-key
+npx tsx examples/code-pipeline/docker.ts
+
+# With real LLM providers
+export ANTHROPIC_API_KEY=sk-ant-...
+npx tsx examples/code-pipeline/with-providers.ts
 ```
 
 ### Repo maintenance
@@ -375,9 +484,11 @@ Both colonies are wired to real Claude agents via `withClaudeCode`. The dashboar
 
 - [x] `mandible dev` CLI + live dashboard
 - [x] `withClaudeCode` wired to Claude Code SDK
-- [x] Test suite (371 tests, 95%+ coverage)
+- [x] Test suite (378 tests, 95%+ coverage)
 - [x] GitHub environment adapter
-- [x] Remote environment adapter
+- [x] `mandible()` DSL with Host/Environment separation
+- [x] `local()` and `docker()` host implementations
+- [ ] `@mandible-ai/cloud` — run colonies in Edera microVMs via Mandible Cloud
 - [ ] `create-mandible` starter template
 - [ ] Dashboard GIF + landing page
 - [ ] Dolt full implementation

package/dist/examples/code-pipeline/colonies.d.ts

@@ -0,0 +1,10 @@
+import type { ColonyBuilder } from '../../src/dsl/builder.js';
+export declare function shaper(c: ColonyBuilder): ColonyBuilder<Record<string, unknown>>;
+export declare function critic(c: ColonyBuilder): ColonyBuilder<Record<string, unknown>>;
+export declare function keeper(c: ColonyBuilder): ColonyBuilder<Record<string, unknown>>;
+export declare const SEED_TASKS: {
+    name: string;
+    priority: string;
+    description: string;
+}[];
+//# sourceMappingURL=colonies.d.ts.map

package/dist/examples/code-pipeline/colonies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"colonies.d.ts","sourceRoot":"","sources":["../../../examples/code-pipeline/colonies.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAiC9D,wBAAgB,MAAM,CAAC,CAAC,EAAE,aAAa,0CAgBtC;AAED,wBAAgB,MAAM,CAAC,CAAC,EAAE,aAAa,0CA+BtC;AAED,wBAAgB,MAAM,CAAC,CAAC,EAAE,aAAa,0CAiBtC;AAED,eAAO,MAAM,UAAU;;;;GAMtB,CAAC"}

package/dist/examples/code-pipeline/colonies.js

@@ -0,0 +1,112 @@
+// ============================================================
+// Shared Colony Definitions — Shaper / Critic / Keeper
+// ============================================================
+// These colonies are reusable across any host (local, docker,
+// cloud). They define *what* happens, not *where* it runs.
+//
+// Each colony only knows about signal types — no colony
+// references any other colony. Coordination emerges from
+// the shared signal environment.
+// ============================================================
+function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+async function simulateShaping(task) {
+    await sleep(500 + Math.random() * 1500);
+    return {
+        code: `function ${task.name}() { return true; }`,
+        linesChanged: Math.floor(Math.random() * 100) + 10,
+        task: task.name,
+    };
+}
+async function simulateReview(artifact) {
+    await sleep(300 + Math.random() * 1000);
+    const approved = Math.random() > 0.2;
+    return {
+        approved,
+        feedback: approved
+            ? `Code for "${artifact.task}" looks good.`
+            : `Code for "${artifact.task}" needs error handling.`,
+    };
+}
+async function simulateMerge(artifact) {
+    await sleep(200 + Math.random() * 500);
+    return { merged: true, task: artifact.task, commitHash: Math.random().toString(36).slice(2, 10) };
+}
+// Colony configurators — passed to mandible().colony(name, configure)
+export function shaper(c) {
+    return c
+        .sense('task:ready', { unclaimed: true, minConcentration: 0.1 })
+        .do('shape-code', async (signal, ctx) => {
+        ctx.log(`Shaping: ${signal.payload.name}`);
+        const artifact = await simulateShaping(signal.payload);
+        await ctx.deposit('artifact:shaped', artifact, {
+            causedBy: [signal.id],
+            tags: ['needs-review'],
+        });
+        await ctx.withdraw(signal.id);
+        ctx.log(`Shaped "${signal.payload.name}" (${artifact.linesChanged} lines)`);
+    })
+        .concurrency(2)
+        .claim('lease', 30_000)
+        .poll(1000);
+}
+export function critic(c) {
+    return c
+        .sense('artifact:shaped', { unclaimed: true, minConcentration: 0.1 })
+        .do('review-code', async (signal, ctx) => {
+        ctx.log(`Reviewing: ${signal.payload.task}`);
+        const review = await simulateReview(signal.payload);
+        if (review.approved) {
+            await ctx.deposit('review:approved', {
+                artifact: signal.payload,
+                feedback: review.feedback,
+            }, {
+                causedBy: [signal.id],
+                tags: ['ready-to-merge'],
+            });
+            ctx.log(`Approved: ${review.feedback}`);
+        }
+        else {
+            await ctx.deposit('review:changes-needed', {
+                artifact: signal.payload,
+                feedback: review.feedback,
+            }, {
+                causedBy: [signal.id],
+                tags: ['needs-rework'],
+                ttl: 60_000,
+            });
+            ctx.log(`Changes needed: ${review.feedback}`);
+        }
+        await ctx.withdraw(signal.id);
+    })
+        .concurrency(2)
+        .claim('lease', 30_000)
+        .poll(1000);
+}
+export function keeper(c) {
+    return c
+        .sense('review:approved', { unclaimed: true, minConcentration: 0.1 })
+        .do('merge-artifact', async (signal, ctx) => {
+        const artifact = signal.payload.artifact ?? {};
+        ctx.log(`Merging: ${artifact.task}`);
+        const result = await simulateMerge(artifact);
+        await ctx.deposit('artifact:merged', result, {
+            causedBy: [signal.id],
+            tags: ['complete'],
+        });
+        await ctx.withdraw(signal.id);
+        ctx.log(`Merged -> commit ${result.commitHash}`);
+    })
+        .concurrency(1)
+        .claim('exclusive')
+        .poll(1000);
+}
+export const SEED_TASKS = [
+    { name: 'auth-middleware', priority: 'high', description: 'Add JWT authentication' },
+    { name: 'rate-limiter', priority: 'medium', description: 'API rate limiting' },
+    { name: 'health-check', priority: 'low', description: 'Add /health endpoint' },
+    { name: 'error-handler', priority: 'high', description: 'Global error handling' },
+    { name: 'request-logger', priority: 'medium', description: 'Structured logging' },
+];
+//# sourceMappingURL=colonies.js.map

package/dist/examples/code-pipeline/colonies.js.map

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

package/dist/examples/code-pipeline/docker.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env tsx
+export {};
+//# sourceMappingURL=docker.d.ts.map

package/dist/examples/code-pipeline/docker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docker.d.ts","sourceRoot":"","sources":["../../../examples/code-pipeline/docker.ts"],"names":[],"mappings":""}

package/dist/examples/code-pipeline/docker.js

@@ -0,0 +1,63 @@
+#!/usr/bin/env tsx
+// ============================================================
+// Code Pipeline — Docker Host
+// ============================================================
+// Same colonies as index.ts, but running as Docker containers
+// via the Mandible Cloud API. The colony definitions are
+// identical — only the host changes.
+//
+// Prerequisites:
+//   - Mandible Cloud API running (local or remote)
+//   - MANDIBLE_API_URL and MANDIBLE_API_KEY set
+//
+// To run:
+//   export MANDIBLE_API_URL=http://localhost:9091
+//   export MANDIBLE_API_KEY=your-api-key
+//   npx tsx examples/code-pipeline/docker.ts
+// ============================================================
+import { mandible, FilesystemEnvironment, docker } from '../../src/index.js';
+import { shaper, critic, keeper, SEED_TASKS } from './colonies.js';
+const apiUrl = process.env.MANDIBLE_API_URL;
+const apiKey = process.env.MANDIBLE_API_KEY;
+if (!apiUrl || !apiKey) {
+    console.error('Set MANDIBLE_API_URL and MANDIBLE_API_KEY');
+    process.exit(1);
+}
+const env = new FilesystemEnvironment({ root: '/tmp/mandible-demo', name: 'code-pipeline' });
+// Same colonies, different host
+const host = await mandible('code-pipeline')
+    .environment(env)
+    .host(docker({
+    apiUrl,
+    apiKey,
+    image: 'mandible-colony:latest',
+}))
+    .colony('shaper', shaper)
+    .colony('critic', critic)
+    .colony('keeper', keeper)
+    .start();
+const meta = host.metadata;
+console.log(`Started ${host.colonies.length} colonies on ${host.name} host`);
+console.log(`Project: ${meta.projectId}`);
+console.log(`Signal server: ${meta.signalServerUrl}\n`);
+// Seed tasks
+for (const task of SEED_TASKS) {
+    await env.deposit({
+        type: 'task:ready',
+        payload: task,
+        meta: { deposited_by: 'seed', tags: [task.priority] },
+    });
+    console.log(`  seeded: task:ready "${task.name}"`);
+}
+console.log('\nColonies running in Docker containers.');
+console.log('Press Ctrl+C to stop.\n');
+// Keep alive until interrupted
+process.on('SIGINT', async () => {
+    console.log('\nStopping...');
+    await host.stop();
+    console.log('Stopped.');
+    process.exit(0);
+});
+// Block forever
+await new Promise(() => { });
+//# sourceMappingURL=docker.js.map

package/dist/examples/code-pipeline/docker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docker.js","sourceRoot":"","sources":["../../../examples/code-pipeline/docker.ts"],"names":[],"mappings":";AACA,+DAA+D;AAC/D,8BAA8B;AAC9B,+DAA+D;AAC/D,8DAA8D;AAC9D,yDAAyD;AACzD,qCAAqC;AACrC,EAAE;AACF,iBAAiB;AACjB,mDAAmD;AACnD,gDAAgD;AAChD,EAAE;AACF,UAAU;AACV,kDAAkD;AAClD,yCAAyC;AACzC,6CAA6C;AAC7C,+DAA+D;AAE/D,OAAO,EAAE,QAAQ,EAAE,qBAAqB,EAAE,MAAM,EAA2B,MAAM,oBAAoB,CAAC;AACtG,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEnE,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;AAC5C,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;AAE5C,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC;IACvB,OAAO,CAAC,KAAK,CAAC,2CAA2C,CAAC,CAAC;IAC3D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,GAAG,GAAG,IAAI,qBAAqB,CAAC,EAAE,IAAI,EAAE,oBAAoB,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC,CAAC;AAE7F,gCAAgC;AAChC,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,eAAe,CAAC;KACzC,WAAW,CAAC,GAAG,CAAC;KAChB,IAAI,CAAC,MAAM,CAAC;IACX,MAAM;IACN,MAAM;IACN,KAAK,EAAE,wBAAwB;CAChC,CAAC,CAAC;KACF,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC;KACxB,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC;KACxB,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC;KACxB,KAAK,EAAE,CAAC;AAEX,MAAM,IAAI,GAAG,IAAI,CAAC,QAA8B,CAAC;AACjD,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,CAAC,QAAQ,CAAC,MAAM,gBAAgB,IAAI,CAAC,IAAI,OAAO,CAAC,CAAC;AAC7E,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;AAC1C,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,CAAC,eAAe,IAAI,CAAC,CAAC;AAExD,aAAa;AACb,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;IAC9B,MAAM,GAAG,CAAC,OAAO,CAAC;QAChB,IAAI,EAAE,YAAY;QAClB,OAAO,EAAE,IAAI;QACb,IAAI,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE;KACtD,CAAC,CAAC;IACH,OAAO,CAAC,GAAG,CAAC,yBAAyB,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;AACrD,CAAC;AAED,OAAO,CAAC,GAAG,CAAC,0CAA0C,CAAC,CAAC;AACxD,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;AAEvC,+BAA+B;AAC/B,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE;IAC9B,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;IAC7B,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;IAClB,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACxB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,gBAAgB;AAChB,MAAM,IAAI,OAAO,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC"}