feat(eve): add Eve agent-framework MCP connection helper#2280
Open
benfrank241 wants to merge 2 commits into
Open
feat(eve): add Eve agent-framework MCP connection helper#2280benfrank241 wants to merge 2 commits into
benfrank241 wants to merge 2 commits into
Conversation
Add @vectorize-io/hindsight-eve: a thin helper that wraps Eve's defineMcpClientConnection to wire an Eve agent into a Hindsight MCP server in one line, pre-filling the endpoint, model-facing description, and bearer auth with env-var defaults (HINDSIGHT_MCP_URL, HINDSIGHT_API_KEY, HINDSIGHT_MCP_BANK_ID). Mirrors the ai-sdk integration: vitest + tsup, own package-lock.json, test-eve-integration CI job (Node 24), release + changelog registration, docs gallery entry and page. In-repo backup for vercel/eve#55 (preferred upstream home is Eve's own connection catalog).
benfrank241
force-pushed
the
feat/eve-integration
branch
from
37f8bab to
6301025
Compare
- Reword DEFAULT_DESCRIPTION JSDoc: it's surfaced when the agent discovers
this connection's tools (connection__hindsight__{retain,recall,reflect}),
not via connection__search (stale copy-paste).
- Add approval-passthrough tests (and a no-approval case) alongside the
existing tools-passthrough coverage.
- Match the Hindsight Cloud auth guard on host instead of exact URL, so a
trailing slash or regional subdomain still raises the friendly missing-key
error; add tests including a look-alike-host negative case.
- Note in code that the { token } auth shape rides on eve 0.11's contract.
- Replace the placeholder eve.svg wordmark with Eve's actual triangle mark.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
Adds a first-party Eve integration:
@vectorize-io/hindsight-eve, a thin helper that wraps Eve'sdefineMcpClientConnectionso an Eve agent gains Hindsight long-term memory by dropping one file underagent/connections/:The helper pre-fills Hindsight's MCP endpoint, a model-facing description, and bearer auth, with env-var defaults (
HINDSIGHT_MCP_URL,HINDSIGHT_API_KEY,HINDSIGHT_MCP_BANK_ID). Supports tool filters and human-in-the-loop approval passthrough. The model seesconnection__hindsight__{recall,retain,reflect}; URL/token never reach it.Why a draft / backup
The preferred home for this is Eve's own connection catalog — proposed upstream in vercel/eve#55. That hinges on a maintainer decision about non-Connect (bearer) auth. This in-repo integration ships value to Hindsight users regardless of that outcome, and remains a convenience wrapper even if the catalog entry lands. Keeping it draft until the upstream direction is settled.
Shape
Mirrors the
ai-sdkintegration exactly:src/index.ts— pureresolveHindsightConnection(env/option precedence + Cloud-needs-key validation) +buildHindsightConnectionDefinition+defineHindsightConnection.evesmoke test) + tsup build, ownpackage-lock.json.test-eve-integrationCI job (Node 24, per Eve's engine requirement) wired intoreport-pr-status.release-integration.shandgenerate_changelog.py.docs-integrations/eve.md(passescheck-integrations.mjs).Checks
npm test/npm run build,check-integrations.mjs,check-integration-lockfiles.sh, andlint.shall green locally.Follow-up
static/img/icons/eve.svgis a placeholder wordmark — swap for the official Eve mark before release.