@jovie/cli 26.9.15

package/dist/client.js

@@ -0,0 +1,174 @@
+export const DEFAULT_BASE_URL = 'https://jov.ie';
+export const DEFAULT_TIMEOUT_MS = 30_000;
+export const DEFAULT_USER_AGENT = 'jovie-cli';
+export class JovieInputError extends Error {
+    code = 'INVALID_INPUT';
+    constructor(message) {
+        super(message);
+        this.name = 'JovieInputError';
+    }
+}
+export class JovieRequestError extends Error {
+    url;
+    status;
+    responseBody;
+    retryAfterSeconds;
+    apiCode;
+    code = 'REQUEST_FAILED';
+    constructor(message, url, status, responseBody, retryAfterSeconds, 
+    /** Stable server error code (e.g. RATE_LIMITED) when the API sent one. */
+    apiCode) {
+        super(message);
+        this.url = url;
+        this.status = status;
+        this.responseBody = responseBody;
+        this.retryAfterSeconds = retryAfterSeconds;
+        this.apiCode = apiCode;
+        this.name = 'JovieRequestError';
+    }
+}
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+/** Normalize a deployment root without accepting credentials or query state. */
+export function normalizeBaseUrl(baseUrl = DEFAULT_BASE_URL) {
+    let url;
+    try {
+        url = new URL(baseUrl);
+    }
+    catch {
+        throw new JovieInputError(`Invalid base URL: ${baseUrl}`);
+    }
+    if (!['http:', 'https:'].includes(url.protocol) ||
+        url.username ||
+        url.password ||
+        url.search ||
+        url.hash ||
+        (url.pathname !== '/' && url.pathname !== '')) {
+        throw new JovieInputError('Base URL must be an http(s) origin without credentials, a path, or query parameters.');
+    }
+    return url.origin;
+}
+function resourceUrl(baseUrl, pathname) {
+    return new URL(pathname, `${normalizeBaseUrl(baseUrl)}/`).toString();
+}
+function requestSignal(options) {
+    const timeoutSignal = AbortSignal.timeout(options.timeoutMs ?? DEFAULT_TIMEOUT_MS);
+    return options.signal
+        ? AbortSignal.any([options.signal, timeoutSignal])
+        : timeoutSignal;
+}
+function getFetch(options) {
+    return options.fetchImpl ?? ((input, init) => globalThis.fetch(input, init));
+}
+function parseRetryAfterSeconds(value, nowMs = Date.now()) {
+    if (!value)
+        return undefined;
+    if (/^\d+$/.test(value.trim())) {
+        const seconds = Number(value);
+        return Number.isSafeInteger(seconds) ? seconds : undefined;
+    }
+    const retryAtMs = Date.parse(value);
+    if (!Number.isFinite(retryAtMs))
+        return undefined;
+    return Math.max(0, Math.ceil((retryAtMs - nowMs) / 1000));
+}
+function parseApiCode(body) {
+    try {
+        const code = JSON.parse(body).error
+            ?.code;
+        return typeof code === 'string' ? code : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+async function request(pathname, accept, options, jsonBody) {
+    const baseUrl = normalizeBaseUrl(options.baseUrl);
+    const url = resourceUrl(baseUrl, pathname);
+    const method = jsonBody === undefined ? 'GET' : 'POST';
+    let response;
+    try {
+        response = await getFetch(options)(url, {
+            method,
+            headers: {
+                Accept: accept,
+                'User-Agent': options.userAgent ?? DEFAULT_USER_AGENT,
+                ...(jsonBody === undefined
+                    ? {}
+                    : { 'Content-Type': 'application/json' }),
+            },
+            ...(jsonBody === undefined ? {} : { body: JSON.stringify(jsonBody) }),
+            signal: requestSignal(options),
+        });
+    }
+    catch (error) {
+        throw new JovieRequestError(`${method} ${url} failed: ${errorMessage(error)}`, url);
+    }
+    const body = await response.text();
+    if (!response.ok) {
+        throw new JovieRequestError(`${method} ${url} returned HTTP ${response.status}`, url, response.status, body.slice(0, 1_000), parseRetryAfterSeconds(response.headers.get('retry-after')), parseApiCode(body));
+    }
+    return { body, url };
+}
+async function requestJson(pathname, options, jsonBody) {
+    const { body, url } = await request(pathname, 'application/json', options, jsonBody);
+    try {
+        return JSON.parse(body);
+    }
+    catch {
+        throw new JovieRequestError(`${jsonBody === undefined ? 'GET' : 'POST'} ${url} returned invalid JSON`, url, undefined, body.slice(0, 1_000));
+    }
+}
+async function requestText(pathname, options) {
+    const { body } = await request(pathname, 'text/plain', options);
+    return body;
+}
+export function validateUsername(username) {
+    const normalized = username.trim();
+    if (normalized.length < 3 ||
+        normalized.length > 30 ||
+        !/^[a-zA-Z0-9._-]+$/.test(normalized)) {
+        throw new JovieInputError('Username must be 3-30 characters and contain only letters, numbers, dots, underscores, or hyphens.');
+    }
+    return normalized;
+}
+/** Fetch the public, unauthenticated artist API response. */
+export function fetchArtist(username, options = {}) {
+    const normalized = validateUsername(username);
+    return requestJson(`/api/v1/${encodeURIComponent(normalized)}`, options);
+}
+/** Fetch the canonical public OpenAPI 3.1 contract. */
+export function fetchOpenApi(options = {}) {
+    return requestJson('/api/v1/openapi.json', options);
+}
+/** Fetch the site-level machine-readable agent guide. */
+export function fetchSiteLlms(full, options = {}) {
+    return requestText(full ? '/llms-full.txt' : '/llms.txt', options);
+}
+/** Fetch the machine-readable guide for one public artist. */
+export function fetchArtistLlms(username, options = {}) {
+    const normalized = validateUsername(username);
+    return requestText(`/${encodeURIComponent(normalized)}/llms.txt`, options);
+}
+/**
+ * Create (or find) a Jovie profile for a Spotify artist. Returns the public
+ * profile URL and, when unclaimed, a claim URL the human opens to verify
+ * ownership. Anonymous and rate limited per IP.
+ */
+export function createProfile(spotifyArtistUrl, options = {}) {
+    let url;
+    try {
+        url = new URL(spotifyArtistUrl.trim());
+    }
+    catch {
+        throw new JovieInputError(`Invalid URL: ${spotifyArtistUrl}`);
+    }
+    if (url.protocol !== 'https:' ||
+        !/(^|\.)spotify\.com$/.test(url.hostname) ||
+        !/^\/(intl-[a-z-]+\/)?artist\/[A-Za-z0-9]+\/?$/.test(url.pathname)) {
+        throw new JovieInputError('Expected a Spotify artist URL like https://open.spotify.com/artist/<id>.');
+    }
+    return requestJson('/api/agents/profiles', options, { url: url.toString() });
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/commands.d.ts

@@ -0,0 +1,21 @@
+import { type ResourceOptions } from './client.js';
+export interface CommandInput {
+    readonly arg?: string;
+    readonly full?: boolean;
+}
+/** One definition drives CLI dispatch, `--help`, and MCP tools. */
+export interface CommandSpec {
+    readonly path: readonly [string, string];
+    readonly tool: string;
+    readonly summary: string;
+    readonly arg?: {
+        readonly name: string;
+        readonly description: string;
+    };
+    readonly acceptsFull?: boolean;
+    readonly readOnly: boolean;
+    readonly run: (input: CommandInput, options: ResourceOptions) => Promise<unknown>;
+}
+export declare const COMMANDS: readonly CommandSpec[];
+export declare function findCommand(positionals: readonly string[]): CommandSpec | undefined;
+//# sourceMappingURL=commands.d.ts.map

package/dist/commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../src/commands.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,eAAe,EACrB,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,mEAAmE;AACnE,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,GAAG,CAAC,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IACvE,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,GAAG,EAAE,CACZ,KAAK,EAAE,YAAY,EACnB,OAAO,EAAE,eAAe,KACrB,OAAO,CAAC,OAAO,CAAC,CAAC;CACvB;AAMD,eAAO,MAAM,QAAQ,EAAE,SAAS,WAAW,EA+C1C,CAAC;AAEF,wBAAgB,WAAW,CACzB,WAAW,EAAE,SAAS,MAAM,EAAE,GAC7B,WAAW,GAAG,SAAS,CAKzB"}

package/dist/commands.js

@@ -0,0 +1,52 @@
+import { createProfile, fetchArtist, fetchArtistLlms, fetchOpenApi, fetchSiteLlms, } from './client.js';
+function required(input) {
+    return input.arg ?? '';
+}
+export const COMMANDS = [
+    {
+        path: ['profile', 'create'],
+        tool: 'create_profile',
+        summary: 'Create (or find) a Jovie profile for a Spotify artist. Returns profileUrl and, when unclaimed, a claimUrl the artist opens to take ownership.',
+        arg: {
+            name: 'url',
+            description: 'Spotify artist URL, e.g. https://open.spotify.com/artist/<id>',
+        },
+        readOnly: false,
+        run: (input, options) => createProfile(required(input), options),
+    },
+    {
+        path: ['artist', 'get'],
+        tool: 'get_artist',
+        summary: 'Fetch a public artist profile: bio, links, releases, events, merch.',
+        arg: { name: 'username', description: 'Jovie username, e.g. radiohead' },
+        readOnly: true,
+        run: (input, options) => fetchArtist(required(input), options),
+    },
+    {
+        path: ['artist', 'llms'],
+        tool: 'get_artist_guide',
+        summary: "Fetch an artist's machine-readable guide (llms.txt).",
+        arg: { name: 'username', description: 'Jovie username' },
+        readOnly: true,
+        run: (input, options) => fetchArtistLlms(required(input), options),
+    },
+    {
+        path: ['api', 'openapi'],
+        tool: 'get_openapi',
+        summary: 'Fetch the public Jovie OpenAPI contract.',
+        readOnly: true,
+        run: (_input, options) => fetchOpenApi(options),
+    },
+    {
+        path: ['docs', 'llms'],
+        tool: 'get_docs',
+        summary: 'Fetch the Jovie agent guide (llms.txt; full=true for llms-full.txt).',
+        acceptsFull: true,
+        readOnly: true,
+        run: (input, options) => fetchSiteLlms(input.full === true, options),
+    },
+];
+export function findCommand(positionals) {
+    return COMMANDS.find(command => command.path[0] === positionals[0] && command.path[1] === positionals[1]);
+}
+//# sourceMappingURL=commands.js.map

package/dist/commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.js","sourceRoot":"","sources":["../src/commands.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,WAAW,EACX,eAAe,EACf,YAAY,EACZ,aAAa,GAEd,MAAM,aAAa,CAAC;AAqBrB,SAAS,QAAQ,CAAC,KAAmB;IACnC,OAAO,KAAK,CAAC,GAAG,IAAI,EAAE,CAAC;AACzB,CAAC;AAED,MAAM,CAAC,MAAM,QAAQ,GAA2B;IAC9C;QACE,IAAI,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC;QAC3B,IAAI,EAAE,gBAAgB;QACtB,OAAO,EACL,+IAA+I;QACjJ,GAAG,EAAE;YACH,IAAI,EAAE,KAAK;YACX,WAAW,EACT,+DAA+D;SAClE;QACD,QAAQ,EAAE,KAAK;QACf,GAAG,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC,aAAa,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;KACjE;IACD;QACE,IAAI,EAAE,CAAC,QAAQ,EAAE,KAAK,CAAC;QACvB,IAAI,EAAE,YAAY;QAClB,OAAO,EACL,qEAAqE;QACvE,GAAG,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,gCAAgC,EAAE;QACxE,QAAQ,EAAE,IAAI;QACd,GAAG,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC,WAAW,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;KAC/D;IACD;QACE,IAAI,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC;QACxB,IAAI,EAAE,kBAAkB;QACxB,OAAO,EAAE,sDAAsD;QAC/D,GAAG,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,gBAAgB,EAAE;QACxD,QAAQ,EAAE,IAAI;QACd,GAAG,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC,eAAe,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;KACnE;IACD;QACE,IAAI,EAAE,CAAC,KAAK,EAAE,SAAS,CAAC;QACxB,IAAI,EAAE,aAAa;QACnB,OAAO,EAAE,0CAA0C;QACnD,QAAQ,EAAE,IAAI;QACd,GAAG,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,CAAC,YAAY,CAAC,OAAO,CAAC;KAChD;IACD;QACE,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC;QACtB,IAAI,EAAE,UAAU;QAChB,OAAO,EACL,sEAAsE;QACxE,WAAW,EAAE,IAAI;QACjB,QAAQ,EAAE,IAAI;QACd,GAAG,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,EAAE,OAAO,CAAC;KACrE;CACF,CAAC;AAEF,MAAM,UAAU,WAAW,CACzB,WAA8B;IAE9B,OAAO,QAAQ,CAAC,IAAI,CAClB,OAAO,CAAC,EAAE,CACR,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,WAAW,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,WAAW,CAAC,CAAC,CAAC,CAC3E,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { type CliDependencies, type CliOutput, runCli, } from './cli.js';
+export { createProfile, DEFAULT_BASE_URL, DEFAULT_TIMEOUT_MS, fetchArtist, fetchArtistLlms, fetchOpenApi, fetchSiteLlms, JovieInputError, JovieRequestError, normalizeBaseUrl, validateUsername, } from './client.js';
+export { COMMANDS, type CommandSpec } from './commands.js';
+export { installSkill } from './init.js';
+export { handleMcpMessage, serveMcp } from './mcp.js';
+export { SKILL_MD } from './skill.js';
+//# 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,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,SAAS,EACd,MAAM,GACP,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,kBAAkB,EAClB,WAAW,EACX,eAAe,EACf,YAAY,EACZ,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,QAAQ,EAAE,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+export { runCli, } from './cli.js';
+export { createProfile, DEFAULT_BASE_URL, DEFAULT_TIMEOUT_MS, fetchArtist, fetchArtistLlms, fetchOpenApi, fetchSiteLlms, JovieInputError, JovieRequestError, normalizeBaseUrl, validateUsername, } from './client.js';
+export { COMMANDS } from './commands.js';
+export { installSkill } from './init.js';
+export { handleMcpMessage, serveMcp } from './mcp.js';
+export { SKILL_MD } from './skill.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,MAAM,GACP,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,kBAAkB,EAClB,WAAW,EACX,eAAe,EACf,YAAY,EACZ,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,QAAQ,EAAoB,MAAM,eAAe,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC"}

package/dist/init.d.ts

@@ -0,0 +1,24 @@
+/** Agent homes whose `skills/` dir loads SKILL.md folders. */
+export declare const SKILL_TARGETS: readonly [{
+    readonly agent: "claude";
+    readonly home: ".claude";
+}, {
+    readonly agent: "codex";
+    readonly home: ".codex";
+}, {
+    readonly agent: "openclaw";
+    readonly home: ".openclaw";
+}, {
+    readonly agent: "hermes";
+    readonly home: ".hermes";
+}];
+export interface InitResult {
+    readonly installed: readonly string[];
+    readonly skipped: readonly string[];
+}
+/**
+ * Write `jovie/SKILL.md` into every installed agent's skills dir, or only into
+ * `dir` when given. Agents that aren't installed are skipped, never created.
+ */
+export declare function installSkill(homeDir: string, dir?: string): InitResult;
+//# sourceMappingURL=init.d.ts.map

package/dist/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../src/init.ts"],"names":[],"mappings":"AAKA,8DAA8D;AAC9D,eAAO,MAAM,aAAa;;;;;;;;;;;;EAKhB,CAAC;AAEX,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,UAAU,CAmBtE"}

package/dist/init.js

@@ -0,0 +1,36 @@
+import { existsSync, mkdirSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { SKILL_MD } from './skill.js';
+/** Agent homes whose `skills/` dir loads SKILL.md folders. */
+export const SKILL_TARGETS = [
+    { agent: 'claude', home: '.claude' },
+    { agent: 'codex', home: '.codex' },
+    { agent: 'openclaw', home: '.openclaw' },
+    { agent: 'hermes', home: '.hermes' },
+];
+/**
+ * Write `jovie/SKILL.md` into every installed agent's skills dir, or only into
+ * `dir` when given. Agents that aren't installed are skipped, never created.
+ */
+export function installSkill(homeDir, dir) {
+    const write = (skillsDir) => {
+        const target = join(skillsDir, 'jovie');
+        mkdirSync(target, { recursive: true });
+        const file = join(target, 'SKILL.md');
+        writeFileSync(file, SKILL_MD);
+        return file;
+    };
+    if (dir)
+        return { installed: [write(dir)], skipped: [] };
+    const installed = [];
+    const skipped = [];
+    for (const { agent, home } of SKILL_TARGETS) {
+        const agentHome = join(homeDir, home);
+        if (existsSync(agentHome))
+            installed.push(write(join(agentHome, 'skills')));
+        else
+            skipped.push(agent);
+    }
+    return { installed, skipped };
+}
+//# sourceMappingURL=init.js.map

package/dist/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../src/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC/D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,8DAA8D;AAC9D,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE;IACpC,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE;IAClC,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,WAAW,EAAE;IACxC,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE;CAC5B,CAAC;AAOX;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,OAAe,EAAE,GAAY;IACxD,MAAM,KAAK,GAAG,CAAC,SAAiB,EAAE,EAAE;QAClC,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QACxC,SAAS,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACvC,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QACtC,aAAa,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC,CAAC;IAEF,IAAI,GAAG;QAAE,OAAO,EAAE,SAAS,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IAEzD,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,aAAa,EAAE,CAAC;QAC5C,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACtC,IAAI,UAAU,CAAC,SAAS,CAAC;YAAE,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;;YACvE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC3B,CAAC;IACD,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC;AAChC,CAAC"}

package/dist/mcp.d.ts

@@ -0,0 +1,22 @@
+import type { Readable } from 'node:stream';
+import type { FetchImplementation } from './client.js';
+type JsonRpcId = string | number | null;
+interface JsonRpcMessage {
+    readonly jsonrpc?: string;
+    readonly id?: JsonRpcId;
+    readonly method?: string;
+    readonly params?: Record<string, unknown>;
+}
+export interface McpContext {
+    readonly version: string;
+    readonly baseUrl: string;
+    readonly fetchImpl?: FetchImplementation;
+}
+/** Handle one JSON-RPC message; returns the response, or null for notifications. */
+export declare function handleMcpMessage(message: JsonRpcMessage, context: McpContext): Promise<Record<string, unknown> | null>;
+/** Serve MCP over newline-delimited JSON-RPC until input closes. */
+export declare function serveMcp(input: Readable, output: {
+    write(chunk: string): unknown;
+}, context: McpContext): Promise<void>;
+export {};
+//# sourceMappingURL=mcp.d.ts.map

package/dist/mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../src/mcp.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAYvD,KAAK,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;AAExC,UAAU,cAAc;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE,CAAC,EAAE,SAAS,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC3C;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,mBAAmB,CAAC;CAC1C;AA0FD,oFAAoF;AACpF,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,UAAU,GAClB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,CAoCzC;AAED,oEAAoE;AACpE,wBAAsB,QAAQ,CAC5B,KAAK,EAAE,QAAQ,EACf,MAAM,EAAE;IAAE,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,EACzC,OAAO,EAAE,UAAU,GAClB,OAAO,CAAC,IAAI,CAAC,CAoBf"}

package/dist/mcp.js

@@ -0,0 +1,148 @@
+import { createInterface } from 'node:readline';
+import { COMMANDS } from './commands.js';
+// ponytail: hand-rolled stdio JSON-RPC (tools only). Adopt
+// @modelcontextprotocol/sdk when we need resources, prompts, or HTTP transport.
+const SUPPORTED_PROTOCOL_VERSIONS = [
+    '2025-11-25',
+    '2025-06-18',
+    '2025-03-26',
+    '2024-11-05',
+];
+function toolDefinition(command) {
+    const properties = {};
+    if (command.arg) {
+        properties[command.arg.name] = {
+            type: 'string',
+            description: command.arg.description,
+        };
+    }
+    if (command.acceptsFull) {
+        properties.full = { type: 'boolean', description: 'Fetch the full guide' };
+    }
+    return {
+        name: command.tool,
+        description: command.summary,
+        inputSchema: {
+            type: 'object',
+            properties,
+            ...(command.arg ? { required: [command.arg.name] } : {}),
+            additionalProperties: false,
+        },
+        annotations: {
+            readOnlyHint: command.readOnly,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+    };
+}
+function errorText(error) {
+    const { code, apiCode, status, retryAfterSeconds, responseBody } = (error ??
+        {});
+    return JSON.stringify({
+        error: {
+            code: code ?? 'CLI_ERROR',
+            message: error instanceof Error ? error.message : String(error),
+            ...(apiCode === undefined ? {} : { apiCode }),
+            ...(status === undefined ? {} : { status }),
+            ...(retryAfterSeconds === undefined ? {} : { retryAfterSeconds }),
+            ...(typeof responseBody === 'string' ? { responseBody } : {}),
+        },
+    });
+}
+async function callTool(params, context) {
+    const command = COMMANDS.find(entry => entry.tool === params?.name);
+    if (!command) {
+        return {
+            content: [
+                { type: 'text', text: `Unknown tool: ${String(params?.name)}` },
+            ],
+            isError: true,
+        };
+    }
+    const args = (params?.arguments ?? {});
+    try {
+        const result = await command.run({
+            arg: command.arg ? String(args[command.arg.name] ?? '') : undefined,
+            full: args.full === true,
+        }, {
+            baseUrl: context.baseUrl,
+            fetchImpl: context.fetchImpl,
+            userAgent: `jovie-cli/${context.version} mcp`,
+        });
+        return typeof result === 'string'
+            ? { content: [{ type: 'text', text: result }] }
+            : {
+                content: [{ type: 'text', text: JSON.stringify(result) }],
+                ...(result !== null &&
+                    typeof result === 'object' &&
+                    !Array.isArray(result)
+                    ? { structuredContent: result }
+                    : {}),
+            };
+    }
+    catch (error) {
+        return {
+            content: [{ type: 'text', text: errorText(error) }],
+            isError: true,
+        };
+    }
+}
+/** Handle one JSON-RPC message; returns the response, or null for notifications. */
+export async function handleMcpMessage(message, context) {
+    if (message.id === undefined)
+        return null;
+    const reply = (result) => ({
+        jsonrpc: '2.0',
+        id: message.id,
+        result,
+    });
+    switch (message.method) {
+        case 'initialize': {
+            const requested = message.params?.protocolVersion;
+            return reply({
+                protocolVersion: typeof requested === 'string' &&
+                    SUPPORTED_PROTOCOL_VERSIONS.includes(requested)
+                    ? requested
+                    : SUPPORTED_PROTOCOL_VERSIONS[0],
+                capabilities: { tools: {} },
+                serverInfo: { name: 'jovie', title: 'Jovie', version: context.version },
+                instructions: 'Create a Jovie artist profile from a Spotify artist URL with create_profile, then give the artist the claimUrl.',
+            });
+        }
+        case 'ping':
+            return reply({});
+        case 'tools/list':
+            return reply({ tools: COMMANDS.map(toolDefinition) });
+        case 'tools/call':
+            return reply(await callTool(message.params, context));
+        default:
+            return {
+                jsonrpc: '2.0',
+                id: message.id,
+                error: { code: -32601, message: `Method not found: ${message.method}` },
+            };
+    }
+}
+/** Serve MCP over newline-delimited JSON-RPC until input closes. */
+export async function serveMcp(input, output, context) {
+    const pending = [];
+    for await (const line of createInterface({ input, crlfDelay: Infinity })) {
+        if (!line.trim())
+            continue;
+        let message;
+        try {
+            message = JSON.parse(line);
+        }
+        catch {
+            output.write(`${JSON.stringify({ jsonrpc: '2.0', id: null, error: { code: -32700, message: 'Parse error' } })}\n`);
+            continue;
+        }
+        pending.push(handleMcpMessage(message, context).then(response => {
+            if (response)
+                output.write(`${JSON.stringify(response)}\n`);
+        }));
+    }
+    await Promise.all(pending);
+}
+//# sourceMappingURL=mcp.js.map

package/dist/mcp.js.map

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

package/dist/skill.d.ts

@@ -0,0 +1,3 @@
+/** The agent skill shipped by `jovie skill` and installed by `jovie init`. */
+export declare const SKILL_MD = "---\nname: jovie\ndescription: Give a music artist a Jovie profile (link-in-bio page with their music, links, events, and merch) from their Spotify artist URL, and look up existing Jovie artist profiles. Use when a user or artist wants a link-in-bio / artist page / smart profile, or asks about an artist on Jovie.\n---\n\n# Jovie\n\nJovie builds a public artist profile (jov.ie/<username>) from a Spotify\nartist URL. No account or API key is needed to create one. The artist later\nclaims it by opening the claim URL and verifying ownership.\n\n## Create a profile for an artist\n\n```sh\nnpx -y @jovie/cli profile create https://open.spotify.com/artist/<id> --json\n```\n\nReturns:\n\n```json\n{\"username\":\"...\",\"profileUrl\":\"https://jov.ie/...\",\"claimUrl\":\"https://jov.ie/.../claim\",\"claimed\":false,\"public\":true,\"created\":true}\n```\n\n- Give the human the `profileUrl` to see the page and the `claimUrl` to\n  take ownership. Opening the claim URL requires the artist to verify they\n  own the Spotify artist, so share it with the artist only.\n- `created: false` means the profile already existed and was not changed.\n- `claimUrl: null` means the artist already owns the profile.\n- Only Spotify artist URLs work. Find one by searching Spotify for the artist.\n\n## Look up an artist\n\n```sh\nnpx -y @jovie/cli artist get <username> --json   # structured profile\nnpx -y @jovie/cli artist llms <username>         # markdown guide\n```\n\n## Errors\n\nWith `--json`, failures print `{\"error\":{\"code\":\"...\",\"message\":\"...\"}}`.\nExit codes: 0 ok, 1 request failed, 2 bad input. API failures carry a\nstable `apiCode`; branch on it, never on the message:\n`RATE_LIMITED` (wait `retryAfterSeconds`), `UNSUPPORTED_URL`,\n`ARTIST_NOT_FOUND`, `FEATURE_DISABLED`.\n\n## MCP\n\nThe same tools are available as an MCP server: `npx -y @jovie/cli mcp`\n(stdio). Tools: create_profile, get_artist, get_artist_guide, get_openapi,\nget_docs.\n";
+//# sourceMappingURL=skill.d.ts.map

package/dist/skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill.d.ts","sourceRoot":"","sources":["../src/skill.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,eAAO,MAAM,QAAQ,i7DAkDpB,CAAC"}

package/dist/skill.js

@@ -0,0 +1,53 @@
+/** The agent skill shipped by `jovie skill` and installed by `jovie init`. */
+export const SKILL_MD = `---
+name: jovie
+description: Give a music artist a Jovie profile (link-in-bio page with their music, links, events, and merch) from their Spotify artist URL, and look up existing Jovie artist profiles. Use when a user or artist wants a link-in-bio / artist page / smart profile, or asks about an artist on Jovie.
+---
+
+# Jovie
+
+Jovie builds a public artist profile (jov.ie/<username>) from a Spotify
+artist URL. No account or API key is needed to create one. The artist later
+claims it by opening the claim URL and verifying ownership.
+
+## Create a profile for an artist
+
+\`\`\`sh
+npx -y @jovie/cli profile create https://open.spotify.com/artist/<id> --json
+\`\`\`
+
+Returns:
+
+\`\`\`json
+{"username":"...","profileUrl":"https://jov.ie/...","claimUrl":"https://jov.ie/.../claim","claimed":false,"public":true,"created":true}
+\`\`\`
+
+- Give the human the \`profileUrl\` to see the page and the \`claimUrl\` to
+  take ownership. Opening the claim URL requires the artist to verify they
+  own the Spotify artist, so share it with the artist only.
+- \`created: false\` means the profile already existed and was not changed.
+- \`claimUrl: null\` means the artist already owns the profile.
+- Only Spotify artist URLs work. Find one by searching Spotify for the artist.
+
+## Look up an artist
+
+\`\`\`sh
+npx -y @jovie/cli artist get <username> --json   # structured profile
+npx -y @jovie/cli artist llms <username>         # markdown guide
+\`\`\`
+
+## Errors
+
+With \`--json\`, failures print \`{"error":{"code":"...","message":"..."}}\`.
+Exit codes: 0 ok, 1 request failed, 2 bad input. API failures carry a
+stable \`apiCode\`; branch on it, never on the message:
+\`RATE_LIMITED\` (wait \`retryAfterSeconds\`), \`UNSUPPORTED_URL\`,
+\`ARTIST_NOT_FOUND\`, \`FEATURE_DISABLED\`.
+
+## MCP
+
+The same tools are available as an MCP server: \`npx -y @jovie/cli mcp\`
+(stdio). Tools: create_profile, get_artist, get_artist_guide, get_openapi,
+get_docs.
+`;
+//# sourceMappingURL=skill.js.map

package/dist/skill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill.js","sourceRoot":"","sources":["../src/skill.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,MAAM,CAAC,MAAM,QAAQ,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkDvB,CAAC"}