@slashfi/agents-sdk 0.1.0

package/dist/auth.js

@@ -0,0 +1,329 @@
+/**
+ * Auth Agent
+ *
+ * Built-in agent that provides OAuth2 client_credentials authentication.
+ * Register it into any agent registry to enable auth.
+ *
+ * Features:
+ * - Client credentials management (create, rotate, revoke)
+ * - OAuth2 client_credentials token exchange
+ * - JWT access tokens with scopes
+ * - Pluggable AuthStore interface (in-memory default)
+ * - Root key for admin operations
+ *
+ * @example
+ * ```typescript
+ * import { createAgentRegistry, createAgentServer, createAuthAgent } from '@slashfi/agents-sdk';
+ *
+ * const registry = createAgentRegistry();
+ * registry.register(createAuthAgent({ rootKey: process.env.ROOT_KEY }));
+ * registry.register(myAgent);
+ *
+ * const server = createAgentServer(registry, { port: 3000 });
+ * await server.start();
+ * ```
+ */
+import { defineAgent, defineTool } from "./define.js";
+// ============================================
+// In-Memory Auth Store
+// ============================================
+function generateId(prefix) {
+    const chars = "abcdefghijklmnopqrstuvwxyz0123456789";
+    let id = prefix;
+    for (let i = 0; i < 24; i++) {
+        id += chars[Math.floor(Math.random() * chars.length)];
+    }
+    return id;
+}
+function generateSecret() {
+    const chars = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789";
+    let secret = "sk_";
+    for (let i = 0; i < 40; i++) {
+        secret += chars[Math.floor(Math.random() * chars.length)];
+    }
+    return secret;
+}
+function generateToken() {
+    const chars = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789";
+    let token = "at_";
+    for (let i = 0; i < 48; i++) {
+        token += chars[Math.floor(Math.random() * chars.length)];
+    }
+    return token;
+}
+/** Simple hash for storing secrets (not for production - use bcrypt/argon2) */
+async function hashSecret(secret) {
+    const encoder = new TextEncoder();
+    const data = encoder.encode(secret);
+    const hash = await crypto.subtle.digest("SHA-256", data);
+    return Array.from(new Uint8Array(hash))
+        .map((b) => b.toString(16).padStart(2, "0"))
+        .join("");
+}
+/**
+ * Create an in-memory auth store.
+ * Suitable for development and testing. Use a persistent store for production.
+ */
+export function createMemoryAuthStore() {
+    const clients = new Map();
+    const tokens = new Map();
+    return {
+        async createClient(name, scopes, selfRegistered) {
+            const clientId = generateId("ag_");
+            const clientSecret = generateSecret();
+            const secretHash = await hashSecret(clientSecret);
+            clients.set(clientId, {
+                clientId,
+                clientSecretHash: secretHash,
+                name,
+                scopes,
+                createdAt: Date.now(),
+                selfRegistered,
+            });
+            return { clientId, clientSecret };
+        },
+        async validateClient(clientId, clientSecret) {
+            const client = clients.get(clientId);
+            if (!client)
+                return null;
+            const hash = await hashSecret(clientSecret);
+            return hash === client.clientSecretHash ? client : null;
+        },
+        async getClient(clientId) {
+            return clients.get(clientId) ?? null;
+        },
+        async listClients() {
+            return Array.from(clients.values());
+        },
+        async revokeClient(clientId) {
+            // Also revoke all tokens for this client
+            for (const [tokenStr, token] of tokens) {
+                if (token.clientId === clientId) {
+                    tokens.delete(tokenStr);
+                }
+            }
+            return clients.delete(clientId);
+        },
+        async rotateSecret(clientId) {
+            const client = clients.get(clientId);
+            if (!client)
+                return null;
+            const clientSecret = generateSecret();
+            client.clientSecretHash = await hashSecret(clientSecret);
+            return { clientSecret };
+        },
+        async storeToken(token) {
+            tokens.set(token.token, token);
+        },
+        async validateToken(tokenString) {
+            const token = tokens.get(tokenString);
+            if (!token)
+                return null;
+            if (Date.now() > token.expiresAt) {
+                tokens.delete(tokenString);
+                return null;
+            }
+            return token;
+        },
+        async revokeToken(tokenString) {
+            return tokens.delete(tokenString);
+        },
+    };
+}
+// ============================================
+// Create Auth Agent
+// ============================================
+/**
+ * Create the built-in `@auth` agent.
+ *
+ * Provides OAuth2 client_credentials authentication as agent tools.
+ * The server auto-detects this agent and wires up token validation.
+ */
+export function createAuthAgent(options) {
+    const { rootKey, allowRegistration = false, registrationScopes, tokenTtl = 3600, store = createMemoryAuthStore(), } = options;
+    // --- Public Tools ---
+    const tokenTool = defineTool({
+        name: "token",
+        description: "Exchange client credentials for an access token (OAuth2 client_credentials grant)",
+        visibility: "public",
+        inputSchema: {
+            type: "object",
+            properties: {
+                grantType: {
+                    type: "string",
+                    enum: ["client_credentials"],
+                    description: "Grant type. Must be 'client_credentials'.",
+                },
+                clientId: { type: "string", description: "Client ID" },
+                clientSecret: { type: "string", description: "Client secret" },
+            },
+            required: ["grantType", "clientId", "clientSecret"],
+        },
+        execute: async (input) => {
+            if (input.grantType !== "client_credentials") {
+                throw new Error("Unsupported grant type. Use 'client_credentials'.");
+            }
+            const client = await store.validateClient(input.clientId, input.clientSecret);
+            if (!client) {
+                throw new Error("Invalid client credentials");
+            }
+            const token = {
+                token: generateToken(),
+                clientId: client.clientId,
+                scopes: client.scopes,
+                issuedAt: Date.now(),
+                expiresAt: Date.now() + tokenTtl * 1000,
+            };
+            await store.storeToken(token);
+            return {
+                accessToken: token.token,
+                tokenType: "bearer",
+                expiresIn: tokenTtl,
+                scopes: client.scopes,
+            };
+        },
+    });
+    const whoamiTool = defineTool({
+        name: "whoami",
+        description: "Introspect the current authentication context",
+        visibility: "public",
+        inputSchema: { type: "object", properties: {} },
+        execute: async (_input, ctx) => {
+            return {
+                callerId: ctx.callerId,
+                callerType: ctx.callerType,
+                scopes: ctx.scopes ?? [],
+                isRoot: ctx.callerId === "root",
+            };
+        },
+    });
+    // --- Optional Public Tool ---
+    const registerTool = defineTool({
+        name: "register",
+        description: "Register a new agent client (self-service)",
+        visibility: "public",
+        inputSchema: {
+            type: "object",
+            properties: {
+                name: { type: "string", description: "Name for this client" },
+                scopes: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "Requested scopes",
+                },
+            },
+            required: ["name"],
+        },
+        execute: async (input) => {
+            let scopes = input.scopes ?? [];
+            // If registration scopes are restricted, filter
+            if (registrationScopes && registrationScopes.length > 0) {
+                scopes = scopes.filter((s) => registrationScopes.includes(s));
+            }
+            const { clientId, clientSecret } = await store.createClient(input.name, scopes, true);
+            return { clientId, clientSecret, scopes };
+        },
+    });
+    // --- Private Tools (root key only) ---
+    const createClientTool = defineTool({
+        name: "create_client",
+        description: "Create a new client with specific scopes (admin only)",
+        visibility: "private",
+        inputSchema: {
+            type: "object",
+            properties: {
+                name: { type: "string", description: "Client name" },
+                scopes: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "Scopes to grant",
+                },
+            },
+            required: ["name", "scopes"],
+        },
+        execute: async (input) => {
+            const { clientId, clientSecret } = await store.createClient(input.name, input.scopes);
+            return { clientId, clientSecret, scopes: input.scopes };
+        },
+    });
+    const listClientsTool = defineTool({
+        name: "list_clients",
+        description: "List all registered clients (admin only)",
+        visibility: "private",
+        inputSchema: { type: "object", properties: {} },
+        execute: async () => {
+            const clients = await store.listClients();
+            return {
+                clients: clients.map((c) => ({
+                    clientId: c.clientId,
+                    name: c.name,
+                    scopes: c.scopes,
+                    createdAt: c.createdAt,
+                    selfRegistered: c.selfRegistered ?? false,
+                })),
+            };
+        },
+    });
+    const revokeClientTool = defineTool({
+        name: "revoke_client",
+        description: "Revoke a client and all its tokens (admin only)",
+        visibility: "private",
+        inputSchema: {
+            type: "object",
+            properties: {
+                clientId: { type: "string", description: "Client ID to revoke" },
+            },
+            required: ["clientId"],
+        },
+        execute: async (input) => {
+            const revoked = await store.revokeClient(input.clientId);
+            return { revoked };
+        },
+    });
+    const rotateSecretTool = defineTool({
+        name: "rotate_secret",
+        description: "Rotate a client's secret (admin only)",
+        visibility: "private",
+        inputSchema: {
+            type: "object",
+            properties: {
+                clientId: { type: "string", description: "Client ID to rotate" },
+            },
+            required: ["clientId"],
+        },
+        execute: async (input) => {
+            const result = await store.rotateSecret(input.clientId);
+            if (!result)
+                throw new Error(`Client not found: ${input.clientId}`);
+            return { clientId: input.clientId, clientSecret: result.clientSecret };
+        },
+    });
+    // --- Assemble tools ---
+    const tools = [
+        tokenTool,
+        whoamiTool,
+        ...(allowRegistration ? [registerTool] : []),
+        createClientTool,
+        listClientsTool,
+        revokeClientTool,
+        rotateSecretTool,
+    ];
+    const agent = defineAgent({
+        path: "@auth",
+        entrypoint: "Authentication agent. Provides OAuth2 client_credentials authentication for the agent network.",
+        config: {
+            name: "Auth",
+            description: "Built-in authentication agent",
+            supportedActions: ["execute_tool", "describe_tools", "load"],
+        },
+        tools: tools,
+        visibility: "public",
+    });
+    // Attach store and config for server integration
+    return Object.assign(agent, {
+        __authStore: store,
+        __rootKey: rootKey,
+        __tokenTtl: tokenTtl,
+    });
+}
+//# sourceMappingURL=auth.js.map

package/dist/auth.js.map

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

package/dist/build.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Build Agents
+ *
+ * Scans a directory for agent definitions and generates a registry file.
+ *
+ * Convention:
+ * - Agent directories start with `@` (e.g., `@my-agent`)
+ * - Each agent has:
+ *   - `entrypoint.md` - System prompt
+ *   - `agent.config.ts` - Configuration (exports default AgentConfig)
+ *   - `*.tool.ts` - Tool definitions (exports `{toolName}Tool`)
+ *
+ * @example
+ * ```typescript
+ * // scripts/build-agents.ts
+ * import { buildAgents } from '@slashfi/agents-sdk';
+ *
+ * await buildAgents({
+ *   agentsDir: './src/agents',
+ *   outFile: './src/agents/_generated-registry.ts',
+ * });
+ * ```
+ */
+/**
+ * Options for building agents.
+ */
+export interface BuildAgentsOptions {
+    /** Directory containing agent folders (e.g., './src/agents') */
+    agentsDir: string;
+    /** Output file path for the generated registry */
+    outFile: string;
+    /**
+     * Import path for the SDK.
+     * @default '@slashfi/agents-sdk'
+     */
+    sdkImport?: string;
+    /**
+     * Default visibility for agents.
+     * @default 'internal'
+     */
+    defaultVisibility?: "public" | "internal" | "private";
+    /**
+     * Whether to use double quotes for strings.
+     * @default false (single quotes)
+     */
+    doubleQuotes?: boolean;
+}
+/**
+ * Result of building agents.
+ */
+export interface BuildAgentsResult {
+    /** Number of agents processed */
+    agentCount: number;
+    /** Paths of agents that were processed */
+    agents: string[];
+    /** Agents that were skipped (missing required files) */
+    skipped: string[];
+    /** Path to the generated output file */
+    outFile: string;
+}
+/**
+ * Build agents from a directory.
+ *
+ * Scans the given directory for agent folders (starting with `@`) and generates
+ * a TypeScript file that creates and populates an agent registry.
+ */
+export declare function buildAgents(options: BuildAgentsOptions): Promise<BuildAgentsResult>;
+//# sourceMappingURL=build.d.ts.map

package/dist/build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../src/build.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAKH;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,gEAAgE;IAChE,SAAS,EAAE,MAAM,CAAC;IAElB,kDAAkD;IAClD,OAAO,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAC;IAEtD;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,iCAAiC;IACjC,UAAU,EAAE,MAAM,CAAC;IAEnB,0CAA0C;IAC1C,MAAM,EAAE,MAAM,EAAE,CAAC;IAEjB,wDAAwD;IACxD,OAAO,EAAE,MAAM,EAAE,CAAC;IAElB,wCAAwC;IACxC,OAAO,EAAE,MAAM,CAAC;CACjB;AA0BD;;;;;GAKG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,iBAAiB,CAAC,CAoI5B"}

package/dist/build.js

@@ -0,0 +1,159 @@
+/**
+ * Build Agents
+ *
+ * Scans a directory for agent definitions and generates a registry file.
+ *
+ * Convention:
+ * - Agent directories start with `@` (e.g., `@my-agent`)
+ * - Each agent has:
+ *   - `entrypoint.md` - System prompt
+ *   - `agent.config.ts` - Configuration (exports default AgentConfig)
+ *   - `*.tool.ts` - Tool definitions (exports `{toolName}Tool`)
+ *
+ * @example
+ * ```typescript
+ * // scripts/build-agents.ts
+ * import { buildAgents } from '@slashfi/agents-sdk';
+ *
+ * await buildAgents({
+ *   agentsDir: './src/agents',
+ *   outFile: './src/agents/_generated-registry.ts',
+ * });
+ * ```
+ */
+import { readFileSync, readdirSync, statSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+/**
+ * Convert kebab-case to camelCase.
+ */
+function toCamelCase(str) {
+    return str
+        .split("-")
+        .map((part, i) => i === 0 ? part : part.charAt(0).toUpperCase() + part.slice(1))
+        .join("");
+}
+/**
+ * Escape a string for use in a JavaScript string literal.
+ */
+function escapeString(str, quote) {
+    return str
+        .replace(/\\/g, "\\\\")
+        .replace(new RegExp(quote, "g"), `\\${quote}`)
+        .replace(/\n/g, "\\n")
+        .replace(/\r/g, "\\r")
+        .replace(/\t/g, "\\t");
+}
+/**
+ * Build agents from a directory.
+ *
+ * Scans the given directory for agent folders (starting with `@`) and generates
+ * a TypeScript file that creates and populates an agent registry.
+ */
+export async function buildAgents(options) {
+    const { agentsDir, outFile, sdkImport = "@slashfi/agents-sdk", defaultVisibility = "internal", doubleQuotes = false, } = options;
+    const q = doubleQuotes ? '"' : "'";
+    const agents = [];
+    const skipped = [];
+    // Find all agent directories (start with @)
+    const agentDirs = readdirSync(agentsDir).filter((name) => {
+        if (!name.startsWith("@"))
+            return false;
+        try {
+            const stat = statSync(join(agentsDir, name));
+            return stat.isDirectory();
+        }
+        catch {
+            return false;
+        }
+    });
+    const imports = [];
+    const registrations = [];
+    const exportItems = [];
+    for (const agentDir of agentDirs) {
+        const agentPath = join(agentsDir, agentDir);
+        const entrypointPath = join(agentPath, "entrypoint.md");
+        const configPath = join(agentPath, "agent.config.ts");
+        // Check if required files exist
+        try {
+            statSync(entrypointPath);
+            statSync(configPath);
+        }
+        catch {
+            skipped.push(agentDir);
+            continue;
+        }
+        // Read entrypoint content
+        const entrypoint = readFileSync(entrypointPath, "utf-8");
+        // Find tool files
+        const toolFiles = readdirSync(agentPath).filter((f) => f.endsWith(".tool.ts"));
+        // Generate variable name from directory (e.g., @product-applications -> productApplications)
+        const varName = toCamelCase(agentDir.slice(1));
+        // Add config import
+        imports.push(`import ${varName}Config from ${q}./${agentDir}/agent.config.js${q};`);
+        // Add tool imports and collect tool info
+        const toolEntries = [];
+        for (const toolFile of toolFiles) {
+            const baseName = toolFile.replace(".tool.ts", "");
+            // Convert kebab-case to camelCase for JS variable: get-status -> getStatusTool
+            const toolVarName = `${toCamelCase(baseName)}Tool`;
+            // Tool name is just the filename (kebab-case): get-status
+            const toolName = baseName;
+            imports.push(`import { ${toolVarName} } from ${q}./${agentDir}/${toolFile.replace(".ts", ".js")}${q};`);
+            toolEntries.push({ varName: toolVarName, name: toolName });
+        }
+        // Read config to get the path override if specified
+        const configContent = readFileSync(configPath, "utf-8");
+        const pathMatch = configContent.match(/path:\s*['"]([^'"]+)['"]/);
+        const registeredPath = pathMatch ? pathMatch[1] : agentDir;
+        // Generate tools array with name override
+        const toolsArray = toolEntries
+            .map((t) => `{ ...${t.varName}, name: ${q}${t.name}${q} }`)
+            .join(", ");
+        // Generate agent definition
+        const entrypointEscaped = escapeString(entrypoint, q);
+        registrations.push(`
+const ${varName}Agent = defineAgent({
+  path: ${q}${registeredPath}${q},
+  entrypoint: ${q}${entrypointEscaped}${q},
+  config: ${varName}Config,
+  tools: [${toolsArray}],
+  visibility: ${q}${defaultVisibility}${q},
+});
+agentRegistry.register(${varName}Agent);`);
+        exportItems.push(`  ${varName}: ${varName}Agent,`);
+        agents.push(registeredPath);
+    }
+    const output = `/**
+ * AUTO-GENERATED FILE - DO NOT EDIT
+ * Generated by buildAgents from ${sdkImport}
+ *
+ * This file bundles agent entrypoints at build time.
+ * Tool names are derived from filenames (kebab-case).
+ */
+
+import { createAgentRegistry, defineAgent } from ${q}${sdkImport}${q};
+
+${imports.join("\n")}
+
+// Create registry
+export const agentRegistry = createAgentRegistry({
+  defaultVisibility: ${q}${defaultVisibility}${q},
+});
+
+// Register agents
+${registrations.join("\n")}
+
+// Export agents
+export const agents = {
+${exportItems.join("\n")}
+};
+`;
+    writeFileSync(outFile, output);
+    return {
+        agentCount: agents.length,
+        agents,
+        skipped,
+        outFile,
+    };
+}
+//# sourceMappingURL=build.js.map

package/dist/build.js.map

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

package/dist/define.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Define Agent and Tool Functions
+ *
+ * Factory functions for creating agent and tool definitions.
+ */
+import type { AgentConfig, AgentDefinition, AgentRuntime, JsonSchema, ToolContext, ToolDefinition, Visibility } from "./types.js";
+export interface DefineToolOptions<TContext extends ToolContext = ToolContext, TInput = unknown, TOutput = unknown> {
+    /** Tool name (unique within agent) */
+    name: string;
+    /** Short description for tool discovery */
+    description: string;
+    /** JSON Schema for input parameters */
+    inputSchema: JsonSchema;
+    /** JSON Schema for output (optional) */
+    outputSchema?: JsonSchema;
+    /** Visibility level */
+    visibility?: Visibility;
+    /** Explicit allowed callers */
+    allowedCallers?: string[];
+    /** Execute function */
+    execute: (input: TInput, ctx: TContext) => Promise<TOutput>;
+}
+/**
+ * Create a tool definition.
+ *
+ * @example
+ * ```typescript
+ * const greet = defineTool({
+ *   name: 'greet',
+ *   description: 'Greet a user',
+ *   inputSchema: {
+ *     type: 'object',
+ *     properties: {
+ *       name: { type: 'string', description: 'Name to greet' }
+ *     },
+ *     required: ['name']
+ *   },
+ *   execute: async (input) => ({ message: `Hello, ${input.name}!` })
+ * });
+ * ```
+ */
+export declare function defineTool<TContext extends ToolContext = ToolContext, TInput = unknown, TOutput = unknown>(options: DefineToolOptions<TContext, TInput, TOutput>): ToolDefinition<TContext, TInput, TOutput>;
+export interface DefineAgentOptions<TContext extends ToolContext = ToolContext> {
+    /** Agent path (e.g., '@example', '/agents/my-agent') */
+    path: string;
+    /** System prompt / entrypoint content */
+    entrypoint: string;
+    /** Agent configuration */
+    config?: AgentConfig;
+    /** Tools provided by this agent */
+    tools?: ToolDefinition<TContext, unknown, unknown>[];
+    /**
+     * Runtime hooks factory.
+     * Called once to create the runtime for this agent.
+     */
+    runtime?: () => AgentRuntime;
+    /** Visibility level */
+    visibility?: Visibility;
+    /** Explicit allowed callers */
+    allowedCallers?: string[];
+}
+/**
+ * Create an agent definition.
+ *
+ * @example
+ * ```typescript
+ * const agent = defineAgent({
+ *   path: '@my-agent',
+ *   entrypoint: 'You are a helpful assistant.',
+ *   config: {
+ *     name: 'My Agent',
+ *     description: 'A helpful agent'
+ *   },
+ *   tools: [greet, echo],
+ *   runtime: () => ({
+ *     onInvoke: async (ctx) => {
+ *       console.log(`Invoked with: ${ctx.prompt}`);
+ *     },
+ *     onTick: async (ctx) => {
+ *       console.log(`Tick at ${ctx.timestamp}`);
+ *     }
+ *   })
+ * });
+ * ```
+ */
+export declare function defineAgent<TContext extends ToolContext = ToolContext>(options: DefineAgentOptions<TContext>): AgentDefinition<TContext>;
+//# sourceMappingURL=define.d.ts.map

package/dist/define.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define.d.ts","sourceRoot":"","sources":["../src/define.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,eAAe,EACf,YAAY,EACZ,UAAU,EACV,WAAW,EACX,cAAc,EACd,UAAU,EACX,MAAM,YAAY,CAAC;AAMpB,MAAM,WAAW,iBAAiB,CAChC,QAAQ,SAAS,WAAW,GAAG,WAAW,EAC1C,MAAM,GAAG,OAAO,EAChB,OAAO,GAAG,OAAO;IAEjB,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IAEb,2CAA2C;IAC3C,WAAW,EAAE,MAAM,CAAC;IAEpB,uCAAuC;IACvC,WAAW,EAAE,UAAU,CAAC;IAExB,wCAAwC;IACxC,YAAY,CAAC,EAAE,UAAU,CAAC;IAE1B,uBAAuB;IACvB,UAAU,CAAC,EAAE,UAAU,CAAC;IAExB,+BAA+B;IAC/B,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAE1B,uBAAuB;IACvB,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC7D;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,UAAU,CACxB,QAAQ,SAAS,WAAW,GAAG,WAAW,EAC1C,MAAM,GAAG,OAAO,EAChB,OAAO,GAAG,OAAO,EAEjB,OAAO,EAAE,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,GACpD,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,CAU3C;AAMD,MAAM,WAAW,kBAAkB,CACjC,QAAQ,SAAS,WAAW,GAAG,WAAW;IAE1C,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAC;IAEb,yCAAyC;IACzC,UAAU,EAAE,MAAM,CAAC;IAEnB,0BAA0B;IAC1B,MAAM,CAAC,EAAE,WAAW,CAAC;IAErB,mCAAmC;IACnC,KAAK,CAAC,EAAE,cAAc,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC;IAErD;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,YAAY,CAAC;IAE7B,uBAAuB;IACvB,UAAU,CAAC,EAAE,UAAU,CAAC;IAExB,+BAA+B;IAC/B,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,WAAW,CAAC,QAAQ,SAAS,WAAW,GAAG,WAAW,EACpE,OAAO,EAAE,kBAAkB,CAAC,QAAQ,CAAC,GACpC,eAAe,CAAC,QAAQ,CAAC,CAU3B"}