@smooai/smooth-operator-core 0.1.0

package/dist/agent.js

@@ -0,0 +1,450 @@
+/**
+ * The TypeScript smooth-operator core: a native agentic loop.
+ *
+ * Phase-0 sibling of the C# `SmoothAgent` (`dotnet/core`), the Python core
+ * (`python/core`), and the Rust reference engine. Drives an agentic tool-calling
+ * loop over any OpenAI-compatible chat client (the `openai` SDK pointed at a
+ * gateway): inject retrieved knowledge, call the model, run any requested tools,
+ * feed results back, and loop until the model answers without a tool call or the
+ * iteration budget is hit.
+ *
+ * Deliberately minimal (no compaction / budget / checkpointing yet) — those layer
+ * on exactly as they did when the C# core grew past Phase 0.
+ */
+import { compact } from './compaction.js';
+import { CostTracker } from './cost.js';
+import { isApproved } from './humanGate.js';
+import { ToolSearch } from './toolSearch.js';
+const DEFAULTS = {
+    model: 'claude-haiku-4-5',
+    maxIterations: 8,
+    maxTokens: 512,
+    temperature: 0,
+    knowledgeTopK: 4,
+    maxContextTokens: 8000,
+    maxRetries: 0,
+    retryBackoffMs: 200,
+};
+/** Sleep for `ms` milliseconds; a no-op when `ms <= 0` (so tests don't actually wait). */
+function sleep(ms) {
+    return ms > 0 ? new Promise((resolve) => setTimeout(resolve, ms)) : Promise.resolve();
+}
+/** Pull token usage from an OpenAI-shaped response, defaulting to zero when absent. */
+function extractUsage(usage) {
+    return { promptTokens: usage?.prompt_tokens ?? 0, completionTokens: usage?.completion_tokens ?? 0 };
+}
+export class SmoothAgent {
+    client;
+    options;
+    toolsByName;
+    constructor(client, options = {}) {
+        this.client = client;
+        this.options = options;
+        if (!client)
+            throw new Error('client is required');
+        this.toolsByName = new Map((options.tools ?? []).map((t) => [t.name, t]));
+    }
+    buildSystem(message) {
+        let system = this.options.instructions ?? '';
+        const mem = this.options.memory;
+        if (mem) {
+            const recalled = mem.recall(message, this.options.memoryTopK ?? 4);
+            if (recalled.length > 0) {
+                const block = recalled.map((e) => `- ${e.text}`).join('\n');
+                system = `${system}\n\nRelevant memory (things you remember about this user/context):\n${block}`.trim();
+            }
+        }
+        const kb = this.options.knowledge;
+        if (kb) {
+            const topK = this.options.knowledgeTopK ?? DEFAULTS.knowledgeTopK;
+            const candidateK = Math.max(this.options.knowledgeCandidateK ?? 0, topK);
+            let hits = kb.query(message, candidateK);
+            if (this.options.reranker)
+                hits = this.options.reranker.rerank(message, hits);
+            hits = hits.slice(0, topK);
+            if (hits.length > 0) {
+                const block = hits.map((h) => `[${h.source}] ${h.content}`).join('\n\n');
+                system = `${system}\n\nKnowledge base (ground all facts ONLY in this; if it is not here, say you don't know):\n${block}`.trim();
+            }
+        }
+        return system;
+    }
+    toolSpecs(search) {
+        // Eager (always-visible) tools, plus — when deferred tools exist — the
+        // built-in `tool_search` meta-tool and any deferred tools promoted so far
+        // this run. Deferred-but-unpromoted tools are deliberately omitted so the
+        // model never sees their schemas until it searches for them.
+        const visible = [...(this.options.tools ?? [])];
+        if (search?.hasDeferred()) {
+            visible.push(search);
+            visible.push(...search.promotedTools());
+        }
+        if (visible.length === 0)
+            return undefined;
+        return visible.map((t) => ({
+            type: 'function',
+            function: { name: t.name, description: t.description, parameters: t.parameters },
+        }));
+    }
+    /**
+     * Run a single turn.
+     *
+     * `history` is prior OpenAI-format messages (multi-turn). `thread`, when given,
+     * is a {@link SmoothAgentThread} carrying the conversation across runs: the turn
+     * is seeded from the thread's messages, and this turn's new user + assistant
+     * (+ tool) messages are appended back to it before returning. The thread takes
+     * precedence over `history` as the prior context.
+     */
+    async run(message, history, thread) {
+        const messages = [];
+        const system = this.buildSystem(message);
+        if (system)
+            messages.push({ role: 'system', content: system });
+        // Source prior conversation: the thread (if passed) wins, then the checkpoint
+        // store (if configured), then the explicit `history` argument.
+        const cpStore = this.options.checkpointStore;
+        const cpId = this.options.conversationId;
+        let prior = history;
+        if (cpStore && cpId) {
+            const loaded = cpStore.load(cpId);
+            if (loaded)
+                prior = loaded.messages;
+        }
+        if (thread)
+            prior = [...thread.messages];
+        if (prior)
+            messages.push(...prior);
+        const userMsg = { role: 'user', content: message };
+        messages.push(userMsg);
+        // Track this turn's new messages by identity so they can be appended back to
+        // the thread on exit. Index slicing would be unsafe — compaction may drop or
+        // reorder `messages` mid-turn.
+        const turnMessages = [userMsg];
+        // Per-run promotion state for deferred tools (undefined when none registered).
+        const search = this.options.deferredTools && this.options.deferredTools.length > 0 ? new ToolSearch(this.options.deferredTools) : undefined;
+        const maxIterations = this.options.maxIterations ?? DEFAULTS.maxIterations;
+        let toolCalls = 0;
+        let lastText = '';
+        const maxContextTokens = this.options.maxContextTokens ?? DEFAULTS.maxContextTokens;
+        const model = this.options.model ?? DEFAULTS.model;
+        const tracker = new CostTracker();
+        try {
+            for (let iteration = 1; iteration <= maxIterations; iteration++) {
+                // Keep the context window within budget before each model call.
+                messages.splice(0, messages.length, ...compact(messages, maxContextTokens));
+                // Recompute tool specs each iteration: a `tool_search` call in the
+                // previous iteration may have promoted deferred tools into view.
+                const tools = this.toolSpecs(search);
+                const response = await this.callModel({
+                    model,
+                    messages,
+                    ...(tools ? { tools } : {}),
+                    temperature: this.options.temperature ?? DEFAULTS.temperature,
+                    max_tokens: this.options.maxTokens ?? DEFAULTS.maxTokens,
+                });
+                tracker.record(model, extractUsage(response.usage), this.options.pricing);
+                const choice = response.choices[0].message;
+                lastText = choice.content ?? '';
+                const assistantMsg = { role: 'assistant', content: choice.content ?? '' };
+                if (choice.tool_calls && choice.tool_calls.length > 0) {
+                    assistantMsg.tool_calls = choice.tool_calls.map((tc) => ({
+                        id: tc.id,
+                        type: 'function',
+                        function: { name: tc.function.name, arguments: tc.function.arguments },
+                    }));
+                }
+                messages.push(assistantMsg);
+                turnMessages.push(assistantMsg);
+                // Stop early if this turn has hit its token/cost budget.
+                if (tracker.exceeds(this.options.budget)) {
+                    return { text: lastText, iterations: iteration, toolCalls, usage: tracker.usage, costUsd: tracker.costUsd, budgetExceeded: true };
+                }
+                if (!choice.tool_calls || choice.tool_calls.length === 0) {
+                    return { text: lastText, iterations: iteration, toolCalls, usage: tracker.usage, costUsd: tracker.costUsd, budgetExceeded: false };
+                }
+                toolCalls += choice.tool_calls.length;
+                // Dispatch the tool calls — concurrently when enabled and there's more than
+                // one — but always append the results in the original tool_calls order so the
+                // transcript stays deterministic. dispatchTool turns failures/denials into a
+                // result string, so Promise.all never rejects and cancels its siblings.
+                const calls = choice.tool_calls;
+                let results;
+                if (this.options.parallelToolCalls && calls.length > 1) {
+                    results = await Promise.all(calls.map((tc) => this.dispatchTool(tc.function.name, tc.function.arguments, search)));
+                }
+                else {
+                    results = [];
+                    for (const tc of calls) {
+                        results.push(await this.dispatchTool(tc.function.name, tc.function.arguments, search));
+                    }
+                }
+                for (let i = 0; i < calls.length; i++) {
+                    const toolMsg = { role: 'tool', tool_call_id: calls[i].id, content: results[i] };
+                    messages.push(toolMsg);
+                    turnMessages.push(toolMsg);
+                }
+            }
+            return { text: lastText, iterations: maxIterations, toolCalls, usage: tracker.usage, costUsd: tracker.costUsd, budgetExceeded: false };
+        }
+        finally {
+            // Persist the conversation (sans system prompt, which is rebuilt each turn).
+            if (cpStore && cpId) {
+                cpStore.save({ conversationId: cpId, messages: messages.filter((m) => m.role !== 'system') });
+            }
+            // Append this turn's new messages (user + assistant + tool, never system)
+            // back to the thread so the next run sees the full conversation.
+            if (thread)
+                thread.extend(turnMessages);
+        }
+    }
+    /**
+     * Stream a single turn, yielding incremental {@link StreamEvent}s as the model
+     * produces them. This drives the SAME agentic loop as {@link run} (system /
+     * knowledge / memory build, seed messages, per-iteration compaction, cost
+     * tracking, budget early-stop, deferred-tool specs, clearance + human-gate on
+     * dispatch, checkpoint/thread persistence on exit) — but calls the model in
+     * STREAMING mode and emits events as work happens:
+     *
+     * - a `text` event per non-empty content delta as it streams in;
+     * - a `tool_call` event per requested tool call, after that iteration's model
+     *   stream ends, BEFORE the call is dispatched;
+     * - a `tool_result` event per tool, after it finishes (in original call order
+     *   even when `parallelToolCalls` runs them concurrently);
+     * - exactly one terminal `done` event carrying the same {@link AgentRunResponse}
+     *   {@link run} would return for the same script.
+     *
+     * NOTE: retry-with-backoff (`maxRetries`/`retryBackoffMs`) is intentionally NOT
+     * applied here — re-running the call after a mid-stream failure would re-emit
+     * already-yielded chunks. Retry stays scoped to non-streaming {@link run}; this
+     * mirrors the C# `RunStreamingAsync` decision.
+     */
+    async *runStream(message, history, thread) {
+        const createStream = this.client.chat.completions.createStream?.bind(this.client.chat.completions);
+        if (!createStream)
+            throw new Error('runStream requires a streaming-capable client (chat.completions.createStream)');
+        const messages = [];
+        const system = this.buildSystem(message);
+        if (system)
+            messages.push({ role: 'system', content: system });
+        // Source prior conversation: the thread (if passed) wins, then the checkpoint
+        // store (if configured), then the explicit `history` argument. (Same as `run`.)
+        const cpStore = this.options.checkpointStore;
+        const cpId = this.options.conversationId;
+        let prior = history;
+        if (cpStore && cpId) {
+            const loaded = cpStore.load(cpId);
+            if (loaded)
+                prior = loaded.messages;
+        }
+        if (thread)
+            prior = [...thread.messages];
+        if (prior)
+            messages.push(...prior);
+        const userMsg = { role: 'user', content: message };
+        messages.push(userMsg);
+        const turnMessages = [userMsg];
+        const search = this.options.deferredTools && this.options.deferredTools.length > 0 ? new ToolSearch(this.options.deferredTools) : undefined;
+        const maxIterations = this.options.maxIterations ?? DEFAULTS.maxIterations;
+        let toolCalls = 0;
+        let lastText = '';
+        const maxContextTokens = this.options.maxContextTokens ?? DEFAULTS.maxContextTokens;
+        const model = this.options.model ?? DEFAULTS.model;
+        const tracker = new CostTracker();
+        try {
+            for (let iteration = 1; iteration <= maxIterations; iteration++) {
+                messages.splice(0, messages.length, ...compact(messages, maxContextTokens));
+                const tools = this.toolSpecs(search);
+                // Stream the model call, yielding text deltas as they arrive while
+                // accumulating the full assistant message (content + tool calls + usage).
+                const assembled = { content: '', toolCalls: [], usage: null };
+                const partials = new Map();
+                const stream = createStream({
+                    model,
+                    messages,
+                    ...(tools ? { tools } : {}),
+                    temperature: this.options.temperature ?? DEFAULTS.temperature,
+                    max_tokens: this.options.maxTokens ?? DEFAULTS.maxTokens,
+                    stream: true,
+                });
+                for await (const chunk of stream) {
+                    if (chunk.usage)
+                        assembled.usage = chunk.usage;
+                    const delta = chunk.choices[0]?.delta;
+                    if (!delta)
+                        continue;
+                    if (delta.content) {
+                        assembled.content += delta.content;
+                        yield { type: 'text', text: delta.content };
+                    }
+                    for (const tc of delta.tool_calls ?? []) {
+                        const cur = partials.get(tc.index) ?? { id: '', name: '', arguments: '' };
+                        if (tc.id)
+                            cur.id = tc.id;
+                        if (tc.function?.name)
+                            cur.name = tc.function.name;
+                        if (tc.function?.arguments)
+                            cur.arguments += tc.function.arguments;
+                        partials.set(tc.index, cur);
+                    }
+                }
+                // Materialize accumulated tool calls in ascending index order.
+                assembled.toolCalls = [...partials.entries()]
+                    .sort((a, b) => a[0] - b[0])
+                    .map(([, p]) => ({ id: p.id, function: { name: p.name, arguments: p.arguments } }));
+                tracker.record(model, extractUsage(assembled.usage), this.options.pricing);
+                lastText = assembled.content;
+                const assistantMsg = { role: 'assistant', content: assembled.content };
+                if (assembled.toolCalls.length > 0) {
+                    assistantMsg.tool_calls = assembled.toolCalls.map((tc) => ({
+                        id: tc.id,
+                        type: 'function',
+                        function: { name: tc.function.name, arguments: tc.function.arguments },
+                    }));
+                }
+                messages.push(assistantMsg);
+                turnMessages.push(assistantMsg);
+                if (tracker.exceeds(this.options.budget)) {
+                    yield {
+                        type: 'done',
+                        response: { text: lastText, iterations: iteration, toolCalls, usage: tracker.usage, costUsd: tracker.costUsd, budgetExceeded: true },
+                    };
+                    return;
+                }
+                if (assembled.toolCalls.length === 0) {
+                    yield {
+                        type: 'done',
+                        response: { text: lastText, iterations: iteration, toolCalls, usage: tracker.usage, costUsd: tracker.costUsd, budgetExceeded: false },
+                    };
+                    return;
+                }
+                toolCalls += assembled.toolCalls.length;
+                const calls = assembled.toolCalls;
+                // Emit a tool_call event per requested call (original order) BEFORE dispatch.
+                for (const tc of calls) {
+                    yield { type: 'tool_call', name: tc.function.name, arguments: tc.function.arguments };
+                }
+                // Reuse the SAME dispatch path as `run` (clearance, human-gate, tool_search,
+                // JSON parsing, error-to-string, parallelToolCalls). Results are surfaced in
+                // original call order so the event stream stays deterministic.
+                let results;
+                if (this.options.parallelToolCalls && calls.length > 1) {
+                    results = await Promise.all(calls.map((tc) => this.dispatchTool(tc.function.name, tc.function.arguments, search)));
+                }
+                else {
+                    results = [];
+                    for (const tc of calls) {
+                        results.push(await this.dispatchTool(tc.function.name, tc.function.arguments, search));
+                    }
+                }
+                for (let i = 0; i < calls.length; i++) {
+                    const toolMsg = { role: 'tool', tool_call_id: calls[i].id, content: results[i] };
+                    messages.push(toolMsg);
+                    turnMessages.push(toolMsg);
+                    yield { type: 'tool_result', name: calls[i].function.name, result: results[i] };
+                }
+            }
+            yield {
+                type: 'done',
+                response: { text: lastText, iterations: maxIterations, toolCalls, usage: tracker.usage, costUsd: tracker.costUsd, budgetExceeded: false },
+            };
+        }
+        finally {
+            if (cpStore && cpId) {
+                cpStore.save({ conversationId: cpId, messages: messages.filter((m) => m.role !== 'system') });
+            }
+            if (thread)
+                thread.extend(turnMessages);
+        }
+    }
+    /**
+     * Invoke the model with bounded retry-with-exponential-backoff.
+     *
+     * On a transient error (anything the client throws — rate-limit, 5xx, dropped
+     * connection) the call is retried up to `maxRetries` additional times, waiting
+     * `retryBackoffMs * 2 ** (n - 1)` ms before the n-th (1-indexed) retry. If all
+     * attempts fail the LAST error propagates, so the turn fails exactly as it did
+     * before retries existed. Only this model call is retried — tool execution is not.
+     */
+    async callModel(body) {
+        const maxRetries = this.options.maxRetries ?? DEFAULTS.maxRetries;
+        const backoffMs = this.options.retryBackoffMs ?? DEFAULTS.retryBackoffMs;
+        let attempt = 0;
+        for (;;) {
+            try {
+                return await this.client.chat.completions.create(body);
+            }
+            catch (err) {
+                if (attempt >= maxRetries)
+                    throw err; // retries exhausted (or disabled): propagate last error
+                attempt++;
+                await sleep(backoffMs * 2 ** (attempt - 1));
+            }
+        }
+    }
+    async dispatchTool(name, rawArgs, search) {
+        // Enforce the role's tool clearance before dispatch: a forbidden tool is
+        // never executed — the model is told it isn't permitted, mirroring how the
+        // loop surfaces other tool errors.
+        const clearance = this.options.clearance;
+        if (clearance && !clearance.isAllowed(name)) {
+            return `error: tool '${name}' is not permitted for this role`;
+        }
+        // Resolve the tool: eager tools first, then the built-in `tool_search`
+        // meta-tool, then deferred tools that have been promoted. An unpromoted
+        // deferred tool resolves to nothing — it's invisible until searched for.
+        let tool = this.toolsByName.get(name);
+        if (!tool && search) {
+            tool = name === search.name ? search : search.toolByName(name);
+        }
+        if (!tool)
+            return `error: unknown tool '${name}'`;
+        let args;
+        try {
+            args = rawArgs ? JSON.parse(rawArgs) : {};
+        }
+        catch {
+            return `error: tool '${name}' received invalid JSON arguments`;
+        }
+        // Human-in-the-loop: pause for approval before running a flagged (write/sensitive)
+        // tool. A denial is fed back to the model as a result — the tool never runs.
+        const gate = this.options.humanGate;
+        if (gate && this.options.requiresApproval?.(name, args)) {
+            const decision = await gate({ toolName: name, arguments: args, prompt: `Approve calling tool '${name}'?` });
+            if (!isApproved(decision)) {
+                return `Denied by human: ${decision.reason ?? 'no reason given'}`;
+            }
+        }
+        try {
+            return await tool.execute(args);
+        }
+        catch (err) {
+            // Surface tool failures to the model, don't crash the turn.
+            return `error: tool '${name}' failed: ${err instanceof Error ? err.message : String(err)}`;
+        }
+    }
+}
+/**
+ * Build a {@link Tool} that delegates a subtask to a child {@link SmoothAgent}.
+ *
+ * A sub-agent is just a tool backed by another agent: the model calls this tool
+ * with a `task` argument, the child agent runs that task, and the child's final
+ * reply becomes the tool result — composing with the existing tool loop, no special
+ * wiring. The child can have its own instructions, tools, knowledge, etc.
+ */
+export function delegateTool(name, description, child, taskProperty = 'task') {
+    return {
+        name,
+        description,
+        parameters: {
+            type: 'object',
+            properties: { [taskProperty]: { type: 'string', description: 'The subtask for the sub-agent to perform.' } },
+            required: [taskProperty],
+        },
+        async execute(args) {
+            const task = String(args[taskProperty] ?? '');
+            const result = await child.run(task);
+            return result.text;
+        },
+    };
+}
+//# sourceMappingURL=agent.js.map

package/dist/agent.js.map

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

package/dist/cast.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Multi-agent cast: roles and per-role tool-access policy.
+ *
+ * Phase-2 sibling of the C# reference (`dotnet/core/src/Cast.cs`) and the Rust
+ * engine. A *cast* is the set of named roles a lead can dispatch to; each role has
+ * a {@link RoleKind} (Lead / Sidekick / Shadow) and a {@link Clearance} that gates
+ * which tools it may call.
+ *
+ * {@link Clearance} semantics (mirrors the reference engines):
+ * - a **deny always wins** — a denied tool is never permitted;
+ * - a **non-empty allow-list is a whitelist** — only listed tools are permitted;
+ * - **empty allow + empty deny means "all tools"**.
+ *
+ * Clearance is wired into the agent loop: if `AgentOptions.clearance` forbids a
+ * tool the model asked for, that tool is *not* executed — a clear "not permitted"
+ * result is returned to the model instead, mirroring how the engine surfaces other
+ * tool errors.
+ */
+/** A role's place in a multi-agent cast. Mirrors the reference engines' `RoleKind`. */
+export declare enum RoleKind {
+    /** The orchestrator that delegates to sidekicks. */
+    Lead = "lead",
+    /** A focused specialist a lead can dispatch a sub-task to. */
+    Sidekick = "sidekick",
+    /** A passive observer (e.g. for logging/critique); not directly dispatchable. */
+    Shadow = "shadow"
+}
+/**
+ * Tool-access policy for a role. A deny always wins; a non-empty `allowTools` is a
+ * whitelist; empty allow + empty deny means "all tools". `denyEverything` blocks
+ * every tool regardless of the lists.
+ */
+export declare class Clearance {
+    readonly allowTools: ReadonlySet<string>;
+    readonly denyTools: ReadonlySet<string>;
+    readonly denyEverything: boolean;
+    constructor(options?: {
+        allowTools?: Iterable<string>;
+        denyTools?: Iterable<string>;
+        denyEverything?: boolean;
+    });
+    static allowAll(): Clearance;
+    static denyAll(): Clearance;
+    static allow(...tools: string[]): Clearance;
+    static deny(...tools: string[]): Clearance;
+    /** Whether `tool` is permitted under this clearance. */
+    isAllowed(tool: string): boolean;
+}
+/**
+ * A named role in the cast — its kind, instructions, tool clearance, and budget.
+ * Mirrors the reference engines' `OperatorRole`.
+ */
+export interface OperatorRole {
+    name: string;
+    kind: RoleKind;
+    instructions?: string;
+    /** Tool-access policy (defaults to allow-all when constructed via {@link makeRole}). */
+    permissions?: Clearance;
+    maxIterations?: number;
+    /** Hidden from listings (still dispatchable by name). */
+    hidden?: boolean;
+}
+/** Build an {@link OperatorRole} with the reference-engine defaults applied. */
+export declare function makeRole(name: string, kind: RoleKind, overrides?: {
+    instructions?: string;
+    permissions?: Clearance;
+    maxIterations?: number;
+    hidden?: boolean;
+}): Required<OperatorRole>;
+/** The registered set of roles a lead can dispatch to. Mirrors the reference engines' `Cast`. */
+export declare class Cast {
+    private readonly roles;
+    register(role: OperatorRole): this;
+    get(name: string): OperatorRole | undefined;
+    list(): OperatorRole[];
+    listVisible(): OperatorRole[];
+    sidekicks(): OperatorRole[];
+    get count(): number;
+    get isEmpty(): boolean;
+}
+//# sourceMappingURL=cast.d.ts.map

package/dist/cast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cast.d.ts","sourceRoot":"","sources":["../src/cast.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,uFAAuF;AACvF,oBAAY,QAAQ;IAChB,oDAAoD;IACpD,IAAI,SAAS;IACb,8DAA8D;IAC9D,QAAQ,aAAa;IACrB,iFAAiF;IACjF,MAAM,WAAW;CACpB;AAED;;;;GAIG;AACH,qBAAa,SAAS;IAClB,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACzC,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACxC,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;gBAErB,OAAO,GAAE;QAAE,UAAU,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;QAAC,SAAS,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;QAAC,cAAc,CAAC,EAAE,OAAO,CAAA;KAAO;IAMnH,MAAM,CAAC,QAAQ,IAAI,SAAS;IAI5B,MAAM,CAAC,OAAO,IAAI,SAAS;IAI3B,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,SAAS;IAI3C,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,SAAS;IAI1C,wDAAwD;IACxD,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;CAMnC;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,wFAAwF;IACxF,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,yDAAyD;IACzD,MAAM,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,gFAAgF;AAChF,wBAAgB,QAAQ,CACpB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,QAAQ,EACd,SAAS,GAAE;IAAE,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,SAAS,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GAC7G,QAAQ,CAAC,YAAY,CAAC,CASxB;AAED,iGAAiG;AACjG,qBAAa,IAAI;IACb,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAmC;IAEzD,QAAQ,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI;IAKlC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAI3C,IAAI,IAAI,YAAY,EAAE;IAItB,WAAW,IAAI,YAAY,EAAE;IAI7B,SAAS,IAAI,YAAY,EAAE;IAI3B,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,IAAI,OAAO,IAAI,OAAO,CAErB;CACJ"}