@xemahq/opencode-xema-plugin 0.3.0 → 0.4.0

package/dist/hooks/subagent-fanout-ceiling.js

@@ -1,8 +1,9 @@
-import { info, warn, debug } from '../logger.js';
-export const TASK_TOOL_ID = 'task';
+import { debug, info, warn } from '../logger.js';
+export const SUBAGENT_TOOL_ID = 'subagent';
 export const DEFAULT_SUBAGENT_FANOUT_LIMIT = 8;
 export const DEFAULT_FANOUT_WAIT_TIMEOUT_MS = 10 * 60 * 1000;
-export const DEFAULT_PERMIT_TTL_MS = 30 * 60 * 1000;
+export const DEFAULT_ACTIVE_CHILD_TTL_MS = 30 * 60 * 1000;
+export const DEFAULT_PENDING_SLOT_TTL_MS = 2 * 60 * 1000;
 export const FANOUT_LIMIT_ENV = 'XEMA_SUBAGENT_FANOUT_LIMIT';
 export function resolveSubagentFanoutLimit(env = process.env) {
     const declared = env[FANOUT_LIMIT_ENV];
@@ -12,7 +13,7 @@ export function resolveSubagentFanoutLimit(env = process.env) {
     const parsed = Number(declared.trim());
     if (!Number.isInteger(parsed)) {
         throw new Error(`${FANOUT_LIMIT_ENV}="${declared}" is not an integer. Expected a whole number of ` +
-            `concurrently executing sub-agent tasks between 1 and ${DEFAULT_SUBAGENT_FANOUT_LIMIT}.`);
+            `concurrently running sub-agents between 1 and ${DEFAULT_SUBAGENT_FANOUT_LIMIT}.`);
     }
     if (parsed < 1) {
         throw new Error(`${FANOUT_LIMIT_ENV}="${declared}" is below 1. A ceiling of 0 would park EVERY delegation ` +
@@ -30,15 +31,17 @@ export function resolveSubagentFanoutLimit(env = process.env) {
 export function createSubagentFanoutCeiling(options) {
     const limit = options.limit;
     const waitTimeoutMs = options.waitTimeoutMs ?? DEFAULT_FANOUT_WAIT_TIMEOUT_MS;
-    const permitTtlMs = options.permitTtlMs ?? DEFAULT_PERMIT_TTL_MS;
+    const pendingSlotTtlMs = options.pendingSlotTtlMs ?? DEFAULT_PENDING_SLOT_TTL_MS;
+    const activeChildTtlMs = options.activeChildTtlMs ?? DEFAULT_ACTIVE_CHILD_TTL_MS;
     const now = options.now ?? (() => Date.now());
-    const held = new Map();
+    const pending = [];
+    const active = new Map();
     const waiters = [];
+    const armed = new Set();
     let waitedCount = 0;
     let timedOutCount = 0;
-    let sweptCount = 0;
-    let ttlReclaimedCount = 0;
-    const armed = new Set();
+    let pendingTtlReclaimedCount = 0;
+    let activeTtlReclaimedCount = 0;
     function arm(fn, ms, keepProcessAlive) {
         const timer = setTimeout(() => {
             armed.delete(timer);
@@ -55,132 +58,143 @@ export function createSubagentFanoutCeiling(options) {
         clearTimeout(timer);
         armed.delete(timer);
     }
-    function take(callId, sessionId) {
-        const ttlTimer = arm(() => {
-            if (!held.has(callId))
+    const occupied = () => pending.length + active.size;
+    function reserve(callId, parentSessionId) {
+        const slot = { callId, parentSessionId, since: now(), timer: undefined };
+        slot.timer = arm(() => {
+            const index = pending.indexOf(slot);
+            if (index === -1)
+                return;
+            pending.splice(index, 1);
+            pendingTtlReclaimedCount += 1;
+            warn(`fanout-ceiling: reserved slot for call=${callId} session=${parentSessionId} never ` +
+                `became a child session within ${pendingSlotTtlMs}ms — reclaiming (its ` +
+                `execute.after was lost; V2 does not guarantee it on abort).`);
+            drain();
+        }, pendingSlotTtlMs, false);
+        pending.push(slot);
+    }
+    function activate(childSessionId, parentSessionId) {
+        const timer = arm(() => {
+            if (!active.has(childSessionId))
                 return;
-            ttlReclaimedCount += 1;
-            warn(`fanout-ceiling: permit TTL expired for call=${callId} session=${sessionId} after ` +
-                `${permitTtlMs}ms — force-releasing. A task held a slot longer than any healthy ` +
-                `sub-agent turn; the pool would otherwise have shrunk permanently.`);
-            release(callId, 'ttl');
-        }, permitTtlMs, false);
-        held.set(callId, { sessionId, acquiredAt: now(), ttlTimer });
+            activeTtlReclaimedCount += 1;
+            warn(`fanout-ceiling: child session=${childSessionId} held a slot for ${activeChildTtlMs}ms ` +
+                `with no terminal event — force-releasing so the pool cannot shrink permanently.`);
+            releaseActive(childSessionId, 'active-ttl');
+        }, activeChildTtlMs, false);
+        active.set(childSessionId, { childSessionId, parentSessionId, since: now(), timer });
     }
-    function release(callId, reason) {
-        const permit = held.get(callId);
-        if (permit === undefined)
+    function releaseActive(childSessionId, reason) {
+        const child = active.get(childSessionId);
+        if (child === undefined)
             return;
-        disarm(permit.ttlTimer);
-        held.delete(callId);
-        if (reason !== 'completed') {
-            debug(`fanout-ceiling: reclaimed call=${callId} via ${reason} ` +
-                `(held ${now() - permit.acquiredAt}ms)`);
-        }
+        disarm(child.timer);
+        active.delete(childSessionId);
+        debug(`fanout-ceiling: released child=${childSessionId} via ${reason} ` +
+            `(held ${now() - child.since}ms, occupied=${occupied()}/${limit})`);
         drain();
     }
     function drain() {
-        while (waiters.length > 0 && held.size < limit) {
+        while (waiters.length > 0 && occupied() < limit) {
             const next = waiters.shift();
             if (next === undefined)
                 return;
             disarm(next.timer);
-            const waitedMs = now() - next.since;
             waitedCount += 1;
-            take(next.callId, next.sessionId);
-            info(`fanout-ceiling: admitted call=${next.callId} session=${next.sessionId} after waiting ` +
-                `${waitedMs}ms (limit=${limit}, in-flight=${held.size}, still waiting=${waiters.length})`);
+            reserve(next.callId, next.parentSessionId);
+            info(`fanout-ceiling: admitted call=${next.callId} session=${next.parentSessionId} after ` +
+                `waiting ${now() - next.since}ms (limit=${limit}, occupied=${occupied()}, ` +
+                `still waiting=${waiters.length})`);
             next.grant();
         }
     }
-    async function before(input) {
-        if (input.tool !== TASK_TOOL_ID)
+    async function beforeToolCall(input) {
+        if (input.tool !== SUBAGENT_TOOL_ID)
             return;
-        const { callID: callId, sessionID: sessionId } = input;
-        if (held.size < limit) {
-            take(callId, sessionId);
-            debug(`fanout-ceiling: admitted call=${callId} immediately ` +
-                `(in-flight=${held.size}/${limit})`);
+        const { id: callId, sessionID: parentSessionId } = input;
+        if (occupied() < limit) {
+            reserve(callId, parentSessionId);
             return;
         }
         const since = now();
-        warn(`fanout-ceiling: sub-agent fan-out at ceiling — call=${callId} session=${sessionId} is ` +
-            `WAITING (limit=${limit}, in-flight=${held.size}, already waiting=${waiters.length}). ` +
-            `This is backpressure, not a refusal: the task will start when a slot frees.`);
+        warn(`fanout-ceiling: sub-agent fan-out at ceiling — call=${callId} session=${parentSessionId} ` +
+            `is WAITING (limit=${limit}, pending=${pending.length}, active=${active.size}, ` +
+            `already waiting=${waiters.length}). Backpressure, not a refusal.`);
         await new Promise((resolve) => {
-            const waiter = {
-                callId,
-                sessionId,
-                since,
-                grant: resolve,
-                timer: undefined,
-            };
+            const waiter = { callId, parentSessionId, since, grant: resolve, timer: undefined };
             waiter.timer = arm(() => {
-                const idx = waiters.indexOf(waiter);
-                if (idx === -1)
+                const index = waiters.indexOf(waiter);
+                if (index === -1)
                     return;
-                waiters.splice(idx, 1);
+                waiters.splice(index, 1);
                 timedOutCount += 1;
-                warn(`fanout-ceiling: call=${callId} session=${sessionId} waited ${waitTimeoutMs}ms and is ` +
-                    `being ADMITTED OVER the ceiling (limit=${limit}, in-flight=${held.size}). The pool ` +
-                    `did not free a slot in that window — suspect a leaked permit or a stuck sub-agent.`);
-                take(callId, sessionId);
+                warn(`fanout-ceiling: call=${callId} session=${parentSessionId} waited ${waitTimeoutMs}ms ` +
+                    `and is ADMITTED OVER the ceiling (limit=${limit}, occupied=${occupied()}). ` +
+                    `Suspect a leaked slot or a stuck sub-agent.`);
+                reserve(callId, parentSessionId);
                 resolve();
             }, waitTimeoutMs, true);
             waiters.push(waiter);
         });
     }
-    function after(input) {
-        if (input.tool !== TASK_TOOL_ID)
+    function afterToolCall(input) {
+        if (input.tool !== SUBAGENT_TOOL_ID)
+            return;
+        const index = pending.findIndex((slot) => slot.callId === input.id);
+        if (index === -1)
             return;
-        release(input.callID, 'completed');
+        const [slot] = pending.splice(index, 1);
+        disarm(slot?.timer);
+        debug(`fanout-ceiling: call=${input.id} ended before any child existed — slot released`);
+        drain();
     }
-    function onSessionIdle(sessionId) {
-        const stale = [];
-        for (const [callId, permit] of held) {
-            if (permit.sessionId === sessionId)
-                stale.push(callId);
-        }
-        if (stale.length === 0)
+    function onSessionCreated(sessionId, parentId) {
+        if (parentId === undefined || active.has(sessionId))
             return;
-        sweptCount += stale.length;
-        warn(`fanout-ceiling: session=${sessionId} went idle still holding ${stale.length} permit(s) ` +
-            `[${stale.join(', ')}] — reclaiming. These tasks ended without a tool.execute.after, ` +
-            `which upstream does not fire on the failure path.`);
-        for (const callId of stale)
-            release(callId, 'session-idle');
+        const index = pending.findIndex((slot) => slot.parentSessionId === parentId);
+        if (index === -1) {
+            debug(`fanout-ceiling: unreserved child=${sessionId} of parent=${parentId} — counted`);
+        }
+        else {
+            const [slot] = pending.splice(index, 1);
+            disarm(slot?.timer);
+        }
+        activate(sessionId, parentId);
+    }
+    function onSessionTerminal(sessionId) {
+        releaseActive(sessionId, 'terminal');
     }
     function dispose() {
-        const parked = waiters.length;
-        const outstanding = held.size;
         while (waiters.length > 0) {
-            const w = waiters.shift();
-            if (w === undefined)
+            const waiter = waiters.shift();
+            if (waiter === undefined)
                 break;
-            disarm(w.timer);
-            w.grant();
-        }
-        for (const permit of held.values())
-            disarm(permit.ttlTimer);
-        held.clear();
-        if (parked > 0 || outstanding > 0) {
-            info(`fanout-ceiling: disposed — released ${parked} parked task(s) and disarmed ` +
-                `${outstanding} permit timer(s).`);
+            disarm(waiter.timer);
+            waiter.grant();
         }
+        for (const slot of pending)
+            disarm(slot.timer);
+        pending.length = 0;
+        for (const child of active.values())
+            disarm(child.timer);
+        active.clear();
     }
     return {
-        before,
-        after,
-        onSessionIdle,
+        beforeToolCall,
+        afterToolCall,
+        onSessionCreated,
+        onSessionTerminal,
         dispose,
         stats: () => ({
             limit,
-            inFlight: held.size,
+            pending: pending.length,
+            active: active.size,
             waiting: waiters.length,
             waitedCount,
             timedOutCount,
-            sweptCount,
-            ttlReclaimedCount,
+            pendingTtlReclaimedCount,
+            activeTtlReclaimedCount,
             armedTimers: armed.size,
         }),
     };

package/dist/hooks/subagent-fanout-ceiling.js.map

@@ -1 +1 @@
-{"version":3,"file":"subagent-fanout-ceiling.js","sourceRoot":"","sources":["../../src/hooks/subagent-fanout-ceiling.ts"],"names":[],"mappings":"AAuFA,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAGjD,MAAM,CAAC,MAAM,YAAY,GAAG,MAAM,CAAC;AA6CnC,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,CAAC;AAW/C,MAAM,CAAC,MAAM,8BAA8B,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAU7D,MAAM,CAAC,MAAM,qBAAqB,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAGpD,MAAM,CAAC,MAAM,gBAAgB,GAAG,4BAA4B,CAAC;AAyB7D,MAAM,UAAU,0BAA0B,CACxC,MAAoD,OAAO,CAAC,GAAG;IAE/D,MAAM,QAAQ,GAAG,GAAG,CAAC,gBAAgB,CAAC,CAAC;IACvC,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACrD,OAAO,6BAA6B,CAAC;IACvC,CAAC;IAGD,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IACvC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CACb,GAAG,gBAAgB,KAAK,QAAQ,kDAAkD;YAChF,wDAAwD,6BAA6B,GAAG,CAC3F,CAAC;IACJ,CAAC;IACD,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,GAAG,gBAAgB,KAAK,QAAQ,2DAA2D;YACzF,sFAAsF;YACtF,gCAAgC,6BAA6B,IAAI,CACpE,CAAC;IACJ,CAAC;IACD,IAAI,MAAM,GAAG,6BAA6B,EAAE,CAAC;QAC3C,MAAM,IAAI,KAAK,CACb,GAAG,gBAAgB,KAAK,QAAQ,kCAAkC;YAChE,IAAI,6BAA6B,sDAAsD;YACvF,2DAA2D;YAC3D,gEAAgE,CACnE,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAiGD,MAAM,UAAU,2BAA2B,CACzC,OAA6B;IAE7B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;IAC5B,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,IAAI,8BAA8B,CAAC;IAC9E,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,qBAAqB,CAAC;IACjE,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IAE9C,MAAM,IAAI,GAAG,IAAI,GAAG,EAAsB,CAAC;IAC3C,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,IAAI,WAAW,GAAG,CAAC,CAAC;IACpB,IAAI,aAAa,GAAG,CAAC,CAAC;IACtB,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,IAAI,iBAAiB,GAAG,CAAC,CAAC;IAc1B,MAAM,KAAK,GAAG,IAAI,GAAG,EAAiC,CAAC;IAUvD,SAAS,GAAG,CACV,EAAc,EACd,EAAU,EACV,gBAAyB;QAEzB,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACpB,EAAE,EAAE,CAAC;QACP,CAAC,EAAE,EAAE,CAAC,CAAC;QACP,IAAI,CAAC,gBAAgB;YAAE,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC;QACvC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACjB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,SAAS,MAAM,CAAC,KAAgD;QAC9D,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO;QAChC,YAAY,CAAC,KAAK,CAAC,CAAC;QACpB,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC;IAED,SAAS,IAAI,CAAC,MAAc,EAAE,SAAiB;QAC7C,MAAM,QAAQ,GAAG,GAAG,CAAC,GAAG,EAAE;YACxB,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC;gBAAE,OAAO;YAC9B,iBAAiB,IAAI,CAAC,CAAC;YACvB,IAAI,CACF,+CAA+C,MAAM,YAAY,SAAS,SAAS;gBACjF,GAAG,WAAW,mEAAmE;gBACjF,mEAAmE,CACtE,CAAC;YACF,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QACzB,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,CAAC;QAOvB,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC/D,CAAC;IAED,SAAS,OAAO,CAAC,MAAc,EAAE,MAAqB;QACpD,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAChC,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO;QACjC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACxB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACpB,IAAI,MAAM,KAAK,WAAW,EAAE,CAAC;YAC3B,KAAK,CACH,kCAAkC,MAAM,QAAQ,MAAM,GAAG;gBACvD,SAAS,GAAG,EAAE,GAAG,MAAM,CAAC,UAAU,KAAK,CAC1C,CAAC;QACJ,CAAC;QACD,KAAK,EAAE,CAAC;IACV,CAAC;IAED,SAAS,KAAK;QACZ,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,IAAI,GAAG,KAAK,EAAE,CAAC;YAC/C,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;YAC7B,IAAI,IAAI,KAAK,SAAS;gBAAE,OAAO;YAC/B,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACnB,MAAM,QAAQ,GAAG,GAAG,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC;YACpC,WAAW,IAAI,CAAC,CAAC;YACjB,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;YAClC,IAAI,CACF,iCAAiC,IAAI,CAAC,MAAM,YAAY,IAAI,CAAC,SAAS,iBAAiB;gBACrF,GAAG,QAAQ,aAAa,KAAK,eAAe,IAAI,CAAC,IAAI,mBAAmB,OAAO,CAAC,MAAM,GAAG,CAC5F,CAAC;YACF,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,CAAC;IACH,CAAC;IAED,KAAK,UAAU,MAAM,CAAC,KAIrB;QACC,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY;YAAE,OAAO;QACxC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,KAAK,CAAC;QAEvD,IAAI,IAAI,CAAC,IAAI,GAAG,KAAK,EAAE,CAAC;YACtB,IAAI,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;YACxB,KAAK,CACH,iCAAiC,MAAM,eAAe;gBACpD,cAAc,IAAI,CAAC,IAAI,IAAI,KAAK,GAAG,CACtC,CAAC;YACF,OAAO;QACT,CAAC;QAID,MAAM,KAAK,GAAG,GAAG,EAAE,CAAC;QACpB,IAAI,CACF,uDAAuD,MAAM,YAAY,SAAS,MAAM;YACtF,kBAAkB,KAAK,eAAe,IAAI,CAAC,IAAI,qBAAqB,OAAO,CAAC,MAAM,KAAK;YACvF,6EAA6E,CAChF,CAAC;QAEF,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YAClC,MAAM,MAAM,GAAW;gBACrB,MAAM;gBACN,SAAS;gBACT,KAAK;gBACL,KAAK,EAAE,OAAO;gBACd,KAAK,EAAE,SAAS;aACjB,CAAC;YACF,MAAM,CAAC,KAAK,GAAG,GAAG,CAAC,GAAG,EAAE;gBACtB,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;gBACpC,IAAI,GAAG,KAAK,CAAC,CAAC;oBAAE,OAAO;gBACvB,OAAO,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;gBACvB,aAAa,IAAI,CAAC,CAAC;gBAKnB,IAAI,CACF,wBAAwB,MAAM,YAAY,SAAS,WAAW,aAAa,YAAY;oBACrF,0CAA0C,KAAK,eAAe,IAAI,CAAC,IAAI,cAAc;oBACrF,oFAAoF,CACvF,CAAC;gBACF,IAAI,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;gBACxB,OAAO,EAAE,CAAC;YACZ,CAAC,EAAE,aAAa,EAAE,IAAI,CAAC,CAAC;YAgBxB,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACvB,CAAC,CAAC,CAAC;IACL,CAAC;IAED,SAAS,KAAK,CAAC,KAId;QACC,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY;YAAE,OAAO;QACxC,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACrC,CAAC;IAED,SAAS,aAAa,CAAC,SAAiB;QAKtC,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,KAAK,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;YACpC,IAAI,MAAM,CAAC,SAAS,KAAK,SAAS;gBAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACzD,CAAC;QACD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAC/B,UAAU,IAAI,KAAK,CAAC,MAAM,CAAC;QAC3B,IAAI,CACF,2BAA2B,SAAS,4BAA4B,KAAK,CAAC,MAAM,aAAa;YACvF,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,kEAAkE;YACtF,mDAAmD,CACtD,CAAC;QACF,KAAK,MAAM,MAAM,IAAI,KAAK;YAAE,OAAO,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAC9D,CAAC;IAED,SAAS,OAAO;QACd,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC9B,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC;QAE9B,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1B,MAAM,CAAC,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;YAC1B,IAAI,CAAC,KAAK,SAAS;gBAAE,MAAM;YAC3B,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;YAChB,CAAC,CAAC,KAAK,EAAE,CAAC;QACZ,CAAC;QAED,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,MAAM,EAAE;YAAE,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC5D,IAAI,CAAC,KAAK,EAAE,CAAC;QACb,IAAI,MAAM,GAAG,CAAC,IAAI,WAAW,GAAG,CAAC,EAAE,CAAC;YAClC,IAAI,CACF,uCAAuC,MAAM,+BAA+B;gBAC1E,GAAG,WAAW,mBAAmB,CACpC,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO;QACL,MAAM;QACN,KAAK;QACL,aAAa;QACb,OAAO;QACP,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;YACZ,KAAK;YACL,QAAQ,EAAE,IAAI,CAAC,IAAI;YACnB,OAAO,EAAE,OAAO,CAAC,MAAM;YACvB,WAAW;YACX,aAAa;YACb,UAAU;YACV,iBAAiB;YACjB,WAAW,EAAE,KAAK,CAAC,IAAI;SACxB,CAAC;KACH,CAAC;AACJ,CAAC"}
+{"version":3,"file":"subagent-fanout-ceiling.js","sourceRoot":"","sources":["../../src/hooks/subagent-fanout-ceiling.ts"],"names":[],"mappings":"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"}

package/dist/hooks/system-overlay.d.ts

@@ -0,0 +1,6 @@
+import type { SessionContext } from '@opencode/plugin/promise/session';
+export type OverlaySystemPart = SessionContext['system'][number];
+export type OverlayContextInput = Pick<SessionContext, 'sessionID' | 'system'>;
+export declare const XEMA_OVERLAY_METADATA_KEY = "xema.system-overlay";
+export declare function buildSystemOverlayHook(directory: string): (input: OverlayContextInput) => void;
+//# sourceMappingURL=system-overlay.d.ts.map

package/dist/hooks/system-overlay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-overlay.d.ts","sourceRoot":"","sources":["../../src/hooks/system-overlay.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAQvE,MAAM,MAAM,iBAAiB,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC;AAGjE,MAAM,MAAM,mBAAmB,GAAG,IAAI,CAAC,cAAc,EAAE,WAAW,GAAG,QAAQ,CAAC,CAAC;AAM/E,eAAO,MAAM,yBAAyB,wBAAwB,CAAC;AAoC/D,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,IAC9C,OAAO,mBAAmB,KAAG,IAAI,CAmC1C"}

package/dist/hooks/system-overlay.js

@@ -0,0 +1,40 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { readInvocationContextForHook } from '../context.js';
+import { XemaSystemOverlayMissingError } from '../errors.js';
+import { debug } from '../logger.js';
+import { renderWorkspaceListing } from './workspace-listing.js';
+export const XEMA_OVERLAY_METADATA_KEY = 'xema.system-overlay';
+export function buildSystemOverlayHook(directory) {
+    return (input) => {
+        const ctx = readInvocationContextForHook(directory, 'session.context');
+        if (!ctx) {
+            return;
+        }
+        const overlayPath = join(directory, '.xema', 'system-overlay.md');
+        if (!existsSync(overlayPath)) {
+            throw new XemaSystemOverlayMissingError(`Xema session ${ctx.invocation.runId ?? 'unknown'} (role=${ctx.invocation.role}, ` +
+                `sessionId=${ctx.invocation.sessionId ?? '-'}) is missing /workspace/.xema/system-overlay.md. ` +
+                `The platform contract is undefined; refusing the model request. ` +
+                `Verify the agent-run-context render flow emitted the system-overlay slot.`);
+        }
+        const bytes = readFileSync(overlayPath, 'utf8');
+        const listing = renderWorkspaceListing(directory);
+        const part = {
+            type: 'text',
+            text: `${bytes}\n\n${listing}`,
+            metadata: { [XEMA_OVERLAY_METADATA_KEY]: true },
+        };
+        const existing = input.system.findIndex((entry) => entry.metadata?.[XEMA_OVERLAY_METADATA_KEY] === true);
+        if (existing === -1) {
+            input.system.push(part);
+        }
+        else {
+            input.system[existing] = part;
+        }
+        debug(`session.context: ${existing === -1 ? 'appended' : 'replaced'} overlay part ` +
+            `(${bytes.length} overlay + ${listing.length} listing bytes, role=${ctx.invocation.role}, ` +
+            `opencodeSession=${input.sessionID})`);
+    };
+}
+//# sourceMappingURL=system-overlay.js.map

package/dist/hooks/system-overlay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-overlay.js","sourceRoot":"","sources":["../../src/hooks/system-overlay.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAIjC,OAAO,EAAE,4BAA4B,EAAE,MAAM,eAAe,CAAC;AAC7D,OAAO,EAAE,6BAA6B,EAAE,MAAM,cAAc,CAAC;AAC7D,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AACrC,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAYhE,MAAM,CAAC,MAAM,yBAAyB,GAAG,qBAAqB,CAAC;AAoC/D,MAAM,UAAU,sBAAsB,CAAC,SAAiB;IACtD,OAAO,CAAC,KAA0B,EAAQ,EAAE;QAC1C,MAAM,GAAG,GAAG,4BAA4B,CAAC,SAAS,EAAE,iBAAiB,CAAC,CAAC;QACvE,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,OAAO;QACT,CAAC;QACD,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,EAAE,OAAO,EAAE,mBAAmB,CAAC,CAAC;QAClE,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,6BAA6B,CACrC,gBAAgB,GAAG,CAAC,UAAU,CAAC,KAAK,IAAI,SAAS,UAAU,GAAG,CAAC,UAAU,CAAC,IAAI,IAAI;gBAChF,aAAa,GAAG,CAAC,UAAU,CAAC,SAAS,IAAI,GAAG,mDAAmD;gBAC/F,kEAAkE;gBAClE,2EAA2E,CAC9E,CAAC;QACJ,CAAC;QACD,MAAM,KAAK,GAAG,YAAY,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;QAChD,MAAM,OAAO,GAAG,sBAAsB,CAAC,SAAS,CAAC,CAAC;QAClD,MAAM,IAAI,GAAsB;YAC9B,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,GAAG,KAAK,OAAO,OAAO,EAAE;YAC9B,QAAQ,EAAE,EAAE,CAAC,yBAAyB,CAAC,EAAE,IAAI,EAAE;SAChD,CAAC;QACF,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC,SAAS,CACrC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,yBAAyB,CAAC,KAAK,IAAI,CAChE,CAAC;QACF,IAAI,QAAQ,KAAK,CAAC,CAAC,EAAE,CAAC;YACpB,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC;QAChC,CAAC;QACD,KAAK,CACH,oBAAoB,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,gBAAgB;YAC3E,IAAI,KAAK,CAAC,MAAM,cAAc,OAAO,CAAC,MAAM,wBAAwB,GAAG,CAAC,UAAU,CAAC,IAAI,IAAI;YAC3F,mBAAmB,KAAK,CAAC,SAAS,GAAG,CACxC,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC"}

package/dist/hooks/tool-surface-observation.d.ts

@@ -0,0 +1,14 @@
+export declare const TOOL_SURFACE_FILE = "opencode-tool-surface.json";
+export declare const DEFAULT_RUNTIME_STATE_DIR = "/run/xema/runtime";
+export declare const RUNTIME_STATE_DIR_ENV = "XEMA_RUNTIME_STATE_DIR";
+export interface ToolSurfaceDocument {
+    readonly observedAt: number;
+    readonly tools: readonly string[];
+}
+export declare function resolveRuntimeStateDir(env?: Readonly<Record<string, string | undefined>>): string;
+export declare function observeToolSurface(options: {
+    readonly listToolIds: () => Promise<readonly string[]>;
+    readonly stateDir: string;
+    readonly now?: () => number;
+}): Promise<ToolSurfaceDocument | undefined>;
+//# sourceMappingURL=tool-surface-observation.d.ts.map

package/dist/hooks/tool-surface-observation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-surface-observation.d.ts","sourceRoot":"","sources":["../../src/hooks/tool-surface-observation.ts"],"names":[],"mappings":"AAoBA,eAAO,MAAM,iBAAiB,+BAA+B,CAAC;AAC9D,eAAO,MAAM,yBAAyB,sBAAsB,CAAC;AAC7D,eAAO,MAAM,qBAAqB,2BAA2B,CAAC;AAE9D,MAAM,WAAW,mBAAmB;IAElC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAED,wBAAgB,sBAAsB,CACpC,GAAG,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAe,GAC9D,MAAM,CAGR;AAED,wBAAsB,kBAAkB,CAAC,OAAO,EAAE;IAChD,QAAQ,CAAC,WAAW,EAAE,MAAM,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC,CAAC;IACvD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CAC7B,GAAG,OAAO,CAAC,mBAAmB,GAAG,SAAS,CAAC,CAmB3C"}

package/dist/hooks/tool-surface-observation.js

@@ -0,0 +1,30 @@
+import { mkdirSync, renameSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { debug, warn } from '../logger.js';
+export const TOOL_SURFACE_FILE = 'opencode-tool-surface.json';
+export const DEFAULT_RUNTIME_STATE_DIR = '/run/xema/runtime';
+export const RUNTIME_STATE_DIR_ENV = 'XEMA_RUNTIME_STATE_DIR';
+export function resolveRuntimeStateDir(env = process.env) {
+    const declared = env[RUNTIME_STATE_DIR_ENV];
+    return declared !== undefined && declared.trim() !== '' ? declared : DEFAULT_RUNTIME_STATE_DIR;
+}
+export async function observeToolSurface(options) {
+    try {
+        const observedAt = (options.now ?? Date.now)();
+        const ids = [...(await options.listToolIds())].sort();
+        const doc = { observedAt, tools: ids };
+        mkdirSync(options.stateDir, { recursive: true });
+        const target = join(options.stateDir, TOOL_SURFACE_FILE);
+        const temp = `${target}.${process.pid}.tmp`;
+        writeFileSync(temp, `${JSON.stringify(doc)}\n`, 'utf8');
+        renameSync(temp, target);
+        debug(`tool-surface: observed ${ids.length} tool(s) → ${target}`);
+        return doc;
+    }
+    catch (err) {
+        warn(`tool-surface: observation failed (observation only — no authority is affected): ` +
+            (err instanceof Error ? err.message : String(err)));
+        return undefined;
+    }
+}
+//# sourceMappingURL=tool-surface-observation.js.map

package/dist/hooks/tool-surface-observation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-surface-observation.js","sourceRoot":"","sources":["../../src/hooks/tool-surface-observation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC/D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAiB3C,MAAM,CAAC,MAAM,iBAAiB,GAAG,4BAA4B,CAAC;AAC9D,MAAM,CAAC,MAAM,yBAAyB,GAAG,mBAAmB,CAAC;AAC7D,MAAM,CAAC,MAAM,qBAAqB,GAAG,wBAAwB,CAAC;AAQ9D,MAAM,UAAU,sBAAsB,CACpC,MAAoD,OAAO,CAAC,GAAG;IAE/D,MAAM,QAAQ,GAAG,GAAG,CAAC,qBAAqB,CAAC,CAAC;IAC5C,OAAO,QAAQ,KAAK,SAAS,IAAI,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,yBAAyB,CAAC;AACjG,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,OAIxC;IACC,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,CAAC,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/C,MAAM,GAAG,GAAG,CAAC,GAAG,CAAC,MAAM,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACtD,MAAM,GAAG,GAAwB,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;QAC5D,SAAS,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACjD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,iBAAiB,CAAC,CAAC;QACzD,MAAM,IAAI,GAAG,GAAG,MAAM,IAAI,OAAO,CAAC,GAAG,MAAM,CAAC;QAC5C,aAAa,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACxD,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACzB,KAAK,CAAC,0BAA0B,GAAG,CAAC,MAAM,cAAc,MAAM,EAAE,CAAC,CAAC;QAClE,OAAO,GAAG,CAAC;IACb,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,CACF,kFAAkF;YAChF,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CACrD,CAAC;QACF,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC"}

package/dist/hooks/workspace-listing.js

@@ -19,7 +19,7 @@ export function renderWorkspaceListing(workspaceRoot) {
     const lines = [
         '## Current workspace contents (depth 1)',
         '',
-        'This is a snapshot of `/workspace/` taken at the start of this turn. Use it to orient before reaching for `glob`, `list`, or `read`. Hidden: platform-private slots (`.xema/`, `.opencode/`).',
+        'This is a snapshot of `/workspace/` taken at the start of this turn. Use it to orient before reaching for `glob` or `read`. Hidden: platform-private slots (`.xema/`, `.opencode/`).',
         '',
     ];
     let topLevel;
@@ -48,7 +48,7 @@ function renderTopLevelEntry(workspaceRoot, entry) {
     }
     if (SKIP_CHILD_EXPANSION_TOP_LEVEL.has(entry.name)) {
         return [
-            `- \`/workspace/${relPath}/\` _(children omitted: known implicit/noisy directory — use \`glob\`/\`list\` if needed)_`,
+            `- \`/workspace/${relPath}/\` _(children omitted: known implicit/noisy directory — use \`glob\` if needed)_`,
         ];
     }
     let children;
@@ -68,7 +68,7 @@ function renderTopLevelEntry(workspaceRoot, entry) {
     });
     const overflow = children.length - shown.length;
     const overflowLine = overflow > 0
-        ? [`  - _(${overflow} more entr${overflow === 1 ? 'y' : 'ies'} — use \`glob\`/\`list\` to enumerate)_`]
+        ? [`  - _(${overflow} more entr${overflow === 1 ? 'y' : 'ies'} — use \`glob\` to enumerate)_`]
         : [];
     return [`- \`/workspace/${relPath}/\``, ...childLines, ...overflowLine];
 }

package/dist/hooks/workspace-listing.js.map

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

package/dist/index.d.ts

@@ -1,8 +1,12 @@
-import type { Plugin } from './opencode-types.js';
-export declare const XemaPlugin: Plugin;
-export declare function __resetBootCacheForTests(): void;
-export default XemaPlugin;
-export { createSubagentFanoutCeiling, resolveSubagentFanoutLimit, DEFAULT_SUBAGENT_FANOUT_LIMIT, DEFAULT_FANOUT_WAIT_TIMEOUT_MS, DEFAULT_PERMIT_TTL_MS, FANOUT_LIMIT_ENV, TASK_TOOL_ID, type SubagentFanoutCeiling, type FanoutCeilingOptions, type FanoutCeilingStats, } from './hooks/subagent-fanout-ceiling.js';
+export { default } from './plugin.js';
+export { XEMA_RUNTIME_BRIDGE_PLUGIN_ID } from './plugin-id.js';
+export { createSubagentFanoutCeiling, resolveSubagentFanoutLimit, DEFAULT_SUBAGENT_FANOUT_LIMIT, DEFAULT_FANOUT_WAIT_TIMEOUT_MS, DEFAULT_ACTIVE_CHILD_TTL_MS, DEFAULT_PENDING_SLOT_TTL_MS, FANOUT_LIMIT_ENV, SUBAGENT_TOOL_ID, type SubagentFanoutCeiling, type FanoutCeilingOptions, type FanoutCeilingStats, } from './hooks/subagent-fanout-ceiling.js';
+export { buildSystemOverlayHook, XEMA_OVERLAY_METADATA_KEY, } from './hooks/system-overlay.js';
+export { buildCompactionInvariantsHook, renderCompactionInvariants, MAX_COMPACTION_INVARIANTS_CHARS, XEMA_COMPACTION_METADATA_KEY, } from './hooks/compaction-invariants.js';
+export { createRootTurnCompletion, TURN_COMPLETED_PATH, WORKSPACE_PROXY_URL_ENV, SERVER_PASSWORD_ENV, } from './hooks/root-turn-completion.js';
+export { observeToolSurface, resolveRuntimeStateDir, TOOL_SURFACE_FILE, DEFAULT_RUNTIME_STATE_DIR, RUNTIME_STATE_DIR_ENV, type ToolSurfaceDocument, } from './hooks/tool-surface-observation.js';
+export { scrubShellEnv, SERVER_PASSWORD_ENV_KEYS } from './hooks/shell-env-hygiene.js';
+export { parseRuntimeSessionEvent, SessionExecutionOutcome } from './runtime-events.js';
 export { readInvocationContext } from './context.js';
 export type { InvocationContext, InvocationRole } from './context.js';
 export * from './errors.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAqFA,OAAO,KAAK,EAIV,MAAM,EACP,MAAM,qBAAqB,CAAC;AAkB7B,eAAO,MAAM,UAAU,EAAE,MAgBxB,CAAC;AAmFF,wBAAgB,wBAAwB,IAAI,IAAI,CAE/C;AA2BD,eAAe,UAAU,CAAC;AAG1B,OAAO,EACL,2BAA2B,EAC3B,0BAA0B,EAC1B,6BAA6B,EAC7B,8BAA8B,EAC9B,qBAAqB,EACrB,gBAAgB,EAChB,YAAY,EACZ,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,GACxB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACrD,YAAY,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACtE,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EAAE,6BAA6B,EAAE,MAAM,gBAAgB,CAAC;AAC/D,OAAO,EACL,2BAA2B,EAC3B,0BAA0B,EAC1B,6BAA6B,EAC7B,8BAA8B,EAC9B,2BAA2B,EAC3B,2BAA2B,EAC3B,gBAAgB,EAChB,gBAAgB,EAChB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,GACxB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EACL,sBAAsB,EACtB,yBAAyB,GAC1B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,6BAA6B,EAC7B,0BAA0B,EAC1B,+BAA+B,EAC/B,4BAA4B,GAC7B,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EACL,wBAAwB,EACxB,mBAAmB,EACnB,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,iBAAiB,EACjB,yBAAyB,EACzB,qBAAqB,EACrB,KAAK,mBAAmB,GACzB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AACvF,OAAO,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AACxF,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACrD,YAAY,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACtE,cAAc,aAAa,CAAC"}

package/dist/index.js

@@ -1,73 +1,12 @@
-import { existsSync } from 'node:fs';
-import { join } from 'node:path';
-import { buildSessionIdleAutocommit } from './hooks/session-idle-autocommit.js';
-import { createSubagentFanoutCeiling, resolveSubagentFanoutLimit, } from './hooks/subagent-fanout-ceiling.js';
-import { buildSystemPromptOverlay } from './hooks/system-prompt-overlay.js';
-import { info, isDebug, warn } from './logger.js';
-const bootCache = new Map();
-export const XemaPlugin = async (ctx) => {
-    const { directory } = ctx;
-    const cached = bootCache.get(directory);
-    if (cached !== undefined) {
-        return cached;
-    }
-    const booting = doBoot(directory);
-    bootCache.set(directory, booting);
-    try {
-        return await booting;
-    }
-    catch (err) {
-        bootCache.delete(directory);
-        throw err;
-    }
-};
-async function doBoot(directory) {
-    const contextPath = join(directory, 'context.json');
-    const contextPresentAtBoot = existsSync(contextPath);
-    info(`boot: directory=${directory} tools=0 (hooks only) ` +
-        `context.json=${contextPresentAtBoot ? 'present' : 'absent'} ` +
-        `debug=${isDebug() ? 'on' : 'off'}`);
-    const fanoutLimit = resolveSubagentFanoutLimit();
-    const fanout = createSubagentFanoutCeiling({ limit: fanoutLimit });
-    const autocommit = buildSessionIdleAutocommit(directory);
-    info(`boot: subagent fan-out ceiling active (limit=${fanoutLimit} concurrent task calls ` +
-        `per worker; tighten with XEMA_SUBAGENT_FANOUT_LIMIT)`);
-    const hooks = {
-        'experimental.chat.system.transform': buildSystemPromptOverlay(directory),
-        'tool.execute.before': async (input) => {
-            await fanout.before(input);
-        },
-        'tool.execute.after': (input) => {
-            fanout.after(input);
-        },
-        dispose: async () => {
-            fanout.dispose();
-        },
-        event: async (input) => {
-            const evt = input.event;
-            if (evt.type === 'session.idle') {
-                const sessionId = evt.properties
-                    ?.sessionID;
-                if (sessionId) {
-                    try {
-                        fanout.onSessionIdle(sessionId);
-                    }
-                    catch (err) {
-                        const message = err instanceof Error ? err.message : String(err);
-                        warn(`fanout-ceiling: session-idle sweep failed: ${message}`);
-                    }
-                }
-            }
-            await autocommit(input);
-        },
-    };
-    return hooks;
-}
-export function __resetBootCacheForTests() {
-    bootCache.clear();
-}
-export default XemaPlugin;
-export { createSubagentFanoutCeiling, resolveSubagentFanoutLimit, DEFAULT_SUBAGENT_FANOUT_LIMIT, DEFAULT_FANOUT_WAIT_TIMEOUT_MS, DEFAULT_PERMIT_TTL_MS, FANOUT_LIMIT_ENV, TASK_TOOL_ID, } from './hooks/subagent-fanout-ceiling.js';
+export { default } from './plugin.js';
+export { XEMA_RUNTIME_BRIDGE_PLUGIN_ID } from './plugin-id.js';
+export { createSubagentFanoutCeiling, resolveSubagentFanoutLimit, DEFAULT_SUBAGENT_FANOUT_LIMIT, DEFAULT_FANOUT_WAIT_TIMEOUT_MS, DEFAULT_ACTIVE_CHILD_TTL_MS, DEFAULT_PENDING_SLOT_TTL_MS, FANOUT_LIMIT_ENV, SUBAGENT_TOOL_ID, } from './hooks/subagent-fanout-ceiling.js';
+export { buildSystemOverlayHook, XEMA_OVERLAY_METADATA_KEY, } from './hooks/system-overlay.js';
+export { buildCompactionInvariantsHook, renderCompactionInvariants, MAX_COMPACTION_INVARIANTS_CHARS, XEMA_COMPACTION_METADATA_KEY, } from './hooks/compaction-invariants.js';
+export { createRootTurnCompletion, TURN_COMPLETED_PATH, WORKSPACE_PROXY_URL_ENV, SERVER_PASSWORD_ENV, } from './hooks/root-turn-completion.js';
+export { observeToolSurface, resolveRuntimeStateDir, TOOL_SURFACE_FILE, DEFAULT_RUNTIME_STATE_DIR, RUNTIME_STATE_DIR_ENV, } from './hooks/tool-surface-observation.js';
+export { scrubShellEnv, SERVER_PASSWORD_ENV_KEYS } from './hooks/shell-env-hygiene.js';
+export { parseRuntimeSessionEvent, SessionExecutionOutcome } from './runtime-events.js';
 export { readInvocationContext } from './context.js';
 export * from './errors.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EAAE,6BAA6B,EAAE,MAAM,gBAAgB,CAAC;AAC/D,OAAO,EACL,2BAA2B,EAC3B,0BAA0B,EAC1B,6BAA6B,EAC7B,8BAA8B,EAC9B,2BAA2B,EAC3B,2BAA2B,EAC3B,gBAAgB,EAChB,gBAAgB,GAIjB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EACL,sBAAsB,EACtB,yBAAyB,GAC1B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,6BAA6B,EAC7B,0BAA0B,EAC1B,+BAA+B,EAC/B,4BAA4B,GAC7B,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EACL,wBAAwB,EACxB,mBAAmB,EACnB,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,iBAAiB,EACjB,yBAAyB,EACzB,qBAAqB,GAEtB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AACvF,OAAO,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AACxF,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAErD,cAAc,aAAa,CAAC"}

package/dist/plugin-id.d.ts

@@ -0,0 +1,2 @@
+export declare const XEMA_RUNTIME_BRIDGE_PLUGIN_ID = "xema-runtime-bridge";
+//# sourceMappingURL=plugin-id.d.ts.map

package/dist/plugin-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-id.d.ts","sourceRoot":"","sources":["../src/plugin-id.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,6BAA6B,wBAAwB,CAAC"}

package/dist/plugin-id.js

@@ -0,0 +1,2 @@
+export const XEMA_RUNTIME_BRIDGE_PLUGIN_ID = 'xema-runtime-bridge';
+//# sourceMappingURL=plugin-id.js.map