@lleverage-ai/agent-sdk 0.0.3 → 0.0.5

package/dist/plugins/agent-teams/index.js

@@ -0,0 +1,313 @@
+/**
+ * Agent Teams plugin for multi-agent coordination.
+ *
+ * Enables dynamic agent team coordination via runtime tools.
+ * When `start_team` is called, team management tools are added to the
+ * primary agent at runtime. Independent teammates communicate via mailboxes,
+ * share a task list with dependencies, and self-organize work.
+ * When `end_team` is called, the team tools are removed.
+ *
+ * @packageDocumentation
+ */
+import { tool } from "ai";
+import { z } from "zod";
+import { createAgent } from "../../agent.js";
+import { invokeCustomHook } from "../../hooks.js";
+import { definePlugin } from "../../plugins.js";
+import { InMemoryTeamCoordinator } from "./coordinator.js";
+import { TEAM_HOOKS } from "./hooks.js";
+import { HeadlessSessionRunner } from "./session-runner.js";
+import { createLeadTools, createTeammateTools } from "./tools.js";
+// Re-exports
+export { InMemoryTeamCoordinator } from "./coordinator.js";
+export { TEAM_HOOKS } from "./hooks.js";
+export { tasksToMermaid } from "./mermaid.js";
+export { HeadlessSessionRunner } from "./session-runner.js";
+/** System prompt augmentation for teammates */
+function buildTeammateSystemPrompt(basePrompt, role) {
+    const teammateInstructions = `
+## Team Context
+
+You are a teammate with role "${role}".
+
+### Workflow
+1. Check available tasks: team_task_list
+2. Claim a task: team_task_claim
+3. Do the work using your tools and capabilities
+4. Mark the task as completed: team_task_complete
+5. Check for messages: team_read_messages
+6. Communicate with the lead or other teammates: team_message
+
+### Guidelines
+- Always claim a task before starting work
+- Complete tasks thoroughly before claiming the next one
+- Send a message to the lead when you finish important work
+- Check for messages regularly in case the lead has updates
+`;
+    return basePrompt
+        ? `${basePrompt}\n\n${teammateInstructions}`
+        : teammateInstructions;
+}
+/**
+ * Build the activation message returned as the `start_team` tool result.
+ * This replaces the old leader system prompt augmentation — the information
+ * is delivered as a tool result so the primary agent knows what to do.
+ */
+function buildTeamActivationMessage(reason, teammates, initialTasks) {
+    const roleList = teammates
+        .map((t) => `- **${t.role}**: ${t.description}`)
+        .join("\n");
+    let message = `Team mode activated. Reason: ${reason}
+
+## Available Teammate Roles
+${roleList}
+
+## Team Management Tools Now Available
+You now have team management tools. Use them to coordinate work:
+
+### Workflow
+1. Break the work into clear tasks (team_task_create)
+2. Spawn teammates for the roles needed (team_spawn)
+3. Monitor progress (team_task_list, team_read_messages)
+4. Communicate with teammates (team_message)
+5. When all work is done, summarize results and end the team (end_team)
+
+### Guidelines
+- Create tasks before spawning teammates so they can immediately claim work
+- Use task dependencies (blocked_by) to order dependent work
+- Periodically check messages from teammates for questions or results
+- When all tasks are completed, synthesize results and call end_team
+`;
+    if (initialTasks && initialTasks.length > 0) {
+        message += "\n## Initial Tasks Created\n";
+        for (const task of initialTasks) {
+            message += `- ${task.subject}: ${task.description}\n`;
+        }
+    }
+    return message;
+}
+/**
+ * Creates the Agent Teams plugin.
+ *
+ * This plugin adds a `start_team` tool to the primary agent. When called,
+ * team management tools are dynamically added to the agent via runtime tools.
+ * No agent handoff occurs — the primary agent itself becomes the team leader.
+ *
+ * @param options - Plugin configuration
+ * @returns An AgentPlugin that enables team coordination
+ *
+ * @example
+ * ```typescript
+ * import { createAgent } from "@lleverage-ai/agent-sdk";
+ * import { createAgentTeamsPlugin } from "@lleverage-ai/agent-sdk/plugins/agent-teams";
+ *
+ * const agent = createAgent({
+ *   model: "anthropic/claude-sonnet-4",
+ *   systemPrompt: "You are a helpful assistant.",
+ *   plugins: [
+ *     createAgentTeamsPlugin({
+ *       teammates: [
+ *         {
+ *           role: "researcher",
+ *           description: "Researches topics thoroughly",
+ *           agentOptions: { systemPrompt: "You are a thorough researcher..." },
+ *         },
+ *         {
+ *           role: "coder",
+ *           description: "Writes clean, tested code",
+ *           agentOptions: { systemPrompt: "You are a senior developer..." },
+ *         },
+ *       ],
+ *     }),
+ *   ],
+ * });
+ * ```
+ *
+ * @category Agent Teams
+ */
+export function createAgentTeamsPlugin(options) {
+    const maxConcurrent = options.maxConcurrentTeammates ?? Infinity;
+    let primaryAgent;
+    // Active team session state (undefined when no team is active)
+    let coordinator;
+    let runners;
+    let activeToolNames;
+    return definePlugin({
+        name: "agent-teams",
+        description: "Enables dynamic agent team coordination via runtime tools",
+        hooks: options.hooks,
+        setup: async (agent) => {
+            primaryAgent = agent;
+        },
+        tools: {
+            start_team: tool({
+                description: "Start a team of specialized agents to work on a complex task in parallel. " +
+                    "Use this when the task benefits from multiple agents working concurrently.",
+                inputSchema: z.object({
+                    reason: z.string().describe("Why a team is needed for this task"),
+                    initial_tasks: z
+                        .array(z.object({
+                        subject: z.string().describe("Brief task title"),
+                        description: z.string().describe("Detailed task description"),
+                        blocked_by: z.array(z.string()).optional().describe("Task subjects this depends on"),
+                    }))
+                        .optional()
+                        .describe("Initial tasks to create for the team"),
+                }),
+                execute: async ({ reason, initial_tasks }) => {
+                    if (!primaryAgent) {
+                        throw new Error("Plugin not initialized");
+                    }
+                    if (coordinator) {
+                        return "Team already active. Use end_team first.";
+                    }
+                    // Create a fresh coordinator for this team session
+                    coordinator = options.coordinator ?? new InMemoryTeamCoordinator();
+                    runners = new Map();
+                    // Create initial tasks if provided
+                    const taskIdMap = new Map();
+                    if (initial_tasks) {
+                        for (const task of initial_tasks) {
+                            const blockedByIds = (task.blocked_by ?? [])
+                                .map((subject) => taskIdMap.get(subject))
+                                .filter((id) => id !== undefined);
+                            const created = coordinator.createTask({
+                                subject: task.subject,
+                                description: task.description,
+                                status: "pending",
+                                createdBy: "lead",
+                                blockedBy: blockedByIds,
+                            });
+                            taskIdMap.set(task.subject, created.id);
+                        }
+                    }
+                    // Capture refs for closures
+                    const currentCoordinator = coordinator;
+                    const currentRunners = runners;
+                    const agent = primaryAgent;
+                    // Shared mutable ref for teammate tools (teammate agent created after tools)
+                    const agentRef = { current: undefined };
+                    // Function to spawn a teammate
+                    const spawnTeammate = async (role, initialPrompt) => {
+                        const def = options.teammates.find((t) => t.role === role);
+                        if (!def) {
+                            throw new Error(`Unknown teammate role: ${role}`);
+                        }
+                        const teammateId = `${role}-${Date.now().toString(36)}`;
+                        const model = def.model ?? agent.options?.model;
+                        if (!model) {
+                            throw new Error("No model available for teammate. Provide a model in TeammateDefinition or the primary agent.");
+                        }
+                        // Create teammate tools (uses agentRef since teammate agent is created after)
+                        const teammateToolSet = createTeammateTools({
+                            teammateId,
+                            coordinator: currentCoordinator,
+                            hooks: options.hooks,
+                            agentRef,
+                        });
+                        // Create teammate agent
+                        const teammateAgent = createAgent({
+                            ...def.agentOptions,
+                            model,
+                            systemPrompt: buildTeammateSystemPrompt(def.agentOptions.systemPrompt, role),
+                            tools: {
+                                ...(def.agentOptions.tools ?? {}),
+                                ...teammateToolSet,
+                            },
+                            permissionMode: "bypassPermissions",
+                        });
+                        // Set the ref so teammate tools can access the agent
+                        agentRef.current = teammateAgent;
+                        // Register teammate
+                        const info = {
+                            id: teammateId,
+                            role,
+                            description: def.description,
+                            status: "idle",
+                            spawnedAt: new Date().toISOString(),
+                        };
+                        currentCoordinator.registerTeammate(info);
+                        // Create and start runner
+                        const runner = new HeadlessSessionRunner({
+                            agent: teammateAgent,
+                            teammateId,
+                            coordinator: currentCoordinator,
+                            initialPrompt,
+                            hooks: options.hooks,
+                            maxTurns: def.maxTurns,
+                            onError: options.onError,
+                            idleTimeoutMs: options.idleTimeoutMs,
+                        });
+                        currentRunners.set(teammateId, runner);
+                        // Start the runner in the background
+                        runner.start().catch(async (err) => {
+                            const error = err instanceof Error ? err : new Error(String(err));
+                            if (options.onError) {
+                                options.onError(teammateId, error);
+                            }
+                            else {
+                                console.error(`[team:${teammateId}] Runner error:`, err);
+                            }
+                            // Fire TeammateStopped hook
+                            await invokeCustomHook(options.hooks, TEAM_HOOKS.TeammateStopped, { teammateId, error: error.message }, agent);
+                        });
+                        return teammateId;
+                    };
+                    // Create lead tools (pass agent directly — no AgentRef needed)
+                    const leadTools = createLeadTools({
+                        coordinator: currentCoordinator,
+                        runners: currentRunners,
+                        teammates: options.teammates,
+                        hooks: options.hooks,
+                        agent,
+                        spawnTeammate,
+                        maxConcurrentTeammates: maxConcurrent,
+                    });
+                    // Create end_team tool
+                    const endTeamTool = tool({
+                        description: "End the team session. Shuts down all active teammates and removes team tools. " +
+                            "Call this when all team work is complete.",
+                        inputSchema: z.object({
+                            summary: z.string().describe("Summary of team results"),
+                        }),
+                        execute: async ({ summary }) => {
+                            // Check for incomplete tasks before shutting down
+                            const allTasks = currentCoordinator.listTasks();
+                            const incomplete = allTasks.filter((t) => t.status !== "completed");
+                            // Stop all active teammates
+                            for (const [id, runner] of currentRunners) {
+                                if (runner.isRunning()) {
+                                    runner.stop();
+                                }
+                                await invokeCustomHook(options.hooks, TEAM_HOOKS.TeammateStopped, { teammateId: id }, agent);
+                            }
+                            currentRunners.clear();
+                            // Dispose the coordinator
+                            currentCoordinator.dispose();
+                            // Remove team tools from the primary agent
+                            if (activeToolNames) {
+                                agent.removeRuntimeTools(activeToolNames);
+                            }
+                            // Reset state
+                            coordinator = undefined;
+                            runners = undefined;
+                            activeToolNames = undefined;
+                            if (incomplete.length > 0) {
+                                const warning = `Warning: ${incomplete.length} task(s) not completed:\n${incomplete.map((t) => `- ${t.id}: [${t.status}] ${t.subject}`).join("\n")}\n\n`;
+                                return warning + summary;
+                            }
+                            return summary;
+                        },
+                    });
+                    const teamTools = { ...leadTools, end_team: endTeamTool };
+                    activeToolNames = Object.keys(teamTools);
+                    // Add team tools to the primary agent at runtime
+                    agent.addRuntimeTools(teamTools);
+                    // Return team context as tool result
+                    return buildTeamActivationMessage(reason, options.teammates, initial_tasks);
+                },
+            }),
+        },
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/plugins/agent-teams/index.js.map

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

package/dist/plugins/agent-teams/mermaid.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Mermaid diagram generation for team task dependency graphs.
+ *
+ * @packageDocumentation
+ */
+import type { TeamTask } from "./types.js";
+/**
+ * Converts an array of team tasks into a mermaid `graph TD` diagram string.
+ *
+ * Nodes are labeled with the task subject and a status icon.
+ * Edges represent `blockedBy` dependencies (blocker → blocked).
+ * CSS classes are applied per status for visual styling.
+ *
+ * @param tasks - The tasks to visualize
+ * @returns A valid mermaid diagram string
+ *
+ * @example
+ * ```typescript
+ * const tasks = coordinator.listTasks();
+ * const diagram = tasksToMermaid(tasks);
+ * console.log(diagram);
+ * // graph TD
+ * //   task-1["Research TypeScript ✓"]
+ * //   task-2["Write Code ⏳"]
+ * //   task-1 --> task-2
+ * //   ...
+ * ```
+ *
+ * @category Agent Teams
+ */
+export declare function tasksToMermaid(tasks: TeamTask[]): string;
+//# sourceMappingURL=mermaid.d.ts.map

package/dist/plugins/agent-teams/mermaid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mermaid.d.ts","sourceRoot":"","sources":["../../../src/plugins/agent-teams/mermaid.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,MAAM,CAyCxD"}

package/dist/plugins/agent-teams/mermaid.js

@@ -0,0 +1,66 @@
+/**
+ * Mermaid diagram generation for team task dependency graphs.
+ *
+ * @packageDocumentation
+ */
+/**
+ * Converts an array of team tasks into a mermaid `graph TD` diagram string.
+ *
+ * Nodes are labeled with the task subject and a status icon.
+ * Edges represent `blockedBy` dependencies (blocker → blocked).
+ * CSS classes are applied per status for visual styling.
+ *
+ * @param tasks - The tasks to visualize
+ * @returns A valid mermaid diagram string
+ *
+ * @example
+ * ```typescript
+ * const tasks = coordinator.listTasks();
+ * const diagram = tasksToMermaid(tasks);
+ * console.log(diagram);
+ * // graph TD
+ * //   task-1["Research TypeScript ✓"]
+ * //   task-2["Write Code ⏳"]
+ * //   task-1 --> task-2
+ * //   ...
+ * ```
+ *
+ * @category Agent Teams
+ */
+export function tasksToMermaid(tasks) {
+    if (tasks.length === 0)
+        return "graph TD\n  empty[No tasks]";
+    const lines = ["graph TD"];
+    // Node definitions
+    for (const task of tasks) {
+        const statusIcon = task.status === "completed" ? " ✓" : task.status === "in_progress" ? " ⏳" : "";
+        const label = `${task.subject}${statusIcon}`.replace(/"/g, """);
+        lines.push(`  ${task.id}["${label}"]`);
+    }
+    // Edges: blocker --> blocked
+    for (const task of tasks) {
+        for (const depId of task.blockedBy) {
+            lines.push(`  ${depId} --> ${task.id}`);
+        }
+    }
+    // Status-based styling
+    lines.push("");
+    lines.push("  classDef completed fill:#90EE90,stroke:#333");
+    lines.push("  classDef in_progress fill:#FFD700,stroke:#333");
+    lines.push("  classDef pending fill:#D3D3D3,stroke:#333");
+    const byStatus = {
+        completed: [],
+        in_progress: [],
+        pending: [],
+    };
+    for (const task of tasks) {
+        byStatus[task.status]?.push(task.id);
+    }
+    for (const [status, ids] of Object.entries(byStatus)) {
+        if (ids.length > 0) {
+            lines.push(`  class ${ids.join(",")} ${status}`);
+        }
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=mermaid.js.map

package/dist/plugins/agent-teams/mermaid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mermaid.js","sourceRoot":"","sources":["../../../src/plugins/agent-teams/mermaid.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,UAAU,cAAc,CAAC,KAAiB;IAC9C,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,6BAA6B,CAAC;IAE7D,MAAM,KAAK,GAAa,CAAC,UAAU,CAAC,CAAC;IAErC,mBAAmB;IACnB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,UAAU,GACd,IAAI,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,KAAK,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QACjF,MAAM,KAAK,GAAG,GAAG,IAAI,CAAC,OAAO,GAAG,UAAU,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QACrE,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,EAAE,KAAK,KAAK,IAAI,CAAC,CAAC;IACzC,CAAC;IAED,6BAA6B;IAC7B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnC,KAAK,CAAC,IAAI,CAAC,KAAK,KAAK,QAAQ,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;IAED,uBAAuB;IACvB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,+CAA+C,CAAC,CAAC;IAC5D,KAAK,CAAC,IAAI,CAAC,iDAAiD,CAAC,CAAC;IAC9D,KAAK,CAAC,IAAI,CAAC,6CAA6C,CAAC,CAAC;IAE1D,MAAM,QAAQ,GAA6B;QACzC,SAAS,EAAE,EAAE;QACb,WAAW,EAAE,EAAE;QACf,OAAO,EAAE,EAAE;KACZ,CAAC;IACF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACvC,CAAC;IACD,KAAK,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QACrD,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACnB,KAAK,CAAC,IAAI,CAAC,WAAW,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,MAAM,EAAE,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/plugins/agent-teams/session-runner.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Headless session runner for teammate agents.
+ *
+ * Runs an AgentSession in the background without a human operator.
+ *
+ * @packageDocumentation
+ */
+import type { Agent, HookRegistration } from "../../types.js";
+import type { TeamCoordinator } from "./types.js";
+/**
+ * Options for creating a HeadlessSessionRunner.
+ *
+ * @category Agent Teams
+ */
+export interface HeadlessSessionRunnerOptions {
+    /** The teammate agent */
+    agent: Agent;
+    /** Unique teammate ID */
+    teammateId: string;
+    /** Team coordinator for message checking */
+    coordinator: TeamCoordinator;
+    /** Initial prompt to send to the agent */
+    initialPrompt: string;
+    /** Hook registration for custom events */
+    hooks?: HookRegistration;
+    /** Maximum turns before stopping */
+    maxTurns?: number;
+    /** Callback for output text */
+    onOutput?: (text: string) => void;
+    /** Callback when teammate enters idle state */
+    onIdle?: (teammateId: string) => void;
+    /** Milliseconds to wait for messages before considering teammate idle. @default 30000 */
+    idleTimeoutMs?: number;
+    /** Callback when a session error occurs. If not provided, errors are logged to console. */
+    onError?: (teammateId: string, error: Error) => void;
+}
+/**
+ * Runs a teammate's AgentSession in the background without a human operator.
+ *
+ * The runner:
+ * 1. Creates an AgentSession with the agent
+ * 2. Sends the initial prompt
+ * 3. When the session waits for input, checks the coordinator mailbox
+ * 4. Injects messages as new prompts or waits for messages
+ *
+ * @category Agent Teams
+ */
+export declare class HeadlessSessionRunner {
+    private session;
+    private running;
+    private stopped;
+    private teammateId;
+    private coordinator;
+    private initialPrompt;
+    private hooks?;
+    private agent;
+    private maxTurns;
+    private onOutput?;
+    private onIdle?;
+    private idleTimeoutMs;
+    private onError?;
+    constructor(options: HeadlessSessionRunnerOptions);
+    /**
+     * Start the headless session runner.
+     *
+     * This runs the session loop, sending the initial prompt and then
+     * processing messages from the coordinator mailbox.
+     */
+    start(): Promise<void>;
+    /**
+     * Send a message to the teammate by injecting it into the session.
+     */
+    sendMessage(content: string): void;
+    /**
+     * Stop the headless session runner.
+     */
+    stop(): void;
+    /**
+     * Check if the runner is currently active.
+     */
+    isRunning(): boolean;
+    /**
+     * Format team messages for injection into the session.
+     * Marks each message as read and formats with sender info.
+     */
+    private formatMessages;
+    /**
+     * Report an error via the onError callback, falling back to console.error.
+     */
+    private reportError;
+}
+//# sourceMappingURL=session-runner.d.ts.map

package/dist/plugins/agent-teams/session-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-runner.d.ts","sourceRoot":"","sources":["../../../src/plugins/agent-teams/session-runner.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAE9D,OAAO,KAAK,EAAE,eAAe,EAAe,MAAM,YAAY,CAAC;AAE/D;;;;GAIG;AACH,MAAM,WAAW,4BAA4B;IAC3C,yBAAyB;IACzB,KAAK,EAAE,KAAK,CAAC;IACb,yBAAyB;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,WAAW,EAAE,eAAe,CAAC;IAC7B,0CAA0C;IAC1C,aAAa,EAAE,MAAM,CAAC;IACtB,0CAA0C;IAC1C,KAAK,CAAC,EAAE,gBAAgB,CAAC;IACzB,oCAAoC;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,+CAA+C;IAC/C,MAAM,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,yFAAyF;IACzF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,2FAA2F;IAC3F,OAAO,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACtD;AAED;;;;;;;;;;GAUG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,OAAO,CAAe;IAC9B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,KAAK,CAAC,CAAmB;IACjC,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,QAAQ,CAAC,CAAyB;IAC1C,OAAO,CAAC,MAAM,CAAC,CAA+B;IAC9C,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,OAAO,CAAC,CAA6C;gBAEjD,OAAO,EAAE,4BAA4B;IAkBjD;;;;;OAKG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAgF5B;;OAEG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAKlC;;OAEG;IACH,IAAI,IAAI,IAAI;IAKZ;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;;OAGG;IACH,OAAO,CAAC,cAAc;IAStB;;OAEG;IACH,OAAO,CAAC,WAAW;CAOpB"}