@bivy/bivy 0.17.3-staging.26 → 0.17.3-staging.28

package/bin/bivy.mjs

@@ -2432,6 +2432,7 @@ async function cmdApp(args = []) {
        bivy app remove <app-id> [--session <id>]
        bivy app shot [app-id] [--widths 390,1280] [--themes light,dark] [--path /page] [--session <id>]
        bivy app present [view] [--path /page] [--note "…"] [--session <id>]
+       bivy app share [app-id] [--view <view>] [--session <id>]
        bivy app run [--name <name>] [--restart-on-change] [--session <id>] -- <command> [args…]
 
 Manifest: {"version":1,"name":"My app","views":[
@@ -2458,10 +2459,16 @@ run: bivy config set sessions.appScreenshots true
 the chat with the app at phone width (and before/after), and it opens the live
 preview. Use it when you finish a visible change, or when the user asks to see
 it. [view] is an app or view name or ID (default: the one opened last).
+"share" mints a reusable link to one web view and prints its URL and expiry
+(24 hours, or until Revoke access in Apps, the app is removed or the machine
+restarts). [app-id] is an app ID or name, --view a view ID or name (default: the
+one opened last). Anyone who has the link can use the app, including a live
+server's backend, until it expires or is revoked: only post it where everyone
+who can read it may use the app.
 Web previews require operator setup; see docs/apps.md.`);
     return;
   }
-  if (!["publish", "list", "remove", "shot", "run", "present"].includes(action)) throw new Error("Unknown app command. Run bivy app --help.");
+  if (!["publish", "list", "remove", "shot", "run", "present", "share"].includes(action)) throw new Error("Unknown app command. Run bivy app --help.");
   // `run -- <command> [args…]`: publish a one-window desktop app without a manifest file.
   let runManifest;
   if (action === "run") {
@@ -2476,6 +2483,15 @@ Web previews require operator setup; see docs/apps.md.`);
     runManifest = { version: 1, name: name.slice(0, 100), views: [{ kind: "display", name: "Window", command, args: commandArgs, ...(restartIndex >= 0 ? { restartOnChange: true } : {}) }] };
   }
   const shot = {};
+  if (action === "share") {
+    const i = rest.indexOf("--view");
+    if (i >= 0) {
+      const value = rest[i + 1];
+      if (!value || value.startsWith("--")) throw new Error("--view requires a view ID or name.");
+      shot.view = value;
+      rest.splice(i, 2);
+    }
+  }
   if (action === "shot" || action === "present") {
     for (const flag of action === "shot" ? ["--widths", "--themes", "--path"] : ["--path", "--note"]) {
       const i = rest.indexOf(flag);
@@ -2494,10 +2510,11 @@ Web previews require operator setup; see docs/apps.md.`);
   const sessionId = resolveAttachSessionId({ sessionFlag: sessionIndex >= 0 ? rest[sessionIndex + 1] : undefined, env: process.env });
   if (!sessionId) throw new Error("Set --session <id> or run inside a Bivy agent session.");
   const positional = rest.filter((_, i) => i !== sessionIndex && (sessionIndex < 0 || i !== sessionIndex + 1));
-  if (positional.some((a) => a.startsWith("-")) || (action === "shot" || action === "present" ? positional.length > 1 : positional.length !== (action === "list" || action === "run" ? 0 : 1))) throw new Error("Invalid arguments. Run bivy app --help.");
+  if (positional.some((a) => a.startsWith("-")) || (action === "shot" || action === "present" || action === "share" ? positional.length > 1 : positional.length !== (action === "list" || action === "run" ? 0 : 1))) throw new Error("Invalid arguments. Run bivy app --help.");
   const body = { sessionId, ...shot };
   if (action === "shot" && positional[0]) body.appId = positional[0];
   if (action === "present" && positional[0]) body.target = positional[0];
+  if (action === "share" && positional[0]) body.appId = positional[0];
   if (action === "publish") {
     const file = path.resolve(positional[0]);
     if (fs.statSync(file).size > 64 * 1024) throw new Error("App manifest exceeds 64 KiB.");
@@ -2519,6 +2536,12 @@ Web previews require operator setup; see docs/apps.md.`);
   });
   const result = await response.json();
   if (!response.ok || result.error) throw new Error(result.error || `App command failed (${response.status}).`);
+  if (action === "share") {
+    const { type: _type, requestId: _requestId, ...link } = result;
+    console.log(JSON.stringify({ ...link, expires: new Date(link.expiresAt).toISOString() }, null, 2));
+    console.error("Anyone with this link can use the app, including its live backend, until it expires or you revoke it (Apps → Revoke access).");
+    return;
+  }
   console.log(JSON.stringify(result, null, 2));
 }
 

package/dist/apps/service.js

@@ -231,8 +231,11 @@ export class AppService {
         return { ok: true };
     }
     /** A view by app or view ID or name; by default the one opened last, else the newest app's first. */
+    webViews(sessionId) {
+        return this.registry.list(sessionId).flatMap((app) => app.views.filter((view) => view.kind === "web").map((view) => this.registry.getView(view.id))).filter(Boolean);
+    }
     pickView(sessionId, target) {
-        const views = this.registry.list(sessionId).flatMap((app) => app.views.filter((view) => view.kind === "web").map((view) => this.registry.getView(view.id))).filter(Boolean);
+        const views = this.webViews(sessionId);
         if (!views.length)
             throw new Error("This session has no web views to present. Publish one with bivy app publish, or preview a detected server.");
         if (target) {
@@ -507,6 +510,25 @@ export class AppService {
             throw new Error("Bivy's preview service is unavailable on this connection.");
         return this.gateway.share(viewId);
     }
+    /** `bivy app share`: mints a share link for a web view picked by app and/or
+     * view ID or name, like `present` (default: the one opened last). */
+    shareView(sessionId, input) {
+        let entry;
+        if (input.view) {
+            const wantedApp = input.app?.trim().toLowerCase();
+            const scope = this.webViews(sessionId).filter((candidate) => !wantedApp || candidate.app.id === wantedApp || candidate.app.name.toLowerCase() === wantedApp);
+            if (wantedApp && !scope.length)
+                throw new Error(`No app called "${input.app}" with web views in this session. Run bivy app list to see them.`);
+            const wanted = input.view.trim().toLowerCase();
+            const found = scope.find((candidate) => candidate.view.id === wanted) ?? scope.find((candidate) => candidate.view.name.toLowerCase() === wanted);
+            if (!found)
+                throw new Error(`No web view called "${input.view}"${input.app ? ` in "${input.app}"` : ""}. Run bivy app list to see them.`);
+            entry = found;
+        }
+        else
+            entry = this.pickView(sessionId, input.app);
+        return { ...this.share(sessionId, entry.app.id, entry.view.id), appId: entry.app.id, viewId: entry.view.id, app: entry.app.name, view: entry.view.name };
+    }
     clearNotes(sessionId, appId, viewId) {
         delete this.registry.requireView(sessionId, appId, viewId).notes;
         return { ok: true };

package/dist/controllers/app-commands.js

@@ -29,7 +29,10 @@ export function createAppCommands(service, workspaceFor, published = () => { })
         "apps.annotate": (msg) => service.annotate(String(msg.sessionId), msg),
         "apps.clearNotes": (msg) => service.clearNotes(String(msg.sessionId), String(msg.appId), String(msg.viewId)),
         "apps.logs": (msg) => service.logs(String(msg.sessionId), String(msg.appId), String(msg.viewId)),
-        "apps.share": (msg) => service.share(String(msg.sessionId), String(msg.appId), String(msg.viewId)),
+        // The app UI passes exact IDs; `bivy app share` passes an app and/or view by ID or name.
+        "apps.share": (msg) => typeof msg.viewId === "string" && typeof msg.appId === "string"
+            ? service.share(String(msg.sessionId), msg.appId, msg.viewId)
+            : service.shareView(String(msg.sessionId), { app: typeof msg.appId === "string" ? msg.appId : undefined, view: typeof msg.view === "string" ? msg.view : undefined }),
         "apps.revoke": (msg) => service.revoke(String(msg.sessionId), String(msg.appId), String(msg.viewId)),
         "apps.remove": (msg) => { service.remove(String(msg.sessionId), String(msg.appId)); return { ok: true }; },
     };

package/dist/protocol/client-command-schemas.js

@@ -26,7 +26,7 @@ export const CLIENT_COMMAND_SCHEMAS = {
         signals: Type.Optional(Type.Record(Type.String(), Type.Boolean())) }),
     "apps.clearNotes": Type.Object({ ...request, ...session, appId: Type.String(), viewId: Type.String() }),
     "apps.logs": Type.Object({ ...request, ...session, appId: Type.String(), viewId: Type.String() }),
-    "apps.share": Type.Object({ ...request, ...session, appId: Type.String(), viewId: Type.String() }),
+    "apps.share": Type.Object({ ...request, ...session, appId: Type.Optional(Type.String({ maxLength: 200 })), viewId: Type.Optional(Type.String()), view: Type.Optional(Type.String({ maxLength: 200 })) }),
     "apps.revoke": Type.Object({ ...request, ...session, appId: Type.String(), viewId: Type.String() }),
     "apps.remove": Type.Object({ ...request, ...session, appId: Type.String() }),
     "credentials.native.preview": Type.Object({ ...request, label: Type.Optional(Type.String({ maxLength: 100 })) }),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bivy/bivy",
-  "version": "0.17.3-staging.26",
+  "version": "0.17.3-staging.28",
   "type": "module",
   "license": "AGPL-3.0-only",
   "description": "Run coding agents on machines you own. Open-source, self-hostable agent workspace.",