@mastra/memory 1.20.1-alpha.0 → 1.20.1-alpha.1

package/dist/docs/SKILL.md

@@ -3,7 +3,7 @@ name: mastra-memory
 description: Documentation for @mastra/memory. Use when working with @mastra/memory APIs, configuration, or implementation.
 metadata:
   package: "@mastra/memory"
-  version: "1.20.1-alpha.0"
+  version: "1.20.1-alpha.1"
 ---
 
 ## When to use

package/dist/docs/assets/SOURCE_MAP.json

@@ -1,119 +1,119 @@
 {
-  "version": "1.20.1-alpha.0",
+  "version": "1.20.1-alpha.1",
   "package": "@mastra/memory",
   "exports": {
     "ModelByInputTokens": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-LXU26UVM.js",
+      "implementation": "dist/chunk-KMJQDCCZ.js",
       "line": 787
     },
     "OBSERVER_SYSTEM_PROMPT": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-LXU26UVM.js"
+      "implementation": "dist/chunk-KMJQDCCZ.js"
     },
     "ObservationalMemory": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-LXU26UVM.js",
-      "line": 7060
+      "implementation": "dist/chunk-KMJQDCCZ.js",
+      "line": 7175
     },
     "ObservationalMemoryProcessor": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-LXU26UVM.js",
-      "line": 9631
+      "implementation": "dist/chunk-KMJQDCCZ.js",
+      "line": 9747
     },
     "TokenCounter": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-LXU26UVM.js",
+      "implementation": "dist/chunk-KMJQDCCZ.js",
       "line": 6506
     },
     "buildObserverPrompt": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-LXU26UVM.js",
+      "implementation": "dist/chunk-KMJQDCCZ.js",
       "line": 3774
     },
     "buildObserverSystemPrompt": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-LXU26UVM.js",
+      "implementation": "dist/chunk-KMJQDCCZ.js",
       "line": 3045
     },
     "combineObservationGroupRanges": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-LXU26UVM.js",
+      "implementation": "dist/chunk-KMJQDCCZ.js",
       "line": 879
     },
     "deriveObservationGroupProvenance": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-LXU26UVM.js",
+      "implementation": "dist/chunk-KMJQDCCZ.js",
       "line": 913
     },
     "extractCurrentTask": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-LXU26UVM.js",
+      "implementation": "dist/chunk-KMJQDCCZ.js",
       "line": 3888
     },
     "formatMessagesForObserver": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-LXU26UVM.js",
+      "implementation": "dist/chunk-KMJQDCCZ.js",
       "line": 3500
     },
     "getObservationsAsOf": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-LXU26UVM.js",
-      "line": 9844
+      "implementation": "dist/chunk-KMJQDCCZ.js",
+      "line": 9960
     },
     "hasCurrentTaskSection": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-LXU26UVM.js",
+      "implementation": "dist/chunk-KMJQDCCZ.js",
       "line": 3876
     },
     "injectAnchorIds": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-LXU26UVM.js",
+      "implementation": "dist/chunk-KMJQDCCZ.js",
       "line": 2593
     },
     "optimizeObservationsForContext": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-LXU26UVM.js",
+      "implementation": "dist/chunk-KMJQDCCZ.js",
       "line": 3899
     },
     "parseAnchorId": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-LXU26UVM.js",
+      "implementation": "dist/chunk-KMJQDCCZ.js",
       "line": 2566
     },
     "parseObservationGroups": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-LXU26UVM.js",
+      "implementation": "dist/chunk-KMJQDCCZ.js",
       "line": 848
     },
     "parseObserverOutput": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-LXU26UVM.js",
+      "implementation": "dist/chunk-KMJQDCCZ.js",
       "line": 3784
     },
     "reconcileObservationGroupsFromReflection": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-LXU26UVM.js",
+      "implementation": "dist/chunk-KMJQDCCZ.js",
       "line": 937
     },
     "renderObservationGroupsForReflection": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-LXU26UVM.js",
+      "implementation": "dist/chunk-KMJQDCCZ.js",
       "line": 893
     },
     "stripEphemeralAnchorIds": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-LXU26UVM.js",
+      "implementation": "dist/chunk-KMJQDCCZ.js",
       "line": 2623
     },
     "stripObservationGroups": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-LXU26UVM.js",
+      "implementation": "dist/chunk-KMJQDCCZ.js",
       "line": 870
     },
     "wrapInObservationGroup": {
       "types": "dist/processors/index.d.ts",
-      "implementation": "dist/chunk-LXU26UVM.js",
+      "implementation": "dist/chunk-KMJQDCCZ.js",
       "line": 841
     },
     "OBSERVATIONAL_MEMORY_DEFAULTS": {
@@ -149,7 +149,7 @@
     "processors": {
       "index": "dist/processors/index.js",
       "chunks": [
-        "chunk-LXU26UVM.js",
+        "chunk-KMJQDCCZ.js",
         "chunk-VKRZ3O5X.js"
       ]
     }

package/dist/docs/references/docs-agents-agent-approval.md

@@ -86,6 +86,20 @@ for await (const chunk of stream.fullStream) {
 }
 ```
 
+#### Conditional approval with a function
+
+Instead of a boolean, `requireToolApproval` accepts a function that decides per tool call. It receives the `toolName`, the `args` the model passed, the `requestContext`, and the `workspace`. Return `true` to require approval for that call, or `false` to allow it. This lets you gate approval dynamically — for example, only for tools whose name matches a pattern:
+
+```typescript
+const stream = await agent.stream('Clean up old records', {
+  requireToolApproval: ({ toolName }) => /^delete_/.test(toolName),
+})
+```
+
+A tool's own `requireApproval` setting still takes precedence: if a tool defines its own approval rule, that rule decides for that tool and the function above does not override it. If the function throws, the call requires approval (fail-safe).
+
+> **Note:** Function-based `requireToolApproval` is only available on regular `stream()` / `generate()` calls. Durable agents and stored agents persist their options, and a function can't be serialized, so they accept only a boolean. If you pass a function in those contexts it falls back to requiring approval for every tool call.
+
 ### Runtime suspension with `suspend()`
 
 A tool can also pause _during_ its `execute` function by calling `suspend()`. This is useful when the tool starts running and then discovers it needs additional user input or confirmation before it can finish.

package/dist/docs/references/docs-memory-semantic-recall.md

@@ -247,7 +247,7 @@ const agent = new Agent({
 })
 ```
 
-The model router automatically handles API key detection from environment variables (`OPENAI_API_KEY`, `GOOGLE_GENERATIVE_AI_API_KEY`, `OPENROUTER_API_KEY`).
+The model router automatically handles API key detection from environment variables (`OPENAI_API_KEY`, `GOOGLE_API_KEY`, `OPENROUTER_API_KEY`). Google models also fall back to `GOOGLE_GENERATIVE_AI_API_KEY`.
 
 ### Using AI SDK Packages
 

package/dist/docs/references/reference-vectors-pg.md

@@ -26,6 +26,8 @@ The PgVector class provides vector search using [PostgreSQL](https://www.postgre
 
 **pgPoolOptions** (`PoolConfig`): Additional pg pool configuration options
 
+**disableInit** (`boolean`): When true, automatic DDL (schema, extension, table, and index creation) inside \`createIndex\` is skipped. Useful for CI/CD pipelines where schema and indexes are managed separately and the runtime database role lacks DDL privileges. Can also be enabled with the \`MASTRA\_DISABLE\_STORAGE\_INIT\` environment variable. (Default: `false`)
+
 ## Constructor examples
 
 ### Connection String