@openagt/dashboard 0.9.0 → 0.10.0

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/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/module/index.d.ts

@@ -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/built-in.d.ts

@@ -1,37 +1,59 @@
 import type { CleanupReport } from './dashboard/types.js';
 import { type ProjectPackage, type ProvidedCommand, type ProvidedCommandLookup } from '@openagt/agent-data';
 /**
- * The packages OpenAgent ships for every project, by name: dependencies of OpenAgent
- * itself, resolved from its own install, so a project installs nothing for them and an empty
- * folder starts an agent and shows it. Each comes through the same contract as a project's own
- * package: a module by its `./dashboard` export, a provider of a kind of data and the writer of
- * its hook lines by its `openagent` key. This list is the one place OpenAgent names a
- * package, and a project's own copy of any of them wins.
+ * The packages OpenAgent brings, by name: dependencies of OpenAgent itself, resolved from its
+ * own install, so a project installs nothing for them and an empty folder starts an agent and
+ * shows it. Each comes through the same contract as any package: a module by its `./dashboard`
+ * export, a provider of a kind of data and the writer of its hook lines by its `openagent` key.
+ * These two lists are the one place OpenAgent names a package. One of these names among a
+ * project's own dependencies is not read: OpenAgent's copy, and the rules below for which
+ * project has it, are the only ones.
  */
+/** The packages every project has: an agent cannot start, be shown or be put on a git host without them. */
 export declare const BUILT_IN_PACKAGES: readonly string[];
-/** The built-in packages, resolved from OpenAgent's own install, once; one that is not installed is skipped. */
+/**
+ * The packages a project has once it picked them (#2023). A skill's package is the project's
+ * when the project holds the skill's text where the coding agents read it
+ * (`.claude/skills/<name>/SKILL.md`, `.agents/skills/<name>/SKILL.md`): the rule the launcher
+ * already lists a project's commands by, so deleting the skill's folder takes its page away. A
+ * tool with no skill text (the scheduler) is the project's when one of the project's hook lines
+ * runs it.
+ */
+export declare const PICKED_PACKAGES: readonly string[];
+/** Every name OpenAgent brings itself. */
+export declare const OWN_PACKAGE_NAMES: readonly string[];
+/** Every package OpenAgent brings, resolved from its own install, once; one that is not installed is skipped. */
 export declare function builtInPackages(): Promise<ProjectPackage[]>;
-/** The directories the built-in packages' commands sit in: what a hook line's PATH gains after the project's own installed tools. */
+/**
+ * The packages OpenAgent brings to the project at `root`: the ones every project has, and
+ * each picked one the project has by its rule (see {@link PICKED_PACKAGES}). Read off the
+ * project's files each time, so a skill written or deleted a moment ago counts at once.
+ */
+export declare function builtInPackagesOf(root: string): Promise<ProjectPackage[]>;
+/** The project's own installed packages, less the names OpenAgent brings itself. */
+export declare function ownPackages(root: string): Promise<ProjectPackage[]>;
+/** The directories the commands of OpenAgent's packages sit in: what a hook line's PATH gains after the project's own installed tools. */
 export declare function builtInBinDirs(): Promise<string[]>;
-/** What provides `kind` in the project at `root`: one of the project's own packages, else a built-in one. */
+/** What provides `kind` in the project at `root`: a package the project installed for it, else one OpenAgent brings to this project. */
 export declare function lookupProvided(root: string, kind: string): Promise<ProvidedCommandLookup>;
 /** {@link lookupProvided}'s command, for a caller that only needs to run it. */
 export declare function providedCommand(root: string, kind: string): Promise<ProvidedCommand | undefined>;
-/** Whether `command` comes from a built-in package the project has no copy of: one the project did not choose. */
-export declare function isBuiltIn(root: string, command: ProvidedCommand): Promise<boolean>;
+/** Whether `command` comes from a package OpenAgent brings: one the project did not install. */
+export declare function isBuiltIn(command: ProvidedCommand): boolean;
 /**
  * Have every package that writes hook lines write its own into the project at `root`: a package
  * declares `"openagent": { "hooks": "<command>" }`, and `<command> init`, run in the project,
  * writes its lines into the project's hooks file, keeping every line already there. The project's
- * own packages are asked, then the built-in ones the project has no copy of. Answers one line per
- * package that could not write, in words.
+ * own packages are asked, then the ones OpenAgent brings to it. Answers one line per package
+ * that could not write, in words.
  */
 export declare function writeHookLines(root: string): Promise<string[]>;
 /**
  * Have every package that declares a clean-up remove what it left in the project at `root`: a
  * package declares `"openagent": { "cleanup": "<command>" }`, and `<command> cleanup`, run in the
- * project, answers `{ ok: true, removed, kept }`. The project's own packages are asked, then the
- * built-in ones the project has no copy of, each whatever the one before answered. A package
- * that refuses, fails or answers something else is one line in `failed`, in words.
+ * project, answers `{ ok: true, removed, kept }`. The project's own packages are asked, then
+ * every package OpenAgent brings, also one this project no longer has (what it left stays its
+ * own to remove), each whatever the one before answered. A package that refuses, fails or answers
+ * something else is one line in `failed`, in words.
  */
 export declare function runCleanups(root: string): Promise<CleanupReport>;

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

@@ -0,0 +1,31 @@
+/**
+ * The branch agents start from in the project at `cwd`: origin's default branch as this clone has
+ * it, else the branch the folder is on (a project with no remote starts an agent from its last
+ * local commit). `ref` is what git is asked, `name` what a person reads. None where the folder is
+ * on no branch, or is no repository.
+ */
+export declare function startBranch(cwd: string): Promise<{
+    ref: string;
+    name: string;
+} | undefined>;
+/** A skill that is in the folder and not on the branch agents start from. */
+export interface Waiting {
+    /** The branch it has yet to reach, by name. */
+    branch: string;
+    /** Whether the branch the folder is on has it: an agent started from that branch does. */
+    here: boolean;
+}
+/**
+ * Which of the skills `names`, all in the project's folder, are waiting to reach the branch agents
+ * start from. A skill is said to be waiting only when that is known: an agent's checkout fetches
+ * the remote before it starts, so before a skill is called waiting against a remote branch, this
+ * clone's copy of that branch is fetched too (at most once a minute per project), or a pull
+ * request merged a moment ago would keep its skill waiting here.
+ */
+export declare function waitingSkills(cwd: string, names: readonly string[]): Promise<{
+    start?: {
+        ref: string;
+        name: string;
+    };
+    waiting: Map<string, Waiting>;
+}>;

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

@@ -8,6 +8,7 @@ export { onQuota } from './quota.js';
 export { onModels } from './models.js';
 export { checkDevices, type DeviceCheck } from './devices.js';
 export { onModules, runModuleCommand, readModule, type DashboardModule, type ModuleCommandResult, type ModuleReadResult } from './modules.js';
+export { onProjectSkills, sendChangeSkills, sendCommitSkills, type ProjectSkills, type ProjectSkill, type ChangeSkillsResult } from './skills.js';
 import { streamAgentEvents } from './events.js';
 /** One RPC: called with whatever the browser sent, answering with whatever JSON.stringify keeps. */
 export type RpcHandler = (...args: never[]) => unknown;

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

@@ -0,0 +1,79 @@
+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;
+}>;

package/dist/module-types/src/openagent-dir.d.ts

@@ -2,9 +2,7 @@
  * The directory, under a project root, that holds OpenAgent's own files.
  *
  * Its own module so every reader and writer of the directory (the hooks file, the project's saved
- * prompts, the activation's `.gitignore`, a run's card, diary and inbox) spells it the same way.
- *
- * Nothing of the product's rides on a branch of its own any more: the agent archives are the
- * `logs` skill's runs, on the shared `agent-data` branch that `@openagt/agent-data` names (#1769).
+ * prompts, a run's card, diary and inbox) spells it the same way. The name itself is
+ * `@openagt/agent-data`'s, which also makes the directory when a folder becomes a project.
  */
-export declare const OPENAGENT_DIR = ".openagent";
+export { OPENAGENT_DIR } from '@openagt/agent-data/names';

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

@@ -13,6 +13,10 @@ export interface ProjectCommand {
     name: string;
     /** The `description` of the skill's front matter, when it has one. */
     description?: string;
+    /** The branch the skill has yet to reach, by name, when its text is in the folder but not on the branch agents start from: an agent started from that branch does not have the command. */
+    waiting?: string;
+    /** With `waiting`: whether the branch the folder is on has the skill, so an agent started from that branch does have the command. */
+    here?: true;
 }
 /**
  * The project's commands, by name: the skills whose front matter says

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

@@ -2,8 +2,8 @@
  * A project's hooks (#1774): the shell lines a project's own `.openagent/hooks.yml` names to
  * run when the dashboard opens and when it closes, the two lines that start a run and continue
  * one, and the line that says whether a run can start here at all. The daemon calls no tool by
- * name: it runs whatever the file says, in the project, with the project's installed tools and
- * then the built-in packages' on the PATH, so a line reaches its tool with nothing fetched from npm. Per
+ * name: it runs whatever the file says, in the project, with the commands of the packages
+ * OpenAgent brings and then the project's installed tools on the PATH, so a line reaches its tool with nothing fetched from npm. Per
  * user, since `.openagent/` is ignored: a hook is this machine's, and a teammate's pull
  * changes nothing.
  *
@@ -49,6 +49,8 @@ export interface RunHooksOptions {
     timeoutMs?: number;
     /** The environment the lines run with; default the daemon's own. */
     env?: NodeJS.ProcessEnv;
+    /** The lines to run, of the ones the file holds; every line when absent. */
+    only?: readonly string[];
 }
 /**
  * Run a project's `open` or `close` lines, in order, each through `sh -c` with the project's
@@ -122,8 +124,9 @@ export declare function runCheckHook(cwd: string, input: {
     driver?: string;
 }, opts?: Omit<RunHooksOptions, 'log'>): Promise<CheckHookResult>;
 /**
- * The environment a line runs with: the PATH led by the project's installed tools, then the
- * built-in packages' own commands, so a tool named in a line is the project's copy when it
- * installed one and the dashboard's otherwise, and never a package fetched by name.
+ * The environment a line runs with: the PATH led by the commands of the packages OpenAgent
+ * brings, then the project's installed tools. So a tool of OpenAgent's named in a line is always
+ * OpenAgent's copy, the one its pages and its data go through too, any other tool is the
+ * project's, and nothing is a package fetched by name.
  */
 export declare function hookEnv(cwd: string, env: NodeJS.ProcessEnv): Promise<NodeJS.ProcessEnv>;

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

@@ -2,11 +2,12 @@ import { type PackageCommandResult } from '@openagt/agent-data';
 /**
  * A package that adds to the dashboard (#1774): its browser part, named by its
  * `exports["./dashboard"]`, and optionally its server part, named by `exports["./server"]`.
- * OpenAgent names no package: any dependency of the project that exports `./dashboard` is a
- * module, whoever wrote it, and OpenAgent's own built-in modules come the same way.
+ * Any dependency of the project that exports `./dashboard` is a module, whoever wrote it, and the
+ * packages OpenAgent brings itself come the same way, for the projects that have them
+ * (`built-in.ts`).
  */
 export interface ProjectModule {
-    /** The package's name, as the project's package.json lists it. */
+    /** The package's name. */
     package: string;
     /** The package's version, when its package.json says one. */
     version?: string;
@@ -21,8 +22,9 @@ export interface ProjectModule {
 }
 /**
  * The modules a project has: each of its dependencies whose package.json exports `./dashboard` to
- * a file that exists inside the package, plus the modules among OpenAgent's built-in packages (`built-in.ts`). A project that
- * depends on a built-in module's package itself gets its own copy. Sorted by name.
+ * a file that exists inside the package, plus the modules among the packages OpenAgent brings to
+ * this project (`built-in.ts`): a skill's page where the project holds the skill's text. Sorted
+ * by name.
  */
 export declare function readProjectModules(root: string): Promise<ProjectModule[]>;
 /** The one module of this project that `name` names, or undefined. */
@@ -38,7 +40,7 @@ export type ModuleCommandResult = PackageCommandResult;
 /**
  * Run one of a module package's own commands in the project, with the given arguments, and read
  * its standard output as JSON. This is how a module reads its data: the same command an agent runs
- * (`npx logs`), so the module and the agent see the same thing and OpenAgent knows neither.
+ * (`npx @openagt/skill-logs@0.1`), so the module and the agent see the same thing and OpenAgent knows neither.
  *
  * `command` picks one of the package's commands; a package with exactly one needs none. The
  * command runs with Node (a package's commands are Node scripts), in the project root, never

package/dist/module-types/src/store/branches.d.ts

@@ -149,7 +149,7 @@ export declare function parseCheckouts(output: unknown): Checkout[];
 /** The states read back from a provider's `show`: the objects with a branch and the three verdicts, lists cleaned; anything else is no state. */
 export declare function parseBranchStates(output: unknown): BranchState[];
 /**
- * The production {@link BranchesReader}: the project's provider, looked up by its package.json,
+ * The production {@link BranchesReader}: the project's provider, looked up among the packages the project has (`built-in.ts`),
  * one source per project kept while the same command provides — so the cache holds across the
  * many reads of one poll, and a project that installs, swaps or drops its provider is read the new
  * way within {@link CACHE_MS}. `changed(root)` forgets that project's reads, so the next read runs

package/dist/module-types/src/store/git-host.d.ts

@@ -101,7 +101,7 @@ export type GitHostReader = GitHostFor & {
 /** The rows read back from a provider's `requests`: the objects with the facts a request needs; anything else is no request. */
 export declare function parseRequests(output: unknown): GitHostRequest[];
 /**
- * The production {@link GitHostReader}: the project's provider, looked up by its package.json, one
+ * The production {@link GitHostReader}: the project's provider, looked up among the packages the project has (`built-in.ts`), one
  * source per project kept while the same command provides, so a project that installs, swaps or
  * drops its git host is read the new way within {@link CACHE_MS}. `changed(root)` forgets the
  * project, so the next ask looks its provider up again.

package/dist/module-types/src/store/queue.d.ts

@@ -32,7 +32,7 @@ export type QueueReader = QueueFor & {
 /** Entries read back from a provider's output: the non-empty strings of an array, trimmed; anything else is no entries. */
 export declare function parseQueueEntries(output: unknown): string[];
 /**
- * The production {@link QueueReader}: the project's provider, looked up by its package.json, one
+ * The production {@link QueueReader}: the project's provider, looked up among the packages the project has (`built-in.ts`), one
  * source per project kept while the same command provides — so the cache holds across the many
  * reads of one poll, and a project that installs, swaps or drops its provider is read the new way
  * within {@link CACHE_MS}. `changed(root)` forgets that project's read, so the next read runs the

package/dist/module-types/src/store/runs.d.ts

@@ -94,7 +94,7 @@ export declare function isRunId(id: string): boolean;
  */
 export declare function parseRunCard(input: unknown): RunCard | undefined;
 /**
- * The production {@link RunsFor}: the project's provider, looked up by its package.json, one
+ * The production {@link RunsFor}: the project's provider, looked up among the packages the project has (`built-in.ts`), one
  * source per project kept while the same command provides — so the cache holds across the many
  * reads of one poll, and a project that installs, swaps or drops its provider is read the new way
  * within {@link CACHE_MS}. `changed(root)` forgets that project's reads, so the next read runs the

package/dist/module-types/src/store/tickets.d.ts

@@ -59,7 +59,7 @@ export type TicketsReader = TicketsFor & {
 /** The rows read back from a provider's output: the objects with the five plain facts, everything else as printed; anything else is no ticket. */
 export declare function parseTickets(output: unknown): Ticket[];
 /**
- * The production {@link TicketsReader}: the project's provider, looked up by its package.json, one
+ * The production {@link TicketsReader}: the project's provider, looked up among the packages the project has (`built-in.ts`), one
  * source per project kept while the same command provides — so the cache holds across the many
  * reads of one poll, and a project that installs, swaps or drops its provider is read the new way
  * within {@link CACHE_MS}. `changed(root)` forgets that project's read, so the next read runs the

package/dist/openagent-dir.d.ts

@@ -2,10 +2,8 @@
  * The directory, under a project root, that holds OpenAgent's own files.
  *
  * Its own module so every reader and writer of the directory (the hooks file, the project's saved
- * prompts, the activation's `.gitignore`, a run's card, diary and inbox) spells it the same way.
- *
- * Nothing of the product's rides on a branch of its own any more: the agent archives are the
- * `logs` skill's runs, on the shared `agent-data` branch that `@openagt/agent-data` names (#1769).
+ * prompts, a run's card, diary and inbox) spells it the same way. The name itself is
+ * `@openagt/agent-data`'s, which also makes the directory when a folder becomes a project.
  */
-export declare const OPENAGENT_DIR = ".openagent";
+export { OPENAGENT_DIR } from '@openagt/agent-data/names';
 //# sourceMappingURL=openagent-dir.d.ts.map

package/dist/openagent-dir.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"openagent-dir.d.ts","sourceRoot":"","sources":["../src/openagent-dir.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,eAAO,MAAM,aAAa,eAAe,CAAA"}
+{"version":3,"file":"openagent-dir.d.ts","sourceRoot":"","sources":["../src/openagent-dir.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA"}

package/dist/openagent-dir.js

@@ -2,10 +2,8 @@
  * The directory, under a project root, that holds OpenAgent's own files.
  *
  * Its own module so every reader and writer of the directory (the hooks file, the project's saved
- * prompts, the activation's `.gitignore`, a run's card, diary and inbox) spells it the same way.
- *
- * Nothing of the product's rides on a branch of its own any more: the agent archives are the
- * `logs` skill's runs, on the shared `agent-data` branch that `@openagt/agent-data` names (#1769).
+ * prompts, a run's card, diary and inbox) spells it the same way. The name itself is
+ * `@openagt/agent-data`'s, which also makes the directory when a folder becomes a project.
  */
-export const OPENAGENT_DIR = '.openagent';
+export { OPENAGENT_DIR } from '@openagt/agent-data/names';
 //# sourceMappingURL=openagent-dir.js.map

package/dist/openagent-dir.js.map

@@ -1 +1 @@
-{"version":3,"file":"openagent-dir.js","sourceRoot":"","sources":["../src/openagent-dir.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,YAAY,CAAA"}
+{"version":3,"file":"openagent-dir.js","sourceRoot":"","sources":["../src/openagent-dir.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA"}

package/dist/project-commands.d.ts

@@ -13,6 +13,10 @@ export interface ProjectCommand {
     name: string;
     /** The `description` of the skill's front matter, when it has one. */
     description?: string;
+    /** The branch the skill has yet to reach, by name, when its text is in the folder but not on the branch agents start from: an agent started from that branch does not have the command. */
+    waiting?: string;
+    /** With `waiting`: whether the branch the folder is on has the skill, so an agent started from that branch does have the command. */
+    here?: true;
 }
 /**
  * The project's commands, by name: the skills whose front matter says

package/dist/project-commands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"project-commands.d.ts","sourceRoot":"","sources":["../src/project-commands.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AAEH,yGAAyG;AACzG,eAAO,MAAM,WAAW,YAAI,gBAAgB,EAAE,gBAAgB,CAAU,CAAA;AAExE,0CAA0C;AAC1C,MAAM,WAAW,cAAc;IAC7B,8DAA8D;IAC9D,IAAI,EAAE,MAAM,CAAA;IACZ,sEAAsE;IACtE,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAqBhF"}
+{"version":3,"file":"project-commands.d.ts","sourceRoot":"","sources":["../src/project-commands.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AAEH,yGAAyG;AACzG,eAAO,MAAM,WAAW,YAAI,gBAAgB,EAAE,gBAAgB,CAAU,CAAA;AAExE,0CAA0C;AAC1C,MAAM,WAAW,cAAc;IAC7B,8DAA8D;IAC9D,IAAI,EAAE,MAAM,CAAA;IACZ,sEAAsE;IACtE,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,2LAA2L;IAC3L,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,qIAAqI;IACrI,IAAI,CAAC,EAAE,IAAI,CAAA;CACZ;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAqBhF"}