sneakoscope 4.8.6 → 4.8.7

package/dist/config/skills-manifest.json

@@ -0,0 +1,465 @@
+{
+  "schema": "sks.skills-manifest.v1",
+  "package_version": "4.8.7",
+  "skills": [
+    {
+      "canonical_name": "answer",
+      "type": "official",
+      "content_sha256": "eb501fbc70c0ba8fd6df6abcbe5cda0bc39693e0f0abc6c8867f4ef441fa793d",
+      "hash_history": [],
+      "deprecated_aliases": []
+    },
+    {
+      "canonical_name": "autoresearch",
+      "type": "official",
+      "content_sha256": "1250cf46bc3fa1c66c4b5a44315631848a4ef5c326ad194aca0f964d274ffcf8",
+      "hash_history": [],
+      "deprecated_aliases": []
+    },
+    {
+      "canonical_name": "autoresearch-loop",
+      "type": "official",
+      "content_sha256": "2baab5c1b25d265494981303ae4c33715dc27154f64662badf447a7d88f1117f",
+      "hash_history": [],
+      "deprecated_aliases": []
+    },
+    {
+      "canonical_name": "commit",
+      "type": "official",
+      "content_sha256": "aa6a9593461eba7abd11b8c9bc035d9a1d496f1798fb013ec09288777d1f3c43",
+      "hash_history": [],
+      "deprecated_aliases": []
+    },
+    {
+      "canonical_name": "commit-and-push",
+      "type": "official",
+      "content_sha256": "7866ccc825979a7a501f905485c91b10d73f646292b5d5fd07111928afe324fa",
+      "hash_history": [],
+      "deprecated_aliases": []
+    },
+    {
+      "canonical_name": "computer-use",
+      "type": "core",
+      "content_sha256": "e48807f0d69c4499ca93d22314207030150950d0ffa033f448681257d9db45de",
+      "hash_history": [],
+      "deprecated_aliases": []
+    },
+    {
+      "canonical_name": "computer-use-fast",
+      "type": "official",
+      "content_sha256": "7d7dd5da1b4e7e673183f736dc0b9adf1b3235d18dfa17dc616e2e5a3f77429f",
+      "hash_history": [],
+      "deprecated_aliases": []
+    },
+    {
+      "canonical_name": "context7-docs",
+      "type": "official",
+      "content_sha256": "bac43a8e4c8fd76b994e7af28b0ce2d56306dcaac72136328ebb3514b988bbbd",
+      "hash_history": [],
+      "deprecated_aliases": []
+    },
+    {
+      "canonical_name": "cu",
+      "type": "official",
+      "content_sha256": "96bb1df88ff15a94e91d903d2eac5bf0ffd49d8f6365d71818cd4ffa8c936b3f",
+      "hash_history": [],
+      "deprecated_aliases": []
+    },
+    {
+      "canonical_name": "db",
+      "type": "official",
+      "content_sha256": "b3e208167c5a01b4e88f8ac2026dbdf3d8a9f7976fe5bb1aabc60b5035da8278",
+      "hash_history": [],
+      "deprecated_aliases": []
+    },
+    {
+      "canonical_name": "db-safety-guard",
+      "type": "official",
+      "content_sha256": "49eef27e8c37732660a5ebe26b47a84e7e7cc685917b0acbdf7eb3a94e366887",
+      "hash_history": [],
+      "deprecated_aliases": []
+    },
+    {
+      "canonical_name": "design-artifact-expert",
+      "type": "official",
+      "content_sha256": "5c023adcb40a555b4698179945c3b79322719d6dc3369a0947a261d31b751db0",
+      "hash_history": [],
+      "deprecated_aliases": []
+    },
+    {
+      "canonical_name": "design-system-builder",
+      "type": "official",
+      "content_sha256": "bec2bddc9009a670de33df3787103c8f8206f5a17070b8cb64bbab184fba2053",
+      "hash_history": [],
+      "deprecated_aliases": []
+    },
+    {
+      "canonical_name": "design-ui-editor",
+      "type": "official",
+      "content_sha256": "6c3fe7738cd62378ab33aeac103f372d8e0726288e42a9ce1d2cf2caa0ace1f3",
+      "hash_history": [],
+      "deprecated_aliases": []
+    },
+    {
+      "canonical_name": "dfix",
+      "type": "core",
+      "content_sha256": "16a1985bce1bd358fa3be80fbf7016c253e5360b8fc2b9f182a4ba09b63d4745",
+      "hash_history": [],
+      "deprecated_aliases": []
+    },
+    {
+      "canonical_name": "fast-mode",
+      "type": "official",
+      "content_sha256": "97f152b5575d7b0e24d321d79ec6fe498e60abce562d388ccd45d31732746be5",
+      "hash_history": [],
+      "deprecated_aliases": []
+    },
+    {
+      "canonical_name": "fast-off",
+      "type": "official",
+      "content_sha256": "509362aa713498cf0d8c10c8b5c7b7a70b29d78da5dc2fa265d66071e7478115",
+      "hash_history": [],
+      "deprecated_aliases": []
+    },
+    {
+      "canonical_name": "fast-on",
+      "type": "official",
+      "content_sha256": "f02f7c8fe1e766ed6c341d059e1ce469a8e5032438bd8381affcdbe4d6d90dde",
+      "hash_history": [],
+      "deprecated_aliases": []
+    },
+    {
+      "canonical_name": "from-chat-img",
+      "type": "official",
+      "content_sha256": "8cef38c9f7c97b31378cd626d8fa43a05cfc29cdb62ec6a0bcd77595f7ca8015",
+      "hash_history": [],
+      "deprecated_aliases": []
+    },
+    {
+      "canonical_name": "getdesign-reference",
+      "type": "official",
+      "content_sha256": "a86adcfbe2e031b7dd438506efba4ebccd98fba4b9a70392fccdfcb118d19116",
+      "hash_history": [],
+      "deprecated_aliases": []
+    },
+    {
+      "canonical_name": "goal",
+      "type": "official",
+      "content_sha256": "35456da6a929270f9df8c54a351bf0a2a867a9b903cc3918cb2e40a040d60ca6",
+      "hash_history": [],
+      "deprecated_aliases": []
+    },
+    {
+      "canonical_name": "gx",
+      "type": "official",
+      "content_sha256": "f5e16f2e0c8000ed9672af28090608688a72e983304451f2f13a4c70a4a21d53",
+      "hash_history": [],
+      "deprecated_aliases": []
+    },
+    {
+      "canonical_name": "gx-visual-generate",
+      "type": "official",
+      "content_sha256": "15d184b6b1fe61706764568868709b912024ab8ad0e416fbaeaa480e3182c1f9",
+      "hash_history": [],
+      "deprecated_aliases": []
+    },
+    {
+      "canonical_name": "gx-visual-read",
+      "type": "official",
+      "content_sha256": "99878b9fa667228676dc2d3b0f53ecdda8c62df94684697ad53f96699d95d5bc",
+      "hash_history": [],
+      "deprecated_aliases": []
+    },
+    {
+      "canonical_name": "gx-visual-validate",
+      "type": "official",
+      "content_sha256": "8a095b1d2212ac197a7912ebc64653d5f8cb3872d9bb4b5e525814ba7158ee96",
+      "hash_history": [],
+      "deprecated_aliases": []
+    },
+    {
+      "canonical_name": "help",
+      "type": "official",
+      "content_sha256": "5bb21aef1078642511505a5cdc02f6a631767201255eaba3c721ca3530c47e54",
+      "hash_history": [],
+      "deprecated_aliases": []
+    },
+    {
+      "canonical_name": "honest-mode",
+      "type": "official",
+      "content_sha256": "506335fe70355dfe1b045ab13e4fb746f49fc7169433ce18fec74b0c04eb987d",
+      "hash_history": [],
+      "deprecated_aliases": []
+    },
+    {
+      "canonical_name": "hproof-claim-ledger",
+      "type": "official",
+      "content_sha256": "837743afc2f559fbd294cf916b73f68d907f3bcc275c9d340342c9e876da238d",
+      "hash_history": [],
+      "deprecated_aliases": []
+    },
+    {
+      "canonical_name": "hproof-evidence-bind",
+      "type": "official",
+      "content_sha256": "0ad34819b743ba3644d851c37b0a964b7aa19b3b8f79107f271f0a75b37f69a2",
+      "hash_history": [],
+      "deprecated_aliases": []
+    },
+    {
+      "canonical_name": "image-ux-review",
+      "type": "core",
+      "content_sha256": "ee7b79b4088ec236cfeb3957286970f63ae635f7c00b3d7cb7ee45c2deabb9b1",
+      "hash_history": [],
+      "deprecated_aliases": []
+    },
+    {
+      "canonical_name": "imagegen",
+      "type": "official",
+      "content_sha256": "e8bdd4695a6e716ccfe19ed591d03710aaf0c8e1529196d3fd6c2fd2b84c8de1",
+      "hash_history": [],
+      "deprecated_aliases": []
+    },
+    {
+      "canonical_name": "imagegen-source-scout",
+      "type": "official",
+      "content_sha256": "9b7b42e64de3c731ed42c85c8188cea0d6b2a074b87e653c953459b13c777a4f",
+      "hash_history": [],
+      "deprecated_aliases": []
+    },
+    {
+      "canonical_name": "init-deep",
+      "type": "core",
+      "content_sha256": "45a0381245a7d2bb0305a269d9feda6abc3bdc569c1e8492f6059c22928e941f",
+      "hash_history": [],
+      "deprecated_aliases": []
+    },
+    {
+      "canonical_name": "insane-search",
+      "type": "official",
+      "content_sha256": "3589b5961e7683740c4c397e66a9a31222a5ddbfbd52eb85b2036c4892f14347",
+      "hash_history": [],
+      "deprecated_aliases": []
+    },
+    {
+      "canonical_name": "kage-bunshin",
+      "type": "official",
+      "content_sha256": "d5c41416021ef9b77752a576a0e7c583b44274abe4d5bb22d3fc0705b5b1ec19",
+      "hash_history": [],
+      "deprecated_aliases": []
+    },
+    {
+      "canonical_name": "loop",
+      "type": "core",
+      "content_sha256": "68e60308a1944c5d7b1207c28ab10490155e04192915b3e7923d95088c45a33a",
+      "hash_history": [],
+      "deprecated_aliases": []
+    },
+    {
+      "canonical_name": "mad-db",
+      "type": "official",
+      "content_sha256": "1f57f8f133688de485d7f1739d19fdf611a7a73d353c58c7f1e402e15b233076",
+      "hash_history": [],
+      "deprecated_aliases": []
+    },
+    {
+      "canonical_name": "mad-sks",
+      "type": "official",
+      "content_sha256": "26334cc7286c8f289a8a605786231d076d969a0d3e339da5a8ead9a63791694e",
+      "hash_history": [],
+      "deprecated_aliases": []
+    },
+    {
+      "canonical_name": "naruto",
+      "type": "core",
+      "content_sha256": "3d523d19e7886ab0ef9b62572df6da4fd837245bd75e4a2dfef40170c08712b0",
+      "hash_history": [],
+      "deprecated_aliases": [
+        "shadow-clone-legacy"
+      ]
+    },
+    {
+      "canonical_name": "performance-evaluator",
+      "type": "official",
+      "content_sha256": "d722992ec4d0660f22e489a90da2810a7830c30f493f0fee0e2d4979252e6f5a",
+      "hash_history": [],
+      "deprecated_aliases": []
+    },
+    {
+      "canonical_name": "pipeline-runner",
+      "type": "official",
+      "content_sha256": "d7d4ceaceabe0903a04a376954747ee9b6c315a73052c951f5470f488c1d6d1d",
+      "hash_history": [],
+      "deprecated_aliases": []
+    },
+    {
+      "canonical_name": "ppt",
+      "type": "official",
+      "content_sha256": "e4c21f41d533f5fc7920a9833e99b9b6e51d62ca682a6d4186a5d5e3b7c88a98",
+      "hash_history": [],
+      "deprecated_aliases": []
+    },
+    {
+      "canonical_name": "prompt-pipeline",
+      "type": "official",
+      "content_sha256": "498e88ed0ca59e10db7a2e8835f985254b17a80ae6cfb623a5e747f07a59e1d6",
+      "hash_history": [],
+      "deprecated_aliases": []
+    },
+    {
+      "canonical_name": "qa-loop",
+      "type": "core",
+      "content_sha256": "96187a82e955d3c71aff7e27d2d68e4c11954ccad3069ef5b62069a1ec8d78c1",
+      "hash_history": [],
+      "deprecated_aliases": [
+        "qaloop"
+      ]
+    },
+    {
+      "canonical_name": "reasoning-router",
+      "type": "official",
+      "content_sha256": "c41ce62468fcccdcc3c2decbf33aed0c524dfe27c31a394064497719aa9b2afa",
+      "hash_history": [],
+      "deprecated_aliases": []
+    },
+    {
+      "canonical_name": "reflection",
+      "type": "official",
+      "content_sha256": "4939f70f7378666934c390b421f799eadaa47961654733fbd421a4b4707742a3",
+      "hash_history": [],
+      "deprecated_aliases": []
+    },
+    {
+      "canonical_name": "release-review",
+      "type": "official",
+      "content_sha256": "3d8b36cc9013d29ca2435812f32fa7a3ac1e28170252f0d97d46b7f7a84334b5",
+      "hash_history": [],
+      "deprecated_aliases": []
+    },
+    {
+      "canonical_name": "research",
+      "type": "core",
+      "content_sha256": "fd0ede8f92775e17249825f53445980af9317bc1d4c786016d08a711695795ff",
+      "hash_history": [],
+      "deprecated_aliases": []
+    },
+    {
+      "canonical_name": "research-discovery",
+      "type": "official",
+      "content_sha256": "6a37e3acaf1801e24ce6b70736993502396cff6e4de99c2182020468a3744850",
+      "hash_history": [],
+      "deprecated_aliases": []
+    },
+    {
+      "canonical_name": "search-visibility-core",
+      "type": "core",
+      "content_sha256": "0f145feb5908552ec5867e52b410f567b2dc5db66c57969d786d1f23be15b588",
+      "hash_history": [],
+      "deprecated_aliases": []
+    },
+    {
+      "canonical_name": "seo-geo-optimizer",
+      "type": "core",
+      "content_sha256": "9bb38a7d7791670402793492e4cebec3e5742fa07a24d377a282556f3ca71802",
+      "hash_history": [],
+      "deprecated_aliases": []
+    },
+    {
+      "canonical_name": "shadow-clone",
+      "type": "official",
+      "content_sha256": "013cac960cbf627e04b5c50ff45e15ed824a2863ed8d2a40bca46f8c688b3f8b",
+      "hash_history": [],
+      "deprecated_aliases": []
+    },
+    {
+      "canonical_name": "sks",
+      "type": "official",
+      "content_sha256": "ba939b92845092f0f79a749b964cb54c8514a78305731de633f0aae1594464ff",
+      "hash_history": [],
+      "deprecated_aliases": [
+        "ralph",
+        "Ralph",
+        "ralph-supervisor",
+        "ralph-resolver"
+      ]
+    },
+    {
+      "canonical_name": "solution-scout",
+      "type": "official",
+      "content_sha256": "35fc6b90f2dae5f07ba9978121a9847c2e6221f6c9f2fa50d9214185a850939f",
+      "hash_history": [],
+      "deprecated_aliases": []
+    },
+    {
+      "canonical_name": "team",
+      "type": "official",
+      "content_sha256": "fafb2e51ae9b0f555edb2a940b995162c0b58d0c1ca40998ddce1b9ef3fd5ee2",
+      "hash_history": [],
+      "deprecated_aliases": [
+        "agent-team"
+      ]
+    },
+    {
+      "canonical_name": "turbo-context-pack",
+      "type": "official",
+      "content_sha256": "681a9917622120e63e50f13f9f15ea9b1ee24bcda53b56b2995d0670e5a46379",
+      "hash_history": [],
+      "deprecated_aliases": []
+    },
+    {
+      "canonical_name": "ui-ux-review",
+      "type": "official",
+      "content_sha256": "dcf08b18a2154ddcbec47142454bf0ce2c2585c1d36fc6b8a00d8b5302420eb4",
+      "hash_history": [],
+      "deprecated_aliases": []
+    },
+    {
+      "canonical_name": "ultra-search",
+      "type": "official",
+      "content_sha256": "119a8f2dfcab262a94f95fd3ce5f1d6cc87717052ca3799611df903bd4d14fdf",
+      "hash_history": [],
+      "deprecated_aliases": []
+    },
+    {
+      "canonical_name": "ux-review",
+      "type": "official",
+      "content_sha256": "3cb20729475d9466becde13c10785deb104c743898e6d66536edf15e21022447",
+      "hash_history": [],
+      "deprecated_aliases": []
+    },
+    {
+      "canonical_name": "visual-review",
+      "type": "official",
+      "content_sha256": "d7bf165e9d04fc4a19b9bac29e158d0f0b6ee2781061d10860ecec9720c5463b",
+      "hash_history": [],
+      "deprecated_aliases": []
+    },
+    {
+      "canonical_name": "wiki",
+      "type": "official",
+      "content_sha256": "8257bd01a5439d1ba4518ed62aec06a0b116208774c209913fc82b25208c7c1e",
+      "hash_history": [],
+      "deprecated_aliases": [
+        "wiki-refresh",
+        "wikirefresh"
+      ]
+    },
+    {
+      "canonical_name": "with-local-llm-off",
+      "type": "official",
+      "content_sha256": "f124a2ce9dca73ee39852ae9356ece2734f157e502bfbd4b5ce64fcdfd0410a5",
+      "hash_history": [],
+      "deprecated_aliases": []
+    },
+    {
+      "canonical_name": "with-local-llm-on",
+      "type": "official",
+      "content_sha256": "e81f97104d432081430d664e1e8ce3ff39ff22639c05a18b054f2b16e7f18d64",
+      "hash_history": [],
+      "deprecated_aliases": []
+    }
+  ],
+  "removed_skills": [
+    "old-workflow",
+    "team-legacy"
+  ]
+}

package/dist/core/agents/agent-lifecycle.js

@@ -1,4 +1,5 @@
 import path from 'node:path';
+import fsp from 'node:fs/promises';
 import { nowIso, readJson, writeJsonAtomic } from '../fsx.js';
 import { appendAgentLedgerEvent } from './agent-central-ledger.js';
 export const AGENT_LIFECYCLE_STATES = Object.freeze(['planned', 'launching', 'running', 'heartbeat_missing', 'collecting', 'completed', 'failed', 'timed_out', 'closing', 'closed', 'killed']);
@@ -6,10 +7,12 @@ export const AGENT_HEARTBEAT_INTERVAL_MS = 5000;
 export const AGENT_HEARTBEAT_TIMEOUT_MS = 60000;
 export const AGENT_HARD_TIMEOUT_MS = 30 * 60 * 1000;
 const SESSION_LOCKS = new Map();
-async function withSessionLock(root, fn) {
-    const previous = SESSION_LOCKS.get(root) || Promise.resolve();
+const AGGREGATE_FLUSH_TIMERS = new Map();
+async function withSessionLock(root, sessionId, fn) {
+    const key = `${path.resolve(root)}:${sessionId || 'aggregate'}`;
+    const previous = SESSION_LOCKS.get(key) || Promise.resolve();
     const next = previous.catch(() => undefined).then(fn);
-    SESSION_LOCKS.set(root, next.catch(() => undefined));
+    SESSION_LOCKS.set(key, next.catch(() => undefined));
     return next;
 }
 export async function openAgentSession(root, agent) {
@@ -30,8 +33,7 @@ export async function closeAgentSession(root, agent, status = 'closed') {
     return updateSession(root, agent, { status, closed_at: nowIso(), heartbeat_at: nowIso() }, 'session_closed', agent.session_id);
 }
 export async function assertAllAgentSessionsClosed(root) {
-    const sessions = await readJson(path.join(root, 'agent-sessions.json'), { sessions: {} });
-    const rows = Object.values(sessions.sessions || {});
+    const rows = await readAllSessionRows(root);
     const open = rows.filter((session) => !['closed', 'blocked', 'failed', 'killed', 'timed_out'].includes(String(session.status)));
     const closed = rows.filter((session) => String(session.status) === 'closed');
     return {
@@ -55,8 +57,7 @@ export async function writeAgentLifecyclePolicy(root) {
     return policy;
 }
 export async function writeAgentLifecycleAggregate(root) {
-    const sessions = await readJson(path.join(root, 'agent-sessions.json'), { sessions: {} });
-    const rows = Object.values(sessions.sessions || {});
+    const rows = await readAllSessionRows(root);
     const aggregate = {
         schema: 'sks.agent-lifecycle-aggregate.v1',
         updated_at: nowIso(),
@@ -64,6 +65,10 @@ export async function writeAgentLifecycleAggregate(root) {
         total_sessions: rows.length,
         closed_session_count: rows.filter((session) => String(session.status) === 'closed').length
     };
+    await writeJsonAtomic(path.join(root, 'agent-sessions.json'), {
+        schema: 'sks.agent-sessions.v1',
+        sessions: Object.fromEntries(rows.map((session) => [String(session.session_key || session.session_id || session.agent_id || ''), session]))
+    });
     await writeJsonAtomic(path.join(root, 'agent-lifecycle-aggregate.json'), aggregate);
     await writeJsonAtomic(path.join(root, 'agent-lifecycle.json'), {
         schema: 'sks.agent-lifecycle.v1',
@@ -73,8 +78,8 @@ export async function writeAgentLifecycleAggregate(root) {
     return aggregate;
 }
 export async function detectStaleAgentSessions(root, now = Date.now()) {
-    const sessions = await readJson(path.join(root, 'agent-sessions.json'), { sessions: {} });
-    const stale = Object.values(sessions.sessions || {}).filter((session) => {
+    const rows = await readAllSessionRows(root);
+    const stale = rows.filter((session) => {
         if (['closed', 'blocked', 'failed', 'killed', 'timed_out'].includes(String(session.status)))
             return false;
         const heartbeat = Date.parse(String(session.heartbeat_at || session.opened_at || ''));
@@ -89,12 +94,11 @@ export function agentHardTimeoutMs(env = process.env) {
     return Math.max(1000, Math.min(raw, 24 * 60 * 60 * 1000));
 }
 export async function killTimedOutAgentSessions(root, now = Date.now(), opts = {}) {
-    return withSessionLock(root, async () => {
+    return withSessionLock(root, 'timeout-reaper', async () => {
         const hardTimeoutMs = opts.hardTimeoutMs || agentHardTimeoutMs(opts.env);
-        const file = path.join(root, 'agent-sessions.json');
-        const data = await readJson(file, { schema: 'sks.agent-sessions.v1', sessions: {} });
+        const rows = await readAllSessionRows(root);
         const killed = [];
-        for (const [sessionKey, session] of Object.entries(data.sessions || {})) {
+        for (const session of rows) {
             if (['closed', 'blocked', 'failed', 'killed', 'timed_out'].includes(String(session.status)))
                 continue;
             const opened = Date.parse(String(session.opened_at || ''));
@@ -103,8 +107,8 @@ export async function killTimedOutAgentSessions(root, now = Date.now(), opts = {
             const heartbeatTimedOut = Number.isFinite(heartbeat) && now - heartbeat > AGENT_HEARTBEAT_TIMEOUT_MS;
             if (!hardTimedOut && !heartbeatTimedOut)
                 continue;
-            const sessionId = session.session_id || sessionKey;
-            data.sessions[sessionKey] = {
+            const sessionId = session.session_id || session.session_key || session.agent_id;
+            const next = {
                 ...session,
                 status: 'killed',
                 killed_at: new Date(now).toISOString(),
@@ -112,11 +116,10 @@ export async function killTimedOutAgentSessions(root, now = Date.now(), opts = {
                 heartbeat_at: new Date(now).toISOString(),
                 kill_reason: hardTimedOut ? 'hard_timeout' : 'heartbeat_timeout'
             };
-            await writeSessionRecord(root, data.sessions[sessionKey]);
-            await appendAgentLedgerEvent(root, { agent_id: String(session.agent_id || sessionKey), session_id: sessionId, event_type: 'session_killed_timeout', payload: { kill_reason: data.sessions[sessionKey].kill_reason } });
+            await writeSessionRecord(root, next);
+            await appendAgentLedgerEvent(root, { agent_id: String(session.agent_id || sessionId), session_id: sessionId, event_type: 'session_killed_timeout', payload: { kill_reason: next.kill_reason } });
             killed.push(sessionId);
         }
-        await writeJsonAtomic(file, data);
         await writeAgentLifecycleAggregate(root);
         const report = {
             schema: 'sks.agent-timeout-kill-report.v1',
@@ -130,40 +133,88 @@ export async function killTimedOutAgentSessions(root, now = Date.now(), opts = {
     });
 }
 async function updateSession(root, agent, patch, eventType, sessionId) {
-    return withSessionLock(root, async () => {
-        const file = path.join(root, 'agent-sessions.json');
-        const data = await readJson(file, { schema: 'sks.agent-sessions.v1', sessions: {} });
-        data.sessions = data.sessions || {};
-        const agentId = String(agent.id || agent.agent_id || sessionId);
-        const sessionKey = String(agent.session_generation_id || agent.session_id || agentId);
-        data.sessions[sessionKey] = {
-            ...(data.sessions[sessionKey] || {
+    const agentId = String(agent.id || agent.agent_id || sessionId);
+    const sessionKey = String(agent.session_generation_id || agent.session_id || agentId);
+    return withSessionLock(root, sessionKey, async () => {
+        const current = await readSessionRow(root, sessionKey);
+        const next = {
+            ...(current || {
                 agent_id: agentId,
                 slot_id: agent.slot_id || agent.worker_slot_id || null,
                 generation_index: Number.isFinite(Number(agent.generation_index)) ? Number(agent.generation_index) : null,
                 session_artifact_dir: agent.session_artifact_dir || null,
-                session_id: sessionId
+                session_id: sessionId,
+                session_key: sessionKey
             }),
             agent_id: agentId,
-            slot_id: agent.slot_id || agent.worker_slot_id || data.sessions[sessionKey]?.slot_id || null,
-            generation_index: Number.isFinite(Number(agent.generation_index)) ? Number(agent.generation_index) : data.sessions[sessionKey]?.generation_index ?? null,
-            session_artifact_dir: agent.session_artifact_dir || data.sessions[sessionKey]?.session_artifact_dir || null,
+            slot_id: agent.slot_id || agent.worker_slot_id || current?.slot_id || null,
+            generation_index: Number.isFinite(Number(agent.generation_index)) ? Number(agent.generation_index) : current?.generation_index ?? null,
+            session_artifact_dir: agent.session_artifact_dir || current?.session_artifact_dir || null,
             session_id: sessionId,
+            session_key: sessionKey,
             ...patch
         };
-        await writeJsonAtomic(file, data);
-        await writeSessionRecord(root, data.sessions[sessionKey]);
-        await writeAgentLifecycleAggregate(root);
+        await writeSessionRecord(root, next);
+        if (eventType === 'heartbeat')
+            scheduleAgentLifecycleAggregate(root);
+        else
+            await writeAgentLifecycleAggregate(root);
         await appendAgentLedgerEvent(root, { agent_id: agentId, session_id: sessionId, event_type: eventType, payload: patch });
-        return data.sessions[sessionKey];
+        return next;
     });
 }
 async function writeSessionRecord(root, session) {
+    const sessionKey = sanitizeSessionFileName(session.session_key || session.session_id || session.agent_id || 'session');
+    await writeJsonAtomic(path.join(sessionShardDir(root), `${sessionKey}.json`), { schema: 'sks.agent-session-record.v1', ...session, session_key: sessionKey });
     const artifactDir = session.session_artifact_dir;
     if (artifactDir) {
         await writeJsonAtomic(path.join(root, artifactDir, 'agent-session-record.json'), { schema: 'sks.agent-session-record.v1', ...session });
         return;
     }
-    await writeJsonAtomic(path.join(root, 'sessions', String(session.agent_id || session.session_id) + '.json'), { schema: 'sks.agent-session-record.v1', ...session });
+}
+async function readSessionRow(root, sessionKey) {
+    const shard = await readJson(path.join(sessionShardDir(root), `${sanitizeSessionFileName(sessionKey)}.json`), null).catch(() => null);
+    if (shard)
+        return shard;
+    const aggregate = await readJson(path.join(root, 'agent-sessions.json'), { sessions: {} }).catch(() => ({ sessions: {} }));
+    const sessions = Array.isArray(aggregate?.sessions)
+        ? Object.fromEntries(aggregate.sessions.map((row) => [String(row.session_key || row.session_id || row.agent_id || ''), row]))
+        : aggregate?.sessions || {};
+    return sessions[sessionKey] || null;
+}
+async function readAllSessionRows(root) {
+    const rows = [];
+    const dir = sessionShardDir(root);
+    const names = await fsp.readdir(dir).catch(() => []);
+    for (const name of names.sort()) {
+        if (!name.endsWith('.json'))
+            continue;
+        const row = await readJson(path.join(dir, name), null).catch(() => null);
+        if (row && row.schema === 'sks.agent-session-record.v1')
+            rows.push(row);
+    }
+    if (rows.length)
+        return rows;
+    const aggregate = await readJson(path.join(root, 'agent-sessions.json'), { sessions: {} }).catch(() => ({ sessions: {} }));
+    if (Array.isArray(aggregate?.sessions))
+        return aggregate.sessions;
+    return Object.values(aggregate?.sessions || {});
+}
+function scheduleAgentLifecycleAggregate(root) {
+    const key = path.resolve(root);
+    if (AGGREGATE_FLUSH_TIMERS.has(key))
+        return;
+    const timer = setTimeout(() => {
+        AGGREGATE_FLUSH_TIMERS.delete(key);
+        writeAgentLifecycleAggregate(root).catch(() => undefined);
+    }, 5000);
+    timer.unref?.();
+    AGGREGATE_FLUSH_TIMERS.set(key, timer);
+}
+function sessionShardDir(root) {
+    return path.join(root, 'sessions');
+}
+function sanitizeSessionFileName(value) {
+    return String(value || 'session').replace(/[^A-Za-z0-9._-]+/g, '_');
 }
 //# sourceMappingURL=agent-lifecycle.js.map