@secure-exec/browser 0.0.0-agentos-dylib-base.edaa4a4

package/dist/runtime.d.ts

@@ -0,0 +1,248 @@
+import { createInMemoryFileSystem, InMemoryFileSystem } from "./os-filesystem.js";
+export type StdioChannel = "stdout" | "stderr";
+export type TimingMitigation = "off" | "freeze";
+type BodyLike = unknown;
+export interface VirtualDirEntry {
+    name: string;
+    isDirectory: boolean;
+    isSymbolicLink?: boolean;
+}
+export interface VirtualStat {
+    mode: number;
+    size: number;
+    blocks: number;
+    dev: number;
+    rdev: number;
+    isDirectory: boolean;
+    isSymbolicLink: boolean;
+    atimeMs: number;
+    mtimeMs: number;
+    ctimeMs: number;
+    birthtimeMs: number;
+    ino: number;
+    nlink: number;
+    uid: number;
+    gid: number;
+}
+export interface VirtualFileSystem {
+    readFile(path: string): Promise<Uint8Array>;
+    readTextFile(path: string): Promise<string>;
+    readDir(path: string): Promise<string[]>;
+    readDirWithTypes(path: string): Promise<VirtualDirEntry[]>;
+    writeFile(path: string, content: string | Uint8Array): Promise<void>;
+    createDir(path: string): Promise<void>;
+    mkdir(path: string, options?: {
+        recursive?: boolean;
+    }): Promise<void>;
+    exists(path: string): Promise<boolean>;
+    stat(path: string): Promise<VirtualStat>;
+    removeFile(path: string): Promise<void>;
+    removeDir(path: string): Promise<void>;
+    rename(oldPath: string, newPath: string): Promise<void>;
+    realpath(path: string): Promise<string>;
+    symlink(target: string, linkPath: string): Promise<void>;
+    readlink(path: string): Promise<string>;
+    lstat(path: string): Promise<VirtualStat>;
+    link(oldPath: string, newPath: string): Promise<void>;
+    chmod(path: string, mode: number): Promise<void>;
+    chown(path: string, uid: number, gid: number): Promise<void>;
+    utimes(path: string, atime: number, mtime: number): Promise<void>;
+    truncate(path: string, length: number): Promise<void>;
+    pread(path: string, offset: number, length: number): Promise<Uint8Array>;
+    pwrite(path: string, offset: number, data: Uint8Array): Promise<void>;
+}
+export type PermissionDecision = boolean | {
+    allowed: boolean;
+    reason?: string;
+} | {
+    allow: boolean;
+    reason?: string;
+};
+export type PermissionCheck<T = unknown> = (request: T) => PermissionDecision;
+export interface Permissions {
+    fs?: PermissionCheck<{
+        path: string;
+        operation: string;
+    }>;
+    network?: PermissionCheck<{
+        url?: string;
+        host?: string;
+        port?: number;
+    }>;
+    childProcess?: PermissionCheck<{
+        command: string;
+        args: string[];
+        cwd?: string;
+        env?: Record<string, string>;
+    }>;
+    env?: PermissionCheck<{
+        name: string;
+        value: string;
+    }>;
+}
+export declare const allowAllFs: PermissionCheck;
+export declare const allowAllNetwork: PermissionCheck;
+export declare const allowAllChildProcess: PermissionCheck;
+export declare const allowAllEnv: PermissionCheck;
+export declare const allowAll: Permissions;
+export interface ExecOptions {
+    filePath?: string;
+    env?: Record<string, string>;
+    cwd?: string;
+    stdin?: string;
+    cpuTimeLimitMs?: number;
+    timingMitigation?: TimingMitigation;
+    onStdio?: StdioHook;
+}
+export interface ExecResult {
+    code: number;
+    exitCode?: number;
+    stdout?: string;
+    stderr?: string;
+    errorMessage?: string;
+}
+export interface RunResult<T = unknown> {
+    value?: T;
+    code: number;
+    errorMessage?: string;
+    exports?: T;
+}
+export interface OSConfig {
+    platform?: string;
+    arch?: string;
+    type?: string;
+    release?: string;
+    version?: string;
+    cpuCount?: number;
+    totalmem?: number;
+    freemem?: number;
+    hostname?: string;
+    homedir?: string;
+    tmpdir?: string;
+    machine?: string;
+    user?: string;
+    shell?: string;
+    uid?: number;
+    gid?: number;
+}
+export interface ProcessConfig {
+    cwd?: string;
+    env?: Record<string, string>;
+    argv?: string[];
+    platform?: string;
+    arch?: string;
+    version?: string;
+    pid?: number;
+    ppid?: number;
+    uid?: number;
+    gid?: number;
+    timingMitigation?: TimingMitigation;
+    frozenTimeMs?: number;
+}
+export type StdioEvent = {
+    channel: StdioChannel;
+    message: string;
+};
+export type StdioHook = (event: StdioEvent) => void;
+export interface CommandExecutor {
+    spawn(command: string, args: string[], options?: {
+        cwd?: string;
+        env?: Record<string, string>;
+        onStdout?: (data: Uint8Array) => void;
+        onStderr?: (data: Uint8Array) => void;
+    }): {
+        wait(): Promise<number>;
+        writeStdin(data: Uint8Array | string): void;
+        closeStdin(): void;
+        kill(signal?: number): void;
+    };
+}
+export interface NetworkAdapter {
+    fetch(url: string, options?: {
+        method?: string;
+        headers?: Record<string, string>;
+        body?: BodyLike | null;
+    }): Promise<{
+        ok: boolean;
+        status: number;
+        statusText: string;
+        headers: Record<string, string>;
+        body: string;
+        url: string;
+        redirected: boolean;
+    }>;
+    dnsLookup(hostname: string): Promise<{
+        address?: string;
+        family?: number;
+        error?: string;
+        code?: string;
+    }>;
+    httpRequest(url: string, options?: {
+        method?: string;
+        headers?: Record<string, string>;
+        body?: BodyLike | null;
+    }): Promise<{
+        status: number;
+        statusText: string;
+        headers: Record<string, string>;
+        body: string;
+        url: string;
+    }>;
+}
+export interface SystemDriver {
+    filesystem?: VirtualFileSystem;
+    network?: NetworkAdapter;
+    commandExecutor?: CommandExecutor;
+    permissions?: Permissions;
+    runtime: {
+        process: ProcessConfig;
+        os: OSConfig;
+    };
+}
+export interface RuntimeDriverOptions {
+    system: SystemDriver;
+    runtime: {
+        process: ProcessConfig;
+        os: OSConfig;
+    };
+    memoryLimit?: number;
+    cpuTimeLimitMs?: number;
+    timingMitigation?: TimingMitigation;
+    onStdio?: StdioHook;
+    payloadLimits?: {
+        base64TransferBytes?: number;
+        jsonPayloadBytes?: number;
+    };
+}
+export interface NodeRuntimeDriver {
+    exec(code: string, options?: ExecOptions): Promise<ExecResult>;
+    run<T = unknown>(code: string, filePath?: string): Promise<RunResult<T>>;
+    dispose(): void;
+    terminate?(): Promise<void>;
+}
+export interface NodeRuntimeDriverFactory {
+    createRuntimeDriver(options: RuntimeDriverOptions): NodeRuntimeDriver;
+}
+export declare function permissionAllowed(decision: PermissionDecision | undefined): boolean;
+export declare function filterEnv(env: Record<string, string> | undefined, permissions?: Permissions): Record<string, string>;
+export declare function createEnosysError(operation: string): Error;
+export declare function createFsStub(): VirtualFileSystem;
+export declare function createNetworkStub(): NetworkAdapter;
+export declare function createCommandExecutorStub(): CommandExecutor;
+export declare function wrapCommandExecutor(adapter: CommandExecutor, permissions?: Permissions): CommandExecutor;
+export declare function wrapFileSystem(filesystem: VirtualFileSystem, permissions?: Permissions): VirtualFileSystem;
+export declare function wrapNetworkAdapter(adapter: NetworkAdapter, permissions?: Permissions): NetworkAdapter;
+export declare function mkdir(filesystem: VirtualFileSystem, path: string, options?: {
+    recursive?: boolean;
+} | boolean): Promise<void>;
+export declare function loadFile(path: string, filesystem: VirtualFileSystem): Promise<string | null>;
+export declare function moduleFormat(path: string, filesystem: VirtualFileSystem): Promise<"module" | "commonjs" | "json" | null>;
+export declare function resolveModule(specifier: string, fromPath: string, filesystem: VirtualFileSystem, mode?: "require" | "import"): Promise<string | null>;
+export declare function isESM(code: string, filePath?: string): boolean;
+export declare function transformDynamicImport(code: string): string;
+export declare const POLYFILL_CODE_MAP: Record<string, string>;
+export declare function exposeCustomGlobal(name: string, value: unknown): void;
+export declare function exposeMutableRuntimeStateGlobal(name: string, value: unknown): void;
+export declare function getIsolateRuntimeSource(id: string): string;
+export declare function getRequireSetupCode(): string;
+export { createInMemoryFileSystem, InMemoryFileSystem };