@hubblecommerce/overmind-core

Shared infrastructure package for the Overmind AI agent system. Contains all foundational code used across the agent server and webhook worker — API clients, vectorstore, embeddings, LLM providers, document processors, repomix utilities, and reusable LangChain tools.

Contents

| Module | Import path | Description | |---|---|---| | Config | @hubblecommerce/overmind-core/config | Centralized app configuration from env vars | | Confluence client | @hubblecommerce/overmind-core/integrations/confluence | Confluence REST API client — getSpaces, getSpacePages, getPageById, getPageContent, getPageLabels, searchPages (CQL v1), createPageWithADF | | Jira client | @hubblecommerce/overmind-core/integrations/jira | Jira REST API v3 client — searchProjects, getProjectDetails (incl. lead), searchIssues (JQL), countIssues, getIssue | | GitLab client | @hubblecommerce/overmind-core/integrations/gitlab | GitLab API client (gitbeaker) + getLatestCommitSha, downloadArchive | | Vectorstore | @hubblecommerce/overmind-core/vectorstore | pgvector provider + interface | | Embeddings | @hubblecommerce/overmind-core/embeddings | Hugging Face Transformers provider + interface | | LLM | @hubblecommerce/overmind-core/llm | Anthropic/Claude provider | | LLM retry | @hubblecommerce/overmind-core/llm/retry | 429 rate limit retry wrapper | | Processors | @hubblecommerce/overmind-core/processors | Confluence HTML parser + document processor | | Repomix search | @hubblecommerce/overmind-core/utils/repomix-search | Search, file extraction, directory structure from repomix XML | | Knowledgebase search tool | @hubblecommerce/overmind-core/tools/knowledgebase-search | LangChain tool for semantic knowledge base search | | Confluence tools | @hubblecommerce/overmind-core/tools/confluence | LangChain tools: createSearchConfluenceTool (CQL), createGetConfluencePageTool | | Jira tools | @hubblecommerce/overmind-core/tools/jira | LangChain tools: createSearchJiraProjectsTool, createGetJiraProjectDetailsTool, createSearchJiraIssuesTool, createGetJiraIssueTool | | GitLab tools | @hubblecommerce/overmind-core/tools/gitlab | LangChain tools for GitLab group/project discovery and metadata | | Repository tools | @hubblecommerce/overmind-core/tools/repository | LangChain tools for GitLab code search, file retrieval, directory structure | | Repository types | @hubblecommerce/overmind-core/types/repository | Shared response types for repository endpoints | | Date tool | @hubblecommerce/overmind-core/tools/get-current-date | LangChain tool returning current date |

Usage

import { config } from '@hubblecommerce/overmind-core/config';
import { ConfluenceClient } from '@hubblecommerce/overmind-core/integrations/confluence';
import { JiraClient } from '@hubblecommerce/overmind-core/integrations/jira';
import { createPostgresVectorStore } from '@hubblecommerce/overmind-core/vectorstore';
import { createKnowledgebaseSearchTool } from '@hubblecommerce/overmind-core/tools/knowledgebase-search';
import { createSearchConfluenceTool, createGetConfluencePageTool } from '@hubblecommerce/overmind-core/tools/confluence';
import { createSearchJiraProjectsTool, createGetJiraProjectDetailsTool, createSearchJiraIssuesTool, createGetJiraIssueTool } from '@hubblecommerce/overmind-core/tools/jira';
import { getGitlabClient, getLatestCommitSha } from '@hubblecommerce/overmind-core/integrations/gitlab';
import { searchRepomix, getRepomixFile } from '@hubblecommerce/overmind-core/utils/repomix-search';
import { createSearchRepositoryTool } from '@hubblecommerce/overmind-core/tools/repository';

Requirements

• Node.js 20+
• PostgreSQL 15+ with pgvector and uuid-ossp extensions enabled
• ANTHROPIC_API_KEY env var set

Publishing

npm publish --access restricted