fauna-api 1.0.759 → 1.0.771

package/dist/src/parrot/room.d.ts

@@ -4,6 +4,7 @@ import { Room, Presence, Authorization } from "../shared/server.js";
 import { ChatTarget, AppendResult, Attachment } from "./share.js";
 import type { Repository } from "../termite/versioning.js";
 import type { Group } from "../groups.js";
+import type { Target } from "../view.js";
 export { Attachment } from "./share.js";
 /**
  * One durable message in a room transcript. Parts keep their file refs as
@@ -80,8 +81,8 @@ export type RoomHooks = Partial<{
     onRenamed(room: ChatRoom, name: string): void;
     /** The chat's repository was attached, swapped or detached. */
     onRepository(room: ChatRoom): void;
-    /** The reply pointed everyone to a file (Parrot's `open`): show it. */
-    onOpenFile(room: ChatRoom, attachment: Attachment): void;
+    /** The reply pointed everyone to a file (Parrot's `open`): show it. A chat attachment, or a file in the chat's repository, live. */
+    onOpenFile(room: ChatRoom, file: Target): void;
     /** The chat was deleted/closed by its owner (or the host disconnected). */
     onClosed(room: ChatRoom): void;
     /** The roster changed (someone joined/left or updated presence/status). */

package/dist/src/parrot/room.js

@@ -2,6 +2,7 @@ import { Role } from "./generative.js";
 import { Room, Presence, connect } from "../shared/server.js";
 import { Parrot } from "./index.js";
 import { appendRoomMessage, steerRoom, unqueueRoomMessage, pageMessages, setRoomRepository, listRoomAttachments, Attachment, } from "./share.js";
+import { File as FaunaFile } from "../drive.js";
 export { Attachment } from "./share.js";
 /**
  * A live, domain-agnostic chat room. `ChatRoom extends Room` and owns everything
@@ -412,9 +413,19 @@ export class ChatRoom extends Room {
                 return true;
             }
             case "chat-open-file": {
-                const raw = packet.data?.attachment;
-                if (raw)
-                    this.hooks.onOpenFile?.(this, Attachment.fromJSON(raw, this.getAuthorization()));
+                const attachment = packet.data?.attachment;
+                const repository = packet.data?.repository;
+                if (attachment) {
+                    this.hooks.onOpenFile?.(this, Attachment.fromJSON(attachment, this.getAuthorization()));
+                }
+                else if (repository) {
+                    this.hooks.onOpenFile?.(this, FaunaFile.fromJSON(repository, {
+                        authorization: this.getAuthorization(),
+                        repository: Number(repository.id),
+                        path: String(repository.path),
+                        ...(repository.group ? { group: String(repository.group) } : {}),
+                    }));
+                }
                 return true;
             }
             case "chat-tool-call": {

package/dist/src/payments.d.ts

@@ -5,8 +5,10 @@ export type Payment = {
     id: string;
     status: PaymentStatus;
     amount: number;
-    /** Fauna's fee, taken from what the payee receives. */
+    /** The whole fee, taken from what the payee receives: the card cost, Fauna's cut and the app's fee. */
     fee: number;
+    /** The app's part of `fee`, paid to the account that owns the API key that asked for the payment. */
+    appFee: number;
     refunded: number;
     currency: string;
     /** The payee's email. */
@@ -28,6 +30,12 @@ export type PaymentRequest = {
     currency?: string;
     description?: string;
     reference?: string;
+    /**
+     * The app's own fee, a percent of the amount (at most 30), paid to the account that owns
+     * the API key once the payment succeeds. Only an API key can ask for one, and its account
+     * needs payouts set up.
+     */
+    appFee?: number;
     /** Where Checkout sends the payer back, with ?payment=paid or ?payment=cancelled. */
     returnUrl?: string;
     cancelUrl?: string;
@@ -39,10 +47,11 @@ export type Payouts = {
     payoutsEnabled: boolean;
     detailsSubmitted: boolean;
 };
-/** What a payment of `amount` costs: Fauna's fee and what the payee receives. */
+/** What a payment of `amount` costs: the whole fee, the app's part of it and what the payee receives. */
 export type Quote = {
     amount: number;
     fee: number;
+    appFee: number;
     payout: number;
 };
 /** Start or continue setting up payouts. Open the returned URL; Stripe sends you back with ?payouts=connected. */
@@ -56,7 +65,10 @@ export declare function payouts(credentials: Credentials): Promise<Payouts>;
 export declare function dashboard(credentials: Credentials): Promise<{
     url: string;
 }>;
-export declare function quote(authorization: Credentials | ApiKey, amount: number): Promise<Quote>;
+/** What a payment of `amount` would cost, with the app's fee (`appFee`, a percent) when an API key asks for one. */
+export declare function quote(authorization: Credentials | ApiKey, amount: number, options?: {
+    appFee?: number;
+}): Promise<Quote>;
 /**
  * Ask for a payment to `payee`. Send the payer to the returned `url`. With an API
  * key, that key's webhooks hear `payment.succeeded`, `payment.expired`,
@@ -69,5 +81,8 @@ export declare function get(authorization: Credentials | ApiKey, id: string): Pr
 export declare function list(authorization: Credentials | ApiKey, query?: {
     reference?: string;
 }): Promise<Payment[]>;
-/** Refund a completed payment in full, Fauna's fee included. Whoever made it, or its payee, can. */
+/**
+ * Refund a completed payment in full. The payee gets back the whole fee except Stripe's own
+ * fee on the charge, the app's fee included. Whoever made it, or its payee, can.
+ */
 export declare function refund(authorization: Credentials | ApiKey, id: string): Promise<Payment>;

package/dist/src/payments.js

@@ -39,8 +39,10 @@ export async function dashboard(credentials) {
         throw new Error(await response.text());
     return await response.json();
 }
-export async function quote(authorization, amount) {
-    const response = await fetch(`${Fauna.getURL()}/payments/quote?amount=${encodeURIComponent(String(amount))}`, {
+/** What a payment of `amount` would cost, with the app's fee (`appFee`, a percent) when an API key asks for one. */
+export async function quote(authorization, amount, options = {}) {
+    const appFee = options.appFee !== undefined ? `&appFee=${encodeURIComponent(String(options.appFee))}` : '';
+    const response = await fetch(`${Fauna.getURL()}/payments/quote?amount=${encodeURIComponent(String(amount))}${appFee}`, {
         method: "GET",
         headers: {
             "Authorization": 'email' in authorization ? `Token ${authorization.token}` : `ApiKey ${authorization.id}`
@@ -93,7 +95,10 @@ export async function list(authorization, query = {}) {
         throw new Error(await response.text());
     return (await response.json()).map(hydrate);
 }
-/** Refund a completed payment in full, Fauna's fee included. Whoever made it, or its payee, can. */
+/**
+ * Refund a completed payment in full. The payee gets back the whole fee except Stripe's own
+ * fee on the charge, the app's fee included. Whoever made it, or its payee, can.
+ */
 export async function refund(authorization, id) {
     const response = await fetch(`${Fauna.getURL()}/payments/${encodeURIComponent(id)}/refund`, {
         method: "POST",

package/dist/src/termite/os.d.ts

@@ -103,12 +103,18 @@ export type ProcessTool = {
     pid: number;
     signal?: 'TERM' | 'KILL';
 };
+/** How the machine reaches the internet: `private` only from a residential address, billed per
+ *  GB to whoever pays for the machine, or `public` from its own. */
+export type InternetTool = {
+    kind: 'internet';
+    mode: 'private' | 'public';
+};
 /** Pointer and keyboard input on the desktop. No executeJavascript, which would run on the
  *  desktop page itself, and no search or exit, which belong to a web page's agent. */
 export type DesktopTool = Exclude<BrowserTool, {
     kind: 'executeJavascript' | 'search' | 'exit';
 }>;
-export type MachineTool = DesktopTool | WindowTool | FileTool | ProcessTool;
+export type MachineTool = DesktopTool | WindowTool | FileTool | ProcessTool | InternetTool;
 /** Metadata for one desktop window. Its pixels live in the desktop HTML. */
 export type Window = {
     /** Same id as the element's data-window and the window tools. */
@@ -153,7 +159,7 @@ export type MachineRoomHooks = BrowserRoomHooks<DesktopTool> & Partial<{
     /** A Files window's folder or view changed. */
     onFiles(room: MachineRoom, window: number, files: FilesState): void;
     onStatus(room: MachineRoom): void;
-    /** Private turned on or off, or couldn't stay on (`privateReason` says why). */
+    /** Private turned on or off, paused while it reconnects (`privateReason` says why), or came back. */
     onPrivate(room: MachineRoom): void;
     /** An agent holding the machine took a step. */
     onAgentStep(room: MachineRoom, step: AgentStep): void;
@@ -180,7 +186,7 @@ export type AgentStep = {
     };
 };
 /**
- * Every machine tool for a model: desktop input, windows, files, and exec.
+ * Every machine tool for a model: desktop input, windows, files, processes, the internet switch, and exec.
  * `invoke` runs a tool; `exec` runs a shell command and returns its result as text.
  */
 export declare function parrotTools(invoke: (tool: MachineTool) => Promise<string>, exec: (command: string, timeoutMs?: number) => Promise<string>): Tool[];
@@ -239,9 +245,11 @@ export declare class MachineRoom extends PageRoom<DesktopTool> {
     error: string;
     /** The repository's name, so a guest who joined by code knows what it is. */
     name: string;
-    /** Its connections go out from a residential address, billed per GB to whoever pays for the machine. */
+    /** Its connections go out only from a residential address, billed per GB to whoever pays for
+     *  the machine. Stays true while private is paused. */
     private: boolean;
-    /** Why private is off when it couldn't turn on or stay on, like a payer out of balance. */
+    /** Why private is paused while it reconnects, like a payer out of balance. Its internet is
+     *  cut until then. Empty while private carries traffic, or is off. */
     privateReason: string;
     private machineHooks;
     private calls;
@@ -292,7 +300,7 @@ export declare class MachineRoom extends PageRoom<DesktopTool> {
         group?: Group;
     }): Promise<void>;
     /** Turn private on or off for a repository's live machine, for its owner or group members.
-     *  Resolves to the machine's private state and, when it couldn't turn on, why. */
+     *  Resolves to the machine's private state and, while it's paused, why. */
     static setPrivate(authorization: Credentials | ApiKey, target: {
         repository: number;
     }, on: boolean, opts?: {

package/dist/src/termite/os.js

@@ -46,7 +46,7 @@ const CALL_MS = 60000;
 const EXEC_MS = 120000;
 const STOP_MS = 10 * 60000;
 /**
- * Every machine tool for a model: desktop input, windows, files, and exec.
+ * Every machine tool for a model: desktop input, windows, files, processes, the internet switch, and exec.
  * `invoke` runs a tool; `exec` runs a shell command and returns its result as text.
  */
 export function parrotTools(invoke, exec) {
@@ -156,6 +156,9 @@ export function parrotTools(invoke, exec) {
         pid: { type: "NUMBER", description: "Process id from processes" },
         signal: { type: "STRING", enum: ["TERM", "KILL"], description: "TERM (default) or KILL" },
     }, ["pid"], (p) => ({ kind: 'kill', pid: Number(p.pid), ...(p.signal === 'KILL' || p.signal === 'TERM' ? { signal: p.signal } : {}) }));
+    add("internet", "Choose how the machine reaches the internet. private sends every connection out from a residential address, billed per GB; public uses the machine's own address. While private reconnects the internet is paused and connections are refused; switch to public if the work can't wait.", {
+        mode: { type: "STRING", enum: ["private", "public"], description: "private or public" },
+    }, ["mode"], (p) => ({ kind: 'internet', mode: p.mode === 'public' ? 'public' : 'private' }));
     tools.push({
         function: {
             name: "exec",
@@ -295,14 +298,16 @@ export class MachineRoom extends PageRoom {
             writable: true,
             value: ''
         });
-        /** Its connections go out from a residential address, billed per GB to whoever pays for the machine. */
+        /** Its connections go out only from a residential address, billed per GB to whoever pays for
+         *  the machine. Stays true while private is paused. */
         Object.defineProperty(this, "private", {
             enumerable: true,
             configurable: true,
             writable: true,
             value: false
         });
-        /** Why private is off when it couldn't turn on or stay on, like a payer out of balance. */
+        /** Why private is paused while it reconnects, like a payer out of balance. Its internet is
+         *  cut until then. Empty while private carries traffic, or is off. */
         Object.defineProperty(this, "privateReason", {
             enumerable: true,
             configurable: true,
@@ -512,7 +517,7 @@ export class MachineRoom extends PageRoom {
             throw new Error(await response.text());
     }
     /** Turn private on or off for a repository's live machine, for its owner or group members.
-     *  Resolves to the machine's private state and, when it couldn't turn on, why. */
+     *  Resolves to the machine's private state and, while it's paused, why. */
     static async setPrivate(authorization, target, on, opts) {
         const response = await fetch(`${Termite.getURL()}/termite/repositories/${target.repository}/machine/private`, {
             method: "POST",

package/dist/src/ui/browser.js

@@ -245,11 +245,27 @@ const MIRRORED = [
 ];
 const SELECTION = "rgba(51, 144, 255, 0.38)";
 const BLINK_MS = 1060;
+/** The field showing the host's caret, in the replay's document or a frame inside it, with
+ *  where that frame's viewport sits in the replay and the outermost frame it is in. */
+function caretField(doc) {
+    const field = doc.querySelector("[data-fauna-caret]");
+    if (field)
+        return { field, left: 0, top: 0, frame: null };
+    for (const frame of Array.from(doc.querySelectorAll("iframe"))) {
+        const inner = frame.contentDocument ? caretField(frame.contentDocument) : null;
+        if (!inner)
+            continue;
+        const box = frame.getBoundingClientRect();
+        return { field: inner.field, left: inner.left + box.left + frame.clientLeft, top: inner.top + box.top + frame.clientTop, frame };
+    }
+    return null;
+}
 /**
  * The host's caret, or its selection, drawn over the focused text field of a replay. The
  * copy is never focused, so it has neither; the recorder streams them as
  * `data-fauna-caret="start,end,scrollLeft,scrollTop"`. The marks sit in a layer at the end
- * of the replay's document, outside every subtree the page mutates.
+ * of the replay's document, outside every subtree the page mutates. A field inside a frame
+ * is measured in the frame's own document, with its fonts, and its marks moved into place.
  */
 function caretPainter(getDoc) {
     let layer = null;
@@ -271,18 +287,20 @@ function caretPainter(getDoc) {
             doc.documentElement.appendChild(layer);
             painted = "";
         }
-        const field = doc.querySelector("[data-fauna-caret]");
+        const found = caretField(doc);
+        const field = found?.field;
+        const local = field?.ownerDocument;
         const caret = field?.getAttribute("data-fauna-caret") ?? "";
         const rect = field?.getBoundingClientRect();
-        if (!field || !caret || !rect?.width || !rect.height)
+        if (!found || !field || !local?.defaultView || !caret || !rect?.width || !rect.height)
             return clear();
         const [start, end, scrollLeft, scrollTop] = caret.split(",").map((n) => Number(n) || 0);
-        const style = doc.defaultView.getComputedStyle(field);
+        const style = local.defaultView.getComputedStyle(field);
         const textarea = field.tagName === "TEXTAREA";
         const value = field.value;
         const from = Math.max(0, Math.min(start, value.length));
         const to = Math.max(from, Math.min(end, value.length));
-        const mirror = doc.createElement("div");
+        const mirror = local.createElement("div");
         mirror.style.cssText = "all:initial;position:fixed;pointer-events:none;visibility:hidden;overflow:hidden";
         for (const name of MIRRORED)
             mirror.style.setProperty(name, style.getPropertyValue(name));
@@ -303,10 +321,13 @@ function caretPainter(getDoc) {
         // An input centers its one line in the box.
         if (!textarea)
             mirror.style.lineHeight = `${inner.bottom - inner.top - px("padding-top") - px("padding-bottom")}px`;
-        const mark = doc.createElement("span");
+        const mark = local.createElement("span");
         mark.textContent = from === to ? "\u200b" : value.slice(from, to);
         mirror.append(value.slice(0, from), mark, value.slice(to) + (textarea ? "\u200b" : ""));
-        layer.appendChild(mirror);
+        if (local === doc)
+            layer.appendChild(mirror);
+        else
+            local.documentElement.appendChild(mirror);
         mirror.scrollLeft = scrollLeft;
         mirror.scrollTop = scrollTop;
         const boxes = Array.from(mark.getClientRects());
@@ -322,11 +343,15 @@ function caretPainter(getDoc) {
             const bottom = Math.min(box.top + (box.height + height) / 2, inner.bottom);
             if (right <= left || bottom <= top || left < inner.left - 1 || left > inner.right)
                 continue;
-            // A window over the field covers its caret too.
-            const under = doc.elementFromPoint(Math.min(left + 1, right), (top + bottom) / 2);
+            // A window over the field covers its caret too, in its frame or over the frame.
+            const x = Math.min(left + 1, right);
+            const y = (top + bottom) / 2;
+            const under = local.elementFromPoint(x, y);
             if (under && under !== field && !field.contains(under))
                 continue;
-            shapes.push({ left, top, width: right - left, height: bottom - top });
+            if (found.frame && doc.elementFromPoint(x + found.left, y + found.top) !== found.frame)
+                continue;
+            shapes.push({ left: left + found.left, top: top + found.top, width: right - left, height: bottom - top });
         }
         // Unchanged marks stay, so the caret keeps blinking through unrelated changes.
         const key = `${color}|${shapes.map((s) => `${s.left},${s.top},${s.width},${s.height}`).join(";")}`;

package/dist/src/ui/chat.js

@@ -1727,10 +1727,10 @@ class ChatEngine {
                     this.roomStream.renderer.feedText(delta);
                 autoScroll(this.refs.messagesEl);
             },
-            onOpenFile: (_r, attachment) => {
+            onOpenFile: (_r, file) => {
                 if (liveEnded || this.destroyed)
                     return;
-                this.refs.panel?.point(attachment);
+                this.refs.panel?.point(file);
             },
             onThinking: (_r, thinking) => {
                 if (liveEnded)

package/dist/src/ui/chatPanel.d.ts

@@ -6,13 +6,13 @@ import type { Attachment } from "../parrot/share.js";
 export type PanelBus = {
     /** A person opened a file (a card, or a row): a tab for them only. */
     open(attachment: Attachment): void;
-    /** The reply pointed everyone to a file: open the panel and focus its tab. */
-    point(attachment: Attachment): void;
+    /** The reply pointed everyone to a file, an attachment or one in the chat's repository: open the panel and focus its tab. */
+    point(file: Fauna.View.Target): void;
     /** New files landed in the chat. */
     added(): void;
     listen(handlers: Partial<{
         open(a: Attachment): void;
-        point(a: Attachment): void;
+        point(f: Fauna.View.Target): void;
         added(): void;
     }>): () => void;
 };

package/dist/src/ui/chatPanel.js

@@ -23,9 +23,15 @@ export function createPanelBus() {
 export function attachmentOf(room, part, message) {
     return Fauna.Parrot.Share.Attachment.fromJSON({ ...part, chat: room.chatId ?? "", ...(message !== undefined ? { message } : {}) }, room.getAuthorization());
 }
-function keyOf(attachment) {
-    const auth = attachment.file.authorization;
-    return attachment.ref || auth.accessCode || attachment.file.name;
+function fileOf(target) {
+    return 'ref' in target && 'chat' in target ? target.file : target;
+}
+function keyOf(target) {
+    const file = fileOf(target);
+    const auth = file.authorization;
+    if (auth.repository)
+        return `repository:${auth.repository}:${auth.path}`;
+    return ('ref' in target && target.ref) || auth.accessCode || file.name;
 }
 function iconOf(contentType, name) {
     if (contentType.startsWith("image/"))
@@ -253,9 +259,9 @@ export function ChatPanel({ room, bus, open, onOpenChange }) {
             load();
         }
     }, [open, load]);
-    const openTab = useCallback((attachment, everyone) => {
-        const key = keyOf(attachment);
-        setTabs((current) => current.some((t) => t.key === key) ? current : [...current, { key, attachment, people: [] }]);
+    const openTab = useCallback((target, everyone) => {
+        const key = keyOf(target);
+        setTabs((current) => current.some((t) => t.key === key) ? current : [...current, { key, target, people: [] }]);
         setActive(key);
         slideBack();
         if (everyone || !open)
@@ -263,7 +269,7 @@ export function ChatPanel({ room, bus, open, onOpenChange }) {
     }, [open, onOpenChange, slideBack]);
     useEffect(() => bus.listen({
         open: (a) => openTab(a, false),
-        point: (a) => openTab(a, true),
+        point: (f) => openTab(f, true),
         added: () => {
             if (!loaded.current)
                 return;
@@ -342,7 +348,10 @@ export function ChatPanel({ room, bus, open, onOpenChange }) {
     };
     if (!open)
         return null;
-    return (_jsxs("div", { className: `chat-panel${cover ? " chat-panel-cover" : ""}`, ref: panel, style: cover ? undefined : { width: shown }, children: [!cover && _jsx("div", { className: "chat-panel-handle", onPointerDown: startResize, title: "Drag to resize" }), _jsxs("div", { className: "chat-panel-inner", style: cover ? undefined : { width: shown }, children: [_jsxs("div", { className: "chat-panel-tabs", children: [_jsxs("button", { className: `chat-panel-tab${active === "attachments" ? " chat-panel-tab-on" : ""}`, onClick: () => setActive("attachments"), children: [_jsx("span", { className: "material-symbols-outlined", children: "attach_file" }), _jsx("span", { className: "chat-panel-tab-name", children: "Attachments" })] }), tabs.map((tab) => (_jsxs("div", { className: `chat-panel-tab${active === tab.key ? " chat-panel-tab-on" : ""}`, onClick: () => setActive(tab.key), title: tab.attachment.file.name, children: [_jsx("span", { className: "material-symbols-outlined", children: iconOf(tab.attachment.file.contentType, tab.attachment.file.name) }), _jsx("span", { className: "chat-panel-tab-name", children: tab.attachment.file.name }), tab.people.length > 0 && _jsx("span", { className: "chat-panel-tab-people", title: tab.people.map((p) => personName(p.profile)).join(", "), children: tab.people.length }), _jsx("button", { className: "material-symbols-outlined chat-panel-tab-close", title: "Close", "aria-label": `Close ${tab.attachment.file.name}`, onClick: (e) => { e.stopPropagation(); closeTab(tab.key); }, children: "close" })] }, tab.key))), _jsx("span", { className: "chat-panel-tabs-gap" }), _jsx("button", { className: "material-symbols-outlined chat-panel-hide", title: "Hide", "aria-label": "Hide attachments", onClick: hide, children: "right_panel_close" })] }), _jsxs("div", { className: "chat-panel-body", children: [_jsx("div", { className: "chat-panel-list", style: active === "attachments" ? undefined : { display: "none" }, children: attachments === null
+    return (_jsxs("div", { className: `chat-panel${cover ? " chat-panel-cover" : ""}`, ref: panel, style: cover ? undefined : { width: shown }, children: [!cover && _jsx("div", { className: "chat-panel-handle", onPointerDown: startResize, title: "Drag to resize" }), _jsxs("div", { className: "chat-panel-inner", style: cover ? undefined : { width: shown }, children: [_jsxs("div", { className: "chat-panel-tabs", children: [_jsxs("button", { className: `chat-panel-tab${active === "attachments" ? " chat-panel-tab-on" : ""}`, onClick: () => setActive("attachments"), children: [_jsx("span", { className: "material-symbols-outlined", children: "attach_file" }), _jsx("span", { className: "chat-panel-tab-name", children: "Attachments" })] }), tabs.map((tab) => {
+                                const file = fileOf(tab.target);
+                                return (_jsxs("div", { className: `chat-panel-tab${active === tab.key ? " chat-panel-tab-on" : ""}`, onClick: () => setActive(tab.key), title: file.name, children: [_jsx("span", { className: "material-symbols-outlined", children: iconOf(file.contentType, file.name) }), _jsx("span", { className: "chat-panel-tab-name", children: file.name }), tab.people.length > 0 && _jsx("span", { className: "chat-panel-tab-people", title: tab.people.map((p) => personName(p.profile)).join(", "), children: tab.people.length }), _jsx("button", { className: "material-symbols-outlined chat-panel-tab-close", title: "Close", "aria-label": `Close ${file.name}`, onClick: (e) => { e.stopPropagation(); closeTab(tab.key); }, children: "close" })] }, tab.key));
+                            }), _jsx("span", { className: "chat-panel-tabs-gap" }), _jsx("button", { className: "material-symbols-outlined chat-panel-hide", title: "Hide", "aria-label": "Hide attachments", onClick: hide, children: "right_panel_close" })] }), _jsxs("div", { className: "chat-panel-body", children: [_jsx("div", { className: "chat-panel-list", style: active === "attachments" ? undefined : { display: "none" }, children: attachments === null
                                     ? _jsx("div", { className: "chat-panel-empty", children: failed ? "Couldn't load the attachments." : "Loading\u2026" })
                                     : attachments.length === 0
                                         ? _jsx("div", { className: "chat-panel-empty", children: "Files sent in this chat, and files Parrot opens, show up here." })
@@ -350,7 +359,7 @@ export function ChatPanel({ room, bus, open, onOpenChange }) {
                                             const key = keyOf(a);
                                             return (_jsxs("div", { className: `chat-panel-row${selected === key ? " chat-panel-row-on" : ""}`, tabIndex: 0, onClick: () => setSelected(key), onDoubleClick: () => openTab(a, false), onKeyDown: (e) => { if (e.key === "Enter")
                                                     openTab(a, false); }, children: [_jsx(RowThumb, { attachment: a }), _jsxs("div", { className: "chat-panel-row-text", children: [_jsx("div", { className: "chat-panel-row-name", children: a.file.name }), _jsxs("div", { className: "chat-panel-row-meta", children: [a.author ? personName(a.author) : "Parrot", ", ", when(a.createdAt)] })] })] }, key));
-                                        }) }), tabs.map((tab) => (_jsx("div", { className: "chat-panel-view", style: active === tab.key ? undefined : { display: "none" }, children: _jsx(View, { target: tab.attachment, onPeople: (people) => setPeople(tab.key, people), onSaved: () => refreshPreview({ key: tab.key, file: tab.attachment.file }) }) }, tab.key)))] })] })] }));
+                                        }) }), tabs.map((tab) => (_jsx("div", { className: "chat-panel-view", style: active === tab.key ? undefined : { display: "none" }, children: _jsx(View, { target: tab.target, onPeople: (people) => setPeople(tab.key, people), onSaved: () => refreshPreview({ key: tab.key, file: fileOf(tab.target) }) }) }, tab.key)))] })] })] }));
 }
 function reducedMotion() {
     return typeof window !== "undefined" && window.matchMedia?.("(prefers-reduced-motion: reduce)").matches === true;
@@ -729,6 +738,11 @@ export function chatToolLabel(call) {
         case "kill":
             out = { icon: "cancel", label: pick(`Stopping process ${args.pid}`, `Stopped process ${args.pid}`, `Couldn't stop process ${args.pid}`) };
             break;
+        case "internet": {
+            const mode = args.mode === "public" ? "public" : "private";
+            out = { icon: mode === "private" ? "shield_lock" : "public", label: pick(`Switching the internet to ${mode}`, `Switched the internet to ${mode}`, `Couldn't switch the internet to ${mode}`) };
+            break;
+        }
         case "open": {
             const name = path ? baseName(path) : String(args.attachment ?? "the file");
             out = { icon: "open_in_new", label: pick(`Opening ${name}`, `Opened ${name}`, `Couldn't open ${name}`) };

package/dist/src/view.d.ts

@@ -8,7 +8,10 @@ import type { Attachment } from "./parrot/share.js";
  * too large to edit) is looked at together.
  */
 export type Kind = 'text' | 'table' | 'image' | 'view';
-/** What you may do in a file room: `read` for share links, `write` for owners, group members and chat members. */
+/**
+ * What you may do in a file room: `read` for share links, `write` for owners, group members and
+ * chat members. A repository file is `write` only while the machine's agent user may write it.
+ */
 export type Role = 'read' | 'write';
 /** Text and tables over this size open as `view`. */
 export declare const EDIT_MAX_BYTES: number;
@@ -49,7 +52,7 @@ export declare function contentOf(kind: Kind, doc: Y.Doc): Uint8Array;
 /** Base64 for document updates on the wire. */
 export declare function toBase64(bytes: Uint8Array): string;
 export declare function fromBase64(text: string): Uint8Array;
-/** A file to open live: a Drive file (by path or share link) or a chat attachment. */
+/** A file to open live: a Drive file (by path or share link), a file in a repository's /repository, or a chat attachment. */
 export type Target = DriveFile | Attachment;
 export type Hooks = Partial<{
     /** Someone joined or left, or moved their pointer or selection. */
@@ -104,8 +107,9 @@ export declare class ViewRoom extends Room {
     disconnect(): void;
 }
 /**
- * Join the live room for a file: a Drive file (by path or share link) or a chat
- * attachment. Owners, group members and chat members can edit; share links look.
+ * Join the live room for a file: a Drive file (by path or share link), a file in a
+ * repository's /repository, or a chat attachment. Owners, group members and chat members
+ * can edit, repository files only where the machine's agent user could; share links look.
  */
 export declare function connect(target: Target, hooks?: Hooks): Promise<{
     room: ViewRoom;

package/dist/src/view.js

@@ -360,13 +360,13 @@ function authorizationFor(target) {
     const auth = target.authorization;
     if ('accessCode' in auth)
         return { authorization: auth.authorization, accessCode: auth.accessCode };
-    if ('repository' in auth)
-        throw new Error('Repository files open in Termite.');
-    return { authorization: auth.authorization, server: `fauna:file:${auth.path}`, ...(auth.group ? { group: auth.group } : {}) };
+    const server = 'repository' in auth ? `fauna:file:repository:${auth.repository}/${auth.path.replace(/^\/+/, '')}` : `fauna:file:${auth.path}`;
+    return { authorization: auth.authorization, server, ...(auth.group ? { group: auth.group } : {}) };
 }
 /**
- * Join the live room for a file: a Drive file (by path or share link) or a chat
- * attachment. Owners, group members and chat members can edit; share links look.
+ * Join the live room for a file: a Drive file (by path or share link), a file in a
+ * repository's /repository, or a chat attachment. Owners, group members and chat members
+ * can edit, repository files only where the machine's agent user could; share links look.
  */
 export async function connect(target, hooks = {}) {
     let created;

package/dist/src/webhooks.d.ts

@@ -1,8 +1,9 @@
 import { ApiKey, Credentials, Profile } from "./authentification.js";
 import { GroupRef } from "./groups.js";
 /** Event types a webhook can listen for: `chat.message` for groups and chats,
- *  `group.joined` and `group.left` for groups, payment events for API keys. */
-export type EventType = 'chat.message' | 'group.joined' | 'group.left' | 'payment.succeeded' | 'payment.expired' | 'payment.refunded' | 'payment.disputed';
+ *  `group.joined` and `group.left` for groups, payment events for API keys.
+ *  `calendar.event.started` goes to a calendar event's own `webhook`. */
+export type EventType = 'chat.message' | 'group.joined' | 'group.left' | 'payment.succeeded' | 'payment.expired' | 'payment.refunded' | 'payment.disputed' | 'calendar.event.started';
 /** Who a webhook belongs to: a group, one chat, or the API key making the call. */
 export type WebhookOwner = {
     group: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fauna-api",
-  "version": "1.0.759",
+  "version": "1.0.771",
   "description": "The Fauna SDK: accounts, Drive, groups, calendar, chats, payments and every Fauna app (Parrot, Marmot, Magpie, Cicada, Ant, Termite), plus React UI.",
   "homepage": "https://docs.faunakit.com",
   "repository": {