@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.cjs CHANGED
@@ -1,5 +1,5 @@
1
1
  Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
2
- //#region \0rolldown/runtime.js
2
+ // \0rolldown/runtime.js
3
3
  var __create = Object.create;
4
4
  var __defProp = Object.defineProperty;
5
5
  var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
@@ -20,7 +20,6 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
20
20
  value: mod,
21
21
  enumerable: true
22
22
  }) : target, mod));
23
- //#endregion
24
23
  let _mastra_core_vector = require("@mastra/core/vector");
25
24
  let oracledb = require("oracledb");
26
25
  oracledb = __toESM(oracledb, 1);
@@ -29,7 +28,7 @@ let crypto$1 = require("crypto");
29
28
  let _mastra_core_storage = require("@mastra/core/storage");
30
29
  let _mastra_core_agent = require("@mastra/core/agent");
31
30
  let _mastra_core_evals = require("@mastra/core/evals");
32
- //#region src/shared/connection.ts
31
+ // src/shared/connection.ts
33
32
  var OraclePoolManager = class {
34
33
  config;
35
34
  poolPromise;
@@ -226,8 +225,7 @@ function isOracleErrorCode(error, ignoredCodes) {
226
225
  const message = "message" in error ? String(error.message) : "";
227
226
  return ignoredCodes.some((code) => message.includes(`ORA-${String(Math.abs(code)).padStart(5, "0")}`));
228
227
  }
229
- //#endregion
230
- //#region src/vector/identifiers.ts
228
+ // src/vector/identifiers.ts
231
229
  const IDENTIFIER_PATTERN = /^[A-Za-z][A-Za-z0-9_]*$/;
232
230
  const MAX_IDENTIFIER_LENGTH = 128;
233
231
  const MAX_LOGICAL_INDEX_NAME_LENGTH = 512;
@@ -301,8 +299,7 @@ function jsonPathSegment(part) {
301
299
  function shortHash(value) {
302
300
  return (0, crypto$1.createHash)("sha256").update(value).digest("hex").slice(0, 12).toUpperCase();
303
301
  }
304
- //#endregion
305
- //#region src/vector/sql.ts
302
+ // src/vector/sql.ts
306
303
  function normalizeMetric(metric) {
307
304
  const normalized = metric.toLowerCase();
308
305
  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\"");
@@ -363,8 +360,7 @@ function validatePositiveInteger$1(value) {
363
360
  if (!Number.isInteger(value) || value <= 0) throw new Error("vector index parameter must be a positive integer");
364
361
  return value;
365
362
  }
366
- //#endregion
367
- //#region src/vector/filter.ts
363
+ // src/vector/filter.ts
368
364
  var BindCollector = class {
369
365
  index = 0;
370
366
  binds = {};
@@ -1292,8 +1288,7 @@ function safeLegacyCanonicalIndexName(indexName) {
1292
1288
  return indexName;
1293
1289
  }
1294
1290
  }
1295
- //#endregion
1296
- //#region src/vector/query.ts
1291
+ // src/vector/query.ts
1297
1292
  async function query(registry, withConnection, { indexName, queryVector, topK = 10, filter, includeVector = false, minScore = -1, sparseVector, queryMode, targetAccuracy }) {
1298
1293
  try {
1299
1294
  if (sparseVector !== void 0) throw new Error("OracleVector does not support sparseVector queries yet; use dense queryVector search");
@@ -1429,8 +1424,7 @@ function unpackBitVector(bytes, dimension) {
1429
1424
  }
1430
1425
  return vector;
1431
1426
  }
1432
- //#endregion
1433
- //#region src/vector/stats.ts
1427
+ // src/vector/stats.ts
1434
1428
  async function listIndexes(registry, withConnection) {
1435
1429
  return withConnection(async (connection) => {
1436
1430
  await registry.ensureRegistry(connection);
@@ -1541,8 +1535,7 @@ function normalizeVectorMemoryScope(scope) {
1541
1535
  function createVectorMemoryConfigurationError(size, scope, cause) {
1542
1536
  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);
1543
1537
  }
1544
- //#endregion
1545
- //#region src/vector/index.ts
1538
+ // src/vector/index.ts
1546
1539
  var OracleVector = class extends _mastra_core_vector.MastraVector {
1547
1540
  poolManager;
1548
1541
  ownsPoolManager;
@@ -1635,8 +1628,7 @@ var OracleVector = class extends _mastra_core_vector.MastraVector {
1635
1628
  return this.registry.createVectorIndex(connection, indexName, metric, indexConfig, tableNameOverride);
1636
1629
  }
1637
1630
  };
1638
- //#endregion
1639
- //#region src/storage/db/index.ts
1631
+ // src/storage/db/index.ts
1640
1632
  var OracleConnectionClient = class {
1641
1633
  connection;
1642
1634
  constructor(connection) {
@@ -2157,8 +2149,7 @@ function validateBalancedParentheses(expression, label) {
2157
2149
  function validatePositiveInteger(value, label) {
2158
2150
  if (!Number.isSafeInteger(value) || value <= 0) throw new Error(`${label} must be a positive safe integer`);
2159
2151
  }
2160
- //#endregion
2161
- //#region src/storage/domain-utils.ts
2152
+ // src/storage/domain-utils.ts
2162
2153
  function createOracleStorageError({ storeName = "ORACLEDB", operation, reason, details, cause, category = _mastra_core_error.ErrorCategory.THIRD_PARTY }) {
2163
2154
  const safeDetails = Object.fromEntries(Object.entries(details).filter((entry) => entry[1] !== void 0));
2164
2155
  return new _mastra_core_error.MastraError({
@@ -2195,8 +2186,7 @@ function parseOptionalStringArray(value) {
2195
2186
  function toDate(value) {
2196
2187
  return value instanceof Date ? value : new Date(String(value));
2197
2188
  }
2198
- //#endregion
2199
- //#region src/storage/domains/agents/index.ts
2189
+ // src/storage/domains/agents/index.ts
2200
2190
  const STORE_NAME$7 = "ORACLEDB";
2201
2191
  const AGENT_ACTIVE_VERSION_ID = "\"activeVersionId\"";
2202
2192
  const AGENT_AUTHOR_ID = "\"authorId\"";
@@ -2889,8 +2879,7 @@ function jsonComparableValue$2(value) {
2889
2879
  if (typeof value === "object") return JSON.stringify(safeJsonValue(value));
2890
2880
  return value;
2891
2881
  }
2892
- //#endregion
2893
- //#region src/storage/domains/mcp-clients/index.ts
2882
+ // src/storage/domains/mcp-clients/index.ts
2894
2883
  const STORE_NAME$6 = "ORACLEDB";
2895
2884
  const SNAPSHOT_FIELDS$1 = [
2896
2885
  "name",
@@ -3368,8 +3357,7 @@ function jsonComparableValue$1(value) {
3368
3357
  if (typeof value === "object") return JSON.stringify(safeJsonValue(value));
3369
3358
  return value;
3370
3359
  }
3371
- //#endregion
3372
- //#region ../../packages/_internal-core/dist/memory/index.js
3360
+ // ../../packages/_internal-core/dist/memory/index.js
3373
3361
  /**
3374
3362
  * A buffered chunk stores `lastObservedAt = max message time + 1ms`. It is wholly covered
3375
3363
  * (every message it observed is already at or before the cursor) iff
@@ -3433,8 +3421,7 @@ function isAppendOnlySince(storedObservations, snapshotObservations) {
3433
3421
  const snapshot = snapshotObservations ?? "";
3434
3422
  return stored === snapshot || stored.startsWith(snapshot);
3435
3423
  }
3436
- //#endregion
3437
- //#region src/storage/db/run-fencing.ts
3424
+ // src/storage/db/run-fencing.ts
3438
3425
  const SINCE_EPOCH = `(SYS_EXTRACT_UTC(SYSTIMESTAMP) - TIMESTAMP '1970-01-01 00:00:00')`;
3439
3426
  /**
3440
3427
  * Epoch milliseconds on the database clock. Oracle evaluates `SYSTIMESTAMP`
@@ -3487,8 +3474,7 @@ async function claimTransaction(db, fn) {
3487
3474
  if (attempt >= MAX_CLAIM_ATTEMPTS || !retryable) throw error;
3488
3475
  }
3489
3476
  }
3490
- //#endregion
3491
- //#region src/storage/domains/memory/utils.ts
3477
+ // src/storage/domains/memory/utils.ts
3492
3478
  const STORE_NAME$5 = "ORACLEDB";
3493
3479
  const EMPTY_STRING_SENTINEL = "__MASTRA_ORACLE_EMPTY_STRING__";
3494
3480
  const STRING_SENTINEL_ESCAPE_PREFIX = "__MASTRA_ORACLE_ESCAPED__";
@@ -3651,8 +3637,7 @@ async function deleteSemanticRecallVectorsByMessageIds(ctx, client, messageIds)
3651
3637
  if (!isOracleErrorCode(error, [-942])) throw error;
3652
3638
  }
3653
3639
  }
3654
- //#endregion
3655
- //#region src/storage/domains/memory/schema.ts
3640
+ // src/storage/domains/memory/schema.ts
3656
3641
  const THREAD_RESOURCE_ID = "\"resourceId\"";
3657
3642
  const THREAD_CREATED_AT = "\"createdAt\"";
3658
3643
  const THREAD_UPDATED_AT = "\"updatedAt\"";
@@ -4011,8 +3996,7 @@ function defaultIndexes(_ctx) {
4011
3996
  }
4012
3997
  ];
4013
3998
  }
4014
- //#endregion
4015
- //#region src/storage/domains/memory/messages.ts
3999
+ // src/storage/domains/memory/messages.ts
4016
4000
  const MAX_MESSAGE_STRING_BIND_BYTES = 3900;
4017
4001
  async function listMessagesById(ctx, { messageIds }) {
4018
4002
  if (messageIds.length === 0) return { messages: [] };
@@ -4468,8 +4452,7 @@ function mergeMessageContent(existingContent, updateContent) {
4468
4452
  } } : {}
4469
4453
  };
4470
4454
  }
4471
- //#endregion
4472
- //#region src/storage/domains/memory/observational.ts
4455
+ // src/storage/domains/memory/observational.ts
4473
4456
  /** Hops a write aimed at a retired record may follow to reach the head before giving up. */
4474
4457
  const OM_MAX_HEAD_HOPS = 3;
4475
4458
  /** Canonical head order for a lookup key. */
@@ -5060,8 +5043,7 @@ async function resolveLiveOMRow(ctx, connection, row) {
5060
5043
  }
5061
5044
  return current;
5062
5045
  }
5063
- //#endregion
5064
- //#region src/storage/domains/memory/observational-buffering.ts
5046
+ // src/storage/domains/memory/observational-buffering.ts
5065
5047
  async function updateBufferedObservations(ctx, input, fence) {
5066
5048
  try {
5067
5049
  return await ctx.db.tx(async (client, connection) => {
@@ -5287,8 +5269,7 @@ function calculateBufferedActivation(chunks, input) {
5287
5269
  }
5288
5270
  };
5289
5271
  }
5290
- //#endregion
5291
- //#region src/storage/domains/memory/resources.ts
5272
+ // src/storage/domains/memory/resources.ts
5292
5273
  async function getResourceById(ctx, { resourceId }) {
5293
5274
  try {
5294
5275
  return await ctx.db.withConnection(async (connection) => {
@@ -5434,8 +5415,7 @@ function parseResource(row) {
5434
5415
  function resourceSelect() {
5435
5416
  return `SELECT id AS "id", ${RESOURCE_WORKING_MEMORY} AS "workingMemory", metadata AS "metadata", ${RESOURCE_CREATED_AT} AS "createdAt", ${RESOURCE_UPDATED_AT} AS "updatedAt"`;
5436
5417
  }
5437
- //#endregion
5438
- //#region src/storage/domains/memory/threads.ts
5418
+ // src/storage/domains/memory/threads.ts
5439
5419
  async function getThreadById(ctx, { threadId, resourceId }) {
5440
5420
  try {
5441
5421
  return await ctx.db.withConnection(async (connection) => {
@@ -5709,8 +5689,7 @@ function threadSelect() {
5709
5689
  function threadOrderColumn(field) {
5710
5690
  return field === "updatedAt" ? THREAD_UPDATED_AT : THREAD_CREATED_AT;
5711
5691
  }
5712
- //#endregion
5713
- //#region src/storage/domains/memory/index.ts
5692
+ // src/storage/domains/memory/index.ts
5714
5693
  const DEFAULT_MESSAGE_SAVE_BATCH_SIZE = 200;
5715
5694
  const DEFAULT_VECTOR_REGISTRY_TABLE$1 = "MASTRA_VECTOR_INDEXES";
5716
5695
  var MemoryOracle = class MemoryOracle extends _mastra_core_storage.MemoryStorage {
@@ -6040,8 +6019,7 @@ var MemoryOracle = class MemoryOracle extends _mastra_core_storage.MemoryStorage
6040
6019
  return swapBufferedReflectionToActive(this.ctx, input, (0, _mastra_core_storage.resolveRunFence)(this, void 0));
6041
6020
  }
6042
6021
  };
6043
- //#endregion
6044
- //#region src/storage/domains/observability/schema.ts
6022
+ // src/storage/domains/observability/schema.ts
6045
6023
  const STORE_NAME$4 = "ORACLEDB";
6046
6024
  const SPAN_SCHEMA = _mastra_core_storage.TABLE_SCHEMAS[_mastra_core_storage.TABLE_SPANS];
6047
6025
  const SCORE_SCHEMA = _mastra_core_storage.TABLE_SCHEMAS[_mastra_core_storage.TABLE_SCORERS];
@@ -6353,8 +6331,7 @@ function storageError(operation, reason, details, cause, category = _mastra_core
6353
6331
  category
6354
6332
  });
6355
6333
  }
6356
- //#endregion
6357
- //#region src/storage/domains/observability/binds.ts
6334
+ // src/storage/domains/observability/binds.ts
6358
6335
  function isIdentifierLikeColumn(columnName) {
6359
6336
  return columnName === "id" || columnName.endsWith("Id") || columnName.endsWith("_id");
6360
6337
  }
@@ -6409,8 +6386,7 @@ function bindDefForLogColumn(columnName) {
6409
6386
  maxSize: isIdentifierLikeColumn(columnName) ? 512 : 4e3
6410
6387
  };
6411
6388
  }
6412
- //#endregion
6413
- //#region src/storage/domains/observability/logs.ts
6389
+ // src/storage/domains/observability/logs.ts
6414
6390
  async function batchCreateLogs(db, schemaName, args) {
6415
6391
  if (args.logs.length === 0) return;
6416
6392
  try {
@@ -6523,8 +6499,7 @@ function addLogTagsFilter(conditions, binds, tableAlias, tags) {
6523
6499
  if (!tags?.length) return;
6524
6500
  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)})`);
6525
6501
  }
6526
- //#endregion
6527
- //#region src/storage/domains/observability/scores-bridge.ts
6502
+ // src/storage/domains/observability/scores-bridge.ts
6528
6503
  async function listScores(db, schemaName, args) {
6529
6504
  const { mode, filters, pagination, orderBy } = _mastra_core_storage.listScoresArgsSchema.parse(args);
6530
6505
  if (mode === "delta") throw new _mastra_core_error.MastraError({
@@ -6796,8 +6771,7 @@ function addScoreMetadataTagsFilter(conditions, binds, tableAlias, tags) {
6796
6771
  if (!tags?.length) return;
6797
6772
  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)})`);
6798
6773
  }
6799
- //#endregion
6800
- //#region src/storage/domains/observability/spans.ts
6774
+ // src/storage/domains/observability/spans.ts
6801
6775
  async function createSpan(db, schemaName, args) {
6802
6776
  const { span } = args;
6803
6777
  try {
@@ -7200,8 +7174,7 @@ function traceOrderClause(field, direction) {
7200
7174
  }
7201
7175
  return `ORDER BY r.${col("startedAt")} ${direction}, r.${col("traceId")} ${direction}`;
7202
7176
  }
7203
- //#endregion
7204
- //#region src/storage/domains/observability/index.ts
7177
+ // src/storage/domains/observability/index.ts
7205
7178
  var ObservabilityOracle = class ObservabilityOracle extends _mastra_core_storage.ObservabilityStorage {
7206
7179
  static retentionTables = {
7207
7180
  spans: {
@@ -7376,8 +7349,7 @@ var ObservabilityOracle = class ObservabilityOracle extends _mastra_core_storage
7376
7349
  return indexNameForTable(indexName, "IDX");
7377
7350
  }
7378
7351
  };
7379
- //#endregion
7380
- //#region src/storage/domains/scorer-definitions/index.ts
7352
+ // src/storage/domains/scorer-definitions/index.ts
7381
7353
  const STORE_NAME$3 = "ORACLEDB";
7382
7354
  const SNAPSHOT_FIELDS = [
7383
7355
  "name",
@@ -7894,8 +7866,7 @@ function metadataJsonEquals(column, path, bindName) {
7894
7866
  const jsonPath = assertJsonPath(path);
7895
7867
  return `JSON_EXISTS(${column}, '${jsonPath}') AND JSON_EQUAL(JSON_QUERY(${column}, '${jsonPath}' RETURNING JSON NULL ON ERROR), :${bindName})`;
7896
7868
  }
7897
- //#endregion
7898
- //#region src/storage/domains/scores/index.ts
7869
+ // src/storage/domains/scores/index.ts
7899
7870
  const STORE_NAME$2 = "ORACLEDB";
7900
7871
  const SCORE_CREATED_AT = "\"createdAt\"";
7901
7872
  const SCORE_UPDATED_AT = "\"updatedAt\"";
@@ -8375,8 +8346,7 @@ function scoreColumnSql(columnName) {
8375
8346
  function scoreTempClobColumnName(columnName) {
8376
8347
  return `ORACLE_TMP_${columnName.toUpperCase()}_CLOB`;
8377
8348
  }
8378
- //#endregion
8379
- //#region src/storage/domains/workflows/index.ts
8349
+ // src/storage/domains/workflows/index.ts
8380
8350
  const STORE_NAME$1 = "ORACLEDB";
8381
8351
  const WORKFLOW_CREATED_AT = "\"createdAt\"";
8382
8352
  const WORKFLOW_UPDATED_AT = "\"updatedAt\"";
@@ -8902,8 +8872,7 @@ function parseSnapshot(value) {
8902
8872
  if (value && typeof value === "object") return value;
8903
8873
  throw new Error("Workflow snapshot is empty or invalid");
8904
8874
  }
8905
- //#endregion
8906
- //#region src/storage/migrations.ts
8875
+ // src/storage/migrations.ts
8907
8876
  const DEFAULT_ORACLE_MIGRATIONS_TABLE = "MASTRA_ORACLE_MIGRATIONS";
8908
8877
  const MIGRATION_ID_PATTERN = /^[A-Za-z][A-Za-z0-9_.:-]*$/;
8909
8878
  const MAX_MIGRATION_ID_LENGTH = 256;
@@ -9060,8 +9029,7 @@ function normalizeMigrationChecksum(value) {
9060
9029
  function checksumMigration(input) {
9061
9030
  return (0, crypto$1.createHash)("sha256").update(JSON.stringify(input)).digest("hex").toUpperCase();
9062
9031
  }
9063
- //#endregion
9064
- //#region src/storage/index.ts
9032
+ // src/storage/index.ts
9065
9033
  const STORE_NAME = "ORACLEDB";
9066
9034
  const DOMAIN_SCHEMA_VERSIONS = {
9067
9035
  R001_MEMORY_SCHEMA: 2,
@@ -9244,8 +9212,7 @@ function stableStringify(value) {
9244
9212
  if (!value || typeof value !== "object") return JSON.stringify(value);
9245
9213
  return `{${Object.keys(value).sort().map((key) => `${JSON.stringify(key)}:${stableStringify(value[key])}`).join(",")}}`;
9246
9214
  }
9247
- //#endregion
9248
- //#region src/schema.ts
9215
+ // src/schema.ts
9249
9216
  const DEFAULT_DOMAINS = [
9250
9217
  "migrations",
9251
9218
  "memory",
@@ -9655,8 +9622,7 @@ function storageConstraintName(name) {
9655
9622
  function escapeSqlLiteral(value) {
9656
9623
  return value.replace(/'/g, "''");
9657
9624
  }
9658
- //#endregion
9659
- //#region src/vector/prompt.ts
9625
+ // src/vector/prompt.ts
9660
9626
  /**
9661
9627
  * Vector store specific prompt that details supported Oracle JSON metadata filter operators and examples.
9662
9628
  * This prompt helps users construct valid filters for Oracle Database Vector Search.
@@ -9766,7 +9732,6 @@ Example Complex Query:
9766
9732
  ]}
9767
9733
  ]
9768
9734
  }`;
9769
- //#endregion
9770
9735
  exports.AgentsOracle = AgentsOracle;
9771
9736
  exports.DEFAULT_ORACLE_MIGRATIONS_TABLE = DEFAULT_ORACLE_MIGRATIONS_TABLE;
9772
9737
  exports.MCPClientsOracle = MCPClientsOracle;