@sriinnu/harmon 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,126 @@
+/**
+ * Harmon CLI - Thin client that calls the daemon
+ */
+import type { Command } from '@sriinnu/harmon-protocol';
+export interface CLIConfig {
+    endpoint: string;
+    token?: string;
+    timeoutMs?: number;
+}
+export type ProviderName = 'spotify' | 'apple' | 'youtube';
+export interface CookieRecord {
+    domain: string;
+    name: string;
+    path: string;
+    value: string;
+    expires?: string | null;
+    isSecure: boolean;
+    isHTTPOnly: boolean;
+}
+export declare function createCLI(config: CLIConfig): {
+    status(): Promise<unknown>;
+    command(cmd: Command): Promise<unknown>;
+    devices(): Promise<unknown>;
+    useDevice(deviceId: string): Promise<unknown>;
+    authLogin(): Promise<unknown>;
+    authLogout(): Promise<unknown>;
+    authImportCookies(cookies: CookieRecord[]): Promise<unknown>;
+    youtubeAuthLogin(): Promise<unknown>;
+    youtubeAuthLogout(): Promise<unknown>;
+    youtubeAuthRefresh(): Promise<unknown>;
+    appleAuthSetUserToken(token: string): Promise<unknown>;
+    appleAuthRefresh(): Promise<unknown>;
+    appleAuthLogout(): Promise<unknown>;
+    spotifySearch(query: string, type: string, options?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<unknown>;
+    appleSearch(query: string, type: string, options?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<unknown>;
+    appleLibraryTracks(options?: {
+        limit?: number;
+    }): Promise<unknown>;
+    applePlaylists(options?: {
+        limit?: number;
+    }): Promise<unknown>;
+    applePlaylistTracks(playlistId: string, options?: {
+        limit?: number;
+    }): Promise<unknown>;
+    appleRecommendations(options?: {
+        limit?: number;
+        seed?: string;
+    }): Promise<unknown>;
+    youtubeSearch(query: string, type: string, options?: {
+        limit?: number;
+    }): Promise<unknown>;
+    youtubeLibraryTracks(options?: {
+        limit?: number;
+    }): Promise<unknown>;
+    youtubePlaylists(options?: {
+        limit?: number;
+    }): Promise<unknown>;
+    youtubePlaylistTracks(playlistId: string, options?: {
+        limit?: number;
+    }): Promise<unknown>;
+    youtubeRecommendations(options?: {
+        limit?: number;
+        seed?: string;
+    }): Promise<unknown>;
+    applePlay(payload?: {
+        url?: string;
+    }): Promise<unknown>;
+    applePause(): Promise<unknown>;
+    appleNext(): Promise<unknown>;
+    applePrev(): Promise<unknown>;
+    appleNowPlaying(): Promise<unknown>;
+    youtubePlay(payload?: {
+        uri?: string;
+    }): Promise<unknown>;
+    youtubePause(): Promise<unknown>;
+    youtubeNext(): Promise<unknown>;
+    youtubePrev(): Promise<unknown>;
+    youtubeNowPlaying(): Promise<unknown>;
+    youtubeQueueAdd(uri: string): Promise<unknown>;
+    spotifyPlay(payload?: {
+        uri?: string;
+        contextUri?: string;
+    }): Promise<unknown>;
+    spotifyPlaylists(options?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<unknown[]>;
+    spotifyPlaylistTracks(playlistId: string, options?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<unknown[]>;
+    spotifyLibraryTracks(options?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<unknown[]>;
+    spotifyRecommendations(options?: {
+        limit?: number;
+        seed?: string;
+    }): Promise<unknown>;
+    spotifyPause(): Promise<unknown>;
+    spotifyNext(): Promise<unknown>;
+    spotifyPrev(): Promise<unknown>;
+    spotifySeek(positionMs: number): Promise<unknown>;
+    spotifyVolume(volumePercent: number): Promise<unknown>;
+    spotifyShuffle(state: boolean): Promise<unknown>;
+    spotifyRepeat(state: "off" | "track" | "context"): Promise<unknown>;
+    spotifyNowPlaying(): Promise<unknown>;
+    spotifyQueueAdd(uri: string): Promise<unknown>;
+    smartSearch(query: string, options?: {
+        limit?: number;
+    }): Promise<unknown>;
+    smartPlay(options: {
+        query?: string;
+        uri?: string;
+        provider?: string;
+    }): Promise<unknown>;
+    recognize(audioBase64: string): Promise<unknown>;
+};
+export declare function getDefaultEndpoint(): string;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAIxD,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;AAE3D,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,OAAO,CAAC;CACrB;AAMD,wBAAgB,SAAS,CAAC,MAAM,EAAE,SAAS;;iBA4DpB,OAAO;;wBAMA,MAAM;;;+BASC,YAAY,EAAE;;;;iCAgBZ,MAAM;;;yBAUd,MAAM,QAAQ,MAAM,YAAY;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE;uBAKrE,MAAM,QAAQ,MAAM,YAAY;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE;iCAKzD;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;6BAKtB;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;oCAKX,MAAM,YAAY;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;mCAKrC;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE;yBAK3C,MAAM,QAAQ,MAAM,YAAY;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;mCAKxC;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;+BAKtB;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;sCAKX,MAAM,YAAY;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;qCAKrC;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE;wBAK9C;QAAE,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE;;;;;0BAed;QAAE,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE;;;;;yBAejB,MAAM;0BAGL;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE;+BAGhC;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE;sCAM5B,MAAM,YAAY;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE;mCAMxD;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE;qCAMjC;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE;;;;4BAc1C,MAAM;iCAGD,MAAM;0BAGb,OAAO;yBAGR,KAAK,GAAG,OAAO,GAAG,SAAS;;yBAM3B,MAAM;uBAKR,MAAM,YAAY;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;uBAKpC;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE;2BAK/C,MAAM;EAItC;AAED,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C"}

package/dist/index.js

@@ -0,0 +1,255 @@
+// @ts-nocheck
+
+
+// src/index.ts
+var DEFAULT_ENDPOINT = "http://127.0.0.1:17373";
+function createCLI(config) {
+  const authHeaders = config.token ? { Authorization: `Bearer ${config.token}` } : {};
+  const timeoutMs = config.timeoutMs ?? 1e4;
+  let insecureWarned = false;
+  const requestJson = async (path, options = {}) => {
+    if (!insecureWarned && config.endpoint.startsWith("http://")) {
+      const parsed = new URL(config.endpoint);
+      const loopback = ["127.0.0.1", "::1", "localhost"].includes(parsed.hostname);
+      if (!loopback && config.token) {
+        console.warn(
+          "WARNING: Sending auth token over insecure HTTP to %s. Use HTTPS for remote daemons.",
+          parsed.hostname
+        );
+        insecureWarned = true;
+      }
+    }
+    const url = new URL(`${config.endpoint}${path}`);
+    if (options.query) {
+      for (const [key, value] of Object.entries(options.query)) {
+        if (value === void 0) continue;
+        url.searchParams.set(key, String(value));
+      }
+    }
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+      const res = await fetch(url, {
+        method: options.method ?? "GET",
+        headers: { "Content-Type": "application/json", ...authHeaders },
+        body: options.body ? JSON.stringify(options.body) : void 0,
+        signal: controller.signal
+      });
+      if (res.status === 204) {
+        return null;
+      }
+      if (!res.ok) {
+        const detail = await res.text();
+        throw new Error(`${res.status} ${detail || res.statusText}`);
+      }
+      return await res.json();
+    } finally {
+      clearTimeout(timeout);
+    }
+  };
+  return {
+    async status() {
+      return requestJson("/v1/status");
+    },
+    async command(cmd) {
+      return requestJson("/v1/command", { method: "POST", body: cmd });
+    },
+    async devices() {
+      return requestJson("/v1/devices");
+    },
+    async useDevice(deviceId) {
+      return requestJson("/v1/device/use", { method: "POST", body: { deviceId } });
+    },
+    async authLogin() {
+      return requestJson("/v1/auth/spotify/login", { method: "POST" });
+    },
+    async authLogout() {
+      return requestJson("/v1/auth/spotify/logout", { method: "POST" });
+    },
+    async authImportCookies(cookies) {
+      return requestJson("/v1/auth/spotify/import", { method: "POST", body: { cookies } });
+    },
+    // YouTube auth
+    async youtubeAuthLogin() {
+      return requestJson("/v1/auth/youtube/login", { method: "POST" });
+    },
+    async youtubeAuthLogout() {
+      return requestJson("/v1/auth/youtube/logout", { method: "POST" });
+    },
+    async youtubeAuthRefresh() {
+      return requestJson("/v1/auth/youtube/refresh", { method: "POST" });
+    },
+    // Apple auth
+    async appleAuthSetUserToken(token) {
+      return requestJson("/v1/auth/apple/set-user-token", { method: "POST", body: { token } });
+    },
+    async appleAuthRefresh() {
+      return requestJson("/v1/auth/apple/refresh", { method: "POST" });
+    },
+    async appleAuthLogout() {
+      return requestJson("/v1/auth/apple/logout", { method: "POST" });
+    },
+    async spotifySearch(query, type, options) {
+      return requestJson("/v1/spotify/search", {
+        query: { q: query, type, limit: options?.limit, offset: options?.offset }
+      });
+    },
+    async appleSearch(query, type, options) {
+      return requestJson("/v1/apple/search", {
+        query: { q: query, type, limit: options?.limit, offset: options?.offset }
+      });
+    },
+    async appleLibraryTracks(options) {
+      return requestJson("/v1/apple/library/songs", {
+        query: { limit: options?.limit }
+      });
+    },
+    async applePlaylists(options) {
+      return requestJson("/v1/apple/library/playlists", {
+        query: { limit: options?.limit }
+      });
+    },
+    async applePlaylistTracks(playlistId, options) {
+      return requestJson(`/v1/apple/playlists/${encodeURIComponent(playlistId)}/tracks`, {
+        query: { limit: options?.limit }
+      });
+    },
+    async appleRecommendations(options) {
+      return requestJson("/v1/apple/recommendations", {
+        query: { limit: options?.limit, seed: options?.seed }
+      });
+    },
+    async youtubeSearch(query, type, options) {
+      return requestJson("/v1/youtube/search", {
+        query: { q: query, type, limit: options?.limit }
+      });
+    },
+    async youtubeLibraryTracks(options) {
+      return requestJson("/v1/youtube/library/tracks", {
+        query: { limit: options?.limit }
+      });
+    },
+    async youtubePlaylists(options) {
+      return requestJson("/v1/youtube/playlists", {
+        query: { limit: options?.limit }
+      });
+    },
+    async youtubePlaylistTracks(playlistId, options) {
+      return requestJson(`/v1/youtube/playlists/${encodeURIComponent(playlistId)}/tracks`, {
+        query: { limit: options?.limit }
+      });
+    },
+    async youtubeRecommendations(options) {
+      return requestJson("/v1/youtube/recommendations", {
+        query: { limit: options?.limit, seed: options?.seed }
+      });
+    },
+    async applePlay(payload) {
+      return requestJson("/v1/apple/play", { method: "POST", body: payload ?? {} });
+    },
+    async applePause() {
+      return requestJson("/v1/apple/pause", { method: "POST" });
+    },
+    async appleNext() {
+      return requestJson("/v1/apple/next", { method: "POST" });
+    },
+    async applePrev() {
+      return requestJson("/v1/apple/prev", { method: "POST" });
+    },
+    async appleNowPlaying() {
+      return requestJson("/v1/apple/now-playing");
+    },
+    async youtubePlay(payload) {
+      return requestJson("/v1/youtube/play", { method: "POST", body: payload ?? {} });
+    },
+    async youtubePause() {
+      return requestJson("/v1/youtube/pause", { method: "POST" });
+    },
+    async youtubeNext() {
+      return requestJson("/v1/youtube/next", { method: "POST" });
+    },
+    async youtubePrev() {
+      return requestJson("/v1/youtube/prev", { method: "POST" });
+    },
+    async youtubeNowPlaying() {
+      return requestJson("/v1/youtube/now-playing");
+    },
+    async youtubeQueueAdd(uri) {
+      return requestJson("/v1/youtube/queue", { method: "POST", body: { uri } });
+    },
+    async spotifyPlay(payload) {
+      return requestJson("/v1/spotify/play", { method: "POST", body: payload ?? {} });
+    },
+    async spotifyPlaylists(options) {
+      const result = await requestJson("/v1/spotify/playlists", {
+        query: { limit: options?.limit, offset: options?.offset }
+      });
+      return result.items ?? [];
+    },
+    async spotifyPlaylistTracks(playlistId, options) {
+      const result = await requestJson(`/v1/spotify/playlists/${encodeURIComponent(playlistId)}/tracks`, {
+        query: { limit: options?.limit, offset: options?.offset }
+      });
+      return result.items ?? [];
+    },
+    async spotifyLibraryTracks(options) {
+      const result = await requestJson("/v1/spotify/library/tracks", {
+        query: { limit: options?.limit, offset: options?.offset }
+      });
+      return result.items ?? [];
+    },
+    async spotifyRecommendations(options) {
+      return requestJson("/v1/spotify/recommendations", {
+        query: { limit: options?.limit, seed: options?.seed }
+      });
+    },
+    async spotifyPause() {
+      return requestJson("/v1/spotify/pause", { method: "POST" });
+    },
+    async spotifyNext() {
+      return requestJson("/v1/spotify/next", { method: "POST" });
+    },
+    async spotifyPrev() {
+      return requestJson("/v1/spotify/prev", { method: "POST" });
+    },
+    async spotifySeek(positionMs) {
+      return requestJson("/v1/spotify/seek", { method: "POST", body: { positionMs } });
+    },
+    async spotifyVolume(volumePercent) {
+      return requestJson("/v1/spotify/volume", { method: "POST", body: { volumePercent } });
+    },
+    async spotifyShuffle(state) {
+      return requestJson("/v1/spotify/shuffle", { method: "POST", body: { state } });
+    },
+    async spotifyRepeat(state) {
+      return requestJson("/v1/spotify/repeat", { method: "POST", body: { state } });
+    },
+    async spotifyNowPlaying() {
+      return requestJson("/v1/spotify/now-playing");
+    },
+    async spotifyQueueAdd(uri) {
+      return requestJson("/v1/spotify/queue", { method: "POST", body: { uri } });
+    },
+    // Smart cross-provider
+    async smartSearch(query, options) {
+      return requestJson("/v1/smart/search", {
+        query: { q: query, limit: options?.limit }
+      });
+    },
+    async smartPlay(options) {
+      return requestJson("/v1/smart/play", { method: "POST", body: options });
+    },
+    // Song recognition
+    async recognize(audioBase64) {
+      return requestJson("/v1/recognize", { method: "POST", body: { audio: audioBase64 } });
+    }
+  };
+}
+function getDefaultEndpoint() {
+  return process.env.HARMON_ENDPOINT || DEFAULT_ENDPOINT;
+}
+export {
+  createCLI,
+  getDefaultEndpoint
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/index.ts"],
+  "sourcesContent": ["/**\n * Harmon CLI - Thin client that calls the daemon\n */\n\nimport type { Command } from '@sriinnu/harmon-protocol';\n\nconst DEFAULT_ENDPOINT = 'http://127.0.0.1:17373';\n\nexport interface CLIConfig {\n  endpoint: string;\n  token?: string;\n  timeoutMs?: number;\n}\n\nexport type ProviderName = 'spotify' | 'apple' | 'youtube';\n\nexport interface CookieRecord {\n  domain: string;\n  name: string;\n  path: string;\n  value: string;\n  expires?: string | null;\n  isSecure: boolean;\n  isHTTPOnly: boolean;\n}\n\ninterface SpotifyPagedResponse<T> {\n  items?: T[];\n}\n\nexport function createCLI(config: CLIConfig) {\n  const authHeaders = config.token ? { Authorization: `Bearer ${config.token}` } : {};\n  const timeoutMs = config.timeoutMs ?? 10000;\n  let insecureWarned = false;\n\n  const requestJson = async <T = unknown>(\n    path: string,\n    options: {\n      method?: string;\n      body?: Record<string, unknown>;\n      query?: Record<string, string | number | undefined>;\n    } = {}\n  ): Promise<T> => {\n    if (!insecureWarned && config.endpoint.startsWith('http://')) {\n      const parsed = new URL(config.endpoint);\n      const loopback = ['127.0.0.1', '::1', 'localhost'].includes(parsed.hostname);\n      if (!loopback && config.token) {\n        console.warn(\n          'WARNING: Sending auth token over insecure HTTP to %s. Use HTTPS for remote daemons.',\n          parsed.hostname,\n        );\n        insecureWarned = true;\n      }\n    }\n\n    const url = new URL(`${config.endpoint}${path}`);\n    if (options.query) {\n      for (const [key, value] of Object.entries(options.query)) {\n        if (value === undefined) continue;\n        url.searchParams.set(key, String(value));\n      }\n    }\n\n    const controller = new AbortController();\n    const timeout = setTimeout(() => controller.abort(), timeoutMs);\n\n    try {\n      const res = await fetch(url, {\n        method: options.method ?? 'GET',\n        headers: { 'Content-Type': 'application/json', ...authHeaders },\n        body: options.body ? JSON.stringify(options.body) : undefined,\n        signal: controller.signal,\n      });\n      if (res.status === 204) {\n        return null as T;\n      }\n      if (!res.ok) {\n        const detail = await res.text();\n        throw new Error(`${res.status} ${detail || res.statusText}`);\n      }\n      return (await res.json()) as T;\n    } finally {\n      clearTimeout(timeout);\n    }\n  };\n\n  return {\n    async status() {\n      return requestJson('/v1/status');\n    },\n    async command(cmd: Command) {\n      return requestJson('/v1/command', { method: 'POST', body: cmd });\n    },\n    async devices() {\n      return requestJson('/v1/devices');\n    },\n    async useDevice(deviceId: string) {\n      return requestJson('/v1/device/use', { method: 'POST', body: { deviceId } });\n    },\n    async authLogin() {\n      return requestJson('/v1/auth/spotify/login', { method: 'POST' });\n    },\n    async authLogout() {\n      return requestJson('/v1/auth/spotify/logout', { method: 'POST' });\n    },\n    async authImportCookies(cookies: CookieRecord[]) {\n      return requestJson('/v1/auth/spotify/import', { method: 'POST', body: { cookies } });\n    },\n\n    // YouTube auth\n    async youtubeAuthLogin() {\n      return requestJson('/v1/auth/youtube/login', { method: 'POST' });\n    },\n    async youtubeAuthLogout() {\n      return requestJson('/v1/auth/youtube/logout', { method: 'POST' });\n    },\n    async youtubeAuthRefresh() {\n      return requestJson('/v1/auth/youtube/refresh', { method: 'POST' });\n    },\n\n    // Apple auth\n    async appleAuthSetUserToken(token: string) {\n      return requestJson('/v1/auth/apple/set-user-token', { method: 'POST', body: { token } });\n    },\n    async appleAuthRefresh() {\n      return requestJson('/v1/auth/apple/refresh', { method: 'POST' });\n    },\n    async appleAuthLogout() {\n      return requestJson('/v1/auth/apple/logout', { method: 'POST' });\n    },\n\n    async spotifySearch(query: string, type: string, options?: { limit?: number; offset?: number }) {\n      return requestJson('/v1/spotify/search', {\n        query: { q: query, type, limit: options?.limit, offset: options?.offset },\n      });\n    },\n    async appleSearch(query: string, type: string, options?: { limit?: number; offset?: number }) {\n      return requestJson('/v1/apple/search', {\n        query: { q: query, type, limit: options?.limit, offset: options?.offset },\n      });\n    },\n    async appleLibraryTracks(options?: { limit?: number }) {\n      return requestJson('/v1/apple/library/songs', {\n        query: { limit: options?.limit },\n      });\n    },\n    async applePlaylists(options?: { limit?: number }) {\n      return requestJson('/v1/apple/library/playlists', {\n        query: { limit: options?.limit },\n      });\n    },\n    async applePlaylistTracks(playlistId: string, options?: { limit?: number }) {\n      return requestJson(`/v1/apple/playlists/${encodeURIComponent(playlistId)}/tracks`, {\n        query: { limit: options?.limit },\n      });\n    },\n    async appleRecommendations(options?: { limit?: number; seed?: string }) {\n      return requestJson('/v1/apple/recommendations', {\n        query: { limit: options?.limit, seed: options?.seed },\n      });\n    },\n    async youtubeSearch(query: string, type: string, options?: { limit?: number }) {\n      return requestJson('/v1/youtube/search', {\n        query: { q: query, type, limit: options?.limit },\n      });\n    },\n    async youtubeLibraryTracks(options?: { limit?: number }) {\n      return requestJson('/v1/youtube/library/tracks', {\n        query: { limit: options?.limit },\n      });\n    },\n    async youtubePlaylists(options?: { limit?: number }) {\n      return requestJson('/v1/youtube/playlists', {\n        query: { limit: options?.limit },\n      });\n    },\n    async youtubePlaylistTracks(playlistId: string, options?: { limit?: number }) {\n      return requestJson(`/v1/youtube/playlists/${encodeURIComponent(playlistId)}/tracks`, {\n        query: { limit: options?.limit },\n      });\n    },\n    async youtubeRecommendations(options?: { limit?: number; seed?: string }) {\n      return requestJson('/v1/youtube/recommendations', {\n        query: { limit: options?.limit, seed: options?.seed },\n      });\n    },\n    async applePlay(payload?: { url?: string }) {\n      return requestJson('/v1/apple/play', { method: 'POST', body: payload ?? {} });\n    },\n    async applePause() {\n      return requestJson('/v1/apple/pause', { method: 'POST' });\n    },\n    async appleNext() {\n      return requestJson('/v1/apple/next', { method: 'POST' });\n    },\n    async applePrev() {\n      return requestJson('/v1/apple/prev', { method: 'POST' });\n    },\n    async appleNowPlaying() {\n      return requestJson('/v1/apple/now-playing');\n    },\n    async youtubePlay(payload?: { uri?: string }) {\n      return requestJson('/v1/youtube/play', { method: 'POST', body: payload ?? {} });\n    },\n    async youtubePause() {\n      return requestJson('/v1/youtube/pause', { method: 'POST' });\n    },\n    async youtubeNext() {\n      return requestJson('/v1/youtube/next', { method: 'POST' });\n    },\n    async youtubePrev() {\n      return requestJson('/v1/youtube/prev', { method: 'POST' });\n    },\n    async youtubeNowPlaying() {\n      return requestJson('/v1/youtube/now-playing');\n    },\n    async youtubeQueueAdd(uri: string) {\n      return requestJson('/v1/youtube/queue', { method: 'POST', body: { uri } });\n    },\n    async spotifyPlay(payload?: { uri?: string; contextUri?: string }) {\n      return requestJson('/v1/spotify/play', { method: 'POST', body: payload ?? {} });\n    },\n    async spotifyPlaylists(options?: { limit?: number; offset?: number }) {\n      const result = await requestJson<SpotifyPagedResponse<unknown>>('/v1/spotify/playlists', {\n        query: { limit: options?.limit, offset: options?.offset },\n      });\n      return result.items ?? [];\n    },\n    async spotifyPlaylistTracks(playlistId: string, options?: { limit?: number; offset?: number }) {\n      const result = await requestJson<SpotifyPagedResponse<unknown>>(`/v1/spotify/playlists/${encodeURIComponent(playlistId)}/tracks`, {\n        query: { limit: options?.limit, offset: options?.offset },\n      });\n      return result.items ?? [];\n    },\n    async spotifyLibraryTracks(options?: { limit?: number; offset?: number }) {\n      const result = await requestJson<SpotifyPagedResponse<unknown>>('/v1/spotify/library/tracks', {\n        query: { limit: options?.limit, offset: options?.offset },\n      });\n      return result.items ?? [];\n    },\n    async spotifyRecommendations(options?: { limit?: number; seed?: string }) {\n      return requestJson('/v1/spotify/recommendations', {\n        query: { limit: options?.limit, seed: options?.seed },\n      });\n    },\n    async spotifyPause() {\n      return requestJson('/v1/spotify/pause', { method: 'POST' });\n    },\n    async spotifyNext() {\n      return requestJson('/v1/spotify/next', { method: 'POST' });\n    },\n    async spotifyPrev() {\n      return requestJson('/v1/spotify/prev', { method: 'POST' });\n    },\n    async spotifySeek(positionMs: number) {\n      return requestJson('/v1/spotify/seek', { method: 'POST', body: { positionMs } });\n    },\n    async spotifyVolume(volumePercent: number) {\n      return requestJson('/v1/spotify/volume', { method: 'POST', body: { volumePercent } });\n    },\n    async spotifyShuffle(state: boolean) {\n      return requestJson('/v1/spotify/shuffle', { method: 'POST', body: { state } });\n    },\n    async spotifyRepeat(state: 'off' | 'track' | 'context') {\n      return requestJson('/v1/spotify/repeat', { method: 'POST', body: { state } });\n    },\n    async spotifyNowPlaying() {\n      return requestJson('/v1/spotify/now-playing');\n    },\n    async spotifyQueueAdd(uri: string) {\n      return requestJson('/v1/spotify/queue', { method: 'POST', body: { uri } });\n    },\n\n    // Smart cross-provider\n    async smartSearch(query: string, options?: { limit?: number }) {\n      return requestJson('/v1/smart/search', {\n        query: { q: query, limit: options?.limit },\n      });\n    },\n    async smartPlay(options: { query?: string; uri?: string; provider?: string }) {\n      return requestJson('/v1/smart/play', { method: 'POST', body: options as Record<string, unknown> });\n    },\n\n    // Song recognition\n    async recognize(audioBase64: string) {\n      return requestJson('/v1/recognize', { method: 'POST', body: { audio: audioBase64 } });\n    },\n  };\n}\n\nexport function getDefaultEndpoint(): string {\n  return process.env.HARMON_ENDPOINT || DEFAULT_ENDPOINT;\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/logo.svg

@@ -0,0 +1,16 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" width="64" height="64" fill="none">
+  <!-- I am the CLI mark: one operator leaning into a terminal prompt. -->
+  <rect width="64" height="64" rx="16" fill="#F3E7D4"/>
+  <g stroke="#171513" stroke-width="2.2" stroke-linecap="round" stroke-linejoin="round">
+    <rect x="22" y="23" width="28" height="18" rx="5"/>
+    <path d="M26 31L30 34.5L26 38"/>
+    <path d="M34 38H42"/>
+    <path d="M18 49H50" opacity="0.4"/>
+    <path d="M14 28L22 31"/>
+    <path d="M12 49L14 36"/>
+  </g>
+  <g fill="#171513">
+    <circle cx="14" cy="24" r="5"/>
+    <path d="M8 37C10 32 18 32 20 37V43H8V37Z"/>
+  </g>
+</svg>

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@sriinnu/harmon",
+  "version": "0.1.0",
+  "description": "CLI client for Harmon daemon",
+  "license": "AGPL-3.0-only",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/sriinnu/harmon.git",
+    "directory": "apps/harmon-cli"
+  },
+  "homepage": "https://github.com/sriinnu/harmon/tree/main/apps/harmon-cli#readme",
+  "bugs": {
+    "url": "https://github.com/sriinnu/harmon/issues"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist/",
+    "README.md",
+    "SKILL.md",
+    "logo.svg"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "bin": {
+    "harmon": "./dist/bin/harmon.js"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "commander": "^14.0.2"
+  },
+  "devDependencies": {
+    "@types/node": "^25.0.8",
+    "esbuild": "^0.27.4",
+    "typescript": "^5.9.3",
+    "@sriinnu/harmon-protocol": "0.1.0"
+  },
+  "scripts": {
+    "build": "node --experimental-strip-types ../../scripts/clean-build.ts ./dist ./tsconfig.tsbuildinfo && tsc",
+    "build:bundle": "node --experimental-strip-types scripts/bundle.ts",
+    "dev": "tsc --watch",
+    "lint": "tsc --noEmit",
+    "test": "vitest --root ../.. apps/harmon-cli/bin/runtime.test.js apps/harmon-cli/src/index.test.ts",
+    "test:run": "vitest --root ../.. run apps/harmon-cli/bin/runtime.test.js apps/harmon-cli/src/index.test.ts"
+  }
+}