kernl 0.1.1

package/dist/mcp/types.d.ts

@@ -0,0 +1,172 @@
+import { z } from "zod";
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+import { Agent } from "../agent";
+import { Context, UnknownContext } from "../context";
+import { Logger } from "../lib/logger";
+/**
+ * MCP tool type from the SDK.
+ * We use the SDK's type directly to avoid compatibility issues.
+ */
+export type MCPTool = Tool;
+/**
+ * Custom MCP tool schema definition with stricter contracts.
+ * NOTE: Currently not used, but kept for potential future runtime validation.
+ * If needed, we could parse SDK tools through this schema to enforce stricter requirements.
+ */
+export declare const MCPToolSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    inputSchema: z.ZodObject<{
+        type: z.ZodLiteral<"object">;
+        properties: z.ZodRecord<z.ZodString, z.ZodAny>;
+        required: z.ZodArray<z.ZodString>;
+        additionalProperties: z.ZodBoolean;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+/**
+ * Context provided to server-level tool filters during tool resolution.
+ */
+export interface MCPToolFilterContext<TContext = UnknownContext> {
+    context: Context<TContext>;
+    agent: Agent<TContext, any>;
+    serverId: string;
+}
+/**
+ * Server-level filter for MCP tools.
+ *
+ * Operates at the protocol layer on raw MCPTool objects before conversion.
+ * Use this for static, security-focused filtering (e.g., "never expose tool X").
+ *
+ * This is the first filter in the pipeline. For dynamic, context-aware filtering,
+ * use ToolkitFilter on MCPToolkit instead.
+ *
+ * @example
+ * ```typescript
+ * const server = new MCPServerStdio({
+ *   command: "npx",
+ *   args: ["-y", "some-server"],
+ *   toolFilter: async (ctx, tool) => {
+ *     // Never expose dangerous tools
+ *     return !tool.name.startsWith("dangerous_");
+ *   }
+ * });
+ * ```
+ */
+export type MCPToolFilter<TContext = UnknownContext> = (context: MCPToolFilterContext<TContext>, tool: MCPTool) => Promise<boolean>;
+/**
+ * Static tool filter using allowlist and blocklist of tool names.
+ */
+export interface MCPToolFilterStatic {
+    allowedToolNames?: string[];
+    blockedToolNames?: string[];
+}
+/**
+ * JSON-RPC 2.0 request message.
+ */
+export interface JsonRpcRequest {
+    jsonrpc: "2.0";
+    id: number;
+    method: string;
+    params?: Record<string, unknown>;
+}
+/**
+ * JSON-RPC 2.0 notification message (no response expected).
+ */
+export interface JsonRpcNotification {
+    jsonrpc: "2.0";
+    method: string;
+    params?: Record<string, unknown>;
+}
+/**
+ * JSON-RPC 2.0 response message.
+ */
+export interface JsonRpcResponse {
+    jsonrpc: "2.0";
+    id: number;
+    result?: any;
+    error?: any;
+}
+/**
+ * Response from calling an MCP tool.
+ */
+export interface CallToolResponse extends JsonRpcResponse {
+    result: {
+        content: {
+            type: string;
+            text: string;
+        }[];
+    };
+}
+export type CallToolResult = CallToolResponse["result"];
+export type CallToolResultContent = CallToolResult["content"];
+/**
+ * Response from MCP server initialization.
+ */
+export interface InitializeResponse extends JsonRpcResponse {
+    result: {
+        protocolVersion: string;
+        capabilities: {
+            tools: Record<string, unknown>;
+        };
+        serverInfo: {
+            name: string;
+            version: string;
+        };
+    };
+}
+export type InitializeResult = InitializeResponse["result"];
+/**
+ * Base configuration options for stdio-based MCP servers.
+ */
+export interface BaseMCPServerStdioOptions {
+    env?: Record<string, string>;
+    cwd?: string;
+    cacheToolsList?: boolean;
+    clientSessionTimeoutSeconds?: number;
+    id?: string;
+    encoding?: string;
+    encodingErrorHandler?: "strict" | "ignore" | "replace";
+    logger?: Logger;
+    toolFilter?: MCPToolFilter;
+    timeout?: number;
+}
+/**
+ * Stdio MCP server options with command and args.
+ */
+export interface MCPServerStdioOptions extends BaseMCPServerStdioOptions {
+    command: string;
+    args?: string[];
+}
+/**
+ * Configuration options for streamable HTTP MCP servers.
+ */
+export interface MCPServerStreamableHttpOptions {
+    url: string;
+    cacheToolsList?: boolean;
+    clientSessionTimeoutSeconds?: number;
+    id?: string;
+    logger?: Logger;
+    toolFilter?: MCPToolFilter;
+    timeout?: number;
+    authProvider?: any;
+    requestInit?: any;
+    fetch?: any;
+    reconnectionOptions?: any;
+    sessionId?: string;
+}
+/**
+ * Configuration options for Server-Sent Events (SSE) MCP servers.
+ */
+export interface MCPServerSSEOptions {
+    url: string;
+    cacheToolsList?: boolean;
+    clientSessionTimeoutSeconds?: number;
+    id?: string;
+    logger?: Logger;
+    toolFilter?: MCPToolFilter;
+    timeout?: number;
+    authProvider?: any;
+    requestInit?: any;
+    eventSourceInit?: any;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/mcp/types.d.ts.map

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

package/dist/mcp/types.js

@@ -0,0 +1,16 @@
+import { z } from "zod";
+/**
+ * Custom MCP tool schema definition with stricter contracts.
+ * NOTE: Currently not used, but kept for potential future runtime validation.
+ * If needed, we could parse SDK tools through this schema to enforce stricter requirements.
+ */
+export const MCPToolSchema = z.object({
+    name: z.string(),
+    description: z.string().optional(),
+    inputSchema: z.object({
+        type: z.literal("object"),
+        properties: z.record(z.string(), z.any()),
+        required: z.array(z.string()),
+        additionalProperties: z.boolean(),
+    }),
+});

package/dist/mcp/utils.d.ts

@@ -0,0 +1,23 @@
+import { z } from "zod";
+import { UnknownContext } from "../context";
+import { MCPServer } from "./base";
+import type { MCPTool, MCPToolFilter } from "./types";
+/**
+ * Converts an MCP tool definition into a function tool usable by the SDK.
+ */
+export declare function mcpToFunctionTool(server: MCPServer, mcpTool: MCPTool): import("../tool").FunctionTool<unknown, z.ZodRecord<z.ZodString, z.ZodAny> | undefined, {
+    type: string;
+    text: string;
+} | {
+    type: string;
+    text: string;
+}[]>;
+/**
+ * Creates a static tool filter from allowed and blocked tool name lists.
+ * Returns a filter function that can be used with MCP servers.
+ */
+export declare function createMCPToolStaticFilter<TContext = UnknownContext>(options?: {
+    allowed?: string[];
+    blocked?: string[];
+}): MCPToolFilter<TContext> | undefined;
+//# sourceMappingURL=utils.d.ts.map

package/dist/mcp/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/mcp/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAG3C,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACnC,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAEtD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO;;;;;;KAmBpE;AAMD;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,GAAG,cAAc,EAAE,OAAO,CAAC,EAAE;IAC7E,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB,GAAG,aAAa,CAAC,QAAQ,CAAC,GAAG,SAAS,CAkBtC"}

package/dist/mcp/utils.js

@@ -0,0 +1,44 @@
+import { z } from "zod";
+import { tool } from "../tool";
+/**
+ * Converts an MCP tool definition into a function tool usable by the SDK.
+ */
+export function mcpToFunctionTool(server, mcpTool) {
+    async function invoke(_ctx, input) {
+        const content = await server.callTool(mcpTool.name, input);
+        return content.length === 1 ? content[0] : content;
+    }
+    // MCP tools accept an object with any properties based on their inputSchema
+    // We use z.record(z.any()) to represent this flexible schema
+    const parameters = mcpTool.inputSchema
+        ? z.record(z.string(), z.any())
+        : undefined;
+    return tool({
+        id: mcpTool.name,
+        name: mcpTool.name,
+        description: mcpTool.description ?? "",
+        parameters,
+        execute: invoke,
+    });
+}
+// ----------------------------
+// Tool filters
+// ----------------------------
+/**
+ * Creates a static tool filter from allowed and blocked tool name lists.
+ * Returns a filter function that can be used with MCP servers.
+ */
+export function createMCPToolStaticFilter(options) {
+    if (!options?.allowed && !options?.blocked) {
+        return undefined;
+    }
+    const allowedToolNames = options.allowed ?? [];
+    const blockedToolNames = options.blocked ?? [];
+    return async (_ctx, tool) => {
+        const allowed = allowedToolNames.length > 0 ? allowedToolNames.includes(tool.name) : true;
+        const blocked = blockedToolNames.length > 0
+            ? blockedToolNames.includes(tool.name)
+            : false;
+        return allowed && !blocked;
+    };
+}

package/dist/model.d.ts

@@ -0,0 +1,175 @@
+import { Usage } from "./usage";
+import { SerializedTool } from "./lib/serde/tool";
+import { ThreadEvent, ThreadStreamEvent } from "./types/thread";
+export type ModelTracing = boolean | "enabled_without_data";
+/**
+ * The base interface for calling an LLM.
+ */
+export interface LanguageModel {
+    /**
+     * Get a response from the model.
+     *
+     * @param request - The request to get a response for.
+     */
+    generate(request: LanguageModelRequest): Promise<LanguageModelResponse>;
+    /**
+     * Get a streamed response from the model.
+     *
+     * @param request - The request to get a response for.
+     */
+    stream(request: LanguageModelRequest): AsyncIterable<ThreadStreamEvent>;
+}
+/**
+ * A request to a large language model.
+ */
+export type LanguageModelRequest = {
+    /**
+     * The system instructions to use for the model.
+     */
+    system?: string;
+    /**
+     * The input to the model.
+     */
+    input: ThreadEvent[] | string;
+    /**
+     * The ID of stored conversation to use for the model.
+     */
+    conversationId?: string;
+    /**
+     * The model settings to use for the model.
+     */
+    modelSettings: LanguageModelSettings;
+    /**
+     * The tools to use for the model.
+     */
+    tools: SerializedTool[];
+    /**
+     * Whether to enable tracing for the model.
+     */
+    tracing: ModelTracing;
+    /**
+     * An optional signal to abort the model request.
+     */
+    abort?: AbortSignal;
+};
+/**
+ * The base response type
+ */
+export type LanguageModelResponse = {
+    /**
+     * The usage information for response.
+     */
+    usage: Usage;
+    /**
+     * A list of events (messages, tool calls, etc.) generated by the model.
+     */
+    events: ThreadEvent[];
+    /**
+     * An ID for the response which can be used to refer to the response in subsequent calls to the
+     * model. Not supported by all model providers.
+     */
+    responseId?: string;
+    /**
+     * Raw response data from the underlying model provider.
+     */
+    providerData?: Record<string, any>;
+};
+/**
+ * Settings to use when calling an LLM.
+ *
+ * This class holds optional model configuration parameters (e.g. temperature,
+ * topP, penalties, truncation, etc.).
+ *
+ * Not all models/providers support all of these parameters, so please check the API documentation
+ * for the specific model and provider you are using.
+ */
+export type LanguageModelSettings = {
+    /**
+     * The temperature to use when calling the model.
+     */
+    temperature?: number;
+    /**
+     * The topP to use when calling the model.
+     */
+    topP?: number;
+    /**
+     * The frequency penalty to use when calling the model.
+     */
+    frequencyPenalty?: number;
+    /**
+     * The presence penalty to use when calling the model.
+     */
+    presencePenalty?: number;
+    /**
+     * The tool choice to use when calling the model.
+     */
+    toolChoice?: ModelSettingsToolChoice;
+    /**
+     * Whether to use parallel tool calls when calling the model.
+     * Defaults to false if not provided.
+     */
+    parallelToolCalls?: boolean;
+    /**
+     * The truncation strategy to use when calling the model.
+     */
+    truncation?: "auto" | "disabled";
+    /**
+     * The maximum number of output tokens to generate.
+     */
+    maxTokens?: number;
+    /**
+     * Whether to store the generated model response for later retrieval.
+     * Defaults to true if not provided.
+     */
+    store?: boolean;
+    /**
+     * The reasoning settings to use when calling the model.
+     */
+    reasoning?: ModelSettingsReasoning;
+    /**
+     * The text settings to use when calling the model.
+     */
+    text?: ModelSettingsText;
+    /**
+     * Additional provider specific settings to be passed directly to the model
+     * request.
+     */
+    providerData?: Record<string, any>;
+};
+export type ModelSettingsToolChoice = "auto" | "required" | "none";
+/**
+ * Constrains effort on reasoning for [reasoning models](https://platform.openai.com/docs/guides/reasoning).
+ *
+ * Supported for providers:
+ *
+ *  - OpenAI
+ *  - ... ?
+ */
+export type ModelSettingsReasoningEffort = "minimal" | "low" | "medium" | "high" | null;
+/**
+ * Configuration options for [reasoning models](https://platform.openai.com/docs/guides/reasoning).
+ */
+export type ModelSettingsReasoning = {
+    /**
+     * Constrains effort on reasoning for [reasoning models](https://platform.openai.com/docs/guides/reasoning).
+     */
+    effort?: ModelSettingsReasoningEffort | null;
+    /**
+     * A summary of the reasoning performed by the model.
+     * This can be useful for debugging and understanding the model's reasoning process.
+     * One of `auto`, `concise`, or `detailed`.
+     */
+    summary?: "auto" | "concise" | "detailed" | null;
+};
+export interface ModelSettingsText {
+    /**
+     * Constrains the verbosity of the model's response.
+     *
+     * Supported for providers:
+     *
+     *  - OpenAI
+     *  - ... ?
+     */
+    verbosity?: "low" | "medium" | "high" | null;
+}
+//# sourceMappingURL=model.d.ts.map

package/dist/model.d.ts.map

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

package/dist/model.js

@@ -0,0 +1 @@
+export {};

package/dist/providers/ai.d.ts

@@ -0,0 +1 @@
+//# sourceMappingURL=ai.d.ts.map

package/dist/providers/ai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai.d.ts","sourceRoot":"","sources":["../../src/providers/ai.ts"],"names":[],"mappings":""}

package/dist/providers/ai.js

@@ -0,0 +1 @@
+"use strict";

package/dist/providers/default.d.ts

@@ -0,0 +1,16 @@
+import type { LanguageModel, LanguageModelRequest, LanguageModelResponse } from "../model";
+import type { ThreadStreamEvent } from "../types/thread";
+/**
+ * Default language model that throws an error when used.
+ * This is used as a fallback when no model is provided to an Agent.
+ */
+declare class DefaultLanguageModel implements LanguageModel {
+    generate(request: LanguageModelRequest): Promise<LanguageModelResponse>;
+    stream(request: LanguageModelRequest): AsyncIterable<ThreadStreamEvent>;
+}
+/**
+ * Singleton instance of the default language model
+ */
+export declare const DEFAULT_LANGUAGE_MODEL: DefaultLanguageModel;
+export {};
+//# sourceMappingURL=default.d.ts.map

package/dist/providers/default.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default.d.ts","sourceRoot":"","sources":["../../src/providers/default.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,oBAAoB,EACpB,qBAAqB,EACtB,MAAM,SAAS,CAAC;AACjB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAIxD;;;GAGG;AACH,cAAM,oBAAqB,YAAW,aAAa;IAC3C,QAAQ,CACZ,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,qBAAqB,CAAC;IAM1B,MAAM,CACX,OAAO,EAAE,oBAAoB,GAC5B,aAAa,CAAC,iBAAiB,CAAC;CAKpC;AAED;;GAEG;AACH,eAAO,MAAM,sBAAsB,sBAA6B,CAAC"}

package/dist/providers/default.js

@@ -0,0 +1,17 @@
+// (TEMPORARY)
+/**
+ * Default language model that throws an error when used.
+ * This is used as a fallback when no model is provided to an Agent.
+ */
+class DefaultLanguageModel {
+    async generate(request) {
+        throw new Error("No language model configured. Please provide a model to the Agent.");
+    }
+    async *stream(request) {
+        throw new Error("No language model configured. Please provide a model to the Agent.");
+    }
+}
+/**
+ * Singleton instance of the default language model
+ */
+export const DEFAULT_LANGUAGE_MODEL = new DefaultLanguageModel();

package/dist/providers/registry.d.ts

@@ -0,0 +1 @@
+//# sourceMappingURL=registry.d.ts.map

package/dist/providers/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/providers/registry.ts"],"names":[],"mappings":""}

package/dist/providers/registry.js

@@ -0,0 +1 @@
+"use strict";

package/dist/sched/scheduler.d.ts

@@ -0,0 +1,20 @@
+import type { Task } from "./task";
+/**
+ * Per-agent run queue.
+ * Each agent has one run queue tracking its tasks.
+ *
+ * Simplified for hello world - defers clock, load, stats, and CFS priority logic.
+ */
+export interface RunQueue {
+    agentId: string;
+    curr: Task[];
+    nrunning: number;
+    tasks: Task[];
+}
+/**
+ * Configuration for the Scheduler.
+ */
+export interface SchedulerConfig {
+    defaultMaxConcurrent?: number;
+}
+//# sourceMappingURL=scheduler.d.ts.map

package/dist/sched/scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.d.ts","sourceRoot":"","sources":["../../src/sched/scheduler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAEnC;;;;;GAKG;AACH,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,CAAmC;IAClD,IAAI,EAAE,IAAI,EAAE,CAAiC;IAC7C,QAAQ,EAAE,MAAM,CAAgC;IAChD,KAAK,EAAE,IAAI,EAAE,CAA0C;CAOxD;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,oBAAoB,CAAC,EAAE,MAAM,CAAkD;CAChF"}

package/dist/sched/scheduler.js

@@ -0,0 +1 @@
+export {};

package/dist/sched/task.d.ts

@@ -0,0 +1,92 @@
+import type { Agent } from "../agent";
+import type { Context, UnknownContext } from "../context";
+import type { Thread } from "../thread";
+/**
+ * A Task represents a unit of work scheduled by the kernl.
+ * Analogous to task_struct in the Linux kernel.
+ */
+export declare class Task<TContext = UnknownContext, TResult = unknown> {
+    pid: string;
+    instructions: string | ((context: Context<TContext>) => string);
+    state: TaskState;
+    owner: Agent<TContext>;
+    context: Context<TContext>;
+    /**
+     * Might want the ability to pick up a new thread of execution from a compressed task checkpoint instead of including
+     * all of the events from the old threads (which may no longer be useful if they completed with good artifacts + reasoning / action summaries).
+     * At that point its really more about tracing.
+     */
+    threads: Thread<TContext>[];
+    current: Thread<TContext> | null;
+    result: TResult | null;
+    constructor(init: {
+        pid: string;
+        instructions: string | ((context: Context<TContext>) => string);
+        state: TaskState;
+        owner: Agent<TContext>;
+        context: Context<TContext>;
+    });
+}
+/**
+ * The various states that a task may be in.
+ */
+export declare enum TaskState {
+    /**
+     * Task is either:
+     * - Currently executing
+     * - In run queue waiting to be scheduled (might want to differentiate between running + queued here)
+     */
+    RUNNING = "running",
+    /**
+     * Task is sleeping/blocked, waiting for a condition.
+     * Can be woken up by:
+     * - The condition being met (e.g., approval granted)
+     * - A signal (e.g., user cancellation)
+     *
+     * Examples:
+     * - Waiting for tool approval
+     * - Waiting for user input
+     * - Sleeping on a timer
+     */
+    INTERRUPTIBLE = "interruptible",
+    /**
+     * Task is sleeping/blocked and CANNOT be interrupted by signals.
+     * Only wakes when the condition is met.
+     *
+     * Examples:
+     * - Waiting for critical I/O (model API call)
+     * - Waiting for resource that MUST complete
+     *
+     * Use sparingly - these tasks can't be cancelled!
+     */
+    UNINTERRUPTIBLE = "uninterruptible",
+    /**
+     * Task has been stopped by a signal (SIGSTOP).
+     * Will remain stopped until explicitly continued (SIGCONT).
+     *
+     * Examples:
+     * - User explicitly paused the agent
+     * - Debugger attached
+     */
+    STOPPED = "stopped",
+    /**
+     * Task is being traced by a debugger.
+     * Similar to STOPPED but for debugging.
+     */
+    TRACED = "traced",
+    /**
+     * Task has finished execution but hasn't been cleaned up yet.
+     * Waiting for parent to read exit status (wait/waitpid).
+     *
+     * Examples:
+     * - Agent completed but result not yet retrieved
+     * - Child agent finished, parent needs to collect result
+     */
+    ZOMBIE = "zombie",
+    /**
+     * Task is being removed from the system.
+     * Final cleanup in progress, about to be fully deleted.
+     */
+    DEAD = "dead"
+}
+//# sourceMappingURL=task.d.ts.map

package/dist/sched/task.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task.d.ts","sourceRoot":"","sources":["../../src/sched/task.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAEzD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAEvC;;;GAGG;AACH,qBAAa,IAAI,CAAC,QAAQ,GAAG,cAAc,EAAE,OAAO,GAAG,OAAO;IAC5D,GAAG,EAAE,MAAM,CAAoD;IAG/D,YAAY,EACR,MAAM,GACN,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,KAAK,MAAM,CAAC,CAA4B;IAExE,KAAK,EAAE,SAAS,CAAiC;IACjD,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC,CAA2C;IAEjE,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,CAA0D;IAIpF;;;;OAIG;IACH,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC,EAAE,CAA6C;IACxE,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAyC;IACzE,MAAM,EAAE,OAAO,GAAG,IAAI,CAAgC;gBAQ1C,IAAI,EAAE;QAChB,GAAG,EAAE,MAAM,CAAC;QACZ,YAAY,EAAE,MAAM,GAAG,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,KAAK,MAAM,CAAC,CAAC;QAChE,KAAK,EAAE,SAAS,CAAC;QACjB,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;QACvB,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;KAC5B;CAUF;AAED;;GAEG;AACH,oBAAY,SAAS;IACnB;;;;OAIG;IACH,OAAO,YAAY;IAEnB;;;;;;;;;;OAUG;IACH,aAAa,kBAAkB;IAE/B;;;;;;;;;OASG;IACH,eAAe,oBAAoB;IAEnC;;;;;;;OAOG;IACH,OAAO,YAAY;IAEnB;;;OAGG;IACH,MAAM,WAAW;IAEjB;;;;;;;OAOG;IACH,MAAM,WAAW;IAEjB;;;OAGG;IACH,IAAI,SAAS;CACd"}