@openacp/cli 0.6.10 → 2026.326.2

package/dist/{chunk-OWP7RZ62.js → chunk-5ZOFBTOR.js}

@@ -1,268 +1,133 @@
-// src/adapters/shared/format-types.ts
-var STATUS_ICONS = {
-  pending: "\u23F3",
-  in_progress: "\u{1F504}",
-  completed: "\u2705",
-  failed: "\u274C",
-  cancelled: "\u{1F6AB}",
-  running: "\u{1F504}",
-  done: "\u2705",
-  error: "\u274C"
-};
-var KIND_ICONS = {
-  read: "\u{1F4D6}",
-  edit: "\u270F\uFE0F",
-  write: "\u270F\uFE0F",
-  delete: "\u{1F5D1}\uFE0F",
-  execute: "\u25B6\uFE0F",
-  command: "\u25B6\uFE0F",
-  bash: "\u25B6\uFE0F",
-  search: "\u{1F50D}",
-  web: "\u{1F310}",
-  fetch: "\u{1F310}",
-  agent: "\u{1F9E0}",
-  think: "\u{1F9E0}",
-  install: "\u{1F4E6}",
-  move: "\u{1F4E6}",
-  other: "\u{1F6E0}\uFE0F"
-};
-
-// src/adapters/shared/message-formatter.ts
-function extractContentText(content, depth = 0) {
-  if (!content || depth > 5) return "";
-  if (typeof content === "string") return content;
-  if (Array.isArray(content)) {
-    return content.map((c) => extractContentText(c, depth + 1)).filter(Boolean).join("\n");
-  }
-  if (typeof content !== "object") return String(content);
-  const obj = content;
-  if (obj.text && typeof obj.text === "string") return obj.text;
-  if (obj.content) {
-    if (typeof obj.content === "string") return obj.content;
-    if (Array.isArray(obj.content)) {
-      return obj.content.map((c) => extractContentText(c, depth + 1)).filter(Boolean).join("\n");
-    }
-    return extractContentText(obj.content, depth + 1);
+// src/core/adapter-primitives/primitives/send-queue.ts
+var SendQueue = class {
+  constructor(config) {
+    this.config = config;
   }
-  if (obj.input) return extractContentText(obj.input, depth + 1);
-  if (obj.output) return extractContentText(obj.output, depth + 1);
-  const keys = Object.keys(obj).filter((k) => k !== "type");
-  if (keys.length === 0) return "";
-  try {
-    return JSON.stringify(obj, null, 2);
-  } catch {
-    return "";
+  items = [];
+  processing = false;
+  lastExec = 0;
+  lastCategoryExec = /* @__PURE__ */ new Map();
+  get pending() {
+    return this.items.length;
   }
-}
-function parseRawInput(rawInput) {
-  try {
-    if (typeof rawInput === "string") {
-      return JSON.parse(rawInput);
-    }
-    if (typeof rawInput === "object" && rawInput !== null) {
-      return rawInput;
+  enqueue(fn, opts) {
+    const type = opts?.type ?? "other";
+    const key = opts?.key;
+    const category = opts?.category;
+    let resolve;
+    let reject;
+    const promise = new Promise((res, rej) => {
+      resolve = res;
+      reject = rej;
+    });
+    promise.catch(() => {
+    });
+    if (type === "text" && key) {
+      const idx = this.items.findIndex(
+        (item) => item.type === "text" && item.key === key
+      );
+      if (idx !== -1) {
+        this.items[idx].resolve(void 0);
+        this.items[idx] = { fn, type, key, category, resolve, reject, promise };
+        this.scheduleProcess();
+        return promise;
+      }
     }
-  } catch {
-  }
-  return {};
-}
-function formatToolSummary(name, rawInput, displaySummary) {
-  if (displaySummary && typeof displaySummary === "string") {
-    return displaySummary;
-  }
-  const args = parseRawInput(rawInput);
-  const lowerName = name.toLowerCase();
-  if (lowerName === "read") {
-    const fp = args.file_path ?? args.filePath ?? "";
-    const limit = args.limit ? ` (${args.limit} lines)` : "";
-    return fp ? `\u{1F4D6} Read ${fp}${limit}` : `\u{1F527} ${name}`;
-  }
-  if (lowerName === "edit") {
-    const fp = args.file_path ?? args.filePath ?? "";
-    return fp ? `\u270F\uFE0F Edit ${fp}` : `\u{1F527} ${name}`;
-  }
-  if (lowerName === "write") {
-    const fp = args.file_path ?? args.filePath ?? "";
-    return fp ? `\u{1F4DD} Write ${fp}` : `\u{1F527} ${name}`;
-  }
-  if (lowerName === "bash") {
-    const cmd = String(args.command ?? "").slice(0, 60);
-    return cmd ? `\u25B6\uFE0F Run: ${cmd}` : `\u{1F527} ${name}`;
-  }
-  if (lowerName === "grep") {
-    const pattern = args.pattern ?? "";
-    const path = args.path ?? "";
-    return pattern ? `\u{1F50D} Grep "${pattern}"${path ? ` in ${path}` : ""}` : `\u{1F527} ${name}`;
-  }
-  if (lowerName === "glob") {
-    const pattern = args.pattern ?? "";
-    return pattern ? `\u{1F50D} Glob ${pattern}` : `\u{1F527} ${name}`;
-  }
-  if (lowerName === "agent") {
-    const desc = String(args.description ?? "").slice(0, 60);
-    return desc ? `\u{1F9E0} Agent: ${desc}` : `\u{1F527} ${name}`;
-  }
-  if (lowerName === "webfetch" || lowerName === "web_fetch") {
-    const url = String(args.url ?? "").slice(0, 60);
-    return url ? `\u{1F310} Fetch ${url}` : `\u{1F527} ${name}`;
-  }
-  if (lowerName === "websearch" || lowerName === "web_search") {
-    const query = String(args.query ?? "").slice(0, 60);
-    return query ? `\u{1F310} Search "${query}"` : `\u{1F527} ${name}`;
-  }
-  return `\u{1F527} ${name}`;
-}
-function formatToolTitle(name, rawInput, displayTitle) {
-  if (displayTitle && typeof displayTitle === "string") {
-    return displayTitle;
-  }
-  const args = parseRawInput(rawInput);
-  const lowerName = name.toLowerCase();
-  if (["read", "edit", "write"].includes(lowerName)) {
-    return String(args.file_path ?? args.filePath ?? name);
+    this.items.push({ fn, type, key, category, resolve, reject, promise });
+    this.scheduleProcess();
+    return promise;
   }
-  if (lowerName === "bash") {
-    return String(args.command ?? name).slice(0, 60);
+  onRateLimited() {
+    this.config.onRateLimited?.();
+    const remaining = [];
+    for (const item of this.items) {
+      if (item.type === "text") {
+        item.resolve(void 0);
+      } else {
+        remaining.push(item);
+      }
+    }
+    this.items = remaining;
   }
-  if (lowerName === "grep") {
-    const pattern = args.pattern ?? "";
-    const path = args.path ?? "";
-    return pattern ? `"${pattern}"${path ? ` in ${path}` : ""}` : name;
+  clear() {
+    for (const item of this.items) {
+      item.resolve(void 0);
+    }
+    this.items = [];
   }
-  if (lowerName === "glob") {
-    return String(args.pattern ?? name);
+  scheduleProcess() {
+    if (this.processing) return;
+    if (this.items.length === 0) return;
+    const item = this.items[0];
+    const interval = this.getInterval(item.category);
+    const lastExec = item.category ? this.lastCategoryExec.get(item.category) ?? 0 : this.lastExec;
+    const elapsed = Date.now() - lastExec;
+    const delay = Math.max(0, interval - elapsed);
+    this.processing = true;
+    setTimeout(() => void this.processNext(), delay);
   }
-  if (lowerName === "agent") {
-    return String(args.description ?? name).slice(0, 60);
+  getInterval(category) {
+    if (category && this.config.categoryIntervals?.[category] != null) {
+      return this.config.categoryIntervals[category];
+    }
+    return this.config.minInterval;
   }
-  if (["webfetch", "web_fetch"].includes(lowerName)) {
-    return String(args.url ?? name).slice(0, 60);
+  async processNext() {
+    const item = this.items.shift();
+    if (!item) {
+      this.processing = false;
+      return;
+    }
+    try {
+      const result = await item.fn();
+      item.resolve(result);
+    } catch (err) {
+      this.config.onError?.(err instanceof Error ? err : new Error(String(err)));
+      item.reject(err);
+    } finally {
+      const now = Date.now();
+      this.lastExec = now;
+      if (item.category) {
+        this.lastCategoryExec.set(item.category, now);
+      }
+      this.processing = false;
+      this.scheduleProcess();
+    }
   }
-  if (["websearch", "web_search"].includes(lowerName)) {
-    return String(args.query ?? name).slice(0, 60);
+};
+
+// src/core/adapter-primitives/primitives/tool-call-tracker.ts
+var ToolCallTracker = class {
+  sessions = /* @__PURE__ */ new Map();
+  track(sessionId, meta, messageId) {
+    if (!this.sessions.has(sessionId)) {
+      this.sessions.set(sessionId, /* @__PURE__ */ new Map());
+    }
+    this.sessions.get(sessionId).set(meta.id, { ...meta, messageId });
   }
-  return name;
-}
-function resolveToolIcon(tool) {
-  const statusIcon = STATUS_ICONS[tool.status || ""];
-  if (statusIcon) return statusIcon;
-  const kind = tool.displayKind ?? tool.kind;
-  if (kind && KIND_ICONS[kind]) return KIND_ICONS[kind];
-  return "\u{1F527}";
-}
-var NOISE_RULES = [
-  {
-    match: (name) => name.toLowerCase() === "ls",
-    action: "hide"
-  },
-  {
-    match: (_name, kind, rawInput) => {
-      if (kind !== "read") return false;
-      const args = parseRawInput(rawInput);
-      const p = String(args.file_path ?? args.filePath ?? args.path ?? "");
-      return p.endsWith("/");
-    },
-    action: "hide"
-  },
-  {
-    match: (name) => name.toLowerCase() === "glob",
-    action: "collapse"
+  update(sessionId, toolId, status, patch) {
+    const tool = this.sessions.get(sessionId)?.get(toolId);
+    if (!tool) return null;
+    tool.status = status;
+    if (patch?.viewerLinks) tool.viewerLinks = patch.viewerLinks;
+    if (patch?.viewerFilePath) tool.viewerFilePath = patch.viewerFilePath;
+    if (patch?.name) tool.name = patch.name;
+    if (patch?.kind) tool.kind = patch.kind;
+    return tool;
   }
-];
-function evaluateNoise(name, kind, rawInput) {
-  for (const rule of NOISE_RULES) {
-    if (rule.match(name, kind, rawInput)) return rule.action;
+  getActive(sessionId) {
+    const session = this.sessions.get(sessionId);
+    return session ? [...session.values()] : [];
   }
-  return null;
-}
-
-// src/adapters/shared/message-dispatcher.ts
-var HIDDEN_ON_LOW = /* @__PURE__ */ new Set(["thought", "plan", "usage"]);
-function shouldDispatch(type, verbosity) {
-  if (verbosity === "low" && HIDDEN_ON_LOW.has(type)) return false;
-  return true;
-}
-async function dispatchMessage(handlers, ctx, content, verbosity = "medium") {
-  if (!shouldDispatch(content.type, verbosity)) return;
-  switch (content.type) {
-    case "text":
-      return handlers.onText(ctx, content);
-    case "thought":
-      return handlers.onThought(ctx, content);
-    case "tool_call":
-      return handlers.onToolCall(ctx, content);
-    case "tool_update":
-      return handlers.onToolUpdate(ctx, content);
-    case "plan":
-      return handlers.onPlan(ctx, content);
-    case "usage":
-      return handlers.onUsage(ctx, content);
-    case "session_end":
-      return handlers.onSessionEnd(ctx, content);
-    case "error":
-      return handlers.onError(ctx, content);
-    case "attachment":
-      return handlers.onAttachment(ctx, content);
-    case "system_message":
-      return handlers.onSystemMessage(ctx, content);
-    default:
-      return;
+  clear(sessionId) {
+    this.sessions.delete(sessionId);
   }
-}
-
-// src/adapters/shared/format-utils.ts
-function progressBar(ratio, length = 10) {
-  const filled = Math.round(Math.min(ratio, 1) * length);
-  return "\u2593".repeat(filled) + "\u2591".repeat(length - filled);
-}
-function formatTokens(n) {
-  return n >= 1e3 ? `${Math.round(n / 1e3)}k` : String(n);
-}
-function stripCodeFences(text) {
-  return text.replace(/```\w*\n?/g, "").replace(/```$/gm, "").trim();
-}
-function truncateContent(text, maxLen) {
-  if (text.length <= maxLen) return text;
-  return text.slice(0, maxLen) + "\n\u2026 (truncated)";
-}
-function splitMessage(text, maxLength) {
-  if (text.length <= maxLength) return [text];
-  const chunks = [];
-  let remaining = text;
-  while (remaining.length > 0) {
-    if (remaining.length <= maxLength) {
-      chunks.push(remaining);
-      break;
-    }
-    const wouldLeaveSmall = remaining.length < maxLength * 1.3;
-    const searchLimit = wouldLeaveSmall ? Math.floor(remaining.length / 2) + 300 : maxLength;
-    const threshold = maxLength * 0.2;
-    let splitAt = remaining.lastIndexOf("\n\n", searchLimit);
-    if (splitAt === -1 || splitAt < threshold) {
-      splitAt = remaining.lastIndexOf("\n", searchLimit);
-    }
-    if (splitAt === -1 || splitAt < threshold) {
-      splitAt = searchLimit;
-    }
-    const candidate = remaining.slice(0, splitAt);
-    const fences = candidate.match(/```/g);
-    if (fences && fences.length % 2 !== 0) {
-      const closingFence = remaining.indexOf("```", splitAt);
-      if (closingFence !== -1) {
-        const afterFence = remaining.indexOf("\n", closingFence + 3);
-        const fenceSplit = afterFence !== -1 ? afterFence + 1 : closingFence + 3;
-        if (fenceSplit <= maxLength * 2) {
-          splitAt = fenceSplit;
-        }
-      }
-    }
-    chunks.push(remaining.slice(0, splitAt));
-    remaining = remaining.slice(splitAt).replace(/^\n+/, "");
+  clearAll() {
+    this.sessions.clear();
   }
-  return chunks;
-}
+};
 
-// src/product-guide.ts
+// src/data/product-guide.ts
 var PRODUCT_GUIDE = `
 # OpenACP \u2014 Product Guide
 
@@ -681,17 +546,8 @@ Session logs auto-cleanup: 30 days (configurable via \`logging.sessionLogRetenti
 `;
 
 export {
-  progressBar,
-  formatTokens,
-  stripCodeFences,
-  truncateContent,
-  splitMessage,
-  extractContentText,
-  formatToolSummary,
-  formatToolTitle,
-  resolveToolIcon,
-  evaluateNoise,
   PRODUCT_GUIDE,
-  dispatchMessage
+  SendQueue,
+  ToolCallTracker
 };
-//# sourceMappingURL=chunk-OWP7RZ62.js.map
+//# sourceMappingURL=chunk-5ZOFBTOR.js.map

package/dist/chunk-5ZOFBTOR.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/core/adapter-primitives/primitives/send-queue.ts","../../src/core/adapter-primitives/primitives/tool-call-tracker.ts","../../src/data/product-guide.ts"],"sourcesContent":["export type QueueItemType = 'text' | 'other'\n\nexport interface SendQueueConfig {\n  minInterval: number\n  categoryIntervals?: Record<string, number>\n  onRateLimited?: () => void\n  onError?: (error: Error) => void\n}\n\nexport interface EnqueueOptions {\n  type?: QueueItemType\n  key?: string\n  category?: string\n}\n\ninterface QueueItem<T = unknown> {\n  fn: () => Promise<T>\n  type: QueueItemType\n  key?: string\n  category?: string\n  resolve: (value: T | undefined) => void\n  reject: (err: unknown) => void\n  promise: Promise<T | undefined>\n}\n\nexport class SendQueue {\n  private items: QueueItem[] = []\n  private processing = false\n  private lastExec = 0\n  private lastCategoryExec = new Map<string, number>()\n\n  constructor(private config: SendQueueConfig) {}\n\n  get pending(): number {\n    return this.items.length\n  }\n\n  enqueue<T>(\n    fn: () => Promise<T>,\n    opts?: EnqueueOptions,\n  ): Promise<T | undefined> {\n    const type = opts?.type ?? 'other'\n    const key = opts?.key\n    const category = opts?.category\n\n    let resolve!: (value: T | undefined) => void\n    let reject!: (err: unknown) => void\n    const promise = new Promise<T | undefined>((res, rej) => {\n      resolve = res\n      reject = rej\n    })\n    // Suppress unhandled rejection — callers are expected to handle via .catch or await\n    promise.catch(() => {})\n\n    if (type === 'text' && key) {\n      const idx = this.items.findIndex(\n        (item) => item.type === 'text' && item.key === key,\n      )\n      if (idx !== -1) {\n        this.items[idx].resolve(undefined)\n        this.items[idx] = { fn, type, key, category, resolve, reject, promise } as QueueItem\n        this.scheduleProcess()\n        return promise\n      }\n    }\n\n    this.items.push({ fn, type, key, category, resolve, reject, promise } as QueueItem)\n    this.scheduleProcess()\n    return promise\n  }\n\n  onRateLimited(): void {\n    this.config.onRateLimited?.()\n    const remaining: QueueItem[] = []\n    for (const item of this.items) {\n      if (item.type === 'text') {\n        item.resolve(undefined)\n      } else {\n        remaining.push(item)\n      }\n    }\n    this.items = remaining\n  }\n\n  clear(): void {\n    for (const item of this.items) {\n      item.resolve(undefined)\n    }\n    this.items = []\n  }\n\n  private scheduleProcess(): void {\n    if (this.processing) return\n    if (this.items.length === 0) return\n\n    const item = this.items[0]\n    const interval = this.getInterval(item.category)\n    const lastExec = item.category\n      ? this.lastCategoryExec.get(item.category) ?? 0\n      : this.lastExec\n    const elapsed = Date.now() - lastExec\n    const delay = Math.max(0, interval - elapsed)\n\n    this.processing = true\n    setTimeout(() => void this.processNext(), delay)\n  }\n\n  private getInterval(category?: string): number {\n    if (category && this.config.categoryIntervals?.[category] != null) {\n      return this.config.categoryIntervals[category]\n    }\n    return this.config.minInterval\n  }\n\n  private async processNext(): Promise<void> {\n    const item = this.items.shift()\n    if (!item) {\n      this.processing = false\n      return\n    }\n\n    try {\n      const result = await item.fn()\n      item.resolve(result)\n    } catch (err) {\n      this.config.onError?.(err instanceof Error ? err : new Error(String(err)))\n      item.reject(err)\n    } finally {\n      const now = Date.now()\n      this.lastExec = now\n      if (item.category) {\n        this.lastCategoryExec.set(item.category, now)\n      }\n      this.processing = false\n      this.scheduleProcess()\n    }\n  }\n}\n","import type { ToolCallMeta } from '../format-types.js'\n\nexport interface TrackedToolCall extends ToolCallMeta {\n  messageId: string\n}\n\nexport class ToolCallTracker {\n  private sessions = new Map<string, Map<string, TrackedToolCall>>()\n\n  track(sessionId: string, meta: ToolCallMeta, messageId: string): void {\n    if (!this.sessions.has(sessionId)) {\n      this.sessions.set(sessionId, new Map())\n    }\n    this.sessions.get(sessionId)!.set(meta.id, { ...meta, messageId })\n  }\n\n  update(\n    sessionId: string,\n    toolId: string,\n    status: string,\n    patch?: Partial<Pick<ToolCallMeta, 'viewerLinks' | 'viewerFilePath' | 'name' | 'kind'>>,\n  ): TrackedToolCall | null {\n    const tool = this.sessions.get(sessionId)?.get(toolId)\n    if (!tool) return null\n\n    tool.status = status\n    if (patch?.viewerLinks) tool.viewerLinks = patch.viewerLinks\n    if (patch?.viewerFilePath) tool.viewerFilePath = patch.viewerFilePath\n    if (patch?.name) tool.name = patch.name\n    if (patch?.kind) tool.kind = patch.kind\n\n    return tool\n  }\n\n  getActive(sessionId: string): TrackedToolCall[] {\n    const session = this.sessions.get(sessionId)\n    return session ? [...session.values()] : []\n  }\n\n  clear(sessionId: string): void {\n    this.sessions.delete(sessionId)\n  }\n\n  clearAll(): void {\n    this.sessions.clear()\n  }\n}\n","/**\n * OpenACP Product Guide — comprehensive reference for the AI assistant.\n * The assistant reads this at runtime to answer user questions about features.\n */\nexport const PRODUCT_GUIDE = `\n# OpenACP — Product Guide\n\nOpenACP lets you chat with AI coding agents (like Claude Code) through messaging platforms (Telegram, Discord).\nYou type messages in your chat platform, the agent reads/writes/runs code in your project folder, and results stream back in real time.\n\n---\n\n## Quick Start\n\n1. Start OpenACP: \\`openacp\\` (or \\`openacp start\\` for background daemon)\n2. Open your messaging platform (Telegram group or Discord server) — you'll see the Assistant topic/thread\n3. Tap/click 🆕 New Session or type /new\n4. Pick an agent and a project folder\n5. Chat in the session topic/thread — the agent works on your code\n\n---\n\n## Core Concepts\n\n### Sessions\nA session = one conversation with one AI agent working in one project folder.\nEach session gets its own topic (Telegram) or forum thread (Discord). Chat there to give instructions to the agent.\n\n### Agents\nAn agent is an AI coding tool (e.g., Claude Code, Gemini, Cursor, Codex, etc.).\nOpenACP supports 28+ agents from the official ACP Registry (agentclientprotocol.com).\nYou can install multiple agents and choose which one to use per session.\nThe default agent is used when you don't specify one.\n\n### Agent Management\n- Browse agents: \\`/agents\\` in your chat platform or \\`openacp agents\\` in CLI\n- Install: tap the install button in /agents, or \\`openacp agents install <name>\\`\n- Uninstall: \\`openacp agents uninstall <name>\\`\n- Setup/login: \\`openacp agents run <name> -- <args>\\` (e.g., \\`openacp agents run gemini -- auth login\\`)\n- Details: \\`openacp agents info <name>\\` shows version, dependencies, and setup steps\n\nSome agents need additional setup before they can be used:\n- Claude: requires \\`claude login\\`\n- Gemini: requires \\`openacp agents run gemini -- auth login\\`\n- Codex: requires setting \\`OPENAI_API_KEY\\` environment variable\n- GitHub Copilot: requires \\`openacp agents run copilot -- auth login\\`\n\nAgents are installed in three ways depending on the agent:\n- **npx** — Node.js agents, downloaded automatically on first use\n- **uvx** — Python agents, downloaded automatically on first use\n- **binary** — Platform-specific binaries, downloaded to \\`~/.openacp/agents/\\`\n\n### Project Folder (Workspace)\nThe directory where the agent reads, writes, and runs code.\nWhen creating a session, you choose which folder the agent works in.\nYou can type a full path like \\`~/code/my-project\\` or just a name like \\`my-project\\` (it becomes \\`<base-dir>/my-project\\`).\n\n### System Topics\n- **Assistant** — Always-on helper that can answer questions, create sessions, check status, troubleshoot\n- **Notifications** — System alerts (permission requests, session errors, completions)\n\n---\n\n## Creating Sessions\n\n### From menu\nTap 🆕 New Session → choose agent (if multiple) → choose project folder → confirm\n\n### From command\n- \\`/new\\` — Interactive flow (asks agent + folder)\n- \\`/new claude ~/code/my-project\\` — Create directly with specific agent and folder\n\n### From Assistant topic\nJust ask: \"Create a session for my-project with claude\" — the assistant handles it\n\n### Quick new chat\n\\`/newchat\\` in a session topic — creates new session with same agent and folder as current one\n\n---\n\n## Working with Sessions\n\n### Chat\nType messages in the session topic. The agent responds with code changes, explanations, tool outputs.\n\n### What you see while the agent works\n- **💭 Thinking indicator** — Shows when the agent is reasoning, with elapsed time\n- **Text responses** — Streamed in real time, updated every few seconds\n- **Tool calls** — When the agent runs commands or edits files, you see tool name, input, status, and output\n- **📋 Plan card** — Visual task progress with completed/in-progress/pending items and progress bar\n- **\"View File\" / \"View Diff\" buttons** — Opens in browser with Monaco editor (requires tunnel)\n\n### Session lifecycle\n1. **Creating** — Topic created, agent spawning\n2. **Warming up** — Agent primes its cache (happens automatically, invisible to you)\n3. **Active** — Ready for your messages\n4. **Auto-naming** — After your first message, the session gets a descriptive name (agent summarizes in ~5 words). The topic title updates automatically.\n5. **Finished/Error** — Session completed or hit an error\n\n### Agent skills\nSome agents provide slash commands (e.g., /compact, /review). Available skills are pinned in the session topic.\n\n### Permission requests\nWhen the agent wants to run a command, it asks for permission.\nYou see buttons: ✅ Allow, ❌ Reject (and sometimes \"Always Allow\").\nA notification also appears in the Notifications topic with a link to the request.\n\n### Dangerous mode\nAuto-approves ALL permission requests — the agent runs any command without asking.\n- Enable: \\`/enable_dangerous\\` or tap the ☠️ button in the session\n- Disable: \\`/disable_dangerous\\` or tap the 🔐 button\n- ⚠️ Use with caution — the agent can execute anything\n\n### Session timeout\nIdle sessions are automatically cancelled after a configurable timeout (default: 60 minutes).\nConfigure via \\`security.sessionTimeoutMinutes\\` in config.\n\n---\n\n## Session Transfer (Handoff)\n\n### Chat → Terminal\n1. Type \\`/handoff\\` in a session topic/thread\n2. You get a command like \\`claude --resume <SESSION_ID>\\`\n3. Copy and run it in your terminal — the session continues there with full conversation history\n\n### Terminal → Chat\n1. First time: run \\`openacp integrate claude\\` to install the handoff skill (one-time setup)\n2. In Claude Code, use the /openacp:handoff slash command\n3. The session appears as a new topic/thread and you can continue chatting there\n\n### How it works\n- The agent session ID is shared between platforms\n- Conversation history is preserved — pick up where you left off\n- The agent that supports resume (e.g., Claude with \\`--resume\\`) handles the actual transfer\n\n---\n\n## Managing Sessions\n\n### Status\n- \\`/status\\` — Shows active sessions count and details\n- Ask the Assistant: \"What sessions are running?\"\n\n### List all sessions\n- \\`/sessions\\` — Shows all sessions with status (active, finished, error)\n\n### Cancel\n- \\`/cancel\\` in a session topic — cancels that session\n- Ask the Assistant: \"Cancel the stuck session\"\n\n### Cleanup\n- From \\`/sessions\\` → tap cleanup buttons (finished, errors, all)\n- Ask the Assistant: \"Clean up old sessions\"\n\n---\n\n## Assistant Topic\n\nThe Assistant is an always-on AI helper in its own topic. It can:\n- Answer questions about OpenACP\n- Create sessions for you\n- Check status and health\n- Cancel sessions\n- Clean up old sessions\n- Troubleshoot issues\n- Manage configuration\n\nJust chat naturally: \"How do I create a session?\", \"What's the status?\", \"Something is stuck\"\n\n### Clear history\n\\`/clear\\` in the Assistant topic — resets the conversation\n\n---\n\n## System Commands\n\n| Command | Where | What it does |\n|---------|-------|-------------|\n| \\`/new [agent] [path]\\` | Anywhere | Create new session |\n| \\`/newchat\\` | Session topic | New session, same agent + folder |\n| \\`/cancel\\` | Session topic | Cancel current session |\n| \\`/status\\` | Anywhere | Show status |\n| \\`/sessions\\` | Anywhere | List all sessions |\n| \\`/agents\\` | Anywhere | Browse & install agents from ACP Registry |\n| \\`/install <name>\\` | Anywhere | Install an agent |\n| \\`/enable_dangerous\\` | Session topic | Auto-approve all permissions |\n| \\`/disable_dangerous\\` | Session topic | Restore permission prompts |\n| \\`/handoff\\` | Session topic | Transfer session to terminal |\n| \\`/clear\\` | Assistant topic | Clear assistant history |\n| \\`/menu\\` | Anywhere | Show action menu |\n| \\`/help\\` | Anywhere | Show help |\n| \\`/restart\\` | Anywhere | Restart OpenACP |\n| \\`/update\\` | Anywhere | Update to latest version |\n| \\`/integrate\\` | Anywhere | Manage agent integrations |\n\n---\n\n## Menu Buttons\n\n| Button | Action |\n|--------|--------|\n| 🆕 New Session | Create new session (interactive) |\n| 📋 Sessions | List all sessions with cleanup options |\n| 📊 Status | Show active/total session count |\n| 🤖 Agents | List available agents |\n| 🔗 Integrate | Manage agent integrations |\n| ❓ Help | Show help text |\n| 🔄 Restart | Restart OpenACP |\n| ⬆️ Update | Check and install updates |\n\n---\n\n## CLI Commands\n\n### Server\n- \\`openacp\\` — Start (uses configured mode: foreground or daemon)\n- \\`openacp start\\` — Start as background daemon\n- \\`openacp stop\\` — Stop daemon\n- \\`openacp status\\` — Show daemon status\n- \\`openacp logs\\` — Tail daemon logs\n- \\`openacp --foreground\\` — Force foreground mode (useful for debugging or containers)\n\n### Auto-start (run on boot)\n- macOS: installs a LaunchAgent in \\`~/Library/LaunchAgents/\\`\n- Linux: installs a systemd user service in \\`~/.config/systemd/user/\\`\n- Enabled automatically when you start the daemon. Remove with \\`openacp stop\\`.\n\n### Configuration\n- \\`openacp config\\` — Interactive config editor\n- \\`openacp reset\\` — Delete all data and start fresh\n\n### Agent Management (CLI)\n- \\`openacp agents\\` — List all agents (installed + available from ACP Registry)\n- \\`openacp agents install <name>\\` — Install an agent\n- \\`openacp agents uninstall <name>\\` — Remove an agent\n- \\`openacp agents info <name>\\` — Show details, dependencies, and setup guide\n- \\`openacp agents run <name> [-- args]\\` — Run agent CLI directly (for login, config, etc.)\n- \\`openacp agents refresh\\` — Force-refresh registry cache\n\n### Plugins\n- \\`openacp install <package>\\` — Install adapter plugin\n- \\`openacp uninstall <package>\\` — Remove adapter plugin\n- \\`openacp plugins\\` — List installed plugins\n\n### Integration\n- \\`openacp integrate <agent>\\` — Install agent integration (e.g., Claude handoff skill)\n- \\`openacp integrate <agent> --uninstall\\` — Remove integration\n\n### API (requires running daemon)\n\\`openacp api <command>\\` — Interact with running daemon:\n\n| Command | Description |\n|---------|-------------|\n| \\`status\\` | List active sessions |\n| \\`session <id>\\` | Session details |\n| \\`new <agent> <path>\\` | Create session |\n| \\`send <id> \"text\"\\` | Send prompt |\n| \\`cancel <id>\\` | Cancel session |\n| \\`dangerous <id> on/off\\` | Toggle dangerous mode |\n| \\`topics [--status x,y]\\` | List topics |\n| \\`delete-topic <id> [--force]\\` | Delete topic |\n| \\`cleanup [--status x,y]\\` | Cleanup old topics |\n| \\`agents\\` | List agents |\n| \\`health\\` | System health |\n| \\`config\\` | Show config |\n| \\`config set <key> <value>\\` | Update config |\n| \\`adapters\\` | List adapters |\n| \\`tunnel\\` | Tunnel status |\n| \\`notify \"message\"\\` | Send notification |\n| \\`version\\` | Daemon version |\n| \\`restart\\` | Restart daemon |\n\n---\n\n## File Viewer (Tunnel)\n\nWhen tunnel is enabled, file edits and diffs get \"View\" buttons that open in your browser:\n- **Monaco Editor** — Full VS Code editor with syntax highlighting\n- **Diff viewer** — Side-by-side or inline comparison\n- **Line highlighting** — Click lines to highlight\n- Dark/light theme toggle\n\n### Setup\nEnable in config: set \\`tunnel.enabled\\` to \\`true\\`.\nProviders: Cloudflare (default, free), ngrok, bore, Tailscale Funnel.\n\n### Port Tunneling\n\nExpose any local port (dev servers, APIs, etc.) to the internet:\n\n**CLI commands** (agent can call these directly):\n- \\`openacp tunnel add <port> --label <name>\\` — Create tunnel to a local port\n- \\`openacp tunnel list\\` — List active tunnels\n- \\`openacp tunnel stop <port>\\` — Stop a tunnel\n- \\`openacp tunnel stop-all\\` — Stop all user tunnels\n\n**Telegram commands**:\n- \\`/tunnel <port> [label]\\` — Create tunnel\n- \\`/tunnels\\` — List active tunnels\n- \\`/tunnel stop <port>\\` — Stop tunnel\n\nExample: after starting a dev server on port 3000, run \\`openacp tunnel add 3000 --label my-app\\` to get a public URL.\n\n---\n\n## Configuration\n\nConfig file: \\`~/.openacp/config.json\\`\n\n### Channels\n- **channels.telegram.botToken** — Your Telegram bot token\n- **channels.telegram.chatId** — Your Telegram supergroup ID\n- **channels.discord.botToken** — Your Discord bot token\n- **channels.discord.guildId** — Your Discord server (guild) ID\n\n### Agents\n- **defaultAgent** — Which agent to use by default\n- Agents are managed via \\`/agents\\` (Telegram) or \\`openacp agents\\` (CLI)\n- Installed agents are stored in \\`~/.openacp/agents.json\\`\n- Agent list is fetched from the ACP Registry CDN and cached locally (24h)\n\n### Workspace\n- **workspace.baseDir** — Base directory for project folders (default: \\`~/openacp-workspace\\`)\n\n### Security\n- **security.allowedUserIds** — Restrict who can use the bot (empty = everyone)\n- **security.maxConcurrentSessions** — Max parallel sessions (default: 5)\n- **security.sessionTimeoutMinutes** — Auto-cancel idle sessions (default: 60)\n\n### Tunnel / File Viewer\n- **tunnel.enabled** — Enable file viewer tunnel\n- **tunnel.provider** — Tunnel provider: cloudflare (default, free), ngrok, bore, tailscale\n- **tunnel.port** — Local port for tunnel server (default: 3100)\n- **tunnel.auth.enabled** — Enable authentication for tunnel URLs\n- **tunnel.auth.token** — Auth token for tunnel access\n- **tunnel.storeTtlMinutes** — How long viewer links stay cached (default: 60)\n\n### Logging\n- **logging.level** — Log level: silent, debug, info, warn, error, fatal (default: info)\n- **logging.logDir** — Log directory (default: \\`~/.openacp/logs\\`)\n- **logging.maxFileSize** — Max log file size before rotation\n- **logging.maxFiles** — Max number of rotated log files\n- **logging.sessionLogRetentionDays** — Auto-delete old session logs (default: 30)\n\n### Data Retention\n- **sessionStore.ttlDays** — How long session records persist (default: 30). Old records are cleaned up automatically.\n\n### Environment variables\nOverride config with env vars:\n- \\`OPENACP_TELEGRAM_BOT_TOKEN\\`\n- \\`OPENACP_TELEGRAM_CHAT_ID\\`\n- \\`OPENACP_DISCORD_BOT_TOKEN\\`\n- \\`OPENACP_DISCORD_GUILD_ID\\`\n- \\`OPENACP_DEFAULT_AGENT\\`\n- \\`OPENACP_RUN_MODE\\` — foreground or daemon\n- \\`OPENACP_API_PORT\\` — API server port (default: 21420)\n- \\`OPENACP_TUNNEL_ENABLED\\`\n- \\`OPENACP_TUNNEL_PORT\\`\n- \\`OPENACP_TUNNEL_PROVIDER\\`\n- \\`OPENACP_LOG_LEVEL\\`\n- \\`OPENACP_LOG_DIR\\`\n- \\`OPENACP_DEBUG\\` — Sets log level to debug\n\n---\n\n## Troubleshooting\n\n### Session stuck / not responding\n- Check status: ask Assistant \"Is anything stuck?\"\n- Cancel and create new: \\`/cancel\\` then \\`/new\\`\n- Check system health: Assistant can run health check\n\n### Agent not found\n- Check available agents: \\`/agents\\` or \\`openacp agents\\`\n- Install missing agent: \\`openacp agents install <name>\\`\n- Some agents need login first: \\`openacp agents info <name>\\` to see setup steps\n- Run agent CLI for setup: \\`openacp agents run <name> -- <args>\\`\n\n### Permission request not showing\n- Check Notifications topic for the alert\n- Try \\`/enable_dangerous\\` to auto-approve (if you trust the agent)\n\n### Session disappeared after restart\n- Sessions persist across restarts\n- Send a message in the old topic — it auto-resumes\n- If topic was deleted, the session record may still exist in status\n\n### Bot not responding at all\n- Check daemon: \\`openacp status\\`\n- Check logs: \\`openacp logs\\`\n- Restart: \\`openacp start\\` or \\`/restart\\`\n\n### Messages going to wrong topic\n- Each session is bound to a specific topic/thread\n- If you see messages appearing in the Assistant topic instead of the session topic, try creating a new session\n\n### Viewing logs\n- Session-specific logs: \\`~/.openacp/logs/sessions/\\`\n- System logs: \\`openacp logs\\` to tail live\n- Set \\`OPENACP_DEBUG=true\\` for verbose output\n\n---\n\n## Data & Storage\n\nAll data is stored in \\`~/.openacp/\\`:\n- \\`config.json\\` — Configuration\n- \\`agents.json\\` — Installed agents (managed by AgentCatalog)\n- \\`registry-cache.json\\` — Cached ACP Registry data (refreshes every 24h)\n- \\`agents/\\` — Downloaded binary agents\n- \\`sessions/\\` — Session records and state\n- \\`topics/\\` — Topic-to-session mappings\n- \\`logs/\\` — System and session logs\n- \\`plugins/\\` — Installed adapter plugins\n- \\`openacp.pid\\` — Daemon PID file\n\nSession records auto-cleanup: 30 days (configurable via \\`sessionStore.ttlDays\\`).\nSession logs auto-cleanup: 30 days (configurable via \\`logging.sessionLogRetentionDays\\`).\n`;\n"],"mappings":"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AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;","names":[]}

package/dist/chunk-6RXVEXF3.js

@@ -0,0 +1,23 @@
+// src/plugins/discord/validators.ts
+async function validateDiscordToken(token) {
+  try {
+    const res = await fetch("https://discord.com/api/v10/users/@me", {
+      headers: { Authorization: `Bot ${token}` }
+    });
+    if (res.status === 200) {
+      const data = await res.json();
+      return { ok: true, username: data.username, id: data.id };
+    }
+    if (res.status === 401) {
+      return { ok: false, error: "Token rejected by Discord (401 Unauthorized)" };
+    }
+    return { ok: false, error: `Discord API returned ${res.status}` };
+  } catch (err) {
+    return { ok: false, error: err.message };
+  }
+}
+
+export {
+  validateDiscordToken
+};
+//# sourceMappingURL=chunk-6RXVEXF3.js.map

package/dist/chunk-6RXVEXF3.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/plugins/discord/validators.ts"],"sourcesContent":["export async function validateDiscordToken(token: string): Promise<\n  | { ok: true; username: string; id: string }\n  | { ok: false; error: string }\n> {\n  try {\n    const res = await fetch(\"https://discord.com/api/v10/users/@me\", {\n      headers: { Authorization: `Bot ${token}` },\n    });\n    if (res.status === 200) {\n      const data = (await res.json()) as { username: string; id: string };\n      return { ok: true, username: data.username, id: data.id };\n    }\n    if (res.status === 401) {\n      return { ok: false, error: \"Token rejected by Discord (401 Unauthorized)\" };\n    }\n    return { ok: false, error: `Discord API returned ${res.status}` };\n  } catch (err) {\n    return { ok: false, error: (err as Error).message };\n  }\n}\n"],"mappings":";AAAA,eAAsB,qBAAqB,OAGzC;AACA,MAAI;AACF,UAAM,MAAM,MAAM,MAAM,yCAAyC;AAAA,MAC/D,SAAS,EAAE,eAAe,OAAO,KAAK,GAAG;AAAA,IAC3C,CAAC;AACD,QAAI,IAAI,WAAW,KAAK;AACtB,YAAM,OAAQ,MAAM,IAAI,KAAK;AAC7B,aAAO,EAAE,IAAI,MAAM,UAAU,KAAK,UAAU,IAAI,KAAK,GAAG;AAAA,IAC1D;AACA,QAAI,IAAI,WAAW,KAAK;AACtB,aAAO,EAAE,IAAI,OAAO,OAAO,+CAA+C;AAAA,IAC5E;AACA,WAAO,EAAE,IAAI,OAAO,OAAO,wBAAwB,IAAI,MAAM,GAAG;AAAA,EAClE,SAAS,KAAK;AACZ,WAAO,EAAE,IAAI,OAAO,OAAQ,IAAc,QAAQ;AAAA,EACpD;AACF;","names":[]}

package/dist/{chunk-34M4OS5P.js → chunk-A6Y4GZM3.js}

@@ -1,8 +1,8 @@
 import {
   createChildLogger
-} from "./chunk-GAK6PIBW.js";
+} from "./chunk-XMMAGAT4.js";
 
-// src/core/agent-store.ts
+// src/core/agents/agent-store.ts
 import * as fs from "fs";
 import * as path from "path";
 import * as os from "os";
@@ -80,4 +80,4 @@ var AgentStore = class {
 export {
   AgentStore
 };
-//# sourceMappingURL=chunk-34M4OS5P.js.map
+//# sourceMappingURL=chunk-A6Y4GZM3.js.map

package/dist/chunk-A6Y4GZM3.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/core/agents/agent-store.ts"],"sourcesContent":["import * as fs from \"node:fs\";\nimport * as path from \"node:path\";\nimport * as os from \"node:os\";\nimport { z } from \"zod\";\nimport type { InstalledAgent } from \"../types.js\";\nimport { createChildLogger } from \"../utils/log.js\";\n\nconst log = createChildLogger({ module: \"agent-store\" });\n\nconst InstalledAgentSchema = z.object({\n  registryId: z.string().nullable(),\n  name: z.string(),\n  version: z.string(),\n  distribution: z.enum([\"npx\", \"uvx\", \"binary\", \"custom\"]),\n  command: z.string(),\n  args: z.array(z.string()).default([]),\n  env: z.record(z.string(), z.string()).default({}),\n  workingDirectory: z.string().optional(),\n  installedAt: z.string(),\n  binaryPath: z.string().nullable().default(null),\n});\n\nconst AgentStoreSchema = z.object({\n  version: z.number().default(1),\n  installed: z.record(z.string(), InstalledAgentSchema).default({}),\n});\n\ntype AgentStoreData = z.infer<typeof AgentStoreSchema>;\n\nexport class AgentStore {\n  private data: AgentStoreData = { version: 1, installed: {} };\n  private filePath: string;\n\n  constructor(filePath?: string) {\n    this.filePath = filePath ?? path.join(os.homedir(), \".openacp\", \"agents.json\");\n  }\n\n  load(): void {\n    fs.mkdirSync(path.dirname(this.filePath), { recursive: true });\n\n    if (!fs.existsSync(this.filePath)) {\n      this.data = { version: 1, installed: {} };\n      return;\n    }\n\n    try {\n      const raw = JSON.parse(fs.readFileSync(this.filePath, \"utf-8\") as string);\n      const result = AgentStoreSchema.safeParse(raw);\n      if (result.success) {\n        this.data = result.data;\n      } else {\n        log.warn({ errors: result.error.issues }, \"Invalid agents.json, starting fresh\");\n        this.data = { version: 1, installed: {} };\n      }\n    } catch (err) {\n      log.warn({ err }, \"Failed to read agents.json, starting fresh\");\n      this.data = { version: 1, installed: {} };\n    }\n  }\n\n  exists(): boolean {\n    return fs.existsSync(this.filePath);\n  }\n\n  getInstalled(): Record<string, InstalledAgent> {\n    return this.data.installed;\n  }\n\n  getAgent(key: string): InstalledAgent | undefined {\n    return this.data.installed[key];\n  }\n\n  addAgent(key: string, agent: InstalledAgent): void {\n    this.data.installed[key] = agent;\n    this.save();\n  }\n\n  removeAgent(key: string): void {\n    delete this.data.installed[key];\n    this.save();\n  }\n\n  hasAgent(key: string): boolean {\n    return key in this.data.installed;\n  }\n\n  private save(): void {\n    const tmpPath = this.filePath + \".tmp\";\n    fs.writeFileSync(tmpPath, JSON.stringify(this.data, null, 2));\n    fs.renameSync(tmpPath, this.filePath);\n  }\n}\n"],"mappings":";;;;;AAAA,YAAY,QAAQ;AACpB,YAAY,UAAU;AACtB,YAAY,QAAQ;AACpB,SAAS,SAAS;AAIlB,IAAM,MAAM,kBAAkB,EAAE,QAAQ,cAAc,CAAC;AAEvD,IAAM,uBAAuB,EAAE,OAAO;AAAA,EACpC,YAAY,EAAE,OAAO,EAAE,SAAS;AAAA,EAChC,MAAM,EAAE,OAAO;AAAA,EACf,SAAS,EAAE,OAAO;AAAA,EAClB,cAAc,EAAE,KAAK,CAAC,OAAO,OAAO,UAAU,QAAQ,CAAC;AAAA,EACvD,SAAS,EAAE,OAAO;AAAA,EAClB,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,CAAC,CAAC;AAAA,EACpC,KAAK,EAAE,OAAO,EAAE,OAAO,GAAG,EAAE,OAAO,CAAC,EAAE,QAAQ,CAAC,CAAC;AAAA,EAChD,kBAAkB,EAAE,OAAO,EAAE,SAAS;AAAA,EACtC,aAAa,EAAE,OAAO;AAAA,EACtB,YAAY,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,IAAI;AAChD,CAAC;AAED,IAAM,mBAAmB,EAAE,OAAO;AAAA,EAChC,SAAS,EAAE,OAAO,EAAE,QAAQ,CAAC;AAAA,EAC7B,WAAW,EAAE,OAAO,EAAE,OAAO,GAAG,oBAAoB,EAAE,QAAQ,CAAC,CAAC;AAClE,CAAC;AAIM,IAAM,aAAN,MAAiB;AAAA,EACd,OAAuB,EAAE,SAAS,GAAG,WAAW,CAAC,EAAE;AAAA,EACnD;AAAA,EAER,YAAY,UAAmB;AAC7B,SAAK,WAAW,YAAiB,UAAQ,WAAQ,GAAG,YAAY,aAAa;AAAA,EAC/E;AAAA,EAEA,OAAa;AACX,IAAG,aAAe,aAAQ,KAAK,QAAQ,GAAG,EAAE,WAAW,KAAK,CAAC;AAE7D,QAAI,CAAI,cAAW,KAAK,QAAQ,GAAG;AACjC,WAAK,OAAO,EAAE,SAAS,GAAG,WAAW,CAAC,EAAE;AACxC;AAAA,IACF;AAEA,QAAI;AACF,YAAM,MAAM,KAAK,MAAS,gBAAa,KAAK,UAAU,OAAO,CAAW;AACxE,YAAM,SAAS,iBAAiB,UAAU,GAAG;AAC7C,UAAI,OAAO,SAAS;AAClB,aAAK,OAAO,OAAO;AAAA,MACrB,OAAO;AACL,YAAI,KAAK,EAAE,QAAQ,OAAO,MAAM,OAAO,GAAG,qCAAqC;AAC/E,aAAK,OAAO,EAAE,SAAS,GAAG,WAAW,CAAC,EAAE;AAAA,MAC1C;AAAA,IACF,SAAS,KAAK;AACZ,UAAI,KAAK,EAAE,IAAI,GAAG,4CAA4C;AAC9D,WAAK,OAAO,EAAE,SAAS,GAAG,WAAW,CAAC,EAAE;AAAA,IAC1C;AAAA,EACF;AAAA,EAEA,SAAkB;AAChB,WAAU,cAAW,KAAK,QAAQ;AAAA,EACpC;AAAA,EAEA,eAA+C;AAC7C,WAAO,KAAK,KAAK;AAAA,EACnB;AAAA,EAEA,SAAS,KAAyC;AAChD,WAAO,KAAK,KAAK,UAAU,GAAG;AAAA,EAChC;AAAA,EAEA,SAAS,KAAa,OAA6B;AACjD,SAAK,KAAK,UAAU,GAAG,IAAI;AAC3B,SAAK,KAAK;AAAA,EACZ;AAAA,EAEA,YAAY,KAAmB;AAC7B,WAAO,KAAK,KAAK,UAAU,GAAG;AAC9B,SAAK,KAAK;AAAA,EACZ;AAAA,EAEA,SAAS,KAAsB;AAC7B,WAAO,OAAO,KAAK,KAAK;AAAA,EAC1B;AAAA,EAEQ,OAAa;AACnB,UAAM,UAAU,KAAK,WAAW;AAChC,IAAG,iBAAc,SAAS,KAAK,UAAU,KAAK,MAAM,MAAM,CAAC,CAAC;AAC5D,IAAG,cAAW,SAAS,KAAK,QAAQ;AAAA,EACtC;AACF;","names":[]}