@saadnvd1/agent-os 0.3.778 → 0.3.780

package/lib/live/types.ts

@@ -1,3 +1,36 @@
+export type LiveLevel = "watch" | "suggest" | "drive";
+
+/** The single source for what each level is called and what it lets a guest do. */
+export const LEVELS: Record<LiveLevel, { label: string; hint: string }> = {
+  watch: {
+    label: "Watch",
+    hint: "Guests only watch. They can't send you anything.",
+  },
+  suggest: {
+    label: "Suggest",
+    hint: "Guests can suggest a prompt. Nothing reaches the agent unless you tap Send.",
+  },
+  drive: {
+    label: "Drive",
+    hint: "Guests can make the agent read this task's files. Everything else waits for you.",
+  },
+};
+
+export interface LevelOption {
+  value: LiveLevel;
+  label: string;
+  hint: string;
+  enabled: boolean;
+  reason?: string;
+}
+
+export interface GuestAction {
+  kind: "kick" | "admit" | "admit_drive" | "deny" | "give_wheel" | "take_back";
+  label: string;
+}
+
+export type DriverState = "idle" | "queued" | "working" | "waiting_on_host";
+
 // What the host's screens show of a live share (served by /api/live-shares).
 export interface LiveView {
   id: string;
@@ -9,6 +42,17 @@ export interface LiveView {
   maxGuests: number;
   connected: boolean;
   notice: string | null;
+  level: LiveLevel;
+  levels: LevelOption[];
+  /** Whether the guests got the chat from before the link was made. */
+  history: boolean;
+  /** The guest holding the wheel on a Drive share. */
+  driver: { guestId: string; name: string; state: DriverState } | null;
+  /** Shown above the composer while a guest drives. */
+  banner: {
+    text: string;
+    action?: { kind: "take_back"; label: string };
+  } | null;
   guests: {
     id: string;
     name: string;
@@ -16,6 +60,7 @@ export interface LiveView {
     online: boolean;
     /** Another guest here has the same name. */
     duplicateName: boolean;
+    actions: GuestAction[];
   }[];
   suggestions: {
     id: string;
@@ -33,7 +78,14 @@ export const EXPIRY_LABEL: Record<LiveExpiry, string> = {
   session: "Until the session ends",
 };
 
+export interface LiveInvite {
+  levels: LevelOption[];
+  history: { label: string; default: boolean; count: number };
+}
+
 export interface LiveResponse {
   linked: boolean;
   shares: LiveView[];
+  /** Only when the request named a session. */
+  invite?: LiveInvite;
 }

package/lib/share/connect.ts

@@ -111,6 +111,7 @@ export async function revokeRemote(id: string): Promise<void> {
 export async function createLiveRemote(share: {
   title: string;
   expiresIn: LiveExpiry;
+  access?: string;
 }) {
   const { config, machineKey } = files();
   try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@saadnvd1/agent-os",
-  "version": "0.3.778",
+  "version": "0.3.780",
   "description": "Self-hosted web UI for managing Claude Code sessions",
   "bin": {
     "agent-os": "scripts/agent-os"