@code-harness/sdk 0.0.0-stage → 0.1.1

package/dist/core/client.js

@@ -0,0 +1,66 @@
+import { Browser } from '../browser.js';
+import { CodeHarnessError } from '../errors.js';
+import { Sandbox } from './sandbox.js';
+const API_PREFIX = '/api/v1';
+// everything but sandboxes, which each entry's Client adds with its own Sandbox
+export class BaseClient {
+    baseUrl;
+    #token;
+    #fetch;
+    constructor(options = {}) {
+        const env = typeof process === 'undefined' ? {} : process.env;
+        const baseUrl = options.baseUrl ?? env.CODE_HARNESS_BASE_URL;
+        const token = options.token ?? env.CODE_HARNESS_TOKEN;
+        if (!baseUrl || !token)
+            throw new CodeHarnessError('Pass baseUrl and token, or set CODE_HARNESS_BASE_URL and CODE_HARNESS_TOKEN', 'AUTHENTICATION_FAILED');
+        this.baseUrl = baseUrl.replace(/\/+$/, '');
+        this.#token = token;
+        this.#fetch = options.fetch ?? fetch;
+    }
+    async me() {
+        return (await this.request('GET', '/me')).json();
+    }
+    async createBrowser() {
+        const session = (await (await this.request('POST', '/browser', {})).json());
+        return new Browser(this, { id: session.id, sandboxId: null, record: false });
+    }
+    getBrowser(id) {
+        return new Browser(this, { id, sandboxId: null, record: false });
+    }
+    // Sends one call to /api/v1, a FormData body as multipart and any other as JSON, and throws CodeHarnessError unless it answers 2xx.
+    async request(method, path, body) {
+        const headers = { authorization: `Bearer ${this.#token}` };
+        const isJson = body !== undefined && !(body instanceof FormData);
+        if (isJson)
+            headers['content-type'] = 'application/json';
+        let response;
+        try {
+            response = await this.#fetch(`${this.baseUrl}${API_PREFIX}${path}`, {
+                method,
+                headers,
+                body: isJson ? JSON.stringify(body) : body,
+            });
+        }
+        catch (err) {
+            const cause = err instanceof Error ? err : new Error(String(err));
+            throw new CodeHarnessError(`Can't reach ${this.baseUrl}: ${cause.message}`, 'NETWORK_ERROR', null, cause);
+        }
+        if (!response.ok)
+            throw await CodeHarnessError.fromResponse(response);
+        return response;
+    }
+}
+export class Client extends BaseClient {
+    async createSandbox({ name, env, ...options } = {}) {
+        const response = await this.request('POST', '/workspaces', {
+            name: name ?? `sandbox-${Date.now()}`,
+            defaultEnv: env,
+        });
+        return new Sandbox(this, (await response.json()), options);
+    }
+    async getSandbox(id, options = {}) {
+        const response = await this.request('GET', `/workspaces/${encodeURIComponent(id)}`);
+        return new Sandbox(this, (await response.json()), options);
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/core/client.js.map

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

package/dist/core/index.d.ts

@@ -0,0 +1,4 @@
+export { Browser, type NavigatedPage, type Page, type PageRef, type RunResult, type WaitFor } from '../browser.js';
+export { CodeHarnessError, type CodeHarnessErrorCode } from '../errors.js';
+export { Client, type ClientOptions, type CreateSandboxOptions } from './client.js';
+export { Sandbox, type ExecuteResponse, type FileDownloadResponse, type FileOperationError, type FileUploadResponse, type LaunchOptions, type SandboxOptions, } from './sandbox.js';

package/dist/core/index.js

@@ -0,0 +1,5 @@
+export { Browser } from '../browser.js';
+export { CodeHarnessError } from '../errors.js';
+export { Client } from './client.js';
+export { Sandbox, } from './sandbox.js';
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAA6E,MAAM,eAAe,CAAA;AAClH,OAAO,EAAE,gBAAgB,EAA6B,MAAM,cAAc,CAAA;AAC1E,OAAO,EAAE,MAAM,EAAiD,MAAM,aAAa,CAAA;AACnF,OAAO,EACL,OAAO,GAOR,MAAM,cAAc,CAAA"}

package/dist/core/sandbox.d.ts

@@ -0,0 +1,63 @@
+import { Browser } from '../browser.js';
+import type { BaseClient } from './client.js';
+export declare const ROOT = "/workspace";
+export type FileOperationError = 'file_not_found' | 'permission_denied' | 'is_directory' | 'invalid_path';
+export interface ExecuteResponse {
+    output: string;
+    exitCode: number | null;
+    truncated: boolean;
+}
+export interface FileUploadResponse {
+    path: string;
+    error: FileOperationError | null;
+}
+export interface FileDownloadResponse {
+    path: string;
+    content: Uint8Array | null;
+    error: FileOperationError | null;
+}
+export interface SandboxOptions {
+    timeoutMs?: number;
+    record?: boolean;
+}
+export interface LaunchOptions {
+    command: string;
+    port: number;
+    env?: Record<string, string>;
+    network?: {
+        allow?: string[];
+        deny?: string[];
+    };
+}
+export interface Workspace {
+    id: string;
+    name: string;
+    defaultEnvKeys: string[];
+    createdAt: string;
+}
+export declare class Sandbox {
+    #private;
+    readonly id: string;
+    readonly name: string;
+    readonly envKeys: string[];
+    readonly createdAt: Date;
+    readonly browser: Browser;
+    constructor(client: BaseClient, workspace: Workspace, { timeoutMs, record }?: SandboxOptions);
+    execute(command: string): Promise<ExecuteResponse>;
+    uploadFiles(files: Array<[string, Uint8Array]>): Promise<FileUploadResponse[]>;
+    downloadFiles(paths: string[]): Promise<FileDownloadResponse[]>;
+    uploadAsZip(zip: Blob | Uint8Array<ArrayBuffer> | ArrayBuffer, { path }?: {
+        path?: string;
+    }): Promise<{
+        path: string;
+        files: number;
+    }>;
+    launch(options: LaunchOptions): Promise<{
+        url: string;
+    }>;
+    logs({ tail }?: {
+        tail?: number;
+    }): Promise<string[]>;
+    stop(): Promise<void>;
+    close(): Promise<void>;
+}

package/dist/core/sandbox.js

@@ -0,0 +1,117 @@
+import { Browser } from '../browser.js';
+import { CodeHarnessError } from '../errors.js';
+export const ROOT = '/workspace';
+const DEFAULT_TIMEOUT_MS = 120_000;
+const UTF8 = new TextDecoder('utf-8', { fatal: true });
+// /workspace/src/a.ts or src/a.ts → src/a.ts, /workspace → ''; null for a path outside /workspace
+const relativePath = (path) => {
+    if (path === ROOT)
+        return '';
+    return path.startsWith(`${ROOT}/`) ? path.slice(ROOT.length + 1) : path.startsWith('/') ? null : path;
+};
+const encodePath = (relative) => relative.split('/').map(encodeURIComponent).join('/');
+// a file route's answer for one path; anything else, like a 401, isn't about the path and is thrown
+const fileError = (err) => {
+    if (err instanceof CodeHarnessError && err.code === 'NOT_FOUND')
+        return 'file_not_found';
+    if (err instanceof CodeHarnessError && err.code === 'INVALID_REQUEST')
+        return 'invalid_path';
+    throw err;
+};
+export class Sandbox {
+    id;
+    name;
+    envKeys;
+    createdAt;
+    browser;
+    #client;
+    #timeoutMs;
+    constructor(client, workspace, { timeoutMs = DEFAULT_TIMEOUT_MS, record = false } = {}) {
+        this.#client = client;
+        this.#timeoutMs = timeoutMs;
+        this.id = workspace.id;
+        this.name = workspace.name;
+        this.envKeys = workspace.defaultEnvKeys;
+        this.createdAt = new Date(workspace.createdAt);
+        this.browser = new Browser(client, { id: null, sandboxId: workspace.id, record });
+    }
+    async execute(command) {
+        const response = await this.#client.request('POST', `/workspaces/${this.id}/sandbox/exec`, {
+            command,
+            timeoutMs: this.#timeoutMs,
+        });
+        const result = (await response.json());
+        return {
+            output: result.timedOut ? `${result.output}\ntimed out after ${this.#timeoutMs} ms` : result.output,
+            exitCode: result.exitCode,
+            truncated: false,
+        };
+    }
+    async uploadFiles(files) {
+        const results = [];
+        for (const [path, bytes] of files) {
+            const relative = relativePath(path);
+            if (!relative) {
+                results.push({ path, error: 'invalid_path' });
+                continue;
+            }
+            let content;
+            try {
+                content = UTF8.decode(bytes);
+            }
+            catch {
+                // the files route takes text only
+                results.push({ path, error: 'invalid_path' });
+                continue;
+            }
+            const error = await this.#client
+                .request('PUT', `/workspaces/${this.id}/files/${encodePath(relative)}`, { content })
+                .then(() => null, fileError);
+            results.push({ path, error });
+        }
+        return results;
+    }
+    async downloadFiles(paths) {
+        const results = [];
+        for (const path of paths) {
+            const relative = relativePath(path);
+            if (!relative) {
+                results.push({ path, content: null, error: 'invalid_path' });
+                continue;
+            }
+            try {
+                const response = await this.#client.request('GET', `/workspaces/${this.id}/files/${encodePath(relative)}?raw=true`);
+                results.push({ path, content: new Uint8Array(await response.arrayBuffer()), error: null });
+            }
+            catch (err) {
+                results.push({ path, content: null, error: fileError(err) });
+            }
+        }
+        return results;
+    }
+    async uploadAsZip(zip, { path = '' } = {}) {
+        const relative = relativePath(path);
+        if (relative === null)
+            throw new CodeHarnessError(`${path} is outside ${ROOT}`, 'INVALID_REQUEST');
+        const form = new FormData();
+        form.append('path', relative);
+        form.append('file', zip instanceof Blob ? zip : new Blob([zip]), 'upload.zip');
+        return (await this.#client.request('PUT', `/workspaces/${this.id}/upload`, form)).json();
+    }
+    async launch(options) {
+        return (await this.#client.request('POST', `/workspaces/${this.id}/sandbox/launch`, options)).json();
+    }
+    async logs({ tail } = {}) {
+        const query = tail === undefined ? '' : `?tail=${tail}`;
+        const response = await this.#client.request('GET', `/workspaces/${this.id}/sandbox/logs${query}`);
+        return (await response.json()).lines;
+    }
+    async stop() {
+        await this.#client.request('POST', `/workspaces/${this.id}/sandbox/stop`);
+    }
+    async close() {
+        await this.browser.close();
+        await this.#client.request('DELETE', `/workspaces/${this.id}`);
+    }
+}
+//# sourceMappingURL=sandbox.js.map

package/dist/core/sandbox.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,8 @@
+export type CodeHarnessErrorCode = 'INVALID_REQUEST' | 'AUTHENTICATION_FAILED' | 'NOT_FOUND' | 'CONFLICT' | 'TOO_LARGE' | 'RATE_LIMITED' | 'UPSTREAM_FAILED' | 'TIMEOUT' | 'NETWORK_ERROR' | 'UNKNOWN';
+export declare class CodeHarnessError extends Error {
+    readonly code: CodeHarnessErrorCode;
+    readonly status: number | null;
+    readonly name: string;
+    constructor(message: string, code: CodeHarnessErrorCode, status?: number | null, cause?: Error);
+    static fromResponse(response: Response): Promise<CodeHarnessError>;
+}

package/dist/errors.js

@@ -0,0 +1,29 @@
+const CODES = {
+    400: 'INVALID_REQUEST',
+    401: 'AUTHENTICATION_FAILED',
+    404: 'NOT_FOUND',
+    409: 'CONFLICT',
+    413: 'TOO_LARGE',
+    429: 'RATE_LIMITED',
+    502: 'UPSTREAM_FAILED',
+    504: 'TIMEOUT',
+};
+// deepagents' SandboxError.isInstance checks this symbol, so the client entry needn't load deepagents
+const SANDBOX_ERROR = Symbol.for('sandbox.error');
+export class CodeHarnessError extends Error {
+    code;
+    status;
+    name = 'CodeHarnessError';
+    constructor(message, code, status = null, cause) {
+        super(message, { cause });
+        this.code = code;
+        this.status = status;
+        Object.defineProperty(this, SANDBOX_ERROR, { value: true });
+    }
+    static async fromResponse(response) {
+        const body = (await response.json().catch(() => null));
+        const message = body?.message ?? body?.error ?? response.statusText;
+        return new CodeHarnessError(message, CODES[response.status] ?? 'UNKNOWN', response.status);
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,KAAK,GAAyC;IAClD,GAAG,EAAE,iBAAiB;IACtB,GAAG,EAAE,uBAAuB;IAC5B,GAAG,EAAE,WAAW;IAChB,GAAG,EAAE,UAAU;IACf,GAAG,EAAE,WAAW;IAChB,GAAG,EAAE,cAAc;IACnB,GAAG,EAAE,iBAAiB;IACtB,GAAG,EAAE,SAAS;CACf,CAAA;AAcD,sGAAsG;AACtG,MAAM,aAAa,GAAG,MAAM,CAAC,GAAG,CAAC,eAAe,CAAC,CAAA;AAEjD,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IAK9B,IAAI;IACJ,MAAM;IALC,IAAI,GAAW,kBAAkB,CAAA;IAEnD,YACE,OAAe,EACN,IAA0B,EAC1B,MAAM,GAAkB,IAAI,EACrC,KAAa;QAEb,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,CAAA;oBAJhB,IAAI;sBACJ,MAAM;QAIf,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,aAAa,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;IAC7D,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,QAAkB;QAC1C,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAgD,CAAA;QACrG,MAAM,OAAO,GAAG,IAAI,EAAE,OAAO,IAAI,IAAI,EAAE,KAAK,IAAI,QAAQ,CAAC,UAAU,CAAA;QAEnE,OAAO,IAAI,gBAAgB,CAAC,OAAO,EAAE,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAA;IAC5F,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { Browser, type NavigatedPage, type Page, type PageRef, type RunResult, type WaitFor } from './browser.js';
+export { Client, type ClientOptions, type CreateSandboxOptions } from './client.js';
+export { CodeHarnessError, type CodeHarnessErrorCode } from './errors.js';
+export { createBrowserUseMiddleware } from './integration/langchain/browser-use.js';
+export { createCodeHarnessMiddleware } from './integration/langchain/code-harness.js';
+export { createSkillUseMiddleware } from './integration/langchain/skill-use.js';
+export { Sandbox, type LaunchOptions, type SandboxOptions } from './sandbox.js';

package/dist/index.js

@@ -0,0 +1,8 @@
+export { Browser } from './browser.js';
+export { Client } from './client.js';
+export { CodeHarnessError } from './errors.js';
+export { createBrowserUseMiddleware } from './integration/langchain/browser-use.js';
+export { createCodeHarnessMiddleware } from './integration/langchain/code-harness.js';
+export { createSkillUseMiddleware } from './integration/langchain/skill-use.js';
+export { Sandbox } from './sandbox.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAA6E,MAAM,cAAc,CAAA;AACjH,OAAO,EAAE,MAAM,EAAiD,MAAM,aAAa,CAAA;AACnF,OAAO,EAAE,gBAAgB,EAA6B,MAAM,aAAa,CAAA;AACzE,OAAO,EAAE,0BAA0B,EAAE,MAAM,wCAAwC,CAAA;AACnF,OAAO,EAAE,2BAA2B,EAAE,MAAM,yCAAyC,CAAA;AACrF,OAAO,EAAE,wBAAwB,EAAE,MAAM,sCAAsC,CAAA;AAC/E,OAAO,EAAE,OAAO,EAA2C,MAAM,cAAc,CAAA"}

package/dist/integration/langchain/browser-use.d.ts

@@ -0,0 +1,7 @@
+import { type StructuredTool } from 'langchain';
+import type { Browser } from '../../browser.js';
+export declare const attempt: (call: () => Promise<unknown>) => Promise<string>;
+export declare const browserTools: (browser: Browser) => StructuredTool[];
+export declare function createBrowserUseMiddleware({ browser }: {
+    browser: Browser;
+}): import("langchain").AgentMiddleware<undefined, undefined, unknown, StructuredTool<import("@langchain/core/tools").ToolSchemaBase, any, any, any, unknown>[], readonly []>;

package/dist/integration/langchain/browser-use.js

@@ -0,0 +1,74 @@
+import { createMiddleware, tool } from 'langchain';
+import { z } from 'zod';
+import { CodeHarnessError } from '../../errors.js';
+import { ROOT } from '../../sandbox.js';
+const WaitFor = z
+    .object({
+    selector: z.string().optional().describe('CSS selector of an element to wait for'),
+    text: z.string().optional().describe('Text to wait for on the page'),
+    timeoutMs: z.number().int().optional().describe('How long to wait, 10000 by default, 60000 at most'),
+})
+    .optional();
+// a tool's answer; an error goes back to the model as text, so it can recover instead of ending the run
+export const attempt = async (call) => {
+    try {
+        const result = await call();
+        return typeof result === 'string' ? result : JSON.stringify(result);
+    }
+    catch (err) {
+        if (err instanceof CodeHarnessError)
+            return `Error: ${err.status ?? err.code} ${err.message}`;
+        return `Error: ${err instanceof Error ? err.message : String(err)}`;
+    }
+};
+export const browserTools = (browser) => {
+    const tools = [
+        tool(({ url, until }) => attempt(() => browser.navigate(url, { until })), {
+            name: 'browser_navigate',
+            description: browser.sandboxId
+                ? 'Open a URL in the browser and return the page as text and numbered refs. A path like "/" opens the launched app.'
+                : 'Open a URL in the browser and return the page as text and numbered refs.',
+            schema: z.object({
+                url: z.string().describe(browser.sandboxId ? 'A path in the app, or a public URL' : 'A public URL'),
+                until: WaitFor,
+            }),
+        }),
+        tool(({ maxChars, waitFor }) => attempt(() => browser.read({ maxChars, waitFor })), {
+            name: 'browser_read',
+            description: 'Read the current page as text and numbered refs.',
+            schema: z.object({ maxChars: z.number().int().optional(), waitFor: WaitFor }),
+        }),
+        tool(({ ref, waitFor }) => attempt(() => browser.click(ref, { waitFor })), {
+            name: 'browser_click',
+            description: 'Click the element with this ref and return the page after.',
+            schema: z.object({ ref: z.number().int().describe('A ref from the last page read'), waitFor: WaitFor }),
+        }),
+        tool(({ ref, text, submit, waitFor }) => attempt(() => browser.type(ref, text, { submit, waitFor })), {
+            name: 'browser_type',
+            description: 'Type into the field with this ref and return the page after.',
+            schema: z.object({
+                ref: z.number().int().describe('A ref from the last page read'),
+                text: z.string(),
+                submit: z.boolean().optional().describe('Press Enter after typing'),
+                waitFor: WaitFor,
+            }),
+        }),
+    ];
+    if (browser.record)
+        tools.push(tool(({ fullPage, waitFor }) => attempt(async () => `${ROOT}/${(await browser.screenshot({ fullPage, waitFor })).path}`), {
+            name: 'browser_screenshot',
+            description: 'Take a PNG screenshot of the page and return its path, which read_file opens.',
+            schema: z.object({ fullPage: z.boolean().optional(), waitFor: WaitFor }),
+        }));
+    return tools;
+};
+export function createBrowserUseMiddleware({ browser }) {
+    return createMiddleware({
+        name: 'BrowserUseMiddleware',
+        tools: browserTools(browser),
+        afterAgent: async () => {
+            await browser.close();
+        },
+    });
+}
+//# sourceMappingURL=browser-use.js.map

package/dist/integration/langchain/browser-use.js.map

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

package/dist/integration/langchain/code-harness.d.ts

@@ -0,0 +1,5 @@
+import { type StructuredTool } from 'langchain';
+import { type Sandbox } from '../../sandbox.js';
+export declare function createCodeHarnessMiddleware({ sandbox }: {
+    sandbox: Sandbox;
+}): import("langchain").AgentMiddleware<undefined, undefined, unknown, StructuredTool<import("@langchain/core/tools").ToolSchemaBase, any, any, any, unknown>[], readonly []>;

package/dist/integration/langchain/code-harness.js

@@ -0,0 +1,40 @@
+import { createMiddleware, tool } from 'langchain';
+import { z } from 'zod';
+import { ROOT } from '../../sandbox.js';
+import { attempt, browserTools } from './browser-use.js';
+const PROMPT = `## Code-Harness sandbox
+
+Your files are in ${ROOT}, and execute runs commands from there. Install dependencies in the same command that needs them; a later command may not have them.
+Start the app with launch_app, then open it with the browser tools at a path like "/" or "/login". When it fails, read app_logs.`;
+export function createCodeHarnessMiddleware({ sandbox }) {
+    const { browser } = sandbox;
+    const tools = [
+        tool(({ command, port, env }) => attempt(async () => {
+            await sandbox.stop();
+            return (await sandbox.launch({ command, port, env })).url;
+        }), {
+            name: 'launch_app',
+            description: 'Start the app in the background, stopping the one running, and return its public URL once it listens on port. Put the install step in the command, like "npm ci && npm start".',
+            schema: z.object({
+                command: z.string().describe('Shell command that starts the app'),
+                port: z.number().int().describe('Port the app listens on; PORT is set to it'),
+                env: z.record(z.string(), z.string()).optional().describe('Env for the app'),
+            }),
+        }),
+        tool(({ tail }) => attempt(async () => (await sandbox.logs({ tail })).join('\n')), {
+            name: 'app_logs',
+            description: 'The last lines the app wrote. After it ends, the last line says how.',
+            schema: z.object({ tail: z.number().int().optional().describe('How many lines, 200 by default, 1000 at most') }),
+        }),
+        ...browserTools(browser),
+    ];
+    return createMiddleware({
+        name: 'CodeHarnessMiddleware',
+        tools,
+        wrapModelCall: (request, handler) => handler({ ...request, systemMessage: request.systemMessage.concat(PROMPT) }),
+        afterAgent: async () => {
+            await browser.close();
+        },
+    });
+}
+//# sourceMappingURL=code-harness.js.map

package/dist/integration/langchain/code-harness.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-harness.js","sourceRoot":"","sources":["../../../src/integration/langchain/code-harness.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAuB,IAAI,EAAE,MAAM,WAAW,CAAA;AACvE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,EAAE,IAAI,EAAgB,MAAM,kBAAkB,CAAA;AACrD,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAExD,MAAM,MAAM,GAAG;;oBAEK,IAAI;iIACyG,CAAA;AAEjI,MAAM,UAAU,2BAA2B,CAAC,EAAE,OAAO,EAAwB;IAC3E,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAA;IAE3B,MAAM,KAAK,GAAqB;QAC9B,IAAI,CACF,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,EAAE,CACzB,OAAO,CAAC,KAAK,IAAI,EAAE;YACjB,MAAM,OAAO,CAAC,IAAI,EAAE,CAAA;YACpB,OAAO,CAAC,MAAM,OAAO,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAA;QAC3D,CAAC,CAAC,EACJ;YACE,IAAI,EAAE,YAAY;YAClB,WAAW,EACT,gLAAgL;YAClL,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;gBACf,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;gBACjE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,4CAA4C,CAAC;gBAC7E,GAAG,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iBAAiB,CAAC;aAC7E,CAAC;SACH,CACF;QACD,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE;YACjF,IAAI,EAAE,UAAU;YAChB,WAAW,EAAE,sEAAsE;YACnF,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8CAA8C,CAAC,EAAE,CAAC;SACjH,CAAC;QACF,GAAG,YAAY,CAAC,OAAO,CAAC;KACzB,CAAA;IAED,OAAO,gBAAgB,CAAC;QACtB,IAAI,EAAE,uBAAuB;QAC7B,KAAK;QACL,aAAa,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,GAAG,OAAO,EAAE,aAAa,EAAE,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QACjH,UAAU,EAAE,KAAK,IAAI,EAAE;YACrB,MAAM,OAAO,CAAC,KAAK,EAAE,CAAA;QACvB,CAAC;KACF,CAAC,CAAA;AACJ,CAAC"}

package/dist/integration/langchain/skill-use.d.ts

@@ -0,0 +1,6 @@
+import { createSkillsMiddleware } from 'deepagents';
+import type { Sandbox } from '../../sandbox.js';
+export declare function createSkillUseMiddleware({ sandbox, sources, }: {
+    sandbox: Sandbox;
+    sources: string[];
+}): ReturnType<typeof createSkillsMiddleware>;

package/dist/integration/langchain/skill-use.js

@@ -0,0 +1,5 @@
+import { createSkillsMiddleware } from 'deepagents';
+export function createSkillUseMiddleware({ sandbox, sources, }) {
+    return createSkillsMiddleware({ backend: sandbox, sources });
+}
+//# sourceMappingURL=skill-use.js.map

package/dist/integration/langchain/skill-use.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-use.js","sourceRoot":"","sources":["../../../src/integration/langchain/skill-use.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAA;AAInD,MAAM,UAAU,wBAAwB,CAAC,EACvC,OAAO,EACP,OAAO,GAIR;IACC,OAAO,sBAAsB,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAA;AAC9D,CAAC"}

package/dist/sandbox.d.ts

@@ -0,0 +1,31 @@
+import { BaseSandbox, type ExecuteResponse, type FileDownloadResponse, type FileUploadResponse } from 'deepagents';
+import type { Browser } from './browser.js';
+import type { BaseClient } from './core/client.js';
+import { type LaunchOptions, type SandboxOptions, type Workspace } from './core/sandbox.js';
+export { ROOT, type LaunchOptions, type SandboxOptions, type Workspace } from './core/sandbox.js';
+export declare class Sandbox extends BaseSandbox {
+    #private;
+    readonly id: string;
+    readonly name: string;
+    readonly envKeys: string[];
+    readonly createdAt: Date;
+    readonly browser: Browser;
+    constructor(client: BaseClient, workspace: Workspace, options?: SandboxOptions);
+    execute(command: string): Promise<ExecuteResponse>;
+    uploadFiles(files: Array<[string, Uint8Array]>): Promise<FileUploadResponse[]>;
+    downloadFiles(paths: string[]): Promise<FileDownloadResponse[]>;
+    uploadAsZip(zip: Blob | Uint8Array<ArrayBuffer> | ArrayBuffer, options?: {
+        path?: string;
+    }): Promise<{
+        path: string;
+        files: number;
+    }>;
+    launch(options: LaunchOptions): Promise<{
+        url: string;
+    }>;
+    logs(options?: {
+        tail?: number;
+    }): Promise<string[]>;
+    stop(): Promise<void>;
+    close(): Promise<void>;
+}

package/dist/sandbox.js

@@ -0,0 +1,46 @@
+import { BaseSandbox, } from 'deepagents';
+import { Sandbox as CoreSandbox } from './core/sandbox.js';
+export { ROOT } from './core/sandbox.js';
+// deepagents' BaseSandbox over the client entry's Sandbox, which holds the calls
+export class Sandbox extends BaseSandbox {
+    id;
+    name;
+    envKeys;
+    createdAt;
+    browser;
+    #sandbox;
+    constructor(client, workspace, options = {}) {
+        super();
+        this.#sandbox = new CoreSandbox(client, workspace, options);
+        this.id = this.#sandbox.id;
+        this.name = this.#sandbox.name;
+        this.envKeys = this.#sandbox.envKeys;
+        this.createdAt = this.#sandbox.createdAt;
+        this.browser = this.#sandbox.browser;
+    }
+    execute(command) {
+        return this.#sandbox.execute(command);
+    }
+    uploadFiles(files) {
+        return this.#sandbox.uploadFiles(files);
+    }
+    downloadFiles(paths) {
+        return this.#sandbox.downloadFiles(paths);
+    }
+    uploadAsZip(zip, options = {}) {
+        return this.#sandbox.uploadAsZip(zip, options);
+    }
+    launch(options) {
+        return this.#sandbox.launch(options);
+    }
+    logs(options = {}) {
+        return this.#sandbox.logs(options);
+    }
+    stop() {
+        return this.#sandbox.stop();
+    }
+    close() {
+        return this.#sandbox.close();
+    }
+}
+//# sourceMappingURL=sandbox.js.map

package/dist/sandbox.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sandbox.js","sourceRoot":"","sources":["../src/sandbox.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,GAIZ,MAAM,YAAY,CAAA;AAInB,OAAO,EAAE,OAAO,IAAI,WAAW,EAA2D,MAAM,mBAAmB,CAAA;AAEnH,OAAO,EAAE,IAAI,EAA2D,MAAM,mBAAmB,CAAA;AAEjG,iFAAiF;AACjF,MAAM,OAAO,OAAQ,SAAQ,WAAW;IAC7B,EAAE,CAAQ;IACV,IAAI,CAAQ;IACZ,OAAO,CAAU;IACjB,SAAS,CAAM;IACf,OAAO,CAAS;IAChB,QAAQ,CAAa;IAE9B,YAAY,MAAkB,EAAE,SAAoB,EAAE,OAAO,GAAmB,EAAE;QAChF,KAAK,EAAE,CAAA;QACP,IAAI,CAAC,QAAQ,GAAG,IAAI,WAAW,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,CAAA;QAC3D,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAA;QAC1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAA;QAC9B,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAA;QACpC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAA;QACxC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAA;IACtC,CAAC;IAED,OAAO,CAAC,OAAe;QACrB,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;IACvC,CAAC;IAED,WAAW,CAAC,KAAkC;QAC5C,OAAO,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,KAAK,CAAC,CAAA;IACzC,CAAC;IAED,aAAa,CAAC,KAAe;QAC3B,OAAO,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,CAAA;IAC3C,CAAC;IAED,WAAW,CACT,GAAiD,EACjD,OAAO,GAAsB,EAAE;QAE/B,OAAO,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,GAAG,EAAE,OAAO,CAAC,CAAA;IAChD,CAAC;IAED,MAAM,CAAC,OAAsB;QAC3B,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;IACtC,CAAC;IAED,IAAI,CAAC,OAAO,GAAsB,EAAE;QAClC,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IACpC,CAAC;IAED,IAAI;QACF,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAA;IAC7B,CAAC;IAED,KAAK;QACH,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAA;IAC9B,CAAC;CACF"}