@openagt/dashboard 0.8.0 → 0.9.0

package/dist/agent-telemetry.js

@@ -1,97 +0,0 @@
-import { hasSessionIdPlaceholder, resolveSessionLink } from './session-link.js';
-import { UsageMeter } from './usage.js';
-/**
- * Emit the agent's opening `session` event. A literal link is shown right away; a
- * templated one (`.../{sessionId}`) can only resolve once the driver reports its
- * session id, so it waits for the `session-update` from {@link createDriverEventHandler}.
- */
-export function emitSessionStart(opts) {
-    const literal = opts.sessionLink && !hasSessionIdPlaceholder(opts.sessionLink) ? opts.sessionLink : undefined;
-    opts.emit({
-        kind: 'session',
-        driver: opts.driver.id,
-        workspace: opts.cwd,
-        fake: opts.driver.id === 'fake',
-        ...(literal ? { sessionLink: literal } : {}),
-        ...(opts.model ? { model: opts.model } : {}),
-    });
-}
-/**
- * Watch the driver's black box (#165) and turn it into the agent's stream: surface the real session
- * id as `session-update` once known (that is the honest handle a UI links to, and it changes per
- * prompt, so re-emit), and fold each turn's usage into the agent total.
- *
- * It used to trip two self-stops here as well — a per-agent USD cap and a mid-run quota gate — each
- * firing *after* the turn that crossed it, when its cost was already spent (E1).
- */
-export function createDriverEventHandler(opts) {
-    const { emit } = opts;
-    let lastSessionId;
-    const usage = new UsageMeter();
-    const onDriverEvent = (event) => {
-        // The turn-start id announcement (#1322) is consumed here, not forwarded: it exists so the
-        // `session-update` below lands before a Stop or a crash can lose the turn, and a transcript
-        // row repeating an id the very next event also carries would only be noise.
-        if (event.type === 'session') {
-            if (event.sessionId !== lastSessionId) {
-                lastSessionId = event.sessionId;
-                const link = opts.sessionLink ? resolveSessionLink(opts.sessionLink, event.sessionId) : undefined;
-                emit({ kind: 'session-update', sessionId: event.sessionId, ...(link ? { sessionLink: link } : {}) });
-            }
-            return;
-        }
-        emit({ kind: 'driver', event });
-        if (event.type !== 'result')
-            return;
-        // The hand-off anchor (#1601) reaches the meta the same way the session id does: it is a
-        // fact about the run the daemon needs after this process is gone, so only an event carries it.
-        if (event.anchorSha)
-            emit({ kind: 'cloud-anchor', sha: event.anchorSha });
-        if (event.sessionId && event.sessionId !== lastSessionId) {
-            lastSessionId = event.sessionId;
-            // A driver that knows its session's real URL (#1317, the cloud hand-off) beats the
-            // session-link template, whose Claude default is the generic entry point.
-            const link = event.sessionLink ?? (opts.sessionLink ? resolveSessionLink(opts.sessionLink, event.sessionId) : undefined);
-            emit({ kind: 'session-update', sessionId: event.sessionId, ...(link ? { sessionLink: link } : {}) });
-        }
-        if (!event.usage)
-            return;
-        usage.add(event.usage);
-        const totals = usage.totals();
-        emit({ kind: 'usage', ...totals });
-    };
-    return { onDriverEvent };
-}
-/**
- * Compose the agent's signal and wire its driver-event handler in one place. The caller's signal is
- * OR'd (via {@link AbortSignal.any}) with the one self-stop left — an answer that says to stop
- * (#358) — so anything downstream that watches `agentSignal` stops the same way regardless of which
- * fired.
- *
- * There were three (E1). A per-agent USD cap and a mid-run quota gate also aborted a session that
- * was already going, which is the worst moment to economise: the tokens are already spent, the
- * work is half-done, and what is saved is the cheap part while what is lost is the expensive part.
- * Spending is decided once, before a session starts.
- *
- * What survives is the one a *person* asked for. It used to be reached through the gate's kind —
- * a decline of an `await-confirmation` — and now through the option the agent marked, which is
- * the same stop with the plan-approval special case taken out of it (D6).
- */
-export function createAgentControls(opts) {
-    const answerController = new AbortController();
-    const agentSignal = AbortSignal.any([...(opts.signal ? [opts.signal] : []), answerController.signal]);
-    const handler = createDriverEventHandler({ emit: opts.emit, sessionLink: opts.sessionLink });
-    return { ...handler, agentSignal, answerController };
-}
-/**
- * Classify why an agent's turn loop threw and render the `end` event's `detail`. A caller interrupt
- * or an answer that said to stop (#358) are clean stops; anything else is a real failure. Shared
- * so the two agent paths can never disagree on what "stopped" means.
- */
-export function endStopDetail(opts) {
-    const callerAborted = opts.signal?.aborted === true;
-    const answered = opts.answerController.signal.aborted;
-    const detail = answered ? 'stopped by your answer' : opts.err instanceof Error ? opts.err.message : String(opts.err);
-    return { stopped: callerAborted || answered, detail };
-}
-//# sourceMappingURL=agent-telemetry.js.map

package/dist/agent-telemetry.js.map

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

package/dist/agent.d.ts

@@ -1,113 +0,0 @@
-import type { Driver } from 'agent-driver';
-import { type ChoicePick, type ChoiceRequest, type FrameworkEvent } from './events.js';
-import type { AgentMessages } from './agent-messages.js';
-import { type AgentLocation } from './agent-location.js';
-/**
- * One session: frame the wrapped agent, send it a prompt, honor the gates it answers with, and
- * stream every step as a {@link FrameworkEvent}. Reversible — swap in a different `Driver`
- * without touching this wiring.
- *
- * There used to be two of these. `runFramework` drove a build through ai-autopilot's `Bootstrap`
- * spine, and `runPrompt` ran one prompt verbatim; `composeAgentSystem` exists specifically because
- * the two each inlined the system composition and drifted apart (#500/#501). Once the review loop
- * (A5) and the `Bootstrap` spine (A3) went, the build path *was* "one prompt, honoring gates" —
- * which is what the prompt path already was. What is left of the difference is two options rather
- * than two implementations: which prompt opens the session, and whether the agent's own backlog is
- * worked afterwards.
- */
-/** What a session is: an intent to build from, or a prompt to run verbatim. */
-export type AgentKind = 'build' | 'prompt';
-/** Options for {@link runAgent}. */
-export interface RunAgentOptions {
-    /**
-     * What the session is asked to do. For `build`, the intent the opening prompt is composed
-     * around; for `prompt`, the text sent as-is (modulo the system template's user slot).
-     */
-    prompt: string;
-    /** Which opening prompt this session gets, and whether live chat follows. Default `build`. */
-    kind?: AgentKind;
-    /**
-     * Where this session's turns execute (#1050/#610). Default `local`. Only `web` hands the work
-     * somewhere this machine cannot follow, which makes the opening prompt the whole session —
-     * see {@link isHandsOff}.
-     */
-    location?: AgentLocation;
-    /** The agent runs in a checkout The Framework created, with `branches` on its PATH (#1725). */
-    ownedCheckout?: boolean;
-    /** The wrapped coding agent. */
-    driver: Driver;
-    /** Absolute workspace path the agent works in. */
-    cwd: string;
-    /** Model id to pass through to the driver. */
-    model?: string;
-    /**
-     * A user-authored system prompt (from `SYSTEM.md`) injected into every prompt
-     * (#301). Load with `loadUserSystemPrompt(cwd)`. Composed after the built-in
-     * #326 system prompt, so a repo can add its own instructions on top of the default.
-     */
-    systemPrompt?: string;
-    /** Remove the built-in #326 system prompt (#301/C3). Default `false` — it is included. */
-    vanilla?: boolean;
-    /** This session has a real browser (#824), so the system channel says so. */
-    browser?: boolean;
-    /** Transparent mode (#625): empty the system channel entirely (raw `claude -p`); overrides vanilla. */
-    transparent?: boolean;
-    /** In-context directories (#439): added as one `Context:` line to the system prompt. */
-    context?: readonly string[];
-    /**
-     * A link to the live agent session, shown on the dashboard. Either a literal
-     * URL, or a template with `{sessionId}` (see {@link SESSION_ID_PLACEHOLDER})
-     * that resolves once the wrapped agent reports its real id via `session-update`.
-     */
-    sessionLink?: string;
-    /** Interrupt the session between turns. */
-    signal?: AbortSignal;
-    /**
-     * Pause on an interactive choice and await a pick (#304). Called when a turn stops to ask
-     * (#337/#358): the session emits a `choice` event, calls this, and resumes on the returned
-     * option. Omit for a headless session: the gate then auto-accepts the recommended option
-     * without pausing. The CLI wires this to the dashboard's Accept button.
-     */
-    requestChoice?: (req: ChoiceRequest) => Promise<ChoicePick>;
-    /**
-     * Continue a stopped session's conversation (#720/#1467): the captured agent session id to
-     * `--resume`. When set, {@link prompt} is sent verbatim as a continuation message rather than
-     * composed — the resumed transcript already carries the framing, which is exactly why #782
-     * refused to bolt a resumed session onto a fresh build. Everything around the turn still runs:
-     * the gates, live chat — the flow resumes, not just the conversation.
-     */
-    resumeSessionId?: string;
-    /**
-     * Live chat (#714): once the opening exchange settles, take the user's own messages, each
-     * continuing the same session. The session then ends itself when the queue is idle (#1390)
-     * unless {@link stayOpenChat} parks it. Unset for a headless session, which ends when the agent
-     * stops asking.
-     */
-    messages?: AgentMessages;
-    /**
-     * Keep the chat parked for the next message instead of ending on an idle queue (#1390).
-     * Only for a session whose own surface is the single one — it has no dashboard to resume
-     * through, so ending would leave its composer a dead end.
-     */
-    stayOpenChat?: boolean;
-    /** Observe the unified event stream. */
-    onEvent?: (event: FrameworkEvent) => void;
-}
-/** What a session returns. */
-export interface RunAgentResult {
-    /** The final turn's text. */
-    text: string;
-    /** Every event emitted, in order. */
-    events: FrameworkEvent[];
-}
-/**
- * Run one session to completion: send the opening prompt, honor each await gate (#337/#339) by
- * re-prompting with the user's answer, work the backlog if this is a build, and stay open for the
- * user's own messages when a chat source is wired.
- *
- * Emits the same {@link FrameworkEvent} stream throughout — `session`, `system-prompt`, `driver`,
- * `choice`, `usage`, `intent`, `end` — so the dashboard, the store, and the control channel (#344)
- * read one shape regardless of what opened the session.
- */
-export declare function runAgent(opts: RunAgentOptions): Promise<RunAgentResult>;
-//# sourceMappingURL=agent.d.ts.map

package/dist/agent.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAiB,MAAM,cAAc,CAAA;AAKzD,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,aAAa,EAAE,KAAK,cAAc,EAAE,MAAM,aAAa,CAAA;AACtF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACxD,OAAO,EAAc,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAEpE;;;;;;;;;;;;GAYG;AAEH,+EAA+E;AAC/E,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,QAAQ,CAAA;AAE1C,oCAAoC;AACpC,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAA;IACd,8FAA8F;IAC9F,IAAI,CAAC,EAAE,SAAS,CAAA;IAChB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,aAAa,CAAA;IACxB,+FAA+F;IAC/F,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,gCAAgC;IAChC,MAAM,EAAE,MAAM,CAAA;IACd,kDAAkD;IAClD,GAAG,EAAE,MAAM,CAAA;IACX,8CAA8C;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAA;IACd;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,0FAA0F;IAC1F,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,6EAA6E;IAC7E,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,uGAAuG;IACvG,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,wFAAwF;IACxF,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAC3B;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,2CAA2C;IAC3C,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB;;;;;OAKG;IACH,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,aAAa,KAAK,OAAO,CAAC,UAAU,CAAC,CAAA;IAC3D;;;;;;OAMG;IACH,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,aAAa,CAAA;IACxB;;;;OAIG;IACH,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,wCAAwC;IACxC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAA;CAC1C;AAED,8BAA8B;AAC9B,MAAM,WAAW,cAAc;IAC7B,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,qCAAqC;IACrC,MAAM,EAAE,cAAc,EAAE,CAAA;CACzB;AAED;;;;;;;;GAQG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,CA8H7E"}

package/dist/agent.js

@@ -1,168 +0,0 @@
-import { composeAgentSystem, renderSystemPrompt } from './system-prompt.js';
-import { createAgentControls, emitSessionStart, endStopDetail } from './agent-telemetry.js';
-import { createTurnSignalEmitter } from './turn-gate.js';
-import { runAwaitRounds } from './await-gate.js';
-import { isHandsOff } from './agent-location.js';
-/**
- * Run one session to completion: send the opening prompt, honor each await gate (#337/#339) by
- * re-prompting with the user's answer, work the backlog if this is a build, and stay open for the
- * user's own messages when a chat source is wired.
- *
- * Emits the same {@link FrameworkEvent} stream throughout — `session`, `system-prompt`, `driver`,
- * `choice`, `usage`, `intent`, `end` — so the dashboard, the store, and the control channel (#344)
- * read one shape regardless of what opened the session.
- */
-export async function runAgent(opts) {
-    const events = [];
-    const emit = (event) => {
-        events.push(event);
-        // Swallow a listener that throws: emit runs both inside and outside the try below (the
-        // session-start and system-prompt events fire first), so an unguarded throw would escape
-        // the session uncaught or skip its `end` event.
-        if (opts.onEvent) {
-            try {
-                opts.onEvent(event);
-            }
-            catch (err) {
-                console.error('[framework] onEvent threw; ignoring:', err);
-            }
-        }
-    };
-    const kind = opts.kind ?? 'build';
-    // A hand-off location (#1225): the prompt leaves this machine and the reply never comes back, so
-    // the opening turn is the entire session and every phase after it is dropped rather than fed.
-    const handsOff = isHandsOff(opts.location);
-    // The built-in #326 system prompt + any user SYSTEM.md frame the session (#301).
-    const tf = { prompt: opts.prompt };
-    const system = composeAgentSystem({
-        vanilla: opts.vanilla,
-        browser: opts.browser,
-        handsOff,
-        ownedCheckout: opts.ownedCheckout,
-        transparent: opts.transparent,
-        user: opts.systemPrompt,
-        tf,
-        context: opts.context,
-    });
-    emitSessionStart({ emit, driver: opts.driver, cwd: opts.cwd, sessionLink: opts.sessionLink, model: opts.model });
-    // What this session was asked for, so the store and the dashboard have its title without
-    // parsing a prompt (#211). Nothing is read off disk and appended after the system prompt, so
-    // the text emitted below is the whole of it (#547); the per-turn user prompts ride along as
-    // `driver` `start` events, so every prompt sent is visible.
-    emit({ kind: 'intent', text: opts.prompt });
-    if (system)
-        emit({ kind: 'system-prompt', text: system });
-    // Usage accounting plus the one self-stop left (#358): the session signal composes the caller's
-    // abort with the one an answer trips. Nothing stops a session for spending (E1) — that is
-    // decided before it starts.
-    const { agentSignal, onDriverEvent, answerController } = createAgentControls({
-        emit,
-        signal: opts.signal,
-        sessionLink: opts.sessionLink,
-    });
-    // One driver session for the whole agent; each prompt is a fresh invocation. A continuation
-    // (#720/#1467) resumes the stopped leg's conversation instead of starting anew.
-    const resuming = typeof opts.resumeSessionId === 'string' && opts.resumeSessionId.length > 0;
-    const session = await opts.driver.start({
-        cwd: opts.cwd,
-        system,
-        ...(opts.model ? { model: opts.model } : {}),
-        ...(resuming ? { resumeSessionId: opts.resumeSessionId } : {}),
-        signal: agentSignal,
-        onEvent: onDriverEvent,
-    });
-    // Non-blocking signals the agent emits per turn: markdown views (#441) and the session-lifecycle (#326)
-    // signals (session name, ready-for-merge). None stop the turn.
-    const emitTurnSignals = createTurnSignalEmitter(emit);
-    try {
-        const rounds = await runAwaitRounds({
-            session,
-            prompt: openingPrompt(opts, resuming),
-            emitTurnSignals,
-            requestChoice: opts.requestChoice,
-            emit,
-            signal: agentSignal,
-            ...(resuming ? { resume: true } : {}),
-            // Chat comes after the backlog for a build, so it is wired below rather than here.
-            ...(opts.messages && (kind === 'prompt' || handsOff) ? { messages: opts.messages } : {}),
-            ...(opts.stayOpenChat ? { stayOpenChat: true } : {}),
-        });
-        // The agent kept asking past the limit: finish with the latest turn rather than loop.
-        if (rounds.exhausted)
-            emit({ kind: 'log', message: 'Finishing the session (await limit reached).' });
-        // An answer marked `stop` (#358) ends the session rather than carrying on: the user takes over
-        // with fresh instructions, so building on a plan they just declined is the one thing not to
-        // do. Tripped through the agent signal so every path ends the same way a Stop does — the prompt
-        // path used to finish cleanly here instead, which meant the same decline read as a completed
-        // session on one path and a stop on the other.
-        if (rounds.stopped)
-            answerController.abort(new Error('[framework] stopped by your answer'));
-        let text = rounds.text;
-        // The session controls (a Stop, an answer that said stop #358) abort between turns, and the
-        // opening rounds do not observe the abort themselves, so look before treating this as a
-        // success — otherwise an aborted session settles as done.
-        if (agentSignal.aborted) {
-            throw agentSignal.reason instanceof Error ? agentSignal.reason : new Error('[framework] run stopped');
-        }
-        // Live chat (#714) for a build, once its opening work settles: a prompt session already took
-        // it inside the rounds above, where there is nothing to come between.
-        if (opts.messages && kind === 'build' && !handsOff && !agentSignal.aborted) {
-            const chat = await runChatAfterBacklog(session, opts, emit, emitTurnSignals, agentSignal);
-            text = chat.text;
-            // Same as #217, for the chat leg: a stop here ends the session rather than publishing.
-            if (chat.stopped)
-                answerController.abort(new Error('[framework] stopped by your answer'));
-        }
-        // The backlog and chat legs abort the same signal a Stop does, but neither observes it itself
-        // (as the opening rounds do not, #233). Look before settling as a success, or a stopped session
-        // reaches `end ok:true` below and publishes the very work its answer declined.
-        if (agentSignal.aborted) {
-            throw agentSignal.reason instanceof Error ? agentSignal.reason : new Error('[framework] run stopped');
-        }
-        // Say why a hand-off stops here, so a finished one does not read as a session that gave up a
-        // turn in. The link itself is already on the driver's `cloud <url>` action.
-        if (handsOff) {
-            emit({ kind: 'log', message: 'Handed off: the rest of this session happens in its own session, which opens its own pull request.' });
-        }
-        emit({ kind: 'end', ok: true });
-        return { text, events };
-    }
-    catch (err) {
-        const { stopped, detail } = endStopDetail({ err, ...(opts.signal ? { signal: opts.signal } : {}), answerController });
-        emit({ kind: 'end', ok: false, ...(stopped ? { stopped: true } : {}), detail });
-        throw err;
-    }
-    finally {
-        await session.dispose();
-    }
-}
-/**
- * The first thing the agent is sent: the user's text rendered through the system prompt's own
- * `# User prompt` slot — the one place the user prompt is framed, for a build and a prompt
- * session alike (#1683 review: the build wrapper that used to sit beside it said nothing the
- * system prompt did not).
- *
- * A resumed session (#720/#1467) gets the text verbatim: the `--resume`d transcript already
- * carries the framing, so composing it again would stack a second preamble onto a conversation
- * that lived through the first. So does a transparent or vanilla session — no built-in prompt
- * means no slot to render into.
- */
-function openingPrompt(opts, resuming) {
-    if (resuming || opts.transparent || opts.vanilla)
-        return opts.prompt;
-    return renderSystemPrompt({ prompt: opts.prompt }).user;
-}
-/** The live-chat phase a build reaches after its backlog, sharing the rounds' own loop. */
-async function runChatAfterBacklog(session, opts, emit, emitTurnSignals, signal) {
-    const { runChatPhase } = await import('./await-gate.js');
-    const chat = await runChatPhase(session, opts.messages, { text: '' }, {
-        ...(opts.requestChoice ? { requestChoice: opts.requestChoice } : {}),
-        emit,
-        emitTurnSignals,
-        signal,
-    }, opts.stayOpenChat === true);
-    // `stopped` carries through, not just the text: an answer marked `stop` here must end the session
-    // the same way it does in the opening rounds, or a stopped chat settles as a clean, published run.
-    return { text: chat.turn.text, stopped: chat.stopped };
-}
-//# sourceMappingURL=agent.js.map

package/dist/agent.js.map

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

package/dist/archived-agent-patch.d.ts

@@ -1,14 +0,0 @@
-import { type ArchivePatch } from './store/index.js';
-/**
- * Patch a settled run's archived record on the logs branch (#1601): synced with origin, patched,
- * committed, pushed — the same funnel every other write to the branch goes through (#1582).
- *
- * A patch written straight into the branch's checkout is not a fact yet: the next sync's rebase
- * refuses a dirty tree and the funnel hard-resets it, so the patch is gone within a minute and
- * no other machine ever saw it. Seen live on the cloud-work adoption before it went through here.
- *
- * True when the record now carries the patch, committed; a push that could not go out rides the
- * next cycle, which is the funnel's owed-push rule. False when the run has no archive to patch.
- */
-export declare function patchArchivedAgentOnDataBranch(cwd: string, agentId: string, patch: ArchivePatch, message: string): Promise<boolean>;
-//# sourceMappingURL=archived-agent-patch.d.ts.map

package/dist/archived-agent-patch.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"archived-agent-patch.d.ts","sourceRoot":"","sources":["../src/archived-agent-patch.ts"],"names":[],"mappings":"AAEA,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAExE;;;;;;;;;;GAUG;AACH,wBAAsB,8BAA8B,CAClD,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,YAAY,EACnB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,OAAO,CAAC,CAMlB"}

package/dist/archived-agent-patch.js

@@ -1,22 +0,0 @@
-import { withFileBranch } from '@gemstack/agent-data';
-import { LOGS_BRANCH } from './framework-dir.js';
-import { patchArchivedAgent } from './store/index.js';
-/**
- * Patch a settled run's archived record on the logs branch (#1601): synced with origin, patched,
- * committed, pushed — the same funnel every other write to the branch goes through (#1582).
- *
- * A patch written straight into the branch's checkout is not a fact yet: the next sync's rebase
- * refuses a dirty tree and the funnel hard-resets it, so the patch is gone within a minute and
- * no other machine ever saw it. Seen live on the cloud-work adoption before it went through here.
- *
- * True when the record now carries the patch, committed; a push that could not go out rides the
- * next cycle, which is the funnel's owed-push rule. False when the run has no archive to patch.
- */
-export async function patchArchivedAgentOnDataBranch(cwd, agentId, patch, message) {
-    let patched = false;
-    const result = await withFileBranch(cwd, LOGS_BRANCH, message, async () => {
-        patched = await patchArchivedAgent(cwd, agentId, patch);
-    });
-    return patched && (result.ok || result.committed);
-}
-//# sourceMappingURL=archived-agent-patch.js.map

package/dist/archived-agent-patch.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"archived-agent-patch.js","sourceRoot":"","sources":["../src/archived-agent-patch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAChD,OAAO,EAAE,kBAAkB,EAAqB,MAAM,kBAAkB,CAAA;AAExE;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,8BAA8B,CAClD,GAAW,EACX,OAAe,EACf,KAAmB,EACnB,OAAe;IAEf,IAAI,OAAO,GAAG,KAAK,CAAA;IACnB,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,GAAG,EAAE,WAAW,EAAE,OAAO,EAAE,KAAK,IAAI,EAAE;QACxE,OAAO,GAAG,MAAM,kBAAkB,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,CAAC,CAAA;IACzD,CAAC,CAAC,CAAA;IACF,OAAO,OAAO,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,MAAM,CAAC,SAAS,CAAC,CAAA;AACnD,CAAC"}