@cluesmith/codev 3.3.5 → 3.3.7

package/dist/agent-farm/servers/agent-state/identity.js

@@ -0,0 +1,120 @@
+/**
+ * Resolve a lifecycle report's launch identity to the agent Tower knows
+ * (Spec 1595, Constraint 15).
+ *
+ * The reporter names its agent with the identity codev injected at launch: a
+ * builder by its worktree path, an architect by name plus workspace path. Tower
+ * normalizes every path before the registry lookup, so a differently spelled path
+ * to the same agent (a symlink, a trailing slash, a relative segment; #1809)
+ * resolves to the same row, and the id it returns is always its own canonical one,
+ * never the raw reported identity:
+ *
+ * - a builder: the shared worktree row matcher (`afx send`'s lookup), then the
+ *   lowercased role id the overview derives for that row (`builderRoleId`);
+ * - an architect: its row in the workspace's registered architects.
+ *
+ * It never throws. An unknown agent, an unreadable registry, or a path outside
+ * any builder worktree all resolve to `null`, which the route rejects.
+ *
+ * Ingestion fires per tool call, so lookups use Tower's own `global.db` handle
+ * behind a memo of successful resolutions. A memoized resolution is reused only
+ * while the registry is unchanged: any write to `global.db`, by Tower or by
+ * another process such as `afx spawn` or `afx cleanup`, moves SQLite's
+ * `data_version` or this connection's `total_changes()` and forces a fresh
+ * lookup, and `IDENTITY_MEMO_TTL_MS` bounds reuse regardless. Misses are never
+ * memoized, so a newly spawned agent resolves on its first report.
+ */
+import { getGlobalDb } from '../../db/index.js';
+import { normalizeWorkspacePath } from '../../utils/workspace-path.js';
+import { matchBuilderRow, parseBuilderWorktreePath, } from '../../utils/builder-worktree-identity.js';
+import { builderRoleId } from '../overview.js';
+/** The longest a successful resolution is reused, even with the registry unchanged. */
+export const IDENTITY_MEMO_TTL_MS = 5_000;
+const memo = new Map();
+/** Drop every memoized resolution. */
+export function invalidateAgentIdentityMemo() {
+    memo.clear();
+}
+/**
+ * A token that changes whenever `global.db` is written: `data_version` moves on
+ * another connection's commit, `total_changes()` on this connection's own writes.
+ */
+function registryVersion(db) {
+    const dataVersion = db.pragma('data_version', { simple: true });
+    const changes = db.prepare('SELECT total_changes() AS n').get();
+    return `${dataVersion}:${changes.n}`;
+}
+/** Whether a stored `workspace_path` names `workspacePath` (already normalized). */
+function sameWorkspace(stored, workspacePath) {
+    return stored === workspacePath || normalizeWorkspacePath(stored) === workspacePath;
+}
+function resolveBuilder(db, worktreePath) {
+    const ref = parseBuilderWorktreePath(normalizeWorkspacePath(worktreePath));
+    if (!ref)
+        return null;
+    const workspacePath = normalizeWorkspacePath(ref.workspacePath);
+    // Both sides normalized: a row recorded under another spelling of the
+    // workspace path still belongs to this workspace. Rows stored in the
+    // canonical spelling are tried first, so the common case realpaths nothing
+    // beyond this workspace's own rows.
+    const rows = db
+        .prepare('SELECT id, worktree, workspace_path FROM builders WHERE worktree IS NOT NULL')
+        .all();
+    const row = matchBuilderRow(rows.filter(r => r.workspace_path === workspacePath), ref)
+        ?? matchBuilderRow(rows.filter(r => r.workspace_path !== workspacePath && sameWorkspace(r.workspace_path, workspacePath)), ref);
+    if (!row)
+        return null;
+    const agentId = builderRoleId(row.id, ref.worktreeDirName);
+    if (agentId === null)
+        return null;
+    return { workspacePath, agentId };
+}
+function resolveArchitect(db, workspacePath, name) {
+    const normalized = normalizeWorkspacePath(workspacePath);
+    const rows = db
+        .prepare('SELECT id, workspace_path FROM architect WHERE id = ?')
+        .all(name);
+    const row = rows.find(r => sameWorkspace(r.workspace_path, normalized));
+    if (!row)
+        return null;
+    return { workspacePath: normalized, agentId: row.id };
+}
+/**
+ * The agent a launch identity names, or `null` when Tower does not know it.
+ * Never throws.
+ */
+export function resolveAgentIdentity(identity, options = {}) {
+    const now = options.now ?? Date.now;
+    try {
+        let memoKey;
+        if (identity.kind === 'builder') {
+            memoKey = `builder\0${normalizeWorkspacePath(identity.worktreePath)}`;
+        }
+        else {
+            memoKey = `architect\0${normalizeWorkspacePath(identity.workspacePath)}\0${identity.name}`;
+        }
+        const db = (options.db ?? getGlobalDb)();
+        const version = registryVersion(db);
+        const cached = memo.get(memoKey);
+        if (cached !== undefined && cached.registryVersion === version && cached.expiresAt > now()) {
+            return cached.agent;
+        }
+        let agent;
+        if (identity.kind === 'builder') {
+            agent = resolveBuilder(db, identity.worktreePath);
+        }
+        else {
+            agent = resolveArchitect(db, identity.workspacePath, identity.name);
+        }
+        if (agent === null) {
+            memo.delete(memoKey);
+            return null;
+        }
+        memo.set(memoKey, { agent, registryVersion: version, expiresAt: now() + IDENTITY_MEMO_TTL_MS });
+        return agent;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=identity.js.map

package/dist/agent-farm/servers/agent-state/identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.js","sourceRoot":"","sources":["../../../../src/agent-farm/servers/agent-state/identity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAIH,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EACL,eAAe,EACf,wBAAwB,GAEzB,MAAM,0CAA0C,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/C,uFAAuF;AACvF,MAAM,CAAC,MAAM,oBAAoB,GAAG,KAAK,CAAC;AAgB1C,MAAM,IAAI,GAAG,IAAI,GAAG,EAAgF,CAAC;AAErG,sCAAsC;AACtC,MAAM,UAAU,2BAA2B;IACzC,IAAI,CAAC,KAAK,EAAE,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,SAAS,eAAe,CAAC,EAAqB;IAC5C,MAAM,WAAW,GAAG,EAAE,CAAC,MAAM,CAAC,cAAc,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAW,CAAC;IAC1E,MAAM,OAAO,GAAG,EAAE,CAAC,OAAO,CAAC,6BAA6B,CAAC,CAAC,GAAG,EAAmB,CAAC;IACjF,OAAO,GAAG,WAAW,IAAI,OAAO,CAAC,CAAC,EAAE,CAAC;AACvC,CAAC;AAED,oFAAoF;AACpF,SAAS,aAAa,CAAC,MAAc,EAAE,aAAqB;IAC1D,OAAO,MAAM,KAAK,aAAa,IAAI,sBAAsB,CAAC,MAAM,CAAC,KAAK,aAAa,CAAC;AACtF,CAAC;AAED,SAAS,cAAc,CAAC,EAAqB,EAAE,YAAoB;IACjE,MAAM,GAAG,GAAG,wBAAwB,CAAC,sBAAsB,CAAC,YAAY,CAAC,CAAC,CAAC;IAC3E,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IACtB,MAAM,aAAa,GAAG,sBAAsB,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IAChE,sEAAsE;IACtE,qEAAqE;IACrE,2EAA2E;IAC3E,oCAAoC;IACpC,MAAM,IAAI,GAAG,EAAE;SACZ,OAAO,CAAC,8EAA8E,CAAC;SACvF,GAAG,EAA4D,CAAC;IACnE,MAAM,GAAG,GAAG,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,cAAc,KAAK,aAAa,CAAC,EAAE,GAAG,CAAC;WACjF,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,cAAc,KAAK,aAAa,IAAI,aAAa,CAAC,CAAC,CAAC,cAAc,EAAE,aAAa,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAClI,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IACtB,MAAM,OAAO,GAAG,aAAa,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,eAAe,CAAC,CAAC;IAC3D,IAAI,OAAO,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAClC,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,CAAC;AACpC,CAAC;AAED,SAAS,gBAAgB,CAAC,EAAqB,EAAE,aAAqB,EAAE,IAAY;IAClF,MAAM,UAAU,GAAG,sBAAsB,CAAC,aAAa,CAAC,CAAC;IACzD,MAAM,IAAI,GAAG,EAAE;SACZ,OAAO,CAAC,uDAAuD,CAAC;SAChE,GAAG,CAAC,IAAI,CAAkD,CAAC;IAC9D,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,cAAc,EAAE,UAAU,CAAC,CAAC,CAAC;IACxE,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IACtB,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC;AACxD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAClC,QAA6B,EAC7B,UAAuC,EAAE;IAEzC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC;IACpC,IAAI,CAAC;QACH,IAAI,OAAe,CAAC;QACpB,IAAI,QAAQ,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAChC,OAAO,GAAG,YAAY,sBAAsB,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;QACxE,CAAC;aAAM,CAAC;YACN,OAAO,GAAG,cAAc,sBAAsB,CAAC,QAAQ,CAAC,aAAa,CAAC,KAAK,QAAQ,CAAC,IAAI,EAAE,CAAC;QAC7F,CAAC;QACD,MAAM,EAAE,GAAG,CAAC,OAAO,CAAC,EAAE,IAAI,WAAW,CAAC,EAAE,CAAC;QACzC,MAAM,OAAO,GAAG,eAAe,CAAC,EAAE,CAAC,CAAC;QACpC,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACjC,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,eAAe,KAAK,OAAO,IAAI,MAAM,CAAC,SAAS,GAAG,GAAG,EAAE,EAAE,CAAC;YAC3F,OAAO,MAAM,CAAC,KAAK,CAAC;QACtB,CAAC;QAED,IAAI,KAA2B,CAAC;QAChC,IAAI,QAAQ,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAChC,KAAK,GAAG,cAAc,CAAC,EAAE,EAAE,QAAQ,CAAC,YAAY,CAAC,CAAC;QACpD,CAAC;aAAM,CAAC;YACN,KAAK,GAAG,gBAAgB,CAAC,EAAE,EAAE,QAAQ,CAAC,aAAa,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;QACtE,CAAC;QACD,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YACnB,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YACrB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,GAAG,oBAAoB,EAAE,CAAC,CAAC;QAChG,OAAO,KAAK,CAAC;IACf,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/agent-farm/servers/agent-state/liveness.d.ts

@@ -0,0 +1,107 @@
+/**
+ * Agent liveness: the one place Tower decides whether an agent's process is
+ * running (Spec 1595, SC7, Constraint 14).
+ *
+ * A sweep every `LIVENESS_SWEEP_INTERVAL_MS` takes one process snapshot through
+ * the shared `listProcessCensus()` (#1227) and walks each registered agent's
+ * process tree from its session's pid:
+ *
+ * - shellper-backed builder: shellper → launch loop → agent. Alive while some
+ *   launch loop has a child. The loop's relaunch-pause `sleep` is a child, so it
+ *   counts as alive; its `read -r` relaunch prompt is not, so a loop waiting
+ *   there reads as not alive although the loop itself still runs.
+ * - direct builder: `session.pid` is the launch loop; same child test.
+ * - shellper-backed architect: shellper → agent. Alive while the shellper has a
+ *   child.
+ * - direct architect: `session.pid` is the agent; alive while it is running.
+ * - any agent: not alive with no session, an exited session, or (architects) a
+ *   session in restart wait.
+ *
+ * A transition to not alive is published only after `NOT_ALIVE_CONFIRMATIONS`
+ * consecutive not-alive sweeps, so a transient gap never flashes `dead`. A
+ * failed snapshot (`[]`) publishes `alive: null` (unknown) for every agent, and
+ * an unrecognized process shape for its agent; neither advances nor resets the
+ * confirmation, so a not-alive observation before an unknown sweep still counts.
+ * A published not alive's `since` is the confirming sweep, up to one interval
+ * after the process went. Lifecycle reports never feed liveness.
+ *
+ * The sweep also drops the store entries of agents no longer registered (SC11)
+ * and raises `AGENT_STATE_CHANGED` whenever a published value changes. The
+ * snapshot's command lines can carry secrets, so only pid and ppid are read and
+ * nothing from it is logged.
+ */
+import { EventEmitter } from 'node:events';
+import { type ProcessCensusEntry } from '../process-census.js';
+import { type AgentStateStore } from './store.js';
+import type { WorkspaceTerminals } from '../tower-types.js';
+/** How often liveness is swept. */
+export declare const LIVENESS_SWEEP_INTERVAL_MS = 5000;
+/** Consecutive not-alive sweeps before not alive is published. */
+export declare const NOT_ALIVE_CONFIRMATIONS = 2;
+/** The session facts liveness reads (a `PtySession` satisfies it). */
+export interface LivenessSession {
+    /** The shellper's pid for a shellper-backed session, else the PTY child's. */
+    pid: number;
+    shellperBacked: boolean;
+    status: 'running' | 'exited';
+    awaitingRestart: boolean;
+}
+/** One agent registered with Tower, with its session when it has one. */
+export interface RegisteredAgent {
+    /** Normalized workspace path. */
+    workspacePath: string;
+    /** Canonical id: a builder's lowercased role id, or an architect's name. */
+    agentId: string;
+    kind: 'builder' | 'architect';
+    session: LivenessSession | undefined;
+}
+/** An agent's published liveness. */
+export interface AgentLiveness {
+    /** `null` while liveness cannot be determined. */
+    alive: boolean | null;
+    /** When `alive` took its current value (epoch ms). */
+    since: number;
+}
+export interface AgentLivenessOptions {
+    /** The registered agents, read once per sweep. */
+    agents: () => RegisteredAgent[];
+    /** The process snapshot. Defaults to `listProcessCensus`. */
+    census?: () => Promise<ProcessCensusEntry[]>;
+    /** The store whose entries follow registration. Defaults to Tower's store. */
+    store?: AgentStateStore;
+    now?: () => number;
+    log?: (message: string) => void;
+}
+export declare class AgentLivenessTracker extends EventEmitter {
+    private readonly options;
+    private readonly records;
+    private readonly census;
+    private readonly store;
+    private readonly now;
+    private timer;
+    private sweeping;
+    constructor(options: AgentLivenessOptions);
+    /** An agent's published liveness, or `undefined` when it is not registered. */
+    get(workspacePath: string, agentId: string): AgentLiveness | undefined;
+    /** Run one sweep: observe every registered agent, publish, and drop the removed. */
+    sweep(): Promise<void>;
+    /** Sweep now and then every `intervalMs`, until `stop`. */
+    start(intervalMs?: number): void;
+    stop(): void;
+    /** A timer-driven sweep: never overlaps another, never throws. */
+    private runSweep;
+    private publish;
+}
+/**
+ * The agents Tower's terminal registry holds: every builder and architect in
+ * each workspace's entry, keyed as the store keys them, with its session when
+ * the terminal manager still has one.
+ */
+export declare function registeredAgents(workspaceTerminals: Map<string, WorkspaceTerminals>, getSession: (terminalId: string) => LivenessSession | undefined, normalizeWorkspace: (workspacePath: string) => string): RegisteredAgent[];
+/** Start Tower's one liveness sweep; returns the tracker so boot can subscribe to it. */
+export declare function startAgentLiveness(options: AgentLivenessOptions): AgentLivenessTracker;
+/** Stop Tower's liveness sweep (shutdown). */
+export declare function stopAgentLiveness(): void;
+/** Tower's published liveness for an agent; `undefined` before the sweep has seen it. */
+export declare function getAgentLiveness(workspacePath: string, agentId: string): AgentLiveness | undefined;
+//# sourceMappingURL=liveness.d.ts.map

package/dist/agent-farm/servers/agent-state/liveness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"liveness.d.ts","sourceRoot":"","sources":["../../../../src/agent-farm/servers/agent-state/liveness.ts"],"names":[],"mappings":"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"}

package/dist/agent-farm/servers/agent-state/liveness.js

@@ -0,0 +1,224 @@
+/**
+ * Agent liveness: the one place Tower decides whether an agent's process is
+ * running (Spec 1595, SC7, Constraint 14).
+ *
+ * A sweep every `LIVENESS_SWEEP_INTERVAL_MS` takes one process snapshot through
+ * the shared `listProcessCensus()` (#1227) and walks each registered agent's
+ * process tree from its session's pid:
+ *
+ * - shellper-backed builder: shellper → launch loop → agent. Alive while some
+ *   launch loop has a child. The loop's relaunch-pause `sleep` is a child, so it
+ *   counts as alive; its `read -r` relaunch prompt is not, so a loop waiting
+ *   there reads as not alive although the loop itself still runs.
+ * - direct builder: `session.pid` is the launch loop; same child test.
+ * - shellper-backed architect: shellper → agent. Alive while the shellper has a
+ *   child.
+ * - direct architect: `session.pid` is the agent; alive while it is running.
+ * - any agent: not alive with no session, an exited session, or (architects) a
+ *   session in restart wait.
+ *
+ * A transition to not alive is published only after `NOT_ALIVE_CONFIRMATIONS`
+ * consecutive not-alive sweeps, so a transient gap never flashes `dead`. A
+ * failed snapshot (`[]`) publishes `alive: null` (unknown) for every agent, and
+ * an unrecognized process shape for its agent; neither advances nor resets the
+ * confirmation, so a not-alive observation before an unknown sweep still counts.
+ * A published not alive's `since` is the confirming sweep, up to one interval
+ * after the process went. Lifecycle reports never feed liveness.
+ *
+ * The sweep also drops the store entries of agents no longer registered (SC11)
+ * and raises `AGENT_STATE_CHANGED` whenever a published value changes. The
+ * snapshot's command lines can carry secrets, so only pid and ppid are read and
+ * nothing from it is logged.
+ */
+import { EventEmitter } from 'node:events';
+import { listProcessCensus } from '../process-census.js';
+import { AGENT_STATE_CHANGED, agentStateStore } from './store.js';
+/** How often liveness is swept. */
+export const LIVENESS_SWEEP_INTERVAL_MS = 5_000;
+/** Consecutive not-alive sweeps before not alive is published. */
+export const NOT_ALIVE_CONFIRMATIONS = 2;
+function agentKey(workspacePath, agentId) {
+    return `${workspacePath}\0${agentId}`;
+}
+function processTree(census) {
+    const running = new Set();
+    const children = new Map();
+    for (const entry of census) {
+        running.add(entry.pid);
+        const siblings = children.get(entry.ppid);
+        if (siblings === undefined) {
+            children.set(entry.ppid, [entry.pid]);
+        }
+        else {
+            siblings.push(entry.pid);
+        }
+    }
+    return { running, children };
+}
+function hasChild(tree, pid) {
+    return tree.children.has(pid);
+}
+/** Whether a launch loop at `pid` is running an agent. */
+function launchLoopRunsAgent(tree, pid) {
+    return tree.running.has(pid) && hasChild(tree, pid);
+}
+/**
+ * This sweep's observation for one agent; `null` when it cannot be told. A
+ * failed snapshot makes every observation unknown, session facts included, so a
+ * failing `ps` never advances any agent toward not alive.
+ */
+function observe(agent, tree) {
+    if (tree === null)
+        return null;
+    const session = agent.session;
+    if (session === undefined || session.status === 'exited')
+        return false;
+    if (agent.kind === 'architect' && session.awaitingRestart)
+        return false;
+    if (!Number.isInteger(session.pid) || session.pid <= 0)
+        return null;
+    if (agent.kind === 'builder') {
+        if (!session.shellperBacked)
+            return launchLoopRunsAgent(tree, session.pid);
+        const loops = tree.children.get(session.pid) ?? [];
+        return loops.some(loop => hasChild(tree, loop));
+    }
+    if (session.shellperBacked)
+        return hasChild(tree, session.pid);
+    return tree.running.has(session.pid);
+}
+export class AgentLivenessTracker extends EventEmitter {
+    options;
+    records = new Map();
+    census;
+    store;
+    now;
+    timer = null;
+    sweeping = false;
+    constructor(options) {
+        super();
+        this.options = options;
+        this.census = options.census ?? listProcessCensus;
+        this.store = options.store ?? agentStateStore;
+        this.now = options.now ?? Date.now;
+    }
+    /** An agent's published liveness, or `undefined` when it is not registered. */
+    get(workspacePath, agentId) {
+        return this.records.get(agentKey(workspacePath, agentId))?.published;
+    }
+    /** Run one sweep: observe every registered agent, publish, and drop the removed. */
+    async sweep() {
+        const agents = this.options.agents();
+        let tree = null;
+        if (agents.length > 0) {
+            const census = await this.census();
+            if (census.length > 0)
+                tree = processTree(census);
+        }
+        const registered = new Set();
+        for (const agent of agents) {
+            const key = agentKey(agent.workspacePath, agent.agentId);
+            if (registered.has(key))
+                continue;
+            registered.add(key);
+            this.publish(agent, key, observe(agent, tree));
+        }
+        for (const key of this.records.keys()) {
+            if (!registered.has(key))
+                this.records.delete(key);
+        }
+        for (const held of this.store.agents()) {
+            if (!registered.has(agentKey(held.workspacePath, held.agentId))) {
+                this.store.drop(held.workspacePath, held.agentId);
+            }
+        }
+    }
+    /** Sweep now and then every `intervalMs`, until `stop`. */
+    start(intervalMs = LIVENESS_SWEEP_INTERVAL_MS) {
+        if (this.timer !== null)
+            return;
+        this.runSweep();
+        this.timer = setInterval(() => this.runSweep(), intervalMs);
+        this.timer.unref();
+    }
+    stop() {
+        if (this.timer === null)
+            return;
+        clearInterval(this.timer);
+        this.timer = null;
+    }
+    /** A timer-driven sweep: never overlaps another, never throws. */
+    runSweep() {
+        if (this.sweeping)
+            return;
+        this.sweeping = true;
+        this.sweep()
+            .catch((err) => {
+            this.options.log?.(`Agent liveness sweep failed: ${err.message}`);
+        })
+            .finally(() => {
+            this.sweeping = false;
+        });
+    }
+    publish(agent, key, observed) {
+        let record = this.records.get(key);
+        if (record === undefined) {
+            record = { published: { alive: null, since: this.now() }, notAliveSweeps: 0 };
+            this.records.set(key, record);
+        }
+        let next = record.published.alive;
+        if (observed === null) {
+            next = null;
+        }
+        else if (observed) {
+            record.notAliveSweeps = 0;
+            next = true;
+        }
+        else {
+            record.notAliveSweeps += 1;
+            if (record.notAliveSweeps >= NOT_ALIVE_CONFIRMATIONS)
+                next = false;
+        }
+        if (next === record.published.alive)
+            return;
+        record.published = { alive: next, since: this.now() };
+        const change = { workspacePath: agent.workspacePath, agentId: agent.agentId };
+        this.emit(AGENT_STATE_CHANGED, change);
+    }
+}
+/**
+ * The agents Tower's terminal registry holds: every builder and architect in
+ * each workspace's entry, keyed as the store keys them, with its session when
+ * the terminal manager still has one.
+ */
+export function registeredAgents(workspaceTerminals, getSession, normalizeWorkspace) {
+    const agents = [];
+    for (const [rawWorkspacePath, entry] of workspaceTerminals) {
+        const workspacePath = normalizeWorkspace(rawWorkspacePath);
+        for (const [roleId, terminalId] of entry.builders) {
+            agents.push({ workspacePath, agentId: roleId.toLowerCase(), kind: 'builder', session: getSession(terminalId) });
+        }
+        for (const [name, terminalId] of entry.architects) {
+            agents.push({ workspacePath, agentId: name, kind: 'architect', session: getSession(terminalId) });
+        }
+    }
+    return agents;
+}
+let towerLiveness = null;
+/** Start Tower's one liveness sweep; returns the tracker so boot can subscribe to it. */
+export function startAgentLiveness(options) {
+    towerLiveness?.stop();
+    towerLiveness = new AgentLivenessTracker(options);
+    towerLiveness.start();
+    return towerLiveness;
+}
+/** Stop Tower's liveness sweep (shutdown). */
+export function stopAgentLiveness() {
+    towerLiveness?.stop();
+    towerLiveness = null;
+}
+/** Tower's published liveness for an agent; `undefined` before the sweep has seen it. */
+export function getAgentLiveness(workspacePath, agentId) {
+    return towerLiveness?.get(workspacePath, agentId);
+}
+//# sourceMappingURL=liveness.js.map

package/dist/agent-farm/servers/agent-state/liveness.js.map

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

package/dist/agent-farm/servers/agent-state/route.d.ts

@@ -0,0 +1,38 @@
+/**
+ * `POST /api/agent-lifecycle`: the one write-only agent-state route (Spec 1595,
+ * Constraint 16).
+ *
+ * An agent's lifecycle reporter posts one `AgentLifecycleEvent` per harness hook.
+ * The route validates it strictly against the contract and its limits, resolves
+ * the launch identity to the agent Tower knows, applies it to the in-memory
+ * store, and answers an empty 204. It writes nothing else: no PTY, no mailbox,
+ * no database. There is no read route; state is served on the overview.
+ *
+ * Auth is the existing `isRequestAllowed` choke point in `handleRequest`; this
+ * route is not on the public allowlist. A rejection is a 4xx carrying only an
+ * error code. The reporter ignores every response.
+ */
+import type http from 'node:http';
+import type { AgentLaunchIdentity, AgentLifecycleEvent } from '@cluesmith/codev-types';
+import type { AgentStateStore } from './store.js';
+import type { ResolvedAgent } from './identity.js';
+/** Request body cap, in bytes. */
+export declare const MAX_LIFECYCLE_BODY_BYTES = 8192;
+export declare const MAX_PATH_LENGTH = 4096;
+export declare const MAX_NAME_LENGTH = 128;
+export declare const MAX_SESSION_ID_LENGTH = 128;
+export declare const MAX_TOOL_LENGTH = 64;
+export declare const MAX_SUMMARY_LENGTH = 200;
+export interface AgentLifecycleDeps {
+    store: AgentStateStore;
+    resolve: (identity: AgentLaunchIdentity) => ResolvedAgent | null;
+}
+/**
+ * Validate a parsed body against the `AgentLifecycleEvent` contract, or `null`.
+ * Strict: unknown keys anywhere are rejected, `needsInput` is accepted only on a
+ * `needs-input` event and `backgroundWork` only on `turn-ended`.
+ */
+export declare function parseLifecycleEvent(value: unknown): AgentLifecycleEvent | null;
+/** Handle one lifecycle report. Auth has already passed in `handleRequest`. */
+export declare function handleAgentLifecycle(req: http.IncomingMessage, res: http.ServerResponse, deps: AgentLifecycleDeps): Promise<void>;
+//# sourceMappingURL=route.d.ts.map

package/dist/agent-farm/servers/agent-state/route.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route.d.ts","sourceRoot":"","sources":["../../../../src/agent-farm/servers/agent-state/route.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,OAAO,KAAK,EACV,mBAAmB,EACnB,mBAAmB,EAGpB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD,kCAAkC;AAClC,eAAO,MAAM,wBAAwB,OAAO,CAAC;AAC7C,eAAO,MAAM,eAAe,OAAO,CAAC;AACpC,eAAO,MAAM,eAAe,MAAM,CAAC;AACnC,eAAO,MAAM,qBAAqB,MAAM,CAAC;AACzC,eAAO,MAAM,eAAe,KAAK,CAAC;AAClC,eAAO,MAAM,kBAAkB,MAAM,CAAC;AAkBtC,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,eAAe,CAAC;IACvB,OAAO,EAAE,CAAC,QAAQ,EAAE,mBAAmB,KAAK,aAAa,GAAG,IAAI,CAAC;CAClE;AAmDD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,mBAAmB,GAAG,IAAI,CAyB9E;AAOD,+EAA+E;AAC/E,wBAAsB,oBAAoB,CACxC,GAAG,EAAE,IAAI,CAAC,eAAe,EACzB,GAAG,EAAE,IAAI,CAAC,cAAc,EACxB,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,IAAI,CAAC,CAwCf"}