@idleware/ringi 0.6.1 → 0.7.0

package/target/dts/core/hub/decisions/usage.d.ts

@@ -1,12 +0,0 @@
-import type { All, Message } from '../protocol/index.ts';
-import type { AuthorityAt } from './budget.ts';
-import type { Grant } from './proposal.ts';
-export type Usage = {
-    runs: number;
-    open: number;
-    uncertain: number;
-    seconds: number;
-    left: number;
-};
-export declare const counted: (all: All, authorityAt: AuthorityAt, m: Message) => boolean;
-export declare const usageOf: (all: All, grant: Grant, now?: number) => Usage;

package/target/dts/core/hub/usecases/budget.d.ts

@@ -1,23 +0,0 @@
-import * as D from '../decisions/index.ts';
-import type { Message } from '../protocol/index.ts';
-import type { Actor } from './actor.ts';
-import type { GrantView, ProposalView } from './view.ts';
-export declare const stamp: ({ R, me }: Actor, ref: string, s: string, text: string) => {
-    proposal: Message;
-    id: string;
-};
-export declare const decide: ({ R, me }: Actor, ref: string, d: string, text: string) => {
-    proposal: Message;
-    id: string;
-    budget: D.Budget | null;
-};
-export declare const proposals: ({ R, me }: Actor, { all: everything }?: {
-    all?: boolean;
-}) => {
-    proposals: D.Proposal[];
-    views: ProposalView[];
-};
-export declare const grants: ({ R, me }: Actor) => GrantView[];
-export { propose } from './propose.ts';
-export type { ProposeInput } from './propose.ts';
-export { DECISIONS, STAMPS, budgetText } from '../decisions/index.ts';

package/target/dts/core/hub/usecases/propose.d.ts

@@ -1,17 +0,0 @@
-import * as D from '../decisions/index.ts';
-import type { Entry } from '../protocol/files.ts';
-import type { Actor } from './actor.ts';
-export type ProposeInput = {
-    text: string;
-    decider: string;
-    reviewers?: string[];
-    budget?: string;
-    due?: string;
-    supersedes?: string;
-    files?: Entry[];
-};
-export declare const propose: ({ R, me }: Actor, x: ProposeInput) => {
-    id: string;
-    to: string[];
-    budget: D.Budget | null;
-};

package/target/esm/adapters/host-posix/group-state.js

@@ -1,24 +0,0 @@
-// group-state: process-group membership and whether its observed members have finished; only Z is a zombie.
-export const procMember = (text) => {
-    const close = text.lastIndexOf(')');
-    if (!/^\d+ \(/.test(text) || close < 0)
-        return null;
-    const fields = text.slice(close + 1).trim().split(/\s+/);
-    const group = Number(fields[2]), state = fields[0];
-    return /^[A-Za-z]$/.test(state) && Number.isSafeInteger(group) && group >= 0 ? { group, state } : null;
-};
-export const psMember = (text) => {
-    const match = /^\s*(\d+)\s+([A-Za-z][^\s]*)\s*$/.exec(text);
-    if (!match)
-        return null;
-    const group = Number(match[1]);
-    return Number.isSafeInteger(group) ? { group, state: match[2][0] } : null;
-};
-// No matching row, or an unreadable row that might belong to this group, cannot prove it is quiescent.
-export const groupRunning = (group, members) => {
-    const own = members.filter(m => m?.group === group);
-    if (own.some(m => m.state !== 'Z'))
-        return true;
-    return own.length && members.every(m => m !== null) ? false : null;
-};
-//# sourceMappingURL=group-state.js.map

package/target/esm/adapters/host-posix/groups.js

@@ -1,43 +0,0 @@
-// groups: a turn's POSIX group is settled once every observed member is a zombie; failed probes stay conservative.
-import fs from 'node:fs';
-import { spawnSync } from 'node:child_process';
-import { groupRunning, procMember, psMember } from './group-state.js';
-const exists = (group) => {
-    try {
-        process.kill(-group, 0);
-        return true;
-    }
-    catch (e) {
-        return e.code !== 'ESRCH';
-    }
-};
-const procMembers = () => {
-    try {
-        return fs.readdirSync('/proc').filter(p => /^\d+$/.test(p)).flatMap(pid => {
-            try {
-                return [procMember(fs.readFileSync(`/proc/${pid}/stat`, 'utf8'))];
-            }
-            catch (e) {
-                return e.code === 'ENOENT' || e.code === 'ESRCH' ? [] : [null];
-            }
-        });
-    }
-    catch {
-        return null;
-    }
-};
-const psMembers = () => {
-    const result = spawnSync('ps', ['-A', '-o', 'pgid=,stat='], { encoding: 'utf8', timeout: 1000 });
-    return result.status === 0 ? result.stdout.split('\n').filter(line => line.trim()).map(psMember) : null;
-};
-export const groupAlive = (group) => {
-    if (!exists(group))
-        return false;
-    const proc = process.platform === 'linux' ? procMembers() : null;
-    const known = proc && groupRunning(group, proc);
-    if (known !== null)
-        return known;
-    const rows = psMembers(), observed = rows && groupRunning(group, rows);
-    return observed ?? exists(group);
-};
-//# sourceMappingURL=groups.js.map

package/target/esm/adapters/host-posix/launch.js

@@ -1,80 +0,0 @@
-// host-posix launch: an isolated shell turn settles its group before its result, as the watcher did before this
-// adapter. Detached argv launches leave the caller's event loop. Only this module knows POSIX group signals.
-import { spawn } from 'node:child_process';
-import { sleep } from '../../lib/index.js';
-import { groupAlive } from './groups.js';
-const GRACE = 5000;
-const signalGroup = (pid, sig) => {
-    if (pid)
-        try {
-            process.kill(-pid, sig);
-        }
-        catch { }
-};
-const detachedSettlement = async (pid) => {
-    while (pid && groupAlive(pid))
-        await new Promise(resolve => { setTimeout(resolve, 50).unref(); });
-};
-const settle = async (pid) => {
-    if (!pid)
-        return;
-    signalGroup(pid, 'SIGTERM');
-    const until = Date.now() + GRACE;
-    while (groupAlive(pid) && Date.now() < until)
-        await sleep(50);
-    if (groupAlive(pid))
-        signalGroup(pid, 'SIGKILL');
-    while (groupAlive(pid))
-        await sleep(50);
-};
-const detached = (r, clock) => {
-    const at = clock.wall(), child = spawn(r.file, [...r.args], { stdio: 'ignore', env: r.env, detached: true });
-    let finished = false;
-    const done = new Promise((resolve, reject) => {
-        child.once('error', e => { finished = true; reject(e); });
-        child.once('exit', (code, signal) => {
-            void detachedSettlement(child.pid).then(() => {
-                finished = true;
-                resolve({ code, signal, timedOut: false, seconds: Math.round((clock.wall() - at) / 1000) });
-            }, reject);
-        });
-    });
-    child.unref();
-    // Fire-and-forget launches still handle spawn failures without an unhandled rejection.
-    void done.catch(() => { });
-    return { done, stop: () => { if (!finished)
-            signalGroup(child.pid, 'SIGTERM'); } };
-};
-const shell = (r, clock) => {
-    const at = clock.wall(), child = spawn('sh', ['-c', r.shell], { stdio: 'inherit', env: r.env, detached: true });
-    let timedOut = false, finished = false;
-    const stop = () => { if (!finished)
-        signalGroup(child.pid, 'SIGTERM'); };
-    const done = new Promise((resolve, reject) => {
-        let hard;
-        const timer = r.timeout ? setTimeout(() => {
-            timedOut = true;
-            signalGroup(child.pid, 'SIGTERM');
-            hard = setTimeout(() => signalGroup(child.pid, 'SIGKILL'), GRACE);
-        }, r.timeout * 1000) : undefined;
-        const cleanup = () => {
-            clearTimeout(timer);
-            clearTimeout(hard);
-            process.removeListener('SIGINT', stop);
-            process.removeListener('SIGTERM', stop);
-        };
-        process.once('SIGINT', stop);
-        process.once('SIGTERM', stop);
-        child.once('error', e => { finished = true; cleanup(); reject(e); });
-        child.once('exit', (code, signal) => {
-            cleanup();
-            void settle(child.pid).then(() => {
-                finished = true;
-                resolve({ code, signal, timedOut, seconds: Math.round((clock.wall() - at) / 1000) });
-            }, reject);
-        });
-    });
-    return { done, stop };
-};
-export const launch = (request, clock) => 'shell' in request ? shell(request, clock) : detached(request, clock);
-//# sourceMappingURL=launch.js.map

package/target/esm/adapters/host-posix/probes.js

@@ -1,66 +0,0 @@
-// host-posix probes: process existence, ancestry and CPU samples on macOS/Linux. Unavailable CPU probes stay null.
-import { spawnSync } from 'node:child_process';
-import fs from 'node:fs';
-import path from 'node:path';
-import { procStat, seconds } from './stats.js';
-export const supported = process.platform === 'darwin' || process.platform === 'linux';
-export const alive = (pid) => {
-    try {
-        process.kill(pid, 0);
-        return true;
-    }
-    catch (e) {
-        return e.code === 'EPERM';
-    }
-};
-const proc = () => {
-    let pids;
-    try {
-        pids = fs.readdirSync('/proc').filter(d => /^\d+$/.test(d));
-    }
-    catch {
-        return null;
-    }
-    const rows = new Map();
-    for (const pid of pids) {
-        try {
-            const row = procStat(fs.readFileSync(`/proc/${pid}/stat`, 'utf8'));
-            if (row)
-                rows.set(Number(pid), row);
-        }
-        catch { /* the process ended meanwhile */ }
-    }
-    return rows.size ? rows : null;
-};
-export const snapshot = () => {
-    if (!supported)
-        return null;
-    if (process.platform === 'linux') {
-        const rows = proc();
-        if (rows)
-            return rows;
-    }
-    const r = spawnSync('ps', ['-A', '-o', 'pid=,ppid=,time='], { encoding: 'utf8', timeout: 10000 });
-    if (r.status !== 0)
-        return null;
-    const rows = new Map();
-    for (const line of r.stdout.split('\n')) {
-        const [pid, ppid, time] = line.trim().split(/\s+/);
-        if (pid && time)
-            rows.set(Number(pid), { ppid: Number(ppid), cpu: seconds(time) });
-    }
-    return rows;
-};
-export const ancestors = (first) => {
-    const result = [];
-    for (let pid = first, i = 0; i < 12 && pid > 1; i++) {
-        const r = spawnSync('ps', ['-o', 'ppid=,comm=', '-p', String(pid)], { encoding: 'utf8' });
-        const m = r.status === 0 ? /^\s*(\d+)\s+(.*)$/.exec(String(r.stdout ?? '').trim()) : null;
-        if (!m)
-            break;
-        result.push({ pid, name: path.basename(m[2].trim()).toLowerCase() });
-        pid = Number(m[1]);
-    }
-    return result;
-};
-//# sourceMappingURL=probes.js.map

package/target/esm/adapters/host-posix/stats.js

@@ -1,27 +0,0 @@
-// host-posix stats: parsing and folding of process CPU samples; no probes, files or platform selection.
-// Cumulative CPU time: [DD-][HH:]MM:SS[.ss].
-export const seconds = (time) => {
-    const [days, rest] = time.includes('-') ? [Number(time.split('-')[0]), time.split('-')[1]] : [0, time];
-    return days * 86400 + rest.split(':').reduce((acc, part) => acc * 60 + Number(part), 0);
-};
-// A parenthesized command may itself contain spaces or parentheses; fields follow its last closing parenthesis.
-export const procStat = (line) => {
-    const f = line.slice(line.lastIndexOf(')') + 2).split(' ');
-    const ppid = Number(f[1]), cpu = (Number(f[11]) + Number(f[12])) / 100;
-    return Number.isFinite(ppid) && Number.isFinite(cpu) ? { ppid, cpu } : null;
-};
-export const treeCpu = (pid, rows) => {
-    if (!rows?.has(pid))
-        return null;
-    const children = new Map();
-    for (const [p, { ppid }] of rows)
-        children.set(ppid, [...children.get(ppid) ?? [], p]);
-    let sum = 0;
-    for (const stack = [pid]; stack.length;) {
-        const p = stack.pop();
-        sum += rows.get(p)?.cpu ?? 0;
-        stack.push(...children.get(p) ?? []);
-    }
-    return sum;
-};
-//# sourceMappingURL=stats.js.map

package/target/esm/adapters/transport-kafka/index.js

@@ -1,4 +0,0 @@
-import { fail } from '../../lib/index.js';
-const planned = (d) => fail(`hub ${d.name}: the kafka store is planned and not implemented in this ringi`);
-export const kafka = { layout: 'kafka/1', open: (_at, d) => planned(d), create: (_at, d) => planned(d) };
-//# sourceMappingURL=index.js.map

package/target/esm/adapters/transport-temporal/index.js

@@ -1,4 +0,0 @@
-import { fail } from '../../lib/index.js';
-const planned = (d) => fail(`hub ${d.name}: the temporal store is planned and not implemented in this ringi`);
-export const temporal = { layout: 'temporal/1', open: (_at, d) => planned(d), create: (_at, d) => planned(d) };
-//# sourceMappingURL=index.js.map

package/target/esm/clients/cli/operator/room-lifecycle.js

@@ -1,23 +0,0 @@
-// room-lifecycle: `ringi room archive | delete | rebase-contract`.
-import * as Rooms from '../../../core/hub/usecases/rooms.js';
-import { fail, short } from '../../../lib/index.js';
-import { flag, opt, out } from '../args.js';
-export const archiveRoom = (H, arg, o) => {
-    // Without an id, the room of the current context.
-    const R = Rooms.roomIn(H, arg ?? opt(o, 'room'));
-    const name = Rooms.archive(H, R);
-    return out(`archived ${R.name} as ${name}: read-only, wakes nobody; its sessions end. Read it with --room ${name}`);
-};
-export const deleteRoom = (H, arg, o) => {
-    const R = Rooms.roomIn(H, arg ?? opt(o, 'room'));
-    if (!flag(o, 'yes'))
-        fail(`deleting ${R.name} in hub ${H.name} erases it and everything kept for it, for good. Run again with --yes, or archive it instead`);
-    Rooms.erase(H, R);
-    return out(`deleted room ${R.name}: its branch, signals, pins, evidence and readers' state. Sessions bound to it leave it on their next turn`);
-};
-export const rebaseRoomContract = (H, arg, o) => {
-    const R = Rooms.roomIn(H, arg ?? fail('usage: ringi room rebase-contract <id>'));
-    Rooms.rebase(H, R);
-    return out(`room ${R.name} now follows the hub contract at ${short(H.main)} (${H.contract.version})`);
-};
-//# sourceMappingURL=room-lifecycle.js.map

package/target/esm/clients/cli/operator/room-list.js

@@ -1,27 +0,0 @@
-// room-list: `ringi room list | create | switch`.
-import { roomsActive } from '../../../core/agents/overview.js';
-import * as Rooms from '../../../core/hub/usecases/rooms.js';
-import { fail, short } from '../../../lib/index.js';
-import { flag, opt, out } from '../args.js';
-export const listRoom = (H, arg, o) => {
-    const rs = roomsActive(H, { archived: flag(o, 'archived') });
-    for (const r of rs.filter(r => !r.archived))
-        out(`${r.current ? '*' : ' '} ${r.name.padEnd(16)} ${r.members} member(s), ${r.active} active session(s), profile ${r.profile}  genesis ${short(r.genesis)}`);
-    for (const r of rs.filter(r => r.archived))
-        out(`  ${r.name.padEnd(16)} archived, read-only`);
-    if (!rs.length && !flag(o, 'archived'))
-        out(`no rooms in hub ${H.name}: ringi room create <id>`);
-    return;
-};
-export const createRoom = (H, arg, o) => {
-    const quorum = opt(o, 'quorum');
-    const r = Rooms.create(H, arg ?? '', { profile: opt(o, 'profile'), quorum: quorum === undefined ? undefined : Number(quorum) });
-    if (quorum !== undefined)
-        return out(`created room ${arg} in hub ${H.name} with profile ${r.profile}; it is the current room. Its work starts by itself at a quorum of ${quorum} agent(s): in each chat that should take part, say "join ${arg} as <id>"`);
-    return out(`created room ${arg} in hub ${H.name} with profile ${r.profile}; it is the current room. In each chat that should take part, say: "join ${arg} as <id>; <what to accept>"`);
-};
-export const switchRoom = (H, arg, o) => {
-    const R = Rooms.use(H, arg ?? fail('usage: ringi room switch <id>'));
-    return out(`current room: ${H.name}/${R.name}; agents keep their own rooms`);
-};
-//# sourceMappingURL=room-list.js.map

package/target/esm/clients/cli/operator/room-members.js

@@ -1,15 +0,0 @@
-// room-members: `ringi room admit | remove`.
-import * as Rooms from '../../../core/hub/usecases/rooms.js';
-import { fail } from '../../../lib/index.js';
-import { opt, out } from '../args.js';
-export const admitRoom = (H, arg, o) => {
-    const R = Rooms.roomIn(H, opt(o, 'room'));
-    Rooms.admit(H, R, arg ?? fail('usage: ringi room admit <agent> <public key|file>'), o._[2] ?? fail('usage: ringi room admit <agent> <public key|file>'));
-    return out(`admitted ${arg} to ${H.name}/${R.name}: its signed messages are accepted from now on; it can join`);
-};
-export const removeRoom = (H, arg, o) => {
-    const R = Rooms.roomIn(H, opt(o, 'room'));
-    Rooms.remove(H, R, arg ?? fail('usage: ringi room remove <agent>'));
-    return out(`removed ${arg} from ${R.name}: it can no longer write or be woken there; returning needs a fresh join`);
-};
-//# sourceMappingURL=room-members.js.map

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