@intellia/workflow-sdk 0.1.0

package/dist/esm/define-node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-node.js","sourceRoot":"","sources":["../../src/define-node.ts"],"names":[],"mappings":"AAYA,MAAM,CAAC,MAAM,cAAc,GAAG,CAAO,IAAuB,EAAqB,EAAE,CAAC,IAAI,CAAC;AAiBzF,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAI,IAA8B,EAA4B,EAAE,CAAC,IAAI,CAAC"}

package/dist/esm/define-tool-workflow.js

@@ -0,0 +1,30 @@
+import { Builder, IdAllocator } from "./builder";
+import { handleFor } from "./refs";
+export const defineToolWorkflow = (spec) => ({
+    record() {
+        var _a;
+        const ids = new IdAllocator();
+        if (typeof spec.endNodeId === "string")
+            ids.reserve(spec.endNodeId);
+        if (spec.outputNodeId !== undefined)
+            ids.reserve(spec.outputNodeId);
+        const root = new Builder(ids);
+        const output = spec.build(root, handleFor("$.results.trigger"));
+        return {
+            name: spec.name,
+            description: (_a = spec.description) !== null && _a !== void 0 ? _a : spec.name,
+            slug: spec.slug,
+            kind: "tool",
+            trigger: { type: "json", name: spec.triggerName, input: spec.input },
+            scope: root.scope,
+            output,
+            outputSchema: spec.output,
+            ids,
+            endNodeId: spec.endNodeId,
+            endNodeName: spec.endNodeName,
+            outputNodeId: spec.outputNodeId,
+            outputNodeName: spec.outputNodeName,
+        };
+    },
+});
+//# sourceMappingURL=define-tool-workflow.js.map

package/dist/esm/define-tool-workflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-tool-workflow.js","sourceRoot":"","sources":["../../src/define-tool-workflow.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,SAAS,EAAe,MAAM,QAAQ,CAAC;AAuBhD,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAChC,IAAuC,EACvB,EAAE,CAAC,CAAC;IACpB,MAAM;;QACJ,MAAM,GAAG,GAAG,IAAI,WAAW,EAAE,CAAC;QAC9B,IAAI,OAAO,IAAI,CAAC,SAAS,KAAK,QAAQ;YAAE,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACpE,IAAI,IAAI,CAAC,YAAY,KAAK,SAAS;YAAE,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACpE,MAAM,IAAI,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC;QAC9B,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,SAAS,CAAS,mBAAmB,CAAC,CAAC,CAAC;QAExE,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,WAAW,EAAE,MAAA,IAAI,CAAC,WAAW,mCAAI,IAAI,CAAC,IAAI;YAC1C,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,MAAM;YACZ,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE;YACpE,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,MAAM;YACN,YAAY,EAAE,IAAI,CAAC,MAAM;YACzB,GAAG;YACH,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,cAAc,EAAE,IAAI,CAAC,cAAc;SACpC,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}

package/dist/esm/define-tool.js

@@ -0,0 +1,2 @@
+export const defineTool = (spec) => spec;
+//# sourceMappingURL=define-tool.js.map

package/dist/esm/define-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-tool.js","sourceRoot":"","sources":["../../src/define-tool.ts"],"names":[],"mappings":"AA8CA,MAAM,CAAC,MAAM,UAAU,GAAG,CAAyC,IAKlE,EAAe,EAAE,CAAC,IAAI,CAAC"}

package/dist/esm/define-workflow.js

@@ -0,0 +1,36 @@
+import { Builder, IdAllocator } from "./builder";
+import { handleFor } from "./refs";
+export const defineWorkflow = (spec) => ({
+    record() {
+        var _a, _b;
+        const ids = new IdAllocator();
+        // Reserved before `build()` runs, so a body node's auto-derived id
+        // yields to it (via allocate()'s suffixing) rather than claiming it
+        // first and making this throw.
+        if (typeof spec.endNodeId === "string")
+            ids.reserve(spec.endNodeId);
+        if (spec.outputNodeId !== undefined)
+            ids.reserve(spec.outputNodeId);
+        const root = new Builder(ids);
+        const trigger = handleFor("$.results.trigger");
+        const output = (_a = spec.build(root, trigger)) !== null && _a !== void 0 ? _a : undefined;
+        const failureScope = root.recordBranch(spec.onFailure);
+        const triggerSpec = { type: spec.trigger.type, name: spec.trigger.name, input: spec.trigger.input };
+        return {
+            name: spec.name,
+            description: (_b = spec.description) !== null && _b !== void 0 ? _b : spec.name,
+            slug: spec.slug,
+            kind: "standard",
+            trigger: triggerSpec,
+            scope: root.scope,
+            output,
+            onFailure: failureScope,
+            ids,
+            endNodeId: spec.endNodeId,
+            endNodeName: spec.endNodeName,
+            outputNodeId: spec.outputNodeId,
+            outputNodeName: spec.outputNodeName,
+        };
+    },
+});
+//# sourceMappingURL=define-workflow.js.map

package/dist/esm/define-workflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-workflow.js","sourceRoot":"","sources":["../../src/define-workflow.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,SAAS,EAAe,MAAM,QAAQ,CAAC;AAmBhD,MAAM,CAAC,MAAM,cAAc,GAAG,CAAS,IAA0B,EAAkB,EAAE,CAAC,CAAC;IACrF,MAAM;;QACJ,MAAM,GAAG,GAAG,IAAI,WAAW,EAAE,CAAC;QAC9B,mEAAmE;QACnE,oEAAoE;QACpE,+BAA+B;QAC/B,IAAI,OAAO,IAAI,CAAC,SAAS,KAAK,QAAQ;YAAE,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACpE,IAAI,IAAI,CAAC,YAAY,KAAK,SAAS;YAAE,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACpE,MAAM,IAAI,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC;QAC9B,MAAM,OAAO,GAAG,SAAS,CAAS,mBAAmB,CAAC,CAAC;QACvD,MAAM,MAAM,GAAG,MAAA,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,mCAAI,SAAS,CAAC;QAEtD,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAEvD,MAAM,WAAW,GAAgB,EAAE,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QAEjH,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,WAAW,EAAE,MAAA,IAAI,CAAC,WAAW,mCAAI,IAAI,CAAC,IAAI;YAC1C,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,UAAU;YAChB,OAAO,EAAE,WAAW;YACpB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,MAAM;YACN,SAAS,EAAE,YAAY;YACvB,GAAG;YACH,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,cAAc,EAAE,IAAI,CAAC,cAAc;SACpC,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}

package/dist/esm/graph.js

@@ -0,0 +1 @@
+//# sourceMappingURL=graph.js.map

package/dist/esm/graph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.js","sourceRoot":"","sources":["../../src/graph.ts"],"names":[],"mappings":""}

package/dist/esm/index.js

@@ -0,0 +1,12 @@
+export { z, toJsonSchema, artifact } from "./schema";
+export { handleFor, isRef, refPath, isTpl, tplText, tpl, encodeValue, } from "./refs";
+export { defineFunction, defineWholeStateFunction } from "./define-node";
+export { defineTool } from "./define-tool";
+export { defineKnowledgeBase } from "./define-knowledge-base";
+export { defineAgentRef } from "./define-agent-ref";
+export { Builder, IdAllocator } from "./builder";
+export { defineWorkflow } from "./define-workflow";
+export { eq, gt, gte, lt, lte, contains, isNull, isPresent, jsonata } from "./conditions";
+export { defineToolWorkflow } from "./define-tool-workflow";
+export { NODE_TYPE_SUPPORT } from "./node-type-support";
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACrD,OAAO,EACL,SAAS,EACT,KAAK,EACL,OAAO,EACP,KAAK,EACL,OAAO,EACP,GAAG,EACH,WAAW,GACZ,MAAM,QAAQ,CAAC;AAEhB,OAAO,EAAE,cAAc,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AAEzE,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAS3C,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAE9D,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEpD,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAUjD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGnD,OAAO,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE1F,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAE5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/esm/node-type-support.js

@@ -0,0 +1,24 @@
+import { Builder } from "./builder";
+export const NODE_TYPE_SUPPORT = {
+    trigger: {
+        status: "not-expressible",
+        reason: "Declared via defineWorkflow()'s `trigger` option (define-workflow.ts), not appended as a graph node — every workflow has exactly one, fixed at definition time, never authored mid-scope.",
+    },
+    approval: { status: "expressible", builder: Builder.prototype.approval },
+    conditional: { status: "expressible", builder: Builder.prototype.if },
+    end: {
+        status: "not-expressible",
+        reason: "Synthesized unconditionally by emitDefinition (workflow-compiler/src/emit.ts) as the workflow's implicit terminal node — every recorded scope needs exactly one, generated at emit time, never authored.",
+    },
+    noop: { status: "expressible", builder: Builder.prototype.noop },
+    agent: { status: "expressible", builder: Builder.prototype.agent },
+    "tool-call": { status: "expressible", builder: Builder.prototype.toolCall },
+    function: { status: "expressible", builder: Builder.prototype.function },
+    bash: { status: "expressible", builder: Builder.prototype.bash },
+    parallel: { status: "expressible", builder: Builder.prototype.parallel },
+    repeat: { status: "expressible", builder: Builder.prototype.forEach },
+    "wait-for-callback": { status: "expressible", builder: Builder.prototype.waitForCallback },
+    "set-output": { status: "expressible", builder: Builder.prototype.setOutput },
+    "execute-workflow": { status: "expressible", builder: Builder.prototype.executeWorkflow },
+};
+//# sourceMappingURL=node-type-support.js.map

package/dist/esm/node-type-support.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-type-support.js","sourceRoot":"","sources":["../../src/node-type-support.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAepC,MAAM,CAAC,MAAM,iBAAiB,GAA8C;IAC1E,OAAO,EAAE;QACP,MAAM,EAAE,iBAAiB;QACzB,MAAM,EACJ,2LAA2L;KAC9L;IACD,QAAQ,EAAE,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,QAAQ,EAAE;IACxE,WAAW,EAAE,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,EAAE,EAAE;IACrE,GAAG,EAAE;QACH,MAAM,EAAE,iBAAiB;QACzB,MAAM,EACJ,0MAA0M;KAC7M;IACD,IAAI,EAAE,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,IAAI,EAAE;IAChE,KAAK,EAAE,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,KAAK,EAAE;IAClE,WAAW,EAAE,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,QAAQ,EAAE;IAC3E,QAAQ,EAAE,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,QAAQ,EAAE;IACxE,IAAI,EAAE,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,IAAI,EAAE;IAChE,QAAQ,EAAE,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,QAAQ,EAAE;IACxE,MAAM,EAAE,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,OAAO,EAAE;IACrE,mBAAmB,EAAE,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,eAAe,EAAE;IAC1F,YAAY,EAAE,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,SAAS,EAAE;IAC7E,kBAAkB,EAAE,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,eAAe,EAAE;CACtC,CAAC"}

package/dist/esm/package.json

@@ -0,0 +1 @@
+{"type":"module"}

package/dist/esm/refs.js

@@ -0,0 +1,42 @@
+const REF = Symbol.for("hutly.workflow.ref");
+const TPL = Symbol.for("hutly.workflow.tpl");
+export const isRef = (v) => typeof v === "object" && v !== null && REF in v;
+export const refPath = (r) => r[REF];
+export const isTpl = (v) => typeof v === "object" && v !== null && TPL in v;
+export const tplText = (t) => t[TPL];
+export const handleFor = (basePath) => new Proxy({}, {
+    get(_target, prop) {
+        if (prop === REF)
+            return basePath;
+        if (typeof prop === "symbol")
+            return undefined;
+        return handleFor(`${basePath}.${prop}`);
+    },
+    has(_target, prop) {
+        return prop === REF;
+    },
+});
+// Handlebars references the state root directly, with no leading `$.`.
+const toHandlebars = (r) => `{{ ${refPath(r).replace(/^\$\./, "")} }}`;
+export const tpl = (strings, ...vals) => {
+    let out = strings[0];
+    for (let i = 0; i < vals.length; i += 1) {
+        const v = vals[i];
+        out += isRef(v) ? toHandlebars(v) : String(v);
+        out += strings[i + 1];
+    }
+    return { [TPL]: out };
+};
+export const encodeValue = (v) => {
+    if (isRef(v))
+        return refPath(v);
+    if (isTpl(v))
+        return tplText(v);
+    if (Array.isArray(v))
+        return v.map(encodeValue);
+    if (v !== null && typeof v === "object") {
+        return Object.fromEntries(Object.entries(v).map(([k, x]) => [k, encodeValue(x)]));
+    }
+    return v;
+};
+//# sourceMappingURL=refs.js.map

package/dist/esm/refs.js.map

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

package/dist/esm/schema.js

@@ -0,0 +1,62 @@
+import { z } from "zod/v4";
+export { z };
+// `z.toJSONSchema` reads `.describe()`/`.meta()` metadata via `z.globalRegistry`
+// — a per-zod-module-instance `WeakMap`. A schema built by a DIFFERENT zod
+// module instance (e.g. bundled separately into a vm-executed workflow entry
+// — see `workflow-compiler/src/execute.ts`) has its own registry, so that
+// lookup silently finds nothing, even though structural fields
+// (type/properties/required) still convert correctly via duck-typed access.
+// The schema's own `.description` getter, though, is a closure bound to
+// whichever registry actually holds the metadata, so reading it works
+// regardless of which zod instance built the schema — it's a plain property
+// read, not an identity check. This walks the zod schema's PUBLIC, documented
+// shape accessors (`.def.type`, `.shape`, `.element`, `.unwrap()`) in
+// parallel with the JSON Schema `z.toJSONSchema` already produced, backfilling
+// any `description` the registry lookup missed. Covers the constructs the SDK
+// and the real corpus actually use (object/array/optional/default); anything
+// else (union, record, nullable's `anyOf` wrapping, ...) falls through
+// unmerged — no worse than before this existed, just not extended to those.
+const backfillDescriptions = (t, node) => {
+    var _a;
+    const description = t.description;
+    if (node.description === undefined && typeof description === "string") {
+        node.description = description;
+    }
+    const kind = (_a = t.def) === null || _a === void 0 ? void 0 : _a.type;
+    if (kind === "object" && node.properties) {
+        const shape = t.shape;
+        for (const [key, sub] of Object.entries(shape)) {
+            const propNode = node.properties[key];
+            if (propNode) {
+                backfillDescriptions(sub, propNode);
+            }
+        }
+    }
+    else if (kind === "array" && node.items) {
+        const element = t.element;
+        backfillDescriptions(element, node.items);
+    }
+    else if (kind === "optional" || kind === "default" || kind === "nonoptional") {
+        // These wrappers add no JSON Schema nesting level of their own (optional
+        // only affects `required`; default keeps the wrapped type's shape), so
+        // the inner schema's fields land at this SAME node.
+        const unwrap = t.unwrap;
+        if (typeof unwrap === "function") {
+            backfillDescriptions(unwrap(), node);
+        }
+    }
+};
+// The repo's ajv schemas and every hand-written workflow use draft-07; zod's
+// default target is 2020-12, which ajv would reject.
+export const toJsonSchema = (t) => {
+    const result = z.toJSONSchema(t, { target: "draft-7" });
+    backfillDescriptions(t, result);
+    return result;
+};
+// A pointer to bytes held out-of-band, so a large payload never rides the
+// Step Functions state.
+export const artifact = () => z.object({
+    artifactId: z.string().max(64),
+    filename: z.string().max(255),
+});
+//# sourceMappingURL=schema.js.map

package/dist/esm/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAG3B,OAAO,EAAE,CAAC,EAAE,CAAC;AAyCb,iFAAiF;AACjF,2EAA2E;AAC3E,6EAA6E;AAC7E,0EAA0E;AAC1E,+DAA+D;AAC/D,4EAA4E;AAC5E,wEAAwE;AACxE,sEAAsE;AACtE,4EAA4E;AAC5E,8EAA8E;AAC9E,sEAAsE;AACtE,+EAA+E;AAC/E,8EAA8E;AAC9E,6EAA6E;AAC7E,uEAAuE;AACvE,4EAA4E;AAC5E,MAAM,oBAAoB,GAAG,CAAC,CAAY,EAAE,IAAgB,EAAQ,EAAE;;IACpE,MAAM,WAAW,GAAI,CAA0C,CAAC,WAAW,CAAC;IAC5E,IAAI,IAAI,CAAC,WAAW,KAAK,SAAS,IAAI,OAAO,WAAW,KAAK,QAAQ,EAAE,CAAC;QACtE,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IACjC,CAAC;IAED,MAAM,IAAI,GAAG,MAAC,CAA4C,CAAC,GAAG,0CAAE,IAAI,CAAC;IACrE,IAAI,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;QACzC,MAAM,KAAK,GAAI,CAAqD,CAAC,KAAK,CAAC;QAC3E,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAC/C,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;YACtC,IAAI,QAAQ,EAAE,CAAC;gBACb,oBAAoB,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;YACtC,CAAC;QACH,CAAC;IACH,CAAC;SAAM,IAAI,IAAI,KAAK,OAAO,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QAC1C,MAAM,OAAO,GAAI,CAAuC,CAAC,OAAO,CAAC;QACjE,oBAAoB,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;IAC5C,CAAC;SAAM,IAAI,IAAI,KAAK,UAAU,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,aAAa,EAAE,CAAC;QAC/E,yEAAyE;QACzE,uEAAuE;QACvE,oDAAoD;QACpD,MAAM,MAAM,GAAI,CAA6C,CAAC,MAAM,CAAC;QACrE,IAAI,OAAO,MAAM,KAAK,UAAU,EAAE,CAAC;YACjC,oBAAoB,CAAC,MAAM,EAAE,EAAE,IAAI,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;AACH,CAAC,CAAC;AAEF,6EAA6E;AAC7E,qDAAqD;AACrD,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAY,EAAc,EAAE;IACvD,MAAM,MAAM,GAAG,CAAC,CAAC,YAAY,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,CAAe,CAAC;IACtE,oBAAoB,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IAChC,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAEF,0EAA0E;AAC1E,wBAAwB;AACxB,MAAM,CAAC,MAAM,QAAQ,GAAG,GAAG,EAAE,CAC3B,CAAC,CAAC,MAAM,CAAC;IACP,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC;IAC9B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC;CAC9B,CAAC,CAAC"}