@tpmjs/tools-sprites-sessions 0.1.1 → 0.1.3

package/README.md

@@ -0,0 +1,73 @@
+# @tpmjs/sprites-sessions
+
+List active execution sessions for a sprite.
+
+## Installation
+
+```bash
+npm install @tpmjs/sprites-sessions
+```
+
+## Requirements
+
+- `SPRITES_TOKEN` environment variable - Get your token from https://sprites.dev
+
+## Usage
+
+```typescript
+import { spritesSessionsTool } from '@tpmjs/sprites-sessions';
+
+const result = await spritesSessionsTool.execute({
+  name: 'my-sandbox'
+});
+
+console.log(result);
+// {
+//   sessions: [
+//     { id: 'sess_123', status: 'active', startedAt: '2024-01-15T10:30:00Z', command: 'python server.py' },
+//     { id: 'sess_124', status: 'completed', startedAt: '2024-01-15T10:25:00Z' }
+//   ],
+//   count: 2
+// }
+```
+
+## Input Parameters
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `name` | `string` | Yes | Name of the sprite to list sessions for |
+
+## Output
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `sessions` | `ExecSession[]` | Array of execution sessions |
+| `count` | `number` | Total number of sessions |
+
+### ExecSession Object
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `id` | `string` | Unique session identifier |
+| `status` | `'active' \| 'completed' \| 'terminated'` | Session status |
+| `startedAt` | `string` | ISO 8601 timestamp when session started |
+| `command` | `string?` | Optional command that started the session |
+
+## Use Cases
+
+- Monitor running commands in a sprite
+- Check if long-running processes are still active
+- Debug execution issues by reviewing session history
+
+## 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

package/dist/index.js

@@ -34,7 +34,7 @@ var spritesSessionsTool = tool({
       const controller = new AbortController();
       const timeoutId = setTimeout(() => controller.abort(), 3e4);
       response = await fetch(
-        `${SPRITES_API_BASE}/sprites/${encodeURIComponent(name)}/exec/sessions`,
+        `${SPRITES_API_BASE}/sprites/${encodeURIComponent(name)}/exec`,
         {
           method: "GET",
           headers: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tpmjs/tools-sprites-sessions",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "List active execution sessions for a sprite",
   "type": "module",
   "keywords": [
@@ -19,10 +19,16 @@
   "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",
-    "@tpmjs/tsconfig": "0.0.0"
+    "typescript": "^5.9.3"
   },
   "publishConfig": {
     "access": "public"
@@ -60,11 +66,5 @@
   },
   "dependencies": {
     "ai": "6.0.23"
-  },
-  "scripts": {
-    "build": "tsup",
-    "dev": "tsup --watch",
-    "type-check": "tsc --noEmit",
-    "clean": "rm -rf dist .turbo"
   }
-}
+}

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2024-2025 TPMJS
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.