@openagt/dashboard 0.0.0-stage → 0.9.0

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

@@ -0,0 +1,89 @@
+import { type AgentStatus, type BranchesFor, type RunsFor } from './store/index.js';
+/** A retained worktree and the agent that left it behind (#752). */
+export interface WorktreeRow {
+    /** The agent id. */
+    agentId: string;
+    /** The branch the agent's work landed on, when its meta recorded one (#799). */
+    branch?: string;
+    /** How the agent that left this checkout ended, or `running` while it is still going. */
+    status?: AgentStatus;
+    /** Size on disk in bytes, absent for a live agent (its tree is still changing) or when unreadable. */
+    sizeBytes?: number;
+    /** True while the agent owning this checkout is still going: it is in use, not retained. */
+    live: boolean;
+}
+/** The outcome of {@link removeProjectWorktree}. */
+export type RemoveResult = {
+    ok: true;
+    /**
+     * Branches that went with the checkout: the branch it was on, when that held nothing of
+     * its own (#1650); the run-id branch the agent branched away from, when everything on
+     * it is in the branch that stays (#1657). Absent when nothing went.
+     */
+    branchesDeleted?: string[];
+} | {
+    ok: false;
+    error: string;
+};
+/**
+ * The worktrees a project still has on disk (#752), newest first — the same view the dashboard's
+ * retained-worktrees list is built from, through the same store reads, so the CLI is a second
+ * surface rather than a second behaviour. The checkouts are what the project's branches provider
+ * lists (#1774); a project with no provider has none.
+ *
+ * A live agent's checkout is included and flagged rather than hidden: "what is this directory and
+ * why can I not remove it" is exactly the question the list has to answer.
+ */
+export declare function listProjectWorktrees(cwd: string, opts?: {
+    sizes?: boolean;
+}, branches?: BranchesFor): Promise<WorktreeRow[]>;
+/**
+ * Remove one retained worktree (#752/#737/E5): the one implementation behind every surface that
+ * removes one: the dashboard's Remove button (#982). The run's own tool reclaims a finished run's
+ * checkout by the same rule; this is for the checkouts that rule kept.
+ *
+ * **One rule: only what is committed may go**: the rule is the branches provider's, whose
+ * `remove` takes a clean checkout and leaves its branch on this machine, pushing nothing
+ * (#1774); its refusal is answered in its own words.
+ *
+ * Refuses while the agent is still going — an agent's checkout is where its agent is working, and Stop
+ * is how you end an agent, not pulling the floor out from under it.
+ */
+export declare function removeProjectWorktree(cwd: string, agentId: string, branches?: BranchesFor): Promise<RemoveResult>;
+/** The outcome of {@link deleteProjectAgent}. */
+export type DeleteAgentResult = {
+    ok: true;
+} | {
+    ok: false;
+    error: string;
+};
+/** Where {@link deleteProjectAgent} reads: the project's providers by default. */
+export interface DeleteAgentOptions {
+    /** Where the project's finished runs are read and removed; the project's runs provider by default. */
+    runs?: RunsFor;
+    /** Where the project's checkouts are read and removed; the project's branches provider by default. */
+    branches?: BranchesFor;
+}
+/**
+ * Delete a session (#1032): take it out of the dashboard, records and all.
+ *
+ * This is the sibling of {@link removeProjectWorktree}, and the difference is the whole point.
+ * Remove-worktree reclaims the checkout on disk and keeps the session — its row, its replayable
+ * log — because the run is recorded on the data branch. Delete removes that record too: the card
+ * (`<id>.json`, what the rail lists) and the diary (`<id>.jsonl`, what replays), so the row is
+ * gone for good. It is the one destructive-of-history action, which is
+ * why the surfaces that call it confirm first. The run is on the data branch, so its deletion is
+ * itself a committed, pushed change.
+ *
+ * What it deliberately leaves is git's, not the dashboard's: the branch `agent-<id>`
+ * (or the name the agent gave it) and its commits. Deleting a branch that may carry merged work
+ * or an open PR is not a thing a
+ * dashboard action should do silently, so the branch stays and delete means "remove from the
+ * dashboard", not "erase every trace".
+ *
+ * Refuses while the agent is still going — Stop is how an agent ends. Any uncommitted work in the
+ * worktree is discarded with it, which is the intent here (the session is being thrown away),
+ * unlike remove-worktree, which refuses a checkout holding uncommitted work: the branches
+ * provider's `remove --discard` (#1774).
+ */
+export declare function deleteProjectAgent(cwd: string, agentId: string, opts?: DeleteAgentOptions): Promise<DeleteAgentResult>;

package/dist/module.css

@@ -0,0 +1,50 @@
+/* The dashboard's theme as Tailwind sees it (#1774): the dark variant, the fonts, and the utilities
+   (`bg-card`, `text-muted-foreground`, …) that read the page's own tokens. The dashboard imports
+   it, and so does a module's stylesheet, so a module's classes read the tokens the page defines in
+   tailwind.css — its colours follow the theme and the theme toggle without a copy of either. */
+
+/* The theme is the `.dark` class LayoutDefault toggles, not the OS preference. Without this,
+   Tailwind v4 compiles `dark:` to `@media (prefers-color-scheme: dark)`, so the `dark:` utilities
+   disagreed with the tokens: picking Dark on a light OS applied the dark tokens but left
+   `dark:text-*-400` unapplied, and picking Light on a dark OS applied them when it should not. */
+@custom-variant dark (&:where(.dark, .dark *));
+
+/* The page is squarer than the old UI, so the radius tightens to ~2px to match. */
+@theme {
+  --radius: 0.125rem;
+  /* The landing page's typeface (#1118), loaded in pages/+Head.tsx. Overriding these two theme
+     keys retargets Tailwind's default body font and every `font-mono` to IBM Plex. */
+  --font-sans: 'IBM Plex Sans', ui-sans-serif, system-ui, sans-serif;
+  --font-mono: 'IBM Plex Mono', ui-monospace, SFMono-Regular, Menlo, monospace;
+}
+
+@theme inline {
+  --color-background: var(--background);
+  --color-foreground: var(--foreground);
+  --color-card: var(--card);
+  --color-card-foreground: var(--card-foreground);
+  --color-muted: var(--muted);
+  --color-muted-foreground: var(--muted-foreground);
+  --color-border: var(--border);
+  --color-primary: var(--primary);
+  --color-primary-foreground: var(--primary-foreground);
+  --color-accent: var(--accent);
+  --color-accent-foreground: var(--accent-foreground);
+  --color-success: var(--success);
+  --color-warning: var(--warning);
+  --color-danger: var(--danger);
+  --color-info: var(--info);
+
+  /* The shadcn sidebar reads its own `--sidebar-*` family so a sidebar can be themed apart from
+     the page. We keep it in step with the rest of the palette (the rail is the app's own surface,
+     not a contrasting slab): background canvas, accent for the hover/active fill, the shared border
+     and the primary ring. */
+  --color-sidebar: var(--background);
+  --color-sidebar-foreground: var(--foreground);
+  --color-sidebar-primary: var(--primary);
+  --color-sidebar-primary-foreground: var(--primary-foreground);
+  --color-sidebar-accent: var(--accent);
+  --color-sidebar-accent-foreground: var(--accent-foreground);
+  --color-sidebar-border: var(--border);
+  --color-sidebar-ring: var(--primary);
+}

package/dist/node-fs.d.ts

@@ -0,0 +1,33 @@
+/**
+ * The one `node:fs/promises` adapter. Every `node*Fs()` factory in the package
+ * returns this under its own narrow type: the store may append, the registry may
+ * not, and those interfaces stay separate because they are the consumers'
+ * contracts. Only the implementation was worth sharing, and it was written out
+ * four times before this.
+ *
+ * Every import is dynamic, which is the whole point of the convention: a module
+ * that reads files keeps a `node:fs` edge out of its static import graph, so it
+ * can be reached from browser-safe code as long as the read itself never runs
+ * there. `client.test.ts` enforces the graph half.
+ */
+export interface NodeFs {
+    /** Rejects when the file is absent. */
+    read(path: string): Promise<string>;
+    write(path: string, contents: string): Promise<void>;
+    append(path: string, contents: string): Promise<void>;
+    /** True when `path` exists AND is a file. Any stat error reads as `false`. */
+    exists(path: string): Promise<boolean>;
+    /** True when `path` exists AND is a directory. Any stat error reads as `false`. */
+    isDirectory(path: string): Promise<boolean>;
+    /** Recursive. */
+    mkdir(path: string): Promise<void>;
+    /** List a directory's entries (names only). Missing dir yields `[]`. */
+    readdir(path: string): Promise<string[]>;
+    /** Replace `to` with `from`. Atomic within one filesystem, which is the point of having it. */
+    rename(from: string, to: string): Promise<void>;
+    /** Set a file's permission bits. Rejects when the path is absent, or the fs cannot express them. */
+    chmod(path: string, mode: number): Promise<void>;
+}
+/** The `node:fs/promises` implementation of {@link NodeFs}. */
+export declare function nodeFs(): NodeFs;
+//# sourceMappingURL=node-fs.d.ts.map

package/dist/node-fs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-fs.d.ts","sourceRoot":"","sources":["../src/node-fs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,MAAM;IACrB,uCAAuC;IACvC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IACnC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACpD,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACrD,8EAA8E;IAC9E,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IACtC,mFAAmF;IACnF,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAC3C,iBAAiB;IACjB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAClC,wEAAwE;IACxE,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;IACxC,+FAA+F;IAC/F,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC/C,oGAAoG;IACpG,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACjD;AAED,+DAA+D;AAC/D,wBAAgB,MAAM,IAAI,MAAM,CAmD/B"}

package/dist/node-fs.js

@@ -0,0 +1,57 @@
+/** The `node:fs/promises` implementation of {@link NodeFs}. */
+export function nodeFs() {
+    return {
+        async read(path) {
+            const { readFile } = await import('node:fs/promises');
+            return readFile(path, 'utf8');
+        },
+        async write(path, contents) {
+            const { writeFile } = await import('node:fs/promises');
+            await writeFile(path, contents, 'utf8');
+        },
+        async append(path, contents) {
+            const { appendFile } = await import('node:fs/promises');
+            await appendFile(path, contents, 'utf8');
+        },
+        async exists(path) {
+            const { stat } = await import('node:fs/promises');
+            try {
+                return (await stat(path)).isFile();
+            }
+            catch {
+                return false;
+            }
+        },
+        async isDirectory(path) {
+            const { stat } = await import('node:fs/promises');
+            try {
+                return (await stat(path)).isDirectory();
+            }
+            catch {
+                return false;
+            }
+        },
+        async mkdir(path) {
+            const { mkdir } = await import('node:fs/promises');
+            await mkdir(path, { recursive: true });
+        },
+        async readdir(path) {
+            const { readdir } = await import('node:fs/promises');
+            try {
+                return await readdir(path);
+            }
+            catch {
+                return [];
+            }
+        },
+        async rename(from, to) {
+            const { rename } = await import('node:fs/promises');
+            await rename(from, to);
+        },
+        async chmod(path, mode) {
+            const { chmod } = await import('node:fs/promises');
+            await chmod(path, mode);
+        },
+    };
+}
+//# sourceMappingURL=node-fs.js.map

package/dist/node-fs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-fs.js","sourceRoot":"","sources":["../src/node-fs.ts"],"names":[],"mappings":"AA+BA,+DAA+D;AAC/D,MAAM,UAAU,MAAM;IACpB,OAAO;QACL,KAAK,CAAC,IAAI,CAAC,IAAI;YACb,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAA;YACrD,OAAO,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;QAC/B,CAAC;QACD,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ;YACxB,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAA;YACtD,MAAM,SAAS,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAA;QACzC,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ;YACzB,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAA;YACvD,MAAM,UAAU,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAA;QAC1C,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,IAAI;YACf,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAA;YACjD,IAAI,CAAC;gBACH,OAAO,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,CAAA;YACpC,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,KAAK,CAAA;YACd,CAAC;QACH,CAAC;QACD,KAAK,CAAC,WAAW,CAAC,IAAI;YACpB,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAA;YACjD,IAAI,CAAC;gBACH,OAAO,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,EAAE,CAAA;YACzC,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,KAAK,CAAA;YACd,CAAC;QACH,CAAC;QACD,KAAK,CAAC,KAAK,CAAC,IAAI;YACd,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAA;YAClD,MAAM,KAAK,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;QACxC,CAAC;QACD,KAAK,CAAC,OAAO,CAAC,IAAI;YAChB,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAA;YACpD,IAAI,CAAC;gBACH,OAAO,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;YAC5B,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,EAAE,CAAA;YACX,CAAC;QACH,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE;YACnB,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAA;YACnD,MAAM,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,CAAA;QACxB,CAAC;QACD,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI;YACpB,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAA;YAClD,MAAM,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;QACzB,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/open-choices.d.ts

@@ -0,0 +1,15 @@
+import type { ChoiceRequest, OpenAgentEvent } from './events.js';
+/**
+ * Every question a run still waits on, in the order asked, read off the run's events. One rule
+ * for every surface that offers an answer (the run page, the open-questions list, the write
+ * that delivers the answer), so none offers what another would refuse.
+ *
+ * A `choice` event opens a question; asked again under the same id, the later one replaces it.
+ * It closes when the agent goes on (any later event of the agent's own: the answer, or the
+ * person's text, began a new turn), when a `choice-resolved` names it, and when the run ends
+ * for good. An end that says `waiting` closes nothing: the run ended ON the question, its
+ * checkout kept, and the answer resumes it. A run that died holding a question ends otherwise,
+ * and its question goes with it (#1359): nobody would read the pick.
+ */
+export declare function pendingChoices(events: readonly OpenAgentEvent[]): ChoiceRequest[];
+//# sourceMappingURL=open-choices.d.ts.map

package/dist/open-choices.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-choices.d.ts","sourceRoot":"","sources":["../src/open-choices.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAKhE;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,SAAS,cAAc,EAAE,GAAG,aAAa,EAAE,CAajF"}

package/dist/open-choices.js

@@ -0,0 +1,31 @@
+/**
+ * Every question a run still waits on, in the order asked, read off the run's events. One rule
+ * for every surface that offers an answer (the run page, the open-questions list, the write
+ * that delivers the answer), so none offers what another would refuse.
+ *
+ * A `choice` event opens a question; asked again under the same id, the later one replaces it.
+ * It closes when the agent goes on (any later event of the agent's own: the answer, or the
+ * person's text, began a new turn), when a `choice-resolved` names it, and when the run ends
+ * for good. An end that says `waiting` closes nothing: the run ended ON the question, its
+ * checkout kept, and the answer resumes it. A run that died holding a question ends otherwise,
+ * and its question goes with it (#1359): nobody would read the pick.
+ */
+export function pendingChoices(events) {
+    const open = new Map();
+    for (const event of events) {
+        if (event.kind === 'choice-resolved')
+            open.delete(event.id);
+        else if (event.kind === 'driver')
+            open.clear();
+        else if (event.kind === 'end') {
+            if (event.waiting !== true)
+                open.clear();
+        }
+        else if (event.kind === 'choice') {
+            const { kind: _kind, ...request } = event;
+            open.set(event.id, request);
+        }
+    }
+    return [...open.values()];
+}
+//# sourceMappingURL=open-choices.js.map

package/dist/open-choices.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-choices.js","sourceRoot":"","sources":["../src/open-choices.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,cAAc,CAAC,MAAiC;IAC9D,MAAM,IAAI,GAAG,IAAI,GAAG,EAAyB,CAAA;IAC7C,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,KAAK,CAAC,IAAI,KAAK,iBAAiB;YAAE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;aACtD,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ;YAAE,IAAI,CAAC,KAAK,EAAE,CAAA;aACzC,IAAI,KAAK,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;YAC9B,IAAI,KAAK,CAAC,OAAO,KAAK,IAAI;gBAAE,IAAI,CAAC,KAAK,EAAE,CAAA;QAC1C,CAAC;aAAM,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACnC,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,GAAG,KAAoB,CAAA;YACxD,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,OAAO,CAAC,CAAA;QAC7B,CAAC;IACH,CAAC;IACD,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,CAAA;AAC3B,CAAC"}

package/dist/openagent-dir.d.ts

@@ -0,0 +1,11 @@
+/**
+ * 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).
+ */
+export declare const OPENAGENT_DIR = ".openagent";
+//# sourceMappingURL=openagent-dir.d.ts.map

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

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

package/dist/openagent-dir.js

@@ -0,0 +1,11 @@
+/**
+ * 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).
+ */
+export const OPENAGENT_DIR = '.openagent';
+//# sourceMappingURL=openagent-dir.js.map

package/dist/openagent-dir.js.map

@@ -0,0 +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"}

package/dist/openagent-gitignore.d.ts

@@ -0,0 +1,12 @@
+/**
+ * The `.openagent/.gitignore` (#313): one file, one content, written at install.
+ *
+ * Everything under `.openagent/` is this machine's or transient: a run's live files, the
+ * hooks file. The lasting records (the runs, the `logs` skill's) live on the data branch
+ * (#1582/#1769), so nothing is tracked, this file included: git shows no trace of the directory.
+ */
+/** The `.gitignore` path under `cwd`'s `.openagent/`. */
+export declare function gitignorePath(cwd: string): string;
+/** The whole file: everything under `.openagent/` stays out of git, the file itself too (#1582). */
+export declare function openagentGitignore(): string;
+//# sourceMappingURL=openagent-gitignore.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"openagent-gitignore.d.ts","sourceRoot":"","sources":["../src/openagent-gitignore.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AAEH,yDAAyD;AACzD,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,oGAAoG;AACpG,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C"}

package/dist/openagent-gitignore.js

@@ -0,0 +1,19 @@
+import { join } from 'node:path';
+import { DATA_BRANCH } from '@openagt/agent-data/names';
+import { OPENAGENT_DIR } from './openagent-dir.js';
+/**
+ * The `.openagent/.gitignore` (#313): one file, one content, written at install.
+ *
+ * Everything under `.openagent/` is this machine's or transient: a run's live files, the
+ * hooks file. The lasting records (the runs, the `logs` skill's) live on the data branch
+ * (#1582/#1769), so nothing is tracked, this file included: git shows no trace of the directory.
+ */
+/** The `.gitignore` path under `cwd`'s `.openagent/`. */
+export function gitignorePath(cwd) {
+    return join(cwd, OPENAGENT_DIR, '.gitignore');
+}
+/** The whole file: everything under `.openagent/` stays out of git, the file itself too (#1582). */
+export function openagentGitignore() {
+    return `# OpenAgent: agent state is transient; the lasting records live on the ${DATA_BRANCH} branch.\n*\n`;
+}
+//# sourceMappingURL=openagent-gitignore.js.map

package/dist/openagent-gitignore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openagent-gitignore.js","sourceRoot":"","sources":["../src/openagent-gitignore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAA;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAElD;;;;;;GAMG;AAEH,yDAAyD;AACzD,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,OAAO,IAAI,CAAC,GAAG,EAAE,aAAa,EAAE,YAAY,CAAC,CAAA;AAC/C,CAAC;AAED,oGAAoG;AACpG,MAAM,UAAU,kBAAkB;IAChC,OAAO,0EAA0E,WAAW,eAAe,CAAA;AAC7G,CAAC"}

package/dist/pick-directory.d.ts

@@ -0,0 +1,30 @@
+/**
+ * The system folder picker behind the dashboard's "Add project" (#1150): the daemon opens the
+ * OS's own choose-a-folder dialog and hands the picked absolute path back, because a browser page
+ * cannot learn the absolute path of anything the user picks in it.
+ */
+/** The outcome of asking the OS for a folder: a path, a dismissed dialog (`path: null`), or why the dialog could not be asked. */
+export type PickDirectoryResult = {
+    ok: true;
+    path: string | null;
+} | {
+    ok: false;
+    error: string;
+};
+/** What a dialog command left behind when it exited. */
+export type DialogRun = {
+    code: number;
+    stdout: string;
+    stderr: string;
+};
+/** Injectable seam so tests never open a real dialog. */
+export type DialogRunner = (command: string, args: string[]) => Promise<DialogRun>;
+/**
+ * Open the OS folder picker and wait for the user's choice.
+ *
+ * Dismissing the dialog is a normal outcome (`path: null`), not an error. A Linux daemon with no
+ * desktop session to draw on, a Linux machine with neither dialog helper installed, and a platform
+ * with no dialog wired up each answer with that reason instead of trying.
+ */
+export declare function pickDirectory(platform?: NodeJS.Platform, run?: DialogRunner, env?: NodeJS.ProcessEnv): Promise<PickDirectoryResult>;
+//# sourceMappingURL=pick-directory.d.ts.map

package/dist/pick-directory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pick-directory.d.ts","sourceRoot":"","sources":["../src/pick-directory.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AAEH,kIAAkI;AAClI,MAAM,MAAM,mBAAmB,GAC3B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GACjC;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAA;AAEhC,wDAAwD;AACxD,MAAM,MAAM,SAAS,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAA;AAExE,yDAAyD;AACzD,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,SAAS,CAAC,CAAA;AA2ElF;;;;;;GAMG;AACH,wBAAsB,aAAa,CACjC,QAAQ,GAAE,MAAM,CAAC,QAA2B,EAC5C,GAAG,GAAE,YAA+B,EACpC,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,OAAO,CAAC,mBAAmB,CAAC,CAW9B"}

package/dist/pick-directory.js

@@ -0,0 +1,102 @@
+import { execFile } from 'node:child_process';
+/** The exit code standing for "this machine does not have that command", so the next candidate can be tried. */
+const NOT_INSTALLED = 127;
+/** The exit code the Windows script reports a cancelled dialog with, kept clear of PowerShell's own failure exit of 1. */
+const WINDOWS_CANCELLED = 2;
+/** What the user is asked for, in every OS's own dialog. */
+const PROMPT = 'Choose a git repository to add as a project';
+/** macOS: `osascript`'s `choose folder`, which renders the standard folder sheet. */
+const macDialog = {
+    command: 'osascript',
+    args: ['-e', `POSIX path of (choose folder with prompt "${PROMPT}")`],
+    // osascript reports a cancelled dialog as error -128, the one exit we translate rather than surface.
+    dismissed: run => run.stderr.includes('-128'),
+};
+/**
+ * Windows: PowerShell drives the folder browser that ships with the OS. `-STA` because that dialog
+ * needs a single-threaded apartment, `-NoProfile` so a user's startup script cannot print into the
+ * path read back off stdout.
+ */
+const windowsDialog = {
+    command: 'powershell.exe',
+    args: [
+        '-NoProfile',
+        '-STA',
+        '-Command',
+        [
+            'Add-Type -AssemblyName System.Windows.Forms',
+            '$dialog = New-Object System.Windows.Forms.FolderBrowserDialog',
+            `$dialog.Description = '${PROMPT}'`,
+            '$dialog.ShowNewFolderButton = $false',
+            `if ($dialog.ShowDialog() -eq [System.Windows.Forms.DialogResult]::OK) { $dialog.SelectedPath } else { exit ${WINDOWS_CANCELLED} }`,
+        ].join('; '),
+    ],
+    dismissed: run => run.code === WINDOWS_CANCELLED,
+};
+/**
+ * Linux: the desktop's own dialog helper, whichever of the two is installed — `zenity` on GTK
+ * desktops, `kdialog` on KDE. Both print the chosen folder and report a cancelled dialog as exit 1,
+ * and both are told where to open, because `kdialog` takes the starting directory as an argument.
+ *
+ * Exit 1 is read as a cancellation even though a helper that cannot reach the display exits that
+ * way too: a session with no display at all is ruled out before we get here, and mistaking the
+ * remaining rarity for a cancellation is better than showing every user who cancels the harmless
+ * warnings these helpers print on startup.
+ */
+function linuxDialogs(home) {
+    const dismissed = (run) => run.code === 1;
+    return [
+        { command: 'zenity', args: ['--file-selection', '--directory', `--title=${PROMPT}`, `--filename=${home}/`], dismissed },
+        { command: 'kdialog', args: ['--title', PROMPT, '--getexistingdirectory', home], dismissed },
+    ];
+}
+/** A command that could not be spawned at all reads as not installed; anything else keeps its own exit code. */
+function exitCode(error) {
+    if (error.code === 'ENOENT')
+        return NOT_INSTALLED;
+    return typeof error.code === 'number' ? error.code : 1;
+}
+const nodeDialogRunner = (command, args) => new Promise(done => {
+    execFile(command, args, (error, stdout, stderr) => {
+        done({ code: error ? exitCode(error) : 0, stdout: String(stdout), stderr: String(stderr) });
+    });
+});
+/**
+ * Open the OS folder picker and wait for the user's choice.
+ *
+ * Dismissing the dialog is a normal outcome (`path: null`), not an error. A Linux daemon with no
+ * desktop session to draw on, a Linux machine with neither dialog helper installed, and a platform
+ * with no dialog wired up each answer with that reason instead of trying.
+ */
+export async function pickDirectory(platform = process.platform, run = nodeDialogRunner, env = process.env) {
+    if (platform === 'darwin')
+        return openDialog([macDialog], run);
+    if (platform === 'win32')
+        return openDialog([windowsDialog], run);
+    if (platform === 'linux') {
+        // A dialog needs a screen to appear on, and a daemon started over SSH or inside a container has
+        // none — saying so beats spawning a helper that can only fail.
+        if (!env.DISPLAY && !env.WAYLAND_DISPLAY)
+            return { ok: false, error: 'The machine running OpenAgent has no desktop session, so no folder dialog can open there.' };
+        return openDialog(linuxDialogs(env.HOME ?? '.'), run);
+    }
+    return { ok: false, error: `The system folder picker is not available on ${platform}.` };
+}
+/** Open the first installed dialog of `dialogs`, and read the user's answer out of what it printed. */
+async function openDialog(dialogs, run) {
+    for (const dialog of dialogs) {
+        const result = await run(dialog.command, dialog.args);
+        if (result.code === NOT_INSTALLED)
+            continue;
+        if (dialog.dismissed(result))
+            return { ok: true, path: null };
+        if (result.code !== 0)
+            return { ok: false, error: result.stderr.trim() || 'The folder dialog could not be opened.' };
+        // macOS prints the POSIX path with a trailing slash; the registry stores paths without one.
+        const path = result.stdout.trim().replace(/(.)\/$/, '$1');
+        return path ? { ok: true, path } : { ok: false, error: 'The folder dialog returned no path.' };
+    }
+    const names = dialogs.map(dialog => dialog.command).join(' or ');
+    return { ok: false, error: `The folder dialog needs ${names}, which the machine running OpenAgent does not have installed.` };
+}
+//# sourceMappingURL=pick-directory.js.map

package/dist/pick-directory.js.map

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

package/dist/preference-defaults.d.ts

@@ -0,0 +1,43 @@
+import type { Preferences } from './registry.js';
+/**
+ * What an unset preference means, and the bounds the controls that write them share.
+ *
+ * A leaf module (no `node:*`) so `client.ts` can export it and the dashboard reads the same values
+ * the daemon acts on.
+ *
+ * No cycle: `registry.ts` re-exports the bounds from here, and the `Preferences` import going the
+ * other way is type-only, so it erases.
+ */
+/**
+ * Notifications have two axes (B5): `notifyBrowser` says whether they reach you in the browser at
+ * all, and `notifyHumanIntervention` / `notifyNewActivity` say *what* they are about. A category
+ * delivers only while the browser switch is on too.
+ */
+/** What a notification is about. */
+export type NotifyCategory = 'humanIntervention' | 'newActivity';
+/**
+ * What each switch means when nobody has said.
+ *
+ * The polarities are not uniform, and that is the point of writing them down once: browser
+ * delivery and the "needs you" category fire unless you turn them off, while plain activity is
+ * opt-in.
+ */
+export declare const NOTIFICATION_DEFAULTS: {
+    readonly browser: true;
+    readonly categories: {
+        readonly humanIntervention: true;
+        readonly newActivity: false;
+    };
+};
+/** Whether browser delivery is switched on, with its default applied. */
+export declare function browserNotifyEnabled(preferences: Preferences): boolean;
+/** Whether a category is switched on, with its default applied. */
+export declare function notifyCategoryEnabled(preferences: Preferences, category: NotifyCategory): boolean;
+/** Whether a category delivers: both browser delivery and the category have to be on. */
+export declare function notifies(preferences: Preferences, category: NotifyCategory): boolean;
+/**
+ * How far either side of the quota boundary the usage bar's handle reaches, in percentage points
+ * (#960): the bound of the stop line a module puts on the bar, which the bar clamps a drag to.
+ */
+export declare const MAX_SPEND_OFFSET = 50;
+//# sourceMappingURL=preference-defaults.d.ts.map

package/dist/preference-defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preference-defaults.d.ts","sourceRoot":"","sources":["../src/preference-defaults.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAEhD;;;;;;;;GAQG;AAEH;;;;GAIG;AAEH,oCAAoC;AACpC,MAAM,MAAM,cAAc,GAAG,mBAAmB,GAAG,aAAa,CAAA;AAQhE;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB;;;iBAElB,iBAAiB;iBAAQ,WAAW;;CACkC,CAAA;AAEtF,yEAAyE;AACzE,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAEtE;AAED,mEAAmE;AACnE,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,WAAW,EAAE,QAAQ,EAAE,cAAc,GAAG,OAAO,CAEjG;AAED,yFAAyF;AACzF,wBAAgB,QAAQ,CAAC,WAAW,EAAE,WAAW,EAAE,QAAQ,EAAE,cAAc,GAAG,OAAO,CAEpF;AAED;;;GAGG;AACH,eAAO,MAAM,gBAAgB,KAAK,CAAA"}

package/dist/preference-defaults.js

@@ -0,0 +1,34 @@
+/** The preference key each category is stored under. */
+const CATEGORY_KEYS = {
+    humanIntervention: 'notifyHumanIntervention',
+    newActivity: 'notifyNewActivity',
+};
+/**
+ * What each switch means when nobody has said.
+ *
+ * The polarities are not uniform, and that is the point of writing them down once: browser
+ * delivery and the "needs you" category fire unless you turn them off, while plain activity is
+ * opt-in.
+ */
+export const NOTIFICATION_DEFAULTS = {
+    browser: true,
+    categories: { humanIntervention: true, newActivity: false },
+};
+/** Whether browser delivery is switched on, with its default applied. */
+export function browserNotifyEnabled(preferences) {
+    return preferences.notifyBrowser ?? NOTIFICATION_DEFAULTS.browser;
+}
+/** Whether a category is switched on, with its default applied. */
+export function notifyCategoryEnabled(preferences, category) {
+    return preferences[CATEGORY_KEYS[category]] ?? NOTIFICATION_DEFAULTS.categories[category];
+}
+/** Whether a category delivers: both browser delivery and the category have to be on. */
+export function notifies(preferences, category) {
+    return browserNotifyEnabled(preferences) && notifyCategoryEnabled(preferences, category);
+}
+/**
+ * How far either side of the quota boundary the usage bar's handle reaches, in percentage points
+ * (#960): the bound of the stop line a module puts on the bar, which the bar clamps a drag to.
+ */
+export const MAX_SPEND_OFFSET = 50;
+//# sourceMappingURL=preference-defaults.js.map

package/dist/preference-defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preference-defaults.js","sourceRoot":"","sources":["../src/preference-defaults.ts"],"names":[],"mappings":"AAqBA,wDAAwD;AACxD,MAAM,aAAa,GAAG;IACpB,iBAAiB,EAAE,yBAAyB;IAC5C,WAAW,EAAE,mBAAmB;CAC4B,CAAA;AAE9D;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,OAAO,EAAE,IAAI;IACb,UAAU,EAAE,EAAE,iBAAiB,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE;CACyB,CAAA;AAEtF,yEAAyE;AACzE,MAAM,UAAU,oBAAoB,CAAC,WAAwB;IAC3D,OAAO,WAAW,CAAC,aAAa,IAAI,qBAAqB,CAAC,OAAO,CAAA;AACnE,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,qBAAqB,CAAC,WAAwB,EAAE,QAAwB;IACtF,OAAO,WAAW,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,IAAI,qBAAqB,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAA;AAC3F,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,QAAQ,CAAC,WAAwB,EAAE,QAAwB;IACzE,OAAO,oBAAoB,CAAC,WAAW,CAAC,IAAI,qBAAqB,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAA;AAC1F,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,EAAE,CAAA"}

package/dist/project-commands.d.ts

@@ -0,0 +1,24 @@
+/**
+ * A project's commands (#1774): the skills written to be run by a person, read off the folders
+ * the coding agents read them from. OpenAgent ships no prompt text; what a project can be
+ * asked to do is what its own command skills say. A skill that teaches the agent how to do
+ * something (the tickets, the queue) is not a command: typed alone it starts an agent with
+ * nothing to do, so the launcher does not list it.
+ */
+/** Where coding agents read a project's skills: Claude Code's folder, and the shared one Codex reads. */
+export declare const SKILLS_DIRS: readonly ['.claude/skills', '.agents/skills'];
+/** One skill as the launcher shows it. */
+export interface ProjectCommand {
+    /** What is typed after the slash: the skill's folder name. */
+    name: string;
+    /** The `description` of the skill's front matter, when it has one. */
+    description?: string;
+}
+/**
+ * The project's commands, by name: the skills whose front matter says
+ * `disable-model-invocation: true`, written to be run by a person or a runner and never picked
+ * up by the agent on its own. A skill in both folders is listed once. A folder without a
+ * readable `SKILL.md` is skipped, and a project with no skills folder has no commands.
+ */
+export declare function readProjectCommands(cwd: string): Promise<ProjectCommand[]>;
+//# sourceMappingURL=project-commands.d.ts.map

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

@@ -0,0 +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"}