@openagt/dashboard 0.0.0-stage → 0.9.0

package/dist/cloud-work.js

@@ -0,0 +1,204 @@
+import { nodeGitRunner } from '@openagt/agent-data';
+import { pickAgentPr, prsForBranchOrThrow } from './dashboard/pull-requests.js';
+import { openRemoteBranchPullRequest } from './dashboard/agent-handoff.js';
+import { listAgents, projectRuns, startedAtFromAgentId } from './store/index.js';
+import { errorMessage } from './error-message.js';
+import { startProjectPass } from './project-pass.js';
+// Adopt the branch a cloud session actually worked on (#1601).
+//
+// A web run is a local wrapper that hands the task to claude.ai and ends; the cloud session does
+// the work on a branch of its own naming (`claude/*`), never the designated run branch. Nothing
+// ever told the run's record about that branch, so every surface keyed to it — the session row,
+// the PR resolution, the merge — stared at an empty `agent-*` branch, and the run read
+// as "nothing committed" while its work sat on origin.
+//
+// The hand-off anchor (#1601) makes the match exact rather than guessed: the driver pushes an
+// empty commit unique to the run as the ref the session clones at, so the session's branch — and
+// only it — descends from that commit. This pass walks origin's `claude/*` heads, matches each
+// waiting run by that ancestry, and records what it finds onto the run's archive as one commit
+// on the data branch: the branch, the PR the session opened for it — and when the run was armed
+// for a PR the session never opened, it opens the draft PR itself, which is the armed handoff
+// finally resolving against the facts.
+//
+// Conservative on every unprovable case: a run matching no head (the session has not pushed, or
+// did nothing) or more than one (ancestry alone cannot say which) is simply retried next pass,
+// and a run older than the window stops being asked about at all.
+/** How long after its start a run is still asked about: safely past any cloud session's life. */
+export const CLOUD_ADOPTION_WINDOW_MS = 48 * 60 * 60 * 1000;
+/** Where a cloud session's own branches live: what an adopted run's record names. */
+const CLOUD_BRANCH_PREFIX = 'claude/';
+/** Whether the run's record still carries the branch it was born on, i.e. no adoption happened: no branch, or one that is not a cloud session's. */
+function onBirthBranch(meta) {
+    return !meta.branch?.startsWith(CLOUD_BRANCH_PREFIX);
+}
+/** Whether the run's handoff was armed to open a PR. Absent means armed, matching the agent. */
+function prArmed(meta) {
+    return meta.handoff?.pr !== false;
+}
+/** The settled web runs this pass still owes an answer. */
+function waitingRuns(agents, now) {
+    return agents.filter(meta => {
+        if (meta.target !== 'web' || meta.status === 'running' || !meta.cloudAnchor)
+            return false;
+        const startedAt = meta.startedAt ?? startedAtFromAgentId(meta.id);
+        const startedMs = startedAt === undefined ? NaN : Date.parse(startedAt);
+        if (!Number.isFinite(startedMs) || now - startedMs > CLOUD_ADOPTION_WINDOW_MS)
+            return false;
+        // Owed: the branch is not adopted yet, or it is and the armed PR is still unaccounted for.
+        // An unarmed run stops being asked about once its branch is recorded — a PR someone opens
+        // later is still found live, by branch name, by every surface that shows PRs.
+        return onBirthBranch(meta) || (meta.pr === undefined && prArmed(meta) && meta.status === 'done');
+    });
+}
+/** Where the pass keeps origin's `claude/*` heads locally. */
+const CLOUD_HEAD_PREFIX = 'refs/remotes/origin/claude/';
+/**
+ * Bring origin's `claude/*` heads local, once for the whole pass rather than once per head.
+ *
+ * The objects belong to a cloud VM, so they have to be fetched before any ancestry can be read.
+ * This replaces a fetch per unmatched head per waiting run (#1607) — the saving is the call
+ * count, not the transfer: a second fetch of heads already local negotiates and sends nothing.
+ *
+ * The destination refspec is named rather than left to chance. An ordinary checkout would write
+ * these refs anyway, because git opportunistically updates the remote-tracking branches its
+ * configured refspec covers even when the command line names its own; a checkout cloned with a
+ * narrower refspec — `--single-branch` — would not, and would re-fetch every pass forever.
+ *
+ * Pruned, because these refs are now a standing local copy of a list that used to be read live
+ * from origin each pass: without it a `claude/*` branch deleted on origin would go on matching.
+ */
+async function fetchCloudHeads(git, cwd) {
+    await git(['fetch', '--prune', 'origin', `+refs/heads/claude/*:${CLOUD_HEAD_PREFIX}*`], cwd);
+}
+/**
+ * The `claude/*` heads descending from `anchor` — the proof a branch is this run's, asked of git
+ * once for the whole set rather than once per head.
+ *
+ * `--contains` is the same ancestry question `merge-base --is-ancestor` answered one head at a
+ * time, and asking it this way also answers "how many" in the same call. Unprovable reads as no
+ * match and is retried next pass: an anchor whose object is not local is exactly the case where
+ * the session has pushed nothing for it to be an ancestor of.
+ */
+async function headsDescendingFrom(git, cwd, anchor) {
+    const listing = await git(['for-each-ref', `--contains=${anchor}`, '--format=%(objectname) %(refname)', CLOUD_HEAD_PREFIX], cwd).catch(() => '');
+    const heads = [];
+    for (const line of listing.split('\n')) {
+        const head = /^([0-9a-f]{40,64}) (.+)$/.exec(line.trim());
+        if (head?.[2]?.startsWith(CLOUD_HEAD_PREFIX)) {
+            heads.push({ ref: `claude/${head[2].slice(CLOUD_HEAD_PREFIX.length)}`, sha: head[1] });
+        }
+    }
+    return heads;
+}
+/** The default {@link CloudWorkDeps.patch}: the late facts onto the run, through the project's runs provider. */
+async function patchProvidedRun(cwd, agentId, patch) {
+    const runs = await projectRuns(cwd).catch(() => undefined);
+    return runs ? (await runs.patch(agentId, patch)).ok : false;
+}
+/**
+ * Adopt one project's cloud work (#1601): match each waiting web run to the `claude/*` head
+ * descending from its hand-off anchor, and record the branch and its PR onto the run's archive —
+ * opening the armed draft PR when the session never did. Never throws: a repo with no remote
+ * (or offline) adopts nothing, and every unmatched run is retried next pass.
+ */
+export async function adoptCloudWork(cwd, deps = {}) {
+    const git = deps.git ?? nodeGitRunner();
+    const prs = deps.prs ?? prsForBranchOrThrow;
+    const agents = deps.agents ?? ((project, since) => listAgents(project, projectRuns, { since }));
+    const patchArchive = deps.patch ?? patchProvidedRun;
+    const openPr = deps.openPr ?? openRemoteBranchPullRequest;
+    const now = deps.now ? deps.now() : Date.now();
+    const result = { adopted: [], failed: [] };
+    // Only the window's runs are asked for: an archive grows without bound, and everything older
+    // than the window is a record `waitingRuns` would drop anyway — so it is never read (#1607).
+    const waiting = waitingRuns(await agents(cwd, now - CLOUD_ADOPTION_WINDOW_MS).catch(() => []), now);
+    if (waiting.length === 0)
+        return result;
+    try {
+        await fetchCloudHeads(git, cwd);
+    }
+    catch {
+        return result; // no remote, or it cannot be reached: nothing to match against
+    }
+    for (const run of waiting) {
+        const matches = await headsDescendingFrom(git, cwd, run.cloudAnchor);
+        // Exactly one, or nothing happens: zero is a session that has not pushed (or never will),
+        // and two is a history this pass cannot arbitrate — both are the next pass's question.
+        if (matches.length !== 1)
+            continue;
+        const head = matches[0];
+        const branch = head.ref;
+        // A run whose record names some other branch — neither the one it was born on nor this head
+        // — is not this pass's to answer: a PR opened here would be recorded against a branch it
+        // does not live on.
+        if (!onBirthBranch(run) && run.branch !== branch)
+            continue;
+        // The PR the session opened for its branch, if any — filtered by the run's start so a
+        // predecessor's PR on a reused name is never this run's, `latest` so the last PR that saw
+        // the branch answers (#1512). "None" and "could not list" must not look alike here: a
+        // listing that fails opens nothing this pass (a second draft PR on a branch that already
+        // has one is the cost of guessing), and the run is asked again next time.
+        const since = run.startedAt ?? startedAtFromAgentId(run.id);
+        const listing = await prs(cwd, branch).then(found => ({ ok: true, pr: pickAgentPr(found, since, 'latest') }), (err) => ({ ok: false, error: errorMessage(err) }));
+        let pr = listing.ok ? listing.pr : undefined;
+        let opened = false;
+        if (!listing.ok) {
+            result.failed.push({ agentId: run.id, error: `could not list the PRs of ${branch} (${listing.error}), so no draft PR was opened this pass` });
+        }
+        else if (!pr && prArmed(run) && run.status === 'done' && head.sha !== run.cloudAnchor) {
+            // The armed handoff, finally resolving (#1601): the run was armed for a PR, the session
+            // opened none, and the branch carries something beyond the hand-off itself — so the draft
+            // PR the wrapper's epilogue could never open (it saw only the empty run branch) opens now.
+            // A run whose PR arming was off gets its branch recorded and nothing else.
+            const openedPr = await openPr(cwd, run, branch);
+            if (openedPr.ok && openedPr.number !== undefined && openedPr.url) {
+                pr = { number: openedPr.number, url: openedPr.url, state: 'OPEN', title: '' };
+                opened = true;
+            }
+            else if (!openedPr.ok) {
+                result.failed.push({ agentId: run.id, error: `could not open the armed draft PR for ${branch}: ${openedPr.error}` });
+            }
+        }
+        // One commit on the data branch carries whatever this pass learned: the branch (first time
+        // only), the PR (once known). Nothing learned, nothing written — and nothing announced.
+        const patch = {
+            ...(onBirthBranch(run) ? { branch } : {}),
+            ...(pr && run.pr === undefined ? { pr: { number: pr.number, url: pr.url } } : {}),
+        };
+        if (Object.keys(patch).length === 0)
+            continue;
+        if (!(await patchArchive(cwd, run.id, patch))) {
+            result.failed.push({ agentId: run.id, error: `could not record ${branch} on the run's archive` });
+            continue;
+        }
+        result.adopted.push({
+            agentId: run.id,
+            branch,
+            ...(pr ? { pr: { number: pr.number, url: pr.url } } : {}),
+            ...(opened ? { opened: true } : {}),
+        });
+    }
+    return result;
+}
+/**
+ * Adopt every registered project's cloud work (#1601), one turn per call.
+ *
+ * Adoptions and failures are said out loud, unmatched runs are not: a session that has not
+ * pushed yet is the normal state of every run this watches, and a line per tick about it would
+ * be noise. A run's row changing branch with no line explaining why would read as a bug.
+ */
+export function startCloudWorkAdoption(opts) {
+    const adopt = opts.adopt ?? adoptCloudWork;
+    // No timer of its own (E4): the daemon's one clock calls `tick`.
+    return startProjectPass(opts.projects, async (cwd) => {
+        const { adopted, failed } = await adopt(cwd).catch(() => ({ adopted: [], failed: [] }));
+        for (const adoption of adopted) {
+            const prLine = adoption.pr ? (adoption.opened ? `; opened its armed draft PR ${adoption.pr.url}` : `; its PR is ${adoption.pr.url}`) : '';
+            opts.log(`[openagent] session ${adoption.agentId}'s cloud work landed on ${adoption.branch} — adopted as its branch (#1601)${prLine}`);
+        }
+        for (const failure of failed) {
+            opts.log(`[openagent] cloud work adoption for session ${failure.agentId}: ${failure.error}`);
+        }
+    });
+}
+//# sourceMappingURL=cloud-work.js.map

package/dist/cloud-work.js.map

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

package/dist/daemon-runtime.d.ts

@@ -0,0 +1,42 @@
+import type { OpenAgentEvent } from './events.js';
+import type { StartAgentOptions, StartAgentResult, AddProjectResult, RemoveProjectResult } from './dashboard/index.js';
+import type { EventsSource, RemoteAgents } from './dashboard/rpc-serve.js';
+/**
+ * What the daemon does for a project (#393): start a run, add a project, and relay a run to and
+ * from a connected device. Split from daemon.ts so that file reads as the daemon's lifecycle
+ * (state file, ports, boot, shutdown). The daemon runs no agent itself (#1774): a Start is the
+ * project's own `start` hook line, and the run it begins belongs to whatever tool that line names.
+ */
+/** Inputs to {@link createProjectRuntime}. */
+export interface ProjectRuntimeOptions {
+    /** The daemon's home workspace; a run with no project id targets it. */
+    cwd: string;
+    /** Env for the registry lookups (#393). */
+    env: NodeJS.ProcessEnv;
+}
+/** The per-project surface the dashboard drives, plus its teardown. */
+export interface ProjectRuntime {
+    onStart: (prompt: string, options?: StartAgentOptions, targetProjectId?: string) => Promise<StartAgentResult>;
+    onAddProject: (path: string, share: boolean) => Promise<AddProjectResult>;
+    onRemoveProject: (projectId: string, files?: boolean) => Promise<RemoveProjectResult>;
+    /** The live event stream for an agent this daemon is relaying from a device (#1067), else undefined
+     *  so `onEvents` falls back to tailing the on-disk log. Wired as the dashboard's events source. */
+    remoteEventsSource: EventsSource;
+    /** Tail a relay-started agent's on-disk events (#1067): the daemon's `/_relay/events` endpoint uses
+     *  it to stream one agent back to whichever daemon relayed it here. */
+    tailRelayEvents: (agentId: string, onEvent: (event: OpenAgentEvent) => void) => () => void;
+    /** The relayed-agent lookup the dashboard's read RPCs consult (#1067 slice 2): which device a remote
+     *  run runs on, so a run-scoped RPC forwards there instead of resolving a local checkout. */
+    remoteAgents: RemoteAgents;
+    /** The device side of the relay (#1067 slice 2): run one whitelisted read/steer/handoff RPC against
+     *  this daemon's own home checkout, for a daemon that relayed an agent here. */
+    onRelayRpc: (fn: string, args: unknown[]) => Promise<unknown>;
+    /** Let go of the relayed streams. */
+    dispose: () => Promise<void>;
+}
+/**
+ * The daemon's per-project runtime (#393). The home `cwd` is the default target: a request with
+ * no project id (or the home id) resolves to it without a registry lookup.
+ */
+export declare function createProjectRuntime({ cwd, env }: ProjectRuntimeOptions): ProjectRuntime;
+//# sourceMappingURL=daemon-runtime.d.ts.map

package/dist/daemon-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon-runtime.d.ts","sourceRoot":"","sources":["../src/daemon-runtime.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AACjD,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AACtH,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAgB1E;;;;;GAKG;AAEH,8CAA8C;AAC9C,MAAM,WAAW,qBAAqB;IACpC,wEAAwE;IACxE,GAAG,EAAE,MAAM,CAAA;IACX,2CAA2C;IAC3C,GAAG,EAAE,MAAM,CAAC,UAAU,CAAA;CACvB;AAED,uEAAuE;AACvE,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB,EAAE,eAAe,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAA;IAC7G,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAA;IACzE,eAAe,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,mBAAmB,CAAC,CAAA;IACrF;uGACmG;IACnG,kBAAkB,EAAE,YAAY,CAAA;IAChC;2EACuE;IACvE,eAAe,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,KAAK,MAAM,IAAI,CAAA;IAC1F;iGAC6F;IAC7F,YAAY,EAAE,YAAY,CAAA;IAC1B;oFACgF;IAChF,UAAU,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IAC7D,qCAAqC;IACrC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC7B;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,qBAAqB,GAAG,cAAc,CA6JxF"}

package/dist/daemon-runtime.js

@@ -0,0 +1,183 @@
+import { resolve } from 'node:path';
+import { hostname } from 'node:os';
+import { stat } from 'node:fs/promises';
+import { fromDiaryLine, isPidAlive, projectBranches, readLiveMetas, resolveAgentDiary } from './store/index.js';
+import { RelayedAgents, startRemoteAgent } from './dashboard/remote-run.js';
+import { dispatchRelayRpc } from './dashboard-rpc/relay-dispatch.js';
+import { tailAgentEvents } from './dashboard-rpc/events-tail.js';
+import { addProject, listProjects, projectId, removeProject } from './registry.js';
+import { writeHookLines } from './built-in.js';
+import { installProject } from './install.js';
+import { fileBranchRepo, writeSharing } from '@openagt/agent-data';
+import { removeProjectFiles } from './remove-files.js';
+import { runProjectHooks, runStartHook } from './project-hooks.js';
+import { publishLevelOf, publishPickIn } from './publish-levels.js';
+import { isBranchName } from './branch-name.js';
+import { hasRemote } from './has-remote.js';
+import { projectGitHost } from './store/git-host.js';
+import { providedDataChanged } from './store/provided.js';
+/**
+ * The daemon's per-project runtime (#393). The home `cwd` is the default target: a request with
+ * no project id (or the home id) resolves to it without a registry lookup.
+ */
+export function createProjectRuntime({ cwd, env }) {
+    const homeId = projectId(resolve(cwd));
+    // Runs this daemon is relaying to/from a connected device (#1067): the local half of a remote agent.
+    const relayedAgents = new RelayedAgents();
+    // The relayed-agent lookup the dashboard's read RPCs consult (#1067 slice 2): is this agentId remote, and
+    // which device owns it. Outlives the event stream so a finished remote agent's push/PR still reaches it.
+    const remoteAgents = {
+        target: agentId => relayedAgents.target(agentId),
+        list: projectId => relayedAgents.list(projectId),
+    };
+    // The device side of the relay (#1067 slice 2): run one whitelisted read/steer/handoff RPC against this
+    // daemon's own home checkout, for a daemon that relayed an agent here. Home id forces the addressed project.
+    const onRelayRpc = (fn, args) => dispatchRelayRpc(homeId, fn, args);
+    // A project id resolves to its repo path via the registry; the home id (or none)
+    // resolves to the daemon's own `cwd` without a lookup.
+    const resolveProject = async (id) => {
+        if (!id || id === homeId)
+            return cwd;
+        const records = await listProjects(undefined, env).catch(() => []);
+        return records.find(record => record.id === id)?.path;
+    };
+    // Start (#1774): the project's own `start` hook line, which answers the id of the run it began.
+    // The daemon names no tool and holds nothing about the run: no slot, no cap (a person's click is
+    // the brake), no process to stop at shutdown. A project without the line cannot start a run here.
+    const onStart = async (prompt, options = {}, targetProjectId) => {
+        // Run on a connected device (#1067): forward the start to the remote daemon, which runs its own
+        // project's hook, and relay the run's events back. `remote` is stripped so the device does not
+        // relay onward, and `base` because a branch of this machine names nothing on the device (the device drops it too). The
+        // device starts it in its own home project.
+        if (options.remote) {
+            const { remote, base: _thisMachines, ...forwarded } = options;
+            const result = await startRemoteAgent(remote, { prompt, options: forwarded });
+            if (result.ok) {
+                // A relayed agent has no local checkout or pid, so its list row is a memory-only stub (#1077):
+                // registered here so onAgents can show it and a dashboard reload re-opens it. Never written to disk.
+                const now = new Date().toISOString();
+                const meta = {
+                    status: 'running',
+                    id: result.agentId,
+                    startedAt: now,
+                    updatedAt: now,
+                    target: 'remote',
+                    intent: prompt,
+                    ...(remote.label ? { remoteLabel: remote.label } : {}),
+                };
+                relayedAgents.register(result.agentId, remote, meta, targetProjectId ?? homeId);
+            }
+            return result;
+        }
+        const projectCwd = await resolveProject(targetProjectId);
+        if (!projectCwd)
+            return { ok: false, error: `unknown project: ${targetProjectId}` };
+        // The branch to start from ends up on the line's command line: only a branch name goes there.
+        // Refused, not dropped: a run started from the main branch instead would be a silent swap.
+        if (options.base !== undefined && !isBranchName(options.base))
+            return { ok: false, error: `not a branch name: ${String(options.base)}` };
+        // The pick in force is decided here, so every Start goes the same way whichever page sent it:
+        // with none saved the run commits and pushes nothing, and with one the project is not offered
+        // it goes as far as the project does with no pull request: its branch pushed, or its work
+        // committed where there is no remote.
+        const publish = publishLevelOf(publishPickIn(options.publish, (await projectGitHost(projectCwd).catch(() => undefined)) !== undefined, await hasRemote(projectCwd)));
+        const started = await runStartHook(projectCwd, {
+            prompt,
+            ...(options.driver !== undefined ? { driver: options.driver } : {}),
+            ...(options.model !== undefined ? { model: options.model } : {}),
+            ...(options.then !== undefined ? { then: options.then } : {}),
+            ...(publish !== undefined ? { publish } : {}),
+            ...(options.base !== undefined ? { base: options.base } : {}),
+        });
+        // The line made a checkout (or is about to): the project's checkouts are read again on the
+        // next look rather than a few seconds from now, so the new run's page finds its own.
+        if (started.ok)
+            projectBranches.changed(projectCwd);
+        return started.ok ? { ok: true, agentId: started.id } : { ok: false, error: started.error };
+    };
+    // Add a project (#396): install the repo, then register it so it appears in the Projects
+    // list. installProject is idempotent (an already-activated repo is a no-op success). `share`
+    // is the person's answer on the agents' records, written before the project is registered:
+    // the first sync of a project added with `false` sends nothing.
+    const onAddProject = async (path, share) => {
+        // Resolve relative input against the daemon cwd, and check the directory really
+        // exists first: without this a bad path reaches git as a missing cwd, which
+        // surfaces as the confusing "spawn git ENOENT" rather than a path error.
+        const abs = resolve(path);
+        const isDir = await stat(abs).then(s => s.isDirectory()).catch(() => false);
+        if (!isDir)
+            return { ok: false, error: `path does not exist or is not a directory: ${abs}` };
+        const result = await installProject(abs);
+        if (!result.ok)
+            return { ok: false, error: result.error };
+        // A yes is to the remote that is there: with none the records are kept, so a remote the
+        // project gets later is asked about, in the project's menu, before anything goes to it.
+        const shared = share && (await hasRemote(abs));
+        const written = await writeSharing(abs, shared).then(() => undefined, (err) => (err instanceof Error ? err.message : String(err)));
+        if (written !== undefined)
+            return { ok: false, error: written };
+        // Each package that writes hook lines writes its own (the built-in runner's start, resume and
+        // check among them), so the new project starts an agent with nothing typed by hand. A writer
+        // keeps every line already there, so adding a project again only fills what is missing.
+        for (const failed of await writeHookLines(abs))
+            console.log(`[openagent] hook lines (${abs}): ${failed}`);
+        await addProject(abs, new Date().toISOString()).catch(() => { });
+        // The project's open hooks (#1774): a project added while the daemon runs is a project the
+        // boot never saw, so its open lines run now, the way they would have at boot.
+        await runProjectHooks(abs, 'open', { log: console.log });
+        return { ok: true, alreadyActivated: result.alreadyActivated === true, ...(share && !shared ? { noRemote: true } : {}) };
+    };
+    // Remove a project: it leaves the Projects list and nothing in its folder is deleted. Found in
+    // the list by its id and not through its folder, so a project whose folder is gone goes too.
+    const onRemoveProject = async (id, files = false) => {
+        const listed = await listProjects(undefined, env).catch(() => []);
+        const record = listed.find(project => project.id === id);
+        if (!record)
+            return { ok: false, error: 'no project with that id is on the list' };
+        const here = await stat(record.path).then(s => s.isDirectory()).catch(() => false);
+        if (here) {
+            // The checkouts are read fresh: a run started a moment ago must be seen.
+            projectBranches.changed(record.path);
+            // An agent at work would go on working in a project the dashboard no longer shows. A card
+            // left "running" by a process that died does not count: nothing is working there.
+            const working = (await readLiveMetas(record.path).catch(() => [])).some(agent => agent.status === 'running' && agent.pid !== undefined && agent.host === hostname() && isPidAlive(agent.pid));
+            if (working)
+                return { ok: false, error: 'An agent is working in this project. Stop it, then remove the project.' };
+            // The project's close hooks, the ones a shutdown would have run for it: once it is off the
+            // list no shutdown names it, and what its open hooks started (a scheduler) would run on.
+            await runProjectHooks(record.path, 'close', { log: console.log });
+        }
+        await removeProject(id, undefined, env);
+        providedDataChanged(record.path);
+        if (!files || !here)
+            return { ok: true };
+        // Off the list first, so no background job of this daemon starts on the folder again; then
+        // what OpenAgent left in it. The records are the repository's: while another project on the
+        // list is a checkout of the same repository, they stay.
+        const repository = await fileBranchRepo(record.path);
+        let recordsUsedBy;
+        for (const other of listed) {
+            if (other.id !== id && repository !== undefined && (await fileBranchRepo(other.path)) === repository)
+                recordsUsedBy = other.path;
+        }
+        const cleanup = await removeProjectFiles(record.path, { recordsUsedBy });
+        providedDataChanged(record.path);
+        return { ok: true, cleanup };
+    };
+    // The dashboard's events source (#1067): a stream for an agent this daemon is relaying from a device,
+    // else undefined so `onEvents` tails the on-disk log as usual for an ordinary local agent.
+    const remoteEventsSource = (_projectId, agentId) => relayedAgents.get(agentId);
+    // Tail a relay-started run's own log (#1067) for the `/_relay/events` endpoint: the diary the
+    // run's tool keeps, its lines turned into events. The relocating tail, for the same reason as
+    // the dashboard's onEvents: the diary becomes the finished run's when the run ends.
+    const tailRelayEvents = (agentId, onEvent) => tailAgentEvents(() => resolveAgentDiary(cwd, agentId), line => {
+        const event = fromDiaryLine(line);
+        if (event)
+            onEvent(event);
+    });
+    const dispose = async () => {
+        relayedAgents.dispose();
+    };
+    return { onStart, onAddProject, onRemoveProject, remoteEventsSource, tailRelayEvents, remoteAgents, onRelayRpc, dispose };
+}
+//# sourceMappingURL=daemon-runtime.js.map

package/dist/daemon-runtime.js.map

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

package/dist/daemon-services.d.ts

@@ -0,0 +1,37 @@
+import type { ProjectErrors } from './project-errors.js';
+/** What the daemon needs back. */
+export interface BackgroundServices {
+    /**
+     * Stop every background job. Resolves once the tick in flight has finished: these jobs commit
+     * and push, and stopping their clock does not stop their turn.
+     */
+    quiesce: () => Promise<void>;
+}
+/** What {@link startBackgroundServices} needs from the daemon. */
+export interface BackgroundServiceDeps {
+    env: NodeJS.ProcessEnv;
+    /** Where a job records a project state the user must fix (#1500), for the dashboard to show. */
+    projectErrors: ProjectErrors;
+    log: (message: string) => void;
+}
+/**
+ * One project's data-sync turn (#1599): converge the `agent-data` branch — the skills' branch,
+ * which carries the tickets, the queue and the `logs` skill's runs — with
+ * origin through the shared branch library, one pull, and set or clear the project's `data-sync`
+ * error by the outcome. The clear is unconditional on success, so the error lives exactly as long
+ * as the condition — the next tick after the user fixes the remote, it is gone. A branch that stays
+ * on this machine (no remote, or the person does not share it) is no error: the project carries why,
+ * for as long as that holds. The daemon knows
+ * nothing of what is on the branch (#1774): a skill's own setup makes its files.
+ */
+export declare function syncProjectData(path: string, errors: ProjectErrors, log: (message: string) => void): Promise<void>;
+/**
+ * One project's provider check (#1820), on the data sync's clock: a kind of the project's data
+ * that packages declare but none is settled to provide (several declare it and the project's
+ * package.json names none, or names one that does not declare it) is the project's `provider`
+ * error, every such kind on its own line; every kind settled clears it. OpenAgent never picks
+ * the first declarer silently: the project says, or nothing provides and the banner says why.
+ */
+export declare function checkProviders(path: string, errors: ProjectErrors): Promise<void>;
+export declare function startBackgroundServices(deps: BackgroundServiceDeps): BackgroundServices;
+//# sourceMappingURL=daemon-services.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"daemon-services.d.ts","sourceRoot":"","sources":["../src/daemon-services.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AA8BxD,kCAAkC;AAClC,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC7B;AAED,kEAAkE;AAClE,MAAM,WAAW,qBAAqB;IACpC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAA;IACtB,gGAAgG;IAChG,aAAa,EAAE,aAAa,CAAA;IAC5B,GAAG,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;CAC/B;AAED;;;;;;;;;GASG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAUxH;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAIvF;AAQD,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,qBAAqB,GAAG,kBAAkB,CA0DvF"}