@jcheesepkg/nanobot 0.1.0

package/README.md

@@ -0,0 +1,139 @@
+# nanobot
+
+Lightweight AI assistant -- TypeScript port of [HKUDS/nanobot](https://github.com/HKUDS/nanobot).
+
+Zero native dependencies. Runs in Node.js or WebContainer.
+
+## Quickstart
+
+```bash
+npm install
+npm run build
+node dist/cli/index.mjs onboard
+```
+
+Add your API key to `~/.nanobot/config.json`, then:
+
+```bash
+node dist/cli/index.mjs agent -m "Hello!"
+```
+
+## Architecture
+
+```
+src/
+  agent/          Core agent loop, context builder, memory, skills, subagents
+    tools/        Tool implementations (filesystem, shell, web, message, spawn, cron)
+  bus/            Async message bus (inbound/outbound queues)
+  channels/       Chat platform integrations (Telegram via grammY)
+  cli/            Commander-based CLI
+  config/         Zod schemas + JSON config loader
+  cron/           Timer-based job scheduler
+  heartbeat/      Periodic HEARTBEAT.md checker
+  providers/      LLM providers (OpenAI SDK -- works with OpenRouter, Anthropic, etc.)
+  session/        JSONL conversation persistence
+  utils/          Path helpers, binary finder
+skills/           Bundled skill definitions (cron, github, summarize, weather, skill-creator)
+```
+
+### How it works
+
+1. Messages arrive via the **bus** (from Telegram, CLI, cron, or heartbeat)
+2. The **agent loop** builds context (system prompt + history + memory + skills)
+3. The **LLM provider** generates a response (with optional tool calls)
+4. **Tools** execute (filesystem, shell, web search, etc.) and results feed back to the LLM
+5. Final response is routed back through the bus to the originating channel
+
+## CLI Commands
+
+| Command | Description |
+|---------|-------------|
+| `nanobot onboard` | Initialize config and workspace |
+| `nanobot gateway` | Start the full gateway (agent + channels + cron + heartbeat) |
+| `nanobot agent -m "..."` | Send a single message to the agent |
+| `nanobot agent` | Interactive chat mode |
+| `nanobot channels status` | Show channel configuration |
+| `nanobot cron list` | List scheduled jobs |
+| `nanobot cron add` | Add a scheduled job |
+| `nanobot cron remove <id>` | Remove a scheduled job |
+| `nanobot status` | Show config and API key status |
+
+## Scripts
+
+```bash
+npm run build       # Build with tsdown
+npm run dev         # Run CLI via tsx (no build needed)
+npm run typecheck   # Type-check with tsc --noEmit
+npm run start       # Run built CLI
+```
+
+## Dependencies
+
+| Package | Purpose |
+|---------|---------|
+| `openai` | LLM provider (OpenAI-compatible API) |
+| `zod` | Config schema validation |
+| `commander` | CLI framework |
+| `grammy` | Telegram bot (grammY) |
+| `cron-parser` | Cron expression parsing |
+
+## Configuration
+
+Config lives at `~/.nanobot/config.json`. Supports multiple providers:
+
+```json
+{
+  "providers": {
+    "openrouter": { "apiKey": "sk-or-..." },
+    "anthropic": { "apiKey": "sk-ant-..." },
+    "openai": { "apiKey": "sk-..." }
+  },
+  "agents": {
+    "defaults": {
+      "model": "anthropic/claude-sonnet-4-20250514",
+      "maxTokens": 8192,
+      "maxToolIterations": 20
+    }
+  },
+  "channels": {
+    "telegram": {
+      "enabled": true,
+      "token": "123456:ABC..."
+    }
+  }
+}
+```
+
+## Programmatic usage
+
+```ts
+import { AgentLoop, MessageBus, OpenAIProvider, loadConfig } from "nanobot";
+
+const config = loadConfig();
+const bus = new MessageBus();
+const provider = new OpenAIProvider({
+  apiKey: "sk-...",
+  defaultModel: "anthropic/claude-sonnet-4-20250514",
+});
+
+const agent = new AgentLoop({
+  bus,
+  provider,
+  workspace: "/path/to/workspace",
+});
+
+const response = await agent.processDirect("What time is it?");
+```
+
+## Differences from Python nanobot
+
+- WhatsApp and Feishu channels removed (Telegram only)
+- `litellm` replaced with OpenAI SDK
+- `pydantic` replaced with `zod`
+- `typer`/`rich` replaced with `commander`
+- `python-telegram-bot` replaced with `grammy`
+- No native dependencies -- suitable for WebContainer deployment
+
+## License
+
+MIT

package/dist/_virtual/_rolldown/runtime.mjs

@@ -0,0 +1,40 @@
+import { createRequire } from "node:module";
+
+//#region \0rolldown/runtime.js
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __esmMin = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
+var __exportAll = (all, no_symbols) => {
+	let target = {};
+	for (var name in all) {
+		__defProp(target, name, {
+			get: all[name],
+			enumerable: true
+		});
+	}
+	if (!no_symbols) {
+		__defProp(target, Symbol.toStringTag, { value: "Module" });
+	}
+	return target;
+};
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") {
+		for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+			key = keys[i];
+			if (!__hasOwnProp.call(to, key) && key !== except) {
+				__defProp(to, key, {
+					get: ((k) => from[k]).bind(null, key),
+					enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+				});
+			}
+		}
+	}
+	return to;
+};
+var __toCommonJS = (mod) => __hasOwnProp.call(mod, "module.exports") ? mod["module.exports"] : __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var __require = /* @__PURE__ */ createRequire(import.meta.url);
+
+//#endregion
+export { __esmMin, __exportAll, __require, __toCommonJS };

package/dist/agent/context.d.mts

@@ -0,0 +1,44 @@
+import { ChatMessage } from "../providers/base.mjs";
+import { MemoryStore } from "./memory.mjs";
+import { SkillsLoader } from "./skills.mjs";
+
+//#region src/agent/context.d.ts
+/**
+ * Builds the context (system prompt + messages) for the agent.
+ */
+declare class ContextBuilder {
+  private workspace;
+  readonly memory: MemoryStore;
+  readonly skills: SkillsLoader;
+  constructor(workspace: string);
+  /** Build the system prompt from bootstrap files, memory, and skills. */
+  buildSystemPrompt(): string;
+  private getIdentity;
+  private loadBootstrapFiles;
+  /** Build the complete message list for an LLM call. */
+  buildMessages(params: {
+    history: Array<{
+      role: string;
+      content: string;
+    }>;
+    currentMessage: string;
+    media?: string[];
+    channel?: string;
+    chatId?: string;
+  }): ChatMessage[];
+  private buildUserContent;
+  /** Add a tool result to the message list. */
+  addToolResult(messages: ChatMessage[], toolCallId: string, toolName: string, result: string): ChatMessage[];
+  /** Add an assistant message to the message list. */
+  addAssistantMessage(messages: ChatMessage[], content: string | null, toolCalls?: Array<{
+    id: string;
+    type: "function";
+    function: {
+      name: string;
+      arguments: string;
+    };
+  }>): ChatMessage[];
+}
+//#endregion
+export { ContextBuilder };
+//# sourceMappingURL=context.d.mts.map

package/dist/agent/context.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.mts","names":[],"sources":["../../src/agent/context.ts"],"mappings":";;;;;;;AAiBA;cAAa,cAAA;EAAA,QACH,SAAA;EAAA,SACC,MAAA,EAAQ,WAAA;EAAA,SACR,MAAA,EAAQ,YAAA;cAEL,SAAA;EA8FR;EAvFJ,iBAAA,CAAA;EAAA,QAqCQ,WAAA;EAAA,QA+BA,kBAAA;EAuGM;EA1Fd,aAAA,CAAc,MAAA;IACZ,OAAA,EAAS,KAAA;MAAQ,IAAA;MAAc,OAAA;IAAA;IAC/B,cAAA;IACA,KAAA;IACA,OAAA;IACA,MAAA;EAAA,IACE,WAAA;EAAA,QA4BI,gBAAA;EA9EA;EAmHR,aAAA,CACE,QAAA,EAAU,WAAA,IACV,UAAA,UACA,QAAA,UACA,MAAA,WACC,WAAA;EA5EH;EAuFA,mBAAA,CACE,QAAA,EAAU,WAAA,IACV,OAAA,iBACA,SAAA,GAAY,KAAA;IACV,EAAA;IACA,IAAA;IACA,QAAA;MAAY,IAAA;MAAc,SAAA;IAAA;EAAA,KAE3B,WAAA;AAAA"}

package/dist/agent/context.mjs

@@ -0,0 +1,153 @@
+import { MemoryStore } from "./memory.mjs";
+import { SkillsLoader } from "./skills.mjs";
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+
+//#region src/agent/context.ts
+const BOOTSTRAP_FILES = [
+	"AGENTS.md",
+	"SOUL.md",
+	"USER.md",
+	"TOOLS.md",
+	"IDENTITY.md"
+];
+/**
+* Builds the context (system prompt + messages) for the agent.
+*/
+var ContextBuilder = class {
+	workspace;
+	memory;
+	skills;
+	constructor(workspace) {
+		this.workspace = workspace;
+		this.memory = new MemoryStore(workspace);
+		this.skills = new SkillsLoader(workspace);
+	}
+	/** Build the system prompt from bootstrap files, memory, and skills. */
+	buildSystemPrompt() {
+		const parts = [];
+		parts.push(this.getIdentity());
+		const bootstrap = this.loadBootstrapFiles();
+		if (bootstrap) parts.push(bootstrap);
+		const memory = this.memory.getMemoryContext();
+		if (memory) parts.push(`# Memory\n\n${memory}`);
+		const alwaysSkills = this.skills.getAlwaysSkills();
+		if (alwaysSkills.length > 0) {
+			const alwaysContent = this.skills.loadSkillsForContext(alwaysSkills);
+			if (alwaysContent) parts.push(`# Active Skills\n\n${alwaysContent}`);
+		}
+		const skillsSummary = this.skills.buildSkillsSummary();
+		if (skillsSummary) parts.push("# Skills\n\nThe following skills extend your capabilities. To use a skill, read its SKILL.md file using the read_file tool.\nSkills with available=\"false\" need dependencies installed first.\n\n" + skillsSummary);
+		return parts.join("\n\n---\n\n");
+	}
+	getIdentity() {
+		const now = /* @__PURE__ */ new Date();
+		return `# nanobot
+
+You are nanobot, a helpful AI assistant. You have access to tools that allow you to:
+- Read, write, and edit files
+- Execute shell commands
+- Search the web and fetch web pages
+- Send messages to users on chat channels
+- Spawn subagents for complex background tasks
+
+## Current Time
+${now.toISOString().slice(0, 16).replace("T", " ")} (${now.toLocaleDateString("en-US", { weekday: "long" })})
+
+## Workspace
+Your workspace is at: ${this.workspace}
+- Memory files: ${this.workspace}/memory/MEMORY.md
+- Daily notes: ${this.workspace}/memory/YYYY-MM-DD.md
+- Custom skills: ${this.workspace}/skills/{skill-name}/SKILL.md
+
+IMPORTANT: When responding to direct questions or conversations, reply directly with your text response.
+Only use the 'message' tool when you need to send a message to a specific chat channel.
+For normal conversation, just respond with text - do not call the message tool.
+
+Always be helpful, accurate, and concise. When using tools, explain what you're doing.
+When remembering something, write to ${this.workspace}/memory/MEMORY.md`;
+	}
+	loadBootstrapFiles() {
+		const parts = [];
+		for (const filename of BOOTSTRAP_FILES) {
+			const filePath = join(this.workspace, filename);
+			if (existsSync(filePath)) {
+				const content = readFileSync(filePath, "utf-8");
+				parts.push(`## ${filename}\n\n${content}`);
+			}
+		}
+		return parts.join("\n\n");
+	}
+	/** Build the complete message list for an LLM call. */
+	buildMessages(params) {
+		const messages = [];
+		let systemPrompt = this.buildSystemPrompt();
+		if (params.channel && params.chatId) systemPrompt += `\n\n## Current Session\nChannel: ${params.channel}\nChat ID: ${params.chatId}`;
+		messages.push({
+			role: "system",
+			content: systemPrompt
+		});
+		for (const msg of params.history) messages.push({
+			role: msg.role,
+			content: msg.content
+		});
+		const userContent = this.buildUserContent(params.currentMessage, params.media);
+		messages.push({
+			role: "user",
+			content: userContent
+		});
+		return messages;
+	}
+	buildUserContent(text, media) {
+		if (!media || media.length === 0) return text;
+		const images = [];
+		for (const filePath of media) {
+			if (!existsSync(filePath)) continue;
+			try {
+				const data = readFileSync(filePath);
+				const mime = {
+					jpg: "image/jpeg",
+					jpeg: "image/jpeg",
+					png: "image/png",
+					gif: "image/gif",
+					webp: "image/webp"
+				}[filePath.split(".").pop()?.toLowerCase() ?? ""];
+				if (!mime) continue;
+				const b64 = data.toString("base64");
+				images.push({
+					type: "image_url",
+					image_url: { url: `data:${mime};base64,${b64}` }
+				});
+			} catch {}
+		}
+		if (images.length === 0) return text;
+		return [...images, {
+			type: "text",
+			text
+		}];
+	}
+	/** Add a tool result to the message list. */
+	addToolResult(messages, toolCallId, toolName, result) {
+		messages.push({
+			role: "tool",
+			tool_call_id: toolCallId,
+			name: toolName,
+			content: result
+		});
+		return messages;
+	}
+	/** Add an assistant message to the message list. */
+	addAssistantMessage(messages, content, toolCalls) {
+		const msg = {
+			role: "assistant",
+			content: content ?? ""
+		};
+		if (toolCalls) msg.tool_calls = toolCalls;
+		messages.push(msg);
+		return messages;
+	}
+};
+
+//#endregion
+export { ContextBuilder };
+//# sourceMappingURL=context.mjs.map

package/dist/agent/context.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.mjs","names":[],"sources":["../../src/agent/context.ts"],"sourcesContent":["import { readFileSync, existsSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport type { ChatMessage, ContentPart } from \"../providers/base.js\";\nimport { MemoryStore } from \"./memory.js\";\nimport { SkillsLoader } from \"./skills.js\";\n\nconst BOOTSTRAP_FILES = [\n  \"AGENTS.md\",\n  \"SOUL.md\",\n  \"USER.md\",\n  \"TOOLS.md\",\n  \"IDENTITY.md\",\n];\n\n/**\n * Builds the context (system prompt + messages) for the agent.\n */\nexport class ContextBuilder {\n  private workspace: string;\n  readonly memory: MemoryStore;\n  readonly skills: SkillsLoader;\n\n  constructor(workspace: string) {\n    this.workspace = workspace;\n    this.memory = new MemoryStore(workspace);\n    this.skills = new SkillsLoader(workspace);\n  }\n\n  /** Build the system prompt from bootstrap files, memory, and skills. */\n  buildSystemPrompt(): string {\n    const parts: string[] = [];\n\n    // Core identity\n    parts.push(this.getIdentity());\n\n    // Bootstrap files\n    const bootstrap = this.loadBootstrapFiles();\n    if (bootstrap) parts.push(bootstrap);\n\n    // Memory context\n    const memory = this.memory.getMemoryContext();\n    if (memory) parts.push(`# Memory\\n\\n${memory}`);\n\n    // Always-loaded skills\n    const alwaysSkills = this.skills.getAlwaysSkills();\n    if (alwaysSkills.length > 0) {\n      const alwaysContent = this.skills.loadSkillsForContext(alwaysSkills);\n      if (alwaysContent) {\n        parts.push(`# Active Skills\\n\\n${alwaysContent}`);\n      }\n    }\n\n    // Available skills summary\n    const skillsSummary = this.skills.buildSkillsSummary();\n    if (skillsSummary) {\n      parts.push(\n        `# Skills\\n\\n` +\n          `The following skills extend your capabilities. To use a skill, read its SKILL.md file using the read_file tool.\\n` +\n          `Skills with available=\"false\" need dependencies installed first.\\n\\n` +\n          skillsSummary,\n      );\n    }\n\n    return parts.join(\"\\n\\n---\\n\\n\");\n  }\n\n  private getIdentity(): string {\n    const now = new Date();\n    const dateStr = now.toISOString().slice(0, 16).replace(\"T\", \" \");\n    const dayName = now.toLocaleDateString(\"en-US\", { weekday: \"long\" });\n\n    return `# nanobot\n\nYou are nanobot, a helpful AI assistant. You have access to tools that allow you to:\n- Read, write, and edit files\n- Execute shell commands\n- Search the web and fetch web pages\n- Send messages to users on chat channels\n- Spawn subagents for complex background tasks\n\n## Current Time\n${dateStr} (${dayName})\n\n## Workspace\nYour workspace is at: ${this.workspace}\n- Memory files: ${this.workspace}/memory/MEMORY.md\n- Daily notes: ${this.workspace}/memory/YYYY-MM-DD.md\n- Custom skills: ${this.workspace}/skills/{skill-name}/SKILL.md\n\nIMPORTANT: When responding to direct questions or conversations, reply directly with your text response.\nOnly use the 'message' tool when you need to send a message to a specific chat channel.\nFor normal conversation, just respond with text - do not call the message tool.\n\nAlways be helpful, accurate, and concise. When using tools, explain what you're doing.\nWhen remembering something, write to ${this.workspace}/memory/MEMORY.md`;\n  }\n\n  private loadBootstrapFiles(): string {\n    const parts: string[] = [];\n    for (const filename of BOOTSTRAP_FILES) {\n      const filePath = join(this.workspace, filename);\n      if (existsSync(filePath)) {\n        const content = readFileSync(filePath, \"utf-8\");\n        parts.push(`## ${filename}\\n\\n${content}`);\n      }\n    }\n    return parts.join(\"\\n\\n\");\n  }\n\n  /** Build the complete message list for an LLM call. */\n  buildMessages(params: {\n    history: Array<{ role: string; content: string }>;\n    currentMessage: string;\n    media?: string[];\n    channel?: string;\n    chatId?: string;\n  }): ChatMessage[] {\n    const messages: ChatMessage[] = [];\n\n    // System prompt\n    let systemPrompt = this.buildSystemPrompt();\n    if (params.channel && params.chatId) {\n      systemPrompt += `\\n\\n## Current Session\\nChannel: ${params.channel}\\nChat ID: ${params.chatId}`;\n    }\n    messages.push({ role: \"system\", content: systemPrompt });\n\n    // History\n    for (const msg of params.history) {\n      messages.push({\n        role: msg.role as \"user\" | \"assistant\",\n        content: msg.content,\n      });\n    }\n\n    // Current message (with optional image attachments)\n    const userContent = this.buildUserContent(\n      params.currentMessage,\n      params.media,\n    );\n    messages.push({ role: \"user\", content: userContent });\n\n    return messages;\n  }\n\n  private buildUserContent(\n    text: string,\n    media?: string[],\n  ): string | ContentPart[] {\n    if (!media || media.length === 0) return text;\n\n    const images: ContentPart[] = [];\n    for (const filePath of media) {\n      if (!existsSync(filePath)) continue;\n      try {\n        const data = readFileSync(filePath);\n        const ext = filePath.split(\".\").pop()?.toLowerCase() ?? \"\";\n        const mimeMap: Record<string, string> = {\n          jpg: \"image/jpeg\",\n          jpeg: \"image/jpeg\",\n          png: \"image/png\",\n          gif: \"image/gif\",\n          webp: \"image/webp\",\n        };\n        const mime = mimeMap[ext];\n        if (!mime) continue;\n\n        const b64 = data.toString(\"base64\");\n        images.push({\n          type: \"image_url\",\n          image_url: { url: `data:${mime};base64,${b64}` },\n        });\n      } catch {\n        // skip unreadable files\n      }\n    }\n\n    if (images.length === 0) return text;\n    return [...images, { type: \"text\", text }];\n  }\n\n  /** Add a tool result to the message list. */\n  addToolResult(\n    messages: ChatMessage[],\n    toolCallId: string,\n    toolName: string,\n    result: string,\n  ): ChatMessage[] {\n    messages.push({\n      role: \"tool\",\n      tool_call_id: toolCallId,\n      name: toolName,\n      content: result,\n    });\n    return messages;\n  }\n\n  /** Add an assistant message to the message list. */\n  addAssistantMessage(\n    messages: ChatMessage[],\n    content: string | null,\n    toolCalls?: Array<{\n      id: string;\n      type: \"function\";\n      function: { name: string; arguments: string };\n    }>,\n  ): ChatMessage[] {\n    const msg: ChatMessage = {\n      role: \"assistant\",\n      content: content ?? \"\",\n    };\n    if (toolCalls) {\n      msg.tool_calls = toolCalls;\n    }\n    messages.push(msg);\n    return messages;\n  }\n}\n"],"mappings":"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"}

package/dist/agent/loop.d.mts

@@ -0,0 +1,56 @@
+import { LLMProvider } from "../providers/base.mjs";
+import { ContextBuilder } from "./context.mjs";
+import { MessageBus } from "../bus/queue.mjs";
+import { ToolRegistry } from "./tools/registry.mjs";
+import { ExecToolConfig } from "../config/schema.mjs";
+import { SubagentManager } from "./subagent.mjs";
+import { SessionManager } from "../session/manager.mjs";
+import { CronService } from "../cron/service.mjs";
+
+//#region src/agent/loop.d.ts
+/**
+ * The agent loop: core processing engine.
+ *
+ * 1. Receives messages from the bus
+ * 2. Builds context with history, memory, skills
+ * 3. Calls the LLM
+ * 4. Executes tool calls
+ * 5. Sends responses back
+ */
+declare class AgentLoop {
+  private bus;
+  private provider;
+  private workspace;
+  private model;
+  private maxIterations;
+  readonly context: ContextBuilder;
+  readonly sessions: SessionManager;
+  readonly tools: ToolRegistry;
+  readonly subagents: SubagentManager;
+  private _running;
+  constructor(params: {
+    bus: MessageBus;
+    provider: LLMProvider;
+    workspace: string;
+    model?: string;
+    maxIterations?: number;
+    braveApiKey?: string;
+    execConfig?: ExecToolConfig;
+    cronService?: CronService;
+  });
+  private registerDefaultTools;
+  /** Run the agent loop, processing messages from the bus. */
+  run(): Promise<void>;
+  /** Stop the agent loop. */
+  stop(): void;
+  /** Process a single inbound message. */
+  private processMessage;
+  private processSystemMessage;
+  private runAgentLoop;
+  private updateToolContexts;
+  /** Process a message directly (for CLI or cron usage). */
+  processDirect(content: string, sessionKey?: string, channel?: string, chatId?: string): Promise<string>;
+}
+//#endregion
+export { AgentLoop };
+//# sourceMappingURL=loop.d.mts.map

package/dist/agent/loop.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop.d.mts","names":[],"sources":["../../src/agent/loop.ts"],"mappings":";;;;;;;;;;;;AAkCA;;;;;;;cAAa,SAAA;EAAA,QACH,GAAA;EAAA,QACA,QAAA;EAAA,QACA,SAAA;EAAA,QACA,KAAA;EAAA,QACA,aAAA;EAAA,SAEC,OAAA,EAAS,cAAA;EAAA,SACT,QAAA,EAAU,cAAA;EAAA,SACV,KAAA,EAAO,YAAA;EAAA,SACP,SAAA,EAAW,eAAA;EAAA,QAEZ,QAAA;cAEI,MAAA;IACV,GAAA,EAAK,UAAA;IACL,QAAA,EAAU,WAAA;IACV,SAAA;IACA,KAAA;IACA,aAAA;IACA,WAAA;IACA,UAAA,GAAa,cAAA;IACb,WAAA,GAAc,WAAA;EAAA;EAAA,QA4BR,oBAAA;;EAyCF,GAAA,CAAA,GAAO,OAAA;EA5EN;EA0GP,IAAA,CAAA;EAzGY;EAAA,QA+GE,cAAA;EAAA,QAwCA,oBAAA;EAAA,QA0CA,YAAA;EAAA,QA0CN,kBAAA;EAtON;EAwPI,aAAA,CACJ,OAAA,UACA,UAAA,WACA,OAAA,WACA,MAAA,YACC,OAAA;AAAA"}