@xemahq/kernel-contracts 0.3.7 → 0.5.0

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

@@ -15,7 +15,7 @@ export interface CompositionOutputSurface {
     readonly defaultDocument?: string;
 }
 export interface CompositionAgentRunConfig {
-    readonly phase: string;
+    readonly stage: string;
     readonly role: AgentRunRole;
     readonly deliverableSpecRef?: string;
 }

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-composition/lib/model-resolution-matrix.d.ts

@@ -3,14 +3,14 @@ export declare enum ResolutionDimension {
     Agent = "agent",
     Skill = "skill",
     Project = "project",
-    Group = "group",
+    Stage = "stage",
     Purpose = "purpose"
 }
 export interface ModelMatrixSelector {
     readonly agent?: string;
     readonly skill?: string;
     readonly project?: string;
-    readonly group?: string;
+    readonly stage?: string;
     readonly purpose?: string;
     readonly extra?: Readonly<Record<string, string>>;
 }
@@ -24,7 +24,7 @@ export interface ModelResolutionContext {
     readonly agentSlug: string;
     readonly projectId?: string;
     readonly skillSlug?: string;
-    readonly groupKey?: string;
+    readonly stageKey?: string;
     readonly purpose?: string;
     readonly extra?: Readonly<Record<string, string>>;
 }

package/dist/agent-composition/lib/model-resolution-matrix.js

@@ -6,7 +6,7 @@ var ResolutionDimension;
     ResolutionDimension["Agent"] = "agent";
     ResolutionDimension["Skill"] = "skill";
     ResolutionDimension["Project"] = "project";
-    ResolutionDimension["Group"] = "group";
+    ResolutionDimension["Stage"] = "stage";
     ResolutionDimension["Purpose"] = "purpose";
 })(ResolutionDimension || (exports.ResolutionDimension = ResolutionDimension = {}));
 //# sourceMappingURL=model-resolution-matrix.js.map

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

@@ -1,6 +1,6 @@
 {
   "$schema": "https://xema.dev/schemas/awp-spec.v1.json",
-  "emittedAt": "2026-06-12T14:43:51.031Z",
+  "emittedAt": "2026-06-14T10:17:37.907Z",
   "spec": {
     "id": "awp/v1",
     "version": "1.2.0",

package/dist/agent-workspace/lib/context-json.d.ts

@@ -8,7 +8,7 @@ export interface ContextInvocation {
     readonly surface: InvocationSurface;
     readonly attempt: number;
     readonly runId: string | null;
-    readonly groupKey: string | null;
+    readonly stageKey: string | null;
     readonly sessionId: string | null;
 }
 export interface ContextAuthority {

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/llm-gateway/lib/caller.d.ts

@@ -9,6 +9,6 @@ export interface LlmCaller {
     id: string;
     orgId: string;
     projectId?: string;
-    groupKey?: string;
+    stageKey?: string;
 }
 //# sourceMappingURL=caller.d.ts.map

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/dist/workflow/lib/compiled-workspace-manifest.d.ts

@@ -28,7 +28,7 @@ export interface CompiledWorkspaceManifest {
 }
 export interface CompiledManifestAgent {
     readonly slug: string;
-    readonly groupKey: string;
+    readonly stageKey: string;
     readonly role: AgentRunRole;
     readonly deliverableSpecRef?: string;
     readonly defaultModel?: ModelRef;

package/dist/workflow/lib/mount-plan.d.ts

@@ -53,7 +53,7 @@ export type MountSource = {
     readonly kind: 'agent-definition';
     readonly orgId: string;
     readonly agentSlug: string;
-    readonly groupKey: string;
+    readonly stageKey: string;
     readonly agentMode: 'primary' | 'subagent';
 } | {
     readonly kind: 'skill-bundle';
@@ -63,7 +63,7 @@ export type MountSource = {
     readonly orgId: string;
     readonly sectionKey: string;
     readonly agentSlug?: string;
-    readonly groupKey?: string;
+    readonly stageKey?: string;
 } | ({
     readonly kind: 'rendered-agents-md';
 } & RenderedAgentRunContextParams) | ({
@@ -75,7 +75,7 @@ export interface RenderedAgentRunContextParams {
     readonly orgId: string;
     readonly projectId: string;
     readonly agentSlug: string;
-    readonly groupKey: string;
+    readonly stageKey: string;
     readonly role: AgentRunRole;
     readonly sessionId?: string;
     readonly runId?: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xemahq/kernel-contracts",
-  "version": "0.3.7",
+  "version": "0.5.0",
   "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-workspace.ts

@@ -93,17 +93,17 @@ export interface CompositionOutputSurface {
 /**
  * The agent run-config the composer needs that is NOT carried by the
  * `CompositionNode` tree. The node tree pins WHICH agent runs; these
- * three fields pin the run FRAMING (phase + role + deliverable
+ * three fields pin the run FRAMING (stage + role + deliverable
  * contract) the renderer + system-overlay are driven by.
  *
- * `role` is the canonical {@link AgentRunRole}. `phase` /
+ * `role` is the canonical {@link AgentRunRole}. `stage` /
  * `deliverableSpecRef` are carried verbatim from the source manifest's
  * `spec.agent` block — they MAY still hold a `${input.x}` token, which
  * the workspace pipeline resolves against the run's bind inputs (the
  * same fail-fast interpolation grammar `env` values use).
  */
 export interface CompositionAgentRunConfig {
-  readonly phase: string;
+  readonly stage: string;
   readonly role: AgentRunRole;
   readonly deliverableSpecRef?: string;
 }
@@ -143,7 +143,7 @@ export interface CompositionMountLayout {
    * slots are NEVER present — the composer auto-emits them.
    */
   readonly mounts: Readonly<Record<string, unknown>>;
-  /** Agent run-config (phase + role + deliverable contract). */
+  /** Agent run-config (stage + role + deliverable contract). */
   readonly agentRunConfig: CompositionAgentRunConfig;
   /**
    * Raw `spec.seedFiles` array — manifest DSL `ManifestSeedFile`

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-composition/lib/model-resolution-matrix.ts

@@ -18,20 +18,20 @@
 import type { ModelRef } from '../../workflow';
 
 /**
- * Open registry of matrix dimensions. v1 ships agent/skill/project/group;
+ * Open registry of matrix dimensions. v1 ships agent/skill/project/stage;
  * v1.1 adds `purpose` for non-agent invocations (memory summarization,
  * embedding, reorganization). New dimensions are added here + carried in
  * `ModelMatrixSelector.extra` (untyped) or as a typed first-class field.
  *
- * The `group` dimension is the kernel-neutral name for a sub-app's
- * structural grouping tag on a job (e.g. the software-dev biome maps
- * its `phaseKey:` YAML field onto this dimension at compile time).
+ * The `stage` dimension is the kernel-neutral name for a sub-app's
+ * structural workflow-stage tag on a job (e.g. the software-dev biome maps
+ * its `stageKey:` YAML field onto this dimension at compile time).
  */
 export enum ResolutionDimension {
   Agent = 'agent',
   Skill = 'skill',
   Project = 'project',
-  Group = 'group',
+  Stage = 'stage',
   Purpose = 'purpose',
 }
 
@@ -47,11 +47,11 @@ export interface ModelMatrixSelector {
   /** Match when the invocation's project id equals this value. */
   readonly project?: string;
   /**
-   * Match when the invocation's structural group key equals this value.
-   * Kernel-neutral name; the software-dev biome's `phaseKey:` YAML field
+   * Match when the invocation's structural stage key equals this value.
+   * Kernel-neutral name; the software-dev biome's `stageKey:` YAML field
    * is mapped onto this dimension by the DSL compiler.
    */
-  readonly group?: string;
+  readonly stage?: string;
   /**
    * Match when the invocation's non-agent purpose equals this value. Used
    * for system flows that route LLM calls outside the agent/skill model —
@@ -84,7 +84,7 @@ export interface ModelResolutionContext {
   readonly agentSlug: string;
   readonly projectId?: string;
   readonly skillSlug?: string;
-  readonly groupKey?: string;
+  readonly stageKey?: string;
   /**
    * Non-agent invocation purpose (e.g. memory summarization/embedding).
    * Optional — agent and skill invocations leave this undefined.

package/src/agent-workspace/lib/context-json.ts

@@ -29,7 +29,7 @@ export interface ContextInvocation {
   readonly surface: InvocationSurface;
   readonly attempt: number;
   readonly runId: string | null;
-  readonly groupKey: string | null;
+  readonly stageKey: string | null;
   readonly sessionId: string | null;
 }
 

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/llm-gateway/lib/caller.ts

@@ -32,9 +32,9 @@ export enum LlmCallerKind {
  * - `kind` + `id` together identify the originating object.
  * - `orgId` is always present (billing/audit anchor).
  * - `projectId` is set when the call is project-scoped (most are).
- * - `groupKey` is set when the caller is tied to a workflow's structural
- *   group bucket. Kernel-neutral name; a sub-app biome (e.g. software-dev)
- *   maps its own `phaseKey` value onto this field at compile time.
+ * - `stageKey` is set when the caller is tied to a workflow's structural
+ *   stage bucket. Kernel-neutral name; a sub-app biome (e.g. software-dev)
+ *   maps its own `stageKey` YAML value onto this field at compile time.
  *
  * Adding new fields is non-breaking; renaming or repurposing existing
  * ones is breaking and requires updates on both gateway and consumers.
@@ -44,5 +44,5 @@ export interface LlmCaller {
   id: string;
   orgId: string;
   projectId?: string;
-  groupKey?: string;
+  stageKey?: string;
 }

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';
@@ -19,7 +20,7 @@ import type { WorkflowVariableRequirement } from './variable-requirement';
  *     :ref`, reconstructing the compiled workspace manifest from the
  *     resolved composition's `workspace.mountLayout` block.
  *   • `inline` — short-form `with.mounts` whose agent metadata
- *     (`agentSlug`, `groupKey`, `deliverableSpecRef`, every entry in
+ *     (`agentSlug`, `stageKey`, `deliverableSpecRef`, every entry in
  *     `mounts`) is fully literal at compile time. The compiler runs
  *     `compileManifest()` once and embeds the result so the worker
  *     skips both the DB round-trip and the runtime synthesis step.
@@ -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. */

package/src/workflow/lib/compiled-workspace-manifest.ts

@@ -66,7 +66,7 @@ export interface CompiledWorkspaceManifest {
 
 export interface CompiledManifestAgent {
   readonly slug: string;
-  readonly groupKey: string;
+  readonly stageKey: string;
   /**
    * Canonical {@link AgentRunRole}. Validated by the DSL's
    * `ManifestAgentBlockSchema` at compile time, so the runtime can

package/src/workflow/lib/mount-plan.ts

@@ -116,7 +116,7 @@ export type MountSource =
       readonly kind: 'agent-definition';
       readonly orgId: string;
       readonly agentSlug: string;
-      readonly groupKey: string;
+      readonly stageKey: string;
       /**
        * Frontmatter `mode` for the rendered .opencode/agents/<slug>.md
        * file. Per OpenCode docs, primary agents and sub-agents share the
@@ -141,7 +141,7 @@ export type MountSource =
       readonly orgId: string;
       readonly sectionKey: string;
       readonly agentSlug?: string;
-      readonly groupKey?: string;
+      readonly stageKey?: string;
     }
   | ({ readonly kind: 'rendered-agents-md' } & RenderedAgentRunContextParams)
   | ({ readonly kind: 'rendered-system-overlay' } & RenderedAgentRunContextParams)
@@ -170,7 +170,7 @@ export interface RenderedAgentRunContextParams {
   readonly orgId: string;
   readonly projectId: string;
   readonly agentSlug: string;
-  readonly groupKey: string;
+  readonly stageKey: string;
   readonly role: AgentRunRole;
   readonly sessionId?: string;
   readonly runId?: string;

package/src/workflow/lib/workflow-stage.ts

@@ -9,7 +9,7 @@
 //
 // A stage is identified by a free-form `stageKey` string. The artifact
 // natural key already `_`-encodes this value (`{kind}:{workflowRunId}:
-// {groupKey|_}:{scope|_}:{slug}`), and the workflow engine sequences jobs
+// {stageKey|_}:{scope|_}:{slug}`), and the workflow engine sequences jobs
 // via explicit `needs:` dependency edges — neither needs a closed enum.
 //
 // Biomes that DO define an ordered stage list (e.g. for a phase rail or a
@@ -33,7 +33,7 @@ export enum WorkflowStageCategory {
 
 /**
  * A single ordered workflow stage. `stageKey` is the value that flows onto
- * a job's `groupKey` and into the artifact natural key — a free-form
+ * a job's `stageKey` and into the artifact natural key — a free-form
  * string the kernel never validates against a closed set.
  */
 export interface WorkflowStage {