Method create

packages/ai-sandbox-sprites/src/provider.ts:90–127

(input: SandboxCreateInput)

  }

  async create(input: SandboxCreateInput): Promise<SandboxHandle> {
    // Honor the deterministic id ensure() supplies (see SandboxCreateInput.id).
    // The sprite's preview URL is keyed by name, so a random name would strand
    // an out-of-band reconnect (a preview iframe) on a different sprite than the
    // one the agent edits. Fall back to a random name for direct/advanced use.
    const name =
      input.id ??
      `${NAME_PREFIX}-${randomUUID().replace(/-/g, '').slice(0, 12)}`
    const sprite = await this.client.createSprite(name, {
      ...(this.config.waitForCapacity !== undefined
        ? { waitForCapacity: this.config.waitForCapacity }
        : {}),
      ...(input.signal ? { signal: input.signal } : {}),
    })

    if (sprite.urlAuth !== this.urlAuth) {
      await this.client.setUrlAuth(sprite.name, this.urlAuth, input.signal)
    }

    // Ensure the workspace dir exists before any cwd-bound command runs in it.
    // Run from `/` (not the workdir, which does not exist yet) so the exec's own
    // cwd resolution does not fail for a non-default `workdir`.
    const mkdir = this.client.exec(sprite.name, {
      argv: ['mkdir', '-p', this.workdir],
      cwd: '/',
      ...(input.signal ? { signal: input.signal } : {}),
    })
    const code = await mkdir.wait()
    if (code !== 0) {
      throw new Error(
        `Sprites: failed to create workspace directory "${this.workdir}" (exit ${code}).`,
      )
    }

    const handle = this.handle(sprite)
    if (input.env) await handle.env.set(input.env)
    return handle
  }

  async resume(input: SandboxResumeInput): Promise<SandboxHandle | null> {
    try {