cortex-engine 0.1.0

package/dist/engines/memory.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Memory engine — prediction error gating, HyDE query expansion,
+ * spreading activation, and memory conversion utilities.
+ *
+ * Pure cognitive functions — no storage imports, no side effects.
+ * All state access goes through CortexStore / providers passed as arguments.
+ */
+import type { CortexStore } from '../core/store.js';
+import type { EmbedProvider } from '../core/embed.js';
+import type { LLMProvider } from '../core/llm.js';
+import type { Memory, MemorySummary, SearchResult, ActivationResult, GateResult } from '../core/types.js';
+/** Similarity threshold above which a new observation is treated as a duplicate. */
+export declare const SIMILARITY_MERGE = 0.85;
+/** Similarity threshold above which a new observation is linked to an existing memory. */
+export declare const SIMILARITY_LINK = 0.5;
+/** Activation score decay factor per hop during spreading activation. */
+export declare const ACTIVATION_DECAY = 0.5;
+/** Maximum BFS depth for spreading activation traversal. */
+export declare const MAX_ACTIVATION_DEPTH = 2;
+/**
+ * Determine how a new observation should be ingested based on similarity
+ * to existing memories.
+ *
+ * - merge (>mergeThreshold): too similar to existing memory (duplicate risk)
+ * - link (>linkThreshold): moderately similar — store and link as related
+ * - novel: nothing close — candidate for a new memory concept
+ *
+ * Thresholds can be overridden per namespace via config.
+ */
+export declare function predictionErrorGate(store: CortexStore, embedding: number[], thresholds?: {
+    merge?: number;
+    link?: number;
+}): Promise<GateResult>;
+/**
+ * Expand a user query using Hypothetical Document Embeddings (HyDE).
+ *
+ * Instead of embedding the raw query, asks the LLM to generate a
+ * hypothetical passage that would answer the query, then embeds THAT.
+ * This dramatically improves recall for concept-level questions.
+ */
+export declare function hydeExpand(query: string, llm: LLMProvider, embed: EmbedProvider): Promise<number[]>;
+/**
+ * Starting from a set of initial search results, traverse edges to activate
+ * related concepts via BFS. Returns primary results augmented with activated
+ * neighbors, ranked by combined activation score.
+ *
+ * Activation decays by ACTIVATION_DECAY (0.5) per hop, weighted by edge weight.
+ * Max depth defaults to 2 hops.
+ */
+export declare function spreadActivation(store: CortexStore, initial: SearchResult[], depth?: number): Promise<ActivationResult[]>;
+/**
+ * Convert a full Memory to a MemorySummary (strips embedding and other large fields).
+ */
+export declare function memoryToSummary(memory: Memory): MemorySummary;
+//# sourceMappingURL=memory.d.ts.map

package/dist/engines/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../src/engines/memory.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EACV,MAAM,EACN,aAAa,EACb,YAAY,EACZ,gBAAgB,EAChB,UAAU,EAEX,MAAM,kBAAkB,CAAC;AAI1B,oFAAoF;AACpF,eAAO,MAAM,gBAAgB,OAAO,CAAC;AAErC,0FAA0F;AAC1F,eAAO,MAAM,eAAe,MAAO,CAAC;AAEpC,yEAAyE;AACzE,eAAO,MAAM,gBAAgB,MAAM,CAAC;AAEpC,4DAA4D;AAC5D,eAAO,MAAM,oBAAoB,IAAI,CAAC;AAItC;;;;;;;;;GASG;AACH,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,WAAW,EAClB,SAAS,EAAE,MAAM,EAAE,EACnB,UAAU,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7C,OAAO,CAAC,UAAU,CAAC,CAkCrB;AAED;;;;;;GAMG;AACH,wBAAsB,UAAU,CAC9B,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,aAAa,GACnB,OAAO,CAAC,MAAM,EAAE,CAAC,CAWnB;AAED;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,WAAW,EAClB,OAAO,EAAE,YAAY,EAAE,EACvB,KAAK,GAAE,MAA6B,GACnC,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAsD7B;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,CAc7D"}

package/dist/engines/memory.js

@@ -0,0 +1,147 @@
+/**
+ * Memory engine — prediction error gating, HyDE query expansion,
+ * spreading activation, and memory conversion utilities.
+ *
+ * Pure cognitive functions — no storage imports, no side effects.
+ * All state access goes through CortexStore / providers passed as arguments.
+ */
+// ─── Constants ────────────────────────────────────────────────────────────────
+/** Similarity threshold above which a new observation is treated as a duplicate. */
+export const SIMILARITY_MERGE = 0.85;
+/** Similarity threshold above which a new observation is linked to an existing memory. */
+export const SIMILARITY_LINK = 0.50;
+/** Activation score decay factor per hop during spreading activation. */
+export const ACTIVATION_DECAY = 0.5;
+/** Maximum BFS depth for spreading activation traversal. */
+export const MAX_ACTIVATION_DEPTH = 2;
+// ─── Functions ────────────────────────────────────────────────────────────────
+/**
+ * Determine how a new observation should be ingested based on similarity
+ * to existing memories.
+ *
+ * - merge (>mergeThreshold): too similar to existing memory (duplicate risk)
+ * - link (>linkThreshold): moderately similar — store and link as related
+ * - novel: nothing close — candidate for a new memory concept
+ *
+ * Thresholds can be overridden per namespace via config.
+ */
+export async function predictionErrorGate(store, embedding, thresholds) {
+    const mergeThreshold = thresholds?.merge ?? SIMILARITY_MERGE;
+    const linkThreshold = thresholds?.link ?? SIMILARITY_LINK;
+    const results = await store.findNearest(embedding, 5);
+    if (results.length === 0) {
+        return { decision: 'novel', max_similarity: 0 };
+    }
+    let maxSimilarity = 0;
+    let nearestId = '';
+    for (const result of results) {
+        if (result.score > maxSimilarity) {
+            maxSimilarity = result.score;
+            nearestId = result.memory.id;
+        }
+    }
+    let decision;
+    if (maxSimilarity > mergeThreshold) {
+        decision = 'merge';
+    }
+    else if (maxSimilarity > linkThreshold) {
+        decision = 'link';
+    }
+    else {
+        decision = 'novel';
+    }
+    return {
+        decision,
+        nearest_id: decision !== 'novel' ? nearestId : undefined,
+        max_similarity: maxSimilarity,
+    };
+}
+/**
+ * Expand a user query using Hypothetical Document Embeddings (HyDE).
+ *
+ * Instead of embedding the raw query, asks the LLM to generate a
+ * hypothetical passage that would answer the query, then embeds THAT.
+ * This dramatically improves recall for concept-level questions.
+ */
+export async function hydeExpand(query, llm, embed) {
+    const hypothetical = await llm.generate(`Write a short, factual passage (2-3 sentences) that would answer this question or describe this concept. Do not include any preamble — just the passage.\n\nQuery: ${query}`, {
+        temperature: 0.3,
+        maxTokens: 200,
+        systemPrompt: 'You are a knowledge retrieval assistant. Generate hypothetical document passages for semantic search.',
+    });
+    return embed.embed(hypothetical);
+}
+/**
+ * Starting from a set of initial search results, traverse edges to activate
+ * related concepts via BFS. Returns primary results augmented with activated
+ * neighbors, ranked by combined activation score.
+ *
+ * Activation decays by ACTIVATION_DECAY (0.5) per hop, weighted by edge weight.
+ * Max depth defaults to 2 hops.
+ */
+export async function spreadActivation(store, initial, depth = MAX_ACTIVATION_DEPTH) {
+    const activated = new Map();
+    // Seed with initial matches
+    for (const result of initial) {
+        activated.set(result.memory.id, {
+            ...result,
+            hop_count: 0,
+            activation_path: [result.memory.id],
+        });
+    }
+    // BFS traversal
+    async function traverse(ids, currentDepth) {
+        if (currentDepth >= depth || ids.length === 0)
+            return;
+        // Get all edges from current frontier (batch)
+        const edges = await store.getEdgesForMemories(ids);
+        const nextIds = [];
+        for (const edge of edges) {
+            // Only follow forward edges (source_id in our frontier)
+            if (!ids.includes(edge.source_id))
+                continue;
+            const sourceResult = activated.get(edge.source_id);
+            if (!sourceResult)
+                continue;
+            const propagatedScore = sourceResult.score * ACTIVATION_DECAY * edge.weight;
+            const targetId = edge.target_id;
+            const existing = activated.get(targetId);
+            if (!existing || existing.score < propagatedScore) {
+                const memory = await store.getMemory(targetId);
+                if (!memory)
+                    continue;
+                activated.set(targetId, {
+                    memory: memoryToSummary(memory),
+                    score: propagatedScore,
+                    distance: 1 - propagatedScore,
+                    hop_count: currentDepth + 1,
+                    activation_path: [...sourceResult.activation_path, targetId],
+                });
+                nextIds.push(targetId);
+            }
+        }
+        await traverse(nextIds, currentDepth + 1);
+    }
+    await traverse(initial.map((r) => r.memory.id), 0);
+    return Array.from(activated.values())
+        .sort((a, b) => b.score - a.score);
+}
+/**
+ * Convert a full Memory to a MemorySummary (strips embedding and other large fields).
+ */
+export function memoryToSummary(memory) {
+    return {
+        id: memory.id,
+        name: memory.name,
+        definition: memory.definition,
+        category: memory.category,
+        salience: memory.salience,
+        confidence: memory.confidence,
+        access_count: memory.access_count,
+        updated_at: memory.updated_at,
+        tags: memory.tags,
+        fsrs: memory.fsrs,
+        provenance: memory.provenance,
+    };
+}
+//# sourceMappingURL=memory.js.map

package/dist/engines/memory.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,42 @@
+/**
+ * cortex-engine — portable cognitive engine for AI agents.
+ *
+ * Public API surface. Everything exported here is part of the stable API.
+ */
+export type { CortexStore } from './core/store.js';
+export type { EmbedProvider } from './core/embed.js';
+export type { LLMProvider, GenerateOptions, GenerateJSONOptions } from './core/llm.js';
+export type { NLIProvider, NLIResult, NLILabel } from './core/nli.js';
+export type { CortexConfig, AgentConfig, NamespaceConfig, IngestionTriggerConfig, BridgeConfig, BridgeRuleConfig, ModelProvenanceConfig, BenchmarkConfig, } from './core/config.js';
+export { DEFAULT_CONFIG } from './core/config.js';
+export { Session } from './core/session.js';
+export type { Memory, MemorySummary, MemoryCategory, FSRSData, FSRSState, Edge, EdgeRelation, Observation, OpsEntry, OpsEntryType, OpsStatus, OpsFilters, Signal, SignalType, BeliefEntry, SearchResult, ActivationResult, IngestDecision, GateResult, ScheduleResult, ModelProvenance, ConfidenceTier, QueryFilter, } from './core/types.js';
+export { retrievability, scheduleNext, initialStability, FSRS_WEIGHTS, DESIRED_RETENTION, } from './engines/fsrs.js';
+export { extractKeywords } from './engines/keywords.js';
+export { predictionErrorGate, hydeExpand, spreadActivation, memoryToSummary, SIMILARITY_MERGE, SIMILARITY_LINK, ACTIVATION_DECAY, MAX_ACTIVATION_DEPTH, } from './engines/memory.js';
+export { dreamConsolidate } from './engines/cognition.js';
+export type { DreamResult, DreamOptions } from './engines/cognition.js';
+export { digestDocument } from './engines/digest.js';
+export type { DigestOptions, DigestResult } from './engines/digest.js';
+export { SqliteCortexStore } from './stores/sqlite.js';
+export { FirestoreCortexStore } from './stores/firestore.js';
+export type { FirestoreStoreOptions } from './stores/firestore.js';
+export { ScopedStore } from './namespace/scoped-store.js';
+export { NamespaceManager } from './namespace/manager.js';
+export { OllamaEmbedProvider, OllamaLLMProvider } from './providers/ollama.js';
+export type { VertexEmbedOptions, VertexEmbedTaskType } from './providers/vertex-embed.js';
+export type { VertexLLMOptions } from './providers/vertex-llm.js';
+export { LocalNLIProvider, nliToCortexVerdict } from './providers/nli-http.js';
+export { TriggerRegistry } from './triggers/registry.js';
+export type { ResolvedTrigger } from './triggers/registry.js';
+export { executeIngestionPipeline } from './triggers/pipeline.js';
+export type { ToolHandler, PipelineResult, PipelineStepResult } from './triggers/pipeline.js';
+export { BridgeRegistry } from './bridges/registry.js';
+export type { ResolvedBridgeRule } from './bridges/registry.js';
+export { evaluateCondition, interpolateTemplate, checkBridges } from './bridges/bridge.js';
+export type { BridgeContext, BridgeResult } from './bridges/bridge.js';
+export { createServer, startServer } from './mcp/server.js';
+export { createTools, CORE_TOOLS } from './mcp/tools.js';
+export type { ToolDefinition, ToolContext, ToolPlugin } from './mcp/tools.js';
+export { loadPlugins } from './plugins/loader.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,38 @@
+/**
+ * cortex-engine — portable cognitive engine for AI agents.
+ *
+ * Public API surface. Everything exported here is part of the stable API.
+ */
+export { DEFAULT_CONFIG } from './core/config.js';
+// Session & provenance
+export { Session } from './core/session.js';
+// Engines (pure functions, storage-agnostic)
+export { retrievability, scheduleNext, initialStability, FSRS_WEIGHTS, DESIRED_RETENTION, } from './engines/fsrs.js';
+export { extractKeywords } from './engines/keywords.js';
+export { predictionErrorGate, hydeExpand, spreadActivation, memoryToSummary, SIMILARITY_MERGE, SIMILARITY_LINK, ACTIVATION_DECAY, MAX_ACTIVATION_DEPTH, } from './engines/memory.js';
+export { dreamConsolidate } from './engines/cognition.js';
+export { digestDocument } from './engines/digest.js';
+// Stores
+export { SqliteCortexStore } from './stores/sqlite.js';
+export { FirestoreCortexStore } from './stores/firestore.js';
+// Namespace
+export { ScopedStore } from './namespace/scoped-store.js';
+export { NamespaceManager } from './namespace/manager.js';
+// Providers — only always-available providers are re-exported as values.
+// Vertex providers use optional peer deps and must be imported directly
+// from 'cortex-engine/providers/vertex-embed' or 'cortex-engine/providers/vertex-llm'
+// to avoid breaking consumers who don't install @google-cloud/*.
+export { OllamaEmbedProvider, OllamaLLMProvider } from './providers/ollama.js';
+export { LocalNLIProvider, nliToCortexVerdict } from './providers/nli-http.js';
+// Triggers
+export { TriggerRegistry } from './triggers/registry.js';
+export { executeIngestionPipeline } from './triggers/pipeline.js';
+// Bridges
+export { BridgeRegistry } from './bridges/registry.js';
+export { evaluateCondition, interpolateTemplate, checkBridges } from './bridges/bridge.js';
+// MCP server
+export { createServer, startServer } from './mcp/server.js';
+export { createTools, CORE_TOOLS } from './mcp/tools.js';
+// Plugins
+export { loadPlugins } from './plugins/loader.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAmBH,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,uBAAuB;AACvB,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AA6B5C,6CAA6C;AAC7C,OAAO,EACL,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,YAAY,EACZ,iBAAiB,GAClB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,OAAO,EACL,mBAAmB,EACnB,UAAU,EACV,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAG1D,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAGrD,SAAS;AACT,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAI7D,YAAY;AACZ,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE1D,yEAAyE;AACzE,wEAAwE;AACxE,sFAAsF;AACtF,iEAAiE;AACjE,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAG/E,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE/E,WAAW;AACX,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAGlE,UAAU;AACV,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAG3F,aAAa;AACb,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAGzD,UAAU;AACV,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/mcp/server.d.ts

@@ -0,0 +1,12 @@
+/**
+ * MCP Server for cortex-engine.
+ *
+ * Wires providers, stores, namespaces, triggers, and bridges together
+ * and exposes them as MCP tools over stdio.
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import type { CortexConfig } from '../core/config.js';
+export declare function createServer(config: CortexConfig): Promise<Server>;
+/** Start the MCP server using stdio transport. Called by bin/serve.ts. */
+export declare function startServer(config: CortexConfig): Promise<void>;
+//# sourceMappingURL=server.d.ts.map

package/dist/mcp/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAMnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAgBtD,wBAAsB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAyGxE;AAID,0EAA0E;AAC1E,wBAAsB,WAAW,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAIrE"}

package/dist/mcp/server.js

@@ -0,0 +1,173 @@
+/**
+ * MCP Server for cortex-engine.
+ *
+ * Wires providers, stores, namespaces, triggers, and bridges together
+ * and exposes them as MCP tools over stdio.
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { Session } from '../core/session.js';
+import { NamespaceManager } from '../namespace/manager.js';
+import { TriggerRegistry } from '../triggers/registry.js';
+import { BridgeRegistry } from '../bridges/registry.js';
+import { SqliteCortexStore } from '../stores/sqlite.js';
+import { FirestoreCortexStore } from '../stores/firestore.js';
+import { OllamaEmbedProvider, OllamaLLMProvider } from '../providers/ollama.js';
+import { createTools, CORE_TOOLS } from './tools.js';
+import { loadPlugins } from '../plugins/loader.js';
+// ─── Server Factory ───────────────────────────────────────────────────────────
+export async function createServer(config) {
+    // 1. Create providers based on config (async — vertex uses dynamic imports)
+    const embed = await createEmbedProvider(config);
+    const llm = await createLLMProvider(config);
+    // 2. Pre-initialize store backend (async for Firestore dynamic import)
+    const firestoreInit = config.store === 'firestore'
+        ? await initFirestoreDb(config)
+        : null;
+    // 3. Create namespace manager with store factory
+    const namespaces = new NamespaceManager(config, (_namespace, prefix) => {
+        if (config.store === 'sqlite') {
+            return new SqliteCortexStore(config.store_options?.sqlite_path ?? './cortex.db', prefix);
+        }
+        if (config.store === 'firestore') {
+            return new FirestoreCortexStore(firestoreInit.db, prefix, firestoreInit.FieldValue);
+        }
+        throw new Error(`Unsupported store: ${config.store}`);
+    });
+    // 4. Create registries
+    const triggers = new TriggerRegistry(config.namespaces);
+    const bridges = new BridgeRegistry(config.bridges ?? []);
+    // 5. Create session (auto-detect model)
+    const detected = Session.detectModel();
+    const provenanceConfig = config.model_provenance ?? {
+        default_model: 'unknown',
+        confidence_tiers: { high: [], medium: [], low: [] },
+        conflict_policy: 'latest_wins',
+    };
+    const session = new Session(detected.modelId, detected.modelFamily, detected.client, provenanceConfig.default_model, provenanceConfig);
+    // 6. Load plugins and merge with core tools
+    const coreTools = createTools();
+    const coreToolNames = new Set(coreTools.map(t => t.name));
+    const pluginTools = await loadPlugins(config.plugins ?? [], coreToolNames);
+    const allTools = [...coreTools, ...pluginTools];
+    // 7. Build tool context (includes allTools for trigger/bridge pipelines)
+    const ctx = { namespaces, embed, llm, session, triggers, bridges, allTools };
+    // 8. Filter active tools by namespace config + core set
+    const activeToolNames = namespaces.getActiveTools();
+    for (const t of CORE_TOOLS) {
+        activeToolNames.add(t);
+    }
+    // Plugin tools are always active (not gated by namespace config)
+    for (const t of pluginTools) {
+        activeToolNames.add(t.name);
+    }
+    const activeTools = allTools.filter(t => activeToolNames.has(t.name));
+    // 9. Create MCP server
+    const server = new Server({ name: 'cortex-engine', version: '0.1.0' }, { capabilities: { tools: {} } });
+    // ListTools handler
+    server.setRequestHandler(ListToolsRequestSchema, async () => ({
+        tools: activeTools.map(t => ({
+            name: t.name,
+            description: t.description,
+            inputSchema: t.inputSchema,
+        })),
+    }));
+    // CallTool handler
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const { name, arguments: args } = request.params;
+        const tool = activeTools.find(t => t.name === name);
+        if (!tool) {
+            return {
+                content: [{ type: 'text', text: `Unknown tool: ${name}` }],
+                isError: true,
+            };
+        }
+        try {
+            const result = await tool.handler(args ?? {}, ctx);
+            return {
+                content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return {
+                content: [{ type: 'text', text: `Error in tool "${name}": ${message}` }],
+                isError: true,
+            };
+        }
+    });
+    return server;
+}
+// ─── Entry Point ─────────────────────────────────────────────────────────────
+/** Start the MCP server using stdio transport. Called by bin/serve.ts. */
+export async function startServer(config) {
+    const server = await createServer(config);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+// ─── Provider Factories ───────────────────────────────────────────────────────
+// Firestore DB init — lazy-loads firebase-admin via dynamic import() to avoid
+// requiring the SDK when running in SQLite-only mode.
+async function initFirestoreDb(config) {
+    const { getApps, initializeApp } = await import('firebase-admin/app');
+    if (getApps().length === 0) {
+        initializeApp({
+            projectId: config.store_options?.gcp_project_id,
+        });
+    }
+    const { getFirestore, FieldValue } = await import('firebase-admin/firestore');
+    const db = config.store_options?.firestore_database_id
+        ? getFirestore(config.store_options.firestore_database_id)
+        : getFirestore();
+    db.settings({ ignoreUndefinedProperties: true });
+    return { db, FieldValue };
+}
+async function createEmbedProvider(config) {
+    switch (config.embed) {
+        case 'ollama':
+            return new OllamaEmbedProvider({
+                model: config.embed_options?.ollama_model,
+                baseUrl: config.embed_options?.ollama_url,
+            });
+        case 'vertex': {
+            const { PredictionServiceClient, helpers } = await import('@google-cloud/aiplatform');
+            const { VertexEmbedProvider } = await import('../providers/vertex-embed.js');
+            const location = config.embed_options?.vertex_location ?? 'us-central1';
+            const client = new PredictionServiceClient({
+                apiEndpoint: `${location}-aiplatform.googleapis.com`,
+            });
+            return new VertexEmbedProvider({
+                projectId: config.store_options?.gcp_project_id,
+                location,
+                model: config.embed_options?.vertex_model,
+            }, client, helpers);
+        }
+        default:
+            throw new Error(`Embed provider "${config.embed}" not yet implemented in this build`);
+    }
+}
+async function createLLMProvider(config) {
+    switch (config.llm) {
+        case 'ollama':
+            return new OllamaLLMProvider({
+                model: config.llm_options?.ollama_model,
+                baseUrl: config.llm_options?.ollama_url,
+            });
+        case 'gemini': {
+            const { VertexAI } = await import('@google-cloud/vertexai');
+            const { VertexLLMProvider } = await import('../providers/vertex-llm.js');
+            const projectId = config.store_options?.gcp_project_id ?? process.env['GOOGLE_CLOUD_PROJECT'] ?? '';
+            const location = config.llm_options?.vertex_location ?? 'us-central1';
+            const vertexAI = new VertexAI({ project: projectId, location });
+            return new VertexLLMProvider({
+                projectId,
+                location,
+                model: config.llm_options?.gemini_model,
+            }, vertexAI);
+        }
+        default:
+            throw new Error(`LLM provider "${config.llm}" not yet implemented in this build`);
+    }
+}
+//# sourceMappingURL=server.js.map

package/dist/mcp/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EACL,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,oCAAoC,CAAC;AAE5C,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAGhF,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAErD,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAEnD,iFAAiF;AAEjF,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,MAAoB;IACrD,4EAA4E;IAC5E,MAAM,KAAK,GAAG,MAAM,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAChD,MAAM,GAAG,GAAG,MAAM,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAE5C,uEAAuE;IACvE,MAAM,aAAa,GAAG,MAAM,CAAC,KAAK,KAAK,WAAW;QAChD,CAAC,CAAC,MAAM,eAAe,CAAC,MAAM,CAAC;QAC/B,CAAC,CAAC,IAAI,CAAC;IAET,iDAAiD;IACjD,MAAM,UAAU,GAAG,IAAI,gBAAgB,CAAC,MAAM,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE;QACrE,IAAI,MAAM,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,OAAO,IAAI,iBAAiB,CAC1B,MAAM,CAAC,aAAa,EAAE,WAAW,IAAI,aAAa,EAClD,MAAM,CACP,CAAC;QACJ,CAAC;QACD,IAAI,MAAM,CAAC,KAAK,KAAK,WAAW,EAAE,CAAC;YACjC,OAAO,IAAI,oBAAoB,CAAC,aAAc,CAAC,EAAE,EAAE,MAAM,EAAE,aAAc,CAAC,UAAU,CAAC,CAAC;QACxF,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,sBAAsB,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;IAEH,uBAAuB;IACvB,MAAM,QAAQ,GAAG,IAAI,eAAe,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IACxD,MAAM,OAAO,GAAG,IAAI,cAAc,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;IAEzD,wCAAwC;IACxC,MAAM,QAAQ,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IACvC,MAAM,gBAAgB,GAAG,MAAM,CAAC,gBAAgB,IAAI;QAClD,aAAa,EAAE,SAAS;QACxB,gBAAgB,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE;QACnD,eAAe,EAAE,aAAsB;KACxC,CAAC;IACF,MAAM,OAAO,GAAG,IAAI,OAAO,CACzB,QAAQ,CAAC,OAAO,EAChB,QAAQ,CAAC,WAAW,EACpB,QAAQ,CAAC,MAAM,EACf,gBAAgB,CAAC,aAAa,EAC9B,gBAAgB,CACjB,CAAC;IAEF,4CAA4C;IAC5C,MAAM,SAAS,GAAG,WAAW,EAAE,CAAC;IAChC,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAC1D,MAAM,WAAW,GAAG,MAAM,WAAW,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,EAAE,aAAa,CAAC,CAAC;IAC3E,MAAM,QAAQ,GAAG,CAAC,GAAG,SAAS,EAAE,GAAG,WAAW,CAAC,CAAC;IAEhD,yEAAyE;IACzE,MAAM,GAAG,GAAgB,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;IAE1F,wDAAwD;IACxD,MAAM,eAAe,GAAG,UAAU,CAAC,cAAc,EAAE,CAAC;IACpD,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QAC3B,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACzB,CAAC;IACD,iEAAiE;IACjE,KAAK,MAAM,CAAC,IAAI,WAAW,EAAE,CAAC;QAC5B,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IACD,MAAM,WAAW,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAEtE,uBAAuB;IACvB,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,OAAO,EAAE,EAC3C,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,CAChC,CAAC;IAEF,oBAAoB;IACpB,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;QAC5D,KAAK,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAC3B,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,WAAW,EAAE,CAAC,CAAC,WAAW;YAC1B,WAAW,EAAE,CAAC,CAAC,WAAW;SAC3B,CAAC,CAAC;KACJ,CAAC,CAAC,CAAC;IAEJ,mBAAmB;IACnB,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QAChE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;QACjD,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;QAEpD,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,iBAAiB,IAAI,EAAE,EAAE,CAAC;gBACnE,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,EAAE,GAAG,CAAC,CAAC;YACnD,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;aAC5E,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACjE,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,kBAAkB,IAAI,MAAM,OAAO,EAAE,EAAE,CAAC;gBACjF,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,gFAAgF;AAEhF,0EAA0E;AAC1E,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,MAAoB;IACpD,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,MAAM,CAAC,CAAC;IAC1C,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC;AAED,iFAAiF;AAEjF,8EAA8E;AAC9E,sDAAsD;AACtD,KAAK,UAAU,eAAe,CAAC,MAAoB;IAIjD,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;IACtE,IAAI,OAAO,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,aAAa,CAAC;YACZ,SAAS,EAAE,MAAM,CAAC,aAAa,EAAE,cAAc;SAChD,CAAC,CAAC;IACL,CAAC;IACD,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,GAAG,MAAM,MAAM,CAAC,0BAA0B,CAAC,CAAC;IAC9E,MAAM,EAAE,GAAG,MAAM,CAAC,aAAa,EAAE,qBAAqB;QACpD,CAAC,CAAC,YAAY,CAAC,MAAM,CAAC,aAAa,CAAC,qBAAqB,CAAC;QAC1D,CAAC,CAAC,YAAY,EAAE,CAAC;IACnB,EAAE,CAAC,QAAQ,CAAC,EAAE,yBAAyB,EAAE,IAAI,EAAE,CAAC,CAAC;IACjD,OAAO,EAAE,EAAE,EAAE,UAAU,EAAE,CAAC;AAC5B,CAAC;AAED,KAAK,UAAU,mBAAmB,CAAC,MAAoB;IACrD,QAAQ,MAAM,CAAC,KAAK,EAAE,CAAC;QACrB,KAAK,QAAQ;YACX,OAAO,IAAI,mBAAmB,CAAC;gBAC7B,KAAK,EAAE,MAAM,CAAC,aAAa,EAAE,YAAY;gBACzC,OAAO,EAAE,MAAM,CAAC,aAAa,EAAE,UAAU;aAC1C,CAAC,CAAC;QACL,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,MAAM,EAAE,uBAAuB,EAAE,OAAO,EAAE,GAAG,MAAM,MAAM,CAAC,0BAA0B,CAAC,CAAC;YACtF,MAAM,EAAE,mBAAmB,EAAE,GAAG,MAAM,MAAM,CAAC,8BAA8B,CAAC,CAAC;YAC7E,MAAM,QAAQ,GAAG,MAAM,CAAC,aAAa,EAAE,eAAe,IAAI,aAAa,CAAC;YACxE,MAAM,MAAM,GAAG,IAAI,uBAAuB,CAAC;gBACzC,WAAW,EAAE,GAAG,QAAQ,4BAA4B;aACrD,CAAC,CAAC;YACH,OAAO,IAAI,mBAAmB,CAC5B;gBACE,SAAS,EAAE,MAAM,CAAC,aAAa,EAAE,cAAc;gBAC/C,QAAQ;gBACR,KAAK,EAAE,MAAM,CAAC,aAAa,EAAE,YAAY;aAC1C,EACD,MAAM,EACN,OAAO,CACR,CAAC;QACJ,CAAC;QACD;YACE,MAAM,IAAI,KAAK,CAAC,mBAAmB,MAAM,CAAC,KAAK,qCAAqC,CAAC,CAAC;IAC1F,CAAC;AACH,CAAC;AAED,KAAK,UAAU,iBAAiB,CAAC,MAAoB;IACnD,QAAQ,MAAM,CAAC,GAAG,EAAE,CAAC;QACnB,KAAK,QAAQ;YACX,OAAO,IAAI,iBAAiB,CAAC;gBAC3B,KAAK,EAAE,MAAM,CAAC,WAAW,EAAE,YAAY;gBACvC,OAAO,EAAE,MAAM,CAAC,WAAW,EAAE,UAAU;aACxC,CAAC,CAAC;QACL,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,wBAAwB,CAAC,CAAC;YAC5D,MAAM,EAAE,iBAAiB,EAAE,GAAG,MAAM,MAAM,CAAC,4BAA4B,CAAC,CAAC;YACzE,MAAM,SAAS,GAAG,MAAM,CAAC,aAAa,EAAE,cAAc,IAAI,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,IAAI,EAAE,CAAC;YACpG,MAAM,QAAQ,GAAG,MAAM,CAAC,WAAW,EAAE,eAAe,IAAI,aAAa,CAAC;YACtE,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,CAAC;YAChE,OAAO,IAAI,iBAAiB,CAC1B;gBACE,SAAS;gBACT,QAAQ;gBACR,KAAK,EAAE,MAAM,CAAC,WAAW,EAAE,YAAY;aACxC,EACD,QAAQ,CACT,CAAC;QACJ,CAAC;QACD;YACE,MAAM,IAAI,KAAK,CAAC,iBAAiB,MAAM,CAAC,GAAG,qCAAqC,CAAC,CAAC;IACtF,CAAC;AACH,CAAC"}

package/dist/mcp/tools.d.ts

@@ -0,0 +1,45 @@
+/**
+ * MCP tool definitions for cortex-engine.
+ *
+ * Each ToolDefinition contains a JSON schema for MCP and a working handler.
+ * Handlers resolve the namespace, operate on the store, call engine functions,
+ * inject provenance from the session, and fire triggers/bridges after writes.
+ */
+import type { EmbedProvider } from '../core/embed.js';
+import type { LLMProvider } from '../core/llm.js';
+import type { Session } from '../core/session.js';
+import type { NamespaceManager } from '../namespace/manager.js';
+import type { TriggerRegistry } from '../triggers/registry.js';
+import type { BridgeRegistry } from '../bridges/registry.js';
+/** Tool context passed to all handlers. */
+export interface ToolContext {
+    namespaces: NamespaceManager;
+    embed: EmbedProvider;
+    llm: LLMProvider;
+    session: Session;
+    triggers: TriggerRegistry;
+    bridges: BridgeRegistry;
+    /** All registered tools (core + plugin), for trigger/bridge pipeline lookups. */
+    allTools: ToolDefinition[];
+}
+/** MCP-compatible tool definition with a working handler. */
+export interface ToolDefinition {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: 'object';
+        properties: Record<string, unknown>;
+        required?: string[];
+    };
+    handler: (args: Record<string, unknown>, ctx: ToolContext) => Promise<Record<string, unknown>>;
+}
+/** A plugin that contributes additional tools to the cortex engine. */
+export interface ToolPlugin {
+    name: string;
+    tools: ToolDefinition[];
+}
+/** All 15 cognitive tool definitions. */
+export declare function createTools(): ToolDefinition[];
+/** Core tools that are always active regardless of namespace config. */
+export declare const CORE_TOOLS: readonly ["query", "observe", "recall", "neighbors", "stats", "ops_append", "ops_query", "ops_update"];
+//# sourceMappingURL=tools.d.ts.map

package/dist/mcp/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/mcp/tools.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAiB7D,2CAA2C;AAC3C,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,gBAAgB,CAAC;IAC7B,KAAK,EAAE,aAAa,CAAC;IACrB,GAAG,EAAE,WAAW,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,eAAe,CAAC;IAC1B,OAAO,EAAE,cAAc,CAAC;IACxB,iFAAiF;IACjF,QAAQ,EAAE,cAAc,EAAE,CAAC;CAC5B;AAID,6DAA6D;AAC7D,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ,CAAC;QACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACpC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;KACrB,CAAC;IACF,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,WAAW,KAAK,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAChG;AAED,uEAAuE;AACvE,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,cAAc,EAAE,CAAC;CACzB;AAs4BD,yCAAyC;AACzC,wBAAgB,WAAW,IAAI,cAAc,EAAE,CAkB9C;AAED,wEAAwE;AACxE,eAAO,MAAM,UAAU,wGASb,CAAC"}