eve-hub 0.13.0 → 0.13.1

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # eve-hub
 
+## 0.13.1
+
+### Patch Changes
+
+- `show` opens a web page (`uri`) or a file from the bot's sandbox (`path`) in a tab beside the thread.
+
 ## 0.13.0
 
 ### Minor Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "eve-hub",
-  "version": "0.13.0",
+  "version": "0.13.1",
   "license": "Apache-2.0",
   "description": "Bot-side code shared by every hub agent: registry tools, the roster hook, the eve channel, the host sandbox and browser, and model helpers.",
   "type": "module",

package/stubs.mjs

@@ -8,7 +8,7 @@ export const KIT_FILES = {
   "hooks/sandbox.ts": ["Migrates legacy Docker sessions to the host sandbox."],
   "tools/bash.ts": ["eve's bash with a default time limit (kills the process group) and the workspace's code location."],
   "tools/react.ts": ["React to a message with an emoji."],
-  "tools/show.ts": ["Move the human's screen to a thread, DM, or message."],
+  "tools/show.ts": ["Move the human's screen to a thread, DM, or message, or open a page or file beside the thread."],
   "tools/browser.ts": ["Its own headless browser, watched live in the Computer view."],
   "tools/attach_image.ts": ["Puts an image (a sandbox file or a browser screenshot) on this turn's reply."],
   "tools/view_image.ts": ["Shows the bot an image (a sandbox file or a browser screenshot) so it can see it."],

package/tools/show.d.ts

@@ -2,17 +2,25 @@ declare const _default: import("eve/tools").ToolDefinition<{
     threadId?: string | undefined;
     agent?: string | undefined;
     messageId?: string | undefined;
+    uri?: string | undefined;
+    path?: string | undefined;
+    line?: number | undefined;
     reason: string;
 }, {
     ok: boolean;
+    opened?: string | undefined;
 }> & {
     execute(input: {
         threadId?: string | undefined;
         agent?: string | undefined;
         messageId?: string | undefined;
+        uri?: string | undefined;
+        path?: string | undefined;
+        line?: number | undefined;
         reason: string;
     }, ctx: import("eve/tools").ToolContext): Promise<{
         ok: boolean;
+        opened?: string | undefined;
     }>;
 };
 export default _default;

package/tools/show.js

@@ -1,24 +1,61 @@
+import { basename } from "node:path";
+import { pathToFileURL } from "node:url";
 import { defineTool } from "eve/tools";
 import { z } from "zod";
 import { registryFetch } from "../registry-fetch.mjs";
 // Moves the human's workspace UI, e.g. to a thread you just opened or a
-// message they need to look at. They see a note saying you did it and why.
+// message they need to look at, or opens a page or file in the pane beside
+// the thread. They see a note saying you did it and why.
+//
+// A file goes as file:// on a local hub (the bot's files are the human's) and,
+// on a hosted hub (a deployed bot, or HUB_TOKEN set), as a snapshot uploaded to the hub
+// (hub://upload/<sha>.<ext>), since the human's Mac can't read the sandbox.
 export default defineTool({
-    description: "Move the human's screen to a place in the workspace: a thread (threadId), a bot's DM (agent), optionally scrolled to and highlighting one message (messageId). Use when you want them to look at something now. Rarely: only when they must look now.",
+    description: "Move the human's screen to a place in the workspace: a thread (threadId), a bot's DM (agent), optionally scrolled to and highlighting one message (messageId). Or open a web page (uri) or a file from your sandbox (path: markdown, text or code, an image, a PDF; line for text) in a tab beside this thread, without moving them. Use when you want them to look at something now. Rarely move their screen: only when they must look now.",
     inputSchema: z.object({
         threadId: z.string().optional().describe("Thread id, e.g. thr_0002."),
         agent: z.string().optional().describe("Open this bot's DM instead of a thread."),
         messageId: z.string().optional().describe("Also scroll to and highlight this message, like opening a link to it."),
+        uri: z.string().optional().describe("An http(s) page to open beside the thread."),
+        path: z.string().optional().describe("A file in your sandbox to open beside the thread, e.g. /workspace/repo/PLAN.md."),
+        line: z.number().int().positive().optional().describe("With path: the line a text or code file opens at."),
         reason: z.string().describe("One short line shown to the human, e.g. 'the plan is ready for review'."),
     }),
-    async execute(input, ctx) {
+    async execute({ path, uri, line, ...input }, ctx) {
+        if (path && uri)
+            throw new Error("pass path or uri, not both");
+        if (line && !path)
+            throw new Error("line goes with path");
+        let open = uri, title;
+        if (path) {
+            title = basename(path);
+            const sandbox = await ctx.getSandbox();
+            if (process.env.VERCEL || process.env.HUB_TOKEN) {
+                const bytes = await sandbox.readBinaryFile({ path });
+                if (!bytes)
+                    throw new Error(`no file at ${path}`);
+                const res = await registryFetch(`/api/uploads`, {
+                    method: "POST",
+                    headers: { "content-type": "application/octet-stream", "x-filename": encodeURIComponent(basename(path)) },
+                    body: new Uint8Array(bytes),
+                    signal: AbortSignal.timeout(30_000),
+                });
+                const body = await res.json().catch(() => ({}));
+                if (!res.ok)
+                    throw new Error(`show failed: the upload was refused (${body.error ?? res.status})`);
+                open = `hub://upload/${body.id}`;
+            }
+            else {
+                open = pathToFileURL(sandbox.resolvePath(path)).href;
+            }
+        }
         const res = await registryFetch(`/api/ui`, {
             method: "POST",
             headers: { "content-type": "application/json" },
-            body: JSON.stringify({ ...input, sessionId: ctx.session.id }),
+            body: JSON.stringify({ ...input, ...(open ? { uri: open, ...(line ? { line } : {}), ...(title ? { title } : {}) } : {}), sessionId: ctx.session.id }),
         });
         if (!res.ok)
             throw new Error(`show failed: ${res.status} ${await res.text()}`);
-        return { ok: true };
+        return { ok: true, ...(open ? { opened: open } : {}) };
     },
 });