@mastra/convex 1.7.5 → 1.7.6

package/dist/_types/@internal_core/dist/memory/index.d.ts

@@ -1,4 +1,3 @@
-//#region src/memory/index.d.ts
 /**
  * Shared rules for observational memory lifecycle writes. Every storage adapter applies
  * these inside its own atomic section (lock, transaction, or conditional update), so the
@@ -9,18 +8,18 @@
  * into the table schema they get from `@mastra/core`, so the columns exist even when the
  * installed core predates them.
  */
-declare const OBSERVATIONAL_MEMORY_LIFECYCLE_COLUMNS: {
+export declare const OBSERVATIONAL_MEMORY_LIFECYCLE_COLUMNS: {
   readonly supersededBy: {
     readonly type: 'text';
     readonly nullable: true;
   };
 };
 /** `schema` plus {@link OBSERVATIONAL_MEMORY_LIFECYCLE_COLUMNS}; `undefined` when `schema` is. */
-declare function withObservationalMemoryLifecycleColumns<T extends object>(schema: T | undefined): (T & typeof OBSERVATIONAL_MEMORY_LIFECYCLE_COLUMNS) | undefined;
+export declare function withObservationalMemoryLifecycleColumns<T extends object>(schema: T | undefined): (T & typeof OBSERVATIONAL_MEMORY_LIFECYCLE_COLUMNS) | undefined;
 /**
  * Result of `commitActiveObservations`.
  */
-interface UpdateActiveObservationsResult {
+export interface UpdateActiveObservationsResult {
   /** Whether the observations were written. */
   applied: boolean;
   /**
@@ -38,14 +37,14 @@ interface UpdateActiveObservationsResult {
  * the head's cursor. Chunks carry `lastObservedAt = max message time + 1ms`, so a chunk is
  * wholly covered iff `head.lastObservedAt >= chunk.lastObservedAt - 1ms`.
  */
-interface UpdateBufferedObservationsResult {
+export interface UpdateBufferedObservationsResult {
   /** Whether the chunk was stored. */
   persisted: boolean;
   /** The record the chunk was written to (or would have been written to). */
   recordId: string;
 }
 /** The fields of an observational memory record that decide head order. */
-interface ObservationalMemoryHeadOrderFields {
+export interface ObservationalMemoryHeadOrderFields {
   generationCount: number;
   createdAt: Date | string;
   id: string;
@@ -54,16 +53,16 @@ interface ObservationalMemoryHeadOrderFields {
  * Canonical head order: `generationCount DESC, createdAt ASC, id ASC`.
  * Returns a negative number when `a` sorts before `b` (i.e. `a` is the better head candidate).
  */
-declare function compareObservationalMemoryHeadOrder(a: ObservationalMemoryHeadOrderFields, b: ObservationalMemoryHeadOrderFields): number;
+export declare function compareObservationalMemoryHeadOrder(a: ObservationalMemoryHeadOrderFields, b: ObservationalMemoryHeadOrderFields): number;
 /**
  * A buffered chunk stores `lastObservedAt = max message time + 1ms`. It is wholly covered
  * (every message it observed is already at or before the cursor) iff
  * `cursor >= chunk.lastObservedAt - 1ms`.
  */
-declare function isBufferedChunkCoveredByCursor(chunkLastObservedAt: Date | string, cursor: Date | string | null | undefined): boolean;
+export declare function isBufferedChunkCoveredByCursor(chunkLastObservedAt: Date | string, cursor: Date | string | null | undefined): boolean;
 /** The later of two cursors; `undefined` only when both are absent. */
-declare function maxObservationCursor(a: Date | string | null | undefined, b: Date | string | null | undefined): Date | undefined;
-interface ReflectionTextPlan {
+export declare function maxObservationCursor(a: Date | string | null | undefined, b: Date | string | null | undefined): Date | undefined;
+export interface ReflectionTextPlan {
   /** `equal`: stored text equals the snapshot. `append`: observations were appended after the snapshot. */
   mode: 'equal' | 'append';
   observations: string;
@@ -78,7 +77,7 @@ interface ReflectionTextPlan {
  *   after the reflection, and its tokens are added.
  * - Anything else (a non-append rewrite): `null` — the reflection must not be applied.
  */
-declare function planReflectionGenerationText(input: {
+export declare function planReflectionGenerationText(input: {
   storedObservations: string;
   storedObservationTokenCount: number;
   snapshotObservations: string;
@@ -91,12 +90,10 @@ declare function planReflectionGenerationText(input: {
  * Callers of `updateActiveObservations` (which resolves `void`) can't see a commit result, so a
  * write that was not applied throws instead of resolving as if it had committed.
  */
-declare function assertActiveObservationsApplied(result: UpdateActiveObservationsResult, id: string): void;
+export declare function assertActiveObservationsApplied(result: UpdateActiveObservationsResult, id: string): void;
 /**
  * Whether the stored text can still accept a reflection built from `snapshot`
  * (equal, or only appended to since).
  */
-declare function isAppendOnlySince(storedObservations: string, snapshotObservations: string): boolean;
-//#endregion
-export { OBSERVATIONAL_MEMORY_LIFECYCLE_COLUMNS, ObservationalMemoryHeadOrderFields, ReflectionTextPlan, UpdateActiveObservationsResult, UpdateBufferedObservationsResult, assertActiveObservationsApplied, compareObservationalMemoryHeadOrder, isAppendOnlySince, isBufferedChunkCoveredByCursor, maxObservationCursor, planReflectionGenerationText, withObservationalMemoryLifecycleColumns };
+export declare function isAppendOnlySince(storedObservations: string, snapshotObservations: string): boolean;
 //# sourceMappingURL=index.d.ts.map

package/dist/docs/SKILL.md

@@ -3,7 +3,7 @@ name: mastra-convex
 description: Documentation for @mastra/convex. Use when working with @mastra/convex APIs, configuration, or implementation.
 metadata:
   package: "@mastra/convex"
-  version: "1.7.5"
+  version: "1.7.6"
 ---
 
 ## When to use

package/dist/docs/assets/SOURCE_MAP.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.7.5",
+  "version": "1.7.6",
   "package": "@mastra/convex",
   "exports": {},
   "modules": {}

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

@@ -346,7 +346,7 @@ Query results are returned in this format:
 interface QueryResult {
   id: string
   score: number
-  metadata: Record<string, any>
+  metadata?: Record<string, any>
   vector?: number[] // Only included if includeVector is true
 }
 ```

package/dist/index.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_server = require("./server-BxQKtmhb.cjs");
+const require_server = require("./server-BwpzJLxa.cjs");
 const require_schema = require("./schema.cjs");
 let _mastra_core_cache = require("@mastra/core/cache");
 let _mastra_core_storage = require("@mastra/core/storage");
@@ -8,7 +8,7 @@ let _mastra_core_agent = require("@mastra/core/agent");
 let _mastra_core_error = require("@mastra/core/error");
 let _mastra_core_vector = require("@mastra/core/vector");
 let _mastra_core_storage_constants = require("@mastra/core/storage/constants");
-//#region src/cache/client.ts
+// src/cache/client.ts
 const DEFAULT_CACHE_FUNCTION = "mastra/cache:handle";
 const DEFAULT_REQUEST_TIMEOUT_MS = 3e4;
 const trimTrailingSlashes = (value) => {
@@ -86,8 +86,7 @@ var ConvexCacheClient = class {
 		return result;
 	}
 };
-//#endregion
-//#region src/cache/index.ts
+// src/cache/index.ts
 const DEFAULT_KEY_PREFIX = "mastra:cache:";
 const DEFAULT_TTL_MS = 3e5;
 const MAX_CACHE_OPERATION_BATCHES = 1e3;
@@ -175,8 +174,7 @@ var ConvexServerCache = class extends _mastra_core_cache.MastraServerCache {
 		}));
 	}
 };
-//#endregion
-//#region src/storage/client.ts
+// src/storage/client.ts
 const DEFAULT_STORAGE_FUNCTION = "mastra/storage:handle";
 var ConvexAdminClient = class {
 	deploymentUrl;
@@ -253,8 +251,7 @@ var ConvexAdminClient = class {
 		return result;
 	}
 };
-//#endregion
-//#region src/storage/run-fencing.ts
+// src/storage/run-fencing.ts
 const READ_OPS = /* @__PURE__ */ new Set([
 	"load",
 	"loadMany",
@@ -412,16 +409,14 @@ async function pruneRunClaims(client, tableName, column, cutoff, limit) {
 	}, "prune");
 	return result;
 }
-//#endregion
-//#region src/storage/types.ts
+// src/storage/types.ts
 /**
 * Observational memory table name. Defined locally (not value-imported from
 * core) following the mongodb/pg convention: core exports the constant, but
 * OM is optional and the constant is absent from older cores in the peer range.
 */
 const TABLE_OBSERVATIONAL_MEMORY$1 = "mastra_observational_memory";
-//#endregion
-//#region src/storage/db/index.ts
+// src/storage/db/index.ts
 const LOAD_MANY_REQUEST_BATCH_SIZE = 10;
 /**
 * Resolves ConvexDomainConfig to a ConvexAdminClient.
@@ -741,8 +736,7 @@ var ConvexDB = class ConvexDB extends _mastra_core_base.MastraBase {
 		return normalized;
 	}
 };
-//#endregion
-//#region src/storage/domains/background-tasks/index.ts
+// src/storage/domains/background-tasks/index.ts
 function serializeJson$1(v) {
 	if (v === void 0 || v === null) return null;
 	return JSON.stringify(v);
@@ -956,8 +950,7 @@ var BackgroundTasksConvex = class extends _mastra_core_storage.BackgroundTasksSt
 		return total;
 	}
 };
-//#endregion
-//#region src/storage/domains/channels/index.ts
+// src/storage/domains/channels/index.ts
 const statusPriority = {
 	active: 0,
 	pending: 1,
@@ -1094,8 +1087,7 @@ var ChannelsConvex = class extends _mastra_core_storage.ChannelsStorage {
 		await this.#db.deleteMany(_mastra_core_storage.TABLE_CHANNEL_CONFIG, [platform]);
 	}
 };
-//#endregion
-//#region ../../packages/_internal-core/dist/memory/index.js
+// ../../packages/_internal-core/dist/memory/index.js
 /**
 * Backs `updateActiveObservations` in adapters that implement `commitActiveObservations`.
 * Callers of `updateActiveObservations` (which resolves `void`) can't see a commit result, so a
@@ -1105,8 +1097,7 @@ function assertActiveObservationsApplied(result, id) {
 	if (result.applied) return;
 	throw new Error(result.reason === "retired" ? `Observational memory record ${id} was superseded by a newer generation; observations were not written` : `Observational memory record ${id} changed since the observations were composed; observations were not written`);
 }
-//#endregion
-//#region src/storage/domains/memory/index.ts
+// src/storage/domains/memory/index.ts
 function parseStoredThread(row) {
 	return {
 		...row,
@@ -1993,8 +1984,7 @@ var MemoryConvex = class MemoryConvex extends _mastra_core_storage.MemoryStorage
 		});
 	}
 };
-//#endregion
-//#region src/storage/domains/schedules/index.ts
+// src/storage/domains/schedules/index.ts
 const SCHEDULE_LIST_LIMIT = 8e3;
 function serializeJson(value) {
 	return JSON.stringify(value);
@@ -2211,8 +2201,7 @@ var SchedulesConvex = class extends _mastra_core_storage.SchedulesStorage {
 		})).map(recordToTrigger);
 	}
 };
-//#endregion
-//#region src/storage/domains/scores/index.ts
+// src/storage/domains/scores/index.ts
 var ScoresConvex = class extends _mastra_core_storage.ScoresStorage {
 	#db;
 	constructor(config) {
@@ -2306,8 +2295,7 @@ var ScoresConvex = class extends _mastra_core_storage.ScoresStorage {
 		};
 	}
 };
-//#endregion
-//#region src/storage/domains/workflows/index.ts
+// src/storage/domains/workflows/index.ts
 var WorkflowsConvex = class WorkflowsConvex extends _mastra_core_storage.WorkflowsStorage {
 	/**
 	* Tables `prune()` can clean up. Run ownership records anchor on `updatedAt` (epoch ms), which every
@@ -2501,8 +2489,7 @@ var WorkflowsConvex = class WorkflowsConvex extends _mastra_core_storage.Workflo
 		return JSON.parse(JSON.stringify(run.snapshot));
 	}
 };
-//#endregion
-//#region src/storage/index.ts
+// src/storage/index.ts
 /**
 * Type guard for pre-configured client config
 */
@@ -2548,8 +2535,7 @@ var ConvexStore = class extends _mastra_core_storage.MastraCompositeStore {
 		};
 	}
 };
-//#endregion
-//#region src/vector/index.ts
+// src/vector/index.ts
 const INDEX_METADATA_TABLE = "mastra_vector_indexes";
 const VECTOR_QUERY_PAGE_SIZE = 256;
 var ConvexVector = class extends _mastra_core_vector.MastraVector {
@@ -2817,8 +2803,7 @@ function cosineSimilarity(a, b) {
 	if (magA === 0 || magB === 0) return -1;
 	return dot / (Math.sqrt(magA) * Math.sqrt(magB));
 }
-//#endregion
-//#region src/vector/native.ts
+// src/vector/native.ts
 const DEFAULT_VECTOR_INDEX = "by_embedding";
 const DEFAULT_ID_FIELD = "id";
 const DEFAULT_ID_INDEX = "by_record_id";
@@ -3003,7 +2988,6 @@ var ConvexNativeVector = class extends _mastra_core_vector.MastraVector {
 		return typeof metadata === "object" && metadata !== null && !Array.isArray(metadata);
 	}
 };
-//#endregion
 exports.ConvexCacheClient = ConvexCacheClient;
 exports.ConvexNativeVector = ConvexNativeVector;
 exports.ConvexServerCache = ConvexServerCache;