@hasna/sandboxes 0.1.23 → 0.1.24

package/dist/providers/daytona.d.ts

@@ -1,4 +1,4 @@
-import type { ExecResult, ExecHandle, FileInfo } from "../types/index.js";
+import type { ExecResult, ExecHandle, FileInfo, UploadDirOptions, UploadDirResult } from "../types/index.js";
 import type { SandboxProvider, ProviderSandbox, CreateSandboxOpts, ExecOptions } from "./types.js";
 export declare class DaytonaProvider implements SandboxProvider {
     readonly name = "daytona";
@@ -10,6 +10,7 @@ export declare class DaytonaProvider implements SandboxProvider {
     readFile(sandboxId: string, path: string): Promise<string>;
     writeFile(sandboxId: string, path: string, content: string): Promise<void>;
     listFiles(sandboxId: string, path: string): Promise<FileInfo[]>;
+    uploadDir(sandboxId: string, localDir: string, remoteDir: string, opts?: UploadDirOptions): Promise<UploadDirResult>;
     stop(sandboxId: string): Promise<void>;
     delete(sandboxId: string): Promise<void>;
     getPublicUrl(_sandboxId: string, _port: number, _protocol?: string): Promise<string>;
@@ -17,4 +18,3 @@ export declare class DaytonaProvider implements SandboxProvider {
     resume(_sandboxId: string): Promise<void>;
     keepAlive(sandboxId: string, durationMs?: number): Promise<void>;
 }
-//# sourceMappingURL=daytona.d.ts.map

package/dist/providers/e2b.d.ts

@@ -1,4 +1,4 @@
-import type { ExecResult, ExecHandle, FileInfo } from "../types/index.js";
+import type { ExecResult, ExecHandle, FileInfo, UploadDirOptions, UploadDirResult } from "../types/index.js";
 import type { SandboxProvider, ProviderSandbox, CreateSandboxOpts, ExecOptions } from "./types.js";
 export declare class E2BProvider implements SandboxProvider {
     readonly name = "e2b";
@@ -17,6 +17,7 @@ export declare class E2BProvider implements SandboxProvider {
         recursive?: boolean;
         glob?: string;
     }): Promise<FileInfo[]>;
+    uploadDir(sandboxId: string, localDir: string, remoteDir: string, opts?: UploadDirOptions): Promise<UploadDirResult>;
     stop(sandboxId: string): Promise<void>;
     delete(sandboxId: string): Promise<void>;
     pause(sandboxId: string): Promise<void>;
@@ -24,4 +25,3 @@ export declare class E2BProvider implements SandboxProvider {
     getPublicUrl(sandboxId: string, port: number, _protocol?: string): Promise<string>;
     keepAlive(sandboxId: string, durationMs?: number): Promise<void>;
 }
-//# sourceMappingURL=e2b.d.ts.map

package/dist/providers/index.d.ts

@@ -2,4 +2,3 @@ import type { SandboxProviderName } from "../types/index.js";
 import type { SandboxProvider } from "./types.js";
 export declare function getProvider(name: SandboxProviderName, apiKey?: string): Promise<SandboxProvider>;
 export { type SandboxProvider } from "./types.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/providers/modal.d.ts

@@ -1,4 +1,4 @@
-import type { ExecResult, ExecHandle, FileInfo } from "../types/index.js";
+import type { ExecResult, ExecHandle, FileInfo, UploadDirOptions, UploadDirResult } from "../types/index.js";
 import type { SandboxProvider, ProviderSandbox, CreateSandboxOpts, ExecOptions } from "./types.js";
 export declare class ModalProvider implements SandboxProvider {
     readonly name = "modal";
@@ -13,6 +13,7 @@ export declare class ModalProvider implements SandboxProvider {
     readFile(sandboxId: string, path: string): Promise<string>;
     writeFile(sandboxId: string, path: string, content: string): Promise<void>;
     listFiles(sandboxId: string, path: string): Promise<FileInfo[]>;
+    uploadDir(sandboxId: string, localDir: string, remoteDir: string, opts?: UploadDirOptions): Promise<UploadDirResult>;
     stop(sandboxId: string): Promise<void>;
     delete(sandboxId: string): Promise<void>;
     getPublicUrl(_sandboxId: string, _port: number, _protocol?: string): Promise<string>;
@@ -28,4 +29,3 @@ export declare class ModalProvider implements SandboxProvider {
      */
     private shellEscape;
 }
-//# sourceMappingURL=modal.d.ts.map

package/dist/providers/types.d.ts

@@ -1,4 +1,4 @@
-import type { ExecResult, ExecHandle, FileInfo } from "../types/index.js";
+import type { ExecResult, ExecHandle, FileInfo, UploadDirOptions, UploadDirResult } from "../types/index.js";
 export interface CreateSandboxOpts {
     image?: string;
     timeout?: number;
@@ -34,6 +34,8 @@ export interface SandboxProvider {
         recursive?: boolean;
         glob?: string;
     }): Promise<FileInfo[]>;
+    /** Upload a local directory tree into the sandbox at `remoteDir`, fast (single archive), without a git clone. */
+    uploadDir(sandboxId: string, localDir: string, remoteDir: string, opts?: UploadDirOptions): Promise<UploadDirResult>;
     stop(sandboxId: string): Promise<void>;
     delete(sandboxId: string): Promise<void>;
     keepAlive(sandboxId: string, durationMs?: number): Promise<void>;
@@ -41,4 +43,3 @@ export interface SandboxProvider {
     resume(sandboxId: string): Promise<void>;
     getPublicUrl(sandboxId: string, port: number, protocol?: string): Promise<string>;
 }
-//# sourceMappingURL=types.d.ts.map

package/dist/sdk.d.ts

@@ -0,0 +1,65 @@
+import { listSandboxes } from "./db/sandboxes.js";
+import { listEvents } from "./db/events.js";
+import type { SandboxProvider } from "./providers/types.js";
+import type { ExecOptions } from "./providers/types.js";
+import type { SecretMapping, SecretResolver } from "./lib/secrets.js";
+import type { AgentType, CreateSandboxInput, ExecResult, FileInfo, Sandbox, SandboxEvent, SandboxProviderName, SandboxSession, UploadDirOptions, UploadDirResult } from "./types/index.js";
+import type { StreamListener } from "./lib/stream.js";
+export type ProviderFactory = (name: SandboxProviderName, apiKey?: string) => Promise<SandboxProvider>;
+export interface SandboxesSDKOptions {
+    defaultProvider?: SandboxProviderName;
+    providerApiKeys?: Partial<Record<SandboxProviderName, string>>;
+    providerFactory?: ProviderFactory;
+}
+export interface ExecCommandResult {
+    session: SandboxSession;
+    result: ExecResult;
+}
+export interface RunAgentOptions {
+    agentType: AgentType;
+    prompt: string;
+    agentName?: string;
+    command?: string;
+    callEnvVars?: Record<string, string>;
+    /** Secrets to resolve from the vault and inject as per-call env vars (never persisted). */
+    secrets?: SecretMapping[];
+    /** Override the secret resolver (defaults to the `secrets` CLI). Useful for tests. */
+    secretResolver?: SecretResolver;
+    onStdout?: (data: string) => void;
+    onStderr?: (data: string) => void;
+}
+export interface WaitForSessionOptions {
+    timeoutMs?: number;
+    pollIntervalMs?: number;
+}
+export declare class SandboxesSDK {
+    private readonly defaultProvider?;
+    private readonly providerApiKeys;
+    private readonly providerFactory;
+    constructor(options?: SandboxesSDKOptions);
+    createSandbox(input?: CreateSandboxInput): Promise<Sandbox>;
+    getSandbox(id: string): Sandbox;
+    listSandboxes(filters?: Parameters<typeof listSandboxes>[0]): Sandbox[];
+    stopSandbox(id: string): Promise<Sandbox>;
+    deleteSandbox(id: string): Promise<void>;
+    execCommand(sandboxId: string, command: string, opts?: ExecOptions): Promise<ExecCommandResult>;
+    readFile(sandboxId: string, path: string, opts?: {
+        encoding?: "utf8" | "base64" | "hex";
+        offset?: number;
+        limit?: number;
+    }): Promise<string>;
+    writeFile(sandboxId: string, path: string, content: string): Promise<void>;
+    listFiles(sandboxId: string, path: string, opts?: {
+        recursive?: boolean;
+        glob?: string;
+    }): Promise<FileInfo[]>;
+    uploadDir(sandboxId: string, localDir: string, remoteDir: string, opts?: UploadDirOptions): Promise<UploadDirResult>;
+    runAgent(sandboxId: string, opts: RunAgentOptions): Promise<SandboxSession>;
+    getSession(sessionId: string): SandboxSession;
+    waitForSession(sessionId: string, opts?: WaitForSessionOptions): Promise<SandboxSession>;
+    listEvents(filters?: Parameters<typeof listEvents>[0]): SandboxEvent[];
+    onSandboxEvent(sandboxId: string, listener: StreamListener): () => void;
+    private getProvider;
+    private requireProviderSandbox;
+}
+export declare function createSandboxesSDK(options?: SandboxesSDKOptions): SandboxesSDK;

package/dist/server/index.d.ts

@@ -1,3 +1,2 @@
 #!/usr/bin/env bun
 export {};
-//# sourceMappingURL=index.d.ts.map