@tpmjs/tools-sprites-checkpoint-create 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+import * as ai from 'ai';
+
+/**
+ * Sprites Checkpoint Create Tool for TPMJS
+ * Creates a point-in-time snapshot of a sprite's filesystem state for later restoration.
+ *
+ * @requires SPRITES_TOKEN environment variable
+ */
+interface Checkpoint {
+    id: string;
+    name?: string;
+    createdAt: string;
+    size?: number;
+}
+type SpritesCheckpointCreateInput = {
+    name: string;
+    checkpointName?: string;
+};
+declare const spritesCheckpointCreateTool: ai.Tool<SpritesCheckpointCreateInput, Checkpoint>;
+
+export { type Checkpoint, spritesCheckpointCreateTool as default, spritesCheckpointCreateTool };

package/dist/index.js

@@ -0,0 +1,95 @@
+import { tool, jsonSchema } from 'ai';
+
+// src/index.ts
+var SPRITES_API_BASE = "https://api.sprites.dev/v1";
+function getSpritesToken() {
+  const token = process.env.SPRITES_TOKEN;
+  if (!token) {
+    throw new Error(
+      "SPRITES_TOKEN environment variable is required. Get your token from https://sprites.dev"
+    );
+  }
+  return token;
+}
+var spritesCheckpointCreateTool = tool({
+  description: "Create a point-in-time snapshot (checkpoint) of a sprite's filesystem state for later restoration. Useful for saving state before risky operations.",
+  inputSchema: jsonSchema({
+    type: "object",
+    properties: {
+      name: {
+        type: "string",
+        description: "Name of the sprite to checkpoint"
+      },
+      checkpointName: {
+        type: "string",
+        description: "Optional human-readable name for the checkpoint"
+      }
+    },
+    required: ["name"],
+    additionalProperties: false
+  }),
+  async execute({ name, checkpointName }) {
+    if (!name || typeof name !== "string") {
+      throw new Error("Sprite name is required and must be a string");
+    }
+    const token = getSpritesToken();
+    let response;
+    try {
+      const controller = new AbortController();
+      const timeoutId = setTimeout(() => controller.abort(), 12e4);
+      const body = {};
+      if (checkpointName) {
+        body.name = checkpointName;
+      }
+      response = await fetch(
+        `${SPRITES_API_BASE}/sprites/${encodeURIComponent(name)}/checkpoints`,
+        {
+          method: "POST",
+          headers: {
+            Authorization: `Bearer ${token}`,
+            "Content-Type": "application/json",
+            "User-Agent": "TPMJS/1.0"
+          },
+          body: JSON.stringify(body),
+          signal: controller.signal
+        }
+      );
+      clearTimeout(timeoutId);
+    } catch (error) {
+      if (error instanceof Error) {
+        if (error.name === "AbortError") {
+          throw new Error(`Request to create checkpoint for sprite "${name}" timed out`);
+        }
+        throw new Error(`Failed to create checkpoint for sprite "${name}": ${error.message}`);
+      }
+      throw new Error(`Failed to create checkpoint for sprite "${name}": Unknown network error`);
+    }
+    if (!response.ok) {
+      if (response.status === 404) {
+        throw new Error(`Sprite "${name}" not found`);
+      }
+      if (response.status === 401) {
+        throw new Error("Invalid SPRITES_TOKEN. Check your API token at https://sprites.dev");
+      }
+      const errorText = await response.text().catch(() => "Unknown error");
+      throw new Error(
+        `Failed to create checkpoint for sprite "${name}": HTTP ${response.status} - ${errorText}`
+      );
+    }
+    let data;
+    try {
+      data = await response.json();
+    } catch {
+      throw new Error("Failed to parse response from Sprites API");
+    }
+    return {
+      id: data.id || "",
+      name: data.name || checkpointName,
+      createdAt: data.createdAt || data.created_at || (/* @__PURE__ */ new Date()).toISOString(),
+      size: data.size
+    };
+  }
+});
+var index_default = spritesCheckpointCreateTool;
+
+export { index_default as default, spritesCheckpointCreateTool };

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@tpmjs/tools-sprites-checkpoint-create",
+  "version": "0.1.0",
+  "description": "Create a point-in-time snapshot of a sprite's filesystem state for later restoration",
+  "type": "module",
+  "keywords": ["tpmjs", "sprites", "sandbox", "checkpoint", "snapshot", "ai"],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": ["dist"],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "type-check": "tsc --noEmit",
+    "clean": "rm -rf dist .turbo"
+  },
+  "devDependencies": {
+    "@tpmjs/tsconfig": "workspace:*",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3"
+  },
+  "publishConfig": { "access": "public" },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/anthropics/tpmjs.git",
+    "directory": "packages/tools/official/sprites-checkpoint-create"
+  },
+  "homepage": "https://tpmjs.com",
+  "license": "MIT",
+  "tpmjs": {
+    "category": "sandbox",
+    "frameworks": ["vercel-ai"],
+    "tools": [{
+      "name": "spritesCheckpointCreateTool",
+      "description": "Create a point-in-time snapshot of a sprite's filesystem state for later restoration",
+      "parameters": [
+        { "name": "name", "type": "string", "description": "Name of the sprite to checkpoint", "required": true },
+        { "name": "checkpointName", "type": "string", "description": "Optional name for the checkpoint", "required": false }
+      ],
+      "returns": {
+        "type": "Checkpoint",
+        "description": "Created checkpoint with ID and metadata"
+      }
+    }]
+  },
+  "dependencies": { "ai": "6.0.23" }
+}