@openagt/dashboard 0.26.0 → 0.28.0

package/dist/module-types/dashboard/components/InviteDialog.d.ts

@@ -13,10 +13,32 @@ export type InviteAnswer = {
     ok: false;
     error: string;
 };
-export declare function InviteDialog({ title, ask, scan, note, openHere, joined, onCode, onClose, }: {
+/** How the dialog learns and names the computer's owner, for a code made for someone else. */
+export interface InvitePersons {
+    /** The owner's GitHub account, once named. */
+    owner: string | undefined;
+    /** The GitHub account this computer is logged in to: who the owner would be. */
+    whoAmI: () => Promise<{
+        ok: true;
+        account: string;
+    } | {
+        ok: false;
+        error: string;
+    }>;
+    /** Name the owner, once. */
+    nameOwner: (account: string) => Promise<{
+        ok: true;
+    } | {
+        ok: false;
+        error: string;
+    }>;
+}
+export declare function InviteDialog({ title, ask, persons, scan, note, openHere, joined, onCode, onClose, }: {
     title: string;
-    /** Asks for a new code: as the dialog opens, and on each "New code". */
-    ask: () => Promise<InviteAnswer>;
+    /** Asks for a new code, for `person` when it is for someone else: as the dialog opens (or once it knows who it is for), and on each "New code". */
+    ask: (person?: string) => Promise<InviteAnswer>;
+    /** Given, the dialog first asks who the code is for. */
+    persons?: InvitePersons;
     /** What the person does with the code: "Scan it with the phone's camera…". */
     scan: string;
     /** A line under the link, for what else the link is good for. */

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

@@ -4,6 +4,10 @@ export type { Machine };
 export declare function refreshMachines(): Promise<void>;
 /** Save the machine a pasted link names; the list is read again once the daemon has it. */
 export declare function addMachine(pasted: string, label?: string): Promise<AddMachineResult>;
+/** Save a computer that keeps a line open to a saved server, reached through it; the list is read again once the daemon has it. */
+export declare function addComputerThrough(machineId: string, computerId: string): Promise<AddMachineResult>;
+/** Say the person was told their logins are copied to another person's computer; the list is read again once the daemon has it. */
+export declare function tellMachine(id: string): Promise<void>;
 /**
  * Take a saved machine off the list, and answer whether the daemon did, with its reason when it
  * did not. The list is read again either way, so a machine the daemon did not remove is still shown.

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

@@ -333,6 +333,12 @@ export interface ModuleHost {
      * its page reads and changes it with no project added. Refused for any other package.
      */
     runComputerCommand(args: string[], command?: string): Promise<ModuleCommandResult>;
+    /**
+     * The same, on a saved machine whose package of the same name is that computer's: what the
+     * package keeps over there, read and changed with this computer's key there, as that machine's
+     * own page would. Not for a computer reached through a server.
+     */
+    runComputerCommandOn(machineId: string, args: string[], command?: string): Promise<ModuleCommandResult>;
     /**
      * Call one of the module's own server reads (its package's `./server`) in one project, with
      * `input`, a JSON object; `input.agentId` names the run the read is about, when it is about one.
@@ -376,6 +382,21 @@ export interface ModuleHost {
      * there stops working. Refused, with the reason, while a run is at work there.
      */
     removeMachine(id: string): Promise<MachineRemoved>;
+    /**
+     * The computers that keep a line open to a saved server: computers at home a run can be sent to
+     * through the server, and whether each is saved here already. None for a machine that is no server.
+     */
+    computersThrough(machineId: string): Promise<ModuleComputersThrough>;
+    /** Save one of them as a machine of its own, reached through the server: it is in "Run on" from then on. */
+    addComputerThrough(machineId: string, computerId: string): Promise<MachineAdded>;
+    /**
+     * What a saved machine's door says of the person this computer is in as there, on a computer
+     * several people use: their GitHub account, whether they are its owner, and their devices. What
+     * it said is another computer's data, to read as such; `unknown` for a machine that does not say.
+     */
+    machinePerson(machineId: string): Promise<ModuleMachinePerson>;
+    /** Take one of that person's devices out at the machine, by its id there; answers as {@link machinePerson} does, after. */
+    removeMachineDevice(machineId: string, deviceId: string): Promise<ModuleMachinePerson>;
     /**
      * What the live screen of a run shows, as the screen's own stream of bytes, until `signal` ends
      * it; nothing when the run has no live screen. OpenAgent asks the computer the run is on, which
@@ -395,6 +416,8 @@ export interface ModuleMachine {
     version?: string;
     /** The id the machine lists this computer under, among the devices that are in there. */
     device?: string;
+    /** Whose computer it is, by their GitHub account, when it is another person's shared with everyone on a server. */
+    owner?: string;
 }
 /** What {@link ModuleHost.machines} answers. */
 export interface ModuleMachines {
@@ -409,6 +432,35 @@ export type MachineAdded = {
     ok: false;
     error: string;
 };
+/** A computer that keeps a line open to a saved server, as {@link ModuleHost.computersThrough} answers it. */
+export interface ModuleComputerThrough {
+    /** The server's id for it. */
+    id: string;
+    name: string;
+    /** Its line is open right now. */
+    online: boolean;
+    /** It is saved here, through the server. */
+    added: boolean;
+    /** Whose computer it is, when it is another person's that keeps its line there for everyone. */
+    owner?: string;
+}
+/** What {@link ModuleHost.computersThrough} answers. */
+export type ModuleComputersThrough = {
+    ok: true;
+    computers: ModuleComputerThrough[];
+} | {
+    ok: false;
+    error: string;
+};
+/** What {@link ModuleHost.machinePerson} answers: what the machine's door said, or why there is nothing. */
+export type ModuleMachinePerson = {
+    ok: true;
+    said: unknown;
+} | {
+    ok: false;
+    error: string;
+    unknown?: true;
+};
 /** How removing a machine went: done, or refused, with the reason. */
 export type MachineRemoved = {
     ok: true;
@@ -417,7 +469,7 @@ export type MachineRemoved = {
     error: string;
 };
 /** What the dashboard knows about the module it is serving: every service but the commands and the reads, which it binds to the package. */
-export type ModuleHostBase = Omit<ModuleHost, 'runCommand' | 'act' | 'runComputerCommand' | 'read'>;
+export type ModuleHostBase = Omit<ModuleHost, 'runCommand' | 'act' | 'runComputerCommand' | 'runComputerCommandOn' | 'read'>;
 /**
  * The host for one module: the dashboard's services, and its commands bound to the module's own
  * package. `acts` marks every command as an action on the project rather than a page's read: the
@@ -463,7 +515,7 @@ export { cn } from '../lib/utils.js';
 export { SettingsSection, SettingsRow, SettingsSelectRow, type SettingsOption } from '../components/SettingsRows.js';
 export { QrCode } from '../components/QrCode.js';
 export { AddMachineDialog } from '../components/AddMachineDialog.js';
-export { InviteDialog, type InviteCode, type InviteAnswer } from '../components/InviteDialog.js';
+export { InviteDialog, type InviteCode, type InviteAnswer, type InvitePersons } from '../components/InviteDialog.js';
 export { Dialog } from '../components/ui/dialog.js';
 export { reachedByLine } from '../../src/client.js';
 export { useCodingAgents, type CodingAgent } from '../lib/models.js';

package/dist/module-types/dashboard/rpc/machines.d.ts

@@ -1,9 +1,17 @@
 import type * as impl from '../../src/dashboard-rpc/machines.js';
 export type * from '../../src/dashboard-rpc/machines.js';
 export declare const onMachines: () => Promise<impl.Machine[]>;
-export declare const sendAddMachine: (pasted: string, label?: string | undefined) => Promise<impl.AddMachineResult>;
+export declare const sendAddMachine: (pasted: string, label?: string | undefined, owner?: string | undefined) => Promise<impl.AddMachineResult>;
 export declare const sendRemoveMachine: (id: string) => Promise<impl.RemoveMachineResult>;
 export declare const onMachinesReachable: () => Promise<Record<string, boolean>>;
 export declare const onMachineVersions: () => Promise<impl.MachineVersions>;
 export declare const sendProjectToMachine: (projectId: string, machineId: string) => Promise<impl.ProjectOnMachine>;
 export declare const onProjectOnMachine: (projectId: string, machineId: string) => Promise<impl.ProjectOnMachine>;
+export declare const onComputersThrough: (machineId: string) => Promise<impl.ComputersThrough>;
+export declare const sendAddComputerThrough: (machineId: string, computerId: string) => Promise<impl.AddMachineResult>;
+export declare const onMachinePerson: (machineId: string) => Promise<impl.MachinePerson>;
+export declare const sendRemoveMachineDevice: (machineId: string, deviceId: string) => Promise<impl.MachinePerson>;
+export declare const sendMachineTold: (machineId: string) => Promise<{
+    ok: boolean;
+}>;
+export declare const onMachineLogins: (machineId: string) => Promise<impl.MachineLoginsResult>;

package/dist/module-types/dashboard/rpc/modules.d.ts

@@ -2,5 +2,6 @@ import type * as impl from '../../src/dashboard-rpc/modules.js';
 export type * from '../../src/dashboard-rpc/modules.js';
 export declare const onModules: () => Promise<impl.DashboardModule[]>;
 export declare const runModuleCommand: (projectId: string, pkg: string, args: string[], command?: string | undefined, acts?: boolean | undefined) => Promise<import("@openagt/agent-data").PackageCommandResult>;
-export declare const runComputerCommand: (pkg: string, args: string[], command?: string | undefined) => Promise<import("@openagt/agent-data").PackageCommandResult>;
+export declare const runComputerCommand: (pkg: string, args: string[], command?: string | null | undefined, input?: string | null | undefined) => Promise<import("@openagt/agent-data").PackageCommandResult>;
+export declare const runComputerCommandOn: (pkg: string, machineId: string, args: string[], command?: string | null | undefined, input?: string | null | undefined) => Promise<import("@openagt/agent-data").PackageCommandResult>;
 export declare const readModule: (projectId: string, pkg: string, name: string, input: unknown) => Promise<impl.ModuleReadResult>;

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

@@ -0,0 +1,57 @@
+/**
+ * A person's logins on another person's computer (#2140). That computer gives each person who
+ * starts a run on it a user and an OpenAgent of their own, and a run there uses that person's own
+ * GitHub and Claude logins. They reach it as copies: the person's own OpenAgent on the server
+ * both computers are in at copies its logins there, the first time it starts a run there. A
+ * person may make a login of their own there instead, and a copy never takes its place.
+ *
+ * What a computer says of a login there is only whose it is, where it came from and a mark of it:
+ * the start of its SHA-256, by which the copier tells whether the copy is still its own login.
+ * The login itself is never said. The marks are the servers package's (`own.ts`), made the same way.
+ */
+/** One login there, as that computer says it. */
+export interface LoginThere {
+    /** GitHub: the account. */
+    account?: string;
+    /** A copy from the person's own OpenAgent on a server, or one the person made there. */
+    source: 'copied' | 'made';
+    /** For a copy: the server it came from. */
+    from?: string;
+    mark?: string;
+}
+/** The person's logins on that computer: each one it has. */
+export interface MachineLogins {
+    github?: LoginThere;
+    claude?: LoginThere;
+}
+/** Logins handed to that computer: each as its own word, with the server they are copies from, when they are. */
+export interface GivenLogins {
+    github?: string;
+    claude?: string;
+    from?: string;
+}
+export declare const isMark: (value: unknown) => value is string;
+/** A server's name as a copied login says where it came from: its host or its address. */
+export declare const isServerName: (value: unknown) => value is string;
+/** A login as it is handed over: letters, digits and the few marks a token is written with, nothing a line could break on. */
+export declare const isLoginWord: (value: unknown) => value is string;
+/** A login's mark: the start of its SHA-256. */
+export declare function markOf(login: string): string;
+/** What another computer said of the logins there, as far as it reads as such: it is another computer's data. */
+export declare function readLogins(value: unknown): MachineLogins;
+/**
+ * The servers package's `own` answer of a person's own OpenAgent, as that computer says it: each
+ * login that is there, a copy when it names the server it came from.
+ */
+export declare function loginsOfOwn(said: unknown): MachineLogins;
+/**
+ * Which of this OpenAgent's own logins go to that computer: one it has none of, and one it has a
+ * copy of that is no longer this one. Never one the person made there.
+ */
+export declare function loginsToCopy(own: {
+    github?: string;
+    claude?: string;
+}, there: MachineLogins): {
+    github?: string;
+    claude?: string;
+};

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

@@ -13,6 +13,18 @@ export interface Person {
     /** A picture of them: an https address. */
     avatar?: string;
 }
+/**
+ * Who a call came from, when the door in front of OpenAgent says (remote-access): the GitHub
+ * account of the person whose device made it. Said only on a computer several persons use.
+ */
+export declare const PERSON_HEADER = "x-openagent-person";
+/** Run `call` as one a person's device made, by their GitHub account, when the request said one. */
+export declare function asCaller<T>(header: string | string[] | undefined, call: () => Promise<T>): Promise<T>;
+/**
+ * The person at the page: the one this computer knows, or, for a call another person's device
+ * made, that person by their GitHub account and its picture.
+ */
+export declare function personAtPage(own: Person, account?: string | undefined): Person;
 /** `projects` are the listed projects' folders, in the list's order. */
 export declare function readPerson(deps: {
     projects: () => Promise<string[]>;

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

@@ -2,6 +2,7 @@ import { EventStream } from '../event-stream.js';
 import type { OpenAgentEvent } from '../events.js';
 import type { AgentMeta } from '../store/index.js';
 import type { StartAgentOptions, StartAgentResult } from './types.js';
+import { type GivenLogins, type MachineLogins } from './machine-logins.js';
 /**
  * The server-side half of "run on a saved machine" (#1067). The local daemon holds this computer's
  * key on the saved machine, so it - not the browser - drives the remote daemon: it POSTs the agent to the
@@ -87,6 +88,29 @@ export declare function deviceIdOf(key: string): string | undefined;
 export declare function leaveRemote(machine: MachineAccess & {
     door: string;
 }): Promise<boolean>;
+/**
+ * Where a server's door passes a call down the line of a computer that keeps one open there: a
+ * computer at home that nothing on a network reaches is asked at this address, through the
+ * server, with this computer's key at the server. To this computer it is one more machine.
+ */
+export declare const THROUGH_PATH = "/_remote-access/via/";
+/** A computer that keeps a line open to a server, as the server's door lists it. */
+export interface ComputerOnServer {
+    id: string;
+    name: string;
+    /** Its line is open right now. */
+    online: boolean;
+    /** Whose computer it is, when it is another person's that keeps its line there for everyone: their GitHub account. */
+    owner?: string;
+}
+/** The computers that keep a line open to a server this computer is in at, or why they could not be asked. */
+export declare function remoteComputers(machine: MachineAccess): Promise<{
+    ok: true;
+    computers: ComputerOnServer[];
+} | {
+    ok: false;
+    error: string;
+}>;
 /**
  * Start an agent on the remote daemon, in its project cloned from `target.project`, and return
  * what it answered (with the remote's own run id). A non-2xx or a transport failure surfaces as an
@@ -209,3 +233,54 @@ export declare class RelayedAgents {
  * diary yields: the agent's session id, its cost, its end.
  */
 export declare function foldRelayedEvent(meta: AgentMeta, event: OpenAgentEvent, at: string): AgentMeta;
+/**
+ * Run one of a computer package's own commands on a machine, as that machine's own page runs it:
+ * a module on this computer reads and changes what the same package keeps over there. `input` is
+ * what the command reads on standard input there; it travels in the call's body, never in an
+ * address. The machine answers as its page is answered.
+ */
+export declare function remoteComputerCommand(machine: MachineAccess, pkg: string, args: readonly string[], command?: string, input?: string): Promise<{
+    ok: true;
+    output: unknown;
+} | {
+    ok: false;
+    error: string;
+}>;
+/** The logins this computer's person has on a machine of another person's, as that machine says (machine-logins.ts). */
+export declare function remoteLogins(machine: MachineAccess): Promise<{
+    ok: true;
+    logins: MachineLogins;
+} | {
+    ok: false;
+    error: string;
+}>;
+/** Hand logins over to this computer's person on a machine of another person's; answers what it says of them after. */
+export declare function giveRemoteLogins(machine: MachineAccess, given: GivenLogins): Promise<{
+    ok: true;
+    logins: MachineLogins;
+} | {
+    ok: false;
+    error: string;
+}>;
+/** What a machine's door is asked about this computer's person there: who they are and their devices, one of those devices out, or a link for this computer's line. */
+export type DoorAsk = {
+    what: 'me';
+} | {
+    what: 'remove';
+    id: string;
+} | {
+    what: 'line';
+};
+/**
+ * Ask a machine's door about the person this computer is in as there: the door answers it
+ * itself, from its own file, and passes nothing on to the OpenAgent behind it. Answers what the
+ * door said, as it said it: the caller reads it as the data of another computer.
+ */
+export declare function remoteDoor(machine: MachineAccess, ask: DoorAsk): Promise<{
+    ok: true;
+    said: unknown;
+} | {
+    ok: false;
+    error: string;
+    unknown?: true;
+}>;

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

@@ -6,8 +6,8 @@ export { onPreferences, savePreferences, patchPreferences, onProjectPresets, sav
 export { type EditorInfo } from '../dashboard/open-in-app.js';
 export { onQuota } from './quota.js';
 export { onModels } from './models.js';
-export { onMachines, sendAddMachine, sendRemoveMachine, onMachinesReachable, onMachineVersions, sendProjectToMachine, onProjectOnMachine, type Machine, type AddMachineResult, type MachineVersions, type ProjectOnMachine } from './machines.js';
-export { onModules, runModuleCommand, runComputerCommand, readModule, type DashboardModule, type ModuleCommandResult, type ModuleReadResult } from './modules.js';
+export { onMachines, sendAddMachine, sendRemoveMachine, onMachinesReachable, onMachineVersions, sendProjectToMachine, onProjectOnMachine, onComputersThrough, sendAddComputerThrough, onMachinePerson, sendRemoveMachineDevice, sendMachineLineLink, sendMachineTold, onMachineLogins, sendMachineLogins, type Machine, type MachineLoginsResult, type AddMachineResult, type MachineVersions, type ProjectOnMachine, type ComputersThrough, type MachinePerson } from './machines.js';
+export { onModules, runModuleCommand, runComputerCommand, runComputerCommandOn, readModule, type DashboardModule, type ModuleCommandResult, type ModuleReadResult } from './modules.js';
 export { onProjectSkills, sendChangeSkills, sendProjectSkills, type ProjectSkills, type ProjectSkill, type ChangeSkillsResult } from './skills.js';
 export { onPerson, type Person } from './person.js';
 import { streamAgentEvents } from './events.js';

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

@@ -1,8 +1,13 @@
+import { type MachineLogins } from '../dashboard/machine-logins.js';
 /** A saved machine as the browser sees it: no key. */
 export interface Machine {
     id: string;
     label: string;
     url: string;
+    /** Whose computer it is, when it is another person's: a run there uses this person's own logins, copied there. */
+    owner?: string;
+    /** The person was told so, once. */
+    told?: true;
 }
 export type AddMachineResult = {
     ok: true;
@@ -18,8 +23,11 @@ export declare function onMachines(): Promise<Machine[]>;
  * computer is let in there with the link's code, once, and keeps the key it is answered. Adding
  * a machine again, with a new link, replaces its name and the key, and the key it had there
  * before is taken out.
+ *
+ * `owner` is said for a computer of another person's that keeps a line to this server for
+ * everyone: the door says whose it is when it tells this OpenAgent of it.
  */
-export declare function sendAddMachine(pasted: string, label?: string): Promise<AddMachineResult>;
+export declare function sendAddMachine(pasted: string, label?: string, owner?: string): Promise<AddMachineResult>;
 export type RemoveMachineResult = {
     ok: true;
 } | {
@@ -33,6 +41,88 @@ export type RemoveMachineResult = {
  * removed there, among its devices.
  */
 export declare function sendRemoveMachine(id: string): Promise<RemoveMachineResult>;
+/** A computer that keeps a line open to a saved server, and whether it is saved here, through that server. */
+export interface ComputerThrough {
+    id: string;
+    name: string;
+    online: boolean;
+    added: boolean;
+    /** Whose computer it is, when it is another person's that keeps its line there for everyone. */
+    owner?: string;
+}
+export type ComputersThrough = {
+    ok: true;
+    computers: ComputerThrough[];
+} | {
+    ok: false;
+    error: string;
+};
+/**
+ * The computers that keep a line open to a saved server: computers at home that a run can be
+ * sent to through the server, from here, as the server's own page does. None for a machine that
+ * is no server, and for one saved through a server.
+ */
+export declare function onComputersThrough(machineId: string): Promise<ComputersThrough>;
+/**
+ * Save a computer that keeps a line open to a saved server, as a machine of its own: reached
+ * through the server, with this computer's key there. Nothing is entered anywhere: the server
+ * already lets this computer in, and passes its calls down the computer's line.
+ */
+export declare function sendAddComputerThrough(machineId: string, computerId: string): Promise<AddMachineResult>;
+/** Write down that the person was told their logins are copied to a saved machine of another person's: the page says it once. */
+export declare function sendMachineTold(machineId: string): Promise<{
+    ok: boolean;
+}>;
+export type MachineLoginsResult = {
+    ok: true;
+    logins: MachineLogins;
+} | {
+    ok: false;
+    error: string;
+};
+/**
+ * This person's logins on a saved machine of another person's, as that machine says: copied from
+ * a server, or made there. Read through the server when the machine is reached through one.
+ */
+export declare function onMachineLogins(machineId: string): Promise<MachineLoginsResult>;
+/**
+ * Hand this person's own logins to a saved machine of another person's: the person made them for
+ * it, here, so they are no copies, and no server's copy takes their place later.
+ */
+export declare function sendMachineLogins(machineId: string, given: {
+    github?: unknown;
+    claude?: unknown;
+}): Promise<MachineLoginsResult>;
+/**
+ * What a saved machine's door says of the person this computer is in as there: their GitHub
+ * account, whether they are that computer's owner, and their devices, as the door lists them. A
+ * computer several people use answers it; `unknown` is a machine that does not say (one from
+ * before persons, or reached through a server). What it said is another computer's data: the page
+ * reads it as such.
+ */
+export type MachinePerson = {
+    ok: true;
+    said: unknown;
+} | {
+    ok: false;
+    error: string;
+    unknown?: true;
+};
+export declare function onMachinePerson(machineId: string): Promise<MachinePerson>;
+/** Take one of this person's devices out at a saved machine, by its id there; answers what {@link onMachinePerson} does, as it is after. */
+export declare function sendRemoveMachineDevice(machineId: string, deviceId: string): Promise<MachinePerson>;
+/**
+ * A link that lets this computer's line in at a saved machine, as this person's: what keeping a
+ * line open to a computer several people use starts from, for a person who cannot ask for one
+ * over SSH. The link works once, and only for a line.
+ */
+export declare function sendMachineLineLink(machineId: string): Promise<{
+    ok: true;
+    url: string;
+} | {
+    ok: false;
+    error: string;
+}>;
 /** Whether each saved machine answers right now, by id: one short call to each, with this computer's key. */
 export declare function onMachinesReachable(): Promise<Record<string, boolean>>;
 /** This computer's OpenAgent, and the one each saved machine runs. */

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

@@ -41,9 +41,21 @@ export declare function runModuleCommand(projectId: string, pkg: string, args: s
  * Run one of the commands of a package that is this computer's, in no project, and answer its
  * JSON output: how the door's page and the servers' page read and change what they keep, which is
  * in the person's home folder, where the command runs. Refused for any other package: a project's
- * module runs its commands in its project ({@link runModuleCommand}).
+ * module runs its commands in its project ({@link runModuleCommand}). `input` is what the command
+ * reads on standard input: a login handed over there is on no command line.
+ *
+ * The command is told which computer this is and where this OpenAgent answers: what it sets up on
+ * another machine is listed there as this computer's, and what it asks of a saved machine it asks
+ * through this OpenAgent, which holds the keys.
+ */
+export declare function runComputerCommand(pkg: string, args: string[], command?: string | null, input?: string | null): Promise<ModuleCommandResult>;
+/**
+ * Run one of the commands of a package that is this computer's on a saved machine, where the
+ * same package is that machine's: a module reads and changes what it keeps over there, with this
+ * computer's key there, as the machine's own page would. Not for a computer reached through a
+ * server: what comes down a line is a machine's calls, not its page's.
  */
-export declare function runComputerCommand(pkg: string, args: string[], command?: string): Promise<ModuleCommandResult>;
+export declare function runComputerCommandOn(pkg: string, machineId: string, args: string[], command?: string | null, input?: string | null): Promise<ModuleCommandResult>;
 /**
  * Call read `name` of a module's server part in one project: how a module's browser part reads
  * what a command cannot answer fast enough. Refused for an unknown project, a package that is not

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

@@ -1,4 +1,4 @@
 import { type Person } from '../dashboard/person.js';
 export type { Person } from '../dashboard/person.js';
-/** The person at this dashboard, for the foot of its sidebar (`readPerson`). */
+/** The person at this dashboard, for the foot of its sidebar (`readPerson`): another person's, for a page their device opened. */
 export declare function onPerson(): Promise<Person>;

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

@@ -10,6 +10,12 @@ import type { ProvidedCommand } from '@openagt/agent-data';
  */
 /** How a package of this computer is told which computer this is: the name of the word in what it is started with. */
 export declare const COMPUTER_ENV = "OPENAGENT_COMPUTER";
+/** How a package of this computer is told where OpenAgent answers on it. */
+export declare const URL_ENV = "OPENAGENT_URL";
+/** Say where this OpenAgent answers, once it listens: what its packages' commands are told too. */
+export declare function sayOwnUrl(url: string | undefined): void;
+/** Where this OpenAgent answers, as it was said; nothing before it listens. */
+export declare function ownUrlSaid(): string | undefined;
 export interface PackageServicesOptions {
     /** The commands to run, each a package's declared service. */
     commands: readonly ProvidedCommand[];

package/dist/module-types/src/project-modules.d.ts

@@ -59,4 +59,6 @@ export type ModuleCommandResult = PackageCommandResult;
  */
 export declare function runModuleCommand(root: string, module: ProjectModule, args: readonly string[], command?: string, 
 /** What the command is started with, beside what this process itself has. */
-more?: NodeJS.ProcessEnv): Promise<ModuleCommandResult>;
+more?: NodeJS.ProcessEnv, 
+/** What the command reads on standard input. */
+input?: string): Promise<ModuleCommandResult>;

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

@@ -40,7 +40,17 @@ export interface MachineRecord {
      * machine that later says another name does not get another computer's runs by it.
      */
     host?: string;
+    /**
+     * Whose computer it is, by their GitHub account, when it is another person's: a computer that
+     * keeps a line to a server for everyone there. A run started on it uses this person's own logins
+     * there, which reach it as copies.
+     */
+    owner?: string;
+    /** The person was told, once, that their logins are copied to that other person's computer. */
+    told?: true;
 }
+/** A GitHub account as a person on a computer is known by: letters, digits and single dashes, at most 39. */
+export declare function isAccount(value: unknown): value is string;
 /**
  * The dashboard's Global options (#410), persisted next to the project list so they
  * survive restarts without localStorage — the daemon reads/writes them, the SPA reads
@@ -290,6 +300,7 @@ export declare function addMachine(machine: {
     door: string;
     pin?: string;
     label?: string;
+    owner?: string;
 }, fs?: RegistryFs, env?: NodeJS.ProcessEnv): Promise<{
     record: MachineRecord;
     displaced: MachineRecord[];
@@ -304,6 +315,8 @@ export declare function nameMachine(machine: {
     id: string;
     key: string;
 }, host: string, fs?: RegistryFs, env?: NodeJS.ProcessEnv): Promise<boolean>;
+/** Write down that the person was told their logins are copied to a saved machine of another person's. Answers whether it is saved. */
+export declare function tellMachine(id: string, fs?: RegistryFs, env?: NodeJS.ProcessEnv): Promise<boolean>;
 /** Take a saved machine off the list, by id. Answers the one that was there. */
 export declare function removeMachine(id: string, fs?: RegistryFs, env?: NodeJS.ProcessEnv): Promise<MachineRecord | undefined>;
 /** A {@link PreferencesStore} bound to the real registry file, wired by the daemon so the

package/dist/package-services.d.ts

@@ -10,6 +10,12 @@ import type { ProvidedCommand } from '@openagt/agent-data';
  */
 /** How a package of this computer is told which computer this is: the name of the word in what it is started with. */
 export declare const COMPUTER_ENV = "OPENAGENT_COMPUTER";
+/** How a package of this computer is told where OpenAgent answers on it. */
+export declare const URL_ENV = "OPENAGENT_URL";
+/** Say where this OpenAgent answers, once it listens: what its packages' commands are told too. */
+export declare function sayOwnUrl(url: string | undefined): void;
+/** Where this OpenAgent answers, as it was said; nothing before it listens. */
+export declare function ownUrlSaid(): string | undefined;
 export interface PackageServicesOptions {
     /** The commands to run, each a package's declared service. */
     commands: readonly ProvidedCommand[];

package/dist/package-services.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"package-services.d.ts","sourceRoot":"","sources":["../src/package-services.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAC1E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAE1D;;;;;;;GAOG;AAEH,sHAAsH;AACtH,eAAO,MAAM,YAAY,uBAAuB,CAAA;AAEhD,MAAM,WAAW,sBAAsB;IACrC,8DAA8D;IAC9D,QAAQ,EAAE,SAAS,eAAe,EAAE,CAAA;IACpC,gDAAgD;IAChD,GAAG,EAAE,MAAM,CAAA;IACX,GAAG,EAAE,MAAM,CAAC,UAAU,CAAA;IACtB,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IAC3B,oEAAoE;IACpE,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,UAAU,KAAK,YAAY,CAAA;IAC7D,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,sDAAsD;IACtD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACtB;AAKD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,sBAAsB,GAAG,eAAe,CAwDlF"}
+{"version":3,"file":"package-services.d.ts","sourceRoot":"","sources":["../src/package-services.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAC1E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAE1D;;;;;;;GAOG;AAEH,sHAAsH;AACtH,eAAO,MAAM,YAAY,uBAAuB,CAAA;AAEhD,4EAA4E;AAC5E,eAAO,MAAM,OAAO,kBAAkB,CAAA;AAItC,mGAAmG;AACnG,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAEvD;AAED,+EAA+E;AAC/E,wBAAgB,UAAU,IAAI,MAAM,GAAG,SAAS,CAE/C;AAED,MAAM,WAAW,sBAAsB;IACrC,8DAA8D;IAC9D,QAAQ,EAAE,SAAS,eAAe,EAAE,CAAA;IACpC,gDAAgD;IAChD,GAAG,EAAE,MAAM,CAAA;IACX,GAAG,EAAE,MAAM,CAAC,UAAU,CAAA;IACtB,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IAC3B,oEAAoE;IACpE,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,UAAU,KAAK,YAAY,CAAA;IAC7D,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,sDAAsD;IACtD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACtB;AAKD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,sBAAsB,GAAG,eAAe,CAwDlF"}

package/dist/package-services.js

@@ -9,11 +9,22 @@ import { spawn as nodeSpawn } from 'node:child_process';
  */
 /** How a package of this computer is told which computer this is: the name of the word in what it is started with. */
 export const COMPUTER_ENV = 'OPENAGENT_COMPUTER';
+/** How a package of this computer is told where OpenAgent answers on it. */
+export const URL_ENV = 'OPENAGENT_URL';
+let ownUrl;
+/** Say where this OpenAgent answers, once it listens: what its packages' commands are told too. */
+export function sayOwnUrl(url) {
+    ownUrl = url;
+}
+/** Where this OpenAgent answers, as it was said; nothing before it listens. */
+export function ownUrlSaid() {
+    return ownUrl;
+}
 /** How long a service gets to end by itself once asked, before it is killed. */
 const STOP_GRACE_MS = 3_000;
 export function startPackageServices(opts) {
     const spawn = opts.spawn ?? ((bin, env) => nodeSpawn(process.execPath, [bin, 'serve'], { env, stdio: ['ignore', 'ignore', 'pipe'], detached: true }));
-    const env = { ...opts.env, OPENAGENT_URL: opts.url };
+    const env = { ...opts.env, [URL_ENV]: opts.url };
     let stopping = false;
     const running = new Map();
     const timers = new Set();

package/dist/package-services.js.map

@@ -1 +1 @@
-{"version":3,"file":"package-services.js","sourceRoot":"","sources":["../src/package-services.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"package-services.js","sourceRoot":"","sources":["../src/package-services.ts"],"names":[],"mappings":"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"}

package/dist/project-modules.d.ts

@@ -59,5 +59,7 @@ export type ModuleCommandResult = PackageCommandResult;
  */
 export declare function runModuleCommand(root: string, module: ProjectModule, args: readonly string[], command?: string, 
 /** What the command is started with, beside what this process itself has. */
-more?: NodeJS.ProcessEnv): Promise<ModuleCommandResult>;
+more?: NodeJS.ProcessEnv, 
+/** What the command reads on standard input. */
+input?: string): Promise<ModuleCommandResult>;
 //# sourceMappingURL=project-modules.d.ts.map