@openagt/dashboard 0.0.0-stage → 0.9.0

package/dist/dashboard/interventions.js.map

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

package/dist/dashboard/keyed-watcher.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Tracks which items have been announced, so only new ones notify. Identity is the caller's
+ * (`keyOf`), since what makes two items "the same" is a property of what is being watched.
+ * Testable without timers.
+ *
+ * The baseline is kept per project (`scopeOf`), not once for the whole poll (#1623). A poll that
+ * reached three projects out of four knows what already existed on those three and knows nothing
+ * about the fourth, and announcing is a per-project decision anyway. Held globally, one project
+ * that can never be read — a registered repo with no remote is an ordinary case — would either
+ * silence every project's notifications or hand the whole set a baseline it had not earned.
+ */
+export declare class SeenTracker<T> {
+    private readonly keyOf;
+    private readonly scopeOf;
+    private readonly seen;
+    private readonly warmedUp;
+    constructor(keyOf: (item: T) => string, scopeOf: (item: T) => string);
+    /**
+     * Fold a poll's items into the baseline and return the ones worth announcing: the items not seen
+     * before, from projects this watcher has a real baseline for. `whole` names the projects the poll
+     * read completely, and only those earn a baseline — so whatever already existed at start-up is
+     * never announced, and a project that could not be read stays quiet until it can be.
+     *
+     * Items keep being folded in either way: a partial read can only under-report, never invent, so
+     * anything it did see is still something the user should not later hear about as new.
+     */
+    observe(items: T[], whole: Iterable<string>): T[];
+}
+//# sourceMappingURL=keyed-watcher.d.ts.map

package/dist/dashboard/keyed-watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyed-watcher.d.ts","sourceRoot":"","sources":["../../src/dashboard/keyed-watcher.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;GAUG;AACH,qBAAa,WAAW,CAAC,CAAC;IAKtB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAL1B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAoB;IACzC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoB;IAE7C,YACmB,KAAK,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,EAC1B,OAAO,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,EAC3C;IAEJ;;;;;;;;OAQG;IACH,OAAO,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAOhD;CACF"}

package/dist/dashboard/keyed-watcher.js

@@ -0,0 +1,42 @@
+// The baseline half of the browser's notifications (#627): what a feed already held versus what
+// is new. One engine, two feeds: the "needs you" queue and the "New activity" feed. They differ
+// only in how an item is identified, so that is a parameter rather than a second copy.
+/**
+ * Tracks which items have been announced, so only new ones notify. Identity is the caller's
+ * (`keyOf`), since what makes two items "the same" is a property of what is being watched.
+ * Testable without timers.
+ *
+ * The baseline is kept per project (`scopeOf`), not once for the whole poll (#1623). A poll that
+ * reached three projects out of four knows what already existed on those three and knows nothing
+ * about the fourth, and announcing is a per-project decision anyway. Held globally, one project
+ * that can never be read — a registered repo with no remote is an ordinary case — would either
+ * silence every project's notifications or hand the whole set a baseline it had not earned.
+ */
+export class SeenTracker {
+    keyOf;
+    scopeOf;
+    seen = new Set();
+    warmedUp = new Set();
+    constructor(keyOf, scopeOf) {
+        this.keyOf = keyOf;
+        this.scopeOf = scopeOf;
+    }
+    /**
+     * Fold a poll's items into the baseline and return the ones worth announcing: the items not seen
+     * before, from projects this watcher has a real baseline for. `whole` names the projects the poll
+     * read completely, and only those earn a baseline — so whatever already existed at start-up is
+     * never announced, and a project that could not be read stays quiet until it can be.
+     *
+     * Items keep being folded in either way: a partial read can only under-report, never invent, so
+     * anything it did see is still something the user should not later hear about as new.
+     */
+    observe(items, whole) {
+        const fresh = items.filter(item => this.warmedUp.has(this.scopeOf(item)) && !this.seen.has(this.keyOf(item)));
+        for (const item of items)
+            this.seen.add(this.keyOf(item));
+        for (const project of whole)
+            this.warmedUp.add(project);
+        return fresh;
+    }
+}
+//# sourceMappingURL=keyed-watcher.js.map

package/dist/dashboard/keyed-watcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyed-watcher.js","sourceRoot":"","sources":["../../src/dashboard/keyed-watcher.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAChG,gGAAgG;AAChG,uFAAuF;AAEvF;;;;;;;;;;GAUG;AACH,MAAM,OAAO,WAAW;IAKH,KAAK;IACL,OAAO;IALT,IAAI,GAAG,IAAI,GAAG,EAAU,CAAA;IACxB,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAA;IAE7C,YACmB,KAA0B,EAC1B,OAA4B;qBAD5B,KAAK;uBACL,OAAO;IACvB,CAAC;IAEJ;;;;;;;;OAQG;IACH,OAAO,CAAC,KAAU,EAAE,KAAuB;QACzC,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CACxB,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAClF,CAAA;QACD,KAAK,MAAM,IAAI,IAAI,KAAK;YAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAA;QACzD,KAAK,MAAM,OAAO,IAAI,KAAK;YAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;QACvD,OAAO,KAAK,CAAA;IACd,CAAC;CACF"}

package/dist/dashboard/keys.d.ts

@@ -0,0 +1,31 @@
+import type { Activity } from './activity.js';
+import type { Intervention } from './interventions.js';
+/**
+ * The stable identity of a watched item, which the browser notifications dedupe on.
+ *
+ * A leaf module on purpose: `activity.ts` and `interventions.ts` build their items by reading the
+ * store, so they import `node:*` and cannot be reached from the browser bundle. These functions
+ * are pure and depend on nothing but the item, so they live here and are re-exported from
+ * `client.ts` — which is what lets the dashboard share them instead of keeping a copy that could
+ * drift from the item types.
+ *
+ * The type imports are erased at compile time, so they add no edge to the graph `client.test.ts`
+ * walks.
+ */
+/**
+ * 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 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
+ * parked would otherwise share one identity, and the dedupe would announce only one of them.
+ */
+export declare function interventionKey(item: Intervention): string;
+/**
+ * The stable identity of an activity item: its kind + project + run. The kind is part of the key
+ * so an agent's `started` and `finished` are two separate announcements (one when it kicks off, one
+ * when it lands), each firing exactly once.
+ */
+export declare function activityKey(item: Activity): string;
+//# sourceMappingURL=keys.d.ts.map

package/dist/dashboard/keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keys.d.ts","sourceRoot":"","sources":["../../src/dashboard/keys.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAC7C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEtD;;;;;;;;;;;GAWG;AAEH;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CAI1D;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAElD"}

package/dist/dashboard/keys.js

@@ -0,0 +1,37 @@
+/**
+ * The stable identity of a watched item, which the browser notifications dedupe on.
+ *
+ * A leaf module on purpose: `activity.ts` and `interventions.ts` build their items by reading the
+ * store, so they import `node:*` and cannot be reached from the browser bundle. These functions
+ * are pure and depend on nothing but the item, so they live here and are re-exported from
+ * `client.ts` — which is what lets the dashboard share them instead of keeping a copy that could
+ * drift from the item types.
+ *
+ * The type imports are erased at compile time, so they add no edge to the graph `client.test.ts`
+ * walks.
+ */
+/**
+ * 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 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
+ * parked would otherwise share one identity, and the dedupe would announce only one of them.
+ */
+export function interventionKey(item) {
+    if (item.kind === 'awaiting')
+        return `awaiting:${item.projectId}:${item.agentId ?? ''}:${item.awaitId ?? ''}`;
+    if (item.kind === 'unpushed')
+        return `unpushed:${item.projectId}:${item.agentId ?? ''}`;
+    return item.url ?? '';
+}
+/**
+ * The stable identity of an activity item: its kind + project + run. The kind is part of the key
+ * so an agent's `started` and `finished` are two separate announcements (one when it kicks off, one
+ * when it lands), each firing exactly once.
+ */
+export function activityKey(item) {
+    return `${item.kind}:${item.projectId}:${item.agentId}`;
+}
+//# sourceMappingURL=keys.js.map

package/dist/dashboard/keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keys.js","sourceRoot":"","sources":["../../src/dashboard/keys.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;GAWG;AAEH;;;;;;;;GAQG;AACH,MAAM,UAAU,eAAe,CAAC,IAAkB;IAChD,IAAI,IAAI,CAAC,IAAI,KAAK,UAAU;QAAE,OAAO,YAAY,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,OAAO,IAAI,EAAE,IAAI,IAAI,CAAC,OAAO,IAAI,EAAE,EAAE,CAAA;IAC7G,IAAI,IAAI,CAAC,IAAI,KAAK,UAAU;QAAE,OAAO,YAAY,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,OAAO,IAAI,EAAE,EAAE,CAAA;IACvF,OAAO,IAAI,CAAC,GAAG,IAAI,EAAE,CAAA;AACvB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,IAAc;IACxC,OAAO,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,OAAO,EAAE,CAAA;AACzD,CAAC"}

package/dist/dashboard/models.d.ts

@@ -0,0 +1,25 @@
+import type { Driver, DriverModel } from '@openagt/agent-driver';
+import { type DriverName } from '../driver-names.js';
+/** What one coding agent offers: its models, or why it could not say. */
+export type DriverModels = {
+    models: DriverModel[];
+} | {
+    models: [];
+    error: string;
+};
+/** The models of every coding agent a person can pick, by driver. */
+export type ModelsView = Record<DriverName, DriverModels>;
+/** Where the dashboard reads which models each coding agent offers. */
+export interface ModelsSource {
+    read(): Promise<ModelsView>;
+}
+/**
+ * Ask each coding agent for its models, once: the first read asks, every later read answers from
+ * what it said, for the daemon's life. The list changes only with a new CLI version or a new
+ * login, and each question starts a CLI, so a menu opened again never waits on one. An agent that
+ * could not say is asked again at the next read, so a CLI installed or logged in since is found.
+ */
+export declare function cachedModelsSource(drivers: Record<DriverName, Pick<Driver, 'listModels'>>): ModelsSource;
+/** The daemon's own source: the coding agents on this machine, asked as the person's own login. */
+export declare function defaultModelsSource(): ModelsSource;
+//# sourceMappingURL=models.d.ts.map

package/dist/dashboard/models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../../src/dashboard/models.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAChE,OAAO,EAAW,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAE7D,yEAAyE;AACzE,MAAM,MAAM,YAAY,GAAG;IAAE,MAAM,EAAE,WAAW,EAAE,CAAA;CAAE,GAAG;IAAE,MAAM,EAAE,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAA;AAEpF,qEAAqE;AACrE,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,EAAE,YAAY,CAAC,CAAA;AAEzD,uEAAuE;AACvE,MAAM,WAAW,YAAY;IAC3B,IAAI,IAAI,OAAO,CAAC,UAAU,CAAC,CAAA;CAC5B;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,CAAC,UAAU,EAAE,IAAI,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,GAAG,YAAY,CAkBxG;AAED,mGAAmG;AACnG,wBAAgB,mBAAmB,IAAI,YAAY,CAElD"}

package/dist/dashboard/models.js

@@ -0,0 +1,30 @@
+import { ClaudeCodeDriver } from '@openagt/agent-driver-claude';
+import { CodexDriver } from '@openagt/agent-driver-codex';
+import { DRIVERS } from '../driver-names.js';
+/**
+ * Ask each coding agent for its models, once: the first read asks, every later read answers from
+ * what it said, for the daemon's life. The list changes only with a new CLI version or a new
+ * login, and each question starts a CLI, so a menu opened again never waits on one. An agent that
+ * could not say is asked again at the next read, so a CLI installed or logged in since is found.
+ */
+export function cachedModelsSource(drivers) {
+    const asked = new Map();
+    const ask = (name) => {
+        let answer = asked.get(name);
+        if (!answer) {
+            const listModels = drivers[name].listModels;
+            answer = listModels ? listModels.call(drivers[name]) : Promise.reject(new Error('this agent cannot list its models'));
+            asked.set(name, answer);
+            answer.catch(() => asked.delete(name));
+        }
+        return answer.then(models => ({ models }), (err) => ({ models: [], error: err instanceof Error ? err.message : String(err) }));
+    };
+    return {
+        read: async () => Object.fromEntries(await Promise.all(DRIVERS.map(async (name) => [name, await ask(name)]))),
+    };
+}
+/** The daemon's own source: the coding agents on this machine, asked as the person's own login. */
+export function defaultModelsSource() {
+    return cachedModelsSource({ 'claude-code': new ClaudeCodeDriver(), codex: new CodexDriver() });
+}
+//# sourceMappingURL=models.js.map

package/dist/dashboard/models.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.js","sourceRoot":"","sources":["../../src/dashboard/models.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAA;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAA;AAEzD,OAAO,EAAE,OAAO,EAAmB,MAAM,oBAAoB,CAAA;AAa7D;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAuD;IACxF,MAAM,KAAK,GAAG,IAAI,GAAG,EAAsC,CAAA;IAC3D,MAAM,GAAG,GAAG,CAAC,IAAgB,EAAyB,EAAE;QACtD,IAAI,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QAC5B,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,UAAU,CAAA;YAC3C,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC,CAAA;YACrH,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;YACvB,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAA;QACxC,CAAC;QACD,OAAO,MAAM,CAAC,IAAI,CAChB,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EACtB,CAAC,GAAY,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAC5F,CAAA;IACH,CAAC,CAAA;IACD,OAAO;QACL,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAC,IAAI,EAAC,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,CAAC,IAAI,CAAC,CAAU,CAAC,CAAC,CAAe;KACnI,CAAA;AACH,CAAC;AAED,mGAAmG;AACnG,MAAM,UAAU,mBAAmB;IACjC,OAAO,kBAAkB,CAAC,EAAE,aAAa,EAAE,IAAI,gBAAgB,EAAE,EAAE,KAAK,EAAE,IAAI,WAAW,EAAE,EAAE,CAAC,CAAA;AAChG,CAAC"}

package/dist/dashboard/module-host.d.ts

@@ -0,0 +1,44 @@
+import { type BranchesFor } from '../store/index.js';
+import { type LinkedPr } from './pull-requests.js';
+import type { Cached } from './cache.js';
+import type { ModuleServerHost } from '../module-server.js';
+/** What {@link serverHost} reads through; each defaults to the production reader. */
+export interface ServerHostDeps {
+    branches?: BranchesFor;
+    agent?: (root: string, agentId: string) => Promise<{
+        id: string;
+        status?: string;
+        host?: string;
+        branch?: string;
+        pr?: {
+            number: number;
+        };
+        base?: string;
+        baseCommit?: string;
+        landed?: string;
+    } | undefined>;
+    /** This machine's name, against a run's `host`. */
+    host?: string;
+    prs?: (root: string, branch: string) => Promise<Cached<LinkedPr[]>>;
+}
+/** The host a read of the project at `root` is given. */
+export declare function serverHost(root: string, deps?: ServerHostDeps): ModuleServerHost;
+/** How large the input of one read may be, as JSON: what a page asks with, never a payload. */
+export declare const MAX_READ_INPUT: number;
+/** How long one read may take before it answers an error instead. */
+export declare const READ_TIMEOUT_MS = 20000;
+/** What a read answered: its JSON, or why there is none. */
+export type ModuleReadResult = {
+    ok: true;
+    output: unknown;
+} | {
+    ok: false;
+    error: string;
+};
+/**
+ * Call read `name` of the server part at `file` with `host` and `input`. Refused: a part that did
+ * not load, a read it does not have, an input that is not an object or is too large. A read that
+ * throws or runs past {@link READ_TIMEOUT_MS} answers an error; nothing a read does stops the daemon.
+ */
+export declare function callModuleRead(file: string, name: string, host: ModuleServerHost, input: unknown, timeoutMs?: number): Promise<ModuleReadResult>;
+//# sourceMappingURL=module-host.d.ts.map

package/dist/dashboard/module-host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-host.d.ts","sourceRoot":"","sources":["../../src/dashboard/module-host.ts"],"names":[],"mappings":"AACA,OAAO,EAAqD,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAEvG,OAAO,EAAsB,KAAK,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AACtE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AACxC,OAAO,KAAK,EAA0D,gBAAgB,EAAY,MAAM,qBAAqB,CAAA;AAM7H,qFAAqF;AACrF,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,WAAW,CAAA;IACtB,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,EAAE,CAAC,EAAE;YAAE,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC,CAAA;IAC7M,mDAAmD;IACnD,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAA;CACpE;AAED,yDAAyD;AACzD,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,cAAmB,GAAG,gBAAgB,CAkCpF;AAoBD,+FAA+F;AAC/F,eAAO,MAAM,cAAc,QAAY,CAAA;AACvC,qEAAqE;AACrE,eAAO,MAAM,eAAe,QAAS,CAAA;AAErC,4DAA4D;AAC5D,MAAM,MAAM,gBAAgB,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAA;AAE3F;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,SAAkB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAsB/J"}

package/dist/dashboard/module-host.js

@@ -0,0 +1,91 @@
+import { pathToFileURL } from 'node:url';
+import { findAgent, findCheckout, isRunId, projectBranches } from '../store/index.js';
+import { agentBranchFor, leftNothing } from './agent-handoff.js';
+import { cachedPrsForBranch } from './pull-requests.js';
+/** The host a read of the project at `root` is given. */
+export function serverHost(root, deps = {}) {
+    return {
+        root,
+        async run(agentId) {
+            if (typeof agentId !== 'string' || !isRunId(agentId))
+                return undefined;
+            const checkout = await findCheckout(root, agentId, deps.branches ?? projectBranches);
+            const agent = await (deps.agent ?? findAgent)(root, agentId).catch(() => undefined);
+            if (!checkout && !agent)
+                return undefined;
+            const branch = agent && agentBranchFor(agent);
+            return {
+                ...(checkout ? { checkout: checkout.path } : {}),
+                ...(agent
+                    ? {
+                        record: {
+                            ...(agent.status !== undefined ? { status: agent.status } : {}),
+                            ...(agent.host !== undefined ? { host: agent.host } : {}),
+                            ...(branch !== undefined ? { branch } : {}),
+                            ...(agent.pr ? { pr: { number: agent.pr.number } } : {}),
+                            ...(agent.base !== undefined ? { base: agent.base } : {}),
+                            ...(agent.baseCommit !== undefined ? { baseCommit: agent.baseCommit } : {}),
+                            ...(agent.landed !== undefined ? { landed: agent.landed } : {}),
+                        },
+                    }
+                    : {}),
+                changedNothing: agent ? leftNothing(agent, deps.host) : false,
+            };
+        },
+        async mergeCommit(branch, number) {
+            const read = await (deps.prs ?? cachedPrsForBranch)(root, branch).catch(() => ({ value: undefined, pending: false }));
+            if (read.pending && read.value === undefined)
+                return { pending: true };
+            const pr = read.value?.find(pr => pr.number === number);
+            return pr?.mergeCommit ? { pending: false, commit: pr.mergeCommit, ...(pr.headRefOid ? { head: pr.headRefOid } : {}) } : { pending: false };
+        },
+    };
+}
+/** Each server part, imported once per daemon, by its file. */
+const imported = new Map();
+function load(file) {
+    let loading = imported.get(file);
+    if (!loading) {
+        loading = import(pathToFileURL(file).href).then((module) => {
+            const server = module.default;
+            return server && typeof server === 'object' && server.reads && typeof server.reads === 'object' ? server : undefined;
+        }, () => undefined);
+        imported.set(file, loading);
+    }
+    return loading;
+}
+/** How large the input of one read may be, as JSON: what a page asks with, never a payload. */
+export const MAX_READ_INPUT = 16 * 1024;
+/** How long one read may take before it answers an error instead. */
+export const READ_TIMEOUT_MS = 20_000;
+/**
+ * Call read `name` of the server part at `file` with `host` and `input`. Refused: a part that did
+ * not load, a read it does not have, an input that is not an object or is too large. A read that
+ * throws or runs past {@link READ_TIMEOUT_MS} answers an error; nothing a read does stops the daemon.
+ */
+export async function callModuleRead(file, name, host, input, timeoutMs = READ_TIMEOUT_MS) {
+    if (!input || typeof input !== 'object' || Array.isArray(input))
+        return { ok: false, error: 'a read takes an object' };
+    if (JSON.stringify(input).length > MAX_READ_INPUT)
+        return { ok: false, error: 'the read input is too large' };
+    const server = await load(file);
+    if (!server)
+        return { ok: false, error: 'the module’s server part did not load' };
+    const read = Object.hasOwn(server.reads, name) ? server.reads[name] : undefined;
+    if (typeof read !== 'function')
+        return { ok: false, error: `the module has no read ${name}` };
+    let timer;
+    const timeout = new Promise(resolve => {
+        timer = setTimeout(() => resolve({ ok: false, error: `the read ${name} took too long` }), timeoutMs);
+    });
+    try {
+        return await Promise.race([
+            read(host, input).then((output) => ({ ok: true, output: output ?? null }), (error) => ({ ok: false, error: error instanceof Error ? error.message : String(error) })),
+            timeout,
+        ]);
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+//# sourceMappingURL=module-host.js.map

package/dist/dashboard/module-host.js.map

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

package/dist/dashboard/module-serve.d.ts

@@ -0,0 +1,15 @@
+import type { IncomingMessage, ServerResponse } from 'node:http';
+import { type ProjectsProvider } from './projects.js';
+import { type ProjectModule } from '../project-modules.js';
+/** Where module files are served: `/_modules/<project id>/<package>/<file>`, each segment encoded. */
+export declare const MODULES_PREFIX = "/_modules";
+/** The URL a module's browser part is served at from one project. */
+export declare function moduleUrl(projectId: string, module: Pick<ProjectModule, 'package' | 'entry'>): string;
+/**
+ * Serve one module file (#1774): the project must be registered, the package must be a module of
+ * that project, and the file must sit inside the module's browser part's own directory. Anything else is a
+ * 404, never a fallback: a module URL is asked for by the dashboard's loader, not typed by a person.
+ * Served as `no-cache`, since a module is rebuilt in place under the same name.
+ */
+export declare function serveModuleFile(req: IncomingMessage, res: ServerResponse, pathname: string, projects?: ProjectsProvider): Promise<void>;
+//# sourceMappingURL=module-serve.d.ts.map

package/dist/dashboard/module-serve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-serve.d.ts","sourceRoot":"","sources":["../../src/dashboard/module-serve.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAEhE,OAAO,EAA2B,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAC9E,OAAO,EAAiC,KAAK,aAAa,EAAE,MAAM,uBAAuB,CAAA;AAEzF,sGAAsG;AACtG,eAAO,MAAM,cAAc,cAAc,CAAA;AAEzC,qEAAqE;AACrE,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,aAAa,EAAE,SAAS,GAAG,OAAO,CAAC,GAAG,MAAM,CAGrG;AAUD;;;;;GAKG;AACH,wBAAsB,eAAe,CACnC,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,EACnB,QAAQ,EAAE,MAAM,EAChB,QAAQ,GAAE,gBAA4C,GACrD,OAAO,CAAC,IAAI,CAAC,CAef"}

package/dist/dashboard/module-serve.js

@@ -0,0 +1,45 @@
+import { readFile } from 'node:fs/promises';
+import { contentTypeFor } from './content-type.js';
+import { defaultProjectsProvider } from './projects.js';
+import { findProjectModule, moduleFile } from '../project-modules.js';
+/** Where module files are served: `/_modules/<project id>/<package>/<file>`, each segment encoded. */
+export const MODULES_PREFIX = '/_modules';
+/** The URL a module's browser part is served at from one project. */
+export function moduleUrl(projectId, module) {
+    const file = module.entry.split('/').map(encodeURIComponent).join('/');
+    return `${MODULES_PREFIX}/${encodeURIComponent(projectId)}/${encodeURIComponent(module.package)}/${file}`;
+}
+function decode(segment) {
+    try {
+        return decodeURIComponent(segment);
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Serve one module file (#1774): the project must be registered, the package must be a module of
+ * that project, and the file must sit inside the module's browser part's own directory. Anything else is a
+ * 404, never a fallback: a module URL is asked for by the dashboard's loader, not typed by a person.
+ * Served as `no-cache`, since a module is rebuilt in place under the same name.
+ */
+export async function serveModuleFile(req, res, pathname, projects = defaultProjectsProvider()) {
+    const notFound = () => void res.writeHead(404, { 'content-type': 'text/plain' }).end('no such module file');
+    if (req.method !== 'GET' && req.method !== 'HEAD')
+        return void res.writeHead(405, { allow: 'GET, HEAD' }).end();
+    const [projectSegment, packageSegment, ...rest] = pathname.slice(MODULES_PREFIX.length + 1).split('/');
+    const projectId = projectSegment !== undefined ? decode(projectSegment) : undefined;
+    const pkg = packageSegment !== undefined ? decode(packageSegment) : undefined;
+    const rel = rest.map(decode);
+    if (!projectId || !pkg || rel.length === 0 || rel.some(part => part === undefined))
+        return notFound();
+    const root = await projects.resolvePath(projectId);
+    const module = root ? await findProjectModule(root, pkg).catch(() => undefined) : undefined;
+    const file = module ? await moduleFile(module, rel.join('/')) : undefined;
+    const body = file ? await readFile(file).catch(() => undefined) : undefined;
+    if (!file || body === undefined)
+        return notFound();
+    res.writeHead(200, { 'content-type': contentTypeFor(file), 'cache-control': 'no-cache' });
+    res.end(req.method === 'HEAD' ? undefined : body);
+}
+//# sourceMappingURL=module-serve.js.map

package/dist/dashboard/module-serve.js.map

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

package/dist/dashboard/open-in-app.d.ts

@@ -0,0 +1,43 @@
+/** Which app to open the project in. */
+export type OpenTarget = 'files' | 'editor';
+/** A known editor: its launcher CLI plus a human label for the picker (#727). */
+export interface EditorInfo {
+    bin: string;
+    label: string;
+}
+/**
+ * The editors the picker can offer (#727), probed by their CLI launcher on PATH. Order is the
+ * display order. `$OPENAGENT_EDITOR` and a hand-typed value stay valid beyond this list; this is
+ * only what auto-detection looks for.
+ */
+export declare const KNOWN_EDITORS: EditorInfo[];
+/** Whether an editor launcher is installed (on PATH). A seam so detection is unit-testable. */
+export type EditorProbe = (bin: string) => Promise<boolean>;
+/** The installed subset of {@link KNOWN_EDITORS}, in display order (#727). */
+export declare function detectEditors(probe?: EditorProbe): Promise<EditorInfo[]>;
+/** The outcome of an open attempt. */
+export type OpenResult = {
+    ok: true;
+} | {
+    ok: false;
+    error: string;
+};
+/** Spawns a command, resolving once it launches (not on exit) and rejecting if it can't start. */
+export type SpawnRunner = (command: string, args: string[]) => Promise<void>;
+/** The OS command that reveals a path in the file manager. */
+export declare function fileManagerCommand(path: string, os?: NodeJS.Platform): {
+    command: string;
+    args: string[];
+};
+/** The command to open a path in an editor: `$OPENAGENT_EDITOR` when set, else the VS Code CLI. */
+export declare function editorCommand(path: string, editor?: string | undefined): {
+    command: string;
+    args: string[];
+};
+/**
+ * Open the project at `cwd` in the file manager or an editor. Failures are values, never throws.
+ * `editor` (#727) is the stored preference; when unset {@link editorCommand} falls back to
+ * `$OPENAGENT_EDITOR`, then `code`.
+ */
+export declare function openInApp(cwd: string, target: OpenTarget, agent?: SpawnRunner, editor?: string): Promise<OpenResult>;
+//# sourceMappingURL=open-in-app.d.ts.map

package/dist/dashboard/open-in-app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-in-app.d.ts","sourceRoot":"","sources":["../../src/dashboard/open-in-app.ts"],"names":[],"mappings":"AAQA,wCAAwC;AACxC,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,QAAQ,CAAA;AAE3C,iFAAiF;AACjF,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;CACd;AAED;;;;GAIG;AACH,eAAO,MAAM,aAAa,EAAE,UAAU,EAYrC,CAAA;AAED,+FAA+F;AAC/F,MAAM,MAAM,WAAW,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;AA0B3D,8EAA8E;AAC9E,wBAAsB,aAAa,CAAC,KAAK,GAAE,WAA+B,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAGjG;AAED,sCAAsC;AACtC,MAAM,MAAM,UAAU,GAAG;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAA;AAEpE,kGAAkG;AAClG,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;AAqB5E,8DAA8D;AAC9D,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAE,MAAM,CAAC,QAAqB,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAItH;AAED,mGAAmG;AACnG,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,qBAA+B,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAGtH;AAED;;;;GAIG;AACH,wBAAsB,SAAS,CAC7B,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,UAAU,EAClB,KAAK,GAAE,WAA+B,EACtC,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,UAAU,CAAC,CAWrB"}

package/dist/dashboard/open-in-app.js

@@ -0,0 +1,98 @@
+import { platform } from 'node:os';
+import { delimiter, join } from 'node:path';
+/**
+ * The editors the picker can offer (#727), probed by their CLI launcher on PATH. Order is the
+ * display order. `$OPENAGENT_EDITOR` and a hand-typed value stay valid beyond this list; this is
+ * only what auto-detection looks for.
+ */
+export const KNOWN_EDITORS = [
+    { bin: 'code', label: 'VS Code' },
+    { bin: 'code-insiders', label: 'VS Code Insiders' },
+    { bin: 'cursor', label: 'Cursor' },
+    { bin: 'windsurf', label: 'Windsurf' },
+    { bin: 'zed', label: 'Zed' },
+    { bin: 'subl', label: 'Sublime Text' },
+    { bin: 'webstorm', label: 'WebStorm' },
+    { bin: 'idea', label: 'IntelliJ IDEA' },
+    { bin: 'nvim', label: 'Neovim' },
+    { bin: 'vim', label: 'Vim' },
+    { bin: 'emacs', label: 'Emacs' },
+];
+/**
+ * An {@link EditorProbe} that looks each launcher up on the real PATH: an executable match in any
+ * PATH dir (trying PATHEXT suffixes on Windows). Pure lookup, nothing is spawned.
+ */
+function nodeEditorProbe(env = process.env, os = platform()) {
+    const dirs = (env.PATH ?? '').split(delimiter).filter(Boolean);
+    const exts = os === 'win32' ? (env.PATHEXT ?? '.EXE;.CMD;.BAT;.COM').split(';').filter(Boolean) : [''];
+    return async (bin) => {
+        const { access, constants } = await import('node:fs/promises');
+        const flag = os === 'win32' ? constants.F_OK : constants.X_OK;
+        for (const dir of dirs) {
+            for (const ext of exts) {
+                try {
+                    await access(join(dir, bin + ext), flag);
+                    return true;
+                }
+                catch {
+                    // not here; keep looking
+                }
+            }
+        }
+        return false;
+    };
+}
+/** The installed subset of {@link KNOWN_EDITORS}, in display order (#727). */
+export async function detectEditors(probe = nodeEditorProbe()) {
+    const hits = await Promise.all(KNOWN_EDITORS.map(async (e) => ((await probe(e.bin)) ? e : null)));
+    return hits.filter((e) => e !== null);
+}
+/**
+ * A {@link SpawnRunner} backed by `spawn`, detached. Resolves on the `spawn` event so a
+ * long-lived editor (or `explorer`, which exits non-zero even on success) does not block or
+ * error; rejects on the `error` event (e.g. ENOENT when the command is not on PATH).
+ */
+function nodeSpawnRunner() {
+    return (command, args) => new Promise((resolve, reject) => {
+        void import('node:child_process').then(({ spawn }) => {
+            const child = spawn(command, args, { stdio: 'ignore', detached: true });
+            child.on('error', reject);
+            child.on('spawn', () => {
+                child.unref();
+                resolve();
+            });
+        });
+    });
+}
+/** The OS command that reveals a path in the file manager. */
+export function fileManagerCommand(path, os = platform()) {
+    if (os === 'darwin')
+        return { command: 'open', args: [path] };
+    if (os === 'win32')
+        return { command: 'explorer', args: [path] };
+    return { command: 'xdg-open', args: [path] };
+}
+/** The command to open a path in an editor: `$OPENAGENT_EDITOR` when set, else the VS Code CLI. */
+export function editorCommand(path, editor = process.env.OPENAGENT_EDITOR) {
+    const bin = editor && editor.trim() ? editor.trim() : 'code';
+    return { command: bin, args: [path] };
+}
+/**
+ * Open the project at `cwd` in the file manager or an editor. Failures are values, never throws.
+ * `editor` (#727) is the stored preference; when unset {@link editorCommand} falls back to
+ * `$OPENAGENT_EDITOR`, then `code`.
+ */
+export async function openInApp(cwd, target, agent = nodeSpawnRunner(), editor) {
+    const { command, args } = target === 'editor' ? editorCommand(cwd, editor) : fileManagerCommand(cwd);
+    try {
+        await agent(command, args);
+        return { ok: true };
+    }
+    catch (err) {
+        if (err?.code === 'ENOENT') {
+            return { ok: false, error: `"${command}" was not found on PATH` };
+        }
+        return { ok: false, error: err instanceof Error ? err.message : 'failed to open' };
+    }
+}
+//# sourceMappingURL=open-in-app.js.map

package/dist/dashboard/open-in-app.js.map

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