@saadnvd1/agent-os 0.3.762 → 0.3.766

package/README.md

@@ -50,7 +50,7 @@ and check on all of it from your phone.
 
 The iPhone app, [AgentOS: Coding Agents](https://apps.apple.com/us/app/agentos-coding-agents/id6820980797), is on the App Store.
 
-You need Node.js 22+, tmux, and at least one agent CLI (the installer offers to set up what's missing).
+You need Node.js 22+, git, tmux, and at least one agent CLI (the installer offers to set up what's missing).
 
 ```bash
 npm install -g @saadnvd1/agent-os
@@ -69,11 +69,12 @@ Then open AgentOS, add a project from ⌘K, and press ⌥N. The [install guide](
 
 ## Connect
 
-Connect (in development) lets you reach AgentOS from anywhere, without a tailnet or opening a port. Sign in at [runagentos.com](https://runagentos.com), get a code, and run:
+AgentOS Connect is live. It gives your machine a private address at runagentos.com, so your phone reaches it from any network with nothing to open on your router and no VPN.
 
-```bash
-agent-os connect   # links this machine with the code from runagentos.com
-```
+- **Free ($0):** Connect for one machine, including phone access from anywhere, on up to 3 devices.
+- **Pro ($4/mo billed yearly, or $6 monthly):** link up to 10 machines, with unlimited devices and 100 GB of traffic a month.
+
+[Sign up](https://runagentos.com/sign-in?mode=sign-up), then run `agent-os connect` on the machine and enter the code. The [phone guide](docs/guides/phone.md) has the steps.
 
 Reach it from your phone with the [AgentOS iPhone app](https://apps.apple.com/us/app/agentos-coding-agents/id6820980797), now on the App Store.
 

package/app/api/shares/route.test.ts

@@ -117,7 +117,7 @@ const one = await import("./[id]/route");
 const { saveItem } = await import("@/lib/chat/store");
 const { seedSession } = await import("@/lib/orchestrator/testing");
 const { createProject } = await import("@/lib/projects");
-const { createArtifact } = await import("@/lib/artifacts/store");
+const { createArtifact, saveArtifact } = await import("@/lib/artifacts/store");
 const { getDb } = await import("@/lib/db");
 
 const secret = ["gh", "p_", "b".repeat(36)].join("");
@@ -341,6 +341,71 @@ describe("create", () => {
     expect(html).toContain("noindex");
   });
 
+  describe("follow latest", () => {
+    const page = (html: string) =>
+      `<html><head></head><body>${html}</body></html>`;
+    async function create(artifactId: string, extra: object = {}) {
+      const body = { kind: "artifact", artifactId, ...extra };
+      const p = await (
+        await preview.POST(post("/api/shares/preview", body))
+      ).json();
+      return shares.POST(
+        post("/api/shares", {
+          ...body,
+          sharedAt: p.sharedAt,
+          hash: p.hash,
+          expiresIn: "7d",
+        })
+      );
+    }
+    const stored = () =>
+      getDb().prepare(`SELECT follow_latest, version FROM shared_links`).get();
+
+    it("pins the shown version by default", async () => {
+      const sid = chat();
+      saveArtifact(sid, "Doc", page("one"), { sameTitle: true });
+      const v2 = saveArtifact(sid, "Doc", page("two"), {
+        sameTitle: true,
+      }).artifact;
+      expect((await create(v2.id)).status).toBe(201);
+      expect(stored()).toEqual({ follow_latest: 0, version: 2 });
+      const listed = await (await shares.GET()).json();
+      expect(listed.shares[0]).toMatchObject({ follow: false, version: 2 });
+    });
+
+    it("keeps follow: latest on the link and lists it", async () => {
+      const sid = chat();
+      const v1 = saveArtifact(sid, "Doc", page("one"), {
+        sameTitle: true,
+      }).artifact;
+      expect((await create(v1.id, { follow: "latest" })).status).toBe(201);
+      expect(stored()).toEqual({ follow_latest: 1, version: 1 });
+      const listed = await (await shares.GET()).json();
+      expect(listed.shares[0]).toMatchObject({ follow: true, version: 1 });
+    });
+
+    it("refuses to follow from an older version, and for a chat", async () => {
+      const sid = chat();
+      const v1 = saveArtifact(sid, "Doc", page("one"), {
+        sameTitle: true,
+      }).artifact;
+      saveArtifact(sid, "Doc", page("two"), { sameTitle: true });
+      const old = await create(v1.id, { follow: "latest" });
+      expect(old.status).toBe(409);
+      expect((await old.json()).error).toMatch(/share v2/);
+      const res = await shares.POST(
+        post("/api/shares", {
+          kind: "chat",
+          sessionId: sid,
+          follow: "latest",
+          hash: "x",
+        })
+      );
+      expect(res.status).toBe(400);
+      expect(seen).toHaveLength(0);
+    });
+  });
+
   it("says so when Connect isn't linked, and for a bad expiry or hash", async () => {
     const id = chat();
     const p = await previewOf(id);

package/app/api/shares/route.ts

@@ -12,6 +12,7 @@ import {
   buildPage,
   parseRequest,
 } from "@/lib/share/service";
+import { getArtifact, latestVersion } from "@/lib/artifacts/store";
 import { insertSharedLink, listSharedLinks } from "@/lib/share/store";
 import type { ShareExpiry } from "@/lib/connect/control-api";
 
@@ -31,6 +32,16 @@ export async function POST(request: Request) {
     if (typeof body?.hash !== "string") return fail("hash is required.", 400);
     if (!linked()) return fail(NOT_LINKED, 409);
 
+    const artifact = req.artifactId ? getArtifact(req.artifactId) : undefined;
+    if (req.follow && artifact) {
+      const latest = latestVersion(artifact.page_id);
+      if (latest && latest.id !== artifact.id)
+        return fail(
+          `v${artifact.version} isn't the latest; share v${latest.version} to follow the page.`,
+          409
+        );
+    }
+
     const page = await buildPage(req);
     if (page.tooBig) return fail(TOO_BIG, 413);
     if (page.hash !== body.hash)
@@ -53,6 +64,8 @@ export async function POST(request: Request) {
       expires_at: share.expires_at,
       created_at: share.created_at,
       revoked_at: null,
+      follow_latest: req.follow ? 1 : 0,
+      version: artifact?.version ?? null,
     });
     return NextResponse.json(
       { id: share.id, url: share.url, expiresAt: share.expires_at },
@@ -96,6 +109,8 @@ export async function GET() {
         status,
         views: r ? r.view_count : null,
         lastViewedAt: r?.last_viewed_at ?? null,
+        follow: l.follow_latest === 1,
+        version: l.version,
       };
     }),
   });

package/components/DemoNotice.tsx

@@ -1,4 +1,8 @@
 import { Info } from "lucide-react";
+import { Button } from "@/components/ui/button";
+import { CONNECT_SIGN_UP } from "@/lib/connect/view";
+
+const INSTALL_URL = "https://github.com/saadnvd1/agent-os#install";
 
 // Where a terminal or a new session would be, in a demo: what this is and
 // what to look at instead. Fixed text; nothing runs.
@@ -18,6 +22,18 @@ export function DemoNotice() {
           Open a session from the sidebar to read its chat, its changes and its
           pull request; its terminal stays closed.
         </p>
+        <div className="flex flex-wrap gap-2 pt-1">
+          <Button asChild className="min-h-11 sm:min-h-9">
+            <a href={INSTALL_URL} target="_blank" rel="noopener noreferrer">
+              Install AgentOS
+            </a>
+          </Button>
+          <Button asChild variant="outline" className="min-h-11 sm:min-h-9">
+            <a href={CONNECT_SIGN_UP} target="_blank" rel="noopener noreferrer">
+              Get Connect
+            </a>
+          </Button>
+        </div>
       </div>
     </div>
   );

package/components/Devices/ConnectCard.tsx

@@ -3,7 +3,11 @@
 import { Cloud } from "lucide-react";
 import { Switch } from "@/components/ui/switch";
 import type { ConnectStatus } from "@/lib/connect/serve";
-import { CONNECT_STATE as STATE, connectView } from "@/lib/connect/view";
+import {
+  CONNECT_SIGN_UP,
+  CONNECT_STATE as STATE,
+  connectView,
+} from "@/lib/connect/view";
 
 export function ConnectCard({
   connect,
@@ -38,7 +42,21 @@ export function ConnectCard({
           ) : enrolled ? (
             <>Linked. The address appears once the tunnel starts.</>
           ) : (
-            <>Not set up on this machine. Run agent-os connect in a terminal.</>
+            <>
+              Not set up on this machine. Run{" "}
+              <code className="text-foreground font-mono">
+                agent-os connect
+              </code>{" "}
+              in a terminal.{" "}
+              <a
+                href={CONNECT_SIGN_UP}
+                target="_blank"
+                rel="noopener noreferrer"
+                className="text-foreground flex min-h-11 w-fit items-center underline underline-offset-2 sm:min-h-6"
+              >
+                Set up Connect (free)
+              </a>
+            </>
           )}
           {connect.reason && connect.state !== "off"
             ? ` ${connect.reason.replace(/\.$/, "")}.`

package/components/Models/ProviderCard.tsx

@@ -73,7 +73,7 @@ export function ProviderCard({
   const builtIn = provider.id === ANTHROPIC;
   const [open, setOpen] = useState(false);
   const [kind, setKind] = useState<SecretRef["kind"]>(
-    provider.auth?.kind ?? "tokenvault"
+    provider.auth?.kind ?? "env"
   );
   const [a0, b0] = refFields(provider.auth);
   const [a, setA] = useState(a0);

package/components/SessionList/SidebarBody.tsx

@@ -3,6 +3,7 @@
 import { AlertCircle, FolderPlus, Plus, X } from "lucide-react";
 import { Button } from "@/components/ui/button";
 import { ShimmeringLoader } from "@/components/ui/skeleton";
+import { chordHint } from "@/lib/keybindings/chord";
 import { sidebarUiActions } from "@/stores/sidebarUi";
 import type { SidebarData } from "./useSidebarData";
 import { MachineShelves, SessionShelves } from "./SessionShelves";
@@ -99,10 +100,19 @@ export function SidebarBody({
           <Empty
             text="Create a project to start your first session"
             action={
-              <Button onClick={onNewProject} className="h-11 gap-2 md:h-9">
-                <FolderPlus className="h-4 w-4" />
-                Add project
-              </Button>
+              <div className="flex flex-col items-center gap-3">
+                <Button onClick={onNewProject} className="h-11 gap-2 md:h-9">
+                  <FolderPlus className="h-4 w-4" />
+                  Add project
+                </Button>
+                <p className="text-muted-foreground/70 text-xs">
+                  Then press{" "}
+                  <kbd className="bg-muted text-foreground rounded px-1.5 py-0.5 font-mono">
+                    {chordHint("alt+n")}
+                  </kbd>{" "}
+                  to start a session
+                </p>
+              </div>
             }
           />
         ) : (

package/components/Share/ShareDialog.tsx

@@ -19,6 +19,7 @@ import {
   SelectValue,
 } from "@/components/ui/select";
 import { DownloadMenu } from "./DownloadMenu";
+import { cn } from "@/lib/utils";
 import { Switch } from "@/components/ui/switch";
 import { writeClipboard } from "@/hooks/useCopyToClipboard";
 import {
@@ -76,6 +77,7 @@ function ShareBody({
   const [preview, setPreview] = useState<SharePreview | null>(null);
   const [error, setError] = useState<string | null>(null);
   const [created, setCreated] = useState<string | null>(null);
+  const [follow, setFollow] = useState(false);
   const [copied, setCopied] = useState(false);
   const [tab, setTab] = useState<"page" | "markdown">("page");
   const previewReq = useSharePreview();
@@ -121,6 +123,7 @@ function ShareBody({
         sharedAt: preview.sharedAt,
         hash: preview.hash,
         expiresIn,
+        follow: follow ? "latest" : undefined,
       });
       setCreated(res.url);
       try {
@@ -235,6 +238,48 @@ function ShareBody({
             </>
           )}
 
+          {linked && kind === "artifact" && (
+            <fieldset className="space-y-2">
+              <legend className="text-muted-foreground mb-1 text-xs font-medium">
+                What the link shows
+              </legend>
+              {[
+                {
+                  value: false,
+                  title: `This version${target.version ? ` (v${target.version})` : ""}`,
+                  hint: "Never changes. You review it above before it goes out.",
+                },
+                {
+                  value: true,
+                  title: "Always the latest",
+                  hint: "Updates when the agent makes a new version. New versions are redacted the same way but publish without a fresh preview.",
+                },
+              ].map((o) => (
+                <label
+                  key={o.title}
+                  className={cn(
+                    "flex min-h-11 cursor-pointer items-start gap-3 rounded-lg border px-3 py-2 text-sm",
+                    follow === o.value && "border-primary bg-primary/5"
+                  )}
+                >
+                  <input
+                    type="radio"
+                    name="share-follow"
+                    className="mt-1 h-4 w-4 shrink-0"
+                    checked={follow === o.value}
+                    onChange={() => setFollow(o.value)}
+                  />
+                  <span className="min-w-0">
+                    <span className="block font-medium">{o.title}</span>
+                    <span className="text-muted-foreground block text-xs">
+                      {o.hint}
+                    </span>
+                  </span>
+                </label>
+              ))}
+            </fieldset>
+          )}
+
           {linked && (
             <label className="flex min-h-11 items-center justify-between gap-3 text-sm">
               <span>Link expires after</span>

package/components/Shares/SharedLinksPanel.tsx

@@ -60,6 +60,13 @@ function Row({ share }: { share: SharedLinkRow }) {
         <div className="truncate text-sm font-medium">{title}</div>
         <div className="text-muted-foreground flex flex-wrap gap-x-3 text-xs">
           <span>{share.kind === "chat" ? "Chat" : "Page"}</span>
+          {share.kind === "artifact" && (
+            <span>
+              {share.follow
+                ? `Follows latest${share.version ? ` · now v${share.version}` : ""}`
+                : `pinned${share.version ? ` v${share.version}` : ""}`}
+            </span>
+          )}
           <span>Created {when(share.createdAt)}</span>
           <span>
             {share.status === "revoked"

package/components/Welcome/ConnectBlock.tsx

@@ -13,7 +13,11 @@ import {
   useNetworkQuery,
   useUpdateNetwork,
 } from "@/data/devices";
-import { CONNECT_SITE, CONNECT_STATE, connectView } from "@/lib/connect/view";
+import {
+  CONNECT_SIGN_UP,
+  CONNECT_STATE,
+  connectView,
+} from "@/lib/connect/view";
 import { Block } from "./Block";
 
 const COMMAND = "agent-os connect";
@@ -40,7 +44,7 @@ export function LinkForm() {
       <p className="text-muted-foreground text-xs">
         Get a code at{" "}
         <a
-          href={CONNECT_SITE}
+          href={CONNECT_SIGN_UP}
           target="_blank"
           rel="noopener noreferrer"
           className="text-foreground inline-flex items-center gap-1 underline underline-offset-2"
@@ -48,7 +52,7 @@ export function LinkForm() {
           runagentos.com
           <ExternalLink className="size-3" />
         </a>{" "}
-        (Connect a machine), then paste it here.
+        (free account, then Connect a machine), then paste it here.
       </p>
       <form
         className="flex gap-2"
@@ -104,7 +108,7 @@ export function ConnectBlock() {
     <Block
       icon={Globe}
       title="Use it away from home"
-      detail="Connect gives this machine a private address at runagentos.com, so your phone reaches it from anywhere. Nothing to open on your router."
+      detail="Connect is free for one machine. It gives this machine a private address at runagentos.com, so your phone reaches it from anywhere. Nothing to open on your router."
     >
       {network.isPending ? (
         <div className="bg-muted/40 h-12 animate-pulse rounded-lg" />

package/components/Welcome/WelcomeDialog.tsx

@@ -28,7 +28,7 @@ const STEPS: Record<
   agents: {
     label: "Agents",
     title: "Connect your agents",
-    hint: "Install and sign in the coding agents you want to use. You need one.",
+    hint: "Install and sign in the coding agents you want to use. You need one, with an account such as Claude or Codex.",
   },
   project: {
     label: "Project",

package/lib/artifacts/tools.ts

@@ -19,6 +19,7 @@ import {
   MAX_TITLE_CHARS,
   type Artifact,
 } from "./store";
+import { followLatest } from "../share/follow";
 import { previewHtml } from "./preview";
 
 export const VISUALS_SERVER = "visuals";
@@ -101,7 +102,10 @@ export async function renderPage(
       readSource(args, ctx.cwd),
       { update: args.update, note: args.note, sameTitle: true }
     );
-    if (created) ctx.onRender(artifact, args.height);
+    if (created) {
+      ctx.onRender(artifact, args.height);
+      if (artifact.version > 1) followLatest(artifact.page_id);
+    }
     const name = `"${artifact.title}"${artifact.version > 1 ? ` v${artifact.version}` : ""}`;
     return {
       content: [

package/lib/connect/control-api.ts

@@ -428,6 +428,21 @@ export async function uploadShare(
   return { ...shareFrom(r), url };
 }
 
+/** Replaces a live share's content under the same link. */
+export async function replaceShare(
+  config: ConnectConfig,
+  privateKey: string,
+  id: string,
+  share: { title: string; html: string; markdown: string }
+): Promise<void> {
+  if (!/^[a-z0-9]{12}$/.test(id)) throw new Error("not a share id");
+  await signed(config, privateKey)(
+    "PUT",
+    `/api/v1/machines/${config.machineId}/shares/${id}`,
+    { title: share.title, html: share.html, markdown: share.markdown }
+  );
+}
+
 export async function listShares(
   config: ConnectConfig,
   privateKey: string

package/lib/connect/view.ts

@@ -1,6 +1,7 @@
 import type { ConnectStatus } from "./serve";
 
 export const CONNECT_SITE = "https://runagentos.com";
+export const CONNECT_SIGN_UP = `${CONNECT_SITE}/sign-in?mode=sign-up`;
 
 export const CONNECT_STATE: Record<ConnectStatus["state"], string> = {
   up: "Connected",

package/lib/db/migrations/20261029T1300_shared_links_follow.ts

@@ -0,0 +1,28 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  key: "20261029T1300_shared_links_follow",
+  up: (db) => {
+    // follow_latest: the link is re-uploaded whenever its page gets a new
+    // version. version: the page version the link shows now (pinned or not).
+    const cols = new Set(
+      (
+        db.prepare(`PRAGMA table_info(shared_links)`).all() as {
+          name: string;
+        }[]
+      ).map((c) => c.name)
+    );
+    if (!cols.has("follow_latest"))
+      db.exec(
+        `ALTER TABLE shared_links ADD COLUMN follow_latest INTEGER NOT NULL DEFAULT 0`
+      );
+    if (!cols.has("version"))
+      db.exec(`ALTER TABLE shared_links ADD COLUMN version INTEGER`);
+    // Links made before this show the version their artifact row is.
+    db.exec(
+      `UPDATE shared_links SET version = (
+         SELECT a.version FROM artifacts a WHERE a.id = shared_links.artifact_id
+       ) WHERE version IS NULL AND artifact_id IS NOT NULL`
+    );
+  },
+} satisfies Migration;

package/lib/share/connect.ts

@@ -5,6 +5,7 @@ import {
   ApiError,
   clean,
   listShares,
+  replaceShare,
   revokeShare,
   uploadShare,
   type RemoteShare,
@@ -70,6 +71,15 @@ export async function createRemote(share: {
   }
 }
 
+/** Puts new content under a live link. Throws the raw ApiError, so the caller can tell a dead link from a failed try. */
+export async function replaceRemote(
+  id: string,
+  content: { title: string; html: string; markdown: string }
+): Promise<void> {
+  const { config, machineKey } = files();
+  await replaceShare(config, machineKey, id, content);
+}
+
 export async function listRemote(): Promise<RemoteShare[]> {
   const { config, machineKey } = files();
   return listShares(config, machineKey);

package/lib/share/follow.ts

@@ -0,0 +1,76 @@
+/**
+ * Follow-latest share links: when a page gets a new version, every live link
+ * that follows it is re-uploaded through Connect's PUT, built the same way as
+ * a normal share (same snapshot, same redaction). Nothing here throws into
+ * the caller: a failed try is logged and the next version tries again, and
+ * the content already on the link stays live meanwhile.
+ */
+
+import { ApiError } from "@/lib/connect/control-api";
+import { latestVersion } from "@/lib/artifacts/store";
+import { linked, replaceRemote } from "./connect";
+import { BadShare, buildPage } from "./service";
+import { listFollowing, setLinkVersion, stopFollowing } from "./store";
+
+// One run per page at a time, so two quick versions can't land out of order.
+const running = new Map<string, Promise<void>>();
+
+export function followLatest(pageId: string): Promise<void> {
+  const next = (running.get(pageId) ?? Promise.resolve())
+    .then(() => run(pageId))
+    .catch((err) => console.error("[share-follow]", pageId, err))
+    .finally(() => {
+      if (running.get(pageId) === next) running.delete(pageId);
+    });
+  running.set(pageId, next);
+  return next;
+}
+
+async function run(pageId: string): Promise<void> {
+  const latest = latestVersion(pageId);
+  if (!latest) return;
+  // A link that missed an earlier version is behind too, so this is also the retry.
+  const behind = listFollowing(pageId).filter(
+    (l) => (l.version ?? 0) < latest.version
+  );
+  if (!behind.length || !linked()) return;
+  let page;
+  try {
+    page = await buildPage({
+      kind: "artifact",
+      artifactId: latest.id,
+      includeTools: false,
+      sharedAt: new Date().toISOString(),
+    });
+  } catch (err) {
+    console.error(
+      "[share-follow] could not build",
+      latest.id,
+      err instanceof BadShare ? err.message : err
+    );
+    return;
+  }
+  if (page.tooBig) {
+    console.error("[share-follow] v%d is too big to share", latest.version);
+    return;
+  }
+  for (const link of behind) {
+    try {
+      await replaceRemote(link.id, {
+        title: page.title,
+        html: page.html,
+        markdown: page.markdown,
+      });
+      setLinkVersion(link.id, latest.version, page.title);
+    } catch (err) {
+      if (err instanceof ApiError && (err.status === 404 || err.status === 410))
+        stopFollowing(link.id);
+      console.error(
+        "[share-follow] %s stays on v%s:",
+        link.id,
+        link.version,
+        err instanceof Error ? err.message : err
+      );
+    }
+  }
+}

package/lib/share/service.ts

@@ -25,6 +25,7 @@ export interface ShareRequest {
   includeTools: boolean;
   /** Messages the reader left out in the preview. */
   dropIds?: string[];
+  follow?: "latest";
   sharedAt: string;
 }
 
@@ -86,6 +87,10 @@ export function parseRequest(raw: unknown, sharedAt?: unknown): ShareRequest {
       throw new BadShare("dropIds must be a list of ids", 400);
     dropIds = b.dropIds as string[];
   }
+  if (b.follow !== undefined && b.follow !== "latest")
+    throw new BadShare("follow must be latest", 400);
+  if (b.follow && kind !== "artifact")
+    throw new BadShare("Only a page can follow its latest version", 400);
   const at = typeof sharedAt === "string" ? sharedAt : new Date().toISOString();
   if (Number.isNaN(Date.parse(at)))
     throw new BadShare("sharedAt is not a date", 400);
@@ -95,6 +100,7 @@ export function parseRequest(raw: unknown, sharedAt?: unknown): ShareRequest {
     artifactId,
     includeTools: b.includeTools === true,
     dropIds,
+    follow: b.follow === "latest" ? "latest" : undefined,
     sharedAt: at,
   };
 }

package/lib/share/store.ts

@@ -10,13 +10,16 @@ export interface SharedLink {
   expires_at: string | null;
   created_at: string;
   revoked_at: string | null;
+  follow_latest: number;
+  // The page version the link shows now.
+  version: number | null;
 }
 
 export function insertSharedLink(link: SharedLink): void {
   db.prepare(
     `INSERT INTO shared_links
-       (id, url, kind, title, session_id, artifact_id, expires_at, created_at, revoked_at)
-     VALUES (@id, @url, @kind, @title, @session_id, @artifact_id, @expires_at, @created_at, @revoked_at)`
+       (id, url, kind, title, session_id, artifact_id, expires_at, created_at, revoked_at, follow_latest, version)
+     VALUES (@id, @url, @kind, @title, @session_id, @artifact_id, @expires_at, @created_at, @revoked_at, @follow_latest, @version)`
   ).run(link);
 }
 
@@ -36,3 +39,32 @@ export function markRevoked(id: string): void {
     `UPDATE shared_links SET revoked_at = COALESCE(revoked_at, ?) WHERE id = ?`
   ).run(new Date().toISOString(), id);
 }
+
+/** Live follow-latest links to any version of a page. */
+export function listFollowing(pageId: string): SharedLink[] {
+  return db
+    .prepare(
+      `SELECT l.* FROM shared_links l JOIN artifacts a ON a.id = l.artifact_id
+       WHERE a.page_id = ? AND l.follow_latest = 1 AND l.revoked_at IS NULL
+         AND (l.expires_at IS NULL OR l.expires_at > ?)
+       ORDER BY l.created_at, l.rowid`
+    )
+    .all(pageId, new Date().toISOString()) as SharedLink[];
+}
+
+export function setLinkVersion(
+  id: string,
+  version: number,
+  title: string
+): void {
+  db.prepare(`UPDATE shared_links SET version = ?, title = ? WHERE id = ?`).run(
+    version,
+    title,
+    id
+  );
+}
+
+/** Connect no longer has it: stop trying. */
+export function stopFollowing(id: string): void {
+  db.prepare(`UPDATE shared_links SET follow_latest = 0 WHERE id = ?`).run(id);
+}

package/lib/share/view.ts

@@ -7,6 +7,8 @@ export interface ShareTarget {
   kind: "chat" | "artifact";
   sessionId?: string;
   artifactId?: string;
+  /** A page link that is re-uploaded when the page gets a new version. */
+  follow?: "latest";
 }
 
 export interface PreviewRequest extends ShareTarget {
@@ -52,6 +54,10 @@ export interface SharedLinkRow {
   status: "active" | "expired" | "revoked";
   views: number | null;
   lastViewedAt: string | null;
+  /** True when the link follows the page's latest version. */
+  follow: boolean;
+  /** The page version the link shows now. */
+  version: number | null;
 }
 
 export interface SharesResponse {

package/package.json

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