@ziggs-ai/agent-sdk 0.10.0 → 0.10.1

package/dist/server/staleBacklogGate.js

@@ -1,100 +0,0 @@
-import { runtimeLog } from '../shared/runtimeLog.js';
-export const DEFAULT_REPLAY_MAX_AGE_MS = 3 * 24 * 60 * 60 * 1000;
-/**
- * "3d" | "12h" | "30m" | "45s"; a bare number means days (the knob's natural
- * granularity). Returns null on garbage so the caller can warn and fall back.
- */
-export function parseReplayMaxAge(raw) {
-    const m = /^\s*(\d+(?:\.\d+)?)\s*([dhms]?)\s*$/i.exec(raw);
-    if (!m)
-        return null;
-    const value = Number(m[1]);
-    if (!Number.isFinite(value) || value <= 0)
-        return null;
-    const unitMs = { d: 86_400_000, h: 3_600_000, m: 60_000, s: 1_000 }[(m[2] || 'd').toLowerCase()];
-    return value * unitMs;
-}
-export function resolveReplayPolicy(env = process.env) {
-    const replayAll = env.FLEET_REPLAY_STALE === '1' || env.FLEET_REPLAY_STALE === 'true';
-    const raw = env.FLEET_REPLAY_MAX_AGE?.trim();
-    let maxAgeMs = DEFAULT_REPLAY_MAX_AGE_MS;
-    if (raw) {
-        const parsed = parseReplayMaxAge(raw);
-        if (parsed == null) {
-            runtimeLog.warn('staleBacklogGate', `FLEET_REPLAY_MAX_AGE="${raw}" is not a duration (use e.g. "3d", "12h", "30m") — using default ${formatAge(DEFAULT_REPLAY_MAX_AGE_MS)}`);
-        }
-        else {
-            maxAgeMs = parsed;
-        }
-    }
-    return { maxAgeMs, replayAll };
-}
-/**
- * Newest actionable instant for an agent, from its operator-sweep entry.
- *
- * The sweep hands this over directly now — it is the agent's delivery
- * watermark — where this used to fold together the max timestamp across every
- * channel of a whole envelope. An agent surfaced only for open work carries no
- * delivery instant: age is unprovable, so it is treated as fresh and started.
- * Stale-skipping a half-finished task would strand it.
- */
-export function newestActionableAt(entry) {
-    if (!entry.deliveredUpTo)
-        return null;
-    const t = Date.parse(entry.deliveredUpTo);
-    return Number.isNaN(t) ? null : t;
-}
-export function formatAge(ms) {
-    if (ms >= 86_400_000)
-        return `${trimNum(ms / 86_400_000)}d`;
-    if (ms >= 3_600_000)
-        return `${trimNum(ms / 3_600_000)}h`;
-    if (ms >= 60_000)
-        return `${trimNum(ms / 60_000)}m`;
-    return `${trimNum(ms / 1_000)}s`;
-}
-function trimNum(n) {
-    return Number(n.toFixed(1)).toString();
-}
-/**
- * Build the `shouldLazyStart` gate for the operator poll. Skipped agents
- * resurface in every envelope (reading never acks), so announcements are
- * per-agent-once: each poll pass that skips agents not yet announced emits one
- * aggregated warn line covering them.
- */
-export function createStaleBacklogGate({ maxAgeMs, replayAll, label = 'launcher', now = Date.now, log, }) {
-    const emit = log ?? ((line) => runtimeLog.warn(label, line));
-    const announced = new Set();
-    let pendingAgents = [];
-    let flushScheduled = false;
-    // One envelope's entries are gated synchronously; a microtask-deferred
-    // flush turns a whole boot flood into a single summary line.
-    const flush = () => {
-        flushScheduled = false;
-        if (pendingAgents.length === 0)
-            return;
-        const preview = pendingAgents.slice(0, 5).join(', ');
-        const more = pendingAgents.length > 5 ? `, +${pendingAgents.length - 5} more` : '';
-        emit(`startup backlog policy: skipped ${pendingAgents.length} agent(s) whose newest mail is older than ${formatAge(maxAgeMs)} (${preview}${more}) — set FLEET_REPLAY_STALE=1 to replay them`);
-        pendingAgents = [];
-    };
-    return (entry) => {
-        if (replayAll)
-            return true;
-        // Open work always starts, however old: the task is unfinished, not stale.
-        if (entry.hasOpenTasks)
-            return true;
-        const newest = newestActionableAt(entry);
-        if (newest == null || now() - newest <= maxAgeMs)
-            return true;
-        if (!announced.has(entry.agentId)) {
-            announced.add(entry.agentId);
-            pendingAgents.push(entry.agentId);
-            if (!flushScheduled) {
-                flushScheduled = true;
-                queueMicrotask(flush);
-            }
-        }
-        return false;
-    };
-}