@openagt/dashboard 0.8.0 → 0.9.0

package/dist/consumption-guard.js

@@ -1,69 +0,0 @@
-import { QuotaPoller } from './quota-poller.js';
-import { quotaBoundaryStatus } from './quota-boundary.js';
-import { DEFAULT_SPEND_OFFSET } from './preference-defaults.js';
-/**
- * Wire the quota boundary up for one run (#879): poll the agent's quota, and
- * hand back the gate a run consults between turns.
- *
- * The boundary is derived from the account's own week, so there is nothing to
- * configure and nothing to remember between restarts: it is a comparison of two
- * numbers the agent reports, not a total we accumulate.
- *
- * Resolves `undefined` when there is nothing to guard with — the agent can't
- * report a quota at all (the fake driver, or a second agent that has no such
- * command). That is the fail-open Rom confirmed on #519: no reading means the
- * work carries on, with the per-run budget cap still underneath it. The gate
- * itself fails open for the same reason, which is the opposite of the auto-PM
- * gate: this one guards work the user asked for.
- *
- * The first read is deliberately not awaited. It takes ~5s (it spawns the whole
- * agent CLI), and making every run wait that long to *maybe* find out it has
- * budget would be a poor trade. It lands a moment into the run instead.
- */
-export function startConsumptionGuard(opts) {
-    const readQuota = opts.driver.readQuota?.bind(opts.driver);
-    if (!readQuota)
-        return undefined;
-    const now = opts.now ?? (() => Date.now());
-    const poller = new QuotaPoller({ read: () => readQuota(), now });
-    poller.start();
-    // The slider's latest resolved value. The gate stays synchronous — it answers from cached
-    // readings — so the offset is refreshed in the background around each check and the check
-    // uses the last value that landed: one turn behind at worst, which is also how fresh the
-    // quota reading itself is.
-    let userOffset = DEFAULT_SPEND_OFFSET;
-    const refreshOffset = () => {
-        if (!opts.limitOffset)
-            return;
-        void Promise.resolve()
-            .then(opts.limitOffset)
-            .then(value => {
-            if (Number.isFinite(value))
-                userOffset = value;
-        })
-            .catch(() => { }); // an unreadable registry means the default policy
-    };
-    refreshOffset();
-    return {
-        poller,
-        stop: () => poller.stop(),
-        gate: () => {
-            refreshOffset();
-            const windows = poller.current().lastGood?.windows;
-            if (!windows)
-                return null;
-            // The same half-day cushion unattended work gets by default (#960 Edit). The continuous
-            // boundary starts the week at zero, so without one the first integer percent the agent
-            // reports outruns it and the user's own first run of the week is paused over ordinary
-            // rounding — the stepped line this replaces always kept the current day's seventh in hand.
-            // The user's slider joins the gate only when it LOOSENS it (#1490): raising the limit must
-            // unblock the runs the Usage bar says have room — the bar and this gate disagreeing is the
-            // exact thing #960 forbids — but lowering it sets where *unattended* work stands down, and
-            // holding it back must never tighten the gate on work the user asked for.
-            const limitOffset = Math.max(DEFAULT_SPEND_OFFSET, userOffset);
-            const status = quotaBoundaryStatus({ windows, now: now(), limitOffset, ...(opts.model ? { model: opts.model } : {}) });
-            return status?.reached?.label ?? null;
-        },
-    };
-}
-//# sourceMappingURL=consumption-guard.js.map

package/dist/consumption-guard.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"consumption-guard.js","sourceRoot":"","sources":["../src/consumption-guard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAA;AAmC/D;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAAkC;IACtE,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;IAC1D,IAAI,CAAC,SAAS;QAAE,OAAO,SAAS,CAAA;IAEhC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAA;IAC1C,MAAM,MAAM,GAAG,IAAI,WAAW,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,SAAS,EAAE,EAAE,GAAG,EAAE,CAAC,CAAA;IAChE,MAAM,CAAC,KAAK,EAAE,CAAA;IAEd,0FAA0F;IAC1F,0FAA0F;IAC1F,yFAAyF;IACzF,2BAA2B;IAC3B,IAAI,UAAU,GAAG,oBAAoB,CAAA;IACrC,MAAM,aAAa,GAAG,GAAG,EAAE;QACzB,IAAI,CAAC,IAAI,CAAC,WAAW;YAAE,OAAM;QAC7B,KAAK,OAAO,CAAC,OAAO,EAAE;aACnB,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC;aACtB,IAAI,CAAC,KAAK,CAAC,EAAE;YACZ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;gBAAE,UAAU,GAAG,KAAK,CAAA;QAChD,CAAC,CAAC;aACD,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA,CAAC,kDAAkD;IACvE,CAAC,CAAA;IACD,aAAa,EAAE,CAAA;IAEf,OAAO;QACL,MAAM;QACN,IAAI,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE;QACzB,IAAI,EAAE,GAAG,EAAE;YACT,aAAa,EAAE,CAAA;YACf,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAA;YAClD,IAAI,CAAC,OAAO;gBAAE,OAAO,IAAI,CAAA;YACzB,wFAAwF;YACxF,uFAAuF;YACvF,sFAAsF;YACtF,2FAA2F;YAC3F,2FAA2F;YAC3F,2FAA2F;YAC3F,2FAA2F;YAC3F,0EAA0E;YAC1E,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,oBAAoB,EAAE,UAAU,CAAC,CAAA;YAC9D,MAAM,MAAM,GAAG,mBAAmB,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,WAAW,EAAE,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAA;YACtH,OAAO,MAAM,EAAE,OAAO,EAAE,KAAK,IAAI,IAAI,CAAA;QACvC,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/control.d.ts

@@ -1,75 +0,0 @@
-import type { ChoiceBy } from './events.js';
-import { type HandoffLevel } from './handoff-level.js';
-/**
- * The dashboard-to-agent control channel (#344): the reverse of the event log.
- * Events flow run -> `.the-framework/events.jsonl` -> daemon -> browser; steering
- * flows browser -> daemon -> `.the-framework/control.jsonl` -> run. The daemon
- * appends a {@link ControlEntry} per choice pick / message, and the agent tails
- * the file, resolving its parked gate. Same file-is-the-seam design
- * as the forward direction — no run<->daemon IPC.
- */
-/** The control log filename under `.the-framework/`. */
-export declare const CONTROL_FILE = "control.jsonl";
-/**
- * One steering instruction from the dashboard to the live agent. Stop is not one: it is a
- * signal to the agent's process, whose pid the agent's meta names (`dashboard-rpc/control.ts`).
- */
-export type ControlEntry = 
-/** Resolve a parked choice gate: the pick for the pending {@link ChoiceRequest} id. */
-{
-    kind: 'choice';
-    id: string;
-    pick: string | string[];
-    by: ChoiceBy;
-}
-/** A live-chat message the user sent to the running agent (#714). */
- | {
-    kind: 'message';
-    text: string;
-}
-/**
- * Move the end-of-session handoff (#1102): how far this session publishes itself when it
- * finishes — keep it local, push the branch, open a PR, merge it.
- *
- * One rung rather than a pair of booleans (B5): a surface offering checkboxes converts on its
- * side, so an impossible answer resolves *down* there instead of arriving here as "a PR with no
- * push" for this end to repair upward.
- *
- * Steering rather than an event because it is an instruction to the agent, and it has to reach a
- * run whose dashboard tab was opened after it started. The agent echoes what it applied back as an
- * event, which is what puts it on the meta the checkboxes read.
- */
- | {
-    kind: 'handoff';
-    level: HandoffLevel;
-}
-/**
- * The user's Merge action on a live session (#1391): arm the full publish ladder and record that
- * a human authorized the merge, so the merge gate (#1363) does not also demand the agent's
- * ready-for-merge signal — a human's word outranks it. The session still merges at its own end
- * (it ends itself once nothing needs a human, #1390); this is a pre-commitment, not an abort.
- */
- | {
-    kind: 'merge';
-};
-/** The control log path for a workspace. */
-export declare function controlPath(cwd: string): string;
-/** Append one entry to the workspace's control log, creating it as needed. */
-export declare function appendControl(cwd: string, entry: ControlEntry): Promise<void>;
-/**
- * Truncate the control log. An agent calls this at start so a previous agent's picks
- * can never fire into this one (gate ids like `plan-approval` repeat across runs).
- */
-export declare function resetControl(cwd: string): Promise<void>;
-/** A live control tail. {@link close} stops watching (idempotent). */
-export interface ControlWatcher {
-    close(): void;
-}
-/**
- * Tail the workspace's control log, dispatching each well-formed entry as it is
- * appended. An `fs.watch` on `.the-framework/` plus a poll backstop, mirroring the
- * daemon's event tail (`fs.watch` is unreliable across platforms). Malformed or
- * unknown lines are skipped so a bad write can never crash an agent.
- */
-export declare function watchControl(cwd: string, onEntry: (entry: ControlEntry) => void, pollMs?: number): ControlWatcher;
-//# sourceMappingURL=control.d.ts.map

package/dist/control.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"control.d.ts","sourceRoot":"","sources":["../src/control.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAC3C,OAAO,EAAkB,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAItE;;;;;;;GAOG;AAEH,wDAAwD;AACxD,eAAO,MAAM,YAAY,kBAAkB,CAAA;AAE3C;;;GAGG;AACH,MAAM,MAAM,YAAY;AACtB,uFAAuF;AACrF;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAAC,EAAE,EAAE,QAAQ,CAAA;CAAE;AACvE,qEAAqE;GACnE;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE;AACnC;;;;;;;;;;;GAWG;GACD;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,YAAY,CAAA;CAAE;AAC1C;;;;;GAKG;GACD;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,CAAA;AAErB,4CAA4C;AAC5C,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,8EAA8E;AAC9E,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAGnF;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAG7D;AAED,sEAAsE;AACtE,MAAM,WAAW,cAAc;IAC7B,KAAK,IAAI,IAAI,CAAA;CACd;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,EACtC,MAAM,SAAM,GACX,cAAc,CAOhB"}

package/dist/control.js

@@ -1,68 +0,0 @@
-import { appendFile, mkdir, writeFile } from 'node:fs/promises';
-import { join } from 'node:path';
-import { isHandoffLevel } from './handoff-level.js';
-import { THE_FRAMEWORK_DIR } from './framework-dir.js';
-import { JsonlTailer, followFile } from './jsonl-tail.js';
-/**
- * The dashboard-to-agent control channel (#344): the reverse of the event log.
- * Events flow run -> `.the-framework/events.jsonl` -> daemon -> browser; steering
- * flows browser -> daemon -> `.the-framework/control.jsonl` -> run. The daemon
- * appends a {@link ControlEntry} per choice pick / message, and the agent tails
- * the file, resolving its parked gate. Same file-is-the-seam design
- * as the forward direction — no run<->daemon IPC.
- */
-/** The control log filename under `.the-framework/`. */
-export const CONTROL_FILE = 'control.jsonl';
-/** The control log path for a workspace. */
-export function controlPath(cwd) {
-    return join(cwd, THE_FRAMEWORK_DIR, CONTROL_FILE);
-}
-/** Append one entry to the workspace's control log, creating it as needed. */
-export async function appendControl(cwd, entry) {
-    await mkdir(join(cwd, THE_FRAMEWORK_DIR), { recursive: true });
-    await appendFile(controlPath(cwd), JSON.stringify(entry) + '\n');
-}
-/**
- * Truncate the control log. An agent calls this at start so a previous agent's picks
- * can never fire into this one (gate ids like `plan-approval` repeat across runs).
- */
-export async function resetControl(cwd) {
-    await mkdir(join(cwd, THE_FRAMEWORK_DIR), { recursive: true });
-    await writeFile(controlPath(cwd), '');
-}
-/**
- * Tail the workspace's control log, dispatching each well-formed entry as it is
- * appended. An `fs.watch` on `.the-framework/` plus a poll backstop, mirroring the
- * daemon's event tail (`fs.watch` is unreliable across platforms). Malformed or
- * unknown lines are skipped so a bad write can never crash an agent.
- */
-export function watchControl(cwd, onEntry, pollMs = 300) {
-    const tailer = new JsonlTailer(controlPath(cwd), entry => {
-        if (isControlEntry(entry))
-            onEntry(entry);
-    });
-    // unref: never keep the process alive just for steering.
-    const stop = followFile(join(cwd, THE_FRAMEWORK_DIR), () => tailer.pull(), { pollMs, unref: true });
-    return { close: stop };
-}
-/** Shape-check a parsed line. A multi-select pick may legitimately be `[]`. */
-function isControlEntry(value) {
-    if (!value || typeof value !== 'object')
-        return false;
-    const v = value;
-    if (v['kind'] === 'merge')
-        return true;
-    // The rung must be one of the four: a half-written entry would otherwise disarm by accident,
-    // and this decides whether the session's work reaches the remote at all.
-    if (v['kind'] === 'handoff')
-        return isHandoffLevel(v['level']);
-    if (v['kind'] === 'message')
-        return typeof v['text'] === 'string' && v['text'].length > 0;
-    if (v['kind'] !== 'choice')
-        return false;
-    if (typeof v['id'] !== 'string' || !v['id'])
-        return false;
-    const pick = v['pick'];
-    return typeof pick === 'string' || (Array.isArray(pick) && pick.every(p => typeof p === 'string'));
-}
-//# sourceMappingURL=control.js.map

package/dist/control.js.map

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

package/dist/conversation-commit.d.ts

@@ -1,166 +0,0 @@
-import type { ProjectSummary } from './dashboard/projects.js';
-import type { GitRunner } from './project.js';
-/**
- * Committing the conversations the daemon records (#912) into the project checkout.
- *
- * #908 made `.the-framework/conversations/<runId>.md` tracked files, and the paths that already
- * commit pick them up: a run's worktree sweeps its own on teardown (`store/worktree.ts`). The main
- * checkout has no such path — `install.ts` commits once at activation and nothing after — so a
- * conversation held there sat as a working-tree change until a human happened to commit it. That
- * is the one gap between "the chat is in Git" (#857) and "the chat reaches Git by itself".
- *
- * Two rules shape the whole module, both about writing into a repo somebody else is using.
- *
- * Path-scoped, never `git add -A`. The pathspec names the conversations directory and nothing
- * else, the way `queue-promote.ts` names the queue file, so whatever the user has in progress
- * cannot ride along in our commit. A pathspec commit also leaves their index alone: what they had
- * staged is still staged afterwards. Scoped down further at commit time to the pathspecs that
- * actually have something pending — see {@link pathspecsFor}.
- *
- * Debounced on an idle window rather than committed per turn. A chat turn is seconds apart, and a
- * commit each would bury the project's real history under transcript noise. A poll that sees the
- * same pending set twice running treats the conversation as settled and commits the batch; a burst
- * keeps resetting it. {@link ConversationCommitterOptions.maxWaitMs} caps that, so a conversation
- * that never goes idle still lands instead of being starved forever.
- *
- * Tolerates not being alone (the #605 question this waited on). One daemon per machine is the rule
- * today (#393), but the committer never assumes it: a locked index or a rebase/merge in progress
- * means somebody else is mid-operation, so it skips rather than commits into their work, and a
- * failed commit is swallowed and retried on the next window. That way #605's eventual answer about
- * who owns the chat bot does not invalidate any of this.
- */
-/** The pathspec the conversations live under. Posix separators: it is a git pathspec, not a path. */
-export declare const CONVERSATIONS_PATHSPEC = ".the-framework/conversations";
-/**
- * The committed session archives (#1179), under every user's own directory.
- *
- * `:(glob)` magic so the `*` stops at a path separator — a plain pathspec wildcard matches `/` too,
- * and would reach further down `.the-framework/` than this means to.
- *
- * The trailing `/**` is load-bearing, and its absence is silent: glob magic matches the pattern
- * against each file's whole path rather than treating a directory as a prefix, so
- * `.the-framework/*​/sessions` matches no *file* and `git add` fails with "did not match any files"
- * — a committer that commits nothing, every time. Only a real repo shows this.
- */
-export declare const SESSIONS_PATHSPEC = ":(glob).the-framework/*/sessions/**";
-/**
- * Everything this committer is scoped to. Both are records the daemon writes into the repo and
- * nobody would think to commit by hand: the chat of a run (#908) and the run's own archived history
- * (#1179). They share one debounce because they are written by the same events and a commit each
- * would double the noise in the project's log.
- */
-export declare const COMMITTED_PATHSPECS: readonly string[];
-/**
- * The subset of {@link COMMITTED_PATHSPECS} that `files` actually has something under.
- *
- * `git add` and `git commit` are all-or-nothing about their pathspecs: one that matches no file
- * aborts the whole command with "pathspec ... did not match any files", so passing both patterns
- * unconditionally means a project that has sessions but has never recorded a conversation — every
- * project, until its first chat — fails to commit and puts that failure in the daemon log on every
- * poll. Nothing to commit under a pattern is the ordinary state, not an error, so the pattern is
- * dropped instead.
- *
- * This covers the empty directory as well as the missing one, and the two fail in different places:
- * `git add` tolerates an existing-but-empty directory, and then `git commit` rejects it, because by
- * then the pathspec has to match a file git knows about.
- */
-export declare function pathspecsFor(files: readonly string[]): string[];
-/** How often the committer looks for settled conversations. */
-export declare const COMMIT_POLL_MS = 30000;
-/** How long a conversation may keep changing before it is committed anyway. */
-export declare const COMMIT_MAX_WAIT_MS: number;
-/** What one attempt did, or why it did nothing. */
-export type CommitOutcome = {
-    committed: true;
-    files: string[];
-} | {
-    committed: false;
-    reason: string;
-};
-/** Whether a path exists. Injectable so the busy check is testable without real lock files. */
-export type PathProbe = (path: string) => Promise<boolean>;
-/** A {@link PathProbe} over `fs.access`. */
-export declare function nodePathProbe(): PathProbe;
-/**
- * The commit message a batch writes. Names what moved, so the log line stands alone.
- *
- * Sessions are counted by run, not by file: one archived run is a `<id>.json` and a `<id>.jsonl`,
- * and "2 sessions" for a single session would be a lie told by the batch's own commit message.
- */
-export declare function commitMessage(files: string[]): string;
-/**
- * The conversation files with uncommitted changes, as repo-relative paths, sorted so the result is
- * a stable fingerprint the debounce can compare across polls.
- *
- * `--porcelain` v1 is parsed rather than `--short` because its two status columns are fixed-width
- * and its paths are quoted consistently. A rename (`R  old -> new`) reports the destination, which
- * is the path we would commit. Anything unreadable — not a repo, no git — reads as no changes.
- *
- * `-uall` is load-bearing, not a detail. By default git collapses a wholly-untracked directory into
- * one entry (`?? .the-framework/conversations/`) instead of naming the files under it, which makes
- * the fingerprint identical whether one conversation is being written or ten. The debounce compares
- * fingerprints, so without this the idle window could never see a burst and would commit straight
- * through the middle of one. Only a real repo shows this; a per-file fake does not.
- */
-export declare function pendingConversations(cwd: string, git?: GitRunner): Promise<string[]>;
-/**
- * Why the repo is in no state to be committed into, or `undefined` when it is fine.
- *
- * The git dir is resolved through git rather than assumed to be `<cwd>/.git`, so this is right in a
- * linked worktree, where `.git` is a file pointing elsewhere and the markers live in the real dir.
- */
-export declare function gitBusy(cwd: string, git?: GitRunner, exists?: PathProbe): Promise<string | undefined>;
-/**
- * Stage and commit the pending conversations under `cwd`, scoped to {@link COMMITTED_PATHSPECS}.
- *
- * `add` before `commit` because a brand-new conversation is untracked, and `git commit -- <path>`
- * only knows paths git already knows. Both are pathspec-scoped, so the staging is as narrow as the
- * commit and the user's own staged work is neither swept in nor disturbed, and both are narrowed to
- * the pathspecs that have something pending ({@link pathspecsFor}) — a pathspec matching nothing is
- * a hard error to git, and "no conversation has been recorded here yet" is not an error at all.
- *
- * Never throws: this runs on a background tick with nothing to catch it.
- */
-export declare function commitConversations(cwd: string, git?: GitRunner, exists?: PathProbe): Promise<CommitOutcome>;
-/** A running committer; call {@link ConversationCommitter.stop} to end it. */
-export interface ConversationCommitter {
-    stop: () => void;
-    /** Run one poll now. Exposed so the daemon and tests can drive it deterministically. */
-    poll: () => Promise<void>;
-    /**
-     * Commit every project's pending conversations now, skipping the idle window. For shutdown: the
-     * daemon is going away, so waiting for quiet would just defer the work to the next boot. Returns
-     * how many projects committed.
-     */
-    flush: () => Promise<number>;
-}
-/** Options for {@link startConversationCommitter}. */
-export interface ConversationCommitterOptions {
-    /** The projects to sweep each poll (the daemon passes the registry, mapped to summaries). */
-    projects: () => Promise<ProjectSummary[]>;
-    /** Poll cadence and idle window, ms. Default {@link COMMIT_POLL_MS}. */
-    intervalMs?: number;
-    /** Commit anyway once a project has been pending this long, ms. Default {@link COMMIT_MAX_WAIT_MS}. */
-    maxWaitMs?: number;
-    /** Injectable git (tests). */
-    git?: GitRunner;
-    /** Injectable existence probe for the busy check (tests). */
-    exists?: PathProbe;
-    /** Clock, injectable for the max-wait cap (tests). */
-    now?: () => number;
-    /** Where a committed batch is announced. */
-    log?: (message: string) => void;
-}
-/**
- * Start committing settled conversations, and return the handle that stops it.
- *
- * The idle window is the poll itself: a project whose pending set is byte-identical to the previous
- * poll's has stopped being written to, so its batch is committed. Anything still moving is recorded
- * and reconsidered next time, unless it has been dirty past `maxWaitMs`, which forces it through.
- *
- * Forgiving throughout — a failed project scan, a busy repo or a rejected commit costs one window
- * and is retried, never a throw. Runs immediately, then every `intervalMs`; the timer is unref'd so
- * it never keeps the daemon alive past shutdown.
- */
-export declare function startConversationCommitter(opts: ConversationCommitterOptions): ConversationCommitter;
-//# sourceMappingURL=conversation-commit.d.ts.map

package/dist/conversation-commit.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"conversation-commit.d.ts","sourceRoot":"","sources":["../src/conversation-commit.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAI7D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAI7C;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,qGAAqG;AACrG,eAAO,MAAM,sBAAsB,iCAA8C,CAAA;AAEjF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,iBAAiB,wCAAqD,CAAA;AAEnF;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,EAAE,SAAS,MAAM,EAAgD,CAAA;AAYjG;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,CAE/D;AAED,+DAA+D;AAC/D,eAAO,MAAM,cAAc,QAAS,CAAA;AAEpC,+EAA+E;AAC/E,eAAO,MAAM,kBAAkB,QAAa,CAAA;AAE5C,mDAAmD;AACnD,MAAM,MAAM,aAAa,GACrB;IAAE,SAAS,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,GACpC;IAAE,SAAS,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAA;AAExC,+FAA+F;AAC/F,MAAM,MAAM,SAAS,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;AAE1D,4CAA4C;AAC5C,wBAAgB,aAAa,IAAI,SAAS,CAQzC;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAQrD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,GAAE,SAA2B,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAW3G;AA0BD;;;;;GAKG;AACH,wBAAsB,OAAO,CAC3B,GAAG,EAAE,MAAM,EACX,GAAG,GAAE,SAA2B,EAChC,MAAM,GAAE,SAA2B,GAClC,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAU7B;AAKD;;;;;;;;;;GAUG;AACH,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,MAAM,EACX,GAAG,GAAE,SAA2B,EAChC,MAAM,GAAE,SAA2B,GAClC,OAAO,CAAC,aAAa,CAAC,CAqBxB;AAED,8EAA8E;AAC9E,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,IAAI,CAAA;IAChB,wFAAwF;IACxF,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IACzB;;;;OAIG;IACH,KAAK,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAA;CAC7B;AAED,sDAAsD;AACtD,MAAM,WAAW,4BAA4B;IAC3C,6FAA6F;IAC7F,QAAQ,EAAE,MAAM,OAAO,CAAC,cAAc,EAAE,CAAC,CAAA;IACzC,wEAAwE;IACxE,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,uGAAuG;IACvG,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,8BAA8B;IAC9B,GAAG,CAAC,EAAE,SAAS,CAAA;IACf,6DAA6D;IAC7D,MAAM,CAAC,EAAE,SAAS,CAAA;IAClB,sDAAsD;IACtD,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;IAClB,4CAA4C;IAC5C,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;CAChC;AAeD;;;;;;;;;;GAUG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,4BAA4B,GAAG,qBAAqB,CAiFpG"}