nomoreide 0.2.0 → 0.3.2

package/dist/core/vultr-manager.d.ts

@@ -1,113 +0,0 @@
-/**
- * Read-safe Vultr API v2 client — the observable half of the integration.
- *
- * Like `git-manager.ts` and `cloudflare-manager.ts`, this module deliberately
- * contains no operation that changes a machine. Start / halt / reboot live in
- * `vultr-actions.ts`, and destructive operations (delete, reinstall, restore)
- * are not implemented at all — the same line `GitManager` draws around
- * `reset --hard`.
- *
- * Every field and path below comes from Vultr's official Go SDK
- * (`github.com/vultr/govultr`), which is generated against the same API the
- * docs describe.
- */
-import type { ProviderFetch } from "./providers/egress.js";
-/** Vultr's `status` — the account-level lifecycle of the machine. */
-export type VultrInstanceStatus = "active" | "pending" | "suspended" | "resizing";
-export interface VultrAccount {
-    name: string;
-    email: string;
-    /** What this API key is permitted to do — `manage_users`, `subscriptions`, … */
-    acls: string[];
-}
-export interface VultrInstance {
-    id: string;
-    label: string;
-    hostname: string;
-    status: VultrInstanceStatus;
-    /** `running` / `stopped`. Empty until the instance finishes provisioning. */
-    powerStatus: string;
-    /** `none` / `locked` / `installingbooting` / `ok`. */
-    serverStatus: string;
-    /** Empty string while the instance has no address yet, normalized to undefined. */
-    mainIp?: string;
-    v6MainIp?: string;
-    internalIp?: string;
-    region: string;
-    plan: string;
-    os: string;
-    vcpuCount: number;
-    /** Vultr reports RAM in MB and disk in GB. */
-    ramMb: number;
-    diskGb: number;
-    tags: string[];
-    createdAt?: number;
-    /**
-     * Which login the instance was built with: `root`, or `limited` for the
-     * unprivileged `linuxuser` account Vultr creates instead. This is the one
-     * field that decides whether an adopted SSH target can actually connect.
-     */
-    userScheme: string;
-}
-export declare class VultrApiError extends Error {
-    readonly status: number;
-    readonly path: string;
-    constructor(message: string, status: number, path: string);
-}
-/**
- * Vultr's API root, overridable onto loopback so a parity gate can stand in for
- * the vendor. Loopback-only, and for the same reason as the other providers:
- * every request carries a bearer token, and an override free to name any host
- * would turn one environment variable into a way to post the user's credential
- * somewhere else.
- */
-export declare function vultrApiBase(): string;
-export declare class VultrManager {
-    private readonly token;
-    private readonly baseUrl;
-    /** The provider's scoped `fetch`; global `fetch` when built outside the registry. */
-    private readonly fetchImpl?;
-    constructor(token: string, baseUrl?: string, 
-    /** The provider's scoped `fetch`; global `fetch` when built outside the registry. */
-    fetchImpl?: ProviderFetch | undefined);
-    /**
-     * The account this API key belongs to.
-     *
-     * Vultr gives an account no id — the email is what identifies one — so that
-     * is what the neutral `ProviderAccount.id` carries.
-     */
-    account(): Promise<VultrAccount>;
-    /**
-     * Every instance on the account, following Vultr's cursor pagination.
-     *
-     * The whole list rather than a page: the caller is building an SSH server
-     * list, and a partial one would silently hide machines.
-     */
-    listInstances(opts?: {
-        label?: string;
-        tag?: string;
-        region?: string;
-    }): Promise<VultrInstance[]>;
-    getInstance(id: string): Promise<VultrInstance>;
-    private request;
-}
-export interface VultrRequestAuth {
-    token: string;
-    baseUrl?: string;
-    /**
-     * The provider's scoped `fetch` (see `providers/egress.ts`). Absent means
-     * global `fetch` — the case for a manager built directly in a test. Production
-     * clients come from `vultr-context.ts`, which always supplies one.
-     */
-    fetch?: ProviderFetch;
-}
-/**
- * The one place a Vultr API call is made. Shared with `vultr-actions.ts` so
- * auth and error shaping stay identical across the read and write halves — the
- * read/write boundary is which module exposes an operation, not which one can
- * reach the network.
- */
-export declare function vultrRequest<T>(auth: VultrRequestAuth, path: string, opts?: {
-    method?: string;
-    body?: unknown;
-}): Promise<T>;

package/dist/core/vultr-manager.js

@@ -1,170 +0,0 @@
-/**
- * Read-safe Vultr API v2 client — the observable half of the integration.
- *
- * Like `git-manager.ts` and `cloudflare-manager.ts`, this module deliberately
- * contains no operation that changes a machine. Start / halt / reboot live in
- * `vultr-actions.ts`, and destructive operations (delete, reinstall, restore)
- * are not implemented at all — the same line `GitManager` draws around
- * `reset --hard`.
- *
- * Every field and path below comes from Vultr's official Go SDK
- * (`github.com/vultr/govultr`), which is generated against the same API the
- * docs describe.
- */
-import { providerApiBase } from "./providers/api-base.js";
-export class VultrApiError extends Error {
-    status;
-    path;
-    constructor(message, status, path) {
-        super(message);
-        this.status = status;
-        this.path = path;
-        this.name = "VultrApiError";
-    }
-}
-/** Vultr caps `per_page` at 500; one page covers any realistic account. */
-const PER_PAGE = 500;
-/** A hard stop on cursor following, so a pathological account cannot hang a request. */
-const MAX_PAGES = 10;
-/**
- * Vultr's API root, overridable onto loopback so a parity gate can stand in for
- * the vendor. Loopback-only, and for the same reason as the other providers:
- * every request carries a bearer token, and an override free to name any host
- * would turn one environment variable into a way to post the user's credential
- * somewhere else.
- */
-export function vultrApiBase() {
-    return providerApiBase("NOMOREIDE_VULTR_API_BASE", "https://api.vultr.com/v2");
-}
-export class VultrManager {
-    token;
-    baseUrl;
-    fetchImpl;
-    constructor(token, baseUrl = vultrApiBase(), 
-    /** The provider's scoped `fetch`; global `fetch` when built outside the registry. */
-    fetchImpl) {
-        this.token = token;
-        this.baseUrl = baseUrl;
-        this.fetchImpl = fetchImpl;
-    }
-    /**
-     * The account this API key belongs to.
-     *
-     * Vultr gives an account no id — the email is what identifies one — so that
-     * is what the neutral `ProviderAccount.id` carries.
-     */
-    async account() {
-        const { account } = await this.request("/account");
-        return {
-            name: account.name ?? "",
-            email: account.email ?? "",
-            acls: account.acls ?? [],
-        };
-    }
-    /**
-     * Every instance on the account, following Vultr's cursor pagination.
-     *
-     * The whole list rather than a page: the caller is building an SSH server
-     * list, and a partial one would silently hide machines.
-     */
-    async listInstances(opts = {}) {
-        const instances = [];
-        let cursor;
-        for (let page = 0; page < MAX_PAGES; page += 1) {
-            const query = new URLSearchParams({ per_page: String(PER_PAGE) });
-            if (opts.label)
-                query.set("label", opts.label);
-            if (opts.tag)
-                query.set("tag", opts.tag);
-            if (opts.region)
-                query.set("region", opts.region);
-            if (cursor)
-                query.set("cursor", cursor);
-            const body = await this.request(`/instances?${query.toString()}`);
-            instances.push(...(body.instances ?? []).map(normalizeInstance));
-            cursor = body.meta?.links?.next || undefined;
-            if (!cursor)
-                break;
-        }
-        return instances;
-    }
-    async getInstance(id) {
-        const { instance } = await this.request(`/instances/${encodeURIComponent(id)}`);
-        return normalizeInstance(instance);
-    }
-    request(path, opts) {
-        return vultrRequest({ token: this.token, baseUrl: this.baseUrl, fetch: this.fetchImpl }, path, opts);
-    }
-}
-/**
- * The one place a Vultr API call is made. Shared with `vultr-actions.ts` so
- * auth and error shaping stay identical across the read and write halves — the
- * read/write boundary is which module exposes an operation, not which one can
- * reach the network.
- */
-export async function vultrRequest(auth, path, opts) {
-    const url = path.startsWith("http") ? path : `${auth.baseUrl ?? vultrApiBase()}${path}`;
-    const headers = {
-        Authorization: `Bearer ${auth.token}`,
-        Accept: "application/json",
-    };
-    const init = { method: opts?.method ?? "GET", headers };
-    if (opts?.body !== undefined) {
-        headers["Content-Type"] = "application/json";
-        init.body = JSON.stringify(opts.body);
-    }
-    const response = await (auth.fetch ?? fetch)(url, init);
-    // Power actions answer 204 with no body, so the body is only read when there
-    // is one to read.
-    const text = await response.text().catch(() => "");
-    if (!response.ok) {
-        const failure = safeParse(text);
-        throw new VultrApiError(failure?.error || `Vultr returned ${response.status} for ${path}`, response.status, path);
-    }
-    return (safeParse(text) ?? {});
-}
-function safeParse(text) {
-    if (!text.trim())
-        return undefined;
-    try {
-        return JSON.parse(text);
-    }
-    catch {
-        return undefined;
-    }
-}
-/**
- * Vultr writes "no address" as the empty string rather than omitting the field,
- * and `0.0.0.0` while an instance is still being built. Both mean the same
- * thing to a caller trying to reach the machine.
- */
-function address(value) {
-    const trimmed = value?.trim();
-    if (!trimmed || trimmed === "0.0.0.0" || trimmed === "::")
-        return undefined;
-    return trimmed;
-}
-function normalizeInstance(instance) {
-    const createdAt = Date.parse(instance.date_created ?? "");
-    return {
-        id: instance.id,
-        label: instance.label ?? "",
-        hostname: instance.hostname ?? "",
-        status: instance.status ?? "pending",
-        powerStatus: instance.power_status ?? "",
-        serverStatus: instance.server_status ?? "",
-        mainIp: address(instance.main_ip),
-        v6MainIp: address(instance.v6_main_ip),
-        internalIp: address(instance.internal_ip),
-        region: instance.region ?? "",
-        plan: instance.plan ?? "",
-        os: instance.os ?? "",
-        vcpuCount: instance.vcpu_count ?? 0,
-        ramMb: instance.ram ?? 0,
-        diskGb: instance.disk ?? 0,
-        tags: instance.tags ?? [],
-        createdAt: Number.isNaN(createdAt) ? undefined : createdAt,
-        userScheme: instance.user_scheme ?? "root",
-    };
-}
-//# sourceMappingURL=vultr-manager.js.map

package/dist/core/vultr-manager.js.map

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

package/dist/core/vultr-provider.d.ts

@@ -1,69 +0,0 @@
-import type { HostInstance, HostInstanceState, HostProvider, HostProviderActions, HostProviderManifest, HostSshTarget } from "./providers/host-provider.js";
-import { type VultrActions } from "./vultr-actions.js";
-import { type VultrInstance, type VultrManager } from "./vultr-manager.js";
-/**
- * Vultr as `HostProvider` implementation #1 — the provider that tests whether
- * the *second* contract was shaped by the problem or by the first one.
- *
- * A pure adapter, like `vercel-provider.ts` and `cloudflare-provider.ts`: every
- * method delegates to `VultrManager` or `VultrActions` and only reshapes the
- * result.
- *
- * What writing it surfaced:
- *
- * 1. **A host provider is not repo-scoped.** `DeployProvider` needs a working
- *    directory to answer anything, because a deployment belongs to the project
- *    a repository is linked to. An instance belongs to an account. So there is
- *    no project-resolution ladder here, no link file, no `repoUrl` hook — the
- *    whole of `providers/project-resolution.ts` is simply not part of this
- *    contract, which is why the split into two contracts was right.
- * 2. **`toSshTarget` needs the machine's login, not just its address.** Hence
- *    `HostInstance.defaultUser`: Vultr builds an instance with either `root` or
- *    an unprivileged `linuxuser`, and a target that omits it is one `ssh` tries
- *    as the *local* username, which fails for every Vultr instance.
- * 3. **The shared credential layer carried over untouched.** Vultr reuses
- *    `providers/credentials.ts` exactly, despite being neither a deploy
- *    platform nor an OAuth one — the first evidence that layer generalized
- *    beyond the contract it was extracted from.
- */
-export declare const VULTR_MANIFEST: HostProviderManifest;
-/**
- * Vultr's three-field state onto the five neutral ones.
- *
- * Vultr describes a machine with `status` (the subscription's lifecycle),
- * `power_status` (whether the VM is switched on) and `server_status` (how far
- * the OS install has got). Only their combination says whether the machine can
- * be reached: an `active` instance that is `running` is still unreachable while
- * `server_status` is `installingbooting`.
- *
- * `suspended` has no neutral equivalent — it is Vultr locking the machine, and
- * the user has to go and deal with it — so it maps to `error` and survives
- * verbatim in `rawState`, the same pressure valve `skipped` used on Cloudflare.
- */
-export declare function toInstanceState(instance: VultrInstance): HostInstanceState;
-/**
- * The word Vultr's own dashboard shows, so `rawState` reads as something the
- * user recognizes rather than as a field dump: the lifecycle status while the
- * instance is not yet `active`, then the install stage, then the power state.
- */
-export declare function toRawState(instance: VultrInstance): string;
-/**
- * Vultr's `user_scheme` onto the account name actually present on the machine.
- * `limited` provisions a sudo-capable `linuxuser` instead of enabling `root`.
- */
-export declare function toDefaultUser(instance: VultrInstance): string;
-export declare function toHostInstance(instance: VultrInstance): HostInstance;
-/**
- * The instance as an SSH host — the payoff this contract exists for.
- *
- * Exported and pure so the mapping is testable on its own, and shared by the
- * provider below.
- */
-export declare function toVultrSshTarget(instance: HostInstance): HostSshTarget | null;
-/** The read-safe half, over an already-authenticated `VultrManager`. */
-export declare function createVultrHostProvider(manager: VultrManager): HostProvider;
-/**
- * The write-capable half. Kept a separate factory, resolved separately, and
- * never handed to an MCP tool — the same boundary `VultrActions` has.
- */
-export declare function createVultrHostActions(actions: VultrActions): HostProviderActions;

package/dist/core/vultr-provider.js

@@ -1,226 +0,0 @@
-import { PRODUCTION_AFFECTING_ACTIONS, VULTR_ACTIONS, } from "./vultr-actions.js";
-import { VULTR_PROVIDER_ID } from "./vultr-auth.js";
-import { providerApiHost } from "./providers/api-base.js";
-import { vultrApiBase } from "./vultr-manager.js";
-/**
- * Vultr as `HostProvider` implementation #1 — the provider that tests whether
- * the *second* contract was shaped by the problem or by the first one.
- *
- * A pure adapter, like `vercel-provider.ts` and `cloudflare-provider.ts`: every
- * method delegates to `VultrManager` or `VultrActions` and only reshapes the
- * result.
- *
- * What writing it surfaced:
- *
- * 1. **A host provider is not repo-scoped.** `DeployProvider` needs a working
- *    directory to answer anything, because a deployment belongs to the project
- *    a repository is linked to. An instance belongs to an account. So there is
- *    no project-resolution ladder here, no link file, no `repoUrl` hook — the
- *    whole of `providers/project-resolution.ts` is simply not part of this
- *    contract, which is why the split into two contracts was right.
- * 2. **`toSshTarget` needs the machine's login, not just its address.** Hence
- *    `HostInstance.defaultUser`: Vultr builds an instance with either `root` or
- *    an unprivileged `linuxuser`, and a target that omits it is one `ssh` tries
- *    as the *local* username, which fails for every Vultr instance.
- * 3. **The shared credential layer carried over untouched.** Vultr reuses
- *    `providers/credentials.ts` exactly, despite being neither a deploy
- *    platform nor an OAuth one — the first evidence that layer generalized
- *    beyond the contract it was extracted from.
- */
-export const VULTR_MANIFEST = {
-    id: VULTR_PROVIDER_ID,
-    name: "Vultr",
-    kind: "host",
-    // Three action names that share not one word with either deploy provider,
-    // which is the clearest evidence for why these strings belong to the plugin:
-    // no host catalogue written for Vercel could ever have contained "halt".
-    // No `scope.label` — a host provider has no scopes.
-    strings: {
-        en: {
-            "action.start": "Start",
-            "action.start.done": "Instance starting.",
-            "action.halt": "Stop",
-            "action.halt.done": "Instance stopping.",
-            "action.halt.confirmTitle": "Stop this instance?",
-            "action.halt.confirm": "The machine powers off immediately. Anything running on it stops.",
-            "action.reboot": "Reboot",
-            "action.reboot.done": "Instance rebooting.",
-            "action.reboot.confirmTitle": "Reboot this instance?",
-            "action.reboot.confirm": "The machine restarts immediately. Anything running on it stops.",
-        },
-        zh: {
-            "action.start": "启动",
-            "action.start.done": "实例正在启动。",
-            "action.halt": "停止",
-            "action.halt.done": "实例正在停止。",
-            "action.halt.confirmTitle": "停止该实例？",
-            "action.halt.confirm": "机器将立即关机，其上运行的一切都会停止。",
-            "action.reboot": "重启",
-            "action.reboot.done": "实例正在重启。",
-            "action.reboot.confirmTitle": "重启该实例？",
-            "action.reboot.confirm": "机器将立即重启，其上运行的一切都会停止。",
-        },
-    },
-    actions: [...VULTR_ACTIONS],
-    productionAffecting: [...PRODUCTION_AFFECTING_ACTIONS],
-    // The API only. An adopted instance is reached over SSH by `ssh-servers.ts`,
-    // which is the host's own transport and never goes through this fetch — so no
-    // instance address belongs here.
-    api: { hosts: [providerApiHost(vultrApiBase())] },
-};
-/**
- * Vultr's three-field state onto the five neutral ones.
- *
- * Vultr describes a machine with `status` (the subscription's lifecycle),
- * `power_status` (whether the VM is switched on) and `server_status` (how far
- * the OS install has got). Only their combination says whether the machine can
- * be reached: an `active` instance that is `running` is still unreachable while
- * `server_status` is `installingbooting`.
- *
- * `suspended` has no neutral equivalent — it is Vultr locking the machine, and
- * the user has to go and deal with it — so it maps to `error` and survives
- * verbatim in `rawState`, the same pressure valve `skipped` used on Cloudflare.
- */
-export function toInstanceState(instance) {
-    switch (instance.status) {
-        case "pending":
-        case "resizing":
-            return "provisioning";
-        case "suspended":
-            return "error";
-        case "active":
-            break;
-        default:
-            return "unknown";
-    }
-    if (instance.serverStatus === "installingbooting")
-        return "provisioning";
-    if (instance.serverStatus === "locked")
-        return "provisioning";
-    if (instance.powerStatus === "running")
-        return "running";
-    if (instance.powerStatus === "stopped")
-        return "stopped";
-    return "unknown";
-}
-/**
- * The word Vultr's own dashboard shows, so `rawState` reads as something the
- * user recognizes rather than as a field dump: the lifecycle status while the
- * instance is not yet `active`, then the install stage, then the power state.
- */
-export function toRawState(instance) {
-    if (instance.status !== "active")
-        return instance.status;
-    if (instance.serverStatus === "installingbooting")
-        return "installing";
-    if (instance.serverStatus === "locked")
-        return "locked";
-    return instance.powerStatus || "unknown";
-}
-/**
- * Vultr's `user_scheme` onto the account name actually present on the machine.
- * `limited` provisions a sudo-capable `linuxuser` instead of enabling `root`.
- */
-export function toDefaultUser(instance) {
-    return instance.userScheme === "limited" ? "linuxuser" : "root";
-}
-export function toHostInstance(instance) {
-    return {
-        id: instance.id,
-        // A Vultr instance may be created with no label at all, in which case its
-        // hostname is the only human-readable thing about it.
-        label: instance.label || instance.hostname || instance.id,
-        state: toInstanceState(instance),
-        rawState: toRawState(instance),
-        ipv4: instance.mainIp,
-        ipv6: instance.v6MainIp,
-        hostname: instance.hostname || undefined,
-        region: instance.region || undefined,
-        plan: instance.plan || undefined,
-        os: instance.os || undefined,
-        specs: {
-            vcpus: instance.vcpuCount || undefined,
-            memoryMb: instance.ramMb || undefined,
-            diskGb: instance.diskGb || undefined,
-        },
-        tags: instance.tags,
-        createdAt: instance.createdAt,
-        defaultUser: toDefaultUser(instance),
-    };
-}
-/**
- * The instance as an SSH host — the payoff this contract exists for.
- *
- * Exported and pure so the mapping is testable on its own, and shared by the
- * provider below.
- */
-export function toVultrSshTarget(instance) {
-    // IPv4 first: a v6-only target only works from a v6-capable client, and an
-    // instance without either address is still being built.
-    const address = instance.ipv4 ?? instance.ipv6;
-    if (!address)
-        return null;
-    return {
-        host: instance.defaultUser ? `${instance.defaultUser}@${address}` : address,
-        name: instance.label,
-        // `environment` is deliberately left unset. Vultr tags are free-form and
-        // mean whatever the account owner decided, so inferring "Production" from
-        // one would eventually put that label on the wrong machine. A user-saved
-        // value wins in the merge anyway, so this is a blank the user can fill.
-        instance: {
-            providerId: VULTR_PROVIDER_ID,
-            providerName: VULTR_MANIFEST.name,
-            instanceId: instance.id,
-            state: instance.state,
-            rawState: instance.rawState,
-            region: instance.region,
-        },
-    };
-}
-/** The read-safe half, over an already-authenticated `VultrManager`. */
-export function createVultrHostProvider(manager) {
-    return {
-        async account() {
-            const account = await manager.account();
-            return {
-                // Vultr gives an account no id of its own; the email is what identifies
-                // one, and is what its dashboard shows.
-                id: account.email,
-                username: account.email,
-                name: account.name || null,
-                email: account.email || null,
-            };
-        },
-        async listInstances() {
-            return (await manager.listInstances()).map(toHostInstance);
-        },
-        async getInstance(id) {
-            return toHostInstance(await manager.getInstance(id));
-        },
-        toSshTarget: toVultrSshTarget,
-    };
-}
-/**
- * The write-capable half. Kept a separate factory, resolved separately, and
- * never handed to an MCP tool — the same boundary `VultrActions` has.
- */
-export function createVultrHostActions(actions) {
-    return {
-        async run(action, instanceId) {
-            switch (action) {
-                case "start":
-                    await actions.start(instanceId);
-                    return;
-                case "halt":
-                    await actions.halt(instanceId);
-                    return;
-                case "reboot":
-                    await actions.reboot(instanceId);
-                    return;
-                default:
-                    throw new Error(`Vultr does not support the action "${action}".`);
-            }
-        },
-    };
-}
-//# sourceMappingURL=vultr-provider.js.map

package/dist/core/vultr-provider.js.map

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