@framers/agentos 0.12.13 → 0.12.14

package/dist/api/gmi.js

@@ -0,0 +1,527 @@
+/**
+ * @file gmi.ts
+ * gmi(): an agent whose sessions are Generalized Mind Instances, built
+ * in-process from agent options (spec D5-D12). `agent({ runtime: 'gmi' })`
+ * returns the same handle.
+ *
+ * Construction checks what needs no environment: options the GMI path cannot
+ * honour, the cognition profile, and the `memory.embedding` settings that name
+ * their provider. The persona (with the provider and model it resolves), the
+ * prompt engine, utility AI and tool orchestrator the sessions share, and the
+ * cognitive memory are built on first use, so an agent made before its keys are
+ * set resolves them on its first call; a build that fails is not kept, and the
+ * next call builds again.
+ */
+import { randomUUID } from 'node:crypto';
+import { GMI } from '../cognition/substrate/GMI.js';
+import { InMemoryWorkingMemory } from '../cognition/substrate/memory/InMemoryWorkingMemory.js';
+import { StatisticalUtilityAI } from '../cognition/nlp/ai_utilities/StatisticalUtilityAI.js';
+import { PromptEngine } from '../core/llm/PromptEngine.js';
+import { ToolPermissionManager } from '../core/tools/permissions/ToolPermissionManager.js';
+import { ToolExecutor } from '../core/tools/ToolExecutor.js';
+import { ToolOrchestrator } from '../core/tools/ToolOrchestrator.js';
+import { ExtensionRegistry } from '../extensions/ExtensionRegistry.js';
+import { EXTENSION_KIND_TOOL } from '../extensions/types.js';
+import { createCompletionGateway } from './runtime/completionGateway.js';
+import { GatewayProviderManager } from './runtime/gatewayProviderManager.js';
+import { adaptTools } from './runtime/toolAdapter.js';
+import { resolveCognition } from './runtime/gmiCognition.js';
+import { personaFromAgentOptions } from './runtime/gmiPersona.js';
+import { assertEmbeddingConfig, createAgentCognitiveMemory } from './runtime/agentCognitiveMemory.js';
+import { sendGmiTurn, streamGmiTurn, TurnLock } from './runtime/gmiSession.js';
+import { transcriptToConversation } from './runtime/gmiTranscript.js';
+import { SessionHistoryBuffer, SESSION_HISTORY_DEFAULTS } from './sessionHistory.js';
+import { accumulateUsage, createEmptyUsageAggregate, mergeAggregates } from './runtime/usageAccumulator.js';
+import { exportAgentConfig, exportAgentConfigJSON } from './agentExportCore.js';
+import { getDeferredCapabilities } from './runtime/lightweightAgentDiagnostics.js';
+/** Options with no GMI-path implementation yet; set, they throw at construction. */
+const UNSUPPORTED_ON_GMI = ['voice', 'avatar', 'channels'];
+/** Per-call overrides generate() and stream() accept on the GMI path (spec D10). */
+const ALLOWED_CALL_OVERRIDES = new Set(['temperature', 'maxTokens', 'topP', 'responseFormat', 'model', 'provider', 'maxSteps', 'usageLedger']);
+/** Per-call overrides that pick the route, the step limit or the ledger rather than a completion option. */
+const ROUTE_OVERRIDES = new Set(['model', 'provider', 'maxSteps', 'usageLedger']);
+/** `agent()`'s step limit. */
+const DEFAULT_MAX_STEPS = 5;
+const GMI_PROMPT_ENGINE_CONFIG = {
+    defaultTemplateName: 'openai_chat',
+    availableTemplates: {},
+    tokenCounting: { strategy: 'estimated', estimationModel: 'gpt-3.5-turbo' },
+    // Truncation only: no utility AI is passed, and no summary is made by a model call.
+    historyManagement: { defaultMaxMessages: 100000, maxTokensForHistory: 120000, summarizationTriggerRatio: 0, preserveImportantMessages: true },
+    contextManagement: { maxRAGContextTokens: 1500, summarizationQualityTier: 'balanced', preserveSourceAttributionInSummary: true },
+    contextualElementSelection: { maxElementsPerType: {}, defaultMaxElementsPerType: 3, priorityResolutionStrategy: 'highest_first', conflictResolutionStrategy: 'skip_conflicting' },
+    performance: { enableCaching: false, cacheTimeoutSeconds: 60 },
+};
+function isSet(value) {
+    if (value == null || value === false)
+        return false;
+    if (typeof value === 'object')
+        return Object.keys(value).length > 0;
+    return true;
+}
+/**
+ * A memoised async build that is not kept when it fails: the next call after a
+ * rejection builds again, so one transient failure does not fail every later
+ * call. `reset()` drops a kept result.
+ */
+function retryingOnce(build) {
+    let pending;
+    return {
+        get() {
+            if (!pending) {
+                const attempt = build();
+                pending = attempt;
+                attempt.catch(() => {
+                    if (pending === attempt)
+                        pending = undefined;
+                });
+            }
+            return pending;
+        },
+        peek: () => pending,
+        reset() {
+            pending = undefined;
+        },
+    };
+}
+/** `target` with some members replaced; every other method runs on `target` itself. */
+function withMembers(target, members) {
+    return new Proxy(target, {
+        get(t, prop) {
+            if (Object.prototype.hasOwnProperty.call(members, prop))
+                return members[prop];
+            const value = Reflect.get(t, prop, t);
+            return typeof value === 'function' ? value.bind(t) : value;
+        },
+    });
+}
+/**
+ * The agent's memory manager as one GMI sees it. `GMI.shutdown()` shuts down
+ * the cognitive memory it was given; the agent's sessions share one manager, so
+ * a session's shutdown must leave it to the others, and `agent.close()` closes it.
+ */
+function sharedMemoryView(manager) {
+    return withMembers(manager, { shutdown: async () => undefined });
+}
+/**
+ * A tool registry that leaves out the tools ToolExecutor registers from its own
+ * constructor (the built-in getCurrentDateTime), so a tool-less agent offers the
+ * model no tools (spec D4j) and an agent tool of the same name is the only one.
+ * The constructor starts that registration without waiting for it; skipping it
+ * here needs no wait, and no later registration can be overtaken by it.
+ */
+class AgentToolRegistry extends ExtensionRegistry {
+    constructor() {
+        super(...arguments);
+        /** False while the executor's constructor registers its built-ins. */
+        this.acceptsRegistrations = false;
+    }
+    async register(...args) {
+        if (!this.acceptsRegistrations)
+            return;
+        return super.register(...args);
+    }
+}
+function toolExecutorWithoutBuiltIns() {
+    const registry = new AgentToolRegistry(EXTENSION_KIND_TOOL);
+    const executor = new ToolExecutor(undefined, undefined, registry);
+    registry.acceptsRegistrations = true;
+    return executor;
+}
+/**
+ * The agent's `onBeforeToolExecution` around the shared orchestrator, for one
+ * GMI: `null` skips the tool as `generateText` skips it, returned arguments
+ * replace the call's, and a hook that throws is warned about and the tool runs.
+ */
+function hookTools(base, hook, step) {
+    if (!hook)
+        return base;
+    const processToolCall = async (details) => {
+        const req = details.toolCallRequest;
+        let info = {
+            name: req.name,
+            args: (req.arguments ?? {}),
+            id: req.id,
+            step: step.index,
+        };
+        try {
+            info = await hook(info);
+        }
+        catch (hookError) {
+            console.warn('[agentos] onBeforeToolExecution hook error:', hookError);
+        }
+        if (info === null) {
+            return {
+                toolCallId: req.id,
+                toolName: req.name,
+                output: { skipped: true },
+                isError: true,
+                errorDetails: { message: 'Skipped by onBeforeToolExecution hook' },
+            };
+        }
+        return base.processToolCall({ ...details, toolCallRequest: { ...req, arguments: info.args } });
+    };
+    return withMembers(base, { processToolCall });
+}
+/**
+ * The agent's completion gateway. The GMI's route carries its own `onFallback`
+ * (a trace entry), which replaces a gateway default, so the agent's
+ * `onFallback` is called beside it, as `onFallback(error, provider)`; a
+ * listener that throws is warned about and never fails the hop.
+ */
+function gatewayFor(opts) {
+    const base = createCompletionGateway({
+        apiKey: opts.apiKey,
+        baseUrl: opts.baseUrl,
+        fallbackProviders: opts.fallbackProviders,
+        policyTier: opts.policyTier,
+        router: opts.router,
+        routerParams: opts.routerParams,
+        hostPolicy: opts.hostPolicy,
+    });
+    const listener = opts.onFallback;
+    if (!listener)
+        return base;
+    return {
+        stream: base.stream,
+        resolve: (route, after) => base.resolve({
+            ...route,
+            onFallback: (info) => {
+                route.onFallback?.(info);
+                try {
+                    listener(info.error, info.to);
+                }
+                catch (listenerError) {
+                    console.warn('[agentos] onFallback listener error:', listenerError);
+                }
+            },
+        }, after),
+    };
+}
+function mergeLedger(...parts) {
+    const merged = Object.assign({}, ...parts.filter(Boolean));
+    return Object.keys(merged).length > 0 ? merged : undefined;
+}
+async function recordedUsage(ledger, sessionId) {
+    // Imported on use, as agent() imports it: the ledger reads files.
+    const { getRecordedAgentOSUsage } = await import('./runtime/usageLedger.js');
+    return getRecordedAgentOSUsage({ enabled: ledger?.enabled, path: ledger?.path, sessionId });
+}
+/**
+ * An agent whose sessions are GMIs (docs/GMI.md, "GMIs from agent()").
+ *
+ * @param opts - The options of `agent()`. `voice`, `avatar` and `channels` throw.
+ * @returns The `Agent` surface: `generate`, `stream`, `session`, `usage`, `close`, `export`.
+ * @throws {Error} At construction, naming the option: an option the GMI path
+ *   cannot honour, an unknown cognition profile or metaprompt preset, or a
+ *   `memory.embedding` that names a provider without embeddings, a model that
+ *   does not resolve, or a dimension that is not a positive integer or not known.
+ *   No environment is read here: the provider and model resolve on the first
+ *   call, which rejects with the error `agent()` gives when nothing resolves.
+ */
+export function gmi(opts) {
+    for (const key of UNSUPPORTED_ON_GMI) {
+        if (isSet(opts[key])) {
+            throw new Error(`gmi(): '${key}' is not available on the GMI path; remove it or use runtime: 'legacy'.`);
+        }
+    }
+    const deferred = getDeferredCapabilities(opts, 'gmi');
+    if (deferred.length > 0) {
+        console.warn(`[AgentOS] gmi() accepted config it does not enforce yet: ${deferred.join(', ')}.`);
+    }
+    const cognition = resolveCognition(opts);
+    const lightCognition = resolveCognition({ cognition: 'light' });
+    if (cognition.memory)
+        assertEmbeddingConfig(cognition.memory);
+    if (cognition.memory && opts.memoryProvider?.getContext) {
+        console.warn('[agentos] gmi(): cognitive memory supplies the memory context; memoryProvider.getContext is skipped (observe still runs).');
+    }
+    const tools = adaptTools(opts.tools);
+    const ledger = mergeLedger(opts.observability?.usageLedger ?? opts.usageLedger);
+    const maxSteps = opts.maxSteps ?? DEFAULT_MAX_STEPS;
+    const gateway = gatewayFor(opts);
+    const shared = retryingOnce(async () => {
+        // Throws, as generateText throws, when no provider or model resolves.
+        const persona = personaFromAgentOptions(opts, cognition, tools);
+        const lightPersona = personaFromAgentOptions(opts, lightCognition, tools);
+        const promptEngine = new PromptEngine();
+        await promptEngine.initialize(GMI_PROMPT_ENGINE_CONFIG);
+        const utilityAI = new StatisticalUtilityAI(`gmi-utility-${persona.id}`);
+        await utilityAI.initialize({ utilityId: `gmi-utility-${persona.id}` });
+        const permissions = new ToolPermissionManager();
+        await permissions.initialize({ strictCapabilityChecking: false, logToolCalls: false, toolToSubscriptionFeatures: {} });
+        const orchestrator = new ToolOrchestrator();
+        await orchestrator.initialize({ orchestratorId: `gmi-tools-${persona.id}`, defaultToolCallTimeoutMs: 30000, maxConcurrentToolCalls: 10, logToolCalls: false, globalDisabledTools: [] }, permissions, toolExecutorWithoutBuiltIns(), tools);
+        return { persona, lightPersona, promptEngine, utilityAI, tools: orchestrator };
+    });
+    const memory = retryingOnce(async () => {
+        if (!cognition.memory)
+            return undefined;
+        const { persona } = await shared.get();
+        // Reads the environment for the embedding provider when memory.embedding names none.
+        return createAgentCognitiveMemory({ persona, memory: cognition.memory, mechanisms: cognition.mechanisms });
+    });
+    async function buildGmi(id, persona, mem, steps) {
+        const s = await shared.get();
+        const step = { index: 0 };
+        let turn = { prompt: undefined, memoryContext: undefined };
+        const instance = new GMI(id);
+        const config = {
+            workingMemory: new InMemoryWorkingMemory(),
+            promptEngine: s.promptEngine,
+            llmProviderManager: new GatewayProviderManager().asProviderManager(),
+            utilityAI: s.utilityAI,
+            toolOrchestrator: hookTools(s.tools, opts.onBeforeToolExecution, step),
+            ...(mem ? { cognitiveMemory: sharedMemoryView(mem.manager) } : {}),
+            completionGateway: gateway,
+            maxToolLoopIterations: steps,
+            defaultLlmProviderId: persona.defaultProviderId,
+            defaultLlmModelId: persona.defaultModelId,
+            // Every model call: the memoryProvider block after the leading system
+            // messages (where the legacy path puts it), then onBeforeGeneration.
+            beforeModelCall: async (ctx) => {
+                step.index = ctx.stepIndex;
+                let messages = ctx.messages;
+                let changed = false;
+                if (turn.memoryContext) {
+                    let insertAt = 0;
+                    while (insertAt < messages.length && messages[insertAt].role === 'system')
+                        insertAt += 1;
+                    messages = [...messages.slice(0, insertAt), { role: 'system', content: turn.memoryContext }, ...messages.slice(insertAt)];
+                    changed = true;
+                }
+                if (opts.onBeforeGeneration) {
+                    try {
+                        const modified = await opts.onBeforeGeneration({
+                            messages: messages,
+                            system: typeof persona.baseSystemPrompt === 'string' ? persona.baseSystemPrompt : undefined,
+                            tools,
+                            model: ctx.modelId,
+                            provider: ctx.providerId,
+                            step: ctx.stepIndex,
+                            prompt: turn.prompt,
+                        });
+                        if (modified?.messages) {
+                            messages = modified.messages;
+                            changed = true;
+                        }
+                    }
+                    catch (hookError) {
+                        console.warn('[agentos] onBeforeGeneration hook error:', hookError);
+                    }
+                }
+                return changed ? messages : undefined;
+            },
+        };
+        await instance.initialize(persona, config);
+        return {
+            gmi: instance,
+            prepare: (context) => {
+                turn = context;
+            },
+        };
+    }
+    /** A GMI for one turn only, shut down once the turn ends. */
+    function forOneTurn(built) {
+        return { ...built, release: () => built.gmi.shutdown() };
+    }
+    const sessions = new Map();
+    const sessionTallies = new Map();
+    const agentTally = createEmptyUsageAggregate();
+    /** The per-call overrides as completion options; throws naming an override the GMI path does not take. */
+    function overridesOf(extra) {
+        const out = {};
+        for (const [k, v] of Object.entries(extra ?? {})) {
+            if (v === undefined)
+                continue;
+            if (!ALLOWED_CALL_OVERRIDES.has(k))
+                throw new Error(`gmi(): the per-call option '${k}' is not supported on the GMI path.`);
+            if (!ROUTE_OVERRIDES.has(k))
+                out[k] = v;
+        }
+        return out;
+    }
+    function oneShotDeps(source, extra) {
+        const callId = `${source === 'agent.generate' ? 'generate' : 'stream'}-${randomUUID()}`;
+        return {
+            sessionId: callId,
+            opts,
+            userId: callId,
+            useMemoryProviderContext: true,
+            history: null,
+            ledger: mergeLedger(ledger, extra?.usageLedger, { source: extra?.usageLedger?.source ?? source }),
+            onUsage: (u) => accumulateUsage(agentTally, u),
+            lock: new TurnLock(),
+            // generate() and stream() keep no history and run the light profile whatever the agent's (spec D10).
+            gmiFor: async () => {
+                const s = await shared.get();
+                const persona = extra && (extra.model || extra.provider)
+                    ? personaFromAgentOptions({ ...opts, model: extra.model ?? opts.model, provider: extra.provider ?? opts.provider }, lightCognition, tools)
+                    : s.lightPersona;
+                return forOneTurn(await buildGmi(`gmi-${persona.id}-${callId}`, persona, undefined, extra?.maxSteps ?? maxSteps));
+            },
+        };
+    }
+    const handle = {
+        async generate(prompt, extra) {
+            const options = overridesOf(extra);
+            return sendGmiTurn(oneShotDeps('agent.generate', extra), prompt, { options });
+        },
+        stream(prompt, extra) {
+            const options = overridesOf(extra);
+            return streamGmiTurn(oneShotDeps('agent.stream', extra), prompt, { options });
+        },
+        session(id, sessionOptions) {
+            const sessionId = id ?? randomUUID();
+            const existing = sessions.get(sessionId);
+            if (existing) {
+                if (sessionOptions?.userId !== undefined && sessionOptions.userId !== existing.userId) {
+                    throw new Error(`gmi(): session '${sessionId}' already runs as user '${existing.userId}'; close it to open it for another user.`);
+                }
+                return existing.session;
+            }
+            // Each session's memory scope is its own unless the caller names the user:
+            // sessions are often different people, and one person's facts must not
+            // reach another's replies.
+            const userId = sessionOptions?.userId ?? sessionId;
+            const history = opts.history === false ? null : new SessionHistoryBuffer({ ...SESSION_HISTORY_DEFAULTS, ...(opts.history ?? {}) });
+            if (!sessionTallies.has(sessionId))
+                sessionTallies.set(sessionId, createEmptyUsageAggregate(sessionId));
+            const tally = sessionTallies.get(sessionId);
+            const lock = new TurnLock();
+            let closing;
+            const buildSessionGmi = async (gmiId) => {
+                const { persona } = await shared.get();
+                return buildGmi(gmiId, persona, await memory.get(), maxSteps);
+            };
+            // The session's own GMI, when it keeps history; a GMI per turn otherwise.
+            const own = retryingOnce(() => buildSessionGmi(`gmi-${sessionId}`));
+            let ownBuilt;
+            // A send made after close() fails; one made before it runs, and close() waits for it.
+            const gmiFor = (closedAtCall) => async () => {
+                if (closedAtCall)
+                    throw new Error(`gmi(): session '${sessionId}' is closed; agent.session('${sessionId}') opens a new one.`);
+                if (!history)
+                    return forOneTurn(await buildSessionGmi(`gmi-${sessionId}-${randomUUID()}`));
+                ownBuilt = await own.get();
+                return ownBuilt;
+            };
+            /** Brings the session GMI's own history in line with the store once the running turn ends, so a cleared fact never reaches its sentiment tracker or metaprompts. */
+            const syncGmiHistory = () => {
+                void lock
+                    .acquire()
+                    .then((release) => {
+                    try {
+                        ownBuilt?.gmi.replaceHistory?.(transcriptToConversation(history?.messages() ?? []));
+                    }
+                    finally {
+                        release();
+                    }
+                })
+                    .catch((error) => console.warn('[agentos] gmi(): could not clear the session GMI history:', error));
+            };
+            const deps = (source) => ({
+                sessionId,
+                opts,
+                userId,
+                history,
+                lock,
+                ledger: mergeLedger(ledger, { sessionId, source }),
+                useMemoryProviderContext: !cognition.memory,
+                gmiFor: gmiFor(closing !== undefined),
+                onUsage: (u) => {
+                    accumulateUsage(tally, u);
+                    accumulateUsage(agentTally, u);
+                },
+            });
+            const session = {
+                id: sessionId,
+                send: (input, sendOpts) => {
+                    const options = Object.fromEntries(Object.entries({
+                        toolChoice: sendOpts?.toolChoice,
+                        requestTimeout: sendOpts?.requestTimeout,
+                        cacheDiagnostics: sendOpts?.cacheDiagnostics,
+                        cache: sendOpts?.cache,
+                        maxTokens: sendOpts?.maxTokens,
+                    }).filter(([, v]) => v !== undefined));
+                    return sendGmiTurn(deps('agent.session.send'), input, {
+                        options,
+                        responseSchema: sendOpts?.responseSchema,
+                        schemaName: sendOpts?.schemaName,
+                        blockLabel: sendOpts?.blockLabel,
+                    });
+                },
+                stream: (input) => streamGmiTurn(deps('agent.session.stream'), input, {}),
+                messages: () => history?.messages() ?? [],
+                reseed: (snapshot) => {
+                    if (!history)
+                        throw new Error('reseed requires session history (history: false is set on this agent)');
+                    history.reseed(snapshot);
+                    syncGmiHistory();
+                },
+                drainHistoryEvents: () => history?.drainHistoryEvents() ?? [],
+                usage: async () => {
+                    const persisted = await recordedUsage(ledger, sessionId);
+                    return ledger?.enabled ? persisted : mergeAggregates(tally, persisted);
+                },
+                clear: () => {
+                    history?.reseed([]);
+                    syncGmiHistory();
+                },
+                // A turn still running ends first and is returned to its caller, but the
+                // reseed keeps it out of the history; then the session's GMI is shut down.
+                close: () => (closing ?? (closing = (async () => {
+                    if (sessions.get(sessionId) === entry)
+                        sessions.delete(sessionId);
+                    history?.reseed([]);
+                    const release = await lock.acquire();
+                    try {
+                        const built = await own.peek()?.catch(() => undefined);
+                        await built?.gmi.shutdown();
+                    }
+                    finally {
+                        release();
+                    }
+                })())),
+            };
+            const entry = { session, userId };
+            sessions.set(sessionId, entry);
+            return session;
+        },
+        async usage(sessionId) {
+            const persisted = await recordedUsage(ledger, sessionId);
+            const inMemory = sessionId ? sessionTallies.get(sessionId) ?? createEmptyUsageAggregate(sessionId) : agentTally;
+            return ledger?.enabled ? persisted : mergeAggregates(inMemory, persisted);
+        },
+        /**
+         * Closes every session (each after its running turn), then the cognitive
+         * memory; a session opened from now on builds a new one. The tools stay as
+         * the caller passed them: the orchestrator is not shut down, because
+         * shutting it down would shut down the caller's tools.
+         */
+        async close() {
+            const pending = memory.peek();
+            memory.reset();
+            await Promise.all([...sessions.values()].map(({ session }) => session.close()));
+            const mem = await pending?.catch(() => undefined);
+            await mem?.close();
+        },
+        export(metadata, options) {
+            return exportAgentConfig(handle, metadata, options);
+        },
+        exportJSON(metadata, options) {
+            return exportAgentConfigJSON(handle, metadata, options);
+        },
+        getAvatarBindings() {
+            return {};
+        },
+        setAvatarBindingOverrides() {
+            // avatar is not available on the GMI path
+        },
+    };
+    Object.defineProperty(handle, '__config', { value: opts, enumerable: false, configurable: true });
+    return handle;
+}
+/** Alias of {@link gmi}. */
+export const createGmi = gmi;
+//# sourceMappingURL=gmi.js.map

package/dist/api/gmi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gmi.js","sourceRoot":"","sources":["../../src/api/gmi.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAIzC,OAAO,EAAE,GAAG,EAAE,MAAM,+BAA+B,CAAC;AAIpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,wDAAwD,CAAC;AAC/F,OAAO,EAAE,oBAAoB,EAAE,MAAM,uDAAuD,CAAC;AAC7F,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAG3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,oDAAoD,CAAC;AAC3F,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAGrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AACvE,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,uBAAuB,EAA0B,MAAM,gCAAgC,CAAC;AACjG,OAAO,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAC7E,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAAE,qBAAqB,EAAE,0BAA0B,EAA6B,MAAM,mCAAmC,CAAC;AACjI,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,QAAQ,EAAkF,MAAM,yBAAyB,CAAC;AAC/J,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAErF,OAAO,EAAE,eAAe,EAAE,yBAAyB,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAE5G,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAChF,OAAO,EAAE,uBAAuB,EAAE,MAAM,0CAA0C,CAAC;AAOnF,oFAAoF;AACpF,MAAM,kBAAkB,GAAG,CAAC,OAAO,EAAE,QAAQ,EAAE,UAAU,CAAU,CAAC;AACpE,oFAAoF;AACpF,MAAM,sBAAsB,GAAG,IAAI,GAAG,CAAC,CAAC,aAAa,EAAE,WAAW,EAAE,MAAM,EAAE,gBAAgB,EAAE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,aAAa,CAAC,CAAC,CAAC;AAC/I,4GAA4G;AAC5G,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,aAAa,CAAC,CAAC,CAAC;AAClF,8BAA8B;AAC9B,MAAM,iBAAiB,GAAG,CAAC,CAAC;AAE5B,MAAM,wBAAwB,GAAuB;IACnD,mBAAmB,EAAE,aAAa;IAClC,kBAAkB,EAAE,EAAE;IACtB,aAAa,EAAE,EAAE,QAAQ,EAAE,WAAW,EAAE,eAAe,EAAE,eAAe,EAAE;IAC1E,oFAAoF;IACpF,iBAAiB,EAAE,EAAE,kBAAkB,EAAE,MAAO,EAAE,mBAAmB,EAAE,MAAO,EAAE,yBAAyB,EAAE,CAAC,EAAE,yBAAyB,EAAE,IAAI,EAAE;IAC/I,iBAAiB,EAAE,EAAE,mBAAmB,EAAE,IAAI,EAAE,wBAAwB,EAAE,UAAU,EAAE,kCAAkC,EAAE,IAAI,EAAE;IAChI,0BAA0B,EAAE,EAAE,kBAAkB,EAAE,EAAE,EAAE,yBAAyB,EAAE,CAAC,EAAE,0BAA0B,EAAE,eAAe,EAAE,0BAA0B,EAAE,kBAAkB,EAAE;IACjL,WAAW,EAAE,EAAE,aAAa,EAAE,KAAK,EAAE,mBAAmB,EAAE,EAAE,EAAE;CACzC,CAAC;AAExB,SAAS,KAAK,CAAC,KAAc;IAC3B,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,KAAK,KAAK;QAAE,OAAO,KAAK,CAAC;IACnD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,IAAI,CAAC,KAAe,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;IAC9E,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;GAIG;AACH,SAAS,YAAY,CAAI,KAAuB;IAC9C,IAAI,OAA+B,CAAC;IACpC,OAAO;QACL,GAAG;YACD,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,MAAM,OAAO,GAAG,KAAK,EAAE,CAAC;gBACxB,OAAO,GAAG,OAAO,CAAC;gBAClB,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE;oBACjB,IAAI,OAAO,KAAK,OAAO;wBAAE,OAAO,GAAG,SAAS,CAAC;gBAC/C,CAAC,CAAC,CAAC;YACL,CAAC;YACD,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,IAAI,EAAE,GAAG,EAAE,CAAC,OAAO;QACnB,KAAK;YACH,OAAO,GAAG,SAAS,CAAC;QACtB,CAAC;KACF,CAAC;AACJ,CAAC;AAED,uFAAuF;AACvF,SAAS,WAAW,CAAmB,MAAS,EAAE,OAA0C;IAC1F,OAAO,IAAI,KAAK,CAAC,MAAM,EAAE;QACvB,GAAG,CAAC,CAAC,EAAE,IAAI;YACT,IAAI,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC;gBAAE,OAAQ,OAAwC,CAAC,IAAI,CAAC,CAAC;YAChH,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;YACtC,OAAO,OAAO,KAAK,KAAK,UAAU,CAAC,CAAC,CAAE,KAAyC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QAClG,CAAC;KACF,CAAC,CAAC;AACL,CAAC;AAED;;;;GAIG;AACH,SAAS,gBAAgB,CAAC,OAAgC;IACxD,OAAO,WAAW,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,KAAK,IAAI,EAAE,CAAC,SAAS,EAAE,CAAC,CAAC;AACnE,CAAC;AAED;;;;;;GAMG;AACH,MAAM,iBAAkB,SAAQ,iBAAwB;IAAxD;;QACE,sEAAsE;QACtE,yBAAoB,GAAG,KAAK,CAAC;IAM/B,CAAC;IAJU,KAAK,CAAC,QAAQ,CAAC,GAAG,IAAsD;QAC/E,IAAI,CAAC,IAAI,CAAC,oBAAoB;YAAE,OAAO;QACvC,OAAO,KAAK,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,CAAC;IACjC,CAAC;CACF;AAED,SAAS,2BAA2B;IAClC,MAAM,QAAQ,GAAG,IAAI,iBAAiB,CAAC,mBAAmB,CAAC,CAAC;IAC5D,MAAM,QAAQ,GAAG,IAAI,YAAY,CAAC,SAAS,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;IAClE,QAAQ,CAAC,oBAAoB,GAAG,IAAI,CAAC;IACrC,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;GAIG;AACH,SAAS,SAAS,CAAC,IAAuB,EAAE,IAA2C,EAAE,IAAuB;IAC9G,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IACvB,MAAM,eAAe,GAAyC,KAAK,EAAE,OAAO,EAAE,EAAE;QAC9E,MAAM,GAAG,GAAG,OAAO,CAAC,eAAe,CAAC;QACpC,IAAI,IAAI,GAA4E;YAClF,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,IAAI,EAAE,CAAC,GAAG,CAAC,SAAS,IAAI,EAAE,CAA4B;YACtD,EAAE,EAAE,GAAG,CAAC,EAAE;YACV,IAAI,EAAE,IAAI,CAAC,KAAK;SACjB,CAAC;QACF,IAAI,CAAC;YACH,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC;QAAC,OAAO,SAAS,EAAE,CAAC;YACnB,OAAO,CAAC,IAAI,CAAC,6CAA6C,EAAE,SAAS,CAAC,CAAC;QACzE,CAAC;QACD,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YAClB,OAAO;gBACL,UAAU,EAAE,GAAG,CAAC,EAAE;gBAClB,QAAQ,EAAE,GAAG,CAAC,IAAI;gBAClB,MAAM,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE;gBACzB,OAAO,EAAE,IAAI;gBACb,YAAY,EAAE,EAAE,OAAO,EAAE,uCAAuC,EAAE;aACnE,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC,eAAe,CAAC,EAAE,GAAG,OAAO,EAAE,eAAe,EAAE,EAAE,GAAG,GAAG,EAAE,SAAS,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACjG,CAAC,CAAC;IACF,OAAO,WAAW,CAAC,IAAI,EAAE,EAAE,eAAe,EAAE,CAAC,CAAC;AAChD,CAAC;AAED;;;;;GAKG;AACH,SAAS,UAAU,CAAC,IAAkB;IACpC,MAAM,IAAI,GAAG,uBAAuB,CAAC;QACnC,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;QACzC,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,UAAU,EAAE,IAAI,CAAC,UAAU;KAC5B,CAAC,CAAC;IACH,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC;IACjC,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC3B,OAAO;QACL,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CACxB,IAAI,CAAC,OAAO,CACV;YACE,GAAG,KAAK;YACR,UAAU,EAAE,CAAC,IAAI,EAAE,EAAE;gBACnB,KAAK,CAAC,UAAU,EAAE,CAAC,IAAI,CAAC,CAAC;gBACzB,IAAI,CAAC;oBACH,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;gBAChC,CAAC;gBAAC,OAAO,aAAa,EAAE,CAAC;oBACvB,OAAO,CAAC,IAAI,CAAC,sCAAsC,EAAE,aAAa,CAAC,CAAC;gBACtE,CAAC;YACH,CAAC;SACF,EACD,KAAK,CACN;KACJ,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAAC,GAAG,KAAmD;IACzE,MAAM,MAAM,GAA8B,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,GAAG,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;IACtF,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;AAC7D,CAAC;AAED,KAAK,UAAU,aAAa,CAAC,MAA6C,EAAE,SAAkB;IAC5F,kEAAkE;IAClE,MAAM,EAAE,uBAAuB,EAAE,GAAG,MAAM,MAAM,CAAC,0BAA0B,CAAC,CAAC;IAC7E,OAAO,uBAAuB,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;AAC9F,CAAC;AAwBD;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,GAAG,CAAC,IAAgB;IAClC,KAAK,MAAM,GAAG,IAAI,kBAAkB,EAAE,CAAC;QACrC,IAAI,KAAK,CAAE,IAA2C,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;YAC7D,MAAM,IAAI,KAAK,CAAC,WAAW,GAAG,yEAAyE,CAAC,CAAC;QAC3G,CAAC;IACH,CAAC;IACD,MAAM,QAAQ,GAAG,uBAAuB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACtD,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,OAAO,CAAC,IAAI,CAAC,4DAA4D,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACnG,CAAC;IACD,MAAM,SAAS,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACzC,MAAM,cAAc,GAAG,gBAAgB,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC;IAChE,IAAI,SAAS,CAAC,MAAM;QAAE,qBAAqB,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAC9D,IAAI,SAAS,CAAC,MAAM,IAAI,IAAI,CAAC,cAAc,EAAE,UAAU,EAAE,CAAC;QACxD,OAAO,CAAC,IAAI,CAAC,2HAA2H,CAAC,CAAC;IAC5I,CAAC;IACD,MAAM,KAAK,GAAY,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC9C,MAAM,MAAM,GAAG,WAAW,CAAE,IAAI,CAAC,aAAa,EAAE,WAAqD,IAAI,IAAI,CAAC,WAAW,CAAC,CAAC;IAC3H,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,iBAAiB,CAAC;IACpD,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IAEjC,MAAM,MAAM,GAAG,YAAY,CAAS,KAAK,IAAI,EAAE;QAC7C,sEAAsE;QACtE,MAAM,OAAO,GAAG,uBAAuB,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;QAChE,MAAM,YAAY,GAAG,uBAAuB,CAAC,IAAI,EAAE,cAAc,EAAE,KAAK,CAAC,CAAC;QAC1E,MAAM,YAAY,GAAG,IAAI,YAAY,EAAE,CAAC;QACxC,MAAM,YAAY,CAAC,UAAU,CAAC,wBAAwB,CAAC,CAAC;QACxD,MAAM,SAAS,GAAG,IAAI,oBAAoB,CAAC,eAAe,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC;QACxE,MAAM,SAAS,CAAC,UAAU,CAAC,EAAE,SAAS,EAAE,eAAe,OAAO,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QACvE,MAAM,WAAW,GAAG,IAAI,qBAAqB,EAAE,CAAC;QAChD,MAAM,WAAW,CAAC,UAAU,CAAC,EAAE,wBAAwB,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,0BAA0B,EAAE,EAAE,EAAE,CAAC,CAAC;QACvH,MAAM,YAAY,GAAG,IAAI,gBAAgB,EAAE,CAAC;QAC5C,MAAM,YAAY,CAAC,UAAU,CAC3B,EAAE,cAAc,EAAE,aAAa,OAAO,CAAC,EAAE,EAAE,EAAE,wBAAwB,EAAE,KAAM,EAAE,sBAAsB,EAAE,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,mBAAmB,EAAE,EAAE,EAAE,EACzJ,WAAW,EACX,2BAA2B,EAAE,EAC7B,KAAK,CACN,CAAC;QACF,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC;IACjF,CAAC,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,YAAY,CAAmC,KAAK,IAAI,EAAE;QACvE,IAAI,CAAC,SAAS,CAAC,MAAM;YAAE,OAAO,SAAS,CAAC;QACxC,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,MAAM,CAAC,GAAG,EAAE,CAAC;QACvC,qFAAqF;QACrF,OAAO,0BAA0B,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,UAAU,EAAE,SAAS,CAAC,UAAU,EAAE,CAAC,CAAC;IAC7G,CAAC,CAAC,CAAC;IAEH,KAAK,UAAU,QAAQ,CAAC,EAAU,EAAE,OAA2B,EAAE,GAAqC,EAAE,KAAa;QACnH,MAAM,CAAC,GAAG,MAAM,MAAM,CAAC,GAAG,EAAE,CAAC;QAC7B,MAAM,IAAI,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;QAC1B,IAAI,IAAI,GAAmB,EAAE,MAAM,EAAE,SAAS,EAAE,aAAa,EAAE,SAAS,EAAE,CAAC;QAC3E,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,EAAE,CAAC,CAAC;QAC7B,MAAM,MAAM,GAAkB;YAC5B,aAAa,EAAE,IAAI,qBAAqB,EAAE;YAC1C,YAAY,EAAE,CAAC,CAAC,YAAY;YAC5B,kBAAkB,EAAE,IAAI,sBAAsB,EAAE,CAAC,iBAAiB,EAAE;YACpE,SAAS,EAAE,CAAC,CAAC,SAAS;YACtB,gBAAgB,EAAE,SAAS,CAAC,CAAC,CAAC,KAAK,EAAE,IAAI,CAAC,qBAAqB,EAAE,IAAI,CAAC;YACtE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,gBAAgB,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAClE,iBAAiB,EAAE,OAAO;YAC1B,qBAAqB,EAAE,KAAK;YAC5B,oBAAoB,EAAE,OAAO,CAAC,iBAAiB;YAC/C,iBAAiB,EAAE,OAAO,CAAC,cAAc;YACzC,sEAAsE;YACtE,qEAAqE;YACrE,eAAe,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;gBAC7B,IAAI,CAAC,KAAK,GAAG,GAAG,CAAC,SAAS,CAAC;gBAC3B,IAAI,QAAQ,GAAkB,GAAG,CAAC,QAAQ,CAAC;gBAC3C,IAAI,OAAO,GAAG,KAAK,CAAC;gBACpB,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;oBACvB,IAAI,QAAQ,GAAG,CAAC,CAAC;oBACjB,OAAO,QAAQ,GAAG,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,QAAQ,CAAC,CAAC,IAAI,KAAK,QAAQ;wBAAE,QAAQ,IAAI,CAAC,CAAC;oBACzF,QAAQ,GAAG,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,aAAa,EAAE,EAAE,GAAG,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;oBAC1H,OAAO,GAAG,IAAI,CAAC;gBACjB,CAAC;gBACD,IAAI,IAAI,CAAC,kBAAkB,EAAE,CAAC;oBAC5B,IAAI,CAAC;wBACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC;4BAC7C,QAAQ,EAAE,QAAgC;4BAC1C,MAAM,EAAE,OAAO,OAAO,CAAC,gBAAgB,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,SAAS;4BAC3F,KAAK;4BACL,KAAK,EAAE,GAAG,CAAC,OAAO;4BAClB,QAAQ,EAAE,GAAG,CAAC,UAAU;4BACxB,IAAI,EAAE,GAAG,CAAC,SAAS;4BACnB,MAAM,EAAE,IAAI,CAAC,MAAM;yBACpB,CAAC,CAAC;wBACH,IAAI,QAAQ,EAAE,QAAQ,EAAE,CAAC;4BACvB,QAAQ,GAAG,QAAQ,CAAC,QAAoC,CAAC;4BACzD,OAAO,GAAG,IAAI,CAAC;wBACjB,CAAC;oBACH,CAAC;oBAAC,OAAO,SAAS,EAAE,CAAC;wBACnB,OAAO,CAAC,IAAI,CAAC,0CAA0C,EAAE,SAAS,CAAC,CAAC;oBACtE,CAAC;gBACH,CAAC;gBACD,OAAO,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;YACxC,CAAC;SACF,CAAC;QACF,MAAM,QAAQ,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC3C,OAAO;YACL,GAAG,EAAE,QAAQ;YACb,OAAO,EAAE,CAAC,OAAO,EAAE,EAAE;gBACnB,IAAI,GAAG,OAAO,CAAC;YACjB,CAAC;SACF,CAAC;IACJ,CAAC;IAED,6DAA6D;IAC7D,SAAS,UAAU,CAAC,KAAe;QACjC,OAAO,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,CAAC;IAC3D,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAwB,CAAC;IACjD,MAAM,cAAc,GAAG,IAAI,GAAG,EAAiC,CAAC;IAChE,MAAM,UAAU,GAAG,yBAAyB,EAAE,CAAC;IAE/C,0GAA0G;IAC1G,SAAS,WAAW,CAAC,KAAoC;QACvD,MAAM,GAAG,GAA4B,EAAE,CAAC;QACxC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,CAAC;YACjD,IAAI,CAAC,KAAK,SAAS;gBAAE,SAAS;YAC9B,IAAI,CAAC,sBAAsB,CAAC,GAAG,CAAC,CAAC,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,qCAAqC,CAAC,CAAC;YAC3H,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC;gBAAE,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QAC1C,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAED,SAAS,WAAW,CAAC,MAAyC,EAAE,KAAoC;QAClG,MAAM,MAAM,GAAG,GAAG,MAAM,KAAK,gBAAgB,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ,IAAI,UAAU,EAAE,EAAE,CAAC;QACxF,OAAO;YACL,SAAS,EAAE,MAAM;YACjB,IAAI;YACJ,MAAM,EAAE,MAAM;YACd,wBAAwB,EAAE,IAAI;YAC9B,OAAO,EAAE,IAAI;YACb,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,IAAI,MAAM,EAAE,CAAC;YACjG,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,UAAU,EAAE,CAAC,CAAC;YAC9C,IAAI,EAAE,IAAI,QAAQ,EAAE;YACpB,qGAAqG;YACrG,MAAM,EAAE,KAAK,IAAI,EAAE;gBACjB,MAAM,CAAC,GAAG,MAAM,MAAM,CAAC,GAAG,EAAE,CAAC;gBAC7B,MAAM,OAAO,GAAG,KAAK,IAAI,CAAC,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,QAAQ,CAAC;oBACtD,CAAC,CAAC,uBAAuB,CAAC,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,IAAI,CAAC,QAAQ,EAAE,EAAE,cAAc,EAAE,KAAK,CAAC;oBAC1I,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC;gBACnB,OAAO,UAAU,CAAC,MAAM,QAAQ,CAAC,OAAO,OAAO,CAAC,EAAE,IAAI,MAAM,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,IAAI,QAAQ,CAAC,CAAC,CAAC;YACpH,CAAC;SACF,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAU;QACpB,KAAK,CAAC,QAAQ,CAAC,MAAsB,EAAE,KAAoC;YACzE,MAAM,OAAO,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;YACnC,OAAO,WAAW,CAAC,WAAW,CAAC,gBAAgB,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QAChF,CAAC;QAED,MAAM,CAAC,MAAsB,EAAE,KAAoC;YACjE,MAAM,OAAO,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;YACnC,OAAO,aAAa,CAAC,WAAW,CAAC,cAAc,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QAChF,CAAC;QAED,OAAO,CAAC,EAAW,EAAE,cAAoC;YACvD,MAAM,SAAS,GAAG,EAAE,IAAI,UAAU,EAAE,CAAC;YACrC,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YACzC,IAAI,QAAQ,EAAE,CAAC;gBACb,IAAI,cAAc,EAAE,MAAM,KAAK,SAAS,IAAI,cAAc,CAAC,MAAM,KAAK,QAAQ,CAAC,MAAM,EAAE,CAAC;oBACtF,MAAM,IAAI,KAAK,CAAC,mBAAmB,SAAS,2BAA2B,QAAQ,CAAC,MAAM,0CAA0C,CAAC,CAAC;gBACpI,CAAC;gBACD,OAAO,QAAQ,CAAC,OAAO,CAAC;YAC1B,CAAC;YACD,2EAA2E;YAC3E,uEAAuE;YACvE,2BAA2B;YAC3B,MAAM,MAAM,GAAG,cAAc,EAAE,MAAM,IAAI,SAAS,CAAC;YACnD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,oBAAoB,CAAC,EAAE,GAAG,wBAAwB,EAAE,GAAG,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;YACnI,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,SAAS,CAAC;gBAAE,cAAc,CAAC,GAAG,CAAC,SAAS,EAAE,yBAAyB,CAAC,SAAS,CAAC,CAAC,CAAC;YACxG,MAAM,KAAK,GAAG,cAAc,CAAC,GAAG,CAAC,SAAS,CAAE,CAAC;YAC7C,MAAM,IAAI,GAAG,IAAI,QAAQ,EAAE,CAAC;YAC5B,IAAI,OAAkC,CAAC;YAEvC,MAAM,eAAe,GAAG,KAAK,EAAE,KAAa,EAAqB,EAAE;gBACjE,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,MAAM,CAAC,GAAG,EAAE,CAAC;gBACvC,OAAO,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC,GAAG,EAAE,EAAE,QAAQ,CAAC,CAAC;YAChE,CAAC,CAAC;YACF,0EAA0E;YAC1E,MAAM,GAAG,GAAG,YAAY,CAAC,GAAG,EAAE,CAAC,eAAe,CAAC,OAAO,SAAS,EAAE,CAAC,CAAC,CAAC;YACpE,IAAI,QAA8B,CAAC;YAEnC,sFAAsF;YACtF,MAAM,MAAM,GAAG,CAAC,YAAqB,EAAE,EAAE,CAAC,KAAK,IAAyB,EAAE;gBACxE,IAAI,YAAY;oBAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,SAAS,+BAA+B,SAAS,qBAAqB,CAAC,CAAC;gBAC7H,IAAI,CAAC,OAAO;oBAAE,OAAO,UAAU,CAAC,MAAM,eAAe,CAAC,OAAO,SAAS,IAAI,UAAU,EAAE,EAAE,CAAC,CAAC,CAAC;gBAC3F,QAAQ,GAAG,MAAM,GAAG,CAAC,GAAG,EAAE,CAAC;gBAC3B,OAAO,QAAQ,CAAC;YAClB,CAAC,CAAC;YAEF,oKAAoK;YACpK,MAAM,cAAc,GAAG,GAAS,EAAE;gBAChC,KAAK,IAAI;qBACN,OAAO,EAAE;qBACT,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE;oBAChB,IAAI,CAAC;wBACH,QAAQ,EAAE,GAAG,CAAC,cAAc,EAAE,CAAC,wBAAwB,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;oBACtF,CAAC;4BAAS,CAAC;wBACT,OAAO,EAAE,CAAC;oBACZ,CAAC;gBACH,CAAC,CAAC;qBACD,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,2DAA2D,EAAE,KAAK,CAAC,CAAC,CAAC;YACjH,CAAC,CAAC;YAEF,MAAM,IAAI,GAAG,CAAC,MAAqD,EAAkB,EAAE,CAAC,CAAC;gBACvF,SAAS;gBACT,IAAI;gBACJ,MAAM;gBACN,OAAO;gBACP,IAAI;gBACJ,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;gBAClD,wBAAwB,EAAE,CAAC,SAAS,CAAC,MAAM;gBAC3C,MAAM,EAAE,MAAM,CAAC,OAAO,KAAK,SAAS,CAAC;gBACrC,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE;oBACb,eAAe,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;oBAC1B,eAAe,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;gBACjC,CAAC;aACF,CAAC,CAAC;YAEH,MAAM,OAAO,GAAG;gBACd,EAAE,EAAE,SAAS;gBACb,IAAI,EAAE,CAAC,KAAqB,EAAE,QAA+D,EAAE,EAAE;oBAC/F,MAAM,OAAO,GAAG,MAAM,CAAC,WAAW,CAChC,MAAM,CAAC,OAAO,CAAC;wBACb,UAAU,EAAE,QAAQ,EAAE,UAAU;wBAChC,cAAc,EAAE,QAAQ,EAAE,cAAc;wBACxC,gBAAgB,EAAE,QAAQ,EAAE,gBAAgB;wBAC5C,KAAK,EAAE,QAAQ,EAAE,KAAK;wBACtB,SAAS,EAAE,QAAQ,EAAE,SAAS;qBAC/B,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC,CACtC,CAAC;oBACF,OAAO,WAAW,CAAC,IAAI,CAAC,oBAAoB,CAAC,EAAE,KAAK,EAAE;wBACpD,OAAO;wBACP,cAAc,EAAE,QAAQ,EAAE,cAAc;wBACxC,UAAU,EAAE,QAAQ,EAAE,UAAU;wBAChC,UAAU,EAAE,QAAQ,EAAE,UAAU;qBACjC,CAAC,CAAC;gBACL,CAAC;gBACD,MAAM,EAAE,CAAC,KAAqB,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,sBAAsB,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC;gBACzF,QAAQ,EAAE,GAA+B,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE;gBACrE,MAAM,EAAE,CAAC,QAAoC,EAAE,EAAE;oBAC/C,IAAI,CAAC,OAAO;wBAAE,MAAM,IAAI,KAAK,CAAC,uEAAuE,CAAC,CAAC;oBACvG,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;oBACzB,cAAc,EAAE,CAAC;gBACnB,CAAC;gBACD,kBAAkB,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,kBAAkB,EAAE,IAAI,EAAE;gBAC7D,KAAK,EAAE,KAAK,IAAI,EAAE;oBAChB,MAAM,SAAS,GAAG,MAAM,aAAa,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;oBACzD,OAAO,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,eAAe,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;gBACzE,CAAC;gBACD,KAAK,EAAE,GAAG,EAAE;oBACV,OAAO,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;oBACpB,cAAc,EAAE,CAAC;gBACnB,CAAC;gBACD,yEAAyE;gBACzE,2EAA2E;gBAC3E,KAAK,EAAE,GAAG,EAAE,CACV,CAAC,OAAO,KAAP,OAAO,GAAK,CAAC,KAAK,IAAI,EAAE;oBACvB,IAAI,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,KAAK;wBAAE,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;oBAClE,OAAO,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;oBACpB,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;oBACrC,IAAI,CAAC;wBACH,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;wBACvD,MAAM,KAAK,EAAE,GAAG,CAAC,QAAQ,EAAE,CAAC;oBAC9B,CAAC;4BAAS,CAAC;wBACT,OAAO,EAAE,CAAC;oBACZ,CAAC;gBACH,CAAC,CAAC,EAAE,EAAC;aACmB,CAAC;YAC7B,MAAM,KAAK,GAAiB,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;YAChD,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;YAC/B,OAAO,OAAO,CAAC;QACjB,CAAC;QAED,KAAK,CAAC,KAAK,CAAC,SAAkB;YAC5B,MAAM,SAAS,GAAG,MAAM,aAAa,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;YACzD,MAAM,QAAQ,GAAG,SAAS,CAAC,CAAC,CAAC,cAAc,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,yBAAyB,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC;YAChH,OAAO,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,eAAe,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;QAC5E,CAAC;QAED;;;;;WAKG;QACH,KAAK,CAAC,KAAK;YACT,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;YAC9B,MAAM,CAAC,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;YAChF,MAAM,GAAG,GAAG,MAAM,OAAO,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;YAClD,MAAM,GAAG,EAAE,KAAK,EAAE,CAAC;QACrB,CAAC;QAED,MAAM,CAAC,QAAQ,EAAE,OAAO;YACtB,OAAO,iBAAiB,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;QACtD,CAAC;QACD,UAAU,CAAC,QAAQ,EAAE,OAAO;YAC1B,OAAO,qBAAqB,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC1D,CAAC;QACD,iBAAiB;YACf,OAAO,EAA4C,CAAC;QACtD,CAAC;QACD,yBAAyB;YACvB,0CAA0C;QAC5C,CAAC;KACF,CAAC;IACF,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC;IAClG,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,4BAA4B;AAC5B,MAAM,CAAC,MAAM,SAAS,GAAG,GAAG,CAAC"}

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

@@ -0,0 +1,82 @@
+/**
+ * @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 type { CognitiveMechanismsConfig } from '../../cognition/memory/mechanisms/types.js';
+import type { IPersonaDefinition } from '../../cognition/substrate/personas/IPersonaDefinition.js';
+import type { IEmbeddingManager } from '../../core/embeddings/IEmbeddingManager.js';
+import type { MemoryConfig } from '../types.js';
+type Env = Readonly<Record<string, string | undefined>>;
+/**
+ * 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 declare function assertEmbeddingAvailable(memory: MemoryConfig, env?: Env): void;
+/**
+ * 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 declare function assertEmbeddingConfig(memory: MemoryConfig): void;
+export interface AgentCognitiveMemoryOptions {
+    /** The agent's persona: its id is the memory's owner (`agentId`), its traits shape encoding. */
+    persona: IPersonaDefinition;
+    memory: MemoryConfig;
+    /** The memory mechanisms to run; none when undefined. */
+    mechanisms?: CognitiveMechanismsConfig;
+    /**
+     * An embedding manager to use instead of one built from `memory.embedding`
+     * (tests, and hosts that own one). The caller keeps ownership: `close()` does not shut it down.
+     */
+    embeddingManager?: IEmbeddingManager;
+}
+export interface AgentCognitiveMemory {
+    manager: CognitiveMemoryManager;
+    /**
+     * Shuts the manager down and releases the vector store and the embedding
+     * manager this builder created. Later calls return the first call's promise.
+     */
+    close(): Promise<void>;
+}
+/**
+ * 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 declare function createAgentCognitiveMemory(opts: AgentCognitiveMemoryOptions): Promise<AgentCognitiveMemory>;
+export {};
+//# sourceMappingURL=agentCognitiveMemory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agentCognitiveMemory.d.ts","sourceRoot":"","sources":["../../../src/api/runtime/agentCognitiveMemory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,sBAAsB,EAAE,MAAM,kDAAkD,CAAC;AAE1F,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,4CAA4C,CAAC;AAM5F,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0DAA0D,CAAC;AAEnG,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4CAA4C,CAAC;AAGpF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AA+BhD,KAAK,GAAG,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;AA4ExD;;;;;;;;;;;;GAYG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,GAAE,GAAiB,GAAG,IAAI,CAE3F;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAMhE;AAED,MAAM,WAAW,2BAA2B;IAC1C,gGAAgG;IAChG,OAAO,EAAE,kBAAkB,CAAC;IAC5B,MAAM,EAAE,YAAY,CAAC;IACrB,yDAAyD;IACzD,UAAU,CAAC,EAAE,yBAAyB,CAAC;IACvC;;;OAGG;IACH,gBAAgB,CAAC,EAAE,iBAAiB,CAAC;CACtC;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,sBAAsB,CAAC;IAChC;;;OAGG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAgFD;;;;;;;;;GASG;AACH,wBAAsB,0BAA0B,CAAC,IAAI,EAAE,2BAA2B,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAgEjH"}