@xemahq/kernel-contracts 0.22.0 → 0.22.2

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

@@ -1,6 +1,7 @@
 export * from './lib/capability-layer';
 export * from './lib/agent';
 export * from './lib/agent-reach-tier';
+export * from './lib/agent-session-lifecycle';
 export * from './lib/agent-workspace-sharing';
 export * from './lib/agent-limits-schema';
 export * from './lib/agent-workspace-config';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agent-composition/index.ts"],"names":[],"mappings":"AAWA,cAAc,wBAAwB,CAAC;AACvC,cAAc,aAAa,CAAC;AAC5B,cAAc,wBAAwB,CAAC;AACvC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,+BAA+B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agent-composition/index.ts"],"names":[],"mappings":"AAWA,cAAc,wBAAwB,CAAC;AACvC,cAAc,aAAa,CAAC;AAC5B,cAAc,wBAAwB,CAAC;AACvC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,+BAA+B,CAAC"}

package/dist/agent-composition/index.js

@@ -17,6 +17,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./lib/capability-layer"), exports);
 __exportStar(require("./lib/agent"), exports);
 __exportStar(require("./lib/agent-reach-tier"), exports);
+__exportStar(require("./lib/agent-session-lifecycle"), exports);
 __exportStar(require("./lib/agent-workspace-sharing"), exports);
 __exportStar(require("./lib/agent-limits-schema"), exports);
 __exportStar(require("./lib/agent-workspace-config"), exports);

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agent-composition/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAWA,yDAAuC;AACvC,8CAA4B;AAC5B,yDAAuC;AACvC,gEAA8C;AAC9C,4DAA0C;AAC1C,+DAA6C;AAC7C,wDAAsC;AACtC,2DAAyC;AACzC,gEAA8C"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agent-composition/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAWA,yDAAuC;AACvC,8CAA4B;AAC5B,yDAAuC;AACvC,gEAA8C;AAC9C,gEAA8C;AAC9C,4DAA0C;AAC1C,+DAA6C;AAC7C,wDAAsC;AACtC,2DAAyC;AACzC,gEAA8C"}

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

@@ -0,0 +1,7 @@
+import { z } from 'zod';
+export declare enum AgentSessionLifecycle {
+    Ephemeral = "ephemeral",
+    Persistent = "persistent"
+}
+export declare const AgentSessionLifecycleSchema: z.ZodEnum<typeof AgentSessionLifecycle>;
+//# sourceMappingURL=agent-session-lifecycle.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent-session-lifecycle.d.ts","sourceRoot":"","sources":["../../../src/agent-composition/lib/agent-session-lifecycle.ts"],"names":[],"mappings":"AAoBA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,oBAAY,qBAAqB;IAC/B,SAAS,cAAc;IACvB,UAAU,eAAe;CAC1B;AAGD,eAAO,MAAM,2BAA2B,yCAAsC,CAAC"}

package/dist/agent-composition/lib/agent-session-lifecycle.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentSessionLifecycleSchema = exports.AgentSessionLifecycle = void 0;
+const zod_1 = require("zod");
+var AgentSessionLifecycle;
+(function (AgentSessionLifecycle) {
+    AgentSessionLifecycle["Ephemeral"] = "ephemeral";
+    AgentSessionLifecycle["Persistent"] = "persistent";
+})(AgentSessionLifecycle || (exports.AgentSessionLifecycle = AgentSessionLifecycle = {}));
+exports.AgentSessionLifecycleSchema = zod_1.z.nativeEnum(AgentSessionLifecycle);
+//# sourceMappingURL=agent-session-lifecycle.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent-session-lifecycle.js","sourceRoot":"","sources":["../../../src/agent-composition/lib/agent-session-lifecycle.ts"],"names":[],"mappings":";;;AAoBA,6BAAwB;AAMxB,IAAY,qBAGX;AAHD,WAAY,qBAAqB;IAC/B,gDAAuB,CAAA;IACvB,kDAAyB,CAAA;AAC3B,CAAC,EAHW,qBAAqB,qCAArB,qBAAqB,QAGhC;AAGY,QAAA,2BAA2B,GAAG,OAAC,CAAC,UAAU,CAAC,qBAAqB,CAAC,CAAC"}

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

@@ -1,6 +1,6 @@
 {
   "$schema": "https://xema.dev/schemas/awp-spec.v1.json",
-  "emittedAt": "2026-06-29T09:35:56.778Z",
+  "emittedAt": "2026-07-01T10:48:07.595Z",
   "spec": {
     "id": "awp/v1",
     "version": "1.2.0",

package/package.json

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

@@ -12,6 +12,7 @@
 export * from './lib/capability-layer';
 export * from './lib/agent';
 export * from './lib/agent-reach-tier';
+export * from './lib/agent-session-lifecycle';
 export * from './lib/agent-workspace-sharing';
 export * from './lib/agent-limits-schema';
 export * from './lib/agent-workspace-config';

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

@@ -0,0 +1,33 @@
+// ═══════════════════════════════════════════════════════════════════════════
+// ── AgentSessionLifecycle — closed session-lifecycle enum ──
+//
+// The default session lifecycle an Agent definition DECLARES. Closed set,
+// value-identical to agent-session-api's `SessionLifecyclePolicy`
+// (`ephemeral` | `persistent`):
+//   • `ephemeral`  — a launched session idle-auto-pauses after the idle window.
+//   • `persistent` — a launched session is always-on (never idle-auto-paused).
+//
+// A launched session INHERITS this value as its `lifecyclePolicy` unless the
+// launch passes an explicit override. A NULL stored column means the agent
+// declares NO preference — agent-session-api then applies its own documented
+// `ephemeral` default (the sole, last-applied default). The agent-owning
+// service only OWNS + exposes the field; the idle/persistence behavior lives
+// in agent-session-api.
+//
+// This is the canonical kernel-shared enum; llm-registry-api and
+// agent-session-api consume it rather than mirroring their own copies.
+// ═══════════════════════════════════════════════════════════════════════════
+
+import { z } from 'zod';
+
+/**
+ * Default session lifecycle an Agent definition declares. Closed set,
+ * value-identical to agent-session-api's `SessionLifecyclePolicy`.
+ */
+export enum AgentSessionLifecycle {
+  Ephemeral = 'ephemeral',
+  Persistent = 'persistent',
+}
+
+/** Zod schema for {@link AgentSessionLifecycle}. Mirrors the sibling enum schemas. */
+export const AgentSessionLifecycleSchema = z.nativeEnum(AgentSessionLifecycle);