@farazirfan/costar-server-executor 1.7.37 → 1.7.39

package/dist/tools/spotify.js

@@ -0,0 +1,251 @@
+/**
+ * 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 } from "@sinclair/typebox";
+import { jsonResult, readStringParam, readNumberParam } from "../utils/tool-helpers.js";
+const SpotifySchema = Type.Object({
+    operation: Type.Union([
+        Type.Literal("search"),
+        Type.Literal("get_track"),
+        Type.Literal("get_artist"),
+        Type.Literal("get_album"),
+        Type.Literal("get_playlist"),
+    ], {
+        description: "Operation: search (find music), get_track (track details), get_artist (artist info + top tracks), get_album (album tracks), get_playlist (playlist tracks)",
+    }),
+    query: Type.Optional(Type.String({ description: "Search query. Required for search." })),
+    type: Type.Optional(Type.Union([
+        Type.Literal("track"),
+        Type.Literal("artist"),
+        Type.Literal("album"),
+        Type.Literal("playlist"),
+    ], { description: "Type of content to search for. Default: track. Used with search." })),
+    id: Type.Optional(Type.String({ description: "Spotify ID. Required for get_track, get_artist, get_album, get_playlist." })),
+    limit: Type.Optional(Type.Number({ description: "Number of results. Default: 10. Max: 50. Used with search." })),
+});
+/** Cached access token */
+let cachedToken = null;
+/**
+ * Get Spotify access token via client credentials flow
+ */
+async function getSpotifyToken() {
+    // Return cached token if still valid (with 60s buffer)
+    if (cachedToken && Date.now() < cachedToken.expiresAt - 60_000) {
+        return cachedToken.token;
+    }
+    const clientId = process.env.SPOTIFY_CLIENT_ID;
+    const clientSecret = process.env.SPOTIFY_CLIENT_SECRET;
+    if (!clientId || !clientSecret) {
+        throw new Error("SPOTIFY_CLIENT_ID and SPOTIFY_CLIENT_SECRET are required");
+    }
+    const response = await fetch("https://accounts.spotify.com/api/token", {
+        method: "POST",
+        headers: {
+            "Content-Type": "application/x-www-form-urlencoded",
+            Authorization: `Basic ${Buffer.from(`${clientId}:${clientSecret}`).toString("base64")}`,
+        },
+        body: "grant_type=client_credentials",
+    });
+    if (!response.ok) {
+        throw new Error(`Spotify auth failed (${response.status}): ${await response.text()}`);
+    }
+    const data = await response.json();
+    cachedToken = {
+        token: data.access_token,
+        expiresAt: Date.now() + data.expires_in * 1000,
+    };
+    return cachedToken.token;
+}
+/**
+ * Make an authenticated Spotify API call
+ */
+async function spotifyApi(path) {
+    const token = await getSpotifyToken();
+    const response = await fetch(`https://api.spotify.com/v1${path}`, {
+        headers: { Authorization: `Bearer ${token}` },
+    });
+    if (!response.ok) {
+        const errText = await response.text();
+        throw new Error(`Spotify API error (${response.status}): ${errText}`);
+    }
+    return response.json();
+}
+/**
+ * Format milliseconds to mm:ss
+ */
+function formatDuration(ms) {
+    const minutes = Math.floor(ms / 60000);
+    const seconds = Math.floor((ms % 60000) / 1000);
+    return `${minutes}:${seconds.toString().padStart(2, "0")}`;
+}
+export function createSpotifyTool() {
+    return {
+        name: "spotify",
+        label: "Spotify",
+        description: "Search Spotify for tracks, albums, artists, and playlists. Get details and share Spotify links. Cannot control playback — server has no speakers. Requires SPOTIFY_CLIENT_ID and SPOTIFY_CLIENT_SECRET env vars.",
+        parameters: SpotifySchema,
+        execute: async (_toolCallId, params) => {
+            const operation = readStringParam(params, "operation", { required: true });
+            try {
+                switch (operation) {
+                    case "search": {
+                        const query = readStringParam(params, "query", { required: true });
+                        const type = readStringParam(params, "type") || "track";
+                        const limit = readNumberParam(params, "limit") || 10;
+                        console.log(`[SPOTIFY] Searching ${type}: "${query}" (limit: ${limit})`);
+                        const data = await spotifyApi(`/search?q=${encodeURIComponent(query)}&type=${type}&limit=${limit}`);
+                        // Extract items from the appropriate key (tracks, artists, albums, playlists)
+                        const key = `${type}s`;
+                        const container = data[key];
+                        const items = (container?.items || []);
+                        const results = items.map((item) => {
+                            const base = {
+                                id: item.id,
+                                name: item.name,
+                                url: item.external_urls?.spotify,
+                            };
+                            if (type === "track") {
+                                const artists = item.artists || [];
+                                base.artists = artists.map((a) => a.name).join(", ");
+                                base.album = item.album?.name;
+                                base.duration = formatDuration(item.duration_ms);
+                                base.popularity = item.popularity;
+                            }
+                            else if (type === "artist") {
+                                base.genres = item.genres;
+                                base.followers = item.followers?.total;
+                                base.popularity = item.popularity;
+                            }
+                            else if (type === "album") {
+                                const artists = item.artists || [];
+                                base.artists = artists.map((a) => a.name).join(", ");
+                                base.total_tracks = item.total_tracks;
+                                base.release_date = item.release_date;
+                            }
+                            else if (type === "playlist") {
+                                base.owner = item.owner?.display_name;
+                                base.total_tracks = item.tracks?.total;
+                            }
+                            return base;
+                        });
+                        return jsonResult({ query, type, count: results.length, results });
+                    }
+                    case "get_track": {
+                        const id = readStringParam(params, "id", { required: true });
+                        console.log(`[SPOTIFY] Getting track ${id}`);
+                        const data = await spotifyApi(`/tracks/${id}`);
+                        const artists = data.artists || [];
+                        return jsonResult({
+                            id: data.id,
+                            name: data.name,
+                            artists: artists.map((a) => a.name).join(", "),
+                            album: data.album?.name,
+                            duration: formatDuration(data.duration_ms),
+                            popularity: data.popularity,
+                            preview_url: data.preview_url,
+                            url: data.external_urls?.spotify,
+                            release_date: data.album?.release_date,
+                        });
+                    }
+                    case "get_artist": {
+                        const id = readStringParam(params, "id", { required: true });
+                        console.log(`[SPOTIFY] Getting artist ${id}`);
+                        const [artist, topTracks] = await Promise.all([
+                            spotifyApi(`/artists/${id}`),
+                            spotifyApi(`/artists/${id}/top-tracks?market=US`),
+                        ]);
+                        const tracks = (topTracks.tracks || []).map((t) => ({
+                            name: t.name,
+                            album: t.album?.name,
+                            duration: formatDuration(t.duration_ms),
+                            popularity: t.popularity,
+                            url: t.external_urls?.spotify,
+                        }));
+                        return jsonResult({
+                            id: artist.id,
+                            name: artist.name,
+                            genres: artist.genres,
+                            followers: artist.followers?.total,
+                            popularity: artist.popularity,
+                            url: artist.external_urls?.spotify,
+                            top_tracks: tracks,
+                        });
+                    }
+                    case "get_album": {
+                        const id = readStringParam(params, "id", { required: true });
+                        console.log(`[SPOTIFY] Getting album ${id}`);
+                        const data = await spotifyApi(`/albums/${id}`);
+                        const artists = data.artists || [];
+                        const trackItems = (data.tracks?.items || []);
+                        const tracks = trackItems.map((t, i) => ({
+                            track_number: i + 1,
+                            name: t.name,
+                            duration: formatDuration(t.duration_ms),
+                            url: t.external_urls?.spotify,
+                        }));
+                        return jsonResult({
+                            id: data.id,
+                            name: data.name,
+                            artists: artists.map((a) => a.name).join(", "),
+                            release_date: data.release_date,
+                            total_tracks: data.total_tracks,
+                            url: data.external_urls?.spotify,
+                            tracks,
+                        });
+                    }
+                    case "get_playlist": {
+                        const id = readStringParam(params, "id", { required: true });
+                        console.log(`[SPOTIFY] Getting playlist ${id}`);
+                        const data = await spotifyApi(`/playlists/${id}`);
+                        const trackContainer = data.tracks;
+                        const trackItems = (trackContainer?.items || []);
+                        const tracks = trackItems.slice(0, 50).map((item) => {
+                            const t = item.track;
+                            if (!t)
+                                return null;
+                            const artists = t.artists || [];
+                            return {
+                                name: t.name,
+                                artists: artists.map((a) => a.name).join(", "),
+                                duration: formatDuration(t.duration_ms),
+                                url: t.external_urls?.spotify,
+                            };
+                        }).filter(Boolean);
+                        return jsonResult({
+                            id: data.id,
+                            name: data.name,
+                            owner: data.owner?.display_name,
+                            description: data.description,
+                            total_tracks: trackContainer?.total || 0,
+                            url: data.external_urls?.spotify,
+                            tracks,
+                        });
+                    }
+                    default:
+                        return jsonResult({
+                            error: "invalid_operation",
+                            message: `Unknown operation: ${operation}. Use: search, get_track, get_artist, get_album, get_playlist`,
+                        });
+                }
+            }
+            catch (error) {
+                console.error(`[SPOTIFY] Error (${operation}):`, error);
+                const msg = error instanceof Error ? error.message : String(error);
+                if (msg.includes("SPOTIFY_CLIENT_ID")) {
+                    return jsonResult({
+                        error: "not_configured",
+                        message: "Spotify is not configured. SPOTIFY_CLIENT_ID and SPOTIFY_CLIENT_SECRET are required.",
+                    });
+                }
+                return jsonResult({ error: `${operation}_failed`, message: msg });
+            }
+        },
+    };
+}
+//# sourceMappingURL=spotify.js.map

package/dist/tools/spotify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spotify.js","sourceRoot":"","sources":["../../src/tools/spotify.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAEzC,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAExF,MAAM,aAAa,GAAG,IAAI,CAAC,MAAM,CAAC;IAChC,SAAS,EAAE,IAAI,CAAC,KAAK,CACnB;QACE,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC;QACtB,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC;QACzB,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC;QAC1B,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC;QACzB,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC;KAC7B,EACD;QACE,WAAW,EACT,4JAA4J;KAC/J,CACF;IACD,KAAK,EAAE,IAAI,CAAC,QAAQ,CAClB,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,oCAAoC,EAAE,CAAC,CACnE;IACD,IAAI,EAAE,IAAI,CAAC,QAAQ,CACjB,IAAI,CAAC,KAAK,CACR;QACE,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC;QACrB,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC;QACtB,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC;QACrB,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC;KACzB,EACD,EAAE,WAAW,EAAE,kEAAkE,EAAE,CACpF,CACF;IACD,EAAE,EAAE,IAAI,CAAC,QAAQ,CACf,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,0EAA0E,EAAE,CAAC,CACzG;IACD,KAAK,EAAE,IAAI,CAAC,QAAQ,CAClB,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,4DAA4D,EAAE,CAAC,CAC3F;CACF,CAAC,CAAC;AAEH,0BAA0B;AAC1B,IAAI,WAAW,GAAgD,IAAI,CAAC;AAEpE;;GAEG;AACH,KAAK,UAAU,eAAe;IAC5B,uDAAuD;IACvD,IAAI,WAAW,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,WAAW,CAAC,SAAS,GAAG,MAAM,EAAE,CAAC;QAC/D,OAAO,WAAW,CAAC,KAAK,CAAC;IAC3B,CAAC;IAED,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;IAC/C,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC;IAEvD,IAAI,CAAC,QAAQ,IAAI,CAAC,YAAY,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC;IAC9E,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,wCAAwC,EAAE;QACrE,MAAM,EAAE,MAAM;QACd,OAAO,EAAE;YACP,cAAc,EAAE,mCAAmC;YACnD,aAAa,EAAE,SAAS,MAAM,CAAC,IAAI,CAAC,GAAG,QAAQ,IAAI,YAAY,EAAE,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE;SACxF;QACD,IAAI,EAAE,+BAA+B;KACtC,CAAC,CAAC;IAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,wBAAwB,QAAQ,CAAC,MAAM,MAAM,MAAM,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACxF,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;IACnC,WAAW,GAAG;QACZ,KAAK,EAAE,IAAI,CAAC,YAAY;QACxB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,UAAU,GAAG,IAAI;KAC/C,CAAC;IAEF,OAAO,WAAW,CAAC,KAAK,CAAC;AAC3B,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,UAAU,CAAC,IAAY;IACpC,MAAM,KAAK,GAAG,MAAM,eAAe,EAAE,CAAC;IAEtC,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,6BAA6B,IAAI,EAAE,EAAE;QAChE,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,KAAK,EAAE,EAAE;KAC9C,CAAC,CAAC;IAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CAAC,sBAAsB,QAAQ,CAAC,MAAM,MAAM,OAAO,EAAE,CAAC,CAAC;IACxE,CAAC;IAED,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC;AACzB,CAAC;AAED;;GAEG;AACH,SAAS,cAAc,CAAC,EAAU;IAChC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,KAAK,CAAC,CAAC;IACvC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;IAChD,OAAO,GAAG,OAAO,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,OAAO;QACL,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,SAAS;QAChB,WAAW,EACT,kNAAkN;QACpN,UAAU,EAAE,aAAa;QACzB,OAAO,EAAE,KAAK,EAAE,WAAmB,EAAE,MAA+B,EAAE,EAAE;YACtE,MAAM,SAAS,GAAG,eAAe,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAE,CAAC;YAE5E,IAAI,CAAC;gBACH,QAAQ,SAAS,EAAE,CAAC;oBAClB,KAAK,QAAQ,CAAC,CAAC,CAAC;wBACd,MAAM,KAAK,GAAG,eAAe,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAE,CAAC;wBACpE,MAAM,IAAI,GAAG,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,OAAO,CAAC;wBACxD,MAAM,KAAK,GAAG,eAAe,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC;wBAErD,OAAO,CAAC,GAAG,CAAC,uBAAuB,IAAI,MAAM,KAAK,aAAa,KAAK,GAAG,CAAC,CAAC;wBAEzE,MAAM,IAAI,GAAG,MAAM,UAAU,CAC3B,aAAa,kBAAkB,CAAC,KAAK,CAAC,SAAS,IAAI,UAAU,KAAK,EAAE,CAC1C,CAAC;wBAE7B,8EAA8E;wBAC9E,MAAM,GAAG,GAAG,GAAG,IAAI,GAAG,CAAC;wBACvB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAwC,CAAC;wBACnE,MAAM,KAAK,GAAG,CAAC,SAAS,EAAE,KAAK,IAAI,EAAE,CAA8B,CAAC;wBAEpE,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAA6B,EAAE,EAAE;4BAC1D,MAAM,IAAI,GAA4B;gCACpC,EAAE,EAAE,IAAI,CAAC,EAAE;gCACX,IAAI,EAAE,IAAI,CAAC,IAAI;gCACf,GAAG,EAAG,IAAI,CAAC,aAAyC,EAAE,OAAO;6BAC9D,CAAC;4BAEF,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;gCACrB,MAAM,OAAO,GAAI,IAAI,CAAC,OAAqC,IAAI,EAAE,CAAC;gCAClE,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gCACrD,IAAI,CAAC,KAAK,GAAI,IAAI,CAAC,KAAiC,EAAE,IAAI,CAAC;gCAC3D,IAAI,CAAC,QAAQ,GAAG,cAAc,CAAC,IAAI,CAAC,WAAqB,CAAC,CAAC;gCAC3D,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;4BACpC,CAAC;iCAAM,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;gCAC7B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;gCAC1B,IAAI,CAAC,SAAS,GAAI,IAAI,CAAC,SAAqC,EAAE,KAAK,CAAC;gCACpE,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;4BACpC,CAAC;iCAAM,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;gCAC5B,MAAM,OAAO,GAAI,IAAI,CAAC,OAAqC,IAAI,EAAE,CAAC;gCAClE,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gCACrD,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC;gCACtC,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC;4BACxC,CAAC;iCAAM,IAAI,IAAI,KAAK,UAAU,EAAE,CAAC;gCAC/B,IAAI,CAAC,KAAK,GAAI,IAAI,CAAC,KAAiC,EAAE,YAAY,CAAC;gCACnE,IAAI,CAAC,YAAY,GAAI,IAAI,CAAC,MAAkC,EAAE,KAAK,CAAC;4BACtE,CAAC;4BAED,OAAO,IAAI,CAAC;wBACd,CAAC,CAAC,CAAC;wBAEH,OAAO,UAAU,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;oBACrE,CAAC;oBAED,KAAK,WAAW,CAAC,CAAC,CAAC;wBACjB,MAAM,EAAE,GAAG,eAAe,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAE,CAAC;wBAC9D,OAAO,CAAC,GAAG,CAAC,2BAA2B,EAAE,EAAE,CAAC,CAAC;wBAE7C,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,WAAW,EAAE,EAAE,CAA4B,CAAC;wBAC1E,MAAM,OAAO,GAAI,IAAI,CAAC,OAAqC,IAAI,EAAE,CAAC;wBAElE,OAAO,UAAU,CAAC;4BAChB,EAAE,EAAE,IAAI,CAAC,EAAE;4BACX,IAAI,EAAE,IAAI,CAAC,IAAI;4BACf,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;4BAC9C,KAAK,EAAG,IAAI,CAAC,KAAiC,EAAE,IAAI;4BACpD,QAAQ,EAAE,cAAc,CAAC,IAAI,CAAC,WAAqB,CAAC;4BACpD,UAAU,EAAE,IAAI,CAAC,UAAU;4BAC3B,WAAW,EAAE,IAAI,CAAC,WAAW;4BAC7B,GAAG,EAAG,IAAI,CAAC,aAAyC,EAAE,OAAO;4BAC7D,YAAY,EAAG,IAAI,CAAC,KAAiC,EAAE,YAAY;yBACpE,CAAC,CAAC;oBACL,CAAC;oBAED,KAAK,YAAY,CAAC,CAAC,CAAC;wBAClB,MAAM,EAAE,GAAG,eAAe,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAE,CAAC;wBAC9D,OAAO,CAAC,GAAG,CAAC,4BAA4B,EAAE,EAAE,CAAC,CAAC;wBAE9C,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;4BAC5C,UAAU,CAAC,YAAY,EAAE,EAAE,CAAqC;4BAChE,UAAU,CAAC,YAAY,EAAE,uBAAuB,CAAqC;yBACtF,CAAC,CAAC;wBAEH,MAAM,MAAM,GAAI,CAAC,SAAS,CAAC,MAAM,IAAI,EAAE,CAA+B,CAAC,GAAG,CACxE,CAAC,CAA0B,EAAE,EAAE,CAAC,CAAC;4BAC/B,IAAI,EAAE,CAAC,CAAC,IAAI;4BACZ,KAAK,EAAG,CAAC,CAAC,KAAiC,EAAE,IAAI;4BACjD,QAAQ,EAAE,cAAc,CAAC,CAAC,CAAC,WAAqB,CAAC;4BACjD,UAAU,EAAE,CAAC,CAAC,UAAU;4BACxB,GAAG,EAAG,CAAC,CAAC,aAAyC,EAAE,OAAO;yBAC3D,CAAC,CACH,CAAC;wBAEF,OAAO,UAAU,CAAC;4BAChB,EAAE,EAAE,MAAM,CAAC,EAAE;4BACb,IAAI,EAAE,MAAM,CAAC,IAAI;4BACjB,MAAM,EAAE,MAAM,CAAC,MAAM;4BACrB,SAAS,EAAG,MAAM,CAAC,SAAqC,EAAE,KAAK;4BAC/D,UAAU,EAAE,MAAM,CAAC,UAAU;4BAC7B,GAAG,EAAG,MAAM,CAAC,aAAyC,EAAE,OAAO;4BAC/D,UAAU,EAAE,MAAM;yBACnB,CAAC,CAAC;oBACL,CAAC;oBAED,KAAK,WAAW,CAAC,CAAC,CAAC;wBACjB,MAAM,EAAE,GAAG,eAAe,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAE,CAAC;wBAC9D,OAAO,CAAC,GAAG,CAAC,2BAA2B,EAAE,EAAE,CAAC,CAAC;wBAE7C,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,WAAW,EAAE,EAAE,CAA4B,CAAC;wBAC1E,MAAM,OAAO,GAAI,IAAI,CAAC,OAAqC,IAAI,EAAE,CAAC;wBAClE,MAAM,UAAU,GAAG,CAAE,IAAI,CAAC,MAAkC,EAAE,KAAK,IAAI,EAAE,CAA8B,CAAC;wBAExG,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAA0B,EAAE,CAAS,EAAE,EAAE,CAAC,CAAC;4BACxE,YAAY,EAAE,CAAC,GAAG,CAAC;4BACnB,IAAI,EAAE,CAAC,CAAC,IAAI;4BACZ,QAAQ,EAAE,cAAc,CAAC,CAAC,CAAC,WAAqB,CAAC;4BACjD,GAAG,EAAG,CAAC,CAAC,aAAyC,EAAE,OAAO;yBAC3D,CAAC,CAAC,CAAC;wBAEJ,OAAO,UAAU,CAAC;4BAChB,EAAE,EAAE,IAAI,CAAC,EAAE;4BACX,IAAI,EAAE,IAAI,CAAC,IAAI;4BACf,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;4BAC9C,YAAY,EAAE,IAAI,CAAC,YAAY;4BAC/B,YAAY,EAAE,IAAI,CAAC,YAAY;4BAC/B,GAAG,EAAG,IAAI,CAAC,aAAyC,EAAE,OAAO;4BAC7D,MAAM;yBACP,CAAC,CAAC;oBACL,CAAC;oBAED,KAAK,cAAc,CAAC,CAAC,CAAC;wBACpB,MAAM,EAAE,GAAG,eAAe,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAE,CAAC;wBAC9D,OAAO,CAAC,GAAG,CAAC,8BAA8B,EAAE,EAAE,CAAC,CAAC;wBAEhD,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,cAAc,EAAE,EAAE,CAA4B,CAAC;wBAC7E,MAAM,cAAc,GAAG,IAAI,CAAC,MAAiC,CAAC;wBAC9D,MAAM,UAAU,GAAG,CAAC,cAAc,EAAE,KAAK,IAAI,EAAE,CAA8B,CAAC;wBAE9E,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,IAA6B,EAAE,EAAE;4BAC3E,MAAM,CAAC,GAAG,IAAI,CAAC,KAAgC,CAAC;4BAChD,IAAI,CAAC,CAAC;gCAAE,OAAO,IAAI,CAAC;4BACpB,MAAM,OAAO,GAAI,CAAC,CAAC,OAAqC,IAAI,EAAE,CAAC;4BAC/D,OAAO;gCACL,IAAI,EAAE,CAAC,CAAC,IAAI;gCACZ,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;gCAC9C,QAAQ,EAAE,cAAc,CAAC,CAAC,CAAC,WAAqB,CAAC;gCACjD,GAAG,EAAG,CAAC,CAAC,aAAyC,EAAE,OAAO;6BAC3D,CAAC;wBACJ,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;wBAEnB,OAAO,UAAU,CAAC;4BAChB,EAAE,EAAE,IAAI,CAAC,EAAE;4BACX,IAAI,EAAE,IAAI,CAAC,IAAI;4BACf,KAAK,EAAG,IAAI,CAAC,KAAiC,EAAE,YAAY;4BAC5D,WAAW,EAAE,IAAI,CAAC,WAAW;4BAC7B,YAAY,EAAG,cAAc,EAAE,KAAgB,IAAI,CAAC;4BACpD,GAAG,EAAG,IAAI,CAAC,aAAyC,EAAE,OAAO;4BAC7D,MAAM;yBACP,CAAC,CAAC;oBACL,CAAC;oBAED;wBACE,OAAO,UAAU,CAAC;4BAChB,KAAK,EAAE,mBAAmB;4BAC1B,OAAO,EAAE,sBAAsB,SAAS,+DAA+D;yBACxG,CAAC,CAAC;gBACP,CAAC;YACH,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,CAAC,KAAK,CAAC,oBAAoB,SAAS,IAAI,EAAE,KAAK,CAAC,CAAC;gBACxD,MAAM,GAAG,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBAEnE,IAAI,GAAG,CAAC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,CAAC;oBACtC,OAAO,UAAU,CAAC;wBAChB,KAAK,EAAE,gBAAgB;wBACvB,OAAO,EAAE,sFAAsF;qBAChG,CAAC,CAAC;gBACL,CAAC;gBAED,OAAO,UAAU,CAAC,EAAE,KAAK,EAAE,GAAG,SAAS,SAAS,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC;YACpE,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/subagents.d.ts

@@ -0,0 +1,23 @@
+/**
+ * CoStar Server Executor - Subagents Management Tool
+ * Ported from OpenClaw's agents/tools/subagents-tool.ts
+ *
+ * Differences from OpenClaw:
+ * - No steer action (requires aborting + re-prompting, deferred for v1)
+ * - No gateway RPC calls (no callGateway, no session store lookups)
+ * - No cascade kill (depth=1 means no grandchildren possible)
+ * - Uses in-memory SubagentRegistry instead of disk/Supabase persistence
+ * - No multi-agent routing (single agent per user)
+ * - Simplified target resolution (index, runId prefix, or label)
+ *
+ * Matched with OpenClaw:
+ * - Same tool name: subagents
+ * - Same list action with active/recent split
+ * - Same kill action with target resolution
+ * - Same formatted output with index, label, status, runtime
+ * - Same constants: DEFAULT_RECENT_MINUTES=30, MAX_RECENT_MINUTES=1440
+ */
+import type { AnyAgentTool } from "../types/tool.js";
+import type { SubagentToolDeps } from "./sessions-spawn.js";
+export declare function createSubagentsTool(deps: SubagentToolDeps): AnyAgentTool;
+//# sourceMappingURL=subagents.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"subagents.d.ts","sourceRoot":"","sources":["../../src/tools/subagents.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAUrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AA2D5D,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,gBAAgB,GAAG,YAAY,CAwJxE"}

package/dist/tools/subagents.js

@@ -0,0 +1,209 @@
+/**
+ * CoStar Server Executor - Subagents Management Tool
+ * Ported from OpenClaw's agents/tools/subagents-tool.ts
+ *
+ * Differences from OpenClaw:
+ * - No steer action (requires aborting + re-prompting, deferred for v1)
+ * - No gateway RPC calls (no callGateway, no session store lookups)
+ * - No cascade kill (depth=1 means no grandchildren possible)
+ * - Uses in-memory SubagentRegistry instead of disk/Supabase persistence
+ * - No multi-agent routing (single agent per user)
+ * - Simplified target resolution (index, runId prefix, or label)
+ *
+ * Matched with OpenClaw:
+ * - Same tool name: subagents
+ * - Same list action with active/recent split
+ * - Same kill action with target resolution
+ * - Same formatted output with index, label, status, runtime
+ * - Same constants: DEFAULT_RECENT_MINUTES=30, MAX_RECENT_MINUTES=1440
+ */
+import { Type } from "@sinclair/typebox";
+import { jsonResult, readStringParam } from "../utils/tool-helpers.js";
+import { listRunsForRequester, resolveTarget, killRun, killAllForSession, formatRunDuration, } from "../subagent/registry.js";
+// ---------- constants (from OpenClaw subagents-tool.ts:46-48) ----------
+const SUBAGENT_ACTIONS = ["list", "kill"];
+const DEFAULT_RECENT_MINUTES = 30;
+const MAX_RECENT_MINUTES = 24 * 60; // 1440
+// ---------- schema (from OpenClaw subagents-tool.ts:54-59, simplified) ----------
+const SubagentsToolSchema = Type.Object({
+    action: Type.String({ description: "One of: list, kill" }),
+    target: Type.Optional(Type.String({ description: "For kill: 1-based index from list, runId prefix, label, or 'all'" })),
+    recentMinutes: Type.Optional(Type.Number({ description: "Time window for 'recent' completed runs (default: 30, max: 1440)" })),
+});
+// ---------- helpers (from OpenClaw subagents-tool.ts:72-84, 118-128, 318-338) ----------
+function resolveRunStatus(entry) {
+    // OpenClaw: subagents-tool.ts:72-84
+    if (entry.status === "running")
+        return "running";
+    if (entry.status === "completed")
+        return "done";
+    if (entry.status === "killed")
+        return "killed";
+    if (entry.status === "timeout")
+        return "timeout";
+    if (entry.status === "failed")
+        return "failed";
+    return entry.status;
+}
+function truncateLine(text, maxLen) {
+    if (text.length <= maxLen)
+        return text;
+    return text.slice(0, maxLen - 1) + "…";
+}
+function buildListText(params) {
+    // OpenClaw: subagents-tool.ts:318-338
+    const lines = [];
+    lines.push("active subagents:");
+    if (params.active.length === 0) {
+        lines.push("(none)");
+    }
+    else {
+        lines.push(...params.active.map((entry) => entry.line));
+    }
+    lines.push("");
+    lines.push(`recent (last ${params.recentMinutes}m):`);
+    if (params.recent.length === 0) {
+        lines.push("(none)");
+    }
+    else {
+        lines.push(...params.recent.map((entry) => entry.line));
+    }
+    return lines.join("\n");
+}
+// ---------- tool factory ----------
+export function createSubagentsTool(deps) {
+    return {
+        label: "Subagents",
+        name: "subagents",
+        description: `List or kill spawned sub-agents for this session. Use for sub-agent orchestration.
+
+Actions:
+- list: Show all active and recently completed sub-agents with index, status, runtime, and task
+- kill: Terminate a running sub-agent by index (from list), runId prefix, label, or 'all'
+
+Examples:
+- list all: { "action": "list" }
+- kill by index: { "action": "kill", "target": "1" }
+- kill by label: { "action": "kill", "target": "research" }
+- kill all: { "action": "kill", "target": "all" }`,
+        parameters: SubagentsToolSchema,
+        execute: async (_toolCallId, params) => {
+            const action = (readStringParam(params, "action") ?? "list");
+            if (!SUBAGENT_ACTIONS.includes(action)) {
+                return jsonResult({
+                    status: "error",
+                    error: `Unknown action: ${action}. Valid: ${SUBAGENT_ACTIONS.join(", ")}`,
+                });
+            }
+            const runs = listRunsForRequester(deps.userId);
+            const recentMinutesRaw = typeof params.recentMinutes === "number" ? params.recentMinutes : undefined;
+            const recentMinutes = recentMinutesRaw
+                ? Math.max(1, Math.min(MAX_RECENT_MINUTES, Math.floor(recentMinutesRaw)))
+                : DEFAULT_RECENT_MINUTES;
+            // ── list ──
+            // (OpenClaw: subagents-tool.ts:361-417)
+            if (action === "list") {
+                const now = Date.now();
+                const recentCutoff = now - recentMinutes * 60_000;
+                let index = 1;
+                const buildListEntry = (entry, runtimeMs) => {
+                    const status = resolveRunStatus(entry);
+                    const runtime = formatRunDuration(entry.startedAt, entry.completedAt);
+                    const label = truncateLine(entry.label || entry.runId.slice(0, 8), 48);
+                    const task = truncateLine(entry.task.trim(), 72);
+                    const tokensText = (entry.inputTokens || entry.outputTokens)
+                        ? `, ${((entry.inputTokens ?? 0) + (entry.outputTokens ?? 0)).toLocaleString()} tokens`
+                        : "";
+                    const line = `${index}. ${label} (${runtime}${tokensText}) ${status} - ${task}`;
+                    const view = {
+                        index,
+                        runId: entry.runId,
+                        label,
+                        task,
+                        status,
+                        runtime,
+                        runtimeMs,
+                        startedAt: entry.startedAt,
+                        ...(entry.completedAt ? { completedAt: entry.completedAt } : {}),
+                        ...(entry.inputTokens ? { inputTokens: entry.inputTokens } : {}),
+                        ...(entry.outputTokens ? { outputTokens: entry.outputTokens } : {}),
+                    };
+                    index += 1;
+                    return { line, view };
+                };
+                const active = runs
+                    .filter((entry) => entry.status === "running")
+                    .map((entry) => buildListEntry(entry, now - entry.startedAt));
+                const recent = runs
+                    .filter((entry) => entry.status !== "running" && (entry.completedAt ?? 0) >= recentCutoff)
+                    .map((entry) => buildListEntry(entry, entry.durationMs ?? 0));
+                const text = buildListText({ active, recent, recentMinutes });
+                return jsonResult({
+                    status: "ok",
+                    action: "list",
+                    total: runs.length,
+                    active: active.map((entry) => entry.view),
+                    recent: recent.map((entry) => entry.view),
+                    text,
+                });
+            }
+            // ── kill ──
+            // (OpenClaw: subagents-tool.ts:419-517)
+            if (action === "kill") {
+                const target = readStringParam(params, "target", { required: true });
+                // Kill all
+                if (target === "all" || target === "*") {
+                    const result = killAllForSession(deps.userId);
+                    return jsonResult({
+                        status: "ok",
+                        action: "kill",
+                        target: "all",
+                        killed: result.killed,
+                        labels: result.labels,
+                        text: result.killed > 0
+                            ? `killed ${result.killed} subagent${result.killed === 1 ? "" : "s"}.`
+                            : "no running subagents to kill.",
+                    });
+                }
+                // Resolve target
+                const resolved = resolveTarget(deps.userId, target);
+                if (!resolved) {
+                    return jsonResult({
+                        status: "error",
+                        action: "kill",
+                        target,
+                        error: `Unknown subagent target: "${target}". Use a 1-based index from list, runId prefix, or label.`,
+                    });
+                }
+                // Already finished?
+                if (resolved.status !== "running") {
+                    return jsonResult({
+                        status: "done",
+                        action: "kill",
+                        target,
+                        runId: resolved.runId,
+                        label: resolved.label,
+                        text: `${resolved.label || resolved.runId.slice(0, 8)} is already finished (${resolved.status}).`,
+                    });
+                }
+                // Kill it
+                const killed = killRun(resolved.runId);
+                return jsonResult({
+                    status: killed ? "ok" : "error",
+                    action: "kill",
+                    target,
+                    runId: resolved.runId,
+                    label: resolved.label,
+                    text: killed
+                        ? `killed ${resolved.label || resolved.runId.slice(0, 8)}.`
+                        : `failed to kill ${resolved.label || resolved.runId.slice(0, 8)}.`,
+                });
+            }
+            return jsonResult({
+                status: "error",
+                error: `Unknown action: ${action}`,
+            });
+        },
+    };
+}
+//# sourceMappingURL=subagents.js.map

package/dist/tools/subagents.js.map

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

package/dist/tools/whatsapp.d.ts

@@ -0,0 +1,13 @@
+/**
+ * CoStar Server Executor - WhatsApp Tool
+ *
+ * Send and receive WhatsApp messages via Asterizk API.
+ * All operations go through POST /email/whatsapp/manage.
+ * Uses draft-then-send pattern: draft message → get draft_id → send draft.
+ *
+ * Operations: send_message, send_media, get_messages, get_messages_by_contact,
+ *             get_groups, get_contacts
+ */
+import type { AnyAgentTool } from "../types/tool.js";
+export declare function createWhatsAppTool(): AnyAgentTool;
+//# sourceMappingURL=whatsapp.d.ts.map

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

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