runpane 2.2.11 → 2.3.0

package/dist/commands.d.ts

@@ -1,12 +1,11 @@
-export type RunpaneCommand = 'help' | 'setup' | 'install' | 'update' | 'version' | 'doctor';
-export type InstallTarget = 'client' | 'daemon';
-export type ArtifactFormat = 'auto' | 'appimage' | 'deb' | 'dmg' | 'zip' | 'exe';
+import { type ArtifactFormat, type InstallTarget, type RunpaneChannel, type RunpaneCommand } from './generated/contract';
+export type { ArtifactFormat, InstallTarget, RunpaneCommand };
 export interface ParsedArgs {
     command: RunpaneCommand;
     helpTopic?: string;
     target: InstallTarget;
     paneVersion: string;
-    channel: 'stable' | 'nightly';
+    channel: RunpaneChannel;
     format: ArtifactFormat;
     downloadDir?: string;
     panePath?: string;

package/dist/commands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../src/commands.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;AAC5F,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAChD,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,UAAU,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;AAEjF,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,cAAc,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,aAAa,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC9B,MAAM,EAAE,cAAc,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,GAAG,EAAE,OAAO,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAqCD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CA4C3D;AAuGD,wBAAgB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAiG/C"}
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../src/commands.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,cAAc,EACpB,MAAM,sBAAsB,CAAC;AAE9B,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,cAAc,EAAE,CAAC;AAE9D,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,cAAc,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,aAAa,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,cAAc,CAAC;IACxB,MAAM,EAAE,cAAc,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,GAAG,EAAE,OAAO,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAqBD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CA4C3D;AAuGD,wBAAgB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAM/C"}

package/dist/commands.js

@@ -2,35 +2,21 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.parseRunpaneArgs = parseRunpaneArgs;
 exports.helpText = helpText;
-const COMMANDS = new Set(['help', 'setup', 'install', 'update', 'version', 'doctor']);
-const TARGETS = new Set(['client', 'daemon']);
-const FORMATS = new Set(['auto', 'appimage', 'deb', 'dmg', 'zip', 'exe']);
-const CHANNELS = new Set(['stable', 'nightly']);
-const REMOTE_VALUE_FLAGS = new Set([
-    '--label',
-    '--prefer-tunnel',
-    '--channel',
-    '--base-url',
-    '--pane-dir',
-    '--listen-port',
-    '--port',
-    '--repo-ref'
-]);
-const REMOTE_BOOLEAN_FLAGS = new Set([
-    '--auto-listen-port',
-    '--interactive-tailscale-setup',
-    '--no-install-service',
-    '--no-tailscale-serve',
-    '--print-only'
-]);
+const contract_1 = require("./generated/contract");
+const COMMANDS = new Set(contract_1.RUNPANE_CONTRACT.commands.map((command) => command.name));
+const TARGETS = new Set(contract_1.RUNPANE_CONTRACT.enums.installTargets);
+const FORMATS = new Set(contract_1.RUNPANE_CONTRACT.enums.artifactFormats);
+const CHANNELS = new Set(contract_1.RUNPANE_CONTRACT.enums.channels);
+const REMOTE_VALUE_FLAGS = new Set(contract_1.RUNPANE_CONTRACT.flags.remoteValue.map((flag) => flag.name));
+const REMOTE_BOOLEAN_FLAGS = new Set(contract_1.RUNPANE_CONTRACT.flags.remoteBoolean.map((flag) => flag.name));
 const DEFAULTS = {
-    target: 'client',
-    paneVersion: 'latest',
-    channel: 'stable',
-    format: 'auto',
-    dryRun: false,
-    yes: false,
-    verbose: false,
+    target: contract_1.RUNPANE_CONTRACT.defaults.target,
+    paneVersion: contract_1.RUNPANE_CONTRACT.defaults.paneVersion,
+    channel: contract_1.RUNPANE_CONTRACT.defaults.channel,
+    format: contract_1.RUNPANE_CONTRACT.defaults.format,
+    dryRun: contract_1.RUNPANE_CONTRACT.defaults.dryRun,
+    yes: contract_1.RUNPANE_CONTRACT.defaults.yes,
+    verbose: contract_1.RUNPANE_CONTRACT.defaults.verbose,
     remoteSetupArgs: []
 };
 function parseRunpaneArgs(argv) {
@@ -162,96 +148,10 @@ function readValue(args, index, flag) {
     return value;
 }
 function helpText(topic) {
-    if (topic === 'install') {
-        return [
-            'Usage:',
-            '  runpane install [client|daemon] [options]',
-            '',
-            'Examples:',
-            '  npx --yes runpane@latest install client',
-            '  npx --yes runpane@latest install daemon --label "My Server"',
-            '  pnpm dlx runpane@latest install daemon --prefer-tunnel ssh --label "VM"',
-            '',
-            'Wrapper options:',
-            '  --version <latest|vX.Y.Z>        Pane release to install',
-            '  --format <auto|appimage|deb|dmg|zip|exe>',
-            '  --download-dir <path>',
-            '  --pane-path <path>               Use an existing Pane executable',
-            '  --dry-run                       Print the plan without downloading',
-            '  --yes                           Skip interactive prompts where possible',
-            '  --verbose',
-            '',
-            'Daemon passthrough options:',
-            '  --label <name>',
-            '  --prefer-tunnel <tailscale|ssh|manual|auto>',
-            '  --channel <stable|nightly>',
-            '  --base-url <url>',
-            '  --pane-dir <path>',
-            '  --listen-port <port> / --port <port>',
-            '  --auto-listen-port',
-            '  --interactive-tailscale-setup',
-            '  --no-install-service',
-            '  --no-tailscale-serve',
-            '  --print-only',
-            '  --repo-ref <ref>'
-        ].join('\n');
-    }
-    if (topic === 'setup') {
-        return [
-            'Usage:',
-            '  runpane setup',
-            '',
-            'Opens the guided setup for desktop install, remote host setup, update, and diagnostics.',
-            '',
-            'Quick start:',
-            '  npx --yes runpane@latest',
-            '  npm i -g runpane && runpane setup'
-        ].join('\n');
-    }
-    if (topic === 'update') {
-        return [
-            'Usage:',
-            '  runpane update [options]',
-            '',
-            'Updates Pane using the same artifact selection as "runpane install client".',
-            '',
-            'Options:',
-            '  --version <latest|vX.Y.Z>',
-            '  --format <auto|appimage|deb|dmg|zip|exe>',
-            '  --download-dir <path>',
-            '  --pane-path <path>',
-            '  --dry-run',
-            '  --yes',
-            '  --verbose'
-        ].join('\n');
-    }
-    if (topic === 'version') {
-        return 'Usage:\n  runpane version\n  runpane --version';
-    }
-    if (topic === 'doctor') {
-        return 'Usage:\n  runpane doctor [--pane-path <path>] [--format <format>] [--verbose]';
-    }
-    return [
-        'Usage:',
-        '  runpane',
-        '  runpane setup',
-        '  runpane install [client|daemon] [options]',
-        '  runpane update [options]',
-        '  runpane version',
-        '  runpane doctor',
-        '  runpane help [command]',
-        '',
-        'Quick start:',
-        '  npx --yes runpane@latest',
-        '  npm i -g runpane && runpane setup',
-        '',
-        'Advanced examples:',
-        '  npx --yes runpane@latest install client',
-        '  npx --yes runpane@latest install daemon --label "My Server"',
-        '  pnpm dlx runpane@latest',
-        '  pipx run runpane',
-        '',
-        'Run "runpane help install" for install options.'
-    ].join('\n');
+    const helpTopics = contract_1.RUNPANE_CONTRACT.help.npm;
+    const key = topic && Object.prototype.hasOwnProperty.call(helpTopics, topic)
+        ? topic
+        : 'default';
+    return helpTopics[key].join('\n');
 }
 //# sourceMappingURL=commands.js.map

package/dist/commands.js.map

@@ -1 +1 @@
-{"version":3,"file":"commands.js","sourceRoot":"","sources":["../src/commands.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"commands.js","sourceRoot":"","sources":["../src/commands.ts"],"names":[],"mappings":";;AA4CA,4CA4CC;AAuGD,4BAMC;AArMD,mDAM8B;AAmB9B,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAS,2BAAgB,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;AAC3F,MAAM,OAAO,GAAG,IAAI,GAAG,CAAS,2BAAgB,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;AACvE,MAAM,OAAO,GAAG,IAAI,GAAG,CAAS,2BAAgB,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;AACxE,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAS,2BAAgB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;AAElE,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAAS,2BAAgB,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AACxG,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAAS,2BAAgB,CAAC,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AAE5G,MAAM,QAAQ,GAAgC;IAC5C,MAAM,EAAE,2BAAgB,CAAC,QAAQ,CAAC,MAAM;IACxC,WAAW,EAAE,2BAAgB,CAAC,QAAQ,CAAC,WAAW;IAClD,OAAO,EAAE,2BAAgB,CAAC,QAAQ,CAAC,OAAO;IAC1C,MAAM,EAAE,2BAAgB,CAAC,QAAQ,CAAC,MAAM;IACxC,MAAM,EAAE,2BAAgB,CAAC,QAAQ,CAAC,MAAM;IACxC,GAAG,EAAE,2BAAgB,CAAC,QAAQ,CAAC,GAAG;IAClC,OAAO,EAAE,2BAAgB,CAAC,QAAQ,CAAC,OAAO;IAC1C,eAAe,EAAE,EAAE;CACpB,CAAC;AAEF,SAAgB,gBAAgB,CAAC,IAAc;IAC7C,MAAM,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;IACvB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;IAE3B,IAAI,CAAC,KAAK,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,QAAQ,EAAE,CAAC;QACnD,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,QAAQ,EAAE,CAAC;IAC1C,CAAC;IAED,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,WAAW,EAAE,CAAC;QAC5C,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,QAAQ,EAAE,CAAC;IAC7C,CAAC;IAED,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,oBAAoB,KAAK,OAAO,QAAQ,EAAE,EAAE,CAAC,CAAC;IAChE,CAAC;IAED,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;QACrB,OAAO;YACL,OAAO,EAAE,MAAM;YACf,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC;YAClB,GAAG,QAAQ;SACZ,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAe;QACzB,OAAO,EAAE,KAAuB;QAChC,GAAG,QAAQ;QACX,eAAe,EAAE,EAAE;KACpB,CAAC;IAEF,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACxE,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;QAC5B,IAAI,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YACpC,MAAM,IAAI,KAAK,CAAC,2BAA2B,MAAM,IAAI,EAAE,kCAAkC,CAAC,CAAC;QAC7F,CAAC;QACD,MAAM,CAAC,MAAM,GAAG,MAAuB,CAAC;IAC1C,CAAC;IAED,IAAI,MAAM,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;QAChC,MAAM,CAAC,MAAM,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACzB,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,UAAU,CAAC,IAAc,EAAE,MAAkB;IACpD,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC;QACjD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;QAExB,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,QAAQ,EAAE,CAAC;YACrC,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC;YAC7B,MAAM,CAAC,OAAO,GAAG,MAAM,CAAC;YACxB,MAAM,CAAC,SAAS,GAAG,KAAK,CAAC;YACzB,SAAS;QACX,CAAC;QACD,IAAI,GAAG,KAAK,WAAW,EAAE,CAAC;YACxB,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC;YACrB,SAAS;QACX,CAAC;QACD,IAAI,GAAG,KAAK,OAAO,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YACpC,MAAM,CAAC,GAAG,GAAG,IAAI,CAAC;YAClB,SAAS;QACX,CAAC;QACD,IAAI,GAAG,KAAK,WAAW,EAAE,CAAC;YACxB,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;YACtB,SAAS;QACX,CAAC;QACD,IAAI,GAAG,KAAK,WAAW,EAAE,CAAC;YACxB,MAAM,CAAC,WAAW,GAAG,SAAS,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;YACnD,SAAS;QACX,CAAC;QACD,IAAI,GAAG,KAAK,gBAAgB,EAAE,CAAC;YAC7B,MAAM,CAAC,WAAW,GAAG,SAAS,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;YACnD,SAAS;QACX,CAAC;QACD,IAAI,GAAG,KAAK,aAAa,EAAE,CAAC;YAC1B,MAAM,CAAC,QAAQ,GAAG,SAAS,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;YAChD,SAAS;QACX,CAAC;QACD,IAAI,GAAG,KAAK,UAAU,EAAE,CAAC;YACvB,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;YAC5C,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;gBACxB,MAAM,IAAI,KAAK,CAAC,qBAAqB,KAAK,uBAAuB,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC9F,CAAC;YACD,MAAM,CAAC,MAAM,GAAG,KAAuB,CAAC;YACxC,SAAS;QACX,CAAC;QAED,IAAI,kBAAkB,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAChC,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;YAC5C,IAAI,GAAG,KAAK,WAAW,EAAE,CAAC;gBACxB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;oBACzB,MAAM,IAAI,KAAK,CAAC,sBAAsB,KAAK,gCAAgC,CAAC,CAAC;gBAC/E,CAAC;gBACD,MAAM,CAAC,OAAO,GAAG,KAAuB,CAAC;YAC3C,CAAC;YACD,eAAe,CAAC,MAAM,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;YACpC,SAAS;QACX,CAAC;QAED,IAAI,oBAAoB,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAClC,eAAe,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;YAC7B,SAAS;QACX,CAAC;QAED,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS,IAAI,MAAM,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC/D,KAAK,GAAG,sBAAsB,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC;YACzD,SAAS;QACX,CAAC;QAED,MAAM,IAAI,KAAK,CAAC,sBAAsB,MAAM,CAAC,OAAO,KAAK,GAAG,EAAE,CAAC,CAAC;IAClE,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CAAC,MAAkB,EAAE,IAAY,EAAE,KAAc;IACvE,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS,IAAI,MAAM,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC/D,MAAM,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,MAAM,CAAC,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrC,CAAC;QACD,OAAO;IACT,CAAC;IAED,IAAI,kBAAkB,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,oBAAoB,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QACnE,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,+CAA+C,CAAC,CAAC;IAC1E,CAAC;AACH,CAAC;AAED,SAAS,sBAAsB,CAAC,IAAc,EAAE,KAAa,EAAE,MAAkB,EAAE,GAAW;IAC5F,MAAM,CAAC,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACjC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;IAC7B,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACzD,MAAM,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClC,OAAO,KAAK,GAAG,CAAC,CAAC;IACnB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,SAAS,CAAC,IAAc,EAAE,KAAa,EAAE,IAAY;IAC5D,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;IAC1B,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,oBAAoB,CAAC,CAAC;IAC/C,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAgB,QAAQ,CAAC,KAAc;IACrC,MAAM,UAAU,GAAG,2BAAgB,CAAC,IAAI,CAAC,GAAG,CAAC;IAC7C,MAAM,GAAG,GAAG,KAAK,IAAI,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC;QAC1E,CAAC,CAAC,KAAgC;QAClC,CAAC,CAAC,SAAS,CAAC;IACd,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACpC,CAAC"}

package/dist/generated/contract.d.ts

@@ -0,0 +1,202 @@
+export declare const RUNPANE_CONTRACT: {
+    readonly $schema: "./schema.json";
+    readonly schemaVersion: 1;
+    readonly name: "runpane";
+    readonly description: "Thin installer and local control CLI for Pane";
+    readonly packageInstallPolicy: readonly ["The packages must not download, install, or configure Pane during package installation.", "Work starts only when a user runs `runpane ...`."];
+    readonly compatibility: {
+        readonly node: ">=18.17.0";
+        readonly python: ">=3.8";
+    };
+    readonly terminology: {
+        readonly repo: "Saved Pane repository/project record";
+        readonly pane: "User-visible Pane session";
+        readonly tool: "Terminal-backed tab";
+        readonly agent: "Built-in agent command template";
+    };
+    readonly defaults: {
+        readonly target: "client";
+        readonly paneVersion: "latest";
+        readonly channel: "stable";
+        readonly format: "auto";
+        readonly dryRun: false;
+        readonly yes: false;
+        readonly verbose: false;
+    };
+    readonly enums: {
+        readonly installTargets: readonly ["client", "daemon"];
+        readonly artifactFormats: readonly ["auto", "appimage", "deb", "dmg", "zip", "exe"];
+        readonly channels: readonly ["stable", "nightly"];
+    };
+    readonly commands: readonly [{
+        readonly name: "help";
+        readonly summary: "Show help for runpane or a specific command.";
+        readonly usage: readonly ["runpane help [command]"];
+    }, {
+        readonly name: "setup";
+        readonly summary: "Open the guided setup wizard for install, remote host setup, update, and diagnostics.";
+        readonly usage: readonly ["runpane setup"];
+        readonly interactiveEntrypoint: true;
+    }, {
+        readonly name: "install";
+        readonly summary: "Install Pane on this machine or configure this machine as a remote daemon host.";
+        readonly usage: readonly ["runpane install [client|daemon] [options]"];
+        readonly defaultTarget: "client";
+        readonly targets: readonly ["client", "daemon"];
+        readonly unknownDaemonFlagsForwarded: true;
+    }, {
+        readonly name: "update";
+        readonly summary: "Update the Pane desktop app using the same artifact path as install client.";
+        readonly usage: readonly ["runpane update [options]"];
+        readonly target: "client";
+    }, {
+        readonly name: "version";
+        readonly summary: "Print the runpane wrapper version and installed Pane version when detectable.";
+        readonly usage: readonly ["runpane version", "runpane --version"];
+    }, {
+        readonly name: "doctor";
+        readonly summary: "Run platform, release, installed Pane, and remote setup diagnostics.";
+        readonly usage: readonly ["runpane doctor"];
+    }];
+    readonly flags: {
+        readonly wrapper: readonly [{
+            readonly name: "--version";
+            readonly value: "<latest|vX.Y.Z>";
+            readonly description: "Pane release to install or inspect.";
+        }, {
+            readonly name: "--download-dir";
+            readonly value: "<path>";
+            readonly description: "Directory for downloaded Pane release artifacts.";
+        }, {
+            readonly name: "--pane-path";
+            readonly value: "<path>";
+            readonly description: "Use or inspect an existing Pane executable.";
+        }, {
+            readonly name: "--format";
+            readonly value: "<auto|appimage|deb|dmg|zip|exe>";
+            readonly description: "Pane release artifact format.";
+        }, {
+            readonly name: "--dry-run";
+            readonly description: "Print the plan without downloading or installing.";
+        }, {
+            readonly name: "--yes";
+            readonly aliases: readonly ["-y"];
+            readonly description: "Skip interactive prompts where possible.";
+        }, {
+            readonly name: "--verbose";
+            readonly description: "Print extra diagnostics.";
+        }];
+        readonly remoteValue: readonly [{
+            readonly name: "--label";
+            readonly value: "<name>";
+        }, {
+            readonly name: "--prefer-tunnel";
+            readonly value: "<tailscale|ssh|manual|auto>";
+        }, {
+            readonly name: "--channel";
+            readonly value: "<stable|nightly>";
+        }, {
+            readonly name: "--base-url";
+            readonly value: "<url>";
+        }, {
+            readonly name: "--pane-dir";
+            readonly value: "<path>";
+        }, {
+            readonly name: "--listen-port";
+            readonly value: "<port>";
+        }, {
+            readonly name: "--port";
+            readonly value: "<port>";
+        }, {
+            readonly name: "--repo-ref";
+            readonly value: "<ref>";
+        }];
+        readonly remoteBoolean: readonly [{
+            readonly name: "--auto-listen-port";
+        }, {
+            readonly name: "--interactive-tailscale-setup";
+        }, {
+            readonly name: "--no-install-service";
+        }, {
+            readonly name: "--no-tailscale-serve";
+        }, {
+            readonly name: "--print-only";
+        }];
+    };
+    readonly help: {
+        readonly npm: {
+            readonly default: readonly ["Usage:", "  runpane", "  runpane setup", "  runpane install [client|daemon] [options]", "  runpane update [options]", "  runpane version", "  runpane doctor", "  runpane help [command]", "", "Quick start:", "  npx --yes runpane@latest", "  npm i -g runpane && runpane setup", "", "Advanced examples:", "  npx --yes runpane@latest install client", "  npx --yes runpane@latest install daemon --label \"My Server\"", "  pnpm dlx runpane@latest", "  pipx run runpane", "", "Run \"runpane help install\" for install options."];
+            readonly install: readonly ["Usage:", "  runpane install [client|daemon] [options]", "", "Examples:", "  npx --yes runpane@latest install client", "  npx --yes runpane@latest install daemon --label \"My Server\"", "  pnpm dlx runpane@latest install daemon --prefer-tunnel ssh --label \"VM\"", "", "Wrapper options:", "  --version <latest|vX.Y.Z>        Pane release to install", "  --format <auto|appimage|deb|dmg|zip|exe>", "  --download-dir <path>", "  --pane-path <path>               Use an existing Pane executable", "  --dry-run                       Print the plan without downloading", "  --yes                           Skip interactive prompts where possible", "  --verbose", "", "Daemon passthrough options:", "  --label <name>", "  --prefer-tunnel <tailscale|ssh|manual|auto>", "  --channel <stable|nightly>", "  --base-url <url>", "  --pane-dir <path>", "  --listen-port <port> / --port <port>", "  --auto-listen-port", "  --interactive-tailscale-setup", "  --no-install-service", "  --no-tailscale-serve", "  --print-only", "  --repo-ref <ref>"];
+            readonly setup: readonly ["Usage:", "  runpane setup", "", "Opens the guided setup for desktop install, remote host setup, update, and diagnostics.", "", "Quick start:", "  npx --yes runpane@latest", "  npm i -g runpane && runpane setup"];
+            readonly update: readonly ["Usage:", "  runpane update [options]", "", "Updates Pane using the same artifact selection as \"runpane install client\".", "", "Options:", "  --version <latest|vX.Y.Z>", "  --format <auto|appimage|deb|dmg|zip|exe>", "  --download-dir <path>", "  --pane-path <path>", "  --dry-run", "  --yes", "  --verbose"];
+            readonly version: readonly ["Usage:", "  runpane version", "  runpane --version"];
+            readonly doctor: readonly ["Usage:", "  runpane doctor [--pane-path <path>] [--format <format>] [--verbose]"];
+        };
+        readonly pip: {
+            readonly default: readonly ["Usage:", "  runpane", "  runpane setup", "  runpane install [client|daemon] [options]", "  runpane update [options]", "  runpane version", "  runpane doctor", "  runpane help [command]", "", "Quick start:", "  pipx run runpane", "  python -m pip install runpane && python -m runpane setup", "", "Advanced examples:", "  pipx run runpane install client", "  pipx run runpane install daemon --label \"My Server\"", "  uvx runpane@latest", "", "Run \"runpane help install\" for install options."];
+            readonly install: readonly ["Usage:", "  runpane install [client|daemon] [options]", "", "Examples:", "  npx --yes runpane@latest install daemon --label \"My Server\"", "  pnpm dlx runpane@latest install daemon --prefer-tunnel ssh --label \"VM\"", "  pipx run runpane install daemon --label \"My Server\"", "", "Wrapper options:", "  --version <latest|vX.Y.Z>", "  --format <auto|appimage|deb|dmg|zip|exe>", "  --download-dir <path>", "  --pane-path <path>", "  --dry-run", "  --yes", "  --verbose", "", "Daemon passthrough options:", "  --label <name>", "  --prefer-tunnel <tailscale|ssh|manual|auto>", "  --channel <stable|nightly>", "  --base-url <url>", "  --pane-dir <path>", "  --listen-port <port> / --port <port>", "  --auto-listen-port", "  --interactive-tailscale-setup", "  --no-install-service", "  --no-tailscale-serve", "  --print-only", "  --repo-ref <ref>"];
+            readonly setup: readonly ["Usage:", "  runpane setup", "", "Opens the guided setup for desktop install, remote host setup, update, and diagnostics.", "", "Quick start:", "  pipx run runpane", "  python -m pip install runpane && python -m runpane setup"];
+            readonly update: readonly ["Usage:", "  runpane update [--version <latest|vX.Y.Z>] [--dry-run] [--yes]"];
+            readonly version: readonly ["Usage:", "  runpane version", "  runpane --version"];
+            readonly doctor: readonly ["Usage:", "  runpane doctor [--pane-path <path>] [--format <format>] [--verbose]"];
+        };
+    };
+    readonly docs: {
+        readonly maintainerRules: readonly ["Treat `contracts/runpane/contract.json` as the source of truth for both wrapper packages and generated docs.", "Every command, flag, platform default, artifact-selection rule, and attribution rule change must be reflected in the contract.", "The npm and PyPI wrappers must expose the same command behavior unless the contract explicitly documents a package-manager-specific difference.", "Root `README.md` and package READMEs should lead with one guided quick-start command. Explicit commands, package-manager variants, and flags belong in an Advanced section.", "Release version bumps must keep root `package.json`, `packages/runpane`, and `packages/runpane-py` versions in sync. Run `pnpm run check:runpane-package-versions` before release.", "`pnpm run test:runpane-contract` must pass before changing wrapper command parsing, help output, platform defaults, release asset selection, or generated contract artifacts.", "Token-based npm or PyPI publishing is a temporary fallback. Prefer trusted publishing once the package names are reserved and trusted publishers are configured."];
+        readonly recommendedQuickStarts: readonly ["npx --yes runpane@latest", "npm i -g runpane && runpane setup", "pipx run runpane", "python -m pip install runpane && python -m runpane setup"];
+        readonly npmCommands: readonly ["npx --yes runpane@latest", "npx --yes runpane@latest setup", "npx --yes runpane@latest install client", "npx --yes runpane@latest install daemon --label \"My Server\"", "pnpm dlx runpane@latest", "pnpm dlx runpane@latest install daemon --label \"My Server\"", "npm i -g runpane && runpane", "npm i -g runpane && runpane setup", "npm i -g runpane && runpane install daemon --label \"My Server\"", "pnpm add -g runpane && runpane", "pnpm add -g runpane && runpane setup", "pnpm add -g runpane && runpane install daemon --label \"My Server\"", "yarn dlx runpane@latest install daemon --label \"My Server\"", "bunx runpane@latest install daemon --label \"My Server\""];
+        readonly pythonCommands: readonly ["pipx run runpane", "pipx run runpane setup", "python -m pip install runpane", "runpane", "runpane setup", "python -m runpane setup", "runpane install daemon --label \"My Server\"", "pipx install runpane", "runpane", "runpane setup", "pipx run runpane install daemon --label \"My Server\"", "uvx runpane@latest", "uvx runpane@latest setup", "uvx runpane@latest install daemon --label \"My Server\"", "python -m runpane install daemon --label \"My Server\""];
+        readonly packageManagerNotes: readonly ["Use `pnpm dlx` for one-shot pnpm execution and `pnpm add -g` for persistent CLI installation.", "Do not document `pnpm install runpane` as the public CLI install path."];
+        readonly commandUsages: readonly ["runpane", "runpane setup", "runpane install", "runpane install client", "runpane install daemon", "runpane update", "runpane version", "runpane doctor", "runpane help", "runpane <command> --help"];
+        readonly commandDescriptions: readonly ["`runpane` with no arguments and `runpane setup` open an interactive wizard when stdin and stdout are TTYs. In non-interactive shells or CI, both forms must print help and exit successfully instead of waiting for input.", "`runpane install` is an alias for `runpane install client`.", "`runpane install client` downloads the selected Pane desktop artifact and installs, opens, or launches it for the current platform.", "`runpane install daemon` downloads or installs Pane, resolves a stable Pane executable path, and spawns `<pane executable> --remote-setup <forwarded remote setup args>`.", "The wrapper must stream Pane stdout/stderr without reformatting because `pane --remote-setup` prints the one-time `pane-remote://...` connection code.", "`runpane update` uses the same release resolution and installer path as `install client`.", "`runpane version` prints the wrapper package version, the installed Pane version when detectable, and the latest GitHub release version when reachable.", "`runpane doctor` checks platform support, release metadata reachability, download URL selection, installed Pane detection, and remote-daemon hints."];
+        readonly wrapperFlagNote: "The top-level `runpane --version` form prints the wrapper version. The install subcommand form `runpane install --version vX.Y.Z` selects a Pane release.";
+        readonly daemonFlagNote: "Unknown daemon flags should be forwarded rather than dropped so newer Pane versions can extend `--remote-setup` without requiring an immediate wrapper release. Unknown flags for non-daemon commands should fail clearly.";
+        readonly downloadAttribution: readonly ["The npm package uses `source=npm` for all npm-registry consumers, including `npx`, `pnpm dlx`, `yarn dlx`, `bunx`, and global npm/pnpm installs.", "The PyPI package uses `source=pip` for all Python consumers, including pip, pipx, uvx, and `python -m runpane`.", "Wrappers should prefer `https://runpane.com/api/download?platform=<platform>&arch=<arch>&format=<format>&version=<version>&channel=<channel>&source=<npm|pip>`.", "If the website route cannot satisfy the download, wrappers may fall back to the matching GitHub release asset and print a warning that website attribution may be incomplete for that run."];
+        readonly publishingCredentials: readonly ["Local implementation, build, and dry-run validation do not need npm or PyPI API tokens.", "Release publishing should prefer npm Trusted Publishing and PyPI Trusted Publishing from GitHub Actions.", "Fallback `NPM_TOKEN` or `PYPI_API_TOKEN` credentials may be used for first package reservation or manual publication only. They must be supplied through local environment variables or GitHub Actions secrets, never committed, and revoked or rotated after use."];
+    };
+    readonly testFixtures: {
+        readonly parserSamples: readonly [readonly ["setup"], readonly ["install"], readonly ["install", "client", "--version", "v2.2.8", "--format", "dmg", "--download-dir", "/tmp/pane-downloads", "--dry-run", "--yes"], readonly ["install", "daemon", "--label", "VM", "--prefer-tunnel", "ssh", "--channel", "nightly", "--base-url", "https://example.test", "--pane-dir", "/tmp/pane", "--listen-port", "4555", "--auto-listen-port", "--print-only", "--repo-ref", "main", "--unknown-future-flag", "future-value", "--dry-run", "--verbose"], readonly ["update", "--version", "latest", "--format", "appimage", "--pane-path", "/usr/bin/pane", "--dry-run"], readonly ["doctor", "--pane-path", "/usr/bin/pane", "--format", "zip", "--verbose"], readonly ["--version"]];
+        readonly topLevelHelpIncludes: readonly ["runpane setup", "runpane install", "runpane update", "runpane version", "runpane doctor"];
+        readonly npmHelpIncludes: readonly ["pnpm dlx runpane@latest", "npx --yes runpane@latest"];
+        readonly pipHelpIncludes: readonly ["pipx run runpane", "python -m pip install runpane && python -m runpane setup"];
+        readonly installHelpIncludes: readonly ["--version <latest|vX.Y.Z>", "--format <auto|appimage|deb|dmg|zip|exe>", "--download-dir <path>", "--pane-path <path>", "--label <name>", "--prefer-tunnel <tailscale|ssh|manual|auto>", "--repo-ref <ref>"];
+    };
+    readonly jsonSchemas: {
+        readonly error: {
+            readonly type: "object";
+            readonly required: readonly ["ok", "error"];
+            readonly properties: {
+                readonly ok: {
+                    readonly const: false;
+                };
+                readonly error: {
+                    readonly type: "object";
+                    readonly required: readonly ["message"];
+                    readonly properties: {
+                        readonly message: {
+                            readonly type: "string";
+                        };
+                        readonly code: {
+                            readonly type: "string";
+                        };
+                    };
+                    readonly additionalProperties: false;
+                };
+            };
+            readonly additionalProperties: false;
+        };
+        readonly "future.repoListResult": {
+            readonly type: "object";
+            readonly description: "Reserved for #252 repo listing output.";
+        };
+        readonly "future.paneCreateResult": {
+            readonly type: "object";
+            readonly description: "Reserved for #252 pane creation output.";
+        };
+    };
+};
+export type RunpaneCommand = typeof RUNPANE_CONTRACT.commands[number]['name'];
+export type InstallTarget = typeof RUNPANE_CONTRACT.enums.installTargets[number];
+export type ArtifactFormat = typeof RUNPANE_CONTRACT.enums.artifactFormats[number];
+export type RunpaneChannel = typeof RUNPANE_CONTRACT.enums.channels[number];
+//# sourceMappingURL=contract.d.ts.map

package/dist/generated/contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../src/generated/contract.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAikBnB,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,OAAO,gBAAgB,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC;AAC9E,MAAM,MAAM,aAAa,GAAG,OAAO,gBAAgB,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;AACjF,MAAM,MAAM,cAAc,GAAG,OAAO,gBAAgB,CAAC,KAAK,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;AACnF,MAAM,MAAM,cAAc,GAAG,OAAO,gBAAgB,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC"}

package/dist/generated/contract.js

@@ -0,0 +1,583 @@
+"use strict";
+// Generated by scripts/generate-runpane-contract.js. Do not edit by hand.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RUNPANE_CONTRACT = void 0;
+exports.RUNPANE_CONTRACT = {
+    "$schema": "./schema.json",
+    "schemaVersion": 1,
+    "name": "runpane",
+    "description": "Thin installer and local control CLI for Pane",
+    "packageInstallPolicy": [
+        "The packages must not download, install, or configure Pane during package installation.",
+        "Work starts only when a user runs `runpane ...`."
+    ],
+    "compatibility": {
+        "node": ">=18.17.0",
+        "python": ">=3.8"
+    },
+    "terminology": {
+        "repo": "Saved Pane repository/project record",
+        "pane": "User-visible Pane session",
+        "tool": "Terminal-backed tab",
+        "agent": "Built-in agent command template"
+    },
+    "defaults": {
+        "target": "client",
+        "paneVersion": "latest",
+        "channel": "stable",
+        "format": "auto",
+        "dryRun": false,
+        "yes": false,
+        "verbose": false
+    },
+    "enums": {
+        "installTargets": [
+            "client",
+            "daemon"
+        ],
+        "artifactFormats": [
+            "auto",
+            "appimage",
+            "deb",
+            "dmg",
+            "zip",
+            "exe"
+        ],
+        "channels": [
+            "stable",
+            "nightly"
+        ]
+    },
+    "commands": [
+        {
+            "name": "help",
+            "summary": "Show help for runpane or a specific command.",
+            "usage": [
+                "runpane help [command]"
+            ]
+        },
+        {
+            "name": "setup",
+            "summary": "Open the guided setup wizard for install, remote host setup, update, and diagnostics.",
+            "usage": [
+                "runpane setup"
+            ],
+            "interactiveEntrypoint": true
+        },
+        {
+            "name": "install",
+            "summary": "Install Pane on this machine or configure this machine as a remote daemon host.",
+            "usage": [
+                "runpane install [client|daemon] [options]"
+            ],
+            "defaultTarget": "client",
+            "targets": [
+                "client",
+                "daemon"
+            ],
+            "unknownDaemonFlagsForwarded": true
+        },
+        {
+            "name": "update",
+            "summary": "Update the Pane desktop app using the same artifact path as install client.",
+            "usage": [
+                "runpane update [options]"
+            ],
+            "target": "client"
+        },
+        {
+            "name": "version",
+            "summary": "Print the runpane wrapper version and installed Pane version when detectable.",
+            "usage": [
+                "runpane version",
+                "runpane --version"
+            ]
+        },
+        {
+            "name": "doctor",
+            "summary": "Run platform, release, installed Pane, and remote setup diagnostics.",
+            "usage": [
+                "runpane doctor"
+            ]
+        }
+    ],
+    "flags": {
+        "wrapper": [
+            {
+                "name": "--version",
+                "value": "<latest|vX.Y.Z>",
+                "description": "Pane release to install or inspect."
+            },
+            {
+                "name": "--download-dir",
+                "value": "<path>",
+                "description": "Directory for downloaded Pane release artifacts."
+            },
+            {
+                "name": "--pane-path",
+                "value": "<path>",
+                "description": "Use or inspect an existing Pane executable."
+            },
+            {
+                "name": "--format",
+                "value": "<auto|appimage|deb|dmg|zip|exe>",
+                "description": "Pane release artifact format."
+            },
+            {
+                "name": "--dry-run",
+                "description": "Print the plan without downloading or installing."
+            },
+            {
+                "name": "--yes",
+                "aliases": [
+                    "-y"
+                ],
+                "description": "Skip interactive prompts where possible."
+            },
+            {
+                "name": "--verbose",
+                "description": "Print extra diagnostics."
+            }
+        ],
+        "remoteValue": [
+            {
+                "name": "--label",
+                "value": "<name>"
+            },
+            {
+                "name": "--prefer-tunnel",
+                "value": "<tailscale|ssh|manual|auto>"
+            },
+            {
+                "name": "--channel",
+                "value": "<stable|nightly>"
+            },
+            {
+                "name": "--base-url",
+                "value": "<url>"
+            },
+            {
+                "name": "--pane-dir",
+                "value": "<path>"
+            },
+            {
+                "name": "--listen-port",
+                "value": "<port>"
+            },
+            {
+                "name": "--port",
+                "value": "<port>"
+            },
+            {
+                "name": "--repo-ref",
+                "value": "<ref>"
+            }
+        ],
+        "remoteBoolean": [
+            {
+                "name": "--auto-listen-port"
+            },
+            {
+                "name": "--interactive-tailscale-setup"
+            },
+            {
+                "name": "--no-install-service"
+            },
+            {
+                "name": "--no-tailscale-serve"
+            },
+            {
+                "name": "--print-only"
+            }
+        ]
+    },
+    "help": {
+        "npm": {
+            "default": [
+                "Usage:",
+                "  runpane",
+                "  runpane setup",
+                "  runpane install [client|daemon] [options]",
+                "  runpane update [options]",
+                "  runpane version",
+                "  runpane doctor",
+                "  runpane help [command]",
+                "",
+                "Quick start:",
+                "  npx --yes runpane@latest",
+                "  npm i -g runpane && runpane setup",
+                "",
+                "Advanced examples:",
+                "  npx --yes runpane@latest install client",
+                "  npx --yes runpane@latest install daemon --label \"My Server\"",
+                "  pnpm dlx runpane@latest",
+                "  pipx run runpane",
+                "",
+                "Run \"runpane help install\" for install options."
+            ],
+            "install": [
+                "Usage:",
+                "  runpane install [client|daemon] [options]",
+                "",
+                "Examples:",
+                "  npx --yes runpane@latest install client",
+                "  npx --yes runpane@latest install daemon --label \"My Server\"",
+                "  pnpm dlx runpane@latest install daemon --prefer-tunnel ssh --label \"VM\"",
+                "",
+                "Wrapper options:",
+                "  --version <latest|vX.Y.Z>        Pane release to install",
+                "  --format <auto|appimage|deb|dmg|zip|exe>",
+                "  --download-dir <path>",
+                "  --pane-path <path>               Use an existing Pane executable",
+                "  --dry-run                       Print the plan without downloading",
+                "  --yes                           Skip interactive prompts where possible",
+                "  --verbose",
+                "",
+                "Daemon passthrough options:",
+                "  --label <name>",
+                "  --prefer-tunnel <tailscale|ssh|manual|auto>",
+                "  --channel <stable|nightly>",
+                "  --base-url <url>",
+                "  --pane-dir <path>",
+                "  --listen-port <port> / --port <port>",
+                "  --auto-listen-port",
+                "  --interactive-tailscale-setup",
+                "  --no-install-service",
+                "  --no-tailscale-serve",
+                "  --print-only",
+                "  --repo-ref <ref>"
+            ],
+            "setup": [
+                "Usage:",
+                "  runpane setup",
+                "",
+                "Opens the guided setup for desktop install, remote host setup, update, and diagnostics.",
+                "",
+                "Quick start:",
+                "  npx --yes runpane@latest",
+                "  npm i -g runpane && runpane setup"
+            ],
+            "update": [
+                "Usage:",
+                "  runpane update [options]",
+                "",
+                "Updates Pane using the same artifact selection as \"runpane install client\".",
+                "",
+                "Options:",
+                "  --version <latest|vX.Y.Z>",
+                "  --format <auto|appimage|deb|dmg|zip|exe>",
+                "  --download-dir <path>",
+                "  --pane-path <path>",
+                "  --dry-run",
+                "  --yes",
+                "  --verbose"
+            ],
+            "version": [
+                "Usage:",
+                "  runpane version",
+                "  runpane --version"
+            ],
+            "doctor": [
+                "Usage:",
+                "  runpane doctor [--pane-path <path>] [--format <format>] [--verbose]"
+            ]
+        },
+        "pip": {
+            "default": [
+                "Usage:",
+                "  runpane",
+                "  runpane setup",
+                "  runpane install [client|daemon] [options]",
+                "  runpane update [options]",
+                "  runpane version",
+                "  runpane doctor",
+                "  runpane help [command]",
+                "",
+                "Quick start:",
+                "  pipx run runpane",
+                "  python -m pip install runpane && python -m runpane setup",
+                "",
+                "Advanced examples:",
+                "  pipx run runpane install client",
+                "  pipx run runpane install daemon --label \"My Server\"",
+                "  uvx runpane@latest",
+                "",
+                "Run \"runpane help install\" for install options."
+            ],
+            "install": [
+                "Usage:",
+                "  runpane install [client|daemon] [options]",
+                "",
+                "Examples:",
+                "  npx --yes runpane@latest install daemon --label \"My Server\"",
+                "  pnpm dlx runpane@latest install daemon --prefer-tunnel ssh --label \"VM\"",
+                "  pipx run runpane install daemon --label \"My Server\"",
+                "",
+                "Wrapper options:",
+                "  --version <latest|vX.Y.Z>",
+                "  --format <auto|appimage|deb|dmg|zip|exe>",
+                "  --download-dir <path>",
+                "  --pane-path <path>",
+                "  --dry-run",
+                "  --yes",
+                "  --verbose",
+                "",
+                "Daemon passthrough options:",
+                "  --label <name>",
+                "  --prefer-tunnel <tailscale|ssh|manual|auto>",
+                "  --channel <stable|nightly>",
+                "  --base-url <url>",
+                "  --pane-dir <path>",
+                "  --listen-port <port> / --port <port>",
+                "  --auto-listen-port",
+                "  --interactive-tailscale-setup",
+                "  --no-install-service",
+                "  --no-tailscale-serve",
+                "  --print-only",
+                "  --repo-ref <ref>"
+            ],
+            "setup": [
+                "Usage:",
+                "  runpane setup",
+                "",
+                "Opens the guided setup for desktop install, remote host setup, update, and diagnostics.",
+                "",
+                "Quick start:",
+                "  pipx run runpane",
+                "  python -m pip install runpane && python -m runpane setup"
+            ],
+            "update": [
+                "Usage:",
+                "  runpane update [--version <latest|vX.Y.Z>] [--dry-run] [--yes]"
+            ],
+            "version": [
+                "Usage:",
+                "  runpane version",
+                "  runpane --version"
+            ],
+            "doctor": [
+                "Usage:",
+                "  runpane doctor [--pane-path <path>] [--format <format>] [--verbose]"
+            ]
+        }
+    },
+    "docs": {
+        "maintainerRules": [
+            "Treat `contracts/runpane/contract.json` as the source of truth for both wrapper packages and generated docs.",
+            "Every command, flag, platform default, artifact-selection rule, and attribution rule change must be reflected in the contract.",
+            "The npm and PyPI wrappers must expose the same command behavior unless the contract explicitly documents a package-manager-specific difference.",
+            "Root `README.md` and package READMEs should lead with one guided quick-start command. Explicit commands, package-manager variants, and flags belong in an Advanced section.",
+            "Release version bumps must keep root `package.json`, `packages/runpane`, and `packages/runpane-py` versions in sync. Run `pnpm run check:runpane-package-versions` before release.",
+            "`pnpm run test:runpane-contract` must pass before changing wrapper command parsing, help output, platform defaults, release asset selection, or generated contract artifacts.",
+            "Token-based npm or PyPI publishing is a temporary fallback. Prefer trusted publishing once the package names are reserved and trusted publishers are configured."
+        ],
+        "recommendedQuickStarts": [
+            "npx --yes runpane@latest",
+            "npm i -g runpane && runpane setup",
+            "pipx run runpane",
+            "python -m pip install runpane && python -m runpane setup"
+        ],
+        "npmCommands": [
+            "npx --yes runpane@latest",
+            "npx --yes runpane@latest setup",
+            "npx --yes runpane@latest install client",
+            "npx --yes runpane@latest install daemon --label \"My Server\"",
+            "pnpm dlx runpane@latest",
+            "pnpm dlx runpane@latest install daemon --label \"My Server\"",
+            "npm i -g runpane && runpane",
+            "npm i -g runpane && runpane setup",
+            "npm i -g runpane && runpane install daemon --label \"My Server\"",
+            "pnpm add -g runpane && runpane",
+            "pnpm add -g runpane && runpane setup",
+            "pnpm add -g runpane && runpane install daemon --label \"My Server\"",
+            "yarn dlx runpane@latest install daemon --label \"My Server\"",
+            "bunx runpane@latest install daemon --label \"My Server\""
+        ],
+        "pythonCommands": [
+            "pipx run runpane",
+            "pipx run runpane setup",
+            "python -m pip install runpane",
+            "runpane",
+            "runpane setup",
+            "python -m runpane setup",
+            "runpane install daemon --label \"My Server\"",
+            "pipx install runpane",
+            "runpane",
+            "runpane setup",
+            "pipx run runpane install daemon --label \"My Server\"",
+            "uvx runpane@latest",
+            "uvx runpane@latest setup",
+            "uvx runpane@latest install daemon --label \"My Server\"",
+            "python -m runpane install daemon --label \"My Server\""
+        ],
+        "packageManagerNotes": [
+            "Use `pnpm dlx` for one-shot pnpm execution and `pnpm add -g` for persistent CLI installation.",
+            "Do not document `pnpm install runpane` as the public CLI install path."
+        ],
+        "commandUsages": [
+            "runpane",
+            "runpane setup",
+            "runpane install",
+            "runpane install client",
+            "runpane install daemon",
+            "runpane update",
+            "runpane version",
+            "runpane doctor",
+            "runpane help",
+            "runpane <command> --help"
+        ],
+        "commandDescriptions": [
+            "`runpane` with no arguments and `runpane setup` open an interactive wizard when stdin and stdout are TTYs. In non-interactive shells or CI, both forms must print help and exit successfully instead of waiting for input.",
+            "`runpane install` is an alias for `runpane install client`.",
+            "`runpane install client` downloads the selected Pane desktop artifact and installs, opens, or launches it for the current platform.",
+            "`runpane install daemon` downloads or installs Pane, resolves a stable Pane executable path, and spawns `<pane executable> --remote-setup <forwarded remote setup args>`.",
+            "The wrapper must stream Pane stdout/stderr without reformatting because `pane --remote-setup` prints the one-time `pane-remote://...` connection code.",
+            "`runpane update` uses the same release resolution and installer path as `install client`.",
+            "`runpane version` prints the wrapper package version, the installed Pane version when detectable, and the latest GitHub release version when reachable.",
+            "`runpane doctor` checks platform support, release metadata reachability, download URL selection, installed Pane detection, and remote-daemon hints."
+        ],
+        "wrapperFlagNote": "The top-level `runpane --version` form prints the wrapper version. The install subcommand form `runpane install --version vX.Y.Z` selects a Pane release.",
+        "daemonFlagNote": "Unknown daemon flags should be forwarded rather than dropped so newer Pane versions can extend `--remote-setup` without requiring an immediate wrapper release. Unknown flags for non-daemon commands should fail clearly.",
+        "downloadAttribution": [
+            "The npm package uses `source=npm` for all npm-registry consumers, including `npx`, `pnpm dlx`, `yarn dlx`, `bunx`, and global npm/pnpm installs.",
+            "The PyPI package uses `source=pip` for all Python consumers, including pip, pipx, uvx, and `python -m runpane`.",
+            "Wrappers should prefer `https://runpane.com/api/download?platform=<platform>&arch=<arch>&format=<format>&version=<version>&channel=<channel>&source=<npm|pip>`.",
+            "If the website route cannot satisfy the download, wrappers may fall back to the matching GitHub release asset and print a warning that website attribution may be incomplete for that run."
+        ],
+        "publishingCredentials": [
+            "Local implementation, build, and dry-run validation do not need npm or PyPI API tokens.",
+            "Release publishing should prefer npm Trusted Publishing and PyPI Trusted Publishing from GitHub Actions.",
+            "Fallback `NPM_TOKEN` or `PYPI_API_TOKEN` credentials may be used for first package reservation or manual publication only. They must be supplied through local environment variables or GitHub Actions secrets, never committed, and revoked or rotated after use."
+        ]
+    },
+    "testFixtures": {
+        "parserSamples": [
+            [
+                "setup"
+            ],
+            [
+                "install"
+            ],
+            [
+                "install",
+                "client",
+                "--version",
+                "v2.2.8",
+                "--format",
+                "dmg",
+                "--download-dir",
+                "/tmp/pane-downloads",
+                "--dry-run",
+                "--yes"
+            ],
+            [
+                "install",
+                "daemon",
+                "--label",
+                "VM",
+                "--prefer-tunnel",
+                "ssh",
+                "--channel",
+                "nightly",
+                "--base-url",
+                "https://example.test",
+                "--pane-dir",
+                "/tmp/pane",
+                "--listen-port",
+                "4555",
+                "--auto-listen-port",
+                "--print-only",
+                "--repo-ref",
+                "main",
+                "--unknown-future-flag",
+                "future-value",
+                "--dry-run",
+                "--verbose"
+            ],
+            [
+                "update",
+                "--version",
+                "latest",
+                "--format",
+                "appimage",
+                "--pane-path",
+                "/usr/bin/pane",
+                "--dry-run"
+            ],
+            [
+                "doctor",
+                "--pane-path",
+                "/usr/bin/pane",
+                "--format",
+                "zip",
+                "--verbose"
+            ],
+            [
+                "--version"
+            ]
+        ],
+        "topLevelHelpIncludes": [
+            "runpane setup",
+            "runpane install",
+            "runpane update",
+            "runpane version",
+            "runpane doctor"
+        ],
+        "npmHelpIncludes": [
+            "pnpm dlx runpane@latest",
+            "npx --yes runpane@latest"
+        ],
+        "pipHelpIncludes": [
+            "pipx run runpane",
+            "python -m pip install runpane && python -m runpane setup"
+        ],
+        "installHelpIncludes": [
+            "--version <latest|vX.Y.Z>",
+            "--format <auto|appimage|deb|dmg|zip|exe>",
+            "--download-dir <path>",
+            "--pane-path <path>",
+            "--label <name>",
+            "--prefer-tunnel <tailscale|ssh|manual|auto>",
+            "--repo-ref <ref>"
+        ]
+    },
+    "jsonSchemas": {
+        "error": {
+            "type": "object",
+            "required": [
+                "ok",
+                "error"
+            ],
+            "properties": {
+                "ok": {
+                    "const": false
+                },
+                "error": {
+                    "type": "object",
+                    "required": [
+                        "message"
+                    ],
+                    "properties": {
+                        "message": {
+                            "type": "string"
+                        },
+                        "code": {
+                            "type": "string"
+                        }
+                    },
+                    "additionalProperties": false
+                }
+            },
+            "additionalProperties": false
+        },
+        "future.repoListResult": {
+            "type": "object",
+            "description": "Reserved for #252 repo listing output."
+        },
+        "future.paneCreateResult": {
+            "type": "object",
+            "description": "Reserved for #252 pane creation output."
+        }
+    }
+};
+//# sourceMappingURL=contract.js.map

package/dist/generated/contract.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "runpane",
-  "version": "2.2.11",
+  "version": "2.3.0",
   "description": "Thin npm installer and remote setup CLI for Pane",
   "license": "AGPL-3.0",
   "homepage": "https://runpane.com",