@papercraneai/sandbox-agent 0.1.9 → 0.1.11

package/dist/index.js

@@ -4,6 +4,7 @@ import { createServer } from "http";
 import { WebSocketServer, WebSocket } from "ws";
 import { Tail } from "tail";
 import { query, tool, createSdkMcpServer } from "@anthropic-ai/claude-agent-sdk";
+import { realpathSync } from "fs";
 import { readdir, stat, mkdir, readFile, writeFile, access, unlink, rm } from "fs/promises";
 import { join, dirname, resolve } from "path";
 import { fileURLToPath } from "url";
@@ -372,6 +373,8 @@ const app = express();
 app.use(express.json());
 const PORT = cliArgs.agentPort;
 let PROJECT_DIR = getProjectDir(); // Will be updated after template setup
+// Per-request UI context for GetContext tool (keyed by requestId, cleaned up after each turn)
+const sessionContext = {};
 // Registration state
 let environmentId = null;
 let connectionToken = null;
@@ -389,10 +392,17 @@ const showPreviewTool = tool("ShowPreview", "Shows the preview iframe for a spec
 });
 // Factory to create a fresh MCP server per chat session
 // (each Protocol instance can only be connected to one transport at a time)
-function createClientToolsServer() {
+// contextKey links to the per-request entry in sessionContext for GetContext
+function createClientToolsServer(contextKey) {
+    const getContextTool = tool("GetContext", "Returns the current UI context — which dashboard the user is viewing in the preview panel. Use this when the user's request is ambiguous about which dashboard they're referring to.", {}, async () => ({
+        content: [{
+                type: "text",
+                text: JSON.stringify(sessionContext[contextKey] || { selectedDashboard: null })
+            }]
+    }));
     return createSdkMcpServer({
         name: "client-tools",
-        tools: [showPreviewTool]
+        tools: [showPreviewTool, getContextTool]
     });
 }
 // Recursively build file tree
@@ -895,7 +905,8 @@ function encodeSessionPath(path) {
 // Get the directory where Claude stores sessions for this project
 function getSessionsDir() {
     const claudeConfigDir = process.env.CLAUDE_CONFIG_DIR || join(homedir(), ".claude");
-    const encodedPath = encodeSessionPath(PROJECT_DIR);
+    const resolvedDir = realpathSync(PROJECT_DIR);
+    const encodedPath = encodeSessionPath(resolvedDir);
     return join(claudeConfigDir, "projects", encodedPath);
 }
 // Parse a JSONL file to extract session metadata
@@ -1123,7 +1134,7 @@ const buildHooks = (res, verbose, requestId, requestStartTime) => {
 app.post("/chat", async (req, res) => {
     const requestStartTime = Date.now();
     const requestId = Math.random().toString(36).substring(7);
-    const { message, sessionId, systemPrompt, verbose = false, subdir, 
+    const { message, sessionId, systemPrompt, verbose = false, subdir, selectedDashboard, 
     // Configurable agent options
     maxTurns = 40, allowedTools, disallowedTools, model, maxBudgetUsd } = req.body;
     const ctx = { requestId, sessionId };
@@ -1185,9 +1196,12 @@ app.post("/chat", async (req, res) => {
         "WebSearch",
         "AgentOutput",
         "KillShell",
-        "mcp__client-tools__ShowPreview"
+        "mcp__client-tools__ShowPreview",
+        "mcp__client-tools__GetContext"
     ];
-    const clientTools = createClientToolsServer();
+    // Store UI context for GetContext tool
+    sessionContext[requestId] = { selectedDashboard: selectedDashboard || null };
+    const clientTools = createClientToolsServer(requestId);
     const options = {
         maxTurns,
         cwd,
@@ -1276,7 +1290,8 @@ app.post("/chat", async (req, res) => {
         }
     }
     finally {
-        // Close the per-session MCP server to free resources
+        // Clean up per-request context and close MCP server
+        delete sessionContext[requestId];
         await clientTools.instance?.close().catch(() => { });
     }
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@papercraneai/sandbox-agent",
-  "version": "0.1.9",
+  "version": "0.1.11",
   "description": "Claude Agent SDK server for sandbox environments",
   "license": "MIT",
   "type": "module",