@xemahq/kernel-contracts 0.13.4 → 0.14.0

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

@@ -1,6 +1,6 @@
 {
   "$schema": "https://xema.dev/schemas/awp-spec.v1.json",
-  "emittedAt": "2026-06-22T08:00:29.978Z",
+  "emittedAt": "2026-06-22T09:58:02.236Z",
   "spec": {
     "id": "awp/v1",
     "version": "1.2.0",

package/dist/contribution/index.d.ts

@@ -2,4 +2,5 @@ export * from './lib/contribution-kind';
 export * from './lib/contribution-source';
 export * from './lib/contribution';
 export * from './lib/registry';
+export * from './lib/sync';
 //# sourceMappingURL=index.d.ts.map

package/dist/contribution/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/contribution/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/contribution/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC"}

package/dist/contribution/index.js

@@ -18,4 +18,5 @@ __exportStar(require("./lib/contribution-kind"), exports);
 __exportStar(require("./lib/contribution-source"), exports);
 __exportStar(require("./lib/contribution"), exports);
 __exportStar(require("./lib/registry"), exports);
+__exportStar(require("./lib/sync"), exports);
 //# sourceMappingURL=index.js.map

package/dist/contribution/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/contribution/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0DAAwC;AACxC,4DAA0C;AAC1C,qDAAmC;AACnC,iDAA+B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/contribution/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0DAAwC;AACxC,4DAA0C;AAC1C,qDAAmC;AACnC,iDAA+B;AAC/B,6CAA2B"}

package/dist/contribution/lib/sync.d.ts

@@ -0,0 +1,75 @@
+import { z } from 'zod';
+import { ContributionKind } from './contribution-kind';
+import { AnyContributionEnvelopeSchema } from './contribution';
+export declare enum ContributionOwnerKind {
+    Biome = "biome",
+    RuntimeService = "runtime_service",
+    SystemSeed = "system_seed"
+}
+export declare const ContributionOwnerKindSchema: z.ZodEnum<typeof ContributionOwnerKind>;
+export interface ContributionOwner {
+    readonly type: ContributionOwnerKind;
+    readonly id: string;
+    readonly version?: string;
+}
+export declare const ContributionOwnerSchema: z.ZodObject<{
+    type: z.ZodEnum<typeof ContributionOwnerKind>;
+    id: z.ZodString;
+    version: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare enum ContributionSyncStatus {
+    NotSynced = "not_synced",
+    Syncing = "syncing",
+    Synced = "synced",
+    SyncFailed = "sync_failed",
+    PendingRetry = "pending_retry",
+    Partial = "partial"
+}
+export declare const ContributionSyncStatusSchema: z.ZodEnum<typeof ContributionSyncStatus>;
+export interface ContributionSyncRequest {
+    readonly owner: ContributionOwner;
+    readonly kind: ContributionKind;
+    readonly items: readonly z.infer<typeof AnyContributionEnvelopeSchema>[];
+    readonly contentHash: string;
+    readonly syncToken: string;
+}
+export declare const ContributionSyncRequestSchema: z.ZodObject<{
+    owner: z.ZodObject<{
+        type: z.ZodEnum<typeof ContributionOwnerKind>;
+        id: z.ZodString;
+        version: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    kind: z.ZodEnum<typeof ContributionKind>;
+    items: z.ZodArray<z.ZodObject<{
+        kind: z.ZodEnum<typeof ContributionKind>;
+        slug: z.ZodString;
+        source: z.ZodEnum<typeof import("./contribution-source").ContributionSource>;
+        version: z.ZodString;
+        manifest: z.ZodUnknown;
+    }, z.core.$strip>>;
+    contentHash: z.ZodString;
+    syncToken: z.ZodString;
+}, z.core.$strip>;
+export interface ContributionSyncResult {
+    readonly owner: ContributionOwner;
+    readonly kind: ContributionKind;
+    readonly upserted: number;
+    readonly pruned: number;
+    readonly unchanged: number;
+    readonly skippedNoOp: boolean;
+    readonly status: ContributionSyncStatus;
+}
+export declare const ContributionSyncResultSchema: z.ZodObject<{
+    owner: z.ZodObject<{
+        type: z.ZodEnum<typeof ContributionOwnerKind>;
+        id: z.ZodString;
+        version: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    kind: z.ZodEnum<typeof ContributionKind>;
+    upserted: z.ZodNumber;
+    pruned: z.ZodNumber;
+    unchanged: z.ZodNumber;
+    skippedNoOp: z.ZodBoolean;
+    status: z.ZodEnum<typeof ContributionSyncStatus>;
+}, z.core.$strip>;
+//# sourceMappingURL=sync.d.ts.map

package/dist/contribution/lib/sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../../src/contribution/lib/sync.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAA0B,MAAM,qBAAqB,CAAC;AAC/E,OAAO,EAAE,6BAA6B,EAAE,MAAM,gBAAgB,CAAC;AAqC/D,oBAAY,qBAAqB;IAC/B,KAAK,UAAU;IACf,cAAc,oBAAoB;IAClC,UAAU,gBAAgB;CAC3B;AAED,eAAO,MAAM,2BAA2B,yCAAsC,CAAC;AAG/E,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;IAErC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,eAAO,MAAM,uBAAuB;;;;iBAIlC,CAAC;AAgBH,oBAAY,sBAAsB;IAChC,SAAS,eAAe;IACxB,OAAO,YAAY;IACnB,MAAM,WAAW;IACjB,UAAU,gBAAgB;IAC1B,YAAY,kBAAkB;IAC9B,OAAO,YAAY;CACpB;AAED,eAAO,MAAM,4BAA4B,0CAAuC,CAAC;AAWjF,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAC;IAClC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,EAAE,CAAC;IACzE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;iBAMxC,CAAC;AAGH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAC;IAClC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,sBAAsB,CAAC;CACzC;AAED,eAAO,MAAM,4BAA4B;;;;;;;;;;;;iBAQvC,CAAC"}

package/dist/contribution/lib/sync.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ContributionSyncResultSchema = exports.ContributionSyncRequestSchema = exports.ContributionSyncStatusSchema = exports.ContributionSyncStatus = exports.ContributionOwnerSchema = exports.ContributionOwnerKindSchema = exports.ContributionOwnerKind = void 0;
+const zod_1 = require("zod");
+const contribution_kind_1 = require("./contribution-kind");
+const contribution_1 = require("./contribution");
+var ContributionOwnerKind;
+(function (ContributionOwnerKind) {
+    ContributionOwnerKind["Biome"] = "biome";
+    ContributionOwnerKind["RuntimeService"] = "runtime_service";
+    ContributionOwnerKind["SystemSeed"] = "system_seed";
+})(ContributionOwnerKind || (exports.ContributionOwnerKind = ContributionOwnerKind = {}));
+exports.ContributionOwnerKindSchema = zod_1.z.nativeEnum(ContributionOwnerKind);
+exports.ContributionOwnerSchema = zod_1.z.object({
+    type: exports.ContributionOwnerKindSchema,
+    id: zod_1.z.string().min(1),
+    version: zod_1.z.string().min(1).optional(),
+});
+var ContributionSyncStatus;
+(function (ContributionSyncStatus) {
+    ContributionSyncStatus["NotSynced"] = "not_synced";
+    ContributionSyncStatus["Syncing"] = "syncing";
+    ContributionSyncStatus["Synced"] = "synced";
+    ContributionSyncStatus["SyncFailed"] = "sync_failed";
+    ContributionSyncStatus["PendingRetry"] = "pending_retry";
+    ContributionSyncStatus["Partial"] = "partial";
+})(ContributionSyncStatus || (exports.ContributionSyncStatus = ContributionSyncStatus = {}));
+exports.ContributionSyncStatusSchema = zod_1.z.nativeEnum(ContributionSyncStatus);
+exports.ContributionSyncRequestSchema = zod_1.z.object({
+    owner: exports.ContributionOwnerSchema,
+    kind: contribution_kind_1.ContributionKindSchema,
+    items: zod_1.z.array(contribution_1.AnyContributionEnvelopeSchema),
+    contentHash: zod_1.z.string().min(1),
+    syncToken: zod_1.z.string().min(1),
+});
+exports.ContributionSyncResultSchema = zod_1.z.object({
+    owner: exports.ContributionOwnerSchema,
+    kind: contribution_kind_1.ContributionKindSchema,
+    upserted: zod_1.z.number().int().nonnegative(),
+    pruned: zod_1.z.number().int().nonnegative(),
+    unchanged: zod_1.z.number().int().nonnegative(),
+    skippedNoOp: zod_1.z.boolean(),
+    status: exports.ContributionSyncStatusSchema,
+});
+//# sourceMappingURL=sync.js.map

package/dist/contribution/lib/sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.js","sourceRoot":"","sources":["../../../src/contribution/lib/sync.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,2DAA+E;AAC/E,iDAA+D;AAqC/D,IAAY,qBAIX;AAJD,WAAY,qBAAqB;IAC/B,wCAAe,CAAA;IACf,2DAAkC,CAAA;IAClC,mDAA0B,CAAA;AAC5B,CAAC,EAJW,qBAAqB,qCAArB,qBAAqB,QAIhC;AAEY,QAAA,2BAA2B,GAAG,OAAC,CAAC,UAAU,CAAC,qBAAqB,CAAC,CAAC;AAWlE,QAAA,uBAAuB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC9C,IAAI,EAAE,mCAA2B;IACjC,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACrB,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;CACtC,CAAC,CAAC;AAgBH,IAAY,sBAOX;AAPD,WAAY,sBAAsB;IAChC,kDAAwB,CAAA;IACxB,6CAAmB,CAAA;IACnB,2CAAiB,CAAA;IACjB,oDAA0B,CAAA;IAC1B,wDAA8B,CAAA;IAC9B,6CAAmB,CAAA;AACrB,CAAC,EAPW,sBAAsB,sCAAtB,sBAAsB,QAOjC;AAEY,QAAA,4BAA4B,GAAG,OAAC,CAAC,UAAU,CAAC,sBAAsB,CAAC,CAAC;AAmBpE,QAAA,6BAA6B,GAAG,OAAC,CAAC,MAAM,CAAC;IACpD,KAAK,EAAE,+BAAuB;IAC9B,IAAI,EAAE,0CAAsB;IAC5B,KAAK,EAAE,OAAC,CAAC,KAAK,CAAC,4CAA6B,CAAC;IAC7C,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9B,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CAC7B,CAAC,CAAC;AAaU,QAAA,4BAA4B,GAAG,OAAC,CAAC,MAAM,CAAC;IACnD,KAAK,EAAE,+BAAuB;IAC9B,IAAI,EAAE,0CAAsB;IAC5B,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IACxC,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IACtC,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IACzC,WAAW,EAAE,OAAC,CAAC,OAAO,EAAE;IACxB,MAAM,EAAE,oCAA4B;CACrC,CAAC,CAAC"}

package/dist/resource/lib/resource-managed-by.d.ts

@@ -3,6 +3,8 @@ export declare enum ResourceManagedBy {
     Ui = "ui",
     Iac = "iac",
     Seeder = "seeder",
+    BiomeContributed = "biome_contributed",
+    RuntimeRegistered = "runtime_registered",
     System = "system"
 }
 export declare const ResourceManagedBySchema: z.ZodEnum<typeof ResourceManagedBy>;

package/dist/resource/lib/resource-managed-by.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resource-managed-by.d.ts","sourceRoot":"","sources":["../../../src/resource/lib/resource-managed-by.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAqBxB,oBAAY,iBAAiB;IAC3B,EAAE,OAAO;IACT,GAAG,QAAQ;IACX,MAAM,WAAW;IACjB,MAAM,WAAW;CAClB;AAED,eAAO,MAAM,uBAAuB,qCAAkC,CAAC"}
+{"version":3,"file":"resource-managed-by.d.ts","sourceRoot":"","sources":["../../../src/resource/lib/resource-managed-by.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAgCxB,oBAAY,iBAAiB;IAC3B,EAAE,OAAO;IACT,GAAG,QAAQ;IACX,MAAM,WAAW;IACjB,gBAAgB,sBAAsB;IACtC,iBAAiB,uBAAuB;IACxC,MAAM,WAAW;CAClB;AAED,eAAO,MAAM,uBAAuB,qCAAkC,CAAC"}

package/dist/resource/lib/resource-managed-by.js

@@ -7,6 +7,8 @@ var ResourceManagedBy;
     ResourceManagedBy["Ui"] = "ui";
     ResourceManagedBy["Iac"] = "iac";
     ResourceManagedBy["Seeder"] = "seeder";
+    ResourceManagedBy["BiomeContributed"] = "biome_contributed";
+    ResourceManagedBy["RuntimeRegistered"] = "runtime_registered";
     ResourceManagedBy["System"] = "system";
 })(ResourceManagedBy || (exports.ResourceManagedBy = ResourceManagedBy = {}));
 exports.ResourceManagedBySchema = zod_1.z.nativeEnum(ResourceManagedBy);

package/dist/resource/lib/resource-managed-by.js.map

@@ -1 +1 @@
-{"version":3,"file":"resource-managed-by.js","sourceRoot":"","sources":["../../../src/resource/lib/resource-managed-by.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAqBxB,IAAY,iBAKX;AALD,WAAY,iBAAiB;IAC3B,8BAAS,CAAA;IACT,gCAAW,CAAA;IACX,sCAAiB,CAAA;IACjB,sCAAiB,CAAA;AACnB,CAAC,EALW,iBAAiB,iCAAjB,iBAAiB,QAK5B;AAEY,QAAA,uBAAuB,GAAG,OAAC,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC"}
+{"version":3,"file":"resource-managed-by.js","sourceRoot":"","sources":["../../../src/resource/lib/resource-managed-by.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAgCxB,IAAY,iBAOX;AAPD,WAAY,iBAAiB;IAC3B,8BAAS,CAAA;IACT,gCAAW,CAAA;IACX,sCAAiB,CAAA;IACjB,2DAAsC,CAAA;IACtC,6DAAwC,CAAA;IACxC,sCAAiB,CAAA;AACnB,CAAC,EAPW,iBAAiB,iCAAjB,iBAAiB,QAO5B;AAEY,QAAA,uBAAuB,GAAG,OAAC,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xemahq/kernel-contracts",
-  "version": "0.13.4",
+  "version": "0.14.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/contribution/index.ts

@@ -2,3 +2,4 @@ export * from './lib/contribution-kind';
 export * from './lib/contribution-source';
 export * from './lib/contribution';
 export * from './lib/registry';
+export * from './lib/sync';

package/src/contribution/lib/sync.ts

@@ -0,0 +1,132 @@
+import { z } from 'zod';
+import { ContributionKind, ContributionKindSchema } from './contribution-kind';
+import { AnyContributionEnvelopeSchema } from './contribution';
+
+// NOTE: the `contribution` subpath is a DAG leaf and MUST NOT import the
+// `resource` subpath (enforced by check-subpath-dag.mjs). The mapping from
+// `ContributionOwnerKind` to `ResourceManagedBy` therefore lives in the
+// consuming SDK (`@xemahq/contribution-sync-nest`), which legally depends on
+// both subpaths. Keep that mapping the single source of truth there.
+
+// ═══════════════════════════════════════════════════════════════════════════
+// Contribution sync — the declarative, owner-scoped push contract.
+//
+// biome-host (and a runtime service self-registering its own capabilities)
+// pushes the COMPLETE desired set of contributions for one `(owner, kind)`
+// to the owning registry over HTTP. The registry upserts every item and
+// prunes anything it owns for that `(owner, kind)` that is no longer present.
+//
+// This replaces the boot-time local-directory scan: registries no longer read
+// biome trees off disk; they receive their content. Pruning is owner-scoped
+// (NEVER installation-scoped — biome content is platform-global and shared
+// across org/project installs), so a per-tenant enable/disable never deletes
+// shared content.
+// ═══════════════════════════════════════════════════════════════════════════
+
+/**
+ * Who owns a pushed set of contributions. The typed owner keeps three
+ * lifecycles cleanly separated while sharing ONE engine + wire shape:
+ *
+ * - `Biome`          — a biome bundle's contributions, pushed by biome-host.
+ *   `id` is the biome id, `version` the biome version. Maps to
+ *   `ResourceManagedBy.BiomeContributed`.
+ * - `RuntimeService` — a service self-registering its OWN capabilities (the
+ *   `@XemaCapability` auto-register path). `id` is the service name. Maps to
+ *   `ResourceManagedBy.RuntimeRegistered`.
+ * - `SystemSeed`     — a genuine package/in-service seed that is neither a
+ *   biome push nor runtime self-registration (`@xemahq/system-skills`,
+ *   `INITIAL_CAPABILITY_SEED`). Maps to `ResourceManagedBy.Seeder`.
+ */
+export enum ContributionOwnerKind {
+  Biome = 'biome',
+  RuntimeService = 'runtime_service',
+  SystemSeed = 'system_seed',
+}
+
+export const ContributionOwnerKindSchema = z.nativeEnum(ContributionOwnerKind);
+
+/** The typed owner of a pushed contribution set. */
+export interface ContributionOwner {
+  readonly type: ContributionOwnerKind;
+  /** Biome id, service name, or seed id depending on `type`. */
+  readonly id: string;
+  /** Biome/bundle version for `Biome` owners; optional otherwise. */
+  readonly version?: string;
+}
+
+export const ContributionOwnerSchema = z.object({
+  type: ContributionOwnerKindSchema,
+  id: z.string().min(1),
+  version: z.string().min(1).optional(),
+});
+
+/**
+ * Lifecycle/availability status of a registry's content for one `(owner, kind)`.
+ * Persisted by the registry and aggregated by biome-host for the UI AND used by
+ * the registry to gate consumption (a not-fully-synced set is not served).
+ *
+ * - `NOT_SYNCED`   — never synced; no rows exist yet (structural empty).
+ * - `SYNCING`      — a sync is in flight.
+ * - `SYNCED`       — desired === active; content is the current good set.
+ * - `SYNC_FAILED`  — last attempt failed (e.g. referential-integrity reject);
+ *   the prior `active` set is preserved and still served.
+ * - `PENDING_RETRY`— transient failure queued for retry (outbox).
+ * - `PARTIAL`      — synced, but a cross-service dependency is unsatisfied;
+ *   affected items are not launchable until it resolves.
+ */
+export enum ContributionSyncStatus {
+  NotSynced = 'not_synced',
+  Syncing = 'syncing',
+  Synced = 'synced',
+  SyncFailed = 'sync_failed',
+  PendingRetry = 'pending_retry',
+  Partial = 'partial',
+}
+
+export const ContributionSyncStatusSchema = z.nativeEnum(ContributionSyncStatus);
+
+/**
+ * The push request. `items` is the COMPLETE desired set for `(owner, kind)`
+ * after the pusher's cross-biome `extends`-dedup — never a delta.
+ *
+ * `contentHash` is a stable sha256 over the canonicalized `items` (idempotent
+ * no-op detection). `syncToken` is a MONOTONIC lifecycle-attempt token (ULID /
+ * sequence / transition counter) — deliberately NOT derived from the version,
+ * so a downgrade still carries a higher token than the upgrade it reverts.
+ */
+export interface ContributionSyncRequest {
+  readonly owner: ContributionOwner;
+  readonly kind: ContributionKind;
+  readonly items: readonly z.infer<typeof AnyContributionEnvelopeSchema>[];
+  readonly contentHash: string;
+  readonly syncToken: string;
+}
+
+export const ContributionSyncRequestSchema = z.object({
+  owner: ContributionOwnerSchema,
+  kind: ContributionKindSchema,
+  items: z.array(AnyContributionEnvelopeSchema),
+  contentHash: z.string().min(1),
+  syncToken: z.string().min(1),
+});
+
+/** The registry's response to a sync push. */
+export interface ContributionSyncResult {
+  readonly owner: ContributionOwner;
+  readonly kind: ContributionKind;
+  readonly upserted: number;
+  readonly pruned: number;
+  readonly unchanged: number;
+  readonly skippedNoOp: boolean;
+  readonly status: ContributionSyncStatus;
+}
+
+export const ContributionSyncResultSchema = z.object({
+  owner: ContributionOwnerSchema,
+  kind: ContributionKindSchema,
+  upserted: z.number().int().nonnegative(),
+  pruned: z.number().int().nonnegative(),
+  unchanged: z.number().int().nonnegative(),
+  skippedNoOp: z.boolean(),
+  status: ContributionSyncStatusSchema,
+});

package/src/resource/lib/resource-managed-by.ts

@@ -4,10 +4,21 @@ import { z } from 'zod';
  * `ResourceManagedBy` — the ownership marker stamped on every provisionable
  * resource row. This single concept powers three behaviors with one switch:
  *
- * - `Seeder`  — owned by a boot/event reconciler (e.g. portals derived from
- *   installed web biomes). The reconciler may create/update/retire these.
+ * - `Seeder`  — owned by a boot/event reconciler that is NOT a biome-bundle
+ *   push (e.g. portals derived from installed web biomes, or genuine
+ *   package/in-service seeds such as `@xemahq/system-skills` and
+ *   `INITIAL_CAPABILITY_SEED`). The reconciler may create/update/retire these.
  *   Retire-removed deletes ONLY `Seeder`-owned rows whose `managedKey` no
  *   longer appears in the desired set.
+ * - `BiomeContributed` — owned by the biome-host contribution-sync push: a
+ *   biome bundle's contributions (agents, skills, specs, …) materialized into
+ *   an owning registry over HTTP at biome lifecycle time. Pruned biome-scoped
+ *   (`owner.type=biome`, `owner.id=biomeId`) when a biome upgrade drops an item
+ *   or the biome leaves the platform — NEVER on per-org/project enable/disable.
+ * - `RuntimeRegistered` — self-registered by a runtime service at boot (the
+ *   `@XemaCapability` auto-register path: a service publishing its OWN
+ *   capabilities). Owner is `owner.type=runtime_service`, `owner.id=serviceName`;
+ *   its prune scope is the service, never a biome's content.
  * - `Iac`     — owned by a declarative source (Terraform / `xema.yaml`).
  *   Declared-state-wins: `plan` surfaces drift, `apply` reconciles back. No
  *   reconciler touches a row it does not own.
@@ -23,6 +34,8 @@ export enum ResourceManagedBy {
   Ui = 'ui',
   Iac = 'iac',
   Seeder = 'seeder',
+  BiomeContributed = 'biome_contributed',
+  RuntimeRegistered = 'runtime_registered',
   System = 'system',
 }
 

package/src/space/lib/skill-mirror-path.ts

@@ -7,10 +7,10 @@
 //
 // Runtime-NEUTRAL: a skill bundle (SKILL.md + resources) is identical across
 // every runtime; only WHERE it is finally placed inside the workspace differs
-// (`.opencode/skills`, `.qwen/skills`, `.claude/skills`, `.hermes/skills`), and
+// (each runtime mounts skills under its own per-runtime skills subtree), and
 // that placement is owned by the worker's RuntimeLayout — NOT by this path.
 // This module describes the STORAGE location of the pre-staged bytes only, so
-// it works for OpenCode / Qwen / Claude / Hermes / any future runtime alike.
+// it works for every runtime adapter alike, present and future.
 // ═══════════════════════════════════════════════════════════════════════════
 import { SpaceKind, type SpaceRef } from './space';