oblien 1.2.7 → 2.0.0

package/dist/runtime/terminal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal.d.ts","sourceRoot":"","sources":["../../src/runtime/terminal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,KAAK,EACV,oBAAoB,EACpB,eAAe,EAEf,0BAA0B,EAC3B,MAAM,qBAAqB,CAAC;AAE7B;;;;;;;;GAQG;AACH,qBAAa,gBAAgB;IACf,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE,iBAAiB;IAErD,qCAAqC;IAC/B,MAAM,CAAC,MAAM,GAAE,oBAAyB,GAAG,OAAO,CAAC,eAAe,CAAC;IAezE,qCAAqC;IAC/B,IAAI,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;IAQxC,gCAAgC;IAC1B,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IAOlF,2CAA2C;IACrC,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,0BAA0B,CAAC;CAOtG"}

package/dist/runtime/terminal.js

@@ -0,0 +1,58 @@
+/**
+ * Terminal sessions inside the workspace runtime.
+ *
+ * ```ts
+ * const term = await rt.terminal.create({ shell: '/bin/bash', cols: 120, rows: 40 });
+ * const sessions = await rt.terminal.list();
+ * await rt.terminal.close(term.id);
+ * ```
+ */
+export class TerminalResource {
+    _http;
+    constructor(_http) {
+        this._http = _http;
+    }
+    /** Create a new terminal session. */
+    async create(params = {}) {
+        const body = {};
+        if (params.shell)
+            body.cmd = [params.shell];
+        if (params.cmd)
+            body.cmd = params.cmd;
+        if (params.cols)
+            body.cols = params.cols;
+        if (params.rows)
+            body.rows = params.rows;
+        if (params.scrollbackSize)
+            body.scrollback_size = params.scrollbackSize;
+        return this._http.request({
+            method: 'POST',
+            path: '/terminals',
+            body,
+        });
+    }
+    /** List active terminal sessions. */
+    async list() {
+        const res = await this._http.request({
+            method: 'GET',
+            path: '/terminals',
+        });
+        return res.terminals;
+    }
+    /** Close a terminal session. */
+    async close(sessionId) {
+        return this._http.request({
+            method: 'DELETE',
+            path: `/terminals/${sessionId}`,
+        });
+    }
+    /** Get scrollback buffer for a session. */
+    async scrollback(sessionId, params) {
+        return this._http.request({
+            method: 'GET',
+            path: `/terminals/${sessionId}/scrollback`,
+            query: params?.bytes ? { bytes: params.bytes } : undefined,
+        });
+    }
+}
+//# sourceMappingURL=terminal.js.map

package/dist/runtime/terminal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal.js","sourceRoot":"","sources":["../../src/runtime/terminal.ts"],"names":[],"mappings":"AAQA;;;;;;;;GAQG;AACH,MAAM,OAAO,gBAAgB;IACE;IAA7B,YAA6B,KAAwB;QAAxB,UAAK,GAAL,KAAK,CAAmB;IAAG,CAAC;IAEzD,qCAAqC;IACrC,KAAK,CAAC,MAAM,CAAC,SAA+B,EAAE;QAC5C,MAAM,IAAI,GAA4B,EAAE,CAAC;QACzC,IAAI,MAAM,CAAC,KAAK;YAAE,IAAI,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5C,IAAI,MAAM,CAAC,GAAG;YAAE,IAAI,CAAC,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC;QACtC,IAAI,MAAM,CAAC,IAAI;YAAE,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;QACzC,IAAI,MAAM,CAAC,IAAI;YAAE,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;QACzC,IAAI,MAAM,CAAC,cAAc;YAAE,IAAI,CAAC,eAAe,GAAG,MAAM,CAAC,cAAc,CAAC;QAExE,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAkB;YACzC,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,YAAY;YAClB,IAAI;SACL,CAAC,CAAC;IACL,CAAC;IAED,qCAAqC;IACrC,KAAK,CAAC,IAAI;QACR,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAuB;YACzD,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,YAAY;SACnB,CAAC,CAAC;QACH,OAAO,GAAG,CAAC,SAAS,CAAC;IACvB,CAAC;IAED,gCAAgC;IAChC,KAAK,CAAC,KAAK,CAAC,SAAiB;QAC3B,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;YACxB,MAAM,EAAE,QAAQ;YAChB,IAAI,EAAE,cAAc,SAAS,EAAE;SAChC,CAAC,CAAC;IACL,CAAC;IAED,2CAA2C;IAC3C,KAAK,CAAC,UAAU,CAAC,SAAiB,EAAE,MAA2B;QAC7D,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAA6B;YACpD,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,cAAc,SAAS,aAAa;YAC1C,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS;SAC3D,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/runtime/watcher.d.ts

@@ -0,0 +1,27 @@
+import type { RuntimeHttpClient } from '../runtime-http.js';
+import type { WatcherCreateParams, WatcherInfo } from '../types/runtime.js';
+/**
+ * File watcher management inside the workspace runtime.
+ *
+ * ```ts
+ * const watcher = await rt.watcher.create({ path: '/app/src' });
+ * const all = await rt.watcher.list();
+ * await rt.watcher.delete(watcher.id);
+ * ```
+ */
+export declare class WatcherResource {
+    private readonly _http;
+    constructor(_http: RuntimeHttpClient);
+    /** Create a file watcher on a directory. */
+    create(params: WatcherCreateParams): Promise<WatcherInfo>;
+    /** List active watchers. */
+    list(): Promise<WatcherInfo[]>;
+    /** Get watcher info by ID. */
+    get(watcherId: string): Promise<WatcherInfo>;
+    /** Delete a watcher. */
+    delete(watcherId: string): Promise<{
+        success: boolean;
+        watcher_id: string;
+    }>;
+}
+//# sourceMappingURL=watcher.d.ts.map

package/dist/runtime/watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watcher.d.ts","sourceRoot":"","sources":["../../src/runtime/watcher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,KAAK,EACV,mBAAmB,EACnB,WAAW,EAEZ,MAAM,qBAAqB,CAAC;AAE7B;;;;;;;;GAQG;AACH,qBAAa,eAAe;IACd,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE,iBAAiB;IAErD,4CAA4C;IACtC,MAAM,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,WAAW,CAAC;IAc/D,4BAA4B;IACtB,IAAI,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAQpC,8BAA8B;IACxB,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAQlD,wBAAwB;IAClB,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;CAMnF"}

package/dist/runtime/watcher.js

@@ -0,0 +1,53 @@
+/**
+ * File watcher management inside the workspace runtime.
+ *
+ * ```ts
+ * const watcher = await rt.watcher.create({ path: '/app/src' });
+ * const all = await rt.watcher.list();
+ * await rt.watcher.delete(watcher.id);
+ * ```
+ */
+export class WatcherResource {
+    _http;
+    constructor(_http) {
+        this._http = _http;
+    }
+    /** Create a file watcher on a directory. */
+    async create(params) {
+        const res = await this._http.request({
+            method: 'POST',
+            path: '/watchers',
+            body: {
+                path: params.path,
+                root: params.root,
+                excludes: params.excludes,
+                exclude: params.exclude,
+            },
+        });
+        return res.watcher;
+    }
+    /** List active watchers. */
+    async list() {
+        const res = await this._http.request({
+            method: 'GET',
+            path: '/watchers',
+        });
+        return res.watchers;
+    }
+    /** Get watcher info by ID. */
+    async get(watcherId) {
+        const res = await this._http.request({
+            method: 'GET',
+            path: `/watchers/${watcherId}`,
+        });
+        return res.watcher;
+    }
+    /** Delete a watcher. */
+    async delete(watcherId) {
+        return this._http.request({
+            method: 'DELETE',
+            path: `/watchers/${watcherId}`,
+        });
+    }
+}
+//# sourceMappingURL=watcher.js.map

package/dist/runtime/watcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watcher.js","sourceRoot":"","sources":["../../src/runtime/watcher.ts"],"names":[],"mappings":"AAOA;;;;;;;;GAQG;AACH,MAAM,OAAO,eAAe;IACG;IAA7B,YAA6B,KAAwB;QAAxB,UAAK,GAAL,KAAK,CAAmB;IAAG,CAAC;IAEzD,4CAA4C;IAC5C,KAAK,CAAC,MAAM,CAAC,MAA2B;QACtC,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAA6C;YAC/E,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,WAAW;YACjB,IAAI,EAAE;gBACJ,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,OAAO,EAAE,MAAM,CAAC,OAAO;aACxB;SACF,CAAC,CAAC;QACH,OAAO,GAAG,CAAC,OAAO,CAAC;IACrB,CAAC;IAED,4BAA4B;IAC5B,KAAK,CAAC,IAAI;QACR,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAsB;YACxD,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,WAAW;SAClB,CAAC,CAAC;QACH,OAAO,GAAG,CAAC,QAAQ,CAAC;IACtB,CAAC;IAED,8BAA8B;IAC9B,KAAK,CAAC,GAAG,CAAC,SAAiB;QACzB,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAA6C;YAC/E,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,aAAa,SAAS,EAAE;SAC/B,CAAC,CAAC;QACH,OAAO,GAAG,CAAC,OAAO,CAAC;IACrB,CAAC;IAED,wBAAwB;IACxB,KAAK,CAAC,MAAM,CAAC,SAAiB;QAC5B,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;YACxB,MAAM,EAAE,QAAQ;YAChB,IAAI,EAAE,aAAa,SAAS,EAAE;SAC/B,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/runtime/ws.d.ts

@@ -0,0 +1,92 @@
+import type { RuntimeOptions, WSOptions, WSMessage, WSWatcherEvent } from '../types/runtime.js';
+/**
+ * Multiplexed WebSocket connection for real-time terminal I/O and
+ * file watcher events.
+ *
+ * Protocol (matches the guest server at /ws):
+ *
+ * **Binary frames** (terminal I/O):
+ * - `[terminal_id_byte][raw data]` — both directions.
+ * - Client → Server: stdin to terminal.
+ * - Server → Client: stdout from terminal.
+ *
+ * **Text frames** (JSON with "channel" field):
+ * - terminal: resize (client→server), exit (server→client)
+ * - watcher: change, ready, overflow (server→client)
+ *
+ * Only one WS connection is active per VM — a new connection replaces the old one.
+ *
+ * ```ts
+ * const ws = rt.ws();
+ * ws.onTerminalOutput((id, data) => process.stdout.write(data));
+ * ws.onWatcherEvent((ev) => console.log(ev.path, ev.op));
+ * ws.connect();
+ * ```
+ */
+export declare class RuntimeWebSocket {
+    private _ws;
+    private readonly _baseUrl;
+    private readonly _token;
+    private readonly _reconnect;
+    private readonly _reconnectDelay;
+    private readonly _maxReconnectAttempts;
+    private _reconnectAttempts;
+    private _intentionallyClosed;
+    private _reconnectTimer;
+    /** Terminal stdout data: (terminalId, rawData). */
+    private _onTerminalOutput;
+    /** Terminal exit event: (terminalId, exitCode). */
+    private _onTerminalExit;
+    /** Watcher events (change, ready, overflow). */
+    private _onWatcherEvent;
+    /** Connection opened. */
+    private _onOpen;
+    /** Connection closed. */
+    private _onClose;
+    /** Connection error. */
+    private _onError;
+    /** Any text message (raw). */
+    private _onMessage;
+    constructor(runtimeOptions: RuntimeOptions, wsOptions?: WSOptions);
+    /**
+     * Register a handler for terminal output (binary frames).
+     * `id` is the terminal session ID (string), `data` is the raw output.
+     */
+    onTerminalOutput(handler: (id: string, data: Uint8Array) => void): this;
+    /** Register a handler for terminal exit events. */
+    onTerminalExit(handler: (id: string, code: number) => void): this;
+    /** Register a handler for file watcher events (change, ready, overflow). */
+    onWatcherEvent(handler: (event: WSWatcherEvent) => void): this;
+    /** Register a handler called when the WebSocket connects. */
+    onOpen(handler: () => void): this;
+    /** Register a handler called when the WebSocket closes. */
+    onClose(handler: (code: number, reason: string) => void): this;
+    /** Register a handler for errors. */
+    onError(handler: (error: unknown) => void): this;
+    /** Register a handler for all incoming text messages (raw parsed JSON). */
+    onMessage(handler: (msg: WSMessage) => void): this;
+    /**
+     * Write stdin data to a terminal session.
+     * Binary frame format: `[terminal_id_byte][data]`.
+     *
+     * `terminalId` is the numeric session ID (same as `parseInt(session.id)`).
+     * Accepts either a `string` (e.g. `"1"`) or `number`.
+     */
+    writeTerminalInput(terminalId: string | number, data: string | Uint8Array): void;
+    /** Send a terminal resize command. */
+    resizeTerminal(terminalId: string, cols: number, rows: number): void;
+    /** Send a raw JSON text message. */
+    sendJSON(msg: Record<string, unknown>): void;
+    /** Open the WebSocket connection. */
+    connect(): void;
+    /** Close the WebSocket connection (no reconnect). */
+    close(): void;
+    /** Whether the socket is currently open. */
+    get connected(): boolean;
+    private _doConnect;
+    private _handleBinary;
+    private _handleText;
+    private _handleTerminalMessage;
+    private _scheduleReconnect;
+}
+//# sourceMappingURL=ws.d.ts.map

package/dist/runtime/ws.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws.d.ts","sourceRoot":"","sources":["../../src/runtime/ws.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,SAAS,EACT,SAAS,EAGT,cAAc,EACf,MAAM,qBAAqB,CAAC;AAE7B;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,GAAG,CAA0B;IACrC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAU;IACrC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAS;IAC/C,OAAO,CAAC,kBAAkB,CAAK;IAC/B,OAAO,CAAC,oBAAoB,CAAS;IACrC,OAAO,CAAC,eAAe,CAA8C;IAIrE,mDAAmD;IACnD,OAAO,CAAC,iBAAiB,CAAyD;IAClF,mDAAmD;IACnD,OAAO,CAAC,eAAe,CAAqD;IAC5E,gDAAgD;IAChD,OAAO,CAAC,eAAe,CAAkD;IACzE,yBAAyB;IACzB,OAAO,CAAC,OAAO,CAA6B;IAC5C,yBAAyB;IACzB,OAAO,CAAC,QAAQ,CAAyD;IACzE,wBAAwB;IACxB,OAAO,CAAC,QAAQ,CAA2C;IAC3D,8BAA8B;IAC9B,OAAO,CAAC,UAAU,CAA2C;gBAEjD,cAAc,EAAE,cAAc,EAAE,SAAS,CAAC,EAAE,SAAS;IAWjE;;;OAGG;IACH,gBAAgB,CAAC,OAAO,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,KAAK,IAAI,GAAG,IAAI;IAKvE,mDAAmD;IACnD,cAAc,CAAC,OAAO,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAKjE,4EAA4E;IAC5E,cAAc,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,GAAG,IAAI;IAK9D,6DAA6D;IAC7D,MAAM,CAAC,OAAO,EAAE,MAAM,IAAI,GAAG,IAAI;IAKjC,2DAA2D;IAC3D,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAK9D,qCAAqC;IACrC,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI;IAKhD,2EAA2E;IAC3E,SAAS,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,SAAS,KAAK,IAAI,GAAG,IAAI;IAOlD;;;;;;OAMG;IACH,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAWhF,sCAAsC;IACtC,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAUpE,oCAAoC;IACpC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAO5C,qCAAqC;IACrC,OAAO,IAAI,IAAI;IAMf,qDAAqD;IACrD,KAAK,IAAI,IAAI;IAYb,4CAA4C;IAC5C,IAAI,SAAS,IAAI,OAAO,CAEvB;IAID,OAAO,CAAC,UAAU;IAgClB,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,WAAW;IAsBnB,OAAO,CAAC,sBAAsB;IAQ9B,OAAO,CAAC,kBAAkB;CAe3B"}

package/dist/runtime/ws.js

@@ -0,0 +1,228 @@
+/**
+ * Multiplexed WebSocket connection for real-time terminal I/O and
+ * file watcher events.
+ *
+ * Protocol (matches the guest server at /ws):
+ *
+ * **Binary frames** (terminal I/O):
+ * - `[terminal_id_byte][raw data]` — both directions.
+ * - Client → Server: stdin to terminal.
+ * - Server → Client: stdout from terminal.
+ *
+ * **Text frames** (JSON with "channel" field):
+ * - terminal: resize (client→server), exit (server→client)
+ * - watcher: change, ready, overflow (server→client)
+ *
+ * Only one WS connection is active per VM — a new connection replaces the old one.
+ *
+ * ```ts
+ * const ws = rt.ws();
+ * ws.onTerminalOutput((id, data) => process.stdout.write(data));
+ * ws.onWatcherEvent((ev) => console.log(ev.path, ev.op));
+ * ws.connect();
+ * ```
+ */
+export class RuntimeWebSocket {
+    _ws = null;
+    _baseUrl;
+    _token;
+    _reconnect;
+    _reconnectDelay;
+    _maxReconnectAttempts;
+    _reconnectAttempts = 0;
+    _intentionallyClosed = false;
+    _reconnectTimer = null;
+    // ── Event callbacks ──────────────────────────────────────────────
+    /** Terminal stdout data: (terminalId, rawData). */
+    _onTerminalOutput = null;
+    /** Terminal exit event: (terminalId, exitCode). */
+    _onTerminalExit = null;
+    /** Watcher events (change, ready, overflow). */
+    _onWatcherEvent = null;
+    /** Connection opened. */
+    _onOpen = null;
+    /** Connection closed. */
+    _onClose = null;
+    /** Connection error. */
+    _onError = null;
+    /** Any text message (raw). */
+    _onMessage = null;
+    constructor(runtimeOptions, wsOptions) {
+        const base = (runtimeOptions.baseUrl ?? 'https://workspace.oblien.com').replace(/\/$/, '');
+        this._baseUrl = base.replace(/^http/, 'ws');
+        this._token = runtimeOptions.token;
+        this._reconnect = wsOptions?.reconnect ?? true;
+        this._reconnectDelay = wsOptions?.reconnectDelay ?? 1000;
+        this._maxReconnectAttempts = wsOptions?.maxReconnectAttempts ?? Infinity;
+    }
+    // ── Public API: Event Handlers ────────────────────────────────────
+    /**
+     * Register a handler for terminal output (binary frames).
+     * `id` is the terminal session ID (string), `data` is the raw output.
+     */
+    onTerminalOutput(handler) {
+        this._onTerminalOutput = handler;
+        return this;
+    }
+    /** Register a handler for terminal exit events. */
+    onTerminalExit(handler) {
+        this._onTerminalExit = handler;
+        return this;
+    }
+    /** Register a handler for file watcher events (change, ready, overflow). */
+    onWatcherEvent(handler) {
+        this._onWatcherEvent = handler;
+        return this;
+    }
+    /** Register a handler called when the WebSocket connects. */
+    onOpen(handler) {
+        this._onOpen = handler;
+        return this;
+    }
+    /** Register a handler called when the WebSocket closes. */
+    onClose(handler) {
+        this._onClose = handler;
+        return this;
+    }
+    /** Register a handler for errors. */
+    onError(handler) {
+        this._onError = handler;
+        return this;
+    }
+    /** Register a handler for all incoming text messages (raw parsed JSON). */
+    onMessage(handler) {
+        this._onMessage = handler;
+        return this;
+    }
+    // ── Public API: Send ──────────────────────────────────────────────
+    /**
+     * Write stdin data to a terminal session.
+     * Binary frame format: `[terminal_id_byte][data]`.
+     *
+     * `terminalId` is the numeric session ID (same as `parseInt(session.id)`).
+     * Accepts either a `string` (e.g. `"1"`) or `number`.
+     */
+    writeTerminalInput(terminalId, data) {
+        if (!this._ws || this._ws.readyState !== WebSocket.OPEN)
+            return;
+        const id = typeof terminalId === 'string' ? parseInt(terminalId, 10) : terminalId;
+        const payload = typeof data === 'string' ? new TextEncoder().encode(data) : data;
+        const frame = new Uint8Array(1 + payload.length);
+        frame[0] = id;
+        frame.set(payload, 1);
+        this._ws.send(frame);
+    }
+    /** Send a terminal resize command. */
+    resizeTerminal(terminalId, cols, rows) {
+        this.sendJSON({
+            channel: 'terminal',
+            type: 'resize',
+            id: terminalId,
+            cols,
+            rows,
+        });
+    }
+    /** Send a raw JSON text message. */
+    sendJSON(msg) {
+        if (!this._ws || this._ws.readyState !== WebSocket.OPEN)
+            return;
+        this._ws.send(JSON.stringify(msg));
+    }
+    // ── Public API: Lifecycle ─────────────────────────────────────────
+    /** Open the WebSocket connection. */
+    connect() {
+        this._intentionallyClosed = false;
+        this._reconnectAttempts = 0;
+        this._doConnect();
+    }
+    /** Close the WebSocket connection (no reconnect). */
+    close() {
+        this._intentionallyClosed = true;
+        if (this._reconnectTimer) {
+            clearTimeout(this._reconnectTimer);
+            this._reconnectTimer = null;
+        }
+        if (this._ws) {
+            this._ws.close(1000, 'client close');
+            this._ws = null;
+        }
+    }
+    /** Whether the socket is currently open. */
+    get connected() {
+        return this._ws?.readyState === WebSocket.OPEN;
+    }
+    // ── Internals ─────────────────────────────────────────────────────
+    _doConnect() {
+        const url = `${this._baseUrl}/ws?token=${encodeURIComponent(this._token)}`;
+        const ws = new WebSocket(url);
+        ws.binaryType = 'arraybuffer';
+        this._ws = ws;
+        ws.addEventListener('open', () => {
+            this._reconnectAttempts = 0;
+            this._onOpen?.();
+        });
+        ws.addEventListener('close', (ev) => {
+            this._onClose?.(ev.code, ev.reason);
+            this._ws = null;
+            if (!this._intentionallyClosed && this._reconnect) {
+                this._scheduleReconnect();
+            }
+        });
+        ws.addEventListener('error', (ev) => {
+            this._onError?.(ev);
+        });
+        ws.addEventListener('message', (ev) => {
+            if (ev.data instanceof ArrayBuffer) {
+                this._handleBinary(new Uint8Array(ev.data));
+            }
+            else if (typeof ev.data === 'string') {
+                this._handleText(ev.data);
+            }
+        });
+    }
+    _handleBinary(frame) {
+        if (frame.length < 2)
+            return;
+        const id = String(frame[0]);
+        const data = frame.subarray(1);
+        this._onTerminalOutput?.(id, data);
+    }
+    _handleText(raw) {
+        let msg;
+        try {
+            msg = JSON.parse(raw);
+        }
+        catch {
+            return;
+        }
+        this._onMessage?.(msg);
+        const channel = msg.channel || 'terminal';
+        switch (channel) {
+            case 'terminal':
+                this._handleTerminalMessage(msg);
+                break;
+            case 'watcher':
+                this._onWatcherEvent?.(msg);
+                break;
+        }
+    }
+    _handleTerminalMessage(msg) {
+        const type = msg.type;
+        if (type === 'exit') {
+            const ev = msg;
+            this._onTerminalExit?.(ev.id, ev.code);
+        }
+    }
+    _scheduleReconnect() {
+        if (this._reconnectAttempts >= this._maxReconnectAttempts)
+            return;
+        this._reconnectAttempts++;
+        // Exponential backoff capped at 30s
+        const delay = Math.min(this._reconnectDelay * Math.pow(1.5, this._reconnectAttempts - 1), 30_000);
+        this._reconnectTimer = setTimeout(() => {
+            this._reconnectTimer = null;
+            this._doConnect();
+        }, delay);
+    }
+}
+//# sourceMappingURL=ws.js.map

package/dist/runtime/ws.js.map

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

package/dist/runtime-http.d.ts

@@ -0,0 +1,35 @@
+import type { RuntimeOptions } from './types/runtime.js';
+/**
+ * HTTP transport for the Runtime (workspace internal API).
+ * Uses Bearer token auth against workspace.oblien.com or a direct IP.
+ */
+export declare class RuntimeHttpClient {
+    private readonly baseUrl;
+    private readonly headers;
+    constructor(options: RuntimeOptions);
+    request<T = unknown>(options: {
+        method: string;
+        path: string;
+        body?: unknown;
+        query?: Record<string, string | number | boolean | undefined>;
+        headers?: Record<string, string>;
+    }): Promise<T>;
+    /** Send raw bytes (for stdin). */
+    requestRaw(path: string, data: string): Promise<unknown>;
+    /**
+     * Get a raw streaming Response for SSE / NDJSON consumption.
+     * Handles auth and error checking; callers parse the stream format.
+     */
+    requestStream(options: {
+        method: string;
+        path: string;
+        body?: unknown;
+        query?: Record<string, string | number | boolean | undefined>;
+        headers?: Record<string, string>;
+    }): Promise<Response>;
+    getBaseUrl(): string;
+    getHeaders(): Record<string, string>;
+    private buildUrl;
+    private errorForStatus;
+}
+//# sourceMappingURL=runtime-http.d.ts.map

package/dist/runtime-http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-http.d.ts","sourceRoot":"","sources":["../src/runtime-http.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAUzD;;;GAGG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyB;gBAErC,OAAO,EAAE,cAAc;IAQ7B,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,OAAO,EAAE;QAClC,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,CAAC;QAC9D,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KAClC,GAAG,OAAO,CAAC,CAAC,CAAC;IAsBd,kCAAkC;IAC5B,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAe9D;;;OAGG;IACG,aAAa,CAAC,OAAO,EAAE;QAC3B,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,CAAC;QAC9D,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KAClC,GAAG,OAAO,CAAC,QAAQ,CAAC;IAsBrB,UAAU,IAAI,MAAM;IAIpB,UAAU,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAMpC,OAAO,CAAC,QAAQ;IAgBhB,OAAO,CAAC,cAAc;CAcvB"}

package/dist/runtime-http.js

@@ -0,0 +1,99 @@
+import { OblienError, AuthenticationError, NotFoundError, RateLimitError, ValidationError, ConflictError, } from './error.js';
+/**
+ * HTTP transport for the Runtime (workspace internal API).
+ * Uses Bearer token auth against workspace.oblien.com or a direct IP.
+ */
+export class RuntimeHttpClient {
+    baseUrl;
+    headers;
+    constructor(options) {
+        this.baseUrl = (options.baseUrl ?? 'https://workspace.oblien.com').replace(/\/$/, '');
+        this.headers = {
+            'Content-Type': 'application/json',
+            'Authorization': `Bearer ${options.token}`,
+        };
+    }
+    async request(options) {
+        const url = this.buildUrl(options.path, options.query);
+        const init = {
+            method: options.method,
+            headers: { ...this.headers, ...options.headers },
+        };
+        if (options.body !== undefined) {
+            init.body = JSON.stringify(options.body);
+        }
+        const res = await fetch(url, init);
+        const body = await res.json().catch(() => null);
+        if (!res.ok) {
+            throw this.errorForStatus(res.status, body);
+        }
+        return body;
+    }
+    /** Send raw bytes (for stdin). */
+    async requestRaw(path, data) {
+        const url = this.buildUrl(path);
+        const res = await fetch(url, {
+            method: 'POST',
+            headers: {
+                ...this.headers,
+                'Content-Type': 'application/octet-stream',
+            },
+            body: data,
+        });
+        const json = await res.json().catch(() => null);
+        if (!res.ok)
+            throw this.errorForStatus(res.status, json);
+        return json;
+    }
+    /**
+     * Get a raw streaming Response for SSE / NDJSON consumption.
+     * Handles auth and error checking; callers parse the stream format.
+     */
+    async requestStream(options) {
+        const url = this.buildUrl(options.path, options.query);
+        const init = {
+            method: options.method,
+            headers: { ...this.headers, ...options.headers },
+        };
+        if (options.body !== undefined) {
+            init.body = JSON.stringify(options.body);
+        }
+        const res = await fetch(url, init);
+        if (!res.ok) {
+            const body = await res.json().catch(() => null);
+            throw this.errorForStatus(res.status, body);
+        }
+        return res;
+    }
+    getBaseUrl() {
+        return this.baseUrl;
+    }
+    getHeaders() {
+        return { ...this.headers };
+    }
+    // ── Internals ───────────────────────────────────────────────────────
+    buildUrl(path, query) {
+        const normalized = path.startsWith('/') ? path : `/${path}`;
+        const url = new URL(normalized, this.baseUrl);
+        if (query) {
+            for (const [k, v] of Object.entries(query)) {
+                if (v !== undefined)
+                    url.searchParams.set(k, String(v));
+            }
+        }
+        return url.toString();
+    }
+    errorForStatus(status, body) {
+        const msg = body?.error ??
+            `Request failed with status ${status}`;
+        switch (status) {
+            case 401: return new AuthenticationError(msg);
+            case 404: return new NotFoundError(msg);
+            case 409: return new ConflictError(msg);
+            case 422: return new ValidationError(msg);
+            case 429: return new RateLimitError(msg);
+            default: return new OblienError(msg, status);
+        }
+    }
+}
+//# sourceMappingURL=runtime-http.js.map

package/dist/runtime-http.js.map

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