@framers/agentos 0.12.13 → 0.12.14

package/dist/api/runtime/agentCognitiveMemory.js

@@ -0,0 +1,277 @@
+/**
+ * @file agentCognitiveMemory.ts
+ * Cognitive memory for GMIs built from agent options (`agent({ runtime: 'gmi' })`,
+ * spec D7): a {@link CognitiveMemoryManager} over an in-memory vector store, the
+ * in-memory knowledge graph, an embedding manager for `memory.embedding`, a
+ * working memory of its own and the persona's HEXACO traits.
+ *
+ * One manager serves every session of an agent. Each GMI's memory bridge passes
+ * the session's mood on every encode, retrieve and assemble call and scopes
+ * recall to the session's user and conversation, so the manager's own mood
+ * callback is neutral. The memory graph runs on the `'knowledge-graph'` backend
+ * over the same in-memory knowledge graph, because the `'graphology'` backend
+ * needs graphology, an optional peer dependency. Consolidation runs only when
+ * `memory.consolidation.enabled` is true. The build embeds one test text through
+ * the embedding model it sets up, so a model that cannot answer, or answers with
+ * another size than memory expects, fails the build instead of leaving memory empty.
+ */
+import { CognitiveMemoryManager } from '../../cognition/memory/CognitiveMemoryManager.js';
+import { KnowledgeGraph } from '../../cognition/memory/retrieval/graph/knowledge/KnowledgeGraph.js';
+import { EmbeddingManager } from '../../cognition/rag/EmbeddingManager.js';
+import { InMemoryVectorStore } from '../../cognition/rag/vector_stores/InMemoryVectorStore.js';
+import { InMemoryWorkingMemory } from '../../cognition/substrate/memory/InMemoryWorkingMemory.js';
+import { HEXACO_TRAIT_KEYS, normalizeHexacoTraits } from '../../cognition/substrate/personas/hexaco.js';
+import { createProviderManager, resolveModelOption, resolveProvider } from '../model.js';
+/**
+ * Output sizes of the embedding models agentos knows, as each returns them when
+ * no `dimensions` is requested: OpenAI's (text-embedding-3 in
+ * https://developers.openai.com/api/docs/guides/embeddings; all three as
+ * OpenAIProvider records them for its model listing), nomic-embed-text's
+ * (https://huggingface.co/nomic-ai/nomic-embed-text-v1.5) and Gemini's (the
+ * sizes GeminiProvider's catalog records).
+ */
+const KNOWN_EMBEDDING_DIMENSIONS = new Map([
+    ['text-embedding-3-small', 1536],
+    ['text-embedding-3-large', 3072],
+    ['text-embedding-ada-002', 1536],
+    ['nomic-embed-text', 768],
+    ['gemini-embedding-001', 3072],
+    ['gemini-embedding-2', 3072],
+]);
+/** Providers whose agentos implementation has no embeddings: their `generateEmbeddings` always throws. */
+const PROVIDERS_WITHOUT_EMBEDDINGS = new Map([
+    ['anthropic', 'Anthropic'],
+    ['groq', 'Groq'],
+    ['xai', 'xAI'],
+    ['claude-code-cli', 'The Claude Code CLI'],
+    ['gemini-cli', 'The Gemini CLI'],
+]);
+const NEUTRAL_PAD = { valence: 0, arousal: 0, dominance: 0 };
+function messageOf(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+/** An Error carrying the error it reports as `cause`. */
+function errorWithCause(message, cause) {
+    return Object.assign(new Error(message), { cause });
+}
+function refuseProviderWithoutEmbeddings(providerId) {
+    const label = PROVIDERS_WITHOUT_EMBEDDINGS.get(providerId.toLowerCase());
+    if (label) {
+        throw new Error(`gmi(): ${label} has no embedding models in agentos; set memory.embedding to a provider that has them, such as openai or ollama.`);
+    }
+}
+/** The size of a model in {@link KNOWN_EMBEDDING_DIMENSIONS}, also under a vendor prefix (`openai/...`) or an Ollama tag (`...:latest`). */
+function knownDimension(modelId) {
+    const exact = KNOWN_EMBEDDING_DIMENSIONS.get(modelId);
+    if (exact !== undefined)
+        return exact;
+    const base = modelId.slice(modelId.lastIndexOf('/') + 1).split(':')[0];
+    return KNOWN_EMBEDDING_DIMENSIONS.get(base);
+}
+/** `memory.embedding.dimension`, refused when it is set and is not a positive integer. */
+function checkedDimension(memory) {
+    const declared = memory.embedding?.dimension;
+    if (declared !== undefined && !(Number.isInteger(declared) && declared > 0)) {
+        throw new Error(`gmi(): memory.embedding.dimension must be a positive integer; got ${String(declared)}.`);
+    }
+    return declared;
+}
+/**
+ * Resolves the embedding model from `memory.embedding`, or, when it is unset,
+ * from the environment: OpenAI's default embedding model when OPENAI_API_KEY is
+ * set, else Ollama's when OLLAMA_BASE_URL is set. Only checks whether those two
+ * are set; the provider's credentials are resolved when the memory is built.
+ */
+function resolveEmbeddingTarget(memory, env) {
+    const requested = memory.embedding?.provider || (env.OPENAI_API_KEY ? 'openai' : env.OLLAMA_BASE_URL ? 'ollama' : undefined);
+    if (!requested) {
+        throw new Error('gmi(): cognitive memory needs an embedding model. Set memory.embedding: { provider, model } or set OPENAI_API_KEY or OLLAMA_BASE_URL.');
+    }
+    refuseProviderWithoutEmbeddings(requested);
+    let model;
+    try {
+        model = resolveModelOption({ provider: requested, model: memory.embedding?.model }, 'embedding');
+    }
+    catch (error) {
+        throw errorWithCause(`gmi(): memory.embedding: ${messageOf(error)}`, error);
+    }
+    // A `provider:model` id names its own provider, which may be one that cannot embed.
+    refuseProviderWithoutEmbeddings(model.providerId);
+    const declared = checkedDimension(memory);
+    const dimension = declared ?? knownDimension(model.modelId);
+    if (dimension === undefined) {
+        throw new Error(`gmi(): set memory.embedding.dimension for the embedding model '${model.modelId}'; agentos does not know its output size.`);
+    }
+    return { ...model, dimension };
+}
+/**
+ * Checks, when the agent is built, that cognitive memory has an embedding model
+ * it can use, so a missing or unusable one fails before the first send. Reads
+ * the environment only to pick the provider when `memory.embedding` is unset;
+ * credentials are read when the memory is built.
+ *
+ * @param memory - The agent's memory config.
+ * @param env - The environment to read OPENAI_API_KEY and OLLAMA_BASE_URL from (defaults to `process.env`).
+ * @throws {Error} Naming `memory.embedding` when no provider is set or detected, when the
+ *   provider has no embeddings (Anthropic, Groq, xAI, the Claude Code and Gemini CLIs), when the
+ *   model does not resolve, or when the model's output size is unknown and
+ *   `memory.embedding.dimension` is unset or not a positive integer.
+ */
+export function assertEmbeddingAvailable(memory, env = process.env) {
+    resolveEmbeddingTarget(memory, env);
+}
+/**
+ * The checks on `memory.embedding` that read no environment, for `gmi()` to run
+ * when the agent is built: with a provider set, that it has embeddings, that the
+ * model resolves on it, that a declared dimension is a positive integer, and that
+ * the model's output size is known or declared. With no provider set, the
+ * provider is picked from the environment when the memory is first built, and
+ * only a declared dimension is checked here.
+ *
+ * @param memory - The agent's memory config.
+ * @throws {Error} Naming `memory.embedding`, as {@link assertEmbeddingAvailable} does.
+ */
+export function assertEmbeddingConfig(memory) {
+    if (memory.embedding?.provider) {
+        resolveEmbeddingTarget(memory, {});
+        return;
+    }
+    checkedDimension(memory);
+}
+/** The text the build embeds once to check the embedding model. */
+const PROBE_TEXT = 'cognitive memory embedding check';
+/**
+ * Embeds {@link PROBE_TEXT} once through the provider and model the embedding
+ * manager will call, and fails when the model cannot answer (an Ollama model
+ * that was never pulled, a model the provider does not serve) or answers with
+ * another size than memory expects. Without this check the build succeeds and
+ * memory stays empty: the embedding manager drops each failed or wrong-size
+ * vector, the memory store refuses the trace, and the GMI's memory bridge only
+ * records a trace warning.
+ *
+ * @param provider - The provider the embedding manager will call.
+ * @param model - The resolved provider and model.
+ * @param expected - The vector size memory expects.
+ * @param declared - `memory.embedding.dimension`, when set.
+ */
+async function probeEmbeddingModel(provider, model, expected, declared) {
+    const label = `cognitive memory's embedding model '${model.modelId}' on ${model.providerId}`;
+    let response;
+    try {
+        response = await provider.generateEmbeddings(model.modelId, [PROBE_TEXT]);
+    }
+    catch (error) {
+        throw errorWithCause(`gmi(): ${label} failed a test call (memory.embedding): ${messageOf(error)}`, error);
+    }
+    if (response?.error) {
+        throw errorWithCause(`gmi(): ${label} failed a test call (memory.embedding): ${response.error.message}`, response.error);
+    }
+    const vector = response?.data?.[0]?.embedding;
+    const size = Array.isArray(vector) ? vector.length : 0;
+    if (size === 0) {
+        throw new Error(`gmi(): ${label} returned no vector for a test call (memory.embedding).`);
+    }
+    if (size !== expected) {
+        const expectation = declared !== undefined
+            ? `memory.embedding.dimension (${declared}) declares ${declared}`
+            : `agentos expects ${expected} for this model`;
+        throw new Error(`gmi(): ${label} returns ${size} values, while ${expectation}; set memory.embedding.dimension to ${size}.`);
+    }
+}
+async function buildEmbeddingManager(memory) {
+    const target = resolveEmbeddingTarget(memory, process.env);
+    let resolved;
+    let providerManager;
+    try {
+        resolved = resolveProvider(target.providerId, target.modelId);
+        providerManager = await createProviderManager(resolved);
+    }
+    catch (error) {
+        // The chat model may run on the same provider with other credentials; name the memory's.
+        throw errorWithCause(`gmi(): cognitive memory could not start its embedding provider '${target.providerId}' (memory.embedding): ${messageOf(error)}`, error);
+    }
+    const provider = providerManager.getProvider(resolved.providerId);
+    if (!provider) {
+        throw new Error(`gmi(): cognitive memory's embedding provider '${resolved.providerId}' is not available (memory.embedding).`);
+    }
+    await probeEmbeddingModel(provider, resolved, target.dimension, memory.embedding?.dimension);
+    const manager = new EmbeddingManager();
+    await manager.initialize({
+        embeddingModels: [{ modelId: resolved.modelId, providerId: resolved.providerId, dimension: target.dimension, isDefault: true }],
+        defaultModelId: resolved.modelId,
+        enableCache: true,
+    }, providerManager);
+    return { manager, dimension: target.dimension };
+}
+/**
+ * Builds and initialises the cognitive memory manager an agent's GMIs share.
+ *
+ * @param opts - The persona, the memory config, the mechanisms and an optional embedding manager.
+ * @returns The manager and a `close()` that releases it.
+ * @throws {Error} When the embedding model is missing or unusable (see {@link assertEmbeddingAvailable}),
+ *   when its provider has no credentials or fails to start, when a test embedding through it
+ *   fails or returns another size than memory expects (skipped for an embedding manager the
+ *   caller passes), or when the manager fails to initialise.
+ */
+export async function createAgentCognitiveMemory(opts) {
+    const owned = opts.embeddingManager === undefined;
+    const embedding = opts.embeddingManager
+        ? { manager: opts.embeddingManager, dimension: await opts.embeddingManager.getEmbeddingDimension() }
+        : await buildEmbeddingManager(opts.memory);
+    const storeId = `gmi-memory-${opts.persona.id}`;
+    const vectorStoreConfig = {
+        id: storeId,
+        type: 'in_memory',
+        similarityMetric: 'cosine',
+        defaultEmbeddingDimension: embedding.dimension,
+    };
+    const vectorStore = new InMemoryVectorStore();
+    await vectorStore.initialize(vectorStoreConfig);
+    const knowledgeGraph = new KnowledgeGraph();
+    await knowledgeGraph.initialize();
+    const workingMemory = new InMemoryWorkingMemory();
+    await workingMemory.initialize(storeId);
+    // Canonical trait names (honestyHumility reads as honesty); 0.5 for a trait the persona leaves out.
+    const declared = normalizeHexacoTraits(opts.persona.personalityTraits);
+    const traits = {};
+    for (const key of HEXACO_TRAIT_KEYS)
+        traits[key] = declared[key] ?? 0.5;
+    const consolidationEnabled = opts.memory.consolidation?.enabled === true;
+    if (consolidationEnabled && opts.memory.consolidation?.interval) {
+        console.warn(`[agentos] gmi(): memory.consolidation.interval ('${opts.memory.consolidation.interval}') is not applied; consolidation runs every hour.`);
+    }
+    const config = {
+        workingMemory,
+        knowledgeGraph,
+        vectorStore,
+        embeddingManager: embedding.manager,
+        agentId: opts.persona.id,
+        traits,
+        moodProvider: () => ({ ...NEUTRAL_PAD }),
+        featureDetectionStrategy: 'keyword',
+        graph: { backend: 'knowledge-graph' },
+        ...(opts.mechanisms ? { cognitiveMechanisms: opts.mechanisms } : {}),
+        consolidation: { enabled: consolidationEnabled },
+    };
+    const manager = new CognitiveMemoryManager();
+    await manager.initialize(config);
+    let closing;
+    return {
+        manager,
+        close: () => (closing ?? (closing = (async () => {
+            try {
+                await manager.shutdown();
+            }
+            finally {
+                try {
+                    await vectorStore.shutdown();
+                }
+                finally {
+                    if (owned)
+                        await embedding.manager.shutdown?.();
+                }
+            }
+        })())),
+    };
+}
+//# sourceMappingURL=agentCognitiveMemory.js.map

package/dist/api/runtime/agentCognitiveMemory.js.map

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

package/dist/api/runtime/capabilityContract.d.ts

@@ -1,4 +1,9 @@
-export type CapabilitySurface = 'agent' | 'generation' | 'runtime';
+/**
+ * Where a config field is read: `agent` (the lightweight `agent()` helper on its
+ * legacy runtime), `generation` (generateText and streamText), `runtime` (the full
+ * AgentOS runtime) and `gmi` (`agent({ runtime: 'gmi' })` and `gmi()`).
+ */
+export type CapabilitySurface = 'agent' | 'generation' | 'runtime' | 'gmi';
 export type CapabilitySupport = 'enforced' | 'partially_enforced' | 'accepted_but_deferred' | 'runtime_only';
 export declare const CAPABILITY_KEYS: readonly ["tools", "memory", "rag", "discovery", "guardrails", "security", "permissions", "hitl", "emergent", "voice", "channels", "output", "provenance", "observability", "controls"];
 export type CapabilityKey = (typeof CAPABILITY_KEYS)[number];
@@ -7,76 +12,91 @@ export declare const BASE_AGENT_CONFIG_CAPABILITY_CONTRACT: {
         readonly agent: "enforced";
         readonly generation: "enforced";
         readonly runtime: "enforced";
+        readonly gmi: "enforced";
     };
     readonly memory: {
         readonly agent: "partially_enforced";
         readonly generation: "runtime_only";
         readonly runtime: "enforced";
+        readonly gmi: "enforced";
     };
     readonly rag: {
         readonly agent: "accepted_but_deferred";
         readonly generation: "runtime_only";
         readonly runtime: "enforced";
+        readonly gmi: "accepted_but_deferred";
     };
     readonly discovery: {
         readonly agent: "accepted_but_deferred";
         readonly generation: "runtime_only";
         readonly runtime: "enforced";
+        readonly gmi: "accepted_but_deferred";
     };
     readonly guardrails: {
         readonly agent: "accepted_but_deferred";
         readonly generation: "partially_enforced";
         readonly runtime: "enforced";
+        readonly gmi: "accepted_but_deferred";
     };
     readonly security: {
         readonly agent: "accepted_but_deferred";
         readonly generation: "runtime_only";
         readonly runtime: "enforced";
+        readonly gmi: "accepted_but_deferred";
     };
     readonly permissions: {
         readonly agent: "accepted_but_deferred";
         readonly generation: "partially_enforced";
         readonly runtime: "enforced";
+        readonly gmi: "accepted_but_deferred";
     };
     readonly hitl: {
         readonly agent: "accepted_but_deferred";
         readonly generation: "runtime_only";
         readonly runtime: "enforced";
+        readonly gmi: "accepted_but_deferred";
     };
     readonly emergent: {
         readonly agent: "accepted_but_deferred";
         readonly generation: "runtime_only";
         readonly runtime: "enforced";
+        readonly gmi: "accepted_but_deferred";
     };
     readonly voice: {
         readonly agent: "accepted_but_deferred";
         readonly generation: "runtime_only";
         readonly runtime: "enforced";
+        readonly gmi: "runtime_only";
     };
     readonly channels: {
         readonly agent: "accepted_but_deferred";
         readonly generation: "runtime_only";
         readonly runtime: "enforced";
+        readonly gmi: "runtime_only";
     };
     readonly output: {
         readonly agent: "accepted_but_deferred";
         readonly generation: "runtime_only";
         readonly runtime: "enforced";
+        readonly gmi: "accepted_but_deferred";
     };
     readonly provenance: {
         readonly agent: "accepted_but_deferred";
         readonly generation: "runtime_only";
         readonly runtime: "enforced";
+        readonly gmi: "accepted_but_deferred";
     };
     readonly observability: {
         readonly agent: "partially_enforced";
         readonly generation: "partially_enforced";
         readonly runtime: "enforced";
+        readonly gmi: "partially_enforced";
     };
     readonly controls: {
         readonly agent: "partially_enforced";
         readonly generation: "runtime_only";
         readonly runtime: "enforced";
+        readonly gmi: "partially_enforced";
     };
 };
 export declare function getCapabilitySupport(surface: CapabilitySurface, key: CapabilityKey): CapabilitySupport;

package/dist/api/runtime/capabilityContract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"capabilityContract.d.ts","sourceRoot":"","sources":["../../../src/api/runtime/capabilityContract.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,YAAY,GAAG,SAAS,CAAC;AAEnE,MAAM,MAAM,iBAAiB,GACzB,UAAU,GACV,oBAAoB,GACpB,uBAAuB,GACvB,cAAc,CAAC;AAEnB,eAAO,MAAM,eAAe,yLAgBlB,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAE7D,eAAO,MAAM,qCAAqC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgBsC,CAAC;AAEzF,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,iBAAiB,EAC1B,GAAG,EAAE,aAAa,GACjB,iBAAiB,CAEnB"}
+{"version":3,"file":"capabilityContract.d.ts","sourceRoot":"","sources":["../../../src/api/runtime/capabilityContract.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,YAAY,GAAG,SAAS,GAAG,KAAK,CAAC;AAE3E,MAAM,MAAM,iBAAiB,GACzB,UAAU,GACV,oBAAoB,GACpB,uBAAuB,GACvB,cAAc,CAAC;AAEnB,eAAO,MAAM,eAAe,yLAgBlB,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAE7D,eAAO,MAAM,qCAAqC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgBsC,CAAC;AAEzF,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,iBAAiB,EAC1B,GAAG,EAAE,aAAa,GACjB,iBAAiB,CAEnB"}

package/dist/api/runtime/capabilityContract.js

@@ -16,21 +16,21 @@ export const CAPABILITY_KEYS = [
     'controls',
 ];
 export const BASE_AGENT_CONFIG_CAPABILITY_CONTRACT = {
-    tools: { agent: 'enforced', generation: 'enforced', runtime: 'enforced' },
-    memory: { agent: 'partially_enforced', generation: 'runtime_only', runtime: 'enforced' },
-    rag: { agent: 'accepted_but_deferred', generation: 'runtime_only', runtime: 'enforced' },
-    discovery: { agent: 'accepted_but_deferred', generation: 'runtime_only', runtime: 'enforced' },
-    guardrails: { agent: 'accepted_but_deferred', generation: 'partially_enforced', runtime: 'enforced' },
-    security: { agent: 'accepted_but_deferred', generation: 'runtime_only', runtime: 'enforced' },
-    permissions: { agent: 'accepted_but_deferred', generation: 'partially_enforced', runtime: 'enforced' },
-    hitl: { agent: 'accepted_but_deferred', generation: 'runtime_only', runtime: 'enforced' },
-    emergent: { agent: 'accepted_but_deferred', generation: 'runtime_only', runtime: 'enforced' },
-    voice: { agent: 'accepted_but_deferred', generation: 'runtime_only', runtime: 'enforced' },
-    channels: { agent: 'accepted_but_deferred', generation: 'runtime_only', runtime: 'enforced' },
-    output: { agent: 'accepted_but_deferred', generation: 'runtime_only', runtime: 'enforced' },
-    provenance: { agent: 'accepted_but_deferred', generation: 'runtime_only', runtime: 'enforced' },
-    observability: { agent: 'partially_enforced', generation: 'partially_enforced', runtime: 'enforced' },
-    controls: { agent: 'partially_enforced', generation: 'runtime_only', runtime: 'enforced' },
+    tools: { agent: 'enforced', generation: 'enforced', runtime: 'enforced', gmi: 'enforced' },
+    memory: { agent: 'partially_enforced', generation: 'runtime_only', runtime: 'enforced', gmi: 'enforced' },
+    rag: { agent: 'accepted_but_deferred', generation: 'runtime_only', runtime: 'enforced', gmi: 'accepted_but_deferred' },
+    discovery: { agent: 'accepted_but_deferred', generation: 'runtime_only', runtime: 'enforced', gmi: 'accepted_but_deferred' },
+    guardrails: { agent: 'accepted_but_deferred', generation: 'partially_enforced', runtime: 'enforced', gmi: 'accepted_but_deferred' },
+    security: { agent: 'accepted_but_deferred', generation: 'runtime_only', runtime: 'enforced', gmi: 'accepted_but_deferred' },
+    permissions: { agent: 'accepted_but_deferred', generation: 'partially_enforced', runtime: 'enforced', gmi: 'accepted_but_deferred' },
+    hitl: { agent: 'accepted_but_deferred', generation: 'runtime_only', runtime: 'enforced', gmi: 'accepted_but_deferred' },
+    emergent: { agent: 'accepted_but_deferred', generation: 'runtime_only', runtime: 'enforced', gmi: 'accepted_but_deferred' },
+    voice: { agent: 'accepted_but_deferred', generation: 'runtime_only', runtime: 'enforced', gmi: 'runtime_only' },
+    channels: { agent: 'accepted_but_deferred', generation: 'runtime_only', runtime: 'enforced', gmi: 'runtime_only' },
+    output: { agent: 'accepted_but_deferred', generation: 'runtime_only', runtime: 'enforced', gmi: 'accepted_but_deferred' },
+    provenance: { agent: 'accepted_but_deferred', generation: 'runtime_only', runtime: 'enforced', gmi: 'accepted_but_deferred' },
+    observability: { agent: 'partially_enforced', generation: 'partially_enforced', runtime: 'enforced', gmi: 'partially_enforced' },
+    controls: { agent: 'partially_enforced', generation: 'runtime_only', runtime: 'enforced', gmi: 'partially_enforced' },
 };
 export function getCapabilitySupport(surface, key) {
     return BASE_AGENT_CONFIG_CAPABILITY_CONTRACT[key][surface];

package/dist/api/runtime/capabilityContract.js.map

@@ -1 +1 @@
-{"version":3,"file":"capabilityContract.js","sourceRoot":"","sources":["../../../src/api/runtime/capabilityContract.ts"],"names":[],"mappings":"AAQA,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,OAAO;IACP,QAAQ;IACR,KAAK;IACL,WAAW;IACX,YAAY;IACZ,UAAU;IACV,aAAa;IACb,MAAM;IACN,UAAU;IACV,OAAO;IACP,UAAU;IACV,QAAQ;IACR,YAAY;IACZ,eAAe;IACf,UAAU;CACF,CAAC;AAIX,MAAM,CAAC,MAAM,qCAAqC,GAAG;IACnD,KAAK,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,EAAE;IACzE,MAAM,EAAE,EAAE,KAAK,EAAE,oBAAoB,EAAE,UAAU,EAAE,cAAc,EAAE,OAAO,EAAE,UAAU,EAAE;IACxF,GAAG,EAAE,EAAE,KAAK,EAAE,uBAAuB,EAAE,UAAU,EAAE,cAAc,EAAE,OAAO,EAAE,UAAU,EAAE;IACxF,SAAS,EAAE,EAAE,KAAK,EAAE,uBAAuB,EAAE,UAAU,EAAE,cAAc,EAAE,OAAO,EAAE,UAAU,EAAE;IAC9F,UAAU,EAAE,EAAE,KAAK,EAAE,uBAAuB,EAAE,UAAU,EAAE,oBAAoB,EAAE,OAAO,EAAE,UAAU,EAAE;IACrG,QAAQ,EAAE,EAAE,KAAK,EAAE,uBAAuB,EAAE,UAAU,EAAE,cAAc,EAAE,OAAO,EAAE,UAAU,EAAE;IAC7F,WAAW,EAAE,EAAE,KAAK,EAAE,uBAAuB,EAAE,UAAU,EAAE,oBAAoB,EAAE,OAAO,EAAE,UAAU,EAAE;IACtG,IAAI,EAAE,EAAE,KAAK,EAAE,uBAAuB,EAAE,UAAU,EAAE,cAAc,EAAE,OAAO,EAAE,UAAU,EAAE;IACzF,QAAQ,EAAE,EAAE,KAAK,EAAE,uBAAuB,EAAE,UAAU,EAAE,cAAc,EAAE,OAAO,EAAE,UAAU,EAAE;IAC7F,KAAK,EAAE,EAAE,KAAK,EAAE,uBAAuB,EAAE,UAAU,EAAE,cAAc,EAAE,OAAO,EAAE,UAAU,EAAE;IAC1F,QAAQ,EAAE,EAAE,KAAK,EAAE,uBAAuB,EAAE,UAAU,EAAE,cAAc,EAAE,OAAO,EAAE,UAAU,EAAE;IAC7F,MAAM,EAAE,EAAE,KAAK,EAAE,uBAAuB,EAAE,UAAU,EAAE,cAAc,EAAE,OAAO,EAAE,UAAU,EAAE;IAC3F,UAAU,EAAE,EAAE,KAAK,EAAE,uBAAuB,EAAE,UAAU,EAAE,cAAc,EAAE,OAAO,EAAE,UAAU,EAAE;IAC/F,aAAa,EAAE,EAAE,KAAK,EAAE,oBAAoB,EAAE,UAAU,EAAE,oBAAoB,EAAE,OAAO,EAAE,UAAU,EAAE;IACrG,QAAQ,EAAE,EAAE,KAAK,EAAE,oBAAoB,EAAE,UAAU,EAAE,cAAc,EAAE,OAAO,EAAE,UAAU,EAAE;CACJ,CAAC;AAEzF,MAAM,UAAU,oBAAoB,CAClC,OAA0B,EAC1B,GAAkB;IAElB,OAAO,qCAAqC,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC;AAC7D,CAAC"}
+{"version":3,"file":"capabilityContract.js","sourceRoot":"","sources":["../../../src/api/runtime/capabilityContract.ts"],"names":[],"mappings":"AAaA,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,OAAO;IACP,QAAQ;IACR,KAAK;IACL,WAAW;IACX,YAAY;IACZ,UAAU;IACV,aAAa;IACb,MAAM;IACN,UAAU;IACV,OAAO;IACP,UAAU;IACV,QAAQ;IACR,YAAY;IACZ,eAAe;IACf,UAAU;CACF,CAAC;AAIX,MAAM,CAAC,MAAM,qCAAqC,GAAG;IACnD,KAAK,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,UAAU,EAAE;IAC1F,MAAM,EAAE,EAAE,KAAK,EAAE,oBAAoB,EAAE,UAAU,EAAE,cAAc,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,UAAU,EAAE;IACzG,GAAG,EAAE,EAAE,KAAK,EAAE,uBAAuB,EAAE,UAAU,EAAE,cAAc,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,uBAAuB,EAAE;IACtH,SAAS,EAAE,EAAE,KAAK,EAAE,uBAAuB,EAAE,UAAU,EAAE,cAAc,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,uBAAuB,EAAE;IAC5H,UAAU,EAAE,EAAE,KAAK,EAAE,uBAAuB,EAAE,UAAU,EAAE,oBAAoB,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,uBAAuB,EAAE;IACnI,QAAQ,EAAE,EAAE,KAAK,EAAE,uBAAuB,EAAE,UAAU,EAAE,cAAc,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,uBAAuB,EAAE;IAC3H,WAAW,EAAE,EAAE,KAAK,EAAE,uBAAuB,EAAE,UAAU,EAAE,oBAAoB,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,uBAAuB,EAAE;IACpI,IAAI,EAAE,EAAE,KAAK,EAAE,uBAAuB,EAAE,UAAU,EAAE,cAAc,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,uBAAuB,EAAE;IACvH,QAAQ,EAAE,EAAE,KAAK,EAAE,uBAAuB,EAAE,UAAU,EAAE,cAAc,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,uBAAuB,EAAE;IAC3H,KAAK,EAAE,EAAE,KAAK,EAAE,uBAAuB,EAAE,UAAU,EAAE,cAAc,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,cAAc,EAAE;IAC/G,QAAQ,EAAE,EAAE,KAAK,EAAE,uBAAuB,EAAE,UAAU,EAAE,cAAc,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,cAAc,EAAE;IAClH,MAAM,EAAE,EAAE,KAAK,EAAE,uBAAuB,EAAE,UAAU,EAAE,cAAc,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,uBAAuB,EAAE;IACzH,UAAU,EAAE,EAAE,KAAK,EAAE,uBAAuB,EAAE,UAAU,EAAE,cAAc,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,uBAAuB,EAAE;IAC7H,aAAa,EAAE,EAAE,KAAK,EAAE,oBAAoB,EAAE,UAAU,EAAE,oBAAoB,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,oBAAoB,EAAE;IAChI,QAAQ,EAAE,EAAE,KAAK,EAAE,oBAAoB,EAAE,UAAU,EAAE,cAAc,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,oBAAoB,EAAE;CAC/B,CAAC;AAEzF,MAAM,UAAU,oBAAoB,CAClC,OAA0B,EAC1B,GAAkB;IAElB,OAAO,qCAAqC,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC;AAC7D,CAAC"}

package/dist/api/runtime/gmiCognition.d.ts

@@ -0,0 +1,66 @@
+/**
+ * @file gmiCognition.ts
+ * Cognition profiles for GMIs built from agent options (`agent({ runtime: 'gmi' })`).
+ *
+ * `light` (the default) is a GMI with its reasoning trace and nothing else
+ * unless `memory` is set. `full` adds cognitive memory with every mechanism,
+ * sentiment tracking and every metaprompt preset. A {@link CognitionConfig}
+ * sets each switch on its own.
+ */
+import type { MemoryConfig } from '../types.js';
+import type { CognitiveMechanismsConfig } from '../../cognition/memory/mechanisms/types.js';
+import type { SentimentTrackingConfig } from '../../cognition/substrate/personas/IPersonaDefinition.js';
+/** A named cognition profile. */
+export type CognitionProfile = 'light' | 'full';
+/** A metaprompt preset, named as `SentimentTrackingConfig.presets` names it. */
+export type MetapromptPreset = Exclude<NonNullable<SentimentTrackingConfig['presets']>[number], 'all'>;
+/** Each cognition switch set explicitly, in place of a named profile. */
+export interface CognitionConfig {
+    /** Cognitive memory: false, true (defaults) or a MemoryConfig. Unset: the agent's `memory` option. */
+    memory?: boolean | MemoryConfig;
+    /**
+     * Memory mechanisms: true (the agent's `cognitiveMechanisms`, or every
+     * mechanism at its defaults), false (none) or a per-mechanism config.
+     * Unset means true. Needs memory.
+     */
+    mechanisms?: boolean | CognitiveMechanismsConfig;
+    /** Sentiment tracking: every user turn is scored by the utility AI's lexicon. */
+    sentiment?: boolean;
+    /**
+     * Metaprompt presets: `'all'`, a list of presets, or false. Needs
+     * `sentiment`: the presets answer the events sentiment tracking raises.
+     */
+    metaprompts?: 'all' | MetapromptPreset[] | false;
+}
+/** What a GMI built from agent options runs. */
+export interface ResolvedCognition {
+    profile: CognitionProfile | 'custom';
+    /** The cognitive memory config, or false for none. */
+    memory: MemoryConfig | false;
+    /** The mechanisms config the memory manager runs; undefined when memory or the mechanisms are off. */
+    mechanisms: CognitiveMechanismsConfig | undefined;
+    sentiment: boolean;
+    /** The metaprompt presets; false when sentiment is off. */
+    metaprompts: 'all' | MetapromptPreset[] | false;
+}
+/** The agent options {@link resolveCognition} reads. */
+export interface CognitionInputs {
+    cognition?: CognitionProfile | CognitionConfig;
+    memory?: boolean | MemoryConfig;
+    cognitiveMechanisms?: CognitiveMechanismsConfig;
+}
+/**
+ * Resolves an agent's `cognition`, `memory` and `cognitiveMechanisms` options
+ * into the switches a GMI runs with.
+ *
+ * - `light`: memory only when `memory` is set (then every mechanism, or the
+ *   agent's `cognitiveMechanisms`); no sentiment tracking, no metaprompts.
+ * - `full`: memory unless `memory: false`, every mechanism (or the agent's
+ *   `cognitiveMechanisms`), sentiment tracking and every metaprompt preset.
+ * - A {@link CognitionConfig}: each switch as set, with `memory` falling back
+ *   to the agent's `memory` option.
+ *
+ * @throws {Error} When `cognition` names an unknown profile or an unknown metaprompt preset.
+ */
+export declare function resolveCognition(opts: CognitionInputs): ResolvedCognition;
+//# sourceMappingURL=gmiCognition.d.ts.map

package/dist/api/runtime/gmiCognition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gmiCognition.d.ts","sourceRoot":"","sources":["../../../src/api/runtime/gmiCognition.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,4CAA4C,CAAC;AAC5F,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,0DAA0D,CAAC;AAGxG,iCAAiC;AACjC,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,MAAM,CAAC;AAEhD,gFAAgF;AAChF,MAAM,MAAM,gBAAgB,GAAG,OAAO,CAAC,WAAW,CAAC,uBAAuB,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,CAAC,CAAC;AAEvG,yEAAyE;AACzE,MAAM,WAAW,eAAe;IAC9B,sGAAsG;IACtG,MAAM,CAAC,EAAE,OAAO,GAAG,YAAY,CAAC;IAChC;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,GAAG,yBAAyB,CAAC;IACjD,iFAAiF;IACjF,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;OAGG;IACH,WAAW,CAAC,EAAE,KAAK,GAAG,gBAAgB,EAAE,GAAG,KAAK,CAAC;CAClD;AAED,gDAAgD;AAChD,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,gBAAgB,GAAG,QAAQ,CAAC;IACrC,sDAAsD;IACtD,MAAM,EAAE,YAAY,GAAG,KAAK,CAAC;IAC7B,sGAAsG;IACtG,UAAU,EAAE,yBAAyB,GAAG,SAAS,CAAC;IAClD,SAAS,EAAE,OAAO,CAAC;IACnB,2DAA2D;IAC3D,WAAW,EAAE,KAAK,GAAG,gBAAgB,EAAE,GAAG,KAAK,CAAC;CACjD;AAED,wDAAwD;AACxD,MAAM,WAAW,eAAe;IAC9B,SAAS,CAAC,EAAE,gBAAgB,GAAG,eAAe,CAAC;IAC/C,MAAM,CAAC,EAAE,OAAO,GAAG,YAAY,CAAC;IAChC,mBAAmB,CAAC,EAAE,yBAAyB,CAAC;CACjD;AAuBD;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,eAAe,GAAG,iBAAiB,CAsBzE"}

package/dist/api/runtime/gmiCognition.js

@@ -0,0 +1,58 @@
+import { SENTIMENT_PRESET_IDS } from '../../cognition/substrate/personas/personaNormalization.js';
+function memoryOf(value) {
+    if (value === undefined || value === false)
+        return false;
+    return value === true ? {} : value;
+}
+function presetsOf(value) {
+    if (value === undefined || value === false)
+        return false;
+    if (value === 'all')
+        return 'all';
+    if (!Array.isArray(value)) {
+        throw new Error("cognition.metaprompts must be 'all', a list of presets, or false.");
+    }
+    const unknown = value.filter((name) => !Object.prototype.hasOwnProperty.call(SENTIMENT_PRESET_IDS, name));
+    if (unknown.length > 0) {
+        throw new Error(`cognition.metaprompts: unknown preset ${unknown.map((name) => `'${String(name)}'`).join(', ')}; ` +
+            `use 'all' or a list of ${Object.keys(SENTIMENT_PRESET_IDS).join(', ')}.`);
+    }
+    return [...value];
+}
+/**
+ * Resolves an agent's `cognition`, `memory` and `cognitiveMechanisms` options
+ * into the switches a GMI runs with.
+ *
+ * - `light`: memory only when `memory` is set (then every mechanism, or the
+ *   agent's `cognitiveMechanisms`); no sentiment tracking, no metaprompts.
+ * - `full`: memory unless `memory: false`, every mechanism (or the agent's
+ *   `cognitiveMechanisms`), sentiment tracking and every metaprompt preset.
+ * - A {@link CognitionConfig}: each switch as set, with `memory` falling back
+ *   to the agent's `memory` option.
+ *
+ * @throws {Error} When `cognition` names an unknown profile or an unknown metaprompt preset.
+ */
+export function resolveCognition(opts) {
+    const c = opts.cognition ?? 'light';
+    if (c === 'light') {
+        const memory = memoryOf(opts.memory);
+        return { profile: 'light', memory, mechanisms: memory ? (opts.cognitiveMechanisms ?? {}) : undefined, sentiment: false, metaprompts: false };
+    }
+    if (c === 'full') {
+        const memory = memoryOf(opts.memory ?? true);
+        return { profile: 'full', memory, mechanisms: memory ? (opts.cognitiveMechanisms ?? {}) : undefined, sentiment: true, metaprompts: 'all' };
+    }
+    if (typeof c !== 'object') {
+        throw new Error(`cognition: unknown profile '${String(c)}'; use 'light', 'full' or a CognitionConfig.`);
+    }
+    const memory = memoryOf(c.memory ?? opts.memory);
+    const mechanisms = !memory || c.mechanisms === false
+        ? undefined
+        : c.mechanisms === true || c.mechanisms === undefined
+            ? (opts.cognitiveMechanisms ?? {})
+            : c.mechanisms;
+    const sentiment = c.sentiment === true;
+    const metaprompts = presetsOf(c.metaprompts);
+    return { profile: 'custom', memory, mechanisms, sentiment, metaprompts: sentiment ? metaprompts : false };
+}
+//# sourceMappingURL=gmiCognition.js.map

package/dist/api/runtime/gmiCognition.js.map

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

package/dist/api/runtime/gmiPersona.d.ts

@@ -0,0 +1,16 @@
+import { type AgentOptions } from '../agent.js';
+import type { IPersonaDefinition } from '../../cognition/substrate/personas/IPersonaDefinition.js';
+import type { ITool } from '../../core/tools/ITool.js';
+import type { ResolvedCognition } from './gmiCognition.js';
+/** The session store bounds history (spec D10), so the GMI's own count window stays out of the way. */
+export declare const GMI_SESSION_MAX_HISTORY_MESSAGES = 100000;
+/**
+ * Builds the persona of a GMI from agent options (spec D6).
+ *
+ * @param opts - The agent's options.
+ * @param cognition - The resolved profile ({@link resolveCognition}): sentiment tracking and metaprompts.
+ * @param tools - The agent's tools, adapted: they decide the chain-of-thought text and the persona's capabilities.
+ * @throws {Error} When no provider or model can be resolved, as `generateText` throws.
+ */
+export declare function personaFromAgentOptions(opts: AgentOptions, cognition: ResolvedCognition, tools: ITool[]): IPersonaDefinition;
+//# sourceMappingURL=gmiPersona.d.ts.map

package/dist/api/runtime/gmiPersona.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gmiPersona.d.ts","sourceRoot":"","sources":["../../../src/api/runtime/gmiPersona.ts"],"names":[],"mappings":"AAYA,OAAO,EAAqB,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAKnE,OAAO,KAAK,EAAE,kBAAkB,EAA2B,MAAM,0DAA0D,CAAC;AAC5H,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,2BAA2B,CAAC;AAEvD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAE3D,uGAAuG;AACvG,eAAO,MAAM,gCAAgC,SAAU,CAAC;AAsCxD;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,YAAY,EAAE,SAAS,EAAE,iBAAiB,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,kBAAkB,CAsB5H"}