nebula-notebook-mcp 0.2.0 → 0.4.1

package/dist/cli/fs.js

@@ -0,0 +1,282 @@
+/**
+ * `nebula fs …` — file operations on the Nebula SERVER's filesystem
+ * (list / cat / write / rm / mv / download / upload).
+ *
+ * For agents running in a terminal ON the server, plain shell commands are
+ * simpler — this group exists for remote agents (laptop ↔ server) and for
+ * parity with the MCP file tools. Thin wrappers over the same NebulaClient
+ * methods the MCP server uses.
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { CliError, EXIT, makeClient, parse, printHint, printJson, requirePositional, resolveContentInput, resolveUrl, toCliError, } from './shared.js';
+const FS_HELP = `usage: nebula fs <ls|cat|write|rm|mv|download|upload> …
+
+Paths are paths on the Nebula SERVER (in a Nebula terminal that is the local
+filesystem — prefer plain shell commands there; this group is for remote use).
+
+examples:
+  nebula fs ls data/
+  nebula fs cat results/summary.csv
+  echo 'hello' | nebula fs write notes.txt -
+  nebula fs mv old.csv archive/old.csv
+  nebula fs rm scratch.txt --force
+  nebula fs download results/fig1.pdf ./fig1.pdf
+  nebula fs upload ./local.csv data/
+
+Run 'nebula fs <subcommand> --help' for details.`;
+export async function cmdFs(argv) {
+    const [sub, ...rest] = argv;
+    switch (sub) {
+        case 'ls':
+            return fsLs(rest);
+        case 'cat':
+            return fsCat(rest);
+        case 'write':
+            return fsWrite(rest);
+        case 'rm':
+            return fsRm(rest);
+        case 'mv':
+            return fsMv(rest);
+        case 'download':
+            return fsDownload(rest);
+        case 'upload':
+            return fsUpload(rest);
+        case undefined:
+        case '--help':
+        case '-h':
+            console.log(FS_HELP);
+            return sub === undefined ? EXIT.USAGE : EXIT.OK;
+        default:
+            throw new CliError(`unknown fs subcommand: ${sub}`, EXIT.USAGE, "run 'nebula fs --help' for the list");
+    }
+}
+function clientFor(values) {
+    return makeClient(resolveUrl(values.url));
+}
+// =============================================================================
+// fs ls
+// =============================================================================
+const LS_HELP = `usage: nebula fs ls [path]
+
+Lists a directory on the server (defaults to the server's root directory).
+
+examples:
+  nebula fs ls
+  nebula fs ls data/raw`;
+async function fsLs(argv) {
+    const { values, positionals } = parse(argv);
+    if (values.help) {
+        console.log(LS_HELP);
+        return EXIT.OK;
+    }
+    const dirPath = positionals[0] ?? '.';
+    const result = await clientFor(values).listFiles(dirPath);
+    if (!result.success)
+        throw toCliError(result.error);
+    const items = result.data ?? [];
+    if (values.json) {
+        printJson(items);
+        return EXIT.OK;
+    }
+    for (const item of items) {
+        console.log(item.type === 'directory' ? `${item.name}/` : item.name);
+    }
+    if (items.length === 0) {
+        console.log('(empty)');
+    }
+    printHint('read a file with: nebula fs cat <path>', values);
+    return EXIT.OK;
+}
+// =============================================================================
+// fs cat
+// =============================================================================
+const CAT_HELP = `usage: nebula fs cat <path>
+
+Prints a text file from the server. Binary files error — use fs download.
+
+examples:
+  nebula fs cat results/summary.csv`;
+async function fsCat(argv) {
+    const { values, positionals } = parse(argv);
+    if (values.help) {
+        console.log(CAT_HELP);
+        return EXIT.OK;
+    }
+    const filePath = requirePositional(positionals, 0, 'path', 'nebula fs cat <path>');
+    const result = await clientFor(values).readFile(filePath);
+    if (!result.success)
+        throw toCliError(result.error);
+    if (values.json) {
+        printJson({ path: filePath, content: result.data.content });
+        return EXIT.OK;
+    }
+    process.stdout.write(result.data.content);
+    if (!result.data.content.endsWith('\n'))
+        process.stdout.write('\n');
+    return EXIT.OK;
+}
+// =============================================================================
+// fs write
+// =============================================================================
+const WRITE_HELP = `usage: nebula fs write <path> (--content <str> | --content-file <f> | -)
+
+Writes a text file on the server (creates or overwrites).
+
+examples:
+  nebula fs write notes.txt --content 'hello'
+  cat local.csv | nebula fs write data/upload.csv -`;
+async function fsWrite(argv) {
+    const { values, positionals } = parse(argv, {
+        content: { type: 'string' },
+        'content-file': { type: 'string' },
+    });
+    if (values.help) {
+        console.log(WRITE_HELP);
+        return EXIT.OK;
+    }
+    const usage = 'nebula fs write <path> (--content <str> | --content-file <f> | -)';
+    const filePath = requirePositional(positionals, 0, 'path', usage);
+    const stdinMarker = positionals[1] === '-';
+    const content = await resolveContentInput(values.content, values['content-file'], stdinMarker);
+    const result = await clientFor(values).writeFile(filePath, content);
+    if (!result.success)
+        throw toCliError(result.error);
+    if (values.json) {
+        printJson({ path: filePath, bytes: Buffer.byteLength(content), written: true });
+        return EXIT.OK;
+    }
+    console.log(`wrote ${filePath} (${Buffer.byteLength(content)} bytes)`);
+    printHint(`verify with: nebula fs cat ${filePath}`, values);
+    return EXIT.OK;
+}
+// =============================================================================
+// fs rm
+// =============================================================================
+const RM_HELP = `usage: nebula fs rm <path> --force
+
+Deletes a file (or directory) on the server — --force is required.
+
+examples:
+  nebula fs rm scratch.txt --force`;
+async function fsRm(argv) {
+    const { values, positionals } = parse(argv, { force: { type: 'boolean' } });
+    if (values.help) {
+        console.log(RM_HELP);
+        return EXIT.OK;
+    }
+    const filePath = requirePositional(positionals, 0, 'path', 'nebula fs rm <path> --force');
+    if (!values.force) {
+        throw new CliError('fs rm deletes server files — pass --force to confirm', EXIT.USAGE);
+    }
+    const result = await clientFor(values).deleteFile(filePath);
+    if (!result.success)
+        throw toCliError(result.error);
+    if (values.json) {
+        printJson({ path: filePath, deleted: true });
+        return EXIT.OK;
+    }
+    console.log(`deleted ${filePath}`);
+    return EXIT.OK;
+}
+// =============================================================================
+// fs mv
+// =============================================================================
+const MV_HELP = `usage: nebula fs mv <old-path> <new-path>
+
+Renames/moves a file or directory on the server.
+
+examples:
+  nebula fs mv old.csv archive/old.csv`;
+async function fsMv(argv) {
+    const { values, positionals } = parse(argv);
+    if (values.help) {
+        console.log(MV_HELP);
+        return EXIT.OK;
+    }
+    const usage = 'nebula fs mv <old-path> <new-path>';
+    const oldPath = requirePositional(positionals, 0, 'old-path', usage);
+    const newPath = requirePositional(positionals, 1, 'new-path', usage);
+    const result = await clientFor(values).renameFile(oldPath, newPath);
+    if (!result.success)
+        throw toCliError(result.error);
+    if (values.json) {
+        printJson({ from: oldPath, to: newPath, moved: true });
+        return EXIT.OK;
+    }
+    console.log(`moved ${oldPath} -> ${newPath}`);
+    return EXIT.OK;
+}
+// =============================================================================
+// fs download
+// =============================================================================
+const DOWNLOAD_HELP = `usage: nebula fs download <server-path> <local-path>
+
+Downloads a file from the server to THIS machine (text or binary).
+
+examples:
+  nebula fs download results/fig1.pdf ./fig1.pdf`;
+async function fsDownload(argv) {
+    const { values, positionals } = parse(argv);
+    if (values.help) {
+        console.log(DOWNLOAD_HELP);
+        return EXIT.OK;
+    }
+    const usage = 'nebula fs download <server-path> <local-path>';
+    const serverPath = requirePositional(positionals, 0, 'server-path', usage);
+    const localPath = requirePositional(positionals, 1, 'local-path', usage);
+    const result = await clientFor(values).downloadFile(serverPath);
+    if (!result.success)
+        throw toCliError(result.error);
+    const target = localPath.endsWith('/') || (fs.existsSync(localPath) && fs.statSync(localPath).isDirectory())
+        ? path.join(localPath, path.basename(serverPath))
+        : localPath;
+    fs.mkdirSync(path.dirname(path.resolve(target)), { recursive: true });
+    fs.writeFileSync(target, result.data.content);
+    if (values.json) {
+        printJson({ from: serverPath, to: target, bytes: result.data.content.length });
+        return EXIT.OK;
+    }
+    console.log(`downloaded ${serverPath} -> ${target} (${result.data.content.length} bytes)`);
+    return EXIT.OK;
+}
+// =============================================================================
+// fs upload
+// =============================================================================
+const UPLOAD_HELP = `usage: nebula fs upload <local-path> <server-dir> [--name NAME]
+
+Uploads a local file into a directory on the server (text or binary).
+
+examples:
+  nebula fs upload ./local.csv data/
+  nebula fs upload ./local.csv data/ --name renamed.csv`;
+async function fsUpload(argv) {
+    const { values, positionals } = parse(argv, { name: { type: 'string' } });
+    if (values.help) {
+        console.log(UPLOAD_HELP);
+        return EXIT.OK;
+    }
+    const usage = 'nebula fs upload <local-path> <server-dir> [--name NAME]';
+    const localPath = requirePositional(positionals, 0, 'local-path', usage);
+    const serverDir = requirePositional(positionals, 1, 'server-dir', usage);
+    let content;
+    try {
+        content = fs.readFileSync(localPath);
+    }
+    catch (e) {
+        throw new CliError(`cannot read ${localPath}: ${e instanceof Error ? e.message : String(e)}`, EXIT.USAGE);
+    }
+    const filename = values.name ?? path.basename(localPath);
+    const result = await clientFor(values).uploadFile(serverDir, content, filename);
+    if (!result.success)
+        throw toCliError(result.error);
+    const dest = `${serverDir.replace(/\/+$/, '')}/${filename}`;
+    if (values.json) {
+        printJson({ from: localPath, to: dest, bytes: content.length });
+        return EXIT.OK;
+    }
+    console.log(`uploaded ${localPath} -> ${dest} (${content.length} bytes)`);
+    printHint(`verify with: nebula fs ls ${serverDir}`, values);
+    return EXIT.OK;
+}
+//# sourceMappingURL=fs.js.map

package/dist/cli/fs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.js","sourceRoot":"","sources":["../../src/cli/fs.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,OAAO,EACL,QAAQ,EACR,IAAI,EACJ,UAAU,EACV,KAAK,EACL,SAAS,EACT,SAAS,EACT,iBAAiB,EACjB,mBAAmB,EACnB,UAAU,EACV,UAAU,GAEX,MAAM,aAAa,CAAC;AAErB,MAAM,OAAO,GAAG;;;;;;;;;;;;;;iDAciC,CAAC;AAElD,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,IAAc;IACxC,MAAM,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IAC5B,QAAQ,GAAG,EAAE,CAAC;QACZ,KAAK,IAAI;YACP,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC;QACpB,KAAK,KAAK;YACR,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC;QACrB,KAAK,OAAO;YACV,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC;QACvB,KAAK,IAAI;YACP,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC;QACpB,KAAK,IAAI;YACP,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC;QACpB,KAAK,UAAU;YACb,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC;QAC1B,KAAK,QAAQ;YACX,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC;QACxB,KAAK,SAAS,CAAC;QACf,KAAK,QAAQ,CAAC;QACd,KAAK,IAAI;YACP,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACrB,OAAO,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;QAClD;YACE,MAAM,IAAI,QAAQ,CAAC,0BAA0B,GAAG,EAAE,EAAE,IAAI,CAAC,KAAK,EAAE,qCAAqC,CAAC,CAAC;IAC3G,CAAC;AACH,CAAC;AAED,SAAS,SAAS,CAAC,MAA4B;IAC7C,OAAO,UAAU,CAAC,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;AAC5C,CAAC;AAED,gFAAgF;AAChF,QAAQ;AACR,gFAAgF;AAEhF,MAAM,OAAO,GAAG;;;;;;wBAMQ,CAAC;AAEzB,KAAK,UAAU,IAAI,CAAC,IAAc;IAChC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;IAC5C,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACrB,OAAO,IAAI,CAAC,EAAE,CAAC;IACjB,CAAC;IACD,MAAM,OAAO,GAAG,WAAW,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC;IACtC,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IAC1D,IAAI,CAAC,MAAM,CAAC,OAAO;QAAE,MAAM,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAEpD,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;IAChC,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QAChB,SAAS,CAAC,KAAK,CAAC,CAAC;QACjB,OAAO,IAAI,CAAC,EAAE,CAAC;IACjB,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACvE,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACzB,CAAC;IACD,SAAS,CAAC,wCAAwC,EAAE,MAAM,CAAC,CAAC;IAC5D,OAAO,IAAI,CAAC,EAAE,CAAC;AACjB,CAAC;AAED,gFAAgF;AAChF,SAAS;AACT,gFAAgF;AAEhF,MAAM,QAAQ,GAAG;;;;;oCAKmB,CAAC;AAErC,KAAK,UAAU,KAAK,CAAC,IAAc;IACjC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;IAC5C,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACtB,OAAO,IAAI,CAAC,EAAE,CAAC;IACjB,CAAC;IACD,MAAM,QAAQ,GAAG,iBAAiB,CAAC,WAAW,EAAE,CAAC,EAAE,MAAM,EAAE,sBAAsB,CAAC,CAAC;IACnF,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC1D,IAAI,CAAC,MAAM,CAAC,OAAO;QAAE,MAAM,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAEpD,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QAChB,SAAS,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,IAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAC7D,OAAO,IAAI,CAAC,EAAE,CAAC;IACjB,CAAC;IACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,IAAK,CAAC,OAAO,CAAC,CAAC;IAC3C,IAAI,CAAC,MAAM,CAAC,IAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACrE,OAAO,IAAI,CAAC,EAAE,CAAC;AACjB,CAAC;AAED,gFAAgF;AAChF,WAAW;AACX,gFAAgF;AAEhF,MAAM,UAAU,GAAG;;;;;;oDAMiC,CAAC;AAErD,KAAK,UAAU,OAAO,CAAC,IAAc;IACnC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,KAAK,CAAC,IAAI,EAAE;QAC1C,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC3B,cAAc,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;KACnC,CAAC,CAAC;IACH,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACxB,OAAO,IAAI,CAAC,EAAE,CAAC;IACjB,CAAC;IACD,MAAM,KAAK,GAAG,mEAAmE,CAAC;IAClF,MAAM,QAAQ,GAAG,iBAAiB,CAAC,WAAW,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IAClE,MAAM,WAAW,GAAG,WAAW,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC;IAC3C,MAAM,OAAO,GAAG,MAAM,mBAAmB,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,cAAc,CAAC,EAAE,WAAW,CAAC,CAAC;IAE/F,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACpE,IAAI,CAAC,MAAM,CAAC,OAAO;QAAE,MAAM,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAEpD,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QAChB,SAAS,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QAChF,OAAO,IAAI,CAAC,EAAE,CAAC;IACjB,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,SAAS,QAAQ,KAAK,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACvE,SAAS,CAAC,8BAA8B,QAAQ,EAAE,EAAE,MAAM,CAAC,CAAC;IAC5D,OAAO,IAAI,CAAC,EAAE,CAAC;AACjB,CAAC;AAED,gFAAgF;AAChF,QAAQ;AACR,gFAAgF;AAEhF,MAAM,OAAO,GAAG;;;;;mCAKmB,CAAC;AAEpC,KAAK,UAAU,IAAI,CAAC,IAAc;IAChC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,KAAK,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC;IAC5E,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACrB,OAAO,IAAI,CAAC,EAAE,CAAC;IACjB,CAAC;IACD,MAAM,QAAQ,GAAG,iBAAiB,CAAC,WAAW,EAAE,CAAC,EAAE,MAAM,EAAE,6BAA6B,CAAC,CAAC;IAC1F,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAClB,MAAM,IAAI,QAAQ,CAAC,sDAAsD,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;IACzF,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,MAAM,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IAC5D,IAAI,CAAC,MAAM,CAAC,OAAO;QAAE,MAAM,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAEpD,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QAChB,SAAS,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QAC7C,OAAO,IAAI,CAAC,EAAE,CAAC;IACjB,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,WAAW,QAAQ,EAAE,CAAC,CAAC;IACnC,OAAO,IAAI,CAAC,EAAE,CAAC;AACjB,CAAC;AAED,gFAAgF;AAChF,QAAQ;AACR,gFAAgF;AAEhF,MAAM,OAAO,GAAG;;;;;uCAKuB,CAAC;AAExC,KAAK,UAAU,IAAI,CAAC,IAAc;IAChC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;IAC5C,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACrB,OAAO,IAAI,CAAC,EAAE,CAAC;IACjB,CAAC;IACD,MAAM,KAAK,GAAG,oCAAoC,CAAC;IACnD,MAAM,OAAO,GAAG,iBAAiB,CAAC,WAAW,EAAE,CAAC,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC;IACrE,MAAM,OAAO,GAAG,iBAAiB,CAAC,WAAW,EAAE,CAAC,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC;IAErE,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,MAAM,CAAC,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACpE,IAAI,CAAC,MAAM,CAAC,OAAO;QAAE,MAAM,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAEpD,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QAChB,SAAS,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACvD,OAAO,IAAI,CAAC,EAAE,CAAC;IACjB,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,SAAS,OAAO,OAAO,OAAO,EAAE,CAAC,CAAC;IAC9C,OAAO,IAAI,CAAC,EAAE,CAAC;AACjB,CAAC;AAED,gFAAgF;AAChF,cAAc;AACd,gFAAgF;AAEhF,MAAM,aAAa,GAAG;;;;;iDAK2B,CAAC;AAElD,KAAK,UAAU,UAAU,CAAC,IAAc;IACtC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;IAC5C,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QAC3B,OAAO,IAAI,CAAC,EAAE,CAAC;IACjB,CAAC;IACD,MAAM,KAAK,GAAG,+CAA+C,CAAC;IAC9D,MAAM,UAAU,GAAG,iBAAiB,CAAC,WAAW,EAAE,CAAC,EAAE,aAAa,EAAE,KAAK,CAAC,CAAC;IAC3E,MAAM,SAAS,GAAG,iBAAiB,CAAC,WAAW,EAAE,CAAC,EAAE,YAAY,EAAE,KAAK,CAAC,CAAC;IAEzE,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC;IAChE,IAAI,CAAC,MAAM,CAAC,OAAO;QAAE,MAAM,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAEpD,MAAM,MAAM,GAAG,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,CAAC;QAC1G,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;QACjD,CAAC,CAAC,SAAS,CAAC;IACd,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtE,EAAE,CAAC,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,IAAK,CAAC,OAAO,CAAC,CAAC;IAE/C,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QAChB,SAAS,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,IAAK,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QAChF,OAAO,IAAI,CAAC,EAAE,CAAC;IACjB,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,cAAc,UAAU,OAAO,MAAM,KAAK,MAAM,CAAC,IAAK,CAAC,OAAO,CAAC,MAAM,SAAS,CAAC,CAAC;IAC5F,OAAO,IAAI,CAAC,EAAE,CAAC;AACjB,CAAC;AAED,gFAAgF;AAChF,YAAY;AACZ,gFAAgF;AAEhF,MAAM,WAAW,GAAG;;;;;;wDAMoC,CAAC;AAEzD,KAAK,UAAU,QAAQ,CAAC,IAAc;IACpC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,KAAK,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC;IAC1E,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QACzB,OAAO,IAAI,CAAC,EAAE,CAAC;IACjB,CAAC;IACD,MAAM,KAAK,GAAG,0DAA0D,CAAC;IACzE,MAAM,SAAS,GAAG,iBAAiB,CAAC,WAAW,EAAE,CAAC,EAAE,YAAY,EAAE,KAAK,CAAC,CAAC;IACzE,MAAM,SAAS,GAAG,iBAAiB,CAAC,WAAW,EAAE,CAAC,EAAE,YAAY,EAAE,KAAK,CAAC,CAAC;IAEzE,IAAI,OAAe,CAAC;IACpB,IAAI,CAAC;QACH,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;IACvC,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,IAAI,QAAQ,CAAC,eAAe,SAAS,KAAK,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;IAC5G,CAAC;IACD,MAAM,QAAQ,GAAI,MAAM,CAAC,IAA2B,IAAI,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IAEjF,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,MAAM,CAAC,CAAC,UAAU,CAAC,SAAS,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;IAChF,IAAI,CAAC,MAAM,CAAC,OAAO;QAAE,MAAM,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAEpD,MAAM,IAAI,GAAG,GAAG,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,QAAQ,EAAE,CAAC;IAC5D,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QAChB,SAAS,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QAChE,OAAO,IAAI,CAAC,EAAE,CAAC;IACjB,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,YAAY,SAAS,OAAO,IAAI,KAAK,OAAO,CAAC,MAAM,SAAS,CAAC,CAAC;IAC1E,SAAS,CAAC,6BAA6B,SAAS,EAAE,EAAE,MAAM,CAAC,CAAC;IAC5D,OAAO,IAAI,CAAC,EAAE,CAAC;AACjB,CAAC"}

package/dist/cli/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * nebula — agent-facing CLI for Nebula Notebook.
+ *
+ * A thin layer over the shared NebulaClient / tools code (the same code the
+ * MCP server uses). Design follows AXI (https://axi.md): compact plain-text
+ * output, combined operations, one contextual hint per command, --json for
+ * raw output, distinct exit codes.
+ *
+ * Exit codes: 0 ok · 1 error · 2 usage · 7 kernel dead/not-found · 9 OCC conflict
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

package/dist/cli/index.js

@@ -0,0 +1,93 @@
+/**
+ * nebula — agent-facing CLI for Nebula Notebook.
+ *
+ * A thin layer over the shared NebulaClient / tools code (the same code the
+ * MCP server uses). Design follows AXI (https://axi.md): compact plain-text
+ * output, combined operations, one contextual hint per command, --json for
+ * raw output, distinct exit codes.
+ *
+ * Exit codes: 0 ok · 1 error · 2 usage · 7 kernel dead/not-found · 9 OCC conflict
+ */
+import { CliError, EXIT } from './shared.js';
+import { cmdNb } from './nb.js';
+import { cmdRun } from './run.js';
+import { cmdKernel } from './kernel.js';
+import { cmdSession } from './session.js';
+import { cmdCompute } from './compute.js';
+import { cmdFs } from './fs.js';
+import { cmdSetupSkill } from './skill.js';
+const ROOT_HELP = `nebula — work with notebooks on a running Nebula server
+
+Server URL required: --url <url> on any command, or export NEBULA_URL.
+Not installed? npx -p nebula-notebook-mcp nebula …  (or: npm i -g nebula-notebook-mcp)
+
+usage: nebula <command> …
+
+  nb read|edit|insert|delete|search <path> …
+                                 cells: read/OCC-checked edit (conflict → exit 9)/
+                                 insert/delete/search — see 'nebula nb --help'
+  nb create|move|duplicate|clear-outputs|clear|meta <path> …
+                                 create notebooks, reorder/copy cells, outputs, metadata
+  run <path> <cell-id>           execute a cell + print output tail (--tail)
+  kernel ls                      available kernels on the server
+  kernel status|start|stop|restart|interrupt <path>
+  session start|end <path>       hold/release the agent lock across invocations
+  compute status|queues|alloc|ls|use|cancel
+                                 cluster compute allocations (HPC; optional)
+  fs ls|cat|write|rm|mv|download|upload
+                                 SERVER files (remote agents; in a Nebula terminal use the shell)
+  setup-skill                    install the Claude Code skill (for agents outside Nebula terminals)
+
+Every command accepts --json (raw output) and --quiet (no hint line).
+Run 'nebula <command> --help' for examples.`;
+async function main(argv) {
+    const [cmd, ...rest] = argv;
+    if (cmd === undefined || cmd === '--help' || cmd === '-h' || cmd === 'help') {
+        console.log(ROOT_HELP);
+        return EXIT.OK;
+    }
+    switch (cmd) {
+        case 'nb':
+            return cmdNb(rest);
+        case 'run':
+            return cmdRun(rest);
+        case 'kernel':
+            return cmdKernel(rest);
+        case 'session':
+            return cmdSession(rest);
+        case 'compute':
+            return cmdCompute(rest);
+        case 'fs':
+            return cmdFs(rest);
+        case 'setup-skill':
+            return cmdSetupSkill(rest);
+        default:
+            throw new CliError(`unknown command: ${cmd}`, EXIT.USAGE, "run 'nebula --help' for the command list");
+    }
+}
+/** Exit only after stdout/stderr are flushed (they can be async on pipes). */
+function finish(code) {
+    let pending = 2;
+    const done = () => {
+        pending -= 1;
+        if (pending === 0)
+            process.exit(code);
+    };
+    process.stdout.write('', done);
+    process.stderr.write('', done);
+}
+main(process.argv.slice(2))
+    .then(finish)
+    .catch((e) => {
+    if (e instanceof CliError) {
+        console.error(`error: ${e.message}`);
+        if (e.hintText)
+            console.error(`hint: ${e.hintText}`);
+        finish(e.code);
+    }
+    else {
+        console.error(`error: ${e instanceof Error ? e.message : String(e)}`);
+        finish(EXIT.ERROR);
+    }
+});
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C,MAAM,SAAS,GAAG;;;;;;;;;;;;;;;;;;;;;;;4CAuB0B,CAAC;AAE7C,KAAK,UAAU,IAAI,CAAC,IAAc;IAChC,MAAM,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IAE5B,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;QAC5E,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACvB,OAAO,IAAI,CAAC,EAAE,CAAC;IACjB,CAAC;IAED,QAAQ,GAAG,EAAE,CAAC;QACZ,KAAK,IAAI;YACP,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC;QACrB,KAAK,KAAK;YACR,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC;QACtB,KAAK,QAAQ;YACX,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC;QACzB,KAAK,SAAS;YACZ,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC;QAC1B,KAAK,SAAS;YACZ,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC;QAC1B,KAAK,IAAI;YACP,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC;QACrB,KAAK,aAAa;YAChB,OAAO,aAAa,CAAC,IAAI,CAAC,CAAC;QAC7B;YACE,MAAM,IAAI,QAAQ,CAAC,oBAAoB,GAAG,EAAE,EAAE,IAAI,CAAC,KAAK,EAAE,0CAA0C,CAAC,CAAC;IAC1G,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,SAAS,MAAM,CAAC,IAAY;IAC1B,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,MAAM,IAAI,GAAG,GAAG,EAAE;QAChB,OAAO,IAAI,CAAC,CAAC;QACb,IAAI,OAAO,KAAK,CAAC;YAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxC,CAAC,CAAC;IACF,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IAC/B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;AACjC,CAAC;AAED,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;KACxB,IAAI,CAAC,MAAM,CAAC;KACZ,KAAK,CAAC,CAAC,CAAU,EAAE,EAAE;IACpB,IAAI,CAAC,YAAY,QAAQ,EAAE,CAAC;QAC1B,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;QACrC,IAAI,CAAC,CAAC,QAAQ;YAAE,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC;QACrD,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACjB,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACtE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrB,CAAC;AACH,CAAC,CAAC,CAAC"}

package/dist/cli/kernel.d.ts

@@ -0,0 +1,8 @@
+/**
+ * `nebula kernel …` — kernel status / restart / interrupt for a notebook.
+ *
+ * Uses the shared NebulaClient kernel-session helpers (same logic as the
+ * MCP kernel tools, but addressed by notebook path per invocation).
+ */
+export declare function cmdKernel(argv: string[]): Promise<number>;
+//# sourceMappingURL=kernel.d.ts.map

package/dist/cli/kernel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kernel.d.ts","sourceRoot":"","sources":["../../src/cli/kernel.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA8BH,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAmC/D"}

package/dist/cli/kernel.js

@@ -0,0 +1,165 @@
+/**
+ * `nebula kernel …` — kernel status / restart / interrupt for a notebook.
+ *
+ * Uses the shared NebulaClient kernel-session helpers (same logic as the
+ * MCP kernel tools, but addressed by notebook path per invocation).
+ */
+import { CliError, EXIT, makeClient, parse, printHint, printJson, requirePositional, resolveUrl, toCliError, } from './shared.js';
+const KERNEL_HELP = `usage: nebula kernel <status|start|stop|restart|interrupt> <path>
+       nebula kernel ls
+
+examples:
+  nebula kernel ls                         # available kernels on the server
+  nebula kernel status analysis.ipynb      # session id, kernel, state
+  nebula kernel start analysis.ipynb       # start (kernel from notebook metadata)
+  nebula kernel start analysis.ipynb --name ir
+  nebula kernel stop analysis.ipynb        # shut the session down
+  nebula kernel interrupt analysis.ipynb   # stop the running cell
+  nebula kernel restart analysis.ipynb     # fresh kernel (variables cleared)
+
+Exit code 7 means no kernel session exists for the notebook.`;
+export async function cmdKernel(argv) {
+    const [sub, ...rest] = argv;
+    if (sub === undefined || sub === '--help' || sub === '-h') {
+        console.log(KERNEL_HELP);
+        return sub === undefined ? EXIT.USAGE : EXIT.OK;
+    }
+    const { values, positionals } = parse(rest, { name: { type: 'string' } });
+    if (values.help) {
+        console.log(KERNEL_HELP);
+        return EXIT.OK;
+    }
+    // Path-less subcommands
+    if (sub === 'ls') {
+        return kernelLs(makeClient(resolveUrl(values.url)), values);
+    }
+    const nbPath = requirePositional(positionals, 0, 'path', `nebula kernel ${sub} <path>`);
+    const url = resolveUrl(values.url);
+    const client = makeClient(url, nbPath);
+    switch (sub) {
+        case 'status':
+            return kernelStatus(client, nbPath, values);
+        case 'start':
+            return kernelStart(client, nbPath, values);
+        case 'stop':
+            return kernelStop(client, nbPath, values);
+        case 'restart':
+            return kernelRestart(client, nbPath, values);
+        case 'interrupt':
+            return kernelInterrupt(client, nbPath, values);
+        default:
+            throw new CliError(`unknown kernel subcommand: ${sub}`, EXIT.USAGE, "run 'nebula kernel --help' for the list");
+    }
+}
+async function kernelLs(client, values) {
+    const result = await client.listKernels();
+    if (!result.success)
+        throw toCliError(result.error);
+    const kernels = result.data ?? [];
+    if (values.json) {
+        printJson(kernels);
+        return EXIT.OK;
+    }
+    if (kernels.length === 0) {
+        console.log('no kernels discovered on the server');
+        return EXIT.OK;
+    }
+    const nameWidth = Math.max(...kernels.map((k) => k.name.length), 4);
+    console.log(`${'NAME'.padEnd(nameWidth)}  LANGUAGE  DISPLAY NAME`);
+    for (const k of kernels) {
+        console.log(`${k.name.padEnd(nameWidth)}  ${(k.language || '-').padEnd(8)}  ${k.displayName}`);
+    }
+    printHint('start one for a notebook with: nebula kernel start <path> --name <NAME>', values);
+    return EXIT.OK;
+}
+async function kernelStart(client, nbPath, values) {
+    // No --name → the server resolves the kernel from the notebook's kernelspec.
+    const started = await client.getOrCreateKernelForFile(nbPath, values.name);
+    if (!started.success)
+        throw toCliError(started.error, nbPath);
+    if (values.json) {
+        printJson({ sessionId: started.data.sessionId, kernelName: started.data.kernelName });
+        return EXIT.OK;
+    }
+    console.log(`kernel session: ${started.data.sessionId} (${started.data.kernelName})`);
+    printHint(`execute a cell with: nebula run ${nbPath} <cell-id>`, values);
+    return EXIT.OK;
+}
+async function kernelStop(client, nbPath, values) {
+    const session = await client.resolveKernelSessionIdForNotebook(nbPath, { createIfMissing: false });
+    if (!session.success) {
+        throw new CliError(`no kernel session for ${nbPath}`, EXIT.KERNEL);
+    }
+    const result = await client.shutdownKernel(session.data.sessionId);
+    if (!result.success)
+        throw toCliError(result.error, nbPath);
+    if (values.json) {
+        printJson({ stopped: true, sessionId: session.data.sessionId });
+        return EXIT.OK;
+    }
+    console.log('kernel stopped');
+    printHint(`start a fresh one with: nebula kernel start ${nbPath}`, values);
+    return EXIT.OK;
+}
+async function kernelStatus(client, nbPath, values) {
+    const sessions = await client.listSessions();
+    if (!sessions.success)
+        throw toCliError(sessions.error, nbPath);
+    const matching = (sessions.data ?? []).filter((s) => s.file_path === nbPath);
+    if (matching.length === 0) {
+        throw new CliError(`no kernel session for ${nbPath}`, EXIT.KERNEL, `one starts automatically on: nebula run ${nbPath} <cell-id>`);
+    }
+    const session = matching[matching.length - 1];
+    if (values.json) {
+        printJson(session);
+        return EXIT.OK;
+    }
+    console.log(`session: ${session.id}`);
+    console.log(`kernel: ${session.kernel_name}`);
+    console.log(`status: ${session.status}`);
+    if (session.execution_count !== undefined) {
+        console.log(`execution_count: ${session.execution_count}`);
+    }
+    printHint(`if stuck: nebula kernel interrupt ${nbPath}; for a clean slate: nebula kernel restart ${nbPath}`, values);
+    return EXIT.OK;
+}
+async function kernelRestart(client, nbPath, values) {
+    // Robust restart (same approach as the MCP kernel_restart tool): shut down
+    // any existing session for the file, then start a fresh one.
+    const existing = await client.resolveKernelSessionIdForNotebook(nbPath, { createIfMissing: false });
+    if (existing.success) {
+        const stopped = await client.shutdownKernel(existing.data.sessionId);
+        if (!stopped.success && !/not found/i.test(stopped.error ?? '')) {
+            throw toCliError(stopped.error, nbPath);
+        }
+    }
+    const started = await client.getOrCreateKernelForFile(nbPath);
+    if (!started.success)
+        throw toCliError(started.error, nbPath);
+    if (values.json) {
+        printJson({ restarted: true, sessionId: started.data.sessionId, kernelName: started.data.kernelName });
+        return EXIT.OK;
+    }
+    console.log(`kernel restarted: ${started.data.sessionId} (${started.data.kernelName})`);
+    printHint('variables were cleared — re-run setup cells before dependent ones', values);
+    return EXIT.OK;
+}
+async function kernelInterrupt(client, nbPath, values) {
+    const session = await client.resolveKernelSessionIdForNotebook(nbPath, { createIfMissing: false });
+    if (!session.success) {
+        throw new CliError(`no kernel session for ${nbPath}`, EXIT.KERNEL);
+    }
+    const result = await client.interruptKernel(session.data.sessionId);
+    if (!result.success) {
+        const notFound = /not found/i.test(result.error ?? '');
+        throw new CliError(result.error ?? 'interrupt failed', notFound ? EXIT.KERNEL : EXIT.ERROR);
+    }
+    if (values.json) {
+        printJson({ interrupted: true, sessionId: session.data.sessionId });
+        return EXIT.OK;
+    }
+    console.log('kernel interrupted');
+    printHint(`check state with: nebula kernel status ${nbPath}`, values);
+    return EXIT.OK;
+}
+//# sourceMappingURL=kernel.js.map

package/dist/cli/kernel.js.map

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

package/dist/cli/nb.d.ts

@@ -0,0 +1,8 @@
+/**
+ * `nebula nb …` — notebook cell commands (read / edit / insert / delete / search).
+ *
+ * Thin wrappers over the shared tool objects in ../tools and NebulaClient
+ * operations; all HTTP goes through the same code the MCP server uses.
+ */
+export declare function cmdNb(argv: string[]): Promise<number>;
+//# sourceMappingURL=nb.d.ts.map

package/dist/cli/nb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nb.d.ts","sourceRoot":"","sources":["../../src/cli/nb.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA4CH,wBAAsB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAiC3D"}