ineersa/hatfield-extension-api

Public Hatfield extension contracts (Ineersa\Hatfield\ExtensionApi). Host and project extensions depend on this package.

Maintainers

Package info

github.com/ineersa/hatfield-extension-api

pkg:composer/ineersa/hatfield-extension-api

Transparency log

Statistics

Installs: 6

Dependents: 4

Suggesters: 0

Stars: 0

Open Issues: 0

Security

Advisories: 0

Aikido package health analysis

v0.0.11 2026-08-31 21:18 UTC

Requires

MIT 77bdb31ec6f5ba2f310cb4c30681135fc1c0919f

Published on Packagist.org on 2026-08-31 21:18 UTC

This package is auto-updated.

Last update: 2026-08-31 21:18:50 UTC

README

Public Composer contracts for Hatfield project extensions.
Package ineersa/hatfield-extension-api
Namespace Ineersa\Hatfield\ExtensionApi\
PHP >=8.3
Requires symfony/tui: ^8.0

This package is the stable surface extensions depend on. Host Hatfield provides a concrete ExtensionApiInterface implementation at runtime; extensions should depend only on these contracts, not on CodingAgent, AgentCore, the in-repo TUI layer (Ineersa\Tui\*), Symfony DI, Symfony AI, settings internals, tool registry, runtime adapters, or packaging code.

What it provides

  • HatfieldExtensionInterface — startup register(ExtensionApiInterface $api) entry for enabled extensions.
  • ExtensionApiInterface — tools, tool call/result/rewrite hooks, slash commands, settings/cwd access, after-turn-commit hooks, before-compaction hooks, exec, session event reading, extension-agent jobs, and related DTOs under Agent\, Approval\, Command\, Compaction\, Exec\, Lifecycle\, Prompt\, Session\, Tool\.
  • Tui\TuiExtensionInterface / Tui\TuiProjectExtensionInterface and Tui\TuiExtensionContextInterface — generic TUI extension registration and overlay/slot APIs.

Approved Symfony TUI dependency: generic TUI contracts intentionally depend on Symfony TUI public widget types (Symfony\Component\Tui\Widget\AbstractWidget, events, input) so extensions can mount their own overlays without Hatfield adding feature-shaped runtime ports. That is part of the public UI extension API — not a leak of Hatfield internals.

Feature-specific UX (for example file rewind) stays in .hatfield/extensions/<name>/ and must not add feature-shaped types to this package.

Install

After a Hatfield v* release (and optionally Packagist):

{
  "require": {
    "ineersa/hatfield-extension-api": "^X.Y"
  },
  "repositories": [
    { "type": "vcs", "url": "https://github.com/ineersa/hatfield-extension-api" }
  ]
}

Prefer released tags. In the Hatfield monorepo, root and .hatfield/extensions Composer roots path-require this package from .hatfield/extensions/extension-api.

Source of truth

ineersa/agent-core is the authoritative monorepo. This GitHub repository is a read-only release mirror: each Hatfield vX.Y.Z tag updates main and publishes the same tag here. Do not open feature PRs against the mirror.

See monorepo docs: