@kontextmind/kxm 0.7.40 → 0.7.44

package/plugins/kxm/src/restricted-yaml.d.mts

@@ -1,7 +1,7 @@
 export type JsonValue = null | boolean | number | string | JsonValue[] | { [key: string]: JsonValue };
 export type JsonObject = { [key: string]: JsonValue };
 
-export interface VnextYamlLimits {
+export interface KxmYamlLimits {
   maxDocumentBytes: number;
   maxDepth: number;
   maxScalarBytes: number;
@@ -10,7 +10,7 @@ export interface VnextYamlLimits {
   maxKeys: number;
 }
 
-export const VNEXT_YAML_LIMITS: Readonly<VnextYamlLimits>;
+export const KXM_YAML_LIMITS: Readonly<KxmYamlLimits>;
 
 export interface RestrictedYamlIssue {
   phase: "parse";
@@ -27,5 +27,5 @@ export class RestrictedYamlError extends Error {
 export function parseRestrictedYaml(
   input: string | Uint8Array,
   label?: string,
-  limits?: Readonly<VnextYamlLimits>,
+  limits?: Readonly<KxmYamlLimits>,
 ): JsonObject;

package/plugins/kxm/src/restricted-yaml.mjs

@@ -1,7 +1,7 @@
 import { isAlias, isCollection, isMap, isScalar, parseDocument, visit } from "yaml";
 
-/** Restricted JSON-compatible YAML limits used by vNext configuration. */
-export const VNEXT_YAML_LIMITS = Object.freeze({
+/** Restricted JSON-compatible YAML limits used by KXM configuration. */
+export const KXM_YAML_LIMITS = Object.freeze({
   maxDocumentBytes: 256 * 1024,
   maxDepth: 32,
   maxScalarBytes: 64 * 1024,
@@ -85,11 +85,11 @@ function assertJsonValue(value, label, path = "$", seen = new Set()) {
   seen.delete(value);
 }
 
-/** Parse the restricted, JSON-compatible YAML profile used by all vNext configuration. */
+/** Parse the restricted, JSON-compatible YAML profile used by all KXM configuration. */
 export function parseRestrictedYaml(
   input,
   label = "<yaml>",
-  limits = VNEXT_YAML_LIMITS,
+  limits = KXM_YAML_LIMITS,
 ) {
   const byteLength = typeof input === "string" ? Buffer.byteLength(input, "utf8") : input.byteLength;
   if (byteLength > limits.maxDocumentBytes) {

package/plugins/kxm/src/{vnext-runtime-owner.ts → runtime-owner.ts}

@@ -1,12 +1,12 @@
 import { randomUUID } from "node:crypto";
-import { runtimeError } from "./vnext-runtime-store.ts";
+import { runtimeError } from "./runtime-store.ts";
 
-export interface VnextOwnedAttempt {
+export interface KxmOwnedAttempt {
   attemptId: string;
   controller: AbortController;
 }
 
-export interface VnextGateHoldView {
+export interface KxmGateHoldView {
   attemptId: string;
   token: string;
   state: "active" | "unsettled";
@@ -19,7 +19,7 @@ interface GateHold {
   stop?: () => void;
 }
 
-export interface VnextDriveSession {
+export interface KxmDriveSession {
   driveId: string;
   runId: string;
   token: string;
@@ -36,7 +36,7 @@ interface AdmissionRecord {
   token: string;
   configRevision: string;
   gateHold?: GateHold;
-  driveSession?: VnextDriveSession;
+  driveSession?: KxmDriveSession;
 }
 
 interface QueueItem {
@@ -58,7 +58,7 @@ interface OwnerRecord {
   implicit?: OwnerPolicy;
   admitted: Map<string, AdmissionRecord>;
   queue: QueueItem[];
-  attempts: Map<string, Map<string, VnextOwnedAttempt>>;
+  attempts: Map<string, Map<string, KxmOwnedAttempt>>;
 }
 
 const owners = new Map<string, OwnerRecord>();
@@ -92,22 +92,22 @@ function clearImplicitIfIdle(owner: OwnerRecord): void {
   }
 }
 
-export function registerVnextRuntimeHandle(storePath: string): void {
+export function registerKxmRuntimeHandle(storePath: string): void {
   record(storePath).handles += 1;
 }
 
-export function unregisterVnextRuntimeHandle(storePath: string): void {
+export function unregisterKxmRuntimeHandle(storePath: string): void {
   const owner = owners.get(storePath);
   if (!owner) return;
   owner.handles = Math.max(0, owner.handles - 1);
   maybeDelete(storePath, owner);
 }
 
-export function vnextRuntimeHandleCount(storePath: string): number {
+export function kxmRuntimeHandleCount(storePath: string): number {
   return owners.get(storePath)?.handles ?? 0;
 }
 
-export function registerVnextAttemptController(storePath: string, runId: string, attempt: VnextOwnedAttempt): void {
+export function registerKxmAttemptController(storePath: string, runId: string, attempt: KxmOwnedAttempt): void {
   const owner = record(storePath);
   let runAttempts = owner.attempts.get(runId);
   if (!runAttempts) {
@@ -120,17 +120,17 @@ export function registerVnextAttemptController(storePath: string, runId: string,
   runAttempts.set(attempt.attemptId, attempt);
 }
 
-export function vnextAttemptController(storePath: string, runId: string, attemptId: string): VnextOwnedAttempt | undefined {
+export function kxmAttemptController(storePath: string, runId: string, attemptId: string): KxmOwnedAttempt | undefined {
   return owners.get(storePath)?.attempts.get(runId)?.get(attemptId);
 }
 
-export function vnextAttemptControllers(storePath: string, runId: string): VnextOwnedAttempt[] {
+export function kxmAttemptControllers(storePath: string, runId: string): KxmOwnedAttempt[] {
   const runAttempts = owners.get(storePath)?.attempts.get(runId);
   if (!runAttempts) return [];
   return [...runAttempts.values()];
 }
 
-export function unregisterVnextAttemptController(storePath: string, runId: string, attemptId: string): void {
+export function unregisterKxmAttemptController(storePath: string, runId: string, attemptId: string): void {
   const owner = owners.get(storePath);
   if (!owner) return;
   const runAttempts = owner.attempts.get(runId);
@@ -141,7 +141,7 @@ export function unregisterVnextAttemptController(storePath: string, runId: strin
   maybeDelete(storePath, owner);
 }
 
-export function bindVnextSchedulerPolicy(storePath: string, bound: number, configRevision: string): void {
+export function bindKxmSchedulerPolicy(storePath: string, bound: number, configRevision: string): void {
   const owner = record(storePath);
   const current = activePolicy(owner);
   if (current && (current.configRevision !== configRevision || current.bound !== bound)) {
@@ -153,11 +153,11 @@ export function bindVnextSchedulerPolicy(storePath: string, bound: number, confi
   delete owner.implicit;
 }
 
-export function vnextSchedulerPolicy(storePath: string): OwnerPolicy | undefined {
+export function kxmSchedulerPolicy(storePath: string): OwnerPolicy | undefined {
   return owners.get(storePath)?.scheduler;
 }
 
-export function admitVnextRun(
+export function admitKxmRun(
   storePath: string,
   runId: string,
   envelopeRevision: string,
@@ -190,7 +190,7 @@ export function admitVnextRun(
   return token;
 }
 
-export function releaseVnextRun(storePath: string, runId: string, token: string): void {
+export function releaseKxmRun(storePath: string, runId: string, token: string): void {
   const owner = owners.get(storePath);
   if (!owner) return;
   const current = owner.admitted.get(runId);
@@ -202,7 +202,7 @@ export function releaseVnextRun(storePath: string, runId: string, token: string)
   maybeDelete(storePath, owner);
 }
 
-export function armVnextGateHold(
+export function armKxmGateHold(
   storePath: string,
   runId: string,
   token: string,
@@ -220,7 +220,7 @@ export function armVnextGateHold(
   current.gateHold = { attemptId, token, state: "active", stop };
 }
 
-export function markVnextGateHoldUnsettled(storePath: string, runId: string, token: string, attemptId: string): void {
+export function markKxmGateHoldUnsettled(storePath: string, runId: string, token: string, attemptId: string): void {
   const owner = owners.get(storePath);
   const current = owner?.admitted.get(runId);
   if (!current || current.token !== token) {
@@ -233,7 +233,7 @@ export function markVnextGateHoldUnsettled(storePath: string, runId: string, tok
   hold.state = "unsettled";
 }
 
-export function finishVnextOwnedGate(storePath: string, runId: string, token: string, attemptId: string): void {
+export function finishKxmOwnedGate(storePath: string, runId: string, token: string, attemptId: string): void {
   const owner = owners.get(storePath);
   const current = owner?.admitted.get(runId);
   if (!current || current.token !== token) {
@@ -249,13 +249,13 @@ export function finishVnextOwnedGate(storePath: string, runId: string, token: st
   delete current.gateHold;
 }
 
-export function dropVnextGateStopHook(storePath: string, runId: string, attemptId: string): void {
+export function dropKxmGateStopHook(storePath: string, runId: string, attemptId: string): void {
   const hold = owners.get(storePath)?.admitted.get(runId)?.gateHold;
   if (!hold || hold.attemptId !== attemptId) return;
   delete hold.stop;
 }
 
-export function resolveVnextGateHold(storePath: string, runId: string, attemptId: string): void {
+export function resolveKxmGateHold(storePath: string, runId: string, attemptId: string): void {
   const owner = owners.get(storePath);
   if (!owner) return;
   const current = owner.admitted.get(runId);
@@ -274,21 +274,21 @@ export function resolveVnextGateHold(storePath: string, runId: string, attemptId
   maybeDelete(storePath, owner);
 }
 
-export function vnextGateHold(storePath: string, runId: string): VnextGateHoldView | undefined {
+export function kxmGateHold(storePath: string, runId: string): KxmGateHoldView | undefined {
   const hold = owners.get(storePath)?.admitted.get(runId)?.gateHold;
   if (!hold) return undefined;
   return { attemptId: hold.attemptId, token: hold.token, state: hold.state };
 }
 
-export function vnextAdmittedToken(storePath: string, runId: string): string | undefined {
+export function kxmAdmittedToken(storePath: string, runId: string): string | undefined {
   return owners.get(storePath)?.admitted.get(runId)?.token;
 }
 
-export function attachVnextDriveSession(
+export function attachKxmDriveSession(
   storePath: string,
   runId: string,
   token: string,
-  session: VnextDriveSession,
+  session: KxmDriveSession,
 ): void {
   const owner = record(storePath);
   const current = owner.admitted.get(runId);
@@ -301,28 +301,28 @@ export function attachVnextDriveSession(
   current.driveSession = session;
 }
 
-export function clearVnextDriveSession(storePath: string, runId: string, token: string): void {
+export function clearKxmDriveSession(storePath: string, runId: string, token: string): void {
   const owner = owners.get(storePath);
   const current = owner?.admitted.get(runId);
   if (!current || current.token !== token) return;
   delete current.driveSession;
 }
 
-export function vnextDriveSession(storePath: string, runId: string): VnextDriveSession | undefined {
+export function kxmDriveSession(storePath: string, runId: string): KxmDriveSession | undefined {
   return owners.get(storePath)?.admitted.get(runId)?.driveSession;
 }
 
-export function vnextOpenDriveSessions(storePath: string): VnextDriveSession[] {
+export function kxmOpenDriveSessions(storePath: string): KxmDriveSession[] {
   const owner = owners.get(storePath);
   if (!owner) return [];
-  const sessions: VnextDriveSession[] = [];
+  const sessions: KxmDriveSession[] = [];
   for (const current of owner.admitted.values()) {
     if (current.driveSession) sessions.push(current.driveSession);
   }
   return sessions;
 }
 
-export function enqueueVnextScheduledRun(
+export function enqueueKxmScheduledRun(
   storePath: string,
   runId: string,
   configRevision: string,
@@ -345,11 +345,11 @@ export function enqueueVnextScheduledRun(
   });
 }
 
-export function vnextActiveScheduledRuns(storePath: string): number {
+export function kxmActiveScheduledRuns(storePath: string): number {
   return owners.get(storePath)?.admitted.size ?? 0;
 }
 
-export function vnextQueuedScheduledRuns(storePath: string): number {
+export function kxmQueuedScheduledRuns(storePath: string): number {
   return owners.get(storePath)?.queue.length ?? 0;
 }
 
@@ -360,13 +360,13 @@ function pump(storePath: string, owner: OwnerRecord): void {
     if (!next) break;
     let token: string;
     try {
-      token = admitVnextRun(storePath, next.runId, next.configRevision, next.bound);
+      token = admitKxmRun(storePath, next.runId, next.configRevision, next.bound);
     } catch (error) {
       next.fail(error);
       continue;
     }
     void next.start(token).finally(() => {
-      releaseVnextRun(storePath, next.runId, token);
+      releaseKxmRun(storePath, next.runId, token);
     });
   }
 }