@xemahq/opencode-xema-plugin 0.3.0 → 0.4.0

package/dist/plugin-id.js.map

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

package/dist/plugin.d.ts

@@ -0,0 +1,4 @@
+import type { Plugin } from '@opencode/plugin';
+declare const plugin: Plugin.Plugin;
+export default plugin;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAoCA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAuG/C,QAAA,MAAM,MAAM,EAAE,MAAM,CAAC,MAAqD,CAAC;AAE3E,eAAe,MAAM,CAAC"}

package/dist/plugin.js

@@ -0,0 +1,86 @@
+import { buildCompactionInvariantsHook } from './hooks/compaction-invariants.js';
+import { createRootTurnCompletion } from './hooks/root-turn-completion.js';
+import { scrubShellEnv } from './hooks/shell-env-hygiene.js';
+import { createSubagentFanoutCeiling, resolveSubagentFanoutLimit, } from './hooks/subagent-fanout-ceiling.js';
+import { buildSystemOverlayHook } from './hooks/system-overlay.js';
+import { observeToolSurface, resolveRuntimeStateDir } from './hooks/tool-surface-observation.js';
+import { info, warn } from './logger.js';
+import { XEMA_RUNTIME_BRIDGE_PLUGIN_ID } from './plugin-id.js';
+import { parseRuntimeSessionEvent } from './runtime-events.js';
+const TOOL_SURFACE_EVENTS = new Set([
+    'plugin.updated',
+    'integration.updated',
+    'skill.updated',
+    'agent.updated',
+]);
+async function setup(ctx) {
+    const directory = ctx.location.directory;
+    const limit = resolveSubagentFanoutLimit();
+    const fanout = createSubagentFanoutCeiling({ limit });
+    const turnCompletion = createRootTurnCompletion({
+        resolveParentId: async (sessionId) => {
+            const session = await ctx.session.get({ sessionID: sessionId });
+            return session.parentID !== undefined && session.parentID.length > 0
+                ? session.parentID
+                : undefined;
+        },
+    });
+    const stateDir = resolveRuntimeStateDir();
+    const observe = () => observeToolSurface({
+        stateDir,
+        listToolIds: async () => (await ctx.tool.list()).map((tool) => tool.id),
+    });
+    const registrations = [
+        await ctx.session.hook('context', buildSystemOverlayHook(directory)),
+        await ctx.session.hook('compaction', buildCompactionInvariantsHook(directory)),
+        await ctx.tool.hook('execute.before', (input) => fanout.beforeToolCall({ tool: input.tool, sessionID: input.sessionID, id: input.id })),
+        await ctx.tool.hook('execute.after', (input) => {
+            fanout.afterToolCall({ tool: input.tool, sessionID: input.sessionID, id: input.id });
+        }),
+        await ctx.shell.hook('create.before', scrubShellEnv),
+    ];
+    const abort = new AbortController();
+    const events = (async () => {
+        try {
+            for await (const event of ctx.event.subscribe({ signal: abort.signal })) {
+                handleEvent(event);
+            }
+        }
+        catch (err) {
+            if (!abort.signal.aborted) {
+                warn(`event subscription ended unexpectedly: ${err instanceof Error ? err.message : String(err)}. ` +
+                    'Fan-out children now release only by TTL and turn-completion notices stop until restart.');
+            }
+        }
+    })();
+    function handleEvent(event) {
+        const type = event?.type;
+        if (typeof type === 'string' && TOOL_SURFACE_EVENTS.has(type)) {
+            void observe();
+        }
+        const parsed = parseRuntimeSessionEvent(event);
+        if (parsed === undefined)
+            return;
+        if (parsed.kind === 'created') {
+            fanout.onSessionCreated(parsed.sessionId, parsed.parentId);
+            turnCompletion.onSessionCreated(parsed.sessionId, parsed.parentId);
+            return;
+        }
+        fanout.onSessionTerminal(parsed.sessionId);
+        void turnCompletion.onSessionTerminal(parsed.sessionId, parsed.outcome, parsed.executionId);
+    }
+    await observe();
+    info(`setup: ${XEMA_RUNTIME_BRIDGE_PLUGIN_ID} ready (OpenCode ${ctx.app.version}, dir=${directory}, ` +
+        `tools=0, sub-agent fan-out limit=${limit}, tool surface → ${stateDir})`);
+    return async () => {
+        abort.abort();
+        fanout.dispose();
+        for (const registration of registrations) {
+            await registration.dispose();
+        }
+        await events;
+    };
+}
+const plugin = { id: XEMA_RUNTIME_BRIDGE_PLUGIN_ID, setup };
+export default plugin;
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

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

package/dist/runtime-events.d.ts

@@ -0,0 +1,17 @@
+export declare enum SessionExecutionOutcome {
+    Succeeded = "succeeded",
+    Failed = "failed",
+    Interrupted = "interrupted"
+}
+export type RuntimeSessionEvent = {
+    readonly kind: 'created';
+    readonly sessionId: string;
+    readonly parentId: string | undefined;
+} | {
+    readonly kind: 'terminal';
+    readonly sessionId: string;
+    readonly outcome: SessionExecutionOutcome;
+    readonly executionId: string;
+};
+export declare function parseRuntimeSessionEvent(event: unknown): RuntimeSessionEvent | undefined;
+//# sourceMappingURL=runtime-events.d.ts.map

package/dist/runtime-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-events.d.ts","sourceRoot":"","sources":["../src/runtime-events.ts"],"names":[],"mappings":"AAiBA,oBAAY,uBAAuB;IACjC,SAAS,cAAc;IACvB,MAAM,WAAW;IACjB,WAAW,gBAAgB;CAC5B;AASD,MAAM,MAAM,mBAAmB,GAC3B;IACE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;CACvC,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,uBAAuB,CAAC;IAE1C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B,CAAC;AAMN,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,mBAAmB,GAAG,SAAS,CAuBxF"}

package/dist/runtime-events.js

@@ -0,0 +1,39 @@
+export var SessionExecutionOutcome;
+(function (SessionExecutionOutcome) {
+    SessionExecutionOutcome["Succeeded"] = "succeeded";
+    SessionExecutionOutcome["Failed"] = "failed";
+    SessionExecutionOutcome["Interrupted"] = "interrupted";
+})(SessionExecutionOutcome || (SessionExecutionOutcome = {}));
+const TERMINAL_EVENT_TYPES = Object.freeze({
+    'session.execution.succeeded': SessionExecutionOutcome.Succeeded,
+    'session.execution.failed': SessionExecutionOutcome.Failed,
+    'session.execution.interrupted': SessionExecutionOutcome.Interrupted,
+});
+function isRecord(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+export function parseRuntimeSessionEvent(event) {
+    if (!isRecord(event) || typeof event.type !== 'string' || !isRecord(event.data)) {
+        return undefined;
+    }
+    const sessionId = event.data.sessionID;
+    if (typeof sessionId !== 'string' || sessionId.length === 0) {
+        return undefined;
+    }
+    if (event.type === 'session.created') {
+        const parent = event.data.parentID;
+        return {
+            kind: 'created',
+            sessionId,
+            parentId: typeof parent === 'string' && parent.length > 0 ? parent : undefined,
+        };
+    }
+    const outcome = Object.hasOwn(TERMINAL_EVENT_TYPES, event.type)
+        ? TERMINAL_EVENT_TYPES[event.type]
+        : undefined;
+    if (outcome === undefined || typeof event.id !== 'string' || event.id.length === 0) {
+        return undefined;
+    }
+    return { kind: 'terminal', sessionId, outcome, executionId: event.id };
+}
+//# sourceMappingURL=runtime-events.js.map

package/dist/runtime-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-events.js","sourceRoot":"","sources":["../src/runtime-events.ts"],"names":[],"mappings":"AAiBA,MAAM,CAAN,IAAY,uBAIX;AAJD,WAAY,uBAAuB;IACjC,kDAAuB,CAAA;IACvB,4CAAiB,CAAA;IACjB,sDAA2B,CAAA;AAC7B,CAAC,EAJW,uBAAuB,KAAvB,uBAAuB,QAIlC;AAED,MAAM,oBAAoB,GACxB,MAAM,CAAC,MAAM,CAAC;IACZ,6BAA6B,EAAE,uBAAuB,CAAC,SAAS;IAChE,0BAA0B,EAAE,uBAAuB,CAAC,MAAM;IAC1D,+BAA+B,EAAE,uBAAuB,CAAC,WAAW;CACrE,CAAC,CAAC;AAgBL,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,KAAc;IACrD,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QAChF,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC;IACvC,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5D,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,KAAK,CAAC,IAAI,KAAK,iBAAiB,EAAE,CAAC;QACrC,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC;QACnC,OAAO;YACL,IAAI,EAAE,SAAS;YACf,SAAS;YACT,QAAQ,EAAE,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS;SAC/E,CAAC;IACJ,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,oBAAoB,EAAE,KAAK,CAAC,IAAI,CAAC;QAC7D,CAAC,CAAC,oBAAoB,CAAC,KAAK,CAAC,IAAI,CAAC;QAClC,CAAC,CAAC,SAAS,CAAC;IACd,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,KAAK,CAAC,EAAE,KAAK,QAAQ,IAAI,KAAK,CAAC,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACnF,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,WAAW,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC;AACzE,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@xemahq/opencode-xema-plugin",
-  "version": "0.3.0",
-  "description": "Opencode plugin providing the Xema dynamic system-prompt overlay hook, the per-turn session.idle auto-commit, and the sub-agent fan-out ceiling. Contributes no tools.",
+  "version": "0.4.0",
+  "description": "OpenCode V2 plugin `xema-runtime-bridge`: the Xema system overlay, compaction continuation invariants, root-session auto-commit, the sub-agent fan-out ceiling, tool-surface observation and shell env hygiene. Contributes no tools.",
   "license": "Apache-2.0",
   "author": "Neuralchowder Inc. <developer@xema.dev> (https://xema.dev)",
   "homepage": "https://xema.dev",
@@ -20,19 +20,19 @@
   "types": "dist/index.d.ts",
   "files": [
     "dist",
-    "plugin.mjs"
+    "plugin"
   ],
   "peerDependencies": {
-    "@opencode-ai/plugin": "^1.0.0",
-    "zod": "^4.0.0"
+    "@opencode/plugin": "2.0.20"
+  },
+  "dependencies": {
+    "zod": "^4.3.6"
   },
   "devDependencies": {
-    "@opencode-ai/plugin": "^1.15.10",
+    "@opencode/plugin": "2.0.20",
     "@types/node": "25.2.3",
     "esbuild": "^0.25.4",
-    "typescript": "5.9.3",
-    "zod": "^4.3.6",
-    "@xemahq/contracts": "^0.1.0"
+    "typescript": "5.9.3"
   },
   "exports": {
     ".": {
@@ -40,16 +40,12 @@
       "xema-source": "./src/index.ts",
       "default": "./dist/index.js"
     },
-    "./plugin.mjs": "./plugin.mjs",
-    "./dist/lib/*": {
-      "types": "./dist/lib/*.d.ts",
-      "default": "./dist/lib/*.js"
-    }
+    "./plugin/xema-runtime-bridge": "./plugin/xema-runtime-bridge/index.js"
   },
   "scripts": {
-    "clean": "rm -rf dist plugin.mjs",
+    "clean": "rm -rf dist plugin",
     "build": "pnpm run clean && tsc -p tsconfig.json && node scripts/write-dist-source-stamp.mjs && pnpm run bundle",
-    "bundle": "esbuild src/plugin-entry.ts --bundle --platform=node --target=node22 --format=esm --external:@opencode-ai/plugin --log-level=info --outfile=plugin.mjs",
+    "bundle": "node scripts/bundle-plugin.mjs",
     "typecheck": "tsc -p tsconfig.json --noEmit",
     "test": "node --test tests/*.test.mjs"
   }