Skip to content

research(eve): programmatic sources - unify framework registration - #2404

Open
AndrewBarba wants to merge 2 commits into
mainfrom
barba/programmatic-agent-sources
Open

research(eve): programmatic sources - unify framework registration#2404
AndrewBarba wants to merge 2 commits into
mainfrom
barba/programmatic-agent-sources

Conversation

@AndrewBarba

@AndrewBarba AndrewBarba commented Aug 21, 2026

Copy link
Copy Markdown
Collaborator

Summary

Related to #2347. Framework defaults and extension contributions currently bypass eve's filesystem compiler through separate loading, merge, routing, sandbox, and inspection paths. This proposal replaces them with one effective source graph: framework modules, extension packages and overrides, and application files compete for canonical path-derived slots before the ordinary compiler loads or normalizes a winner.

The plan makes physical backing required per compiled node, projects extension sources into final logical paths, and makes runtime, Nitro, bundling, and inspection consume the same manifest. It migrates ordinary tools, connection_search, the default sandbox, and framework channels; confines genuinely native behavior to a closed kernel inventory; replaces agent-info v2 with a truthful v3; and makes deletion of the old catalogs, merge paths, fallbacks, and duplicate projectors an acceptance gate. Memory integration remains an explicit later lifecycle proof and is not claimed by this research PR.

Review should focus on the required binding table, choose-before-normalize precedence, extension path projection, the closed kernel boundary, and whether the deletion ledger leaves any parallel source of truth.

Validation

Cross-checked the proposal against current compiler loading and module maps, extension composition, dynamic-tool durability, framework graph and Nitro routing, sandbox fallback, adapter rehydration, and both agent-info builders. pnpm guard:invariants passes; runtime tests are not applicable to this research-only change.

Checklist

  • This change was requested or approved by a maintainer
  • I ran the relevant checks from CONTRIBUTING.md
  • I added tests and documentation where relevant
  • I added a changeset if this touches the published eve package
  • DCO sign-off passes for every commit (git commit --signoff)

Changeset not applicable: this PR does not modify the published eve package.

Diff size

Docs — 1 file · +595 / -0

The research plan now specifies the source model, composition semantics, framework migrations, native boundary, deletion gates, and validation required for a cross-cutting compiler/runtime refactor.

Implementation — 0 files · +0 / -0

Not applicable.

Tests — 0 files · +0 / -0

Not applicable for a research-only change.

@vercel

vercel Bot commented Aug 21, 2026

Copy link
Copy Markdown
Contributor

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
eve-docs Ready Ready Preview, v0 Aug 22, 2026 2:25pm
eve-docs-4759 Error Error v0 Aug 22, 2026 2:25pm
eve-pkg Ready Ready Preview, v0 Aug 22, 2026 2:25pm

@AndrewBarba
AndrewBarba marked this pull request as ready for review August 22, 2026 04:26
Signed-off-by: Andrew Barba <barba@hey.com>
Signed-off-by: Andrew Barba <barba@hey.com>
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