@xemahq/kernel-contracts 0.5.0 → 0.6.0

package/src/agent-workspace/lib/workspace-spec.ts

@@ -147,7 +147,7 @@ export interface SlotDefinition {
 /**
  * Workspace-relative paths captured on session pause and restored on
  * resume, plus per-slot policy overrides. The authoritative SOURCE of
- * these values is the authored `Composition.workspace.persistence` block
+ * these values is the authored `Agent.workspace.persistence` block
  * (`@xemahq/agent-composition-contracts`); they are projected onto
  * `WorkspaceSpec` so workspace-tree consumers (session lifecycle,
  * workspace-proxy snapshot pipeline) read them off one resolved spec
@@ -185,7 +185,7 @@ export interface WorkspaceSpec {
   readonly slots: readonly SlotDefinition[];
   /**
    * Workspace-relative persist-paths + per-slot policy overrides.
-   * Projected from `Composition.workspace.persistence`. Optional — when
+   * Projected from `Agent.workspace.persistence`. Optional — when
    * absent the workspace persists only what the slots' own
    * `persistencePolicy` fields declare. Additive: pre-existing consumers
    * that never read this field keep compiling.
@@ -193,7 +193,7 @@ export interface WorkspaceSpec {
   readonly persistence?: WorkspacePersistenceSpec;
   /**
    * Environment variables applied to the agent runtime before dispatch.
-   * Projected from `Composition.workspace.env`. Optional / additive —
+   * Projected from `Agent.workspace.env`. Optional / additive —
    * absent means the composition declared no env block.
    */
   readonly env?: readonly WorkspaceEnvVar[];

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

@@ -1,10 +1,10 @@
 // ═══════════════════════════════════════════════════════════════════════════
 // ── Biome Availability Filter — per-definition opt-in/opt-out (DBM.2) ──
 //
-// A definition (an Agent Composition node, an Agent definition, a workflow
+// A definition (an Agent 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
+// (the 5-tier `SkillScope`/`AgentSpace` 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`).
 //
@@ -54,7 +54,7 @@ export interface BiomeAvailabilityFilter {
 
 /**
  * The shape a definition mixes in to gain the optional biome opt-in/opt-out
- * knob. Mixed into `CompositionNode`, the Agent definition contract, the
+ * knob. Mixed into `AgentNode`, the Agent definition contract, the
  * workflow job/stage contract, and the Session shape so the field has ONE
  * declaration site (no per-shape restating).
  */

package/src/contribution/lib/contribution-kind.ts

@@ -25,7 +25,7 @@ export enum ContributionKind {
   ChartRuntime = 'chart-runtime',
   PresentationRuntime = 'presentation-runtime',
   AgentSkill = 'agent-skill',
-  AgentDefinition = 'agent-definition',
+  AgentKernel = 'agent-kernel',
   ModelResolutionDimension = 'model-resolution-dimension',
   WidgetKind = 'widget-kind',
 

package/src/contribution/lib/contribution-source.ts

@@ -2,7 +2,7 @@ import { z } from 'zod';
 
 /**
  * `ContributionSource` is the 5-tier scope at which a Contribution lives.
- * Value-identical to `SkillSpace` and `CompositionSpace` (see
+ * Value-identical to `SkillSpace` and `AgentSpace` (see
  * `.claude/rules/skills-and-composition.md`) — the three enums share ONE
  * ownership / scope model and must not drift.
  *

package/src/distribution/lib/distribution.ts

@@ -53,7 +53,7 @@ export const DistributionPlatformServiceSchema = z.object({
  * is deployed (the deployment plane). It contains PACKAGING fields only — no
  * infra/deploy/values config (that lives in the deployment overlay).
  *
- * Composition: `extends` names a parent distribution; the resolver composes
+ * Agent: `extends` names a parent distribution; the resolver composes
  * parent → child, with the child's `include`/`exclude` overriding. The resolver
  * enforces (fail-fast): kernel-tier biomes are always included and cannot be
  * excluded; an included biome whose `requires` are absent is an error; selectors

package/src/document-templates/lib/document-template.ts

@@ -51,7 +51,7 @@ export enum DocumentTemplateScope {
  * not interpret the strings, just hands them to skill-registry-api.
  *
  * `subAgents` are agent slugs delegated as sub-agents on the session's
- * Agent Composition. The bar for declaring one is "needs its own model,
+ * Agent. The bar for declaring one is "needs its own model,
  * tools, or context"; most templates leave this empty and rely on
  * sub-skills (cheap, shared context).
  *

package/src/invocation/lib/execution-requirements.ts

@@ -10,7 +10,7 @@ import {
  * Per-invocation hard limits. None are required at the contract level; an
  * absent field means "no caller-declared limit on this axis" (the platform may
  * still apply its own). These map directly onto the existing `composition.limits`
- * consumed by `CompositionBudgetEnforcer` — no new enforcement engine.
+ * consumed by `AgentBudgetEnforcer` — no new enforcement engine.
  */
 export interface InvocationLimits {
   readonly maxDurationMs?: number;

package/src/invocation/lib/invocation-mode.ts

@@ -1,7 +1,7 @@
 import { z } from 'zod';
 
 /**
- * How the Composition Invocation Runtime executes an invocation.
+ * How the Agent Invocation Runtime executes an invocation.
  *
  * The platform owns mode selection (deterministic `selectMode`): a biome MAY
  * hint a mode via `ExecutionRequirements.mode`, but policy may override it.

package/src/invocation/lib/invocation-record.ts

@@ -16,7 +16,7 @@ import {
  */
 export interface InvocationRecord {
   readonly id: string;
-  readonly compositionRef: string;
+  readonly agentRef: string;
   readonly orgId: string;
   readonly projectId: string | null;
   readonly threadKey: string;
@@ -38,7 +38,7 @@ export interface InvocationRecord {
 
 export const InvocationRecordSchema = z.object({
   id: z.string().min(1),
-  compositionRef: z.string().min(1),
+  agentRef: z.string().min(1),
   orgId: z.string().min(1),
   projectId: z.string().min(1).nullable(),
   threadKey: z.string().min(1),

package/src/invocation/lib/invoke-request.ts

@@ -8,12 +8,12 @@ import {
  * The wire body for `composition:invoke@1` — what a caller sends through the
  * capability funnel to execute a published composition.
  *
- * `CompositionInvokeRequestSchema` is the fail-fast validator the runtime
+ * `AgentInvokeRequestSchema` is the fail-fast validator the runtime
  * applies at the wire boundary before any execution.
  */
-export interface CompositionInvokeRequest {
-  /** Composition slug or `slug@version`. */
-  readonly compositionRef: string;
+export interface AgentInvokeRequest {
+  /** Agent slug or `slug@version`. */
+  readonly agentRef: string;
   readonly orgId: string;
   readonly projectId?: string;
   /** Stable execution-context key — org+mailbox+emailThreadId for mail. */
@@ -23,12 +23,12 @@ export interface CompositionInvokeRequest {
   readonly requirements: ExecutionRequirements;
 }
 
-export const CompositionInvokeRequestSchema = z.object({
-  compositionRef: z.string().min(1),
+export const AgentInvokeRequestSchema = z.object({
+  agentRef: z.string().min(1),
   orgId: z.string().min(1),
   projectId: z.string().min(1).optional(),
   threadKey: z.string().min(1),
   correlationId: z.string().min(1).optional(),
   input: z.record(z.string(), z.unknown()),
   requirements: ExecutionRequirementsSchema,
-}) as z.ZodType<CompositionInvokeRequest>;
+}) as z.ZodType<AgentInvokeRequest>;

package/src/invocation/lib/invoke-response.ts

@@ -13,7 +13,7 @@ import {
  * `Event` mode `output` is omitted and the consumer subscribes to the result
  * completion event instead.
  */
-export interface CompositionInvokeResponse {
+export interface AgentInvokeResponse {
   readonly invocationId: string;
   readonly status: InvocationStatus;
   readonly mode: InvocationMode;
@@ -26,7 +26,7 @@ export interface CompositionInvokeResponse {
   readonly auditId?: string;
 }
 
-export const CompositionInvokeResponseSchema = z.object({
+export const AgentInvokeResponseSchema = z.object({
   invocationId: z.string().min(1),
   status: InvocationStatusSchema,
   mode: InvocationModeSchema,
@@ -36,4 +36,4 @@ export const CompositionInvokeResponseSchema = z.object({
   durationMs: z.number().optional(),
   modelRef: z.string().min(1).optional(),
   auditId: z.string().min(1).optional(),
-}) as z.ZodType<CompositionInvokeResponse>;
+}) as z.ZodType<AgentInvokeResponse>;

package/src/object/lib/object-lifecycle.ts

@@ -2,7 +2,7 @@ import { z } from 'zod';
 
 /**
  * Lifecycle every versioned XemaObject moves through. Mirrors
- * `CompositionLifecycle` from `@xemahq/agent-composition-contracts` —
+ * `AgentLifecycle` from `@xemahq/agent-composition-contracts` —
  * the two enums MUST stay value-identical (one ownership model across
  * the four primitives + every other XemaObject kind, per
  * `.claude/rules/skills-and-composition.md`).

package/src/object/lib/xema-object-kind.ts

@@ -19,9 +19,9 @@ export enum XemaObjectKind {
   ExternalSubject = 'external-subject',
   DelegatedSession = 'delegated-session',
 
-  // Agent runtime primitives + composition
+  // Agent runtime primitives — a base kernel armed into an Agent
+  AgentKernel = 'agent-kernel',
   Agent = 'agent',
-  AgentComposition = 'agent-composition',
   Skill = 'skill',
   Tool = 'tool',
   Model = 'model',

package/src/object/lib/xema-object.ts

@@ -35,11 +35,11 @@ export const SubjectRefSchema = z.object({
  * - `ref` is the wire-stable address (`XemaObjectRef`).
  * - `kind` is the closed `XemaObjectKind` enum value.
  * - `scope` is the 5-tier ownership reference (single ownership model
- *   shared with `SkillSpace` / `CompositionSpace`).
+ *   shared with `SkillSpace` / `AgentSpace`).
  * - `owner` is the subject that owns the object.
  * - `version` is a semver string. Resolution serves only `Published`
  *   versions per `ObjectLifecycle` semantics.
- * - `lifecycle` mirrors `CompositionLifecycle` (draft/published/archived).
+ * - `lifecycle` mirrors `AgentLifecycle` (draft/published/archived).
  * - `payload` is kind-specific; the resolved schema is supplied by the
  *   owning domain contract package.
  */

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

@@ -14,9 +14,9 @@ import type { WorkflowVariableRequirement } from './variable-requirement';
  * Pre-resolved manifest source for `xema/agent`-shaped jobs. The
  * workflow-dsl compiler emits exactly one variant per agent step:
  *
- *   • `ref` — long-form `with.compositionRef: <slug>` (or
+ *   • `ref` — long-form `with.agentRef: <slug>` (or
  *     `<slug>@<version>`) that the activity resolves at boot via
- *     llm-registry-api's Agent Composition `GET /compositions/resolve/
+ *     llm-registry-api's Agent `GET /compositions/resolve/
  *     :ref`, reconstructing the compiled workspace manifest from the
  *     resolved composition's `workspace.mountLayout` block.
  *   • `inline` — short-form `with.mounts` whose agent metadata
@@ -30,7 +30,7 @@ import type { WorkflowVariableRequirement } from './variable-requirement';
  *
  * `null` for non-agent actions (compileManifestSource short-circuits
  * when the action manifest's `inputs.properties` lacks both
- * `compositionRef` and `mounts`).
+ * `agentRef` and `mounts`).
  */
 export type CompiledManifestSource =
   | { readonly kind: 'ref'; readonly ref: string }

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

@@ -80,7 +80,7 @@ export interface CompiledManifestAgent {
    * manifest's `spec.agent.instructions` (WS5 Phase B: author a migrated
    * agent as `base agent slug + instructions`). A prompt fragment the
    * runtime layers ONTO the referenced base agent's intrinsic system
-   * prompt — semantically the same as `CompositionNode.instructions`.
+   * prompt — semantically the same as `AgentNode.instructions`.
    * Absent = the base agent's prompt passes through unchanged.
    */
   readonly instructions?: string;

package/src/workflow/lib/model-ref.ts

@@ -148,7 +148,7 @@ export function isStrategyModelRef(ref: ModelRef): ref is StrategyModelRef {
  * The INVOCATION-overlay fragment shared by EVERY "agent node" shape — the
  * genuinely-identical trio that specializes a referenced agent WITHOUT
  * authoring a new definition. Single declaration site (the
- * `ModelRef`/`PermissionMap` reuse pattern): `CompositionNode`,
+ * `ModelRef`/`PermissionMap` reuse pattern): `AgentNode`,
  * `SubAgentBinding`, the compiled manifest agent block, and the typed
  * workflow/session invocation overlays all `extends` this — the trio is
  * never restated per shape.

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

@@ -113,7 +113,7 @@ export type MountSource =
   | { readonly kind: 'static-literal'; readonly pathWithinWorkspace: string; readonly bytes: string }
   // Platform-rendered (PR 1 of unified-workspace-image refactor):
   | {
-      readonly kind: 'agent-definition';
+      readonly kind: 'agent-kernel';
       readonly orgId: string;
       readonly agentSlug: string;
       readonly stageKey: string;