@douglas-agent/sandbank-boxlite 0.6.1

package/dist/types.d.ts

@@ -0,0 +1,138 @@
+/** Remote mode: connect to a BoxRun REST API */
+export interface BoxLiteRemoteConfig {
+    mode?: 'remote';
+    /** BoxRun REST API base URL, e.g. 'http://localhost:8090' */
+    apiUrl: string;
+    /** Multi-tenant prefix (e.g. 'default') */
+    prefix?: string;
+    /** Bearer token (if already obtained) */
+    apiToken?: string;
+    /** OAuth2 client ID (for automatic token acquisition) */
+    clientId?: string;
+    /** OAuth2 client secret (for automatic token acquisition) */
+    clientSecret?: string;
+}
+/** Local mode: use boxlite Python SDK directly on this machine */
+export interface BoxLiteLocalConfig {
+    mode: 'local';
+    /** Path to Python 3.10+ interpreter (default: 'python3') */
+    pythonPath?: string;
+    /** BoxLite home directory (default: '~/.boxlite') */
+    boxliteHome?: string;
+}
+/** BoxLite adapter configuration — remote (BoxRun REST API) or local (Python SDK) */
+export type BoxLiteAdapterConfig = BoxLiteRemoteConfig | BoxLiteLocalConfig;
+export interface BoxLiteClient {
+    createBox(params: BoxLiteCreateParams): Promise<BoxLiteBox>;
+    getBox(boxId: string): Promise<BoxLiteBox>;
+    listBoxes(status?: string, pageSize?: number): Promise<BoxLiteBox[]>;
+    deleteBox(boxId: string, force?: boolean): Promise<void>;
+    startBox(boxId: string): Promise<void>;
+    stopBox(boxId: string): Promise<void>;
+    exec(boxId: string, req: BoxLiteExecRequest): Promise<{
+        stdout: string;
+        stderr: string;
+        exitCode: number;
+    }>;
+    execStream(boxId: string, req: BoxLiteExecRequest): Promise<ReadableStream<Uint8Array>>;
+    uploadFiles(boxId: string, path: string, tarData: Uint8Array): Promise<void>;
+    downloadFiles(boxId: string, path: string): Promise<ReadableStream<Uint8Array>>;
+    createSnapshot(boxId: string, name: string): Promise<BoxLiteSnapshot>;
+    restoreSnapshot(boxId: string, name: string): Promise<void>;
+    listSnapshots(boxId: string): Promise<BoxLiteSnapshot[]>;
+    deleteSnapshot(boxId: string, name: string): Promise<void>;
+    cloneBox(boxId: string, name?: string): Promise<BoxLiteBox>;
+    exportBox?(boxId: string): Promise<ReadableStream<Uint8Array>>;
+    importBox?(data: Uint8Array): Promise<BoxLiteBox>;
+    execAsync?(boxId: string, req: BoxLiteExecRequest): Promise<BoxLiteExecution>;
+    getExecOutput?(boxId: string, execId: string): Promise<ReadableStream<Uint8Array>>;
+    sendExecInput?(boxId: string, execId: string, data: string): Promise<void>;
+    signalExec?(boxId: string, execId: string, signal: number): Promise<void>;
+    resizeExec?(boxId: string, execId: string, cols: number, rows: number): Promise<void>;
+    getMetrics?(): Promise<Record<string, unknown>>;
+    getBoxMetrics?(boxId: string): Promise<Record<string, unknown>>;
+    getConfig?(): Promise<Record<string, unknown>>;
+    /** Dispose of the client (cleanup subprocess, etc.) */
+    dispose?(): Promise<void>;
+}
+export interface BoxLiteBox {
+    id: string;
+    boxlite_id?: string;
+    name: string | null;
+    status: BoxStatus;
+    created_at: string;
+    started_at?: string | null;
+    stopped_at?: string | null;
+    image: string;
+    cpu: number;
+    memory_mb: number;
+    disk_size_gb?: number;
+    workdir?: string;
+    env?: Record<string, string> | null;
+    network?: boolean | BoxLiteNetworkConfig;
+    error_code?: string | null;
+    error_message?: string | null;
+    volumes?: unknown;
+}
+export type BoxStatus = 'configured' | 'running' | 'stopping' | 'stopped' | 'paused' | 'unknown';
+export interface BoxLiteExecRequest {
+    cmd: string[];
+    env?: Record<string, string>;
+    timeout_seconds?: number;
+    working_dir?: string;
+    tty?: boolean;
+}
+export interface BoxLiteExecution {
+    id: string;
+    box_id?: string;
+    cmd?: string[];
+    status: string;
+    exit_code: number | null;
+    stdout?: string;
+    stderr?: string;
+}
+export interface BoxLiteSnapshot {
+    id: string;
+    box_id: string;
+    name: string;
+    created_at: number;
+    size_bytes: number;
+    guest_disk_bytes?: number;
+    container_disk_bytes?: number;
+}
+export interface BoxLiteNetworkConfig {
+    mode: 'enabled' | 'disabled';
+    allow_net?: string[];
+}
+export interface BoxLiteSecretSpec {
+    name: string;
+    value: string;
+    target?: string;
+}
+export interface BoxLiteCreateParams {
+    image?: string;
+    /** Path to a local OCI layout directory. When set, overrides `image` (no registry pull). */
+    rootfs_path?: string;
+    name?: string;
+    cpu?: number;
+    memory_mb?: number;
+    disk_size_gb?: number;
+    working_dir?: string;
+    env?: Record<string, string>;
+    auto_remove?: boolean;
+    security?: string;
+    /** Port mappings [hostPort, guestPort][] for local mode */
+    ports?: [number, number][];
+    network?: BoxLiteNetworkConfig;
+    secrets?: BoxLiteSecretSpec[];
+    entrypoint?: string;
+    cmd?: string[];
+    user?: string;
+    labels?: Record<string, string>;
+}
+export interface BoxLiteTokenResponse {
+    access_token: string;
+    token_type: string;
+    expires_in: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,2 @@
+// --- Adapter configuration (discriminated union) ---
+export {};

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@douglas-agent/sandbank-boxlite",
+  "version": "0.6.1",
+  "description": "BoxLite bare-metal sandbox adapter for Sandbank",
+  "license": "MIT",
+  "type": "module",
+  "homepage": "https://sandbank.dev",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Xeonice/sandbank-douglas-agent.git",
+    "directory": "packages/boxlite"
+  },
+  "keywords": [
+    "sandbox",
+    "ai-agent",
+    "boxlite",
+    "bare-metal",
+    "kvm"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {
+    "@douglas-agent/sandbank-core": "^0.3.6"
+  },
+  "devDependencies": {
+    "@types/node": "^25.3.0",
+    "typescript": "^5.7.3"
+  }
+}