nosana-mcp 0.2.0

package/dist/cli/commands/templates.js

@@ -0,0 +1,115 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import pc from 'picocolors';
+import { CliError, createClient } from '../../core/client.js';
+import { heading, printJson, sym, table } from '../../core/format.js';
+import { hardwareHints, listTemplates, prepareJobDefinition, resolveTemplate, topLevelTemplates, findTemplate, NeedsVariantError } from '../../core/templates.js';
+export function registerTemplateCommands(program, globals) {
+    const templates = program.command('templates').alias('template').description('Browse the ready-to-run Nosana templates (MiniMax H3, Ollama models, ComfyUI, Jupyter, ...).');
+    templates
+        .command('list', { isDefault: true })
+        .description('List templates. Variants (e.g. minimax-h3-i2v-32gb) are folded under their parent unless --all is given.')
+        .option('--all', 'Show every variant template as its own row')
+        .option('--search <text>', 'Filter by id, name or category')
+        .action(async (cmd) => {
+        const options = globals();
+        const client = createClient(options);
+        let all = await listTemplates(client);
+        if (cmd.search) {
+            const q = cmd.search.toLowerCase();
+            all = all.filter((t) => t.id.toLowerCase().includes(q) || t.name.toLowerCase().includes(q) || t.category.join(' ').toLowerCase().includes(q));
+        }
+        const rows = cmd.all ? all : topLevelTemplates(all);
+        const vramLabel = (t) => {
+            const values = t.variants.length
+                ? t.variants.map((v) => all.find((x) => x.id === `${t.id}-${v.id}`)?.vramRequirementGb ?? null).filter((n) => n !== null)
+                : t.vramRequirementGb !== null
+                    ? [t.vramRequirementGb]
+                    : [];
+            if (!values.length)
+                return pc.dim('-');
+            const min = Math.min(...values);
+            const max = Math.max(...values);
+            return min === max ? `${min} GB` : `${min} to ${max} GB`;
+        };
+        if (options.json) {
+            printJson(rows.map(({ readme: _readme, jobDefinition: _def, ...rest }) => rest));
+            return;
+        }
+        console.log(table(['ID', 'Name', 'Category', 'Variants', 'VRAM'], rows.map((t) => [
+            t.id,
+            t.name,
+            t.category.filter((c) => c !== 'Official').join(', '),
+            t.variants.length ? t.variants.map((v) => v.id).join(', ') : pc.dim('-'),
+            vramLabel(t),
+        ])));
+        console.log(`\n${rows.length} templates. Use \`nosana-deploy templates show <id>\` for details or \`nosana-deploy run --template <id>\` to deploy one.`);
+    });
+    templates
+        .command('show')
+        .description('Show a template: variants, hardware needs, exposed ports and the job definition it deploys.')
+        .argument('<id>', 'Template id or name, e.g. minimax-h3')
+        .option('--variant <id>', 'Variant id, e.g. i2v-32gb')
+        .option('--readme', 'Print the full README instead of a summary')
+        .action(async (id, cmd) => {
+        const options = globals();
+        const client = createClient(options);
+        const all = await listTemplates(client);
+        const parent = findTemplate(all, id);
+        if (!parent)
+            throw new CliError(`Unknown template "${id}".`);
+        let resolved;
+        try {
+            resolved = resolveTemplate(all, id, cmd.variant);
+        }
+        catch (error) {
+            if (!(error instanceof NeedsVariantError))
+                throw error;
+            resolved = null;
+        }
+        const template = resolved?.template ?? parent;
+        if (options.json) {
+            printJson({ parent: { ...parent, readme: undefined }, template: { ...template, readme: cmd.readme ? template.readme : undefined } });
+            return;
+        }
+        const hints = hardwareHints(parent);
+        console.log(`${pc.bold(parent.name)}  ${pc.dim(parent.id)}`);
+        if (parent.description)
+            console.log(parent.description);
+        console.log(`Category: ${parent.category.join(', ')}`);
+        if (parent.variants.length) {
+            heading('Variants');
+            console.log(table(['ID', 'Name', 'Description'], parent.variants.map((v) => [v.id, v.name, v.description ?? ''])));
+            if (!resolved)
+                console.log(`\n${sym.info} Add --variant <id> to see one variant's job definition.`);
+        }
+        heading('Hardware');
+        console.log(`VRAM needed: ${template.vramRequirementGb ? `${template.vramRequirementGb} GB` : 'not specified'}`);
+        for (const note of hints.notes)
+            console.log(`${sym.warn} ${note}`);
+        if (resolved) {
+            heading(`Job definition (${resolved.id})`);
+            console.log(JSON.stringify(prepareJobDefinition(resolved.jobDefinition), null, 2));
+        }
+        if (cmd.readme && parent.readme) {
+            heading('README');
+            console.log(parent.readme);
+        }
+    });
+    templates
+        .command('export')
+        .description('Write a template job definition to a file so you can customise it and deploy with --file.')
+        .argument('<id>', 'Template id, e.g. minimax-h3')
+        .option('--variant <id>', 'Variant id, e.g. i2v-32gb')
+        .option('-o, --output <file>', 'Output path (defaults to <template-id>.json)')
+        .action(async (id, cmd) => {
+        const options = globals();
+        const client = createClient(options);
+        const resolved = resolveTemplate(await listTemplates(client), id, cmd.variant);
+        const target = path.resolve(cmd.output ?? `${resolved.id}.json`);
+        fs.writeFileSync(target, `${JSON.stringify(prepareJobDefinition(resolved.jobDefinition), null, 2)}\n`);
+        console.log(`${sym.ok} Wrote ${target}`);
+        console.log(`Deploy it with: nosana-deploy run --file ${path.relative(process.cwd(), target) || target} --gpu <slug>`);
+    });
+}
+//# sourceMappingURL=templates.js.map

package/dist/cli/commands/templates.js.map

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

package/dist/cli/index.d.ts

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

package/dist/cli/index.js

@@ -0,0 +1,45 @@
+#!/usr/bin/env node
+import { createRequire } from 'node:module';
+import { Command, Option } from 'commander';
+import { CliError } from '../core/client.js';
+import { formatError, sym } from '../core/format.js';
+import { registerAccountCommands } from './commands/account.js';
+import { registerDeployCommands } from './commands/deploy.js';
+import { registerGpuCommands } from './commands/gpus.js';
+import { registerJobCommands } from './commands/job.js';
+import { registerRunCommand } from './commands/run.js';
+import { registerTemplateCommands } from './commands/templates.js';
+const { version: VERSION } = createRequire(import.meta.url)('../../package.json');
+const program = new Command()
+    .name('nosana-deploy')
+    .description('Nosana Deploy CLI (part of Nosana MCP): deploy GPU workloads on Nosana with account credits. Pick a template such as MiniMax H3, choose a GPU, run it.')
+    .version(VERSION)
+    .addOption(new Option('-n, --network <network>', 'Nosana network').choices(['mainnet', 'devnet']).default('mainnet'))
+    .option('--api-key <key>', 'Nosana API key (defaults to NOSANA_API_KEY or the key saved by `login`)')
+    .option('--rpc <url>', 'Solana RPC URL, only used for optional on-chain queue reads')
+    .option('--json', 'Machine-readable JSON output')
+    .showHelpAfterError('(add --help for usage)')
+    .addHelpText('after', `
+Quick start:
+  nosana-deploy login                      store your API key from deploy.nosana.com
+  nosana-deploy templates list             see what you can run (MiniMax H3, Qwen, ComfyUI, Jupyter, ...)
+  nosana-deploy gpus --template minimax-h3 --variant i2v-32gb
+  nosana-deploy run                        guided: template -> GPU -> timeout -> confirm -> live status
+  nosana-deploy deploy list                everything you have deployed
+  nosana-deploy deploy stop <id>           stop paying for a running deployment`);
+const globals = () => program.opts();
+registerAccountCommands(program, globals);
+registerTemplateCommands(program, globals);
+registerGpuCommands(program, globals);
+registerRunCommand(program, globals);
+registerDeployCommands(program, globals);
+registerJobCommands(program, globals);
+program.parseAsync().catch((error) => {
+    if (error instanceof Error && error.name === 'ExitPromptError') {
+        console.error('\nCancelled.');
+        process.exit(130);
+    }
+    console.error(`${sym.err} ${formatError(error)}`);
+    process.exit(error instanceof CliError ? error.exitCode : 1);
+});
+//# 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":";AACA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAsB,MAAM,mBAAmB,CAAC;AACjE,OAAO,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AAEnE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,oBAAoB,CAAwB,CAAC;AAEzG,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE;KAC1B,IAAI,CAAC,eAAe,CAAC;KACrB,WAAW,CAAC,wJAAwJ,CAAC;KACrK,OAAO,CAAC,OAAO,CAAC;KAChB,SAAS,CAAC,IAAI,MAAM,CAAC,yBAAyB,EAAE,gBAAgB,CAAC,CAAC,OAAO,CAAC,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;KACpH,MAAM,CAAC,iBAAiB,EAAE,yEAAyE,CAAC;KACpG,MAAM,CAAC,aAAa,EAAE,6DAA6D,CAAC;KACpF,MAAM,CAAC,QAAQ,EAAE,8BAA8B,CAAC;KAChD,kBAAkB,CAAC,wBAAwB,CAAC;KAC5C,WAAW,CACV,OAAO,EACP;;;;;;;gFAO4E,CAC7E,CAAC;AAEJ,MAAM,OAAO,GAAG,GAAkB,EAAE,CAAC,OAAO,CAAC,IAAI,EAAiB,CAAC;AAEnE,uBAAuB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;AAC1C,wBAAwB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;AAC3C,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;AACtC,kBAAkB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;AACrC,sBAAsB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;AACzC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;AAEtC,OAAO,CAAC,UAAU,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IAC5C,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,iBAAiB,EAAE,CAAC;QAC/D,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;QAC9B,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACpB,CAAC;IACD,OAAO,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,GAAG,IAAI,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAClD,OAAO,CAAC,IAAI,CAAC,KAAK,YAAY,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC/D,CAAC,CAAC,CAAC"}

package/dist/core/client.d.ts

@@ -0,0 +1,23 @@
+import { NosanaNetwork, type NosanaClient } from '@nosana/kit';
+import { type Network } from './config.js';
+export interface GlobalOptions {
+    apiKey?: string;
+    network: Network;
+    rpc?: string;
+    json?: boolean;
+}
+export declare class CliError extends Error {
+    readonly exitCode: number;
+    constructor(message: string, exitCode?: number);
+}
+export declare const NO_KEY_MESSAGE: string;
+export declare function requireApiKey(options: GlobalOptions): string;
+export declare function toKitNetwork(network: Network): NosanaNetwork;
+export type ClientLogLevel = 'none' | 'error';
+export declare function createClient(options: GlobalOptions, apiKey?: string, logLevel?: ClientLogLevel): NosanaClient;
+export declare function createPublicClient(options: GlobalOptions): NosanaClient;
+export type Api = NosanaClient['api'];
+export type ApiDeployment = Awaited<ReturnType<Api['deployments']['get']>>;
+export type CreateDeploymentBody = Parameters<Api['deployments']['create']>[0];
+export type CreditsBalance = Awaited<ReturnType<Api['credits']['balance']>>;
+export type { JobDefinition } from '@nosana/kit';

package/dist/core/client.js

@@ -0,0 +1,38 @@
+import { createNosanaClient, NosanaNetwork } from '@nosana/kit';
+import { resolveApiKey } from './config.js';
+export class CliError extends Error {
+    exitCode;
+    constructor(message, exitCode = 1) {
+        super(message);
+        this.exitCode = exitCode;
+        this.name = 'CliError';
+    }
+}
+export const NO_KEY_MESSAGE = [
+    'No Nosana API key found.',
+    '  Run `nosana-deploy login` to store one, set NOSANA_API_KEY, or pass --api-key.',
+    '  Create a key at https://deploy.nosana.com (Account > API Keys).',
+].join('\n');
+export function requireApiKey(options) {
+    const resolved = resolveApiKey(options.apiKey);
+    if (!resolved)
+        throw new CliError(NO_KEY_MESSAGE);
+    return resolved.key;
+}
+export function toKitNetwork(network) {
+    return network === 'devnet' ? NosanaNetwork.DEVNET : NosanaNetwork.MAINNET;
+}
+export function createClient(options, apiKey = requireApiKey(options), logLevel = 'error') {
+    return createNosanaClient(toKitNetwork(options.network), {
+        api: { apiKey },
+        logLevel,
+        ...(options.rpc ? { solana: { rpcEndpoint: options.rpc } } : {}),
+    });
+}
+export function createPublicClient(options) {
+    return createNosanaClient(toKitNetwork(options.network), {
+        logLevel: 'error',
+        ...(options.rpc ? { solana: { rpcEndpoint: options.rpc } } : {}),
+    });
+}
+//# sourceMappingURL=client.js.map

package/dist/core/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/core/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAqB,MAAM,aAAa,CAAC;AACnF,OAAO,EAAE,aAAa,EAAgB,MAAM,aAAa,CAAC;AAS1D,MAAM,OAAO,QAAS,SAAQ,KAAK;IAGtB;IAFX,YACE,OAAe,EACN,WAAW,CAAC;QAErB,KAAK,CAAC,OAAO,CAAC,CAAC;QAFN,aAAQ,GAAR,QAAQ,CAAI;QAGrB,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;IACzB,CAAC;CACF;AAED,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,0BAA0B;IAC1B,kFAAkF;IAClF,mEAAmE;CACpE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,MAAM,UAAU,aAAa,CAAC,OAAsB;IAClD,MAAM,QAAQ,GAAG,aAAa,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/C,IAAI,CAAC,QAAQ;QAAE,MAAM,IAAI,QAAQ,CAAC,cAAc,CAAC,CAAC;IAClD,OAAO,QAAQ,CAAC,GAAG,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,OAAgB;IAC3C,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC,OAAO,CAAC;AAC7E,CAAC;AAID,MAAM,UAAU,YAAY,CAC1B,OAAsB,EACtB,SAAiB,aAAa,CAAC,OAAO,CAAC,EACvC,WAA2B,OAAO;IAElC,OAAO,kBAAkB,CAAC,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE;QACvD,GAAG,EAAE,EAAE,MAAM,EAAE;QACf,QAAQ;QACR,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,WAAW,EAAE,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACjE,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,OAAsB;IACvD,OAAO,kBAAkB,CAAC,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE;QACvD,QAAQ,EAAE,OAAO;QACjB,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,WAAW,EAAE,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACjE,CAAC,CAAC;AACL,CAAC"}

package/dist/core/config.d.ts

@@ -0,0 +1,18 @@
+export type Network = 'mainnet' | 'devnet';
+export interface StoredConfig {
+    apiKey?: string;
+    network?: Network;
+    rpc?: string;
+}
+export declare const CONFIG_DIR: string;
+export declare const CONFIG_FILE: string;
+export declare function readConfig(): StoredConfig;
+export declare function writeConfig(config: StoredConfig): void;
+export declare function clearConfig(): boolean;
+export type ApiKeySource = 'flag' | 'env' | 'config';
+export declare function resolveApiKey(explicit?: string): {
+    key: string;
+    source: ApiKeySource;
+} | undefined;
+export declare function maskKey(key: string): string;
+export declare function isInteractive(): boolean;

package/dist/core/config.js

@@ -0,0 +1,52 @@
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+export const CONFIG_DIR = process.env.NOSANA_DEPLOY_CONFIG_DIR ?? path.join(os.homedir(), '.config', 'nosana-deploy');
+export const CONFIG_FILE = path.join(CONFIG_DIR, 'config.json');
+export function readConfig() {
+    try {
+        const parsed = JSON.parse(fs.readFileSync(CONFIG_FILE, 'utf8'));
+        return parsed && typeof parsed === 'object' && !Array.isArray(parsed) ? parsed : {};
+    }
+    catch {
+        return {};
+    }
+}
+export function writeConfig(config) {
+    fs.mkdirSync(CONFIG_DIR, { recursive: true, mode: 0o700 });
+    fs.writeFileSync(CONFIG_FILE, `${JSON.stringify(config, null, 2)}\n`, { mode: 0o600 });
+    try {
+        fs.chmodSync(CONFIG_FILE, 0o600);
+    }
+    catch {
+        /* best effort */
+    }
+}
+export function clearConfig() {
+    try {
+        fs.unlinkSync(CONFIG_FILE);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function resolveApiKey(explicit) {
+    if (explicit)
+        return { key: explicit, source: 'flag' };
+    if (process.env.NOSANA_API_KEY)
+        return { key: process.env.NOSANA_API_KEY, source: 'env' };
+    const stored = readConfig().apiKey;
+    if (stored)
+        return { key: stored, source: 'config' };
+    return undefined;
+}
+export function maskKey(key) {
+    if (key.length <= 12)
+        return '****';
+    return `${key.slice(0, 8)}...${key.slice(-4)}`;
+}
+export function isInteractive() {
+    return Boolean(process.stdin.isTTY && process.stdout.isTTY);
+}
+//# sourceMappingURL=config.js.map

package/dist/core/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAU7B,MAAM,CAAC,MAAM,UAAU,GACrB,OAAO,CAAC,GAAG,CAAC,wBAAwB,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,eAAe,CAAC,CAAC;AAC9F,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;AAEhE,MAAM,UAAU,UAAU;IACxB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,WAAW,EAAE,MAAM,CAAC,CAAY,CAAC;QAC3E,OAAO,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAE,MAAuB,CAAC,CAAC,CAAC,EAAE,CAAC;IACxG,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,MAAoB;IAC9C,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAC3D,EAAE,CAAC,aAAa,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACvF,IAAI,CAAC;QACH,EAAE,CAAC,SAAS,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,iBAAiB;IACnB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,WAAW;IACzB,IAAI,CAAC;QACH,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;QAC3B,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAID,MAAM,UAAU,aAAa,CAAC,QAAiB;IAC7C,IAAI,QAAQ;QAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IACvD,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc;QAAE,OAAO,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IAC1F,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC,MAAM,CAAC;IACnC,IAAI,MAAM;QAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;IACrD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,GAAW;IACjC,IAAI,GAAG,CAAC,MAAM,IAAI,EAAE;QAAE,OAAO,MAAM,CAAC;IACpC,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,OAAO,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC9D,CAAC"}

package/dist/core/credits.d.ts

@@ -0,0 +1,9 @@
+import type { CreditsBalance } from './client.js';
+export interface BalanceSummary {
+    assigned: number;
+    reserved: number;
+    settled: number;
+    available: number;
+}
+export declare function summarizeBalance(balance: CreditsBalance): BalanceSummary;
+export declare const availableCredits: (balance: CreditsBalance) => number;

package/dist/core/credits.js

@@ -0,0 +1,9 @@
+export function summarizeBalance(balance) {
+    const b = balance;
+    const assigned = b.assignedCredits ?? 0;
+    const reserved = b.reservedCredits ?? 0;
+    const settled = b.settledCredits ?? 0;
+    return { assigned, reserved, settled, available: assigned - reserved - settled };
+}
+export const availableCredits = (balance) => summarizeBalance(balance).available;
+//# sourceMappingURL=credits.js.map

package/dist/core/credits.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"credits.js","sourceRoot":"","sources":["../../src/core/credits.ts"],"names":[],"mappings":"AAWA,MAAM,UAAU,gBAAgB,CAAC,OAAuB;IACtD,MAAM,CAAC,GAAG,OAAiC,CAAC;IAC5C,MAAM,QAAQ,GAAG,CAAC,CAAC,eAAe,IAAI,CAAC,CAAC;IACxC,MAAM,QAAQ,GAAG,CAAC,CAAC,eAAe,IAAI,CAAC,CAAC;IACxC,MAAM,OAAO,GAAG,CAAC,CAAC,cAAc,IAAI,CAAC,CAAC;IACtC,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,GAAG,QAAQ,GAAG,OAAO,EAAE,CAAC;AACnF,CAAC;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,OAAuB,EAAU,EAAE,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC"}

package/dist/core/deploy.d.ts

@@ -0,0 +1,146 @@
+import type { JobDefinition, NosanaClient } from '@nosana/kit';
+import { type ApiDeployment, type CreateDeploymentBody } from './client.js';
+import type { Network } from './config.js';
+import { type GpuMarket, type GpuTableOptions } from './markets.js';
+import { type WorkloadKind } from './templates.js';
+export type Strategy = 'SIMPLE' | 'SIMPLE-EXTEND' | 'SCHEDULED' | 'INFINITE';
+/** Nosana refuses credit-paid jobs shorter than 3600 seconds, so every deployment needs at least this timeout. */
+export declare const MIN_TIMEOUT_MINUTES = 60;
+export declare const STRATEGIES: readonly Strategy[];
+export declare function parseStrategy(value: string | undefined): Strategy;
+export interface DeployPlan {
+    name: string;
+    /** Human label of what is being deployed (template id or file name). */
+    workload: string;
+    jobDefinition: JobDefinition;
+    gpu: GpuMarket;
+    timeoutMinutes: number;
+    replicas: number;
+    strategy: Strategy;
+    schedule?: string;
+    rotationTime?: number;
+    startupTimeoutMinutes?: number;
+    confidential: boolean;
+    sshPublicKeys?: string[];
+}
+export declare function defaultDeploymentName(label: string): string;
+export interface PlanAssessment {
+    /** Problems that should stop the deployment unless the caller forces it. */
+    blocking: string[];
+    /** Things worth knowing that do not block. */
+    advisories: string[];
+    /** blocking followed by advisories, for printing. */
+    warnings: string[];
+    cost: CostEstimate;
+}
+export interface AssessOptions {
+    /** Treat "no idle host" as blocking (agents must get explicit consent to queue). */
+    requireIdle?: boolean;
+}
+export declare function assessPlan(plan: DeployPlan, fit: GpuTableOptions, creditsAvailable: number, options?: AssessOptions): PlanAssessment;
+export interface CostEstimate {
+    perHour: number;
+    hours: number;
+    total: number;
+    recurring: boolean;
+}
+/** 1 credit is priced like 1 USD on the dashboard; the estimate covers one full timeout window. */
+export declare function estimateCost(plan: DeployPlan): CostEstimate;
+export declare function validatePlan(plan: DeployPlan): void;
+export declare function buildCreateBody(plan: DeployPlan): CreateDeploymentBody;
+export declare function createDeployment(client: NosanaClient, plan: DeployPlan): Promise<ApiDeployment>;
+export declare const dashboardUrl: (id: string, network: Network) => string;
+export declare const explorerJobUrl: (job: string, network: Network) => string;
+export declare const normalizeJobState: (state: unknown) => string;
+export declare function summarizeDeployment(dep: ApiDeployment, network: Network): string[];
+export declare function deploymentsTable(deps: ApiDeployment[]): string;
+export interface WaitOptions {
+    timeoutMinutes: number;
+    intervalSeconds?: number;
+    network: Network;
+    quiet?: boolean;
+    /** Print the deployment's existing event log on the first pass (useful right after creation). */
+    replayEvents?: boolean;
+    /** Receive progress lines instead of printing them to stdout (used by the MCP server). */
+    onLog?: (line: string) => void;
+}
+export type WaitOutcome = {
+    kind: 'online';
+    deployment: ApiDeployment;
+    readyUrls: string[];
+} | {
+    kind: 'completed';
+    deployment: ApiDeployment;
+    job: string;
+} | {
+    kind: 'stopped';
+    deployment: ApiDeployment;
+} | {
+    kind: 'failed';
+    deployment: ApiDeployment;
+    reason: string;
+    error?: string;
+} | {
+    kind: 'timeout';
+    deployment: ApiDeployment;
+    phase: DeploymentPhase;
+};
+export type DeploymentPhase = 'draft' | 'scheduling' | 'queued' | 'starting' | 'initializing' | 'ready' | 'completed' | 'stopped' | 'error';
+export interface DefinitionFacts {
+    jobDefinition: JobDefinition | null;
+    exposes: boolean;
+    kind: WorkloadKind;
+    readinessPath: string;
+    bootMinutes: number;
+    opId: string | null;
+}
+export declare function inspectDefinition(dep: ApiDeployment): Promise<DefinitionFacts>;
+/** Where a deployment is in its life, derived from status, jobs and endpoint probes. */
+export declare function computePhase(dep: ApiDeployment, jobs: {
+    state: unknown;
+    node?: string | null;
+}[], endpoints: {
+    tunnel_online: boolean;
+    service_ready: boolean;
+}[], exposes: boolean): DeploymentPhase;
+export declare const PHASE_HINTS: Record<DeploymentPhase, {
+    message: string;
+    pollAfterSeconds: number;
+}>;
+export interface EndpointSnapshot {
+    url: string;
+    op: string;
+    port: number | string;
+    tunnel_online: boolean;
+    service_ready: boolean;
+}
+export interface DeploymentSnapshot {
+    deployment: ApiDeployment;
+    facts: DefinitionFacts;
+    phase: DeploymentPhase;
+    endpoints: EndpointSnapshot[];
+    readyUrls: string[];
+    jobs: {
+        job: string;
+        state: string;
+        node: string | null;
+        created_at?: string;
+        time_start?: number;
+    }[];
+    events: {
+        at?: string;
+        type?: string;
+        message?: string;
+    }[];
+    elapsedSeconds: number;
+}
+export declare function snapshotDeployment(client: NosanaClient, id: string, facts?: DefinitionFacts): Promise<DeploymentSnapshot>;
+export type EndpointProbe = 'ready' | 'initializing' | 'unreachable';
+/**
+ * The deployment manager marks an endpoint online as soon as the host's tunnel answers, which can be
+ * long before the container does: Nosana then serves a 503 "Service Initializing" page. Probe the URL
+ * so "online" means the workload itself responds.
+ */
+export declare function probeEndpoint(url: string, path?: string): Promise<EndpointProbe>;
+export declare function waitForDeployment(client: NosanaClient, id: string, options: WaitOptions): Promise<WaitOutcome>;
+export declare function formatJobResult(result: unknown): string[];