rhachet 1.6.0 → 1.7.1

package/dist/logic/invoke/performInIsolatedThreads.d.ts

@@ -0,0 +1,19 @@
+import { InvokeOpts } from '../../domain/objects/InvokeOpts';
+/**
+ * .what = performs a skill in one-or-more isolated threads concurrently
+ * .why =
+ *   - enables multiple attempts of the same performance, to compare different takes of the same skill
+ *   - given llm's may produce divergent results on reinvocation, this is useful to...
+ *     - support the attempt-&-blend pattern
+ *     - evaluate the consistency of a skill applied to your ask
+ *     - etc
+ * .how =
+ *    - spawns isolated child threads and performs the skill within each of those threads
+ */
+export declare const performInIsolatedThreads: (input: {
+    opts: InvokeOpts<{
+        config: string;
+        ask: string;
+        output?: string;
+    }>;
+}) => Promise<void>;

package/dist/logic/invoke/performInIsolatedThreads.integration.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/logic/invoke/performInIsolatedThreads.integration.test.js

@@ -0,0 +1,75 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_path_1 = __importDefault(require("node:path"));
+const rhachet_artifact_git_1 = require("rhachet-artifact-git");
+const test_fns_1 = require("test-fns");
+const directory_1 = require("../../.test/directory");
+const performInIsolatedThreads_1 = require("./performInIsolatedThreads");
+describe('performInIsolatedThreads', () => {
+    // observe stdout
+    let stdoutObserved = '';
+    const originalWrite = process.stdout.write;
+    beforeAll(() => {
+        process.stdout.write = (chunk, ...args) => {
+            stdoutObserved += chunk.toString();
+            return originalWrite.call(process.stdout, chunk, ...args);
+        };
+    });
+    afterAll(() => {
+        process.stdout.write = originalWrite;
+    });
+    (0, test_fns_1.given)('a simple echo demo', () => {
+        // declare the demo config via path
+        const configPath = node_path_1.default.resolve(directory_1.TEST_FIXTURE_DIRECTORY, './example.use.repo/example.rhachet.use.ts');
+        (0, test_fns_1.when)('asked to perform a skill registered in the config 3 times', () => {
+            const opts = {
+                config: configPath,
+                role: 'echoer',
+                skill: 'echo',
+                attempts: 3,
+                ask: 'do it',
+            };
+            (0, test_fns_1.then)('it should successfully execute do so', async () => {
+                await (0, performInIsolatedThreads_1.performInIsolatedThreads)({ opts });
+            });
+            (0, test_fns_1.then)('it should have logged with observable prefixes', async () => {
+                expect(stdoutObserved).toContain('○ i1 ›');
+                expect(stdoutObserved).toContain(`🫡  on it!`);
+            });
+        });
+    });
+    (0, test_fns_1.given)('a simple file write', () => {
+        // declare the demo config via path
+        const configPath = node_path_1.default.resolve(directory_1.TEST_FIXTURE_DIRECTORY, './example.use.repo/example.rhachet.use.ts');
+        (0, test_fns_1.when)('asked to perform a skill registered in the config 3 times', () => {
+            const opts = {
+                config: configPath,
+                output: directory_1.TEST_FIXTURE_DIRECTORY +
+                    `/example.use.repo/.tmp/performInIsolatedThreads/${Date.now()}.demo.md`,
+                role: 'echoer',
+                skill: 'write',
+                attempts: 3,
+                ask: 'do it',
+            };
+            (0, test_fns_1.then)('it should successfully execute do so', async () => {
+                await (0, performInIsolatedThreads_1.performInIsolatedThreads)({ opts });
+            });
+            (0, test_fns_1.then)('it should have logged with observable prefixes', async () => {
+                expect(stdoutObserved).toContain('○ i1 ›');
+                expect(stdoutObserved).toContain(`🫡  on it!`);
+            });
+            (0, test_fns_1.then)('it should written files to the expected paths', async () => {
+                const artifactsExpected = [
+                    (0, rhachet_artifact_git_1.genArtifactGitFile)({ uri: opts.output.replace(/\.md$/, '.i1.md') }),
+                    (0, rhachet_artifact_git_1.genArtifactGitFile)({ uri: opts.output.replace(/\.md$/, '.i2.md') }),
+                    (0, rhachet_artifact_git_1.genArtifactGitFile)({ uri: opts.output.replace(/\.md$/, '.i3.md') }),
+                ];
+                await Promise.all(artifactsExpected.map(async (art) => expect((await art.get())?.content).toEqual(opts.ask)));
+            });
+        });
+    });
+});
+//# sourceMappingURL=performInIsolatedThreads.integration.test.js.map

package/dist/logic/invoke/performInIsolatedThreads.integration.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"performInIsolatedThreads.integration.test.js","sourceRoot":"","sources":["../../../src/logic/invoke/performInIsolatedThreads.integration.test.ts"],"names":[],"mappings":";;;;;AAAA,0DAA6B;AAC7B,+DAA0D;AAC1D,uCAA6C;AAE7C,qDAA+D;AAC/D,yEAAsE;AAEtE,QAAQ,CAAC,0BAA0B,EAAE,GAAG,EAAE;IACxC,iBAAiB;IACjB,IAAI,cAAc,GAAG,EAAE,CAAC;IACxB,MAAM,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;IAC3C,SAAS,CAAC,GAAG,EAAE;QACZ,OAAO,CAAC,MAAM,CAAC,KAAa,GAAG,CAAC,KAAU,EAAE,GAAG,IAAW,EAAE,EAAE;YAC7D,cAAc,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YACnC,OAAQ,aAAqB,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC,CAAC;QACrE,CAAC,CAAC;IACJ,CAAC,CAAC,CAAC;IACH,QAAQ,CAAC,GAAG,EAAE;QACX,OAAO,CAAC,MAAM,CAAC,KAAa,GAAG,aAAa,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,IAAA,gBAAK,EAAC,oBAAoB,EAAE,GAAG,EAAE;QAC/B,mCAAmC;QACnC,MAAM,UAAU,GAAG,mBAAI,CAAC,OAAO,CAC7B,kCAAsB,EACtB,2CAA2C,CAC5C,CAAC;QAEF,IAAA,eAAI,EAAC,2DAA2D,EAAE,GAAG,EAAE;YACrE,MAAM,IAAI,GAAG;gBACX,MAAM,EAAE,UAAU;gBAClB,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,MAAM;gBACb,QAAQ,EAAE,CAAC;gBACX,GAAG,EAAE,OAAO;aACb,CAAC;YAEF,IAAA,eAAI,EAAC,sCAAsC,EAAE,KAAK,IAAI,EAAE;gBACtD,MAAM,IAAA,mDAAwB,EAAC,EAAE,IAAI,EAAE,CAAC,CAAC;YAC3C,CAAC,CAAC,CAAC;YACH,IAAA,eAAI,EAAC,gDAAgD,EAAE,KAAK,IAAI,EAAE;gBAChE,MAAM,CAAC,cAAc,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;gBAC3C,MAAM,CAAC,cAAc,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;YACjD,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,IAAA,gBAAK,EAAC,qBAAqB,EAAE,GAAG,EAAE;QAChC,mCAAmC;QACnC,MAAM,UAAU,GAAG,mBAAI,CAAC,OAAO,CAC7B,kCAAsB,EACtB,2CAA2C,CAC5C,CAAC;QAEF,IAAA,eAAI,EAAC,2DAA2D,EAAE,GAAG,EAAE;YACrE,MAAM,IAAI,GAAG;gBACX,MAAM,EAAE,UAAU;gBAClB,MAAM,EACJ,kCAAsB;oBACtB,mDAAmD,IAAI,CAAC,GAAG,EAAE,UAAU;gBACzE,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,OAAO;gBACd,QAAQ,EAAE,CAAC;gBACX,GAAG,EAAE,OAAO;aACb,CAAC;YAEF,IAAA,eAAI,EAAC,sCAAsC,EAAE,KAAK,IAAI,EAAE;gBACtD,MAAM,IAAA,mDAAwB,EAAC,EAAE,IAAI,EAAE,CAAC,CAAC;YAC3C,CAAC,CAAC,CAAC;YACH,IAAA,eAAI,EAAC,gDAAgD,EAAE,KAAK,IAAI,EAAE;gBAChE,MAAM,CAAC,cAAc,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;gBAC3C,MAAM,CAAC,cAAc,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;YACjD,CAAC,CAAC,CAAC;YACH,IAAA,eAAI,EAAC,+CAA+C,EAAE,KAAK,IAAI,EAAE;gBAC/D,MAAM,iBAAiB,GAAG;oBACxB,IAAA,yCAAkB,EAAC,EAAE,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE,CAAC;oBACnE,IAAA,yCAAkB,EAAC,EAAE,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE,CAAC;oBACnE,IAAA,yCAAkB,EAAC,EAAE,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE,CAAC;iBACpE,CAAC;gBACF,MAAM,OAAO,CAAC,GAAG,CACf,iBAAiB,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE,CAClC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC,GAAG,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CACrD,CACF,CAAC;YACJ,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/logic/invoke/performInIsolatedThreads.js

@@ -0,0 +1,99 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.performInIsolatedThreads = void 0;
+const uni_time_1 = require("@ehmpathy/uni-time");
+const bottleneck_1 = __importDefault(require("bottleneck"));
+const helpful_errors_1 = require("helpful-errors");
+const addAttemptQualifierToOutputPath_1 = require("./addAttemptQualifierToOutputPath");
+const performInIsolatedThread_invoke_1 = require("./performInIsolatedThread.invoke");
+/**
+ * .what = performs a skill in one-or-more isolated threads concurrently
+ * .why =
+ *   - enables multiple attempts of the same performance, to compare different takes of the same skill
+ *   - given llm's may produce divergent results on reinvocation, this is useful to...
+ *     - support the attempt-&-blend pattern
+ *     - evaluate the consistency of a skill applied to your ask
+ *     - etc
+ * .how =
+ *    - spawns isolated child threads and performs the skill within each of those threads
+ */
+const performInIsolatedThreads = async (input) => {
+    // validate that attempts were requested
+    if (!input.opts.attempts)
+        helpful_errors_1.BadRequestError.throw('--attempts was not provided', {
+            argv: input.opts,
+        });
+    // validate that more than one attempt was declared
+    const attempts = Number(input.opts.attempts);
+    if (!Number.isInteger(attempts))
+        helpful_errors_1.BadRequestError.throw('--attempts must be an integer', {
+            attempts: { input: input.opts.attempts, asNum: input.opts.attempts },
+        });
+    if (attempts < 1)
+        helpful_errors_1.BadRequestError.throw('--attempts must be greater than one', {
+            attempts: { input: input.opts.attempts, asNum: input.opts.attempts },
+        });
+    // parse concurrency (defaults to 3 if unset); concurrency governs parallelism, not the number of attempts
+    const concurrency = input.opts.concurrency
+        ? Number(input.opts.concurrency)
+        : 3;
+    if (!Number.isInteger(concurrency))
+        helpful_errors_1.BadRequestError.throw('--concurrency must be an integer', {
+            concurrency: {
+                input: input.opts.concurrency,
+                asNum: input.opts.concurrency,
+            },
+        });
+    if (concurrency < 1)
+        helpful_errors_1.BadRequestError.throw('--concurrency must be greater than one', {
+            concurrency: {
+                input: input.opts.concurrency,
+                asNum: input.opts.concurrency,
+            },
+        });
+    // cast the argv per attempt; i.e., replace the output in each
+    const attemptArgvs = Array.from({ length: attempts }, (_, i) => ({
+        ...input.opts,
+        attempt: i + 1,
+        // qualify the output, if output was specified
+        output: input.opts.output
+            ? (0, addAttemptQualifierToOutputPath_1.addAttemptQualifierToOutputPath)({
+                path: input.opts.output,
+                attempt: i + 1,
+            })
+            : undefined,
+    }));
+    // orchestrate the child processes using bottleneck for concurrency control
+    const bottleneck = new bottleneck_1.default({ maxConcurrent: concurrency });
+    const beganAt = Date.now();
+    const results = await Promise.all(attemptArgvs.map((argv) => bottleneck.schedule(() => (0, performInIsolatedThread_invoke_1.performInIsolatedThread)({
+        opts: argv,
+        peer: { attempts },
+    }))));
+    const wallTime = ((Date.now() - beganAt) / 1000).toFixed(1) + 's';
+    // print summary: per-attempt status + durations
+    const rows = results.map((r) => ({
+        // attempt: r.attempt, // ?: console.table already includes an "index" column which we cant remove, so this is redundant in display
+        status: r.code === 0 ? 'ok' : 'fail',
+        duration: (0, uni_time_1.asDurationInWords)(r.clock.duration),
+    }));
+    console.log(`\nsummary (${results.length} attempts):`);
+    console.table(rows);
+    // print overall outcome banner
+    const ok = rows.filter((r) => r.status === 'ok').length;
+    const fail = rows.length - ok;
+    console.log(`\n${ok} succeeded, ${fail} failed • total wall time: ${wallTime}`);
+    // print output file paths in order
+    if (input.opts.output) {
+        console.log('\noutputs:');
+        for (const argv of attemptArgvs)
+            console.log('-', argv.output);
+    }
+    // parent exit code: 0 iff all succeed; non-zero if any fail
+    process.exitCode = fail > 0 ? 1 : 0;
+};
+exports.performInIsolatedThreads = performInIsolatedThreads;
+//# sourceMappingURL=performInIsolatedThreads.js.map

package/dist/logic/invoke/performInIsolatedThreads.js.map

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

package/package.json

@@ -2,7 +2,7 @@
   "name": "rhachet",
   "author": "ehmpathy",
   "description": "A framework for reliable, thorough thought. Weave threads of thought via stitches.",
-  "version": "1.6.0",
+  "version": "1.7.1",
   "repository": "ehmpathy/rhachet",
   "homepage": "https://github.com/ehmpathy/rhachet",
   "keywords": [
@@ -51,8 +51,10 @@
     "prepare:husky": "npx husky install && chmod ug+x .husky/*"
   },
   "dependencies": {
-    "@ehmpathy/uni-time": "1.8.2",
+    "@ehmpathy/uni-time": "1.9.0",
     "as-procedure": "1.1.6",
+    "bottleneck": "2.19.5",
+    "chalk": "4.1.2",
     "commander": "14.0.0",
     "domain-objects": "0.25.2",
     "flattie": "1.1.1",
@@ -60,8 +62,9 @@
     "openai": "5.8.2",
     "rhachet-artifact": "1.0.0",
     "rhachet-artifact-git": "1.1.0",
-    "serde-fns": "1.3.0",
+    "serde-fns": "1.3.1",
     "test-fns": "1.5.0",
+    "tsx": "4.20.5",
     "type-fns": "1.19.0",
     "uuid-fns": "1.0.1"
   },
@@ -74,7 +77,7 @@
     "@typescript-eslint/eslint-plugin": "7.8.0",
     "@typescript-eslint/parser": "7.8.0",
     "core-js": "3.26.1",
-    "cz-conventional-changelog": "3.3.0",
+    "cz-conventional-changelog": "3.0.1",
     "declapract": "0.12.2",
     "declapract-typescript-ehmpathy": "0.39.9",
     "depcheck": "1.4.3",

package/readme.md

@@ -3,15 +3,15 @@
 ![test](https://github.com/ehmpathy/rhachet/workflows/test/badge.svg)
 ![publish](https://github.com/ehmpathy/rhachet/workflows/publish/badge.svg)
 
-Build reusable roles with rhachet: a framework for reliable, thorough thought.
+Build reusable roles with rhachet: a framework for reliable, composable, and iteratively improvable thought.
 
 > Weave threads 🧵 of thought, stitched 🪡  with a rhachet ⚙️
 
 # vision
 
-Unlock digital clones built by you, who work even from your laptop, and work for anyone you choose.
+Build or use digital actors, who work even from your laptop, and work for anyone you choose.
 
-Distill your skills and roles systematically, with rhachet. Use them, share them, open source them. The choice is yours.
+Distill your skills and roles iteratively, with rhachet. Use them, compose them, share them, open source them. The choice is yours.
 
 - With open source top to bottom, we can raise the floor and prosper collectively.
 - With observable routes of thought, we can not only debug, but align.
@@ -23,10 +23,11 @@ Here's to a solarpunk future of abundance 🌞🌴
 
 1. declare thought routes, reusably and maintainably
 2. apply thought routes, observably and reliably
-3. compose and accumulate reusable thought tactics
+3. compose and accumulate reusable thought skill
 4. assure slipless progress towards goals, like a ratchet (🎼 click, click, click)
-5. assure guarded budgets of money and time, with route plans, expense approvals, and circuit breakers
-6. observe thought routes and weaves intuitively
+5. enable iterative improvement of skills, like a ratchet (🎼 click, click, click)
+6. assure guarded budgets of money and time, with route plans, expense approvals, and circuit breakers
+7. observe thought routes and weaves intuitively
 
 # install
 
@@ -45,16 +46,34 @@ looks for `@gitroot/rhachet.use.ts` by default
 
 ```ts
 // @/rhachet.use.ts
+import { getRoleRegistry as getBhrainRegistry } from 'rhachet-roles-bhrain';
 import { getRoleRegistry as getEhmpathyRegistry } from 'rhachet-roles-ehmpathy';
 
 export const getRoleRegistries = () => [
+  getBhrainRegistry(),
   getEhmpathyRegistry(),
   // whichever other registries you'd like
 ]
 ```
 
-### invoke the role
+### perform a skill
 
 ```sh
-npx rhachet ask --role mechanic --skill upsert --ask "add endpoint to get weather"
+npx rhachet act \
+  --repo bhrain --role skeptic --skill review \
+  --ask "are birds real? or are they just government drones 🤔"
+```
+
+```sh
+npx rhachet act \
+  --repo ehmpathy --role mechanic --skill review \
+  --input "https://github.com/ehmpathy/simple-in-memory-cache/pull/9" \
+  --ask "review this pr"
+```
+
+```sh
+npx rhachet act \
+  --repo ehmpathy --role mechanic --skill deliver \
+  --input "https://github.com/ehmpathy/domain-objects/issues/7" \
+  --ask "push a pr to solve the issue"
 ```

package/dist/contract/cli/.test/example.echoRegistry.js

@@ -1,54 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.EXAMPLE_REGISTRY = void 0;
-const genThread_1 = require("../../../logic/thread/genThread");
-const sdk_1 = require("../../sdk");
-const stepEchoAsk = new sdk_1.StitchStepCompute({
-    slug: 'echo.step',
-    form: 'COMPUTE',
-    stitchee: 'caller',
-    readme: 'simple echo logic',
-    invoke: async ({ threads }, context) => {
-        context.log.info('echo:', { ask: threads.caller.context.ask });
-        return {
-            input: null,
-            output: `echo: ${threads.caller.context.ask}`,
-        };
-    },
-});
-const echoSkill = sdk_1.RoleSkill.build({
-    slug: 'echo',
-    readme: 'Echoes back the ask string.',
-    route: stepEchoAsk,
-    threads: {
-        lookup: {},
-        assess: (input) => true,
-        instantiate: (input) => ({
-            caller: (0, genThread_1.genThread)({ role: 'caller', ask: input.ask }),
-        }),
-    },
-    context: {
-        lookup: {},
-        assess: (input) => true,
-        instantiate: () => ({
-            log: console,
-            stitch: {
-                trail: [],
-            },
-        }),
-    },
-});
-const echoRole = sdk_1.Role.build({
-    slug: 'echoer',
-    name: 'Echoer',
-    purpose: 'repeat things',
-    readme: 'knows how to echo input back to the user.',
-    traits: [],
-    skills: [echoSkill],
-});
-exports.EXAMPLE_REGISTRY = new sdk_1.RoleRegistry({
-    slug: 'echo',
-    readme: 'basic registry for testing CLI execution',
-    roles: [echoRole],
-});
-//# sourceMappingURL=example.echoRegistry.js.map

package/dist/contract/cli/.test/example.echoRegistry.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"example.echoRegistry.js","sourceRoot":"","sources":["../../../../src/contract/cli/.test/example.echoRegistry.ts"],"names":[],"mappings":";;;AAEA,+DAA4D;AAC5D,mCAQmB;AAEnB,MAAM,WAAW,GAAG,IAAI,uBAAiB,CAEvC;IACA,IAAI,EAAE,WAAW;IACjB,IAAI,EAAE,SAAS;IACf,QAAQ,EAAE,QAAQ;IAClB,MAAM,EAAE,mBAAmB;IAC3B,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,EAAE;QACrC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,GAAG,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;QAC/D,OAAO;YACL,KAAK,EAAE,IAAI;YACX,MAAM,EAAE,SAAS,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE;SAC9C,CAAC;IACJ,CAAC;CACF,CAAC,CAAC;AAEH,MAAM,SAAS,GAAG,eAAS,CAAC,KAAK,CAA6C;IAC5E,IAAI,EAAE,MAAM;IACZ,MAAM,EAAE,6BAA6B;IACrC,KAAK,EAAE,WAAW;IAClB,OAAO,EAAE;QACP,MAAM,EAAE,EAAE;QACV,MAAM,EAAE,CAAC,KAAK,EAAkB,EAAE,CAAC,IAAI;QACvC,WAAW,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YACvB,MAAM,EAAE,IAAA,qBAAS,EAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC;SACtD,CAAC;KACH;IACD,OAAO,EAAE;QACP,MAAM,EAAE,EAAE;QACV,MAAM,EAAE,CAAC,KAAU,EAAkB,EAAE,CAAC,IAAI;QAC5C,WAAW,EAAE,GAAG,EAAE,CAAC,CAAC;YAClB,GAAG,EAAE,OAAO;YACZ,MAAM,EAAE;gBACN,KAAK,EAAE,EAAE;aACV;SACF,CAAC;KACH;CACF,CAAC,CAAC;AACH,MAAM,QAAQ,GAAG,UAAI,CAAC,KAAK,CAAC;IAC1B,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,QAAQ;IACd,OAAO,EAAE,eAAe;IACxB,MAAM,EAAE,2CAA2C;IACnD,MAAM,EAAE,EAAE;IACV,MAAM,EAAE,CAAC,SAAS,CAAC;CACpB,CAAC,CAAC;AAEU,QAAA,gBAAgB,GAAG,IAAI,kBAAY,CAAC;IAC/C,IAAI,EAAE,MAAM;IACZ,MAAM,EAAE,0CAA0C;IAClD,KAAK,EAAE,CAAC,QAAQ,CAAC;CAClB,CAAC,CAAC"}