@thoughtflow/core 0.1.2

package/dist/tools/workspace/pipeline-run.tool.js

@@ -0,0 +1,160 @@
+"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.PipelineRunTool = void 0;
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+const zod_1 = require("zod");
+const tool_base_class_1 = require("../base/tool-base.class");
+const pipeline_run_registry_class_1 = require("../../libs/pipeline-run-registry.class");
+const DEFAULT_REGISTRY_DIR = path.join(os.homedir(), ".thoughtflow", "pipeline-runs");
+function getRegistry(registryDir) {
+    return new pipeline_run_registry_class_1.PipelineRunRegistry(registryDir ?? process.env["THOUGHTFLOW_PIPELINE_RUNS_DIR"] ?? DEFAULT_REGISTRY_DIR);
+}
+class PipelineRunTool extends tool_base_class_1.ToolBase {
+    registryDir;
+    name = "pipelineRun";
+    readonly = false;
+    description = "CRUD management of pipeline runs. " +
+        "Operations: " +
+        "'list' – list all runs (optionally filtered by status or projectName); " +
+        "'get' – get full details of a specific run by uuid; " +
+        "'delete' – remove a run record from the registry; " +
+        "'status' – get the rolled-up status and phase summary for a run.";
+    constructor(registryDir) {
+        super(zod_1.z.discriminatedUnion("operation", [
+            zod_1.z.object({
+                operation: zod_1.z.literal("list"),
+                status: zod_1.z
+                    .enum(["pending", "running", "complete", "failed", "skipped"])
+                    .optional()
+                    .describe("Filter by run status"),
+                projectName: zod_1.z.string().optional().describe("Filter by project name"),
+            }),
+            zod_1.z.object({
+                operation: zod_1.z.literal("get"),
+                uuid: zod_1.z.string().describe("UUID of the pipeline run"),
+            }),
+            zod_1.z.object({
+                operation: zod_1.z.literal("delete"),
+                uuid: zod_1.z.string().describe("UUID of the pipeline run to delete"),
+            }),
+            zod_1.z.object({
+                operation: zod_1.z.literal("status"),
+                uuid: zod_1.z.string().describe("UUID of the pipeline run"),
+            }),
+        ]));
+        this.registryDir = registryDir;
+    }
+    async run(input, _ctx) {
+        const registry = getRegistry(this.registryDir);
+        const op = input["operation"];
+        try {
+            switch (op) {
+                case "list": {
+                    const filter = {};
+                    if (input["status"])
+                        filter.status = input["status"];
+                    if (input["projectName"])
+                        filter.projectName = input["projectName"];
+                    const runs = await registry.list(filter);
+                    return {
+                        success: true,
+                        output: JSON.stringify(runs.map((r) => ({
+                            uuid: r.uuid,
+                            projectName: r.projectName,
+                            status: r.status,
+                            createdAt: r.createdAt,
+                            updatedAt: r.updatedAt,
+                            phases: r.phases.map((p) => ({
+                                id: p.id,
+                                name: p.name,
+                                status: p.status,
+                                progress: p.progress,
+                            })),
+                        })), null, 2),
+                    };
+                }
+                case "get": {
+                    const run = await registry.get(input["uuid"]);
+                    if (!run) {
+                        return { success: false, error: `Run ${input["uuid"]} not found` };
+                    }
+                    return { success: true, output: JSON.stringify(run, null, 2) };
+                }
+                case "delete": {
+                    await registry.delete(input["uuid"]);
+                    return { success: true, output: `Run ${input["uuid"]} deleted` };
+                }
+                case "status": {
+                    const run = await registry.get(input["uuid"]);
+                    if (!run) {
+                        return { success: false, error: `Run ${input["uuid"]} not found` };
+                    }
+                    return {
+                        success: true,
+                        output: JSON.stringify({
+                            uuid: run.uuid,
+                            status: run.status,
+                            projectName: run.projectName,
+                            model: run.model,
+                            createdAt: run.createdAt,
+                            updatedAt: run.updatedAt,
+                            phases: run.phases.map((p) => ({
+                                id: p.id,
+                                name: p.name,
+                                status: p.status,
+                                progress: p.progress,
+                                durationMs: p.durationMs,
+                                error: p.error,
+                                details: p.details,
+                            })),
+                        }, null, 2),
+                    };
+                }
+                default:
+                    return { success: false, error: `Unknown operation: ${op}` };
+            }
+        }
+        catch (err) {
+            return {
+                success: false,
+                error: `pipeline_run error: ${err instanceof Error ? err.message : String(err)}`,
+            };
+        }
+    }
+}
+exports.PipelineRunTool = PipelineRunTool;
+//# sourceMappingURL=pipeline-run.tool.js.map

package/dist/tools/workspace/pipeline-run.tool.js.map

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

package/dist/tools/workspace/plan.tool.d.ts

@@ -0,0 +1,44 @@
+import { ToolBase } from "../base/tool-base.class";
+import { IStorageAdapter, ToolContext, ToolExecutionResult } from "../../contracts";
+/**
+ * A single entity managed by the plan storage adapter.
+ * type="plan"    — root/header entry that groups sections (planId === id).
+ * type="section" — content block belonging to a plan (planId = parent id).
+ */
+export interface PlanEntry {
+    id: string;
+    type: "plan" | "section";
+    planId: string;
+    title: string;
+    /** One-sentence summary shown in list_sections / search results. */
+    description: string;
+    /** Full markdown body; may contain "- [ ] / - [x]" checklist items. */
+    content: string;
+    tags: string[];
+    /** Relative position within a plan (lower = earlier). */
+    order: number;
+    createdAt: string;
+    updatedAt: string;
+}
+export declare class PlanTool extends ToolBase {
+    readonly name = "plan";
+    readonly description: string;
+    isReadOnly(input: Record<string, unknown>): boolean;
+    private readonly storage;
+    constructor(storage?: IStorageAdapter<PlanEntry>);
+    run(input: Record<string, unknown>, _ctx: ToolContext): Promise<ToolExecutionResult>;
+    private resolvePlanId;
+    private resolveSection;
+    private now;
+    private create;
+    private addSection;
+    private updateSection;
+    private addItem;
+    private checkItem;
+    private read;
+    private listSections;
+    private search;
+    private deleteSection;
+    private renderSection;
+}
+//# sourceMappingURL=plan.tool.d.ts.map

package/dist/tools/workspace/plan.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.tool.d.ts","sourceRoot":"","sources":["../../../src/tools/workspace/plan.tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAsB,WAAW,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAGxG;;;;GAIG;AACH,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,oEAAoE;IACpE,WAAW,EAAE,MAAM,CAAC;IACpB,uEAAuE;IACvE,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,yDAAyD;IACzD,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAgBD,qBAAa,QAAS,SAAQ,QAAQ;IACpC,QAAQ,CAAC,IAAI,UAAU;IACvB,QAAQ,CAAC,WAAW,SAUqD;IAEhE,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO;IAI5D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6B;gBAEzC,OAAO,CAAC,EAAE,eAAe,CAAC,SAAS,CAAC;IAqB1C,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,mBAAmB,CAAC;YAuB5E,aAAa;YAWb,cAAc;IAkB5B,OAAO,CAAC,GAAG;YAIG,MAAM;YAYN,UAAU;YAqBV,aAAa;YAeb,OAAO;YAWP,SAAS;YAeT,IAAI;YAqBJ,YAAY;YAgBZ,MAAM;YAeN,aAAa;IAS3B,OAAO,CAAC,aAAa;CAOtB"}

package/dist/tools/workspace/plan.tool.js

@@ -0,0 +1,271 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PlanTool = void 0;
+const zod_1 = require("zod");
+const tool_base_class_1 = require("../base/tool-base.class");
+const storage_1 = require("../../storage");
+const PLAN_ACTIONS = [
+    "create",
+    "add_section",
+    "update_section",
+    "add_item",
+    "check_item",
+    "read",
+    "list_sections",
+    "search",
+    "delete_section",
+];
+const READ_ONLY_ACTIONS = new Set(["read", "list_sections", "search"]);
+class PlanTool extends tool_base_class_1.ToolBase {
+    name = "plan";
+    description = "Manage a structured project plan backed by a CRUD storage adapter.\n" +
+        "create — initialise a new plan (title, description, tags).\n" +
+        "add_section — append a new section (title, description, content, tags, order).\n" +
+        "update_section — replace title/description/content/tags of an existing section.\n" +
+        "add_item — append a '- [ ] item' checklist entry to a section.\n" +
+        "check_item — mark an existing unchecked item as done ('- [x] item').\n" +
+        "read — return one section by title/sectionId, or the full assembled plan.\n" +
+        "list_sections — return summary list (id, title, description, tags) of all sections.\n" +
+        "search — full-text + tag search across section titles, descriptions, and content.\n" +
+        "delete_section — permanently remove a section by sectionId or title.";
+    isReadOnly(input) {
+        return READ_ONLY_ACTIONS.has(input["action"] ?? "");
+    }
+    storage;
+    constructor(storage) {
+        super(zod_1.z.object({
+            action: zod_1.z
+                .enum(PLAN_ACTIONS)
+                .describe("create | add_section | update_section | add_item | check_item | read | list_sections | search | delete_section"),
+            planId: zod_1.z.string().optional().describe("Plan id to target (required when multiple plans exist)"),
+            sectionId: zod_1.z.string().optional().describe("Section id for precise lookup (alternative to section title)"),
+            title: zod_1.z.string().optional().describe("Plan or section title"),
+            description: zod_1.z.string().optional().describe("One-sentence summary of the plan or section"),
+            content: zod_1.z.string().optional().describe("Full markdown body / content of the section"),
+            tags: zod_1.z.array(zod_1.z.string()).optional().describe("Tag list for categorising and searching sections"),
+            section: zod_1.z.string().optional().describe("Section title to look up (read, update_section, add_item, check_item, delete_section)"),
+            item: zod_1.z.string().optional().describe("Checklist item text without leading '- [ ] ' prefix"),
+            query: zod_1.z.string().optional().describe("Full-text query for the search action"),
+            order: zod_1.z.number().optional().describe("Explicit ordering position for add_section (default: append after last)"),
+        }));
+        this.storage = storage ?? new storage_1.InMemoryAdapter();
+    }
+    async run(input, _ctx) {
+        const action = input["action"];
+        try {
+            switch (action) {
+                case "create": return await this.create(input);
+                case "add_section": return await this.addSection(input);
+                case "update_section": return await this.updateSection(input);
+                case "add_item": return await this.addItem(input);
+                case "check_item": return await this.checkItem(input);
+                case "read": return await this.read(input);
+                case "list_sections": return await this.listSections(input);
+                case "search": return await this.search(input);
+                case "delete_section": return await this.deleteSection(input);
+                default:
+                    return { success: false, error: `Unknown action: ${action}` };
+            }
+        }
+        catch (err) {
+            return { success: false, error: `PlanTool error: ${err instanceof Error ? err.message : String(err)}` };
+        }
+    }
+    // ── helpers ───────────────────────────────────────────────────────────────
+    async resolvePlanId(input) {
+        const explicit = input["planId"];
+        if (explicit)
+            return explicit;
+        const all = await this.storage.list({
+            filter: { type: "plan" },
+        });
+        if (all.length === 0)
+            return { error: "No plan found. Use action='create' first." };
+        if (all.length === 1)
+            return all[0].id;
+        return { error: `Multiple plans exist (${all.map((p) => `${p.title} [${p.id}]`).join(", ")}). Provide 'planId'.` };
+    }
+    async resolveSection(planId, input) {
+        const sectionId = input["sectionId"];
+        const title = input["section"];
+        if (sectionId) {
+            const entry = await this.storage.read(sectionId);
+            if (!entry || entry.type !== "section" || entry.planId !== planId)
+                return { error: `Section id '${sectionId}' not found in this plan.` };
+            return entry;
+        }
+        if (!title)
+            return { error: "Provide 'section' (title) or 'sectionId'." };
+        const sections = await this.storage.list({
+            filter: { type: "section", planId },
+        });
+        const found = sections.find((s) => s.title.toLowerCase() === title.toLowerCase());
+        if (!found)
+            return { error: `Section '${title}' not found.` };
+        return found;
+    }
+    now() { return new Date().toISOString(); }
+    // ── actions ───────────────────────────────────────────────────────────────
+    async create(input) {
+        const title = input["title"] ?? "Plan";
+        const description = input["description"] ?? "";
+        const tags = input["tags"] ?? [];
+        const ts = this.now();
+        const plan = await this.storage.create({
+            type: "plan", planId: "", title, description, content: "", tags, order: 0, createdAt: ts, updatedAt: ts,
+        });
+        await this.storage.update(plan.id, { planId: plan.id });
+        return { success: true, output: `Plan '${title}' created. planId=${plan.id}`, data: { planId: plan.id } };
+    }
+    async addSection(input) {
+        const r = await this.resolvePlanId(input);
+        if (typeof r !== "string")
+            return { success: false, error: r.error };
+        const title = input["title"];
+        if (!title)
+            return { success: false, error: "add_section: 'title' is required" };
+        const description = input["description"] ?? "";
+        const content = input["content"] ?? "";
+        const tags = input["tags"] ?? [];
+        const orderIn = input["order"];
+        let order = orderIn ?? 0;
+        if (orderIn === undefined) {
+            const existing = await this.storage.list({
+                filter: { type: "section", planId: r },
+            });
+            order = existing.length > 0 ? Math.max(...existing.map((s) => s.order)) + 1 : 0;
+        }
+        const ts = this.now();
+        const sec = await this.storage.create({ type: "section", planId: r, title, description, content, tags, order, createdAt: ts, updatedAt: ts });
+        return { success: true, output: `Section '${title}' added (sectionId=${sec.id}).`, data: { sectionId: sec.id } };
+    }
+    async updateSection(input) {
+        const r = await this.resolvePlanId(input);
+        if (typeof r !== "string")
+            return { success: false, error: r.error };
+        const s = await this.resolveSection(r, input);
+        if ("error" in s)
+            return { success: false, error: s.error };
+        const patch = { updatedAt: this.now() };
+        if (input["title"] !== undefined)
+            patch.title = input["title"];
+        if (input["description"] !== undefined)
+            patch.description = input["description"];
+        if (input["content"] !== undefined)
+            patch.content = input["content"];
+        if (input["tags"] !== undefined)
+            patch.tags = input["tags"];
+        if (input["order"] !== undefined)
+            patch.order = input["order"];
+        await this.storage.update(s.id, patch);
+        return { success: true, output: `Section '${s.title}' updated.` };
+    }
+    async addItem(input) {
+        const r = await this.resolvePlanId(input);
+        if (typeof r !== "string")
+            return { success: false, error: r.error };
+        const s = await this.resolveSection(r, input);
+        if ("error" in s)
+            return { success: false, error: s.error };
+        const item = input["item"];
+        if (!item)
+            return { success: false, error: "add_item: 'item' is required" };
+        await this.storage.update(s.id, { content: `${s.content.trimEnd()}\n- [ ] ${item}\n`, updatedAt: this.now() });
+        return { success: true, output: `Item '${item}' added to section '${s.title}'.` };
+    }
+    async checkItem(input) {
+        const r = await this.resolvePlanId(input);
+        if (typeof r !== "string")
+            return { success: false, error: r.error };
+        const s = await this.resolveSection(r, input);
+        if ("error" in s)
+            return { success: false, error: s.error };
+        const item = input["item"];
+        if (!item)
+            return { success: false, error: "check_item: 'item' is required" };
+        const esc = item.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+        if (!new RegExp(`- \\[ \\] (${esc})`).test(s.content))
+            return { success: false, error: `check_item: unchecked item '${item}' not found in section '${s.title}'` };
+        const updated = s.content.replace(new RegExp(`- \\[ \\] (${esc})`, "g"), "- [x] $1");
+        await this.storage.update(s.id, { content: updated, updatedAt: this.now() });
+        return { success: true, output: `Item '${item}' marked as done.` };
+    }
+    async read(input) {
+        const r = await this.resolvePlanId(input);
+        if (typeof r !== "string")
+            return { success: false, error: r.error };
+        if (input["section"] || input["sectionId"]) {
+            const s = await this.resolveSection(r, input);
+            if ("error" in s)
+                return { success: false, error: s.error };
+            return { success: true, output: this.renderSection(s), data: { section: s } };
+        }
+        const plan = await this.storage.read(r);
+        if (!plan)
+            return { success: false, error: `Plan '${r}' not found.` };
+        const sections = await this.storage.list({
+            filter: { type: "section", planId: r },
+            orderBy: "order", order: "asc",
+        });
+        const parts = [`# ${plan.title}`];
+        if (plan.description)
+            parts.push("", plan.description);
+        parts.push("");
+        for (const sec of sections) {
+            parts.push(this.renderSection(sec));
+            parts.push("");
+        }
+        return { success: true, output: parts.join("\n"), data: { plan, sections } };
+    }
+    async listSections(input) {
+        const r = await this.resolvePlanId(input);
+        if (typeof r !== "string")
+            return { success: false, error: r.error };
+        const sections = await this.storage.list({
+            filter: { type: "section", planId: r },
+            orderBy: "order", order: "asc",
+        });
+        const summary = sections.map((s) => ({ sectionId: s.id, title: s.title, description: s.description, tags: s.tags, order: s.order }));
+        const lines = sections.map((s) => `[${s.id}] ${s.title}` +
+            (s.description ? ` — ${s.description}` : "") +
+            (s.tags.length ? ` (tags: ${s.tags.join(", ")})` : ""));
+        return { success: true, output: lines.join("\n") || "(no sections yet)", data: { sections: summary } };
+    }
+    async search(input) {
+        const r = await this.resolvePlanId(input);
+        if (typeof r !== "string")
+            return { success: false, error: r.error };
+        const query = input["query"];
+        const tags = input["tags"];
+        if (!query && !tags?.length)
+            return { success: false, error: "search: provide 'query' and/or 'tags'" };
+        const all = await this.storage.search({ query, tags });
+        const hits = all.filter((e) => e.type === "section" && e.planId === r);
+        if (hits.length === 0)
+            return { success: true, output: "No matching sections found.", data: { sections: [] } };
+        const lines = hits.map((s) => `[${s.id}] ${s.title}` + (s.description ? ` — ${s.description}` : "") + "\n" + s.content.slice(0, 300));
+        return { success: true, output: lines.join("\n\n"), data: { sections: hits } };
+    }
+    async deleteSection(input) {
+        const r = await this.resolvePlanId(input);
+        if (typeof r !== "string")
+            return { success: false, error: r.error };
+        const s = await this.resolveSection(r, input);
+        if ("error" in s)
+            return { success: false, error: s.error };
+        await this.storage.delete(s.id);
+        return { success: true, output: `Section '${s.title}' deleted.` };
+    }
+    renderSection(s) {
+        const lines = [`## ${s.title}`];
+        if (s.description)
+            lines.push(`> ${s.description}`);
+        if (s.tags.length)
+            lines.push(`tags: ${s.tags.join(", ")}`);
+        if (s.content.trim())
+            lines.push("", s.content.trim());
+        return lines.join("\n");
+    }
+}
+exports.PlanTool = PlanTool;
+//# sourceMappingURL=plan.tool.js.map

package/dist/tools/workspace/plan.tool.js.map

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

package/dist/tools/workspace/process-manager.tool.d.ts

@@ -0,0 +1,23 @@
+import { ToolBase } from "../base/tool-base.class";
+import { ToolContext, ToolExecutionResult } from "../../contracts";
+/**
+ * Shared registry of background processes — one per tool instance.
+ * Stored on the instance so demo cleanup can call tool.killAll().
+ */
+export declare class ProcessManagerTool extends ToolBase {
+    private readonly rootDir;
+    readonly name = "processManager";
+    readonly description: string;
+    /** list / logs / wait_ready are read-only; start / stop mutate process state. */
+    isReadOnly(input: Record<string, unknown>): boolean;
+    private readonly procs;
+    constructor(rootDir: string);
+    run(input: Record<string, unknown>, ctx: ToolContext): Promise<ToolExecutionResult>;
+    private startProcess;
+    private waitReady;
+    private stopProcess;
+    private listProcesses;
+    private getProcessLogs;
+    killAll(): void;
+}
+//# sourceMappingURL=process-manager.tool.d.ts.map

package/dist/tools/workspace/process-manager.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-manager.tool.d.ts","sourceRoot":"","sources":["../../../src/tools/workspace/process-manager.tool.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAUnE;;;GAGG;AACH,qBAAa,kBAAmB,SAAQ,QAAQ;IAkBlC,OAAO,CAAC,QAAQ,CAAC,OAAO;IAjBpC,QAAQ,CAAC,IAAI,oBAAoB;IACjC,QAAQ,CAAC,WAAW,SAM4B;IAEhD,iFAAiF;IACxE,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO;IAK5D,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqC;gBAE9B,OAAO,EAAE,MAAM;IAsBtC,GAAG,CACP,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,GAAG,EAAE,WAAW,GACf,OAAO,CAAC,mBAAmB,CAAC;IAwB/B,OAAO,CAAC,YAAY;IA+DpB,OAAO,CAAC,SAAS;IA2BjB,OAAO,CAAC,WAAW;IAqBnB,OAAO,CAAC,aAAa;IAYrB,OAAO,CAAC,cAAc;IActB,OAAO,IAAI,IAAI;CAMhB"}