@xemahq/kernel-contracts 0.4.0 → 0.5.1

package/dist/agent-composition/lib/composition.d.ts

@@ -1,6 +1,7 @@
 import type { ToolSelectionEntry } from '../../mcp-tool';
 import type { NodeOverlayFragment } from '../../workflow';
 import type { SkillRef } from '../../skill';
+import type { BiomeAvailabilityScoped } from '../../biome-availability';
 import type { CapabilityLayer } from './capability-layer';
 import type { CompositionWorkspace } from './composition-workspace';
 export interface AgentRef {
@@ -25,7 +26,7 @@ export interface CompositionLimits {
     readonly maxSpawns: number;
     readonly tokenBudget?: number | undefined;
 }
-export interface CompositionNode extends NodeOverlayFragment {
+export interface CompositionNode extends NodeOverlayFragment, BiomeAvailabilityScoped {
     readonly agent: AgentRef;
     readonly alias?: string;
     readonly skills: readonly SkillRef[];
@@ -44,7 +45,7 @@ export interface Composition {
     readonly capability?: CapabilityLayer;
     readonly workspace?: CompositionWorkspace;
 }
-export interface ResolvedCompositionNode extends NodeOverlayFragment {
+export interface ResolvedCompositionNode extends NodeOverlayFragment, BiomeAvailabilityScoped {
     readonly agent: Required<AgentRef>;
     readonly alias?: string;
     readonly skills: readonly SkillRef[];

package/dist/agent-composition/lib/composition.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"composition.d.ts","sourceRoot":"","sources":["../../../src/agent-composition/lib/composition.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAKpE,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAOD,oBAAY,gBAAgB;IAC1B,MAAM,WAAW;IACjB,KAAK,UAAU;IACf,GAAG,QAAQ;IACX,OAAO,YAAY;IACnB,IAAI,SAAS;CACd;AAQD,oBAAY,oBAAoB;IAC9B,KAAK,UAAU;IACf,SAAS,cAAc;IACvB,QAAQ,aAAa;CACtB;AAwBD,MAAM,WAAW,iBAAiB;IAEhC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAQ3B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3C;AASD,MAAM,WAAW,eAAgB,SAAQ,mBAAmB;IAE1D,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IAEzB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAExB,QAAQ,CAAC,MAAM,EAAE,SAAS,QAAQ,EAAE,CAAC;IAErC,QAAQ,CAAC,KAAK,EAAE,SAAS,kBAAkB,EAAE,CAAC;IAM9C,QAAQ,CAAC,QAAQ,EAAE,SAAS,eAAe,EAAE,CAAC;IAQ9C,QAAQ,CAAC,MAAM,CAAC,EAAE,iBAAiB,CAAC;CACrC;AAKD,MAAM,WAAW,WAAW;IAE1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAC;IACjC,QAAQ,CAAC,SAAS,EAAE,oBAAoB,CAAC;IAEzC,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAE/B,QAAQ,CAAC,UAAU,CAAC,EAAE,eAAe,CAAC;IAStC,QAAQ,CAAC,SAAS,CAAC,EAAE,oBAAoB,CAAC;CAC3C;AAWD,MAAM,WAAW,uBAAwB,SAAQ,mBAAmB;IAElE,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACnC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAExB,QAAQ,CAAC,MAAM,EAAE,SAAS,QAAQ,EAAE,CAAC;IAErC,QAAQ,CAAC,KAAK,EAAE,SAAS,kBAAkB,EAAE,CAAC;IAM9C,QAAQ,CAAC,QAAQ,EAAE,SAAS,uBAAuB,EAAE,CAAC;IAQtD,QAAQ,CAAC,MAAM,CAAC,EAAE,iBAAiB,CAAC;CACrC;AAMD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAC;IAEjC,QAAQ,CAAC,IAAI,EAAE,uBAAuB,CAAC;IAEvC,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAC;IAOrC,QAAQ,CAAC,SAAS,CAAC,EAAE,oBAAoB,CAAC;CAC3C"}
+{"version":3,"file":"composition.d.ts","sourceRoot":"","sources":["../../../src/agent-composition/lib/composition.ts"],"names":[],"mappings":"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"}

package/dist/agent-composition/lib/composition.js.map

@@ -1 +1 @@
-{"version":3,"file":"composition.js","sourceRoot":"","sources":["../../../src/agent-composition/lib/composition.ts"],"names":[],"mappings":";;;AAmCA,IAAY,gBAMX;AAND,WAAY,gBAAgB;IAC1B,qCAAiB,CAAA;IACjB,mCAAe,CAAA;IACf,+BAAW,CAAA;IACX,uCAAmB,CAAA;IACnB,iCAAa,CAAA;AACf,CAAC,EANW,gBAAgB,gCAAhB,gBAAgB,QAM3B;AAQD,IAAY,oBAIX;AAJD,WAAY,oBAAoB;IAC9B,uCAAe,CAAA;IACf,+CAAuB,CAAA;IACvB,6CAAqB,CAAA;AACvB,CAAC,EAJW,oBAAoB,oCAApB,oBAAoB,QAI/B"}
+{"version":3,"file":"composition.js","sourceRoot":"","sources":["../../../src/agent-composition/lib/composition.ts"],"names":[],"mappings":";;;AAoCA,IAAY,gBAMX;AAND,WAAY,gBAAgB;IAC1B,qCAAiB,CAAA;IACjB,mCAAe,CAAA;IACf,+BAAW,CAAA;IACX,uCAAmB,CAAA;IACnB,iCAAa,CAAA;AACf,CAAC,EANW,gBAAgB,gCAAhB,gBAAgB,QAM3B;AAQD,IAAY,oBAIX;AAJD,WAAY,oBAAoB;IAC9B,uCAAe,CAAA;IACf,+CAAuB,CAAA;IACvB,6CAAqB,CAAA;AACvB,CAAC,EAJW,oBAAoB,oCAApB,oBAAoB,QAI/B"}

package/dist/agent-workspace/awp-spec.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://xema.dev/schemas/awp-spec.v1.json",
-  "emittedAt": "2026-06-13T09:08:25.716Z",
+  "emittedAt": "2026-06-14T10:21:11.634Z",
   "spec": {
     "id": "awp/v1",
     "version": "1.2.0",

package/dist/agent-workspace/index.d.ts

@@ -1,6 +1,6 @@
 export * from './lib/workspace-layout';
 export * from './lib/workspace-spec';
-export * from './lib/awp-v1';
+export * from './lib/awp';
 export * from './lib/context-json';
 export * from './lib/manifest';
 export * from './lib/deliverable-spec-ref';

package/dist/agent-workspace/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agent-workspace/index.ts"],"names":[],"mappings":"AAgBA,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AACxC,cAAc,mBAAmB,CAAC;AAClC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agent-workspace/index.ts"],"names":[],"mappings":"AAgBA,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,WAAW,CAAC;AAC1B,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AACxC,cAAc,mBAAmB,CAAC;AAClC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,oBAAoB,CAAC"}

package/dist/agent-workspace/index.js

@@ -16,7 +16,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./lib/workspace-layout"), exports);
 __exportStar(require("./lib/workspace-spec"), exports);
-__exportStar(require("./lib/awp-v1"), exports);
+__exportStar(require("./lib/awp"), exports);
 __exportStar(require("./lib/context-json"), exports);
 __exportStar(require("./lib/manifest"), exports);
 __exportStar(require("./lib/deliverable-spec-ref"), exports);

package/dist/agent-workspace/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agent-workspace/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAgBA,yDAAuC;AACvC,uDAAqC;AACrC,+CAA6B;AAC7B,qDAAmC;AACnC,iDAA+B;AAC/B,6DAA2C;AAC3C,4DAA0C;AAC1C,0DAAwC;AACxC,oDAAkC;AAClC,4DAA0C;AAC1C,qDAAmC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agent-workspace/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAgBA,yDAAuC;AACvC,uDAAqC;AACrC,4CAA0B;AAC1B,qDAAmC;AACnC,iDAA+B;AAC/B,6DAA2C;AAC3C,4DAA0C;AAC1C,0DAAwC;AACxC,oDAAkC;AAClC,4DAA0C;AAC1C,qDAAmC"}

package/dist/agent-workspace/lib/awp.d.ts

@@ -0,0 +1,15 @@
+import { GitPushBranchSuffix, GitPushConcurrencyMode, type WorkspaceSpec } from './workspace-spec';
+export declare const AWP_V1_SPEC: WorkspaceSpec;
+export declare function findSlot(spec: WorkspaceSpec, key: string): import("./workspace-spec").SlotDefinition | undefined;
+export declare function isKnownSlotKey(spec: WorkspaceSpec, key: string): boolean;
+export declare function listAlwaysOnSlotKeys(spec: WorkspaceSpec): readonly string[];
+export declare function listTarballPersistedRelPaths(spec: WorkspaceSpec): readonly string[];
+export interface ResolvedGitPushSlot {
+    readonly key: string;
+    readonly path: string;
+    readonly branchPrefix: string;
+    readonly branchSuffix: GitPushBranchSuffix;
+    readonly concurrencyMode: GitPushConcurrencyMode;
+}
+export declare function listGitPushPersistedSlots(spec: WorkspaceSpec): readonly ResolvedGitPushSlot[];
+//# sourceMappingURL=awp.d.ts.map

package/dist/agent-workspace/lib/awp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"awp.d.ts","sourceRoot":"","sources":["../../../src/agent-workspace/lib/awp.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EAEtB,KAAK,aAAa,EACnB,MAAM,kBAAkB,CAAC;AAgB1B,eAAO,MAAM,WAAW,EAAE,aAwMzB,CAAC;AAMF,wBAAgB,QAAQ,CAAC,IAAI,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,yDAExD;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAExE;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,aAAa,GAAG,SAAS,MAAM,EAAE,CAE3E;AAQD,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,aAAa,GAAG,SAAS,MAAM,EAAE,CAInF;AAQD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,YAAY,EAAE,mBAAmB,CAAC;IAC3C,QAAQ,CAAC,eAAe,EAAE,sBAAsB,CAAC;CAClD;AAOD,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,aAAa,GAClB,SAAS,mBAAmB,EAAE,CAgBhC"}

package/dist/agent-workspace/lib/awp.js

@@ -0,0 +1,197 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AWP_V1_SPEC = void 0;
+exports.findSlot = findSlot;
+exports.isKnownSlotKey = isKnownSlotKey;
+exports.listAlwaysOnSlotKeys = listAlwaysOnSlotKeys;
+exports.listTarballPersistedRelPaths = listTarballPersistedRelPaths;
+exports.listGitPushPersistedSlots = listGitPushPersistedSlots;
+const workspace_spec_1 = require("./workspace-spec");
+exports.AWP_V1_SPEC = {
+    id: 'awp/v1',
+    version: '1.2.0',
+    slots: [
+        {
+            key: 'inputs',
+            path: '/workspace/inputs',
+            presence: 'always',
+            allowedModes: [workspace_spec_1.SlotMode.ReadOnly],
+            defaultMode: workspace_spec_1.SlotMode.ReadOnly,
+            ownership: 'user',
+            humanDescription: "Read-only inputs supplied at session/run start (the workflow's `with:` block or the session's customConfig). The DSL input bag lands at `inputs.json`.",
+            persistencePolicy: { kind: 'none' },
+        },
+        {
+            key: 'tmp',
+            path: '/workspace/tmp',
+            presence: 'always',
+            allowedModes: [workspace_spec_1.SlotMode.ReadWrite],
+            defaultMode: workspace_spec_1.SlotMode.ReadWrite,
+            ownership: 'user',
+            humanDescription: 'Your scratch space — drafts, intermediate computation, working notes. Snapshot-persisted so retries see prior state. Never harvested.',
+            persistencePolicy: { kind: 'tarball' },
+        },
+        {
+            key: 'uploads',
+            path: '/workspace/uploads',
+            presence: 'optional',
+            allowedModes: [workspace_spec_1.SlotMode.ReadOnly],
+            defaultMode: workspace_spec_1.SlotMode.ReadOnly,
+            ownership: 'user',
+            humanDescription: 'User-uploaded files (briefs, screenshots, sketches). Read-only — never write here.',
+            persistencePolicy: { kind: 'tarball' },
+        },
+        {
+            key: 'references',
+            path: '/workspace/references',
+            presence: 'optional',
+            allowedModes: [workspace_spec_1.SlotMode.ReadOnly],
+            defaultMode: workspace_spec_1.SlotMode.ReadOnly,
+            ownership: 'user',
+            humanDescription: 'Curated evidence library (knowledge-base spaces, prior artifacts, external project mounts). Read-only.',
+            persistencePolicy: { kind: 'none' },
+            subSlots: [
+                {
+                    key: 'kb',
+                    path: '/workspace/references/kb',
+                    allowedModes: [workspace_spec_1.SlotMode.ReadOnly],
+                    defaultMode: workspace_spec_1.SlotMode.ReadOnly,
+                    ownership: 'user',
+                },
+                {
+                    key: 'external-projects',
+                    path: '/workspace/references/external-projects',
+                    allowedModes: [workspace_spec_1.SlotMode.ReadOnly],
+                    defaultMode: workspace_spec_1.SlotMode.ReadOnly,
+                    ownership: 'user',
+                },
+            ],
+        },
+        {
+            key: 'deliverable-specs',
+            path: '/workspace/deliverable-specs',
+            presence: 'optional',
+            allowedModes: [workspace_spec_1.SlotMode.ReadOnly],
+            defaultMode: workspace_spec_1.SlotMode.ReadOnly,
+            ownership: 'user',
+            humanDescription: 'Schemas + metadata for the deliverable spec(s) this run targets. Read-only — consult before writing under deliverables/.',
+            persistencePolicy: { kind: 'none' },
+        },
+        {
+            key: 'deliverables',
+            path: '/workspace/deliverables',
+            presence: 'optional',
+            allowedModes: [workspace_spec_1.SlotMode.ReadOnly, workspace_spec_1.SlotMode.ReadWrite],
+            defaultMode: workspace_spec_1.SlotMode.ReadWrite,
+            ownership: 'user',
+            humanDescription: "Your writable output area. Files written here are harvested by the runtime per the deliverable spec's contract.",
+            persistencePolicy: { kind: 'tarball' },
+        },
+        {
+            key: 'repos',
+            path: '/workspace/repos',
+            presence: 'optional',
+            allowedModes: [workspace_spec_1.SlotMode.ReadOnly, workspace_spec_1.SlotMode.ReadWrite],
+            defaultMode: workspace_spec_1.SlotMode.ReadOnly,
+            ownership: 'user',
+            humanDescription: 'Project repositories. Read-only unless the workflow explicitly granted write authority (engineer roles only).',
+            persistencePolicy: { kind: 'git-push', branchPrefix: 'xema/session/' },
+        },
+        {
+            key: 'agents-md',
+            path: '/workspace/AGENTS.md',
+            presence: 'always',
+            allowedModes: [workspace_spec_1.SlotMode.ReadOnly],
+            defaultMode: workspace_spec_1.SlotMode.ReadOnly,
+            singleFile: true,
+            ownership: 'platform',
+            persistencePolicy: { kind: 'none' },
+        },
+        {
+            key: 'context-json',
+            path: '/workspace/context.json',
+            presence: 'always',
+            allowedModes: [workspace_spec_1.SlotMode.ReadOnly],
+            defaultMode: workspace_spec_1.SlotMode.ReadOnly,
+            singleFile: true,
+            ownership: 'platform',
+            persistencePolicy: { kind: 'none' },
+        },
+        {
+            key: 'system-overlay',
+            path: '/workspace/.xema/system-overlay.md',
+            presence: 'always',
+            allowedModes: [workspace_spec_1.SlotMode.ReadOnly],
+            defaultMode: workspace_spec_1.SlotMode.ReadOnly,
+            singleFile: true,
+            ownership: 'platform',
+            persistencePolicy: { kind: 'none' },
+        },
+        {
+            key: 'agent-bundles',
+            path: '/workspace/.opencode/agents',
+            presence: 'always',
+            allowedModes: [workspace_spec_1.SlotMode.ReadOnly],
+            defaultMode: workspace_spec_1.SlotMode.ReadOnly,
+            ownership: 'platform',
+            persistencePolicy: { kind: 'none' },
+        },
+        {
+            key: 'skill-bundles',
+            path: '/workspace/.opencode/skills',
+            presence: 'optional',
+            allowedModes: [workspace_spec_1.SlotMode.ReadOnly],
+            defaultMode: workspace_spec_1.SlotMode.ReadOnly,
+            ownership: 'platform',
+            persistencePolicy: { kind: 'none' },
+        },
+        {
+            key: 'commands',
+            path: '/workspace/.opencode/command',
+            presence: 'optional',
+            allowedModes: [workspace_spec_1.SlotMode.ReadOnly],
+            defaultMode: workspace_spec_1.SlotMode.ReadOnly,
+            ownership: 'platform',
+            persistencePolicy: { kind: 'none' },
+        },
+        {
+            key: 'instructions',
+            path: '/workspace/.xema/instructions',
+            presence: 'optional',
+            allowedModes: [workspace_spec_1.SlotMode.ReadOnly],
+            defaultMode: workspace_spec_1.SlotMode.ReadOnly,
+            ownership: 'platform',
+            persistencePolicy: { kind: 'none' },
+        },
+    ],
+};
+function findSlot(spec, key) {
+    return spec.slots.find((s) => s.key === key);
+}
+function isKnownSlotKey(spec, key) {
+    return spec.slots.some((s) => s.key === key);
+}
+function listAlwaysOnSlotKeys(spec) {
+    return spec.slots.filter((s) => s.presence === 'always').map((s) => s.key);
+}
+function listTarballPersistedRelPaths(spec) {
+    return spec.slots
+        .filter((s) => s.persistencePolicy?.kind === 'tarball')
+        .map((s) => s.path.replace(/^\/workspace\//, ''));
+}
+function listGitPushPersistedSlots(spec) {
+    const out = [];
+    for (const slot of spec.slots) {
+        if (slot.persistencePolicy?.kind === 'git-push') {
+            out.push({
+                key: slot.key,
+                path: slot.path,
+                branchPrefix: slot.persistencePolicy.branchPrefix,
+                branchSuffix: slot.persistencePolicy.branchSuffix ?? workspace_spec_1.GitPushBranchSuffix.SessionId,
+                concurrencyMode: slot.persistencePolicy.concurrencyMode ?? workspace_spec_1.GitPushConcurrencyMode.Force,
+            });
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=awp.js.map

package/dist/agent-workspace/lib/awp.js.map

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

package/dist/biome-availability/index.d.ts

@@ -0,0 +1,2 @@
+export * from './lib/biome-availability';
+//# sourceMappingURL=index.d.ts.map

package/dist/biome-availability/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/biome-availability/index.ts"],"names":[],"mappings":"AAQA,cAAc,0BAA0B,CAAC"}

package/dist/biome-availability/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./lib/biome-availability"), exports);
+//# sourceMappingURL=index.js.map

package/dist/biome-availability/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/biome-availability/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAQA,2DAAyC"}

package/dist/biome-availability/lib/biome-availability.d.ts

@@ -0,0 +1,9 @@
+export interface BiomeAvailabilityFilter {
+    readonly include?: readonly string[];
+    readonly exclude?: readonly string[];
+}
+export interface BiomeAvailabilityScoped {
+    readonly biomeAvailability?: BiomeAvailabilityFilter;
+}
+export declare function isBiomeContributionAllowed(biomeId: string | null | undefined, filter: BiomeAvailabilityFilter | undefined): boolean;
+//# sourceMappingURL=biome-availability.d.ts.map

package/dist/biome-availability/lib/biome-availability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"biome-availability.d.ts","sourceRoot":"","sources":["../../../src/biome-availability/lib/biome-availability.ts"],"names":[],"mappings":"AAsCA,MAAM,WAAW,uBAAuB;IAOtC,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAMrC,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AAQD,MAAM,WAAW,uBAAuB;IAKtC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,uBAAuB,CAAC;CACtD;AAuBD,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAClC,MAAM,EAAE,uBAAuB,GAAG,SAAS,GAC1C,OAAO,CAqBT"}

package/dist/biome-availability/lib/biome-availability.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isBiomeContributionAllowed = isBiomeContributionAllowed;
+function isBiomeContributionAllowed(biomeId, filter) {
+    if (biomeId === null || biomeId === undefined || biomeId.length === 0) {
+        return true;
+    }
+    if (filter === undefined) {
+        return true;
+    }
+    const exclude = filter.exclude ?? [];
+    const include = filter.include ?? [];
+    if (exclude.includes(biomeId)) {
+        return false;
+    }
+    if (include.length > 0 && !include.includes(biomeId)) {
+        return false;
+    }
+    return true;
+}
+//# sourceMappingURL=biome-availability.js.map

package/dist/biome-availability/lib/biome-availability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"biome-availability.js","sourceRoot":"","sources":["../../../src/biome-availability/lib/biome-availability.ts"],"names":[],"mappings":";;AAyFA,gEAwBC;AAxBD,SAAgB,0BAA0B,CACxC,OAAkC,EAClC,MAA2C;IAG3C,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtE,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC;IACrC,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC;IAErC,IAAI,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QACrD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/workflow/lib/compiled-run.d.ts

@@ -1,4 +1,5 @@
 import type { CompiledWorkspaceManifest } from './compiled-workspace-manifest';
+import type { BiomeAvailabilityScoped } from '../../biome-availability';
 import type { ActionRef } from './action-ref';
 import type { Briefcase } from './briefcase';
 import type { ConcurrencyGroup } from './concurrency-group';
@@ -72,7 +73,7 @@ export interface CompiledRetryPolicy {
     readonly maximumIntervalMs: number;
     readonly nonRetryableErrorTypes: readonly string[];
 }
-export interface CompiledJob {
+export interface CompiledJob extends BiomeAvailabilityScoped {
     readonly jobKey: string;
     readonly title: string | null;
     readonly needs: readonly string[];

package/dist/workflow/lib/compiled-run.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compiled-run.d.ts","sourceRoot":"","sources":["../../../src/workflow/lib/compiled-run.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"compiled-run.d.ts","sourceRoot":"","sources":["../../../src/workflow/lib/compiled-run.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xemahq/kernel-contracts",
-  "version": "0.4.0",
+  "version": "0.5.1",
   "description": "Consolidated Xema OS kernel wire contracts — pure types + zod schemas for the 32 kernel protocol surfaces. One package, one npm scope, wildcard per-surface subpath exports. No framework/runtime deps.",
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",

package/src/agent-composition/lib/composition.ts

@@ -16,6 +16,7 @@
 import type { ToolSelectionEntry } from '../../mcp-tool';
 import type { NodeOverlayFragment } from '../../workflow';
 import type { SkillRef } from '../../skill';
+import type { BiomeAvailabilityScoped } from '../../biome-availability';
 import type { CapabilityLayer } from './capability-layer';
 import type { CompositionWorkspace } from './composition-workspace';
 
@@ -99,7 +100,9 @@ export interface CompositionLimits {
  * `skills` / `tools` / `modelOverride` attach AT this node — they extend or
  * override what the referenced agent definition declares intrinsically.
  */
-export interface CompositionNode extends NodeOverlayFragment {
+export interface CompositionNode
+  extends NodeOverlayFragment,
+    BiomeAvailabilityScoped {
   /** The agent definition this node runs. */
   readonly agent: AgentRef;
   /** Optional alias when the same agent appears more than once in the tree. */
@@ -159,7 +162,9 @@ export interface Composition {
  * Distinct from `CompositionNode` (the AUTHORED form): a resolved node
  * has its agent reference fully version-pinned, never `latest`.
  */
-export interface ResolvedCompositionNode extends NodeOverlayFragment {
+export interface ResolvedCompositionNode
+  extends NodeOverlayFragment,
+    BiomeAvailabilityScoped {
   /** Fully version-pinned agent reference. */
   readonly agent: Required<AgentRef>;
   readonly alias?: string;

package/src/agent-workspace/index.ts

@@ -16,7 +16,7 @@
 
 export * from './lib/workspace-layout';
 export * from './lib/workspace-spec';
-export * from './lib/awp-v1';
+export * from './lib/awp';
 export * from './lib/context-json';
 export * from './lib/manifest';
 export * from './lib/deliverable-spec-ref';

package/src/biome-availability/index.ts

@@ -0,0 +1,9 @@
+// ═══════════════════════════════════════════════════════════════════════════
+// ── Biome Availability Contracts — Barrel Export ──
+//
+// Kernel (Layer-0) leaf: the per-definition biome opt-in/opt-out POST-scope
+// filter (DBM.2). Zero cross-subpath deps so agent-composition / skill /
+// capability / workflow / action resolvers can all import it without a cycle.
+// ═══════════════════════════════════════════════════════════════════════════
+
+export * from './lib/biome-availability';

package/src/biome-availability/lib/biome-availability.ts

@@ -0,0 +1,114 @@
+// ═══════════════════════════════════════════════════════════════════════════
+// ── Biome Availability Filter — per-definition opt-in/opt-out (DBM.2) ──
+//
+// A definition (an Agent Composition node, an Agent definition, a workflow
+// job, a Session) MAY declare which biomes' contributions it wants in or out.
+// This is a POST-SCOPE FILTER applied AFTER implicit-by-scope resolution
+// (the 5-tier `SkillScope`/`CompositionScope` precedence): it NARROWS the
+// already-visible set; it never widens it and it is NOT a parallel
+// availability/binding table (see `.claude/rules/skills-and-composition.md`).
+//
+// Why a filter and not a binding table: the ownership model is implicit-by-
+// scope — a contribution is available because its owning biome is installed
+// and enabled for the org. This filter lets ONE definition say "even though
+// biome X is installed, I don't want its contributions" (exclude) or "only
+// honor biomes Y and Z, ignore everything else" (allow-list include). It is
+// authored on the definition, additive + optional, and absent ⇒ no filtering
+// (every implicitly-visible contribution passes).
+//
+// Fail-fast is unchanged: this filter decides VISIBILITY, not lifecycle. A
+// reference that survives the filter and is still unavailable degrades only
+// when its `MissingReferencePolicy` is `Optional` (see `reference-resolution`).
+//
+// Pure Layer-0 leaf: zero cross-subpath imports so every resolver
+// (agent-composition / skill / capability / workflow / action) can import it
+// without creating a cycle.
+// ═══════════════════════════════════════════════════════════════════════════
+
+/**
+ * Per-definition opt-in / opt-out over biome-contributed references.
+ * Additive + optional everywhere it is attached. Both fields are
+ * independent and may be combined; an empty/absent filter never narrows.
+ *
+ * Precedence when both are set is encoded by {@link isBiomeContributionAllowed}:
+ * an explicit {@link exclude} ALWAYS wins (a biome in both lists is excluded),
+ * and a non-empty {@link include} turns the filter into an allow-list (any
+ * biome not listed is dropped). Non-biome contributions (no owning biome) are
+ * never affected.
+ */
+export interface BiomeAvailabilityFilter {
+  /**
+   * Allow-list. When non-empty, ONLY contributions whose owning biome id is
+   * in this list survive the filter (plus non-biome contributions, which are
+   * never filtered). When omitted/empty, every biome is allowed unless
+   * {@link exclude}d.
+   */
+  readonly include?: readonly string[];
+  /**
+   * Deny-list. A contribution whose owning biome id is in this list is
+   * always dropped, even if it also appears in {@link include}. Omitted/empty
+   * ⇒ nothing is force-excluded.
+   */
+  readonly exclude?: readonly string[];
+}
+
+/**
+ * The shape a definition mixes in to gain the optional biome opt-in/opt-out
+ * knob. Mixed into `CompositionNode`, the Agent definition contract, the
+ * workflow job/stage contract, and the Session shape so the field has ONE
+ * declaration site (no per-shape restating).
+ */
+export interface BiomeAvailabilityScoped {
+  /**
+   * Optional per-definition biome opt-in/opt-out. POST-scope filter applied
+   * after implicit-by-scope resolution. Absent ⇒ no filtering.
+   */
+  readonly biomeAvailability?: BiomeAvailabilityFilter;
+}
+
+/**
+ * The single predicate every resolver calls to decide whether a
+ * biome-contributed reference survives a definition's
+ * {@link BiomeAvailabilityFilter}. Implemented in exactly one place so the
+ * include/exclude precedence is never re-derived (and never silently
+ * diverges) per resolver.
+ *
+ * Rules, in order:
+ *   1. A contribution with no owning biome (`biomeId` null/undefined) is
+ *      NEVER filtered — it is not biome-attributed, so opt-in/opt-out does
+ *      not apply. Returns `true`.
+ *   2. No filter, or an empty filter ⇒ everything is allowed. Returns `true`.
+ *   3. `exclude` wins: a biome present in `exclude` is dropped. Returns `false`.
+ *   4. A non-empty `include` makes the filter an allow-list: a biome NOT in
+ *      `include` is dropped. Returns `false`.
+ *   5. Otherwise allowed. Returns `true`.
+ *
+ * @param biomeId the owning biome of the contribution, or null/undefined for
+ *                a non-biome (system/org/user/project-authored) contribution.
+ * @param filter  the definition's optional filter; absent ⇒ allow all.
+ */
+export function isBiomeContributionAllowed(
+  biomeId: string | null | undefined,
+  filter: BiomeAvailabilityFilter | undefined,
+): boolean {
+  // (1) Non-biome contributions are out of scope for this filter.
+  if (biomeId === null || biomeId === undefined || biomeId.length === 0) {
+    return true;
+  }
+  // (2) No filter ⇒ allow all.
+  if (filter === undefined) {
+    return true;
+  }
+  const exclude = filter.exclude ?? [];
+  const include = filter.include ?? [];
+  // (3) exclude always wins.
+  if (exclude.includes(biomeId)) {
+    return false;
+  }
+  // (4) non-empty include ⇒ allow-list semantics.
+  if (include.length > 0 && !include.includes(biomeId)) {
+    return false;
+  }
+  // (5) allowed.
+  return true;
+}

package/src/workflow/lib/compiled-run.ts

@@ -1,5 +1,6 @@
 import type { CompiledWorkspaceManifest } from './compiled-workspace-manifest';
 
+import type { BiomeAvailabilityScoped } from '../../biome-availability';
 import type { ActionRef } from './action-ref';
 import type { Briefcase } from './briefcase';
 import type { ConcurrencyGroup } from './concurrency-group';
@@ -210,7 +211,7 @@ export interface CompiledRetryPolicy {
   readonly nonRetryableErrorTypes: readonly string[];
 }
 
-export interface CompiledJob {
+export interface CompiledJob extends BiomeAvailabilityScoped {
   /** Stable logical key (as authored in YAML). Unique per CompiledRun. */
   readonly jobKey: string;
   /** Optional human-readable title; falls back to jobKey in UIs. */