microsandbox-mcp 0.5.7 → 0.5.10

package/dist/utils/response.js

@@ -0,0 +1,38 @@
+import { redact } from "./redaction.js";
+export function ok(data, options = {}) {
+    const body = {
+        ok: true,
+        data,
+        ...(options.warnings && options.warnings.length > 0 ? { warnings: options.warnings } : {}),
+        ...(options.truncated && options.truncated.length > 0 ? { truncated: options.truncated } : {}),
+    };
+    return jsonResult(body);
+}
+export function fail(code, message, options = {}) {
+    const body = {
+        ok: false,
+        error: {
+            code,
+            message,
+            ...(options.details !== undefined ? { details: redact(options.details) } : {}),
+            ...(options.retryable !== undefined ? { retryable: options.retryable } : {}),
+        },
+    };
+    return {
+        ...jsonResult(body),
+        isError: true,
+    };
+}
+export function errorResult(error, code = "operation_failed") {
+    const message = error instanceof Error ? error.message : String(error);
+    return fail(code, message);
+}
+function jsonResult(body) {
+    return {
+        content: [{
+                type: "text",
+                text: JSON.stringify(body, null, 2),
+            }],
+    };
+}
+//# sourceMappingURL=response.js.map

package/dist/utils/response.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"response.js","sourceRoot":"","sources":["../../src/utils/response.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AA2BxC,MAAM,UAAU,EAAE,CAChB,IAAO,EACP,UAA6D,EAAE;IAE/D,MAAM,IAAI,GAAc;QACtB,EAAE,EAAE,IAAI;QACR,IAAI;QACJ,GAAG,CAAC,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1F,GAAG,CAAC,OAAO,CAAC,SAAS,IAAI,OAAO,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC/F,CAAC;IAEF,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,IAAI,CAClB,IAAY,EACZ,OAAe,EACf,UAAsD,EAAE;IAExD,MAAM,IAAI,GAAc;QACtB,EAAE,EAAE,KAAK;QACT,KAAK,EAAE;YACL,IAAI;YACJ,OAAO;YACP,GAAG,CAAC,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC9E,GAAG,CAAC,OAAO,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC7E;KACF,CAAC;IAEF,OAAO;QACL,GAAG,UAAU,CAAC,IAAI,CAAC;QACnB,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAc,EAAE,IAAI,GAAG,kBAAkB;IACnE,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,OAAO,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAC7B,CAAC;AAED,SAAS,UAAU,CAAC,IAAiC;IACnD,OAAO;QACL,OAAO,EAAE,CAAC;gBACR,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;aACpC,CAAC;KACH,CAAC;AACJ,CAAC"}

package/dist/utils/serialization.d.ts

@@ -0,0 +1,15 @@
+import type { FsEntry, FsMetadata, ImageDetail, ImageHandle, LogEntry, SandboxHandle, SandboxMetrics, Snapshot, SnapshotHandle, VolumeHandle } from "microsandbox";
+export declare function sandboxHandleData(handle: SandboxHandle): Record<string, unknown>;
+export declare function sandboxSummaryData(handle: SandboxHandle): Record<string, unknown>;
+export declare function metricsData(metrics: SandboxMetrics): Record<string, unknown>;
+export declare function fsEntryData(entry: FsEntry): Record<string, unknown>;
+export declare function fsMetadataData(meta: FsMetadata): Record<string, unknown>;
+export declare function logEntryData(entry: LogEntry): Record<string, unknown>;
+export declare function imageHandleData(handle: ImageHandle): Record<string, unknown>;
+export declare function imageDetailData(detail: ImageDetail): Record<string, unknown>;
+export declare function volumeHandleData(handle: VolumeHandle): Record<string, unknown>;
+export declare function snapshotHandleData(handle: SnapshotHandle): Record<string, unknown>;
+export declare function snapshotData(snapshot: Snapshot): Record<string, unknown>;
+export declare function toIso(value: Date | number | string | null | undefined): string | null;
+export declare function parseDate(value: string | undefined): Date | undefined;
+export declare function parseJson(value: string): unknown;

package/dist/utils/serialization.js

@@ -0,0 +1,164 @@
+export function sandboxHandleData(handle) {
+    return {
+        name: handle.name,
+        status: handle.status,
+        config: parseJson(handle.configJson),
+        createdAt: toIso(handle.createdAt),
+        updatedAt: toIso(handle.updatedAt),
+    };
+}
+export function sandboxSummaryData(handle) {
+    const config = parseJson(handle.configJson);
+    return {
+        name: handle.name,
+        status: handle.status,
+        image: imageFromConfig(config),
+        labels: labelsFromConfig(config),
+        createdAt: toIso(handle.createdAt),
+        updatedAt: toIso(handle.updatedAt),
+    };
+}
+export function metricsData(metrics) {
+    return {
+        timestamp: toIso(metrics.timestamp),
+        cpuPercent: metrics.cpuPercent,
+        vcpuTimeNs: metrics.vcpuTimeNs,
+        memoryBytes: metrics.memoryBytes,
+        memoryAvailableBytes: metrics.memoryAvailableBytes,
+        memoryHostResidentBytes: metrics.memoryHostResidentBytes,
+        memoryLimitBytes: metrics.memoryLimitBytes,
+        diskReadBytes: metrics.diskReadBytes,
+        diskWriteBytes: metrics.diskWriteBytes,
+        netRxBytes: metrics.netRxBytes,
+        netTxBytes: metrics.netTxBytes,
+        uptimeMs: metrics.uptimeMs,
+        uptimeSecs: Math.round(metrics.uptimeMs / 1000),
+    };
+}
+export function fsEntryData(entry) {
+    return {
+        path: entry.path,
+        kind: entry.kind,
+        size: entry.size,
+        mode: entry.mode,
+        modified: toIso(entry.modified),
+    };
+}
+export function fsMetadataData(meta) {
+    return {
+        kind: meta.kind,
+        size: meta.size,
+        mode: meta.mode,
+        readonly: meta.readonly,
+        modified: toIso(meta.modified),
+        created: toIso(meta.created),
+    };
+}
+export function logEntryData(entry) {
+    return {
+        timestamp: toIso(entry.timestamp),
+        source: entry.source,
+        sessionId: entry.sessionId,
+        text: entry.text(),
+        cursor: entry.cursor,
+    };
+}
+export function imageHandleData(handle) {
+    return {
+        reference: handle.reference,
+        sizeBytes: handle.sizeBytes,
+        manifestDigest: handle.manifestDigest,
+        architecture: handle.architecture,
+        os: handle.os,
+        layerCount: handle.layerCount,
+        lastUsedAt: toIso(handle.lastUsedAt),
+        createdAt: toIso(handle.createdAt),
+    };
+}
+export function imageDetailData(detail) {
+    return {
+        handle: imageHandleData(detail.handle),
+        config: detail.config,
+        layers: detail.layers,
+    };
+}
+export function volumeHandleData(handle) {
+    return {
+        name: handle.name,
+        kind: handle.kind,
+        quotaMib: handle.quotaMib,
+        usedBytes: handle.usedBytes,
+        capacityBytes: handle.capacityBytes,
+        diskFormat: handle.diskFormat,
+        diskFstype: handle.diskFstype,
+        labels: Object.fromEntries(handle.labels),
+        createdAt: toIso(handle.createdAt),
+    };
+}
+export function snapshotHandleData(handle) {
+    return {
+        digest: handle.digest,
+        name: handle.name,
+        parentDigest: handle.parentDigest,
+        imageRef: handle.imageRef,
+        format: handle.format,
+        sizeBytes: bigintToString(handle.sizeBytes),
+        createdAt: toIso(handle.createdAt),
+        path: handle.path,
+    };
+}
+export function snapshotData(snapshot) {
+    return {
+        path: snapshot.path,
+        digest: snapshot.digest,
+        sizeBytes: snapshot.sizeBytes.toString(),
+        imageRef: snapshot.imageRef,
+        imageManifestDigest: snapshot.imageManifestDigest,
+        format: snapshot.format,
+        fstype: snapshot.fstype,
+        parent: snapshot.parent,
+        createdAt: snapshot.createdAt,
+        labels: Object.fromEntries(snapshot.labels),
+        sourceSandbox: snapshot.sourceSandbox,
+    };
+}
+export function toIso(value) {
+    if (value == null)
+        return null;
+    if (value instanceof Date)
+        return value.toISOString();
+    if (typeof value === "number")
+        return new Date(value).toISOString();
+    return value;
+}
+export function parseDate(value) {
+    if (!value)
+        return undefined;
+    const date = new Date(value);
+    if (Number.isNaN(date.getTime())) {
+        throw new Error(`invalid date: ${value}`);
+    }
+    return date;
+}
+export function parseJson(value) {
+    try {
+        return JSON.parse(value);
+    }
+    catch {
+        return null;
+    }
+}
+function bigintToString(value) {
+    return value == null ? null : value.toString();
+}
+function imageFromConfig(config) {
+    if (!config || typeof config.image !== "object" || config.image === null)
+        return null;
+    return config.image;
+}
+function labelsFromConfig(config) {
+    if (!config || typeof config.labels !== "object" || config.labels === null)
+        return {};
+    return config.labels;
+}
+//# sourceMappingURL=serialization.js.map

package/dist/utils/serialization.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "microsandbox-mcp",
-  "version": "0.5.7",
+  "version": "0.5.10",
   "description": "MCP server for microsandbox — manage microVM sandboxes from any AI agent",
   "type": "module",
   "bin": {
@@ -14,11 +14,13 @@
   "scripts": {
     "build": "tsc",
     "dev": "tsc --watch",
-    "start": "node dist/index.js"
+    "start": "node dist/index.js",
+    "test": "npm run build && node --test tests/*.test.mjs",
+    "test:e2e": "npm run build && node tests/e2e-all-tools.mjs"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
-    "microsandbox": "^0.5.7",
+    "microsandbox": "^0.5.10",
     "zod": "^4.3.6"
   },
   "devDependencies": {