@farazirfan/costar-server-executor 1.0.0

package/dist/tools/tts.js

@@ -0,0 +1,102 @@
+/**
+ * CoStar Server Executor - Text-to-Speech Tool
+ * Based on OpenClaw's tts-tool.ts
+ *
+ * Simplified to use OpenAI TTS API
+ */
+import { Type } from "@sinclair/typebox";
+import { writeFile } from "fs/promises";
+import { join } from "path";
+import { tmpdir } from "os";
+import { OpenAI } from "openai";
+import { readStringParam } from "../utils/tool-helpers.js";
+const TtsSchema = Type.Object({
+    text: Type.String({ description: "Text to convert to speech" }),
+    voice: Type.Optional(Type.String({
+        description: "Voice to use: alloy, echo, fable, onyx, nova, shimmer (default: alloy)",
+    })),
+});
+export function createTtsTool() {
+    return {
+        name: "tts",
+        label: "Text-to-Speech",
+        description: "Convert text to speech using OpenAI TTS. Returns a MEDIA: path to the audio file. Requires OPENAI_API_KEY environment variable.",
+        parameters: TtsSchema,
+        execute: async (_toolCallId, params) => {
+            const text = readStringParam(params, "text", { required: true });
+            const voice = readStringParam(params, "voice") || "alloy";
+            // Validate voice
+            const validVoices = ["alloy", "echo", "fable", "onyx", "nova", "shimmer"];
+            if (!validVoices.includes(voice)) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Invalid voice: ${voice}. Valid voices: ${validVoices.join(", ")}`,
+                        },
+                    ],
+                    details: { error: "invalid_voice" },
+                };
+            }
+            // Get API key
+            const apiKey = process.env.OPENAI_API_KEY;
+            if (!apiKey) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: "OpenAI API key not found. Set OPENAI_API_KEY environment variable.",
+                        },
+                    ],
+                    details: { error: "missing_api_key" },
+                };
+            }
+            try {
+                console.log(`[TTS] Converting text (${text.length} chars, voice: ${voice})`);
+                // Call OpenAI TTS API
+                const openai = new OpenAI({ apiKey });
+                const response = await openai.audio.speech.create({
+                    model: "tts-1",
+                    voice: voice,
+                    input: text,
+                    response_format: "mp3",
+                });
+                // Save to temp file
+                const buffer = Buffer.from(await response.arrayBuffer());
+                const filename = `tts-${Date.now()}.mp3`;
+                const filepath = join(tmpdir(), filename);
+                await writeFile(filepath, buffer);
+                console.log(`[TTS] Audio saved to ${filepath} (${buffer.length} bytes)`);
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `MEDIA:${filepath}`,
+                        },
+                    ],
+                    details: {
+                        audioPath: filepath,
+                        voice,
+                        textLength: text.length,
+                        audioSize: buffer.length,
+                        provider: "openai",
+                    },
+                };
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                console.error(`[TTS] Error:`, message);
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `TTS conversion failed: ${message}`,
+                        },
+                    ],
+                    details: { error: message },
+                };
+            }
+        },
+    };
+}
+//# sourceMappingURL=tts.js.map

package/dist/tools/tts.js.map

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

package/dist/tools/web-fetch.d.ts

@@ -0,0 +1,9 @@
+/**
+ * CoStar Server Executor - Web Fetch Tool
+ * Based on OpenClaw's web-fetch.ts
+ *
+ * Fetches web pages and extracts readable content
+ */
+import type { AnyAgentTool } from "../types/tool.js";
+export declare function createWebFetchTool(): AnyAgentTool;
+//# sourceMappingURL=web-fetch.d.ts.map

package/dist/tools/web-fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-fetch.d.ts","sourceRoot":"","sources":["../../src/tools/web-fetch.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAuBrD,wBAAgB,kBAAkB,IAAI,YAAY,CAuHjD"}

package/dist/tools/web-fetch.js

@@ -0,0 +1,129 @@
+/**
+ * CoStar Server Executor - Web Fetch Tool
+ * Based on OpenClaw's web-fetch.ts
+ *
+ * Fetches web pages and extracts readable content
+ */
+import { Type } from "@sinclair/typebox";
+import { Readability } from "@mozilla/readability";
+import { JSDOM } from "jsdom";
+import TurndownService from "turndown";
+import { jsonResult, readStringParam, readNumberParam, truncateText } from "../utils/tool-helpers.js";
+const DEFAULT_MAX_CHARS = 50_000;
+const DEFAULT_TIMEOUT_MS = 15_000;
+const DEFAULT_USER_AGENT = "Mozilla/5.0 (Macintosh; Intel Mac OS X 14_7_2) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/122.0.0.0 Safari/537.36";
+const WebFetchSchema = Type.Object({
+    url: Type.String({ description: "HTTP or HTTPS URL to fetch" }),
+    extractMode: Type.Optional(Type.String({
+        description: 'Extraction mode: "markdown" (default) or "text"',
+    })),
+    maxChars: Type.Optional(Type.Number({
+        description: "Maximum characters to return (default: 50000)",
+        minimum: 100,
+    })),
+});
+export function createWebFetchTool() {
+    return {
+        name: "web_fetch",
+        label: "Web Fetch",
+        description: "Fetch a web page and extract readable content as markdown or plain text. Automatically handles HTML parsing and content extraction.",
+        parameters: WebFetchSchema,
+        execute: async (_toolCallId, params) => {
+            const url = readStringParam(params, "url", { required: true });
+            const extractMode = readStringParam(params, "extractMode") || "markdown";
+            const maxChars = readNumberParam(params, "maxChars") || DEFAULT_MAX_CHARS;
+            // Validate URL
+            try {
+                const parsed = new URL(url);
+                if (!["http:", "https:"].includes(parsed.protocol)) {
+                    throw new Error("URL must use http:// or https:// protocol");
+                }
+            }
+            catch (error) {
+                return jsonResult({
+                    error: "invalid_url",
+                    message: error instanceof Error ? error.message : "Invalid URL",
+                    url,
+                });
+            }
+            console.log(`[WEB_FETCH] Fetching: ${url} (mode: ${extractMode})`);
+            try {
+                // Fetch the page
+                const controller = new AbortController();
+                const timeout = setTimeout(() => controller.abort(), DEFAULT_TIMEOUT_MS);
+                const response = await fetch(url, {
+                    headers: {
+                        "User-Agent": DEFAULT_USER_AGENT,
+                        Accept: "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8",
+                    },
+                    signal: controller.signal,
+                });
+                clearTimeout(timeout);
+                if (!response.ok) {
+                    throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+                }
+                const html = await response.text();
+                const contentType = response.headers.get("content-type") || "";
+                if (!contentType.includes("html")) {
+                    console.warn(`[WEB_FETCH] Non-HTML content type: ${contentType}`);
+                }
+                // Extract readable content using Readability
+                const dom = new JSDOM(html, { url });
+                const reader = new Readability(dom.window.document);
+                const article = reader.parse();
+                if (!article) {
+                    return jsonResult({
+                        error: "extraction_failed",
+                        message: "Could not extract readable content from page",
+                        url,
+                    });
+                }
+                // Convert to markdown or text
+                let content;
+                if (extractMode === "text") {
+                    // Strip HTML tags for plain text
+                    const textDom = new JSDOM(article.content || "");
+                    content = textDom.window.document.body.textContent || "";
+                }
+                else {
+                    // Convert to markdown
+                    const turndown = new TurndownService({
+                        headingStyle: "atx",
+                        codeBlockStyle: "fenced",
+                    });
+                    content = turndown.turndown(article.content || "");
+                }
+                // Clean up whitespace
+                content = content
+                    .replace(/\n{3,}/g, "\n\n")
+                    .replace(/\t+/g, " ")
+                    .trim();
+                // Truncate if needed
+                const truncated = content.length > maxChars;
+                if (truncated) {
+                    content = truncateText(content, maxChars);
+                }
+                console.log(`[WEB_FETCH] Extracted ${content.length} chars (truncated: ${truncated})`);
+                return jsonResult({
+                    url,
+                    title: article.title,
+                    excerpt: article.excerpt,
+                    content,
+                    contentLength: content.length,
+                    truncated,
+                    extractMode,
+                });
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                console.error(`[WEB_FETCH] Error:`, message);
+                return jsonResult({
+                    error: "fetch_failed",
+                    message,
+                    url,
+                });
+            }
+        },
+    };
+}
+//# sourceMappingURL=web-fetch.js.map

package/dist/tools/web-fetch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-fetch.js","sourceRoot":"","sources":["../../src/tools/web-fetch.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAC9B,OAAO,eAAe,MAAM,UAAU,CAAC;AAEvC,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAEtG,MAAM,iBAAiB,GAAG,MAAM,CAAC;AACjC,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAClC,MAAM,kBAAkB,GACtB,sHAAsH,CAAC;AAEzH,MAAM,cAAc,GAAG,IAAI,CAAC,MAAM,CAAC;IACjC,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,4BAA4B,EAAE,CAAC;IAC/D,WAAW,EAAE,IAAI,CAAC,QAAQ,CACxB,IAAI,CAAC,MAAM,CAAC;QACV,WAAW,EAAE,iDAAiD;KAC/D,CAAC,CACH;IACD,QAAQ,EAAE,IAAI,CAAC,QAAQ,CACrB,IAAI,CAAC,MAAM,CAAC;QACV,WAAW,EAAE,+CAA+C;QAC5D,OAAO,EAAE,GAAG;KACb,CAAC,CACH;CACF,CAAC,CAAC;AAEH,MAAM,UAAU,kBAAkB;IAChC,OAAO;QACL,IAAI,EAAE,WAAW;QACjB,KAAK,EAAE,WAAW;QAClB,WAAW,EACT,qIAAqI;QACvI,UAAU,EAAE,cAAc;QAC1B,OAAO,EAAE,KAAK,EAAE,WAAmB,EAAE,MAA+B,EAAE,EAAE;YACtE,MAAM,GAAG,GAAG,eAAe,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAE,CAAC;YAChE,MAAM,WAAW,GAAG,eAAe,CAAC,MAAM,EAAE,aAAa,CAAC,IAAI,UAAU,CAAC;YACzE,MAAM,QAAQ,GAAG,eAAe,CAAC,MAAM,EAAE,UAAU,CAAC,IAAI,iBAAiB,CAAC;YAE1E,eAAe;YACf,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;gBAC5B,IAAI,CAAC,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;oBACnD,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;gBAC/D,CAAC;YACH,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,UAAU,CAAC;oBAChB,KAAK,EAAE,aAAa;oBACpB,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,aAAa;oBAC/D,GAAG;iBACJ,CAAC,CAAC;YACL,CAAC;YAED,OAAO,CAAC,GAAG,CAAC,yBAAyB,GAAG,WAAW,WAAW,GAAG,CAAC,CAAC;YAEnE,IAAI,CAAC;gBACH,iBAAiB;gBACjB,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;gBACzC,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,kBAAkB,CAAC,CAAC;gBAEzE,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;oBAChC,OAAO,EAAE;wBACP,YAAY,EAAE,kBAAkB;wBAChC,MAAM,EAAE,iEAAiE;qBAC1E;oBACD,MAAM,EAAE,UAAU,CAAC,MAAM;iBAC1B,CAAC,CAAC;gBAEH,YAAY,CAAC,OAAO,CAAC,CAAC;gBAEtB,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;oBACjB,MAAM,IAAI,KAAK,CAAC,QAAQ,QAAQ,CAAC,MAAM,KAAK,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;gBACrE,CAAC;gBAED,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;gBACnC,MAAM,WAAW,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC;gBAE/D,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;oBAClC,OAAO,CAAC,IAAI,CAAC,sCAAsC,WAAW,EAAE,CAAC,CAAC;gBACpE,CAAC;gBAED,6CAA6C;gBAC7C,MAAM,GAAG,GAAG,IAAI,KAAK,CAAC,IAAI,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;gBACrC,MAAM,MAAM,GAAG,IAAI,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;gBACpD,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC;gBAE/B,IAAI,CAAC,OAAO,EAAE,CAAC;oBACb,OAAO,UAAU,CAAC;wBAChB,KAAK,EAAE,mBAAmB;wBAC1B,OAAO,EAAE,8CAA8C;wBACvD,GAAG;qBACJ,CAAC,CAAC;gBACL,CAAC;gBAED,8BAA8B;gBAC9B,IAAI,OAAe,CAAC;gBACpB,IAAI,WAAW,KAAK,MAAM,EAAE,CAAC;oBAC3B,iCAAiC;oBACjC,MAAM,OAAO,GAAG,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;oBACjD,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,IAAI,EAAE,CAAC;gBAC3D,CAAC;qBAAM,CAAC;oBACN,sBAAsB;oBACtB,MAAM,QAAQ,GAAG,IAAI,eAAe,CAAC;wBACnC,YAAY,EAAE,KAAK;wBACnB,cAAc,EAAE,QAAQ;qBACzB,CAAC,CAAC;oBACH,OAAO,GAAG,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;gBACrD,CAAC;gBAED,sBAAsB;gBACtB,OAAO,GAAG,OAAO;qBACd,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC;qBAC1B,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;qBACpB,IAAI,EAAE,CAAC;gBAEV,qBAAqB;gBACrB,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,QAAQ,CAAC;gBAC5C,IAAI,SAAS,EAAE,CAAC;oBACd,OAAO,GAAG,YAAY,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;gBAC5C,CAAC;gBAED,OAAO,CAAC,GAAG,CACT,yBAAyB,OAAO,CAAC,MAAM,sBAAsB,SAAS,GAAG,CAC1E,CAAC;gBAEF,OAAO,UAAU,CAAC;oBAChB,GAAG;oBACH,KAAK,EAAE,OAAO,CAAC,KAAK;oBACpB,OAAO,EAAE,OAAO,CAAC,OAAO;oBACxB,OAAO;oBACP,aAAa,EAAE,OAAO,CAAC,MAAM;oBAC7B,SAAS;oBACT,WAAW;iBACZ,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBACvE,OAAO,CAAC,KAAK,CAAC,oBAAoB,EAAE,OAAO,CAAC,CAAC;gBAE7C,OAAO,UAAU,CAAC;oBAChB,KAAK,EAAE,cAAc;oBACrB,OAAO;oBACP,GAAG;iBACJ,CAAC,CAAC;YACL,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/web-search.d.ts

@@ -0,0 +1,15 @@
+/**
+ * CoStar Server Executor - Web Search Tool
+ * Uses Serper.dev API for comprehensive web search
+ *
+ * Serper.dev features:
+ * - Fast Google SERP results (1-2 seconds)
+ * - Support for web, news, images, videos, shopping, scholar, patents
+ * - Industry standard for AI agents
+ * - $0.30 per 1,000 queries or 2,500/month free
+ */
+import type { AnyAgentTool } from "../types/tool.js";
+export declare function createWebSearchTool(options?: {
+    apiKey?: string;
+}): AnyAgentTool;
+//# sourceMappingURL=web-search.d.ts.map

package/dist/tools/web-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-search.d.ts","sourceRoot":"","sources":["../../src/tools/web-search.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAyCrD,wBAAgB,mBAAmB,CAAC,OAAO,CAAC,EAAE;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,YAAY,CAkGf"}

package/dist/tools/web-search.js

@@ -0,0 +1,119 @@
+/**
+ * CoStar Server Executor - Web Search Tool
+ * Uses Serper.dev API for comprehensive web search
+ *
+ * Serper.dev features:
+ * - Fast Google SERP results (1-2 seconds)
+ * - Support for web, news, images, videos, shopping, scholar, patents
+ * - Industry standard for AI agents
+ * - $0.30 per 1,000 queries or 2,500/month free
+ */
+import { Type } from "@sinclair/typebox";
+import { jsonResult, readStringParam, readNumberParam } from "../utils/tool-helpers.js";
+const DEFAULT_SEARCH_COUNT = 5;
+const MAX_SEARCH_COUNT = 10;
+const SERPER_ENDPOINT = "https://google.serper.dev/search";
+const DEFAULT_TIMEOUT_MS = 10_000;
+const WebSearchSchema = Type.Object({
+    query: Type.String({ description: "Search query string" }),
+    count: Type.Optional(Type.Number({
+        description: "Number of results to return (1-10, default: 5)",
+        minimum: 1,
+        maximum: MAX_SEARCH_COUNT,
+    })),
+    searchType: Type.Optional(Type.String({
+        description: 'Type of search: "organic" (default), "news", "shopping", "images", "scholar", "patents"',
+        enum: ["organic", "news", "shopping", "images", "scholar", "patents"],
+    })),
+});
+export function createWebSearchTool(options) {
+    return {
+        name: "web_search",
+        label: "Web Search",
+        description: "Search the web using Serper.dev API. Returns title, URL, and description for each result. Supports multiple search types. Requires SERPER_API_KEY environment variable.",
+        parameters: WebSearchSchema,
+        execute: async (_toolCallId, params) => {
+            const query = readStringParam(params, "query", { required: true });
+            const count = readNumberParam(params, "count") || DEFAULT_SEARCH_COUNT;
+            const searchType = readStringParam(params, "searchType") || "organic";
+            // Get API key from options or environment
+            const apiKey = options?.apiKey || process.env.SERPER_API_KEY;
+            if (!apiKey) {
+                return jsonResult({
+                    error: "missing_api_key",
+                    message: "Serper API key not found. Set SERPER_API_KEY environment variable. Get free key at https://serper.dev",
+                    query,
+                });
+            }
+            try {
+                console.log(`[WEB_SEARCH] Searching: ${query} (count: ${count}, type: ${searchType})`);
+                // Make request to Serper.dev
+                const controller = new AbortController();
+                const timeout = setTimeout(() => controller.abort(), DEFAULT_TIMEOUT_MS);
+                const response = await fetch(SERPER_ENDPOINT, {
+                    method: "POST",
+                    headers: {
+                        "X-API-KEY": apiKey,
+                        "Content-Type": "application/json",
+                    },
+                    body: JSON.stringify({
+                        q: query,
+                        num: Math.min(count, MAX_SEARCH_COUNT),
+                        autocorrect: true,
+                        page: 1,
+                    }),
+                    signal: controller.signal,
+                });
+                clearTimeout(timeout);
+                if (!response.ok) {
+                    const errorText = await response.text();
+                    throw new Error(`Serper API error (${response.status}): ${errorText || response.statusText}`);
+                }
+                const data = (await response.json());
+                // Extract results based on search type
+                let results = [];
+                if (searchType === "news" && data.news) {
+                    results = data.news;
+                }
+                else if (searchType === "shopping" && data.shopping) {
+                    results = data.shopping;
+                }
+                else if (searchType === "images" && data.images) {
+                    results = data.images;
+                }
+                else {
+                    // Default to organic results
+                    results = data.organic || [];
+                }
+                // Format results
+                const formattedResults = results.slice(0, count).map((result) => ({
+                    title: result.title || "No title",
+                    url: result.link || "",
+                    description: result.snippet || "",
+                    date: result.date,
+                    position: result.position,
+                }));
+                console.log(`[WEB_SEARCH] Found ${formattedResults.length} results`);
+                return jsonResult({
+                    query,
+                    count: formattedResults.length,
+                    results: formattedResults,
+                    provider: "serper",
+                    type: searchType,
+                    knowledgeGraph: data.knowledgeGraph,
+                });
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                console.error(`[WEB_SEARCH] Error:`, message);
+                return jsonResult({
+                    error: "search_failed",
+                    message,
+                    query,
+                    results: [],
+                });
+            }
+        },
+    };
+}
+//# sourceMappingURL=web-search.js.map

package/dist/tools/web-search.js.map

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

package/dist/types/tool.d.ts

@@ -0,0 +1,31 @@
+/**
+ * CoStar Server Executor - Tool Type Definitions
+ */
+import type { TSchema } from "@sinclair/typebox";
+export type AnyAgentTool = {
+    name: string;
+    label?: string;
+    description: string;
+    parameters: TSchema;
+    execute: (toolCallId: string, params: any) => Promise<AgentToolResult>;
+};
+export type AgentToolResult = {
+    content: Array<{
+        type: "text" | "image";
+        text?: string;
+        source?: {
+            type: "base64";
+            media_type: string;
+            data: string;
+        };
+    }>;
+    details?: unknown;
+};
+export type ToolContext = {
+    userId: string;
+    sessionId?: string;
+    workspaceDir?: string;
+    supabaseUrl: string;
+    supabaseKey: string;
+};
+//# sourceMappingURL=tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../src/types/tool.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAEjD,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,KAAK,OAAO,CAAC,eAAe,CAAC,CAAC;CACxE,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,EAAE,KAAK,CAAC;QACb,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE;YACP,IAAI,EAAE,QAAQ,CAAC;YACf,UAAU,EAAE,MAAM,CAAC;YACnB,IAAI,EAAE,MAAM,CAAC;SACd,CAAC;KACH,CAAC,CAAC;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC"}

package/dist/types/tool.js

@@ -0,0 +1,5 @@
+/**
+ * CoStar Server Executor - Tool Type Definitions
+ */
+export {};
+//# sourceMappingURL=tool.js.map

package/dist/types/tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.js","sourceRoot":"","sources":["../../src/types/tool.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/updates/checker.d.ts

@@ -0,0 +1,51 @@
+/**
+ * CoStar Server Executor - Update Checker
+ * Adapted from OpenClaw's infra/update-check.ts and infra/update-startup.ts
+ */
+export type UpdateChannel = "latest" | "beta" | "dev";
+export type UpdateCheckState = {
+    lastCheckedAt?: string;
+    lastNotifiedVersion?: string;
+    lastNotifiedChannel?: UpdateChannel;
+};
+export type VersionInfo = {
+    version: string | null;
+    error?: string;
+};
+export type UpdateCheckResult = {
+    updateAvailable: boolean;
+    currentVersion: string;
+    latestVersion: string | null;
+    channel: UpdateChannel;
+    shouldNotify: boolean;
+};
+/**
+ * Compare two semver strings
+ * (Adapted from OpenClaw's compareSemverStrings)
+ * Returns: -1 if a < b, 0 if a === b, 1 if a > b, null if invalid
+ */
+export declare function compareSemverStrings(a: string | null, b: string | null): number | null;
+/**
+ * Check for updates
+ * (Adapted from OpenClaw's runGatewayUpdateCheck pattern)
+ */
+export declare function checkForUpdates(params: {
+    channel?: UpdateChannel;
+    enabled?: boolean;
+    timeoutMs?: number;
+    skipInTest?: boolean;
+}): Promise<UpdateCheckResult | null>;
+/**
+ * Schedule background update check (non-blocking)
+ * (Adapted from OpenClaw's scheduleGatewayUpdateCheck)
+ */
+export declare function scheduleUpdateCheck(params: {
+    channel?: UpdateChannel;
+    enabled?: boolean;
+    onUpdateAvailable?: (result: UpdateCheckResult) => void;
+}): void;
+/**
+ * Get update command for user
+ */
+export declare function getUpdateCommand(): string;
+//# sourceMappingURL=checker.d.ts.map

package/dist/updates/checker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checker.d.ts","sourceRoot":"","sources":["../../src/updates/checker.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,MAAM,GAAG,KAAK,CAAC;AAEtD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,mBAAmB,CAAC,EAAE,aAAa,CAAC;CACrC,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,eAAe,EAAE,OAAO,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,OAAO,EAAE,aAAa,CAAC;IACvB,YAAY,EAAE,OAAO,CAAC;CACvB,CAAC;AA2HF;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAWtF;AAgDD;;;GAGG;AACH,wBAAsB,eAAe,CAAC,MAAM,EAAE;IAC5C,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAqDpC;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE;IAC1C,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,iBAAiB,CAAC,EAAE,CAAC,MAAM,EAAE,iBAAiB,KAAK,IAAI,CAAC;CACzD,GAAG,IAAI,CAcP;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC"}