@hoangsonw/forge 0.1.0

package/dist/agents/executor.js

@@ -0,0 +1,402 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports._digestToolResultForTest = exports._parseExecutorOutputForTest = exports.runStep = exports.executorAgent = void 0;
+const router_1 = require("../models/router");
+const assembler_1 = require("../prompts/assembler");
+const registry_1 = require("../tools/registry");
+const errors_1 = require("../types/errors");
+const manager_1 = require("../permissions/manager");
+const logger_1 = require("../logging/logger");
+const loader_1 = require("../config/loader");
+const trace_1 = require("../logging/trace");
+const mode_policy_1 = require("../core/mode-policy");
+const validation_1 = require("../core/validation");
+const executorSchemaPrompt = `You are executing a single step of an approved plan via iterative tool use.
+
+Each turn, output STRICT JSON:
+{
+  "actions": [
+    { "tool": string, "args": object, "justification": string }
+  ],
+  "summary": string,
+  "done"?: boolean
+}
+
+Protocol:
+- Choose tools from the catalog only. Each action's args must match the tool's input schema.
+- You will receive the result of every tool call before your next turn. Read errors carefully.
+- If a tool fails, either retry with different args, switch tools, or set "done": true with a summary explaining what is blocked and why.
+- Set "done": true with an empty actions array once the step is satisfied.
+- Never include prose outside JSON. No code fences outside a single JSON object.`;
+const TRUNCATE = 2_000;
+const truncate = (s) => s.length <= TRUNCATE ? s : s.slice(0, TRUNCATE) + `\n…[truncated ${s.length - TRUNCATE}B]`;
+const parseModelOutput = (content) => {
+    const fence = /```(?:json)?\s*([\s\S]+?)\s*```/i.exec(content);
+    let obj = null;
+    try {
+        obj = JSON.parse(fence ? fence[1] : content);
+    }
+    catch {
+        obj = null;
+    }
+    const rawActions = obj && Array.isArray(obj.actions) ? obj.actions : [];
+    const actions = rawActions
+        .filter((a) => a && typeof a.tool === 'string')
+        .map((a) => ({
+        tool: String(a.tool),
+        args: (a.args && typeof a.args === 'object' ? a.args : {}),
+    }));
+    const summary = typeof obj?.summary === 'string' ? String(obj.summary) : '';
+    const done = Boolean(obj?.done);
+    return { actions, summary, done };
+};
+/**
+ * Compact, model-facing digest of a tool invocation. We serialise enough
+ * for the model to diagnose, but truncate large payloads so we don't
+ * burn context on one step.
+ */
+const digestToolResult = (entry) => {
+    const base = {
+        tool: entry.tool,
+        success: entry.result.success,
+        durationMs: entry.result.durationMs,
+    };
+    if (entry.result.success) {
+        const out = entry.result.output;
+        if (out && typeof out === 'object') {
+            const o = out;
+            // run_command / run_tests share this shape. Normalise it.
+            if ('stdout' in o || 'stderr' in o || 'exitCode' in o) {
+                base.exitCode = o.exitCode ?? null;
+                base.stdout = truncate(String(o.stdout ?? ''));
+                base.stderr = truncate(String(o.stderr ?? ''));
+                if (o.timedOut)
+                    base.timedOut = true;
+            }
+            else {
+                const serialised = JSON.stringify(o);
+                base.output = truncate(serialised);
+            }
+        }
+        else if (typeof out === 'string') {
+            base.output = truncate(out);
+        }
+    }
+    else {
+        base.error = {
+            class: entry.result.error?.class ?? 'tool_error',
+            message: truncate(String(entry.result.error?.message ?? 'unknown error')),
+            retryable: entry.result.error?.retryable ?? false,
+            recoveryHint: entry.result.error?.recoveryHint,
+        };
+    }
+    return base;
+};
+exports.executorAgent = {
+    name: 'executor',
+    description: 'Executes a single plan step via iterative tool use.',
+    async run() {
+        return {
+            success: false,
+            message: 'executor.run is a delegate; use runStep() directly.',
+        };
+    },
+};
+const runStep = async (params) => {
+    const runId = params.runId ?? (0, trace_1.newRunId)();
+    const policy = (0, mode_policy_1.modePolicy)(params.mode);
+    const toolCtx = {
+        taskId: params.taskId,
+        projectId: params.projectId,
+        projectRoot: params.projectRoot,
+        traceId: runId,
+        runId,
+    };
+    // ---- Direct-tool shortcut ----
+    // If the plan nominates a concrete tool + args, honour them as-is. This
+    // preserves the prior fast-path for deterministic steps (e.g. `run_tests`
+    // with a specific command) and avoids spending a model turn to echo them.
+    if (params.step.tool && (0, registry_1.hasTool)(params.step.tool) && params.step.args) {
+        const tool = (0, registry_1.getTool)(params.step.tool);
+        await requestPermissionFor(tool.schema, params.projectId, params.taskId, params.step, params.flags);
+        const result = await tool.execute(params.step.args, toolCtx);
+        const filesChanged = extractFilesChanged(tool.schema.name, params.step.args, result);
+        return {
+            step: params.step,
+            toolResults: [{ tool: tool.schema.name, args: params.step.args, result }],
+            summary: result.success
+                ? `ran ${tool.schema.name}`
+                : `FAILED ${tool.schema.name}: ${result.error?.message ?? ''}`,
+            filesChanged,
+            turns: 0,
+            completed: result.success,
+        };
+    }
+    // ---- Iterative tool-use loop ----
+    const initialPrompt = (0, assembler_1.assembleTaskPrompt)({
+        mode: params.mode,
+        title: `Execute step: ${params.step.description}`,
+        description: `Step id=${params.step.id}, type=${params.step.type}` +
+            (params.step.target ? `, target=${params.step.target}` : ''),
+        globalInstructions: (0, loader_1.loadGlobalInstructions)(),
+        projectInstructions: (0, loader_1.loadProjectInstructions)(params.projectRoot),
+        tools: (0, registry_1.allTools)(),
+        additionalUserText: `${executorSchemaPrompt}\n\nSTEP:\n${JSON.stringify(params.step, null, 2)}`,
+    });
+    const messages = [...initialPrompt.messages];
+    const toolResults = [];
+    const filesChanged = [];
+    let summary = '';
+    let completed = false;
+    let validationRetriesLeft = policy.maxValidationRetries;
+    const maxTurns = Math.max(1, policy.maxExecutorTurns);
+    let turn = 0;
+    while (turn < maxTurns) {
+        turn++;
+        let response;
+        try {
+            const { response: r } = await (0, router_1.callModel)('executor', params.mode, messages, {
+                jsonMode: true,
+                temperature: 0.2,
+                maxTokens: 1500,
+                timeoutMs: 60_000,
+            });
+            response = r;
+        }
+        catch (err) {
+            logger_1.log.warn('executor: model call failed', {
+                err: String(err),
+                step: params.step.id,
+                turn,
+            });
+            return {
+                step: params.step,
+                toolResults,
+                summary: summary || `model_error: ${String(err)}`,
+                filesChanged,
+                turns: turn,
+                completed: false,
+            };
+        }
+        const parsed = parseModelOutput(response.content);
+        if (parsed.summary)
+            summary = parsed.summary;
+        // No actions requested → the model is either finishing or stuck. Either
+        // way we stop here; `done` signals success, absence signals a short-circuit.
+        if (!parsed.actions.length) {
+            completed = parsed.done;
+            break;
+        }
+        const turnDigests = [];
+        let anyFailed = false;
+        for (const action of parsed.actions) {
+            if (!(0, registry_1.hasTool)(action.tool)) {
+                const result = {
+                    success: false,
+                    error: { class: 'not_found', message: `Unknown tool ${action.tool}`, retryable: false },
+                    durationMs: 0,
+                };
+                toolResults.push({ tool: action.tool, args: action.args, result });
+                turnDigests.push(digestToolResult({ tool: action.tool, args: action.args, result }));
+                anyFailed = true;
+                continue;
+            }
+            const tool = (0, registry_1.getTool)(action.tool);
+            const readOnlyEffect = tool.schema.sideEffect === 'pure' || tool.schema.sideEffect === 'readonly';
+            if (!readOnlyEffect && !policy.allowMutations) {
+                const result = {
+                    success: false,
+                    error: {
+                        class: 'permission_denied',
+                        message: `Mode ${params.mode} is read-only; tool ${tool.schema.name} is blocked.`,
+                        retryable: false,
+                    },
+                    durationMs: 0,
+                };
+                toolResults.push({ tool: tool.schema.name, args: action.args, result });
+                turnDigests.push(digestToolResult({ tool: tool.schema.name, args: action.args, result }));
+                anyFailed = true;
+                continue;
+            }
+            try {
+                await requestPermissionFor(tool.schema, params.projectId, params.taskId, params.step, params.flags);
+            }
+            catch (err) {
+                const result = {
+                    success: false,
+                    error: err instanceof errors_1.ForgeRuntimeError
+                        ? err.toJSON()
+                        : { class: 'permission_denied', message: String(err), retryable: false },
+                    durationMs: 0,
+                };
+                toolResults.push({ tool: tool.schema.name, args: action.args, result });
+                turnDigests.push(digestToolResult({ tool: tool.schema.name, args: action.args, result }));
+                anyFailed = true;
+                continue;
+            }
+            const result = await tool.execute(action.args, toolCtx);
+            toolResults.push({ tool: tool.schema.name, args: action.args, result });
+            turnDigests.push(digestToolResult({ tool: tool.schema.name, args: action.args, result }));
+            if (result.success) {
+                filesChanged.push(...extractFilesChanged(tool.schema.name, action.args, result));
+            }
+            else {
+                anyFailed = true;
+            }
+        }
+        // All actions succeeded and the model signalled done → exit early.
+        if (!anyFailed && parsed.done) {
+            completed = true;
+            break;
+        }
+        // Out of turns? Don't bother paying for one more model call.
+        if (turn >= maxTurns)
+            break;
+        messages.push({ role: 'assistant', content: response.content });
+        messages.push({
+            role: 'user',
+            content: `TOOL_RESULTS (turn ${turn}):\n` +
+                JSON.stringify(turnDigests, null, 2) +
+                `\n\nReview the results above. If the step is satisfied, reply with {"actions":[],"summary":"…","done":true}. ` +
+                `If a tool failed, either try a corrective action or set done=true and explain what is blocked.`,
+        });
+    }
+    // ---- Validation gate ----
+    // Only engage when the step actually touched files and the mode enables it.
+    if (completed && filesChanged.length && policy.maxValidationRetries > 0) {
+        const validator = params.validate ?? validation_1.runValidation;
+        while (validationRetriesLeft >= 0) {
+            const vres = await validator(params.projectRoot);
+            if (vres.ok)
+                break;
+            if (validationRetriesLeft === 0 || turn >= maxTurns) {
+                // Out of budget — surface as a synthetic tool failure so the loop
+                // caller (runAgenticLoop) treats the step as failed and escalates
+                // to diagnose() at the retry boundary.
+                const result = {
+                    success: false,
+                    error: {
+                        class: 'tool_error',
+                        message: vres.message ?? 'Validation failed.',
+                        retryable: true,
+                        recoveryHint: 'Address the validator output before continuing.',
+                    },
+                    durationMs: 0,
+                };
+                toolResults.push({
+                    tool: 'validation_gate',
+                    args: { ran: vres.ran },
+                    result,
+                });
+                completed = false;
+                break;
+            }
+            validationRetriesLeft--;
+            turn++;
+            messages.push({
+                role: 'user',
+                content: `VALIDATION_FAILED (ran: ${vres.ran.join(', ') || 'n/a'}):\n` +
+                    (vres.message ?? '(no message)') +
+                    `\n\nProduce a corrective action as JSON. Same schema as before. Set done=true once validation would pass.`,
+            });
+            let response;
+            try {
+                const { response: r } = await (0, router_1.callModel)('executor', params.mode, messages, {
+                    jsonMode: true,
+                    temperature: 0.2,
+                    maxTokens: 1500,
+                    timeoutMs: 60_000,
+                });
+                response = r;
+            }
+            catch (err) {
+                logger_1.log.warn('executor: validation-retry model call failed', {
+                    err: String(err),
+                    step: params.step.id,
+                });
+                break;
+            }
+            const parsed = parseModelOutput(response.content);
+            if (parsed.summary)
+                summary = parsed.summary;
+            // Do NOT break here on `done: true` — the authoritative signal is the
+            // validator re-running on the next loop iteration. A model that claims
+            // done but left the validator failing still costs us a correctness bug.
+            const turnDigests = [];
+            for (const action of parsed.actions) {
+                if (!(0, registry_1.hasTool)(action.tool))
+                    continue;
+                const tool = (0, registry_1.getTool)(action.tool);
+                try {
+                    await requestPermissionFor(tool.schema, params.projectId, params.taskId, params.step, params.flags);
+                }
+                catch {
+                    continue;
+                }
+                const result = await tool.execute(action.args, toolCtx);
+                toolResults.push({ tool: tool.schema.name, args: action.args, result });
+                turnDigests.push(digestToolResult({ tool: tool.schema.name, args: action.args, result }));
+                if (result.success) {
+                    filesChanged.push(...extractFilesChanged(tool.schema.name, action.args, result));
+                }
+            }
+            messages.push({ role: 'assistant', content: response.content });
+            messages.push({
+                role: 'user',
+                content: `TOOL_RESULTS:\n${JSON.stringify(turnDigests, null, 2)}`,
+            });
+        }
+    }
+    if (!summary) {
+        summary = completed
+            ? `ran ${toolResults.length} action(s)`
+            : `step did not complete after ${turn} turn(s)`;
+    }
+    return {
+        step: params.step,
+        toolResults,
+        summary,
+        filesChanged: Array.from(new Set(filesChanged)),
+        turns: turn,
+        completed,
+    };
+};
+exports.runStep = runStep;
+const requestPermissionFor = async (schema, projectId, taskId, step, flags) => {
+    const decision = await (0, manager_1.requestPermission)({
+        tool: schema.name,
+        risk: step.risk ?? schema.risk,
+        sideEffect: schema.sideEffect,
+        sensitivity: schema.sensitivity,
+        action: step.description,
+        target: step.target,
+        projectId,
+        taskId,
+    }, flags);
+    if (decision === 'deny' || decision === 'ask') {
+        throw new errors_1.ForgeRuntimeError({
+            class: 'permission_denied',
+            message: `Denied ${schema.name} for step ${step.id}`,
+            retryable: false,
+        });
+    }
+};
+const extractFilesChanged = (tool, args, result) => {
+    if (!result.success)
+        return [];
+    if (tool === 'write_file' && args && typeof args === 'object' && 'path' in args) {
+        return [String(args.path)];
+    }
+    if (tool === 'apply_patch' && result.output && typeof result.output === 'object') {
+        const out = result.output;
+        return out.filesChanged ?? [];
+    }
+    if (tool === 'edit_file' && args && typeof args === 'object' && 'path' in args) {
+        return [String(args.path)];
+    }
+    return [];
+};
+// Exposed for tests.
+exports._parseExecutorOutputForTest = parseModelOutput;
+exports._digestToolResultForTest = digestToolResult;
+//# sourceMappingURL=executor.js.map

package/dist/agents/executor.js.map

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

package/dist/agents/memory.d.ts

@@ -0,0 +1,8 @@
+import { Agent } from './base';
+/**
+ * Memory agent — maintains the project's context graph. Invoked after
+ * planning with a seed file (if any) to populate `imports` edges derived
+ * from warm-memory traversal. Deliberately idempotent; safe to re-run.
+ */
+export declare const memoryAgent: Agent;
+//# sourceMappingURL=memory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../src/agents/memory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAe,MAAM,QAAQ,CAAC;AAM5C;;;;GAIG;AACH,eAAO,MAAM,WAAW,EAAE,KAqCzB,CAAC"}

package/dist/agents/memory.js

@@ -0,0 +1,84 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.memoryAgent = void 0;
+const graph_1 = require("../memory/graph");
+const warm_1 = require("../memory/warm");
+const path = __importStar(require("path"));
+const logger_1 = require("../logging/logger");
+/**
+ * Memory agent — maintains the project's context graph. Invoked after
+ * planning with a seed file (if any) to populate `imports` edges derived
+ * from warm-memory traversal. Deliberately idempotent; safe to re-run.
+ */
+exports.memoryAgent = {
+    name: 'memory',
+    description: 'Maintains the project context graph and long-term memory.',
+    async run(ctx) {
+        try {
+            const seed = ctx.task.profile?.scope === 'single-file'
+                ? ctx.task.description?.match(/(^|[\s"'`])((?:\.\/)?[\w./-]+\.[a-z]{1,5})/)?.[2]
+                : null;
+            const touched = [];
+            if (seed) {
+                const absoluteSeed = path.resolve(ctx.projectRoot, seed);
+                const related = (0, warm_1.collectRelated)(absoluteSeed, ctx.projectRoot, {
+                    maxFiles: 20,
+                    maxDepth: 3,
+                });
+                for (const f of related) {
+                    const rel = path.relative(ctx.projectRoot, f);
+                    (0, graph_1.upsertNode)(ctx.projectRoot, { id: `file:${rel}`, type: 'file', label: rel });
+                    touched.push(rel);
+                }
+                const seedRel = path.relative(ctx.projectRoot, absoluteSeed);
+                for (const f of related.slice(1)) {
+                    const rel = path.relative(ctx.projectRoot, f);
+                    (0, graph_1.upsertEdge)(ctx.projectRoot, {
+                        src: `file:${seedRel}`,
+                        dst: `file:${rel}`,
+                        kind: 'imports',
+                    });
+                }
+            }
+            return { success: true, output: { filesIndexed: touched.length }, filesChanged: [] };
+        }
+        catch (err) {
+            logger_1.log.debug('memory agent non-fatal failure', { err: String(err) });
+            return { success: true, message: String(err) };
+        }
+    },
+};
+//# sourceMappingURL=memory.js.map

package/dist/agents/memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.js","sourceRoot":"","sources":["../../src/agents/memory.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AACA,2CAAyD;AACzD,yCAAgD;AAChD,2CAA6B;AAC7B,8CAAwC;AAExC;;;;GAIG;AACU,QAAA,WAAW,GAAU;IAChC,IAAI,EAAE,QAAQ;IACd,WAAW,EAAE,2DAA2D;IACxE,KAAK,CAAC,GAAG,CAAC,GAAG;QACX,IAAI,CAAC;YACH,MAAM,IAAI,GACR,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,KAAK,aAAa;gBACvC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC,4CAA4C,CAAC,EAAE,CAAC,CAAC,CAAC;gBAChF,CAAC,CAAC,IAAI,CAAC;YACX,MAAM,OAAO,GAAa,EAAE,CAAC;YAC7B,IAAI,IAAI,EAAE,CAAC;gBACT,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;gBACzD,MAAM,OAAO,GAAG,IAAA,qBAAc,EAAC,YAAY,EAAE,GAAG,CAAC,WAAW,EAAE;oBAC5D,QAAQ,EAAE,EAAE;oBACZ,QAAQ,EAAE,CAAC;iBACZ,CAAC,CAAC;gBACH,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;oBACxB,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;oBAC9C,IAAA,kBAAU,EAAC,GAAG,CAAC,WAAW,EAAE,EAAE,EAAE,EAAE,QAAQ,GAAG,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;oBAC7E,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBACpB,CAAC;gBACD,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;gBAC7D,KAAK,MAAM,CAAC,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;oBACjC,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;oBAC9C,IAAA,kBAAU,EAAC,GAAG,CAAC,WAAW,EAAE;wBAC1B,GAAG,EAAE,QAAQ,OAAO,EAAE;wBACtB,GAAG,EAAE,QAAQ,GAAG,EAAE;wBAClB,IAAI,EAAE,SAAS;qBAChB,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;YACD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,YAAY,EAAE,OAAO,CAAC,MAAM,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC;QACvF,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,YAAG,CAAC,KAAK,CAAC,gCAAgC,EAAE,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAClE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;QACjD,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/agents/planner.d.ts

@@ -0,0 +1,5 @@
+import { Task, Mode } from '../types';
+import { Agent } from './base';
+export declare const buildPlannerPrompt: (task: Task, projectRoot: string, mode: Mode) => import("../types").AssembledPrompt;
+export declare const plannerAgent: Agent;
+//# sourceMappingURL=planner.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"planner.d.ts","sourceRoot":"","sources":["../../src/agents/planner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,IAAI,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AACtD,OAAO,EAAE,KAAK,EAAe,MAAM,QAAQ,CAAC;AA+H5C,eAAO,MAAM,kBAAkB,GAAI,MAAM,IAAI,EAAE,aAAa,MAAM,EAAE,MAAM,IAAI,uCAkB7E,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,KAoC1B,CAAC"}