@framers/agentos 0.1.255 → 0.2.0

package/README.md

@@ -167,6 +167,39 @@ await session.send('Explain recursion with an analogy.');
 await session.send('Can you expand on that?'); // remembers context
 ```
 
+#### Memory on direct calls
+
+Memory auto-wires on `agent.stream()` / `agent.generate()` as well — sessions are not required to get memory integration. As of AgentOS 0.2.0, any call path invokes `memoryProvider.getContext` before the LLM call and `memoryProvider.observe` after.
+
+```typescript
+import type { AgentMemoryProvider } from '@framers/agentos';
+
+const myProvider: AgentMemoryProvider = {
+  async getContext(text, opts) {
+    return { contextText: await recallRelevant(text, opts?.tokenBudget) };
+  },
+  async observe(role, text) {
+    await persist(role, text);
+  },
+};
+
+const tutor = agent({
+  provider: 'anthropic',
+  instructions: 'You are a patient CS tutor.',
+  memoryProvider: myProvider,
+});
+
+// Direct stream — memory context injected before the call, observations
+// recorded after. No session required.
+const stream = tutor.stream('Explain recursion.');
+
+// Session — same memory wiring, plus per-session conversation history.
+const session = tutor.session('student-1');
+await session.send('Continue where we left off.');
+```
+
+Both `getContext` and `observe` hooks are optional; implementations may provide read-only or write-only memory behavior.
+
 ### Multi-Agent Teams
 
 ```typescript

package/dist/api/agent.d.ts

@@ -16,6 +16,46 @@ import type { SkillEntry } from '../skills/types.js';
 import type { AgentOSUsageAggregate, AgentOSUsageLedgerOptions } from './runtime/usageLedger.js';
 import type { BaseAgentConfig } from './types.js';
 import { type AgentExportConfig } from './agentExportCore.js';
+/**
+ * Provider hook interface consumed by `agent()` for memory integration.
+ *
+ * When provided on the agent config, `getContext` is called before each
+ * LLM generation to inject retrieved memory into the system prompt, and
+ * `observe` is called after each turn to encode the exchange for future
+ * recall. Both hooks are optional — implementations may choose to provide
+ * read-only or write-only memory behavior.
+ *
+ * Auto-wires on every agent call path as of AgentOS 0.2.0: direct
+ * `agent.stream()` / `.generate()` and `agent.session().send()` / `.stream()`
+ * all invoke the hooks when the provider is present.
+ */
+export interface AgentMemoryProvider {
+    /**
+     * Retrieve a memory context block to prepend to the system prompt.
+     *
+     * @param text - The user input for the current turn.
+     * @param opts - Retrieval options. `tokenBudget` caps the memory block size.
+     * @returns An object whose `contextText` (when present) is injected as a
+     *   system message before the LLM call. Returning `null` or an object
+     *   without `contextText` skips injection.
+     */
+    getContext?: (text: string, opts?: {
+        tokenBudget?: number;
+    }) => Promise<{
+        contextText?: string;
+    } | null>;
+    /**
+     * Record an observation of a turn exchange.
+     *
+     * Invoked twice per turn (`role: 'user'` with the input, then
+     * `role: 'assistant'` with the reply) as fire-and-forget. Rejections
+     * are swallowed so memory-backend errors do not break generation.
+     *
+     * @param role - Whether the content came from the user or assistant.
+     * @param text - Plain text content of the turn.
+     */
+    observe?: (role: 'user' | 'assistant', text: string) => Promise<void>;
+}
 /**
  * Configuration options for the {@link agent} factory function.
  *
@@ -109,13 +149,14 @@ export interface AgentOptions extends BaseAgentConfig {
     /** Pre-tool-execution hook. */
     onBeforeToolExecution?: (info: ToolCallHookInfo) => Promise<ToolCallHookInfo | null>;
     /**
-     * Optional memory provider.  When provided:
-     * - `session.send()`/`stream()` calls `memory.getContext()` before each turn
-     *   and prepends results to the system prompt.
-     * - `session.send()`/`stream()` calls `memory.observe()` after each turn
-     *   to encode the exchange into long-term memory.
+     * Optional memory provider. When provided, memory auto-wires on all four
+     * agent call paths (see {@link AgentMemoryProvider} for hook contract).
+     *
+     * - `getContext` runs before each LLM call; result prepended as a system
+     *   message.
+     * - `observe` runs after each LLM call as fire-and-forget.
      */
-    memoryProvider?: any;
+    memoryProvider?: AgentMemoryProvider;
     /**
      * Optional skill entries to inject into the system prompt.
      * Skill content is appended to the system prompt as markdown sections.

package/dist/api/agent.d.ts.map

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

package/dist/api/agent.js

@@ -12,6 +12,7 @@ import { generateText, extractTextFromContent, } from './generateText.js';
 import { streamText } from './streamText.js';
 import { warnOnDeferredLightweightAgentCapabilities } from './runtime/lightweightAgentDiagnostics.js';
 import { exportAgentConfig, exportAgentConfigJSON } from './agentExportCore.js';
+import { applyMemoryProvider } from './runtime/memoryProviderHooks.js';
 function mergeUsageLedgerOptions(...parts) {
     const merged = Object.assign({}, ...parts.filter(Boolean));
     return Object.keys(merged).length > 0 ? merged : undefined;
@@ -20,8 +21,6 @@ async function loadRecordedAgentOSUsage(options) {
     const { getRecordedAgentOSUsage } = await import('./runtime/usageLedger.js');
     return getRecordedAgentOSUsage(options);
 }
-/** Timeout for memory operations to prevent blocking generation. */
-const MEMORY_TIMEOUT_MS = 5000;
 /**
  * Convert HEXACO trait values (0-1) into behavioral descriptions the LLM can act on.
  *
@@ -165,13 +164,14 @@ export function agent(opts) {
     };
     const agentInstance = {
         async generate(prompt, extra) {
-            const genOpts = {
+            const userText = typeof prompt === 'string' ? prompt : extractTextFromContent(prompt);
+            const genOpts = applyMemoryProvider({
                 ...baseOpts,
                 ...extra,
                 usageLedger: mergeUsageLedgerOptions(baseOpts.usageLedger, extra?.usageLedger, {
                     source: extra?.usageLedger?.source ?? 'agent.generate',
                 }),
-            };
+            }, opts.memoryProvider, userText);
             if (typeof prompt === 'string') {
                 genOpts.prompt = prompt;
             }
@@ -181,13 +181,14 @@ export function agent(opts) {
             return generateText(genOpts);
         },
         stream(prompt, extra) {
-            const streamOpts = {
+            const userText = typeof prompt === 'string' ? prompt : extractTextFromContent(prompt);
+            const streamOpts = applyMemoryProvider({
                 ...baseOpts,
                 ...extra,
                 usageLedger: mergeUsageLedgerOptions(baseOpts.usageLedger, extra?.usageLedger, {
                     source: extra?.usageLedger?.source ?? 'agent.stream',
                 }),
-            };
+            }, opts.memoryProvider, userText);
             if (typeof prompt === 'string') {
                 streamOpts.prompt = prompt;
             }
@@ -205,106 +206,47 @@ export function agent(opts) {
                 id: sessionId,
                 async send(input) {
                     const textForMemory = typeof input === 'string' ? input : extractTextFromContent(input);
-                    // Memory recall before generation
-                    let memorySystemMsg;
-                    if (opts.memoryProvider?.getContext) {
-                        try {
-                            const ctx = await Promise.race([
-                                opts.memoryProvider.getContext(textForMemory, { tokenBudget: 2000 }),
-                                new Promise((resolve) => setTimeout(() => resolve(null), MEMORY_TIMEOUT_MS)),
-                            ]);
-                            if (ctx?.contextText) {
-                                memorySystemMsg = ctx.contextText;
-                            }
-                        }
-                        catch {
-                            // Memory recall failure is non-fatal
-                        }
-                    }
-                    // Prepend memory context to system prompt
-                    let system = baseOpts.system;
-                    if (memorySystemMsg) {
-                        system = [memorySystemMsg, system].filter(Boolean).join('\n\n') || undefined;
-                    }
                     const userMessage = { role: 'user', content: input };
                     const requestMessages = useMemory
                         ? [...history, userMessage]
                         : [userMessage];
-                    const result = await generateText({
+                    const wrappedOpts = applyMemoryProvider({
                         ...baseOpts,
-                        system,
                         messages: requestMessages,
                         usageLedger: mergeUsageLedgerOptions(baseOpts.usageLedger, {
                             sessionId,
                             source: 'agent.session.send',
                         }),
-                    });
+                    }, opts.memoryProvider, textForMemory);
+                    const result = await generateText(wrappedOpts);
                     if (useMemory) {
                         history.push(userMessage);
                         history.push({ role: 'assistant', content: result.text });
                     }
-                    // Memory observe after generation (fire-and-forget, text only)
-                    if (opts.memoryProvider?.observe) {
-                        opts.memoryProvider.observe('user', textForMemory).catch(() => { });
-                        if (result.text) {
-                            opts.memoryProvider.observe('assistant', result.text).catch(() => { });
-                        }
-                    }
                     return result;
                 },
                 stream(input) {
                     const textForMemory = typeof input === 'string' ? input : extractTextFromContent(input);
                     const userMessage = { role: 'user', content: input };
-                    // For streaming, use onBeforeGeneration hook to inject memory context
-                    const originalBeforeHook = baseOpts.onBeforeGeneration;
-                    const result = streamText({
+                    const wrappedOpts = applyMemoryProvider({
                         ...baseOpts,
                         messages: useMemory
                             ? [...history, userMessage]
                             : [userMessage],
-                        onBeforeGeneration: opts.memoryProvider?.getContext
-                            ? async (ctx) => {
-                                // Inject memory context
-                                try {
-                                    const memCtx = await Promise.race([
-                                        opts.memoryProvider.getContext(textForMemory, { tokenBudget: 2000 }),
-                                        new Promise((resolve) => setTimeout(() => resolve(null), MEMORY_TIMEOUT_MS)),
-                                    ]);
-                                    if (memCtx?.contextText) {
-                                        ctx = {
-                                            ...ctx,
-                                            messages: [
-                                                { role: 'system', content: memCtx.contextText },
-                                                ...ctx.messages,
-                                            ],
-                                        };
-                                    }
-                                }
-                                catch { /* non-fatal */ }
-                                // Chain with user's hook if present
-                                if (originalBeforeHook) {
-                                    const userResult = await originalBeforeHook(ctx);
-                                    return userResult ?? ctx;
-                                }
-                                return ctx;
-                            }
-                            : originalBeforeHook,
                         usageLedger: mergeUsageLedgerOptions(baseOpts.usageLedger, {
                             sessionId,
                             source: 'agent.session.stream',
                         }),
-                    });
-                    // Capture text for history when done
+                    }, opts.memoryProvider, textForMemory);
+                    const result = streamText(wrappedOpts);
+                    // Capture text for history when done. Memory observe runs inside
+                    // applyMemoryProvider's onAfterGeneration wrapper so it's not
+                    // re-fired here.
                     if (useMemory) {
                         history.push(userMessage);
                         void result.text
                             .then((replyText) => {
                             history.push({ role: 'assistant', content: replyText });
-                            // Memory observe after stream completes (text only)
-                            if (opts.memoryProvider?.observe) {
-                                opts.memoryProvider.observe('user', textForMemory).catch(() => { });
-                                opts.memoryProvider.observe('assistant', replyText).catch(() => { });
-                            }
                         })
                             .catch(() => {
                             /* history update failed, non-critical */

package/dist/api/agent.js.map

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

package/dist/api/agentExport.js

@@ -18,7 +18,7 @@
  * @example
  * ```ts
  * import { agent } from '@framers/agentos';
- * import { exportAgentConfig, importAgent, exportAgentConfigJSON } from '../api/agentExport.js';
+ * import { exportAgentConfig, importAgent, exportAgentConfigJSON } from '../api/agentExport';
  *
  * const myAgent = agent({ model: 'openai:gpt-4o', instructions: 'Be helpful.' });
  * const json = exportAgentConfigJSON(myAgent);

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

@@ -0,0 +1,33 @@
+/**
+ * @file memoryProviderHooks.ts
+ * Shared helper that wires {@link AgentMemoryProvider} hooks into
+ * {@link GenerateTextOptions}.
+ *
+ * Used by all four agent call paths (`Agent.generate`, `Agent.stream`,
+ * `AgentSession.send`, `AgentSession.stream`) to consistently invoke
+ * `memory.getContext` before the LLM call and `memory.observe` after.
+ * Pure function: returns a new options object without mutating inputs.
+ *
+ * @module api/runtime/memoryProviderHooks
+ */
+import type { GenerateTextOptions } from '../generateText.js';
+import type { AgentMemoryProvider } from '../agent.js';
+/** Timeout applied to memory.getContext calls to prevent hangs. */
+export declare const MEMORY_TIMEOUT_MS = 5000;
+/** Default token budget forwarded to memory.getContext. */
+export declare const DEFAULT_MEMORY_TOKEN_BUDGET = 2000;
+/**
+ * Apply memory-provider hooks to an options object.
+ *
+ * @param baseOpts - The GenerateTextOptions object to wrap.
+ * @param provider - Memory provider. When undefined or lacking both
+ *   `getContext` and `observe`, returns baseOpts unchanged.
+ * @param userText - The user input text for this turn; passed to
+ *   getContext and observe('user', ...).
+ * @returns A new options object with onBeforeGeneration +
+ *   onAfterGeneration wrappers that invoke the memory hooks. Existing
+ *   user hooks (if any) are chained AFTER the memory wiring so the
+ *   caller's hook sees the memory-augmented context and result.
+ */
+export declare function applyMemoryProvider(baseOpts: Partial<GenerateTextOptions>, provider: AgentMemoryProvider | undefined, userText: string): Partial<GenerateTextOptions>;
+//# sourceMappingURL=memoryProviderHooks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"memoryProviderHooks.d.ts","sourceRoot":"","sources":["../../../src/api/runtime/memoryProviderHooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EACV,mBAAmB,EAGpB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEvD,mEAAmE;AACnE,eAAO,MAAM,iBAAiB,OAAO,CAAC;AAEtC,2DAA2D;AAC3D,eAAO,MAAM,2BAA2B,OAAO,CAAC;AAEhD;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,OAAO,CAAC,mBAAmB,CAAC,EACtC,QAAQ,EAAE,mBAAmB,GAAG,SAAS,EACzC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,mBAAmB,CAAC,CA+D9B"}

package/dist/api/runtime/memoryProviderHooks.js

@@ -0,0 +1,76 @@
+/** Timeout applied to memory.getContext calls to prevent hangs. */
+export const MEMORY_TIMEOUT_MS = 5000;
+/** Default token budget forwarded to memory.getContext. */
+export const DEFAULT_MEMORY_TOKEN_BUDGET = 2000;
+/**
+ * Apply memory-provider hooks to an options object.
+ *
+ * @param baseOpts - The GenerateTextOptions object to wrap.
+ * @param provider - Memory provider. When undefined or lacking both
+ *   `getContext` and `observe`, returns baseOpts unchanged.
+ * @param userText - The user input text for this turn; passed to
+ *   getContext and observe('user', ...).
+ * @returns A new options object with onBeforeGeneration +
+ *   onAfterGeneration wrappers that invoke the memory hooks. Existing
+ *   user hooks (if any) are chained AFTER the memory wiring so the
+ *   caller's hook sees the memory-augmented context and result.
+ */
+export function applyMemoryProvider(baseOpts, provider, userText) {
+    const hasContext = Boolean(provider?.getContext);
+    const hasObserve = Boolean(provider?.observe);
+    if (!hasContext && !hasObserve)
+        return baseOpts;
+    const userOnBefore = baseOpts.onBeforeGeneration;
+    const userOnAfter = baseOpts.onAfterGeneration;
+    const wrappedOnBefore = async (ctx) => {
+        let nextCtx = ctx;
+        if (hasContext) {
+            try {
+                const memCtx = await Promise.race([
+                    provider.getContext(userText, { tokenBudget: DEFAULT_MEMORY_TOKEN_BUDGET }),
+                    new Promise((resolve) => setTimeout(() => resolve(null), MEMORY_TIMEOUT_MS)),
+                ]);
+                if (memCtx && 'contextText' in memCtx && memCtx.contextText) {
+                    nextCtx = {
+                        ...ctx,
+                        messages: [
+                            { role: 'system', content: memCtx.contextText },
+                            ...ctx.messages,
+                        ],
+                    };
+                }
+            }
+            catch {
+                // Memory recall failure is non-fatal; continue with unmodified ctx.
+            }
+        }
+        if (userOnBefore) {
+            const userResult = await userOnBefore(nextCtx);
+            return userResult ?? nextCtx;
+        }
+        return nextCtx;
+    };
+    const wrappedOnAfter = async (result) => {
+        if (hasObserve) {
+            void provider.observe('user', userText).catch(() => {
+                /* fire-and-forget */
+            });
+            if (result.text) {
+                void provider.observe('assistant', result.text).catch(() => {
+                    /* fire-and-forget */
+                });
+            }
+        }
+        if (userOnAfter) {
+            const userResult = await userOnAfter(result);
+            return userResult ?? result;
+        }
+        return result;
+    };
+    return {
+        ...baseOpts,
+        onBeforeGeneration: wrappedOnBefore,
+        onAfterGeneration: wrappedOnAfter,
+    };
+}
+//# sourceMappingURL=memoryProviderHooks.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"memoryProviderHooks.js","sourceRoot":"","sources":["../../../src/api/runtime/memoryProviderHooks.ts"],"names":[],"mappings":"AAmBA,mEAAmE;AACnE,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,CAAC;AAEtC,2DAA2D;AAC3D,MAAM,CAAC,MAAM,2BAA2B,GAAG,IAAI,CAAC;AAEhD;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,mBAAmB,CACjC,QAAsC,EACtC,QAAyC,EACzC,QAAgB;IAEhB,MAAM,UAAU,GAAG,OAAO,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IACjD,MAAM,UAAU,GAAG,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC9C,IAAI,CAAC,UAAU,IAAI,CAAC,UAAU;QAAE,OAAO,QAAQ,CAAC;IAEhD,MAAM,YAAY,GAAG,QAAQ,CAAC,kBAAkB,CAAC;IACjD,MAAM,WAAW,GAAG,QAAQ,CAAC,iBAAiB,CAAC;IAE/C,MAAM,eAAe,GAA2D,KAAK,EACnF,GAA0B,EACa,EAAE;QACzC,IAAI,OAAO,GAA0B,GAAG,CAAC;QACzC,IAAI,UAAU,EAAE,CAAC;YACf,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC;oBAChC,QAAS,CAAC,UAAW,CAAC,QAAQ,EAAE,EAAE,WAAW,EAAE,2BAA2B,EAAE,CAAC;oBAC7E,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,iBAAiB,CAAC,CAAC;iBACnF,CAAC,CAAC;gBACH,IAAI,MAAM,IAAI,aAAa,IAAI,MAAM,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;oBAC5D,OAAO,GAAG;wBACR,GAAG,GAAG;wBACN,QAAQ,EAAE;4BACR,EAAE,IAAI,EAAE,QAAiB,EAAE,OAAO,EAAE,MAAM,CAAC,WAAW,EAAE;4BACxD,GAAG,GAAG,CAAC,QAAQ;yBAChB;qBACF,CAAC;gBACJ,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,oEAAoE;YACtE,CAAC;QACH,CAAC;QACD,IAAI,YAAY,EAAE,CAAC;YACjB,MAAM,UAAU,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,CAAC;YAC/C,OAAO,UAAU,IAAI,OAAO,CAAC;QAC/B,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC,CAAC;IAEF,MAAM,cAAc,GAA0D,KAAK,EACjF,MAA4B,EACU,EAAE;QACxC,IAAI,UAAU,EAAE,CAAC;YACf,KAAK,QAAS,CAAC,OAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE;gBACnD,qBAAqB;YACvB,CAAC,CAAC,CAAC;YACH,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;gBAChB,KAAK,QAAS,CAAC,OAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE;oBAC3D,qBAAqB;gBACvB,CAAC,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QACD,IAAI,WAAW,EAAE,CAAC;YAChB,MAAM,UAAU,GAAG,MAAM,WAAW,CAAC,MAAM,CAAC,CAAC;YAC7C,OAAO,UAAU,IAAI,MAAM,CAAC;QAC9B,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;IAEF,OAAO;QACL,GAAG,QAAQ;QACX,kBAAkB,EAAE,eAAe;QACnC,iBAAiB,EAAE,cAAc;KAClC,CAAC;AACJ,CAAC"}

package/dist/api/transferStyle.js

@@ -15,7 +15,7 @@
  *
  * @example
  * ```typescript
- * import { transferStyle } from '../api/transferStyle.js';
+ * import { transferStyle } from '../api/transferStyle';
  *
  * const result = await transferStyle({
  *   image: './photo.jpg',

package/dist/cognitive_substrate/GMI.js

@@ -14,7 +14,7 @@
 import { uuidv4 } from '../core/utils/uuid.js';
 import { GMIOutputChunkType, GMIPrimeState, GMIMood, ReasoningEntryType, GMIInteractionType,
 // AudioOutputConfig, ImageOutputConfig are part of GMIOutput
- } from './IGMI.js';
+ } from './IGMI';
 import { RagMemoryCategory } from '../rag/IRetrievalAugmentor.js';
 import { GMIError, GMIErrorCode, createGMIErrorFromError } from '../core/utils/errors.js';
 import { ConversationHistoryManager } from './ConversationHistoryManager.js';

package/dist/core/config/VectorStoreConfiguration.d.ts

@@ -11,6 +11,7 @@
 import type { VectorStoreProviderConfig } from '../vector-store/IVectorStore.js';
 import type { StorageAdapter, StorageResolutionOptions } from '@framers/sql-storage-adapter';
 import type { HnswlibVectorStoreConfig } from '../../rag/vector_stores/HnswlibVectorStore.js';
+import type { PineconeVectorStoreConfig as AdapterPineconeVectorStoreConfig } from '../../rag/vector_stores/PineconeVectorStore.js';
 import type { QdrantVectorStoreConfig } from '../../rag/vector_stores/QdrantVectorStore.js';
 import type { Neo4jVectorStoreConfig } from '../../rag/vector_stores/Neo4jVectorStore.js';
 /**
@@ -96,23 +97,15 @@ export interface LocalFileVectorStoreConfig extends VectorStoreProviderConfig {
 /**
  * Specific configuration for a Pinecone vector store.
  *
- * @interface PineconeVectorStoreConfig
- * @extends VectorStoreProviderConfig
- * @property {'pinecone'} type - Identifier for the Pinecone provider type.
- * @property {string} apiKey - Pinecone API key. Ensure this is securely managed (e.g., via environment variables).
- * @property {string} environment - Pinecone environment (e.g., 'gcp-starter', 'us-east-1-aws').
- * @property {number} [defaultEmbeddingDimension] - Default embedding dimension for collections created
- * or managed by this provider instance if not specified per collection.
- * @property {'cosine' | 'euclidean' | 'dotproduct'} [similarityMetric='cosine'] - Default similarity metric for new Pinecone indexes
- * created through this configuration, if applicable.
+ * This re-exports the runtime adapter config so the shared configuration contract
+ * stays aligned with the real Pinecone implementation and docs:
+ * - `apiKey`
+ * - `indexHost`
+ * - optional `namespace`
+ * - optional `defaultDimension`
+ * - optional `apiVersion`
  */
-export interface PineconeVectorStoreConfig extends VectorStoreProviderConfig {
-    type: 'pinecone';
-    apiKey: string;
-    environment: string;
-    defaultEmbeddingDimension?: number;
-    similarityMetric?: 'cosine' | 'euclidean' | 'dotproduct';
-}
+export type PineconeVectorStoreConfig = AdapterPineconeVectorStoreConfig;
 /**
  * Specific configuration for a Weaviate vector store.
  *

package/dist/core/config/VectorStoreConfiguration.d.ts.map

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

package/dist/core/config/VectorStoreConfiguration.js

@@ -14,16 +14,16 @@ export {};
 const systemRagDataLayerConfig: RagDataLayerConfig = {
   vectorStoreManager: {
     managerId: 'main-vsm',
-    defaultProviderId: 'pinecone_main_prod',
+    defaultProviderId: 'qdrant_main_prod',
     defaultEmbeddingDimension: 1536, // System-wide default if not specified lower
     providers: [
       {
-        id: 'pinecone_main_prod', // Matches VectorStoreProviderConfig.id
-        type: 'pinecone',
-        apiKey: process.env.PINECONE_API_KEY!,
-        environment: process.env.PINECONE_ENVIRONMENT!,
+        id: 'qdrant_main_prod', // Matches VectorStoreProviderConfig.id
+        type: 'qdrant',
+        url: process.env.QDRANT_URL!,
+        apiKey: process.env.QDRANT_API_KEY,
         defaultEmbeddingDimension: 1536, // Provider-level default
-      } as PineconeVectorStoreConfig,
+      } as QdrantVectorStoreConfig,
       {
         id: 'in_memory_dev_store',
         type: 'in_memory',
@@ -36,8 +36,8 @@ const systemRagDataLayerConfig: RagDataLayerConfig = {
       dataSourceId: 'global_company_wiki',
       displayName: 'Global Company Wiki',
       description: 'Shared knowledge base for all company agents and employees.',
-      vectorStoreProviderId: 'pinecone_main_prod',
-      actualNameInProvider: 'company-wiki-prod-v2', // e.g., Pinecone index name
+      vectorStoreProviderId: 'qdrant_main_prod',
+      actualNameInProvider: 'company-wiki-prod-v2', // e.g., Qdrant collection name
       embeddingDimension: 1536, // Specific to this data source's content
       isDefaultQuerySource: true,
       metadataSchema: { "department": "string", "lastReviewed": "date" }
@@ -46,7 +46,7 @@ const systemRagDataLayerConfig: RagDataLayerConfig = {
       dataSourceId: 'user_personal_notes_main',
       displayName: 'User Personal Notes (Encrypted)',
       description: 'Personal notes and memories for individual users. Data segregated by user ID in metadata filters.',
-      vectorStoreProviderId: 'pinecone_main_prod',
+      vectorStoreProviderId: 'qdrant_main_prod',
       actualNameInProvider: 'user-notes-prod-encrypted',
       embeddingDimension: 1536,
       // This collection would typically be queried with a strong `userId` metadata filter.

package/dist/core/config/VectorStoreConfiguration.js.map

@@ -1 +1 @@
-{"version":3,"file":"VectorStoreConfiguration.js","sourceRoot":"","sources":["../../../src/core/config/VectorStoreConfiguration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;;AAmPH,sFAAsF;AACtF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA6CE"}
+{"version":3,"file":"VectorStoreConfiguration.js","sourceRoot":"","sources":["../../../src/core/config/VectorStoreConfiguration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;;AA4OH,sFAAsF;AACtF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA6CE"}

package/dist/core/validation/schema-primitives.js

@@ -8,7 +8,7 @@
  *
  * @example
  * ```ts
- * import { MemoryTypeEnum, ConfidenceScore, EntityArray } from '../../core/validation/index.js';
+ * import { MemoryTypeEnum, ConfidenceScore, EntityArray } from '../../core/validation';
  *
  * const MySchema = z.object({
  *   type: MemoryTypeEnum,