@mastra/pg 0.0.0-error-handler-fix-20251020202607 → 0.0.0-execa-dynamic-import-20260304221256

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.
Files changed (83) hide show
  1. package/CHANGELOG.md +3220 -3
  2. package/LICENSE.md +15 -0
  3. package/README.md +72 -20
  4. package/dist/docs/SKILL.md +40 -0
  5. package/dist/docs/assets/SOURCE_MAP.json +6 -0
  6. package/dist/docs/references/docs-memory-semantic-recall.md +288 -0
  7. package/dist/docs/references/docs-memory-storage.md +261 -0
  8. package/dist/docs/references/docs-memory-working-memory.md +400 -0
  9. package/dist/docs/references/docs-rag-overview.md +72 -0
  10. package/dist/docs/references/docs-rag-retrieval.md +515 -0
  11. package/dist/docs/references/docs-rag-vector-databases.md +645 -0
  12. package/dist/docs/references/reference-memory-memory-class.md +147 -0
  13. package/dist/docs/references/reference-processors-message-history-processor.md +85 -0
  14. package/dist/docs/references/reference-processors-semantic-recall-processor.md +117 -0
  15. package/dist/docs/references/reference-processors-working-memory-processor.md +152 -0
  16. package/dist/docs/references/reference-rag-metadata-filters.md +216 -0
  17. package/dist/docs/references/reference-storage-composite.md +235 -0
  18. package/dist/docs/references/reference-storage-dynamodb.md +282 -0
  19. package/dist/docs/references/reference-storage-postgresql.md +526 -0
  20. package/dist/docs/references/reference-tools-vector-query-tool.md +459 -0
  21. package/dist/docs/references/reference-vectors-pg.md +408 -0
  22. package/dist/index.cjs +11374 -2692
  23. package/dist/index.cjs.map +1 -1
  24. package/dist/index.d.ts +1 -1
  25. package/dist/index.d.ts.map +1 -1
  26. package/dist/index.js +11362 -2694
  27. package/dist/index.js.map +1 -1
  28. package/dist/shared/config.d.ts +122 -31
  29. package/dist/shared/config.d.ts.map +1 -1
  30. package/dist/storage/client.d.ts +91 -0
  31. package/dist/storage/client.d.ts.map +1 -0
  32. package/dist/storage/db/constraint-utils.d.ts +16 -0
  33. package/dist/storage/db/constraint-utils.d.ts.map +1 -0
  34. package/dist/storage/db/index.d.ts +235 -0
  35. package/dist/storage/db/index.d.ts.map +1 -0
  36. package/dist/storage/domains/agents/index.d.ts +52 -0
  37. package/dist/storage/domains/agents/index.d.ts.map +1 -0
  38. package/dist/storage/domains/blobs/index.d.ts +17 -0
  39. package/dist/storage/domains/blobs/index.d.ts.map +1 -0
  40. package/dist/storage/domains/datasets/index.d.ts +48 -0
  41. package/dist/storage/domains/datasets/index.d.ts.map +1 -0
  42. package/dist/storage/domains/experiments/index.d.ts +34 -0
  43. package/dist/storage/domains/experiments/index.d.ts.map +1 -0
  44. package/dist/storage/domains/mcp-clients/index.d.ts +33 -0
  45. package/dist/storage/domains/mcp-clients/index.d.ts.map +1 -0
  46. package/dist/storage/domains/mcp-servers/index.d.ts +33 -0
  47. package/dist/storage/domains/mcp-servers/index.d.ts.map +1 -0
  48. package/dist/storage/domains/memory/index.d.ts +74 -55
  49. package/dist/storage/domains/memory/index.d.ts.map +1 -1
  50. package/dist/storage/domains/observability/index.d.ts +65 -39
  51. package/dist/storage/domains/observability/index.d.ts.map +1 -1
  52. package/dist/storage/domains/prompt-blocks/index.d.ts +43 -0
  53. package/dist/storage/domains/prompt-blocks/index.d.ts.map +1 -0
  54. package/dist/storage/domains/scorer-definitions/index.d.ts +43 -0
  55. package/dist/storage/domains/scorer-definitions/index.d.ts.map +1 -0
  56. package/dist/storage/domains/scores/index.d.ts +40 -33
  57. package/dist/storage/domains/scores/index.d.ts.map +1 -1
  58. package/dist/storage/domains/skills/index.d.ts +33 -0
  59. package/dist/storage/domains/skills/index.d.ts.map +1 -0
  60. package/dist/storage/domains/utils.d.ts +1 -5
  61. package/dist/storage/domains/utils.d.ts.map +1 -1
  62. package/dist/storage/domains/workflows/index.d.ts +42 -30
  63. package/dist/storage/domains/workflows/index.d.ts.map +1 -1
  64. package/dist/storage/domains/workspaces/index.d.ts +33 -0
  65. package/dist/storage/domains/workspaces/index.d.ts.map +1 -0
  66. package/dist/storage/index.d.ts +66 -255
  67. package/dist/storage/index.d.ts.map +1 -1
  68. package/dist/storage/performance-indexes/performance-test.d.ts +3 -1
  69. package/dist/storage/performance-indexes/performance-test.d.ts.map +1 -1
  70. package/dist/storage/test-utils.d.ts.map +1 -1
  71. package/dist/vector/index.d.ts +45 -7
  72. package/dist/vector/index.d.ts.map +1 -1
  73. package/dist/vector/sql-builder.d.ts +4 -0
  74. package/dist/vector/sql-builder.d.ts.map +1 -1
  75. package/dist/vector/types.d.ts +10 -0
  76. package/dist/vector/types.d.ts.map +1 -1
  77. package/package.json +18 -15
  78. package/dist/storage/domains/legacy-evals/index.d.ts +0 -20
  79. package/dist/storage/domains/legacy-evals/index.d.ts.map +0 -1
  80. package/dist/storage/domains/operations/index.d.ts +0 -118
  81. package/dist/storage/domains/operations/index.d.ts.map +0 -1
  82. package/dist/storage/domains/traces/index.d.ts +0 -23
  83. package/dist/storage/domains/traces/index.d.ts.map +0 -1
@@ -1,20 +0,0 @@
1
- import { LegacyEvalsStorage } from '@mastra/core/storage';
2
- import type { PaginationArgs, PaginationInfo, EvalRow } from '@mastra/core/storage';
3
- import type { IDatabase } from 'pg-promise';
4
- export declare class LegacyEvalsPG extends LegacyEvalsStorage {
5
- private client;
6
- private schema;
7
- constructor({ client, schema }: {
8
- client: IDatabase<{}>;
9
- schema: string;
10
- });
11
- /** @deprecated use getEvals instead */
12
- getEvalsByAgentName(agentName: string, type?: 'test' | 'live'): Promise<EvalRow[]>;
13
- getEvals(options?: {
14
- agentName?: string;
15
- type?: 'test' | 'live';
16
- } & PaginationArgs): Promise<PaginationInfo & {
17
- evals: EvalRow[];
18
- }>;
19
- }
20
- //# sourceMappingURL=index.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/storage/domains/legacy-evals/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAe,MAAM,sBAAsB,CAAC;AACvE,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACpF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AA2B5C,qBAAa,aAAc,SAAQ,kBAAkB;IACnD,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,MAAM,CAAS;gBACX,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE;QAAE,MAAM,EAAE,SAAS,CAAC,EAAE,CAAC,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;IAMzE,uCAAuC;IACjC,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAwBlF,QAAQ,CACZ,OAAO,GAAE;QACP,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;KACxB,GAAG,cAAmB,GACtB,OAAO,CAAC,cAAc,GAAG;QAAE,KAAK,EAAE,OAAO,EAAE,CAAA;KAAE,CAAC;CAgFlD"}
@@ -1,118 +0,0 @@
1
- import { StoreOperations } from '@mastra/core/storage';
2
- import type { StorageColumn, TABLE_NAMES, CreateIndexOptions, IndexInfo, StorageIndexStats } from '@mastra/core/storage';
3
- import type { IDatabase } from 'pg-promise';
4
- export type { CreateIndexOptions, IndexInfo, StorageIndexStats };
5
- export declare class StoreOperationsPG extends StoreOperations {
6
- client: IDatabase<{}>;
7
- schemaName?: string;
8
- private setupSchemaPromise;
9
- private schemaSetupComplete;
10
- constructor({ client, schemaName }: {
11
- client: IDatabase<{}>;
12
- schemaName?: string;
13
- });
14
- hasColumn(table: string, column: string): Promise<boolean>;
15
- /**
16
- * Prepares values for insertion, handling JSONB columns by stringifying them
17
- */
18
- private prepareValuesForInsert;
19
- /**
20
- * Adds timestamp Z columns to a record if timestamp columns exist
21
- */
22
- private addTimestampZColumns;
23
- /**
24
- * Prepares a value for database operations, handling Date objects and JSON serialization
25
- */
26
- private prepareValue;
27
- private setupSchema;
28
- insert({ tableName, record }: {
29
- tableName: TABLE_NAMES;
30
- record: Record<string, any>;
31
- }): Promise<void>;
32
- clearTable({ tableName }: {
33
- tableName: TABLE_NAMES;
34
- }): Promise<void>;
35
- protected getDefaultValue(type: StorageColumn['type']): string;
36
- createTable({ tableName, schema, }: {
37
- tableName: TABLE_NAMES;
38
- schema: Record<string, StorageColumn>;
39
- }): Promise<void>;
40
- /**
41
- * Set up timestamp triggers for a table to automatically manage createdAt/updatedAt
42
- */
43
- private setupTimestampTriggers;
44
- /**
45
- * Alters table schema to add columns if they don't exist
46
- * @param tableName Name of the table
47
- * @param schema Schema of the table
48
- * @param ifNotExists Array of column names to add if they don't exist
49
- */
50
- alterTable({ tableName, schema, ifNotExists, }: {
51
- tableName: TABLE_NAMES;
52
- schema: Record<string, StorageColumn>;
53
- ifNotExists: string[];
54
- }): Promise<void>;
55
- load<R>({ tableName, keys }: {
56
- tableName: TABLE_NAMES;
57
- keys: Record<string, string>;
58
- }): Promise<R | null>;
59
- batchInsert({ tableName, records }: {
60
- tableName: TABLE_NAMES;
61
- records: Record<string, any>[];
62
- }): Promise<void>;
63
- dropTable({ tableName }: {
64
- tableName: TABLE_NAMES;
65
- }): Promise<void>;
66
- /**
67
- * Create a new index on a table
68
- */
69
- createIndex(options: CreateIndexOptions): Promise<void>;
70
- /**
71
- * Drop an existing index
72
- */
73
- dropIndex(indexName: string): Promise<void>;
74
- /**
75
- * List indexes for a specific table or all tables
76
- */
77
- listIndexes(tableName?: string): Promise<IndexInfo[]>;
78
- /**
79
- * Returns definitions for automatic performance indexes
80
- * These composite indexes cover both filtering and sorting in single index
81
- */
82
- protected getAutomaticIndexDefinitions(): CreateIndexOptions[];
83
- /**
84
- * Creates automatic indexes for optimal query performance
85
- * Uses getAutomaticIndexDefinitions() to determine which indexes to create
86
- */
87
- createAutomaticIndexes(): Promise<void>;
88
- /**
89
- * Get detailed statistics for a specific index
90
- */
91
- describeIndex(indexName: string): Promise<StorageIndexStats>;
92
- /**
93
- * Update a single record in the database
94
- */
95
- update({ tableName, keys, data, }: {
96
- tableName: TABLE_NAMES;
97
- keys: Record<string, any>;
98
- data: Record<string, any>;
99
- }): Promise<void>;
100
- /**
101
- * Update multiple records in a single batch transaction
102
- */
103
- batchUpdate({ tableName, updates, }: {
104
- tableName: TABLE_NAMES;
105
- updates: Array<{
106
- keys: Record<string, any>;
107
- data: Record<string, any>;
108
- }>;
109
- }): Promise<void>;
110
- /**
111
- * Delete multiple records by keys
112
- */
113
- batchDelete({ tableName, keys }: {
114
- tableName: TABLE_NAMES;
115
- keys: Record<string, any>[];
116
- }): Promise<void>;
117
- }
118
- //# sourceMappingURL=index.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/storage/domains/operations/index.ts"],"names":[],"mappings":"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"}
@@ -1,23 +0,0 @@
1
- import type { PaginationInfo, StorageGetTracesArg, StorageGetTracesPaginatedArg } from '@mastra/core/storage';
2
- import { TracesStorage } from '@mastra/core/storage';
3
- import type { Trace } from '@mastra/core/telemetry';
4
- import type { IDatabase } from 'pg-promise';
5
- import type { StoreOperationsPG } from '../operations/index.js';
6
- export declare class TracesPG extends TracesStorage {
7
- client: IDatabase<{}>;
8
- private operations;
9
- private schema?;
10
- constructor({ client, operations, schema, }: {
11
- client: IDatabase<{}>;
12
- operations: StoreOperationsPG;
13
- schema?: string;
14
- });
15
- getTraces(args: StorageGetTracesArg): Promise<Trace[]>;
16
- getTracesPaginated(args: StorageGetTracesPaginatedArg): Promise<PaginationInfo & {
17
- traces: Trace[];
18
- }>;
19
- batchTraceInsert({ records }: {
20
- records: Record<string, any>[];
21
- }): Promise<void>;
22
- }
23
- //# sourceMappingURL=index.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/storage/domains/traces/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,mBAAmB,EAAE,4BAA4B,EAAE,MAAM,sBAAsB,CAAC;AAC9G,OAAO,EAAgB,aAAa,EAAmB,MAAM,sBAAsB,CAAC;AACpF,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AAEpD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAGvD,qBAAa,QAAS,SAAQ,aAAa;IAClC,MAAM,EAAE,SAAS,CAAC,EAAE,CAAC,CAAC;IAC7B,OAAO,CAAC,UAAU,CAAoB;IACtC,OAAO,CAAC,MAAM,CAAC,CAAS;gBAEZ,EACV,MAAM,EACN,UAAU,EACV,MAAM,GACP,EAAE;QACD,MAAM,EAAE,SAAS,CAAC,EAAE,CAAC,CAAC;QACtB,UAAU,EAAE,iBAAiB,CAAC;QAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB;IAOK,SAAS,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAsBtD,kBAAkB,CAAC,IAAI,EAAE,4BAA4B,GAAG,OAAO,CAAC,cAAc,GAAG;QAAE,MAAM,EAAE,KAAK,EAAE,CAAA;KAAE,CAAC;IAqGrG,gBAAgB,CAAC,EAAE,OAAO,EAAE,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAOvF"}