Class SpritesHandle

packages/ai-sandbox-sprites/src/handle.ts:87–315

}

export class SpritesHandle implements SandboxHandle {
  readonly id: string
  readonly provider = 'sprites'
  readonly workspaceRoot: string
  readonly capabilities = SPRITES_CAPS
  readonly fs: SandboxHandle['fs']
  readonly git: SandboxHandle['git']
  readonly process: SandboxHandle['process']
  readonly ports: SandboxHandle['ports']
  readonly env: SandboxHandle['env']

  private readonly client: SpritesClientLike
  private readonly name: string
  private readonly url: string
  private readonly workdir: string
  private readonly httpPort: number
  private readonly urlAuth: SpriteUrlAuth
  private readonly envVars: Record<string, string> = {}

  constructor(deps: SpritesHandleDeps) {
    this.client = deps.client
    this.name = deps.name
    this.url = deps.url
    this.workdir = deps.workdir
    this.workspaceRoot = deps.workdir
    this.httpPort = deps.httpPort ?? SPRITE_DEFAULT_HTTP_PORT
    this.urlAuth = deps.urlAuth ?? 'public'
    this.id = deps.name

    this.process = {
      exec: (command, opts) => this.exec(command, opts),
      spawn: (command, opts) => this.spawnProcess(command, opts),
    }

    this.fs = {
      read: async (p) =>
        new TextDecoder().decode(
          await this.client.fsRead(this.name, this.abs(p)),
        ),
      readBytes: (p) => this.client.fsRead(this.name, this.abs(p)),
      write: (p, data) =>
        this.client.fsWrite(
          this.name,
          this.abs(p),
          typeof data === 'string' ? new TextEncoder().encode(data) : data,
        ),
      list: async (p) => {
        const entries = await this.client.fsList(this.name, this.abs(p))
        // Native paths are absolute Sprite paths; re-root them under the
        // caller's virtual path so consumers stay provider-agnostic.
        const base = p.replace(/\/$/, '')
        return entries.map((entry) => ({
          name: entry.name,
          path: `${base}/${entry.name}`,
          type: entry.type,
        }))
      },
      mkdir: async (p) => {