Interface: ContributionManifest

Makaio Framework

---

Makaio Framework / contracts/extension / ContributionManifest

Interface: ContributionManifest

Defined in: ../../../packages/contracts/src/extension/contribution-manifest.ts:471

Top-level container for all contributions an extension declares.

Added as an optional field on ExtensionManifest. Extensions that do not need discovery-time contribution metadata may omit this field entirely. This manifest is intentionally not a runtime wiring surface; it mirrors the executable contribution fields only for pre-load introspection.

Rich metadata fields (adapters, clients, providers, triggers, logImporters, sessionEventActions) carry structured data for discovery and filtering. Boolean surface flags (create, tools, bootstrap, etc.) declare which executable surfaces the extension contributes without duplicating runtime detail.

Examples

{
  "contributions": {
    "adapters": [
      {
        "name": "claude-code",
        "protocols": ["anthropic"],
        "clients": [{ "id": "claude-code", "version": "^1.5.0" }]
      }
    ],
    "clients": [
      { "id": "claude-code", "name": "Claude Code", "binaryName": "claude" }
    ]
  }
}

{
  "contributions": {
    "triggers": [
      { "prefix": "loop", "description": "Retry-until-success execution", "stage": "action" }
    ],
    "create": true,
    "tools": true,
    "configSchema": true,
    "ui": { "widgets": true }
  }
}

Properties

adapters?

readonly optional adapters?: readonly AdapterManifest[]

Defined in: ../../../packages/contracts/src/extension/contribution-manifest.ts:473

Adapter contributions declared by this extension.

---

bootstrap?

readonly optional bootstrap?: boolean

Defined in: ../../../packages/contracts/src/extension/contribution-manifest.ts:492

Extension contributes bootstrap import/export (MakaioExtension.bootstrap).

---

clients?

readonly optional clients?: readonly ClientManifest[]

Defined in: ../../../packages/contracts/src/extension/contribution-manifest.ts:475

Client binary contributions declared by this extension.

---

configSchema?

readonly optional configSchema?: boolean

Defined in: ../../../packages/contracts/src/extension/contribution-manifest.ts:496

Extension declares a config schema (MakaioExtension.configSchema).

---

create?

readonly optional create?: boolean

Defined in: ../../../packages/contracts/src/extension/contribution-manifest.ts:488

Extension provides a service factory (MakaioExtension.create).

---

logImporters?

readonly optional logImporters?: readonly LogImporterManifest[]

Defined in: ../../../packages/contracts/src/extension/contribution-manifest.ts:481

Log importer contribution declared by this extension.

---

namespace?

readonly optional namespace?: boolean

Defined in: ../../../packages/contracts/src/extension/contribution-manifest.ts:494

Extension declares a bus namespace (MakaioExtension.”namespace”).

---

providers?

readonly optional providers?: readonly ProviderManifest[]

Defined in: ../../../packages/contracts/src/extension/contribution-manifest.ts:477

Provider contributions declared by this extension.

---

sessionEventActions?

readonly optional sessionEventActions?: readonly SessionEventActionManifest[]

Defined in: ../../../packages/contracts/src/extension/contribution-manifest.ts:483

Session event action contributions declared by this extension.

---

tools?

readonly optional tools?: boolean

Defined in: ../../../packages/contracts/src/extension/contribution-manifest.ts:490

Extension contributes one or more toolsets (MakaioExtension.tools).

---

triggers?

readonly optional triggers?: readonly TriggerManifest[]

Defined in: ../../../packages/contracts/src/extension/contribution-manifest.ts:479

Hash trigger contributions declared by this extension.

---

ui?

readonly optional ui?: UiSurfaceFlags

Defined in: ../../../packages/contracts/src/extension/contribution-manifest.ts:500

Browser UI surface flags (MakaioExtension.ui).

---

uiConfig?

readonly optional uiConfig?: boolean

Defined in: ../../../packages/contracts/src/extension/contribution-manifest.ts:498

Extension declares UI config overrides (MakaioExtension.uiConfig).