@tpmjs/tools-sprites-url-set 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+import * as ai from 'ai';
+
+/**
+ * Sprites URL Set Tool for TPMJS
+ * Sets the access settings for a sprite URL (public or private).
+ *
+ * @requires SPRITES_TOKEN environment variable
+ */
+interface SpriteUrlResult {
+    url: string;
+    auth: 'sprite' | 'public';
+    name: string;
+    updated: boolean;
+}
+type SpritesUrlSetInput = {
+    name: string;
+    auth: 'sprite' | 'public';
+};
+declare const spritesUrlSetTool: ai.Tool<SpritesUrlSetInput, SpriteUrlResult>;
+
+export { type SpriteUrlResult, spritesUrlSetTool as default, spritesUrlSetTool };

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 spritesUrlSetTool = tool({
+  description: "Set the access settings for a sprite URL. Use 'public' to allow anyone to access the sprite URL (for web servers, APIs, webhooks), or 'sprite' to require authentication. The sprite must have a server listening on port 8080 for the URL to work.",
+  inputSchema: jsonSchema({
+    type: "object",
+    properties: {
+      name: {
+        type: "string",
+        description: "Name of the sprite to update"
+      },
+      auth: {
+        type: "string",
+        enum: ["sprite", "public"],
+        description: "Access mode - 'public' for public access, 'sprite' for authenticated access only"
+      }
+    },
+    required: ["name", "auth"],
+    additionalProperties: false
+  }),
+  async execute({ name, auth }) {
+    if (!name || typeof name !== "string") {
+      throw new Error("Sprite name is required and must be a string");
+    }
+    if (auth !== "sprite" && auth !== "public") {
+      throw new Error("Auth must be 'sprite' or 'public'");
+    }
+    const token = getSpritesToken();
+    let response;
+    try {
+      const controller = new AbortController();
+      const timeoutId = setTimeout(() => controller.abort(), 3e4);
+      response = await fetch(`${SPRITES_API_BASE}/sprites/${encodeURIComponent(name)}`, {
+        method: "PUT",
+        headers: {
+          Authorization: `Bearer ${token}`,
+          "Content-Type": "application/json",
+          "User-Agent": "TPMJS/1.0"
+        },
+        body: JSON.stringify({
+          url_settings: { auth }
+        }),
+        signal: controller.signal
+      });
+      clearTimeout(timeoutId);
+    } catch (error) {
+      if (error instanceof Error) {
+        if (error.name === "AbortError") {
+          throw new Error(`Request to set URL auth for sprite "${name}" timed out`);
+        }
+        throw new Error(`Failed to set URL auth for sprite "${name}": ${error.message}`);
+      }
+      throw new Error(`Failed to set URL auth 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 set URL auth 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");
+    }
+    const urlSettings = data.url_settings;
+    return {
+      url: data.url || "",
+      auth: urlSettings?.auth || auth,
+      name: data.name || name,
+      updated: true
+    };
+  }
+});
+var index_default = spritesUrlSetTool;
+
+export { index_default as default, spritesUrlSetTool };

package/package.json

@@ -0,0 +1,76 @@
+{
+  "name": "@tpmjs/tools-sprites-url-set",
+  "version": "0.1.0",
+  "description": "Set the access settings for a sprite URL (public or private)",
+  "type": "module",
+  "keywords": [
+    "tpmjs",
+    "sprites",
+    "sandbox",
+    "code-execution",
+    "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-url-set"
+  },
+  "homepage": "https://tpmjs.com",
+  "license": "MIT",
+  "tpmjs": {
+    "category": "sandbox",
+    "frameworks": [
+      "vercel-ai"
+    ],
+    "tools": [
+      {
+        "name": "spritesUrlSetTool",
+        "description": "Set the access settings for a sprite URL. Use 'public' to allow anyone to access the sprite URL, or 'sprite' to require authentication.",
+        "parameters": [
+          {
+            "name": "name",
+            "type": "string",
+            "description": "Name of the sprite to update",
+            "required": true
+          },
+          {
+            "name": "auth",
+            "type": "string",
+            "description": "Access mode - 'public' for public access, 'sprite' for authenticated access only",
+            "required": true
+          }
+        ],
+        "returns": {
+          "type": "SpriteUrlResult",
+          "description": "Updated sprite URL and settings"
+        }
+      }
+    ]
+  },
+  "dependencies": {
+    "ai": "6.0.23"
+  }
+}