@openagt/dashboard 0.24.0 → 0.26.0

package/dist/dashboard-rpc/test-context.js

@@ -12,6 +12,7 @@ export function testDashboardContext(over = {}) {
     return {
         startAgent: () => ({ ok: false, error: 'not wired in this test' }),
         addProject: () => ({ ok: false, error: 'not wired in this test' }),
+        startedIn: () => ({ ok: false, error: 'not wired in this test' }),
         removeProject: () => ({ ok: false, error: 'not wired in this test' }),
         eventsSource: () => undefined,
         remote: { target: () => undefined, list: () => [], working: () => false, rekey: () => { }, sent: () => true, home: async () => undefined, follow: async () => { }, machineNames: async () => () => undefined },
@@ -28,8 +29,8 @@ export function testDashboardContext(over = {}) {
  * test asserting one route still stands up the same server the product does.
  */
 export function testDashboardOptions(over = {}) {
-    const { startAgent, addProject, removeProject, ...rest } = testDashboardContext();
-    return { port: 0, onStart: startAgent, onAddProject: addProject, onRemoveProject: removeProject, ...rest, ...over };
+    const { startAgent, addProject, startedIn, removeProject, ...rest } = testDashboardContext();
+    return { port: 0, onStart: startAgent, onAddProject: addProject, onStartedIn: startedIn, onRemoveProject: removeProject, ...rest, ...over };
 }
 /**
  * Wire the dashboard's capabilities for a test that calls an RPC directly.

package/dist/dashboard-rpc/test-context.js.map

@@ -1 +1 @@
-{"version":3,"file":"test-context.js","sourceRoot":"","sources":["../../src/dashboard-rpc/test-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AAClD,OAAO,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAA;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAA;AAI1D;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAI,GAA8B,EAAE;IACvE,OAAO;QACL,UAAU,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,wBAAwB,EAAE,CAAC;QAClE,UAAU,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,wBAAwB,EAAE,CAAC;QAClE,aAAa,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,wBAAwB,EAAE,CAAC;QACrE,YAAY,EAAE,GAAG,EAAE,CAAC,SAAS;QAC7B,MAAM,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,SAAS,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC,EAAE,YAAY,EAAE,KAAK,IAAI,EAAE,CAAC,GAAG,EAAE,CAAC,SAAS,EAAE;QAC5M,WAAW,EAAE,wBAAwB,EAAE;QACvC,KAAK,EAAE,kBAAkB,EAAE;QAC3B,MAAM,EAAE,EAAE,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,aAAa,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE;QACxF,aAAa,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;QACrC,aAAa,EAAE,EAAE,MAAM,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC,EAAE,IAAI,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC,EAAE,GAAG,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC,EAAE;QAC3H,GAAG,IAAI;KACR,CAAA;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAI,GAA8B,EAAE;IACvE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,aAAa,EAAE,GAAG,IAAI,EAAE,GAAG,oBAAoB,EAAE,CAAA;IACjF,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,aAAa,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,EAAE,CAAA;AACrH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAI,GAA8B,EAAE;IACrE,mBAAmB,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC,CAAA;AACjD,CAAC"}
+{"version":3,"file":"test-context.js","sourceRoot":"","sources":["../../src/dashboard-rpc/test-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AAClD,OAAO,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAA;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAA;AAI1D;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAI,GAA8B,EAAE;IACvE,OAAO;QACL,UAAU,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,wBAAwB,EAAE,CAAC;QAClE,UAAU,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,wBAAwB,EAAE,CAAC;QAClE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,wBAAwB,EAAE,CAAC;QACjE,aAAa,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,wBAAwB,EAAE,CAAC;QACrE,YAAY,EAAE,GAAG,EAAE,CAAC,SAAS;QAC7B,MAAM,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,SAAS,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC,EAAE,YAAY,EAAE,KAAK,IAAI,EAAE,CAAC,GAAG,EAAE,CAAC,SAAS,EAAE;QAC5M,WAAW,EAAE,wBAAwB,EAAE;QACvC,KAAK,EAAE,kBAAkB,EAAE;QAC3B,MAAM,EAAE,EAAE,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,aAAa,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE;QACxF,aAAa,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;QACrC,aAAa,EAAE,EAAE,MAAM,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC,EAAE,IAAI,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC,EAAE,GAAG,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC,EAAE;QAC3H,GAAG,IAAI;KACR,CAAA;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAI,GAA8B,EAAE;IACvE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,GAAG,IAAI,EAAE,GAAG,oBAAoB,EAAE,CAAA;IAC5F,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,SAAS,EAAE,eAAe,EAAE,aAAa,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,EAAE,CAAA;AAC7I,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAI,GAA8B,EAAE;IACrE,mBAAmB,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC,CAAA;AACjD,CAAC"}

package/dist/join-dashboard.d.ts

@@ -0,0 +1,21 @@
+import type { StartedInResult } from './dashboard/types.js';
+/**
+ * A second `openagent` on a port a dashboard already listens on (#2141): it asks that port whether
+ * it is OpenAgent's, and if it is, hands it the folder it was started in. Binding first and asking
+ * only on `EADDRINUSE` leaves the common start as it was, with no race between a look and a bind.
+ *
+ * The call is a plain RPC: with no `Origin` and a loopback `Host`, the dashboard's guards let it
+ * by, as they let any program on this computer call `sendAddProject`.
+ */
+/** What the port answered: OpenAgent's dashboard, its version and the folder's project; or something else. */
+export type JoinedDashboard = {
+    joined: true;
+    url: string;
+    version: string;
+    project?: StartedInResult;
+} | {
+    joined: false;
+};
+/** Hand `folder` (undefined outside a repository) to the dashboard on `port` of this computer. */
+export declare function joinRunningDashboard(port: number, folder: string | undefined): Promise<JoinedDashboard>;
+//# sourceMappingURL=join-dashboard.d.ts.map

package/dist/join-dashboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"join-dashboard.d.ts","sourceRoot":"","sources":["../src/join-dashboard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAE3D;;;;;;;GAOG;AAEH,8GAA8G;AAC9G,MAAM,MAAM,eAAe,GACvB;IAAE,MAAM,EAAE,IAAI,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,eAAe,CAAA;CAAE,GACzE;IAAE,MAAM,EAAE,KAAK,CAAA;CAAE,CAAA;AAErB,kGAAkG;AAClG,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,eAAe,CAAC,CAgB7G"}

package/dist/join-dashboard.js

@@ -0,0 +1,22 @@
+/** Hand `folder` (undefined outside a repository) to the dashboard on `port` of this computer. */
+export async function joinRunningDashboard(port, folder) {
+    const url = `http://127.0.0.1:${port}`;
+    try {
+        const res = await fetch(`${url}/_rpc/sendStartedAgain`, {
+            method: 'POST',
+            headers: { 'content-type': 'application/json' },
+            body: JSON.stringify([folder ?? null]),
+        });
+        if (!res.ok)
+            return { joined: false };
+        const { ret } = (await res.json());
+        if (typeof ret?.version !== 'string')
+            return { joined: false };
+        return { joined: true, url, version: ret.version, ...(ret.project ? { project: ret.project } : {}) };
+    }
+    catch {
+        // Refused, or not JSON: no OpenAgent dashboard answers there.
+        return { joined: false };
+    }
+}
+//# sourceMappingURL=join-dashboard.js.map

package/dist/join-dashboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"join-dashboard.js","sourceRoot":"","sources":["../src/join-dashboard.ts"],"names":[],"mappings":"AAgBA,kGAAkG;AAClG,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,IAAY,EAAE,MAA0B;IACjF,MAAM,GAAG,GAAG,oBAAoB,IAAI,EAAE,CAAA;IACtC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,GAAG,wBAAwB,EAAE;YACtD,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,IAAI,IAAI,CAAC,CAAC;SACvC,CAAC,CAAA;QACF,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAA;QACrC,MAAM,EAAE,GAAG,EAAE,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAA+D,CAAA;QAChG,IAAI,OAAO,GAAG,EAAE,OAAO,KAAK,QAAQ;YAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAA;QAC9D,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAA;IACtG,CAAC;IAAC,MAAM,CAAC;QACP,8DAA8D;QAC9D,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAA;IAC1B,CAAC;AACH,CAAC"}

package/dist/module-types/dashboard/components/ui/card.d.ts

@@ -1,4 +1,4 @@
-import type { HTMLAttributes, ReactNode } from 'react';
+import { type HTMLAttributes, type ReactNode } from 'react';
 export declare function Card({ className, ...props }: HTMLAttributes<HTMLDivElement>): import("react").JSX.Element;
 export declare function CardHeader({ className, ...props }: HTMLAttributes<HTMLDivElement>): import("react").JSX.Element;
 export declare function CardTitle({ className, ...props }: HTMLAttributes<HTMLHeadingElement>): import("react").JSX.Element;

package/dist/module-types/dashboard/components/ui/checkbox.d.ts

@@ -1,5 +1,5 @@
 import type { ComponentProps } from 'react';
-import { Checkbox as CheckboxPrimitive } from '@base-ui-components/react/checkbox';
+import { Checkbox as CheckboxPrimitive } from '@base-ui/react/checkbox';
 type CheckboxProps = Omit<ComponentProps<typeof CheckboxPrimitive.Root>, 'disabled'> & {
     disabled?: boolean | undefined;
 };

package/dist/module-types/dashboard/components/ui/context-menu.d.ts

@@ -1,3 +1,3 @@
-import { ContextMenu as BaseContextMenu } from '@base-ui-components/react/context-menu';
+import { ContextMenu as BaseContextMenu } from '@base-ui/react/context-menu';
 export declare const ContextMenu: typeof BaseContextMenu.Root;
-export declare const ContextMenuTrigger: import("react").ForwardRefExoticComponent<import("@base-ui-components/react/context-menu").ContextMenuTriggerProps & import("react").RefAttributes<HTMLDivElement>>;
+export declare const ContextMenuTrigger: import("react").ForwardRefExoticComponent<Omit<import("@base-ui/react").ContextMenuTriggerProps, "ref"> & import("react").RefAttributes<HTMLDivElement>>;

package/dist/module-types/dashboard/components/ui/dropdown-menu.d.ts

@@ -1,7 +1,7 @@
-import { Menu } from '@base-ui-components/react/menu';
+import { Menu } from '@base-ui/react/menu';
 import type { ComponentProps } from 'react';
 export declare const DropdownMenu: typeof Menu.Root;
-export declare const DropdownMenuGroup: import("react").ForwardRefExoticComponent<import("@base-ui-components/react/menu").MenuGroupProps & import("react").RefAttributes<Element>>;
+export declare const DropdownMenuGroup: import("react").ForwardRefExoticComponent<Omit<import("@base-ui/react").MenuGroupProps, "ref"> & import("react").RefAttributes<HTMLDivElement>>;
 export declare const DropdownMenuSub: typeof Menu.SubmenuRoot;
 export declare function DropdownMenuTrigger({ className, ...props }: ComponentProps<typeof Menu.Trigger>): import("react").JSX.Element;
 export declare function DropdownMenuContent({ className, sideOffset, align, children, ...props }: ComponentProps<typeof Menu.Popup> & {

package/dist/module-types/dashboard/components/ui/popover.d.ts

@@ -1,4 +1,4 @@
-import { Popover as BasePopover } from '@base-ui-components/react/popover';
+import { Popover as BasePopover } from '@base-ui/react/popover';
 import type { ComponentProps } from 'react';
 export declare const Popover: typeof BasePopover.Root;
 export declare function PopoverTrigger({ className, ...props }: ComponentProps<typeof BasePopover.Trigger>): import("react").JSX.Element;

package/dist/module-types/dashboard/components/ui/radio-group.d.ts

@@ -1,6 +1,6 @@
 import { type ComponentProps, type ReactNode } from 'react';
-import { RadioGroup as RadioGroupPrimitive } from '@base-ui-components/react/radio-group';
-import { Radio } from '@base-ui-components/react/radio';
+import { RadioGroup as RadioGroupPrimitive } from '@base-ui/react/radio-group';
+import { Radio } from '@base-ui/react/radio';
 type RadioGroupProps = Omit<ComponentProps<typeof RadioGroupPrimitive>, 'disabled'> & {
     disabled?: boolean | undefined;
 };

package/dist/module-types/dashboard/components/ui/scroll-area.d.ts

@@ -1,4 +1,4 @@
-import { ScrollArea as ScrollAreaPrimitive } from '@base-ui-components/react/scroll-area';
+import { ScrollArea as ScrollAreaPrimitive } from '@base-ui/react/scroll-area';
 export declare function ScrollArea({ className, children, viewportClassName, ...props }: ScrollAreaPrimitive.Root.Props & {
     /** Extra classes on the viewport — where the height cap belongs when the Root has no definite
      *  height. A `max-h-*` on the Root only caps the box; the viewport's `h-full` cannot resolve

package/dist/module-types/dashboard/components/ui/select.d.ts

@@ -1,5 +1,5 @@
 import type { ComponentProps } from 'react';
-import { Select as SelectPrimitive } from '@base-ui-components/react/select';
+import { Select as SelectPrimitive } from '@base-ui/react/select';
 export declare const Select: typeof SelectPrimitive.Root;
 export declare function SelectValue(props: ComponentProps<typeof SelectPrimitive.Value>): import("react").JSX.Element;
 export declare function SelectTrigger({ className, size, children, ...props }: ComponentProps<typeof SelectPrimitive.Trigger> & {

package/dist/module-types/dashboard/components/ui/separator.d.ts

@@ -1,3 +1,3 @@
 import type { ComponentProps } from 'react';
-import { Separator as SeparatorPrimitive } from '@base-ui-components/react/separator';
+import { Separator as SeparatorPrimitive } from '@base-ui/react/separator';
 export declare function Separator({ className, orientation, ...props }: ComponentProps<typeof SeparatorPrimitive>): import("react").JSX.Element;

package/dist/module-types/dashboard/components/ui/switch.d.ts

@@ -1,5 +1,5 @@
 import type { ComponentProps } from 'react';
-import { Switch as SwitchPrimitive } from '@base-ui-components/react/switch';
+import { Switch as SwitchPrimitive } from '@base-ui/react/switch';
 type SwitchProps = Omit<ComponentProps<typeof SwitchPrimitive.Root>, 'disabled'> & {
     disabled?: boolean | undefined;
 };

package/dist/module-types/dashboard/components/ui/tooltip.d.ts

@@ -1,7 +1,7 @@
 import type { ComponentProps } from 'react';
-import { Tooltip as TooltipPrimitive } from '@base-ui-components/react/tooltip';
-declare const TooltipProvider: import("react").FC<import("@base-ui-components/react/tooltip").TooltipProviderProps>;
-declare const Tooltip: typeof TooltipPrimitive.Root;
+import { Tooltip as TooltipPrimitive } from '@base-ui/react/tooltip';
+declare const TooltipProvider: import("react").FC<import("@base-ui/react").TooltipProviderProps>;
+declare const Tooltip: <Payload>(props: TooltipPrimitive.Root.Props<Payload>) => React.JSX.Element;
 declare function TooltipTrigger(props: ComponentProps<typeof TooltipPrimitive.Trigger>): import("react").JSX.Element;
 declare function TooltipContent({ className, sideOffset, side, align, children, ...props }: ComponentProps<typeof TooltipPrimitive.Popup> & {
     sideOffset?: number;

package/dist/module-types/dashboard/lib/data-link.d.ts

@@ -1,4 +1,4 @@
-import { type Route } from './route.js';
+import type { Route } from './route.js';
 /** A repository path's page segment and the rest: `tickets/a.md` → `{ segment: 'tickets', rest: ['a.md'] }`; nothing for a path with no page-shaped first segment or no rest. */
 export declare function dataLinkParts(href: string): {
     segment: string;

package/dist/module-types/dashboard/lib/route.d.ts

@@ -1,11 +1,4 @@
-/**
- * Whether a first segment names a page a module adds (#1774) rather than a project: a lowercase
- * letter, then lowercase letters and digits. Never a project's id, which always carries a
- * `-<hash>` suffix, so the router reserves no module's word: whichever module claims the segment
- * gets it, and the shell says "no such page" when none does, or when the picked project
- * has no package that adds it.
- */
-export declare function isPageSegment(segment: string): boolean;
+import { type ProjectAddresses } from '../../src/project-address.js';
 /** What the dashboard is looking at, as carried by the URL. */
 export interface Route {
     /**
@@ -13,38 +6,32 @@ export interface Route {
      * `''` for its first one. Absent when it is closed. Carried as `?settings=<entry>`.
      */
     settings?: string;
-    /** The selected project, or null for the Overview. */
+    /** The project whose agent or "New agent" page shows, by id; null for an Overview and a module's page. */
     projectId: string | null;
-    /** The selected session (agent id), or null for the project's home/launcher. */
+    /** The selected agent, or null for the project's "New agent" page. */
     agentId: string | null;
-    /** A module's page (#1774), by its segment; no project and no agent is selected there. */
+    /** A module's page (#1774), by its segment; no project's own page shows there. */
     page?: string;
     /** The segments after a module page's own, decoded: `/logs/a` carries `['a']`. */
     pagePath?: string[];
     /**
-     * The one project every page shows (#1513), by id; absent when every project shows. Carried as
-     * `?project=<id>` on the Overview and a module's page. On a project's own pages it is that
+     * The one project every page shows (#1513), by id; absent when every project shows. It is the
+     * project the address starts with. On a project's agent and "New agent" pages it is that
      * project, or absent when `?all` is there: never another one.
      */
     scope?: string;
 }
 /**
- * Read the route out of a URL's path and query. Anything unparseable is the Overview, and extra
- * segments are ignored. A project's own page shows its project unless `?all` is there; a
- * `?project=` on it is ignored.
+ * Read the route out of a URL's path and query, naming projects by `projects`. A first segment
+ * that names no project is a module's page when it can be one, and else a project nobody
+ * registered, whose page says so. Extra segments are ignored.
  */
-export declare function parseRoute(url: string): Route;
+export declare function parseRoute(url: string, projects: ProjectAddresses): Route;
 /** The URL for a route, its path and its query — the inverse of {@link parseRoute}. */
-export declare function formatRoute(route: Route): string;
+export declare function formatRoute(route: Route, projects: ProjectAddresses): string;
 /**
  * `url` with the query parameters of `search` that are not the route's own added to it: what a
  * module's page mirrored there (a list's filters) stays when only the picked project changes, or
  * when Settings opens or closes over the page.
  */
 export declare function keepPageQuery(url: string, search: string): string;
-/**
- * The address of a module's page as a link holds it, for a link that must also open in a new
- * tab: the page's segment, with the one project the dashboard is showing when one is picked, so
- * the new tab shows that project too.
- */
-export declare function pageHref(segment: string, url?: string): string;

package/dist/module-types/dashboard/module/index.d.ts

@@ -15,19 +15,21 @@ export interface ModuleProject {
  * link convention below.
  *
  * A link into a project's files (`ModuleLink.href` such as `tickets/2026-01-01_x.md`) opens the
- * mounted page named by its first segment, at `/<segment>/<projectId>/<rest…>`: the path a page
- * gets for it is `[projectId, ...rest]`. So a page that shows one project's file under its own
- * segment is where every such link in the dashboard lands, and the dashboard names no page.
+ * mounted page named by its first segment in that project, at `/<project>/<segment>/<rest…>`: the
+ * page gets `projectId` and `rest` as its path. So a page that shows one project's file under its
+ * own segment is where every such link in the dashboard lands, and the dashboard names no page.
  */
 export interface ModulePageProps {
-    /** The registered projects whose dependencies include the module's package, in the registry's order. */
+    /** The registered projects whose dependencies include the module's package, in the registry's order: only the picked one when one is. */
     projects: ModuleProject[];
+    /** The project the address starts with (`/<project>/<segment>`), picked in the sidebar; null when every project shows. */
+    projectId: string | null;
     /** The URL's segments after the page's own, decoded: `/logs/a` gives `['a']`. */
     path: string[];
 }
 /** A page a module adds: its own URL segment and its row in the sidebar. */
 export interface ModulePage {
-    /** The page's URL, `/<segment>`: a lowercase letter, then lowercase letters and digits (never a project's id, which always has a dash). */
+    /** The page's URL, `/<segment>`, and `/<project>/<segment>` with a project picked: a lowercase letter, then lowercase letters and digits, never `overview` or `settings`. A project named as a page's word is addressed by its id. */
     segment: string;
     /** The sidebar row's label. */
     label: string;
@@ -339,8 +341,14 @@ export interface ModuleHost {
     read(projectId: string, name: string, input?: Record<string, unknown>): Promise<ModuleReadResult>;
     /** Open one agent's page in the dashboard: its live feed while it runs, its record after. */
     openAgent(projectId: string, agentId: string): void;
-    /** Open a page a module adds (this one's or another's), at a sub-path: `openPage('tickets', [projectId, file])`. With a project picked in the dashboard, a page that project's packages do not add shows "No such page". */
-    openPage(segment: string, path?: string[]): void;
+    /**
+     * Open a page a module adds (this one's or another's), at a sub-path, in the project picked in
+     * the dashboard, or in `projectId`, which is then the one picked: `openPage('tickets', [file], projectId)`.
+     * A page the picked project's packages do not add shows "No such page".
+     */
+    openPage(segment: string, path?: string[], projectId?: string): void;
+    /** The address of a page a module adds, with the project picked in the dashboard: a link's `href`, for a link that also opens in a new tab. */
+    pageHref(segment: string): string;
     /**
      * Start a run in one project with this prompt, with the person's own picks (which tool, which
      * model, where it runs), and land on it, unless `land` is false: then the dashboard stays where
@@ -466,6 +474,5 @@ export { useNarrow } from '../lib/use-narrow.js';
 export { useHighlighted, Pieces, type Piece } from '../lib/highlight.js';
 export { useAction } from '../lib/use-action.js';
 export { useSchedule, type Schedule } from '../lib/use-schedule.js';
-export { pageHref } from '../lib/route.js';
 export { useFileNames, pathsIn, type FileNames, type NamedFile } from '../lib/use-file-names.js';
 export { ConfirmDialog } from '../components/ui/confirm-dialog.js';

package/dist/module-types/src/bridge-browser.d.ts

@@ -168,6 +168,8 @@ export interface BridgeBrowserOptions {
     extension?: BridgeExtensionSource | undefined;
     /** Progress, one line at a time, for the dashboard to show while the launch runs. */
     report?: ((detail: string) => void) | undefined;
+    /** Gives the launch up: a step under way is not waited for, and a Chrome already spawned is killed. */
+    signal?: AbortSignal | undefined;
 }
 /**
  * Launch the bridge browser and get it ready: binary, profile, extension, developer mode, token,
@@ -204,12 +206,12 @@ export interface BridgeBrowserOwner {
     stop(): Promise<void>;
     act(action: BridgeBrowserAction): Promise<void>;
 }
-/** How the owner launches a browser: the daemon's real launch, or a test's fake. */
-export type BridgeBrowserLauncher = (report: (detail: string) => void) => Promise<BridgeBrowser>;
+/** How the owner launches a browser: the daemon's real launch, or a test's fake. `signal` aborts when a stop gives the launch up. */
+export type BridgeBrowserLauncher = (report: (detail: string) => void, signal: AbortSignal) => Promise<BridgeBrowser>;
 /**
  * The one bridge browser a daemon runs. A launch is slow — the first one downloads Chrome — so
- * the status carries the step it is on, and a stop that lands mid-launch closes the browser the
- * launch then hands over rather than leaving it running unowned. A browser that exits on its own
+ * the status carries the step it is on, and a stop that lands mid-launch gives the launch up, and
+ * closes the browser a launch that went on regardless hands over, rather than leaving it unowned. A browser that exits on its own
  * (the user quit it) is reported as stopped with the reason, and not relaunched: quitting it was
  * an act, and the dashboard offers a restart.
  */

package/dist/module-types/src/dashboard/agent-handoff.d.ts

@@ -272,7 +272,7 @@ export declare function openRemoteBranchPullRequest(cwd: string, agent: HandoffA
  * Open a PR for a finished session, deciding from what the agent recorded which cases should not
  * open one. Reads the branch's handoff first: a branch that no longer exists, or a session that
  * changed nothing, is a clear error rather than an empty PR, and a branch that already has a PR
- * returns that one. Title is its branch, else the id; body is the intent, plus which session did it. This is the handoff decision the
+ * returns that one. Title and body say what its commits did ({@link commitsPrText}). This is the handoff decision the
  * dashboard's open-PR button offers; the RPC layer only resolves which run it is about, and the
  * two providers do the pushing and the opening.
  */
@@ -281,6 +281,7 @@ export declare function openAgentPullRequest(cwd: string, agent: AgentMeta, opti
     branches?: BranchesFor;
     gitHost?: GitHostFor;
     pr?: BranchPrLookup;
+    git?: GitRunner;
 }): Promise<HandoffResult>;
 /**
  * The little a handoff needs to know about the agent it is for: which branch, and what to say on

package/dist/module-types/src/dashboard/interventions.d.ts

@@ -14,22 +14,25 @@ export interface Intervention {
     projectName: string;
     /**
      * `pr` = an open PR to review/merge or close; `awaiting` = a run waiting on the question it ended on (#636/#1774);
-     * `unpushed` = a finished agent whose branch has commits that were never pushed (#860).
+     * `uncommitted` = a finished run whose checkout holds files it never committed; `unpushed` = a finished
+     * run whose branch has commits that were never pushed (#860).
      */
-    kind: 'pr' | 'awaiting' | 'unpushed';
+    kind: 'pr' | 'awaiting' | 'uncommitted' | 'unpushed';
     title: string;
-    /** The PR on the git host (`pr` only): where a click takes the user. */
+    /** The PR on the git host (`pr` only): where a click takes the user when no run of this dashboard opened it. */
     url?: string;
     /** The PR number (`pr` only). */
     number?: number;
     /** The question's id (`awaiting` only) — its stable identity, so it notifies exactly once. */
     awaitId?: string;
-    /** Which run this is about (`awaiting` #738 / `unpushed`): a project has several agents. */
+    /** Which run this is about (every kind but a `pr` opened outside this dashboard's runs): a project has several agents. */
     agentId?: string;
-    /** The branch the work is sitting on (`unpushed` only). */
+    /** The branch the work is sitting on (`uncommitted` and `unpushed` only). */
     branch?: string;
     /** How many commits are waiting (`unpushed` only). */
     commits?: number;
+    /** How many files were left uncommitted (`uncommitted` only). */
+    files?: number;
     /** When the PR was opened (`pr`) or the agent last updated (the other two), ISO, for ordering. */
     createdAt?: string;
 }
@@ -44,12 +47,6 @@ export interface InterventionsDeps {
     agents?: (cwd: string) => Promise<AgentMeta[]>;
     /** The project's checkouts and branches (default the project's provider, {@link projectBranches}): where a branch's state is read; drives the `unpushed` source (#860). */
     branches?: BranchesFor;
-    /**
-     * How many of a project's most recent finished agents to inspect for unpushed work. Each one costs
-     * a handful of git reads, and this runs on a poll, so old history is not re-walked every minute:
-     * work that has sat unpushed for dozens of agents is not news, and the agent list stays the record.
-     */
-    handoffLimit?: number;
 }
 /**
  * Build the cross-project interventions queue: every registered project's open PRs, plus any run

package/dist/module-types/src/dashboard/keys.d.ts

@@ -14,8 +14,8 @@ import type { Intervention } from './interventions.js';
  */
 /**
  * The stable identity of an intervention. A PR is its url (survives title edits and re-sorts);
- * the other two have no url and are keyed on the project plus the thing waiting — the agent and
- * the gate it is parked on, or the agent whose branch is unpushed.
+ * the others have no url and are keyed on the project plus the thing waiting — the agent and
+ * the gate it is parked on, or the agent whose work is uncommitted or unpushed.
  *
  * The agent is part of the awaiting key because a gate id is only unique within its own agent:
  * every agent's first gate is `await-choices`. Two agents running in one project (#736) and both

package/dist/module-types/src/dashboard/pull-requests.d.ts

@@ -91,8 +91,25 @@ export declare function prView(cwd: string, branch: string, gitHost?: GitHostFor
  * deciding whether to offer "Open PR". A read with no branch to ask about answers nothing at once.
  */
 export declare function cachedPrView(cwd: string, branch?: string): Promise<Cached<LinkedPr | undefined>>;
-/** Forget a branch's PR, after an action that changes whether it has one. */
+/** Forget a branch's PR, after an action that changes whether it has one, and with it how the project's PRs stand and which are open. */
 export declare function forgetPr(cwd: string, branch?: string): void;
+/** How a run's pull request stands, as its row in the list of runs shows it. */
+export type PrState = 'open' | 'draft' | 'merged' | 'closed';
+/**
+ * How each of a project's newest pull requests stands, by its address: what the list of runs marks
+ * each run's PR with. One listing of the project's requests, whatever their state, rather than one
+ * per run; a request older than what the git host lists has no state here. A listing the git host
+ * cannot answer throws.
+ */
+export declare function prStates(cwd: string, gitHost?: GitHostFor): Promise<Map<string, PrState>>;
+/**
+ * The cached form of {@link prStates} (#1028): the list of runs is polled every few seconds, and a
+ * PR's state changes far less often. A listing that fails is kept like an answer, as the states
+ * last read, so a git host that cannot answer is asked again a minute later, not at every poll;
+ * and while a read is on its way, after a request was opened or merged here, the rows keep the
+ * states they had.
+ */
+export declare function cachedPrStates(cwd: string, read?: (cwd: string) => Promise<Map<string, PrState>>): Promise<Map<string, PrState>>;
 /** The cached form of {@link prsForBranch}, shared through the same read-through cache (#1028). */
 export declare function cachedPrsForBranch(cwd: string, branch: string): Promise<Cached<LinkedPr[]>>;
 /** Forget a branch's PR history, after an action that changes it (opening one). */
@@ -124,3 +141,12 @@ export declare function pickAgentPr(prs: LinkedPr[], since?: string, order?: 'fi
  * it cannot decide what it never hears about. A project with no git host package has none open.
  */
 export declare function openPrs(cwd: string, gitHost?: GitHostFor): Promise<OpenPr[]>;
+/**
+ * The cached form of {@link openPrs} (#1028), for the Human Queue: it asked the git host at every
+ * poll of every page that shows it, and the page waited. The first ask waits for the answer; after
+ * that the list last read answers at once and is read again behind it once it is
+ * {@link OPEN_PRS_TTL_MS} old. A request opened or merged here is read again at once
+ * ({@link forgetPr}). A first read that fails rejects, as {@link openPrs} does; a later one keeps
+ * the list last read.
+ */
+export declare function cachedOpenPrs(cwd: string, read?: (cwd: string) => Promise<OpenPr[]>): Promise<OpenPr[]>;

package/dist/module-types/src/dashboard/rpc-serve.d.ts

@@ -5,13 +5,15 @@ import type { QuotaSource } from './quota.js';
 import type { ModelsSource } from './models.js';
 import type { BridgeBrowserOwner } from '../bridge-browser.js';
 import type { ProjectErrorsReader } from '../project-errors.js';
-import type { AddProjectResult, RemoveProjectResult, StartAgentOptions, StartAgentResult } from './types.js';
+import type { AddProjectResult, RemoveProjectResult, StartAgentOptions, StartAgentResult, StartedInResult } from './types.js';
 import type { AgentMeta } from '../store/index.js';
 import type { RemoteTarget } from './remote-run.js';
 /** Wired by the daemon so `sendStart` can reach the daemon's own `startAgent` closure. */
 export type StartAgentHandler = (prompt: string, options: StartAgentOptions, projectId?: string) => StartAgentResult | Promise<StartAgentResult>;
 /** Wired by the daemon so `sendAddProject` can install + register a repo (#433). */
 export type AddProjectHandler = (path: string, share: boolean) => AddProjectResult | Promise<AddProjectResult>;
+/** Wired by the daemon so `sendStartedAgain` can find or add the project a second `openagent` was started in. */
+export type StartedInHandler = (folder: string) => StartedInResult | Promise<StartedInResult>;
 /** Wired by the daemon so `sendRemoveProject` can take a project off the list, by its id, and with `files` remove what OpenAgent left in its folder. */
 export type RemoveProjectHandler = (projectId: string, files: boolean) => RemoveProjectResult | Promise<RemoveProjectResult>;
 /** Resolve an agent to its live event stream: the relay feeds `onEvents` from its own in-memory stream
@@ -63,6 +65,7 @@ export interface RemoteAgents {
 export interface DashboardContext {
     startAgent: StartAgentHandler;
     addProject: AddProjectHandler;
+    startedIn: StartedInHandler;
     removeProject: RemoveProjectHandler;
     /** The in-memory event stream for an agent relayed from a saved machine (#1067), else undefined. */
     eventsSource: EventsSource;

package/dist/module-types/src/dashboard/types.d.ts

@@ -28,6 +28,24 @@ export type AddProjectResult = {
     ok: false;
     error: string;
 };
+/**
+ * The project a folder `openagent` was started in is, on the dashboard's list: the listed project
+ * holding the folder, or the folder, added now. `id` always opens its page; `address` is the one
+ * the page writes (`src/project-address.ts`).
+ */
+export interface StartedProject {
+    id: string;
+    path: string;
+    added: boolean;
+    address: string;
+}
+/** The {@link StartedProject}, or why the folder could not be added. */
+export type StartedInResult = ({
+    ok: true;
+} & StartedProject) | {
+    ok: false;
+    error: string;
+};
 /**
  * What removing OpenAgent's files from a project's folder did: what went, what stayed with the
  * reason, and what could not be done, each line in words for a person. Paths are from the

package/dist/module-types/src/dashboard/unpublished.d.ts

@@ -0,0 +1,42 @@
+import type { AgentMeta } from '../store/index.js';
+import { type BranchesFor } from '../store/branches.js';
+/**
+ * A finished run's work that never left this machine: the branch it is on, the commits it holds
+ * that were never published, and the files its checkout left uncommitted. Either count may be 0,
+ * never both.
+ */
+export interface Unpublished {
+    branch: string;
+    commits: number;
+    uncommitted: number;
+}
+/**
+ * The finished runs of a project whose work never left this machine (#860), by run id: what the
+ * Human Queue lists as "Not committed" and "Not published" and the list of runs marks on each row,
+ * read alike so the two never disagree.
+ *
+ * Only a branch the branches provider made for the run counts. A branch of the person's own is
+ * theirs: a run continued on it, or a branch made before the history was rewritten, which is
+ * thousands of commits past the base.
+ *
+ * Files its checkout left uncommitted wait on the person whatever else is true of the branch: the
+ * run's next step is to commit them, a pull request or none. Not for a run waiting on its question,
+ * which is that run's next step, and which keeps its checkout as it was. The checkout on a branch is
+ * the newest run's: a run continued on the branch of an earlier one works in a checkout of its own,
+ * and what it leaves there is not the earlier run's.
+ *
+ * Commits wait when they are the branch's own beyond the base, not in the default branch, never
+ * pushed, in a project with a remote to push to. A branch pushed once whose copy on the remote is
+ * gone since, as a merged pull request's is, left the machine. So did a run with a pull request: its
+ * request is what the queue and its row show, and a branch pushed without an upstream reads, once
+ * its request merged and the remote's copy went, as never pushed.
+ *
+ * Every run is asked, in one quick read of the provider (`ahead`: counts, no file lists). A run
+ * started from another branch is asked apart, from the commit it started at, or that branch's work
+ * would count as its own; a run started from the default branch is counted from it, which already
+ * leaves out whatever it took in later, so the commit it started at changes nothing and all such
+ * runs share one read. A subagent's branch is its main agent's to land, never a person's to push,
+ * and a run still working is still writing its branch. A provider that cannot be found, or does not
+ * answer for every branch asked, throws: "nothing waits" would be a false answer.
+ */
+export declare function unpublishedRuns(cwd: string, agents: readonly AgentMeta[], branches?: BranchesFor): Promise<Map<string, Unpublished>>;

package/dist/module-types/src/dashboard-rpc/context.d.ts

@@ -51,5 +51,7 @@ export declare function contextBridgeBrowser(): BridgeBrowserOwner;
 export declare function contextStartAgent(): DashboardContext['startAgent'];
 /** Install + register a repo (#433), which only the daemon can do. */
 export declare function contextAddProject(): DashboardContext['addProject'];
+/** Find or add the project a second `openagent` was started in (#2141), which only the daemon can do. */
+export declare function contextStartedIn(): DashboardContext['startedIn'];
 /** Take a project off the list, which only the daemon can do: it runs the project's close hooks first. */
 export declare function contextRemoveProject(): DashboardContext['removeProject'];

package/dist/module-types/src/dashboard-rpc/index.d.ts

@@ -1,7 +1,7 @@
 export { onAgents, onAgent, onAgentsDoing, onDocs, onQueue, onOverview, onRecentAgents, onInterventions, onOpenQuestions, onActivity, onDashboard, onGitHostHome, onRepositoryOffer, onGitStatus, onProjectFiles, onRetainedWorktrees, onAgentWorktree, onAgentHandoff, onBridgeQuestion, onBridgeStatus, onBridgeToken, onBridgeEvents, onBridgeAnswer, onBridgeBrowser } from './reads.js';
 export { sendStop, sendChoice, sendBridgeAnswer, sendBridgeAnswerCancel, sendBridgeBrowser, sendMessage, sendStart, sendOpenInApp, sendRemoveWorktree, sendDeleteAgent, sendOpenPullRequest, sendPush, sendMergeBranch, sendMerge, sendCreateRepository } from './control.js';
 export { streamAgentEvents, type LiveFeedEvent, type PartialMessage, type StreamSync } from './events.js';
-export { onProjects, sendAddProject, onCloneTarget, sendAddProjectFromAddress, sendRemoveProject, onRecordsReach, sendShareRecords, sendPickProjectDirectory, onOnboarding, onCommands, onStartCheck, type ProjectLauncher } from './projects.js';
+export { onProjects, sendAddProject, sendStartedAgain, onCloneTarget, sendAddProjectFromAddress, sendRemoveProject, onRecordsReach, sendShareRecords, sendPickProjectDirectory, onOnboarding, onCommands, onStartCheck, type ProjectLauncher } from './projects.js';
 export { onPreferences, savePreferences, patchPreferences, onProjectPresets, saveProjectPresets, onEditors, type SavePreferencesResult, type PatchPreferencesResult, } from './preferences.js';
 export { type EditorInfo } from '../dashboard/open-in-app.js';
 export { onQuota } from './quota.js';

package/dist/module-types/src/dashboard-rpc/projects.d.ts

@@ -3,7 +3,7 @@ import { type BranchReach } from '@openagt/agent-data';
 import { type StartReadiness } from '../project-hooks.js';
 import { type PickDirectoryResult } from '../pick-directory.js';
 import type { ProjectSummary } from '../dashboard/projects.js';
-import type { AddProjectResult, OnboardingSuggestion, RemoveProjectResult } from '../dashboard/types.js';
+import type { AddProjectResult, OnboardingSuggestion, RemoveProjectResult, StartedInResult } from '../dashboard/types.js';
 export declare function onProjects(): Promise<ProjectSummary[]>;
 /**
  * Add a project from the dashboard (#396/#433): install the repo and register it so it joins the
@@ -15,6 +15,16 @@ export declare function onProjects(): Promise<ProjectSummary[]>;
  * repository's remote. Nothing is pushed for a project added with `false`.
  */
 export declare function sendAddProject(path: string, share: boolean): Promise<AddProjectResult>;
+/**
+ * A second `openagent` started while this dashboard listens on its port (#2141): it serves
+ * nothing itself, and hands over the folder it was started in, if it is in a repository. The
+ * answer says which OpenAgent runs here, and the project that holds the folder, else the folder,
+ * added. A page's own call is answered the same, and adds no more than Add project.
+ */
+export declare function sendStartedAgain(folder: string | null): Promise<{
+    version: string;
+    project?: StartedInResult;
+}>;
 /** Where the repository a person typed the address of would be cloned to on this computer, or why what was typed is no address: asked before anything is cloned. */
 export declare function onCloneTarget(address: string): Promise<{
     ok: true;