@united-workforce/cli 0.1.0

package/dist/commands/shared.js

@@ -0,0 +1,154 @@
+import { getSchema } from "@ocas/core";
+import { createUwfStore, getThread } from "../store.js";
+function fail(message) {
+    process.stderr.write(`${message}\n`);
+    process.exit(1);
+}
+function walkChain(uwf, headHash) {
+    const headNode = uwf.store.cas.get(headHash);
+    if (headNode === null) {
+        fail(`CAS node not found: ${headHash}`);
+    }
+    if (headNode.type === uwf.schemas.startNode) {
+        return {
+            startHash: headHash,
+            start: headNode.payload,
+            stepsNewestFirst: [],
+            headIsStart: true,
+        };
+    }
+    if (headNode.type !== uwf.schemas.stepNode) {
+        fail(`head ${headHash} is not a StartNode or StepNode`);
+    }
+    const stepsNewestFirst = [];
+    let hash = headHash;
+    while (hash !== null) {
+        const node = uwf.store.cas.get(hash);
+        if (node === null) {
+            fail(`CAS node not found while walking chain: ${hash}`);
+        }
+        if (node.type !== uwf.schemas.stepNode) {
+            break;
+        }
+        const payload = node.payload;
+        stepsNewestFirst.push(payload);
+        hash = payload.prev;
+    }
+    const newest = stepsNewestFirst[0];
+    if (newest === undefined) {
+        fail(`empty step chain at head ${headHash}`);
+    }
+    const startNode = uwf.store.cas.get(newest.start);
+    if (startNode === null || startNode.type !== uwf.schemas.startNode) {
+        fail(`StartNode not found: ${newest.start}`);
+    }
+    return {
+        startHash: newest.start,
+        start: startNode.payload,
+        stepsNewestFirst,
+        headIsStart: false,
+    };
+}
+function expandOutput(uwf, outputRef) {
+    const node = uwf.store.cas.get(outputRef);
+    if (node === null) {
+        return {};
+    }
+    return node.payload;
+}
+/**
+ * Recursively expand all ocas_ref fields in a CAS node's payload,
+ * replacing hash strings with the referenced node's expanded payload.
+ */
+function expandDeep(store, hash, visited) {
+    const seen = visited ?? new Set();
+    if (seen.has(hash))
+        return hash; // cycle guard
+    seen.add(hash);
+    const node = store.cas.get(hash);
+    if (node === null)
+        return hash;
+    const schema = getSchema(store, node.type);
+    if (schema === null)
+        return node.payload;
+    return expandValue(store, schema, node.payload, seen);
+}
+function expandCasRefField(store, value, visited) {
+    if (typeof value === "string") {
+        return expandDeep(store, value, visited);
+    }
+    return value;
+}
+function expandAnyOfField(store, schema, value, visited) {
+    if (!Array.isArray(schema.anyOf))
+        return value;
+    for (const sub of schema.anyOf) {
+        if (sub.format === "ocas_ref" && typeof value === "string") {
+            return expandDeep(store, value, visited);
+        }
+    }
+    return value;
+}
+function expandArrayField(store, schema, value, visited) {
+    if (!schema.items || !Array.isArray(value))
+        return value;
+    const itemSchema = schema.items;
+    return value.map((item) => expandValue(store, itemSchema, item, visited));
+}
+function expandObjectField(store, schema, value, visited) {
+    if (value === null || typeof value !== "object" || Array.isArray(value) || !schema.properties) {
+        return value;
+    }
+    const props = schema.properties;
+    const obj = value;
+    const result = {};
+    for (const [key, val] of Object.entries(obj)) {
+        const propSchema = props[key];
+        result[key] = propSchema ? expandValue(store, propSchema, val, visited) : val;
+    }
+    return result;
+}
+function expandValue(store, schema, value, visited) {
+    if (schema.format === "ocas_ref")
+        return expandCasRefField(store, value, visited);
+    if (Array.isArray(schema.anyOf))
+        return expandAnyOfField(store, schema, value, visited);
+    if (schema.type === "array")
+        return expandArrayField(store, schema, value, visited);
+    return expandObjectField(store, schema, value, visited);
+}
+function collectOrderedSteps(uwf, headHash, chain) {
+    let hash = headHash;
+    const hashToNode = new Map();
+    while (hash !== null) {
+        const node = uwf.store.cas.get(hash);
+        if (node === null || node.type !== uwf.schemas.stepNode) {
+            break;
+        }
+        const payload = node.payload;
+        hashToNode.set(hash, { payload, timestamp: node.timestamp });
+        hash = payload.prev;
+    }
+    let cur = chain.headIsStart ? null : headHash;
+    const ordered = [];
+    while (cur !== null) {
+        const entry = hashToNode.get(cur);
+        if (entry === undefined) {
+            break;
+        }
+        ordered.push({ hash: cur, ...entry });
+        cur = entry.payload.prev;
+    }
+    ordered.reverse();
+    return ordered;
+}
+async function resolveHeadHash(storageRoot, threadId) {
+    const uwf = await createUwfStore(storageRoot);
+    const entry = getThread(uwf.varStore, threadId);
+    if (entry !== null) {
+        return entry.head;
+    }
+    fail(`thread not found: ${threadId}`);
+}
+export { collectOrderedSteps, expandAnyOfField, expandArrayField, expandCasRefField, expandDeep, expandObjectField, expandOutput, expandValue, fail, resolveHeadHash, walkChain, };
+//# sourceMappingURL=shared.js.map

package/dist/commands/shared.js.map

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

package/dist/commands/step.d.ts

@@ -0,0 +1,18 @@
+import type { CasRef, ThreadForkOutput, ThreadId, ThreadStepsOutput } from "@united-workforce/protocol";
+/**
+ * List all steps in a thread (previously: thread steps)
+ */
+export declare function cmdStepList(storageRoot: string, threadId: ThreadId): Promise<ThreadStepsOutput>;
+/**
+ * Show details of a specific step (previously: thread step-details)
+ */
+export declare function cmdStepShow(storageRoot: string, stepHash: CasRef): Promise<unknown>;
+/**
+ * Fork a thread from a specific step (previously: thread fork)
+ */
+export declare function cmdStepFork(storageRoot: string, stepHash: CasRef): Promise<ThreadForkOutput>;
+/**
+ * Read a step's agent turns as human-readable markdown with quota enforcement
+ */
+export declare function cmdStepRead(storageRoot: string, stepHash: CasRef, quota: number, showPrompt: boolean): Promise<string>;
+//# sourceMappingURL=step.d.ts.map

package/dist/commands/step.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"step.d.ts","sourceRoot":"","sources":["../../src/commands/step.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,MAAM,EAIN,gBAAgB,EAChB,QAAQ,EACR,iBAAiB,EAClB,MAAM,4BAA4B,CAAC;AAwBpC;;GAEG;AACH,wBAAsB,WAAW,CAC/B,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,QAAQ,GACjB,OAAO,CAAC,iBAAiB,CAAC,CAsC5B;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAczF;AAED;;GAEG;AACH,wBAAsB,WAAW,CAC/B,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,gBAAgB,CAAC,CAyB3B;AAgKD;;GAEG;AACH,wBAAsB,WAAW,CAC/B,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,OAAO,GAClB,OAAO,CAAC,MAAM,CAAC,CA6CjB"}

package/dist/commands/step.js

@@ -0,0 +1,257 @@
+import { generateUlid } from "@united-workforce/util";
+import { createUwfStore, setThread } from "../store.js";
+import { collectOrderedSteps, expandDeep, expandOutput, fail, resolveHeadHash, walkChain, } from "./shared.js";
+/**
+ * List all steps in a thread (previously: thread steps)
+ */
+export async function cmdStepList(storageRoot, threadId) {
+    const headHash = await resolveHeadHash(storageRoot, threadId);
+    const uwf = await createUwfStore(storageRoot);
+    const chain = walkChain(uwf, headHash);
+    const startNode = uwf.store.cas.get(chain.startHash);
+    if (startNode === null) {
+        fail(`StartNode not found: ${chain.startHash}`);
+    }
+    const startEntry = {
+        hash: chain.startHash,
+        workflow: chain.start.workflow,
+        prompt: chain.start.prompt,
+        timestamp: startNode.timestamp,
+    };
+    const stepEntries = [];
+    const ordered = collectOrderedSteps(uwf, headHash, chain);
+    for (const item of ordered) {
+        stepEntries.push({
+            hash: item.hash,
+            role: item.payload.role,
+            output: expandOutput(uwf, item.payload.output),
+            detail: item.payload.detail ?? null,
+            agent: item.payload.agent,
+            timestamp: item.timestamp,
+            durationMs: item.payload.completedAtMs - item.payload.startedAtMs,
+            usage: item.payload.usage ?? null,
+        });
+    }
+    return {
+        thread: threadId,
+        workflow: chain.start.workflow,
+        steps: [startEntry, ...stepEntries],
+    };
+}
+/**
+ * Show details of a specific step (previously: thread step-details)
+ */
+export async function cmdStepShow(storageRoot, stepHash) {
+    const uwf = await createUwfStore(storageRoot);
+    const node = uwf.store.cas.get(stepHash);
+    if (node === null) {
+        fail(`CAS node not found: ${stepHash}`);
+    }
+    if (node.type !== uwf.schemas.stepNode) {
+        fail(`node ${stepHash} is not a StepNode`);
+    }
+    const payload = node.payload;
+    if (!payload.detail) {
+        fail(`step ${stepHash} has no detail`);
+    }
+    return expandDeep(uwf.store, payload.detail);
+}
+/**
+ * Fork a thread from a specific step (previously: thread fork)
+ */
+export async function cmdStepFork(storageRoot, stepHash) {
+    const uwf = await createUwfStore(storageRoot);
+    const node = uwf.store.cas.get(stepHash);
+    if (node === null) {
+        fail(`CAS node not found: ${stepHash}`);
+    }
+    if (node.type !== uwf.schemas.startNode && node.type !== uwf.schemas.stepNode) {
+        fail(`node ${stepHash} is not a StartNode or StepNode`);
+    }
+    const newThreadId = generateUlid(Date.now());
+    setThread(uwf.varStore, newThreadId, {
+        head: stepHash,
+        status: "idle",
+        suspendedRole: null,
+        suspendMessage: null,
+        completedAt: null,
+    });
+    return {
+        thread: newThreadId,
+        forkedFrom: {
+            step: stepHash,
+        },
+    };
+}
+/**
+ * Load and validate step detail node from CAS store
+ */
+function loadStepDetail(store, detailRef) {
+    const detailNode = store.get(detailRef);
+    if (detailNode === null) {
+        fail(`detail node not found: ${detailRef}`);
+    }
+    return detailNode.payload;
+}
+function parseTurnToolCalls(raw) {
+    if (!Array.isArray(raw) || raw.length === 0) {
+        return null;
+    }
+    const calls = [];
+    for (const entry of raw) {
+        if (typeof entry !== "object" || entry === null) {
+            continue;
+        }
+        const record = entry;
+        const name = record.name;
+        const args = record.args;
+        if (typeof name === "string") {
+            calls.push({ name, args: typeof args === "string" ? args : "" });
+        }
+    }
+    return calls.length > 0 ? calls : null;
+}
+function formatTurnBody(turn) {
+    const parts = [];
+    parts.push(`**Turn role:** ${turn.role}`);
+    if (turn.toolCalls !== null) {
+        for (const call of turn.toolCalls) {
+            const argsSuffix = call.args !== "" ? ` — \`${call.args}\`` : "";
+            parts.push(`- **${call.name}**${argsSuffix}`);
+        }
+    }
+    if (turn.content !== "") {
+        if (parts.length > 0) {
+            parts.push("");
+        }
+        parts.push(turn.content);
+    }
+    return parts.join("\n");
+}
+function parseSingleTurn(store, turnRef, fallbackIndex) {
+    if (typeof turnRef !== "string") {
+        return null;
+    }
+    const turnNode = store.get(turnRef);
+    if (turnNode === null) {
+        return null;
+    }
+    const turn = turnNode.payload;
+    const content = typeof turn.content === "string" ? turn.content : "";
+    const toolCalls = parseTurnToolCalls(turn.toolCalls);
+    if (content === "" && toolCalls === null) {
+        return null;
+    }
+    return {
+        index: typeof turn.index === "number" ? turn.index : fallbackIndex,
+        role: typeof turn.role === "string" ? turn.role : "assistant",
+        content,
+        toolCalls,
+    };
+}
+/**
+ * Load all turn nodes from CAS store and extract display fields
+ */
+function loadTurnData(store, turns) {
+    if (!Array.isArray(turns) || turns.length === 0) {
+        return [];
+    }
+    const turnData = [];
+    for (const turnRef of turns) {
+        const parsed = parseSingleTurn(store, turnRef, turnData.length);
+        if (parsed !== null) {
+            turnData.push(parsed);
+        }
+    }
+    return turnData;
+}
+/**
+ * Select turns that fit within quota, working backwards from most recent
+ */
+function selectTurnsForQuota(turnData, availableQuota) {
+    const selectedTurns = [];
+    let totalChars = 0;
+    for (let i = turnData.length - 1; i >= 0; i--) {
+        const turn = turnData[i];
+        if (turn === undefined)
+            continue;
+        const turnHeader = `## Turn ${turn.index + 1}\n\n`;
+        const turnBlock = turnHeader + formatTurnBody(turn);
+        const separatorCost = selectedTurns.length > 0 ? 2 : 0;
+        const addCost = turnBlock.length + separatorCost;
+        if (totalChars + addCost > availableQuota && selectedTurns.length > 0) {
+            break;
+        }
+        selectedTurns.unshift(turn);
+        totalChars += addCost;
+    }
+    return selectedTurns;
+}
+/**
+ * Assemble final markdown output from header and selected turns
+ */
+function formatStepMarkdown(stepHash, role, agent, turnData, selectedTurns) {
+    const parts = [];
+    parts.push(`# Step ${stepHash}`);
+    parts.push("");
+    parts.push(`**Role:** ${role}`);
+    parts.push(`**Agent:** ${agent}`);
+    if (selectedTurns.length === 0) {
+        return parts.join("\n");
+    }
+    const skippedCount = turnData.length - selectedTurns.length;
+    if (skippedCount > 0) {
+        parts.push("");
+        parts.push(`_[Earlier turns omitted due to quota. Use --quota to increase.]_`);
+    }
+    for (const turn of selectedTurns) {
+        parts.push("");
+        parts.push(`## Turn ${turn.index + 1}`);
+        parts.push("");
+        parts.push(formatTurnBody(turn));
+    }
+    return parts.join("\n");
+}
+/**
+ * Read a step's agent turns as human-readable markdown with quota enforcement
+ */
+export async function cmdStepRead(storageRoot, stepHash, quota, showPrompt) {
+    const uwf = await createUwfStore(storageRoot);
+    const node = uwf.store.cas.get(stepHash);
+    if (node === null) {
+        fail(`CAS node not found: ${stepHash}`);
+    }
+    if (node.type !== uwf.schemas.stepNode) {
+        fail(`node ${stepHash} is not a StepNode`);
+    }
+    const payload = node.payload;
+    // --prompt mode: show the assembled prompt that was sent to the agent
+    if (showPrompt) {
+        const promptRef = payload.assembledPrompt;
+        if (typeof promptRef !== "string") {
+            return `# Step ${stepHash}\n\n_Prompt not recorded (legacy step)._`;
+        }
+        const promptNode = uwf.store.cas.get(promptRef);
+        if (promptNode === null) {
+            return `# Step ${stepHash}\n\n_Prompt CAS node not found: ${promptRef}_`;
+        }
+        const promptText = typeof promptNode.payload === "string"
+            ? promptNode.payload
+            : JSON.stringify(promptNode.payload);
+        return `# Step ${stepHash}\n\n**Role:** ${payload.role}\n**Agent:** ${payload.agent}\n\n## Prompt\n\n${promptText}`;
+    }
+    if (payload.detail === null) {
+        return formatStepMarkdown(stepHash, payload.role, payload.agent, [], []);
+    }
+    const detail = loadStepDetail(uwf.store.cas, payload.detail);
+    const turnData = loadTurnData(uwf.store.cas, detail.turns);
+    if (turnData.length === 0) {
+        return formatStepMarkdown(stepHash, payload.role, payload.agent, [], []);
+    }
+    const headerSection = formatStepMarkdown(stepHash, payload.role, payload.agent, [], []);
+    const BUFFER = 200;
+    const availableQuota = quota - headerSection.length - BUFFER;
+    const selectedTurns = selectTurnsForQuota(turnData, availableQuota);
+    return formatStepMarkdown(stepHash, payload.role, payload.agent, turnData, selectedTurns);
+}
+//# sourceMappingURL=step.js.map

package/dist/commands/step.js.map

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

package/dist/commands/thread-time-parser.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Parse time input: ISO date (YYYY-MM-DD, YYYY-MM-DDTHH:MM:SS) or relative (7d, 24h, 30m)
+ * Returns Unix timestamp in milliseconds.
+ */
+export declare function parseTimeInput(input: string, nowMs: number): number;
+//# sourceMappingURL=thread-time-parser.d.ts.map

package/dist/commands/thread-time-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"thread-time-parser.d.ts","sourceRoot":"","sources":["../../src/commands/thread-time-parser.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAkBnE"}

package/dist/commands/thread-time-parser.js

@@ -0,0 +1,22 @@
+/**
+ * Parse time input: ISO date (YYYY-MM-DD, YYYY-MM-DDTHH:MM:SS) or relative (7d, 24h, 30m)
+ * Returns Unix timestamp in milliseconds.
+ */
+export function parseTimeInput(input, nowMs) {
+    const trimmed = input.trim();
+    // Relative time: 7d, 24h, 30m
+    const relativeMatch = /^(\d+)(d|h|m)$/.exec(trimmed);
+    if (relativeMatch !== null) {
+        const value = Number.parseInt(relativeMatch[1], 10);
+        const unit = relativeMatch[2];
+        const multiplier = unit === "d" ? 86400000 : unit === "h" ? 3600000 : 60000;
+        return nowMs - value * multiplier;
+    }
+    // ISO date: try parsing
+    const parsed = Date.parse(trimmed);
+    if (Number.isNaN(parsed)) {
+        throw new Error(`invalid time format: ${trimmed} (expected ISO date or relative like '7d')`);
+    }
+    return parsed;
+}
+//# sourceMappingURL=thread-time-parser.js.map

package/dist/commands/thread-time-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"thread-time-parser.js","sourceRoot":"","sources":["../../src/commands/thread-time-parser.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,KAAa,EAAE,KAAa;IACzD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAE7B,8BAA8B;IAC9B,MAAM,aAAa,GAAG,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACrD,IAAI,aAAa,KAAK,IAAI,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACpD,MAAM,IAAI,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;QAC9B,MAAM,UAAU,GAAG,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;QAC5E,OAAO,KAAK,GAAG,KAAK,GAAG,UAAU,CAAC;IACpC,CAAC;IAED,wBAAwB;IACxB,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACnC,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,wBAAwB,OAAO,4CAA4C,CAAC,CAAC;IAC/F,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/commands/thread.d.ts

@@ -0,0 +1,38 @@
+import type { CasRef, StartOutput, StepOutput, ThreadId, ThreadListItem, ThreadStatus } from "@united-workforce/protocol";
+import { type UwfStore } from "../store.js";
+export declare const THREAD_READ_DEFAULT_QUOTA = 4000;
+export declare function cmdThreadStart(storageRoot: string, workflowId: string, prompt: string, projectRoot: string, cwd?: string): Promise<StartOutput>;
+export declare function cmdThreadShow(storageRoot: string, threadId: ThreadId): Promise<ThreadShowOutput>;
+export type ThreadListItemWithStatus = ThreadListItem & {
+    status: ThreadStatus;
+    currentRole: string | null;
+    /** Display label with status marker for suspended threads */
+    statusDisplay: string;
+};
+export type ThreadShowOutput = StepOutput & {
+    /** Hint message for suspended threads */
+    hint: string | null;
+};
+export declare function cmdThreadList(storageRoot: string, statusFilter: ThreadStatus[] | null, afterMs: number | null, beforeMs: number | null, skip: number | null, take: number | null): Promise<ThreadListItemWithStatus[]>;
+export declare function extractLastAssistantContent(uwf: UwfStore, detailRef: CasRef): string | null;
+export declare function cmdThreadResume(storageRoot: string, threadId: ThreadId, supplement: string | null, agentOverride: string | null): Promise<StepOutput>;
+export declare function validateCount(count: number): void;
+export declare function cmdThreadExec(storageRoot: string, threadId: ThreadId, agentOverride: string | null, count: number, background: boolean, backgroundWorker: boolean): Promise<StepOutput[]>;
+export declare function cmdThreadRead(storageRoot: string, threadId: ThreadId, quota?: number, before?: CasRef | null, showStart?: boolean): Promise<string>;
+export type StopOutput = {
+    thread: ThreadId;
+    stopped: boolean;
+};
+export type CancelOutput = {
+    thread: ThreadId;
+    cancelled: boolean;
+};
+/**
+ * Stop background execution of a thread (but keep thread active)
+ */
+export declare function cmdThreadStop(storageRoot: string, threadId: ThreadId): Promise<StopOutput>;
+/**
+ * Cancel a thread (stop execution + move to history)
+ */
+export declare function cmdThreadCancel(storageRoot: string, threadId: ThreadId): Promise<CancelOutput>;
+//# sourceMappingURL=thread.d.ts.map

package/dist/commands/thread.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"thread.d.ts","sourceRoot":"","sources":["../../src/commands/thread.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAGV,MAAM,EAEN,WAAW,EAEX,UAAU,EACV,QAAQ,EAER,cAAc,EACd,YAAY,EAIb,MAAM,4BAA4B,CAAC;AAmBpC,OAAO,EASL,KAAK,QAAQ,EACd,MAAM,aAAa,CAAC;AAerB,eAAO,MAAM,yBAAyB,OAAO,CAAC;AAmX9C,wBAAsB,cAAc,CAClC,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,GAAG,GAAE,MAAsB,GAC1B,OAAO,CAAC,WAAW,CAAC,CAmCtB;AAED,wBAAsB,aAAa,CACjC,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,QAAQ,GACjB,OAAO,CAAC,gBAAgB,CAAC,CAoD3B;AAED,MAAM,MAAM,wBAAwB,GAAG,cAAc,GAAG;IACtD,MAAM,EAAE,YAAY,CAAC;IACrB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,6DAA6D;IAC7D,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,UAAU,GAAG;IAC1C,yCAAyC;IACzC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB,CAAC;AAmGF,wBAAsB,aAAa,CACjC,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,YAAY,EAAE,GAAG,IAAI,EACnC,OAAO,EAAE,MAAM,GAAG,IAAI,EACtB,QAAQ,EAAE,MAAM,GAAG,IAAI,EACvB,IAAI,EAAE,MAAM,GAAG,IAAI,EACnB,IAAI,EAAE,MAAM,GAAG,IAAI,GAClB,OAAO,CAAC,wBAAwB,EAAE,CAAC,CA+BrC;AAED,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA6B3F;AAiUD,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,QAAQ,EAClB,UAAU,EAAE,MAAM,GAAG,IAAI,EACzB,aAAa,EAAE,MAAM,GAAG,IAAI,GAC3B,OAAO,CAAC,UAAU,CAAC,CAyFrB;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAIjD;AAED,wBAAsB,aAAa,CACjC,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,QAAQ,EAClB,aAAa,EAAE,MAAM,GAAG,IAAI,EAC5B,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,OAAO,EACnB,gBAAgB,EAAE,OAAO,GACxB,OAAO,CAAC,UAAU,EAAE,CAAC,CAkDvB;AAkSD,wBAAsB,aAAa,CACjC,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,QAAQ,EAClB,KAAK,GAAE,MAAkC,EACzC,MAAM,GAAE,MAAM,GAAG,IAAW,EAC5B,SAAS,GAAE,OAAe,GACzB,OAAO,CAAC,MAAM,CAAC,CAmBjB;AAED,MAAM,MAAM,UAAU,GAAG;IACvB,MAAM,EAAE,QAAQ,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,MAAM,EAAE,QAAQ,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF;;GAEG;AACH,wBAAsB,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC,CAsBhG;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,QAAQ,GACjB,OAAO,CAAC,YAAY,CAAC,CAqBvB"}