open-multi-agent-kit 0.97.0 → 0.98.0

package/dist/core/agent-session-snapshot.js

@@ -0,0 +1,111 @@
+/**
+ * Finalized-message snapshot contract.
+ *
+ * `SessionManager` persists replaced messages as JSON, so a replacement must be
+ * a plain value that survives a JSON round-trip and cannot mutate afterwards.
+ * Rather than letting a `Date`, a class instance, or a getter be silently
+ * flattened at write time, this module rejects it at replacement time and
+ * returns a deep-frozen deep clone.
+ */
+function snapshotContractError(reason) {
+    return new Error(`Finalized message replacement must be a plain serializable snapshot: ${reason}`);
+}
+/**
+ * Clone a finalized message replacement into the JSON-compatible snapshot
+ * persisted by SessionManager. Undefined remains allowed as ordinary optional
+ * message data: JSON omits object properties with undefined values and writes
+ * undefined array elements as null.
+ */
+function clonePlainSnapshot(value, ancestors = new WeakSet(), copies = new WeakMap()) {
+    if (value === null)
+        return value;
+    switch (typeof value) {
+        case "string":
+        case "boolean":
+        case "undefined":
+            return value;
+        case "number":
+            if (!Number.isFinite(value)) {
+                throw snapshotContractError("non-finite number values are not allowed");
+            }
+            return value;
+        case "bigint":
+            throw snapshotContractError("bigint values are not allowed");
+        case "function":
+        case "symbol":
+            throw snapshotContractError(`${typeof value} values are not allowed`);
+        case "object":
+            break;
+        default:
+            throw snapshotContractError(`${typeof value} values are not allowed`);
+    }
+    if (ancestors.has(value)) {
+        throw snapshotContractError("cyclic values are not allowed");
+    }
+    if (copies.has(value)) {
+        return copies.get(value);
+    }
+    ancestors.add(value);
+    try {
+        if (Array.isArray(value)) {
+            const copy = [];
+            copy.length = value.length;
+            copies.set(value, copy);
+            for (const key of Reflect.ownKeys(value)) {
+                if (key === "length")
+                    continue;
+                if (typeof key !== "string" || !/^(0|[1-9]\d*)$/.test(key) || Number(key) >= value.length) {
+                    throw snapshotContractError("arrays may only contain indexed values");
+                }
+                const descriptor = Object.getOwnPropertyDescriptor(value, key);
+                if (!descriptor || !("value" in descriptor) || !descriptor.enumerable) {
+                    throw snapshotContractError("accessor or non-enumerable properties are not allowed");
+                }
+                copy[Number(key)] = clonePlainSnapshot(descriptor.value, ancestors, copies);
+            }
+            return copy;
+        }
+        const prototype = Object.getPrototypeOf(value);
+        if (prototype !== Object.prototype && prototype !== null) {
+            throw snapshotContractError("non-plain objects are not allowed");
+        }
+        const copy = Object.create(prototype);
+        copies.set(value, copy);
+        for (const key of Reflect.ownKeys(value)) {
+            if (typeof key !== "string") {
+                throw snapshotContractError("symbol-keyed properties are not allowed");
+            }
+            const descriptor = Object.getOwnPropertyDescriptor(value, key);
+            if (!descriptor || !("value" in descriptor) || !descriptor.enumerable) {
+                throw snapshotContractError("accessor or non-enumerable properties are not allowed");
+            }
+            Object.defineProperty(copy, key, {
+                value: clonePlainSnapshot(descriptor.value, ancestors, copies),
+                enumerable: true,
+                configurable: true,
+                writable: true,
+            });
+        }
+        return copy;
+    }
+    finally {
+        ancestors.delete(value);
+    }
+}
+function freezeSnapshot(value, seen = new WeakSet()) {
+    if (value === null || typeof value !== "object" || seen.has(value))
+        return value;
+    seen.add(value);
+    for (const child of Object.values(value)) {
+        freezeSnapshot(child, seen);
+    }
+    return Object.freeze(value);
+}
+/**
+ * Deep-clone and deep-freeze a finalized message, throwing when the value does
+ * not satisfy the persistable-snapshot contract.
+ */
+export function createImmutableMessageSnapshot(message) {
+    return freezeSnapshot(clonePlainSnapshot(message));
+}
+//# sourceMappingURL=agent-session-snapshot.js.map

package/dist/core/agent-session-snapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-session-snapshot.js","sourceRoot":"","sources":["../../src/core/agent-session-snapshot.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Finalized-message snapshot contract.\n *\n * `SessionManager` persists replaced messages as JSON, so a replacement must be\n * a plain value that survives a JSON round-trip and cannot mutate afterwards.\n * Rather than letting a `Date`, a class instance, or a getter be silently\n * flattened at write time, this module rejects it at replacement time and\n * returns a deep-frozen deep clone.\n */\n\nimport type { AgentMessage } from \"omk-agent-core\";\n\nfunction snapshotContractError(reason: string): Error {\n\treturn new Error(`Finalized message replacement must be a plain serializable snapshot: ${reason}`);\n}\n\n/**\n * Clone a finalized message replacement into the JSON-compatible snapshot\n * persisted by SessionManager. Undefined remains allowed as ordinary optional\n * message data: JSON omits object properties with undefined values and writes\n * undefined array elements as null.\n */\nfunction clonePlainSnapshot(\n\tvalue: unknown,\n\tancestors = new WeakSet<object>(),\n\tcopies = new WeakMap<object, unknown>(),\n): unknown {\n\tif (value === null) return value;\n\n\tswitch (typeof value) {\n\t\tcase \"string\":\n\t\tcase \"boolean\":\n\t\tcase \"undefined\":\n\t\t\treturn value;\n\t\tcase \"number\":\n\t\t\tif (!Number.isFinite(value)) {\n\t\t\t\tthrow snapshotContractError(\"non-finite number values are not allowed\");\n\t\t\t}\n\t\t\treturn value;\n\t\tcase \"bigint\":\n\t\t\tthrow snapshotContractError(\"bigint values are not allowed\");\n\t\tcase \"function\":\n\t\tcase \"symbol\":\n\t\t\tthrow snapshotContractError(`${typeof value} values are not allowed`);\n\t\tcase \"object\":\n\t\t\tbreak;\n\t\tdefault:\n\t\t\tthrow snapshotContractError(`${typeof value} values are not allowed`);\n\t}\n\n\tif (ancestors.has(value)) {\n\t\tthrow snapshotContractError(\"cyclic values are not allowed\");\n\t}\n\tif (copies.has(value)) {\n\t\treturn copies.get(value);\n\t}\n\tancestors.add(value);\n\n\ttry {\n\t\tif (Array.isArray(value)) {\n\t\t\tconst copy: unknown[] = [];\n\t\t\tcopy.length = value.length;\n\t\t\tcopies.set(value, copy);\n\t\t\tfor (const key of Reflect.ownKeys(value)) {\n\t\t\t\tif (key === \"length\") continue;\n\t\t\t\tif (typeof key !== \"string\" || !/^(0|[1-9]\\d*)$/.test(key) || Number(key) >= value.length) {\n\t\t\t\t\tthrow snapshotContractError(\"arrays may only contain indexed values\");\n\t\t\t\t}\n\t\t\t\tconst descriptor = Object.getOwnPropertyDescriptor(value, key);\n\t\t\t\tif (!descriptor || !(\"value\" in descriptor) || !descriptor.enumerable) {\n\t\t\t\t\tthrow snapshotContractError(\"accessor or non-enumerable properties are not allowed\");\n\t\t\t\t}\n\t\t\t\tcopy[Number(key)] = clonePlainSnapshot(descriptor.value, ancestors, copies);\n\t\t\t}\n\t\t\treturn copy;\n\t\t}\n\n\t\tconst prototype = Object.getPrototypeOf(value);\n\t\tif (prototype !== Object.prototype && prototype !== null) {\n\t\t\tthrow snapshotContractError(\"non-plain objects are not allowed\");\n\t\t}\n\n\t\tconst copy = Object.create(prototype) as Record<string, unknown>;\n\t\tcopies.set(value, copy);\n\t\tfor (const key of Reflect.ownKeys(value)) {\n\t\t\tif (typeof key !== \"string\") {\n\t\t\t\tthrow snapshotContractError(\"symbol-keyed properties are not allowed\");\n\t\t\t}\n\t\t\tconst descriptor = Object.getOwnPropertyDescriptor(value, key);\n\t\t\tif (!descriptor || !(\"value\" in descriptor) || !descriptor.enumerable) {\n\t\t\t\tthrow snapshotContractError(\"accessor or non-enumerable properties are not allowed\");\n\t\t\t}\n\t\t\tObject.defineProperty(copy, key, {\n\t\t\t\tvalue: clonePlainSnapshot(descriptor.value, ancestors, copies),\n\t\t\t\tenumerable: true,\n\t\t\t\tconfigurable: true,\n\t\t\t\twritable: true,\n\t\t\t});\n\t\t}\n\t\treturn copy;\n\t} finally {\n\t\tancestors.delete(value);\n\t}\n}\n\nfunction freezeSnapshot<T>(value: T, seen = new WeakSet<object>()): T {\n\tif (value === null || typeof value !== \"object\" || seen.has(value)) return value;\n\tseen.add(value);\n\tfor (const child of Object.values(value as Record<string, unknown>)) {\n\t\tfreezeSnapshot(child, seen);\n\t}\n\treturn Object.freeze(value);\n}\n\n/**\n * Deep-clone and deep-freeze a finalized message, throwing when the value does\n * not satisfy the persistable-snapshot contract.\n */\nexport function createImmutableMessageSnapshot(message: AgentMessage): AgentMessage {\n\treturn freezeSnapshot(clonePlainSnapshot(message) as AgentMessage);\n}\n"]}

package/dist/core/agent-session.d.ts

@@ -24,7 +24,7 @@ import { type LoadoutAccessPolicy } from "./loadout-access-policy.ts";
 import { type McpServerConfig, type McpServerStatus } from "./mcp/manager.ts";
 import type { CustomMessage } from "./messages.ts";
 import type { ModelRegistry } from "./model-registry.ts";
-import { type PromptSettledEvent } from "./prompt-settlement.ts";
+import * as promptSettlement from "./prompt-settlement.ts";
 import { type PromptTemplate } from "./prompt-templates.ts";
 import { type ResourceAdmissionDecision } from "./resource-admission.ts";
 import type { ResourceLoader } from "./resource-loader.ts";
@@ -60,7 +60,7 @@ export type AgentSessionEvent = Exclude<AgentEvent, {
     type: "agent_end";
     messages: AgentMessage[];
     willRetry: boolean;
-} | PromptSettledEvent | {
+} | promptSettlement.PromptSettledEvent | {
     type: "queue_update";
     steering: readonly string[];
     followUp: readonly string[];
@@ -356,7 +356,7 @@ export declare class AgentSession {
     private _sessionRiskLevel;
     private _workspaceMutationCount;
     private _modelRegistry;
-    /** Lazy, in-memory only; never shared across sessions or persisted. */
+    /** Lazy provider: representations persist per workspace by default; plans stay session-memory-only. */
     private _contextBudgetCacheProvider;
     private _contextCacheInvalidationSnapshot;
     private _toolRegistry;
@@ -397,12 +397,8 @@ export declare class AgentSession {
     private _getVerifiedEvidenceExecutor;
     /** Append one required durable audit record. Persistence failures propagate. */
     private _appendRunJournalAudit;
-    private _terminationMessage;
-    private _providerFailureCause;
-    private _classifyPreflightCause;
     private _classifyRunTermination;
     private _publishTermination;
-    private _runtimeFailureCause;
     private _publishRuntimeFailure;
     private _handleRunLifecycleEvent;
     /**
@@ -749,8 +745,8 @@ export declare class AgentSession {
     /**
      * Context-pressure band 0..3 from the projected token estimate over the
      * model context window (reuses estimateProjectedContextTokens). 0..<0.5,
-     * 1..<0.75, 2..<0.9, 3..>=0.9. Inert under DEFAULT_WEIGHTS (no pressure
-     * coefficient); computed for future calibrated weight presets.
+     * 1..<0.75, 2..<0.9, 3..>=0.9. The released default pressure coefficient
+     * is 1 and participates only after the classifier has prompt evidence.
      */
     private _computePressureBucket;
     /**