@farazirfan/costar-server-executor 1.0.0

package/dist/tools/pty-keys.d.ts

@@ -0,0 +1,20 @@
+/**
+ * CoStar Server Executor - PTY Key Encoding
+ * Based on OpenClaw's pty-keys.ts
+ *
+ * Encodes keyboard input for PTY sessions
+ */
+export declare const BRACKETED_PASTE_START = "\u001B[200~";
+export declare const BRACKETED_PASTE_END = "\u001B[201~";
+export type KeyEncodingRequest = {
+    keys?: string[];
+    hex?: string[];
+    literal?: string;
+};
+export type KeyEncodingResult = {
+    data: string;
+    warnings: string[];
+};
+export declare function encodeKeySequence(request: KeyEncodingRequest): KeyEncodingResult;
+export declare function encodePaste(text: string, bracketed?: boolean): string;
+//# sourceMappingURL=pty-keys.d.ts.map

package/dist/tools/pty-keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pty-keys.d.ts","sourceRoot":"","sources":["../../src/tools/pty-keys.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,eAAO,MAAM,qBAAqB,gBAAgB,CAAC;AACnD,eAAO,MAAM,mBAAmB,gBAAgB,CAAC;AAyFjD,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,GAAG,iBAAiB,CA0BhF;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,UAAO,GAAG,MAAM,CAGlE"}

package/dist/tools/pty-keys.js

@@ -0,0 +1,242 @@
+/**
+ * CoStar Server Executor - PTY Key Encoding
+ * Based on OpenClaw's pty-keys.ts
+ *
+ * Encodes keyboard input for PTY sessions
+ */
+const ESC = "\x1b";
+const CR = "\r";
+const TAB = "\t";
+const BACKSPACE = "\x7f";
+export const BRACKETED_PASTE_START = `${ESC}[200~`;
+export const BRACKETED_PASTE_END = `${ESC}[201~`;
+function escapeRegExp(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+const namedKeyMap = new Map([
+    ["enter", CR],
+    ["return", CR],
+    ["tab", TAB],
+    ["escape", ESC],
+    ["esc", ESC],
+    ["space", " "],
+    ["bspace", BACKSPACE],
+    ["backspace", BACKSPACE],
+    ["up", `${ESC}[A`],
+    ["down", `${ESC}[B`],
+    ["right", `${ESC}[C`],
+    ["left", `${ESC}[D`],
+    ["home", `${ESC}[1~`],
+    ["end", `${ESC}[4~`],
+    ["pageup", `${ESC}[5~`],
+    ["pgup", `${ESC}[5~`],
+    ["ppage", `${ESC}[5~`],
+    ["pagedown", `${ESC}[6~`],
+    ["pgdn", `${ESC}[6~`],
+    ["npage", `${ESC}[6~`],
+    ["insert", `${ESC}[2~`],
+    ["ic", `${ESC}[2~`],
+    ["delete", `${ESC}[3~`],
+    ["del", `${ESC}[3~`],
+    ["dc", `${ESC}[3~`],
+    ["btab", `${ESC}[Z`],
+    ["f1", `${ESC}OP`],
+    ["f2", `${ESC}OQ`],
+    ["f3", `${ESC}OR`],
+    ["f4", `${ESC}OS`],
+    ["f5", `${ESC}[15~`],
+    ["f6", `${ESC}[17~`],
+    ["f7", `${ESC}[18~`],
+    ["f8", `${ESC}[19~`],
+    ["f9", `${ESC}[20~`],
+    ["f10", `${ESC}[21~`],
+    ["f11", `${ESC}[23~`],
+    ["f12", `${ESC}[24~`],
+    ["kp/", `${ESC}Oo`],
+    ["kp*", `${ESC}Oj`],
+    ["kp-", `${ESC}Om`],
+    ["kp+", `${ESC}Ok`],
+    ["kp7", `${ESC}Ow`],
+    ["kp8", `${ESC}Ox`],
+    ["kp9", `${ESC}Oy`],
+    ["kp4", `${ESC}Ot`],
+    ["kp5", `${ESC}Ou`],
+    ["kp6", `${ESC}Ov`],
+    ["kp1", `${ESC}Oq`],
+    ["kp2", `${ESC}Or`],
+    ["kp3", `${ESC}Os`],
+    ["kp0", `${ESC}Op`],
+    ["kp.", `${ESC}On`],
+    ["kpenter", `${ESC}OM`],
+]);
+const modifiableNamedKeys = new Set([
+    "up",
+    "down",
+    "left",
+    "right",
+    "home",
+    "end",
+    "pageup",
+    "pgup",
+    "ppage",
+    "pagedown",
+    "pgdn",
+    "npage",
+    "insert",
+    "ic",
+    "delete",
+    "del",
+    "dc",
+]);
+export function encodeKeySequence(request) {
+    const warnings = [];
+    let data = "";
+    if (request.literal) {
+        data += request.literal;
+    }
+    if (request.hex?.length) {
+        for (const raw of request.hex) {
+            const byte = parseHexByte(raw);
+            if (byte === null) {
+                warnings.push(`Invalid hex byte: ${raw}`);
+                continue;
+            }
+            data += String.fromCharCode(byte);
+        }
+    }
+    if (request.keys?.length) {
+        for (const token of request.keys) {
+            data += encodeKeyToken(token, warnings);
+        }
+    }
+    return { data, warnings };
+}
+export function encodePaste(text, bracketed = true) {
+    if (!bracketed)
+        return text;
+    return `${BRACKETED_PASTE_START}${text}${BRACKETED_PASTE_END}`;
+}
+function encodeKeyToken(raw, warnings) {
+    const token = raw.trim();
+    if (!token)
+        return "";
+    if (token.length === 2 && token.startsWith("^")) {
+        const ctrl = toCtrlChar(token[1]);
+        if (ctrl)
+            return ctrl;
+    }
+    const parsed = parseModifiers(token);
+    const base = parsed.base;
+    const baseLower = base.toLowerCase();
+    if (baseLower === "tab" && parsed.mods.shift) {
+        return `${ESC}[Z`;
+    }
+    const baseSeq = namedKeyMap.get(baseLower);
+    if (baseSeq) {
+        let seq = baseSeq;
+        if (modifiableNamedKeys.has(baseLower) && hasAnyModifier(parsed.mods)) {
+            const mod = xtermModifier(parsed.mods);
+            if (mod > 1) {
+                const modified = applyXtermModifier(seq, mod);
+                if (modified) {
+                    seq = modified;
+                    return seq;
+                }
+            }
+        }
+        if (parsed.mods.alt) {
+            return `${ESC}${seq}`;
+        }
+        return seq;
+    }
+    if (base.length === 1) {
+        return applyCharModifiers(base, parsed.mods);
+    }
+    if (parsed.hasModifiers) {
+        warnings.push(`Unknown key "${base}" for modifiers; sending literal.`);
+    }
+    return base;
+}
+function parseModifiers(token) {
+    const mods = { ctrl: false, alt: false, shift: false };
+    let rest = token;
+    let sawModifiers = false;
+    while (rest.length > 2 && rest[1] === "-") {
+        const mod = rest[0].toLowerCase();
+        if (mod === "c")
+            mods.ctrl = true;
+        else if (mod === "m")
+            mods.alt = true;
+        else if (mod === "s")
+            mods.shift = true;
+        else
+            break;
+        sawModifiers = true;
+        rest = rest.slice(2);
+    }
+    return { mods, base: rest, hasModifiers: sawModifiers };
+}
+function applyCharModifiers(char, mods) {
+    let value = char;
+    if (mods.shift && value.length === 1 && /[a-z]/.test(value)) {
+        value = value.toUpperCase();
+    }
+    if (mods.ctrl) {
+        const ctrl = toCtrlChar(value);
+        if (ctrl)
+            value = ctrl;
+    }
+    if (mods.alt) {
+        value = `${ESC}${value}`;
+    }
+    return value;
+}
+function toCtrlChar(char) {
+    if (char.length !== 1)
+        return null;
+    if (char === "?")
+        return "\x7f";
+    const code = char.toUpperCase().charCodeAt(0);
+    if (code >= 64 && code <= 95) {
+        return String.fromCharCode(code & 0x1f);
+    }
+    return null;
+}
+function xtermModifier(mods) {
+    let mod = 1;
+    if (mods.shift)
+        mod += 1;
+    if (mods.alt)
+        mod += 2;
+    if (mods.ctrl)
+        mod += 4;
+    return mod;
+}
+function applyXtermModifier(sequence, modifier) {
+    const escPattern = escapeRegExp(ESC);
+    const csiNumber = new RegExp(`^${escPattern}\\[(\\d+)([~A-Z])$`);
+    const csiArrow = new RegExp(`^${escPattern}\\[(A|B|C|D|H|F)$`);
+    const numberMatch = sequence.match(csiNumber);
+    if (numberMatch) {
+        return `${ESC}[${numberMatch[1]};${modifier}${numberMatch[2]}`;
+    }
+    const arrowMatch = sequence.match(csiArrow);
+    if (arrowMatch) {
+        return `${ESC}[1;${modifier}${arrowMatch[1]}`;
+    }
+    return null;
+}
+function hasAnyModifier(mods) {
+    return mods.ctrl || mods.alt || mods.shift;
+}
+function parseHexByte(raw) {
+    const trimmed = raw.trim().toLowerCase();
+    const normalized = trimmed.startsWith("0x") ? trimmed.slice(2) : trimmed;
+    if (!/^[0-9a-f]{1,2}$/.test(normalized))
+        return null;
+    const value = Number.parseInt(normalized, 16);
+    if (Number.isNaN(value) || value < 0 || value > 0xff)
+        return null;
+    return value;
+}
+//# sourceMappingURL=pty-keys.js.map

package/dist/tools/pty-keys.js.map

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

package/dist/tools/session-slug.d.ts

@@ -0,0 +1,8 @@
+/**
+ * CoStar Server Executor - Session Slug Generator
+ * Based on OpenClaw's session-slug.ts
+ *
+ * Generates human-readable session IDs like "calm-harbor", "swift-reef"
+ */
+export declare function createSessionSlug(isTaken?: (id: string) => boolean): string;
+//# sourceMappingURL=session-slug.d.ts.map

package/dist/tools/session-slug.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-slug.d.ts","sourceRoot":"","sources":["../../src/tools/session-slug.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA6GH,wBAAgB,iBAAiB,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,GAAG,MAAM,CAoB3E"}

package/dist/tools/session-slug.js

@@ -0,0 +1,136 @@
+/**
+ * CoStar Server Executor - Session Slug Generator
+ * Based on OpenClaw's session-slug.ts
+ *
+ * Generates human-readable session IDs like "calm-harbor", "swift-reef"
+ */
+const SLUG_ADJECTIVES = [
+    "amber",
+    "briny",
+    "brisk",
+    "calm",
+    "clear",
+    "cool",
+    "crisp",
+    "dawn",
+    "delta",
+    "ember",
+    "faint",
+    "fast",
+    "fresh",
+    "gentle",
+    "glow",
+    "good",
+    "grand",
+    "keen",
+    "kind",
+    "lucky",
+    "marine",
+    "mellow",
+    "mild",
+    "neat",
+    "nimble",
+    "nova",
+    "oceanic",
+    "plaid",
+    "quick",
+    "quiet",
+    "rapid",
+    "salty",
+    "sharp",
+    "swift",
+    "tender",
+    "tidal",
+    "tidy",
+    "tide",
+    "vivid",
+    "warm",
+    "wild",
+    "young",
+];
+const SLUG_NOUNS = [
+    "atlas",
+    "basil",
+    "bison",
+    "bloom",
+    "breeze",
+    "canyon",
+    "cedar",
+    "claw",
+    "cloud",
+    "comet",
+    "coral",
+    "cove",
+    "crest",
+    "daisy",
+    "dune",
+    "ember",
+    "falcon",
+    "fjord",
+    "forest",
+    "glade",
+    "gulf",
+    "harbor",
+    "haven",
+    "kelp",
+    "lagoon",
+    "meadow",
+    "mist",
+    "nexus",
+    "ocean",
+    "orbit",
+    "otter",
+    "pine",
+    "prairie",
+    "reef",
+    "ridge",
+    "river",
+    "rook",
+    "sable",
+    "sage",
+    "shell",
+    "shoal",
+    "shore",
+    "slug",
+    "summit",
+    "trail",
+    "valley",
+    "wharf",
+    "willow",
+    "zephyr",
+];
+function randomChoice(values, fallback) {
+    return values[Math.floor(Math.random() * values.length)] ?? fallback;
+}
+function createSlugBase(words = 2) {
+    const parts = [randomChoice(SLUG_ADJECTIVES, "steady"), randomChoice(SLUG_NOUNS, "harbor")];
+    if (words > 2)
+        parts.push(randomChoice(SLUG_NOUNS, "reef"));
+    return parts.join("-");
+}
+export function createSessionSlug(isTaken) {
+    const isIdTaken = isTaken ?? (() => false);
+    for (let attempt = 0; attempt < 12; attempt += 1) {
+        const base = createSlugBase(2);
+        if (!isIdTaken(base))
+            return base;
+        for (let i = 2; i <= 12; i += 1) {
+            const candidate = `${base}-${i}`;
+            if (!isIdTaken(candidate))
+                return candidate;
+        }
+    }
+    for (let attempt = 0; attempt < 12; attempt += 1) {
+        const base = createSlugBase(3);
+        if (!isIdTaken(base))
+            return base;
+        for (let i = 2; i <= 12; i += 1) {
+            const candidate = `${base}-${i}`;
+            if (!isIdTaken(candidate))
+                return candidate;
+        }
+    }
+    const fallback = `${createSlugBase(3)}-${Math.random().toString(36).slice(2, 5)}`;
+    return isIdTaken(fallback) ? `${fallback}-${Date.now().toString(36)}` : fallback;
+}
+//# sourceMappingURL=session-slug.js.map

package/dist/tools/session-slug.js.map

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

package/dist/tools/session-status.d.ts

@@ -0,0 +1,7 @@
+/**
+ * CoStar Server Executor - Session Status Tool
+ * Provides information about the current execution session
+ */
+import type { AnyAgentTool } from "../types/tool.js";
+export declare function createSessionStatusTool(): AnyAgentTool;
+//# sourceMappingURL=session-status.d.ts.map

package/dist/tools/session-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-status.d.ts","sourceRoot":"","sources":["../../src/tools/session-status.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAOrD,wBAAgB,uBAAuB,IAAI,YAAY,CA8CtD"}

package/dist/tools/session-status.js

@@ -0,0 +1,55 @@
+/**
+ * CoStar Server Executor - Session Status Tool
+ * Provides information about the current execution session
+ */
+import { Type } from "@sinclair/typebox";
+import { jsonResult } from "../utils/tool-helpers.js";
+import { tmpdir } from "os";
+import { hostname, platform, arch, uptime } from "os";
+const SessionStatusSchema = Type.Object({});
+export function createSessionStatusTool() {
+    return {
+        name: "session_status",
+        label: "Session Status",
+        description: "Get information about the current execution session including system info, environment, and available resources.",
+        parameters: SessionStatusSchema,
+        execute: async (_toolCallId, _params) => {
+            try {
+                const sessionInfo = {
+                    timestamp: new Date().toISOString(),
+                    system: {
+                        platform: platform(),
+                        arch: arch(),
+                        hostname: hostname(),
+                        uptime_seconds: uptime(),
+                        temp_dir: tmpdir(),
+                    },
+                    node: {
+                        version: process.version,
+                        pid: process.pid,
+                        cwd: process.cwd(),
+                        memory_usage: process.memoryUsage(),
+                    },
+                    environment: {
+                        has_openai_key: !!process.env.OPENAI_API_KEY,
+                        has_anthropic_key: !!process.env.ANTHROPIC_API_KEY,
+                        has_brave_key: !!process.env.BRAVE_SEARCH_API_KEY,
+                        has_gemini_key: !!process.env.GEMINI_API_KEY,
+                        has_google_maps_key: !!process.env.GOOGLE_MAPS_API_KEY,
+                        has_supabase_url: !!process.env.SUPABASE_URL,
+                    },
+                };
+                return jsonResult(sessionInfo);
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                console.error(`[SESSION_STATUS] Error:`, message);
+                return jsonResult({
+                    error: "status_failed",
+                    message,
+                });
+            }
+        },
+    };
+}
+//# sourceMappingURL=session-status.js.map

package/dist/tools/session-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-status.js","sourceRoot":"","sources":["../../src/tools/session-status.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAEzC,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,MAAM,EAAE,MAAM,IAAI,CAAC;AAC5B,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,IAAI,CAAC;AAEtD,MAAM,mBAAmB,GAAG,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAE5C,MAAM,UAAU,uBAAuB;IACrC,OAAO;QACL,IAAI,EAAE,gBAAgB;QACtB,KAAK,EAAE,gBAAgB;QACvB,WAAW,EACT,kHAAkH;QACpH,UAAU,EAAE,mBAAmB;QAC/B,OAAO,EAAE,KAAK,EAAE,WAAmB,EAAE,OAAY,EAAE,EAAE;YACnD,IAAI,CAAC;gBACH,MAAM,WAAW,GAAG;oBAClB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;oBACnC,MAAM,EAAE;wBACN,QAAQ,EAAE,QAAQ,EAAE;wBACpB,IAAI,EAAE,IAAI,EAAE;wBACZ,QAAQ,EAAE,QAAQ,EAAE;wBACpB,cAAc,EAAE,MAAM,EAAE;wBACxB,QAAQ,EAAE,MAAM,EAAE;qBACnB;oBACD,IAAI,EAAE;wBACJ,OAAO,EAAE,OAAO,CAAC,OAAO;wBACxB,GAAG,EAAE,OAAO,CAAC,GAAG;wBAChB,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;wBAClB,YAAY,EAAE,OAAO,CAAC,WAAW,EAAE;qBACpC;oBACD,WAAW,EAAE;wBACX,cAAc,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc;wBAC5C,iBAAiB,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB;wBAClD,aAAa,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,oBAAoB;wBACjD,cAAc,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc;wBAC5C,mBAAmB,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB;wBACtD,gBAAgB,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY;qBAC7C;iBACF,CAAC;gBAEF,OAAO,UAAU,CAAC,WAAW,CAAC,CAAC;YACjC,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,yBAAyB,EAAE,OAAO,CAAC,CAAC;gBAElD,OAAO,UAAU,CAAC;oBAChB,KAAK,EAAE,eAAe;oBACtB,OAAO;iBACR,CAAC,CAAC;YACL,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/shell-utils.d.ts

@@ -0,0 +1,13 @@
+/**
+ * CoStar Server Executor - Shell Utilities
+ * Based on OpenClaw's shell-utils.ts
+ *
+ * Shell configuration and process utilities
+ */
+export declare function getShellConfig(): {
+    shell: string;
+    args: string[];
+};
+export declare function sanitizeBinaryOutput(text: string): string;
+export declare function killProcessTree(pid: number): void;
+//# sourceMappingURL=shell-utils.d.ts.map

package/dist/tools/shell-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell-utils.d.ts","sourceRoot":"","sources":["../../src/tools/shell-utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAqBH,wBAAgB,cAAc,IAAI;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAwBlE;AAkBD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAezD;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAsBjD"}

package/dist/tools/shell-utils.js

@@ -0,0 +1,106 @@
+/**
+ * CoStar Server Executor - Shell Utilities
+ * Based on OpenClaw's shell-utils.ts
+ *
+ * Shell configuration and process utilities
+ */
+import { spawn } from "node:child_process";
+import fs from "node:fs";
+import path from "node:path";
+function resolvePowerShellPath() {
+    const systemRoot = process.env.SystemRoot || process.env.WINDIR;
+    if (systemRoot) {
+        const candidate = path.join(systemRoot, "System32", "WindowsPowerShell", "v1.0", "powershell.exe");
+        if (fs.existsSync(candidate))
+            return candidate;
+    }
+    return "powershell.exe";
+}
+export function getShellConfig() {
+    if (process.platform === "win32") {
+        // Use PowerShell instead of cmd.exe on Windows.
+        // Problem: Many Windows system utilities (ipconfig, systeminfo, etc.) write
+        // directly to the console via WriteConsole API, bypassing stdout pipes.
+        // When Node.js spawns cmd.exe with piped stdio, these utilities produce no output.
+        // PowerShell properly captures and redirects their output to stdout.
+        return {
+            shell: resolvePowerShellPath(),
+            args: ["-NoProfile", "-NonInteractive", "-Command"],
+        };
+    }
+    const envShell = process.env.SHELL?.trim();
+    const shellName = envShell ? path.basename(envShell) : "";
+    // Fish rejects common bashisms used by tools, so prefer bash when detected.
+    if (shellName === "fish") {
+        const bash = resolveShellFromPath("bash");
+        if (bash)
+            return { shell: bash, args: ["-c"] };
+        const sh = resolveShellFromPath("sh");
+        if (sh)
+            return { shell: sh, args: ["-c"] };
+    }
+    const shell = envShell && envShell.length > 0 ? envShell : "sh";
+    return { shell, args: ["-c"] };
+}
+function resolveShellFromPath(name) {
+    const envPath = process.env.PATH ?? "";
+    if (!envPath)
+        return undefined;
+    const entries = envPath.split(path.delimiter).filter(Boolean);
+    for (const entry of entries) {
+        const candidate = path.join(entry, name);
+        try {
+            fs.accessSync(candidate, fs.constants.X_OK);
+            return candidate;
+        }
+        catch {
+            // ignore missing or non-executable entries
+        }
+    }
+    return undefined;
+}
+export function sanitizeBinaryOutput(text) {
+    const scrubbed = text.replace(/[\p{Format}\p{Surrogate}]/gu, "");
+    if (!scrubbed)
+        return scrubbed;
+    const chunks = [];
+    for (const char of scrubbed) {
+        const code = char.codePointAt(0);
+        if (code == null)
+            continue;
+        if (code === 0x09 || code === 0x0a || code === 0x0d) {
+            chunks.push(char);
+            continue;
+        }
+        if (code < 0x20)
+            continue;
+        chunks.push(char);
+    }
+    return chunks.join("");
+}
+export function killProcessTree(pid) {
+    if (process.platform === "win32") {
+        try {
+            spawn("taskkill", ["/F", "/T", "/PID", String(pid)], {
+                stdio: "ignore",
+                detached: true,
+            });
+        }
+        catch {
+            // ignore errors if taskkill fails
+        }
+        return;
+    }
+    try {
+        process.kill(-pid, "SIGKILL");
+    }
+    catch {
+        try {
+            process.kill(pid, "SIGKILL");
+        }
+        catch {
+            // process already dead
+        }
+    }
+}
+//# sourceMappingURL=shell-utils.js.map

package/dist/tools/shell-utils.js.map

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

package/dist/tools/tts.d.ts

@@ -0,0 +1,9 @@
+/**
+ * CoStar Server Executor - Text-to-Speech Tool
+ * Based on OpenClaw's tts-tool.ts
+ *
+ * Simplified to use OpenAI TTS API
+ */
+import type { AnyAgentTool } from "../types/tool.js";
+export declare function createTtsTool(): AnyAgentTool;
+//# sourceMappingURL=tts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tts.d.ts","sourceRoot":"","sources":["../../src/tools/tts.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAYrD,wBAAgB,aAAa,IAAI,YAAY,CA4F5C"}