Skip to content

Add Core Agent and Model Interfaces#22100

Draft
dewitt wants to merge 1 commit intogoogle-gemini:mainfrom
dewitt:dewitt/issue-20995-2-core-interfaces
Draft

Add Core Agent and Model Interfaces#22100
dewitt wants to merge 1 commit intogoogle-gemini:mainfrom
dewitt:dewitt/issue-20995-2-core-interfaces

Conversation

@dewitt
Copy link
Copy Markdown
Collaborator

@dewitt dewitt commented Mar 11, 2026

Summary

Introduces the foundational TypeScript interfaces for the modular agent architecture. These interfaces (Agent, Model, AgentEvent) establish stable contracts without altering any existing runtime behavior.

Details

This is Part 2 of 4 PRs toward #20995.

This PR adds pure interface definitions and associated verification tests. It allows the core engine to transition toward a plug-and-play architecture where components interact through these defined boundaries rather than relying on concrete implementations.

Related Issues

Part 2 of 4 PRs toward #20995

How to Validate

Review the TypeScript definitions in packages/core/src/interfaces/ and confirm that they represent the correct boundaries for our architectural shift.

Pre-Merge Checklist

  • Updated relevant documentation and README (if needed)
  • Added/updated tests (if needed)
  • Noted breaking changes (if any)
  • Validated on required platforms/methods:
    • MacOS
      • npm run
      • npx
      • Docker
      • Podman
      • Seatbelt
    • Windows
      • npm run
      • npx
      • Docker
    • Linux
      • npm run
      • npx
      • Docker

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area/agent Issues related to Core Agent, Tools, Memory, Sub-Agents, Hooks, Agent Quality 🔒 maintainer only ⛔ Do not contribute. Internal roadmap item.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant