@xemahq/agent-session-runtime 0.7.0 → 0.9.0

package/dist/lib/launch-identity/prepared-launch-variant.js

@@ -0,0 +1,118 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PreparedLaunchVariantStatus = void 0;
+exports.createPreparedLaunchVariantKey = createPreparedLaunchVariantKey;
+exports.serializePreparedLaunchVariantKey = serializePreparedLaunchVariantKey;
+exports.hashPreparedLaunchVariantKey = hashPreparedLaunchVariantKey;
+exports.createPreparedLaunchVariant = createPreparedLaunchVariant;
+exports.serializePreparedLaunchVariant = serializePreparedLaunchVariant;
+exports.hashPreparedLaunchVariant = hashPreparedLaunchVariant;
+const worker_runtime_1 = require("@xemahq/kernel-contracts/worker-runtime");
+const canonical_contract_1 = require("./canonical-contract");
+const preparation_generation_1 = require("./preparation-generation");
+const runtime_template_key_1 = require("./runtime-template-key");
+var PreparedLaunchVariantStatus;
+(function (PreparedLaunchVariantStatus) {
+    PreparedLaunchVariantStatus["Materializing"] = "materializing";
+    PreparedLaunchVariantStatus["Ready"] = "ready";
+    PreparedLaunchVariantStatus["Failed"] = "failed";
+    PreparedLaunchVariantStatus["Retired"] = "retired";
+})(PreparedLaunchVariantStatus || (exports.PreparedLaunchVariantStatus = PreparedLaunchVariantStatus = {}));
+const KEY_KEYS = [
+    'schemaVersion',
+    'runtimeKind',
+    'runtimeRevision',
+    'imageDigest',
+    'layoutProfileRef',
+    'staticDependencyClosureHash',
+    'tenantDependency',
+    'trustPolicy',
+    'policyGenerationHash',
+    'region',
+];
+const VARIANT_KEYS = [
+    'id',
+    'preparationGenerationId',
+    'key',
+    'keyHash',
+    'compiledLaunchPlanHash',
+    'preparedRuntimeTemplateHash',
+    'preparedRuntimeTemplateRef',
+    'status',
+    'rowVersion',
+];
+const VARIANT_OPTIONAL_KEYS = ['failure'];
+const RUNTIME_KINDS = Object.values(worker_runtime_1.WorkerRuntimeKind);
+const TENANT_DEPENDENCY_KINDS = Object.values(runtime_template_key_1.RuntimeTemplateTenantDependency);
+const TRUST_POLICIES = Object.values(runtime_template_key_1.RuntimeTemplateTrustPolicy);
+const VARIANT_STATUSES = Object.values(PreparedLaunchVariantStatus);
+function createPreparedLaunchVariantKey(input) {
+    const object = (0, canonical_contract_1.requireExactObject)(input, 'PreparedLaunchVariantKey', KEY_KEYS);
+    if (object.schemaVersion !== 1) {
+        throw new TypeError('PreparedLaunchVariantKey.schemaVersion must be 1.');
+    }
+    return Object.freeze({
+        schemaVersion: 1,
+        runtimeKind: (0, canonical_contract_1.requireEnumValue)(object.runtimeKind, 'PreparedLaunchVariantKey.runtimeKind', RUNTIME_KINDS),
+        runtimeRevision: (0, canonical_contract_1.requireNonEmptyString)(object.runtimeRevision, 'PreparedLaunchVariantKey.runtimeRevision'),
+        imageDigest: (0, canonical_contract_1.requireImageDigest)(object.imageDigest, 'PreparedLaunchVariantKey.imageDigest'),
+        layoutProfileRef: (0, canonical_contract_1.requireNonEmptyString)(object.layoutProfileRef, 'PreparedLaunchVariantKey.layoutProfileRef'),
+        staticDependencyClosureHash: (0, canonical_contract_1.requireSha256)(object.staticDependencyClosureHash, 'PreparedLaunchVariantKey.staticDependencyClosureHash'),
+        tenantDependency: requireTenantDependency(object.tenantDependency),
+        trustPolicy: (0, canonical_contract_1.requireEnumValue)(object.trustPolicy, 'PreparedLaunchVariantKey.trustPolicy', TRUST_POLICIES),
+        policyGenerationHash: (0, canonical_contract_1.requireSha256)(object.policyGenerationHash, 'PreparedLaunchVariantKey.policyGenerationHash'),
+        region: (0, canonical_contract_1.requireNonEmptyString)(object.region, 'PreparedLaunchVariantKey.region'),
+    });
+}
+function serializePreparedLaunchVariantKey(input) {
+    return (0, canonical_contract_1.canonicalContractJson)(createPreparedLaunchVariantKey(input));
+}
+function hashPreparedLaunchVariantKey(input) {
+    return (0, canonical_contract_1.hashCanonicalContract)(createPreparedLaunchVariantKey(input));
+}
+function createPreparedLaunchVariant(input) {
+    const object = (0, canonical_contract_1.requireExactObject)(input, 'PreparedLaunchVariant', VARIANT_KEYS, VARIANT_OPTIONAL_KEYS);
+    const key = createPreparedLaunchVariantKey(object.key);
+    const keyHash = (0, canonical_contract_1.requireSha256)(object.keyHash, 'PreparedLaunchVariant.keyHash');
+    if (keyHash !== hashPreparedLaunchVariantKey(key)) {
+        throw new TypeError('PreparedLaunchVariant.keyHash must equal the canonical key hash.');
+    }
+    const status = (0, canonical_contract_1.requireEnumValue)(object.status, 'PreparedLaunchVariant.status', VARIANT_STATUSES);
+    const failure = (0, preparation_generation_1.requirePreparationFailureForStatus)(object.failure, Object.hasOwn(object, 'failure'), status === PreparedLaunchVariantStatus.Failed, 'PreparedLaunchVariant');
+    return Object.freeze({
+        id: (0, canonical_contract_1.requireNonEmptyString)(object.id, 'PreparedLaunchVariant.id'),
+        preparationGenerationId: (0, canonical_contract_1.requireNonEmptyString)(object.preparationGenerationId, 'PreparedLaunchVariant.preparationGenerationId'),
+        key,
+        keyHash,
+        compiledLaunchPlanHash: (0, canonical_contract_1.requireSha256)(object.compiledLaunchPlanHash, 'PreparedLaunchVariant.compiledLaunchPlanHash'),
+        preparedRuntimeTemplateHash: (0, canonical_contract_1.requireSha256)(object.preparedRuntimeTemplateHash, 'PreparedLaunchVariant.preparedRuntimeTemplateHash'),
+        preparedRuntimeTemplateRef: (0, canonical_contract_1.requireNonEmptyString)(object.preparedRuntimeTemplateRef, 'PreparedLaunchVariant.preparedRuntimeTemplateRef'),
+        status,
+        ...(failure === undefined ? {} : { failure }),
+        rowVersion: (0, canonical_contract_1.requireNonNegativeSafeInteger)(object.rowVersion, 'PreparedLaunchVariant.rowVersion'),
+    });
+}
+function serializePreparedLaunchVariant(input) {
+    return (0, canonical_contract_1.canonicalContractJson)(createPreparedLaunchVariant(input));
+}
+function hashPreparedLaunchVariant(input) {
+    return (0, canonical_contract_1.hashCanonicalContract)(createPreparedLaunchVariant(input));
+}
+function requireTenantDependency(input) {
+    const base = (0, canonical_contract_1.requireExactObject)(input, 'PreparedLaunchVariantKey.tenantDependency', ['kind'], ['organizationScopeHash']);
+    const kind = (0, canonical_contract_1.requireEnumValue)(base.kind, 'PreparedLaunchVariantKey.tenantDependency.kind', TENANT_DEPENDENCY_KINDS);
+    if (kind === runtime_template_key_1.RuntimeTemplateTenantDependency.OrganizationNeutral) {
+        if (Object.hasOwn(base, 'organizationScopeHash')) {
+            throw new TypeError('PreparedLaunchVariantKey.tenantDependency.organizationScopeHash is forbidden for organization-neutral variants.');
+        }
+        return Object.freeze({ kind });
+    }
+    if (!Object.hasOwn(base, 'organizationScopeHash')) {
+        throw new TypeError('PreparedLaunchVariantKey.tenantDependency.organizationScopeHash is required for organization-bound variants.');
+    }
+    return Object.freeze({
+        kind,
+        organizationScopeHash: (0, canonical_contract_1.requireSha256)(base.organizationScopeHash, 'PreparedLaunchVariantKey.tenantDependency.organizationScopeHash'),
+    });
+}
+//# sourceMappingURL=prepared-launch-variant.js.map

package/dist/lib/launch-identity/prepared-launch-variant.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prepared-launch-variant.js","sourceRoot":"","sources":["../../../src/lib/launch-identity/prepared-launch-variant.ts"],"names":[],"mappings":"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"}

package/dist/lib/launch-identity/runtime-template-key.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime-template-key.d.ts","sourceRoot":"","sources":["../../../src/lib/launch-identity/runtime-template-key.ts"],"names":[],"mappings":"AAUA,oBAAY,+BAA+B;IACzC,mBAAmB,yBAAyB;IAC5C,iBAAiB,uBAAuB;CACzC;AAED,oBAAY,0BAA0B;IACpC,MAAM,WAAW;IACjB,SAAS,cAAc;IACvB,YAAY,iBAAiB;CAC9B;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,aAAa,EAAE,CAAC,CAAC;IAC1B,QAAQ,CAAC,gBAAgB,EAAE,+BAA+B,CAAC;IAC3D,QAAQ,CAAC,WAAW,EAAE,0BAA0B,CAAC;IACjD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,yBAAyB,EAAE,MAAM,CAAC;IAC3C,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AA6BD,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,kBAAkB,CAyE3E;AAED,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,kBAAkB,GAAG,MAAM,CAE7E;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,kBAAkB,GAAG,MAAM,CAExE"}
+{"version":3,"file":"runtime-template-key.d.ts","sourceRoot":"","sources":["../../../src/lib/launch-identity/runtime-template-key.ts"],"names":[],"mappings":"AAWA,oBAAY,+BAA+B;IACzC,mBAAmB,yBAAyB;IAC5C,iBAAiB,uBAAuB;CACzC;AAED,oBAAY,0BAA0B;IACpC,MAAM,WAAW;IACjB,SAAS,cAAc;IACvB,YAAY,iBAAiB;CAC9B;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,aAAa,EAAE,CAAC,CAAC;IAC1B,QAAQ,CAAC,gBAAgB,EAAE,+BAA+B,CAAC;IAC3D,QAAQ,CAAC,WAAW,EAAE,0BAA0B,CAAC;IACjD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,yBAAyB,EAAE,MAAM,CAAC;IAC3C,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AA4BD,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,kBAAkB,CAoE3E;AAED,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,kBAAkB,GAAG,MAAM,CAE7E;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,kBAAkB,GAAG,MAAM,CAExE"}

package/dist/lib/launch-identity/runtime-template-key.js

@@ -35,17 +35,13 @@ const REQUIRED_KEYS = [
 ];
 const TENANT_DEPENDENCIES = Object.values(RuntimeTemplateTenantDependency);
 const TRUST_POLICIES = Object.values(RuntimeTemplateTrustPolicy);
-const IMAGE_DIGEST_PATTERN = /^sha256:[a-f0-9]{64}$/u;
 function createRuntimeTemplateKey(input) {
     (0, canonical_contract_1.assertNoTenantOrSecretTemplateFields)(input, 'RuntimeTemplateKey');
     const object = (0, canonical_contract_1.requireExactObject)(input, 'RuntimeTemplateKey', REQUIRED_KEYS);
     if (object.schemaVersion !== 1) {
         throw new TypeError('RuntimeTemplateKey.schemaVersion must be 1.');
     }
-    const imageDigest = (0, canonical_contract_1.requireNonEmptyString)(object.imageDigest, 'RuntimeTemplateKey.imageDigest');
-    if (!IMAGE_DIGEST_PATTERN.test(imageDigest)) {
-        throw new TypeError('RuntimeTemplateKey.imageDigest must be an immutable sha256 image digest.');
-    }
+    const imageDigest = (0, canonical_contract_1.requireImageDigest)(object.imageDigest, 'RuntimeTemplateKey.imageDigest');
     return Object.freeze({
         schemaVersion: 1,
         tenantDependency: (0, canonical_contract_1.requireEnumValue)(object.tenantDependency, 'RuntimeTemplateKey.tenantDependency', TENANT_DEPENDENCIES),

package/dist/lib/launch-identity/runtime-template-key.js.map

@@ -1 +1 @@
-{"version":3,"file":"runtime-template-key.js","sourceRoot":"","sources":["../../../src/lib/launch-identity/runtime-template-key.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"runtime-template-key.js","sourceRoot":"","sources":["../../../src/lib/launch-identity/runtime-template-key.ts"],"names":[],"mappings":";;;AAkEA,4DAoEC;AAED,kEAEC;AAED,wDAEC;AA9ID,6DAS8B;AAE9B,IAAY,+BAGX;AAHD,WAAY,+BAA+B;IACzC,+EAA4C,CAAA;IAC5C,2EAAwC,CAAA;AAC1C,CAAC,EAHW,+BAA+B,+CAA/B,+BAA+B,QAG1C;AAED,IAAY,0BAIX;AAJD,WAAY,0BAA0B;IACpC,+CAAiB,CAAA;IACjB,qDAAuB,CAAA;IACvB,2DAA6B,CAAA;AAC/B,CAAC,EAJW,0BAA0B,0CAA1B,0BAA0B,QAIrC;AAoBD,MAAM,aAAa,GAAG;IACpB,eAAe;IACf,kBAAkB;IAClB,aAAa;IACb,YAAY;IACZ,iBAAiB;IACjB,aAAa;IACb,eAAe;IACf,kBAAkB;IAClB,eAAe;IACf,YAAY;IACZ,WAAW;IACX,2BAA2B;IAC3B,oBAAoB;IACpB,mBAAmB;IACnB,eAAe;CACP,CAAC;AAEX,MAAM,mBAAmB,GAAG,MAAM,CAAC,MAAM,CAAC,+BAA+B,CAAC,CAAC;AAC3E,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,CAAC,0BAA0B,CAAC,CAAC;AAOjE,SAAgB,wBAAwB,CAAC,KAAc;IACrD,IAAA,yDAAoC,EAAC,KAAK,EAAE,oBAAoB,CAAC,CAAC;IAClE,MAAM,MAAM,GAAG,IAAA,uCAAkB,EAAC,KAAK,EAAE,oBAAoB,EAAE,aAAa,CAAC,CAAC;IAE9E,IAAI,MAAM,CAAC,aAAa,KAAK,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,SAAS,CAAC,6CAA6C,CAAC,CAAC;IACrE,CAAC;IAED,MAAM,WAAW,GAAG,IAAA,uCAAkB,EACpC,MAAM,CAAC,WAAW,EAClB,gCAAgC,CACjC,CAAC;IAEF,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,aAAa,EAAE,CAAC;QAChB,gBAAgB,EAAE,IAAA,qCAAgB,EAChC,MAAM,CAAC,gBAAgB,EACvB,qCAAqC,EACrC,mBAAmB,CACpB;QACD,WAAW,EAAE,IAAA,qCAAgB,EAC3B,MAAM,CAAC,WAAW,EAClB,gCAAgC,EAChC,cAAc,CACf;QACD,UAAU,EAAE,IAAA,0CAAqB,EAC/B,MAAM,CAAC,UAAU,EACjB,+BAA+B,CAChC;QACD,eAAe,EAAE,IAAA,0CAAqB,EACpC,MAAM,CAAC,eAAe,EACtB,oCAAoC,CACrC;QACD,WAAW;QACX,aAAa,EAAE,IAAA,0CAAqB,EAClC,MAAM,CAAC,aAAa,EACpB,kCAAkC,CACnC;QACD,gBAAgB,EAAE,IAAA,kCAAa,EAC7B,MAAM,CAAC,gBAAgB,EACvB,qCAAqC,CACtC;QACD,aAAa,EAAE,IAAA,kCAAa,EAC1B,MAAM,CAAC,aAAa,EACpB,kCAAkC,CACnC;QACD,UAAU,EAAE,IAAA,kCAAa,EACvB,MAAM,CAAC,UAAU,EACjB,+BAA+B,CAChC;QACD,SAAS,EAAE,IAAA,kCAAa,EAAC,MAAM,CAAC,SAAS,EAAE,8BAA8B,CAAC;QAC1E,yBAAyB,EAAE,IAAA,kCAAa,EACtC,MAAM,CAAC,yBAAyB,EAChC,8CAA8C,CAC/C;QACD,kBAAkB,EAAE,IAAA,kCAAa,EAC/B,MAAM,CAAC,kBAAkB,EACzB,uCAAuC,CACxC;QACD,iBAAiB,EAAE,IAAA,kCAAa,EAC9B,MAAM,CAAC,iBAAiB,EACxB,sCAAsC,CACvC;QACD,aAAa,EAAE,IAAA,0CAAqB,EAClC,MAAM,CAAC,aAAa,EACpB,kCAAkC,CACnC;KACF,CAAC,CAAC;AACL,CAAC;AAED,SAAgB,2BAA2B,CAAC,KAAyB;IACnE,OAAO,IAAA,0CAAqB,EAAC,wBAAwB,CAAC,KAAK,CAAC,CAAC,CAAC;AAChE,CAAC;AAED,SAAgB,sBAAsB,CAAC,KAAyB;IAC9D,OAAO,IAAA,0CAAqB,EAAC,wBAAwB,CAAC,KAAK,CAAC,CAAC,CAAC;AAChE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xemahq/agent-session-runtime",
-  "version": "0.7.0",
+  "version": "0.9.0",
   "description": "Runtime for composing and running Xema agent sessions — workspace manifests, skill bundles, environment resolution, and drift detection.",
   "license": "Apache-2.0",
   "author": "Neuralchowder Inc. <developer@xema.dev> (https://xema.dev)",
@@ -38,28 +38,29 @@
     "dist",
     "src"
   ],
-  "devDependencies": {
-    "@types/jest": "^30.0.0",
-    "@types/node": "25.2.3",
-    "jest": "^30.3.0",
-    "prettier": "3.6.2",
-    "ts-jest": "^29.4.9",
-    "typescript": "5.9.3",
-    "@xemahq/kernel-contracts": "^0.60.0"
-  },
-  "dependencies": {
-    "@xemahq/declarative-reconciler": "^0.1.1",
-    "@xemahq/dsl": "^0.6.1",
-    "@xemahq/kernel-contracts": "^0.60.0"
-  },
-  "peerDependencies": {
-    "@xemahq/kernel-contracts": ">=0.13.0"
-  },
   "scripts": {
     "clean": "rm -rf dist",
-    "build": "tsc -p tsconfig.json",
+    "build": "tsc -p tsconfig.build.json",
     "format": "prettier --write \"src/**/*.ts\"",
     "test": "jest --config jest.config.ts",
     "typecheck": "tsc -p tsconfig.json --noEmit"
+  },
+  "devDependencies": {
+    "@types/jest": "catalog:",
+    "@types/node": "catalog:",
+    "jest": "catalog:",
+    "prettier": "catalog:",
+    "ts-jest": "catalog:",
+    "typescript": "catalog:",
+    "@xemahq/dsl": "catalog:",
+    "@xemahq/kernel-contracts": "catalog:"
+  },
+  "dependencies": {
+    "@xemahq/declarative-reconciler": "workspace:^0.1.1",
+    "@xemahq/kernel-contracts": "catalog:"
+  },
+  "peerDependencies": {
+    "@xemahq/dsl": ">=0.6.1",
+    "@xemahq/kernel-contracts": "^5.0.0"
   }
-}
+}

package/src/lib/agent-resolution.ts

@@ -97,10 +97,21 @@ export interface RuntimeAgentConfig {
   /** Root instructions (+ overlay), normalized; `null` when none. */
   readonly primaryInstructions: string | null;
   /**
-   * How `primaryInstructions` combine with the base kernel's `systemPrompt`
-   * (the root node's `promptMode`). `null` ⇒ Append (back-compat). `Replace`
-   * makes `primaryInstructions` the system prompt; the base kernel prompt body
-   * is dropped (config still inherited). The session overlay always appends.
+   * The root node's `promptMode`, carried VERBATIM — `null` means the node
+   * DECLARED none, not "defaulted to something here".
+   *
+   * `NodeOverlayFragment.promptMode` is optional in the kernel contract, so an
+   * absent mode is a legal, meaningful state and this projection does NOT
+   * resolve it: every consumer spreads the field conditionally
+   * (`...(primaryPromptMode ? { promptMode } : {})`), so `null` propagates as
+   * "field omitted" and the closed-set default is applied ONCE, at the point
+   * that materializes the prompt. Restating the default rule here would be a
+   * second source of truth for it; fail-fast would be wrong because "omitted"
+   * is contractually valid.
+   *
+   * `Replace` makes `primaryInstructions` the system prompt; the base agent
+   * prompt body is dropped (config still inherited). The session overlay
+   * always appends.
    */
   readonly primaryPromptMode: PromptMergeMode | null;
   /** Root permission (+ overlay); `null` when none. */