tpmjs/packages/tools/official/sprites-delete
Ajax Davis ce3596ea22 feat: add READMEs to sprites packages and fix blocks.yml schema
- Add README documentation for all 11 sprites packages
- Fix blocks.yml to be compatible with blocks CLI validator
- Add project wrapper and type fields to blocks.yml
- Bump sprites packages to v0.1.2
2026-01-14 16:22:39 +10:00
..
src refactor: replace exportName with name throughout codebase 2026-01-14 14:18:36 +10:00
package.json feat: add READMEs to sprites packages and fix blocks.yml schema 2026-01-14 16:22:39 +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