nebula-notebook-mcp 0.2.0 → 0.3.0

package/dist/cli/kernel.js

@@ -0,0 +1,102 @@
+/**
+ * `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|restart|interrupt> <path>
+
+examples:
+  nebula kernel status analysis.ipynb      # session id, kernel, state
+  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);
+    if (values.help) {
+        console.log(KERNEL_HELP);
+        return EXIT.OK;
+    }
+    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 '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 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":"AAAA;;;;;GAKG;AAGH,OAAO,EACL,QAAQ,EACR,IAAI,EACJ,UAAU,EACV,KAAK,EACL,SAAS,EACT,SAAS,EACT,iBAAiB,EACjB,UAAU,EACV,UAAU,GAEX,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,GAAG;;;;;;;6DAOyC,CAAC;AAE9D,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,IAAc;IAC5C,MAAM,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IAC5B,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QAC1D,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QACzB,OAAO,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;IAClD,CAAC;IACD,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;IAC5C,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QACzB,OAAO,IAAI,CAAC,EAAE,CAAC;IACjB,CAAC;IACD,MAAM,MAAM,GAAG,iBAAiB,CAAC,WAAW,EAAE,CAAC,EAAE,MAAM,EAAE,iBAAiB,GAAG,SAAS,CAAC,CAAC;IACxF,MAAM,GAAG,GAAG,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACnC,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAEvC,QAAQ,GAAG,EAAE,CAAC;QACZ,KAAK,QAAQ;YACX,OAAO,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QAC9C,KAAK,SAAS;YACZ,OAAO,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QAC/C,KAAK,WAAW;YACd,OAAO,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QACjD;YACE,MAAM,IAAI,QAAQ,CAAC,8BAA8B,GAAG,EAAE,EAAE,IAAI,CAAC,KAAK,EAAE,yCAAyC,CAAC,CAAC;IACnH,CAAC;AACH,CAAC;AAED,KAAK,UAAU,YAAY,CAAC,MAAoB,EAAE,MAAc,EAAE,MAA4B;IAC5F,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,YAAY,EAAE,CAAC;IAC7C,IAAI,CAAC,QAAQ,CAAC,OAAO;QAAE,MAAM,UAAU,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAEhE,MAAM,QAAQ,GAAG,CAAC,QAAQ,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,MAAM,CAAC,CAAC;IAC7E,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,QAAQ,CAChB,yBAAyB,MAAM,EAAE,EACjC,IAAI,CAAC,MAAM,EACX,2CAA2C,MAAM,YAAY,CAC9D,CAAC;IACJ,CAAC;IACD,MAAM,OAAO,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAE9C,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QAChB,SAAS,CAAC,OAAO,CAAC,CAAC;QACnB,OAAO,IAAI,CAAC,EAAE,CAAC;IACjB,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,YAAY,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC;IACtC,OAAO,CAAC,GAAG,CAAC,WAAW,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAC9C,OAAO,CAAC,GAAG,CAAC,WAAW,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACzC,IAAI,OAAO,CAAC,eAAe,KAAK,SAAS,EAAE,CAAC;QAC1C,OAAO,CAAC,GAAG,CAAC,oBAAoB,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;IAC7D,CAAC;IACD,SAAS,CAAC,qCAAqC,MAAM,8CAA8C,MAAM,EAAE,EAAE,MAAM,CAAC,CAAC;IACrH,OAAO,IAAI,CAAC,EAAE,CAAC;AACjB,CAAC;AAED,KAAK,UAAU,aAAa,CAAC,MAAoB,EAAE,MAAc,EAAE,MAA4B;IAC7F,2EAA2E;IAC3E,6DAA6D;IAC7D,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,iCAAiC,CAAC,MAAM,EAAE,EAAE,eAAe,EAAE,KAAK,EAAE,CAAC,CAAC;IACpG,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;QACrB,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,QAAQ,CAAC,IAAK,CAAC,SAAS,CAAC,CAAC;QACtE,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,CAAC;YAChE,MAAM,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,wBAAwB,CAAC,MAAM,CAAC,CAAC;IAC9D,IAAI,CAAC,OAAO,CAAC,OAAO;QAAE,MAAM,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAE9D,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QAChB,SAAS,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,CAAC,IAAK,CAAC,SAAS,EAAE,UAAU,EAAE,OAAO,CAAC,IAAK,CAAC,UAAU,EAAE,CAAC,CAAC;QACzG,OAAO,IAAI,CAAC,EAAE,CAAC;IACjB,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,qBAAqB,OAAO,CAAC,IAAK,CAAC,SAAS,KAAK,OAAO,CAAC,IAAK,CAAC,UAAU,GAAG,CAAC,CAAC;IAC1F,SAAS,CAAC,mEAAmE,EAAE,MAAM,CAAC,CAAC;IACvF,OAAO,IAAI,CAAC,EAAE,CAAC;AACjB,CAAC;AAED,KAAK,UAAU,eAAe,CAAC,MAAoB,EAAE,MAAc,EAAE,MAA4B;IAC/F,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,iCAAiC,CAAC,MAAM,EAAE,EAAE,eAAe,EAAE,KAAK,EAAE,CAAC,CAAC;IACnG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QACrB,MAAM,IAAI,QAAQ,CAAC,yBAAyB,MAAM,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACrE,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,OAAO,CAAC,IAAK,CAAC,SAAS,CAAC,CAAC;IACrE,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,QAAQ,GAAG,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;QACvD,MAAM,IAAI,QAAQ,CAAC,MAAM,CAAC,KAAK,IAAI,kBAAkB,EAAE,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC9F,CAAC;IAED,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QAChB,SAAS,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,CAAC,IAAK,CAAC,SAAS,EAAE,CAAC,CAAC;QACrE,OAAO,IAAI,CAAC,EAAE,CAAC;IACjB,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;IAClC,SAAS,CAAC,0CAA0C,MAAM,EAAE,EAAE,MAAM,CAAC,CAAC;IACtE,OAAO,IAAI,CAAC,EAAE,CAAC;AACjB,CAAC"}

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;AAuCH,wBAAsB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAqB3D"}

package/dist/cli/nb.js

@@ -0,0 +1,331 @@
+/**
+ * `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.
+ */
+import { randomBytes } from 'node:crypto';
+import { readNotebookTool, readCellTool, insertCellTool, deleteCellTool, searchCellsTool, } from '../tools/notebook.js';
+import { CliError, EXIT, firstLineOf, makeClient, parse, parseIntFlag, printHint, printJson, requirePositional, resolveContentInput, resolveUrl, tailLines, toCliError, } from './shared.js';
+const NB_HELP = `usage: nebula nb <read|edit|insert|delete|search> …
+
+examples:
+  nebula nb read analysis.ipynb
+  nebula nb edit analysis.ipynb cell-3 --content 'x = 42'
+  nebula nb insert analysis.ipynb --index -1 --content 'print(x)'
+  nebula nb delete analysis.ipynb cell-3
+  nebula nb search analysis.ipynb "read_csv"
+
+Run 'nebula nb <subcommand> --help' for details.`;
+export async function cmdNb(argv) {
+    const [sub, ...rest] = argv;
+    switch (sub) {
+        case 'read':
+            return nbRead(rest);
+        case 'edit':
+            return nbEdit(rest);
+        case 'insert':
+            return nbInsert(rest);
+        case 'delete':
+            return nbDelete(rest);
+        case 'search':
+            return nbSearch(rest);
+        case undefined:
+        case '--help':
+        case '-h':
+            console.log(NB_HELP);
+            return sub === undefined ? EXIT.USAGE : EXIT.OK;
+        default:
+            throw new CliError(`unknown nb subcommand: ${sub}`, EXIT.USAGE, "run 'nebula nb --help' for the list");
+    }
+}
+// =============================================================================
+// nb read
+// =============================================================================
+const READ_HELP = `usage: nebula nb read <path> [--cells A-B|id,id] [--outputs] [--full]
+
+One line per cell: #<idx> <id> <type> [exec_count] <first line…>
+
+examples:
+  nebula nb read analysis.ipynb              # compact listing
+  nebula nb read analysis.ipynb --outputs    # append truncated output tails
+  nebula nb read analysis.ipynb --full       # full cell sources
+  nebula nb read analysis.ipynb --cells 2-5  # only cells #2..#5
+  nebula nb read analysis.ipynb --cells cell-a,cell-b`;
+/** Parse --cells selector: comma list of 1-based indices, A-B ranges, or cell ids. */
+function selectCells(cells, selector) {
+    const all = cells.map((cell, index) => ({ cell, index }));
+    if (!selector)
+        return all;
+    const keep = new Set();
+    for (const token of selector.split(',').map((t) => t.trim()).filter(Boolean)) {
+        const range = token.match(/^(\d+)-(\d+)$/);
+        if (range) {
+            const from = Number.parseInt(range[1], 10);
+            const to = Number.parseInt(range[2], 10);
+            for (let i = from; i <= to; i++)
+                keep.add(i - 1);
+            continue;
+        }
+        if (/^\d+$/.test(token)) {
+            keep.add(Number.parseInt(token, 10) - 1);
+            continue;
+        }
+        const byId = cells.findIndex((c) => c.id === token);
+        if (byId === -1) {
+            throw new CliError(`no cell matches selector "${token}"`, EXIT.ERROR, 'list cell ids with: nebula nb read <path>');
+        }
+        keep.add(byId);
+    }
+    return all.filter(({ index }) => keep.has(index));
+}
+function cellLine(cell, index) {
+    const exec = cell.executionCount ? ` [${cell.executionCount}]` : '';
+    const first = firstLineOf(cell.content);
+    return `#${index + 1} ${cell.id} ${cell.type}${exec}${first ? ` ${first}` : ''}`;
+}
+function outputTailLines(cell, maxLines = 3, maxChars = 120) {
+    if (!cell.outputs || cell.outputs.length === 0)
+        return [];
+    const text = cell.outputs
+        .map((o) => (o.type === 'image' ? '[image]\n' : o.type === 'error' ? `[error] ${o.content}\n` : o.content))
+        .join('');
+    return tailLines(text, maxLines).map((line) => {
+        const trimmed = line.length > maxChars ? `${line.slice(0, maxChars - 1)}…` : line;
+        return `    out: ${trimmed}`;
+    });
+}
+async function nbRead(argv) {
+    const { values, positionals } = parse(argv, {
+        cells: { type: 'string' },
+        outputs: { type: 'boolean' },
+        full: { type: 'boolean' },
+    });
+    if (values.help) {
+        console.log(READ_HELP);
+        return EXIT.OK;
+    }
+    const nbPath = requirePositional(positionals, 0, 'path', 'nebula nb read <path> [--cells …] [--outputs] [--full]');
+    const url = resolveUrl(values.url);
+    const client = makeClient(url, nbPath);
+    const wantOutputs = Boolean(values.outputs);
+    const result = await readNotebookTool.execute({ path: nbPath, format: 'content', include_outputs: wantOutputs }, client);
+    if (!result.success)
+        throw toCliError(result.error, nbPath);
+    const { cells, totalCells } = result.data;
+    const selected = selectCells(cells, values.cells);
+    if (values.json) {
+        printJson({ path: nbPath, totalCells, cells: selected.map(({ cell, index }) => ({ index, ...cell })) });
+        return EXIT.OK;
+    }
+    console.log(`${nbPath} (${totalCells} cells)`);
+    for (const { cell, index } of selected) {
+        if (values.full) {
+            console.log('');
+            console.log(cellLine(cell, index));
+            console.log(cell.content);
+        }
+        else {
+            console.log(cellLine(cell, index));
+        }
+        if (wantOutputs) {
+            for (const line of outputTailLines(cell))
+                console.log(line);
+        }
+    }
+    if (totalCells === 0) {
+        printHint(`add a cell with: nebula nb insert ${nbPath} --index -1 --content '…'`, values);
+    }
+    else {
+        printHint(`execute a cell with: nebula run ${nbPath} <cell-id>`, values);
+    }
+    return EXIT.OK;
+}
+// =============================================================================
+// nb edit
+// =============================================================================
+const EDIT_HELP = `usage: nebula nb edit <path> <cell-id> (--content <str> | --content-file <f> | -)
+
+Updates a cell's content. The write is OCC-checked: if the cell changed since
+you last read it, the command exits 9 and prints the current content so you
+can retry against it.
+
+examples:
+  nebula nb edit analysis.ipynb cell-3 --content 'x = 42'
+  nebula nb edit analysis.ipynb cell-3 --content-file new_cell.py
+  echo 'x = 42' | nebula nb edit analysis.ipynb cell-3 -`;
+async function nbEdit(argv) {
+    const { values, positionals } = parse(argv, {
+        content: { type: 'string' },
+        'content-file': { type: 'string' },
+    });
+    if (values.help) {
+        console.log(EDIT_HELP);
+        return EXIT.OK;
+    }
+    const usage = 'nebula nb edit <path> <cell-id> (--content <str> | --content-file <f> | -)';
+    const nbPath = requirePositional(positionals, 0, 'path', usage);
+    const cellId = requirePositional(positionals, 1, 'cell-id', usage);
+    const stdinMarker = positionals[2] === '-';
+    if (positionals.length > 2 && !stdinMarker) {
+        throw new CliError(`unexpected argument: ${positionals[2]}`, EXIT.USAGE, `usage: ${usage}`);
+    }
+    const content = await resolveContentInput(values.content, values['content-file'], stdinMarker);
+    const url = resolveUrl(values.url);
+    const client = makeClient(url, nbPath);
+    // Use the shared operation path directly so OCC conflict metadata
+    // (conflict/currentContent) survives to the CLI.
+    const result = await client.applyOperation({ type: 'updateContent', notebookPath: nbPath, cellId, content });
+    if (!result.success)
+        throw toCliError(result.error, nbPath);
+    const op = result.data;
+    if (!op.success) {
+        const isConflict = op.conflict === true || /conflict/i.test(op.error ?? '');
+        if (isConflict) {
+            let current = op.currentContent;
+            if (current === undefined) {
+                const read = await readCellTool.execute({ path: nbPath, cell_id: cellId }, client);
+                current = read.success ? read.data.cell.content : undefined;
+            }
+            console.log('CONFLICT: cell changed — current content below; retry your edit against it');
+            if (current !== undefined)
+                console.log(current);
+            console.error(`error: cell ${cellId} was modified since you last read it (OCC conflict)`);
+            return EXIT.CONFLICT;
+        }
+        throw toCliError(op.error, nbPath);
+    }
+    if (values.json) {
+        printJson({ path: nbPath, cellId, updated: true });
+        return EXIT.OK;
+    }
+    console.log(`updated ${cellId}`);
+    printHint(`execute it with: nebula run ${nbPath} ${cellId}`, values);
+    return EXIT.OK;
+}
+// =============================================================================
+// nb insert
+// =============================================================================
+const INSERT_HELP = `usage: nebula nb insert <path> --index N (--content <str> | --content-file <f> | -)
+                        [--type code|markdown] [--id ID]
+
+--index is 0-based; use -1 to append at the end.
+
+examples:
+  nebula nb insert analysis.ipynb --index -1 --content 'print(df.shape)'
+  nebula nb insert analysis.ipynb --index 0 --type markdown --content '# Intro'
+  cat setup.py | nebula nb insert analysis.ipynb --index 2 -`;
+async function nbInsert(argv) {
+    const { values, positionals } = parse(argv, {
+        index: { type: 'string' },
+        content: { type: 'string' },
+        'content-file': { type: 'string' },
+        type: { type: 'string' },
+        id: { type: 'string' },
+    });
+    if (values.help) {
+        console.log(INSERT_HELP);
+        return EXIT.OK;
+    }
+    const usage = 'nebula nb insert <path> --index N (--content … | --content-file … | -) [--type code|markdown] [--id ID]';
+    const nbPath = requirePositional(positionals, 0, 'path', usage);
+    if (values.index === undefined) {
+        throw new CliError('missing --index (use -1 to append)', EXIT.USAGE, `usage: ${usage}`);
+    }
+    const index = parseIntFlag(values.index, '--index', -1);
+    const stdinMarker = positionals[1] === '-';
+    const content = await resolveContentInput(values.content, values['content-file'], stdinMarker);
+    const cellType = values.type ?? 'code';
+    if (cellType !== 'code' && cellType !== 'markdown') {
+        throw new CliError(`--type must be code or markdown, got "${cellType}"`, EXIT.USAGE);
+    }
+    const cellId = values.id ?? `cell-${Date.now().toString(36)}-${randomBytes(2).toString('hex')}`;
+    const url = resolveUrl(values.url);
+    const client = makeClient(url, nbPath);
+    const result = await insertCellTool.execute({ path: nbPath, cell_id: cellId, content, cell_type: cellType, position: index }, client);
+    if (!result.success)
+        throw toCliError(result.error, nbPath);
+    const data = result.data;
+    if (values.json) {
+        printJson({ path: nbPath, ...data });
+        return EXIT.OK;
+    }
+    let line = `inserted ${data.cellId} at #${data.cellIndex + 1}`;
+    if (data.idModified) {
+        line += ` (requested id "${data.requestedId}" was taken)`;
+    }
+    console.log(line);
+    printHint(`execute it with: nebula run ${nbPath} ${data.cellId}`, values);
+    return EXIT.OK;
+}
+// =============================================================================
+// nb delete
+// =============================================================================
+const DELETE_HELP = `usage: nebula nb delete <path> <cell-id>
+
+examples:
+  nebula nb delete analysis.ipynb cell-3`;
+async function nbDelete(argv) {
+    const { values, positionals } = parse(argv);
+    if (values.help) {
+        console.log(DELETE_HELP);
+        return EXIT.OK;
+    }
+    const usage = 'nebula nb delete <path> <cell-id>';
+    const nbPath = requirePositional(positionals, 0, 'path', usage);
+    const cellId = requirePositional(positionals, 1, 'cell-id', usage);
+    const url = resolveUrl(values.url);
+    const client = makeClient(url, nbPath);
+    const result = await deleteCellTool.execute({ path: nbPath, cell_id: cellId }, client);
+    if (!result.success)
+        throw toCliError(result.error, nbPath);
+    if (values.json) {
+        printJson({ path: nbPath, cellId, deleted: true });
+        return EXIT.OK;
+    }
+    console.log(`deleted ${cellId}`);
+    printHint(`review remaining cells with: nebula nb read ${nbPath}`, values);
+    return EXIT.OK;
+}
+// =============================================================================
+// nb search
+// =============================================================================
+const SEARCH_HELP = `usage: nebula nb search <path> <query> [--limit N]
+
+examples:
+  nebula nb search analysis.ipynb "read_csv"
+  nebula nb search analysis.ipynb TODO --limit 20`;
+async function nbSearch(argv) {
+    const { values, positionals } = parse(argv, { limit: { type: 'string' } });
+    if (values.help) {
+        console.log(SEARCH_HELP);
+        return EXIT.OK;
+    }
+    const usage = 'nebula nb search <path> <query> [--limit N]';
+    const nbPath = requirePositional(positionals, 0, 'path', usage);
+    const query = requirePositional(positionals, 1, 'query', usage);
+    const limit = parseIntFlag(values.limit, '--limit', 10);
+    const url = resolveUrl(values.url);
+    const client = makeClient(url, nbPath);
+    const result = await searchCellsTool.execute({ path: nbPath, query, limit }, client);
+    if (!result.success)
+        throw toCliError(result.error, nbPath);
+    const data = result.data;
+    if (values.json) {
+        printJson(data);
+        return EXIT.OK;
+    }
+    console.log(`${data.matchCount} match${data.matchCount === 1 ? '' : 'es'} for "${query}"`);
+    for (const m of data.matches) {
+        const loc = m.matchLocation === 'output' ? `output[${m.outputIndex ?? 0}]` : `source:${m.matchLine ?? 0}`;
+        console.log(`#${m.cellIndex + 1} ${m.cellId} ${loc}  ${m.preview}`);
+    }
+    if (data.hasMore) {
+        console.log(`(showing first ${data.matches.length}; raise --limit for more)`);
+    }
+    if (data.matchCount > 0) {
+        printHint(`view a matching cell with: nebula nb read ${nbPath} --cells <cell-id> --full`, values);
+    }
+    return EXIT.OK;
+}
+//# sourceMappingURL=nb.js.map

package/dist/cli/nb.js.map

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

package/dist/cli/run.d.ts

@@ -0,0 +1,7 @@
+/**
+ * `nebula run` — the flagship combined operation (AXI): execute a cell and
+ * report status, execution count, elapsed time, and the output tail in a
+ * single invocation.
+ */
+export declare function cmdRun(argv: string[]): Promise<number>;
+//# sourceMappingURL=run.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/cli/run.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAuCH,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAgG5D"}

package/dist/cli/run.js

@@ -0,0 +1,120 @@
+/**
+ * `nebula run` — the flagship combined operation (AXI): execute a cell and
+ * report status, execution count, elapsed time, and the output tail in a
+ * single invocation.
+ */
+import { EXIT, makeClient, parse, parseIntFlag, printHint, printJson, requirePositional, resolveUrl, tailLines, toCliError, } from './shared.js';
+const RUN_HELP = `usage: nebula run <path> <cell-id> [--tail N] [--max-wait S] [--no-wait]
+
+Executes the cell and BLOCKS until it completes (up to --max-wait, default
+300s; 0 = no limit), then prints status, execution_count, elapsed, and the
+last N output lines (default 40). Long runs are followed with cheap internal
+polling — launch this as a background shell task and the process exit IS the
+completion signal (no agent-side polling needed).
+
+Non-ok status exits 1 with the error/traceback tail.
+Exit 3 = still running when --max-wait expired (not an error).
+--no-wait = fire-and-forget: start execution and return immediately.
+
+examples:
+  nebula run analysis.ipynb cell-3
+  nebula run analysis.ipynb train-cell --max-wait 0     # wait however long it takes
+  nebula run analysis.ipynb train-cell --no-wait        # start it and come back later`;
+/** Per-request cap on the server-side long-poll (tunnel/proxy safe). */
+const SERVER_WAIT_CHUNK_S = 25;
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+export async function cmdRun(argv) {
+    const { values, positionals } = parse(argv, {
+        tail: { type: 'string' },
+        'max-wait': { type: 'string' },
+        'no-wait': { type: 'boolean' },
+    });
+    if (values.help) {
+        console.log(RUN_HELP);
+        return EXIT.OK;
+    }
+    const usage = 'nebula run <path> <cell-id> [--tail N] [--max-wait S] [--no-wait]';
+    const nbPath = requirePositional(positionals, 0, 'path', usage);
+    const cellId = requirePositional(positionals, 1, 'cell-id', usage);
+    const tailN = parseIntFlag(values.tail, '--tail', 40);
+    const maxWait = parseIntFlag(values['max-wait'], '--max-wait', 300);
+    const noWait = values['no-wait'] === true;
+    const url = resolveUrl(values.url);
+    const client = makeClient(url, nbPath);
+    const started = Date.now();
+    // --max-wait 0 (CLI) = wait forever. (The MCP's max_wait=0 means "return
+    // immediately" — the CLI expresses that as --no-wait instead.)
+    const deadline = noWait ? started : maxWait <= 0 ? Number.POSITIVE_INFINITY : started + maxWait * 1000;
+    const initialWait = noWait ? 0 : Math.min(maxWait <= 0 ? SERVER_WAIT_CHUNK_S : maxWait, SERVER_WAIT_CHUNK_S);
+    const result = await client.executeCellOp(nbPath, { cellId, maxWait: initialWait });
+    if (!result.success)
+        throw toCliError(result.error, nbPath);
+    let d = result.data;
+    if (noWait) {
+        if (values.json) {
+            printJson({ ...d, status: 'started' });
+        }
+        else {
+            console.log('status: started');
+            printHint(`check on it with: nebula nb read ${nbPath} --cells ${cellId} --outputs`, values);
+        }
+        return EXIT.OK;
+    }
+    // Follow the execution: the server long-polls up to SERVER_WAIT_CHUNK_S per
+    // request; between requests we back off 2s → 10s. The agent never polls —
+    // this process simply doesn't exit until the cell is done (or deadline).
+    let pollMs = 2000;
+    while (d.executionStatus === 'busy' && Date.now() < deadline) {
+        await sleep(Math.min(pollMs, Math.max(0, deadline - Date.now())));
+        pollMs = Math.min(pollMs * 1.4, 10_000);
+        try {
+            const r = await client.readCellOutputOp(nbPath, { cellId });
+            if (r.success && r.data) {
+                d = {
+                    ...d,
+                    outputs: r.data.outputs ?? d.outputs,
+                    executionCount: r.data.executionCount ?? d.executionCount,
+                    executionStatus: r.data.executionStatus ?? d.executionStatus,
+                };
+            }
+        }
+        catch {
+            // transient network blip — keep following
+        }
+    }
+    const elapsedSec = d.executionTime !== undefined ? d.executionTime / 1000 : (Date.now() - started) / 1000;
+    const failed = d.executionStatus === 'error' || d.outputs.some((o) => o.type === 'error');
+    const status = failed ? 'error' : d.executionStatus === 'busy' ? 'busy' : 'ok';
+    if (values.json) {
+        printJson({ ...d, status, elapsed: elapsedSec });
+        return failed ? EXIT.ERROR : status === 'busy' ? EXIT.RUNNING : EXIT.OK;
+    }
+    console.log(`status: ${status}`);
+    console.log(`execution_count: ${d.executionCount ?? '-'}`);
+    console.log(`elapsed: ${elapsedSec.toFixed(1)}s`);
+    const text = d.outputs
+        .map((o) => (o.type === 'image' ? '[image]\n' : o.type === 'error' ? `${o.content}\n` : o.content))
+        .join('');
+    if (!text.trim()) {
+        console.log('(no output)');
+    }
+    else {
+        const lines = tailLines(text, tailN);
+        console.log(`--- output tail (last ${lines.length} line${lines.length === 1 ? '' : 's'}) ---`);
+        for (const line of lines)
+            console.log(line);
+    }
+    if (failed) {
+        console.error('error: cell execution failed');
+        return EXIT.ERROR;
+    }
+    if (status === 'busy') {
+        printHint(`still running after ${maxWait}s (exit 3); wait to completion with: nebula run ${nbPath} ${cellId} --max-wait 0`, values);
+        return EXIT.RUNNING;
+    }
+    printHint(`see all saved outputs with: nebula nb read ${nbPath} --outputs`, values);
+    return EXIT.OK;
+}
+//# sourceMappingURL=run.js.map

package/dist/cli/run.js.map

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

package/dist/cli/session.d.ts

@@ -0,0 +1,10 @@
+/**
+ * `nebula session …` — agent-lock sessions.
+ *
+ * `session start` acquires the agent lock via the shared client and persists
+ * the agent token to $NEBULA_STATE_DIR (or ~/.nebula), keyed by hash of
+ * url+path, so separate CLI invocations share the same lock. Other commands
+ * attach the token automatically (see makeClient in shared.ts).
+ */
+export declare function cmdSession(argv: string[]): Promise<number>;
+//# sourceMappingURL=session.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/cli/session.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA6BH,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAehE"}