oblien 1.2.7 → 2.0.0

package/dist/resources/workloads.js

@@ -0,0 +1,83 @@
+/** Managed workloads (long-running processes). */
+export class WorkloadsResource {
+    _http;
+    constructor(_http) {
+        this._http = _http;
+    }
+    /** Create a workload. */
+    async create(workspaceId, params) {
+        const res = await this._http.request({ method: 'POST', path: `/workspace/${workspaceId}/workloads`, body: params });
+        return res.workload;
+    }
+    /** List workloads. */
+    async list(workspaceId, params = {}) {
+        const res = await this._http.request({
+            method: 'GET',
+            path: `/workspace/${workspaceId}/workloads`,
+            query: params,
+        });
+        return res.workloads ?? [];
+    }
+    /** Get a workload. */
+    async get(workspaceId, workloadId) {
+        return this._http.request({ method: 'GET', path: `/workspace/${workspaceId}/workloads/${workloadId}` });
+    }
+    /** Update a workload. */
+    async update(workspaceId, workloadId, params) {
+        return this._http.request({ method: 'PUT', path: `/workspace/${workspaceId}/workloads/${workloadId}`, body: params });
+    }
+    /** Partial update a workload (PATCH alias). */
+    async patch(workspaceId, workloadId, params) {
+        return this._http.request({ method: 'PATCH', path: `/workspace/${workspaceId}/workloads/${workloadId}`, body: params });
+    }
+    /** Delete a workload. */
+    async delete(workspaceId, workloadId) {
+        return this._http.request({ method: 'DELETE', path: `/workspace/${workspaceId}/workloads/${workloadId}` });
+    }
+    /** Delete all workloads. */
+    async deleteAll(workspaceId) {
+        return this._http.request({ method: 'DELETE', path: `/workspace/${workspaceId}/workloads` });
+    }
+    /** Start a workload. */
+    async start(workspaceId, workloadId) {
+        return this._http.request({ method: 'POST', path: `/workspace/${workspaceId}/workloads/${workloadId}/start` });
+    }
+    /** Stop a workload. */
+    async stop(workspaceId, workloadId) {
+        return this._http.request({ method: 'POST', path: `/workspace/${workspaceId}/workloads/${workloadId}/stop` });
+    }
+    /** Get workload status. */
+    async status(workspaceId, workloadId) {
+        return this._http.request({ method: 'GET', path: `/workspace/${workspaceId}/workloads/${workloadId}/status` });
+    }
+    /** Get workload logs. */
+    async logs(workspaceId, workloadId) {
+        return this._http.request({ method: 'GET', path: `/workspace/${workspaceId}/workloads/${workloadId}/logs` });
+    }
+    /** Get workload stats. */
+    async stats(workspaceId, workloadId) {
+        return this._http.request({ method: 'GET', path: `/workspace/${workspaceId}/workloads/${workloadId}/stats` });
+    }
+    /** Stream workload stats (SSE). */
+    async *statsStream(workspaceId, workloadId) {
+        yield* this._http.requestSSE({
+            method: 'GET',
+            path: `/workspace/${workspaceId}/workloads/${workloadId}/stats/stream`,
+        });
+    }
+    /** Stream workload logs (SSE). */
+    async *logsStream(workspaceId, workloadId) {
+        yield* this._http.requestSSE({
+            method: 'GET',
+            path: `/workspace/${workspaceId}/workloads/${workloadId}/logs/stream`,
+        });
+    }
+    /** Stream stats for ALL workloads (SSE). */
+    async *allStatsStream(workspaceId) {
+        yield* this._http.requestSSE({
+            method: 'GET',
+            path: `/workspace/${workspaceId}/workloads/stats/stream`,
+        });
+    }
+}
+//# sourceMappingURL=workloads.js.map

package/dist/resources/workloads.js.map

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

package/dist/runtime/exec.d.ts

@@ -0,0 +1,71 @@
+import type { RuntimeHttpClient } from '../runtime-http.js';
+import type { ExecRunParams, ExecTask, ExecStreamEvent } from '../types/runtime.js';
+/**
+ * Command execution inside the workspace runtime.
+ *
+ * ```ts
+ * const result = await rt.exec.run(['echo', 'hello']);
+ * console.log(result.stdout); // "hello\n"
+ *
+ * // Stream output
+ * for await (const ev of rt.exec.stream(['npm', 'test'])) {
+ *   if (ev.event === 'stdout') process.stdout.write(atob(ev.data));
+ * }
+ *
+ * await rt.exec.kill('task_id');
+ * ```
+ */
+export declare class ExecResource {
+    private readonly _http;
+    constructor(_http: RuntimeHttpClient);
+    /** Run a command synchronously — returns when the process exits. */
+    run(cmd: string[], params?: ExecRunParams): Promise<ExecTask>;
+    /**
+     * Stream command output via SSE — yields events as the process runs.
+     *
+     * Events: `task_id`, `stdout` (base64), `stderr` (base64), `exit`.
+     *
+     * ```ts
+     * for await (const ev of rt.exec.stream(['npm', 'test'])) {
+     *   if (ev.event === 'stdout') process.stdout.write(atob(ev.data));
+     *   if (ev.event === 'exit') console.log('Exit code:', ev.exit_code);
+     * }
+     * ```
+     */
+    stream(cmd: string[], params?: ExecRunParams): AsyncGenerator<ExecStreamEvent>;
+    /**
+     * Subscribe to an existing task's output via SSE.
+     * If the task already finished, replays output + exit immediately.
+     *
+     * ```ts
+     * for await (const ev of rt.exec.subscribe('3')) {
+     *   console.log(ev);
+     * }
+     * ```
+     */
+    subscribe(taskId: string): AsyncGenerator<ExecStreamEvent>;
+    /** List all tracked tasks. */
+    list(): Promise<ExecTask[]>;
+    /** Get a specific task by ID. */
+    get(taskId: string): Promise<ExecTask>;
+    /** Kill / remove a task. */
+    kill(taskId: string): Promise<{
+        success: boolean;
+    }>;
+    /** Delete all tasks. */
+    deleteAll(): Promise<{
+        success: boolean;
+        deleted: number;
+    }>;
+    /** Send stdin to a running task. */
+    input(taskId: string, data: string): Promise<{
+        success: boolean;
+        bytes_written: number;
+    }>;
+    /**
+     * Parse SSE named events from a Response stream.
+     * Server sends `event: <name>\ndata: <json>\n\n`.
+     */
+    private parseSSE;
+}
+//# sourceMappingURL=exec.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"exec.d.ts","sourceRoot":"","sources":["../../src/runtime/exec.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,KAAK,EACV,aAAa,EACb,QAAQ,EAER,eAAe,EAChB,MAAM,qBAAqB,CAAC;AAE7B;;;;;;;;;;;;;;GAcG;AACH,qBAAa,YAAY;IACX,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE,iBAAiB;IAErD,oEAAoE;IAC9D,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,MAAM,GAAE,aAAkB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAcvE;;;;;;;;;;;OAWG;IACI,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,MAAM,GAAE,aAAkB,GAAG,cAAc,CAAC,eAAe,CAAC;IAiBzF;;;;;;;;;OASG;IACI,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,CAAC,eAAe,CAAC;IAWjE,8BAA8B;IACxB,IAAI,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IAQjC,iCAAiC;IAC3B,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAO5C,4BAA4B;IACtB,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAOzD,wBAAwB;IAClB,SAAS,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAOjE,oCAAoC;IAC9B,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC;IAM/F;;;OAGG;YACY,QAAQ;CAsCxB"}

package/dist/runtime/exec.js

@@ -0,0 +1,163 @@
+/**
+ * Command execution inside the workspace runtime.
+ *
+ * ```ts
+ * const result = await rt.exec.run(['echo', 'hello']);
+ * console.log(result.stdout); // "hello\n"
+ *
+ * // Stream output
+ * for await (const ev of rt.exec.stream(['npm', 'test'])) {
+ *   if (ev.event === 'stdout') process.stdout.write(atob(ev.data));
+ * }
+ *
+ * await rt.exec.kill('task_id');
+ * ```
+ */
+export class ExecResource {
+    _http;
+    constructor(_http) {
+        this._http = _http;
+    }
+    /** Run a command synchronously — returns when the process exits. */
+    async run(cmd, params = {}) {
+        return this._http.request({
+            method: 'POST',
+            path: '/exec',
+            body: {
+                cmd,
+                exec_mode: params.execMode,
+                timeout_seconds: params.timeoutSeconds,
+                ttl_seconds: params.ttlSeconds,
+                keep_logs: params.keepLogs,
+            },
+        });
+    }
+    /**
+     * Stream command output via SSE — yields events as the process runs.
+     *
+     * Events: `task_id`, `stdout` (base64), `stderr` (base64), `exit`.
+     *
+     * ```ts
+     * for await (const ev of rt.exec.stream(['npm', 'test'])) {
+     *   if (ev.event === 'stdout') process.stdout.write(atob(ev.data));
+     *   if (ev.event === 'exit') console.log('Exit code:', ev.exit_code);
+     * }
+     * ```
+     */
+    async *stream(cmd, params = {}) {
+        const res = await this._http.requestStream({
+            method: 'POST',
+            path: '/exec/stream',
+            body: {
+                cmd,
+                exec_mode: params.execMode,
+                timeout_seconds: params.timeoutSeconds,
+                ttl_seconds: params.ttlSeconds,
+                keep_logs: params.keepLogs,
+            },
+        });
+        if (!res.body)
+            throw new Error('No response body for exec stream');
+        yield* this.parseSSE(res);
+    }
+    /**
+     * Subscribe to an existing task's output via SSE.
+     * If the task already finished, replays output + exit immediately.
+     *
+     * ```ts
+     * for await (const ev of rt.exec.subscribe('3')) {
+     *   console.log(ev);
+     * }
+     * ```
+     */
+    async *subscribe(taskId) {
+        const res = await this._http.requestStream({
+            method: 'GET',
+            path: '/exec/stream',
+            query: { task_id: taskId },
+        });
+        if (!res.body)
+            throw new Error('No response body for exec subscribe');
+        yield* this.parseSSE(res);
+    }
+    /** List all tracked tasks. */
+    async list() {
+        const res = await this._http.request({
+            method: 'GET',
+            path: '/exec',
+        });
+        return res.tasks;
+    }
+    /** Get a specific task by ID. */
+    async get(taskId) {
+        return this._http.request({
+            method: 'GET',
+            path: `/exec/${taskId}`,
+        });
+    }
+    /** Kill / remove a task. */
+    async kill(taskId) {
+        return this._http.request({
+            method: 'DELETE',
+            path: `/exec/${taskId}`,
+        });
+    }
+    /** Delete all tasks. */
+    async deleteAll() {
+        return this._http.request({
+            method: 'DELETE',
+            path: '/exec',
+        });
+    }
+    /** Send stdin to a running task. */
+    async input(taskId, data) {
+        return this._http.requestRaw(`/exec/${taskId}/input`, data);
+    }
+    // ── SSE Parser (shared by stream + subscribe) ───────────────────
+    /**
+     * Parse SSE named events from a Response stream.
+     * Server sends `event: <name>\ndata: <json>\n\n`.
+     */
+    async *parseSSE(res) {
+        const reader = res.body.getReader();
+        const decoder = new TextDecoder();
+        let buffer = '';
+        let currentEvent = '';
+        try {
+            while (true) {
+                const { done, value } = await reader.read();
+                if (done)
+                    break;
+                buffer += decoder.decode(value, { stream: true });
+                const lines = buffer.split('\n');
+                buffer = lines.pop() ?? '';
+                for (const line of lines) {
+                    if (line.startsWith('event: ')) {
+                        currentEvent = line.slice(7).trim();
+                    }
+                    else if (line.startsWith('data: ')) {
+                        const data = line.slice(6).trim();
+                        if (!data || data === '[DONE]')
+                            continue;
+                        try {
+                            const parsed = JSON.parse(data);
+                            yield { event: currentEvent || 'message', ...parsed };
+                        }
+                        catch {
+                            // Skip non-JSON data lines
+                        }
+                        currentEvent = '';
+                    }
+                    else if (line === '') {
+                        // Empty line = event boundary, reset
+                        currentEvent = '';
+                    }
+                }
+            }
+        }
+        finally {
+            reader.releaseLock();
+        }
+    }
+}
+//# sourceMappingURL=exec.js.map

package/dist/runtime/exec.js.map

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

package/dist/runtime/files.d.ts

@@ -0,0 +1,39 @@
+import type { RuntimeHttpClient } from '../runtime-http.js';
+import type { FileListParams, FileListResponse, FileReadParams, FileReadResponse, FileWriteParams, FileWriteResponse, FileMkdirParams, FileStatParams, FileStatResponse, FileDeleteParams, FileEntry } from '../types/runtime.js';
+/**
+ * File operations inside the workspace runtime.
+ *
+ * ```ts
+ * const entries = await rt.files.list({ dirPath: '/app/src' });
+ * const file = await rt.files.read({ filePath: '/app/index.js' });
+ * await rt.files.write({ fullPath: '/app/hello.txt', content: 'hi' });
+ * ```
+ */
+export declare class FilesResource {
+    private readonly _http;
+    constructor(_http: RuntimeHttpClient);
+    /** List directory contents. */
+    list(params?: FileListParams): Promise<FileListResponse>;
+    /**
+     * Stream directory entries as an async iterator (NDJSON).
+     * Ideal for large directories — entries arrive as they're discovered.
+     */
+    stream(params?: FileListParams): AsyncGenerator<FileEntry>;
+    /** Read file content. Supports line ranges. */
+    read(params: FileReadParams): Promise<FileReadResponse>;
+    /** Write or overwrite a file. */
+    write(params: FileWriteParams): Promise<FileWriteResponse>;
+    /** Create a directory (and parents). */
+    mkdir(params: FileMkdirParams): Promise<{
+        success: boolean;
+        path: string;
+    }>;
+    /** Get file/directory metadata. */
+    stat(params: FileStatParams): Promise<FileStatResponse>;
+    /** Delete a file or directory. Accepts path in body or query. */
+    delete(params: FileDeleteParams): Promise<{
+        success: boolean;
+        path: string;
+    }>;
+}
+//# sourceMappingURL=files.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../../src/runtime/files.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,KAAK,EACV,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,SAAS,EACV,MAAM,qBAAqB,CAAC;AAE7B;;;;;;;;GAQG;AACH,qBAAa,aAAa;IACZ,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE,iBAAiB;IAErD,+BAA+B;IACzB,IAAI,CAAC,MAAM,GAAE,cAAmB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAuBlE;;;OAGG;IACI,MAAM,CAAC,MAAM,GAAE,cAAmB,GAAG,cAAc,CAAC,SAAS,CAAC;IAkDrE,+CAA+C;IACzC,IAAI,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAa7D,iCAAiC;IAC3B,KAAK,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAchE,wCAAwC;IAClC,KAAK,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAQjF,mCAAmC;IAC7B,IAAI,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAQ7D,iEAAiE;IAC3D,MAAM,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CAOpF"}

package/dist/runtime/files.js

@@ -0,0 +1,143 @@
+/**
+ * File operations inside the workspace runtime.
+ *
+ * ```ts
+ * const entries = await rt.files.list({ dirPath: '/app/src' });
+ * const file = await rt.files.read({ filePath: '/app/index.js' });
+ * await rt.files.write({ fullPath: '/app/hello.txt', content: 'hi' });
+ * ```
+ */
+export class FilesResource {
+    _http;
+    constructor(_http) {
+        this._http = _http;
+    }
+    /** List directory contents. */
+    async list(params = {}) {
+        return this._http.request({
+            method: 'GET',
+            path: '/files',
+            query: {
+                path: params.dirPath,
+                nested: params.nested,
+                flatten: params.flatten,
+                light: params.light,
+                include_hash: params.includeHash,
+                include_content: params.includeContent,
+                include_extensions: params.includeExtensions,
+                code_files_only: params.codeFilesOnly,
+                use_gitignore: params.useGitignore,
+                max_depth: params.maxDepth,
+                path_filter: params.pathFilter,
+                include_ext: params.includeExt,
+                ignore_patterns: params.ignorePatterns,
+                max_content_budget: params.maxContentBudget,
+            },
+        });
+    }
+    /**
+     * Stream directory entries as an async iterator (NDJSON).
+     * Ideal for large directories — entries arrive as they're discovered.
+     */
+    async *stream(params = {}) {
+        const res = await this._http.requestStream({
+            method: 'GET',
+            path: '/files/stream',
+            query: {
+                path: params.dirPath,
+                nested: params.nested,
+                flatten: params.flatten,
+                light: params.light,
+                include_hash: params.includeHash,
+                include_content: params.includeContent,
+                include_extensions: params.includeExtensions,
+                code_files_only: params.codeFilesOnly,
+                use_gitignore: params.useGitignore,
+                max_depth: params.maxDepth,
+                path_filter: params.pathFilter,
+                include_ext: params.includeExt,
+                ignore_patterns: params.ignorePatterns,
+                max_content_budget: params.maxContentBudget,
+            },
+        });
+        if (!res.body)
+            throw new Error('No response body for file stream');
+        const reader = res.body.getReader();
+        const decoder = new TextDecoder();
+        let buffer = '';
+        try {
+            while (true) {
+                const { done, value } = await reader.read();
+                if (done)
+                    break;
+                buffer += decoder.decode(value, { stream: true });
+                const lines = buffer.split('\n');
+                buffer = lines.pop() ?? '';
+                for (const line of lines) {
+                    if (!line.trim())
+                        continue;
+                    const obj = JSON.parse(line);
+                    // Skip control events (start, done)
+                    if (obj.event)
+                        continue;
+                    yield obj;
+                }
+            }
+        }
+        finally {
+            reader.releaseLock();
+        }
+    }
+    /** Read file content. Supports line ranges. */
+    async read(params) {
+        return this._http.request({
+            method: 'GET',
+            path: '/files/read',
+            query: {
+                path: params.filePath,
+                start_line: params.startLine,
+                end_line: params.endLine,
+                with_line_numbers: params.withLineNumbers,
+            },
+        });
+    }
+    /** Write or overwrite a file. */
+    async write(params) {
+        return this._http.request({
+            method: 'POST',
+            path: '/files/write',
+            body: {
+                path: params.fullPath,
+                content: params.content,
+                create_dirs: params.createDirs,
+                append: params.append,
+                mode: params.mode,
+            },
+        });
+    }
+    /** Create a directory (and parents). */
+    async mkdir(params) {
+        return this._http.request({
+            method: 'POST',
+            path: '/files/mkdir',
+            body: { path: params.path, mode: params.mode },
+        });
+    }
+    /** Get file/directory metadata. */
+    async stat(params) {
+        return this._http.request({
+            method: 'GET',
+            path: '/files/stat',
+            query: { path: params.path },
+        });
+    }
+    /** Delete a file or directory. Accepts path in body or query. */
+    async delete(params) {
+        return this._http.request({
+            method: 'POST',
+            path: '/files/delete',
+            body: { path: params.path },
+        });
+    }
+}
+//# sourceMappingURL=files.js.map

package/dist/runtime/files.js.map

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

package/dist/runtime/search.d.ts

@@ -0,0 +1,23 @@
+import type { RuntimeHttpClient } from '../runtime-http.js';
+import type { ContentSearchParams, ContentSearchResponse, FileSearchParams, FileSearchResponse, SearchStatusResponse, SearchInitResponse } from '../types/runtime.js';
+/**
+ * Content and filename search inside the workspace runtime.
+ *
+ * ```ts
+ * const results = await rt.search.content({ query: 'handleRequest', path: '/app' });
+ * const files = await rt.search.files({ query: 'controller' });
+ * ```
+ */
+export declare class SearchResource {
+    private readonly _http;
+    constructor(_http: RuntimeHttpClient);
+    /** Search file contents (powered by ripgrep). */
+    content(params: ContentSearchParams): Promise<ContentSearchResponse>;
+    /** Search by filename/path. */
+    files(params: FileSearchParams): Promise<FileSearchResponse>;
+    /** Check if ripgrep is installed. */
+    status(): Promise<SearchStatusResponse>;
+    /** Install ripgrep (one-time setup). */
+    init(): Promise<SearchInitResponse>;
+}
+//# sourceMappingURL=search.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/runtime/search.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,KAAK,EACV,mBAAmB,EACnB,qBAAqB,EACrB,gBAAgB,EAChB,kBAAkB,EAClB,oBAAoB,EACpB,kBAAkB,EACnB,MAAM,qBAAqB,CAAC;AAE7B;;;;;;;GAOG;AACH,qBAAa,cAAc;IACb,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE,iBAAiB;IAErD,iDAAiD;IAC3C,OAAO,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAqB1E,+BAA+B;IACzB,KAAK,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAelE,qCAAqC;IAC/B,MAAM,IAAI,OAAO,CAAC,oBAAoB,CAAC;IAO7C,wCAAwC;IAClC,IAAI,IAAI,OAAO,CAAC,kBAAkB,CAAC;CAM1C"}

package/dist/runtime/search.js

@@ -0,0 +1,65 @@
+/**
+ * Content and filename search inside the workspace runtime.
+ *
+ * ```ts
+ * const results = await rt.search.content({ query: 'handleRequest', path: '/app' });
+ * const files = await rt.search.files({ query: 'controller' });
+ * ```
+ */
+export class SearchResource {
+    _http;
+    constructor(_http) {
+        this._http = _http;
+    }
+    /** Search file contents (powered by ripgrep). */
+    async content(params) {
+        return this._http.request({
+            method: 'GET',
+            path: '/files/search',
+            query: {
+                q: params.query,
+                path: params.path,
+                case_sensitive: params.caseSensitive,
+                regex: params.regex,
+                whole_word: params.wholeWord,
+                max_results: params.maxResults,
+                timeout: params.timeout,
+                context_lines: params.contextLines,
+                file_types: params.fileTypes,
+                include_hidden: params.includeHidden,
+                no_gitignore: params.noGitignore,
+                ignore_patterns: params.ignorePatterns,
+            },
+        });
+    }
+    /** Search by filename/path. */
+    async files(params) {
+        return this._http.request({
+            method: 'GET',
+            path: '/files/search/files',
+            query: {
+                q: params.query,
+                path: params.path,
+                case_sensitive: params.caseSensitive,
+                include_hidden: params.includeHidden,
+                max_results: params.maxResults,
+                ignore_patterns: params.ignorePatterns,
+            },
+        });
+    }
+    /** Check if ripgrep is installed. */
+    async status() {
+        return this._http.request({
+            method: 'GET',
+            path: '/files/search/init',
+        });
+    }
+    /** Install ripgrep (one-time setup). */
+    async init() {
+        return this._http.request({
+            method: 'POST',
+            path: '/files/search/init',
+        });
+    }
+}
+//# sourceMappingURL=search.js.map

package/dist/runtime/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/runtime/search.ts"],"names":[],"mappings":"AAUA;;;;;;;GAOG;AACH,MAAM,OAAO,cAAc;IACI;IAA7B,YAA6B,KAAwB;QAAxB,UAAK,GAAL,KAAK,CAAmB;IAAG,CAAC;IAEzD,iDAAiD;IACjD,KAAK,CAAC,OAAO,CAAC,MAA2B;QACvC,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAwB;YAC/C,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,eAAe;YACrB,KAAK,EAAE;gBACL,CAAC,EAAE,MAAM,CAAC,KAAK;gBACf,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,cAAc,EAAE,MAAM,CAAC,aAAa;gBACpC,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,UAAU,EAAE,MAAM,CAAC,SAAS;gBAC5B,WAAW,EAAE,MAAM,CAAC,UAAU;gBAC9B,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,aAAa,EAAE,MAAM,CAAC,YAAY;gBAClC,UAAU,EAAE,MAAM,CAAC,SAAS;gBAC5B,cAAc,EAAE,MAAM,CAAC,aAAa;gBACpC,YAAY,EAAE,MAAM,CAAC,WAAW;gBAChC,eAAe,EAAE,MAAM,CAAC,cAAc;aACvC;SACF,CAAC,CAAC;IACL,CAAC;IAED,+BAA+B;IAC/B,KAAK,CAAC,KAAK,CAAC,MAAwB;QAClC,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAqB;YAC5C,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,qBAAqB;YAC3B,KAAK,EAAE;gBACL,CAAC,EAAE,MAAM,CAAC,KAAK;gBACf,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,cAAc,EAAE,MAAM,CAAC,aAAa;gBACpC,cAAc,EAAE,MAAM,CAAC,aAAa;gBACpC,WAAW,EAAE,MAAM,CAAC,UAAU;gBAC9B,eAAe,EAAE,MAAM,CAAC,cAAc;aACvC;SACF,CAAC,CAAC;IACL,CAAC;IAED,qCAAqC;IACrC,KAAK,CAAC,MAAM;QACV,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAuB;YAC9C,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,oBAAoB;SAC3B,CAAC,CAAC;IACL,CAAC;IAED,wCAAwC;IACxC,KAAK,CAAC,IAAI;QACR,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAqB;YAC5C,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,oBAAoB;SAC3B,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/runtime/terminal.d.ts

@@ -0,0 +1,29 @@
+import type { RuntimeHttpClient } from '../runtime-http.js';
+import type { TerminalCreateParams, TerminalSession, TerminalScrollbackResponse } from '../types/runtime.js';
+/**
+ * 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 declare class TerminalResource {
+    private readonly _http;
+    constructor(_http: RuntimeHttpClient);
+    /** Create a new terminal session. */
+    create(params?: TerminalCreateParams): Promise<TerminalSession>;
+    /** List active terminal sessions. */
+    list(): Promise<TerminalSession[]>;
+    /** Close a terminal session. */
+    close(sessionId: string): Promise<{
+        success: boolean;
+        terminal_id: string;
+    }>;
+    /** Get scrollback buffer for a session. */
+    scrollback(sessionId: string, params?: {
+        bytes?: number;
+    }): Promise<TerminalScrollbackResponse>;
+}
+//# sourceMappingURL=terminal.d.ts.map