Skip to content

Conversation

@igor0
Copy link
Contributor

@igor0 igor0 commented Dec 15, 2025

An open-source library built on the Context Engine SDK that makes diverse sources searchable across agents and apps

Context Connectors enables users to:

  • Build indexes from Git repos (GitHub, GitLab, BitBucket), documentation websites, or local filesystem: index code, documentation, runbooks, schemas, configs, and more. Use DirectContext in the Context Engine SDK for custom sources.
  • Store indexes on a local filesystem for fast & simple access, or in S3 for persistent storage in production apps.
  • Search indexes via interactive agent, MCP for AI integrations, CLI for quick searches, or DirectContext in the Context Engine SDK for custom implementations.

igor0 added 22 commits December 15, 2025 06:19
Switch from openai() to openai.chat() to use the Chat Completions API
instead of the Responses API. The Responses API is stateful and generates
server-side IDs (fc_...) for function calls that are not persisted for
Zero Data Retention (ZDR) organizations, causing multi-step tool calls
to fail.

The Chat Completions API is stateless and works correctly with ZDR.
- OpenAI: gpt-5.2 → gpt-5-mini
- Anthropic: claude-sonnet-4-5 → claude-haiku-4-5
- Google: gemini-3-pro → gemini-3-flash-preview

Also adds Phase 10 test results documenting:
- ZDR compatibility fix (openai.chat vs openai)
- Model availability testing
- Multi-provider verification
- Add ./clients export path to package.json for programmatic API access
- Export createMCPServer, runMCPServer, MCPServerConfig from clients module
- Document Phase 11 programmatic API test results in test-results.md
Flip the default behavior: file tools (listFiles, readFile) are now
enabled by default. Use --search-only to disable them.

This is more intuitive - users get full functionality by default and
explicitly opt out when they only want the search tool.

- cmd-mcp: --search-only disables list_files/read_file tools
- cmd-agent: --search-only disables listFiles/readFile tools
- cmd-search: --search-only disables file access
…ansport

- Add mcp-http-server.ts with runMCPHttpServer() and createMCPHttpServer()
- Add mcp-serve CLI command with --port, --host, --cors, --base-path, --api-key options
- Support API key authentication via Authorization: Bearer header
- Support CORS for browser-based clients
- Update README with HTTP server documentation and examples
Updated tool descriptions for search, list_files, and read_file to be more
detailed and informative, adapting from Auggie CLI while keeping content
appropriate for context-connectors:

- Added multi-line descriptions with features and usage notes
- Included condensed regex syntax guide for searchPattern
- Clarified parameter semantics (1-based, inclusive, relative paths)
- Removed coding-specific language to support general use cases

Files modified:
- src/clients/mcp-server.ts
- src/clients/cli-agent.ts
…-specific store paths

- Rename -k, --key flag to -n, --name across all CLI commands
- Change default store location from CWD-relative .context-connectors to:
  - Linux: ~/.local/share/context-connectors (XDG Base Directory spec)
  - macOS: ~/Library/Application Support/context-connectors
  - Windows: %LOCALAPPDATA%\context-connectors
- Add CONTEXT_CONNECTORS_STORE_PATH environment variable override
- Priority order: --store-path CLI option > env var > platform default
- Update README.md with new flag, Data Storage section, and env var docs
Replace importFromFile with temp file pattern with direct import() call.
This is platform-neutral and avoids unnecessary filesystem operations.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants