@farazirfan/costar-server-executor 1.7.37 → 1.7.39

package/dist/subagent/registry.js

@@ -0,0 +1,180 @@
+/**
+ * CoStar Server Executor - Subagent Registry
+ * Ported from OpenClaw's agents/subagent-registry.ts
+ *
+ * Differences from OpenClaw:
+ * - In-memory only (no disk persistence, no Supabase) — subagent runs are ephemeral
+ * - No gateway event listener (uses Promise completion instead)
+ * - No announce retry queue (single injectIsolatedResult call)
+ * - AbortController stored on each record for kill support
+ * - No multi-agent routing (single agent per user)
+ *
+ * Matched with OpenClaw:
+ * - Same SubagentRunRecord concept (simplified fields)
+ * - Same query functions (listRunsForRequester, countActiveRunsForSession)
+ * - Same target resolution (index, runId prefix, label)
+ * - Same archive cleanup (60 min default)
+ * - Same markTerminated pattern
+ */
+// ---------- constants (from OpenClaw subagent-registry.ts:46-59) ----------
+/** Archive window — clean up completed records older than this */
+const ARCHIVE_AFTER_MS = 60 * 60 * 1000; // 60 minutes
+// ---------- module-level state ----------
+const subagentRuns = new Map();
+// ---------- registry functions ----------
+/**
+ * Register a new subagent run in the registry.
+ * (OpenClaw: subagent-registry.ts:507-552)
+ */
+export function registerSubagentRun(record) {
+    subagentRuns.set(record.runId, record);
+    console.log(`[SUBAGENT-REGISTRY] Registered run ${record.runId}${record.label ? ` (${record.label})` : ""} — task: ${record.task.slice(0, 80)}`);
+}
+/**
+ * Mark a run as completed/failed/timeout with outcome details.
+ */
+export function completeRun(runId, result) {
+    const entry = subagentRuns.get(runId);
+    if (!entry) {
+        console.warn(`[SUBAGENT-REGISTRY] completeRun: run not found: ${runId}`);
+        return;
+    }
+    entry.status = result.status;
+    entry.completedAt = Date.now();
+    entry.outcome = result.outcome;
+    entry.error = result.error;
+    entry.durationMs = result.durationMs;
+    entry.inputTokens = result.inputTokens;
+    entry.outputTokens = result.outputTokens;
+    console.log(`[SUBAGENT-REGISTRY] Run ${runId} ${result.status}${result.error ? `: ${result.error.slice(0, 100)}` : ""}`);
+}
+/**
+ * Count active (status === "running") runs for a requester session.
+ * (OpenClaw: subagent-registry.ts:766-782)
+ */
+export function countActiveRunsForSession(requesterSessionKey) {
+    const key = requesterSessionKey.trim();
+    if (!key)
+        return 0;
+    let count = 0;
+    for (const entry of subagentRuns.values()) {
+        if (entry.requesterSessionKey !== key)
+            continue;
+        if (entry.status === "running") {
+            count += 1;
+        }
+    }
+    return count;
+}
+/**
+ * List all runs (active + recent) for a requester, sorted by startedAt desc.
+ * (OpenClaw: subagent-registry.ts:758-764)
+ */
+export function listRunsForRequester(requesterSessionKey) {
+    const key = requesterSessionKey.trim();
+    if (!key)
+        return [];
+    // Opportunistic cleanup
+    cleanupArchive();
+    return [...subagentRuns.values()]
+        .filter((entry) => entry.requesterSessionKey === key)
+        .sort((a, b) => b.startedAt - a.startedAt);
+}
+/**
+ * Get a run by ID.
+ */
+export function getRunById(runId) {
+    return subagentRuns.get(runId);
+}
+/**
+ * Resolve a target to a SubagentRunRecord.
+ * Accepts: 1-based index (from active list), runId prefix, or label.
+ * (Ported from OpenClaw subagents-tool.ts:130-150)
+ */
+export function resolveTarget(requesterSessionKey, target) {
+    const runs = listRunsForRequester(requesterSessionKey);
+    const activeRuns = runs.filter((r) => r.status === "running");
+    // Try "all" — special case handled by caller
+    if (target === "all" || target === "*") {
+        return undefined; // Caller handles "all"
+    }
+    // Try as 1-based index into active list
+    const index = Number(target);
+    if (Number.isInteger(index) && index >= 1 && index <= activeRuns.length) {
+        return activeRuns[index - 1];
+    }
+    // Try as runId prefix
+    const byRunId = runs.find((r) => r.runId.startsWith(target));
+    if (byRunId)
+        return byRunId;
+    // Try as label (case-insensitive, most recent first — already sorted)
+    const lowerTarget = target.toLowerCase();
+    const byLabel = runs.find((r) => r.label?.toLowerCase() === lowerTarget ||
+        r.label?.toLowerCase().startsWith(lowerTarget));
+    if (byLabel)
+        return byLabel;
+    return undefined;
+}
+/**
+ * Kill a running subagent by aborting its AbortController.
+ * (OpenClaw: subagent-registry.ts:716-756 markSubagentRunTerminated)
+ */
+export function killRun(runId) {
+    const entry = subagentRuns.get(runId);
+    if (!entry)
+        return false;
+    if (entry.status !== "running")
+        return false;
+    entry.abortController.abort();
+    entry.status = "killed";
+    entry.completedAt = Date.now();
+    entry.durationMs = entry.completedAt - entry.startedAt;
+    entry.error = "killed";
+    console.log(`[SUBAGENT-REGISTRY] Killed run ${runId}${entry.label ? ` (${entry.label})` : ""}`);
+    return true;
+}
+/**
+ * Kill all active runs for a requester session.
+ * Returns count of killed runs and their labels.
+ */
+export function killAllForSession(requesterSessionKey) {
+    const runs = listRunsForRequester(requesterSessionKey);
+    const activeRuns = runs.filter((r) => r.status === "running");
+    const labels = [];
+    for (const run of activeRuns) {
+        killRun(run.runId);
+        labels.push(run.label || run.runId.slice(0, 8));
+    }
+    return { killed: activeRuns.length, labels };
+}
+/**
+ * Remove completed/failed/killed records older than ARCHIVE_AFTER_MS.
+ * Called opportunistically on list/spawn operations.
+ * (OpenClaw: sweeper pattern from subagent-registry.ts)
+ */
+export function cleanupArchive() {
+    const cutoff = Date.now() - ARCHIVE_AFTER_MS;
+    for (const [runId, entry] of subagentRuns) {
+        if (entry.status !== "running" && entry.completedAt && entry.completedAt < cutoff) {
+            subagentRuns.delete(runId);
+        }
+    }
+}
+/**
+ * Format duration in short human-readable form.
+ * (OpenClaw: subagent-announce.ts formatDurationShort)
+ */
+export function formatRunDuration(startedAt, completedAt) {
+    const endMs = completedAt ?? Date.now();
+    const ms = Math.max(0, endMs - startedAt);
+    const totalSeconds = Math.round(ms / 1000);
+    const hours = Math.floor(totalSeconds / 3600);
+    const minutes = Math.floor((totalSeconds % 3600) / 60);
+    const seconds = totalSeconds % 60;
+    if (hours > 0)
+        return `${hours}h${minutes}m`;
+    if (minutes > 0)
+        return `${minutes}m${seconds}s`;
+    return `${seconds}s`;
+}
+//# sourceMappingURL=registry.js.map

package/dist/subagent/registry.js.map

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

package/dist/tools/complete-turn.d.ts

@@ -15,12 +15,12 @@ export type TurnSummary = {
 };
 /**
  * Get the last turn summary (called by heartbeat runner after the turn).
- * Returns null if the LLM never called complete_turn.
+ * Returns null if the LLM never called complete_task.
  */
 export declare function getLastTurnSummary(): TurnSummary | null;
 /**
  * Clear the turn summary (called before each new turn to reset state).
  */
 export declare function clearTurnSummary(): void;
-export declare function createCompleteTurnTool(): AnyAgentTool;
+export declare function createCompleteTaskTool(): AnyAgentTool;
 //# sourceMappingURL=complete-turn.d.ts.map

package/dist/tools/complete-turn.js

@@ -10,11 +10,11 @@
  */
 import { Type } from "@sinclair/typebox";
 import { jsonResult } from "../utils/tool-helpers.js";
-/** Stores the most recent complete_turn call data */
+/** Stores the most recent complete_task call data */
 let _lastTurnSummary = null;
 /**
  * Get the last turn summary (called by heartbeat runner after the turn).
- * Returns null if the LLM never called complete_turn.
+ * Returns null if the LLM never called complete_task.
  */
 export function getLastTurnSummary() {
     return _lastTurnSummary;
@@ -28,7 +28,7 @@ export function clearTurnSummary() {
 // ═══════════════════════════════════════════════════
 // TOOL DEFINITION
 // ═══════════════════════════════════════════════════
-const CompleteTurnSchema = Type.Object({
+const CompleteTaskSchema = Type.Object({
     title: Type.String({
         description: "Short title (5-10 words) describing what you did. Example: 'Email check and Bitcoin price monitoring'",
     }),
@@ -36,19 +36,19 @@ const CompleteTurnSchema = Type.Object({
         description: "Thorough account of what happened — write naturally, like telling a colleague what happened while they were away. This is the only record of your work.",
     }),
 });
-export function createCompleteTurnTool() {
+export function createCompleteTaskTool() {
     return {
-        label: "Complete Turn",
-        name: "complete_turn",
-        description: "Call this as your LAST tool call in every turn to log what you did. Provide a short title and a thorough summary. This is the only record of your work — stored for future recall by both executors. Write naturally, no technical terms.",
-        parameters: CompleteTurnSchema,
+        label: "Complete Task",
+        name: "complete_task",
+        description: "Call this as your LAST tool call in every turn to log what you did. Provide a short title and a thorough summary. This is the only record of your work — stored for future recall. Write naturally, no technical terms.",
+        parameters: CompleteTaskSchema,
         execute: async (_toolCallId, params) => {
             const title = params.title?.trim() || "Untitled turn";
             const summary = params.summary?.trim() || "No summary provided.";
             // Store for the runner to pick up
             _lastTurnSummary = { title, summary };
-            console.log(`[COMPLETE_TURN] Title: ${title}`);
-            console.log(`[COMPLETE_TURN] Summary: ${summary.slice(0, 200)}`);
+            console.log(`[COMPLETE_TASK] Title: ${title}`);
+            console.log(`[COMPLETE_TASK] Summary: ${summary.slice(0, 200)}`);
             return jsonResult({
                 status: "logged",
                 title,

package/dist/tools/complete-turn.js.map

@@ -1 +1 @@
-{"version":3,"file":"complete-turn.js","sourceRoot":"","sources":["../../src/tools/complete-turn.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAEzC,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAWtD,qDAAqD;AACrD,IAAI,gBAAgB,GAAuB,IAAI,CAAC;AAEhD;;;GAGG;AACH,MAAM,UAAU,kBAAkB;IAChC,OAAO,gBAAgB,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB;IAC9B,gBAAgB,GAAG,IAAI,CAAC;AAC1B,CAAC;AAED,sDAAsD;AACtD,kBAAkB;AAClB,sDAAsD;AAEtD,MAAM,kBAAkB,GAAG,IAAI,CAAC,MAAM,CAAC;IACrC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC;QACjB,WAAW,EACT,uGAAuG;KAC1G,CAAC;IACF,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC;QACnB,WAAW,EACT,yJAAyJ;KAC5J,CAAC;CACH,CAAC,CAAC;AAEH,MAAM,UAAU,sBAAsB;IACpC,OAAO;QACL,KAAK,EAAE,eAAe;QACtB,IAAI,EAAE,eAAe;QACrB,WAAW,EACT,2OAA2O;QAC7O,UAAU,EAAE,kBAAkB;QAC9B,OAAO,EAAE,KAAK,EAAE,WAAmB,EAAE,MAA+B,EAAE,EAAE;YACtE,MAAM,KAAK,GAAI,MAAM,CAAC,KAAgB,EAAE,IAAI,EAAE,IAAI,eAAe,CAAC;YAClE,MAAM,OAAO,GAAI,MAAM,CAAC,OAAkB,EAAE,IAAI,EAAE,IAAI,sBAAsB,CAAC;YAE7E,kCAAkC;YAClC,gBAAgB,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;YAEtC,OAAO,CAAC,GAAG,CAAC,0BAA0B,KAAK,EAAE,CAAC,CAAC;YAC/C,OAAO,CAAC,GAAG,CAAC,4BAA4B,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;YAEjE,OAAO,UAAU,CAAC;gBAChB,MAAM,EAAE,QAAQ;gBAChB,KAAK;gBACL,OAAO,EAAE,OAAO,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,OAAO;aACxE,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"complete-turn.js","sourceRoot":"","sources":["../../src/tools/complete-turn.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAEzC,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAWtD,qDAAqD;AACrD,IAAI,gBAAgB,GAAuB,IAAI,CAAC;AAEhD;;;GAGG;AACH,MAAM,UAAU,kBAAkB;IAChC,OAAO,gBAAgB,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB;IAC9B,gBAAgB,GAAG,IAAI,CAAC;AAC1B,CAAC;AAED,sDAAsD;AACtD,kBAAkB;AAClB,sDAAsD;AAEtD,MAAM,kBAAkB,GAAG,IAAI,CAAC,MAAM,CAAC;IACrC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC;QACjB,WAAW,EACT,uGAAuG;KAC1G,CAAC;IACF,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC;QACnB,WAAW,EACT,yJAAyJ;KAC5J,CAAC;CACH,CAAC,CAAC;AAEH,MAAM,UAAU,sBAAsB;IACpC,OAAO;QACL,KAAK,EAAE,eAAe;QACtB,IAAI,EAAE,eAAe;QACrB,WAAW,EACT,yNAAyN;QAC3N,UAAU,EAAE,kBAAkB;QAC9B,OAAO,EAAE,KAAK,EAAE,WAAmB,EAAE,MAA+B,EAAE,EAAE;YACtE,MAAM,KAAK,GAAI,MAAM,CAAC,KAAgB,EAAE,IAAI,EAAE,IAAI,eAAe,CAAC;YAClE,MAAM,OAAO,GAAI,MAAM,CAAC,OAAkB,EAAE,IAAI,EAAE,IAAI,sBAAsB,CAAC;YAE7E,kCAAkC;YAClC,gBAAgB,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;YAEtC,OAAO,CAAC,GAAG,CAAC,0BAA0B,KAAK,EAAE,CAAC,CAAC;YAC/C,OAAO,CAAC,GAAG,CAAC,4BAA4B,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;YAEjE,OAAO,UAAU,CAAC;gBAChB,MAAM,EAAE,QAAQ;gBAChB,KAAK;gBACL,OAAO,EAAE,OAAO,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,OAAO;aACxE,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/contacts.d.ts

@@ -0,0 +1,13 @@
+/**
+ * CoStar Server Executor - Contacts Search Tool
+ *
+ * Search user's contacts via Asterizk API.
+ * Endpoint: POST /samantha/api/v1/contacts/search/{userEmail}
+ *
+ * Returns contacts with name, email, phone, WhatsApp JID.
+ * Use this tool BEFORE making phone calls or sending WhatsApp messages
+ * to get the correct phone number or JID.
+ */
+import type { AnyAgentTool } from "../types/tool.js";
+export declare function createContactsSearchTool(): AnyAgentTool;
+//# sourceMappingURL=contacts.d.ts.map

package/dist/tools/contacts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contacts.d.ts","sourceRoot":"","sources":["../../src/tools/contacts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AA6BrD,wBAAgB,wBAAwB,IAAI,YAAY,CA4DvD"}

package/dist/tools/contacts.js

@@ -0,0 +1,80 @@
+/**
+ * CoStar Server Executor - Contacts Search Tool
+ *
+ * Search user's contacts via Asterizk API.
+ * Endpoint: POST /samantha/api/v1/contacts/search/{userEmail}
+ *
+ * Returns contacts with name, email, phone, WhatsApp JID.
+ * Use this tool BEFORE making phone calls or sending WhatsApp messages
+ * to get the correct phone number or JID.
+ */
+import { Type } from "@sinclair/typebox";
+import { jsonResult, readStringParam } from "../utils/tool-helpers.js";
+import { getUserEmail, asterizkFetch, handleAsterizkApiError } from "../utils/asterizk-auth.js";
+const ContactsSearchSchema = Type.Object({
+    q: Type.Optional(Type.String({ description: "General search query (searches across name, email, phone)." })),
+    name: Type.Optional(Type.String({ description: "Filter by contact name." })),
+    email: Type.Optional(Type.String({ description: "Filter by email address." })),
+    phone: Type.Optional(Type.String({ description: "Filter by phone number." })),
+    contact_type: Type.Optional(Type.Union([
+        Type.Literal("email"),
+        Type.Literal("whatsapp"),
+        Type.Literal("phonebook"),
+    ], { description: "Filter by contact type. Optional." })),
+});
+export function createContactsSearchTool() {
+    return {
+        name: "contacts_search",
+        label: "Search Contacts",
+        description: "Search the user's contacts by name, email, phone number, or general query. Returns contact details including WhatsApp JID and phone numbers. Always search contacts before making calls or sending WhatsApp messages to get the correct number.",
+        parameters: ContactsSearchSchema,
+        execute: async (_toolCallId, params) => {
+            const q = readStringParam(params, "q");
+            const name = readStringParam(params, "name");
+            const email = readStringParam(params, "email");
+            const phone = readStringParam(params, "phone");
+            const contactType = readStringParam(params, "contact_type");
+            try {
+                const userEmail = getUserEmail();
+                console.log(`[CONTACTS] Searching contacts for ${userEmail} (q: "${q || name || email || phone}")`);
+                const body = {};
+                if (q)
+                    body.q = q;
+                if (name)
+                    body.name = name;
+                if (email)
+                    body.email = email;
+                if (phone)
+                    body.phone = phone;
+                if (contactType)
+                    body.contact_type = contactType;
+                const response = await asterizkFetch(`/samantha/api/v1/contacts/search/${encodeURIComponent(userEmail)}`, { body });
+                if (!response.ok) {
+                    const errText = await response.text();
+                    throw new Error(`Contacts search failed (${response.status}): ${errText}`);
+                }
+                const data = await response.json();
+                // Flatten grouped contacts for easier consumption
+                const contacts = Array.isArray(data) ? data : (data.contacts || data.results || []);
+                const flattened = contacts.map((c) => ({
+                    name: c.name,
+                    email: c.email || null,
+                    phone: c.phone_number || c.phone || null,
+                    whatsapp_jid: c.whatsapp_jid || null,
+                    contact_type: c.contact_type || null,
+                }));
+                console.log(`[CONTACTS] Found ${flattened.length} contacts`);
+                return jsonResult({
+                    query: q || name || email || phone || "(all)",
+                    count: flattened.length,
+                    contacts: flattened,
+                });
+            }
+            catch (error) {
+                console.error(`[CONTACTS] Error:`, error);
+                return jsonResult(handleAsterizkApiError(error, "contacts_search"));
+            }
+        },
+    };
+}
+//# sourceMappingURL=contacts.js.map

package/dist/tools/contacts.js.map

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

package/dist/tools/cron.d.ts

@@ -1,7 +1,22 @@
 /**
  * CoStar Server Executor - Cron Tool
- * Cloned from OpenClaw's agents/tools/cron-tool.ts
- * Adapted for Supabase-backed storage instead of gateway RPC
+ * Ported from OpenClaw's agents/tools/cron-tool.ts
+ *
+ * Differences from OpenClaw:
+ * - Uses Supabase-backed storage instead of gateway RPC
+ * - Flat schema (snake_case fields) instead of nested job/payload/schedule objects
+ * - No delivery system (CoStar uses agent.injectIsolatedResult instead)
+ * - No agentId/sessionKey per job (CoStar uses user_id with single agent)
+ * - No contextMessages (no gateway chat.history endpoint)
+ *
+ * Matched with OpenClaw:
+ * - Same actions: status, list, add, update, remove, run, runs, wake
+ * - Same schedule types: at, every, cron
+ * - Same session targets: main, isolated
+ * - Same wake modes: now, next-heartbeat
+ * - Same normalization (schedule coercion, field inference, defaults)
+ * - Same runMode (due/force) for manual triggers
+ * - Flat-params recovery for non-frontier models
  */
 import type { AnyAgentTool } from "../types/tool.js";
 export type CronToolDeps = {

package/dist/tools/cron.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cron.d.ts","sourceRoot":"","sources":["../../src/tools/cron.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AA8CrD,MAAM,MAAM,YAAY,GAAG;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,kBAAkB,CAAC,EAAE,MAAM;QAAE,SAAS,EAAE,OAAO,CAAC;QAAC,WAAW,EAAE,OAAO,CAAC;QAAC,WAAW,EAAE,IAAI,GAAG,IAAI,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC;IACxH,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,KAAK,GAAG,gBAAgB,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IACjF,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACnD,CAAC;AAIF,wBAAgB,cAAc,CAAC,IAAI,EAAE,YAAY,GAAG,YAAY,CAiQ/D"}
+{"version":3,"file":"cron.d.ts","sourceRoot":"","sources":["../../src/tools/cron.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAkDrD,MAAM,MAAM,YAAY,GAAG;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,kBAAkB,CAAC,EAAE,MAAM;QAAE,SAAS,EAAE,OAAO,CAAC;QAAC,WAAW,EAAE,OAAO,CAAC;QAAC,WAAW,EAAE,IAAI,GAAG,IAAI,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC;IACxH,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,KAAK,GAAG,gBAAgB,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IACjF,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACnD,CAAC;AA2BF,wBAAgB,cAAc,CAAC,IAAI,EAAE,YAAY,GAAG,YAAY,CAgT/D"}