@mastra/oracledb 0.5.4 → 0.5.5-alpha.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.js CHANGED
@@ -5,7 +5,7 @@ import { createHash } from "crypto";
5
5
  import { AgentsStorage, MCPClientsStorage, MastraCompositeStore, MemoryStorage, ObservabilityStorage, RUN_FENCING_TABLE_SCHEMAS, RunFenceConflictError, ScorerDefinitionsStorage, ScoresStorage, TABLE_AGENTS, TABLE_AGENT_VERSIONS, TABLE_MCP_CLIENTS, TABLE_MCP_CLIENT_VERSIONS, TABLE_MEMORY_RUN_FENCES, TABLE_MESSAGES, TABLE_OBSERVATIONAL_MEMORY, TABLE_RESOURCES, TABLE_SCHEMAS, TABLE_SCORERS, TABLE_SCORER_DEFINITIONS, TABLE_SCORER_DEFINITION_VERSIONS, TABLE_SPANS, TABLE_THREADS, TABLE_WORKFLOW_RUN_OWNERS, TABLE_WORKFLOW_SNAPSHOT, TraceStatus, WorkflowsStorage, calculatePagination, createStorageErrorId, createVectorErrorId, executeRetentionPrune, isRunFenceConflictError, listLogsArgsSchema, listScoresArgsSchema, listTracesArgsSchema, matchesExpectedWorkflowStatus, matchesRunFence, normalizePerPage, resolveRetentionTargets, resolveRunFence, retentionCutoffMs, storageMessageMatchesMetadataFilter, toTraceSpans, transformScoreRow, validateStorageMetadataFilter } from "@mastra/core/storage";
6
6
  import { MessageList } from "@mastra/core/agent";
7
7
  import { saveScorePayloadSchema } from "@mastra/core/evals";
8
- //#region src/shared/connection.ts
8
+ // src/shared/connection.ts
9
9
  var OraclePoolManager = class {
10
10
  config;
11
11
  poolPromise;
@@ -202,8 +202,7 @@ function isOracleErrorCode(error, ignoredCodes) {
202
202
  const message = "message" in error ? String(error.message) : "";
203
203
  return ignoredCodes.some((code) => message.includes(`ORA-${String(Math.abs(code)).padStart(5, "0")}`));
204
204
  }
205
- //#endregion
206
- //#region src/vector/identifiers.ts
205
+ // src/vector/identifiers.ts
207
206
  const IDENTIFIER_PATTERN = /^[A-Za-z][A-Za-z0-9_]*$/;
208
207
  const MAX_IDENTIFIER_LENGTH = 128;
209
208
  const MAX_LOGICAL_INDEX_NAME_LENGTH = 512;
@@ -277,8 +276,7 @@ function jsonPathSegment(part) {
277
276
  function shortHash(value) {
278
277
  return createHash("sha256").update(value).digest("hex").slice(0, 12).toUpperCase();
279
278
  }
280
- //#endregion
281
- //#region src/vector/sql.ts
279
+ // src/vector/sql.ts
282
280
  function normalizeMetric(metric) {
283
281
  const normalized = metric.toLowerCase();
284
282
  if (normalized !== "cosine" && normalized !== "euclidean" && normalized !== "dotproduct" && normalized !== "hamming" && normalized !== "jaccard") throw new Error("metric must be one of \"cosine\", \"euclidean\", \"dotproduct\", \"hamming\", or \"jaccard\"");
@@ -339,8 +337,7 @@ function validatePositiveInteger$1(value) {
339
337
  if (!Number.isInteger(value) || value <= 0) throw new Error("vector index parameter must be a positive integer");
340
338
  return value;
341
339
  }
342
- //#endregion
343
- //#region src/vector/filter.ts
340
+ // src/vector/filter.ts
344
341
  var BindCollector = class {
345
342
  index = 0;
346
343
  binds = {};
@@ -1268,8 +1265,7 @@ function safeLegacyCanonicalIndexName(indexName) {
1268
1265
  return indexName;
1269
1266
  }
1270
1267
  }
1271
- //#endregion
1272
- //#region src/vector/query.ts
1268
+ // src/vector/query.ts
1273
1269
  async function query(registry, withConnection, { indexName, queryVector, topK = 10, filter, includeVector = false, minScore = -1, sparseVector, queryMode, targetAccuracy }) {
1274
1270
  try {
1275
1271
  if (sparseVector !== void 0) throw new Error("OracleVector does not support sparseVector queries yet; use dense queryVector search");
@@ -1405,8 +1401,7 @@ function unpackBitVector(bytes, dimension) {
1405
1401
  }
1406
1402
  return vector;
1407
1403
  }
1408
- //#endregion
1409
- //#region src/vector/stats.ts
1404
+ // src/vector/stats.ts
1410
1405
  async function listIndexes(registry, withConnection) {
1411
1406
  return withConnection(async (connection) => {
1412
1407
  await registry.ensureRegistry(connection);
@@ -1517,8 +1512,7 @@ function normalizeVectorMemoryScope(scope) {
1517
1512
  function createVectorMemoryConfigurationError(size, scope, cause) {
1518
1513
  return withCause(/* @__PURE__ */ new Error(`Unable to set Oracle VECTOR_MEMORY_SIZE=${size} SCOPE=${scope}. Run this with a DBA-capable user such as SYSTEM for local Docker databases, or ask your DBA to size the Vector Pool before building HNSW indexes.`), cause);
1519
1514
  }
1520
- //#endregion
1521
- //#region src/vector/index.ts
1515
+ // src/vector/index.ts
1522
1516
  var OracleVector = class extends MastraVector {
1523
1517
  poolManager;
1524
1518
  ownsPoolManager;
@@ -1611,8 +1605,7 @@ var OracleVector = class extends MastraVector {
1611
1605
  return this.registry.createVectorIndex(connection, indexName, metric, indexConfig, tableNameOverride);
1612
1606
  }
1613
1607
  };
1614
- //#endregion
1615
- //#region src/storage/db/index.ts
1608
+ // src/storage/db/index.ts
1616
1609
  var OracleConnectionClient = class {
1617
1610
  connection;
1618
1611
  constructor(connection) {
@@ -2133,8 +2126,7 @@ function validateBalancedParentheses(expression, label) {
2133
2126
  function validatePositiveInteger(value, label) {
2134
2127
  if (!Number.isSafeInteger(value) || value <= 0) throw new Error(`${label} must be a positive safe integer`);
2135
2128
  }
2136
- //#endregion
2137
- //#region src/storage/domain-utils.ts
2129
+ // src/storage/domain-utils.ts
2138
2130
  function createOracleStorageError({ storeName = "ORACLEDB", operation, reason, details, cause, category = ErrorCategory.THIRD_PARTY }) {
2139
2131
  const safeDetails = Object.fromEntries(Object.entries(details).filter((entry) => entry[1] !== void 0));
2140
2132
  return new MastraError({
@@ -2171,8 +2163,7 @@ function parseOptionalStringArray(value) {
2171
2163
  function toDate(value) {
2172
2164
  return value instanceof Date ? value : new Date(String(value));
2173
2165
  }
2174
- //#endregion
2175
- //#region src/storage/domains/agents/index.ts
2166
+ // src/storage/domains/agents/index.ts
2176
2167
  const STORE_NAME$7 = "ORACLEDB";
2177
2168
  const AGENT_ACTIVE_VERSION_ID = "\"activeVersionId\"";
2178
2169
  const AGENT_AUTHOR_ID = "\"authorId\"";
@@ -2865,8 +2856,7 @@ function jsonComparableValue$2(value) {
2865
2856
  if (typeof value === "object") return JSON.stringify(safeJsonValue(value));
2866
2857
  return value;
2867
2858
  }
2868
- //#endregion
2869
- //#region src/storage/domains/mcp-clients/index.ts
2859
+ // src/storage/domains/mcp-clients/index.ts
2870
2860
  const STORE_NAME$6 = "ORACLEDB";
2871
2861
  const SNAPSHOT_FIELDS$1 = [
2872
2862
  "name",
@@ -3344,8 +3334,7 @@ function jsonComparableValue$1(value) {
3344
3334
  if (typeof value === "object") return JSON.stringify(safeJsonValue(value));
3345
3335
  return value;
3346
3336
  }
3347
- //#endregion
3348
- //#region ../../packages/_internal-core/dist/memory/index.js
3337
+ // ../../packages/_internal-core/dist/memory/index.js
3349
3338
  /**
3350
3339
  * A buffered chunk stores `lastObservedAt = max message time + 1ms`. It is wholly covered
3351
3340
  * (every message it observed is already at or before the cursor) iff
@@ -3409,8 +3398,7 @@ function isAppendOnlySince(storedObservations, snapshotObservations) {
3409
3398
  const snapshot = snapshotObservations ?? "";
3410
3399
  return stored === snapshot || stored.startsWith(snapshot);
3411
3400
  }
3412
- //#endregion
3413
- //#region src/storage/db/run-fencing.ts
3401
+ // src/storage/db/run-fencing.ts
3414
3402
  const SINCE_EPOCH = `(SYS_EXTRACT_UTC(SYSTIMESTAMP) - TIMESTAMP '1970-01-01 00:00:00')`;
3415
3403
  /**
3416
3404
  * Epoch milliseconds on the database clock. Oracle evaluates `SYSTIMESTAMP`
@@ -3463,8 +3451,7 @@ async function claimTransaction(db, fn) {
3463
3451
  if (attempt >= MAX_CLAIM_ATTEMPTS || !retryable) throw error;
3464
3452
  }
3465
3453
  }
3466
- //#endregion
3467
- //#region src/storage/domains/memory/utils.ts
3454
+ // src/storage/domains/memory/utils.ts
3468
3455
  const STORE_NAME$5 = "ORACLEDB";
3469
3456
  const EMPTY_STRING_SENTINEL = "__MASTRA_ORACLE_EMPTY_STRING__";
3470
3457
  const STRING_SENTINEL_ESCAPE_PREFIX = "__MASTRA_ORACLE_ESCAPED__";
@@ -3627,8 +3614,7 @@ async function deleteSemanticRecallVectorsByMessageIds(ctx, client, messageIds)
3627
3614
  if (!isOracleErrorCode(error, [-942])) throw error;
3628
3615
  }
3629
3616
  }
3630
- //#endregion
3631
- //#region src/storage/domains/memory/schema.ts
3617
+ // src/storage/domains/memory/schema.ts
3632
3618
  const THREAD_RESOURCE_ID = "\"resourceId\"";
3633
3619
  const THREAD_CREATED_AT = "\"createdAt\"";
3634
3620
  const THREAD_UPDATED_AT = "\"updatedAt\"";
@@ -3987,8 +3973,7 @@ function defaultIndexes(_ctx) {
3987
3973
  }
3988
3974
  ];
3989
3975
  }
3990
- //#endregion
3991
- //#region src/storage/domains/memory/messages.ts
3976
+ // src/storage/domains/memory/messages.ts
3992
3977
  const MAX_MESSAGE_STRING_BIND_BYTES = 3900;
3993
3978
  async function listMessagesById(ctx, { messageIds }) {
3994
3979
  if (messageIds.length === 0) return { messages: [] };
@@ -4444,8 +4429,7 @@ function mergeMessageContent(existingContent, updateContent) {
4444
4429
  } } : {}
4445
4430
  };
4446
4431
  }
4447
- //#endregion
4448
- //#region src/storage/domains/memory/observational.ts
4432
+ // src/storage/domains/memory/observational.ts
4449
4433
  /** Hops a write aimed at a retired record may follow to reach the head before giving up. */
4450
4434
  const OM_MAX_HEAD_HOPS = 3;
4451
4435
  /** Canonical head order for a lookup key. */
@@ -5036,8 +5020,7 @@ async function resolveLiveOMRow(ctx, connection, row) {
5036
5020
  }
5037
5021
  return current;
5038
5022
  }
5039
- //#endregion
5040
- //#region src/storage/domains/memory/observational-buffering.ts
5023
+ // src/storage/domains/memory/observational-buffering.ts
5041
5024
  async function updateBufferedObservations(ctx, input, fence) {
5042
5025
  try {
5043
5026
  return await ctx.db.tx(async (client, connection) => {
@@ -5263,8 +5246,7 @@ function calculateBufferedActivation(chunks, input) {
5263
5246
  }
5264
5247
  };
5265
5248
  }
5266
- //#endregion
5267
- //#region src/storage/domains/memory/resources.ts
5249
+ // src/storage/domains/memory/resources.ts
5268
5250
  async function getResourceById(ctx, { resourceId }) {
5269
5251
  try {
5270
5252
  return await ctx.db.withConnection(async (connection) => {
@@ -5410,8 +5392,7 @@ function parseResource(row) {
5410
5392
  function resourceSelect() {
5411
5393
  return `SELECT id AS "id", ${RESOURCE_WORKING_MEMORY} AS "workingMemory", metadata AS "metadata", ${RESOURCE_CREATED_AT} AS "createdAt", ${RESOURCE_UPDATED_AT} AS "updatedAt"`;
5412
5394
  }
5413
- //#endregion
5414
- //#region src/storage/domains/memory/threads.ts
5395
+ // src/storage/domains/memory/threads.ts
5415
5396
  async function getThreadById(ctx, { threadId, resourceId }) {
5416
5397
  try {
5417
5398
  return await ctx.db.withConnection(async (connection) => {
@@ -5685,8 +5666,7 @@ function threadSelect() {
5685
5666
  function threadOrderColumn(field) {
5686
5667
  return field === "updatedAt" ? THREAD_UPDATED_AT : THREAD_CREATED_AT;
5687
5668
  }
5688
- //#endregion
5689
- //#region src/storage/domains/memory/index.ts
5669
+ // src/storage/domains/memory/index.ts
5690
5670
  const DEFAULT_MESSAGE_SAVE_BATCH_SIZE = 200;
5691
5671
  const DEFAULT_VECTOR_REGISTRY_TABLE$1 = "MASTRA_VECTOR_INDEXES";
5692
5672
  var MemoryOracle = class MemoryOracle extends MemoryStorage {
@@ -6016,8 +5996,7 @@ var MemoryOracle = class MemoryOracle extends MemoryStorage {
6016
5996
  return swapBufferedReflectionToActive(this.ctx, input, resolveRunFence(this, void 0));
6017
5997
  }
6018
5998
  };
6019
- //#endregion
6020
- //#region src/storage/domains/observability/schema.ts
5999
+ // src/storage/domains/observability/schema.ts
6021
6000
  const STORE_NAME$4 = "ORACLEDB";
6022
6001
  const SPAN_SCHEMA = TABLE_SCHEMAS[TABLE_SPANS];
6023
6002
  const SCORE_SCHEMA = TABLE_SCHEMAS[TABLE_SCORERS];
@@ -6329,8 +6308,7 @@ function storageError(operation, reason, details, cause, category = ErrorCategor
6329
6308
  category
6330
6309
  });
6331
6310
  }
6332
- //#endregion
6333
- //#region src/storage/domains/observability/binds.ts
6311
+ // src/storage/domains/observability/binds.ts
6334
6312
  function isIdentifierLikeColumn(columnName) {
6335
6313
  return columnName === "id" || columnName.endsWith("Id") || columnName.endsWith("_id");
6336
6314
  }
@@ -6385,8 +6363,7 @@ function bindDefForLogColumn(columnName) {
6385
6363
  maxSize: isIdentifierLikeColumn(columnName) ? 512 : 4e3
6386
6364
  };
6387
6365
  }
6388
- //#endregion
6389
- //#region src/storage/domains/observability/logs.ts
6366
+ // src/storage/domains/observability/logs.ts
6390
6367
  async function batchCreateLogs(db, schemaName, args) {
6391
6368
  if (args.logs.length === 0) return;
6392
6369
  try {
@@ -6499,8 +6476,7 @@ function addLogTagsFilter(conditions, binds, tableAlias, tags) {
6499
6476
  if (!tags?.length) return;
6500
6477
  for (const tag of tags) conditions.push(`EXISTS (SELECT 1 FROM JSON_TABLE(${logQcol(tableAlias, "tags")}, '$[*]' COLUMNS (tag VARCHAR2(4000) PATH '$')) tag_filter WHERE tag_filter.tag = ${addBind(binds, tag)})`);
6501
6478
  }
6502
- //#endregion
6503
- //#region src/storage/domains/observability/scores-bridge.ts
6479
+ // src/storage/domains/observability/scores-bridge.ts
6504
6480
  async function listScores(db, schemaName, args) {
6505
6481
  const { mode, filters, pagination, orderBy } = listScoresArgsSchema.parse(args);
6506
6482
  if (mode === "delta") throw new MastraError({
@@ -6772,8 +6748,7 @@ function addScoreMetadataTagsFilter(conditions, binds, tableAlias, tags) {
6772
6748
  if (!tags?.length) return;
6773
6749
  for (const tag of tags) conditions.push(`EXISTS (SELECT 1 FROM JSON_TABLE(${scoreQcol(tableAlias, "metadata")}, '$.tags[*]' COLUMNS (tag VARCHAR2(4000) PATH '$')) tag_filter WHERE tag_filter.tag = ${addBind(binds, tag)})`);
6774
6750
  }
6775
- //#endregion
6776
- //#region src/storage/domains/observability/spans.ts
6751
+ // src/storage/domains/observability/spans.ts
6777
6752
  async function createSpan(db, schemaName, args) {
6778
6753
  const { span } = args;
6779
6754
  try {
@@ -7176,8 +7151,7 @@ function traceOrderClause(field, direction) {
7176
7151
  }
7177
7152
  return `ORDER BY r.${col("startedAt")} ${direction}, r.${col("traceId")} ${direction}`;
7178
7153
  }
7179
- //#endregion
7180
- //#region src/storage/domains/observability/index.ts
7154
+ // src/storage/domains/observability/index.ts
7181
7155
  var ObservabilityOracle = class ObservabilityOracle extends ObservabilityStorage {
7182
7156
  static retentionTables = {
7183
7157
  spans: {
@@ -7352,8 +7326,7 @@ var ObservabilityOracle = class ObservabilityOracle extends ObservabilityStorage
7352
7326
  return indexNameForTable(indexName, "IDX");
7353
7327
  }
7354
7328
  };
7355
- //#endregion
7356
- //#region src/storage/domains/scorer-definitions/index.ts
7329
+ // src/storage/domains/scorer-definitions/index.ts
7357
7330
  const STORE_NAME$3 = "ORACLEDB";
7358
7331
  const SNAPSHOT_FIELDS = [
7359
7332
  "name",
@@ -7870,8 +7843,7 @@ function metadataJsonEquals(column, path, bindName) {
7870
7843
  const jsonPath = assertJsonPath(path);
7871
7844
  return `JSON_EXISTS(${column}, '${jsonPath}') AND JSON_EQUAL(JSON_QUERY(${column}, '${jsonPath}' RETURNING JSON NULL ON ERROR), :${bindName})`;
7872
7845
  }
7873
- //#endregion
7874
- //#region src/storage/domains/scores/index.ts
7846
+ // src/storage/domains/scores/index.ts
7875
7847
  const STORE_NAME$2 = "ORACLEDB";
7876
7848
  const SCORE_CREATED_AT = "\"createdAt\"";
7877
7849
  const SCORE_UPDATED_AT = "\"updatedAt\"";
@@ -8351,8 +8323,7 @@ function scoreColumnSql(columnName) {
8351
8323
  function scoreTempClobColumnName(columnName) {
8352
8324
  return `ORACLE_TMP_${columnName.toUpperCase()}_CLOB`;
8353
8325
  }
8354
- //#endregion
8355
- //#region src/storage/domains/workflows/index.ts
8326
+ // src/storage/domains/workflows/index.ts
8356
8327
  const STORE_NAME$1 = "ORACLEDB";
8357
8328
  const WORKFLOW_CREATED_AT = "\"createdAt\"";
8358
8329
  const WORKFLOW_UPDATED_AT = "\"updatedAt\"";
@@ -8878,8 +8849,7 @@ function parseSnapshot(value) {
8878
8849
  if (value && typeof value === "object") return value;
8879
8850
  throw new Error("Workflow snapshot is empty or invalid");
8880
8851
  }
8881
- //#endregion
8882
- //#region src/storage/migrations.ts
8852
+ // src/storage/migrations.ts
8883
8853
  const DEFAULT_ORACLE_MIGRATIONS_TABLE = "MASTRA_ORACLE_MIGRATIONS";
8884
8854
  const MIGRATION_ID_PATTERN = /^[A-Za-z][A-Za-z0-9_.:-]*$/;
8885
8855
  const MAX_MIGRATION_ID_LENGTH = 256;
@@ -9036,8 +9006,7 @@ function normalizeMigrationChecksum(value) {
9036
9006
  function checksumMigration(input) {
9037
9007
  return createHash("sha256").update(JSON.stringify(input)).digest("hex").toUpperCase();
9038
9008
  }
9039
- //#endregion
9040
- //#region src/storage/index.ts
9009
+ // src/storage/index.ts
9041
9010
  const STORE_NAME = "ORACLEDB";
9042
9011
  const DOMAIN_SCHEMA_VERSIONS = {
9043
9012
  R001_MEMORY_SCHEMA: 2,
@@ -9220,8 +9189,7 @@ function stableStringify(value) {
9220
9189
  if (!value || typeof value !== "object") return JSON.stringify(value);
9221
9190
  return `{${Object.keys(value).sort().map((key) => `${JSON.stringify(key)}:${stableStringify(value[key])}`).join(",")}}`;
9222
9191
  }
9223
- //#endregion
9224
- //#region src/schema.ts
9192
+ // src/schema.ts
9225
9193
  const DEFAULT_DOMAINS = [
9226
9194
  "migrations",
9227
9195
  "memory",
@@ -9631,8 +9599,7 @@ function storageConstraintName(name) {
9631
9599
  function escapeSqlLiteral(value) {
9632
9600
  return value.replace(/'/g, "''");
9633
9601
  }
9634
- //#endregion
9635
- //#region src/vector/prompt.ts
9602
+ // src/vector/prompt.ts
9636
9603
  /**
9637
9604
  * Vector store specific prompt that details supported Oracle JSON metadata filter operators and examples.
9638
9605
  * This prompt helps users construct valid filters for Oracle Database Vector Search.
@@ -9742,7 +9709,6 @@ Example Complex Query:
9742
9709
  ]}
9743
9710
  ]
9744
9711
  }`;
9745
- //#endregion
9746
9712
  export { AgentsOracle, DEFAULT_ORACLE_MIGRATIONS_TABLE, MCPClientsOracle, MemoryOracle, ORACLEDB_PROMPT, ObservabilityOracle, OracleDB, OracleMigrationRegistry, OraclePoolManager, OracleStore, OracleVector, ScorerDefinitionsOracle, ScoresOracle, WorkflowsOracle, exportSchemas, oracleMigrationTableSql };
9747
9713
 
9748
9714
  //# sourceMappingURL=index.js.map