@agentforge/tools 0.17.2 → 0.18.1

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.d.cts CHANGED
@@ -1,5 +1,5 @@
1
1
  import * as _agentforge_core from '@agentforge/core';
2
- import { LogLevel, JsonValue, JsonObject, HumanRequestPriority } from '@agentforge/core';
2
+ import { LogLevel, JsonValue, JsonObject, Tool, HumanRequestPriority } from '@agentforge/core';
3
3
  import { z } from 'zod';
4
4
  import { AxiosRequestConfig, AxiosResponse } from 'axios';
5
5
  import { SQL } from 'drizzle-orm';
@@ -5089,7 +5089,7 @@ interface QueryExecutionContext {
5089
5089
  * @returns Query execution result with rows, row count, and execution time
5090
5090
  * @throws {Error} If database is not initialized or query execution fails
5091
5091
  */
5092
- declare function executeQuery(manager: ConnectionManager, input: QueryInput, context?: QueryExecutionContext): Promise<QueryExecutionResult>;
5092
+ declare function executeQuery(executor: SqlExecutor, input: QueryInput, context?: QueryExecutionContext): Promise<QueryExecutionResult>;
5093
5093
 
5094
5094
  /**
5095
5095
  * Supported scalar values for INSERT payloads.
@@ -5502,6 +5502,19 @@ interface SchemaInspectOptions {
5502
5502
  interface SchemaInspectorConfig {
5503
5503
  cacheTtlMs?: number;
5504
5504
  cacheKey?: string;
5505
+ cache?: SchemaCache$1;
5506
+ }
5507
+ /** Cache entry retained by a schema-cache owner. */
5508
+ interface SchemaCacheEntry {
5509
+ expiresAt: number;
5510
+ schema: DatabaseSchema;
5511
+ }
5512
+ /** Minimal cache state accepted by schema inspection. */
5513
+ interface SchemaCache$1 {
5514
+ get(cacheKey: string): SchemaCacheEntry | undefined;
5515
+ set(cacheKey: string, entry: SchemaCacheEntry): void;
5516
+ delete(cacheKey: string): void;
5517
+ clear(): void;
5505
5518
  }
5506
5519
 
5507
5520
  /**
@@ -5509,6 +5522,14 @@ interface SchemaInspectorConfig {
5509
5522
  * @module schema/schema-inspector
5510
5523
  */
5511
5524
 
5525
+ /** Cache state whose lifetime can be owned by a Relational Tool Set. */
5526
+ declare class SchemaCache implements SchemaCache$1 {
5527
+ private readonly entries;
5528
+ get(cacheKey: string): SchemaCacheEntry | undefined;
5529
+ set(cacheKey: string, entry: SchemaCacheEntry): void;
5530
+ delete(cacheKey: string): void;
5531
+ clear(): void;
5532
+ }
5512
5533
  /**
5513
5534
  * Inspects database schemas across PostgreSQL, MySQL, and SQLite.
5514
5535
  *
@@ -5517,11 +5538,12 @@ interface SchemaInspectorConfig {
5517
5538
  * cached schemas.
5518
5539
  */
5519
5540
  declare class SchemaInspector {
5520
- private readonly manager;
5541
+ private readonly executor;
5521
5542
  private readonly vendor;
5522
5543
  private readonly cacheTtlMs;
5523
5544
  private readonly cacheKey?;
5524
- constructor(manager: ConnectionManager, vendor: DatabaseVendor, config?: SchemaInspectorConfig);
5545
+ constructor(executor: SqlExecutor, vendor: DatabaseVendor, config?: SchemaInspectorConfig);
5546
+ private readonly cache;
5525
5547
  static clearCache(cacheKey?: string): void;
5526
5548
  invalidateCache(): void;
5527
5549
  inspect(options?: SchemaInspectOptions): Promise<DatabaseSchema>;
@@ -5703,170 +5725,495 @@ declare function exportSchemaToJson(schema: DatabaseSchema): string;
5703
5725
  declare function importSchemaFromJson(json: string): DatabaseSchema;
5704
5726
 
5705
5727
  /**
5706
- * Relational Query Tool - Execute raw SQL queries with parameter binding
5707
- * @module tools/relational-query
5708
- */
5709
- /**
5710
- * Relational Query Tool
5711
- *
5712
- * Executes raw SQL queries against relational databases (PostgreSQL, MySQL, SQLite)
5713
- * with proper parameter binding to prevent SQL injection.
5714
- *
5715
- * Features:
5716
- * - Supports SELECT, INSERT, UPDATE, DELETE, and other SQL statements
5717
- * - Parameter binding prevents SQL injection
5718
- * - Supports positional ($1, ?) and named (:name) parameters
5719
- * - Result formatting to JSON
5720
- * - Error handling with sanitized messages
5721
- *
5722
- * @example
5723
- * ```typescript
5724
- * // SELECT with positional parameters
5725
- * const result = await relationalQuery.invoke({
5726
- * sql: 'SELECT * FROM users WHERE id = $1',
5727
- * params: [42],
5728
- * vendor: 'postgresql',
5729
- * connectionString: 'postgresql://user:pass@localhost:5432/mydb'
5730
- * });
5731
- *
5732
- * // INSERT with named parameters
5733
- * const result = await relationalQuery.invoke({
5734
- * sql: 'INSERT INTO users (name, email) VALUES (:name, :email)',
5735
- * params: { name: 'John Doe', email: 'john@example.com' },
5736
- * vendor: 'postgresql',
5737
- * connectionString: 'postgresql://user:pass@localhost:5432/mydb'
5738
- * });
5739
- * ```
5740
- */
5741
- declare const relationalQuery: _agentforge_core.Tool<{
5742
- connectionString: string;
5743
- vendor: "postgresql" | "mysql" | "sqlite";
5744
- sql: string;
5745
- params?: unknown[] | Record<string, unknown> | undefined;
5746
- }, {
5747
- success: boolean;
5748
- rows: unknown[];
5749
- rowCount: number;
5750
- executionTime: number;
5751
- error?: undefined;
5752
- } | {
5753
- success: boolean;
5754
- error: string;
5755
- rows: never[];
5756
- rowCount: number;
5757
- executionTime?: undefined;
5758
- }>;
5759
-
5760
- /**
5761
- * Type definitions for relational SELECT operations
5762
- * @module tools/relational-select/types
5763
- */
5764
-
5765
- /** Re-export of streaming memory usage type from the query layer. */
5766
- type StreamingMemoryUsage = StreamingMemoryUsage$1;
5767
- /**
5768
- * Optional streaming benchmark metadata.
5769
- */
5770
- type StreamingBenchmarkMetadata = StreamingBenchmarkResult;
5771
- /**
5772
- * Streaming execution metadata.
5773
- */
5774
- interface StreamingMetadata {
5775
- enabled: true;
5776
- chunkSize: number;
5777
- chunkCount: number;
5778
- sampledRowCount: number;
5779
- streamedRowCount: number;
5780
- cancelled: boolean;
5781
- memoryUsage: StreamingMemoryUsage;
5782
- benchmark?: StreamingBenchmarkMetadata;
5783
- }
5784
- /**
5785
- * Tool success response
5786
- */
5787
- interface SelectSuccessResponse {
5788
- success: true;
5789
- rows: unknown[];
5790
- rowCount: number;
5791
- executionTime: number;
5792
- streaming?: StreamingMetadata;
5793
- }
5794
- /**
5795
- * Tool error response
5796
- */
5797
- interface SelectErrorResponse {
5798
- success: false;
5799
- error: string;
5800
- rows: [];
5801
- rowCount: 0;
5802
- }
5803
- /**
5804
- * Tool response (success or error)
5728
+ * Zod schemas for relational DELETE operations
5729
+ * @module tools/relational-delete/schemas
5805
5730
  */
5806
- type SelectResponse = SelectSuccessResponse | SelectErrorResponse;
5807
5731
 
5808
- /**
5809
- * Relational SELECT Tool
5810
- *
5811
- * Execute type-safe SELECT queries using Drizzle ORM query builder.
5812
- *
5813
- * Features:
5814
- * - Type-safe column selection
5815
- * - WHERE conditions with multiple operators
5816
- * - ORDER BY with ascending/descending
5817
- * - LIMIT and OFFSET for pagination
5818
- * - Optional chunked streaming mode for large result sets
5819
- * - Result formatting to JSON
5820
- * - Error handling with clear messages
5821
- *
5822
- * @example
5823
- * ```typescript
5824
- * // SELECT with WHERE and ORDER BY
5825
- * const result = await relationalSelect.invoke({
5826
- * table: 'users',
5827
- * columns: ['id', 'name', 'email'],
5828
- * where: [
5829
- * { column: 'status', operator: 'eq', value: 'active' },
5830
- * { column: 'age', operator: 'gte', value: 18 }
5831
- * ],
5832
- * orderBy: [{ column: 'name', direction: 'asc' }],
5833
- * limit: 10,
5834
- * vendor: 'postgresql',
5835
- * connectionString: 'postgresql://user:pass@localhost:5432/mydb'
5836
- * });
5837
- * ```
5838
- */
5839
- declare const relationalSelect: _agentforge_core.Tool<{
5732
+ /** Complete input schema for the relational-delete tool. */
5733
+ declare const relationalDeleteSchema: z.ZodEffects<z.ZodObject<{
5734
+ table: z.ZodString;
5735
+ where: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodObject<{
5736
+ column: z.ZodString;
5737
+ operator: z.ZodEnum<["eq", "ne", "gt", "lt", "gte", "lte", "like", "in", "notIn", "isNull", "isNotNull"]>;
5738
+ value: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodNumber]>, "many">, z.ZodNull]>>;
5739
+ }, "strip", z.ZodTypeAny, {
5740
+ operator: "eq" | "ne" | "gt" | "lt" | "gte" | "lte" | "like" | "in" | "notIn" | "isNull" | "isNotNull";
5741
+ column: string;
5742
+ value?: string | number | boolean | (string | number)[] | null | undefined;
5743
+ }, {
5744
+ operator: "eq" | "ne" | "gt" | "lt" | "gte" | "lte" | "like" | "in" | "notIn" | "isNull" | "isNotNull";
5745
+ column: string;
5746
+ value?: string | number | boolean | (string | number)[] | null | undefined;
5747
+ }>, {
5748
+ operator: "eq" | "ne" | "gt" | "lt" | "gte" | "lte" | "like" | "in" | "notIn" | "isNull" | "isNotNull";
5749
+ column: string;
5750
+ value?: string | number | boolean | (string | number)[] | null | undefined;
5751
+ }, {
5752
+ operator: "eq" | "ne" | "gt" | "lt" | "gte" | "lte" | "like" | "in" | "notIn" | "isNull" | "isNotNull";
5753
+ column: string;
5754
+ value?: string | number | boolean | (string | number)[] | null | undefined;
5755
+ }>, "many">>;
5756
+ allowFullTableDelete: z.ZodDefault<z.ZodBoolean>;
5757
+ cascade: z.ZodDefault<z.ZodBoolean>;
5758
+ softDelete: z.ZodOptional<z.ZodObject<{
5759
+ column: z.ZodDefault<z.ZodString>;
5760
+ value: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
5761
+ }, "strip", z.ZodTypeAny, {
5762
+ column: string;
5763
+ value?: string | number | undefined;
5764
+ }, {
5765
+ value?: string | number | undefined;
5766
+ column?: string | undefined;
5767
+ }>>;
5768
+ operations: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodObject<{
5769
+ where: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodObject<{
5770
+ column: z.ZodString;
5771
+ operator: z.ZodEnum<["eq", "ne", "gt", "lt", "gte", "lte", "like", "in", "notIn", "isNull", "isNotNull"]>;
5772
+ value: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodNumber]>, "many">, z.ZodNull]>>;
5773
+ }, "strip", z.ZodTypeAny, {
5774
+ operator: "eq" | "ne" | "gt" | "lt" | "gte" | "lte" | "like" | "in" | "notIn" | "isNull" | "isNotNull";
5775
+ column: string;
5776
+ value?: string | number | boolean | (string | number)[] | null | undefined;
5777
+ }, {
5778
+ operator: "eq" | "ne" | "gt" | "lt" | "gte" | "lte" | "like" | "in" | "notIn" | "isNull" | "isNotNull";
5779
+ column: string;
5780
+ value?: string | number | boolean | (string | number)[] | null | undefined;
5781
+ }>, {
5782
+ operator: "eq" | "ne" | "gt" | "lt" | "gte" | "lte" | "like" | "in" | "notIn" | "isNull" | "isNotNull";
5783
+ column: string;
5784
+ value?: string | number | boolean | (string | number)[] | null | undefined;
5785
+ }, {
5786
+ operator: "eq" | "ne" | "gt" | "lt" | "gte" | "lte" | "like" | "in" | "notIn" | "isNull" | "isNotNull";
5787
+ column: string;
5788
+ value?: string | number | boolean | (string | number)[] | null | undefined;
5789
+ }>, "many">>;
5790
+ allowFullTableDelete: z.ZodDefault<z.ZodBoolean>;
5791
+ cascade: z.ZodDefault<z.ZodBoolean>;
5792
+ softDelete: z.ZodOptional<z.ZodObject<{
5793
+ column: z.ZodDefault<z.ZodString>;
5794
+ value: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
5795
+ }, "strip", z.ZodTypeAny, {
5796
+ column: string;
5797
+ value?: string | number | undefined;
5798
+ }, {
5799
+ value?: string | number | undefined;
5800
+ column?: string | undefined;
5801
+ }>>;
5802
+ }, "strip", z.ZodTypeAny, {
5803
+ allowFullTableDelete: boolean;
5804
+ cascade: boolean;
5805
+ where?: {
5806
+ operator: "eq" | "ne" | "gt" | "lt" | "gte" | "lte" | "like" | "in" | "notIn" | "isNull" | "isNotNull";
5807
+ column: string;
5808
+ value?: string | number | boolean | (string | number)[] | null | undefined;
5809
+ }[] | undefined;
5810
+ softDelete?: {
5811
+ column: string;
5812
+ value?: string | number | undefined;
5813
+ } | undefined;
5814
+ }, {
5815
+ where?: {
5816
+ operator: "eq" | "ne" | "gt" | "lt" | "gte" | "lte" | "like" | "in" | "notIn" | "isNull" | "isNotNull";
5817
+ column: string;
5818
+ value?: string | number | boolean | (string | number)[] | null | undefined;
5819
+ }[] | undefined;
5820
+ allowFullTableDelete?: boolean | undefined;
5821
+ cascade?: boolean | undefined;
5822
+ softDelete?: {
5823
+ value?: string | number | undefined;
5824
+ column?: string | undefined;
5825
+ } | undefined;
5826
+ }>, {
5827
+ allowFullTableDelete: boolean;
5828
+ cascade: boolean;
5829
+ where?: {
5830
+ operator: "eq" | "ne" | "gt" | "lt" | "gte" | "lte" | "like" | "in" | "notIn" | "isNull" | "isNotNull";
5831
+ column: string;
5832
+ value?: string | number | boolean | (string | number)[] | null | undefined;
5833
+ }[] | undefined;
5834
+ softDelete?: {
5835
+ column: string;
5836
+ value?: string | number | undefined;
5837
+ } | undefined;
5838
+ }, {
5839
+ where?: {
5840
+ operator: "eq" | "ne" | "gt" | "lt" | "gte" | "lte" | "like" | "in" | "notIn" | "isNull" | "isNotNull";
5841
+ column: string;
5842
+ value?: string | number | boolean | (string | number)[] | null | undefined;
5843
+ }[] | undefined;
5844
+ allowFullTableDelete?: boolean | undefined;
5845
+ cascade?: boolean | undefined;
5846
+ softDelete?: {
5847
+ value?: string | number | undefined;
5848
+ column?: string | undefined;
5849
+ } | undefined;
5850
+ }>, "many">>;
5851
+ batch: z.ZodOptional<z.ZodObject<{
5852
+ enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
5853
+ batchSize: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
5854
+ continueOnError: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
5855
+ maxRetries: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
5856
+ retryDelayMs: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
5857
+ benchmark: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
5858
+ }, "strip", z.ZodTypeAny, {
5859
+ enabled: boolean;
5860
+ batchSize: number;
5861
+ maxRetries: number;
5862
+ retryDelayMs: number;
5863
+ continueOnError: boolean;
5864
+ benchmark: boolean;
5865
+ }, {
5866
+ enabled?: boolean | undefined;
5867
+ batchSize?: number | undefined;
5868
+ maxRetries?: number | undefined;
5869
+ retryDelayMs?: number | undefined;
5870
+ continueOnError?: boolean | undefined;
5871
+ benchmark?: boolean | undefined;
5872
+ }>>;
5873
+ vendor: z.ZodEnum<["postgresql", "mysql", "sqlite"]>;
5874
+ connectionString: z.ZodString;
5875
+ }, "strip", z.ZodTypeAny, {
5840
5876
  table: string;
5841
5877
  connectionString: string;
5842
5878
  vendor: "postgresql" | "mysql" | "sqlite";
5843
- limit?: number | undefined;
5844
- columns?: string[] | undefined;
5879
+ allowFullTableDelete: boolean;
5880
+ cascade: boolean;
5845
5881
  where?: {
5846
5882
  operator: "eq" | "ne" | "gt" | "lt" | "gte" | "lte" | "like" | "in" | "notIn" | "isNull" | "isNotNull";
5847
5883
  column: string;
5848
5884
  value?: string | number | boolean | (string | number)[] | null | undefined;
5849
5885
  }[] | undefined;
5850
- orderBy?: {
5851
- direction: "asc" | "desc";
5886
+ softDelete?: {
5852
5887
  column: string;
5888
+ value?: string | number | undefined;
5889
+ } | undefined;
5890
+ operations?: {
5891
+ allowFullTableDelete: boolean;
5892
+ cascade: boolean;
5893
+ where?: {
5894
+ operator: "eq" | "ne" | "gt" | "lt" | "gte" | "lte" | "like" | "in" | "notIn" | "isNull" | "isNotNull";
5895
+ column: string;
5896
+ value?: string | number | boolean | (string | number)[] | null | undefined;
5897
+ }[] | undefined;
5898
+ softDelete?: {
5899
+ column: string;
5900
+ value?: string | number | undefined;
5901
+ } | undefined;
5853
5902
  }[] | undefined;
5854
- offset?: number | undefined;
5855
- streaming?: {
5856
- enabled?: boolean | undefined;
5857
- chunkSize?: number | undefined;
5858
- sampleSize?: number | undefined;
5859
- maxRows?: number | undefined;
5860
- benchmark?: boolean | undefined;
5903
+ batch?: {
5904
+ enabled: boolean;
5905
+ batchSize: number;
5906
+ maxRetries: number;
5907
+ retryDelayMs: number;
5908
+ continueOnError: boolean;
5909
+ benchmark: boolean;
5861
5910
  } | undefined;
5862
- }, SelectResponse>;
5863
-
5864
- /**
5865
- * Type definitions for relational INSERT operations
5866
- * @module tools/relational-insert/types
5867
- */
5868
-
5869
- /**
5911
+ }, {
5912
+ table: string;
5913
+ connectionString: string;
5914
+ vendor: "postgresql" | "mysql" | "sqlite";
5915
+ where?: {
5916
+ operator: "eq" | "ne" | "gt" | "lt" | "gte" | "lte" | "like" | "in" | "notIn" | "isNull" | "isNotNull";
5917
+ column: string;
5918
+ value?: string | number | boolean | (string | number)[] | null | undefined;
5919
+ }[] | undefined;
5920
+ allowFullTableDelete?: boolean | undefined;
5921
+ cascade?: boolean | undefined;
5922
+ softDelete?: {
5923
+ value?: string | number | undefined;
5924
+ column?: string | undefined;
5925
+ } | undefined;
5926
+ operations?: {
5927
+ where?: {
5928
+ operator: "eq" | "ne" | "gt" | "lt" | "gte" | "lte" | "like" | "in" | "notIn" | "isNull" | "isNotNull";
5929
+ column: string;
5930
+ value?: string | number | boolean | (string | number)[] | null | undefined;
5931
+ }[] | undefined;
5932
+ allowFullTableDelete?: boolean | undefined;
5933
+ cascade?: boolean | undefined;
5934
+ softDelete?: {
5935
+ value?: string | number | undefined;
5936
+ column?: string | undefined;
5937
+ } | undefined;
5938
+ }[] | undefined;
5939
+ batch?: {
5940
+ enabled?: boolean | undefined;
5941
+ batchSize?: number | undefined;
5942
+ maxRetries?: number | undefined;
5943
+ retryDelayMs?: number | undefined;
5944
+ continueOnError?: boolean | undefined;
5945
+ benchmark?: boolean | undefined;
5946
+ } | undefined;
5947
+ }>, {
5948
+ table: string;
5949
+ connectionString: string;
5950
+ vendor: "postgresql" | "mysql" | "sqlite";
5951
+ allowFullTableDelete: boolean;
5952
+ cascade: boolean;
5953
+ where?: {
5954
+ operator: "eq" | "ne" | "gt" | "lt" | "gte" | "lte" | "like" | "in" | "notIn" | "isNull" | "isNotNull";
5955
+ column: string;
5956
+ value?: string | number | boolean | (string | number)[] | null | undefined;
5957
+ }[] | undefined;
5958
+ softDelete?: {
5959
+ column: string;
5960
+ value?: string | number | undefined;
5961
+ } | undefined;
5962
+ operations?: {
5963
+ allowFullTableDelete: boolean;
5964
+ cascade: boolean;
5965
+ where?: {
5966
+ operator: "eq" | "ne" | "gt" | "lt" | "gte" | "lte" | "like" | "in" | "notIn" | "isNull" | "isNotNull";
5967
+ column: string;
5968
+ value?: string | number | boolean | (string | number)[] | null | undefined;
5969
+ }[] | undefined;
5970
+ softDelete?: {
5971
+ column: string;
5972
+ value?: string | number | undefined;
5973
+ } | undefined;
5974
+ }[] | undefined;
5975
+ batch?: {
5976
+ enabled: boolean;
5977
+ batchSize: number;
5978
+ maxRetries: number;
5979
+ retryDelayMs: number;
5980
+ continueOnError: boolean;
5981
+ benchmark: boolean;
5982
+ } | undefined;
5983
+ }, {
5984
+ table: string;
5985
+ connectionString: string;
5986
+ vendor: "postgresql" | "mysql" | "sqlite";
5987
+ where?: {
5988
+ operator: "eq" | "ne" | "gt" | "lt" | "gte" | "lte" | "like" | "in" | "notIn" | "isNull" | "isNotNull";
5989
+ column: string;
5990
+ value?: string | number | boolean | (string | number)[] | null | undefined;
5991
+ }[] | undefined;
5992
+ allowFullTableDelete?: boolean | undefined;
5993
+ cascade?: boolean | undefined;
5994
+ softDelete?: {
5995
+ value?: string | number | undefined;
5996
+ column?: string | undefined;
5997
+ } | undefined;
5998
+ operations?: {
5999
+ where?: {
6000
+ operator: "eq" | "ne" | "gt" | "lt" | "gte" | "lte" | "like" | "in" | "notIn" | "isNull" | "isNotNull";
6001
+ column: string;
6002
+ value?: string | number | boolean | (string | number)[] | null | undefined;
6003
+ }[] | undefined;
6004
+ allowFullTableDelete?: boolean | undefined;
6005
+ cascade?: boolean | undefined;
6006
+ softDelete?: {
6007
+ value?: string | number | undefined;
6008
+ column?: string | undefined;
6009
+ } | undefined;
6010
+ }[] | undefined;
6011
+ batch?: {
6012
+ enabled?: boolean | undefined;
6013
+ batchSize?: number | undefined;
6014
+ maxRetries?: number | undefined;
6015
+ retryDelayMs?: number | undefined;
6016
+ continueOnError?: boolean | undefined;
6017
+ benchmark?: boolean | undefined;
6018
+ } | undefined;
6019
+ }>;
6020
+
6021
+ /**
6022
+ * Type definitions for relational DELETE operations
6023
+ * @module tools/relational-delete/types
6024
+ */
6025
+
6026
+ /** Metadata returned after a batched DELETE operation completes. */
6027
+ interface DeleteBatchMetadata {
6028
+ enabled: boolean;
6029
+ batchSize: number;
6030
+ totalItems: number;
6031
+ processedItems: number;
6032
+ successfulItems: number;
6033
+ failedItems: number;
6034
+ totalBatches: number;
6035
+ retries: number;
6036
+ partialSuccess: boolean;
6037
+ failures: BatchFailureDetail[];
6038
+ benchmark?: BatchBenchmarkResult;
6039
+ }
6040
+ /** Validated input for the relational-delete tool. */
6041
+ type RelationalDeleteInput = z.input<typeof relationalDeleteSchema>;
6042
+ /** DELETE input after database credentials have been bound by a session owner. */
6043
+ type RelationalDeleteExecutionInput = Omit<RelationalDeleteInput, 'connectionString'>;
6044
+ /** Agent-facing DELETE operation input for a configured database session. */
6045
+ type RelationalDeleteOperationInput = Omit<RelationalDeleteExecutionInput, 'vendor'>;
6046
+ /** Successful DELETE response returned to the caller. */
6047
+ interface DeleteSuccessResponse {
6048
+ success: true;
6049
+ rowCount: number;
6050
+ executionTime: number;
6051
+ softDeleted: boolean;
6052
+ batch?: DeleteBatchMetadata;
6053
+ }
6054
+ /** Error DELETE response returned when the operation fails. */
6055
+ interface DeleteErrorResponse {
6056
+ success: false;
6057
+ error: string;
6058
+ rowCount: 0;
6059
+ softDeleted: false;
6060
+ }
6061
+ /** Union type representing either a successful or failed DELETE response. */
6062
+ type DeleteResponse = DeleteSuccessResponse | DeleteErrorResponse;
6063
+
6064
+ /**
6065
+ * Zod schema for relational-get-schema input.
6066
+ */
6067
+ declare const relationalGetSchemaInputSchema: z.ZodObject<{
6068
+ vendor: z.ZodEnum<["postgresql", "mysql", "sqlite"]>;
6069
+ connectionString: z.ZodString;
6070
+ database: z.ZodOptional<z.ZodString>;
6071
+ tables: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
6072
+ cacheTtlMs: z.ZodOptional<z.ZodNumber>;
6073
+ refreshCache: z.ZodOptional<z.ZodBoolean>;
6074
+ }, "strip", z.ZodTypeAny, {
6075
+ connectionString: string;
6076
+ vendor: "postgresql" | "mysql" | "sqlite";
6077
+ database?: string | undefined;
6078
+ tables?: string[] | undefined;
6079
+ cacheTtlMs?: number | undefined;
6080
+ refreshCache?: boolean | undefined;
6081
+ }, {
6082
+ connectionString: string;
6083
+ vendor: "postgresql" | "mysql" | "sqlite";
6084
+ database?: string | undefined;
6085
+ tables?: string[] | undefined;
6086
+ cacheTtlMs?: number | undefined;
6087
+ refreshCache?: boolean | undefined;
6088
+ }>;
6089
+ type RelationalGetSchemaInput = z.input<typeof relationalGetSchemaInputSchema>;
6090
+ type RelationalGetSchemaOperationInput = Omit<RelationalGetSchemaInput, 'vendor' | 'connectionString'>;
6091
+ interface SchemaSummary {
6092
+ tableCount: number;
6093
+ columnCount: number;
6094
+ foreignKeyCount: number;
6095
+ indexCount: number;
6096
+ }
6097
+ type GetSchemaResponse = {
6098
+ success: true;
6099
+ schema: DatabaseSchema;
6100
+ summary: SchemaSummary;
6101
+ } | {
6102
+ success: false;
6103
+ error: string;
6104
+ schema: null;
6105
+ };
6106
+ /**
6107
+ * Relational Get Schema Tool
6108
+ *
6109
+ * Introspects database schema metadata including tables, columns, primary keys,
6110
+ * foreign keys, and indexes for PostgreSQL, MySQL, and SQLite.
6111
+ *
6112
+ * @deprecated Configure a session-owning Relational Tool Set with
6113
+ * `createRelationalToolSet(...)` and use its `getSchema` Tool instead.
6114
+ */
6115
+ declare const relationalGetSchema: _agentforge_core.Tool<{
6116
+ connectionString: string;
6117
+ vendor: "postgresql" | "mysql" | "sqlite";
6118
+ database?: string | undefined;
6119
+ tables?: string[] | undefined;
6120
+ cacheTtlMs?: number | undefined;
6121
+ refreshCache?: boolean | undefined;
6122
+ }, GetSchemaResponse>;
6123
+
6124
+ /**
6125
+ * Zod schemas for relational INSERT operations
6126
+ * @module tools/relational-insert/schemas
6127
+ */
6128
+
6129
+ /**
6130
+ * Relational INSERT tool input schema.
6131
+ */
6132
+ declare const relationalInsertSchema: z.ZodObject<{
6133
+ table: z.ZodString;
6134
+ data: z.ZodUnion<[z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>, z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>, "many">]>;
6135
+ batch: z.ZodOptional<z.ZodObject<{
6136
+ enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
6137
+ batchSize: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
6138
+ continueOnError: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
6139
+ maxRetries: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
6140
+ retryDelayMs: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
6141
+ benchmark: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
6142
+ }, "strip", z.ZodTypeAny, {
6143
+ enabled: boolean;
6144
+ batchSize: number;
6145
+ maxRetries: number;
6146
+ retryDelayMs: number;
6147
+ continueOnError: boolean;
6148
+ benchmark: boolean;
6149
+ }, {
6150
+ enabled?: boolean | undefined;
6151
+ batchSize?: number | undefined;
6152
+ maxRetries?: number | undefined;
6153
+ retryDelayMs?: number | undefined;
6154
+ continueOnError?: boolean | undefined;
6155
+ benchmark?: boolean | undefined;
6156
+ }>>;
6157
+ returning: z.ZodOptional<z.ZodEffects<z.ZodObject<{
6158
+ mode: z.ZodDefault<z.ZodEnum<["none", "id", "row"]>>;
6159
+ idColumn: z.ZodOptional<z.ZodString>;
6160
+ }, "strip", z.ZodTypeAny, {
6161
+ mode: "row" | "none" | "id";
6162
+ idColumn?: string | undefined;
6163
+ }, {
6164
+ mode?: "row" | "none" | "id" | undefined;
6165
+ idColumn?: string | undefined;
6166
+ }>, {
6167
+ mode: "row" | "none" | "id";
6168
+ idColumn?: string | undefined;
6169
+ }, {
6170
+ mode?: "row" | "none" | "id" | undefined;
6171
+ idColumn?: string | undefined;
6172
+ }>>;
6173
+ vendor: z.ZodEnum<["postgresql", "mysql", "sqlite"]>;
6174
+ connectionString: z.ZodString;
6175
+ }, "strip", z.ZodTypeAny, {
6176
+ data: Record<string, string | number | boolean | null> | Record<string, string | number | boolean | null>[];
6177
+ table: string;
6178
+ connectionString: string;
6179
+ vendor: "postgresql" | "mysql" | "sqlite";
6180
+ batch?: {
6181
+ enabled: boolean;
6182
+ batchSize: number;
6183
+ maxRetries: number;
6184
+ retryDelayMs: number;
6185
+ continueOnError: boolean;
6186
+ benchmark: boolean;
6187
+ } | undefined;
6188
+ returning?: {
6189
+ mode: "row" | "none" | "id";
6190
+ idColumn?: string | undefined;
6191
+ } | undefined;
6192
+ }, {
6193
+ data: Record<string, string | number | boolean | null> | Record<string, string | number | boolean | null>[];
6194
+ table: string;
6195
+ connectionString: string;
6196
+ vendor: "postgresql" | "mysql" | "sqlite";
6197
+ batch?: {
6198
+ enabled?: boolean | undefined;
6199
+ batchSize?: number | undefined;
6200
+ maxRetries?: number | undefined;
6201
+ retryDelayMs?: number | undefined;
6202
+ continueOnError?: boolean | undefined;
6203
+ benchmark?: boolean | undefined;
6204
+ } | undefined;
6205
+ returning?: {
6206
+ mode?: "row" | "none" | "id" | undefined;
6207
+ idColumn?: string | undefined;
6208
+ } | undefined;
6209
+ }>;
6210
+
6211
+ /**
6212
+ * Type definitions for relational INSERT operations
6213
+ * @module tools/relational-insert/types
6214
+ */
6215
+
6216
+ /**
5870
6217
  * Batch metadata returned by INSERT execution when batch mode is active.
5871
6218
  */
5872
6219
  interface InsertBatchMetadata {
@@ -5882,6 +6229,14 @@ interface InsertBatchMetadata {
5882
6229
  failures: BatchFailureDetail[];
5883
6230
  benchmark?: BatchBenchmarkResult;
5884
6231
  }
6232
+ /**
6233
+ * Relational INSERT tool input.
6234
+ */
6235
+ type RelationalInsertInput = z.input<typeof relationalInsertSchema>;
6236
+ /** INSERT input after database credentials have been bound by a session owner. */
6237
+ type RelationalInsertExecutionInput = Omit<RelationalInsertInput, 'connectionString'>;
6238
+ /** Agent-facing INSERT operation input for a configured database session. */
6239
+ type RelationalInsertOperationInput = Omit<RelationalInsertExecutionInput, 'vendor'>;
5885
6240
  /**
5886
6241
  * Tool success response.
5887
6242
  */
@@ -5909,15 +6264,529 @@ interface InsertErrorResponse {
5909
6264
  type InsertResponse = InsertSuccessResponse | InsertErrorResponse;
5910
6265
 
5911
6266
  /**
5912
- * Relational INSERT Tool
5913
- *
5914
- * Execute type-safe INSERT queries using Drizzle ORM query builder.
6267
+ * Zod schema for relational-query tool input
5915
6268
  */
5916
- declare const relationalInsert: _agentforge_core.Tool<{
5917
- data: Record<string, string | number | boolean | null> | Record<string, string | number | boolean | null>[];
6269
+ declare const relationalQuerySchema: z.ZodObject<{
6270
+ sql: z.ZodString;
6271
+ params: z.ZodOptional<z.ZodUnion<[z.ZodArray<z.ZodUnknown, "many">, z.ZodRecord<z.ZodString, z.ZodUnknown>]>>;
6272
+ vendor: z.ZodEnum<["postgresql", "mysql", "sqlite"]>;
6273
+ connectionString: z.ZodString;
6274
+ }, "strip", z.ZodTypeAny, {
6275
+ connectionString: string;
6276
+ vendor: "postgresql" | "mysql" | "sqlite";
6277
+ sql: string;
6278
+ params?: unknown[] | Record<string, unknown> | undefined;
6279
+ }, {
6280
+ connectionString: string;
6281
+ vendor: "postgresql" | "mysql" | "sqlite";
6282
+ sql: string;
6283
+ params?: unknown[] | Record<string, unknown> | undefined;
6284
+ }>;
6285
+ type RelationalQueryInput = z.input<typeof relationalQuerySchema>;
6286
+ type RelationalQueryOperationInput = Omit<RelationalQueryInput, 'vendor' | 'connectionString'>;
6287
+ type QueryResponse = {
6288
+ success: true;
6289
+ rows: unknown[];
6290
+ rowCount: number;
6291
+ executionTime: number;
6292
+ } | {
6293
+ success: false;
6294
+ error: string;
6295
+ rows: [];
6296
+ rowCount: 0;
6297
+ };
6298
+ /**
6299
+ * Relational Query Tool
6300
+ *
6301
+ * Executes raw SQL queries against relational databases (PostgreSQL, MySQL, SQLite)
6302
+ * with proper parameter binding to prevent SQL injection.
6303
+ *
6304
+ * Features:
6305
+ * - Supports SELECT, INSERT, UPDATE, DELETE, and other SQL statements
6306
+ * - Parameter binding prevents SQL injection
6307
+ * - Supports positional ($1, ?) and named (:name) parameters
6308
+ * - Result formatting to JSON
6309
+ * - Error handling with sanitized messages
6310
+ *
6311
+ * @deprecated Configure a session-owning Relational Tool Set with
6312
+ * `createRelationalToolSet(...)` and use its `query` Tool instead.
6313
+ *
6314
+ * @example
6315
+ * ```typescript
6316
+ * // SELECT with positional parameters
6317
+ * const result = await relationalQuery.invoke({
6318
+ * sql: 'SELECT * FROM users WHERE id = $1',
6319
+ * params: [42],
6320
+ * vendor: 'postgresql',
6321
+ * connectionString: 'postgresql://user:pass@localhost:5432/mydb'
6322
+ * });
6323
+ *
6324
+ * // INSERT with named parameters
6325
+ * const result = await relationalQuery.invoke({
6326
+ * sql: 'INSERT INTO users (name, email) VALUES (:name, :email)',
6327
+ * params: { name: 'John Doe', email: 'john@example.com' },
6328
+ * vendor: 'postgresql',
6329
+ * connectionString: 'postgresql://user:pass@localhost:5432/mydb'
6330
+ * });
6331
+ * ```
6332
+ */
6333
+ declare const relationalQuery: _agentforge_core.Tool<{
6334
+ connectionString: string;
6335
+ vendor: "postgresql" | "mysql" | "sqlite";
6336
+ sql: string;
6337
+ params?: unknown[] | Record<string, unknown> | undefined;
6338
+ }, QueryResponse>;
6339
+
6340
+ /**
6341
+ * Zod schemas for relational SELECT operations
6342
+ * @module tools/relational-select/schemas
6343
+ */
6344
+
6345
+ /**
6346
+ * Relational SELECT tool input schema
6347
+ */
6348
+ declare const relationalSelectSchema: z.ZodObject<{
6349
+ table: z.ZodString;
6350
+ columns: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
6351
+ where: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodObject<{
6352
+ column: z.ZodString;
6353
+ operator: z.ZodEnum<["eq", "ne", "gt", "lt", "gte", "lte", "like", "in", "notIn", "isNull", "isNotNull"]>;
6354
+ value: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodNumber]>, "many">, z.ZodNull]>>;
6355
+ }, "strip", z.ZodTypeAny, {
6356
+ operator: "eq" | "ne" | "gt" | "lt" | "gte" | "lte" | "like" | "in" | "notIn" | "isNull" | "isNotNull";
6357
+ column: string;
6358
+ value?: string | number | boolean | (string | number)[] | null | undefined;
6359
+ }, {
6360
+ operator: "eq" | "ne" | "gt" | "lt" | "gte" | "lte" | "like" | "in" | "notIn" | "isNull" | "isNotNull";
6361
+ column: string;
6362
+ value?: string | number | boolean | (string | number)[] | null | undefined;
6363
+ }>, {
6364
+ operator: "eq" | "ne" | "gt" | "lt" | "gte" | "lte" | "like" | "in" | "notIn" | "isNull" | "isNotNull";
6365
+ column: string;
6366
+ value?: string | number | boolean | (string | number)[] | null | undefined;
6367
+ }, {
6368
+ operator: "eq" | "ne" | "gt" | "lt" | "gte" | "lte" | "like" | "in" | "notIn" | "isNull" | "isNotNull";
6369
+ column: string;
6370
+ value?: string | number | boolean | (string | number)[] | null | undefined;
6371
+ }>, "many">>;
6372
+ orderBy: z.ZodOptional<z.ZodArray<z.ZodObject<{
6373
+ column: z.ZodString;
6374
+ direction: z.ZodEnum<["asc", "desc"]>;
6375
+ }, "strip", z.ZodTypeAny, {
6376
+ direction: "asc" | "desc";
6377
+ column: string;
6378
+ }, {
6379
+ direction: "asc" | "desc";
6380
+ column: string;
6381
+ }>, "many">>;
6382
+ limit: z.ZodOptional<z.ZodNumber>;
6383
+ offset: z.ZodOptional<z.ZodNumber>;
6384
+ streaming: z.ZodOptional<z.ZodObject<{
6385
+ enabled: z.ZodDefault<z.ZodBoolean>;
6386
+ chunkSize: z.ZodOptional<z.ZodNumber>;
6387
+ maxRows: z.ZodOptional<z.ZodNumber>;
6388
+ sampleSize: z.ZodOptional<z.ZodNumber>;
6389
+ benchmark: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
6390
+ }, "strip", z.ZodTypeAny, {
6391
+ enabled: boolean;
6392
+ benchmark: boolean;
6393
+ chunkSize?: number | undefined;
6394
+ sampleSize?: number | undefined;
6395
+ maxRows?: number | undefined;
6396
+ }, {
6397
+ enabled?: boolean | undefined;
6398
+ chunkSize?: number | undefined;
6399
+ sampleSize?: number | undefined;
6400
+ maxRows?: number | undefined;
6401
+ benchmark?: boolean | undefined;
6402
+ }>>;
6403
+ vendor: z.ZodEnum<["postgresql", "mysql", "sqlite"]>;
6404
+ connectionString: z.ZodString;
6405
+ }, "strip", z.ZodTypeAny, {
6406
+ table: string;
6407
+ connectionString: string;
6408
+ vendor: "postgresql" | "mysql" | "sqlite";
6409
+ limit?: number | undefined;
6410
+ columns?: string[] | undefined;
6411
+ where?: {
6412
+ operator: "eq" | "ne" | "gt" | "lt" | "gte" | "lte" | "like" | "in" | "notIn" | "isNull" | "isNotNull";
6413
+ column: string;
6414
+ value?: string | number | boolean | (string | number)[] | null | undefined;
6415
+ }[] | undefined;
6416
+ orderBy?: {
6417
+ direction: "asc" | "desc";
6418
+ column: string;
6419
+ }[] | undefined;
6420
+ offset?: number | undefined;
6421
+ streaming?: {
6422
+ enabled: boolean;
6423
+ benchmark: boolean;
6424
+ chunkSize?: number | undefined;
6425
+ sampleSize?: number | undefined;
6426
+ maxRows?: number | undefined;
6427
+ } | undefined;
6428
+ }, {
6429
+ table: string;
6430
+ connectionString: string;
6431
+ vendor: "postgresql" | "mysql" | "sqlite";
6432
+ limit?: number | undefined;
6433
+ columns?: string[] | undefined;
6434
+ where?: {
6435
+ operator: "eq" | "ne" | "gt" | "lt" | "gte" | "lte" | "like" | "in" | "notIn" | "isNull" | "isNotNull";
6436
+ column: string;
6437
+ value?: string | number | boolean | (string | number)[] | null | undefined;
6438
+ }[] | undefined;
6439
+ orderBy?: {
6440
+ direction: "asc" | "desc";
6441
+ column: string;
6442
+ }[] | undefined;
6443
+ offset?: number | undefined;
6444
+ streaming?: {
6445
+ enabled?: boolean | undefined;
6446
+ chunkSize?: number | undefined;
6447
+ sampleSize?: number | undefined;
6448
+ maxRows?: number | undefined;
6449
+ benchmark?: boolean | undefined;
6450
+ } | undefined;
6451
+ }>;
6452
+
6453
+ /**
6454
+ * Type definitions for relational SELECT operations
6455
+ * @module tools/relational-select/types
6456
+ */
6457
+
6458
+ /** Re-export of streaming memory usage type from the query layer. */
6459
+ type StreamingMemoryUsage = StreamingMemoryUsage$1;
6460
+ /**
6461
+ * Optional streaming benchmark metadata.
6462
+ */
6463
+ type StreamingBenchmarkMetadata = StreamingBenchmarkResult;
6464
+ /**
6465
+ * Streaming execution metadata.
6466
+ */
6467
+ interface StreamingMetadata {
6468
+ enabled: true;
6469
+ chunkSize: number;
6470
+ chunkCount: number;
6471
+ sampledRowCount: number;
6472
+ streamedRowCount: number;
6473
+ cancelled: boolean;
6474
+ memoryUsage: StreamingMemoryUsage;
6475
+ benchmark?: StreamingBenchmarkMetadata;
6476
+ }
6477
+ /**
6478
+ * Relational SELECT tool input
6479
+ */
6480
+ type RelationalSelectInput = z.input<typeof relationalSelectSchema>;
6481
+ /** SELECT input after database credentials have been bound by a session owner. */
6482
+ type RelationalSelectExecutionInput = Omit<RelationalSelectInput, 'connectionString'>;
6483
+ /** Agent-facing SELECT operation input for a configured database session. */
6484
+ type RelationalSelectOperationInput = Omit<RelationalSelectExecutionInput, 'vendor'>;
6485
+ /**
6486
+ * Tool success response
6487
+ */
6488
+ interface SelectSuccessResponse {
6489
+ success: true;
6490
+ rows: unknown[];
6491
+ rowCount: number;
6492
+ executionTime: number;
6493
+ streaming?: StreamingMetadata;
6494
+ }
6495
+ /**
6496
+ * Tool error response
6497
+ */
6498
+ interface SelectErrorResponse {
6499
+ success: false;
6500
+ error: string;
6501
+ rows: [];
6502
+ rowCount: 0;
6503
+ }
6504
+ /**
6505
+ * Tool response (success or error)
6506
+ */
6507
+ type SelectResponse = SelectSuccessResponse | SelectErrorResponse;
6508
+
6509
+ /**
6510
+ * Zod schemas for relational UPDATE operations
6511
+ * @module tools/relational-update/schemas
6512
+ */
6513
+
6514
+ /**
6515
+ * Relational UPDATE tool input schema.
6516
+ */
6517
+ declare const relationalUpdateSchema: z.ZodEffects<z.ZodObject<{
6518
+ table: z.ZodString;
6519
+ data: z.ZodOptional<z.ZodEffects<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>, Record<string, string | number | boolean | null>, Record<string, string | number | boolean | null>>>;
6520
+ where: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodObject<{
6521
+ column: z.ZodString;
6522
+ operator: z.ZodEnum<["eq", "ne", "gt", "lt", "gte", "lte", "like", "in", "notIn", "isNull", "isNotNull"]>;
6523
+ value: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodNumber]>, "many">, z.ZodNull]>>;
6524
+ }, "strip", z.ZodTypeAny, {
6525
+ operator: "eq" | "ne" | "gt" | "lt" | "gte" | "lte" | "like" | "in" | "notIn" | "isNull" | "isNotNull";
6526
+ column: string;
6527
+ value?: string | number | boolean | (string | number)[] | null | undefined;
6528
+ }, {
6529
+ operator: "eq" | "ne" | "gt" | "lt" | "gte" | "lte" | "like" | "in" | "notIn" | "isNull" | "isNotNull";
6530
+ column: string;
6531
+ value?: string | number | boolean | (string | number)[] | null | undefined;
6532
+ }>, {
6533
+ operator: "eq" | "ne" | "gt" | "lt" | "gte" | "lte" | "like" | "in" | "notIn" | "isNull" | "isNotNull";
6534
+ column: string;
6535
+ value?: string | number | boolean | (string | number)[] | null | undefined;
6536
+ }, {
6537
+ operator: "eq" | "ne" | "gt" | "lt" | "gte" | "lte" | "like" | "in" | "notIn" | "isNull" | "isNotNull";
6538
+ column: string;
6539
+ value?: string | number | boolean | (string | number)[] | null | undefined;
6540
+ }>, "many">>;
6541
+ allowFullTableUpdate: z.ZodDefault<z.ZodBoolean>;
6542
+ optimisticLock: z.ZodOptional<z.ZodObject<{
6543
+ column: z.ZodString;
6544
+ expectedValue: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
6545
+ }, "strip", z.ZodTypeAny, {
6546
+ column: string;
6547
+ expectedValue: string | number;
6548
+ }, {
6549
+ column: string;
6550
+ expectedValue: string | number;
6551
+ }>>;
6552
+ operations: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodObject<{
6553
+ data: z.ZodEffects<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>, Record<string, string | number | boolean | null>, Record<string, string | number | boolean | null>>;
6554
+ where: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodObject<{
6555
+ column: z.ZodString;
6556
+ operator: z.ZodEnum<["eq", "ne", "gt", "lt", "gte", "lte", "like", "in", "notIn", "isNull", "isNotNull"]>;
6557
+ value: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodNumber]>, "many">, z.ZodNull]>>;
6558
+ }, "strip", z.ZodTypeAny, {
6559
+ operator: "eq" | "ne" | "gt" | "lt" | "gte" | "lte" | "like" | "in" | "notIn" | "isNull" | "isNotNull";
6560
+ column: string;
6561
+ value?: string | number | boolean | (string | number)[] | null | undefined;
6562
+ }, {
6563
+ operator: "eq" | "ne" | "gt" | "lt" | "gte" | "lte" | "like" | "in" | "notIn" | "isNull" | "isNotNull";
6564
+ column: string;
6565
+ value?: string | number | boolean | (string | number)[] | null | undefined;
6566
+ }>, {
6567
+ operator: "eq" | "ne" | "gt" | "lt" | "gte" | "lte" | "like" | "in" | "notIn" | "isNull" | "isNotNull";
6568
+ column: string;
6569
+ value?: string | number | boolean | (string | number)[] | null | undefined;
6570
+ }, {
6571
+ operator: "eq" | "ne" | "gt" | "lt" | "gte" | "lte" | "like" | "in" | "notIn" | "isNull" | "isNotNull";
6572
+ column: string;
6573
+ value?: string | number | boolean | (string | number)[] | null | undefined;
6574
+ }>, "many">>;
6575
+ allowFullTableUpdate: z.ZodDefault<z.ZodBoolean>;
6576
+ optimisticLock: z.ZodOptional<z.ZodObject<{
6577
+ column: z.ZodString;
6578
+ expectedValue: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
6579
+ }, "strip", z.ZodTypeAny, {
6580
+ column: string;
6581
+ expectedValue: string | number;
6582
+ }, {
6583
+ column: string;
6584
+ expectedValue: string | number;
6585
+ }>>;
6586
+ }, "strip", z.ZodTypeAny, {
6587
+ data: Record<string, string | number | boolean | null>;
6588
+ allowFullTableUpdate: boolean;
6589
+ where?: {
6590
+ operator: "eq" | "ne" | "gt" | "lt" | "gte" | "lte" | "like" | "in" | "notIn" | "isNull" | "isNotNull";
6591
+ column: string;
6592
+ value?: string | number | boolean | (string | number)[] | null | undefined;
6593
+ }[] | undefined;
6594
+ optimisticLock?: {
6595
+ column: string;
6596
+ expectedValue: string | number;
6597
+ } | undefined;
6598
+ }, {
6599
+ data: Record<string, string | number | boolean | null>;
6600
+ where?: {
6601
+ operator: "eq" | "ne" | "gt" | "lt" | "gte" | "lte" | "like" | "in" | "notIn" | "isNull" | "isNotNull";
6602
+ column: string;
6603
+ value?: string | number | boolean | (string | number)[] | null | undefined;
6604
+ }[] | undefined;
6605
+ allowFullTableUpdate?: boolean | undefined;
6606
+ optimisticLock?: {
6607
+ column: string;
6608
+ expectedValue: string | number;
6609
+ } | undefined;
6610
+ }>, {
6611
+ data: Record<string, string | number | boolean | null>;
6612
+ allowFullTableUpdate: boolean;
6613
+ where?: {
6614
+ operator: "eq" | "ne" | "gt" | "lt" | "gte" | "lte" | "like" | "in" | "notIn" | "isNull" | "isNotNull";
6615
+ column: string;
6616
+ value?: string | number | boolean | (string | number)[] | null | undefined;
6617
+ }[] | undefined;
6618
+ optimisticLock?: {
6619
+ column: string;
6620
+ expectedValue: string | number;
6621
+ } | undefined;
6622
+ }, {
6623
+ data: Record<string, string | number | boolean | null>;
6624
+ where?: {
6625
+ operator: "eq" | "ne" | "gt" | "lt" | "gte" | "lte" | "like" | "in" | "notIn" | "isNull" | "isNotNull";
6626
+ column: string;
6627
+ value?: string | number | boolean | (string | number)[] | null | undefined;
6628
+ }[] | undefined;
6629
+ allowFullTableUpdate?: boolean | undefined;
6630
+ optimisticLock?: {
6631
+ column: string;
6632
+ expectedValue: string | number;
6633
+ } | undefined;
6634
+ }>, "many">>;
6635
+ batch: z.ZodOptional<z.ZodObject<{
6636
+ enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
6637
+ batchSize: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
6638
+ continueOnError: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
6639
+ maxRetries: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
6640
+ retryDelayMs: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
6641
+ benchmark: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
6642
+ }, "strip", z.ZodTypeAny, {
6643
+ enabled: boolean;
6644
+ batchSize: number;
6645
+ maxRetries: number;
6646
+ retryDelayMs: number;
6647
+ continueOnError: boolean;
6648
+ benchmark: boolean;
6649
+ }, {
6650
+ enabled?: boolean | undefined;
6651
+ batchSize?: number | undefined;
6652
+ maxRetries?: number | undefined;
6653
+ retryDelayMs?: number | undefined;
6654
+ continueOnError?: boolean | undefined;
6655
+ benchmark?: boolean | undefined;
6656
+ }>>;
6657
+ vendor: z.ZodEnum<["postgresql", "mysql", "sqlite"]>;
6658
+ connectionString: z.ZodString;
6659
+ }, "strip", z.ZodTypeAny, {
6660
+ table: string;
6661
+ connectionString: string;
6662
+ vendor: "postgresql" | "mysql" | "sqlite";
6663
+ allowFullTableUpdate: boolean;
6664
+ data?: Record<string, string | number | boolean | null> | undefined;
6665
+ where?: {
6666
+ operator: "eq" | "ne" | "gt" | "lt" | "gte" | "lte" | "like" | "in" | "notIn" | "isNull" | "isNotNull";
6667
+ column: string;
6668
+ value?: string | number | boolean | (string | number)[] | null | undefined;
6669
+ }[] | undefined;
6670
+ operations?: {
6671
+ data: Record<string, string | number | boolean | null>;
6672
+ allowFullTableUpdate: boolean;
6673
+ where?: {
6674
+ operator: "eq" | "ne" | "gt" | "lt" | "gte" | "lte" | "like" | "in" | "notIn" | "isNull" | "isNotNull";
6675
+ column: string;
6676
+ value?: string | number | boolean | (string | number)[] | null | undefined;
6677
+ }[] | undefined;
6678
+ optimisticLock?: {
6679
+ column: string;
6680
+ expectedValue: string | number;
6681
+ } | undefined;
6682
+ }[] | undefined;
6683
+ batch?: {
6684
+ enabled: boolean;
6685
+ batchSize: number;
6686
+ maxRetries: number;
6687
+ retryDelayMs: number;
6688
+ continueOnError: boolean;
6689
+ benchmark: boolean;
6690
+ } | undefined;
6691
+ optimisticLock?: {
6692
+ column: string;
6693
+ expectedValue: string | number;
6694
+ } | undefined;
6695
+ }, {
6696
+ table: string;
6697
+ connectionString: string;
6698
+ vendor: "postgresql" | "mysql" | "sqlite";
6699
+ data?: Record<string, string | number | boolean | null> | undefined;
6700
+ where?: {
6701
+ operator: "eq" | "ne" | "gt" | "lt" | "gte" | "lte" | "like" | "in" | "notIn" | "isNull" | "isNotNull";
6702
+ column: string;
6703
+ value?: string | number | boolean | (string | number)[] | null | undefined;
6704
+ }[] | undefined;
6705
+ operations?: {
6706
+ data: Record<string, string | number | boolean | null>;
6707
+ where?: {
6708
+ operator: "eq" | "ne" | "gt" | "lt" | "gte" | "lte" | "like" | "in" | "notIn" | "isNull" | "isNotNull";
6709
+ column: string;
6710
+ value?: string | number | boolean | (string | number)[] | null | undefined;
6711
+ }[] | undefined;
6712
+ allowFullTableUpdate?: boolean | undefined;
6713
+ optimisticLock?: {
6714
+ column: string;
6715
+ expectedValue: string | number;
6716
+ } | undefined;
6717
+ }[] | undefined;
6718
+ batch?: {
6719
+ enabled?: boolean | undefined;
6720
+ batchSize?: number | undefined;
6721
+ maxRetries?: number | undefined;
6722
+ retryDelayMs?: number | undefined;
6723
+ continueOnError?: boolean | undefined;
6724
+ benchmark?: boolean | undefined;
6725
+ } | undefined;
6726
+ allowFullTableUpdate?: boolean | undefined;
6727
+ optimisticLock?: {
6728
+ column: string;
6729
+ expectedValue: string | number;
6730
+ } | undefined;
6731
+ }>, {
6732
+ table: string;
6733
+ connectionString: string;
6734
+ vendor: "postgresql" | "mysql" | "sqlite";
6735
+ allowFullTableUpdate: boolean;
6736
+ data?: Record<string, string | number | boolean | null> | undefined;
6737
+ where?: {
6738
+ operator: "eq" | "ne" | "gt" | "lt" | "gte" | "lte" | "like" | "in" | "notIn" | "isNull" | "isNotNull";
6739
+ column: string;
6740
+ value?: string | number | boolean | (string | number)[] | null | undefined;
6741
+ }[] | undefined;
6742
+ operations?: {
6743
+ data: Record<string, string | number | boolean | null>;
6744
+ allowFullTableUpdate: boolean;
6745
+ where?: {
6746
+ operator: "eq" | "ne" | "gt" | "lt" | "gte" | "lte" | "like" | "in" | "notIn" | "isNull" | "isNotNull";
6747
+ column: string;
6748
+ value?: string | number | boolean | (string | number)[] | null | undefined;
6749
+ }[] | undefined;
6750
+ optimisticLock?: {
6751
+ column: string;
6752
+ expectedValue: string | number;
6753
+ } | undefined;
6754
+ }[] | undefined;
6755
+ batch?: {
6756
+ enabled: boolean;
6757
+ batchSize: number;
6758
+ maxRetries: number;
6759
+ retryDelayMs: number;
6760
+ continueOnError: boolean;
6761
+ benchmark: boolean;
6762
+ } | undefined;
6763
+ optimisticLock?: {
6764
+ column: string;
6765
+ expectedValue: string | number;
6766
+ } | undefined;
6767
+ }, {
5918
6768
  table: string;
5919
6769
  connectionString: string;
5920
6770
  vendor: "postgresql" | "mysql" | "sqlite";
6771
+ data?: Record<string, string | number | boolean | null> | undefined;
6772
+ where?: {
6773
+ operator: "eq" | "ne" | "gt" | "lt" | "gte" | "lte" | "like" | "in" | "notIn" | "isNull" | "isNotNull";
6774
+ column: string;
6775
+ value?: string | number | boolean | (string | number)[] | null | undefined;
6776
+ }[] | undefined;
6777
+ operations?: {
6778
+ data: Record<string, string | number | boolean | null>;
6779
+ where?: {
6780
+ operator: "eq" | "ne" | "gt" | "lt" | "gte" | "lte" | "like" | "in" | "notIn" | "isNull" | "isNotNull";
6781
+ column: string;
6782
+ value?: string | number | boolean | (string | number)[] | null | undefined;
6783
+ }[] | undefined;
6784
+ allowFullTableUpdate?: boolean | undefined;
6785
+ optimisticLock?: {
6786
+ column: string;
6787
+ expectedValue: string | number;
6788
+ } | undefined;
6789
+ }[] | undefined;
5921
6790
  batch?: {
5922
6791
  enabled?: boolean | undefined;
5923
6792
  batchSize?: number | undefined;
@@ -5926,11 +6795,12 @@ declare const relationalInsert: _agentforge_core.Tool<{
5926
6795
  continueOnError?: boolean | undefined;
5927
6796
  benchmark?: boolean | undefined;
5928
6797
  } | undefined;
5929
- returning?: {
5930
- mode?: "row" | "none" | "id" | undefined;
5931
- idColumn?: string | undefined;
6798
+ allowFullTableUpdate?: boolean | undefined;
6799
+ optimisticLock?: {
6800
+ column: string;
6801
+ expectedValue: string | number;
5932
6802
  } | undefined;
5933
- }, InsertResponse>;
6803
+ }>;
5934
6804
 
5935
6805
  /**
5936
6806
  * Type definitions for relational UPDATE operations
@@ -5953,6 +6823,14 @@ interface UpdateBatchMetadata {
5953
6823
  failures: BatchFailureDetail[];
5954
6824
  benchmark?: BatchBenchmarkResult;
5955
6825
  }
6826
+ /**
6827
+ * Relational UPDATE tool input.
6828
+ */
6829
+ type RelationalUpdateInput = z.input<typeof relationalUpdateSchema>;
6830
+ /** UPDATE input after database credentials have been bound by a session owner. */
6831
+ type RelationalUpdateExecutionInput = Omit<RelationalUpdateInput, 'connectionString'>;
6832
+ /** Agent-facing UPDATE operation input for a configured database session. */
6833
+ type RelationalUpdateOperationInput = Omit<RelationalUpdateExecutionInput, 'vendor'>;
5956
6834
  /**
5957
6835
  * Tool success response.
5958
6836
  */
@@ -5975,21 +6853,124 @@ interface UpdateErrorResponse {
5975
6853
  */
5976
6854
  type UpdateResponse = UpdateSuccessResponse | UpdateErrorResponse;
5977
6855
 
6856
+ interface RelationalToolSetOptions {
6857
+ /** Kebab-case prefix prepended to every configured Tool name. */
6858
+ prefix?: string;
6859
+ /** Lifetime of cached schema results. Use 0 to disable caching. */
6860
+ schemaCacheTtlMs?: number;
6861
+ }
6862
+ declare class RelationalToolSetConfigurationError extends Error {
6863
+ readonly name = "RelationalToolSetConfigurationError";
6864
+ }
6865
+ declare class RelationalToolSetDisposedError extends Error {
6866
+ readonly name = "RelationalToolSetDisposedError";
6867
+ constructor();
6868
+ }
6869
+ type RelationalTransactionErrorCode = 'NESTED_TRANSACTION' | 'ROLLBACK_ONLY' | 'SCOPE_EXPIRED' | 'START_FAILED' | 'UNSCOPED_TOOL_IN_TRANSACTION';
6870
+ declare class RelationalTransactionError extends Error {
6871
+ readonly code: RelationalTransactionErrorCode;
6872
+ readonly name = "RelationalTransactionError";
6873
+ constructor(message: string, code: RelationalTransactionErrorCode);
6874
+ }
6875
+ type QueryTool = Tool<RelationalQueryOperationInput, QueryResponse>;
6876
+ type SelectTool = Tool<RelationalSelectOperationInput, SelectResponse>;
6877
+ type InsertTool = Tool<RelationalInsertOperationInput, InsertResponse>;
6878
+ type UpdateTool = Tool<RelationalUpdateOperationInput, UpdateResponse>;
6879
+ type DeleteTool = Tool<RelationalDeleteOperationInput, DeleteResponse>;
6880
+ type RelationalToolSetGetSchemaInput = Omit<RelationalGetSchemaOperationInput, 'database' | 'cacheTtlMs'>;
6881
+ type GetSchemaTool = Tool<RelationalToolSetGetSchemaInput, GetSchemaResponse>;
6882
+ type ConfiguredTool = QueryTool | SelectTool | InsertTool | UpdateTool | DeleteTool | GetSchemaTool;
6883
+ interface RelationalTransactionToolSet extends Iterable<ConfiguredTool> {
6884
+ readonly query: QueryTool;
6885
+ readonly select: SelectTool;
6886
+ readonly insert: InsertTool;
6887
+ readonly update: UpdateTool;
6888
+ readonly delete: DeleteTool;
6889
+ readonly getSchema: GetSchemaTool;
6890
+ }
6891
+ interface RelationalToolSet extends RelationalTransactionToolSet {
6892
+ transaction<T>(operation: (tools: RelationalTransactionToolSet) => Promise<T>, options?: TransactionOptions): Promise<T>;
6893
+ refreshSchema(): void;
6894
+ dispose(): Promise<void>;
6895
+ }
5978
6896
  /**
5979
- * Relational UPDATE Tool
6897
+ * Configure all six Relational Tools around one lazily connected database session or pool.
6898
+ * Construction performs validation only and never connects to the database.
6899
+ */
6900
+ declare function createRelationalToolSet(config: ConnectionConfig, options?: RelationalToolSetOptions): RelationalToolSet;
6901
+
6902
+ /**
6903
+ * Relational SELECT Tool
5980
6904
  *
5981
- * Execute type-safe UPDATE queries using Drizzle ORM query builder.
6905
+ * Execute type-safe SELECT queries using Drizzle ORM query builder.
6906
+ *
6907
+ * Features:
6908
+ * - Type-safe column selection
6909
+ * - WHERE conditions with multiple operators
6910
+ * - ORDER BY with ascending/descending
6911
+ * - LIMIT and OFFSET for pagination
6912
+ * - Optional chunked streaming mode for large result sets
6913
+ * - Result formatting to JSON
6914
+ * - Error handling with clear messages
6915
+ *
6916
+ * @deprecated Configure a session-owning Relational Tool Set with
6917
+ * `createRelationalToolSet(...)` and use its `select` Tool instead.
6918
+ *
6919
+ * @example
6920
+ * ```typescript
6921
+ * // SELECT with WHERE and ORDER BY
6922
+ * const result = await relationalSelect.invoke({
6923
+ * table: 'users',
6924
+ * columns: ['id', 'name', 'email'],
6925
+ * where: [
6926
+ * { column: 'status', operator: 'eq', value: 'active' },
6927
+ * { column: 'age', operator: 'gte', value: 18 }
6928
+ * ],
6929
+ * orderBy: [{ column: 'name', direction: 'asc' }],
6930
+ * limit: 10,
6931
+ * vendor: 'postgresql',
6932
+ * connectionString: 'postgresql://user:pass@localhost:5432/mydb'
6933
+ * });
6934
+ * ```
5982
6935
  */
5983
- declare const relationalUpdate: _agentforge_core.Tool<{
6936
+ declare const relationalSelect: _agentforge_core.Tool<{
5984
6937
  table: string;
5985
6938
  connectionString: string;
5986
6939
  vendor: "postgresql" | "mysql" | "sqlite";
5987
- data?: Record<string, string | number | boolean | null> | undefined;
6940
+ limit?: number | undefined;
6941
+ columns?: string[] | undefined;
5988
6942
  where?: {
5989
6943
  operator: "eq" | "ne" | "gt" | "lt" | "gte" | "lte" | "like" | "in" | "notIn" | "isNull" | "isNotNull";
5990
6944
  column: string;
5991
6945
  value?: string | number | boolean | (string | number)[] | null | undefined;
5992
6946
  }[] | undefined;
6947
+ orderBy?: {
6948
+ direction: "asc" | "desc";
6949
+ column: string;
6950
+ }[] | undefined;
6951
+ offset?: number | undefined;
6952
+ streaming?: {
6953
+ enabled?: boolean | undefined;
6954
+ chunkSize?: number | undefined;
6955
+ sampleSize?: number | undefined;
6956
+ maxRows?: number | undefined;
6957
+ benchmark?: boolean | undefined;
6958
+ } | undefined;
6959
+ }, SelectResponse>;
6960
+
6961
+ /**
6962
+ * Relational INSERT Tool
6963
+ *
6964
+ * Execute type-safe INSERT queries using Drizzle ORM query builder.
6965
+ *
6966
+ * @deprecated Configure a session-owning Relational Tool Set with
6967
+ * `createRelationalToolSet(...)` and use its `insert` Tool instead.
6968
+ */
6969
+ declare const relationalInsert: _agentforge_core.Tool<{
6970
+ data: Record<string, string | number | boolean | null> | Record<string, string | number | boolean | null>[];
6971
+ table: string;
6972
+ connectionString: string;
6973
+ vendor: "postgresql" | "mysql" | "sqlite";
5993
6974
  batch?: {
5994
6975
  enabled?: boolean | undefined;
5995
6976
  batchSize?: number | undefined;
@@ -5998,11 +6979,30 @@ declare const relationalUpdate: _agentforge_core.Tool<{
5998
6979
  continueOnError?: boolean | undefined;
5999
6980
  benchmark?: boolean | undefined;
6000
6981
  } | undefined;
6001
- allowFullTableUpdate?: boolean | undefined;
6002
- optimisticLock?: {
6003
- column: string;
6004
- expectedValue: string | number;
6982
+ returning?: {
6983
+ mode?: "row" | "none" | "id" | undefined;
6984
+ idColumn?: string | undefined;
6005
6985
  } | undefined;
6986
+ }, InsertResponse>;
6987
+
6988
+ /**
6989
+ * Relational UPDATE Tool
6990
+ *
6991
+ * Execute type-safe UPDATE queries using Drizzle ORM query builder.
6992
+ *
6993
+ * @deprecated Configure a session-owning Relational Tool Set with
6994
+ * `createRelationalToolSet(...)` and use its `update` Tool instead.
6995
+ */
6996
+ declare const relationalUpdate: _agentforge_core.Tool<{
6997
+ table: string;
6998
+ connectionString: string;
6999
+ vendor: "postgresql" | "mysql" | "sqlite";
7000
+ data?: Record<string, string | number | boolean | null> | undefined;
7001
+ where?: {
7002
+ operator: "eq" | "ne" | "gt" | "lt" | "gte" | "lte" | "like" | "in" | "notIn" | "isNull" | "isNotNull";
7003
+ column: string;
7004
+ value?: string | number | boolean | (string | number)[] | null | undefined;
7005
+ }[] | undefined;
6006
7006
  operations?: {
6007
7007
  data: Record<string, string | number | boolean | null>;
6008
7008
  where?: {
@@ -6016,50 +7016,29 @@ declare const relationalUpdate: _agentforge_core.Tool<{
6016
7016
  expectedValue: string | number;
6017
7017
  } | undefined;
6018
7018
  }[] | undefined;
7019
+ batch?: {
7020
+ enabled?: boolean | undefined;
7021
+ batchSize?: number | undefined;
7022
+ maxRetries?: number | undefined;
7023
+ retryDelayMs?: number | undefined;
7024
+ continueOnError?: boolean | undefined;
7025
+ benchmark?: boolean | undefined;
7026
+ } | undefined;
7027
+ allowFullTableUpdate?: boolean | undefined;
7028
+ optimisticLock?: {
7029
+ column: string;
7030
+ expectedValue: string | number;
7031
+ } | undefined;
6019
7032
  }, UpdateResponse>;
6020
7033
 
6021
- /**
6022
- * Type definitions for relational DELETE operations
6023
- * @module tools/relational-delete/types
6024
- */
6025
-
6026
- /** Metadata returned after a batched DELETE operation completes. */
6027
- interface DeleteBatchMetadata {
6028
- enabled: boolean;
6029
- batchSize: number;
6030
- totalItems: number;
6031
- processedItems: number;
6032
- successfulItems: number;
6033
- failedItems: number;
6034
- totalBatches: number;
6035
- retries: number;
6036
- partialSuccess: boolean;
6037
- failures: BatchFailureDetail[];
6038
- benchmark?: BatchBenchmarkResult;
6039
- }
6040
- /** Successful DELETE response returned to the caller. */
6041
- interface DeleteSuccessResponse {
6042
- success: true;
6043
- rowCount: number;
6044
- executionTime: number;
6045
- softDeleted: boolean;
6046
- batch?: DeleteBatchMetadata;
6047
- }
6048
- /** Error DELETE response returned when the operation fails. */
6049
- interface DeleteErrorResponse {
6050
- success: false;
6051
- error: string;
6052
- rowCount: 0;
6053
- softDeleted: false;
6054
- }
6055
- /** Union type representing either a successful or failed DELETE response. */
6056
- type DeleteResponse = DeleteSuccessResponse | DeleteErrorResponse;
6057
-
6058
7034
  /**
6059
7035
  * LangGraph tool for type-safe DELETE queries with single and batched operation support.
6060
7036
  *
6061
7037
  * Supports WHERE conditions, full-table-delete protection, soft-delete mode,
6062
7038
  * batch operations with retry logic, and optional cascade hints.
7039
+ *
7040
+ * @deprecated Configure a session-owning Relational Tool Set with
7041
+ * `createRelationalToolSet(...)` and use its `delete` Tool instead.
6063
7042
  */
6064
7043
  declare const relationalDelete: _agentforge_core.Tool<{
6065
7044
  table: string;
@@ -6070,13 +7049,11 @@ declare const relationalDelete: _agentforge_core.Tool<{
6070
7049
  column: string;
6071
7050
  value?: string | number | boolean | (string | number)[] | null | undefined;
6072
7051
  }[] | undefined;
6073
- batch?: {
6074
- enabled?: boolean | undefined;
6075
- batchSize?: number | undefined;
6076
- maxRetries?: number | undefined;
6077
- retryDelayMs?: number | undefined;
6078
- continueOnError?: boolean | undefined;
6079
- benchmark?: boolean | undefined;
7052
+ allowFullTableDelete?: boolean | undefined;
7053
+ cascade?: boolean | undefined;
7054
+ softDelete?: {
7055
+ value?: string | number | undefined;
7056
+ column?: string | undefined;
6080
7057
  } | undefined;
6081
7058
  operations?: {
6082
7059
  where?: {
@@ -6091,48 +7068,16 @@ declare const relationalDelete: _agentforge_core.Tool<{
6091
7068
  column?: string | undefined;
6092
7069
  } | undefined;
6093
7070
  }[] | undefined;
6094
- allowFullTableDelete?: boolean | undefined;
6095
- cascade?: boolean | undefined;
6096
- softDelete?: {
6097
- value?: string | number | undefined;
6098
- column?: string | undefined;
7071
+ batch?: {
7072
+ enabled?: boolean | undefined;
7073
+ batchSize?: number | undefined;
7074
+ maxRetries?: number | undefined;
7075
+ retryDelayMs?: number | undefined;
7076
+ continueOnError?: boolean | undefined;
7077
+ benchmark?: boolean | undefined;
6099
7078
  } | undefined;
6100
7079
  }, DeleteResponse>;
6101
7080
 
6102
- /**
6103
- * Relational Get Schema Tool
6104
- * @module tools/relational-get-schema
6105
- */
6106
- /**
6107
- * Relational Get Schema Tool
6108
- *
6109
- * Introspects database schema metadata including tables, columns, primary keys,
6110
- * foreign keys, and indexes for PostgreSQL, MySQL, and SQLite.
6111
- */
6112
- declare const relationalGetSchema: _agentforge_core.Tool<{
6113
- connectionString: string;
6114
- vendor: "postgresql" | "mysql" | "sqlite";
6115
- database?: string | undefined;
6116
- tables?: string[] | undefined;
6117
- cacheTtlMs?: number | undefined;
6118
- refreshCache?: boolean | undefined;
6119
- }, {
6120
- success: boolean;
6121
- schema: DatabaseSchema;
6122
- summary: {
6123
- tableCount: number;
6124
- columnCount: number;
6125
- foreignKeyCount: number;
6126
- indexCount: number;
6127
- };
6128
- error?: undefined;
6129
- } | {
6130
- success: boolean;
6131
- error: string;
6132
- schema: null;
6133
- summary?: undefined;
6134
- }>;
6135
-
6136
7081
  type FileSystemPolicyErrorCode = 'FILE_SYSTEM_POLICY_VIOLATION';
6137
7082
  declare class FileSystemPolicyError extends Error {
6138
7083
  readonly operation: string;
@@ -8978,4 +9923,4 @@ declare const askHumanTool: _agentforge_core.Tool<{
8978
9923
  suggestions?: string[] | undefined;
8979
9924
  }, AskHumanOutput>;
8980
9925
 
8981
- export { type AskHumanInput, AskHumanInputSchema, type AskHumanOutput, type BatchBenchmarkResult, type BatchEmbeddingResult, type BatchExecutionOptions, type BatchExecutionResult, type BatchExecutionTask, type BatchFailureDetail, type BatchProgressUpdate, type BuiltDeleteQuery, type BuiltInsertQuery, type BuiltUpdateQuery, type CalculatorInput, CalculatorSchema, type ColumnDiff, type ColumnSchema, type ConfluenceAuth, type ConfluenceToolsConfig, type ConnectionConfig, type ConnectionEvent, ConnectionManager, ConnectionState, type CreditCardValidatorInput, CreditCardValidatorSchema, type CsvToolsConfig, type CurrentDateTimeInput, CurrentDateTimeSchema, DEFAULT_BATCH_SIZE, DEFAULT_CHUNK_SIZE, DEFAULT_DESTINATION_POLICY, DEFAULT_FILE_SYSTEM_POLICY, DEFAULT_RETRY_CONFIG, type DatabaseConfig, type DatabaseConnection, type DatabaseSchema, type DatabaseVendor, type DateArithmeticInput, DateArithmeticSchema, type DateComparisonInput, DateComparisonSchema, type DateDifferenceInput, DateDifferenceSchema, type DateFormatterInput, DateFormatterSchema, type DateTimeConfig, type DeleteQueryInput, type DeleteSoftDeleteOptions, type DeleteWhereCondition, type DestinationBlockReason, type DestinationPolicy, DestinationPolicyError, type DirectoryListEntry, type DirectoryListResult, type DirectoryOperationsConfig, DuckDuckGoProvider, type EmailValidatorInput, EmailValidatorSchema, type EmbeddingConfig, EmbeddingManager, type EmbeddingProvider, type EmbeddingProviderError, type EmbeddingResult, type EmbeddingRetryConfig, type FileOperationsConfig, FileSystemPolicy, FileSystemPolicyError, type FileSystemPolicyErrorCode, type FileSystemPolicyInput, type FileSystemPolicyOptions, type ForeignKeySchema, type HtmlParserToolsConfig, HttpMethod, type HttpResponse, type HttpToolsConfig, type IEmbeddingProvider, type IndexSchema, type InsertData, type InsertQueryInput, type InsertReturningMode, type InsertReturningOptions, type InsertRow, type InsertValue, type IpValidatorInput, IpValidatorSchema, type JsonToolsConfig, MAX_BATCH_SIZE, type MappedType, type MathFunctionsInput, MathFunctionsSchema, type MathOperationsConfig, MissingPeerDependencyError, type ModelSafeToolPreset, type ModelSafeToolPresetOptions, type MySQLConnectionConfig, type Neo4jConfig, type Neo4jNode, type Neo4jPath, type Neo4jProperties, type Neo4jPropertyValue, type Neo4jRelationship, type Neo4jSchema, type Neo4jToolsConfig, OpenAIEmbeddingProvider, type PathUtilitiesConfig, type PhoneValidatorInput, PhoneValidatorSchema, type PoolConfig, type PostgreSQLConnectionConfig, type QueryExecutionResult, type QueryInput, type QueryMetadata, type QueryParams, type QueryResult, type RandomNumberInput, RandomNumberSchema, type ReconnectionConfig, type RetryConfig, type SQLiteConnectionConfig, type SchemaDiffResult, type SchemaInspectOptions, SchemaInspector, type SchemaInspectorConfig, type ScraperResult, type ScraperToolsConfig, type SearchProvider, type SearchResult, type SelectOrderBy, type SelectOrderDirection, type SelectQueryInput, type SelectWhereCondition, SerperProvider, type SlackClientConfig, type SlackToolsConfig, type SqlExecutor, type StatisticsInput, StatisticsSchema, type StreamingBenchmarkResult, type StreamingMemoryUsage$1 as StreamingMemoryUsage, type StreamingSelectChunk, type StreamingSelectOptions, type StreamingSelectResult, type StringCaseConverterInput, StringCaseConverterSchema, type StringJoinInput, StringJoinSchema, type StringLengthInput, StringLengthSchema, type StringReplaceInput, StringReplaceSchema, type StringSplitInput, StringSplitSchema, type StringSubstringInput, StringSubstringSchema, type StringTrimInput, StringTrimSchema, type StringUtilitiesConfig, type TableDiff, type TableSchema, type TransactionContext, type TransactionIsolationLevel, type TransactionOptions, type TransformerToolsConfig, type UpdateData, type UpdateOptimisticLock, type UpdateQueryInput, type UpdateValue, type UpdateWhereCondition, type UpdateWhereOperator, type UrlValidationResult, type UrlValidatorSimpleInput, UrlValidatorSimpleSchema, type UrlValidatorToolsConfig, type UuidValidatorInput, UuidValidatorSchema, type ValidationConfig, type ValidationResult, type VendorConnectionConfig, type WebSearchInput, type WebSearchOutput, type XmlToolsConfig, archiveConfluencePage, arrayFilter, arrayFilterSchema, arrayGroupBy, arrayGroupBySchema, arrayMap, arrayMapSchema, arraySort, arraySortSchema, askHumanTool, assertDestinationAllowed, benchmarkBatchExecution, benchmarkStreamingSelectMemory, buildDeleteQuery, buildInsertQuery, buildSelectQuery, buildUpdateQuery, calculator, checkPeerDependency, confluenceTools, createArrayFilterTool, createArrayGroupByTool, createArrayMapTool, createArraySortTool, createAskHumanTool, createCalculatorTool, createConfluencePage, createConfluenceTools, createCreditCardValidatorTool, createCsvGeneratorTool, createCsvParserTool, createCsvToJsonTool, createCsvTools, createCurrentDateTimeTool, createDateArithmeticTool, createDateComparisonTool, createDateDifferenceTool, createDateFormatterTool, createDateTimeTools, createDirectoryCreateTool, createDirectoryDeleteTool, createDirectoryListTool, createDirectoryOperationTools, createDuckDuckGoProvider, createEmailValidatorTool, createExtractImagesTool, createExtractLinksTool, createFileAppendTool, createFileDeleteTool, createFileExistsTool, createFileOperationTools, createFileReaderTool, createFileSearchTool, createFileSystemPolicy, createFileWriterTool, createHtmlParserTool, createHtmlParserTools, createHttpTools, createIpValidatorTool, createJsonMergeTool, createJsonParserTool, createJsonQueryTool, createJsonStringifyTool, createJsonToCsvTool, createJsonToXmlTool, createJsonTools, createJsonValidatorTool, createMathFunctionsTool, createMathOperationTools, createModelSafeToolPreset, createNeo4jCreateNodeWithEmbeddingTool, createNeo4jFindNodesTool, createNeo4jGetSchemaTool, createNeo4jQueryTool, createNeo4jTools, createNeo4jTraverseTool, createNeo4jVectorSearchTool, createNeo4jVectorSearchWithEmbeddingTool, createObjectOmitTool, createObjectPickTool, createPathBasenameTool, createPathDirnameTool, createPathExtensionTool, createPathJoinTool, createPathNormalizeTool, createPathParseTool, createPathRelativeTool, createPathResolveTool, createPathUtilityTools, createPhoneValidatorTool, createRandomNumberTool, createScraperTools, createSelectReadableStream, createSerperProvider, createSlackTools, createStatisticsTool, createStringCaseConverterTool, createStringJoinTool, createStringLengthTool, createStringReplaceTool, createStringSplitTool, createStringSubstringTool, createStringTrimTool, createStringUtilityTools, createTransformerTools, createUrlBuilderTool, createUrlQueryParserTool, createUrlValidatorSimpleTool, createUrlValidatorTool, createUrlValidatorTools, createUuidValidatorTool, createValidationTools, createWebScraperTool, createXmlGeneratorTool, createXmlParserTool, createXmlToJsonTool, createXmlTools, creditCardValidator, csvGenerator, csvGeneratorSchema, csvParser, csvParserSchema, csvToJson, csvToJsonSchema, csvTools, currentDateTime, dateArithmetic, dateComparison, dateDifference, dateFormatter, dateTimeTools, diffSchemas, directoryCreate, directoryCreateSchema, directoryDelete, directoryDeleteSchema, directoryList, directoryListSchema, directoryOperationTools, emailValidator, embeddingManager, executeBatchedTask, executeQuery, executeStreamingSelect, exportSchemaToJson, extractImages, extractImagesSchema, extractLinks, extractLinksSchema, fileAppend, fileAppendSchema, fileDelete, fileDeleteSchema, fileExists, fileExistsSchema, fileOperationTools, fileReader, fileReaderSchema, fileSearch, fileSearchSchema, fileWriter, fileWriterSchema, generateBatchEmbeddings, generateEmbedding, getCohereApiKey, getConfluencePage, getEmbeddingModel, getEmbeddingProvider, getHuggingFaceApiKey, getInstallationInstructions, getOllamaBaseUrl, getOpenAIApiKey, getPeerDependencyName, getSlackChannels, getSlackMessages, getSpacePages, getVendorTypeMap, getVoyageApiKey, htmlParser, htmlParserSchema, htmlParserTools, httpClient, httpGet, httpGetSchema, httpPost, httpPostSchema, httpRequestSchema, httpTools, importSchemaFromJson, initializeEmbeddings, initializeEmbeddingsWithConfig, initializeFromEnv, initializeNeo4jTools, ipValidator, isRetryableError, jsonMerge, jsonMergeSchema, jsonParser, jsonParserSchema, jsonQuery, jsonQuerySchema, jsonStringify, jsonStringifySchema, jsonToCsv, jsonToCsvSchema, jsonToXml, jsonToXmlSchema, jsonTools, jsonValidator, jsonValidatorSchema, listConfluenceSpaces, mapColumnType, mapSchemaTypes, mathFunctions, mathOperationTools, neo4jCoreTools, neo4jCreateNodeWithEmbedding, neo4jCreateNodeWithEmbeddingSchema, neo4jFindNodes, neo4jFindNodesSchema, neo4jGetSchema, neo4jGetSchemaSchema, neo4jPool, neo4jQuery, neo4jQuerySchema, neo4jTools, neo4jTraverse, neo4jTraverseSchema, neo4jVectorSearch, neo4jVectorSearchSchema, neo4jVectorSearchWithEmbedding, neo4jVectorSearchWithEmbeddingSchema, notifySlack, objectOmit, objectOmitSchema, objectPick, objectPickSchema, pathBasename, pathBasenameSchema, pathDirname, pathDirnameSchema, pathExtension, pathExtensionSchema, pathJoin, pathJoinSchema, pathNormalize, pathNormalizeSchema, pathParse, pathParseSchema, pathRelative, pathRelativeSchema, pathResolve, pathResolveSchema, pathUtilityTools, phoneValidator, randomNumber, relationalDelete, relationalGetSchema, relationalInsert, relationalQuery, relationalSelect, relationalUpdate, requestWithDestinationPolicy, resolveFileSystemPolicy, retryWithBackoff, scraperTools, searchConfluence, searchResultSchema, sendSlackMessage, slackTools, statistics, streamSelectChunks, stringCaseConverter, stringJoin, stringLength, stringReplace, stringSplit, stringSubstring, stringTrim, stringUtilityTools, transformerArraySchema, transformerObjectSchema, transformerTools, transformerValueSchema, updateConfluencePage, urlBuilder, urlBuilderSchema, urlQueryParser, urlQueryParserSchema, urlValidator, urlValidatorSchema, urlValidatorSimple, urlValidatorTools, uuidValidator, validateBatch, validateColumnTypes, validateColumnsExist, validateTableExists, validateText, validationTools, webScraper, webScraperSchema, webSearch, webSearchOutputSchema, webSearchSchema, withProviderErrorMetadata, withTransaction, xmlGenerator, xmlGeneratorSchema, xmlParser, xmlParserSchema, xmlToJson, xmlToJsonSchema, xmlTools };
9926
+ export { type AskHumanInput, AskHumanInputSchema, type AskHumanOutput, type BatchBenchmarkResult, type BatchEmbeddingResult, type BatchExecutionOptions, type BatchExecutionResult, type BatchExecutionTask, type BatchFailureDetail, type BatchProgressUpdate, type BuiltDeleteQuery, type BuiltInsertQuery, type BuiltUpdateQuery, type CalculatorInput, CalculatorSchema, type ColumnDiff, type ColumnSchema, type ConfluenceAuth, type ConfluenceToolsConfig, type ConnectionConfig, type ConnectionEvent, ConnectionManager, ConnectionState, type CreditCardValidatorInput, CreditCardValidatorSchema, type CsvToolsConfig, type CurrentDateTimeInput, CurrentDateTimeSchema, DEFAULT_BATCH_SIZE, DEFAULT_CHUNK_SIZE, DEFAULT_DESTINATION_POLICY, DEFAULT_FILE_SYSTEM_POLICY, DEFAULT_RETRY_CONFIG, type DatabaseConfig, type DatabaseConnection, type DatabaseSchema, type DatabaseVendor, type DateArithmeticInput, DateArithmeticSchema, type DateComparisonInput, DateComparisonSchema, type DateDifferenceInput, DateDifferenceSchema, type DateFormatterInput, DateFormatterSchema, type DateTimeConfig, type DeleteQueryInput, type DeleteSoftDeleteOptions, type DeleteWhereCondition, type DestinationBlockReason, type DestinationPolicy, DestinationPolicyError, type DirectoryListEntry, type DirectoryListResult, type DirectoryOperationsConfig, DuckDuckGoProvider, type EmailValidatorInput, EmailValidatorSchema, type EmbeddingConfig, EmbeddingManager, type EmbeddingProvider, type EmbeddingProviderError, type EmbeddingResult, type EmbeddingRetryConfig, type FileOperationsConfig, FileSystemPolicy, FileSystemPolicyError, type FileSystemPolicyErrorCode, type FileSystemPolicyInput, type FileSystemPolicyOptions, type ForeignKeySchema, type HtmlParserToolsConfig, HttpMethod, type HttpResponse, type HttpToolsConfig, type IEmbeddingProvider, type IndexSchema, type InsertData, type InsertQueryInput, type InsertReturningMode, type InsertReturningOptions, type InsertRow, type InsertValue, type IpValidatorInput, IpValidatorSchema, type JsonToolsConfig, MAX_BATCH_SIZE, type MappedType, type MathFunctionsInput, MathFunctionsSchema, type MathOperationsConfig, MissingPeerDependencyError, type ModelSafeToolPreset, type ModelSafeToolPresetOptions, type MySQLConnectionConfig, type Neo4jConfig, type Neo4jNode, type Neo4jPath, type Neo4jProperties, type Neo4jPropertyValue, type Neo4jRelationship, type Neo4jSchema, type Neo4jToolsConfig, OpenAIEmbeddingProvider, type PathUtilitiesConfig, type PhoneValidatorInput, PhoneValidatorSchema, type PoolConfig, type PostgreSQLConnectionConfig, type QueryExecutionResult, type QueryInput, type QueryMetadata, type QueryParams, type QueryResult, type RandomNumberInput, RandomNumberSchema, type ReconnectionConfig, type RelationalToolSet, RelationalToolSetConfigurationError, RelationalToolSetDisposedError, type RelationalToolSetGetSchemaInput, type RelationalToolSetOptions, RelationalTransactionError, type RelationalTransactionErrorCode, type RelationalTransactionToolSet, type RetryConfig, type SQLiteConnectionConfig, SchemaCache, type SchemaCacheEntry, type SchemaCache$1 as SchemaCacheInterface, type SchemaDiffResult, type SchemaInspectOptions, SchemaInspector, type SchemaInspectorConfig, type ScraperResult, type ScraperToolsConfig, type SearchProvider, type SearchResult, type SelectOrderBy, type SelectOrderDirection, type SelectQueryInput, type SelectWhereCondition, SerperProvider, type SlackClientConfig, type SlackToolsConfig, type SqlExecutor, type StatisticsInput, StatisticsSchema, type StreamingBenchmarkResult, type StreamingMemoryUsage$1 as StreamingMemoryUsage, type StreamingSelectChunk, type StreamingSelectOptions, type StreamingSelectResult, type StringCaseConverterInput, StringCaseConverterSchema, type StringJoinInput, StringJoinSchema, type StringLengthInput, StringLengthSchema, type StringReplaceInput, StringReplaceSchema, type StringSplitInput, StringSplitSchema, type StringSubstringInput, StringSubstringSchema, type StringTrimInput, StringTrimSchema, type StringUtilitiesConfig, type TableDiff, type TableSchema, type TransactionContext, type TransactionIsolationLevel, type TransactionOptions, type TransformerToolsConfig, type UpdateData, type UpdateOptimisticLock, type UpdateQueryInput, type UpdateValue, type UpdateWhereCondition, type UpdateWhereOperator, type UrlValidationResult, type UrlValidatorSimpleInput, UrlValidatorSimpleSchema, type UrlValidatorToolsConfig, type UuidValidatorInput, UuidValidatorSchema, type ValidationConfig, type ValidationResult, type VendorConnectionConfig, type WebSearchInput, type WebSearchOutput, type XmlToolsConfig, archiveConfluencePage, arrayFilter, arrayFilterSchema, arrayGroupBy, arrayGroupBySchema, arrayMap, arrayMapSchema, arraySort, arraySortSchema, askHumanTool, assertDestinationAllowed, benchmarkBatchExecution, benchmarkStreamingSelectMemory, buildDeleteQuery, buildInsertQuery, buildSelectQuery, buildUpdateQuery, calculator, checkPeerDependency, confluenceTools, createArrayFilterTool, createArrayGroupByTool, createArrayMapTool, createArraySortTool, createAskHumanTool, createCalculatorTool, createConfluencePage, createConfluenceTools, createCreditCardValidatorTool, createCsvGeneratorTool, createCsvParserTool, createCsvToJsonTool, createCsvTools, createCurrentDateTimeTool, createDateArithmeticTool, createDateComparisonTool, createDateDifferenceTool, createDateFormatterTool, createDateTimeTools, createDirectoryCreateTool, createDirectoryDeleteTool, createDirectoryListTool, createDirectoryOperationTools, createDuckDuckGoProvider, createEmailValidatorTool, createExtractImagesTool, createExtractLinksTool, createFileAppendTool, createFileDeleteTool, createFileExistsTool, createFileOperationTools, createFileReaderTool, createFileSearchTool, createFileSystemPolicy, createFileWriterTool, createHtmlParserTool, createHtmlParserTools, createHttpTools, createIpValidatorTool, createJsonMergeTool, createJsonParserTool, createJsonQueryTool, createJsonStringifyTool, createJsonToCsvTool, createJsonToXmlTool, createJsonTools, createJsonValidatorTool, createMathFunctionsTool, createMathOperationTools, createModelSafeToolPreset, createNeo4jCreateNodeWithEmbeddingTool, createNeo4jFindNodesTool, createNeo4jGetSchemaTool, createNeo4jQueryTool, createNeo4jTools, createNeo4jTraverseTool, createNeo4jVectorSearchTool, createNeo4jVectorSearchWithEmbeddingTool, createObjectOmitTool, createObjectPickTool, createPathBasenameTool, createPathDirnameTool, createPathExtensionTool, createPathJoinTool, createPathNormalizeTool, createPathParseTool, createPathRelativeTool, createPathResolveTool, createPathUtilityTools, createPhoneValidatorTool, createRandomNumberTool, createRelationalToolSet, createScraperTools, createSelectReadableStream, createSerperProvider, createSlackTools, createStatisticsTool, createStringCaseConverterTool, createStringJoinTool, createStringLengthTool, createStringReplaceTool, createStringSplitTool, createStringSubstringTool, createStringTrimTool, createStringUtilityTools, createTransformerTools, createUrlBuilderTool, createUrlQueryParserTool, createUrlValidatorSimpleTool, createUrlValidatorTool, createUrlValidatorTools, createUuidValidatorTool, createValidationTools, createWebScraperTool, createXmlGeneratorTool, createXmlParserTool, createXmlToJsonTool, createXmlTools, creditCardValidator, csvGenerator, csvGeneratorSchema, csvParser, csvParserSchema, csvToJson, csvToJsonSchema, csvTools, currentDateTime, dateArithmetic, dateComparison, dateDifference, dateFormatter, dateTimeTools, diffSchemas, directoryCreate, directoryCreateSchema, directoryDelete, directoryDeleteSchema, directoryList, directoryListSchema, directoryOperationTools, emailValidator, embeddingManager, executeBatchedTask, executeQuery, executeStreamingSelect, exportSchemaToJson, extractImages, extractImagesSchema, extractLinks, extractLinksSchema, fileAppend, fileAppendSchema, fileDelete, fileDeleteSchema, fileExists, fileExistsSchema, fileOperationTools, fileReader, fileReaderSchema, fileSearch, fileSearchSchema, fileWriter, fileWriterSchema, generateBatchEmbeddings, generateEmbedding, getCohereApiKey, getConfluencePage, getEmbeddingModel, getEmbeddingProvider, getHuggingFaceApiKey, getInstallationInstructions, getOllamaBaseUrl, getOpenAIApiKey, getPeerDependencyName, getSlackChannels, getSlackMessages, getSpacePages, getVendorTypeMap, getVoyageApiKey, htmlParser, htmlParserSchema, htmlParserTools, httpClient, httpGet, httpGetSchema, httpPost, httpPostSchema, httpRequestSchema, httpTools, importSchemaFromJson, initializeEmbeddings, initializeEmbeddingsWithConfig, initializeFromEnv, initializeNeo4jTools, ipValidator, isRetryableError, jsonMerge, jsonMergeSchema, jsonParser, jsonParserSchema, jsonQuery, jsonQuerySchema, jsonStringify, jsonStringifySchema, jsonToCsv, jsonToCsvSchema, jsonToXml, jsonToXmlSchema, jsonTools, jsonValidator, jsonValidatorSchema, listConfluenceSpaces, mapColumnType, mapSchemaTypes, mathFunctions, mathOperationTools, neo4jCoreTools, neo4jCreateNodeWithEmbedding, neo4jCreateNodeWithEmbeddingSchema, neo4jFindNodes, neo4jFindNodesSchema, neo4jGetSchema, neo4jGetSchemaSchema, neo4jPool, neo4jQuery, neo4jQuerySchema, neo4jTools, neo4jTraverse, neo4jTraverseSchema, neo4jVectorSearch, neo4jVectorSearchSchema, neo4jVectorSearchWithEmbedding, neo4jVectorSearchWithEmbeddingSchema, notifySlack, objectOmit, objectOmitSchema, objectPick, objectPickSchema, pathBasename, pathBasenameSchema, pathDirname, pathDirnameSchema, pathExtension, pathExtensionSchema, pathJoin, pathJoinSchema, pathNormalize, pathNormalizeSchema, pathParse, pathParseSchema, pathRelative, pathRelativeSchema, pathResolve, pathResolveSchema, pathUtilityTools, phoneValidator, randomNumber, relationalDelete, relationalGetSchema, relationalInsert, relationalQuery, relationalSelect, relationalUpdate, requestWithDestinationPolicy, resolveFileSystemPolicy, retryWithBackoff, scraperTools, searchConfluence, searchResultSchema, sendSlackMessage, slackTools, statistics, streamSelectChunks, stringCaseConverter, stringJoin, stringLength, stringReplace, stringSplit, stringSubstring, stringTrim, stringUtilityTools, transformerArraySchema, transformerObjectSchema, transformerTools, transformerValueSchema, updateConfluencePage, urlBuilder, urlBuilderSchema, urlQueryParser, urlQueryParserSchema, urlValidator, urlValidatorSchema, urlValidatorSimple, urlValidatorTools, uuidValidator, validateBatch, validateColumnTypes, validateColumnsExist, validateTableExists, validateText, validationTools, webScraper, webScraperSchema, webSearch, webSearchOutputSchema, webSearchSchema, withProviderErrorMetadata, withTransaction, xmlGenerator, xmlGeneratorSchema, xmlParser, xmlParserSchema, xmlToJson, xmlToJsonSchema, xmlTools };