@xemahq/kernel-contracts 0.5.1 → 0.7.0

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

@@ -1,5 +1,3 @@
-import type { CompiledWorkspaceManifest } from './compiled-workspace-manifest';
-
 import type { BiomeAvailabilityScoped } from '../../biome-availability';
 import type { ActionRef } from './action-ref';
 import type { Briefcase } from './briefcase';
@@ -11,30 +9,24 @@ import type { TriggerPayload } from './trigger-payload';
 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:
+ * Pre-resolved manifest source for `xema/agent`-shaped jobs. `agentRef`
+ * is the SOLE way a workflow names its agent — the workflow-dsl compiler
+ * emits exactly one variant per agent step:
  *
- *   • `ref` — long-form `with.compositionRef: <slug>` (or
+ *   • `ref` — `with.agentRef` is a literal `<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
- *     (`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.
- *   • `inline-deferred` — short-form whose agent metadata still
- *     contains `${{ … }}` expressions; the worker synthesizes the
- *     inline manifest after expression evaluation.
+ *   • `inline-deferred` — `with.agentRef` is a `${{ … }}` expression
+ *     that resolves per dispatch; the worker resolves the named Agent
+ *     after expression evaluation.
  *
  * `null` for non-agent actions (compileManifestSource short-circuits
- * when the action manifest's `inputs.properties` lacks both
- * `compositionRef` and `mounts`).
+ * when the action manifest's `inputs.properties` lacks `agentRef`).
  */
 export type CompiledManifestSource =
   | { readonly kind: 'ref'; readonly ref: string }
-  | { readonly kind: 'inline'; readonly compiled: CompiledWorkspaceManifest }
   | { readonly kind: 'inline-deferred' };
 
 /**

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/errors.ts

@@ -18,9 +18,9 @@ export enum WorkflowErrorCode {
   DSL_UNKNOWN_ACTION = 'DSL_UNKNOWN_ACTION',
   DSL_UNKNOWN_REUSABLE_WORKFLOW = 'DSL_UNKNOWN_REUSABLE_WORKFLOW',
   /**
-   * A literal `with.agentSlug` (or `with.reviewers[].agentSlug`) value
+   * A literal `with.agentRef` (or `with.reviewers[].agentRef`) value
    * does not appear in the resolvedAgents map the engine passed to the
-   * compiler. Indicates a typo, a stale slug, or a new agent that was
+   * compiler. Indicates a typo, a stale ref, or a new agent that was
    * never seeded into llm-registry.
    */
   DSL_UNKNOWN_AGENT = 'DSL_UNKNOWN_AGENT',

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;