@musicpal/pianopal-upload 0.1.0

package/README.md

@@ -0,0 +1,69 @@
+# @musicpal/pianopal-upload
+
+Puts a media file into the PianoPal library from the machine that holds it, for
+partners who author courses over the PianoPal MCP.
+
+An AI assistant can start and confirm an upload through the MCP, but the bytes
+never pass through a tool call — something on the machine has to send them. This
+package is that something, in two forms:
+
+- a **command line**, for assistants that can run commands (Claude Code, Cursor,
+  Codex);
+- a **local MCP server**, for assistants that cannot (Claude Desktop): it exposes
+  one tool, `upload_local_file`, and does the upload itself.
+
+Video is uploaded with the resumable protocol Cloudflare Stream requires; every
+other type by a single `PUT`. Which one applies is decided by the server per file.
+
+## Setup
+
+Node.js 18 or newer. Export your partner API key — it is read from the
+environment and never accepted as a flag:
+
+```bash
+export PIANOPAL_API_KEY="mp_live_XXXXXXXX.YYYYYYYYYYYYYYYYYYYYYYYY"
+```
+
+Optional: `PIANOPAL_APP_ID` (default `com.musicpal.partner.mcp`) and
+`PIANOPAL_MCP_URL` (default production) when PianoPal has pointed you at a test
+server.
+
+## Command line
+
+```bash
+npx @musicpal/pianopal-upload ./intro.mp4 --type video --title "Course intro"
+npx @musicpal/pianopal-upload ./cover.png --type image --unique-name course-cover --json
+```
+
+Types: `image`, `thumbnail_image`, `audio_mp3`, `audio_wav`, `audio_aac`,
+`static_voice`, `musicxml`, `video`. The content type is inferred from the
+extension; pass `--mime-type` when it cannot be.
+
+The result names the `assetId` to reference from a step. A video is confirmed
+before it is playable: poll `asset_get` over the MCP until `ready` is true.
+
+## Local MCP server (Claude Desktop)
+
+Add it next to the PianoPal connector in `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "pianopal-upload": {
+      "command": "npx",
+      "args": ["-y", "@musicpal/pianopal-upload", "--mcp"],
+      "env": {
+        "PIANOPAL_API_KEY": "mp_live_XXXXXXXX.YYYYYYYYYYYYYYYYYYYYYYYY"
+      }
+    }
+  }
+}
+```
+
+The assistant then has `upload_local_file({ path, type, title?, uniqueName?,
+mimeType? })`, which starts, transfers and confirms the upload in one call.
+
+## Exit codes
+
+`0` done, `1` the command line did not form a command, `2` the upload did not
+complete (the message names the step and the server's reason).

package/dist/bin.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/bin.js

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const run_cli_1 = require("./cli/run-cli");
+void (0, run_cli_1.runCli)(process.argv.slice(2), {
+    stdout: (text) => process.stdout.write(`${text}\n`),
+    stderr: (text) => process.stderr.write(`${text}\n`),
+}).then((code) => {
+    if (code !== 0 || !process.argv.includes('--mcp')) {
+        process.exitCode = code;
+    }
+});
+//# sourceMappingURL=bin.js.map

package/dist/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";;;AACA,2CAAsC;AAEtC,KAAK,IAAA,gBAAM,EAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;IACjC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC;IACnD,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC;CACpD,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE;IAEf,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QAClD,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAA;IACzB,CAAC;AACH,CAAC,CAAC,CAAA"}

package/dist/cli/cli-command.type.d.ts

@@ -0,0 +1,10 @@
+import { UploadRequest } from '../upload/upload-request.interface';
+export type CliCommand = {
+    readonly kind: 'upload';
+    readonly request: UploadRequest;
+    readonly json: boolean;
+} | {
+    readonly kind: 'mcp';
+} | {
+    readonly kind: 'help';
+};

package/dist/cli/cli-command.type.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=cli-command.type.js.map

package/dist/cli/cli-command.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-command.type.js","sourceRoot":"","sources":["../../src/cli/cli-command.type.ts"],"names":[],"mappings":""}

package/dist/cli/format-upload-summary.d.ts

@@ -0,0 +1,2 @@
+import { UploadResult } from '../upload/upload-result.interface';
+export declare const formatUploadSummary: (result: UploadResult) => string;

package/dist/cli/format-upload-summary.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatUploadSummary = void 0;
+const formatUploadSummary = (result) => [
+    `Uploaded ${result.fileSizeBytes} bytes by ${result.method}.`,
+    `assetId: ${result.assetId}`,
+    `type: ${result.asset.type}`,
+    `ready: ${result.asset.ready ? 'yes' : 'no'}` +
+        (result.asset.videoProcessingStatus === null
+            ? ''
+            : ` (encoding: ${result.asset.videoProcessingStatus})`),
+    result.nextStep,
+].join('\n');
+exports.formatUploadSummary = formatUploadSummary;
+//# sourceMappingURL=format-upload-summary.js.map

package/dist/cli/format-upload-summary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-upload-summary.js","sourceRoot":"","sources":["../../src/cli/format-upload-summary.ts"],"names":[],"mappings":";;;AAQO,MAAM,mBAAmB,GAAG,CAAC,MAAoB,EAAU,EAAE,CAClE;IACE,YAAY,MAAM,CAAC,aAAa,aAAa,MAAM,CAAC,MAAM,GAAG;IAC7D,YAAY,MAAM,CAAC,OAAO,EAAE;IAC5B,SAAS,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE;IAC5B,UAAU,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE;QAC3C,CAAC,MAAM,CAAC,KAAK,CAAC,qBAAqB,KAAK,IAAI;YAC1C,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,eAAe,MAAM,CAAC,KAAK,CAAC,qBAAqB,GAAG,CAAC;IAC3D,MAAM,CAAC,QAAQ;CAChB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AAVD,QAAA,mBAAmB,uBAUlB"}

package/dist/cli/parse-cli-args.d.ts

@@ -0,0 +1,2 @@
+import { CliCommand } from './cli-command.type';
+export declare const parseCliArgs: (argv: readonly string[]) => CliCommand;

package/dist/cli/parse-cli-args.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseCliArgs = void 0;
+const node_util_1 = require("node:util");
+const asset_type_1 = require("../upload/asset-type");
+const parseCliArgs = (argv) => {
+    const { values, positionals } = (0, node_util_1.parseArgs)({
+        args: [...argv],
+        allowPositionals: true,
+        options: {
+            type: { type: 'string' },
+            title: { type: 'string' },
+            'unique-name': { type: 'string' },
+            'mime-type': { type: 'string' },
+            json: { type: 'boolean', default: false },
+            mcp: { type: 'boolean', default: false },
+            help: { type: 'boolean', short: 'h', default: false },
+        },
+    });
+    if (values.help) {
+        return { kind: 'help' };
+    }
+    if (values.mcp) {
+        return { kind: 'mcp' };
+    }
+    const [filePath, ...rest] = positionals;
+    if (filePath === undefined) {
+        throw new Error('Name the file to upload, or pass --mcp to run as an MCP server.');
+    }
+    if (rest.length > 0) {
+        throw new Error(`One file per run; unexpected: ${rest.join(' ')}`);
+    }
+    if (values.type === undefined) {
+        throw new Error(`--type is required; one of ${asset_type_1.ASSET_TYPES.join(', ')}.`);
+    }
+    if (!(0, asset_type_1.isAssetType)(values.type)) {
+        throw new Error(`Unknown --type "${values.type}"; one of ${asset_type_1.ASSET_TYPES.join(', ')}.`);
+    }
+    return {
+        kind: 'upload',
+        json: values.json,
+        request: {
+            filePath,
+            type: values.type,
+            mimeType: values['mime-type'],
+            title: values.title,
+            uniqueName: values['unique-name'],
+        },
+    };
+};
+exports.parseCliArgs = parseCliArgs;
+//# sourceMappingURL=parse-cli-args.js.map

package/dist/cli/parse-cli-args.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-cli-args.js","sourceRoot":"","sources":["../../src/cli/parse-cli-args.ts"],"names":[],"mappings":";;;AAAA,yCAAqC;AACrC,qDAA+D;AAcxD,MAAM,YAAY,GAAG,CAAC,IAAuB,EAAc,EAAE;IAClE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,IAAA,qBAAS,EAAC;QACxC,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC;QACf,gBAAgB,EAAE,IAAI;QACtB,OAAO,EAAE;YACP,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACxB,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACzB,aAAa,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACjC,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC/B,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE;YACzC,GAAG,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE;YACxC,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE;SACtD;KACF,CAAC,CAAA;IAEF,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QAChB,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAA;IACzB,CAAC;IAED,IAAI,MAAM,CAAC,GAAG,EAAE,CAAC;QACf,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAA;IACxB,CAAC;IAED,MAAM,CAAC,QAAQ,EAAE,GAAG,IAAI,CAAC,GAAG,WAAW,CAAA;IACvC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,iEAAiE,CAAC,CAAA;IACpF,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,iCAAiC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;IACpE,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,8BAA8B,wBAAW,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IAC1E,CAAC;IACD,IAAI,CAAC,IAAA,wBAAW,EAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,mBAAmB,MAAM,CAAC,IAAI,aAAa,wBAAW,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IACvF,CAAC;IAED,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,OAAO,EAAE;YACP,QAAQ;YACR,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,QAAQ,EAAE,MAAM,CAAC,WAAW,CAAC;YAC7B,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,UAAU,EAAE,MAAM,CAAC,aAAa,CAAC;SAClC;KACF,CAAA;AACH,CAAC,CAAA;AAhDY,QAAA,YAAY,gBAgDxB"}

package/dist/cli/run-cli.d.ts

@@ -0,0 +1,7 @@
+export declare const EXIT_USAGE = 1;
+export declare const EXIT_FAILED = 2;
+export interface CliIo {
+    readonly stdout: (text: string) => void;
+    readonly stderr: (text: string) => void;
+}
+export declare const runCli: (argv: readonly string[], io: CliIo) => Promise<number>;

package/dist/cli/run-cli.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runCli = exports.EXIT_FAILED = exports.EXIT_USAGE = void 0;
+const pianopal_mcp_client_1 = require("../client/pianopal-mcp-client");
+const load_uploader_config_1 = require("../config/load-uploader-config");
+const run_mcp_server_1 = require("../mcp/run-mcp-server");
+const upload_local_file_1 = require("../upload/upload-local-file");
+const format_upload_summary_1 = require("./format-upload-summary");
+const parse_cli_args_1 = require("./parse-cli-args");
+const usage_text_1 = require("./usage-text");
+exports.EXIT_USAGE = 1;
+exports.EXIT_FAILED = 2;
+const runCli = async (argv, io) => {
+    let command;
+    try {
+        command = (0, parse_cli_args_1.parseCliArgs)(argv);
+    }
+    catch (error) {
+        io.stderr(`${messageOf(error)}\n\n${usage_text_1.USAGE_TEXT}`);
+        return exports.EXIT_USAGE;
+    }
+    if (command.kind === 'help') {
+        io.stdout(usage_text_1.USAGE_TEXT);
+        return 0;
+    }
+    if (command.kind === 'mcp') {
+        await (0, run_mcp_server_1.runMcpServer)();
+        return 0;
+    }
+    try {
+        const config = (0, load_uploader_config_1.loadUploaderConfig)();
+        const result = await (0, upload_local_file_1.uploadLocalFile)(command.request, {
+            openSession: () => pianopal_mcp_client_1.PianopalMcpClient.connect(config),
+            onProgress: (sent, total) => io.stderr(`${Math.floor((sent / total) * 100)}% (${sent}/${total} bytes)`),
+        });
+        io.stdout(command.json ? JSON.stringify(result, null, 2) : (0, format_upload_summary_1.formatUploadSummary)(result));
+        return 0;
+    }
+    catch (error) {
+        io.stderr(`Upload failed: ${messageOf(error)}`);
+        return exports.EXIT_FAILED;
+    }
+};
+exports.runCli = runCli;
+const messageOf = (error) => error instanceof Error ? error.message : String(error);
+//# sourceMappingURL=run-cli.js.map

package/dist/cli/run-cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-cli.js","sourceRoot":"","sources":["../../src/cli/run-cli.ts"],"names":[],"mappings":";;;AAAA,uEAAiE;AACjE,yEAAmE;AACnE,0DAAoD;AACpD,mEAA6D;AAC7D,mEAA6D;AAC7D,qDAA+C;AAC/C,6CAAyC;AAG5B,QAAA,UAAU,GAAG,CAAC,CAAA;AAGd,QAAA,WAAW,GAAG,CAAC,CAAA;AAkBrB,MAAM,MAAM,GAAG,KAAK,EAAE,IAAuB,EAAE,EAAS,EAAmB,EAAE;IAClF,IAAI,OAAwC,CAAA;IAC5C,IAAI,CAAC;QACH,OAAO,GAAG,IAAA,6BAAY,EAAC,IAAI,CAAC,CAAA;IAC9B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,EAAE,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC,KAAK,CAAC,OAAO,uBAAU,EAAE,CAAC,CAAA;QACjD,OAAO,kBAAU,CAAA;IACnB,CAAC;IAED,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAC5B,EAAE,CAAC,MAAM,CAAC,uBAAU,CAAC,CAAA;QACrB,OAAO,CAAC,CAAA;IACV,CAAC;IAED,IAAI,OAAO,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;QAC3B,MAAM,IAAA,6BAAY,GAAE,CAAA;QACpB,OAAO,CAAC,CAAA;IACV,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAA,yCAAkB,GAAE,CAAA;QACnC,MAAM,MAAM,GAAG,MAAM,IAAA,mCAAe,EAAC,OAAO,CAAC,OAAO,EAAE;YACpD,WAAW,EAAE,GAAG,EAAE,CAAC,uCAAiB,CAAC,OAAO,CAAC,MAAM,CAAC;YACpD,UAAU,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAC1B,EAAE,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,GAAG,KAAK,CAAC,GAAG,GAAG,CAAC,MAAM,IAAI,IAAI,KAAK,SAAS,CAAC;SAC7E,CAAC,CAAA;QACF,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAA,2CAAmB,EAAC,MAAM,CAAC,CAAC,CAAA;QACvF,OAAO,CAAC,CAAA;IACV,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,EAAE,CAAC,MAAM,CAAC,kBAAkB,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;QAC/C,OAAO,mBAAW,CAAA;IACpB,CAAC;AACH,CAAC,CAAA;AAhCY,QAAA,MAAM,UAgClB;AAED,MAAM,SAAS,GAAG,CAAC,KAAc,EAAU,EAAE,CAC3C,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA"}

package/dist/cli/usage-text.d.ts

@@ -0,0 +1 @@
+export declare const USAGE_TEXT: string;

package/dist/cli/usage-text.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.USAGE_TEXT = void 0;
+const asset_type_1 = require("../upload/asset-type");
+const load_uploader_config_1 = require("../config/load-uploader-config");
+exports.USAGE_TEXT = `pianopal-upload — put a media file into the PianoPal library
+
+Usage
+  pianopal-upload <file> --type <type> [--title <text>] [--unique-name <key>]
+                  [--mime-type <type>] [--json]
+  pianopal-upload --mcp
+  pianopal-upload --help
+
+Types
+  ${asset_type_1.ASSET_TYPES.join(', ')}
+
+Options
+  --type         The library category to file it under (required)
+  --title        Human-readable name shown in the library
+  --unique-name  Stable key to look the asset up by later
+  --mime-type    Content type, when it cannot be inferred from the extension
+  --json         Print the result as JSON instead of a summary
+  --mcp          Run as a local MCP server over stdio, exposing upload_local_file
+
+Environment
+  ${load_uploader_config_1.API_KEY_ENV}   Your PianoPal partner API key (required; never a flag)
+  ${load_uploader_config_1.APP_ID_ENV}    Tenant id (default: com.musicpal.partner.mcp)
+  ${load_uploader_config_1.MCP_URL_ENV}   MCP endpoint (default: production)
+`;
+//# sourceMappingURL=usage-text.js.map

package/dist/cli/usage-text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-text.js","sourceRoot":"","sources":["../../src/cli/usage-text.ts"],"names":[],"mappings":";;;AAAA,qDAAkD;AAClD,yEAAqF;AAGxE,QAAA,UAAU,GAAG;;;;;;;;;IAStB,wBAAW,CAAC,IAAI,CAAC,IAAI,CAAC;;;;;;;;;;;IAWtB,kCAAW;IACX,iCAAU;IACV,kCAAW;CACd,CAAA"}

package/dist/client/parse-tool-result.d.ts

@@ -0,0 +1 @@
+export declare const parseToolResult: <T>(tool: string, result: unknown) => T;

package/dist/client/parse-tool-result.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseToolResult = void 0;
+const pianopal_tool_error_1 = require("./pianopal-tool-error");
+const isRecord = (value) => typeof value === 'object' && value !== null;
+const isTextPart = (part) => typeof part === 'object' &&
+    part !== null &&
+    part.type === 'text' &&
+    typeof part.text === 'string';
+const parseToolResult = (tool, result) => {
+    const shape = isRecord(result) ? result : {};
+    const parts = Array.isArray(shape.content) ? shape.content.filter(isTextPart) : [];
+    const first = parts[0];
+    if (shape.isError === true) {
+        throw new pianopal_tool_error_1.PianopalToolError(tool, first?.text ?? 'refused without a message');
+    }
+    if (first === undefined) {
+        throw new pianopal_tool_error_1.PianopalToolError(tool, 'answered without a text part');
+    }
+    try {
+        return JSON.parse(first.text);
+    }
+    catch {
+        throw new pianopal_tool_error_1.PianopalToolError(tool, `answered with something other than JSON: ${first.text}`);
+    }
+};
+exports.parseToolResult = parseToolResult;
+//# sourceMappingURL=parse-tool-result.js.map

package/dist/client/parse-tool-result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-tool-result.js","sourceRoot":"","sources":["../../src/client/parse-tool-result.ts"],"names":[],"mappings":";;;AAAA,+DAAyD;AAQzD,MAAM,QAAQ,GAAG,CAAC,KAAc,EAAoC,EAAE,CACpE,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAA;AAE7C,MAAM,UAAU,GAAG,CAAC,IAAa,EAAoB,EAAE,CACrD,OAAO,IAAI,KAAK,QAAQ;IACxB,IAAI,KAAK,IAAI;IACZ,IAA2B,CAAC,IAAI,KAAK,MAAM;IAC5C,OAAQ,IAA2B,CAAC,IAAI,KAAK,QAAQ,CAAA;AAgBhD,MAAM,eAAe,GAAG,CAAI,IAAY,EAAE,MAAe,EAAK,EAAE;IACrE,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAA;IAC5C,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;IAClF,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAA;IAEtB,IAAI,KAAK,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;QAC3B,MAAM,IAAI,uCAAiB,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,IAAI,2BAA2B,CAAC,CAAA;IAC/E,CAAC;IAED,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,MAAM,IAAI,uCAAiB,CAAC,IAAI,EAAE,8BAA8B,CAAC,CAAA;IACnE,CAAC;IAED,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAM,CAAA;IACpC,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,uCAAiB,CAAC,IAAI,EAAE,4CAA4C,KAAK,CAAC,IAAI,EAAE,CAAC,CAAA;IAC7F,CAAC;AACH,CAAC,CAAA;AAlBY,QAAA,eAAe,mBAkB3B"}

package/dist/client/pianopal-mcp-client.d.ts

@@ -0,0 +1,11 @@
+import { UploaderConfig } from '../config/uploader-config.interface';
+export interface PianopalToolCaller {
+    callTool<T>(name: string, args: Record<string, unknown>): Promise<T>;
+}
+export declare class PianopalMcpClient implements PianopalToolCaller {
+    private readonly client;
+    private constructor();
+    static connect(config: UploaderConfig): Promise<PianopalMcpClient>;
+    callTool<T>(name: string, args: Record<string, unknown>): Promise<T>;
+    close(): Promise<void>;
+}

package/dist/client/pianopal-mcp-client.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PianopalMcpClient = void 0;
+const index_js_1 = require("@modelcontextprotocol/sdk/client/index.js");
+const streamableHttp_js_1 = require("@modelcontextprotocol/sdk/client/streamableHttp.js");
+const load_uploader_config_1 = require("../config/load-uploader-config");
+const parse_tool_result_1 = require("./parse-tool-result");
+const CLIENT_NAME = 'pianopal-upload';
+const CLIENT_VERSION = '0.1.0';
+class PianopalMcpClient {
+    constructor(client) {
+        this.client = client;
+    }
+    static async connect(config) {
+        const transport = new streamableHttp_js_1.StreamableHTTPClientTransport(new URL(config.mcpUrl), {
+            requestInit: {
+                headers: {
+                    Authorization: `Bearer ${config.apiKey}`,
+                    'X-App-Id': config.appId,
+                },
+            },
+        });
+        const client = new index_js_1.Client({ name: CLIENT_NAME, version: CLIENT_VERSION });
+        try {
+            await client.connect(transport);
+        }
+        catch (error) {
+            throw new Error(`Could not connect to the PianoPal MCP at ${config.mcpUrl}. Check ${load_uploader_config_1.API_KEY_ENV} and ` +
+                `${load_uploader_config_1.APP_ID_ENV}. ${error instanceof Error ? error.message : String(error)}`);
+        }
+        return new PianopalMcpClient(client);
+    }
+    async callTool(name, args) {
+        const result = await this.client.callTool({ name, arguments: args });
+        return (0, parse_tool_result_1.parseToolResult)(name, result);
+    }
+    async close() {
+        await this.client.close();
+    }
+}
+exports.PianopalMcpClient = PianopalMcpClient;
+//# sourceMappingURL=pianopal-mcp-client.js.map

package/dist/client/pianopal-mcp-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pianopal-mcp-client.js","sourceRoot":"","sources":["../../src/client/pianopal-mcp-client.ts"],"names":[],"mappings":";;;AAAA,wEAAkE;AAClE,0FAAkG;AAElG,yEAAwE;AAExE,2DAAqD;AAGrD,MAAM,WAAW,GAAG,iBAAiB,CAAA;AAGrC,MAAM,cAAc,GAAG,OAAO,CAAA;AA0B9B,MAAa,iBAAiB;IAC5B,YAAqC,MAAc;QAAd,WAAM,GAAN,MAAM,CAAQ;IAAG,CAAC;IASvD,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,MAAsB;QACzC,MAAM,SAAS,GAAG,IAAI,iDAA6B,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE;YAC1E,WAAW,EAAE;gBACX,OAAO,EAAE;oBACP,aAAa,EAAE,UAAU,MAAM,CAAC,MAAM,EAAE;oBACxC,UAAU,EAAE,MAAM,CAAC,KAAK;iBACzB;aACF;SACF,CAAC,CAAA;QACF,MAAM,MAAM,GAAG,IAAI,iBAAM,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC,CAAA;QACzE,IAAI,CAAC;YAIH,MAAM,MAAM,CAAC,OAAO,CAAC,SAAsB,CAAC,CAAA;QAC9C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAGf,MAAM,IAAI,KAAK,CACb,4CAA4C,MAAM,CAAC,MAAM,WAAW,kCAAW,OAAO;gBACpF,GAAG,iCAAU,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAC7E,CAAA;QACH,CAAC;QAED,OAAO,IAAI,iBAAiB,CAAC,MAAM,CAAC,CAAA;IACtC,CAAC;IAED,KAAK,CAAC,QAAQ,CAAI,IAAY,EAAE,IAA6B;QAC3D,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;QAEpE,OAAO,IAAA,mCAAe,EAAI,IAAI,EAAE,MAAM,CAAC,CAAA;IACzC,CAAC;IAGD,KAAK,CAAC,KAAK;QACT,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAA;IAC3B,CAAC;CACF;AA/CD,8CA+CC"}

package/dist/client/pianopal-tool-error.d.ts

@@ -0,0 +1,4 @@
+export declare class PianopalToolError extends Error {
+    readonly tool: string;
+    constructor(tool: string, message: string);
+}

package/dist/client/pianopal-tool-error.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PianopalToolError = void 0;
+class PianopalToolError extends Error {
+    constructor(tool, message) {
+        super(`${tool}: ${message}`);
+        this.tool = tool;
+        this.name = 'PianopalToolError';
+    }
+}
+exports.PianopalToolError = PianopalToolError;
+//# sourceMappingURL=pianopal-tool-error.js.map

package/dist/client/pianopal-tool-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pianopal-tool-error.js","sourceRoot":"","sources":["../../src/client/pianopal-tool-error.ts"],"names":[],"mappings":";;;AAOA,MAAa,iBAAkB,SAAQ,KAAK;IAC1C,YAEW,IAAY,EACrB,OAAe;QAEf,KAAK,CAAC,GAAG,IAAI,KAAK,OAAO,EAAE,CAAC,CAAA;QAHnB,SAAI,GAAJ,IAAI,CAAQ;QAIrB,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAA;IACjC,CAAC;CACF;AATD,8CASC"}

package/dist/config/load-uploader-config.d.ts

@@ -0,0 +1,7 @@
+import { UploaderConfig } from './uploader-config.interface';
+export declare const API_KEY_ENV = "PIANOPAL_API_KEY";
+export declare const APP_ID_ENV = "PIANOPAL_APP_ID";
+export declare const MCP_URL_ENV = "PIANOPAL_MCP_URL";
+export declare const DEFAULT_APP_ID = "com.musicpal.partner.mcp";
+export declare const DEFAULT_MCP_URL = "https://api.pianopal.ai/api/v1/mcp";
+export declare const loadUploaderConfig: (env?: NodeJS.ProcessEnv) => UploaderConfig;

package/dist/config/load-uploader-config.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadUploaderConfig = exports.DEFAULT_MCP_URL = exports.DEFAULT_APP_ID = exports.MCP_URL_ENV = exports.APP_ID_ENV = exports.API_KEY_ENV = void 0;
+exports.API_KEY_ENV = 'PIANOPAL_API_KEY';
+exports.APP_ID_ENV = 'PIANOPAL_APP_ID';
+exports.MCP_URL_ENV = 'PIANOPAL_MCP_URL';
+exports.DEFAULT_APP_ID = 'com.musicpal.partner.mcp';
+exports.DEFAULT_MCP_URL = 'https://api.pianopal.ai/api/v1/mcp';
+const loadUploaderConfig = (env = process.env) => {
+    const apiKey = env[exports.API_KEY_ENV]?.trim();
+    if (!apiKey) {
+        throw new Error(`${exports.API_KEY_ENV} is not set. Export your PianoPal partner API key in that variable; ` +
+            'it is never accepted as a command-line argument.');
+    }
+    return {
+        mcpUrl: env[exports.MCP_URL_ENV]?.trim() || exports.DEFAULT_MCP_URL,
+        apiKey,
+        appId: env[exports.APP_ID_ENV]?.trim() || exports.DEFAULT_APP_ID,
+    };
+};
+exports.loadUploaderConfig = loadUploaderConfig;
+//# sourceMappingURL=load-uploader-config.js.map

package/dist/config/load-uploader-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-uploader-config.js","sourceRoot":"","sources":["../../src/config/load-uploader-config.ts"],"names":[],"mappings":";;;AAGa,QAAA,WAAW,GAAG,kBAAkB,CAAA;AAGhC,QAAA,UAAU,GAAG,iBAAiB,CAAA;AAG9B,QAAA,WAAW,GAAG,kBAAkB,CAAA;AAGhC,QAAA,cAAc,GAAG,0BAA0B,CAAA;AAG3C,QAAA,eAAe,GAAG,oCAAoC,CAAA;AAa5D,MAAM,kBAAkB,GAAG,CAChC,MAAyB,OAAO,CAAC,GAAG,EACpB,EAAE;IAClB,MAAM,MAAM,GAAG,GAAG,CAAC,mBAAW,CAAC,EAAE,IAAI,EAAE,CAAA;IACvC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CACb,GAAG,mBAAW,sEAAsE;YAClF,kDAAkD,CACrD,CAAA;IACH,CAAC;IAED,OAAO;QACL,MAAM,EAAE,GAAG,CAAC,mBAAW,CAAC,EAAE,IAAI,EAAE,IAAI,uBAAe;QACnD,MAAM;QACN,KAAK,EAAE,GAAG,CAAC,kBAAU,CAAC,EAAE,IAAI,EAAE,IAAI,sBAAc;KACjD,CAAA;AACH,CAAC,CAAA;AAhBY,QAAA,kBAAkB,sBAgB9B"}

package/dist/config/uploader-config.interface.d.ts

@@ -0,0 +1,5 @@
+export interface UploaderConfig {
+    readonly mcpUrl: string;
+    readonly apiKey: string;
+    readonly appId: string;
+}

package/dist/config/uploader-config.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=uploader-config.interface.js.map

package/dist/config/uploader-config.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uploader-config.interface.js","sourceRoot":"","sources":["../../src/config/uploader-config.interface.ts"],"names":[],"mappings":""}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export { PianopalMcpClient } from './client/pianopal-mcp-client';
+export type { PianopalToolCaller } from './client/pianopal-mcp-client';
+export { PianopalToolError } from './client/pianopal-tool-error';
+export { loadUploaderConfig } from './config/load-uploader-config';
+export type { UploaderConfig } from './config/uploader-config.interface';
+export { ASSET_TYPES } from './upload/asset-type';
+export type { AssetType } from './upload/asset-type';
+export { uploadLocalFile } from './upload/upload-local-file';
+export type { UploadRequest } from './upload/upload-request.interface';
+export type { UploadResult } from './upload/upload-result.interface';
+export { runMcpServer } from './mcp/run-mcp-server';

package/dist/index.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runMcpServer = exports.uploadLocalFile = exports.ASSET_TYPES = exports.loadUploaderConfig = exports.PianopalToolError = exports.PianopalMcpClient = void 0;
+var pianopal_mcp_client_1 = require("./client/pianopal-mcp-client");
+Object.defineProperty(exports, "PianopalMcpClient", { enumerable: true, get: function () { return pianopal_mcp_client_1.PianopalMcpClient; } });
+var pianopal_tool_error_1 = require("./client/pianopal-tool-error");
+Object.defineProperty(exports, "PianopalToolError", { enumerable: true, get: function () { return pianopal_tool_error_1.PianopalToolError; } });
+var load_uploader_config_1 = require("./config/load-uploader-config");
+Object.defineProperty(exports, "loadUploaderConfig", { enumerable: true, get: function () { return load_uploader_config_1.loadUploaderConfig; } });
+var asset_type_1 = require("./upload/asset-type");
+Object.defineProperty(exports, "ASSET_TYPES", { enumerable: true, get: function () { return asset_type_1.ASSET_TYPES; } });
+var upload_local_file_1 = require("./upload/upload-local-file");
+Object.defineProperty(exports, "uploadLocalFile", { enumerable: true, get: function () { return upload_local_file_1.uploadLocalFile; } });
+var run_mcp_server_1 = require("./mcp/run-mcp-server");
+Object.defineProperty(exports, "runMcpServer", { enumerable: true, get: function () { return run_mcp_server_1.runMcpServer; } });
+//# 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,oEAAgE;AAAvD,wHAAA,iBAAiB,OAAA;AAE1B,oEAAgE;AAAvD,wHAAA,iBAAiB,OAAA;AAC1B,sEAAkE;AAAzD,0HAAA,kBAAkB,OAAA;AAE3B,kDAAiD;AAAxC,yGAAA,WAAW,OAAA;AAEpB,gEAA4D;AAAnD,oHAAA,eAAe,OAAA;AAGxB,uDAAmD;AAA1C,8GAAA,YAAY,OAAA"}

package/dist/mcp/run-mcp-server.d.ts

@@ -0,0 +1 @@
+export declare const runMcpServer: () => Promise<void>;

package/dist/mcp/run-mcp-server.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runMcpServer = void 0;
+const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const zod_1 = require("zod");
+const pianopal_mcp_client_1 = require("../client/pianopal-mcp-client");
+const load_uploader_config_1 = require("../config/load-uploader-config");
+const asset_type_1 = require("../upload/asset-type");
+const upload_local_file_1 = require("../upload/upload-local-file");
+const SERVER_NAME = 'pianopal-upload';
+const SERVER_VERSION = '0.1.0';
+const INSTRUCTIONS = 'Local uploader for the PianoPal library. Use upload_local_file for a file on this ' +
+    'machine instead of asset_upload_start: it starts, transfers and confirms the upload ' +
+    'in one call, including video. Search the library with asset_search first. A video ' +
+    'is confirmed before it is ready; poll asset_get until ready is true.';
+const runMcpServer = async () => {
+    const config = (0, load_uploader_config_1.loadUploaderConfig)();
+    const server = new mcp_js_1.McpServer({ name: SERVER_NAME, version: SERVER_VERSION }, {
+        instructions: INSTRUCTIONS,
+    });
+    server.registerTool('upload_local_file', {
+        description: 'Upload a file from this machine into the PianoPal library and confirm it. ' +
+            'Returns the assetId to reference from a step. Handles every type, including ' +
+            'video. Search asset_search before uploading something the library may hold.',
+        inputSchema: {
+            path: zod_1.z.string().min(1).describe('Absolute path of the file on this machine'),
+            type: zod_1.z.enum(asset_type_1.ASSET_TYPES).describe('The library category to file it under'),
+            title: zod_1.z.string().max(2000).optional().describe('Human-readable name for the library'),
+            uniqueName: zod_1.z.string().max(500).optional().describe('Stable key to look it up by later'),
+            mimeType: zod_1.z
+                .string()
+                .max(255)
+                .optional()
+                .describe('Content type, when it cannot be inferred from the extension'),
+        },
+    }, async (input) => {
+        try {
+            const result = await (0, upload_local_file_1.uploadLocalFile)({
+                filePath: input.path,
+                type: input.type,
+                title: input.title,
+                uniqueName: input.uniqueName,
+                mimeType: input.mimeType,
+            }, { openSession: () => pianopal_mcp_client_1.PianopalMcpClient.connect(config) });
+            return { content: [{ type: 'text', text: JSON.stringify(result) }] };
+        }
+        catch (error) {
+            return {
+                isError: true,
+                content: [{ type: 'text', text: error instanceof Error ? error.message : String(error) }],
+            };
+        }
+    });
+    await server.connect(new stdio_js_1.StdioServerTransport());
+};
+exports.runMcpServer = runMcpServer;
+//# sourceMappingURL=run-mcp-server.js.map

package/dist/mcp/run-mcp-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-mcp-server.js","sourceRoot":"","sources":["../../src/mcp/run-mcp-server.ts"],"names":[],"mappings":";;;AAAA,oEAAmE;AACnE,wEAAgF;AAChF,6BAAuB;AACvB,uEAAiE;AACjE,yEAAmE;AACnE,qDAAkD;AAClD,mEAA6D;AAG7D,MAAM,WAAW,GAAG,iBAAiB,CAAA;AAGrC,MAAM,cAAc,GAAG,OAAO,CAAA;AAG9B,MAAM,YAAY,GAChB,oFAAoF;IACpF,sFAAsF;IACtF,oFAAoF;IACpF,sEAAsE,CAAA;AAgBjE,MAAM,YAAY,GAAG,KAAK,IAAmB,EAAE;IACpD,MAAM,MAAM,GAAG,IAAA,yCAAkB,GAAE,CAAA;IACnC,MAAM,MAAM,GAAG,IAAI,kBAAS,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,cAAc,EAAE,EAAE;QAC3E,YAAY,EAAE,YAAY;KAC3B,CAAC,CAAA;IAEF,MAAM,CAAC,YAAY,CACjB,mBAAmB,EACnB;QACE,WAAW,EACT,4EAA4E;YAC5E,8EAA8E;YAC9E,6EAA6E;QAC/E,WAAW,EAAE;YACX,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,2CAA2C,CAAC;YAC7E,IAAI,EAAE,OAAC,CAAC,IAAI,CAAC,wBAAW,CAAC,CAAC,QAAQ,CAAC,uCAAuC,CAAC;YAC3E,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qCAAqC,CAAC;YACtF,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;YACxF,QAAQ,EAAE,OAAC;iBACR,MAAM,EAAE;iBACR,GAAG,CAAC,GAAG,CAAC;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,6DAA6D,CAAC;SAC3E;KACF,EACD,KAAK,EAAE,KAAK,EAAE,EAAE;QACd,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAA,mCAAe,EAClC;gBACE,QAAQ,EAAE,KAAK,CAAC,IAAI;gBACpB,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,UAAU,EAAE,KAAK,CAAC,UAAU;gBAC5B,QAAQ,EAAE,KAAK,CAAC,QAAQ;aACzB,EACD,EAAE,WAAW,EAAE,GAAG,EAAE,CAAC,uCAAiB,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CACzD,CAAA;YAED,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAA;QACtE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;aAC1F,CAAA;QACH,CAAC;IACH,CAAC,CACF,CAAA;IAED,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,+BAAoB,EAAE,CAAC,CAAA;AAClD,CAAC,CAAA;AAjDY,QAAA,YAAY,gBAiDxB"}