instar 1.3.1339 → 1.3.1341

package/dist/threadline/peerDark.js

@@ -0,0 +1,204 @@
+/**
+ * peerDark — honest sender-side reporting of a send that stays queued
+ * (docs/specs/a2a-single-agent-identity.md §3).
+ *
+ * A peer is `dark` when my own delivery ledger shows messages to it queued,
+ * unconfirmed or expired for longer than `queuedDarkAfterMs` with nothing back
+ * (no ack, no inbound, no `delivered` verdict) since. It is a PROXY read from my
+ * ledger: it means "nothing from this peer for N h" and cannot by itself tell
+ * offline from wrong-address — so every sentence here is worded to the evidence.
+ *
+ * This module holds the pure pieces the route, the MCP tool and the reworked
+ * A2ARedeliverySentinel share: the config resolver (dev-gated, dry-run first),
+ * the peer label (fingerprint prefix + clamped, HTML-escaped display name), the
+ * `deliveryOutcome` sentence, and the would-raise / would-sentence audit writer
+ * for `logs/a2a-peer-dark.jsonl`. No decision here gates a send.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { resolveDevAgentGate } from '../core/devAgentGate.js';
+/** Default: a peer with nothing back for 2 h is dark (below the 6 h `stale` window so the sender hears first). */
+export const DEFAULT_QUEUED_DARK_AFTER_MS = 2 * 60 * 60 * 1000;
+/** Default per-peer cooldown between two dark items for the same peer. */
+export const DEFAULT_PEER_DARK_COOLDOWN_MS = 12 * 60 * 60 * 1000;
+/** Floors so a mis-set config cannot page on every send or never page. */
+export const MIN_QUEUED_DARK_AFTER_MS = 5 * 60 * 1000;
+export const MIN_PEER_DARK_COOLDOWN_MS = 60 * 1000;
+/** Bound on configured per-peer entries (a config map, not a ledger). */
+export const PEER_DARK_PER_PEER_MAX = 200;
+function resolvePerPeer(raw) {
+    // Null-prototype: a fingerprint is peer-chosen text and must never hit an inherited key.
+    const out = Object.create(null);
+    if (!raw || typeof raw !== 'object' || Array.isArray(raw))
+        return out;
+    let n = 0;
+    for (const [fp, v] of Object.entries(raw)) {
+        if (n >= PEER_DARK_PER_PEER_MAX)
+            break;
+        const ms = v?.queuedDarkAfterMs;
+        if (typeof fp !== 'string' || !fp.trim() || typeof ms !== 'number' || !Number.isFinite(ms))
+            continue;
+        out[fp.trim().toLowerCase()] = { queuedDarkAfterMs: Math.max(MIN_QUEUED_DARK_AFTER_MS, ms) };
+        n++;
+    }
+    return out;
+}
+/** The dark threshold that applies to ONE peer: its per-peer entry, else the default. */
+export function queuedDarkAfterMsFor(cfg, peerFp) {
+    const key = String(peerFp ?? '').trim().toLowerCase();
+    const entry = cfg.perPeer && Object.prototype.hasOwnProperty.call(cfg.perPeer, key) ? cfg.perPeer[key] : undefined;
+    return entry && typeof entry.queuedDarkAfterMs === 'number' ? entry.queuedDarkAfterMs : cfg.queuedDarkAfterMs;
+}
+function finiteOr(v, fallback, floor) {
+    const n = typeof v === 'number' && Number.isFinite(v) ? v : fallback;
+    return Math.max(floor, n);
+}
+/**
+ * Resolve `threadline.peerDarkNotice`. `enabled` omitted ⇒ the developmentAgent
+ * gate (live on a dev agent, dark on the fleet); an explicit value always wins.
+ * `liveEnabled` lets a caller pass a live-config read ahead of the boot config.
+ */
+export function resolvePeerDarkNoticeConfig(config, liveEnabled) {
+    const raw = config?.threadline?.peerDarkNotice ?? {};
+    const explicit = liveEnabled ?? raw.enabled;
+    return {
+        enabled: resolveDevAgentGate(explicit, config),
+        dryRun: raw.dryRun ?? true,
+        queuedDarkAfterMs: finiteOr(raw.queuedDarkAfterMs, DEFAULT_QUEUED_DARK_AFTER_MS, MIN_QUEUED_DARK_AFTER_MS),
+        perPeer: resolvePerPeer(raw.perPeer),
+        cooldownMs: finiteOr(raw.cooldownMs, DEFAULT_PEER_DARK_COOLDOWN_MS, MIN_PEER_DARK_COOLDOWN_MS),
+    };
+}
+/** The read when there is no relay client at all (a standby, or relay off). */
+export const PRESENCE_RELAY_DOWN = { connectedNow: null, connectedNowReason: 'relay-down', connectedAsOf: null };
+function ageMinutes(iso, nowMs) {
+    if (!iso)
+        return null;
+    const t = Date.parse(iso);
+    if (Number.isNaN(t))
+        return null;
+    return Math.max(0, Math.round((nowMs - t) / 60_000));
+}
+export function escapeHtml(text) {
+    return text
+        .replace(/&/g, '&')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;')
+        .replace(/'/g, '&#39;');
+}
+export const PEER_LABEL_NAME_MAX = 40;
+/**
+ * Render a peer for user-facing text: the fingerprint prefix (the authoritative
+ * address) plus the display name, clamped and HTML-escaped (the name is
+ * peer-supplied text and the attention hub renders HTML).
+ */
+export function peerLabel(peerFp, peerName) {
+    const prefix = (peerFp ?? '').slice(0, 12);
+    const name = typeof peerName === 'string' ? peerName.replace(/[\r\n\t]+/g, ' ').trim() : '';
+    if (!name || name === peerFp)
+        return prefix || 'unknown-peer';
+    const clamped = name.length > PEER_LABEL_NAME_MAX ? `${name.slice(0, PEER_LABEL_NAME_MAX - 1)}…` : name;
+    return `${escapeHtml(clamped)} (${prefix})`;
+}
+function hoursSince(iso, nowMs) {
+    if (!iso)
+        return 0;
+    const t = Date.parse(iso);
+    if (Number.isNaN(t))
+        return 0;
+    return Math.max(0, Math.round(((nowMs - t) / 3_600_000) * 10) / 10);
+}
+function shortIso(iso) {
+    if (!iso)
+        return 'unknown';
+    const t = Date.parse(iso);
+    return Number.isNaN(t) ? 'unknown' : new Date(t).toISOString().replace(/\.\d{3}Z$/, 'Z');
+}
+/** The connectivity clause (§3.2), worded to the evidence — never "nothing will arrive". */
+export function connectedNowClause(label, connectedNow, detail = {}) {
+    const mins = ageMinutes(detail.asOf, detail.nowMs ?? Date.now());
+    const asOf = mins === null ? '' : ` (as of ${mins} min ago)`;
+    if (connectedNow === false) {
+        return `${label} is not connected to the relay right now${asOf} — it may be offline, or listening under a different address`;
+    }
+    if (connectedNow === true) {
+        return `${label} IS connected to the relay${asOf} but has not acknowledged anything — it may be listening under a different address, or not reading`;
+    }
+    const why = detail.reason === 'relay-down'
+        ? ' (my own relay connection is down)'
+        : detail.reason === 'stale'
+            ? ` (my last presence record for it is ${mins === null ? 'too old' : `${mins} min old`})`
+            : detail.reason === 'no-row'
+                ? ' (the relay has given me no presence record for it)'
+                : '';
+    return `whether ${label} is connected right now is unknown${why}`;
+}
+/**
+ * The `deliveryOutcome` sentence for a send to a dark peer (spec §3.2):
+ * "no acknowledgement from <peer> for N h; this and K other messages are still
+ * queued (oldest expires T)" + the connectivity clause.
+ */
+export function buildPeerDarkSentence(report, peer, nowMs = Date.now()) {
+    const label = peerLabel(peer.peerFp, peer.peerName);
+    const h = hoursSince(report.since, nowMs);
+    const others = Math.max(0, report.queuedCount - 1);
+    const queuedPart = others === 0
+        ? 'this message is still queued'
+        : `this and ${others} other message${others === 1 ? '' : 's'} are still queued`;
+    const expiry = report.expiresAt ? ` (oldest expires ${shortIso(report.expiresAt)})` : '';
+    return `no acknowledgement from ${label} for ${h} h; ${queuedPart}${expiry}${handedClause(report.handedUnackedCount)}; ${connectedNowClause(label, report.connectedNow, { reason: report.connectedNowReason, asOf: report.connectedAsOf, nowMs })}.`;
+}
+/**
+ * Names the rows a relay queue flush handed to a connection under the peer's
+ * address with no acknowledgement after — they are not "queued" any more, and
+ * calling them that would be a false statement.
+ */
+function handedClause(handed) {
+    const n = typeof handed === 'number' && handed > 0 ? Math.floor(handed) : 0;
+    if (n === 0)
+        return '';
+    return ` — ${n} of these ${n === 1 ? 'was' : 'were'} handed to a connection under its address and never acknowledged`;
+}
+/** Attention-item body for the per-peer dark item (spec §3.2). */
+export function buildPeerDarkItemBody(peer, queuedCount, since, handedUnackedCount) {
+    const label = peerLabel(peer.peerFp, peer.peerName);
+    return `Messages to ${label} are stuck: ${queuedCount} queued since ${shortIso(since)}, none acknowledged${handedClause(handedUnackedCount)}. ${label} may be offline, or listening under a different address.`;
+}
+/** Resolve line for the per-peer dark item (spec §3.2 iv). */
+export function buildPeerDarkResolveLine(peer, expiredUnacknowledged) {
+    const label = peerLabel(peer.peerFp, peer.peerName);
+    return `${label} is back; ${expiredUnacknowledged} message${expiredUnacknowledged === 1 ? '' : 's'} from the dark window expired unacknowledged — resend what still matters.`;
+}
+/** Deterministic item ids (spec §3.2 iii — no episode stamp). */
+export function peerDarkItemId(agentId, peerFp) {
+    return `a2a-peer-dark:${agentId}:${peerFp}`;
+}
+export function relayUnreachableItemId(agentId) {
+    return `a2a-relay-unreachable:${agentId}`;
+}
+export const PEER_DARK_AUDIT_MAX_BYTES = 4 * 1024 * 1024;
+/** Append-only JSONL writer with a one-generation rotation; never throws. */
+export function createPeerDarkAuditWriter(auditPath, log) {
+    return (row) => {
+        try {
+            fs.mkdirSync(path.dirname(auditPath), { recursive: true });
+            let size = 0;
+            try {
+                size = fs.statSync(auditPath).size;
+            }
+            catch { /* @silent-fallback-ok: no file yet = size 0 */ }
+            if (size > PEER_DARK_AUDIT_MAX_BYTES)
+                fs.renameSync(auditPath, `${auditPath}.1`);
+            fs.appendFileSync(auditPath, JSON.stringify(row) + '\n');
+        }
+        catch (err) {
+            // @silent-fallback-ok: an audit append must never break a send or a sweep; logged.
+            log?.(`[a2a-peer-dark] audit append failed (non-fatal): ${err instanceof Error ? err.message : err}`);
+        }
+    };
+}
+export function resolvePeerDarkAuditPath(stateDir) {
+    return path.join(stateDir, 'logs', 'a2a-peer-dark.jsonl');
+}
+//# sourceMappingURL=peerDark.js.map

package/dist/threadline/peerDark.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "instar",
-  "version": "1.3.1339",
+  "version": "1.3.1341",
   "description": "Coherence infrastructure for self-evolving AI agents — on the Claude Code or Codex subscription you already have.",
   "type": "module",
   "main": "dist/index.js",