@agentforge/tools 0.9.0 → 0.10.0

package/dist/index.d.cts

@@ -760,6 +760,104 @@ declare const slackTools: (Tool<{
     error?: string;
 }>)[];
 
+/**
+ * Type definitions for Confluence tools
+ */
+
+/**
+ * Configuration options for Confluence tools
+ */
+interface ConfluenceToolsConfig {
+    /**
+     * Atlassian API key
+     * If not provided, will fall back to ATLASSIAN_API_KEY env var
+     */
+    apiKey?: string;
+    /**
+     * Atlassian account email
+     * If not provided, will fall back to ATLASSIAN_EMAIL env var
+     */
+    email?: string;
+    /**
+     * Atlassian site URL (e.g., 'https://your-domain.atlassian.net')
+     * If not provided, will fall back to ATLASSIAN_SITE_URL env var
+     */
+    siteUrl?: string;
+    /**
+     * Custom log level for Confluence tools
+     * @default LogLevel.INFO
+     */
+    logLevel?: LogLevel;
+}
+/**
+ * Confluence authentication credentials
+ */
+interface ConfluenceAuth {
+    ATLASSIAN_API_KEY: string;
+    ATLASSIAN_EMAIL: string;
+    ATLASSIAN_SITE_URL: string;
+}
+
+/**
+ * Default Confluence tools using environment variables
+ */
+declare const searchConfluence: _agentforge_core.Tool<unknown, unknown>;
+declare const getConfluencePage: _agentforge_core.Tool<unknown, unknown>;
+declare const listConfluenceSpaces: _agentforge_core.Tool<unknown, unknown>;
+declare const getSpacePages: _agentforge_core.Tool<unknown, unknown>;
+declare const createConfluencePage: _agentforge_core.Tool<unknown, unknown>;
+declare const updateConfluencePage: _agentforge_core.Tool<unknown, unknown>;
+declare const archiveConfluencePage: _agentforge_core.Tool<unknown, unknown>;
+/**
+ * Export all Confluence tools
+ *
+ * Includes 7 tools for Confluence integration:
+ * - 4 read tools: search, get-page, list-spaces, get-space-pages
+ * - 3 write tools: create-page, update-page, archive-page
+ */
+declare const confluenceTools: _agentforge_core.Tool<unknown, unknown>[];
+/**
+ * Create Confluence tools with custom configuration
+ *
+ * This factory function allows you to create Confluence tools with programmatic configuration
+ * instead of relying solely on environment variables.
+ *
+ * @param config - Optional configuration for Confluence tools
+ * @returns Object containing all 7 Confluence tools configured with the provided settings
+ *
+ * @example
+ * ```ts
+ * // Create tools with custom credentials
+ * const tools = createConfluenceTools({
+ *   apiKey: 'your-api-key',
+ *   email: 'your-email@example.com',
+ *   siteUrl: 'https://your-domain.atlassian.net'
+ * });
+ *
+ * // Use the tools
+ * const result = await tools.searchConfluence.execute({
+ *   query: 'payment processing'
+ * });
+ * ```
+ *
+ * @example
+ * ```ts
+ * // Create tools with custom log level
+ * const tools = createConfluenceTools({
+ *   logLevel: LogLevel.DEBUG
+ * });
+ * ```
+ */
+declare function createConfluenceTools(config?: ConfluenceToolsConfig): {
+    searchConfluence: _agentforge_core.Tool<unknown, unknown>;
+    getConfluencePage: _agentforge_core.Tool<unknown, unknown>;
+    listConfluenceSpaces: _agentforge_core.Tool<unknown, unknown>;
+    getSpacePages: _agentforge_core.Tool<unknown, unknown>;
+    createConfluencePage: _agentforge_core.Tool<unknown, unknown>;
+    updateConfluencePage: _agentforge_core.Tool<unknown, unknown>;
+    archiveConfluencePage: _agentforge_core.Tool<unknown, unknown>;
+};
+
 /**
  * JSON Processor Tool
  *
@@ -1788,4 +1886,4 @@ declare const askHumanTool: _agentforge_core.Tool<{
     suggestions?: string[] | undefined;
 }, AskHumanOutput>;
 
-export { type AskHumanInput, AskHumanInputSchema, type AskHumanOutput, DuckDuckGoProvider, type HttpResponse, type RetryConfig, type ScraperResult, type SearchProvider, type SearchResult, SerperProvider, type SlackToolsConfig, type UrlValidationResult, type WebSearchInput, type WebSearchOutput, arrayFilter, arrayGroupBy, arrayMap, arraySort, askHumanTool, calculator, createAskHumanTool, createDuckDuckGoProvider, createSerperProvider, createSlackTools, creditCardValidator, csvGenerator, csvParser, csvToJson, currentDateTime, dateArithmetic, dateComparison, dateDifference, dateFormatter, directoryCreate, directoryDelete, directoryList, emailValidator, extractImages, extractLinks, fileAppend, fileDelete, fileExists, fileReader, fileSearch, fileWriter, getSlackChannels, getSlackMessages, htmlParser, httpClient, httpGet, httpPost, ipValidator, jsonMerge, jsonParser, jsonQuery, jsonStringify, jsonToCsv, jsonToXml, jsonValidator, mathFunctions, notifySlack, objectOmit, objectPick, pathBasename, pathDirname, pathExtension, pathJoin, pathNormalize, pathParse, pathRelative, pathResolve, phoneValidator, randomNumber, searchResultSchema, sendSlackMessage, slackTools, statistics, stringCaseConverter, stringJoin, stringLength, stringReplace, stringSplit, stringSubstring, stringTrim, urlBuilder, urlQueryParser, urlValidator, urlValidatorSimple, uuidValidator, webScraper, webSearch, webSearchOutputSchema, webSearchSchema, xmlGenerator, xmlParser, xmlToJson };
+export { type AskHumanInput, AskHumanInputSchema, type AskHumanOutput, type ConfluenceAuth, type ConfluenceToolsConfig, DuckDuckGoProvider, type HttpResponse, type RetryConfig, type ScraperResult, type SearchProvider, type SearchResult, SerperProvider, type SlackToolsConfig, type UrlValidationResult, type WebSearchInput, type WebSearchOutput, archiveConfluencePage, arrayFilter, arrayGroupBy, arrayMap, arraySort, askHumanTool, calculator, confluenceTools, createAskHumanTool, createConfluencePage, createConfluenceTools, createDuckDuckGoProvider, createSerperProvider, createSlackTools, creditCardValidator, csvGenerator, csvParser, csvToJson, currentDateTime, dateArithmetic, dateComparison, dateDifference, dateFormatter, directoryCreate, directoryDelete, directoryList, emailValidator, extractImages, extractLinks, fileAppend, fileDelete, fileExists, fileReader, fileSearch, fileWriter, getConfluencePage, getSlackChannels, getSlackMessages, getSpacePages, htmlParser, httpClient, httpGet, httpPost, ipValidator, jsonMerge, jsonParser, jsonQuery, jsonStringify, jsonToCsv, jsonToXml, jsonValidator, listConfluenceSpaces, mathFunctions, notifySlack, objectOmit, objectPick, pathBasename, pathDirname, pathExtension, pathJoin, pathNormalize, pathParse, pathRelative, pathResolve, phoneValidator, randomNumber, searchConfluence, searchResultSchema, sendSlackMessage, slackTools, statistics, stringCaseConverter, stringJoin, stringLength, stringReplace, stringSplit, stringSubstring, stringTrim, updateConfluencePage, urlBuilder, urlQueryParser, urlValidator, urlValidatorSimple, uuidValidator, webScraper, webSearch, webSearchOutputSchema, webSearchSchema, xmlGenerator, xmlParser, xmlToJson };

package/dist/index.d.ts

@@ -760,6 +760,104 @@ declare const slackTools: (Tool<{
     error?: string;
 }>)[];
 
+/**
+ * Type definitions for Confluence tools
+ */
+
+/**
+ * Configuration options for Confluence tools
+ */
+interface ConfluenceToolsConfig {
+    /**
+     * Atlassian API key
+     * If not provided, will fall back to ATLASSIAN_API_KEY env var
+     */
+    apiKey?: string;
+    /**
+     * Atlassian account email
+     * If not provided, will fall back to ATLASSIAN_EMAIL env var
+     */
+    email?: string;
+    /**
+     * Atlassian site URL (e.g., 'https://your-domain.atlassian.net')
+     * If not provided, will fall back to ATLASSIAN_SITE_URL env var
+     */
+    siteUrl?: string;
+    /**
+     * Custom log level for Confluence tools
+     * @default LogLevel.INFO
+     */
+    logLevel?: LogLevel;
+}
+/**
+ * Confluence authentication credentials
+ */
+interface ConfluenceAuth {
+    ATLASSIAN_API_KEY: string;
+    ATLASSIAN_EMAIL: string;
+    ATLASSIAN_SITE_URL: string;
+}
+
+/**
+ * Default Confluence tools using environment variables
+ */
+declare const searchConfluence: _agentforge_core.Tool<unknown, unknown>;
+declare const getConfluencePage: _agentforge_core.Tool<unknown, unknown>;
+declare const listConfluenceSpaces: _agentforge_core.Tool<unknown, unknown>;
+declare const getSpacePages: _agentforge_core.Tool<unknown, unknown>;
+declare const createConfluencePage: _agentforge_core.Tool<unknown, unknown>;
+declare const updateConfluencePage: _agentforge_core.Tool<unknown, unknown>;
+declare const archiveConfluencePage: _agentforge_core.Tool<unknown, unknown>;
+/**
+ * Export all Confluence tools
+ *
+ * Includes 7 tools for Confluence integration:
+ * - 4 read tools: search, get-page, list-spaces, get-space-pages
+ * - 3 write tools: create-page, update-page, archive-page
+ */
+declare const confluenceTools: _agentforge_core.Tool<unknown, unknown>[];
+/**
+ * Create Confluence tools with custom configuration
+ *
+ * This factory function allows you to create Confluence tools with programmatic configuration
+ * instead of relying solely on environment variables.
+ *
+ * @param config - Optional configuration for Confluence tools
+ * @returns Object containing all 7 Confluence tools configured with the provided settings
+ *
+ * @example
+ * ```ts
+ * // Create tools with custom credentials
+ * const tools = createConfluenceTools({
+ *   apiKey: 'your-api-key',
+ *   email: 'your-email@example.com',
+ *   siteUrl: 'https://your-domain.atlassian.net'
+ * });
+ *
+ * // Use the tools
+ * const result = await tools.searchConfluence.execute({
+ *   query: 'payment processing'
+ * });
+ * ```
+ *
+ * @example
+ * ```ts
+ * // Create tools with custom log level
+ * const tools = createConfluenceTools({
+ *   logLevel: LogLevel.DEBUG
+ * });
+ * ```
+ */
+declare function createConfluenceTools(config?: ConfluenceToolsConfig): {
+    searchConfluence: _agentforge_core.Tool<unknown, unknown>;
+    getConfluencePage: _agentforge_core.Tool<unknown, unknown>;
+    listConfluenceSpaces: _agentforge_core.Tool<unknown, unknown>;
+    getSpacePages: _agentforge_core.Tool<unknown, unknown>;
+    createConfluencePage: _agentforge_core.Tool<unknown, unknown>;
+    updateConfluencePage: _agentforge_core.Tool<unknown, unknown>;
+    archiveConfluencePage: _agentforge_core.Tool<unknown, unknown>;
+};
+
 /**
  * JSON Processor Tool
  *
@@ -1788,4 +1886,4 @@ declare const askHumanTool: _agentforge_core.Tool<{
     suggestions?: string[] | undefined;
 }, AskHumanOutput>;
 
-export { type AskHumanInput, AskHumanInputSchema, type AskHumanOutput, DuckDuckGoProvider, type HttpResponse, type RetryConfig, type ScraperResult, type SearchProvider, type SearchResult, SerperProvider, type SlackToolsConfig, type UrlValidationResult, type WebSearchInput, type WebSearchOutput, arrayFilter, arrayGroupBy, arrayMap, arraySort, askHumanTool, calculator, createAskHumanTool, createDuckDuckGoProvider, createSerperProvider, createSlackTools, creditCardValidator, csvGenerator, csvParser, csvToJson, currentDateTime, dateArithmetic, dateComparison, dateDifference, dateFormatter, directoryCreate, directoryDelete, directoryList, emailValidator, extractImages, extractLinks, fileAppend, fileDelete, fileExists, fileReader, fileSearch, fileWriter, getSlackChannels, getSlackMessages, htmlParser, httpClient, httpGet, httpPost, ipValidator, jsonMerge, jsonParser, jsonQuery, jsonStringify, jsonToCsv, jsonToXml, jsonValidator, mathFunctions, notifySlack, objectOmit, objectPick, pathBasename, pathDirname, pathExtension, pathJoin, pathNormalize, pathParse, pathRelative, pathResolve, phoneValidator, randomNumber, searchResultSchema, sendSlackMessage, slackTools, statistics, stringCaseConverter, stringJoin, stringLength, stringReplace, stringSplit, stringSubstring, stringTrim, urlBuilder, urlQueryParser, urlValidator, urlValidatorSimple, uuidValidator, webScraper, webSearch, webSearchOutputSchema, webSearchSchema, xmlGenerator, xmlParser, xmlToJson };
+export { type AskHumanInput, AskHumanInputSchema, type AskHumanOutput, type ConfluenceAuth, type ConfluenceToolsConfig, DuckDuckGoProvider, type HttpResponse, type RetryConfig, type ScraperResult, type SearchProvider, type SearchResult, SerperProvider, type SlackToolsConfig, type UrlValidationResult, type WebSearchInput, type WebSearchOutput, archiveConfluencePage, arrayFilter, arrayGroupBy, arrayMap, arraySort, askHumanTool, calculator, confluenceTools, createAskHumanTool, createConfluencePage, createConfluenceTools, createDuckDuckGoProvider, createSerperProvider, createSlackTools, creditCardValidator, csvGenerator, csvParser, csvToJson, currentDateTime, dateArithmetic, dateComparison, dateDifference, dateFormatter, directoryCreate, directoryDelete, directoryList, emailValidator, extractImages, extractLinks, fileAppend, fileDelete, fileExists, fileReader, fileSearch, fileWriter, getConfluencePage, getSlackChannels, getSlackMessages, getSpacePages, htmlParser, httpClient, httpGet, httpPost, ipValidator, jsonMerge, jsonParser, jsonQuery, jsonStringify, jsonToCsv, jsonToXml, jsonValidator, listConfluenceSpaces, mathFunctions, notifySlack, objectOmit, objectPick, pathBasename, pathDirname, pathExtension, pathJoin, pathNormalize, pathParse, pathRelative, pathResolve, phoneValidator, randomNumber, searchConfluence, searchResultSchema, sendSlackMessage, slackTools, statistics, stringCaseConverter, stringJoin, stringLength, stringReplace, stringSplit, stringSubstring, stringTrim, updateConfluencePage, urlBuilder, urlQueryParser, urlValidator, urlValidatorSimple, uuidValidator, webScraper, webSearch, webSearchOutputSchema, webSearchSchema, xmlGenerator, xmlParser, xmlToJson };