@idleware/ringi 0.0.0 → 0.1.1

package/README.md

@@ -1,15 +1,20 @@
 # ringi
 
-**Distributed agent coordinator.**
+[![CI](https://github.com/idleware/ringi/actions/workflows/ci.yml/badge.svg?branch=master)](https://github.com/idleware/ringi/actions/workflows/ci.yml)
+[![Maintainability](https://qlty.sh/gh/idleware/projects/ringi/maintainability.svg)](https://qlty.sh/gh/idleware/projects/ringi)
+[![Code Coverage](https://qlty.sh/gh/idleware/projects/ringi/coverage.svg)](https://qlty.sh/gh/idleware/projects/ringi)
+[![npm version](https://img.shields.io/npm/v/@idleware/ringi/latest?label=npm&color=blue)](https://www.npmjs.com/package/@idleware/ringi)
 
-Orchestrators (Hermes, n8n, OpenClaw) run processes: they decide what happens next. ringi decides nothing of the
-kind. It connects the parts, agents of any vendor on one machine or many, and keeps them in sync: who said what to
-whom, who took which work, what it may spend, what came of it. Every message is a stored, checkable record; a peer's
-message is data, never an instruction.
+*Distributed agent coordinator.*
 
-- **Your rules.** A room's profile defines work and who moves it; A2A tasks are one profile.
-- **Budgets.** Proposal, stamps, decision (稟議). The runner spends a grant, never the model.
-- **Signals.** Each counted transition gets a checkable marker beside its message (git: a tag).
+Orchestrators (Hermes, n8n, OpenClaw) run processes and choose the next step. ringi only connects the parts, agents
+of any vendor on one machine or many, and keeps them in sync: who said what to whom, who took which work, what it may
+spend, what came of it. Everything is a stored, checkable record; whatever a peer writes is data, never an
+instruction.
+
+- **Your rules.** A room's profile defines work and who moves it; A2A tasks ship as one of them.
+- **Budgets.** Proposal, stamps, decision ([稟議](https://en.wikipedia.org/wiki/Japanese_management_culture#Managerial_style)). The runner spends a grant, never the model.
+- **Signals.** Each counted transition is marked beside its message (git: a tag).
 - **Any store.** Git first; one CLI and a skill for you and the agents.
 
 ```sh
@@ -17,7 +22,7 @@ npm i -g @idleware/ringi
 ringi skill install
 ```
 
-Node.js 24 or later.
+Node.js 16 or later.
 
 ## Local: one machine, several agents
 
@@ -51,7 +56,7 @@ Codex: add `~/.ringi` to `writable_roots` in `~/.codex/config.toml`, or approve
 ```
 
 1. `ringi hub create team --signed --url <git url>` prints the `ringi hub add …` line for the other machines.
-2. There, `ringi join team fix --as codex` prints the agent's key; you run `ringi room admit codex '<key>' --room fix`.
+2. There, `ringi join team fix --as codex` shows the agent's key; you run `ringi room admit codex '<key>' --room fix`.
 3. `ringi watch team:fix/codex --require-grant --exec 'codex exec "…"'`
 
 ## Your own profile

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@idleware/ringi",
-  "version": "0.0.0",
+  "version": "0.1.1",
   "description": "Distributed agent coordinator",
   "keywords": [
     "agents",
@@ -31,6 +31,7 @@
   "types": "target/dts/index.d.ts",
   "files": [
     "target/esm",
+    "!target/esm/**/*.map",
     "target/dts",
     "src/main/resources"
   ],
@@ -38,13 +39,14 @@
     "build": "tsc -p tsconfig.json && node -e \"require('fs').chmodSync('target/esm/cli.js', 0o755)\"",
     "test": "npm run build && tsc -p tsconfig.test.json && node --test --test-reporter=spec src/test/ts/*.test.ts",
     "test:conformance": "node --test --test-reporter=spec src/test/ts/ringi.test.ts src/test/ts/model.test.ts src/test/ts/flow.test.ts",
-    "commands": "node target/esm/cli.js help --md > COMMANDS.md"
-  },
-  "engines": {
-    "node": ">=24"
+    "commands": "node target/esm/cli.js help --md > COMMANDS.md",
+    "release": "npx --yes zx-semrel@1.25.1",
+    "test:coverage": "npm run build && tsc -p tsconfig.test.json && c8 --reporter=lcov --reporter=text-summary --report-dir=target/coverage --exclude-after-remap --include='src/main/ts/**' node --test src/test/ts/*.test.ts",
+    "test:smoke": "node --test --test-reporter=spec src/test/ts/flow.test.ts"
   },
   "devDependencies": {
-    "@types/node": "24.19.2",
+    "@types/node": "26.6.3",
+    "c8": "12.0.0",
     "typescript": "7.0.2"
   },
   "publishConfig": {

package/target/esm/app/agent.js

@@ -81,3 +81,4 @@ export const wait = async (a, { max = 120, ...options } = {}) => {
         await sleep(Math.min(1000, max * 1000 - (now - start)));
     }
 };
+//# sourceMappingURL=agent.js.map

package/target/esm/app/budget.js

@@ -92,3 +92,4 @@ export const grants = ({ R, me }) => {
     return D.proposals(all, R.authorityAt).filter(x => x.grant).map(x => grantView(x, D.usageOf(all, x.grant)));
 };
 export { DECISIONS, STAMPS, budgetText } from '../domain/decisions.js';
+//# sourceMappingURL=budget.js.map

package/target/esm/app/context.js

@@ -13,3 +13,4 @@ export const operator = ({ hub, room } = {}) => {
 export const agent = () => bound();
 export const about = () => ({ version: VERSION, home: HOME, resources: RESOURCES, contract: `${HUB_MAJOR}.x`, capabilities: [...CAPS] });
 export { config };
+//# sourceMappingURL=context.js.map

package/target/esm/app/hubs.js

@@ -73,3 +73,4 @@ export const amend = (H, x) => {
     H.store.amendContract(OPERATOR, compose(x.text, [['To', '*'], ['Kind', 'hub']]), files);
     return { version: String(contract.version) };
 };
+//# sourceMappingURL=hubs.js.map

package/target/esm/app/overview.js

@@ -36,3 +36,4 @@ export const forgetSession = (handle) => locked('sessions', () => {
         fail(`no session ${handle}`);
     dropSession(handle);
 });
+//# sourceMappingURL=overview.js.map

package/target/esm/app/room.js

@@ -124,3 +124,4 @@ export const signals = ({ R, me }, { repair = false } = {}) => readerLock(R, me,
 // What interfaces need to show and store a message's files: their sizes, and a path safe to write under.
 export { withSizes } from '../hub/index.js';
 export { checkPath } from '../protocol/files.js';
+//# sourceMappingURL=room.js.map

package/target/esm/app/rooms.js

@@ -117,3 +117,4 @@ export const forgetLog = (H, R, id) => {
     }
     return n;
 };
+//# sourceMappingURL=rooms.js.map

package/target/esm/app/session.js

@@ -94,3 +94,4 @@ export const leave = () => locked('sessions', () => {
     dropSession(s.handle);
     return s;
 });
+//# sourceMappingURL=session.js.map

package/target/esm/app/view.js

@@ -49,3 +49,4 @@ export const proposalView = (x) => ({ id: x.proposal.id, subject: x.proposal.sub
     decider: x.decider, state: x.state, budget: x.budget, stamps: x.stamps, missing: x.missing });
 export const grantView = (x, usage) => ({ grant: x.grant.id, proposal: x.proposal.id,
     subject: x.proposal.subject, budget: x.grant.budget, revoked: x.grant.revoked, usage });
+//# sourceMappingURL=view.js.map

package/target/esm/cli/agent.js

@@ -37,3 +37,4 @@ export const wait = async (a, o) => {
     out(`wait: nothing for ${a.me} in ${Math.round(r.seconds)}s`);
     process.exitCode = 3;
 };
+//# sourceMappingURL=agent.js.map

package/target/esm/cli/args.js

@@ -58,3 +58,4 @@ export const attachments = (spec) => {
         return [{ path: dest, file: src, mode: mode(src) }];
     return walk(src).map(f => ({ path: checkPath(`${dest}/${path.relative(src, f).split(path.sep).join('/')}`), file: f, mode: mode(f) }));
 };
+//# sourceMappingURL=args.js.map

package/target/esm/cli/context.js

@@ -5,3 +5,4 @@ import { opt } from './args.js';
 export { isRef } from '../app/room.js';
 export const parseTo = (v) => [...new Set(words(v))];
 export const operatorCtx = (o) => Context.operator({ hub: opt(o, 'hub'), room: opt(o, 'room') });
+//# sourceMappingURL=context.js.map

package/target/esm/cli/index.js

@@ -122,3 +122,4 @@ export const main = async (argv = process.argv.slice(2)) => {
         fail(`${cmd} is an agent command: ringi agent ${cmd}`);
     fail(`unknown command ${cmd}; see ringi help`);
 };
+//# sourceMappingURL=index.js.map

package/target/esm/cli/operator.js

@@ -144,3 +144,4 @@ export const roomCmd = (o) => {
     }
     fail(`unknown: room ${sub}`);
 };
+//# sourceMappingURL=operator.js.map

package/target/esm/cli/session.js

@@ -36,3 +36,4 @@ export const leave = () => {
     const s = Session.leave();
     out(`left ${s.hub}/${s.room}: the seat of ${s.agent} is free; ${s.agent} stays a member until the operator removes it`);
 };
+//# sourceMappingURL=session.js.map

package/target/esm/cli/shared.js

@@ -140,3 +140,4 @@ export const grants = (a, o) => {
         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=shared.js.map

package/target/esm/cli/skill.js

@@ -51,3 +51,4 @@ in ~/.codex/config.toml. Otherwise agents re-run ringi commands with sandbox esc
         return void process.stdout.write(fs.readFileSync(path.join(SKILL, 'SKILL.md'), 'utf8'));
     fail('usage: ringi skill install [--project] | uninstall [--project] | status | show');
 };
+//# sourceMappingURL=skill.js.map

package/target/esm/cli.js

@@ -11,3 +11,4 @@ if (process.argv[1] && fs.realpathSync(process.argv[1]) === fileURLToPath(import
         process.exitCode = 1;
     });
 }
+//# sourceMappingURL=cli.js.map

package/target/esm/domain/decisions.js

@@ -175,3 +175,4 @@ export const usageOf = (all, grant, now = Date.now() / 1000) => {
     const open = unsettled.filter(m => now - m.time <= grant.budget['run-seconds'] + 60);
     return { runs: reserves.length, open: open.length, uncertain: unsettled.length - open.length, seconds, left: Math.max(0, grant.budget.runs - reserves.length) };
 };
+//# sourceMappingURL=decisions.js.map

package/target/esm/domain/index.js

@@ -13,3 +13,4 @@ export const unenforceable = (ids) => {
     const unknown = ids.filter(id => !CAPABILITIES[id]);
     return unknown.length ? `requires ${unknown.join(', ')}` : null;
 };
+//# sourceMappingURL=index.js.map

package/target/esm/domain/profiles.js

@@ -93,3 +93,4 @@ export const taskOf = (all, root, profile) => {
 };
 export const tasksIn = (all, profile) => [...all.values()].filter(m => m.kind === profile.opens && !m.bad).map(r => taskOf(all, r, profile));
 export const isOpen = (t, profile) => !profile.terminal.includes(t.state);
+//# sourceMappingURL=profiles.js.map

package/target/esm/domain/signals.js

@@ -126,3 +126,4 @@ export const pins = (records, checked, accepted = {}) => {
             next[keyOf(c.ref)] = now.get(keyOf(c.ref)).object;
     return { accepted: next, alarms };
 };
+//# sourceMappingURL=signals.js.map

package/target/esm/home/index.js

@@ -85,3 +85,4 @@ export const locked = (name, fn) => {
 export const configFile = () => path.join(HOME, 'config.json');
 export const config = () => ({ hub: 'local', room: null, ...readJson(configFile(), {}) });
 export const setConfig = (patch) => writeJson(configFile(), { ...config(), ...patch });
+//# sourceMappingURL=index.js.map

package/target/esm/hub/index.js

@@ -209,3 +209,4 @@ export const withSizes = (R, m) => {
 };
 export const pongText = (me, m, what) => compose(`pong: ${me} ${what}`, [['To', m.from], ['Re', m.id], ['Kind', 'pong'], ['Hop', String(m.hopEff + 1)]]);
 export { OPERATOR, HIDDEN };
+//# sourceMappingURL=index.js.map

package/target/esm/hub/signals.js

@@ -24,3 +24,4 @@ export const emit = (R, who, all, m) => {
     }
     return n;
 };
+//# sourceMappingURL=signals.js.map

package/target/esm/index.js

@@ -6,3 +6,4 @@ export * as decide from './domain/decisions.js';
 export * as signals from './domain/signals.js';
 export { STORES } from './store/index.js';
 export { openHub, openRoom, createHub, contractAt } from './hub/index.js';
+//# sourceMappingURL=index.js.map

package/target/esm/lib/index.js

@@ -199,3 +199,4 @@ export const guardWrite = (where, fn) => {
     }
 };
 export const mkdirIn = (where, d) => { guardWrite(where, () => fs.mkdirSync(d, { recursive: true, mode: 0o700 })); };
+//# sourceMappingURL=index.js.map

package/target/esm/protocol/files.js

@@ -16,3 +16,4 @@ export const checkCollisions = (paths) => {
         seen.set(k, p);
     }
 };
+//# sourceMappingURL=files.js.map

package/target/esm/protocol/index.js

@@ -214,3 +214,4 @@ export const unread = (logs, id, cursors, limit = Infinity, hidden) => {
     }
     return { msgs: shown, rest: queue.length - shown.length, cursors: next };
 };
+//# sourceMappingURL=index.js.map

package/target/esm/runtime/reader.js

@@ -61,3 +61,4 @@ export const linked = (R, reader) => {
     const { logs } = loadRoom(R, reader);
     return { logs, all: link(logs) };
 };
+//# sourceMappingURL=reader.js.map

package/target/esm/runtime/session.js

@@ -109,3 +109,4 @@ export const parseSelector = (sel) => {
     const m = /^(?:([a-z0-9._-]+):)?([^/]+)\/([^/]+)$/.exec(sel ?? '');
     return m ? { hub: m[1] ?? null, room: m[2], agent: m[3] } : fail('a session is named <room>/<agent> or <hub>:<room>/<agent>');
 };
+//# sourceMappingURL=session.js.map

package/target/esm/runtime/watch.js

@@ -301,3 +301,4 @@ export const watch = async (w, log = note) => {
         await sleep(interval);
     }
 };
+//# sourceMappingURL=watch.js.map

package/target/esm/store/git/index.js

@@ -343,3 +343,4 @@ export class GitStore {
     rootKey() { return this.d.root ?? fail(`hub ${this.d.name} has no pinned root`); }
     rootRoster() { return Remote.rootRoster(this.h); }
 }
+//# sourceMappingURL=index.js.map

package/target/esm/store/git/remote.js

@@ -697,3 +697,4 @@ export const forget = (H, R, who) => {
             delete H.remoteAlarms[ref];
     });
 };
+//# sourceMappingURL=remote.js.map

package/target/esm/store/index.js

@@ -12,3 +12,4 @@ import { kafka } from './kafka/index.js';
 import { temporal } from './temporal/index.js';
 // The store types this ringi knows. Another type is a directory here implementing Store, and an entry below.
 export const STORES = { git: (dir, d, home) => new GitStore(dir, d, home), kafka, temporal };
+//# sourceMappingURL=index.js.map

package/target/esm/store/kafka/index.js

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

package/target/esm/store/temporal/index.js

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