@entelligentsia/forgecli 0.6.6 → 0.7.6

package/dist/extensions/forgecli/wf-engine/event-parser.d.ts

@@ -0,0 +1,6 @@
+import type { Event } from "./types.js";
+export interface ParsedEvents {
+    events: Event[];
+    rawBlock?: string;
+}
+export declare function parseEventsBlock(response: string): ParsedEvents;

package/dist/extensions/forgecli/wf-engine/event-parser.js

@@ -0,0 +1,29 @@
+// Match any ```json events ... ``` block; g flag so we can take the last one.
+// LLMs often emit the block mid-response followed by explanatory prose, so we
+// cannot anchor to $ — we take the last occurrence instead.
+const FENCE_RE = /```json\s+events\s*\n([\s\S]*?)\n```/g;
+export function parseEventsBlock(response) {
+    // Scan all matches; keep the last one (the actual output, not prompt examples).
+    let last = null;
+    let m;
+    const re = new RegExp(FENCE_RE.source, "g");
+    while ((m = re.exec(response)) !== null) {
+        last = m;
+    }
+    if (!last) {
+        return { events: [] };
+    }
+    const block = last[1];
+    let arr;
+    try {
+        arr = JSON.parse(block);
+    }
+    catch (err) {
+        throw new Error(`events block is not valid JSON: ${err.message}`);
+    }
+    if (!Array.isArray(arr)) {
+        throw new Error(`events block must be a JSON array, got ${typeof arr}`);
+    }
+    return { events: arr, rawBlock: block };
+}
+//# sourceMappingURL=event-parser.js.map

package/dist/extensions/forgecli/wf-engine/event-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-parser.js","sourceRoot":"","sources":["../../../../src/extensions/forgecli/wf-engine/event-parser.ts"],"names":[],"mappings":"AAEA,8EAA8E;AAC9E,8EAA8E;AAC9E,4DAA4D;AAC5D,MAAM,QAAQ,GAAG,uCAAuC,CAAC;AAOzD,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAC/C,gFAAgF;IAChF,IAAI,IAAI,GAA2B,IAAI,CAAC;IACxC,IAAI,CAAyB,CAAC;IAC9B,MAAM,EAAE,GAAG,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC5C,OAAO,CAAC,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QACxC,IAAI,GAAG,CAAC,CAAC;IACX,CAAC;IACD,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IACxB,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACtB,IAAI,GAAY,CAAC;IACjB,IAAI,CAAC;QACH,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,mCAAoC,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;IAC/E,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,0CAA0C,OAAO,GAAG,EAAE,CAAC,CAAC;IAC1E,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,GAAc,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;AACrD,CAAC"}

package/dist/extensions/forgecli/wf-engine/id-gen.d.ts

@@ -0,0 +1,6 @@
+export declare function makeInstanceId(workflowId: string, rand?: () => string): string;
+export declare function makeNodeExecId(instanceId: string, nodeId: string, loop?: {
+    iter: number;
+    itemId: string;
+}): string;
+export declare function makeEventId(nodeExecId: string, seq: number, type: string): string;

package/dist/extensions/forgecli/wf-engine/id-gen.js

@@ -0,0 +1,17 @@
+import * as crypto from "node:crypto";
+export function makeInstanceId(workflowId, rand) {
+    const iso = new Date().toISOString().replace(/[-:]/g, "").replace(/\.\d{3}Z$/, "Z");
+    const r = rand ? rand() : crypto.randomBytes(2).toString("hex");
+    return `wf_${workflowId}_${iso}_${r}`;
+}
+export function makeNodeExecId(instanceId, nodeId, loop) {
+    if (!loop)
+        return `${instanceId}__${nodeId}`;
+    const iterPad = String(loop.iter).padStart(2, "0");
+    return `${instanceId}__${nodeId}__iter${iterPad}__${loop.itemId}`;
+}
+export function makeEventId(nodeExecId, seq, type) {
+    const seqPad = String(seq).padStart(3, "0");
+    return `${nodeExecId}__${seqPad}__${type}`;
+}
+//# sourceMappingURL=id-gen.js.map

package/dist/extensions/forgecli/wf-engine/id-gen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"id-gen.js","sourceRoot":"","sources":["../../../../src/extensions/forgecli/wf-engine/id-gen.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AAEtC,MAAM,UAAU,cAAc,CAAC,UAAkB,EAAE,IAAmB;IACpE,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;IACpF,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAChE,OAAO,MAAM,UAAU,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,UAAkB,EAClB,MAAc,EACd,IAAuC;IAEvC,IAAI,CAAC,IAAI;QAAE,OAAO,GAAG,UAAU,KAAK,MAAM,EAAE,CAAC;IAC7C,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACnD,OAAO,GAAG,UAAU,KAAK,MAAM,SAAS,OAAO,KAAK,IAAI,CAAC,MAAM,EAAE,CAAC;AACpE,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,UAAkB,EAAE,GAAW,EAAE,IAAY;IACvE,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC5C,OAAO,GAAG,UAAU,KAAK,MAAM,KAAK,IAAI,EAAE,CAAC;AAC7C,CAAC"}

package/dist/extensions/forgecli/wf-engine/loader.d.ts

@@ -0,0 +1,2 @@
+import type { WorkflowDef } from "./types.js";
+export declare function loadWorkflow(workflowDir: string): WorkflowDef;

package/dist/extensions/forgecli/wf-engine/loader.js

@@ -0,0 +1,100 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import * as yaml from "js-yaml";
+export function loadWorkflow(workflowDir) {
+    const yamlPath = path.join(workflowDir, "workflow.yaml");
+    if (!fs.existsSync(yamlPath)) {
+        throw new Error(`workflow.yaml not found at ${yamlPath}`);
+    }
+    const raw = fs.readFileSync(yamlPath, "utf8");
+    const parsed = yaml.load(raw);
+    validateWorkflow(parsed, workflowDir);
+    return parsed;
+}
+function validateWorkflow(wf, workflowDir) {
+    if (!wf.id || typeof wf.id !== "string")
+        throw new Error("workflow.id required (string)");
+    if (!Array.isArray(wf.nodes) || wf.nodes.length === 0)
+        throw new Error("workflow.nodes required (non-empty array)");
+    if (!Array.isArray(wf.edges) || wf.edges.length === 0)
+        throw new Error("workflow.edges required (non-empty array)");
+    const nodeIds = new Set(wf.nodes.map(n => n.id));
+    for (const n of wf.nodes) {
+        if (!n.id)
+            throw new Error(`node missing id`);
+        if (!n.prompt)
+            throw new Error(`node ${n.id} missing prompt`);
+        const promptPath = path.join(workflowDir, n.prompt);
+        if (!fs.existsSync(promptPath))
+            throw new Error(`node ${n.id} prompt file not found: ${promptPath}`);
+        if (!n.expects?.success)
+            throw new Error(`node ${n.id} missing expects.success`);
+        if (!n.expects?.failure)
+            throw new Error(`node ${n.id} missing expects.failure`);
+    }
+    for (const e of wf.edges) {
+        if (!nodeIds.has(e.from))
+            throw new Error(`edge.from references unknown node: ${e.from}`);
+        if (e.to && !nodeIds.has(e.to))
+            throw new Error(`edge.to references unknown node: ${e.to}`);
+        if (e.next && !nodeIds.has(e.next))
+            throw new Error(`edge.next references unknown node: ${e.next}`);
+        if (!e.on || (e.on !== "success" && e.on !== "failure" && e.on !== "exhausted")) {
+            throw new Error(`edge.on must be 'success' | 'failure' | 'exhausted' (from ${e.from})`);
+        }
+        const hasOne = [e.to, e.halt, e.terminal, e.advance].filter(Boolean).length;
+        if (hasOne === 0)
+            throw new Error(`edge from ${e.from} has no continuation (to/halt/terminal/advance)`);
+        if (e.when && typeof e.when !== "string") {
+            throw new Error(`edge.when must be a string predicate (from ${e.from})`);
+        }
+        if (e.when && e.on !== "success") {
+            throw new Error(`edge.when only valid on success edges (from ${e.from})`);
+        }
+    }
+    // Group validation: collect groups, enforce single head, consistent loop.over
+    const groupMembers = new Map();
+    for (const n of wf.nodes) {
+        if (n.loop?.group) {
+            const arr = groupMembers.get(n.loop.group) ?? [];
+            arr.push(n.id);
+            groupMembers.set(n.loop.group, arr);
+        }
+    }
+    for (const [group, members] of groupMembers) {
+        const heads = members.filter(id => wf.nodes.find(n => n.id === id).loop?.head === true);
+        if (heads.length !== 1) {
+            throw new Error(`loop group '${group}' must have exactly one head node, found ${heads.length}`);
+        }
+        const overs = new Set(members.map(id => wf.nodes.find(n => n.id === id).loop.over));
+        if (overs.size !== 1) {
+            throw new Error(`loop group '${group}' members must share the same loop.over (found: ${[...overs].join(", ")})`);
+        }
+    }
+    // Exhausted edges only valid from loop head (or non-grouped loop node)
+    for (const e of wf.edges) {
+        if (e.on === "exhausted") {
+            const fromNode = wf.nodes.find(n => n.id === e.from);
+            if (!fromNode.loop)
+                throw new Error(`edge.on='exhausted' requires from node to have a loop (from ${e.from})`);
+            if (fromNode.loop.group && fromNode.loop.head !== true) {
+                throw new Error(`edge.on='exhausted' must originate from group head (from ${e.from})`);
+            }
+        }
+    }
+    // Every node must have a success and failure edge; loop heads in groups must also have an exhausted edge
+    for (const n of wf.nodes) {
+        const hasSuccess = wf.edges.some(e => e.from === n.id && e.on === "success");
+        const hasFailure = wf.edges.some(e => e.from === n.id && e.on === "failure");
+        if (!hasSuccess)
+            throw new Error(`node ${n.id} missing success edge`);
+        if (!hasFailure)
+            throw new Error(`node ${n.id} missing failure edge`);
+        if (n.loop?.group && n.loop?.head) {
+            const hasExhausted = wf.edges.some(e => e.from === n.id && e.on === "exhausted");
+            if (!hasExhausted)
+                throw new Error(`group-head node ${n.id} missing exhausted edge`);
+        }
+    }
+}
+//# sourceMappingURL=loader.js.map

package/dist/extensions/forgecli/wf-engine/loader.js.map

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

package/dist/extensions/forgecli/wf-engine/predicate.d.ts

@@ -0,0 +1,7 @@
+export interface PredicateContext {
+    state: unknown;
+    loop?: {
+        item: unknown;
+    };
+}
+export declare function evalPredicate(expr: string, ctx: PredicateContext): boolean;

package/dist/extensions/forgecli/wf-engine/predicate.js

@@ -0,0 +1,36 @@
+const OP_RE = /^(\S+)\s+(==|!=|<=|>=|<|>)\s+(.+)$/;
+export function evalPredicate(expr, ctx) {
+    const trimmed = expr.trim();
+    const m = trimmed.match(OP_RE);
+    if (!m)
+        throw new Error(`predicate: cannot parse '${expr}' — expected '<path> <op> <literal>'`);
+    const [, lhsPath, op, rhsLit] = m;
+    const lhs = resolvePath({ state: ctx.state, loop: ctx.loop }, lhsPath);
+    let rhs;
+    try {
+        rhs = JSON.parse(rhsLit);
+    }
+    catch {
+        throw new Error(`predicate: rhs '${rhsLit}' is not a valid JSON literal`);
+    }
+    switch (op) {
+        case "==": return lhs === rhs;
+        case "!=": return lhs !== rhs;
+        case "<": return lhs < rhs;
+        case "<=": return lhs <= rhs;
+        case ">": return lhs > rhs;
+        case ">=": return lhs >= rhs;
+        default: throw new Error(`predicate: unsupported op '${op}'`);
+    }
+}
+function resolvePath(obj, dotted) {
+    const parts = dotted.split(".");
+    let cur = obj;
+    for (const p of parts) {
+        if (cur === null || typeof cur !== "object")
+            return undefined;
+        cur = cur[p];
+    }
+    return cur;
+}
+//# sourceMappingURL=predicate.js.map

package/dist/extensions/forgecli/wf-engine/predicate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"predicate.js","sourceRoot":"","sources":["../../../../src/extensions/forgecli/wf-engine/predicate.ts"],"names":[],"mappings":"AAKA,MAAM,KAAK,GAAG,oCAAoC,CAAC;AAEnD,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,GAAqB;IAC/D,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC5B,MAAM,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC/B,IAAI,CAAC,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,IAAI,sCAAsC,CAAC,CAAC;IAChG,MAAM,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;IAElC,MAAM,GAAG,GAAG,WAAW,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC;IACvE,IAAI,GAAY,CAAC;IACjB,IAAI,CAAC;QACH,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,mBAAmB,MAAM,+BAA+B,CAAC,CAAC;IAC5E,CAAC;IAED,QAAQ,EAAE,EAAE,CAAC;QACX,KAAK,IAAI,CAAC,CAAC,OAAO,GAAG,KAAK,GAAG,CAAC;QAC9B,KAAK,IAAI,CAAC,CAAC,OAAO,GAAG,KAAK,GAAG,CAAC;QAC9B,KAAK,GAAG,CAAC,CAAE,OAAQ,GAAc,GAAK,GAAc,CAAC;QACrD,KAAK,IAAI,CAAC,CAAC,OAAQ,GAAc,IAAK,GAAc,CAAC;QACrD,KAAK,GAAG,CAAC,CAAE,OAAQ,GAAc,GAAK,GAAc,CAAC;QACrD,KAAK,IAAI,CAAC,CAAC,OAAQ,GAAc,IAAK,GAAc,CAAC;QACrD,OAAO,CAAC,CAAG,MAAM,IAAI,KAAK,CAAC,8BAA8B,EAAE,GAAG,CAAC,CAAC;IAClE,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAAC,GAAY,EAAE,MAAc;IAC/C,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAChC,IAAI,GAAG,GAAY,GAAG,CAAC;IACvB,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,IAAI,GAAG,KAAK,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ;YAAE,OAAO,SAAS,CAAC;QAC9D,GAAG,GAAI,GAA+B,CAAC,CAAC,CAAC,CAAC;IAC5C,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/extensions/forgecli/wf-engine/prompt-compiler.d.ts

@@ -0,0 +1,15 @@
+export interface PromptContext {
+    wf: {
+        instanceId: string;
+        workingDir: string;
+    };
+    node: {
+        execId: string;
+        id: string;
+    };
+    state: unknown;
+    loop?: {
+        item: unknown;
+    };
+}
+export declare function compilePrompt(promptFile: string, ctx: PromptContext): string;

package/dist/extensions/forgecli/wf-engine/prompt-compiler.js

@@ -0,0 +1,23 @@
+import * as fs from "node:fs";
+export function compilePrompt(promptFile, ctx) {
+    let body = fs.readFileSync(promptFile, "utf8");
+    body = substitute(body, "{{wf.instanceId}}", ctx.wf.instanceId);
+    body = substitute(body, "{{wf.workingDir}}", ctx.wf.workingDir);
+    body = substitute(body, "{{node.execId}}", ctx.node.execId);
+    body = substitute(body, "{{node.id}}", ctx.node.id);
+    body = substitute(body, "{{state}}", JSON.stringify(ctx.state, null, 2));
+    if (ctx.loop) {
+        body = substitute(body, "{{loop.item}}", JSON.stringify(ctx.loop.item, null, 2));
+        // Also support {{loop.item.<key>}} for shallow object access
+        if (typeof ctx.loop.item === "object" && ctx.loop.item !== null) {
+            for (const [k, v] of Object.entries(ctx.loop.item)) {
+                body = substitute(body, `{{loop.item.${k}}}`, String(v));
+            }
+        }
+    }
+    return body;
+}
+function substitute(s, token, value) {
+    return s.split(token).join(value);
+}
+//# sourceMappingURL=prompt-compiler.js.map

package/dist/extensions/forgecli/wf-engine/prompt-compiler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-compiler.js","sourceRoot":"","sources":["../../../../src/extensions/forgecli/wf-engine/prompt-compiler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAS9B,MAAM,UAAU,aAAa,CAAC,UAAkB,EAAE,GAAkB;IAClE,IAAI,IAAI,GAAG,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IAC/C,IAAI,GAAG,UAAU,CAAC,IAAI,EAAE,mBAAmB,EAAI,GAAG,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC;IAClE,IAAI,GAAG,UAAU,CAAC,IAAI,EAAE,mBAAmB,EAAI,GAAG,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC;IAClE,IAAI,GAAG,UAAU,CAAC,IAAI,EAAE,iBAAiB,EAAM,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAChE,IAAI,GAAG,UAAU,CAAC,IAAI,EAAE,aAAa,EAAU,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC5D,IAAI,GAAG,UAAU,CAAC,IAAI,EAAE,WAAW,EAAY,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IACnF,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC;QACb,IAAI,GAAG,UAAU,CAAC,IAAI,EAAE,eAAe,EAAM,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACrF,6DAA6D;QAC7D,IAAI,OAAO,GAAG,CAAC,IAAI,CAAC,IAAI,KAAK,QAAQ,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;YAChE,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBACnD,IAAI,GAAG,UAAU,CAAC,IAAI,EAAE,eAAe,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;YAC3D,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,UAAU,CAAC,CAAS,EAAE,KAAa,EAAE,KAAa;IACzD,OAAO,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACpC,CAAC"}

package/dist/extensions/forgecli/wf-engine/register.d.ts

@@ -0,0 +1,9 @@
+import type { ExtensionAPI } from "@entelligentsia/pi-coding-agent";
+export interface RegisterRunWorkflowOptions {
+    cwd?: string;
+    /** Explicit single search dir. If set, overrides the CWD-first/bundled-fallback resolution. */
+    workflowsDir?: string;
+    /** Bundled workflows shipped with the package — used as fallback when CWD/workflows/<id> doesn't exist. */
+    bundledWorkflowsDir?: string;
+}
+export declare function registerRunWorkflow(pi: ExtensionAPI, options?: RegisterRunWorkflowOptions): void;

package/dist/extensions/forgecli/wf-engine/register.js

@@ -0,0 +1,59 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { runWorkflow } from "./engine.js";
+import { getSessionRegistry } from "../session-registry.js";
+export function registerRunWorkflow(pi, options = {}) {
+    pi.registerCommand("forge:run-workflow", {
+        description: "Run a generic workflow defined in workflows/<workflowId>/workflow.yaml. " +
+            "Resolution: CWD/workflows/<id> first, then bundled examples. " +
+            "Usage: /forge:run-workflow <workflowId> [entryPrompt...]",
+        async handler(args, ctx) {
+            const cwd = options.cwd ?? process.cwd();
+            const trimmed = args.trim();
+            if (!trimmed) {
+                ctx.ui.notify("× /forge:run-workflow — workflowId required. Usage: /forge:run-workflow <workflowId> [prompt]", "error");
+                return;
+            }
+            const [workflowId, ...rest] = trimmed.split(/\s+/);
+            const entryPrompt = rest.join(" ");
+            // Resolve workflowsDir: explicit override > CWD/workflows (if it has the id) > bundled fallback
+            let workflowsDir;
+            if (options.workflowsDir) {
+                workflowsDir = options.workflowsDir;
+            }
+            else {
+                const cwdCandidate = path.join(cwd, "workflows");
+                if (fs.existsSync(path.join(cwdCandidate, workflowId, "workflow.yaml"))) {
+                    workflowsDir = cwdCandidate;
+                }
+                else if (options.bundledWorkflowsDir) {
+                    workflowsDir = options.bundledWorkflowsDir;
+                }
+                else {
+                    workflowsDir = cwdCandidate; // last resort — will surface a clear not-found error
+                }
+            }
+            try {
+                const result = await runWorkflow({
+                    workflowsDir,
+                    workflowId,
+                    cwd,
+                    entryPrompt,
+                    notify: (line) => ctx.ui.notify(line, "info"),
+                    registry: getSessionRegistry(),
+                });
+                if (result.status === "completed") {
+                    ctx.ui.notify(`✓ workflow complete: ${result.workingDir}`, "info");
+                }
+                else {
+                    ctx.ui.notify(`× workflow halted (${result.haltReason}): ${result.workingDir}`, "error");
+                }
+            }
+            catch (err) {
+                const e = err;
+                ctx.ui.notify(`× /forge:run-workflow threw: ${e.message ?? "unknown"}`, "error");
+            }
+        },
+    });
+}
+//# sourceMappingURL=register.js.map

package/dist/extensions/forgecli/wf-engine/register.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.js","sourceRoot":"","sources":["../../../../src/extensions/forgecli/wf-engine/register.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAU5D,MAAM,UAAU,mBAAmB,CAAC,EAAgB,EAAE,UAAsC,EAAE;IAC5F,EAAE,CAAC,eAAe,CAAC,oBAAoB,EAAE;QACvC,WAAW,EACT,0EAA0E;YAC1E,+DAA+D;YAC/D,0DAA0D;QAC5D,KAAK,CAAC,OAAO,CAAC,IAAY,EAAE,GAA4B;YACtD,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;YAEzC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;YAC5B,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,+FAA+F,EAAE,OAAO,CAAC,CAAC;gBACxH,OAAO;YACT,CAAC;YACD,MAAM,CAAC,UAAU,EAAE,GAAG,IAAI,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YACnD,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAEnC,gGAAgG;YAChG,IAAI,YAAgC,CAAC;YACrC,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;gBACzB,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;YACtC,CAAC;iBAAM,CAAC;gBACN,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;gBACjD,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,UAAU,EAAE,eAAe,CAAC,CAAC,EAAE,CAAC;oBACxE,YAAY,GAAG,YAAY,CAAC;gBAC9B,CAAC;qBAAM,IAAI,OAAO,CAAC,mBAAmB,EAAE,CAAC;oBACvC,YAAY,GAAG,OAAO,CAAC,mBAAmB,CAAC;gBAC7C,CAAC;qBAAM,CAAC;oBACN,YAAY,GAAG,YAAY,CAAC,CAAG,qDAAqD;gBACtF,CAAC;YACH,CAAC;YAED,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC;oBAC/B,YAAY;oBACZ,UAAU;oBACV,GAAG;oBACH,WAAW;oBACX,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC;oBAC7C,QAAQ,EAAE,kBAAkB,EAAE;iBAC/B,CAAC,CAAC;gBACH,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;oBAClC,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,wBAAwB,MAAM,CAAC,UAAU,EAAE,EAAE,MAAM,CAAC,CAAC;gBACrE,CAAC;qBAAM,CAAC;oBACN,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,sBAAsB,MAAM,CAAC,UAAU,MAAM,MAAM,CAAC,UAAU,EAAE,EAAE,OAAO,CAAC,CAAC;gBAC3F,CAAC;YACH,CAAC;YAAC,OAAO,GAAY,EAAE,CAAC;gBACtB,MAAM,CAAC,GAAG,GAA2B,CAAC;gBACtC,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,gCAAgC,CAAC,CAAC,OAAO,IAAI,SAAS,EAAE,EAAE,OAAO,CAAC,CAAC;YACnF,CAAC;QACH,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/extensions/forgecli/wf-engine/remit-check.d.ts

@@ -0,0 +1,6 @@
+import type { Event, NodeDef } from "./types.js";
+export interface RemitCheckResult {
+    ok: boolean;
+    violations: string[];
+}
+export declare function checkRemit(emitted: Event[], node: NodeDef, loopItemId?: string): RemitCheckResult;

package/dist/extensions/forgecli/wf-engine/remit-check.js

@@ -0,0 +1,42 @@
+export function checkRemit(emitted, node, loopItemId) {
+    const violations = [];
+    // Must have started + exactly one terminal
+    const startedCount = emitted.filter(e => e.type === "started").length;
+    if (startedCount !== 1)
+        violations.push(`expected exactly 1 'started' event, got ${startedCount}`);
+    const terminals = emitted.filter(e => e.type === "success" || e.type === "failure");
+    if (terminals.length !== 1)
+        violations.push(`expected exactly 1 terminal event (success/failure), got ${terminals.length}`);
+    if (terminals.length === 1) {
+        const term = terminals[0];
+        if (term.type === "success" && term.writes?.artifact) {
+            const pattern = node.expects.success.writes?.artifact?.pattern;
+            if (!pattern) {
+                violations.push(`node emitted artifact but expects.success.writes.artifact not declared`);
+            }
+            else {
+                const resolved = pattern.replace(/\{loop\.item\.id\}/g, loopItemId ?? "");
+                if (term.writes.artifact.path !== resolved) {
+                    violations.push(`artifact path '${term.writes.artifact.path}' does not match declared pattern '${resolved}'`);
+                }
+            }
+        }
+        if (term.type === "success" && term.writes?.state) {
+            const allowed = node.expects.success.writes?.state ?? [];
+            for (const key of Object.keys(term.writes.state)) {
+                const matched = allowed.some(a => {
+                    const resolved = a.replace(/\{loop\.item\.id\}/g, loopItemId ?? "");
+                    return resolved === key;
+                });
+                if (!matched) {
+                    violations.push(`state write '${key}' not in declared expects.success.writes.state`);
+                }
+            }
+        }
+        if (term.type === "failure" && (!term.reason || typeof term.reason !== "string")) {
+            violations.push(`failure event missing 'reason' string`);
+        }
+    }
+    return { ok: violations.length === 0, violations };
+}
+//# sourceMappingURL=remit-check.js.map

package/dist/extensions/forgecli/wf-engine/remit-check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remit-check.js","sourceRoot":"","sources":["../../../../src/extensions/forgecli/wf-engine/remit-check.ts"],"names":[],"mappings":"AAOA,MAAM,UAAU,UAAU,CACxB,OAAgB,EAChB,IAAa,EACb,UAAmB;IAEnB,MAAM,UAAU,GAAa,EAAE,CAAC;IAEhC,2CAA2C;IAC3C,MAAM,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,MAAM,CAAC;IACtE,IAAI,YAAY,KAAK,CAAC;QAAE,UAAU,CAAC,IAAI,CAAC,2CAA2C,YAAY,EAAE,CAAC,CAAC;IAEnG,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC;IACpF,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,UAAU,CAAC,IAAI,CAAC,4DAA4D,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;IAE5H,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;QAC1B,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC;YACrD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC;YAC/D,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,UAAU,CAAC,IAAI,CAAC,wEAAwE,CAAC,CAAC;YAC5F,CAAC;iBAAM,CAAC;gBACN,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,qBAAqB,EAAE,UAAU,IAAI,EAAE,CAAC,CAAC;gBAC1E,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;oBAC3C,UAAU,CAAC,IAAI,CAAC,kBAAkB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,sCAAsC,QAAQ,GAAG,CAAC,CAAC;gBAChH,CAAC;YACH,CAAC;QACH,CAAC;QAED,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC;YAClD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,IAAI,EAAE,CAAC;YACzD,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;gBACjD,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE;oBAC/B,MAAM,QAAQ,GAAG,CAAC,CAAC,OAAO,CAAC,qBAAqB,EAAE,UAAU,IAAI,EAAE,CAAC,CAAC;oBACpE,OAAO,QAAQ,KAAK,GAAG,CAAC;gBAC1B,CAAC,CAAC,CAAC;gBACH,IAAI,CAAC,OAAO,EAAE,CAAC;oBACb,UAAU,CAAC,IAAI,CAAC,gBAAgB,GAAG,gDAAgD,CAAC,CAAC;gBACvF,CAAC;YACH,CAAC;QACH,CAAC;QAED,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,IAAI,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ,CAAC,EAAE,CAAC;YACjF,UAAU,CAAC,IAAI,CAAC,uCAAuC,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC;IAED,OAAO,EAAE,EAAE,EAAE,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC;AACrD,CAAC"}

package/dist/extensions/forgecli/wf-engine/state-store.d.ts

@@ -0,0 +1,13 @@
+import type { Event, RuntimeState } from "./types.js";
+export declare class StateStore {
+    private readonly workingDir;
+    constructor(workingDir: string);
+    initialState(initial: RuntimeState): void;
+    readState(): RuntimeState;
+    writeState(s: RuntimeState): void;
+    appendEvents(events: Event[]): void;
+    writeArtifact(relPath: string, content: string): void;
+    writeNodeArchive(nodeExecId: string, files: Record<string, string>): void;
+    private statePath;
+    private eventLogPath;
+}

package/dist/extensions/forgecli/wf-engine/state-store.js

@@ -0,0 +1,43 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+export class StateStore {
+    workingDir;
+    constructor(workingDir) {
+        this.workingDir = workingDir;
+    }
+    initialState(initial) {
+        fs.mkdirSync(this.workingDir, { recursive: true });
+        fs.mkdirSync(path.join(this.workingDir, "nodes"), { recursive: true });
+        fs.mkdirSync(path.join(this.workingDir, "artifacts"), { recursive: true });
+        fs.writeFileSync(this.statePath(), JSON.stringify(initial, null, 2));
+        fs.writeFileSync(this.eventLogPath(), ""); // create empty file
+    }
+    readState() {
+        return JSON.parse(fs.readFileSync(this.statePath(), "utf8"));
+    }
+    writeState(s) {
+        // Atomic write: tmp + rename
+        const tmp = `${this.statePath()}.tmp`;
+        fs.writeFileSync(tmp, JSON.stringify(s, null, 2));
+        fs.renameSync(tmp, this.statePath());
+    }
+    appendEvents(events) {
+        const lines = events.map(e => JSON.stringify(e)).join("\n") + "\n";
+        fs.appendFileSync(this.eventLogPath(), lines);
+    }
+    writeArtifact(relPath, content) {
+        const abs = path.join(this.workingDir, relPath);
+        fs.mkdirSync(path.dirname(abs), { recursive: true });
+        fs.writeFileSync(abs, content);
+    }
+    writeNodeArchive(nodeExecId, files) {
+        const dir = path.join(this.workingDir, "nodes", nodeExecId);
+        fs.mkdirSync(dir, { recursive: true });
+        for (const [name, content] of Object.entries(files)) {
+            fs.writeFileSync(path.join(dir, name), content);
+        }
+    }
+    statePath() { return path.join(this.workingDir, "state.json"); }
+    eventLogPath() { return path.join(this.workingDir, "events.log.jsonl"); }
+}
+//# sourceMappingURL=state-store.js.map

package/dist/extensions/forgecli/wf-engine/state-store.js.map

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

package/dist/extensions/forgecli/wf-engine/types.d.ts

@@ -0,0 +1,66 @@
+export interface WorkflowDef {
+    id: string;
+    version: number;
+    description?: string;
+    nodes: NodeDef[];
+    edges: EdgeDef[];
+}
+export interface NodeDef {
+    id: string;
+    prompt: string;
+    loop?: LoopSpec;
+    expects: ExpectsSpec;
+}
+export interface LoopSpec {
+    over: string;
+    alias: string;
+    alsoEmitsItemId?: boolean;
+    group?: string;
+    head?: boolean;
+}
+export interface ExpectsSpec {
+    success: {
+        writes?: {
+            state?: string[];
+            artifact?: {
+                pattern: string;
+            };
+        };
+    };
+    failure: {};
+}
+export interface EdgeDef {
+    from: string;
+    on: "success" | "failure" | "exhausted";
+    to?: string;
+    halt?: string;
+    terminal?: "complete";
+    advance?: "loop-or-next";
+    next?: string;
+    when?: string;
+}
+export interface RuntimeState {
+    cursor: string;
+    loopCursor: Record<string, number>;
+    entryPrompt?: string;
+    [key: string]: unknown;
+}
+export interface Event {
+    eventId: string;
+    nodeExecId: string;
+    type: "started" | "progress" | "success" | "failure" | "workflow.started" | "workflow.completed" | "workflow.halted" | "node.dispatched" | "node.committed" | "node.remit-violation";
+    ts: string;
+    writes?: {
+        state?: Record<string, unknown>;
+        artifact?: {
+            path: string;
+            content: string;
+        };
+    };
+    summary?: string;
+    reason?: string;
+    details?: string;
+    workflowId?: string;
+    instanceId?: string;
+    violatedRule?: string;
+}

package/dist/extensions/forgecli/wf-engine/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/extensions/forgecli/wf-engine/types.js.map

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

package/dist/extensions/forgecli/wf-engine/worker.d.ts

@@ -0,0 +1,11 @@
+import { type AgentSessionEvent } from "@entelligentsia/pi-coding-agent";
+export interface WorkerResult {
+    responseText: string;
+    exitCode: 0 | 1;
+    errorMessage?: string;
+}
+export declare function dispatchLlmWorker(opts: {
+    compiledPrompt: string;
+    cwd: string;
+    onEvent?: (event: AgentSessionEvent) => void;
+}): Promise<WorkerResult>;

package/dist/extensions/forgecli/wf-engine/worker.js

@@ -0,0 +1,50 @@
+import { AuthStorage, createAgentSession, DefaultResourceLoader, getAgentDir, ModelRegistry, SessionManager, } from "@entelligentsia/pi-coding-agent";
+export async function dispatchLlmWorker(opts) {
+    const loader = new DefaultResourceLoader({
+        cwd: opts.cwd,
+        agentDir: getAgentDir(),
+        systemPromptOverride: () => "You are a workflow node worker. Read the user message carefully. "
+            + "At the end of your reply, emit a ```json events block per the protocol. "
+            + "Outside that block, you may write reasoning prose if helpful — but the engine ignores it.",
+        noExtensions: true,
+        noSkills: true,
+        noPromptTemplates: true,
+        noContextFiles: true,
+    });
+    await loader.reload();
+    const authStorage = AuthStorage.create();
+    const modelRegistry = ModelRegistry.create(authStorage);
+    const { session } = await createAgentSession({
+        sessionManager: SessionManager.inMemory(),
+        authStorage,
+        modelRegistry,
+        resourceLoader: loader,
+    });
+    let responseText = "";
+    const unsub = session.subscribe((event) => {
+        if (opts.onEvent)
+            opts.onEvent(event);
+        if (event.type === "turn_end" && event.message) {
+            const msg = event.message;
+            if (msg.role === "assistant") {
+                for (const part of msg.content) {
+                    if (part.type === "text")
+                        responseText += part.text;
+                }
+            }
+        }
+    });
+    try {
+        await session.prompt(opts.compiledPrompt);
+        unsub();
+        session.dispose();
+        return { responseText, exitCode: 0 };
+    }
+    catch (err) {
+        unsub();
+        session.dispose();
+        const e = err;
+        return { responseText, exitCode: 1, errorMessage: e.message ?? "worker threw" };
+    }
+}
+//# sourceMappingURL=worker.js.map

package/dist/extensions/forgecli/wf-engine/worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.js","sourceRoot":"","sources":["../../../../src/extensions/forgecli/wf-engine/worker.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,kBAAkB,EAClB,qBAAqB,EACrB,WAAW,EACX,aAAa,EACb,cAAc,GAEf,MAAM,iCAAiC,CAAC;AASzC,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,IAIvC;IACC,MAAM,MAAM,GAAG,IAAI,qBAAqB,CAAC;QACvC,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,QAAQ,EAAE,WAAW,EAAE;QACvB,oBAAoB,EAAE,GAAG,EAAE,CACzB,mEAAmE;cACjE,0EAA0E;cAC1E,2FAA2F;QAC/F,YAAY,EAAE,IAAI;QAClB,QAAQ,EAAE,IAAI;QACd,iBAAiB,EAAE,IAAI;QACvB,cAAc,EAAE,IAAI;KACrB,CAAC,CAAC;IACH,MAAM,MAAM,CAAC,MAAM,EAAE,CAAC;IAEtB,MAAM,WAAW,GAAK,WAAW,CAAC,MAAM,EAAE,CAAC;IAC3C,MAAM,aAAa,GAAG,aAAa,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IAExD,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,kBAAkB,CAAC;QAC3C,cAAc,EAAE,cAAc,CAAC,QAAQ,EAAE;QACzC,WAAW;QACX,aAAa;QACb,cAAc,EAAE,MAAM;KACvB,CAAC,CAAC;IAEH,IAAI,YAAY,GAAG,EAAE,CAAC;IAEtB,MAAM,KAAK,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,KAAwB,EAAE,EAAE;QAC3D,IAAI,IAAI,CAAC,OAAO;YAAE,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACtC,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;YAC/C,MAAM,GAAG,GAAG,KAAK,CAAC,OAAkB,CAAC;YACrC,IAAI,GAAG,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;gBAC7B,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;oBAC/B,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM;wBAAE,YAAY,IAAI,IAAI,CAAC,IAAI,CAAC;gBACtD,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC1C,KAAK,EAAE,CAAC;QACR,OAAO,CAAC,OAAO,EAAE,CAAC;QAClB,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;IACvC,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,KAAK,EAAE,CAAC;QACR,OAAO,CAAC,OAAO,EAAE,CAAC;QAClB,MAAM,CAAC,GAAG,GAA2B,CAAC;QACtC,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,OAAO,IAAI,cAAc,EAAE,CAAC;IAClF,CAAC;AACH,CAAC"}