tpmjs/packages/tools/official/sprites-delete
Ajax Davis 4e3cb78ba4 feat(sprites): add SPRITES_TOKEN env requirement to package metadata
All sprites tools require a SPRITES_TOKEN to authenticate with sprites.dev.
This adds the env field to the tpmjs metadata so Omega can warn users
about missing API keys.
2026-01-25 12:23:43 +10:00
..
src refactor: replace exportName with name throughout codebase 2026-01-14 14:18:36 +10:00
CHANGELOG.md feat(sprites): add SPRITES_TOKEN env requirement to package metadata 2026-01-25 12:23:43 +10:00
package.json feat(sprites): add SPRITES_TOKEN env requirement to package metadata 2026-01-25 12:23:43 +10:00
README.md feat: add READMEs to sprites packages and fix blocks.yml schema 2026-01-14 16:22:39 +10:00
tsconfig.json refactor: replace exportName with name throughout codebase 2026-01-14 14:18:36 +10:00
tsup.config.ts refactor: replace exportName with name throughout codebase 2026-01-14 14:18:36 +10:00

@tpmjs/sprites-delete

Delete a sprite and all its associated data including checkpoints.

Installation

npm install @tpmjs/sprites-delete

Requirements

Usage

import { spritesDeleteTool } from '@tpmjs/sprites-delete';

const result = await spritesDeleteTool.execute({
  name: 'my-sandbox'
});

console.log(result);
// {
//   deleted: true,
//   name: 'my-sandbox'
// }

Input Parameters

Parameter Type Required Description
name string Yes Name of the sprite to delete

Output

Field Type Description
deleted boolean Whether deletion was successful
name string Name of the deleted sprite

Warning

This action is irreversible. All data associated with the sprite, including:

  • Filesystem contents
  • All checkpoints
  • Execution history

will be permanently deleted.

Error Handling

The tool throws errors in these cases:

  • SPRITES_TOKEN environment variable is not set
  • Sprite not found (HTTP 404)
  • Invalid or expired API token (HTTP 401)
  • Network timeout (30 second limit)
  • API errors with descriptive messages

License

MIT