@openagt/dashboard 0.0.0-stage → 0.8.0

package/dist/dashboard/overview.js.map

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

package/dist/dashboard/projects.d.ts

@@ -0,0 +1,100 @@
+import { type ProjectRecord } from '../registry.js';
+import { type AgentMeta } from '../store/index.js';
+import type { ProjectError } from '../project-errors.js';
+import { type GitHostFor } from '../store/git-host.js';
+/**
+ * The multi-project read side (#392): projects the daemon serves come from the registry (#390),
+ * and every read resolves a project id to that project's path before running the per-cwd reader
+ * underneath. One daemon serves them all, running as many agents per project as their own
+ * concurrency allows (#736), each in its own checkout.
+ */
+/** One project's summary for the Projects sidebar (#314). */
+export interface ProjectSummary {
+    /** Registry id (stable, URL-safe). */
+    id: string;
+    /** Absolute repo path. */
+    path: string;
+    /** Display name (the path's basename). */
+    name: string;
+    /** True when the repo still has its `.the-framework/` marker. */
+    activated: boolean;
+    /** Whether one of the project's packages provides a git host; without one no pull request can be opened there. */
+    gitHost: boolean;
+    /** ISO timestamp of the project's newest activity: its most recent session. */
+    lastActivityAt?: string;
+    /**
+     * What the daemon's background jobs currently find wrong with the project (#1500), oldest
+     * first — absent when nothing is. Not part of the summary itself: the dashboard's project
+     * list attaches it from the daemon's error state.
+     */
+    errors?: ProjectError[];
+    /**
+     * The project's repository has no remote, as the daemon's last data sync found it: nothing is
+     * wrong, it lives on this machine only. Absent otherwise; attached like `errors`.
+     */
+    localOnly?: true;
+}
+/**
+ * A projection over the registered projects, together with the projects it could actually see.
+ *
+ * A project whose sources cannot be read contributes no items — which is exactly what a project
+ * with nothing waiting contributes. `whole` is what tells the two apart (#1623). Only a caller
+ * that keeps a baseline of what it has already announced needs the distinction; the panels that
+ * simply render the list read `items` and ignore it.
+ */
+export interface ProjectionRead<T> {
+    /** What was found. Possibly only part of it, when some project could not be read. */
+    items: T[];
+    /** The ids of the projects every source answered for, so their share of `items` is all of it. */
+    whole: string[];
+}
+/** Injectable readers so {@link summarizeProject} is unit-testable off disk. */
+export interface SummarizeDeps {
+    isActivated?: (path: string) => Promise<boolean>;
+    /** The project's runs (live + archived), newest-first. Defaults to {@link readAllAgents}. */
+    readAgents?: (path: string) => Promise<AgentMeta[]>;
+    /** The project's git host. Defaults to {@link projectGitHost}. */
+    gitHost?: GitHostFor;
+}
+/** A project's runs, live prepended to the archived history. Forgiving: a failed read is `[]`. */
+/**
+ * Derive a {@link ProjectSummary} from a registry record: its display name, whether
+ * it is still activated, and its last activity. Forgiving: a failed read reads as an
+ * inactive project with no activity, never a throw.
+ *
+ * Activity is the sessions themselves (B3). It used to be the newest of those and the latest
+ * `LOGS.md` entry — a committed markdown re-narration of the same sessions, which could only ever
+ * be older than the agent it described.
+ */
+export declare function summarizeProject(record: ProjectRecord, deps?: SummarizeDeps): Promise<ProjectSummary>;
+/**
+ * Reads the registry to serve the multi-project endpoints. The dashboard server
+ * holds one of these; the daemon uses the default (the real registry), tests pass
+ * a fake so the server is exercised without touching the user's registry.
+ */
+export interface ProjectsProvider {
+    /** Every registered project, summarized, for the projects read. */
+    list(): Promise<ProjectSummary[]>;
+    /** The absolute path for a registry id, or `undefined` when unknown. */
+    resolvePath(id: string): Promise<string | undefined>;
+}
+/** Injectable readers so {@link defaultProjectsProvider} is unit-testable off the user's registry. */
+export interface ProviderDeps {
+    /** The registry's records. Defaults to {@link listProjects}, forgiving. */
+    listRecords?: () => Promise<ProjectRecord[]>;
+    /** Whether a project's directory is on disk. Defaults to a directory stat. */
+    isDirectory?: (path: string) => Promise<boolean>;
+    /** Defaults to {@link summarizeProject}. */
+    summarize?: (record: ProjectRecord) => Promise<ProjectSummary>;
+}
+/**
+ * A {@link ProjectsProvider} backed by the global registry (#390).
+ *
+ * Only projects whose directory is still on disk are served (#1140): a repo the user renamed or
+ * deleted used to stay in the sidebar as a grey "not activated" entry with no files (#1142),
+ * indistinguishable from a repo that merely lost its marker, and with nothing to click to make it
+ * go away. The registry itself is left alone — the record is skipped, not pruned — so a directory
+ * that comes back (renamed back, a volume remounted) is a project again on the next read.
+ */
+export declare function defaultProjectsProvider(deps?: ProviderDeps): ProjectsProvider;
+//# sourceMappingURL=projects.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"projects.d.ts","sourceRoot":"","sources":["../../src/dashboard/projects.ts"],"names":[],"mappings":"AACA,OAAO,EAAgB,KAAK,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAGjE,OAAO,EAAiB,KAAK,SAAS,EAAE,MAAM,mBAAmB,CAAA;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AACxD,OAAO,EAAkB,KAAK,UAAU,EAAE,MAAM,sBAAsB,CAAA;AAEtE;;;;;GAKG;AAEH,6DAA6D;AAC7D,MAAM,WAAW,cAAc;IAC7B,sCAAsC;IACtC,EAAE,EAAE,MAAM,CAAA;IACV,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAA;IACZ,iEAAiE;IACjE,SAAS,EAAE,OAAO,CAAA;IAClB,kHAAkH;IAClH,OAAO,EAAE,OAAO,CAAA;IAChB,+EAA+E;IAC/E,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB;;;;OAIG;IACH,MAAM,CAAC,EAAE,YAAY,EAAE,CAAA;IACvB;;;OAGG;IACH,SAAS,CAAC,EAAE,IAAI,CAAA;CACjB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,qFAAqF;IACrF,KAAK,EAAE,CAAC,EAAE,CAAA;IACV,iGAAiG;IACjG,KAAK,EAAE,MAAM,EAAE,CAAA;CAChB;AAED,gFAAgF;AAChF,MAAM,WAAW,aAAa;IAC5B,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IAChD,6FAA6F;IAC7F,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,EAAE,CAAC,CAAA;IACnD,kEAAkE;IAClE,OAAO,CAAC,EAAE,UAAU,CAAA;CACrB;AAED,kGAAkG;AAClG;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,aAAa,EAAE,IAAI,GAAE,aAAkB,GAAG,OAAO,CAAC,cAAc,CAAC,CAiB/G;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,mEAAmE;IACnE,IAAI,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC,CAAA;IACjC,wEAAwE;IACxE,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;CACrD;AAED,sGAAsG;AACtG,MAAM,WAAW,YAAY;IAC3B,2EAA2E;IAC3E,WAAW,CAAC,EAAE,MAAM,OAAO,CAAC,aAAa,EAAE,CAAC,CAAA;IAC5C,8EAA8E;IAC9E,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IAChD,4CAA4C;IAC5C,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,OAAO,CAAC,cAAc,CAAC,CAAA;CAC/D;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,GAAE,YAAiB,GAAG,gBAAgB,CAiBjF"}

package/dist/dashboard/projects.js

@@ -0,0 +1,63 @@
+import { basename } from 'node:path';
+import { listProjects } from '../registry.js';
+import { nodeFs } from '../node-fs.js';
+import { isActivated } from '../project.js';
+import { readAllAgents } from '../store/index.js';
+import { projectGitHost } from '../store/git-host.js';
+/** A project's runs, live prepended to the archived history. Forgiving: a failed read is `[]`. */
+/**
+ * Derive a {@link ProjectSummary} from a registry record: its display name, whether
+ * it is still activated, and its last activity. Forgiving: a failed read reads as an
+ * inactive project with no activity, never a throw.
+ *
+ * Activity is the sessions themselves (B3). It used to be the newest of those and the latest
+ * `LOGS.md` entry — a committed markdown re-narration of the same sessions, which could only ever
+ * be older than the agent it described.
+ */
+export async function summarizeProject(record, deps = {}) {
+    const checkActivated = deps.isActivated ?? isActivated;
+    const loadAgents = deps.readAgents ?? readAllAgents;
+    const activated = await checkActivated(record.path).catch(() => false);
+    const agents = await loadAgents(record.path).catch(() => []);
+    // ISO timestamps sort chronologically.
+    const agentActivity = agents.map(r => r.updatedAt || r.startedAt).filter(Boolean);
+    const lastActivityAt = agentActivity.filter((a) => !!a).sort().at(-1);
+    const summary = {
+        id: record.id,
+        path: record.path,
+        name: basename(record.path),
+        activated,
+        gitHost: (await (deps.gitHost ?? projectGitHost)(record.path).catch(() => undefined)) !== undefined,
+    };
+    if (lastActivityAt)
+        summary.lastActivityAt = lastActivityAt;
+    return summary;
+}
+/**
+ * A {@link ProjectsProvider} backed by the global registry (#390).
+ *
+ * Only projects whose directory is still on disk are served (#1140): a repo the user renamed or
+ * deleted used to stay in the sidebar as a grey "not activated" entry with no files (#1142),
+ * indistinguishable from a repo that merely lost its marker, and with nothing to click to make it
+ * go away. The registry itself is left alone — the record is skipped, not pruned — so a directory
+ * that comes back (renamed back, a volume remounted) is a project again on the next read.
+ */
+export function defaultProjectsProvider(deps = {}) {
+    const listRecords = deps.listRecords ?? (() => listProjects().catch(() => []));
+    const isDirectory = deps.isDirectory ?? nodeFs().isDirectory;
+    const summarize = deps.summarize ?? (record => summarizeProject(record));
+    const present = async () => {
+        const records = await listRecords();
+        const kept = await Promise.all(records.map(async (record) => ((await isDirectory(record.path).catch(() => false)) ? record : undefined)));
+        return kept.filter((record) => record !== undefined);
+    };
+    return {
+        async list() {
+            return Promise.all((await present()).map(summarize));
+        },
+        async resolvePath(id) {
+            return (await present()).find(record => record.id === id)?.path;
+        },
+    };
+}
+//# sourceMappingURL=projects.js.map

package/dist/dashboard/projects.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projects.js","sourceRoot":"","sources":["../../src/dashboard/projects.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AACpC,OAAO,EAAE,YAAY,EAAsB,MAAM,gBAAgB,CAAA;AACjE,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAC3C,OAAO,EAAE,aAAa,EAAkB,MAAM,mBAAmB,CAAA;AAEjE,OAAO,EAAE,cAAc,EAAmB,MAAM,sBAAsB,CAAA;AA4DtE,kGAAkG;AAClG;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,MAAqB,EAAE,IAAI,GAAkB,EAAE;IACpF,MAAM,cAAc,GAAG,IAAI,CAAC,WAAW,IAAI,WAAW,CAAA;IACtD,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,aAAa,CAAA;IACnD,MAAM,SAAS,GAAG,MAAM,cAAc,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAA;IACtE,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAiB,CAAC,CAAA;IAC3E,uCAAuC;IACvC,MAAM,aAAa,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;IACjF,MAAM,cAAc,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAA;IAClF,MAAM,OAAO,GAAmB;QAC9B,EAAE,EAAE,MAAM,CAAC,EAAE;QACb,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC;QAC3B,SAAS;QACT,OAAO,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,IAAI,cAAc,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC,KAAK,SAAS;KACpG,CAAA;IACD,IAAI,cAAc;QAAE,OAAO,CAAC,cAAc,GAAG,cAAc,CAAA;IAC3D,OAAO,OAAO,CAAA;AAChB,CAAC;AAwBD;;;;;;;;GAQG;AACH,MAAM,UAAU,uBAAuB,CAAC,IAAI,GAAiB,EAAE;IAC7D,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,IAAI,CAAC,GAAG,EAAE,CAAC,YAAY,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;IAC9E,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,IAAI,MAAM,EAAE,CAAC,WAAW,CAAA;IAC5D,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAA;IACxE,MAAM,OAAO,GAAG,KAAK,IAA8B,EAAE;QACnD,MAAM,OAAO,GAAG,MAAM,WAAW,EAAE,CAAA;QACnC,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAC,MAAM,EAAC,EAAE,CAAC,CAAC,CAAC,MAAM,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAA;QACvI,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,EAA2B,EAAE,CAAC,MAAM,KAAK,SAAS,CAAC,CAAA;IAC/E,CAAC,CAAA;IACD,OAAO;QACL,KAAK,CAAC,IAAI;YACR,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAA;QACtD,CAAC;QACD,KAAK,CAAC,WAAW,CAAC,EAAE;YAClB,OAAO,CAAC,MAAM,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,CAAA;QACjE,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/dashboard/pull-requests.d.ts

@@ -0,0 +1,127 @@
+import { type GitHostFor, type GitHostRequest } from '../store/git-host.js';
+import { type Cached } from './cache.js';
+/**
+ * The pull requests the dashboard reads (#1820), in one place, all through the project's git host
+ * provider (`../store/git-host.ts`): a branch's request, a branch's whole request history, and the
+ * project's open requests. Reads only: opening and landing are `agent-handoff.ts`'s, through the
+ * same provider. The framework runs no git host tool; a project with no git host package has no pull
+ * requests, and every read here answers "none" for it.
+ *
+ * The shapes are the framework's own ({@link LinkedPr}, {@link OpenPr}), copied out of what the
+ * provider answers rather than passed through, so a field a provider adds cannot leak into what
+ * callers store.
+ */
+/** The PR opened for a branch, when there is one. */
+export interface LinkedPr {
+    number: number;
+    url: string;
+    /** OPEN / MERGED / CLOSED, as the git host reports it; UNKNOWN for a recorded request no live read confirmed. */
+    state: string;
+    title: string;
+    /** ISO creation time, when the read included it: what tells one agent's PR from a predecessor's. */
+    createdAt?: string;
+    /**
+     * The head commit the PR covers, when the read included it (#1512): what tells "the branch's
+     * PR already landed everything" from "the session kept working after its PR merged".
+     */
+    headRefOid?: string;
+    /** The commit a merged PR landed as on the base branch, when the git host said. */
+    mergeCommit?: string;
+}
+/** An open PR on the interventions queue (#632). */
+export interface OpenPr {
+    number: number;
+    title: string;
+    url: string;
+    /**
+     * Draft PRs are generally left off the queue: a draft is not asking for review.
+     *
+     * The exception is a draft the framework opened for itself (#1102), which {@link headRefName}
+     * is what tells apart.
+     */
+    isDraft: boolean;
+    /** The branch the PR is from, so a session's own PR can be recognised as ours (#1102). */
+    headRefName?: string;
+    createdAt?: string;
+}
+/**
+ * A best-effort PR lookup, for a named branch or for the checkout's current branch. One type for
+ * both: the named-branch form is the general one, and "the current branch" is just omitting it.
+ */
+export type PrLookup = (cwd: string, branch?: string) => Promise<LinkedPr | undefined>;
+/**
+ * The branch-addressed form, for a caller that always names one (#799): a finished session's
+ * worktree may be gone, so "the current branch" would silently be the project's, not the
+ * session's. Narrower than {@link PrLookup} on purpose, so that invariant is in the type.
+ */
+export type BranchPrLookup = (cwd: string, branch: string) => Promise<LinkedPr | undefined>;
+/** Lists a checkout's open PRs; rejects when the git host could not answer. */
+export type PrLister = (cwd: string) => Promise<OpenPr[]>;
+/** A provider's request as the framework keeps it: the state upper-cased, the head as the request's commit. */
+export declare function linkedPrOf(request: GitHostRequest): LinkedPr;
+/** A provider's open request as the interventions queue keeps it. */
+export declare function openPrOf(request: GitHostRequest): OpenPr;
+/**
+ * Every PR a branch name has ever had, newest first (#1251).
+ *
+ * The newest request for a head *in any state* is what a single view would answer, so a session
+ * whose prompt pins its branch name (`the-framework/triage-quick`) inherits a predecessor's
+ * merged PR as its own. The list form keeps the whole history so {@link pickAgentPr} can decide
+ * which entry, if any, belongs to the agent asking. Resolves `[]` when the project has no git host or
+ * the git host could not answer — indistinguishable from "no PRs", which is what every caller would do
+ * with a failure anyway.
+ */
+export declare function prsForBranch(cwd: string, branch: string, gitHost?: GitHostFor): Promise<LinkedPr[]>;
+/**
+ * {@link prsForBranch} for a caller about to *open* a PR (#1601): a listing the git host could not
+ * answer throws instead of reading as "no PRs", because "none" and "could not tell" must not look
+ * alike there — the difference is a second draft PR on a branch that already has one. A project
+ * with no git host has none, truthfully.
+ */
+export declare function prsForBranchOrThrow(cwd: string, branch: string, gitHost?: GitHostFor): Promise<LinkedPr[]>;
+/** The newest PR of `branch`, in any state, or undefined when it has none or the git host cannot tell. */
+export declare function prView(cwd: string, branch: string, gitHost?: GitHostFor): Promise<LinkedPr | undefined>;
+/**
+ * The cached form of {@link prView} (#1028), and what the dashboard's panels use.
+ *
+ * A PR lookup costs a process where the git reads beside it cost ten milliseconds, and the answer
+ * changes about as often as someone opens a PR. Cached per checkout and branch, shared between
+ * the worktree bar and the handoff summary, and refreshed behind whoever asks. `pending` says the
+ * answer is not known yet rather than that there is no PR — the difference matters to a caller
+ * deciding whether to offer "Open PR". A read with no branch to ask about answers nothing at once.
+ */
+export declare function cachedPrView(cwd: string, branch?: string): Promise<Cached<LinkedPr | undefined>>;
+/** Forget a branch's PR, after an action that changes whether it has one. */
+export declare function forgetPr(cwd: string, branch?: string): void;
+/** The cached form of {@link prsForBranch}, shared through the same read-through cache (#1028). */
+export declare function cachedPrsForBranch(cwd: string, branch: string): Promise<Cached<LinkedPr[]>>;
+/** Forget a branch's PR history, after an action that changes it (opening one). */
+export declare function forgetBranchPrs(cwd: string, branch: string): void;
+/**
+ * The PR that belongs to an agent, out of every PR its branch name has had (#1251/#1255).
+ *
+ * An OPEN PR always counts: a git host allows one open PR per head branch, so whatever is open on the
+ * run's branch is where its pushed commits land. A closed one counts only when it was created
+ * after the agent started (`since`, the agent's `startedAt`) — the oldest such entry, which is the one
+ * this agent's handoff opened. Anything older is a previous agent's PR wearing the same branch name,
+ * which is exactly what showed a merged two-day-old PR as a fresh session's own. Without `since`
+ * only an open PR is trusted.
+ *
+ * `order` exists for the one caller asking a different question (#1512). `'first'` answers
+ * identity — which PR did *this agent* open, so a later agent's must not be the answer. `'latest'`
+ * answers the handoff decision — which PR last saw the branch, so "did the session keep working
+ * past it" is readable off that PR's `headRefOid`; there the oldest entry would call work that a
+ * second PR already landed unlanded.
+ */
+export declare function pickAgentPr(prs: LinkedPr[], since?: string, order?: 'first' | 'latest'): LinkedPr | undefined;
+/**
+ * A project's open PRs, through its git host. Unlike the other reads here it *rejects* when the git host
+ * could not answer — no remote, not logged in, the git host unreachable — instead of resolving `[]`.
+ *
+ * "No PRs are open" and "I could not look" are different answers, and its caller keeps a baseline
+ * of what it has already announced (#1623): taking the second for the first makes the next
+ * successful read announce every already-open PR as new. The caller decides what a failure costs;
+ * it cannot decide what it never hears about. A project with no git host package has none open.
+ */
+export declare function openPrs(cwd: string, gitHost?: GitHostFor): Promise<OpenPr[]>;
+//# sourceMappingURL=pull-requests.d.ts.map

package/dist/dashboard/pull-requests.d.ts.map

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

package/dist/dashboard/pull-requests.js

@@ -0,0 +1,137 @@
+import { projectGitHost } from '../store/git-host.js';
+import { cachedRead, invalidate } from './cache.js';
+/** A provider's request as the framework keeps it: the state upper-cased, the head as the request's commit. */
+export function linkedPrOf(request) {
+    return {
+        number: request.number,
+        url: request.url,
+        state: request.state.toUpperCase(),
+        title: request.title,
+        ...(request.createdAt ? { createdAt: request.createdAt } : {}),
+        ...(request.head ? { headRefOid: request.head } : {}),
+        ...(request.mergeCommit ? { mergeCommit: request.mergeCommit } : {}),
+    };
+}
+/** A provider's open request as the interventions queue keeps it. */
+export function openPrOf(request) {
+    return {
+        number: request.number,
+        title: request.title,
+        url: request.url,
+        isDraft: request.draft,
+        ...(request.branch ? { headRefName: request.branch } : {}),
+        ...(request.createdAt ? { createdAt: request.createdAt } : {}),
+    };
+}
+/**
+ * Every PR a branch name has ever had, newest first (#1251).
+ *
+ * The newest request for a head *in any state* is what a single view would answer, so a session
+ * whose prompt pins its branch name (`the-framework/triage-quick`) inherits a predecessor's
+ * merged PR as its own. The list form keeps the whole history so {@link pickAgentPr} can decide
+ * which entry, if any, belongs to the agent asking. Resolves `[]` when the project has no git host or
+ * the git host could not answer — indistinguishable from "no PRs", which is what every caller would do
+ * with a failure anyway.
+ */
+export async function prsForBranch(cwd, branch, gitHost = projectGitHost) {
+    return prsForBranchOrThrow(cwd, branch, gitHost).catch(() => []);
+}
+/**
+ * {@link prsForBranch} for a caller about to *open* a PR (#1601): a listing the git host could not
+ * answer throws instead of reading as "no PRs", because "none" and "could not tell" must not look
+ * alike there — the difference is a second draft PR on a branch that already has one. A project
+ * with no git host has none, truthfully.
+ */
+export async function prsForBranchOrThrow(cwd, branch, gitHost = projectGitHost) {
+    const source = await gitHost(cwd);
+    if (!source)
+        return [];
+    const listed = await source.requests({ branch, state: 'all' });
+    if (!listed.ok)
+        throw new Error(listed.error);
+    return listed.requests.map(linkedPrOf);
+}
+/** The newest PR of `branch`, in any state, or undefined when it has none or the git host cannot tell. */
+export async function prView(cwd, branch, gitHost = projectGitHost) {
+    return (await prsForBranch(cwd, branch, gitHost))[0];
+}
+/**
+ * The cached form of {@link prView} (#1028), and what the dashboard's panels use.
+ *
+ * A PR lookup costs a process where the git reads beside it cost ten milliseconds, and the answer
+ * changes about as often as someone opens a PR. Cached per checkout and branch, shared between
+ * the worktree bar and the handoff summary, and refreshed behind whoever asks. `pending` says the
+ * answer is not known yet rather than that there is no PR — the difference matters to a caller
+ * deciding whether to offer "Open PR". A read with no branch to ask about answers nothing at once.
+ */
+export async function cachedPrView(cwd, branch) {
+    if (branch === undefined)
+        return { value: undefined, pending: false };
+    return cachedRead(prCacheKey(cwd, branch), () => prView(cwd, branch));
+}
+/** Forget a branch's PR, after an action that changes whether it has one. */
+export function forgetPr(cwd, branch) {
+    invalidate(prCacheKey(cwd, branch));
+}
+/** The cached form of {@link prsForBranch}, shared through the same read-through cache (#1028). */
+export async function cachedPrsForBranch(cwd, branch) {
+    return cachedRead(branchPrsCacheKey(cwd, branch), () => prsForBranch(cwd, branch));
+}
+/** Forget a branch's PR history, after an action that changes it (opening one). */
+export function forgetBranchPrs(cwd, branch) {
+    invalidate(branchPrsCacheKey(cwd, branch));
+}
+/** An unprintable separator, so paths cannot collide with the keys. */
+const KEY_SEP = String.fromCharCode(0);
+function prCacheKey(cwd, branch) {
+    return ['pr', cwd, branch ?? ''].join(KEY_SEP);
+}
+function branchPrsCacheKey(cwd, branch) {
+    return ['prs', cwd, branch].join(KEY_SEP);
+}
+/**
+ * The PR that belongs to an agent, out of every PR its branch name has had (#1251/#1255).
+ *
+ * An OPEN PR always counts: a git host allows one open PR per head branch, so whatever is open on the
+ * run's branch is where its pushed commits land. A closed one counts only when it was created
+ * after the agent started (`since`, the agent's `startedAt`) — the oldest such entry, which is the one
+ * this agent's handoff opened. Anything older is a previous agent's PR wearing the same branch name,
+ * which is exactly what showed a merged two-day-old PR as a fresh session's own. Without `since`
+ * only an open PR is trusted.
+ *
+ * `order` exists for the one caller asking a different question (#1512). `'first'` answers
+ * identity — which PR did *this agent* open, so a later agent's must not be the answer. `'latest'`
+ * answers the handoff decision — which PR last saw the branch, so "did the session keep working
+ * past it" is readable off that PR's `headRefOid`; there the oldest entry would call work that a
+ * second PR already landed unlanded.
+ */
+export function pickAgentPr(prs, since, order = 'first') {
+    const open = prs.find(pr => pr.state === 'OPEN');
+    if (open)
+        return open;
+    if (!since)
+        return undefined;
+    const closed = prs
+        .filter(pr => pr.createdAt && pr.createdAt >= since)
+        .sort((a, b) => ((a.createdAt ?? '') < (b.createdAt ?? '') ? -1 : 1));
+    return order === 'latest' ? closed.at(-1) : closed[0];
+}
+/**
+ * A project's open PRs, through its git host. Unlike the other reads here it *rejects* when the git host
+ * could not answer — no remote, not logged in, the git host unreachable — instead of resolving `[]`.
+ *
+ * "No PRs are open" and "I could not look" are different answers, and its caller keeps a baseline
+ * of what it has already announced (#1623): taking the second for the first makes the next
+ * successful read announce every already-open PR as new. The caller decides what a failure costs;
+ * it cannot decide what it never hears about. A project with no git host package has none open.
+ */
+export async function openPrs(cwd, gitHost = projectGitHost) {
+    const source = await gitHost(cwd);
+    if (!source)
+        return [];
+    const listed = await source.requests({ state: 'open' });
+    if (!listed.ok)
+        throw new Error(listed.error);
+    return listed.requests.map(openPrOf);
+}
+//# sourceMappingURL=pull-requests.js.map

package/dist/dashboard/pull-requests.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pull-requests.js","sourceRoot":"","sources":["../../src/dashboard/pull-requests.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAwC,MAAM,sBAAsB,CAAA;AAC3F,OAAO,EAAE,UAAU,EAAE,UAAU,EAAe,MAAM,YAAY,CAAA;AAiEhE,+GAA+G;AAC/G,MAAM,UAAU,UAAU,CAAC,OAAuB;IAChD,OAAO;QACL,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,WAAW,EAAE;QAClC,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9D,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACrD,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACrE,CAAA;AACH,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,QAAQ,CAAC,OAAuB;IAC9C,OAAO;QACL,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,OAAO,EAAE,OAAO,CAAC,KAAK;QACtB,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1D,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC/D,CAAA;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,GAAW,EAAE,MAAc,EAAE,OAAO,GAAe,cAAc;IAClG,OAAO,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,GAAe,EAAE,CAAC,EAAE,CAAC,CAAA;AAC9E,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,GAAW,EAAE,MAAc,EAAE,OAAO,GAAe,cAAc;IACzG,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAA;IACjC,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,CAAA;IACtB,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAA;IAC9D,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IAC7C,OAAO,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;AACxC,CAAC;AAED,0GAA0G;AAC1G,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,GAAW,EAAE,MAAc,EAAE,OAAO,GAAe,cAAc;IAC5F,OAAO,CAAC,MAAM,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;AACtD,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,GAAW,EAAE,MAAe;IAC7D,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,CAAA;IACrE,OAAO,UAAU,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAA;AACvE,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,QAAQ,CAAC,GAAW,EAAE,MAAe;IACnD,UAAU,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAA;AACrC,CAAC;AAED,mGAAmG;AACnG,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,GAAW,EAAE,MAAc;IAClE,OAAO,UAAU,CAAC,iBAAiB,CAAC,GAAG,EAAE,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAA;AACpF,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,eAAe,CAAC,GAAW,EAAE,MAAc;IACzD,UAAU,CAAC,iBAAiB,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAA;AAC5C,CAAC;AAED,uEAAuE;AACvE,MAAM,OAAO,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;AAEtC,SAAS,UAAU,CAAC,GAAW,EAAE,MAAe;IAC9C,OAAO,CAAC,IAAI,EAAE,GAAG,EAAE,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;AAChD,CAAC;AAED,SAAS,iBAAiB,CAAC,GAAW,EAAE,MAAc;IACpD,OAAO,CAAC,KAAK,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;AAC3C,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,WAAW,CAAC,GAAe,EAAE,KAAc,EAAE,KAAK,GAAuB,OAAO;IAC9F,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,KAAK,MAAM,CAAC,CAAA;IAChD,IAAI,IAAI;QAAE,OAAO,IAAI,CAAA;IACrB,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAA;IAC5B,MAAM,MAAM,GAAG,GAAG;SACf,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,SAAS,IAAI,EAAE,CAAC,SAAS,IAAI,KAAK,CAAC;SACnD,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IACvE,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAA;AACvD,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,GAAW,EAAE,OAAO,GAAe,cAAc;IAC7E,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAA;IACjC,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,CAAA;IACtB,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAA;IACvD,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IAC7C,OAAO,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;AACtC,CAAC"}

package/dist/dashboard/queue.d.ts

@@ -0,0 +1,17 @@
+import type { ProjectSummary } from './projects.js';
+import { type QueueFor } from '../store/queue.js';
+/** One project's queue, as the dashboard reads it. */
+export interface ProjectQueue {
+    projectId: string;
+    projectName: string;
+    /** The open entries, in order of work: each the task a future agent is started with. */
+    entries: string[];
+}
+/**
+ * The queue of every project that has one, most entries first: a project one of whose packages
+ * provides the queue is listed even with nothing queued (the card shows the projects it can speak
+ * for), and a project with no provider is left out (it has no queue, so nothing is said about it).
+ * `queueFor` is injectable so this is unit-testable off disk and processes.
+ */
+export declare function collectQueue(projects: ProjectSummary[], queueFor?: QueueFor): Promise<ProjectQueue[]>;
+//# sourceMappingURL=queue.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../../src/dashboard/queue.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AACnD,OAAO,EAAgB,KAAK,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAO/D,sDAAsD;AACtD,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,MAAM,CAAA;IACnB,wFAAwF;IACxF,OAAO,EAAE,MAAM,EAAE,CAAA;CAClB;AAED;;;;;GAKG;AACH,wBAAsB,YAAY,CAAC,QAAQ,EAAE,cAAc,EAAE,EAAE,QAAQ,GAAE,QAAuB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CASzH"}

package/dist/dashboard/queue.js

@@ -0,0 +1,19 @@
+import { projectQueue } from '../store/queue.js';
+/**
+ * The queue of every project that has one, most entries first: a project one of whose packages
+ * provides the queue is listed even with nothing queued (the card shows the projects it can speak
+ * for), and a project with no provider is left out (it has no queue, so nothing is said about it).
+ * `queueFor` is injectable so this is unit-testable off disk and processes.
+ */
+export async function collectQueue(projects, queueFor = projectQueue) {
+    const queues = [];
+    for (const project of projects) {
+        const source = await queueFor(project.path).catch(() => undefined);
+        if (!source)
+            continue;
+        const entries = await source.list().catch(() => []);
+        queues.push({ projectId: project.id, projectName: project.name, entries });
+    }
+    return queues.sort((a, b) => b.entries.length - a.entries.length);
+}
+//# sourceMappingURL=queue.js.map

package/dist/dashboard/queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.js","sourceRoot":"","sources":["../../src/dashboard/queue.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAiB,MAAM,mBAAmB,CAAA;AAe/D;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,QAA0B,EAAE,QAAQ,GAAa,YAAY;IAC9F,MAAM,MAAM,GAAmB,EAAE,CAAA;IACjC,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAA;QAClE,IAAI,CAAC,MAAM;YAAE,SAAQ;QACrB,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAa,EAAE,CAAC,EAAE,CAAC,CAAA;QAC7D,MAAM,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,EAAE,WAAW,EAAE,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,CAAA;IAC5E,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;AACnE,CAAC"}

package/dist/dashboard/quota.d.ts

@@ -0,0 +1,53 @@
+import { QuotaPoller } from '../quota-poller.js';
+import { type QuotaBoundary } from '../quota-boundary.js';
+import type { DriverQuotaUnavailableReason, DriverQuotaWindow } from '@openagt/agent-driver';
+/**
+ * Everything the dashboard needs to draw the usage panel (#533): the account's
+ * own windows, and where they stand against the quota boundary (#879).
+ */
+export interface QuotaView {
+    /**
+     * The account's quota windows as the agent reported them (session, week, and
+     * a week per model). Empty when we have no reading at all — check
+     * {@link unavailable} before reading that as "nothing used".
+     */
+    windows: DriverQuotaWindow[];
+    /** When the reading was taken, epoch ms. Absent when there has never been one. */
+    readAt?: number;
+    /**
+     * Why there is no reading, when there isn't one. Present alongside stale
+     * `windows` too: the last good reading is kept through a blip, and this says
+     * the newest attempt failed, so the UI can mark it stale rather than blank it.
+     */
+    unavailable?: DriverQuotaUnavailableReason;
+    /**
+     * The quota boundary of the account's week (#879). Absent when there is no
+     * reading, or when the week's reset could not be placed — which is "we don't
+     * know", not "nothing is allowed".
+     */
+    boundary?: QuotaBoundary;
+}
+/** Where a dashboard reads the quota from. */
+export interface QuotaSource {
+    read(): Promise<QuotaView>;
+    /** Stop any polling behind it. */
+    stop(): void;
+}
+/**
+ * A {@link QuotaSource} backed by a live poller.
+ *
+ * The boundary is measured per read rather than captured: it moves with the clock, so a cached
+ * one would be stale the moment the week's day rolls over. A read costs no reading of the
+ * account: the poller's last good windows are measured again.
+ */
+export declare function pollerQuotaSource(poller: QuotaPoller, now?: () => number): QuotaSource;
+/**
+ * The daemon's own quota source: it polls for the whole life of the dashboard,
+ * not just during an agent, because the panel has to show where the account stands
+ * even when nothing is running.
+ *
+ * Separate from the reading an agent takes for itself: that one dies with the agent, and
+ * nothing stops a running agent over quota anyway. This one exists to draw the bar.
+ */
+export declare function defaultQuotaSource(): QuotaSource;
+//# sourceMappingURL=quota.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"quota.d.ts","sourceRoot":"","sources":["../../src/dashboard/quota.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAChD,OAAO,EAAgB,KAAK,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAEvE,OAAO,KAAK,EAAE,4BAA4B,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AAE5F;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB;;;;OAIG;IACH,OAAO,EAAE,iBAAiB,EAAE,CAAA;IAC5B,kFAAkF;IAClF,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;;;;OAIG;IACH,WAAW,CAAC,EAAE,4BAA4B,CAAA;IAC1C;;;;OAIG;IACH,QAAQ,CAAC,EAAE,aAAa,CAAA;CACzB;AAED,8CAA8C;AAC9C,MAAM,WAAW,WAAW;IAC1B,IAAI,IAAI,OAAO,CAAC,SAAS,CAAC,CAAA;IAC1B,kCAAkC;IAClC,IAAI,IAAI,IAAI,CAAA;CACb;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,GAAE,MAAM,MAAyB,GAAG,WAAW,CAgBxG;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,IAAI,WAAW,CAKhD"}

package/dist/dashboard/quota.js

@@ -0,0 +1,42 @@
+import { QuotaPoller } from '../quota-poller.js';
+import { weekBoundary } from '../quota-boundary.js';
+import { ClaudeCodeDriver } from '@openagt/agent-driver-claude';
+/**
+ * A {@link QuotaSource} backed by a live poller.
+ *
+ * The boundary is measured per read rather than captured: it moves with the clock, so a cached
+ * one would be stale the moment the week's day rolls over. A read costs no reading of the
+ * account: the poller's last good windows are measured again.
+ */
+export function pollerQuotaSource(poller, now = () => Date.now()) {
+    return {
+        stop: () => poller.stop(),
+        read: async () => {
+            const envelope = poller.current();
+            const windows = envelope.lastGood?.windows ?? [];
+            const boundary = weekBoundary(windows, now());
+            const view = {
+                windows,
+                ...(boundary ? { boundary } : {}),
+                ...(envelope.lastGoodAt !== undefined ? { readAt: envelope.lastGoodAt } : {}),
+                ...(envelope.latest && !envelope.latest.available ? { unavailable: envelope.latest.reason } : {}),
+            };
+            return view;
+        },
+    };
+}
+/**
+ * The daemon's own quota source: it polls for the whole life of the dashboard,
+ * not just during an agent, because the panel has to show where the account stands
+ * even when nothing is running.
+ *
+ * Separate from the reading an agent takes for itself: that one dies with the agent, and
+ * nothing stops a running agent over quota anyway. This one exists to draw the bar.
+ */
+export function defaultQuotaSource() {
+    const driver = new ClaudeCodeDriver();
+    const poller = new QuotaPoller({ read: () => driver.readQuota() });
+    poller.start();
+    return pollerQuotaSource(poller);
+}
+//# sourceMappingURL=quota.js.map

package/dist/dashboard/quota.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quota.js","sourceRoot":"","sources":["../../src/dashboard/quota.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAChD,OAAO,EAAE,YAAY,EAAsB,MAAM,sBAAsB,CAAA;AACvE,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAA;AAqC/D;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAmB,EAAE,GAAG,GAAiB,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE;IACzF,OAAO;QACL,IAAI,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE;QACzB,IAAI,EAAE,KAAK,IAAI,EAAE;YACf,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,EAAE,CAAA;YACjC,MAAM,OAAO,GAAG,QAAQ,CAAC,QAAQ,EAAE,OAAO,IAAI,EAAE,CAAA;YAChD,MAAM,QAAQ,GAAG,YAAY,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,CAAA;YAC7C,MAAM,IAAI,GAAc;gBACtB,OAAO;gBACP,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACjC,GAAG,CAAC,QAAQ,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC7E,GAAG,CAAC,QAAQ,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAClG,CAAA;YACD,OAAO,IAAI,CAAA;QACb,CAAC;KACF,CAAA;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB;IAChC,MAAM,MAAM,GAAG,IAAI,gBAAgB,EAAE,CAAA;IACrC,MAAM,MAAM,GAAG,IAAI,WAAW,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,CAAC,CAAA;IAClE,MAAM,CAAC,KAAK,EAAE,CAAA;IACd,OAAO,iBAAiB,CAAC,MAAM,CAAC,CAAA;AAClC,CAAC"}