@tpmjs/tools-sprites-sessions 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,24 @@
+import * as ai from 'ai';
+
+/**
+ * Sprites Sessions Tool for TPMJS
+ * Lists active execution sessions for a sprite.
+ *
+ * @requires SPRITES_TOKEN environment variable
+ */
+interface ExecSession {
+    id: string;
+    status: 'active' | 'completed' | 'terminated';
+    startedAt: string;
+    command?: string;
+}
+interface SpritesSessionsResult {
+    sessions: ExecSession[];
+    count: number;
+}
+type SpritesSessionsInput = {
+    name: string;
+};
+declare const spritesSessionsTool: ai.Tool<SpritesSessionsInput, SpritesSessionsResult>;
+
+export { type ExecSession, type SpritesSessionsResult, spritesSessionsTool as default, spritesSessionsTool };

package/dist/index.js

@@ -0,0 +1,92 @@
+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 spritesSessionsTool = tool({
+  description: "List active execution sessions for a sprite. Useful for monitoring running commands or attaching to existing sessions.",
+  inputSchema: jsonSchema({
+    type: "object",
+    properties: {
+      name: {
+        type: "string",
+        description: "Name of the sprite to list sessions for"
+      }
+    },
+    required: ["name"],
+    additionalProperties: false
+  }),
+  async execute({ name }) {
+    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(), 3e4);
+      response = await fetch(
+        `${SPRITES_API_BASE}/sprites/${encodeURIComponent(name)}/exec/sessions`,
+        {
+          method: "GET",
+          headers: {
+            Authorization: `Bearer ${token}`,
+            "User-Agent": "TPMJS/1.0"
+          },
+          signal: controller.signal
+        }
+      );
+      clearTimeout(timeoutId);
+    } catch (error) {
+      if (error instanceof Error) {
+        if (error.name === "AbortError") {
+          throw new Error(`Request to list sessions for sprite "${name}" timed out`);
+        }
+        throw new Error(`Failed to list sessions for sprite "${name}": ${error.message}`);
+      }
+      throw new Error(`Failed to list sessions 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 list sessions 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 sessionsArray = Array.isArray(data) ? data : data.sessions;
+    const sessions = (Array.isArray(sessionsArray) ? sessionsArray : []).map(
+      (s) => ({
+        id: s.id,
+        status: s.status || "active",
+        startedAt: s.startedAt || s.started_at || "",
+        command: s.command
+      })
+    );
+    return {
+      sessions,
+      count: sessions.length
+    };
+  }
+});
+var index_default = spritesSessionsTool;
+
+export { index_default as default, spritesSessionsTool };

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@tpmjs/tools-sprites-sessions",
+  "version": "0.1.0",
+  "description": "List active execution sessions for a sprite",
+  "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-sessions"
+  },
+  "homepage": "https://tpmjs.com",
+  "license": "MIT",
+  "tpmjs": {
+    "category": "sandbox",
+    "frameworks": ["vercel-ai"],
+    "tools": [{
+      "name": "spritesSessionsTool",
+      "description": "List active execution sessions for a sprite",
+      "parameters": [{
+        "name": "name",
+        "type": "string",
+        "description": "Name of the sprite to list sessions for",
+        "required": true
+      }],
+      "returns": {
+        "type": "{ sessions: ExecSession[], count: number }",
+        "description": "Array of active execution sessions with count"
+      }
+    }]
+  },
+  "dependencies": { "ai": "6.0.23" }
+}