@farazirfan/costar-server-executor 1.7.37 → 1.7.39

package/dist/tools/index.js

@@ -1,7 +1,7 @@
 /**
  * CoStar Server Executor - Tools Index
  *
- * Central export point for all 29 core tools (28 original + cron)
+ * Central export point for all core tools
  */
 import { readTool, writeTool, editTool, bashTool } from "@mariozechner/pi-coding-agent";
 import { createExecTool, execTool } from "./exec.js";
@@ -18,7 +18,15 @@ import { createGetCalendarEventsTool, createCreateCalendarEventTool, createUpdat
 import { createGenerateImageTool } from "./generate-image.js";
 import { createDiscoverDataApiTool, createFetchApiDataTool } from "./fetch-api-data.js";
 import { createCronTool } from "./cron.js";
-import { createCompleteTurnTool } from "./complete-turn.js";
+import { createCompleteTaskTool } from "./complete-turn.js";
+import { createSessionsSpawnTool } from "./sessions-spawn.js";
+import { createSubagentsTool } from "./subagents.js";
+import { createPhoneCallTool } from "./phone-call.js";
+import { createWhatsAppTool } from "./whatsapp.js";
+import { createContactsSearchTool } from "./contacts.js";
+import { createSpotifyTool } from "./spotify.js";
+import { createYouTubeTool } from "./youtube.js";
+import { createGoogleMapsTool } from "./google-maps.js";
 // Re-export individual tool creators and types
 export { 
 // File Operations
@@ -43,25 +51,33 @@ createGetCalendarEventsTool, createCreateCalendarEventTool, createUpdateCalendar
 createDiscoverDataApiTool, createFetchApiDataTool, 
 // Cron (OpenClaw)
 createCronTool, 
-// Turn completion
-createCompleteTurnTool, };
+// Task completion
+createCompleteTaskTool, 
+// Sub-agent spawning (OpenClaw)
+createSessionsSpawnTool, createSubagentsTool, 
+// Communication (phone, WhatsApp, contacts)
+createPhoneCallTool, createWhatsAppTool, createContactsSearchTool, 
+// Media & Services
+createSpotifyTool, createYouTubeTool, createGoogleMapsTool, };
 /**
- * Get all 30 core tools
+ * Get all core tools
  *
  * Tool breakdown:
  * - File Operations (4): read, write, edit, bash
  * - Execution (2): exec, process
  * - Web (3): web_search, web_fetch, browser
  * - Memory (2): memory_search, memory_get
- * - Communication (1): message
+ * - Communication (4): message, phone_call, whatsapp, contacts_search
  * - Media (2): image, generate_image
- * - System (2): session_status, complete_turn
+ * - System (2): session_status, complete_task
  * - Email (4): search_emails, send_email, read_email, read_email_thread
  * - Calendar (4): get_calendar_events, create_calendar_event, update_calendar_event, delete_calendar_event
  * - Data API (2): discover_data_api, fetch_api_data (matches client executor)
+ * - Services (3): spotify, youtube, google_maps
  * - Scheduling (1): cron (OpenClaw-compatible)
+ * - Sub-agents (2): sessions_spawn, subagents (OpenClaw-compatible, conditional on deps)
  */
-export function getAllTools(cronDeps) {
+export function getAllTools(cronDeps, subagentDeps) {
     const tools = [
         // File Operations (4)
         readTool,
@@ -85,7 +101,7 @@ export function getAllTools(cronDeps) {
         createGenerateImageTool(),
         // System (2)
         createSessionStatusTool(),
-        createCompleteTurnTool(),
+        createCompleteTaskTool(),
         // Email (4)
         createSearchEmailsTool(),
         createSendEmailTool(),
@@ -99,11 +115,26 @@ export function getAllTools(cronDeps) {
         // Data API (2) — discovery + execution, matches client executor
         createDiscoverDataApiTool(),
         createFetchApiDataTool(),
+        // Communication (3) — phone, WhatsApp, contacts
+        createPhoneCallTool(),
+        createWhatsAppTool(),
+        createContactsSearchTool(),
+        // Services (3) — Spotify, YouTube, Google Maps
+        createSpotifyTool(),
+        createYouTubeTool(),
+        createGoogleMapsTool(),
     ];
     // Cron tool (1) - OpenClaw-compatible, requires deps for scheduler/heartbeat integration
     if (cronDeps) {
         tools.push(createCronTool(cronDeps));
     }
+    // Sub-agent tools (2) - OpenClaw-compatible, requires deps for agent reference
+    // Only added to main sessions; sub-agent sessions are called without subagentDeps
+    // to enforce depth limits (sub-agents cannot spawn their own sub-agents).
+    if (subagentDeps) {
+        tools.push(createSessionsSpawnTool(subagentDeps));
+        tools.push(createSubagentsTool(subagentDeps));
+    }
     return tools;
 }
 //# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

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

package/dist/tools/phone-call.d.ts

@@ -0,0 +1,11 @@
+/**
+ * CoStar Server Executor - Phone Call Tool
+ *
+ * Make phone calls via VAPI (background AI-powered calls).
+ * Uses the Asterizk API endpoint /email/vapi/manage.
+ *
+ * Operations: make_call, check_status, get_report, list_calls
+ */
+import type { AnyAgentTool } from "../types/tool.js";
+export declare function createPhoneCallTool(): AnyAgentTool;
+//# sourceMappingURL=phone-call.d.ts.map

package/dist/tools/phone-call.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"phone-call.d.ts","sourceRoot":"","sources":["../../src/tools/phone-call.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AA2DrD,wBAAgB,mBAAmB,IAAI,YAAY,CAuHlD"}

package/dist/tools/phone-call.js

@@ -0,0 +1,151 @@
+/**
+ * CoStar Server Executor - Phone Call Tool
+ *
+ * Make phone calls via VAPI (background AI-powered calls).
+ * Uses the Asterizk API endpoint /email/vapi/manage.
+ *
+ * Operations: make_call, check_status, get_report, list_calls
+ */
+import { Type } from "@sinclair/typebox";
+import { jsonResult, readStringParam, readNumberParam } from "../utils/tool-helpers.js";
+import { asterizkFetch, handleAsterizkApiError } from "../utils/asterizk-auth.js";
+const PhoneCallSchema = Type.Object({
+    operation: Type.Union([
+        Type.Literal("make_call"),
+        Type.Literal("check_status"),
+        Type.Literal("get_report"),
+        Type.Literal("list_calls"),
+    ], {
+        description: "Operation to perform: make_call (initiate a call), check_status (check call progress), get_report (get transcript/report), list_calls (list recent calls)",
+    }),
+    phone_number: Type.Optional(Type.String({
+        description: "Phone number to call in international format (e.g., +1234567890). Required for make_call.",
+    })),
+    message: Type.Optional(Type.String({
+        description: "Instructions for the AI call agent — what to say, information to gather, actions to take. Required for make_call.",
+    })),
+    call_id: Type.Optional(Type.String({
+        description: "Call ID to check status or get report for. Required for check_status and get_report.",
+    })),
+    query: Type.Optional(Type.String({ description: "Search query to filter calls. Used with list_calls." })),
+    limit: Type.Optional(Type.Number({ description: "Maximum number of calls to return. Used with list_calls. Default: 10." })),
+});
+/**
+ * Clean phone number: strip non-digits except +, convert 00 prefix to +
+ */
+function cleanPhoneNumber(raw) {
+    let cleaned = raw.trim();
+    // Convert 00 international prefix to +
+    if (cleaned.startsWith("00")) {
+        cleaned = "+" + cleaned.slice(2);
+    }
+    // Strip everything except digits and +
+    cleaned = cleaned.replace(/[^\d+]/g, "");
+    // Ensure + prefix
+    if (!cleaned.startsWith("+")) {
+        cleaned = "+" + cleaned;
+    }
+    return cleaned;
+}
+export function createPhoneCallTool() {
+    return {
+        name: "phone_call",
+        label: "Phone Call",
+        description: "Make and manage phone calls via AI assistant. Operations: make_call (place a background AI call with instructions), check_status (check call progress), get_report (get transcript/report), list_calls (list recent calls). Always search contacts first to get the correct phone number before calling.",
+        parameters: PhoneCallSchema,
+        execute: async (_toolCallId, params) => {
+            const operation = readStringParam(params, "operation", { required: true });
+            try {
+                switch (operation) {
+                    case "make_call": {
+                        const rawPhone = readStringParam(params, "phone_number", { required: true });
+                        const message = readStringParam(params, "message", { required: true });
+                        const phoneNumber = cleanPhoneNumber(rawPhone);
+                        console.log(`[PHONE] Making call to ${phoneNumber}`);
+                        const response = await asterizkFetch("/email/vapi/manage", {
+                            body: {
+                                operation: "make_vapi_call",
+                                phone_number: phoneNumber,
+                                call_description: message,
+                                timezone: process.env.USER_TIMEZONE || "UTC",
+                            },
+                        });
+                        if (!response.ok) {
+                            const errText = await response.text();
+                            throw new Error(`VAPI call failed (${response.status}): ${errText}`);
+                        }
+                        const data = await response.json();
+                        console.log(`[PHONE] Call initiated: ${data.call_id || "unknown"}`);
+                        return jsonResult({
+                            status: "call_initiated",
+                            call_id: data.call_id,
+                            phone_number: phoneNumber,
+                            message: "Background call initiated. Use check_status with the call_id to monitor progress.",
+                            data,
+                        });
+                    }
+                    case "check_status": {
+                        const callId = readStringParam(params, "call_id", { required: true });
+                        console.log(`[PHONE] Checking status for call ${callId}`);
+                        const response = await asterizkFetch("/email/vapi/manage", {
+                            body: {
+                                operation: "check_call_status",
+                                call_id: callId,
+                            },
+                        });
+                        if (!response.ok) {
+                            const errText = await response.text();
+                            throw new Error(`Status check failed (${response.status}): ${errText}`);
+                        }
+                        const data = await response.json();
+                        return jsonResult({ call_id: callId, ...data });
+                    }
+                    case "get_report": {
+                        const callId = readStringParam(params, "call_id", { required: true });
+                        console.log(`[PHONE] Getting report for call ${callId}`);
+                        const response = await asterizkFetch("/email/vapi/manage", {
+                            body: {
+                                operation: "get_call_report",
+                                call_id: callId,
+                            },
+                        });
+                        if (!response.ok) {
+                            const errText = await response.text();
+                            throw new Error(`Report fetch failed (${response.status}): ${errText}`);
+                        }
+                        const data = await response.json();
+                        return jsonResult({ call_id: callId, ...data });
+                    }
+                    case "list_calls": {
+                        const query = readStringParam(params, "query") || "";
+                        const limit = readNumberParam(params, "limit") || 10;
+                        console.log(`[PHONE] Listing calls (query: "${query}", limit: ${limit})`);
+                        const response = await asterizkFetch("/email/vapi/manage", {
+                            body: {
+                                operation: "list_calls",
+                                query,
+                                limit,
+                            },
+                        });
+                        if (!response.ok) {
+                            const errText = await response.text();
+                            throw new Error(`List calls failed (${response.status}): ${errText}`);
+                        }
+                        const data = await response.json();
+                        return jsonResult(data);
+                    }
+                    default:
+                        return jsonResult({
+                            error: "invalid_operation",
+                            message: `Unknown operation: ${operation}. Use: make_call, check_status, get_report, list_calls`,
+                        });
+                }
+            }
+            catch (error) {
+                console.error(`[PHONE] Error (${operation}):`, error);
+                return jsonResult(handleAsterizkApiError(error, operation));
+            }
+        },
+    };
+}
+//# sourceMappingURL=phone-call.js.map

package/dist/tools/phone-call.js.map

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

package/dist/tools/sessions-spawn.d.ts

@@ -0,0 +1,33 @@
+/**
+ * CoStar Server Executor - Sessions Spawn Tool
+ * Ported from OpenClaw's agents/tools/sessions-spawn-tool.ts
+ *
+ * Differences from OpenClaw:
+ * - No gateway RPC (spawnSubagentDirect) — uses agent.runSubagentTurn() directly
+ * - No agentId param (single agent per user)
+ * - No thinking override (not needed v1)
+ * - No DeliveryContext / channel routing (single agent)
+ * - Spawn validation (depth, max children) inlined from subagent-spawn.ts
+ * - Fire-and-forget pattern with Promise.then() for completion handling
+ *
+ * Matched with OpenClaw:
+ * - Same tool name: sessions_spawn
+ * - Same core params: task, label, runTimeoutSeconds, cleanup
+ * - Same depth limits (default maxSpawnDepth=1, maxChildren=5)
+ * - Same result shape: { status, runId, label, ... }
+ * - Same auto-announce on completion via injectIsolatedResult
+ */
+import type { AnyAgentTool } from "../types/tool.js";
+import type { Agent } from "../agent/agent.js";
+export type SubagentToolDeps = {
+    /** User ID for the requester session */
+    userId: string;
+    /** Agent instance for running sub-agent turns */
+    agent: Agent;
+    /** Maximum allowed spawn depth. Default: 1 (sub-agents cannot spawn) */
+    maxSpawnDepth?: number;
+    /** Maximum concurrent children per requester. Default: 5 */
+    maxChildren?: number;
+};
+export declare function createSessionsSpawnTool(deps: SubagentToolDeps): AnyAgentTool;
+//# sourceMappingURL=sessions-spawn.d.ts.map

package/dist/tools/sessions-spawn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessions-spawn.d.ts","sourceRoot":"","sources":["../../src/tools/sessions-spawn.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAQrD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAK/C,MAAM,MAAM,gBAAgB,GAAG;IAC7B,wCAAwC;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,iDAAiD;IACjD,KAAK,EAAE,KAAK,CAAC;IACb,wEAAwE;IACxE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,4DAA4D;IAC5D,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAeF,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,gBAAgB,GAAG,YAAY,CAkJ5E"}

package/dist/tools/sessions-spawn.js

@@ -0,0 +1,164 @@
+/**
+ * CoStar Server Executor - Sessions Spawn Tool
+ * Ported from OpenClaw's agents/tools/sessions-spawn-tool.ts
+ *
+ * Differences from OpenClaw:
+ * - No gateway RPC (spawnSubagentDirect) — uses agent.runSubagentTurn() directly
+ * - No agentId param (single agent per user)
+ * - No thinking override (not needed v1)
+ * - No DeliveryContext / channel routing (single agent)
+ * - Spawn validation (depth, max children) inlined from subagent-spawn.ts
+ * - Fire-and-forget pattern with Promise.then() for completion handling
+ *
+ * Matched with OpenClaw:
+ * - Same tool name: sessions_spawn
+ * - Same core params: task, label, runTimeoutSeconds, cleanup
+ * - Same depth limits (default maxSpawnDepth=1, maxChildren=5)
+ * - Same result shape: { status, runId, label, ... }
+ * - Same auto-announce on completion via injectIsolatedResult
+ */
+import { Type } from "@sinclair/typebox";
+import { jsonResult, readStringParam } from "../utils/tool-helpers.js";
+import { registerSubagentRun, completeRun, countActiveRunsForSession, getRunById, } from "../subagent/registry.js";
+import crypto from "node:crypto";
+// ---------- schema (from OpenClaw sessions-spawn-tool.ts:8-18, simplified) ----------
+const SessionsSpawnSchema = Type.Object({
+    task: Type.String({ description: "What the sub-agent should accomplish. Be specific and provide all necessary context." }),
+    label: Type.Optional(Type.String({ description: "Short label for tracking (e.g., 'research-competitor', 'analyze-data')" })),
+    runTimeoutSeconds: Type.Optional(Type.Number({ description: "Timeout in seconds (default: 600 = 10 minutes)", minimum: 0 })),
+    // Back-compat: older callers used timeoutSeconds (OpenClaw pattern)
+    timeoutSeconds: Type.Optional(Type.Number({ description: "Alias for runTimeoutSeconds (backward compat)", minimum: 0 })),
+    cleanup: Type.Optional(Type.String({ description: "'delete' to remove session after run (default), 'keep' to retain for debugging" })),
+});
+// ---------- tool factory ----------
+export function createSessionsSpawnTool(deps) {
+    return {
+        label: "Sessions",
+        name: "sessions_spawn",
+        description: `Spawn a background sub-agent to handle a task in parallel. The sub-agent runs in a separate isolated session with all standard tools (except spawning/management). Results are automatically delivered back when complete.
+
+Use for: research tasks, data gathering, parallel workstreams, multi-step analysis, anything that benefits from concurrent execution.
+
+Rules:
+- Maximum ${deps.maxChildren ?? 5} concurrent sub-agents
+- Sub-agents cannot spawn their own sub-agents (depth limit: ${deps.maxSpawnDepth ?? 1})
+- Results are automatically announced when complete — do NOT poll or sleep
+- Use the 'subagents' tool to check status or kill running sub-agents
+- Each sub-agent gets its own isolated session with full tool access
+- Write clear, self-contained task descriptions — sub-agents have no conversation context`,
+        parameters: SessionsSpawnSchema,
+        execute: async (_toolCallId, params) => {
+            // ── 1. Validate depth (from OpenClaw subagent-spawn.ts:109-116) ──
+            const maxDepth = deps.maxSpawnDepth ?? 1;
+            // Current depth is always 0 from main agent (sub-agents don't get this tool)
+            const currentDepth = 0;
+            if (currentDepth >= maxDepth) {
+                return jsonResult({
+                    status: "forbidden",
+                    error: `Sub-agent spawning not allowed at this depth (current: ${currentDepth}, max: ${maxDepth})`,
+                });
+            }
+            // ── 2. Validate max children (from OpenClaw subagent-spawn.ts:118-125) ──
+            const maxChildren = deps.maxChildren ?? 5;
+            const activeCount = countActiveRunsForSession(deps.userId);
+            if (activeCount >= maxChildren) {
+                return jsonResult({
+                    status: "forbidden",
+                    error: `Maximum concurrent sub-agents reached (${activeCount}/${maxChildren}). Wait for one to complete or kill one using the 'subagents' tool.`,
+                });
+            }
+            // ── 3. Read params (from OpenClaw sessions-spawn-tool.ts:40-58) ──
+            const task = readStringParam(params, "task", { required: true });
+            const label = typeof params.label === "string" ? params.label.trim() : undefined;
+            // Back-compat: older callers used timeoutSeconds
+            const timeoutSecondsCandidate = typeof params.runTimeoutSeconds === "number"
+                ? params.runTimeoutSeconds
+                : typeof params.timeoutSeconds === "number"
+                    ? params.timeoutSeconds
+                    : undefined;
+            const runTimeoutSeconds = typeof timeoutSecondsCandidate === "number" && Number.isFinite(timeoutSecondsCandidate)
+                ? Math.max(0, Math.floor(timeoutSecondsCandidate))
+                : 600; // Default: 10 minutes
+            const cleanup = params.cleanup === "keep" || params.cleanup === "delete"
+                ? params.cleanup
+                : "delete"; // Default: delete session after run
+            // ── 4. Create AbortController and register ──
+            const abortController = new AbortController();
+            const runId = crypto.randomUUID();
+            registerSubagentRun({
+                runId,
+                requesterSessionKey: deps.userId,
+                task,
+                label: label || undefined,
+                status: "running",
+                startedAt: Date.now(),
+                depth: currentDepth + 1,
+                abortController,
+            });
+            // ── 5. Fire-and-forget: run sub-agent in background ──
+            const runPromise = deps.agent.runSubagentTurn(task, {
+                sessionLabel: label ? `subagent:${label}` : `subagent:${runId.slice(0, 8)}`,
+                deleteAfterRun: cleanup === "delete",
+                abortSignal: abortController.signal,
+                timeoutMs: runTimeoutSeconds * 1000,
+            });
+            // ── 6. Background completion handler ──
+            runPromise
+                .then(async (result) => {
+                const record = getRunById(runId);
+                if (!record || record.status !== "running") {
+                    // Already killed or completed — skip
+                    return;
+                }
+                const summaryText = result.outputText?.trim() || result.response?.trim() || "";
+                const durationMs = Date.now() - record.startedAt;
+                completeRun(runId, {
+                    status: result.success ? "completed" : "failed",
+                    outcome: summaryText.slice(0, 5000), // Cap at 5k chars
+                    error: result.error,
+                    durationMs,
+                    inputTokens: result.inputTokens,
+                    outputTokens: result.outputTokens,
+                });
+                // Announce to main session (same pattern as cron scheduler isolated job)
+                if (!result.didSendViaMessagingTool && summaryText) {
+                    try {
+                        await deps.agent.injectIsolatedResult({
+                            label: label || `sub-agent task`,
+                            summary: summaryText,
+                            status: result.success ? "ok" : "error",
+                            durationMs,
+                            inputTokens: result.inputTokens,
+                            outputTokens: result.outputTokens,
+                        });
+                    }
+                    catch (announceErr) {
+                        console.warn(`[SESSIONS-SPAWN] Announce failed for run ${runId}:`, announceErr);
+                    }
+                }
+            })
+                .catch((err) => {
+                const record = getRunById(runId);
+                if (!record || record.status !== "running")
+                    return;
+                const isAbort = err instanceof Error &&
+                    (err.name === "AbortError" || err.message.includes("aborted"));
+                completeRun(runId, {
+                    status: isAbort ? "killed" : "failed",
+                    error: err instanceof Error ? err.message : String(err),
+                    durationMs: Date.now() - record.startedAt,
+                });
+            });
+            // ── 7. Return immediately (from OpenClaw sessions-spawn-tool.ts:84) ──
+            return jsonResult({
+                status: "spawned",
+                runId,
+                label: label || undefined,
+                task: task.slice(0, 100),
+                activeSubagents: activeCount + 1,
+                note: "Sub-agent is running in the background. Results will be automatically announced when complete. Use 'subagents' tool to check status.",
+            });
+        },
+    };
+}
+//# sourceMappingURL=sessions-spawn.js.map

package/dist/tools/sessions-spawn.js.map

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

package/dist/tools/spotify.d.ts

@@ -0,0 +1,12 @@
+/**
+ * CoStar Server Executor - Spotify Tool
+ *
+ * Search Spotify for tracks, albums, artists, and playlists.
+ * Uses Spotify Web API with client credentials flow (no user login needed).
+ * Search + info only — cannot control playback (server has no speakers).
+ *
+ * Requires: SPOTIFY_CLIENT_ID, SPOTIFY_CLIENT_SECRET env vars.
+ */
+import type { AnyAgentTool } from "../types/tool.js";
+export declare function createSpotifyTool(): AnyAgentTool;
+//# sourceMappingURL=spotify.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"spotify.d.ts","sourceRoot":"","sources":["../../src/tools/spotify.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AA2GrD,wBAAgB,iBAAiB,IAAI,YAAY,CA6LhD"}