evOo-local/packages/adapters/src/fake-sandbox.ts

import type {
  AdapterContext,
  CommandRequest,
  ComputerActionRequest,
  ComputerFileEntry,
  ComputerInput,
  ComputerRef,
  ControlLeaseRef,
  PortableFile,
  ProcessEvent,
  SandboxProvider,
  ScreenRequest,
  ScreenSession,
} from "@rakazo/adapter-kit";
import { canReleaseScreenLease, canTakeScreenLease } from "@rakazo/core";
import { ComputerScreenUnavailableError, screenSessionKey } from "./computer-screens.js";
import {
  applyPlaceholderAction,
  boundedComputerActions,
  normalizeWorkspacePath,
  placeholderObservation,
} from "./computer-support.js";

export interface FakeBox {
  ref: ComputerRef;
  files: Map<string, { content: Uint8Array; executable: boolean }>;
  running: boolean;
  screens: Map<string, string>;
  screenLeases: Map<string, string>;
}

export class FakeSandboxProvider implements SandboxProvider {
  readonly boxes = new Map<string, FakeBox>();

  describe() {
    return {
      id: "fake",
      contractVersion: "1",
      adapterVersion: "0.1.0",
      capabilities: {
        graphical: true,
        pty: true,
        snapshots: true,
        takeover: true,
        persistentHome: true,
        multiScreen: true,
      },
    };
  }

  async provision(
    request: { botId: string; homePath: string },
    _context: AdapterContext,
  ): Promise<ComputerRef> {
    const id = `fake-${request.botId}`;
    const existing = this.boxes.get(id);
    if (existing) {
      existing.running = true;
      return { ...existing.ref, fresh: false };
    }
    const ref: ComputerRef = {
      id,
      botId: request.botId,
      kind: "fake",
      providerRef: id,
      fresh: true,
    };
    this.boxes.set(ref.id, {
      ref,
      files: new Map(),
      running: true,
      screens: new Map([["default", "ready"]]),
      screenLeases: new Map(),
    });
    return ref;
  }

  async prepare(_computer: ComputerRef, _context: AdapterContext): Promise<void> {}

  async *execute(
    computer: ComputerRef,
    request: CommandRequest,
    _context: AdapterContext,
  ): AsyncIterable<ProcessEvent> {
    const box = this.boxes.get(computer.id);
    if (!box) {
      yield { type: "stderr", data: "computer not found" };
      yield { type: "exit", code: 1 };
      return;
    }
    const cmd = request.argv.join(" ");
    if (request.argv[0] === "echo") {
      yield { type: "stdout", data: `${request.argv.slice(1).join(" ")}\n` };
    } else if (cmd.startsWith("cat ")) {
      const file = normalizeWorkspacePath(request.argv[1] ?? "");
      const stored = box.files.get(file);
      yield { type: "stdout", data: stored ? new TextDecoder().decode(stored.content) : "" };
    } else {
      yield { type: "stdout", data: `ran ${cmd}\n` };
    }
    yield { type: "exit", code: 0 };
  }

  async inspectBackgroundWork(
    _computer: ComputerRef,
    _markerId: string,
    _context: AdapterContext,
  ): Promise<"idle"> {
    return "idle";
  }

  async connectScreen(
    computer: ComputerRef,
    _request: ScreenRequest,
    context: AdapterContext,
  ): Promise<ScreenSession> {
    const key = screenSessionKey(context);
    this.screenSlot(this.requiredBox(computer), key, context.screenLeaseId);
    return {
      url: `fake://screen/${computer.id}/${key}`,
      mimeType: "text/plain",
      close: async () => undefined,
    };
  }

  async sendInput(
    computer: ComputerRef,
    input: ComputerInput,
    _lease: ControlLeaseRef,
    context: AdapterContext,
  ): Promise<void> {
    const box = this.boxes.get(computer.id);
    if (box) {
      applyPlaceholderAction(
        this.screenSlot(box, screenSessionKey(context), context.screenLeaseId),
        input,
      );
    }
  }

  async observe(computer: ComputerRef, context: AdapterContext) {
    const key = screenSessionKey(context);
    return placeholderObservation(
      this.screenSlot(this.requiredBox(computer), key, context.screenLeaseId).screen,
    );
  }

  async act(computer: ComputerRef, request: ComputerActionRequest, context: AdapterContext) {
    const box = this.requiredBox(computer);
    const slot = this.screenSlot(box, screenSessionKey(context), context.screenLeaseId);
    const actions = boundedComputerActions(request.actions);
    for (const action of actions) applyPlaceholderAction(slot, action);
    return {
      completed: actions.length,
      ...(request.observe === false ? {} : { observation: await this.observe(computer, context) }),
    };
  }

  async listFiles(
    computer: ComputerRef,
    directory: string,
    _context: AdapterContext,
  ): Promise<ComputerFileEntry[]> {
    const box = this.requiredBox(computer);
    const normalized = normalizeWorkspacePath(directory);
    const prefix = normalized ? `${normalized}/` : "";
    const entries = new Map<string, ComputerFileEntry>();
    for (const [filePath, file] of box.files) {
      if (!filePath.startsWith(prefix)) continue;
      const remainder = filePath.slice(prefix.length);
      const [name, ...rest] = remainder.split("/");
      if (!name) continue;
      const listedPath = prefix + name;
      entries.set(listedPath, {
        path: listedPath,
        kind: rest.length ? "dir" : "file",
        size: rest.length ? 0 : file.content.byteLength,
        ...(!rest.length && file.executable ? { executable: true } : {}),
      });
    }
    return [...entries.values()].sort((a, b) => a.path.localeCompare(b.path));
  }

  async readFile(
    computer: ComputerRef,
    filePath: string,
    _context: AdapterContext,
    options?: { maxBytes?: number },
  ) {
    const file = this.requiredBox(computer).files.get(normalizeWorkspacePath(filePath));
    if (!file) throw new Error("computer file not found");
    if (options?.maxBytes !== undefined && file.content.byteLength > options.maxBytes) {
      throw new Error(`computer file exceeds ${options.maxBytes} bytes`);
    }
    return new Uint8Array(file.content);
  }

  async writeFile(computer: ComputerRef, file: PortableFile, _context: AdapterContext) {
    this.requiredBox(computer).files.set(normalizeWorkspacePath(file.path), {
      content: new Uint8Array(file.content),
      executable: file.executable === true,
    });
  }

  async *exportWorkspace(
    computer: ComputerRef,
    _context: AdapterContext,
  ): AsyncIterable<PortableFile> {
    for (const [filePath, file] of [...this.requiredBox(computer).files].sort(([a], [b]) =>
      a.localeCompare(b),
    )) {
      yield {
        path: filePath,
        content: new Uint8Array(file.content),
        executable: file.executable,
      };
    }
  }

  async importWorkspace(
    computer: ComputerRef,
    files: AsyncIterable<PortableFile>,
    _context: AdapterContext,
  ) {
    const box = this.requiredBox(computer);
    for await (const file of files) {
      box.files.set(normalizeWorkspacePath(file.path), {
        content: new Uint8Array(file.content),
        executable: file.executable === true,
      });
    }
  }

  async snapshot(computer: ComputerRef, _context: AdapterContext) {
    return { id: `snap-${computer.id}`, createdAt: new Date().toISOString() };
  }

  async releaseScreen(computer: ComputerRef, context: AdapterContext): Promise<void> {
    const box = this.boxes.get(computer.id);
    if (!box) return;
    const key = screenSessionKey(context);
    const leaseId = box.screenLeases.get(key);
    if (context.screenLeaseId && !canReleaseScreenLease(leaseId, context.screenLeaseId)) return;
    box.screens.delete(key);
    box.screenLeases.delete(key);
  }

  async stop(computer: ComputerRef, _context: AdapterContext): Promise<void> {
    const box = this.boxes.get(computer.id);
    if (box) box.running = false;
  }

  async destroy(computer: ComputerRef, _context: AdapterContext): Promise<void> {
    this.boxes.delete(computer.id);
  }

  private requiredBox(computer: ComputerRef): FakeBox {
    const box = this.boxes.get(computer.id);
    if (!box) throw new Error("computer not found");
    return box;
  }

  private screenSlot(box: FakeBox, key: string, leaseId?: string): { screen: string } {
    if (!box.screens.has(key)) box.screens.set(key, `ready:${key}`);
    const current = box.screenLeases.get(key);
    if (leaseId && current && leaseId !== current && !canTakeScreenLease(current, leaseId)) {
      throw new ComputerScreenUnavailableError();
    }
    if (leaseId && canTakeScreenLease(current, leaseId)) box.screenLeases.set(key, leaseId);
    return {
      get screen() {
        return box.screens.get(key) ?? `ready:${key}`;
      },
      set screen(value: string) {
        box.screens.set(key, value);
      },
    };
  }
}