@idleware/ringi 0.6.1 → 0.7.1

package/target/esm/clients/cli/operator/watch.js

@@ -1,15 +0,0 @@
-// watch: the headless watcher the operator starts for an agent's seat (`ringi watch <room>/<agent> --exec …`).
-import { watch } from '../../../core/agents/sessions/agent.js';
-import { fail, words } from '../../../lib/index.js';
-import { flag, opt, out } from '../args.js';
-const numberOption = (o, k) => opt(o, k) === undefined ? undefined : Number(opt(o, k));
-export const watchCommand = async (o) => {
-    process.exitCode = await watch({
-        seat: o._[0] ?? fail('usage: ringi watch <room>/<agent> --exec <cmd> [--scope <text>] [--once] [--require-grant] …'),
-        exec: opt(o, 'exec') ?? fail('--exec <cmd> is required: the command that starts a headless turn'),
-        hub: opt(o, 'hub'), scope: opt(o, 'scope'), once: flag(o, 'once'), requireGrant: flag(o, 'require-grant'), handoff: flag(o, 'handoff'),
-        interval: numberOption(o, 'interval'), from: opt(o, 'from') ? words(opt(o, 'from')) : undefined, maxHop: numberOption(o, 'max-hop'),
-        maxRuns: numberOption(o, 'max-runs'), window: numberOption(o, 'window')
-    }, out);
-};
-//# sourceMappingURL=watch.js.map

package/target/esm/clients/cli/shared/budget.js

@@ -1,50 +0,0 @@
-// budget: `propose`, `stamp`, `decide`, `proposals`, `grants`.
-import * as Budget from '../../../core/hub/usecases/budget.js';
-import { fail, short, words } from '../../../lib/index.js';
-import { attachments, dump, flag, list, opt, out, textOf } from '../args.js';
-// --- decisions and budgets ---
-export const propose = (a, o) => {
-    const decider = opt(o, 'decider') ?? fail('--decider <id> is required: who decides (operator, or someone with authority in the hub contract)');
-    const r = Budget.propose(a, {
-        text: textOf(o), decider, reviewers: words(opt(o, 'reviewers')), budget: opt(o, 'budget'), due: opt(o, 'due'),
-        supersedes: opt(o, 'supersedes'), files: list(o, 'attach').flatMap(attachments)
-    });
-    out(`proposed ${short(r.id)} to ${r.to.join(', ') || 'the room'}; decider ${decider}${r.budget ? `, budget ${Budget.budgetText(r.budget)}` : ''}`);
-};
-export const stamp_ = (a, o) => {
-    const s = o._[1] ?? '';
-    if (!Budget.STAMPS.includes(s))
-        fail(`usage: stamp <proposal> ${Budget.STAMPS.join('|')} -m <reason>`);
-    const r = Budget.stamp(a, o._[0] ?? fail('name the proposal'), s, textOf(o));
-    out(`stamped ${short(r.proposal.id)} ${s}: ${short(r.id)}`);
-};
-export const decide = (a, o) => {
-    const d = o._[1] ?? '';
-    if (!Budget.DECISIONS.includes(d))
-        fail(`usage: decide <proposal> ${Budget.DECISIONS.join('|')} -m <reason>`);
-    const r = Budget.decide(a, o._[0] ?? fail('name the proposal'), d, textOf(o));
-    out(`${d} ${short(r.proposal.id)}: ${short(r.id)}${r.budget ? `; grant ${short(r.id)} with ${Budget.budgetText(r.budget)}. Work spends it with --grant ${short(r.id)}` : ''}`);
-};
-export const proposals = (a, o) => {
-    const { proposals: ps, views } = Budget.proposals(a, { all: flag(o, 'all') });
-    if (flag(o, 'json'))
-        return dump(views);
-    if (!ps.length)
-        return out(flag(o, 'all') ? 'no proposals' : 'no open proposals (proposals --all for everything)');
-    for (const x of ps) {
-        const st = x.reviewers.map(r => `${r}:${x.stamps[r]?.stamp ?? '-'}`).join(' ');
-        out(`${short(x.proposal.id)}  ${x.state.padEnd(10)} ${x.proposal.from} → ${x.decider}${x.budget ? `  [${Budget.budgetText(x.budget)}]` : ''}${st ? `  ${st}` : ''}  ${x.proposal.subject}`);
-    }
-};
-export const grants = (a, o) => {
-    const gs = Budget.grants(a);
-    if (flag(o, 'json'))
-        return dump(gs);
-    if (!gs.length)
-        return out('no grants');
-    for (const g of gs) {
-        const u = g.usage;
-        out(`${short(g.grant)}  ${g.revoked ? 'revoked ' : u.left ? 'active  ' : 'spent   '} runs ${u.runs}/${g.budget.runs}, open ${u.open}${u.uncertain ? `, uncertain ${u.uncertain}` : ''}, ${u.seconds}s used, ≤${g.budget['run-seconds']}s a run, concurrency ${g.budget.concurrency}  ${g.subject}`);
-    }
-};
-//# sourceMappingURL=budget.js.map

package/target/esm/core/agents/turns/budgets.js

@@ -1,48 +0,0 @@
-// budgets: which groups of messages may start a turn now: within a grant's budget, or within the watcher's own run
-// limit when no grant covers them.
-import { note, short } from '../../../lib/index.js';
-import { reportExhausted } from './exhaustion.js';
-import { reserveGrant } from './grants.js';
-const ownRun = (c, grp, p, now) => {
-    if (c.w.requireGrant) {
-        for (const m of grp.msgs)
-            note(`watch: ${short(m.id)} is outside any grant; --require-grant: not starting a turn`);
-        return;
-    }
-    if (p.ownRuns.length >= c.maxRuns) {
-        p.hold = true;
-        note(`watch: own run budget spent (${c.maxRuns} per ${c.span}s); ${grp.msgs.length} message(s) wait`);
-        return;
-    }
-    p.ownRuns = [...p.ownRuns, now];
-    p.runs.push({ ...grp, timeout: null });
-};
-const grantedRun = ({ c, R, all, grp, r, p }) => {
-    if (r.wait) {
-        p.hold = true;
-        note(`watch: ${r.why}; waiting`);
-        return;
-    }
-    if (r.why) {
-        note(`watch: ${r.why}`);
-        reportExhausted({ c, R, all, grp, r, p });
-        return;
-    }
-    p.runs.push({ ...grp, run: r.run, timeout: r.gr.budget['run-seconds'] });
-};
-export const reserveGroups = (c, R, all, groups, st) => {
-    const now = Date.now() / 1000;
-    const p = { runs: [], hold: false, lost: false, ownRuns: (st.runs ?? []).filter(t => t > now - c.span), exhausted: { ...st.exhausted } };
-    for (const grp of groups.values()) {
-        if (!grp.grant) {
-            ownRun(c, grp, p, now);
-            continue;
-        }
-        const r = reserveGrant(c, R, all, grp);
-        if (r.lost)
-            return { ...p, runs: [], hold: true, lost: true };
-        grantedRun({ c, R, all, grp, r, p });
-    }
-    return p;
-};
-//# sourceMappingURL=budgets.js.map

package/target/esm/core/agents/turns/dispatch.js

@@ -1,40 +0,0 @@
-// dispatch: a planned turn is started through the process host, still holding the seat and a valid grant.
-import * as D from '../../hub/decisions/index.js';
-import { hubPorts, locked } from '../../hub/ports/index.js';
-import { fail, note, short } from '../../../lib/index.js';
-import { link } from '../../hub/protocol/index.js';
-import { loadRoomUnlocked, loadState, readerLock, saveState } from '../../hub/history/index.js';
-import { readSession } from '../sessions/index.js';
-import { agentPorts } from '../ports/index.js';
-const grantProblem = (c, R, run) => {
-    if (!run.grant)
-        return undefined;
-    const { logs } = readerLock(R, c.me, () => loadRoomUnlocked(R, c.me));
-    const gr = D.grantOf(link(logs), R.authorityAt, run.grant);
-    return !gr ? 'its grant is no longer valid' : gr.revoked ? 'its grant was revoked' : undefined;
-};
-const spawnTurn = (c, run) => locked('sessions', () => {
-    const cur = readSession(c.handle);
-    if (!cur || cur.pid !== process.pid)
-        return { why: 'the seat was taken over' };
-    if (cur.state !== 'active')
-        return { why: 'the watcher was stopped' };
-    note(`watch: ${run.msgs.length} new${run.grant ? ` under grant ${short(run.grant)}` : ''}: ${c.cmd}`);
-    return {
-        done: agentPorts().host.awaitQuiescence(agentPorts().host.start({ shell: c.cmd, timeout: run.timeout, env: {
-                ...process.env, RINGI_HOME: hubPorts().state.root, RINGI_SESSION: c.raw,
-                RINGI_MSGS: run.msgs.map(m => m.id).join('\n'), RINGI_GRANT: run.grant ?? ''
-            } })).then(result => result ?? fail('the process host did not settle the turn'))
-    };
-});
-export const dispatch = (c, R, run) => locked(`grant-${R.hub.name}`, () => {
-    const why = grantProblem(c, R, run);
-    if (why)
-        return { why };
-    readerLock(R, c.me, () => {
-        const st = loadState(R, c.me);
-        saveState(R, c.me, { ...st, inflight: { seen: st.seen ?? {} } });
-    });
-    return spawnTurn(c, run);
-});
-//# sourceMappingURL=dispatch.js.map

package/target/esm/core/agents/turns/exhaustion.js

@@ -1,16 +0,0 @@
-// exhaustion: a piece of work whose grant is spent or revoked waits for a new grant, said once in its thread.
-import { isOpen, taskOf } from '../../hub/work/index.js';
-import { OPERATOR, append } from '../../hub/rooms/index.js';
-import { compose } from '../../hub/protocol/index.js';
-export const reportExhausted = ({ c, R, all, grp, r, p }) => {
-    const key = `${grp.task?.id}/${grp.grant}`;
-    if (!r.exhausted || !grp.task || p.exhausted[key])
-        return;
-    p.exhausted[key] = true;
-    const t = taskOf(all, grp.task, R.profile), last = grp.msgs.at(-1);
-    if (isOpen(t, R.profile))
-        append(R, c.me, compose(`${r.why}; waiting for a new grant`, [
-            ['To', [...new Set([t.requester, OPERATOR])].join(', ')], ['Re', last.id], ['State', R.profile.waiting], ['Hop', String(last.hopEff + 1)]
-        ]));
-};
-//# sourceMappingURL=exhaustion.js.map

package/target/esm/core/agents/turns/grants.js

@@ -1,36 +0,0 @@
-// grants: a run reserved under a grant: approved, not revoked, not spent, within its concurrency.
-import * as D from '../../hub/decisions/index.js';
-import { OPERATOR, append } from '../../hub/rooms/index.js';
-import { short } from '../../../lib/index.js';
-import { compose } from '../../hub/protocol/index.js';
-import { readSession } from '../sessions/index.js';
-const grantStatus = (gr) => {
-    if (gr.revoked)
-        return { why: `grant ${short(gr.id)} was revoked`, exhausted: true, gr };
-    return { gr };
-};
-const remaining = (all, gr) => {
-    const u = D.usageOf(all, gr);
-    if (u.left <= 0)
-        return { why: `grant ${short(gr.id)} is spent: ${u.runs}/${gr.budget.runs} runs`, exhausted: true, gr };
-    if (u.open >= gr.budget.concurrency)
-        return { why: `grant ${short(gr.id)} has ${u.open} run(s) open, concurrency ${gr.budget.concurrency}`, wait: true };
-    return { gr };
-};
-export const reserveGrant = (c, R, all, grp) => {
-    if (readSession(c.handle)?.pid !== process.pid)
-        return { why: 'this watcher no longer holds the seat', lost: true };
-    const gr = D.grantOf(all, R.authorityAt, grp.grant);
-    if (!gr)
-        return { why: `grant ${short(grp.grant)} is not an approved decision with a budget` };
-    const status = grantStatus(gr);
-    if (status.why)
-        return status;
-    const balance = remaining(all, gr);
-    if (balance.why)
-        return balance;
-    const run = `${c.raw}.${process.pid}.${Date.now().toString(36)}.${c.runSeq++}`;
-    append(R, c.me, compose(`usage: reserve a run of ${c.me}`, [['To', OPERATOR], ['Kind', 'usage'], ['Grant', gr.id], ['Usage', 'reserve'], ['Run', run]]));
-    return { gr, run };
-};
-//# sourceMappingURL=grants.js.map

package/target/esm/core/agents/turns/index.js

@@ -1,33 +0,0 @@
-// turns: the headless watcher: it holds one agent's seat, wakes a command for what arrives, and charges only its own
-// reservations and receipts.
-import { note, sleep } from '../../../lib/index.js';
-import { planTurns } from './plan.js';
-import { pollWatcher } from './poll.js';
-import { runTurns } from './results.js';
-import { createWatcher } from './seat.js';
-export const watch = async (w, log = note) => {
-    const c = createWatcher(w, log);
-    for (;;) {
-        const done = await watchTick(c);
-        if (done !== undefined)
-            return done;
-        await sleep(c.interval);
-    }
-};
-const watchTick = async (c) => {
-    const poll = pollWatcher(c);
-    if (poll.done)
-        return 0;
-    if (poll.R) {
-        const plan = planTurns(c, poll.R);
-        if (plan.lost) {
-            c.log(`watch: the seat of ${c.me} was taken over; stopping`);
-            return 0;
-        }
-        const exitCode = await runTurns(c, poll.R, plan.runs);
-        if (c.w.once)
-            return exitCode || (plan.hold ? 4 : 0);
-    }
-    return undefined;
-};
-//# sourceMappingURL=index.js.map

package/target/esm/core/agents/turns/limits.js

@@ -1,11 +0,0 @@
-// limits: the watcher's options checked before it starts.
-import { fail } from '../../../lib/index.js';
-export const validateWatch = (w) => {
-    for (const [name, value] of [['interval', w.interval], ['window', w.window]])
-        if (value !== undefined && (!Number.isFinite(value) || value <= 0))
-            fail(`watch ${name} must be positive seconds`);
-    for (const [name, value] of [['max-runs', w.maxRuns], ['max-hop', w.maxHop]])
-        if (value !== undefined && (!Number.isSafeInteger(value) || value < 0))
-            fail(`watch ${name} must be a nonnegative integer`);
-};
-//# sourceMappingURL=limits.js.map

package/target/esm/core/agents/turns/messages.js

@@ -1,32 +0,0 @@
-// messages: what wakes the watcher: new messages for its agent and retries of failed turns, grouped by grant and work.
-import { isOpen, taskFor, taskOf } from '../../hub/work/index.js';
-import { HIDDEN } from '../../hub/rooms/index.js';
-import { note, short } from '../../../lib/index.js';
-import { unread, wakes } from '../../hub/protocol/index.js';
-export const collectMessages = (c, R, logs, st, all) => {
-    const { msgs: fresh, cursors } = unread(logs, c.me, st.watched ?? st.seen ?? {}, Infinity, HIDDEN);
-    const retry = (st.pending ?? []).flatMap(id => {
-        const m = all.get(id);
-        if (!m)
-            return [];
-        const task = taskFor(all, m, R.profile);
-        return !task || isOpen(taskOf(all, task, R.profile), R.profile) ? [m] : [];
-    });
-    const msgs = [...new Map([...retry, ...fresh].map(m => [m.id, m])).values()];
-    const go = msgs.filter(m => wakes(m, c.me, HIDDEN) && m.hopEff < c.maxHop && (!c.allow || c.allow.has(m.from)));
-    for (const m of msgs)
-        if (!go.includes(m))
-            note(`watch: not waking for ${short(m.id)} from ${m.from} (to ${m.to.join(',')}, hop ${m.hopEff})`);
-    return { retry, cursors, go };
-};
-export const groupMessages = (R, all, go) => {
-    const groups = new Map();
-    for (const m of go) {
-        const task = taskFor(all, m, R.profile), g = task ? taskOf(all, task, R.profile).grant : null;
-        if (!groups.has(g))
-            groups.set(g, { grant: g, msgs: [], task });
-        groups.get(g).msgs.push(m);
-    }
-    return groups;
-};
-//# sourceMappingURL=messages.js.map

package/target/esm/core/agents/turns/pings.js

@@ -1,30 +0,0 @@
-// pings: the watcher answers pings for its agent without waking a model.
-import { append, pongText } from '../../hub/rooms/index.js';
-import { note, short } from '../../../lib/index.js';
-const allowed = (c, m, answered) => {
-    const ping = !m.bad && m.kind === 'ping' && m.to.includes(c.me);
-    const wake = m.hopEff < c.maxHop && (!c.allow || c.allow.has(m.from));
-    return ping && !answered.has(m.id) && wake;
-};
-const answerAuthor = (c, R, msgs, last, answered) => {
-    const at = msgs.findIndex(m => m.id === last);
-    for (const m of msgs.slice(at + 1)) {
-        if (!allowed(c, m, answered))
-            continue;
-        append(R, c.me, pongText(c.me, m, 'has a watcher'));
-        note(`watch: answered heartbeat ${short(m.id)} from ${m.from}`);
-    }
-};
-export const answerWatchPings = (c, R, logs, st) => {
-    const heartbeatSeen = { ...st.heartbeatSeen };
-    const answered = new Set((logs.get(c.me) ?? []).filter(m => m.kind === 'pong').map(m => m.reId));
-    for (const [id, msgs] of logs) {
-        if (id === c.me)
-            continue;
-        answerAuthor(c, R, msgs, heartbeatSeen[id], answered);
-        if (msgs.length)
-            heartbeatSeen[id] = msgs.at(-1).id;
-    }
-    return heartbeatSeen;
-};
-//# sourceMappingURL=pings.js.map

package/target/esm/core/agents/turns/plan.js

@@ -1,29 +0,0 @@
-// plan: one loop's turns: what arrived, grouped and reserved; planning and dispatch take locks in the order grant,
-// reader, sessions.
-import { locked } from '../../hub/ports/index.js';
-import { link } from '../../hub/protocol/index.js';
-import { loadRoomUnlocked, loadState, readerLock, saveState } from '../../hub/history/index.js';
-import { reserveGroups } from './budgets.js';
-import { collectMessages, groupMessages } from './messages.js';
-import { answerWatchPings } from './pings.js';
-const planUnlocked = (c, R) => {
-    const { logs, st } = loadRoomUnlocked(R, c.me);
-    if (st.inflight) {
-        st.seen = st.inflight.seen;
-        st.inflight = undefined;
-        saveState(R, c.me, st);
-    }
-    const all = link(logs), heartbeatSeen = answerWatchPings(c, R, logs, st);
-    const { retry, cursors, go } = collectMessages(c, R, logs, st, all);
-    const p = reserveGroups(c, R, all, groupMessages(R, all, go), st);
-    if (p.lost)
-        return { runs: [], hold: true, lost: true };
-    const pending = [...new Set([...retry.map(m => m.id), ...p.runs.flatMap(r => r.msgs.map(m => m.id))])];
-    saveState(R, c.me, {
-        ...loadState(R, c.me), heartbeatSeen, exhausted: p.exhausted, pending, runs: p.ownRuns,
-        ...(p.hold ? {} : { watched: cursors })
-    });
-    return { runs: p.runs, hold: p.hold, lost: false };
-};
-export const planTurns = (c, R) => locked(`grant-${R.hub.name}`, () => readerLock(R, c.me, () => planUnlocked(c, R)));
-//# sourceMappingURL=plan.js.map

package/target/esm/core/agents/turns/poll.js

@@ -1,48 +0,0 @@
-// poll: each loop renews the watcher's seat and finds its room still there, the same, with its agent a member.
-import { locked } from '../../hub/ports/index.js';
-import { openHub, openRoom, start } from '../../hub/rooms/index.js';
-import { stamp } from '../../../lib/index.js';
-import { dropSession, readSession, saveSession } from '../sessions/index.js';
-const refreshSeat = (c) => locked('sessions', () => {
-    const cur = readSession(c.handle);
-    if (cur?.state === 'active')
-        saveSession({ ...cur, lastSeen: stamp(), pid: process.pid });
-    return cur;
-});
-const currentRoom = (c) => {
-    const H = openHub(c.H0.name, { refresh: true }), R = openRoom(H, c.R0.name, { quiet: true });
-    if (!R || R.genesis !== c.R0.genesis) {
-        locked('sessions', () => { if (readSession(c.handle)?.genesis === c.R0.genesis)
-            dropSession(c.handle); });
-        c.log(`watch: ${c.R0.name} is gone, recreated or archived; ${c.me} left it`);
-        return null;
-    }
-    if (!R.members[c.me]) {
-        c.log(`watch: ${c.me} was removed from ${c.R0.name}; stopping`);
-        return null;
-    }
-    return R;
-};
-const quorum = (c, R) => {
-    const st = start(R);
-    if (st.started)
-        return { done: false, R };
-    if (c.w.once)
-        c.log(`watch: ${c.R0.name} waits for a quorum of ${st.quorum} agents and has ${st.agents}; nothing to do yet`);
-    return { done: !!c.w.once };
-};
-export const pollWatcher = (c) => {
-    const s = refreshSeat(c);
-    if (!s) {
-        c.log(`watch: the seat of ${c.me} was released or taken over; stopping`);
-        return { done: true };
-    }
-    if (s.state === 'stopped') {
-        if (c.w.once)
-            c.log('watch: stopped by the operator');
-        return { done: !!c.w.once };
-    }
-    const R = currentRoom(c);
-    return R ? quorum(c, R) : { done: true };
-};
-//# sourceMappingURL=poll.js.map

package/target/esm/core/agents/turns/results.js

@@ -1,40 +0,0 @@
-// results: a turn's end: its usage receipt settled, and its messages delivered or kept for a retry.
-import { OPERATOR, append } from '../../hub/rooms/index.js';
-import { note } from '../../../lib/index.js';
-import { compose } from '../../hub/protocol/index.js';
-import { loadState, readerLock, saveState } from '../../hub/history/index.js';
-import { dispatch } from './dispatch.js';
-const settle = (c, R, run, result) => append(R, c.me, compose(`usage: settle a run of ${c.me}${result.why ? ` (${result.why})` : ''}`, [['To', OPERATOR], ['Kind', 'usage'], ['Grant', run.grant], ['Usage', 'settle'], ['Run', run.run], ['Seconds', String(result.seconds)], ['Exit', String(result.exit)]]));
-const delivered = (c, R, run, r) => readerLock(R, c.me, () => {
-    const st = loadState(R, c.me), ids = new Set(run.msgs.map(m => m.id));
-    const success = r.code === 0 || r.timedOut;
-    saveState(R, c.me, {
-        ...st, inflight: undefined, ...(success
-            ? { pending: (st.pending ?? []).filter(id => !ids.has(id)) }
-            : { seen: st.inflight?.seen ?? st.seen })
-    });
-});
-const ended = (c, R, run, r) => {
-    note(`watch: exit ${r.code ?? r.signal}${r.timedOut ? ' (stopped at the grant\'s run-seconds)' : ''} after ${r.seconds}s`);
-    if (run.run)
-        settle(c, R, run, { seconds: r.seconds, exit: r.code ?? 128 });
-    delivered(c, R, run, r);
-};
-export const runTurns = async (c, R, runs) => {
-    let exitCode = 0;
-    for (const run of runs) {
-        const next = dispatch(c, R, run);
-        if (next.why) {
-            note(`watch: not starting the next turn: ${next.why}`);
-            if (run.run)
-                settle(c, R, run, { seconds: 0, exit: 125, why: `not started: ${next.why}` });
-            continue;
-        }
-        const r = await next.done;
-        ended(c, R, run, r);
-        if (r.code !== 0 || r.timedOut)
-            exitCode ||= r.code || 128;
-    }
-    return exitCode;
-};
-//# sourceMappingURL=results.js.map

package/target/esm/core/agents/turns/seat.js

@@ -1,44 +0,0 @@
-// seat: the watcher takes its agent's seat, from a dead watcher or by an explicit handoff from the agent's own chat.
-import { locked } from '../../hub/ports/index.js';
-import { config, openHub, openRoom } from '../../hub/rooms/index.js';
-import { fail, stamp } from '../../../lib/index.js';
-import { dropSession, liveness, parseSelector, pidAlive, saveSession, seatHolder, whoAmI } from '../sessions/index.js';
-import { validateWatch } from './limits.js';
-const handoff = (c, holder) => {
-    const own = c.w.handoff && holder?.product !== 'watch' && holder?.handle === whoAmI().handle;
-    if (c.w.handoff && !own)
-        fail('watch --handoff needs the invoking chat to own this seat');
-    if (own && holder.state === 'stopped')
-        fail('this chat is stopped; continue it before a handoff');
-    const live = holder && (holder.product !== 'watch' || (holder.pid && pidAlive(holder.pid)));
-    if (holder && !own && live)
-        fail(`${c.R0.name}/${c.me} is held by session ${holder.handle} (${liveness(holder)}); one seat per agent. Its chat may use watch --handoff`);
-    return !!own;
-};
-const claim = (c) => locked('sessions', () => {
-    const { w, H0, R0, me, handle } = c;
-    const holder = seatHolder(H0.name, R0.genesis, me, handle), handed = handoff(c, holder);
-    if (holder)
-        dropSession(holder.handle);
-    saveSession({
-        handle, product: 'watch', hub: H0.name, room: R0.name, genesis: R0.genesis, agent: me, scope: w.scope ?? holder?.scope ?? null,
-        state: holder?.state === 'stopped' ? 'stopped' : 'active', since: stamp(), lastSeen: stamp(), pid: process.pid,
-        takenFrom: handed ? holder.handle : holder?.takenFrom
-    });
-});
-export const createWatcher = (w, log) => {
-    validateWatch(w);
-    const sel = parseSelector(w.seat), H0 = openHub(sel.hub ?? w.hub ?? config().hub), R0 = openRoom(H0, sel.room), me = sel.agent;
-    if (R0.archived)
-        fail(`${R0.name} is archived`);
-    if (!R0.members[me])
-        fail(`${me} is not a member of ${R0.name}; the operator adds it with a join, or watch another agent`);
-    const raw = `watch-${H0.name}-${R0.genesis.slice(0, 8)}-${me}-${process.pid}`, handle = `env:${raw}`;
-    const c = {
-        w, H0, R0, me, raw, handle, cmd: w.exec, log, interval: (w.interval ?? 5) * 1000,
-        allow: w.from ? new Set(w.from) : null, maxHop: w.maxHop ?? 8, maxRuns: w.maxRuns ?? 10, span: w.window ?? 86400, runSeq: 0
-    };
-    claim(c);
-    return c;
-};
-//# sourceMappingURL=seat.js.map

package/target/esm/core/agents/turns/types.js

@@ -1,3 +0,0 @@
-// types: what the watcher's modules share: its options and context, groups of messages, runs and reservations.
-export {};
-//# sourceMappingURL=types.js.map

package/target/esm/core/hub/decisions/budget.js

@@ -1,40 +0,0 @@
-// budget: what a decision grants (a budget), until when a proposal waits (its due time), and who may decide it.
-import { fail } from '../../../lib/index.js';
-export const ROOT = 'operator';
-const BUDGET_KEYS = ['runs', 'run-seconds', 'concurrency'];
-export const ids = (v) => v === null ? [] : [...new Set(v.split(',').map(x => x.trim()).filter(Boolean))];
-const PART = /^([a-z][a-z-]*)=(\d{1,9})$/;
-// `runs=5, run-seconds=600, concurrency=1`; undefined if malformed. `runs` is required: a budget without a run count
-// bounds nothing; a zero run time or concurrency would disable the bound it names.
-export const parseBudget = (s) => {
-    if (s === null || s === undefined)
-        return null;
-    const b = {};
-    for (const part of String(s).split(',').map(x => x.trim()).filter(Boolean)) {
-        const m = PART.exec(part);
-        if (!m || !BUDGET_KEYS.includes(m[1]) || m[1] in b)
-            return undefined;
-        b[m[1]] = Number(m[2]);
-    }
-    return bounded(b) ? { 'run-seconds': 1800, concurrency: 1, ...b } : undefined;
-};
-const bounded = (b) => 'runs' in b && b['run-seconds'] !== 0 && b.concurrency !== 0;
-export const budgetText = (b) => BUDGET_KEYS.map(k => `${k}=${b[k]}`).join(', ');
-const UNIT = { m: 60e3, h: 3600e3, d: 86400e3 };
-// Relative (`90m`, `2h`, `3d`) or an ISO 8601 time → ISO UTC to the second.
-export const parseDue = (s) => {
-    const rel = /^(\d{1,6})([mhd])$/.exec(s);
-    const t = rel ? Date.now() + Number(rel[1]) * UNIT[rel[2]] : Date.parse(s);
-    if (!Number.isFinite(t))
-        fail(`--due takes 90m, 2h, 3d or an ISO time, not ${s}`);
-    return new Date(t).toISOString().slice(0, 19) + 'Z';
-};
-const within = (cap, budget) => BUDGET_KEYS.every(k => Number.isFinite(cap[k]) && budget[k] <= cap[k]);
-// The root always may; anyone else only within the authority table, and never on their own proposal.
-export const mayDecide = (authority, decider, proposer, budget) => {
-    if (decider === ROOT)
-        return true;
-    const cap = decider === proposer ? undefined : authority?.decide?.[decider];
-    return !!cap && (!budget || within(cap, budget));
-};
-//# sourceMappingURL=budget.js.map

package/target/esm/core/hub/decisions/check.js

@@ -1,43 +0,0 @@
-// check: the extension's trailers are part of a record's validity; a malformed decision record routes nowhere.
-import { ID_RE, one } from '../protocol/index.js';
-import { ids, parseBudget } from './budget.js';
-export const STAMPS = ['approve', 'object', 'abstain'];
-export const DECISIONS = ['approved', 'rejected', 'revoked'];
-const SINGLE = ['decider', 'reviewers', 'due', 'budget', 'supersedes', 'stamp', 'decision', 'control', 'grant', 'usage', 'run', 'seconds', 'exit'];
-const RUN = /^[A-Za-z0-9._:-]{1,128}$/;
-// A trailer absent, or a message id.
-const refOk = (m, k, isRef) => one(m, k) === null || isRef(one(m, k));
-const answers = (m, values, k) => !!m.re && values.includes(one(m, k) ?? '');
-const receipt = (m, isRef) => isRef(one(m, 'grant') ?? '') && ['reserve', 'settle'].includes(one(m, 'usage') ?? '') && RUN.test(one(m, 'run') ?? '');
-const dueOk = (v) => v === null || Number.isFinite(Date.parse(v));
-// What each kind of record must carry, as (wrong, why) in the order the reasons are reported.
-const BY_KIND = {
-    proposal: (m, isRef) => [
-        [() => !ID_RE.test(one(m, 'decider') ?? ''), 'proposal without a valid Decider'],
-        [() => !ids(one(m, 'reviewers')).every(x => ID_RE.test(x)), 'malformed Reviewers'],
-        [() => !dueOk(one(m, 'due')), 'malformed Due'],
-        [() => !refOk(m, 'supersedes', isRef), 'malformed Supersedes'],
-    ],
-    stamp: m => [[() => !answers(m, STAMPS, 'stamp'), 'stamp without Re or a valid Stamp']],
-    decision: m => [[() => !answers(m, DECISIONS, 'decision'), 'decision without Re or a valid Decision']],
-    usage: (m, isRef) => [
-        [() => !receipt(m, isRef), 'malformed usage receipt'],
-        [() => one(m, 'usage') === 'settle' && !/^\d{1,9}$/.test(one(m, 'seconds') ?? ''), 'usage settle without Seconds'],
-    ],
-};
-// Why a record is malformed for this extension, or null.
-export const check = (m, isRef) => {
-    if (m.bad)
-        return null;
-    const twice = SINGLE.find(k => (m.trailers[k]?.length ?? 0) > 1);
-    if (twice)
-        return `duplicate ${twice}`;
-    const rules = [
-        [() => !refOk(m, 'grant', isRef), 'malformed Grant'],
-        [() => !refOk(m, 'control', isRef), 'malformed Control'],
-        [() => one(m, 'budget') !== null && !parseBudget(one(m, 'budget')), 'malformed Budget'],
-        ...BY_KIND[m.kind ?? '']?.(m, isRef) ?? [],
-    ];
-    return rules.find(([wrong]) => wrong())?.[1] ?? null;
-};
-//# sourceMappingURL=check.js.map

package/target/esm/core/hub/decisions/index.js

@@ -1,10 +0,0 @@
-// decide: the extension for decisions and budgets (capability `decisions/1`, docs/spec/decisions-1.md). A proposal circulates
-// to named reviewers, who stamp it; only the named decider, holding authority from the hub's contract, decides. An
-// approval that carries a budget is a grant; work spends against it, and the runner that starts model runs writes
-// the usage receipts. Everything here is a pure fold over messages; nothing trusts a model's own report.
-export const CAPABILITY = 'decisions/1';
-export * from './budget.js';
-export * from './check.js';
-export * from './proposal.js';
-export * from './usage.js';
-//# sourceMappingURL=index.js.map