Build errors

Wrap Template.build when your application needs to report a reason, retry an upload, or stop the current job.

mjs

import { BuildError, FileUploadError, Template } from "@abox-dev/sdk";

const templateName = process.env.TEMPLATE_NAME ?? "failing-template";
const template = Template().fromBaseImage().runCmd("exit 23");

try {
  await Template.build(template, templateName);
} catch (error) {
  if (error instanceof FileUploadError) {
    console.error(`Could not upload build files: ${error.message}`);
  } else if (error instanceof BuildError) {
    console.error(`Template build failed: ${error.message}`);
  } else {
    throw error;
  }
}

import os

from agentbox import BuildException, FileUploadException, Template


template_name = os.getenv("TEMPLATE_NAME", "failing-template")
template = Template().from_base_image().run_cmd("exit 23")

try:
    Template.build(template, template_name)
except FileUploadException as error:
    print(f"Could not upload build files: {error}")
except BuildException as error:
    print(f"Template build failed: {error}")

package main

import (
	"context"
	"errors"
	"fmt"
	"log"
	"os"

	"github.com/abox-dev/sdk/packages/go-sdk"
)

func kill(sandbox *agentbox.Sandbox) {
	if _, err := sandbox.Kill(context.Background()); err != nil {
		log.Printf("cleanup sandbox: %v", err)
	}
}

func run() (err error) {
	ctx := context.Background()
	client, err := agentbox.NewClient()
	if err != nil {
		return err
	}
	name := os.Getenv("TEMPLATE_NAME")
	if name == "" {
		name = "failing-template"
	}
	_, err = client.Templates.Build(ctx, agentbox.NewTemplate("").
		FromBase().
		Run("exit 23"), name, nil)
	var uploadError *agentbox.FileUploadError
	var buildError *agentbox.BuildError
	switch {
	case errors.As(err, &uploadError):
		fmt.Println("Could not upload build files:", uploadError)
	case errors.As(err, &buildError):
		fmt.Println("Template build failed:", buildError)
	case err != nil:
		return err
	}
	return nil
}

func main() {
	if err := run(); err != nil {
		log.Fatal(err)
	}
}

FileUploadError in JavaScript, FileUploadException in Python, and *agentbox.FileUploadError in Go cover files sent by copy. Handle these specific failures first; Go selects them with errors.As.

BuildError, BuildException, and *agentbox.BuildError mean the builder could not execute an instruction or complete the template. The message contains the available reason, while build logs identify the failing step.

Invalid API keys raise AuthenticationError in JavaScript, AuthenticationException in Python, and *agentbox.AuthenticationError in Go. Do not retry with the same key automatically; replace or correct the key first.

Build errors ​

Build errors