@openagt/dashboard 0.8.0 → 0.10.0

package/dist/dashboard-rpc/reads.js

@@ -340,7 +340,7 @@ export async function onBridgeStatus() {
  * page. Revealing it here is not a new exposure: anyone who can load this dashboard can already
  * start runs on this machine, and on a non-loopback bind their browser is holding the same token
  * as a cookie. What it replaces is the alternative, which was telling people to open
- * `~/.the-framework.json` and copy a field out of it.
+ * `~/.openagent.json` and copy a field out of it.
  */
 export async function onBridgeToken() {
     const preferences = await readPreferences().catch(() => ({}));

package/dist/dashboard-rpc/skills.d.ts

@@ -0,0 +1,80 @@
+import { type Standing } from '@openagt/init';
+/**
+ * A project's skills, as the dashboard shows and changes them (#2023): the same list with ticks
+ * `npx @openagt/init` shows in a terminal, read and written through that package's own code, so
+ * the two cannot drift apart. A project has a skill when the skill's text is in its folder; the
+ * dashboard writes and deletes those files, and offers the one commit that holds them.
+ */
+/** One skill of the list, as it stands in the project. */
+export interface ProjectSkill {
+    name: string;
+    /** The one line the skill's text says of itself. */
+    description: string;
+    /** How the project's text stands against the one this dashboard carries; `absent` when the project does not hold the skill. */
+    standing: Standing;
+    /** Whether the skill is in the folder but not yet on the branch agents start from: an agent started from it does not have the skill. */
+    waiting: boolean;
+}
+export interface ProjectSkills {
+    /** How many skills the project has, of how many there are: the ones in its folder, and the basic ones every run gets. */
+    has: number;
+    of: number;
+    /** The list's groups; `ticked` says whether a group's skills are ticked in a project that has none yet. */
+    groups: {
+        title: string;
+        ticked: boolean;
+        skills: ProjectSkill[];
+    }[];
+    /** Whether the scheduler starts with the dashboard for this project, on this machine. */
+    scheduler: boolean;
+    /** The branch agents start from, by its name: the remote's default branch, else the branch the folder is on. Absent where there is none. */
+    startBranch?: string;
+    /** How many skill files stand written or deleted in the folder with no commit yet. */
+    uncommitted: number;
+    /** Whether the folder is a git repository: without one there is nothing to commit. */
+    git: boolean;
+    /** Whether the project has a remote: without one a commit on this machine is all agents need. */
+    remote: boolean;
+}
+/** The project's skills; `null` when the project is unknown here. */
+export declare function onProjectSkills(projectId: string): Promise<ProjectSkills | null>;
+/** What a change of skills answered: what was written and deleted, what was left as it is, and the scheduler when the change switched it. */
+export type ChangeSkillsResult = {
+    ok: true;
+    written: string[];
+    removed: string[];
+    left: {
+        path: string;
+        reason: string;
+    }[];
+    scheduler?: 'on' | 'off';
+    schedulerError?: string;
+} | {
+    ok: false;
+    error: string;
+};
+/**
+ * Write and delete skills in a project's folder, and switch its scheduler: what the "Add skills"
+ * screen saves. Only the names of the list are taken; anything else is refused whole. A scheduler
+ * switched on starts at once, by its own line, as it would have at this dashboard's opening.
+ * Nothing is committed here: `sendCommitSkills` is the person's next press.
+ */
+export declare function sendChangeSkills(projectId: string, change: {
+    write?: string[];
+    remove?: string[];
+    scheduler?: boolean;
+}): Promise<ChangeSkillsResult>;
+/**
+ * One commit of skill files that stand uncommitted in the project's folder, on the branch the
+ * folder is on: the files of the skills `only` names, after a change that wrote or deleted them,
+ * else every uncommitted skill file. Never a push.
+ */
+export declare function sendCommitSkills(projectId: string, only?: string[]): Promise<{
+    ok: true;
+    committed: boolean;
+    commit?: string;
+} | {
+    ok: false;
+    error: string;
+}>;
+//# sourceMappingURL=skills.d.ts.map

package/dist/dashboard-rpc/skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../src/dashboard-rpc/skills.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmI,KAAK,QAAQ,EAAE,MAAM,eAAe,CAAA;AAM9K;;;;;GAKG;AAEH,0DAA0D;AAC1D,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,oDAAoD;IACpD,WAAW,EAAE,MAAM,CAAA;IACnB,+HAA+H;IAC/H,QAAQ,EAAE,QAAQ,CAAA;IAClB,wIAAwI;IACxI,OAAO,EAAE,OAAO,CAAA;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,yHAAyH;IACzH,GAAG,EAAE,MAAM,CAAA;IACX,EAAE,EAAE,MAAM,CAAA;IACV,2GAA2G;IAC3G,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,YAAY,EAAE,CAAA;KAAE,EAAE,CAAA;IACpE,yFAAyF;IACzF,SAAS,EAAE,OAAO,CAAA;IAClB,4IAA4I;IAC5I,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,sFAAsF;IACtF,WAAW,EAAE,MAAM,CAAA;IACnB,sFAAsF;IACtF,GAAG,EAAE,OAAO,CAAA;IACZ,iGAAiG;IACjG,MAAM,EAAE,OAAO,CAAA;CAChB;AAED,qEAAqE;AACrE,wBAAsB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAoBtF;AAED,6IAA6I;AAC7I,MAAM,MAAM,kBAAkB,GAC1B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAAC,SAAS,CAAC,EAAE,IAAI,GAAG,KAAK,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/I;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAA;AAKhC;;;;;GAKG;AACH,wBAAsB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA4B3J;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,SAAS,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAMpK"}

package/dist/dashboard-rpc/skills.js

@@ -0,0 +1,84 @@
+import { applyChange, carriedSkills, commitSkills, GROUPS, isKnown, readProject, SCHEDULER, skillCount, SKILLS_IN_ALL, uncommittedSkills } from '@openagt/init';
+import { waitingSkills } from '../dashboard/start-branch.js';
+import { readProjectHooks, runProjectHooks } from '../project-hooks.js';
+import { providedDataChanged } from '../store/provided.js';
+import { resolveProjectPath } from './context.js';
+/** The project's skills; `null` when the project is unknown here. */
+export async function onProjectSkills(projectId) {
+    const cwd = await resolveProjectPath(projectId);
+    if (!cwd)
+        return null;
+    const [state, carried] = await Promise.all([readProject(cwd), carriedSkills()]);
+    const standing = new Map(state.skills.map(skill => [skill.name, skill.standing]));
+    const { start, waiting } = await waitingSkills(cwd, state.skills.filter(skill => skill.standing !== 'absent').map(skill => skill.name));
+    return {
+        has: skillCount(state),
+        of: SKILLS_IN_ALL,
+        groups: GROUPS.map(group => ({
+            title: group.title,
+            ticked: group.ticked,
+            skills: group.skills.map(name => ({ name, description: carried.get(name).description, standing: standing.get(name) ?? 'absent', waiting: waiting.has(name) })),
+        })),
+        scheduler: state.scheduler,
+        ...(start ? { startBranch: start.name } : {}),
+        uncommitted: state.git ? await uncommittedSkills(cwd) : 0,
+        git: state.git,
+        remote: state.remote,
+    };
+}
+/** A list of the list's own skill names, each once; nothing for anything else. */
+const names = (value) => (value === undefined ? [] : Array.isArray(value) && value.every(name => typeof name === 'string' && name !== SCHEDULER && isKnown(name)) ? [...new Set(value)] : undefined);
+/**
+ * Write and delete skills in a project's folder, and switch its scheduler: what the "Add skills"
+ * screen saves. Only the names of the list are taken; anything else is refused whole. A scheduler
+ * switched on starts at once, by its own line, as it would have at this dashboard's opening.
+ * Nothing is committed here: `sendCommitSkills` is the person's next press.
+ */
+export async function sendChangeSkills(projectId, change) {
+    const cwd = await resolveProjectPath(projectId);
+    if (!cwd)
+        return { ok: false, error: 'this project has no local path on this server' };
+    const asked = change && typeof change === 'object' && !Array.isArray(change) ? change : undefined;
+    const write = names(asked?.write);
+    const remove = names(asked?.remove);
+    if (!asked || !write || !remove || (asked.scheduler !== undefined && typeof asked.scheduler !== 'boolean'))
+        return { ok: false, error: 'not a list of skills' };
+    try {
+        const opened = (await readProjectHooks(cwd).catch(() => undefined))?.open ?? [];
+        const changed = await applyChange(cwd, { write, remove, ...(asked.scheduler !== undefined ? { scheduler: asked.scheduler } : {}) });
+        providedDataChanged(cwd);
+        const scheduler = changed.scheduler;
+        // The lines the change added run when the dashboard opens, and this dashboard is open: they run now, the way they would have.
+        if (scheduler && !('error' in scheduler) && scheduler.on && scheduler.changed) {
+            const added = ((await readProjectHooks(cwd).catch(() => undefined))?.open ?? []).filter(line => !opened.includes(line));
+            if (added.length > 0)
+                await runProjectHooks(cwd, 'open', { only: added, log: console.log });
+        }
+        return {
+            ok: true,
+            written: changed.written,
+            removed: changed.removed,
+            left: changed.left,
+            ...(scheduler && !('error' in scheduler) && scheduler.changed ? { scheduler: scheduler.on ? 'on' : 'off' } : {}),
+            ...(scheduler && 'error' in scheduler ? { schedulerError: scheduler.error } : {}),
+        };
+    }
+    catch (err) {
+        return { ok: false, error: err instanceof Error ? err.message : String(err) };
+    }
+}
+/**
+ * One commit of skill files that stand uncommitted in the project's folder, on the branch the
+ * folder is on: the files of the skills `only` names, after a change that wrote or deleted them,
+ * else every uncommitted skill file. Never a push.
+ */
+export async function sendCommitSkills(projectId, only) {
+    const cwd = await resolveProjectPath(projectId);
+    if (!cwd)
+        return { ok: false, error: 'this project has no local path on this server' };
+    const named = names(only);
+    if (!named)
+        return { ok: false, error: 'not a list of skills' };
+    return named.length > 0 ? commitSkills(cwd, named) : commitSkills(cwd);
+}
+//# sourceMappingURL=skills.js.map

package/dist/dashboard-rpc/skills.js.map

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

package/dist/dashboard-rpc/test-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"test-context.d.ts","sourceRoot":"","sources":["../../src/dashboard-rpc/test-context.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAA;AACjE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAE9D;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,GAAE,OAAO,CAAC,gBAAgB,CAAM,GAAG,gBAAgB,CAa3F;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,GAAE,OAAO,CAAC,gBAAgB,CAAM,GAAG,gBAAgB,CAG3F;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,GAAE,OAAO,CAAC,gBAAgB,CAAM,GAAG,IAAI,CAE7E"}
+{"version":3,"file":"test-context.d.ts","sourceRoot":"","sources":["../../src/dashboard-rpc/test-context.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAA;AACjE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAE9D;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,GAAE,OAAO,CAAC,gBAAgB,CAAM,GAAG,gBAAgB,CAc3F;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,GAAE,OAAO,CAAC,gBAAgB,CAAM,GAAG,gBAAgB,CAG3F;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,GAAE,OAAO,CAAC,gBAAgB,CAAM,GAAG,IAAI,CAE7E"}

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

@@ -12,12 +12,13 @@ export function testDashboardContext(over = {}) {
     return {
         startAgent: () => ({ ok: false, error: 'not wired in this test' }),
         addProject: () => ({ ok: false, error: 'not wired in this test' }),
+        removeProject: () => ({ ok: false, error: 'not wired in this test' }),
         eventsSource: () => undefined,
         remote: { target: () => undefined, list: () => [] },
         preferences: registryPreferencesStore(),
         quota: defaultQuotaSource(),
         models: { read: async () => ({ 'claude-code': { models: [] }, codex: { models: [] } }) },
-        projectErrors: () => ({ errors: [], localOnly: false }),
+        projectErrors: () => ({ errors: [] }),
         bridgeBrowser: { status: async () => ({ state: 'off' }), start: async () => { }, stop: async () => { }, act: async () => { } },
         ...over,
     };
@@ -27,8 +28,8 @@ export function testDashboardContext(over = {}) {
  * test asserting one route still stands up the same server the product does.
  */
 export function testDashboardOptions(over = {}) {
-    const { startAgent, addProject, ...rest } = testDashboardContext();
-    return { port: 0, onStart: startAgent, onAddProject: addProject, ...rest, ...over };
+    const { startAgent, addProject, removeProject, ...rest } = testDashboardContext();
+    return { port: 0, onStart: startAgent, onAddProject: addProject, onRemoveProject: removeProject, ...rest, ...over };
 }
 /**
  * Wire the dashboard's capabilities for a test that calls an RPC directly.

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

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

package/dist/event-stream.d.ts

@@ -3,7 +3,7 @@
  * iterators, and replay history from an offset (tail=N replay).
  *
  * Absorbed from `@gemstack/ai-autopilot` when that package was deleted (A2). Its element type
- * used to default to the supervisor's event; the only caller here passes `FrameworkEvent`, so
+ * used to default to the supervisor's event; the only caller here passes `OpenAgentEvent`, so
  * the parameter is now required.
  */
 export declare class EventStream<E> {

package/dist/event-stream.js

@@ -3,7 +3,7 @@
  * iterators, and replay history from an offset (tail=N replay).
  *
  * Absorbed from `@gemstack/ai-autopilot` when that package was deleted (A2). Its element type
- * used to default to the supervisor's event; the only caller here passes `FrameworkEvent`, so
+ * used to default to the supervisor's event; the only caller here passes `OpenAgentEvent`, so
  * the parameter is now required.
  */
 export class EventStream {

package/dist/events.d.ts

@@ -12,7 +12,7 @@ export interface ChoiceOption {
 }
 /**
  * An interactive choice the agent pauses on until a pick arrives (#304). Emitted as
- * a `choice` {@link FrameworkEvent}; the dashboard renders it in a panel and posts
+ * a `choice` {@link OpenAgentEvent}; the dashboard renders it in a panel and posts
  * the pick back. The recommended option is what an agent nobody is watching takes.
  */
 export interface ChoiceRequest {
@@ -39,7 +39,7 @@ export interface ChoiceRequest {
 }
 /** Who resolved a {@link ChoiceRequest}: a human, or a headless auto-accept. */
 export type ChoiceBy = 'user' | 'auto';
-/** What a {@link import('./agent.js').RunFrameworkOptions.requestChoice} handler resolves with. */
+/** What a {@link import('./agent.js').RunOpenAgentOptions.requestChoice} handler resolves with. */
 export interface ChoicePick {
     /** The picked option id, or (for a {@link ChoiceRequest.multi} select) the selected subset of ids. */
     picked: string | readonly string[];
@@ -49,21 +49,21 @@ export interface ChoicePick {
 /** Normalize a {@link ChoicePick} (single id or subset) to a list of picked ids. */
 export declare function pickedIds(picked: string | readonly string[]): string[];
 /**
- * The single type a run's timeline is read as. The framework emits none of these itself (#1774):
+ * The single type a run's timeline is read as. OpenAgent emits none of these itself (#1774):
  * a run's tool writes the run's diary, and every line of it is read as one of these so the
  * dashboard and the terminal render one timeline whatever wrote it.
  *
  * What a diary yields today is the agent's own progress (`driver`), the session id it reports
  * (`session-update`), the question a turn ended on (`choice`), what it cost (`usage`) and how it
  * ended (`end`). **The rest of this union is a reading vocabulary for runs recorded before the
- * daemon stopped running agents** — the framework's own narration back then. They are kept
+ * daemon stopped running agents** — OpenAgent's own narration back then. They are kept
  * because that history is still on the data branch and still has to render.
  *
  * Every event read from a diary line that says when it was written carries that time as `at`
  * (ISO 8601), so the timeline shows the same times live, after a reload, and once the run has
  * ended. Lines written before the diary kept times have none, and show none.
  */
-export type FrameworkEvent = {
+export type OpenAgentEvent = {
     at?: string;
 } & (
 /**
@@ -105,8 +105,8 @@ export type FrameworkEvent = {
  * A live screen something the agent ran is showing: a page on this machine's loopback, shown in
  * the chat where the line is, while it is the newest open screen at that address and the run
  * has not ended. `label` names what it showed then. The same address with `ended` says the
- * screen has gone. A diary line a command appends itself (agent-driver's `DIARY_ENV`); the
- * framework knows nothing of what the page is.
+ * screen has gone. A diary line a command appends itself (agent-driver's `DIARY_ENV`);
+ * OpenAgent knows nothing of what the page is.
  */
  | {
     kind: 'screen';
@@ -114,7 +114,7 @@ export type FrameworkEvent = {
     label: string;
     ended?: true;
 }
-/** A framework-level log line. */
+/** An OpenAgent-level log line. */
  | {
     kind: 'log';
     message: string;

package/dist/events.d.ts.map

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

package/dist/index.d.ts

@@ -13,7 +13,7 @@
  * ends where its consumers end, so a name nothing renders cannot quietly live on in it.
  */
 export type { AgentError, SessionInfo } from './agent-view.js';
-export type { ChoiceRequest, FrameworkEvent } from './events.js';
+export type { ChoiceRequest, OpenAgentEvent } from './events.js';
 export type { QuotaBoundary } from './quota-boundary.js';
 export type { CustomPreset, Preferences } from './registry.js';
 export type { PublishPick } from './publish-levels.js';
@@ -23,6 +23,7 @@ export type { Activity } from './dashboard/activity.js';
 export type { AgentHandoff } from './dashboard/agent-handoff.js';
 export type { GitHostHome } from './store/git-host.js';
 export type { RepositoryOffer, CreateRepositoryResult } from './store/repository.js';
+export type { BranchReach as RecordsReach } from '@openagt/agent-data';
 export type { BridgeEvent } from './dashboard/bridge-endpoints.js';
 export type { BridgeOption, BridgeQuestion } from './dashboard/bridge-question.js';
 export type { BridgeAnswer } from './dashboard/bridge-store.js';
@@ -37,5 +38,5 @@ export type { ProjectError, ProjectErrorCode } from './project-errors.js';
 export type { ProjectQueue } from './dashboard/queue.js';
 export type { QuotaView } from './dashboard/quota.js';
 export type { Ticket } from './store/tickets.js';
-export type { AgentWorktree, OnboardingSuggestion } from './dashboard/types.js';
+export type { AgentWorktree, CleanupReport, OnboardingSuggestion } from './dashboard/types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAC9D,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAChE,YAAY,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACxD,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAC9D,YAAY,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AACtD,YAAY,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AAC9D,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AACpE,YAAY,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AACvD,YAAY,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAA;AAChE,YAAY,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AACtD,YAAY,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAA;AACpF,YAAY,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAA;AAClE,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAA;AAClF,YAAY,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAC/D,YAAY,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AAC7D,YAAY,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AACvD,YAAY,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAA;AAC1D,YAAY,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAA;AAChE,YAAY,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAA;AACjE,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AACjF,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAC7E,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AACzE,YAAY,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AACxD,YAAY,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA;AACrD,YAAY,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAChD,YAAY,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAC9D,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAChE,YAAY,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACxD,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAC9D,YAAY,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AACtD,YAAY,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AAC9D,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AACpE,YAAY,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AACvD,YAAY,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAA;AAChE,YAAY,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AACtD,YAAY,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAA;AACpF,YAAY,EAAE,WAAW,IAAI,YAAY,EAAE,MAAM,qBAAqB,CAAA;AACtE,YAAY,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAA;AAClE,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAA;AAClF,YAAY,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAC/D,YAAY,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AAC7D,YAAY,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AACvD,YAAY,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAA;AAC1D,YAAY,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAA;AAChE,YAAY,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAA;AACjE,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AACjF,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAC7E,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AACzE,YAAY,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AACxD,YAAY,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA;AACrD,YAAY,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAChD,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA"}

package/dist/install.d.ts

@@ -1,10 +1,12 @@
 import { type GitRunner } from '@openagt/agent-data';
 import { type StoreFs } from './store/index.js';
 /**
- * Install/activate a repo for The Framework (#391): create the `.the-framework/` marker and its
- * ignore file, committing pre-existing dirty changes first so the install commit is clean. Pure
- * core over the same {@link GitRunner} + {@link StoreFs} seams as project.ts.
+ * Install/activate a repo for OpenAgent (#391): create the `.openagent/` marker and its
+ * ignore file. Nothing is committed on a branch that has a commit. Pure core over the same
+ * {@link GitRunner} + {@link StoreFs} seams as project.ts.
  */
+/** The message of the empty commit an install gives a repository that has none. */
+export declare const FIRST_COMMIT_MESSAGE = "[OpenAgent] first commit";
 /** The outcome of {@link installProject}. Failures are values, never throws. */
 export type InstallResult = {
     ok: true;
@@ -20,10 +22,10 @@ export interface InstallDeps {
     fs?: StoreFs;
 }
 /**
- * Activate the repo at `cwd`: create `.the-framework/` with
- * its ignore file and layout marker (#1575), and commit the install. A repo whose ignore file is
- * already there is a no-op (`alreadyActivated`) — the ignore file is the activation marker.
- * Forgiving: any git/fs failure surfaces as `{ ok: false, error }`.
+ * Activate the repo at `cwd`: create `.openagent/` with its ignore file, which hides the whole
+ * directory from git, itself included, so the person's repository shows no change. A repo whose
+ * ignore file is already there is a no-op (`alreadyActivated`) — the ignore file is the
+ * activation marker. Forgiving: any git/fs failure surfaces as `{ ok: false, error }`.
  */
 export declare function installProject(cwd: string, deps?: InstallDeps): Promise<InstallResult>;
 //# sourceMappingURL=install.d.ts.map

package/dist/install.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../src/install.ts"],"names":[],"mappings":"AACA,OAAO,EAAiB,KAAK,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAGnE,OAAO,EAAe,KAAK,OAAO,EAAE,MAAM,kBAAkB,CAAA;AAG5D;;;;GAIG;AAEH,gFAAgF;AAChF,MAAM,MAAM,aAAa,GACrB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAAC,WAAW,CAAC,EAAE,OAAO,CAAA;CAAE,GAC/D;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAA;AAEhC,mDAAmD;AACnD,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,EAAE,SAAS,CAAA;IACf,EAAE,CAAC,EAAE,OAAO,CAAA;CACb;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,WAAgB,GAAG,OAAO,CAAC,aAAa,CAAC,CA2BhG"}
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../src/install.ts"],"names":[],"mappings":"AACA,OAAO,EAAiB,KAAK,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAGnE,OAAO,EAAe,KAAK,OAAO,EAAE,MAAM,kBAAkB,CAAA;AAG5D;;;;GAIG;AAEH,mFAAmF;AACnF,eAAO,MAAM,oBAAoB,6BAA6B,CAAA;AAK9D,gFAAgF;AAChF,MAAM,MAAM,aAAa,GACrB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAAC,WAAW,CAAC,EAAE,OAAO,CAAA;CAAE,GAC/D;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAA;AAEhC,mDAAmD;AACnD,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,EAAE,SAAS,CAAA;IACf,EAAE,CAAC,EAAE,OAAO,CAAA;CACb;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,WAAgB,GAAG,OAAO,CAAC,aAAa,CAAC,CAgChG"}

package/dist/install.js

@@ -1,14 +1,23 @@
 import { join } from 'node:path';
 import { nodeGitRunner } from '@openagt/agent-data';
-import { THE_FRAMEWORK_DIR } from './framework-dir.js';
-import { frameworkGitignore, gitignorePath } from './framework-gitignore.js';
+import { OPENAGENT_DIR } from './openagent-dir.js';
+import { openagentGitignore, gitignorePath } from './openagent-gitignore.js';
 import { nodeStoreFs } from './store/index.js';
 import { errorMessage } from './error-message.js';
 /**
- * Activate the repo at `cwd`: create `.the-framework/` with
- * its ignore file and layout marker (#1575), and commit the install. A repo whose ignore file is
- * already there is a no-op (`alreadyActivated`) — the ignore file is the activation marker.
- * Forgiving: any git/fs failure surfaces as `{ ok: false, error }`.
+ * Install/activate a repo for OpenAgent (#391): create the `.openagent/` marker and its
+ * ignore file. Nothing is committed on a branch that has a commit. Pure core over the same
+ * {@link GitRunner} + {@link StoreFs} seams as project.ts.
+ */
+/** The message of the empty commit an install gives a repository that has none. */
+export const FIRST_COMMIT_MESSAGE = '[OpenAgent] first commit';
+/** Git's tree with no file in it. */
+const EMPTY_TREE = '4b825dc642cb6eb9a060e54bf8d69288fbee4904';
+/**
+ * Activate the repo at `cwd`: create `.openagent/` with its ignore file, which hides the whole
+ * directory from git, itself included, so the person's repository shows no change. A repo whose
+ * ignore file is already there is a no-op (`alreadyActivated`) — the ignore file is the
+ * activation marker. Forgiving: any git/fs failure surfaces as `{ ok: false, error }`.
  */
 export async function installProject(cwd, deps = {}) {
     const git = deps.git ?? nodeGitRunner();
@@ -16,21 +25,26 @@ export async function installProject(cwd, deps = {}) {
     if (await fs.exists(gitignorePath(cwd)))
         return { ok: true, alreadyActivated: true };
     try {
-        // Auto-initialize a repo when the folder isn't one yet: The Framework treats
+        // Auto-initialize a repo when the folder isn't one yet: OpenAgent treats
         // git as the source of truth, so `git init` it for the user rather than erroring.
         const insideRepo = await git(['rev-parse', '--is-inside-work-tree'], cwd)
             .then(out => out.trim() === 'true')
             .catch(() => false);
         if (!insideRepo)
             await git(['init'], cwd);
-        await fs.mkdir(join(cwd, THE_FRAMEWORK_DIR));
-        // Keep what lives under `.the-framework/` (a run's live files, the hooks file) out of git
+        // A repository with no commit cannot give an agent's branch a start. Its first commit is
+        // made empty, straight from the empty tree: the index is not read, so a file the person has
+        // staged stays staged and none of theirs is committed. Before the marker below, so a commit
+        // that fails leaves a folder the next add tries again.
+        const hasCommit = await git(['rev-parse', '--verify', '--quiet', 'HEAD'], cwd).then(() => true, () => false);
+        if (!hasCommit) {
+            const first = (await git(['commit-tree', EMPTY_TREE, '-m', FIRST_COMMIT_MESSAGE], cwd)).trim();
+            await git(['update-ref', 'HEAD', first], cwd);
+        }
+        await fs.mkdir(join(cwd, OPENAGENT_DIR));
+        // Keep what lives under `.openagent/` (a run's live files, the hooks file) out of git
         // (#313). The early return above established the file is absent.
-        await fs.write(gitignorePath(cwd), frameworkGitignore());
-        // Only The Framework's own directory (#1638): whatever the user has uncommitted stays theirs,
-        // uncommitted. Nothing is ever swept into a commit on their behalf.
-        await git(['add', THE_FRAMEWORK_DIR], cwd);
-        await git(['commit', '-m', '[The Framework] install The Framework'], cwd);
+        await fs.write(gitignorePath(cwd), openagentGitignore());
         return insideRepo ? { ok: true } : { ok: true, initialized: true };
     }
     catch (err) {

package/dist/install.js.map

@@ -1 +1 @@
-{"version":3,"file":"install.js","sourceRoot":"","sources":["../src/install.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,aAAa,EAAkB,MAAM,qBAAqB,CAAA;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AACtD,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AAC5E,OAAO,EAAE,WAAW,EAAgB,MAAM,kBAAkB,CAAA;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAmBjD;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,GAAW,EAAE,IAAI,GAAgB,EAAE;IACtE,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,aAAa,EAAE,CAAA;IACvC,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,IAAI,WAAW,EAAE,CAAA;IAEnC,IAAI,MAAM,EAAE,CAAC,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;QAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,CAAA;IAEpF,IAAI,CAAC;QACH,6EAA6E;QAC7E,kFAAkF;QAClF,MAAM,UAAU,GAAG,MAAM,GAAG,CAAC,CAAC,WAAW,EAAE,uBAAuB,CAAC,EAAE,GAAG,CAAC;aACtE,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,MAAM,CAAC;aAClC,KAAK,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAA;QACrB,IAAI,CAAC,UAAU;YAAE,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,GAAG,CAAC,CAAA;QAEzC,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,iBAAiB,CAAC,CAAC,CAAA;QAC5C,0FAA0F;QAC1F,iEAAiE;QACjE,MAAM,EAAE,CAAC,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,kBAAkB,EAAE,CAAC,CAAA;QAExD,8FAA8F;QAC9F,oEAAoE;QACpE,MAAM,GAAG,CAAC,CAAC,KAAK,EAAE,iBAAiB,CAAC,EAAE,GAAG,CAAC,CAAA;QAC1C,MAAM,GAAG,CAAC,CAAC,QAAQ,EAAE,IAAI,EAAE,uCAAuC,CAAC,EAAE,GAAG,CAAC,CAAA;QACzE,OAAO,UAAU,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,CAAA;IACpE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,CAAC,GAAG,CAAC,EAAE,CAAA;IAChD,CAAC;AACH,CAAC"}
+{"version":3,"file":"install.js","sourceRoot":"","sources":["../src/install.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,aAAa,EAAkB,MAAM,qBAAqB,CAAA;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAClD,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AAC5E,OAAO,EAAE,WAAW,EAAgB,MAAM,kBAAkB,CAAA;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEjD;;;;GAIG;AAEH,mFAAmF;AACnF,MAAM,CAAC,MAAM,oBAAoB,GAAG,0BAA0B,CAAA;AAE9D,qCAAqC;AACrC,MAAM,UAAU,GAAG,0CAA0C,CAAA;AAa7D;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,GAAW,EAAE,IAAI,GAAgB,EAAE;IACtE,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,aAAa,EAAE,CAAA;IACvC,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,IAAI,WAAW,EAAE,CAAA;IAEnC,IAAI,MAAM,EAAE,CAAC,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;QAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,CAAA;IAEpF,IAAI,CAAC;QACH,yEAAyE;QACzE,kFAAkF;QAClF,MAAM,UAAU,GAAG,MAAM,GAAG,CAAC,CAAC,WAAW,EAAE,uBAAuB,CAAC,EAAE,GAAG,CAAC;aACtE,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,MAAM,CAAC;aAClC,KAAK,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAA;QACrB,IAAI,CAAC,UAAU;YAAE,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,GAAG,CAAC,CAAA;QAEzC,yFAAyF;QACzF,4FAA4F;QAC5F,4FAA4F;QAC5F,uDAAuD;QACvD,MAAM,SAAS,GAAG,MAAM,GAAG,CAAC,CAAC,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,CAAA;QAC5G,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,KAAK,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,aAAa,EAAE,UAAU,EAAE,IAAI,EAAE,oBAAoB,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;YAC9F,MAAM,GAAG,CAAC,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,GAAG,CAAC,CAAA;QAC/C,CAAC;QAED,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC,CAAA;QACxC,sFAAsF;QACtF,iEAAiE;QACjE,MAAM,EAAE,CAAC,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,kBAAkB,EAAE,CAAC,CAAA;QACxD,OAAO,UAAU,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,CAAA;IACpE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,CAAC,GAAG,CAAC,EAAE,CAAA;IAChD,CAAC;AACH,CAAC"}

package/dist/module-server.d.ts

@@ -2,7 +2,7 @@
 //
 // A module's server part is the file its package exports as `./server`. The daemon imports it once,
 // in its own process, and calls one of its reads when the module's browser part asks for it
-// (`host.read(name, input)` there). The server part imports nothing from the framework at run time:
+// (`host.read(name, input)` there). The server part imports nothing from OpenAgent at run time:
 // these are types only, and its default export is a plain object that satisfies `ModuleServer`.
 
 /** What the core knows about one run: facts, never a verdict about what the run's files are. */

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

@@ -0,0 +1,7 @@
+import type { ComponentProps } from 'react';
+import { Switch as SwitchPrimitive } from '@base-ui-components/react/switch';
+type SwitchProps = Omit<ComponentProps<typeof SwitchPrimitive.Root>, 'disabled'> & {
+    disabled?: boolean | undefined;
+};
+export declare function Switch({ className, disabled, ...props }: SwitchProps): import("react").JSX.Element;
+export {};

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

@@ -2,7 +2,8 @@
  * Whether a first segment names a page a module adds (#1774) rather than a project: a lowercase
  * letter, then lowercase letters and digits. Never a project's id, which always carries a
  * `-<hash>` suffix, so the router reserves no module's word: whichever module claims the segment
- * gets it, and the shell says "no such page" when none does.
+ * gets it, and the shell says "no such page" when none does, or when the picked project
+ * has no package that adds it.
  */
 export declare function isPageSegment(segment: string): boolean;
 /** What the dashboard is looking at, as carried by the URL. */

package/dist/module-types/dashboard/lib/use-modules.d.ts

@@ -37,7 +37,7 @@ export interface MountedUsageLimit extends ModuleUsageLimit {
 /** What the installed modules bring, once loaded: their pages, their cards and their link actions. */
 export interface MountedModules {
     pages: MountedPage[];
-    /** The Overview's cards, in the order they are drawn: by `order`, then by package name. */
+    /** Every package's cards, in the order the Overview draws the ones it draws: by `order`, then by package name. */
     cards: MountedCard[];
     linkActions: MountedLinkAction[];
     /** The side-rail tabs, in package order. */
@@ -64,9 +64,10 @@ export declare function byMountOrder(a: {
  * modules claim going to the first, the cards (#1818), sorted by their order then their package, the link actions, the side-rail tabs, the run slots, the Settings sections (sorted as the cards are) and the usage bar's stop line (the first module's that declares one),
  * every one of them, each carrying the package it came from and the projects that have it. `loaded` is false until the module list has
  * been read and every module in it imported, so the shell can tell "no such page" from "not
- * loaded yet".
+ * loaded yet". A change of `reloadKey` reads the list again at once; what is mounted stays until
+ * it answers.
  */
-export declare function useModules(): MountedModules;
+export declare function useModules(reloadKey?: number): MountedModules;
 /**
  * The mounted modules, for any component in the shell (#1774): the shell reads them once with
  * {@link useModules} and provides them here, so a page deep in the tree finds the link actions

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

@@ -84,15 +84,15 @@ export interface LinkAction {
      */
     run(host: ModuleHost, projectId: string, links: ModuleLink[]): Promise<LinkActionResult>;
 }
-/** What a module card is rendered with: the projects that have its package. A card has no URL and no sub-path. */
+/** What a module card is rendered with: the projects that have its package, never none: the card is not drawn then. With a project picked in the dashboard, that project alone. A card has no URL and no sub-path. */
 export interface ModuleCardProps {
-    /** The registered projects whose dependencies include the module's package, in the registry's order. */
+    /** The registered projects that have the module's package, in the registry's order; with a project picked in the dashboard, that project alone. Never empty. */
     projects: ModuleProject[];
 }
 /**
  * A card a module adds to the Overview (#1818): the package's own summary of its data across the
- * projects that have it, drawn beside the dashboard's own cards. A project none of whose packages
- * declares a card sees none.
+ * projects that have it, drawn beside the dashboard's own cards. Drawn only when one of the
+ * projects the Overview shows has the package: with a project picked, only when that project has it.
  */
 export interface ModuleCard {
     /** Which card this is, for the shell's key and its error line; never shown as a title. */
@@ -276,7 +276,7 @@ export interface ModuleHost {
     read(projectId: string, name: string, input?: Record<string, unknown>): Promise<ModuleReadResult>;
     /** Open one agent's page in the dashboard: its live feed while it runs, its record after. */
     openAgent(projectId: string, agentId: string): void;
-    /** Open a page a module adds (this one's or another's), at a sub-path: `openPage('tickets', [projectId, file])`. */
+    /** Open a page a module adds (this one's or another's), at a sub-path: `openPage('tickets', [projectId, file])`. With a project picked in the dashboard, a page that project's packages do not add shows "No such page". */
     openPage(segment: string, path?: string[]): void;
     /**
      * Start a run in one project with this prompt, with the person's own picks (which tool, which
@@ -314,6 +314,7 @@ export { Badge } from '../components/ui/badge.js';
 export { Card, CardHeader, CardTitle, CardContent } from '../components/ui/card.js';
 export { Skeleton } from '../components/ui/skeleton.js';
 export { Checkbox } from '../components/ui/checkbox.js';
+export { Switch } from '../components/ui/switch.js';
 export { Input } from '../components/ui/input.js';
 export { Popover, PopoverContent, PopoverTrigger } from '../components/ui/popover.js';
 export { RangeSlider } from '../components/ui/slider.js';

package/dist/module-types/src/agent-view.d.ts

@@ -1,4 +1,4 @@
-import type { FrameworkEvent } from './events.js';
+import type { OpenAgentEvent } from './events.js';
 /** One error of a run: one the agent reported through an `error` block (#1500), or one its tool wrote in the diary. */
 export interface AgentError {
     /** What is wrong, in one line. */
@@ -16,7 +16,7 @@ export interface AgentError {
  * A fold over the log rather than state of its own: an error is an event that happened, so the
  * list only ever grows, and reopening a finished agent shows exactly what it showed while it ran.
  */
-export declare function agentErrors(events: readonly FrameworkEvent[]): AgentError[];
+export declare function agentErrors(events: readonly OpenAgentEvent[]): AgentError[];
 /** The wrapped agent session (#431): its id and a deep link, when one is known. */
 export interface SessionInfo {
     sessionId?: string;
@@ -35,4 +35,4 @@ export interface SessionInfo {
  * event, then the id and any deep link from the latest `session-update`. Null before the
  * session opens. The link is what the old dashboard surfaced as "open session".
  */
-export declare function sessionInfo(events: readonly FrameworkEvent[]): SessionInfo | null;
+export declare function sessionInfo(events: readonly OpenAgentEvent[]): SessionInfo | null;