@framers/agentos 0.10.38 → 0.10.40

package/dist/cognition/substrate/reasoningTraceLimits.js

@@ -0,0 +1,105 @@
+/** Entries kept when neither the persona nor the runtime sets a limit. */
+export const DEFAULT_REASONING_TRACE_MAX_ENTRIES = 500;
+/** Characters kept per entry message when neither the persona nor the runtime sets a limit. */
+export const DEFAULT_REASONING_TRACE_MAX_MESSAGE_LENGTH = 1000;
+/**
+ * Smallest entry cap applied. The self-reflection metaprompt reads the last 20
+ * entries and error detection the last 10, so a lower setting is raised to it.
+ */
+export const REASONING_TRACE_MIN_ENTRIES = 20;
+/** Largest entry cap accepted; higher settings are clamped to it. */
+export const REASONING_TRACE_MAX_ENTRIES_CEILING = 5000;
+/** Largest message cap accepted; higher settings are clamped to it. */
+export const REASONING_TRACE_MAX_MESSAGE_LENGTH_CEILING = 20000;
+/** True for an integer greater than zero. */
+export function isPositiveInteger(value) {
+    return typeof value === 'number' && Number.isInteger(value) && value > 0;
+}
+/**
+ * Makes a setting's value safe to record in a trace entry, which is cloned
+ * through JSON: finite numbers, strings, booleans and null pass through;
+ * `NaN`, `Infinity`, bigints, symbols, functions and objects become their
+ * `String()` form, or `[unserializable]` when even that throws.
+ */
+export function toJsonSafe(value) {
+    if (value === null || typeof value === 'string' || typeof value === 'boolean')
+        return value;
+    if (typeof value === 'number')
+        return Number.isFinite(value) ? value : String(value);
+    try {
+        return String(value);
+    }
+    catch {
+        return '[unserializable]';
+    }
+}
+const KEYS = ['maxEntries', 'maxMessageLength'];
+const FLOORS = { maxEntries: REASONING_TRACE_MIN_ENTRIES, maxMessageLength: 1 };
+const CEILINGS = {
+    maxEntries: REASONING_TRACE_MAX_ENTRIES_CEILING,
+    maxMessageLength: REASONING_TRACE_MAX_MESSAGE_LENGTH_CEILING,
+};
+const DEFAULTS = {
+    maxEntries: DEFAULT_REASONING_TRACE_MAX_ENTRIES,
+    maxMessageLength: DEFAULT_REASONING_TRACE_MAX_MESSAGE_LENGTH,
+};
+function isPlainObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/**
+ * Picks each limit from the persona, then the runtime config, then the
+ * defaults: the first positive integer wins, raised to its floor or clamped to
+ * its ceiling. Every setting that was defined but not usable as given is listed
+ * in `ignored`, whether or not a higher-precedence setting won: a persona field
+ * that is not an object, an unknown key, a value that is not a positive
+ * integer, and a value below the floor or above the ceiling.
+ */
+export function resolveReasoningTraceLimits(persona, config) {
+    const ignored = [];
+    const personaField = persona?.reasoningTraceConfig;
+    let personaValues = {};
+    if (personaField !== undefined) {
+        if (isPlainObject(personaField)) {
+            personaValues = personaField;
+            for (const name of Object.keys(personaField)) {
+                if (!KEYS.includes(name)) {
+                    ignored.push({ source: 'persona', key: name, value: toJsonSafe(personaField[name]), reason: 'unknown_key' });
+                }
+            }
+        }
+        else {
+            ignored.push({ source: 'persona', key: 'reasoningTraceConfig', value: toJsonSafe(personaField), reason: 'not_an_object' });
+        }
+    }
+    const pick = (key) => {
+        const candidates = [
+            ['persona', personaValues[key]],
+            ['config', key === 'maxEntries' ? config?.defaultReasoningTraceMaxEntries : config?.defaultReasoningTraceMaxMessageLength],
+        ];
+        let chosen;
+        for (const [source, value] of candidates) {
+            if (value === undefined)
+                continue;
+            let usable;
+            if (!isPositiveInteger(value)) {
+                ignored.push({ source, key, value: toJsonSafe(value), reason: 'not_a_positive_integer' });
+            }
+            else if (value < FLOORS[key]) {
+                ignored.push({ source, key, value, reason: 'below_floor' });
+                usable = FLOORS[key];
+            }
+            else if (value > CEILINGS[key]) {
+                ignored.push({ source, key, value, reason: 'above_ceiling' });
+                usable = CEILINGS[key];
+            }
+            else {
+                usable = value;
+            }
+            if (chosen === undefined && usable !== undefined)
+                chosen = usable;
+        }
+        return chosen ?? DEFAULTS[key];
+    };
+    return { maxEntries: pick('maxEntries'), maxMessageLength: pick('maxMessageLength'), ignored };
+}
+//# sourceMappingURL=reasoningTraceLimits.js.map

package/dist/cognition/substrate/reasoningTraceLimits.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reasoningTraceLimits.js","sourceRoot":"","sources":["../../../src/cognition/substrate/reasoningTraceLimits.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@framers/agentos",
-  "version": "0.10.38",
+  "version": "0.10.40",
   "description": "AgentOS: open-source TypeScript framework for autonomous AI agents. Unified graph orchestration, cognitive memory, runtime tool forging, multi-tier guardrails, voice pipeline, and 11 LLM providers.",
   "homepage": "https://agentos.sh",
   "repository": {