@openagt/dashboard 0.0.0-stage → 0.8.0

package/dist/publish-levels.d.ts

@@ -0,0 +1,33 @@
+/**
+ * How far a run takes its work when its agent finishes, node-free so every surface shares
+ * one copy: the registry's preference sanitizer, the daemon's Start and the dashboard bundle.
+ * The levels are the words a project's start hook is handed as `PUBLISH`, the ones
+ * `agent-runner run --publish` takes. The launcher's menu offers them after "Nothing", the pick
+ * that hands the hook no level: the run then commits and publishes nothing unless its prompt asks.
+ * Until a person picks, a run goes as far as it can without a pull request: its branch pushed, or
+ * its work committed where the project has no remote.
+ */
+/** The levels a run can be started at, each going further than the one before. */
+export declare const PUBLISH_LEVELS: readonly ['commit', 'branch', 'pr', 'merge'];
+/** A level: commit the work, and from there push the branch, open its pull request, or open it set to merge once its checks pass. */
+export type PublishLevel = (typeof PUBLISH_LEVELS)[number];
+/** What the launcher's menu lists, in its order: nothing, then each level. */
+export declare const PUBLISH_PICKS: readonly ["nothing", "commit", "branch", "pr", "merge"];
+/** A pick of the launcher's menu. */
+export type PublishPick = (typeof PUBLISH_PICKS)[number];
+export declare const PUBLISH_LABELS: Readonly<Record<PublishPick, string>>;
+export declare function isPublishPick(value: unknown): value is PublishPick;
+/**
+ * The picks a project is offered: every one where it has a git host; without a git host no pull
+ * request can be opened, so the picks stop at the branch; without a remote nothing can be
+ * published at all, so they stop at the commit.
+ */
+export declare function offeredPublishPicks(gitHost: boolean, remote?: boolean): readonly PublishPick[];
+/**
+ * The saved pick as this project can hold it: a pick it is not offered falls back to the furthest
+ * it goes with no pull request, which is also the pick in force until a person saves one.
+ */
+export declare function publishPickIn(saved: PublishPick | undefined, gitHost: boolean, remote?: boolean): PublishPick;
+/** The level a pick hands the start hook; none for Nothing. */
+export declare function publishLevelOf(pick: PublishPick): PublishLevel | undefined;
+//# sourceMappingURL=publish-levels.d.ts.map

package/dist/publish-levels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"publish-levels.d.ts","sourceRoot":"","sources":["../src/publish-levels.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,kFAAkF;AAClF,eAAO,MAAM,cAAc,YAAI,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAU,CAAA;AAE1E,qIAAqI;AACrI,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAA;AAE1D,8EAA8E;AAC9E,eAAO,MAAM,aAAa,yDAA0C,CAAA;AAEpE,qCAAqC;AACrC,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAA;AAExD,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAMhE,CAAA;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,CAElE;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,UAAO,GAAG,SAAS,WAAW,EAAE,CAG3F;AAOD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,WAAW,GAAG,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,UAAO,GAAG,WAAW,CAG1G;AAED,+DAA+D;AAC/D,wBAAgB,cAAc,CAAC,IAAI,EAAE,WAAW,GAAG,YAAY,GAAG,SAAS,CAE1E"}

package/dist/publish-levels.js

@@ -0,0 +1,51 @@
+/**
+ * How far a run takes its work when its agent finishes, node-free so every surface shares
+ * one copy: the registry's preference sanitizer, the daemon's Start and the dashboard bundle.
+ * The levels are the words a project's start hook is handed as `PUBLISH`, the ones
+ * `agent-runner run --publish` takes. The launcher's menu offers them after "Nothing", the pick
+ * that hands the hook no level: the run then commits and publishes nothing unless its prompt asks.
+ * Until a person picks, a run goes as far as it can without a pull request: its branch pushed, or
+ * its work committed where the project has no remote.
+ */
+/** The levels a run can be started at, each going further than the one before. */
+export const PUBLISH_LEVELS = ['commit', 'branch', 'pr', 'merge'];
+/** What the launcher's menu lists, in its order: nothing, then each level. */
+export const PUBLISH_PICKS = ['nothing', ...PUBLISH_LEVELS];
+export const PUBLISH_LABELS = {
+    nothing: 'Nothing',
+    commit: 'Commit',
+    branch: 'Publish branch',
+    pr: 'Open PR',
+    merge: 'Merge on green',
+};
+export function isPublishPick(value) {
+    return PUBLISH_PICKS.includes(value);
+}
+/**
+ * The picks a project is offered: every one where it has a git host; without a git host no pull
+ * request can be opened, so the picks stop at the branch; without a remote nothing can be
+ * published at all, so they stop at the commit.
+ */
+export function offeredPublishPicks(gitHost, remote = true) {
+    if (!remote)
+        return ['nothing', 'commit'];
+    return gitHost ? PUBLISH_PICKS : ['nothing', 'commit', 'branch'];
+}
+/** The furthest a project's run goes with no pull request: its branch pushed, or its work committed where there is no remote. */
+function furthestWithoutRequest(remote) {
+    return remote ? 'branch' : 'commit';
+}
+/**
+ * The saved pick as this project can hold it: a pick it is not offered falls back to the furthest
+ * it goes with no pull request, which is also the pick in force until a person saves one.
+ */
+export function publishPickIn(saved, gitHost, remote = true) {
+    if (saved !== undefined && offeredPublishPicks(gitHost, remote).includes(saved))
+        return saved;
+    return furthestWithoutRequest(remote);
+}
+/** The level a pick hands the start hook; none for Nothing. */
+export function publishLevelOf(pick) {
+    return pick === 'nothing' ? undefined : pick;
+}
+//# sourceMappingURL=publish-levels.js.map

package/dist/publish-levels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"publish-levels.js","sourceRoot":"","sources":["../src/publish-levels.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,kFAAkF;AAClF,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAU,CAAA;AAK1E,8EAA8E;AAC9E,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,SAAS,EAAE,GAAG,cAAc,CAAU,CAAA;AAKpE,MAAM,CAAC,MAAM,cAAc,GAA0C;IACnE,OAAO,EAAE,SAAS;IAClB,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,gBAAgB;IACxB,EAAE,EAAE,SAAS;IACb,KAAK,EAAE,gBAAgB;CACxB,CAAA;AAED,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,OAAQ,aAAoC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;AAC9D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAgB,EAAE,MAAM,GAAG,IAAI;IACjE,IAAI,CAAC,MAAM;QAAE,OAAO,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAA;IACzC,OAAO,OAAO,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAA;AAClE,CAAC;AAED,iIAAiI;AACjI,SAAS,sBAAsB,CAAC,MAAe;IAC7C,OAAO,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAA;AACrC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,KAA8B,EAAE,OAAgB,EAAE,MAAM,GAAG,IAAI;IAC3F,IAAI,KAAK,KAAK,SAAS,IAAI,mBAAmB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAA;IAC7F,OAAO,sBAAsB,CAAC,MAAM,CAAC,CAAA;AACvC,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,cAAc,CAAC,IAAiB;IAC9C,OAAO,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAA;AAC9C,CAAC"}

package/dist/queue-promote.d.ts

@@ -0,0 +1,70 @@
+import type { GitRunner } from './project.js';
+/**
+ * Promoting the agent queue out of a finished agent's branch and into the project checkout (#852).
+ *
+ * Runs happen in their own git worktree (#736), which is right for code and wrong for the queue:
+ * `TODO_AGENTS.md` is shared mutable state, and a worktree forks it. So a quick-wins agent (#773)
+ * wrote a perfectly good queue onto a branch nobody reads, auto PM kept seeing an empty checkout,
+ * and it re-derived the same entries every cooldown, forever, spending real quota each time.
+ *
+ * Rom settled the destination on #624: the queue is a durable global `TODO_AGENTS.md` the session
+ * writes directly, unlike a *proposal* (a ticket), which is a PR for a human to accept. So the
+ * queue belongs in the checkout, and nothing should have to be merged by hand for the loop to turn.
+ *
+ * The daemon does this, not the agent. The agent stays sandboxed in its worktree with no write
+ * access to the project checkout; the daemon copies one known file across, and commits only that
+ * pathspec. Narrow enough to audit in a single log line.
+ *
+ * Conservative everywhere it is not certain: anything unexpected skips with a reason and leaves the
+ * checkout untouched. A skipped promotion costs one idle cycle; a wrong one touches a repo a human
+ * is working in.
+ */
+/** Why a promotion did not happen, or that it did. */
+export type QueuePromotion = {
+    promoted: true;
+    branch: string;
+} | {
+    promoted: false;
+    reason: string;
+    /**
+     * Worth trying again next tick: the queue file is mid-edit in the checkout, and the human's
+     * work outranks an unattended tidy-up only until they commit it. Every other skip is final
+     * for this agent. The callee owns this call — the daemon used to decide it by string-matching
+     * the prose `reason`, where a one-word copyedit would have silently turned "retry next
+     * tick" into "settled forever".
+     */
+    retry?: true;
+};
+/**
+ * Copy `TODO_AGENTS.md` from a finished agent's branch into the project checkout and commit it.
+ *
+ * Skips, rather than forcing, when:
+ * - the agent recorded no branch (nothing to read from)
+ * - the branch has no queue file, or it matches the checkout already (nothing to do)
+ * - the checkout has uncommitted changes to the queue file — a human is mid-edit, and their work
+ *   outranks an unattended tidy-up
+ *
+ * Never throws: this runs on a background tick with nothing to catch it.
+ */
+export declare function promoteQueue(projectCwd: string, agent: {
+    id: string;
+    branch?: string | undefined;
+    entry?: string | undefined;
+}, git?: GitRunner, write?: (path: string, content: string) => Promise<void>): Promise<QueuePromotion>;
+/**
+ * Land what a drain agent pinned to one entry actually did (#1204): retire that entry, and keep any
+ * follow-ups it queued.
+ *
+ * Additive by construction, which is what makes it safe to run concurrently: it only ever checks a
+ * box or appends a line. It never unchecks, never removes, and never reorders, so two drains
+ * landing in either order compose, and the worst a wrong guess can do is leave a duplicate line
+ * for a human to delete rather than silently send an agent to redo finished work.
+ *
+ * A follow-up is an entry the agent's branch has that `atBase` did not: written during the agent. The
+ * fork point is what tells that from an entry somebody *removed* meanwhile, which looks identical
+ * from the branch alone and which `todo_format.md` makes the ordinary way to retire an entry. With
+ * no fork point to compare against, nothing is added -- resurrecting struck-off work is worse than
+ * leaving a follow-up on the branch, and the check-off still lands either way.
+ */
+export declare function landPinnedEntry(inCheckout: string, fromBranch: string, entry: string, atBase: string | undefined): string;
+//# sourceMappingURL=queue-promote.d.ts.map

package/dist/queue-promote.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-promote.d.ts","sourceRoot":"","sources":["../src/queue-promote.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAK7C;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,sDAAsD;AACtD,MAAM,MAAM,cAAc,GACtB;IAAE,QAAQ,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAClC;IACE,QAAQ,EAAE,KAAK,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,IAAI,CAAA;CACb,CAAA;AAOL;;;;;;;;;;GAUG;AACH,wBAAsB,YAAY,CAChC,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,EAC9E,GAAG,GAAE,SAA2B,EAChC,KAAK,GAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAuD,GAC5G,OAAO,CAAC,cAAc,CAAC,CA+CzB;AAeD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe,CAC7B,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GAAG,SAAS,GACzB,MAAM,CAmBR"}

package/dist/queue-promote.js

@@ -0,0 +1,118 @@
+import { writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { nodeGitRunner } from './project.js';
+import { FLAT_TODO_FILE } from './tickets.js';
+import { errorMessage } from './error-message.js';
+/** The commit message a promotion writes. Names the agent so the history says where it came from. */
+function promotionMessage(agentId) {
+    return `[The Framework] queue updates from ${agentId}`;
+}
+/**
+ * Copy `TODO_AGENTS.md` from a finished agent's branch into the project checkout and commit it.
+ *
+ * Skips, rather than forcing, when:
+ * - the agent recorded no branch (nothing to read from)
+ * - the branch has no queue file, or it matches the checkout already (nothing to do)
+ * - the checkout has uncommitted changes to the queue file — a human is mid-edit, and their work
+ *   outranks an unattended tidy-up
+ *
+ * Never throws: this runs on a background tick with nothing to catch it.
+ */
+export async function promoteQueue(projectCwd, agent, git = nodeGitRunner(), write = (path, content) => writeFile(path, content, 'utf8')) {
+    const branch = agent.branch;
+    if (!branch)
+        return { promoted: false, reason: 'the run recorded no branch' };
+    try {
+        // The queue as the agent left it. An agent that never touched it has no such path on the branch.
+        const fromBranch = await git(['show', `${branch}:${FLAT_TODO_FILE}`], projectCwd).catch(() => undefined);
+        if (fromBranch === undefined)
+            return { promoted: false, reason: 'the run left no queue file on its branch' };
+        const inCheckout = await git(['show', `HEAD:${FLAT_TODO_FILE}`], projectCwd).catch(() => '');
+        if (fromBranch === inCheckout)
+            return { promoted: false, reason: 'the queue is already up to date' };
+        // A dirty queue file means someone is editing it by hand right now. Leave it alone; the next
+        // tick will try again, and until then auto PM simply does not start more work.
+        const dirty = (await git(['status', '--porcelain', '--', FLAT_TODO_FILE], projectCwd)).trim();
+        if (dirty)
+            return { promoted: false, reason: 'the checkout has uncommitted queue changes', retry: true };
+        // An agent pinned to one entry (#1204) lands that entry, not its whole file: with several drains
+        // in flight the wholesale copy below would carry each agent's stale view of every *other* entry,
+        // and the last promotion of the tick would un-check whatever the earlier ones had just retired.
+        if (agent.entry !== undefined) {
+            // The queue where the agent forked, so an entry it *added* can be told from one somebody
+            // *removed* while it worked. Both look alike from the branch alone — present there, absent
+            // here — and `todo_format.md` makes removal the way to retire an entry, so guessing wrong
+            // resurrects work a human deliberately struck off. No merge base (a rewritten history, say)
+            // means no additions land: the check-off is the part that must not be lost.
+            const mergeBase = (await git(['merge-base', branch, 'HEAD'], projectCwd).catch(() => '')).trim();
+            const atBase = mergeBase
+                ? await git(['show', `${mergeBase}:${FLAT_TODO_FILE}`], projectCwd).catch(() => undefined)
+                : undefined;
+            const landed = landPinnedEntry(inCheckout, fromBranch, agent.entry, atBase);
+            if (landed === inCheckout)
+                return { promoted: false, reason: 'the run left nothing to land on the queue' };
+            await write(join(projectCwd, FLAT_TODO_FILE), landed);
+            await git(['add', '--', FLAT_TODO_FILE], projectCwd);
+            await git(['commit', '-m', promotionMessage(agent.id), '--', FLAT_TODO_FILE], projectCwd);
+            return { promoted: true, branch };
+        }
+        // `checkout <branch> -- <path>` writes the file and stages it in one step, touching nothing
+        // else in the tree. The commit is pathspec-scoped for the same reason: whatever else is
+        // staged in the user's checkout is theirs and must not ride along.
+        await git(['checkout', branch, '--', FLAT_TODO_FILE], projectCwd);
+        await git(['commit', '-m', promotionMessage(agent.id), '--', FLAT_TODO_FILE], projectCwd);
+        return { promoted: true, branch };
+    }
+    catch (err) {
+        return { promoted: false, reason: errorMessage(err) };
+    }
+}
+/** One markdown list item, by the grammar `parseTodoEntries` reads. */
+const ENTRY_LINE = /^(\s*(?:[-*]|\d+\.)\s+)(?:\[([ xX])\]\s*)?(.*)$/;
+/** Every entry the document names, checked or not, so a re-add can tell "new" from "already there". */
+function entryTexts(md) {
+    const texts = new Set();
+    for (const line of md.split('\n')) {
+        const text = ENTRY_LINE.exec(line)?.[3]?.trim();
+        if (text)
+            texts.add(text);
+    }
+    return texts;
+}
+/**
+ * Land what a drain agent pinned to one entry actually did (#1204): retire that entry, and keep any
+ * follow-ups it queued.
+ *
+ * Additive by construction, which is what makes it safe to run concurrently: it only ever checks a
+ * box or appends a line. It never unchecks, never removes, and never reorders, so two drains
+ * landing in either order compose, and the worst a wrong guess can do is leave a duplicate line
+ * for a human to delete rather than silently send an agent to redo finished work.
+ *
+ * A follow-up is an entry the agent's branch has that `atBase` did not: written during the agent. The
+ * fork point is what tells that from an entry somebody *removed* meanwhile, which looks identical
+ * from the branch alone and which `todo_format.md` makes the ordinary way to retire an entry. With
+ * no fork point to compare against, nothing is added -- resurrecting struck-off work is worse than
+ * leaving a follow-up on the branch, and the check-off still lands either way.
+ */
+export function landPinnedEntry(inCheckout, fromBranch, entry, atBase) {
+    const lines = inCheckout.split('\n').map(line => {
+        const item = ENTRY_LINE.exec(line);
+        // Retire any *open* entry that matches — an empty `[ ]` box or a no-checkbox bullet alike,
+        // the same "open" grammar `parseTodoEntries` uses (#1164/#1297).
+        // Skipping the no-checkbox form left it open, so the sweep re-drained it after the PR closed.
+        if (!item || item[3]?.trim() !== entry || item[2] === 'x' || item[2] === 'X')
+            return line;
+        return `${item[1]}[x] ${item[3].trim()}`;
+    });
+    if (atBase === undefined)
+        return lines.join('\n');
+    const known = entryTexts(inCheckout);
+    const base = entryTexts(atBase);
+    const added = [...entryTexts(fromBranch)].filter(text => !known.has(text) && !base.has(text));
+    if (!added.length)
+        return lines.join('\n');
+    const body = lines.join('\n');
+    const separator = body === '' || body.endsWith('\n') ? '' : '\n';
+    return `${body}${separator}${added.map(text => `- [ ] ${text}`).join('\n')}\n`;
+}
+//# sourceMappingURL=queue-promote.js.map

package/dist/queue-promote.js.map

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

package/dist/quota-boundary.d.ts

@@ -0,0 +1,65 @@
+/**
+ * The quota boundary (#879): how much of the account's week The Framework may
+ * have spent by now.
+ *
+ * The whole policy is one line — the boundary is the pro-rated share of the week's allowance that
+ * has elapsed, rising continuously with the clock rather than once a day (#960 Edit) — and it
+ * replaces the configurable limits of #519. There is nothing to configure: the boundary is derived
+ * from the account's own week, which the agent reports.
+ *
+ * Nothing is left on the floor: the boundary rises on its own and reaches the full allowance
+ * exactly as the week resets, so a quiet week still gets spent rather than expiring.
+ *
+ * The Framework only draws it. Whether work stops at it, or how far past it, is the business of
+ * whatever starts unattended work, which puts its own stop line on the usage bar.
+ */
+import type { DriverQuotaWindow } from '@openagt/agent-driver';
+/** The quota week, in ms. */
+export declare const QUOTA_WEEK_MS: number;
+/** Where the boundary sits, and the week it is derived from. */
+export interface QuotaBoundary {
+    /** When the current quota week began, epoch ms. */
+    startsAt: number;
+    /** When it resets, epoch ms. */
+    resetsAt: number;
+    /** Which day of the week we are on, 1-7. */
+    day: number;
+    /** The share of the week's allowance that may be spent by now, 0-100. */
+    percent: number;
+}
+/**
+ * Parse the agent's reset prose into an epoch.
+ *
+ * The agent prints no year (`Jul 25 at 7am (Asia/Jerusalem)`), which is why the
+ * driver keeps this as text. It is recoverable here because we know something
+ * the driver does not: a *weekly* window resets within seven days, so of the
+ * candidate years exactly one lands anywhere near now.
+ *
+ * `undefined` for anything that does not parse, which the callers treat as "we
+ * do not know where the week is" rather than as a boundary of zero.
+ */
+export declare function parseResetsAt(text: string, now: number): number | undefined;
+/**
+ * Where the boundary sits, given when the week resets.
+ *
+ * `percent` is continuous — the plain elapsed share of the week (#960 Edit) — rather than a value
+ * that jumps once a day, so it always names the actual instant `now` falls on, on any axis that
+ * measures the week the same way. A stepped version once unlocked a whole day's allowance the
+ * moment a new day began (including the entire week's worth on the last day), which read as
+ * generous on paper but let a burst of spending land the instant the clock ticked over rather than
+ * pacing with it; continuous keeps the line honest about what has actually elapsed at the cost of
+ * that burst.
+ *
+ * `day` is 1-based and still names which day of the week `now` falls on — for callers that want to
+ * say "day 4 of 7" rather than a percentage — and steps at the exact second the week's own day
+ * rolls over, independently of `percent`.
+ */
+export declare function boundaryFromResetsAt(resetsAt: number, now: number): QuotaBoundary;
+/**
+ * Where the boundary sits for the account's own week, as the agent reported it (#879).
+ *
+ * `undefined` when there is no reading of the week, or when its reset cannot be placed. That is
+ * "we do not know", never a boundary of zero.
+ */
+export declare function weekBoundary(windows: readonly DriverQuotaWindow[], now: number): QuotaBoundary | undefined;
+//# sourceMappingURL=quota-boundary.d.ts.map

package/dist/quota-boundary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quota-boundary.d.ts","sourceRoot":"","sources":["../src/quota-boundary.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AAE9D,6BAA6B;AAC7B,eAAO,MAAM,aAAa,QAA0B,CAAA;AAQpD,gEAAgE;AAChE,MAAM,WAAW,aAAa;IAC5B,mDAAmD;IACnD,QAAQ,EAAE,MAAM,CAAA;IAChB,gCAAgC;IAChC,QAAQ,EAAE,MAAM,CAAA;IAChB,4CAA4C;IAC5C,GAAG,EAAE,MAAM,CAAA;IACX,yEAAyE;IACzE,OAAO,EAAE,MAAM,CAAA;CAChB;AAuCD;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CA6B3E;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,aAAa,CAKjF;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,SAAS,iBAAiB,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAK1G"}

package/dist/quota-boundary.js

@@ -0,0 +1,135 @@
+/**
+ * The quota boundary (#879): how much of the account's week The Framework may
+ * have spent by now.
+ *
+ * The whole policy is one line — the boundary is the pro-rated share of the week's allowance that
+ * has elapsed, rising continuously with the clock rather than once a day (#960 Edit) — and it
+ * replaces the configurable limits of #519. There is nothing to configure: the boundary is derived
+ * from the account's own week, which the agent reports.
+ *
+ * Nothing is left on the floor: the boundary rises on its own and reaches the full allowance
+ * exactly as the week resets, so a quiet week still gets spent rather than expiring.
+ *
+ * The Framework only draws it. Whether work stops at it, or how far past it, is the business of
+ * whatever starts unattended work, which puts its own stop line on the usage bar.
+ */
+/** The quota week, in ms. */
+export const QUOTA_WEEK_MS = 7 * 24 * 60 * 60 * 1000;
+/** A day of it, in ms. */
+const ONE_DAY_MS = 24 * 60 * 60 * 1000;
+/** Days in the quota week, i.e. the denominator of `n/7`. */
+const WEEK_DAYS = 7;
+const MONTHS = ['jan', 'feb', 'mar', 'apr', 'may', 'jun', 'jul', 'aug', 'sep', 'oct', 'nov', 'dec'];
+/**
+ * `Jul 25 at 7am (Asia/Jerusalem)`, with the minutes and the zone both optional. Newer Claude
+ * Code prints a comma where older versions print `at` — `Jul 25, 7am` — and both are in the wild.
+ */
+const RESETS_AT = /^([a-z]{3})\s+(\d{1,2})(?:\s+at\s+|,\s*)(\d{1,2})(?::(\d{2}))?\s*(am|pm)\s*(?:\(([^)]+)\))?$/i;
+/** How far `zone` is ahead of UTC at `at`, in ms. */
+function zoneOffsetMs(at, zone) {
+    const parts = new Intl.DateTimeFormat('en-US', {
+        timeZone: zone,
+        hour12: false,
+        year: 'numeric',
+        month: '2-digit',
+        day: '2-digit',
+        hour: '2-digit',
+        minute: '2-digit',
+        second: '2-digit',
+    }).formatToParts(at);
+    const read = (type) => Number(parts.find(p => p.type === type)?.value);
+    // `hour: '2-digit'` with hour12 off prints midnight as 24 in some runtimes.
+    const hour = read('hour') % 24;
+    const asUtc = Date.UTC(read('year'), read('month') - 1, read('day'), hour, read('minute'), read('second'));
+    return asUtc - at;
+}
+/** The epoch of a wall-clock time in `zone`, resolving the offset at that instant rather than now. */
+function zonedTimeToEpoch(year, month, day, hour, minute, zone) {
+    const wall = Date.UTC(year, month - 1, day, hour, minute);
+    const first = wall - zoneOffsetMs(wall, zone);
+    // One correction settles it: the first guess is only wrong when it landed on
+    // the far side of a DST change, and the second offset is the right one.
+    const second = wall - zoneOffsetMs(first, zone);
+    return second;
+}
+/**
+ * Parse the agent's reset prose into an epoch.
+ *
+ * The agent prints no year (`Jul 25 at 7am (Asia/Jerusalem)`), which is why the
+ * driver keeps this as text. It is recoverable here because we know something
+ * the driver does not: a *weekly* window resets within seven days, so of the
+ * candidate years exactly one lands anywhere near now.
+ *
+ * `undefined` for anything that does not parse, which the callers treat as "we
+ * do not know where the week is" rather than as a boundary of zero.
+ */
+export function parseResetsAt(text, now) {
+    const match = RESETS_AT.exec(text.trim());
+    if (!match)
+        return undefined;
+    const [, monthName, dayText, hourText, minuteText, meridiem, zoneText] = match;
+    const month = MONTHS.indexOf((monthName ?? '').toLowerCase()) + 1;
+    if (month === 0)
+        return undefined;
+    const day = Number(dayText);
+    const hour12 = Number(hourText);
+    if (hour12 < 1 || hour12 > 12)
+        return undefined;
+    const hour = (hour12 % 12) + ((meridiem ?? '').toLowerCase() === 'pm' ? 12 : 0);
+    const minute = minuteText === undefined ? 0 : Number(minuteText);
+    const zone = zoneText?.trim() || Intl.DateTimeFormat().resolvedOptions().timeZone;
+    const nowYear = new Date(now).getUTCFullYear();
+    let best;
+    for (const year of [nowYear - 1, nowYear, nowYear + 1]) {
+        let at;
+        try {
+            at = zonedTimeToEpoch(year, month, day, hour, minute, zone);
+        }
+        catch {
+            // An unknown zone name. Nothing to fall back to that wouldn't be a guess.
+            return undefined;
+        }
+        // Feb 29 in a non-leap year rolls into March; that candidate isn't the date
+        // the agent printed.
+        if (new Date(at + zoneOffsetMs(at, zone)).getUTCDate() !== day)
+            continue;
+        if (best === undefined || Math.abs(at - now) < Math.abs(best - now))
+            best = at;
+    }
+    return best;
+}
+/**
+ * Where the boundary sits, given when the week resets.
+ *
+ * `percent` is continuous — the plain elapsed share of the week (#960 Edit) — rather than a value
+ * that jumps once a day, so it always names the actual instant `now` falls on, on any axis that
+ * measures the week the same way. A stepped version once unlocked a whole day's allowance the
+ * moment a new day began (including the entire week's worth on the last day), which read as
+ * generous on paper but let a burst of spending land the instant the clock ticked over rather than
+ * pacing with it; continuous keeps the line honest about what has actually elapsed at the cost of
+ * that burst.
+ *
+ * `day` is 1-based and still names which day of the week `now` falls on — for callers that want to
+ * say "day 4 of 7" rather than a percentage — and steps at the exact second the week's own day
+ * rolls over, independently of `percent`.
+ */
+export function boundaryFromResetsAt(resetsAt, now) {
+    const startsAt = resetsAt - QUOTA_WEEK_MS;
+    const elapsedMs = Math.min(Math.max(now - startsAt, 0), QUOTA_WEEK_MS);
+    const day = Math.min(WEEK_DAYS, Math.floor(elapsedMs / ONE_DAY_MS) + 1);
+    return { startsAt, resetsAt, day, percent: (elapsedMs / QUOTA_WEEK_MS) * 100 };
+}
+/**
+ * Where the boundary sits for the account's own week, as the agent reported it (#879).
+ *
+ * `undefined` when there is no reading of the week, or when its reset cannot be placed. That is
+ * "we do not know", never a boundary of zero.
+ */
+export function weekBoundary(windows, now) {
+    const week = windows.find(w => w.kind === 'week');
+    if (!week?.resetsAtText)
+        return undefined;
+    const resetsAt = parseResetsAt(week.resetsAtText, now);
+    return resetsAt === undefined ? undefined : boundaryFromResetsAt(resetsAt, now);
+}
+//# sourceMappingURL=quota-boundary.js.map

package/dist/quota-boundary.js.map

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

package/dist/quota-poller.d.ts

@@ -0,0 +1,83 @@
+import { type DriverQuota } from '@openagt/agent-driver';
+/**
+ * How often to read the quota when everything is healthy. A read spawns the
+ * whole agent CLI (~5s), and the agent's own usage fetch is refused upstream if
+ * asked too often, so this is deliberately slow: the boundary moves over days,
+ * which a 5-minute sample rate resolves comfortably.
+ */
+export declare const DEFAULT_POLL_MS: number;
+/** Longest gap between reads once backoff has stretched it. */
+export declare const MAX_POLL_MS: number;
+/**
+ * What the poller currently believes about the account's quota.
+ *
+ * `latest` is the last attempt as it came back; `lastGood` is the last real
+ * reading. The two are separate so a transient blip doesn't blank a number that
+ * was accurate a minute ago — a bar going empty reads as "nothing used", which
+ * is the one thing this feature must never imply.
+ */
+export interface QuotaEnvelope {
+    /** The most recent attempt, exactly as it came back. `undefined` before the first. */
+    latest: DriverQuota | undefined;
+    /** The most recent successful reading, retained across transient failures. */
+    lastGood: (DriverQuota & {
+        available: true;
+    }) | undefined;
+    /** When {@link lastGood} was read, epoch ms. */
+    lastGoodAt: number | undefined;
+    /** When the last failure happened, epoch ms. */
+    lastFailureAt: number | undefined;
+}
+/** Options for {@link QuotaPoller}. */
+export interface QuotaPollerOptions {
+    /** Read the quota once. Normally `driver.readQuota`. */
+    read: () => Promise<DriverQuota>;
+    /** Healthy interval. Default {@link DEFAULT_POLL_MS}. */
+    intervalMs?: number;
+    /** Ceiling for the backed-off interval. Default {@link MAX_POLL_MS}. */
+    maxIntervalMs?: number;
+    /** Clock, injectable for tests. */
+    now?: () => number;
+}
+/**
+ * Keeps a recent quota reading on hand (#525).
+ *
+ * Polling is slow by design and backs *off* on failure rather than retrying
+ * into it: the agent's usage fetch is refused upstream when asked too often,
+ * and the penalty window is minutes long, so an eager retry loop would keep the
+ * number permanently unavailable — the opposite of the goal.
+ */
+export declare class QuotaPoller {
+    private readonly opts;
+    private envelope;
+    private timer;
+    private running;
+    private currentIntervalMs;
+    private stopped;
+    private readonly now;
+    constructor(opts: QuotaPollerOptions);
+    /** What we currently believe. */
+    current(): QuotaEnvelope;
+    /** The gap before the next read, which grows while the fetch keeps being refused. */
+    get intervalMs(): number;
+    /** Whether the poller has given up (an authoritative failure, or {@link stop}). */
+    get isStopped(): boolean;
+    /**
+     * Read once, now, and fold the result in. Safe to call on demand (e.g. right
+     * after a turn settles) alongside the timer.
+     */
+    poll(): Promise<DriverQuota>;
+    /**
+     * Begin polling, starting with a read right now rather than one interval from
+     * now: a poller whose first reading lands five minutes in is no use to an agent
+     * that just started, and the session's own measurement needs a baseline. Not
+     * awaited — the read takes ~5s and nothing should wait on it. Idempotent.
+     */
+    start(): void;
+    /** Stop polling. Idempotent. */
+    stop(): void;
+    private onGood;
+    private onBad;
+    private schedule;
+}
+//# sourceMappingURL=quota-poller.d.ts.map

package/dist/quota-poller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quota-poller.d.ts","sourceRoot":"","sources":["../src/quota-poller.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0B,KAAK,WAAW,EAAqC,MAAM,uBAAuB,CAAA;AAEnH;;;;;GAKG;AACH,eAAO,MAAM,eAAe,QAAgB,CAAA;AAE5C,+DAA+D;AAC/D,eAAO,MAAM,WAAW,QAAiB,CAAA;AAEzC;;;;;;;GAOG;AACH,MAAM,WAAW,aAAa;IAC5B,sFAAsF;IACtF,MAAM,EAAE,WAAW,GAAG,SAAS,CAAA;IAC/B,8EAA8E;IAC9E,QAAQ,EAAE,CAAC,WAAW,GAAG;QAAE,SAAS,EAAE,IAAI,CAAA;KAAE,CAAC,GAAG,SAAS,CAAA;IACzD,gDAAgD;IAChD,UAAU,EAAE,MAAM,GAAG,SAAS,CAAA;IAC9B,gDAAgD;IAChD,aAAa,EAAE,MAAM,GAAG,SAAS,CAAA;CAClC;AAED,uCAAuC;AACvC,MAAM,WAAW,kBAAkB;IACjC,wDAAwD;IACxD,IAAI,EAAE,MAAM,OAAO,CAAC,WAAW,CAAC,CAAA;IAChC,yDAAyD;IACzD,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,wEAAwE;IACxE,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,mCAAmC;IACnC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;CACnB;AAED;;;;;;;GAOG;AACH,qBAAa,WAAW;IAQV,OAAO,CAAC,QAAQ,CAAC,IAAI;IAPjC,OAAO,CAAC,QAAQ,CAA6G;IAC7H,OAAO,CAAC,KAAK,CAA2C;IACxD,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,iBAAiB,CAAQ;IACjC,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAc;IAElC,YAA6B,IAAI,EAAE,kBAAkB,EAGpD;IAED,iCAAiC;IACjC,OAAO,IAAI,aAAa,CAEvB;IAED,qFAAqF;IACrF,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED,mFAAmF;IACnF,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,WAAW,CAAC,CAgBjC;IAED;;;;;OAKG;IACH,KAAK,IAAI,IAAI,CAIZ;IAED,gCAAgC;IAChC,IAAI,IAAI,IAAI,CAKX;IAED,OAAO,CAAC,MAAM;IAMd,OAAO,CAAC,KAAK;IAab,OAAO,CAAC,QAAQ;CAYjB"}