@agent-relay/sandbox 0.0.0 → 0.1.1

package/README.md

@@ -53,10 +53,14 @@ Requires Node.js 20 or newer.
 
 ## Releasing
 
-Publishing is manual-dispatch only, via the `Publish` workflow. It defaults to a
-dry run and requires an `NPM_TOKEN` secret configured by the repository owner
-before a real publish will run. Nothing publishes automatically on push or
-merge.
+Publishing is manual-dispatch only, via the `Publish` workflow, and defaults to
+a dry run. Nothing publishes automatically on push or merge.
+
+Authentication is npm OIDC trusted publishing — there is no publish token to
+store. A real publish requires the repository owner to register this repository
+and workflow as a trusted publisher for the package on npmjs.org; releases carry
+[provenance](https://docs.npmjs.com/generating-provenance-statements) attesting
+the commit and workflow they were built from.
 
 ## License
 

package/dist/daytona/runtime.d.ts

@@ -0,0 +1,118 @@
+import type { Daytona, Sandbox } from '@daytonaio/sdk';
+import type { ExecOptions, ExecResult, AsyncExecStartResult, AsyncExecStatus, LaunchOptions, RuntimeCapabilities, RuntimeHandle, WorkflowRuntime } from '../types.js';
+export interface DaytonaRuntimeOptions {
+    daytona: Daytona;
+    snapshot?: string;
+    /**
+     * Home directory inside the sandbox image. Required: it is image-specific,
+     * so there is no default that is correct for every consumer.
+     */
+    defaultHomeDir: string;
+}
+export declare class SnapshotNotFoundError extends Error {
+    readonly snapshot: string;
+    constructor(snapshot: string, cause?: unknown);
+}
+export interface DaytonaAttachedSandboxOptions {
+    homeDir?: string;
+    workdir?: string;
+    owned?: boolean;
+    states?: readonly string[] | null;
+}
+export interface DaytonaFindByLabelsOptions extends DaytonaAttachedSandboxOptions {
+    states?: readonly string[] | null;
+    limit?: number;
+    /** @deprecated Use limit. */
+    pageSize?: number;
+    /** Sandbox IDs to skip before performing the per-ID rehydration request. */
+    excludeIds?: readonly string[];
+    /** Total deadline for listing, rehydration, and home-directory resolution. */
+    timeoutMs?: number;
+}
+export interface DaytonaCountByLabelsOptions {
+    states?: readonly string[] | null;
+    limit?: number;
+    /** @deprecated Use limit. */
+    pageSize?: number;
+    /** Stop counting once this total is reached. */
+    maxCount?: number;
+    /** Total deadline for cursor iteration. */
+    timeoutMs?: number;
+}
+export interface DaytonaRunScriptOptions extends ExecOptions {
+    command: string;
+    sessionId?: string;
+    useSession?: boolean;
+    suppressInputEcho?: boolean;
+}
+export interface DaytonaRunScriptResult {
+    output: string;
+    stdout?: string;
+    stderr?: string;
+    exitCode: number | null;
+    cmdId?: string;
+}
+export interface DaytonaBundleFile {
+    source: string | Buffer;
+    destination: string;
+}
+export interface DaytonaUploadBundleOptions {
+    files: DaytonaBundleFile[];
+    manifest?: unknown;
+    manifestPath?: string;
+}
+export declare class DaytonaRuntime implements WorkflowRuntime {
+    readonly id = "daytona";
+    readonly capabilities: RuntimeCapabilities;
+    private readonly sandboxes;
+    private readonly daytona;
+    private readonly snapshot?;
+    private readonly defaultHomeDir;
+    constructor(options: DaytonaRuntimeOptions);
+    launch(options?: LaunchOptions): Promise<RuntimeHandle>;
+    launchDetached(options?: LaunchOptions): Promise<RuntimeHandle>;
+    getById(id: string, options?: DaytonaAttachedSandboxOptions): Promise<RuntimeHandle | null>;
+    findByLabels(labels: Record<string, string>, options?: DaytonaFindByLabelsOptions): Promise<RuntimeHandle | null>;
+    countByLabels(labels: Record<string, string>, options?: DaytonaCountByLabelsOptions): Promise<number>;
+    findAllByLabels(labels: Record<string, string>, options?: DaytonaFindByLabelsOptions): Promise<RuntimeHandle[]>;
+    attachSandbox(sandbox: Sandbox, options?: DaytonaAttachedSandboxOptions): RuntimeHandle;
+    exec(handle: RuntimeHandle, command: string, options?: ExecOptions): Promise<ExecResult>;
+    runScript(handle: RuntimeHandle, options: DaytonaRunScriptOptions): Promise<DaytonaRunScriptResult>;
+    startScript(handle: RuntimeHandle, options: DaytonaRunScriptOptions): Promise<AsyncExecStartResult>;
+    getScriptStatus(handle: RuntimeHandle, sessionId: string, commandId: string): Promise<AsyncExecStatus>;
+    getScriptLogs(handle: RuntimeHandle, sessionId: string, commandId: string): Promise<DaytonaRunScriptResult>;
+    startExec(handle: RuntimeHandle, command: string, options?: ExecOptions & {
+        sessionId?: string;
+    }): Promise<AsyncExecStartResult>;
+    getExecStatus(handle: RuntimeHandle, sessionId: string, commandId: string): Promise<AsyncExecStatus>;
+    getExecLogs(handle: RuntimeHandle, sessionId: string, commandId: string): Promise<ExecResult>;
+    uploadFile(handle: RuntimeHandle, source: string | Buffer, destination: string): Promise<void>;
+    uploadBundle(handle: RuntimeHandle, options: DaytonaUploadBundleOptions): Promise<void>;
+    downloadFile(handle: RuntimeHandle, source: string, destination?: string): Promise<Buffer | void>;
+    getHomeDir(handle: RuntimeHandle): Promise<string>;
+    destroy(handle: RuntimeHandle): Promise<void>;
+    stop(handle: RuntimeHandle): Promise<void>;
+    start(handle: RuntimeHandle): Promise<RuntimeHandle>;
+    private createSandbox;
+    private createSandboxDetached;
+    private buildCreateParams;
+    private buildCreateOptions;
+    private createWithOptions;
+    private createDetachedWithOptions;
+    private listSandboxes;
+    private registerSandbox;
+    private requireSandbox;
+    private supportsSessionExec;
+    private buildScriptCommand;
+    private scriptLogPath;
+    private scriptStatusPath;
+    private matchesState;
+    private readSandboxState;
+    private uploadParentDirectories;
+    private uploadDestinations;
+    private ensureUploadParentDirectories;
+    private verifyUploadedBundleFiles;
+    private resolveHomeDir;
+    private msToSeconds;
+}
+//# sourceMappingURL=runtime.d.ts.map

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

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