feat: add canonical integration catalog
This commit is contained in:
ZacharyZhang-NY committed
1 parent
34300ba38f
commit
91469a525a
6 files changed
+886
No files matched your search
@@ -7,6 +7,16 @@ on:
|
|||||||
branches: [main]
|
branches: [main]
|
||||||
|
|
||||||
jobs:
|
jobs:
|
||||||
|
integration-catalog:
|
||||||
|
name: Validate Integration Catalog
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
steps:
|
||||||
|
- uses: actions/checkout@v4
|
||||||
|
- uses: actions/setup-node@v4
|
||||||
|
with:
|
||||||
|
node-version: '20'
|
||||||
|
- run: npm run validate:integrations
|
||||||
|
|
||||||
typecheck-server:
|
typecheck-server:
|
||||||
name: Typecheck Server
|
name: Typecheck Server
|
||||||
runs-on: ubuntu-latest
|
runs-on: ubuntu-latest
|
||||||
|
|||||||
@@ -0,0 +1,20 @@
|
|||||||
|
# Integration Catalog
|
||||||
|
|
||||||
|
[`catalog.json`](catalog.json) is the canonical inventory for agent integration IDs, official hook contracts, blocking behavior, and SDK delivery state. Backend validation, Console controls, Docs, and SDK registries derive their integration facts from this catalog.
|
||||||
|
|
||||||
|
`delivery_state` is computed from the `node`, `python`, and `go` adapter flags:
|
||||||
|
|
||||||
|
| State | Meaning |
|
||||||
|
| --- | --- |
|
||||||
|
| `available` | All three SDK adapters exist |
|
||||||
|
| `partial` | One or two SDK adapters exist |
|
||||||
|
| `planned` | The provider contract is researched and adapter delivery is pending |
|
||||||
|
|
||||||
|
Update workflow:
|
||||||
|
|
||||||
|
1. Verify the provider contract against its official `source_url`.
|
||||||
|
2. Update `verified_on`, hook fields, blocking semantics, and adapter flags.
|
||||||
|
3. Run `npm run validate:integrations` from the repository root.
|
||||||
|
4. Synchronize generated consumers in Backend, Console, Docs, and standalone SDK repositories.
|
||||||
|
|
||||||
|
[`catalog.schema.json`](catalog.schema.json) freezes the machine-readable contract. [`integration-catalog.test.mjs`](../test/integration-catalog.test.mjs) enforces provider completeness, stable IDs, event fields, delivery-state derivation, and schema enums in CI.
|
||||||
@@ -0,0 +1,482 @@
|
|||||||
|
{
|
||||||
|
"$schema": "./catalog.schema.json",
|
||||||
|
"schema_version": 1,
|
||||||
|
"verified_on": "2026-07-19",
|
||||||
|
"providers": [
|
||||||
|
{
|
||||||
|
"id": "augment",
|
||||||
|
"name": "Augment Code CLI",
|
||||||
|
"vendor": "Augment Code",
|
||||||
|
"surface": "cli",
|
||||||
|
"integration_mode": "command_hooks",
|
||||||
|
"config_format": "json",
|
||||||
|
"config_paths": [
|
||||||
|
"~/.augment/settings.json",
|
||||||
|
".augment/settings.json",
|
||||||
|
".augment/settings.local.json"
|
||||||
|
],
|
||||||
|
"events": {
|
||||||
|
"before_tool": "PreToolUse",
|
||||||
|
"after_tool": "PostToolUse"
|
||||||
|
},
|
||||||
|
"event_fields": {
|
||||||
|
"name": "tool_name",
|
||||||
|
"input": "tool_input",
|
||||||
|
"session": "conversation_id"
|
||||||
|
},
|
||||||
|
"blocking": {
|
||||||
|
"mechanism": "exit_code_2",
|
||||||
|
"failure_mode": "fail_open"
|
||||||
|
},
|
||||||
|
"adapters": {
|
||||||
|
"node": false,
|
||||||
|
"python": false,
|
||||||
|
"go": false
|
||||||
|
},
|
||||||
|
"delivery_state": "planned",
|
||||||
|
"source_url": "https://docs.augmentcode.com/cli/hooks"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"id": "claudecode",
|
||||||
|
"name": "Claude Code",
|
||||||
|
"vendor": "Anthropic",
|
||||||
|
"surface": "cli",
|
||||||
|
"integration_mode": "command_hooks",
|
||||||
|
"config_format": "json",
|
||||||
|
"config_paths": [
|
||||||
|
"~/.claude/settings.json",
|
||||||
|
".claude/settings.json",
|
||||||
|
".claude/settings.local.json"
|
||||||
|
],
|
||||||
|
"events": {
|
||||||
|
"before_tool": "PreToolUse",
|
||||||
|
"after_tool": "PostToolUse"
|
||||||
|
},
|
||||||
|
"event_fields": {
|
||||||
|
"name": "tool_name",
|
||||||
|
"input": "tool_input",
|
||||||
|
"session": "session_id"
|
||||||
|
},
|
||||||
|
"blocking": {
|
||||||
|
"mechanism": "exit_code_2",
|
||||||
|
"failure_mode": "fail_open"
|
||||||
|
},
|
||||||
|
"adapters": {
|
||||||
|
"node": true,
|
||||||
|
"python": true,
|
||||||
|
"go": true
|
||||||
|
},
|
||||||
|
"delivery_state": "available",
|
||||||
|
"source_url": "https://code.claude.com/docs/en/hooks"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"id": "cline",
|
||||||
|
"name": "Cline",
|
||||||
|
"vendor": "Cline",
|
||||||
|
"surface": "cli_and_ide",
|
||||||
|
"integration_mode": "plugin_api",
|
||||||
|
"config_format": "plugin",
|
||||||
|
"config_paths": [],
|
||||||
|
"events": {
|
||||||
|
"before_tool": "beforeTool",
|
||||||
|
"after_tool": "afterTool"
|
||||||
|
},
|
||||||
|
"blocking": {
|
||||||
|
"mechanism": "hook_policy",
|
||||||
|
"failure_mode": "configurable"
|
||||||
|
},
|
||||||
|
"adapters": {
|
||||||
|
"node": false,
|
||||||
|
"python": false,
|
||||||
|
"go": false
|
||||||
|
},
|
||||||
|
"delivery_state": "planned",
|
||||||
|
"source_url": "https://docs.cline.bot/sdk/plugins"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"id": "codex",
|
||||||
|
"name": "OpenAI Codex",
|
||||||
|
"vendor": "OpenAI",
|
||||||
|
"surface": "cli",
|
||||||
|
"integration_mode": "command_hooks",
|
||||||
|
"config_format": "json",
|
||||||
|
"config_paths": [
|
||||||
|
"~/.codex/hooks.json",
|
||||||
|
".codex/hooks.json"
|
||||||
|
],
|
||||||
|
"events": {
|
||||||
|
"before_tool": "PreToolUse",
|
||||||
|
"after_tool": "PostToolUse"
|
||||||
|
},
|
||||||
|
"event_fields": {
|
||||||
|
"name": "tool_name",
|
||||||
|
"input": "tool_input",
|
||||||
|
"session": "session_id"
|
||||||
|
},
|
||||||
|
"blocking": {
|
||||||
|
"mechanism": "exit_code_2",
|
||||||
|
"failure_mode": "fail_open"
|
||||||
|
},
|
||||||
|
"adapters": {
|
||||||
|
"node": true,
|
||||||
|
"python": false,
|
||||||
|
"go": false
|
||||||
|
},
|
||||||
|
"delivery_state": "partial",
|
||||||
|
"source_url": "https://learn.chatgpt.com/docs/hooks"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"id": "copilot",
|
||||||
|
"name": "GitHub Copilot",
|
||||||
|
"vendor": "GitHub",
|
||||||
|
"surface": "cli",
|
||||||
|
"integration_mode": "command_hooks",
|
||||||
|
"config_format": "json",
|
||||||
|
"config_paths": [
|
||||||
|
"~/.copilot/hooks/*.json",
|
||||||
|
".github/hooks/*.json"
|
||||||
|
],
|
||||||
|
"events": {
|
||||||
|
"before_tool": "preToolUse",
|
||||||
|
"after_tool": "postToolUse"
|
||||||
|
},
|
||||||
|
"blocking": {
|
||||||
|
"mechanism": "exit_code_2",
|
||||||
|
"failure_mode": "fail_open"
|
||||||
|
},
|
||||||
|
"adapters": {
|
||||||
|
"node": true,
|
||||||
|
"python": true,
|
||||||
|
"go": true
|
||||||
|
},
|
||||||
|
"delivery_state": "available",
|
||||||
|
"source_url": "https://docs.github.com/en/copilot/reference/hooks-reference"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"id": "cursor",
|
||||||
|
"name": "Cursor",
|
||||||
|
"vendor": "Anysphere",
|
||||||
|
"surface": "ide",
|
||||||
|
"integration_mode": "command_hooks",
|
||||||
|
"config_format": "json",
|
||||||
|
"config_paths": [
|
||||||
|
"~/.cursor/hooks.json",
|
||||||
|
".cursor/hooks.json"
|
||||||
|
],
|
||||||
|
"events": {
|
||||||
|
"before_tool": "preToolUse",
|
||||||
|
"after_tool": "postToolUse"
|
||||||
|
},
|
||||||
|
"blocking": {
|
||||||
|
"mechanism": "exit_code_2",
|
||||||
|
"failure_mode": "fail_open"
|
||||||
|
},
|
||||||
|
"adapters": {
|
||||||
|
"node": true,
|
||||||
|
"python": true,
|
||||||
|
"go": true
|
||||||
|
},
|
||||||
|
"delivery_state": "available",
|
||||||
|
"source_url": "https://cursor.com/docs/hooks"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"id": "droid",
|
||||||
|
"name": "Factory Droid",
|
||||||
|
"vendor": "Factory",
|
||||||
|
"surface": "cli",
|
||||||
|
"integration_mode": "command_hooks",
|
||||||
|
"config_format": "json",
|
||||||
|
"config_paths": [
|
||||||
|
"~/.factory/hooks.json",
|
||||||
|
".factory/hooks.json"
|
||||||
|
],
|
||||||
|
"events": {
|
||||||
|
"before_tool": "PreToolUse",
|
||||||
|
"after_tool": "PostToolUse"
|
||||||
|
},
|
||||||
|
"event_fields": {
|
||||||
|
"name": "tool_name",
|
||||||
|
"input": "tool_input",
|
||||||
|
"session": "session_id"
|
||||||
|
},
|
||||||
|
"blocking": {
|
||||||
|
"mechanism": "exit_code_2",
|
||||||
|
"failure_mode": "fail_open"
|
||||||
|
},
|
||||||
|
"adapters": {
|
||||||
|
"node": false,
|
||||||
|
"python": false,
|
||||||
|
"go": false
|
||||||
|
},
|
||||||
|
"delivery_state": "planned",
|
||||||
|
"source_url": "https://docs.factory.ai/reference/hooks-reference"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"id": "gemini",
|
||||||
|
"name": "Gemini CLI",
|
||||||
|
"vendor": "Google",
|
||||||
|
"surface": "cli",
|
||||||
|
"integration_mode": "command_hooks",
|
||||||
|
"config_format": "json",
|
||||||
|
"config_paths": [
|
||||||
|
"~/.gemini/settings.json",
|
||||||
|
".gemini/settings.json"
|
||||||
|
],
|
||||||
|
"events": {
|
||||||
|
"before_tool": "BeforeTool",
|
||||||
|
"after_tool": "AfterTool"
|
||||||
|
},
|
||||||
|
"event_fields": {
|
||||||
|
"name": "tool_name",
|
||||||
|
"input": "tool_input",
|
||||||
|
"session": "session_id"
|
||||||
|
},
|
||||||
|
"blocking": {
|
||||||
|
"mechanism": "exit_code_2",
|
||||||
|
"failure_mode": "fail_open"
|
||||||
|
},
|
||||||
|
"adapters": {
|
||||||
|
"node": true,
|
||||||
|
"python": true,
|
||||||
|
"go": true
|
||||||
|
},
|
||||||
|
"delivery_state": "available",
|
||||||
|
"source_url": "https://geminicli.com/docs/hooks/reference/"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"id": "grok",
|
||||||
|
"name": "Grok Build",
|
||||||
|
"vendor": "xAI",
|
||||||
|
"surface": "cli",
|
||||||
|
"integration_mode": "command_hooks",
|
||||||
|
"config_format": "json",
|
||||||
|
"config_paths": [
|
||||||
|
"~/.grok/hooks/*.json",
|
||||||
|
".grok/hooks/*.json"
|
||||||
|
],
|
||||||
|
"events": {
|
||||||
|
"before_tool": "PreToolUse",
|
||||||
|
"after_tool": "PostToolUse"
|
||||||
|
},
|
||||||
|
"event_fields": {
|
||||||
|
"name": "toolName",
|
||||||
|
"input": "toolInput",
|
||||||
|
"session": "sessionId"
|
||||||
|
},
|
||||||
|
"blocking": {
|
||||||
|
"mechanism": "exit_code_2",
|
||||||
|
"failure_mode": "fail_open"
|
||||||
|
},
|
||||||
|
"adapters": {
|
||||||
|
"node": false,
|
||||||
|
"python": false,
|
||||||
|
"go": false
|
||||||
|
},
|
||||||
|
"delivery_state": "planned",
|
||||||
|
"source_url": "https://docs.x.ai/build/features/hooks"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"id": "kimi",
|
||||||
|
"name": "Kimi Code",
|
||||||
|
"vendor": "Moonshot AI",
|
||||||
|
"surface": "cli",
|
||||||
|
"integration_mode": "command_hooks",
|
||||||
|
"config_format": "toml",
|
||||||
|
"config_paths": [
|
||||||
|
"~/.kimi-code/config.toml"
|
||||||
|
],
|
||||||
|
"events": {
|
||||||
|
"before_tool": "PreToolUse",
|
||||||
|
"after_tool": "PostToolUse"
|
||||||
|
},
|
||||||
|
"event_fields": {
|
||||||
|
"name": "tool_name",
|
||||||
|
"input": "tool_input",
|
||||||
|
"session": "session_id"
|
||||||
|
},
|
||||||
|
"blocking": {
|
||||||
|
"mechanism": "exit_code_2",
|
||||||
|
"failure_mode": "fail_open"
|
||||||
|
},
|
||||||
|
"adapters": {
|
||||||
|
"node": false,
|
||||||
|
"python": false,
|
||||||
|
"go": false
|
||||||
|
},
|
||||||
|
"delivery_state": "planned",
|
||||||
|
"source_url": "https://moonshotai.github.io/kimi-code/en/customization/hooks"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"id": "kirocli",
|
||||||
|
"name": "Kiro CLI",
|
||||||
|
"vendor": "AWS",
|
||||||
|
"surface": "cli",
|
||||||
|
"integration_mode": "command_hooks",
|
||||||
|
"config_format": "json",
|
||||||
|
"config_paths": [
|
||||||
|
"~/.kiro/agents/*.json",
|
||||||
|
".kiro/agents/*.json"
|
||||||
|
],
|
||||||
|
"events": {
|
||||||
|
"before_tool": "preToolUse",
|
||||||
|
"after_tool": "postToolUse"
|
||||||
|
},
|
||||||
|
"event_fields": {
|
||||||
|
"name": "tool_name",
|
||||||
|
"input": "tool_input",
|
||||||
|
"session": "session_id"
|
||||||
|
},
|
||||||
|
"blocking": {
|
||||||
|
"mechanism": "exit_code_2",
|
||||||
|
"failure_mode": "fail_open"
|
||||||
|
},
|
||||||
|
"adapters": {
|
||||||
|
"node": true,
|
||||||
|
"python": true,
|
||||||
|
"go": true
|
||||||
|
},
|
||||||
|
"delivery_state": "available",
|
||||||
|
"source_url": "https://kiro.dev/docs/cli/hooks/"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"id": "kiroide",
|
||||||
|
"name": "Kiro IDE",
|
||||||
|
"vendor": "AWS",
|
||||||
|
"surface": "ide",
|
||||||
|
"integration_mode": "command_hooks",
|
||||||
|
"config_format": "json",
|
||||||
|
"config_paths": [
|
||||||
|
".kiro/hooks/*.json"
|
||||||
|
],
|
||||||
|
"events": {
|
||||||
|
"before_tool": "PreToolUse",
|
||||||
|
"after_tool": "PostToolUse"
|
||||||
|
},
|
||||||
|
"blocking": {
|
||||||
|
"mechanism": "exit_code_2",
|
||||||
|
"failure_mode": "fail_open"
|
||||||
|
},
|
||||||
|
"adapters": {
|
||||||
|
"node": true,
|
||||||
|
"python": true,
|
||||||
|
"go": true
|
||||||
|
},
|
||||||
|
"delivery_state": "available",
|
||||||
|
"source_url": "https://kiro.dev/docs/hooks/"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"id": "letta",
|
||||||
|
"name": "Letta Code",
|
||||||
|
"vendor": "Letta",
|
||||||
|
"surface": "cli",
|
||||||
|
"integration_mode": "command_hooks",
|
||||||
|
"config_format": "json",
|
||||||
|
"config_paths": [
|
||||||
|
"~/.letta/settings.json",
|
||||||
|
".letta/settings.json",
|
||||||
|
".letta/settings.local.json"
|
||||||
|
],
|
||||||
|
"events": {
|
||||||
|
"before_tool": "PreToolUse",
|
||||||
|
"after_tool": "PostToolUse"
|
||||||
|
},
|
||||||
|
"blocking": {
|
||||||
|
"mechanism": "exit_code_2",
|
||||||
|
"failure_mode": "fail_open"
|
||||||
|
},
|
||||||
|
"adapters": {
|
||||||
|
"node": true,
|
||||||
|
"python": true,
|
||||||
|
"go": true
|
||||||
|
},
|
||||||
|
"delivery_state": "available",
|
||||||
|
"source_url": "https://docs.letta.com/letta-agent/hooks"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"id": "opencode",
|
||||||
|
"name": "OpenCode",
|
||||||
|
"vendor": "SST",
|
||||||
|
"surface": "cli_and_ide",
|
||||||
|
"integration_mode": "plugin_api",
|
||||||
|
"config_format": "plugin",
|
||||||
|
"config_paths": [
|
||||||
|
"~/.config/opencode/plugins/*.{js,ts,mjs}",
|
||||||
|
".opencode/plugins/*.{js,ts,mjs}"
|
||||||
|
],
|
||||||
|
"events": {
|
||||||
|
"before_tool": "tool.execute.before",
|
||||||
|
"after_tool": "tool.execute.after"
|
||||||
|
},
|
||||||
|
"event_fields": {
|
||||||
|
"name": "tool",
|
||||||
|
"input": "args",
|
||||||
|
"session": "sessionID"
|
||||||
|
},
|
||||||
|
"blocking": {
|
||||||
|
"mechanism": "exception",
|
||||||
|
"failure_mode": "fail_closed"
|
||||||
|
},
|
||||||
|
"adapters": {
|
||||||
|
"node": true,
|
||||||
|
"python": true,
|
||||||
|
"go": true
|
||||||
|
},
|
||||||
|
"delivery_state": "available",
|
||||||
|
"source_url": "https://opencode.ai/docs/plugins/"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"id": "qwen",
|
||||||
|
"name": "Qwen Code",
|
||||||
|
"vendor": "Alibaba Cloud",
|
||||||
|
"surface": "cli",
|
||||||
|
"integration_mode": "command_hooks",
|
||||||
|
"config_format": "json",
|
||||||
|
"config_paths": [
|
||||||
|
"~/.qwen/settings.json",
|
||||||
|
".qwen/settings.json"
|
||||||
|
],
|
||||||
|
"events": {
|
||||||
|
"before_tool": "PreToolUse",
|
||||||
|
"after_tool": "PostToolUse"
|
||||||
|
},
|
||||||
|
"event_fields": {
|
||||||
|
"name": "tool_name",
|
||||||
|
"input": "tool_input",
|
||||||
|
"session": "session_id"
|
||||||
|
},
|
||||||
|
"blocking": {
|
||||||
|
"mechanism": "exit_code_2",
|
||||||
|
"failure_mode": "fail_open"
|
||||||
|
},
|
||||||
|
"adapters": {
|
||||||
|
"node": false,
|
||||||
|
"python": false,
|
||||||
|
"go": false
|
||||||
|
},
|
||||||
|
"delivery_state": "planned",
|
||||||
|
"source_url": "https://qwenlm.github.io/qwen-code-docs/en/users/features/hooks/"
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"custom_integrations": [
|
||||||
|
{
|
||||||
|
"id": "enterprise",
|
||||||
|
"name": "Enterprise",
|
||||||
|
"description": "Managed enterprise integration"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"id": "gui",
|
||||||
|
"name": "GUI Agent",
|
||||||
|
"description": "Desktop or browser automation agent"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"id": "other",
|
||||||
|
"name": "Other",
|
||||||
|
"description": "Custom integration outside the provider catalog"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"id": "sdk",
|
||||||
|
"name": "SDK",
|
||||||
|
"description": "Direct Elydora SDK integration"
|
||||||
|
}
|
||||||
|
]
|
||||||
|
}
|
||||||
@@ -0,0 +1,214 @@
|
|||||||
|
{
|
||||||
|
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
||||||
|
"$id": "https://elydora.com/schemas/integration-catalog.schema.json",
|
||||||
|
"title": "Elydora Integration Catalog",
|
||||||
|
"type": "object",
|
||||||
|
"additionalProperties": false,
|
||||||
|
"required": [
|
||||||
|
"schema_version",
|
||||||
|
"verified_on",
|
||||||
|
"providers",
|
||||||
|
"custom_integrations"
|
||||||
|
],
|
||||||
|
"properties": {
|
||||||
|
"$schema": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"schema_version": {
|
||||||
|
"const": 1
|
||||||
|
},
|
||||||
|
"verified_on": {
|
||||||
|
"type": "string",
|
||||||
|
"format": "date"
|
||||||
|
},
|
||||||
|
"providers": {
|
||||||
|
"type": "array",
|
||||||
|
"minItems": 1,
|
||||||
|
"items": {
|
||||||
|
"type": "object",
|
||||||
|
"additionalProperties": false,
|
||||||
|
"required": [
|
||||||
|
"id",
|
||||||
|
"name",
|
||||||
|
"vendor",
|
||||||
|
"surface",
|
||||||
|
"integration_mode",
|
||||||
|
"config_format",
|
||||||
|
"config_paths",
|
||||||
|
"events",
|
||||||
|
"blocking",
|
||||||
|
"adapters",
|
||||||
|
"delivery_state",
|
||||||
|
"source_url"
|
||||||
|
],
|
||||||
|
"properties": {
|
||||||
|
"id": {
|
||||||
|
"type": "string",
|
||||||
|
"pattern": "^[a-z][a-z0-9]*$"
|
||||||
|
},
|
||||||
|
"name": {
|
||||||
|
"type": "string",
|
||||||
|
"minLength": 1
|
||||||
|
},
|
||||||
|
"vendor": {
|
||||||
|
"type": "string",
|
||||||
|
"minLength": 1
|
||||||
|
},
|
||||||
|
"surface": {
|
||||||
|
"enum": [
|
||||||
|
"cli",
|
||||||
|
"ide",
|
||||||
|
"cli_and_ide"
|
||||||
|
]
|
||||||
|
},
|
||||||
|
"integration_mode": {
|
||||||
|
"enum": [
|
||||||
|
"command_hooks",
|
||||||
|
"plugin_api"
|
||||||
|
]
|
||||||
|
},
|
||||||
|
"config_format": {
|
||||||
|
"enum": [
|
||||||
|
"json",
|
||||||
|
"toml",
|
||||||
|
"plugin"
|
||||||
|
]
|
||||||
|
},
|
||||||
|
"config_paths": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string",
|
||||||
|
"minLength": 1
|
||||||
|
},
|
||||||
|
"uniqueItems": true
|
||||||
|
},
|
||||||
|
"events": {
|
||||||
|
"type": "object",
|
||||||
|
"additionalProperties": false,
|
||||||
|
"required": [
|
||||||
|
"before_tool",
|
||||||
|
"after_tool"
|
||||||
|
],
|
||||||
|
"properties": {
|
||||||
|
"before_tool": {
|
||||||
|
"type": "string",
|
||||||
|
"minLength": 1
|
||||||
|
},
|
||||||
|
"after_tool": {
|
||||||
|
"type": "string",
|
||||||
|
"minLength": 1
|
||||||
|
}
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"event_fields": {
|
||||||
|
"type": "object",
|
||||||
|
"additionalProperties": false,
|
||||||
|
"required": [
|
||||||
|
"name",
|
||||||
|
"input",
|
||||||
|
"session"
|
||||||
|
],
|
||||||
|
"properties": {
|
||||||
|
"name": {
|
||||||
|
"type": "string",
|
||||||
|
"minLength": 1
|
||||||
|
},
|
||||||
|
"input": {
|
||||||
|
"type": "string",
|
||||||
|
"minLength": 1
|
||||||
|
},
|
||||||
|
"session": {
|
||||||
|
"type": "string",
|
||||||
|
"minLength": 1
|
||||||
|
}
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"blocking": {
|
||||||
|
"type": "object",
|
||||||
|
"additionalProperties": false,
|
||||||
|
"required": [
|
||||||
|
"mechanism",
|
||||||
|
"failure_mode"
|
||||||
|
],
|
||||||
|
"properties": {
|
||||||
|
"mechanism": {
|
||||||
|
"enum": [
|
||||||
|
"any_nonzero_exit",
|
||||||
|
"exception",
|
||||||
|
"exit_code_2",
|
||||||
|
"hook_policy"
|
||||||
|
]
|
||||||
|
},
|
||||||
|
"failure_mode": {
|
||||||
|
"enum": [
|
||||||
|
"adapter_controlled",
|
||||||
|
"configurable",
|
||||||
|
"fail_closed",
|
||||||
|
"fail_open"
|
||||||
|
]
|
||||||
|
}
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"adapters": {
|
||||||
|
"type": "object",
|
||||||
|
"additionalProperties": false,
|
||||||
|
"required": [
|
||||||
|
"node",
|
||||||
|
"python",
|
||||||
|
"go"
|
||||||
|
],
|
||||||
|
"properties": {
|
||||||
|
"node": {
|
||||||
|
"type": "boolean"
|
||||||
|
},
|
||||||
|
"python": {
|
||||||
|
"type": "boolean"
|
||||||
|
},
|
||||||
|
"go": {
|
||||||
|
"type": "boolean"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"delivery_state": {
|
||||||
|
"enum": [
|
||||||
|
"available",
|
||||||
|
"partial",
|
||||||
|
"planned"
|
||||||
|
]
|
||||||
|
},
|
||||||
|
"source_url": {
|
||||||
|
"type": "string",
|
||||||
|
"format": "uri",
|
||||||
|
"pattern": "^https://"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"custom_integrations": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "object",
|
||||||
|
"additionalProperties": false,
|
||||||
|
"required": [
|
||||||
|
"id",
|
||||||
|
"name",
|
||||||
|
"description"
|
||||||
|
],
|
||||||
|
"properties": {
|
||||||
|
"id": {
|
||||||
|
"type": "string",
|
||||||
|
"pattern": "^[a-z][a-z0-9]*$"
|
||||||
|
},
|
||||||
|
"name": {
|
||||||
|
"type": "string",
|
||||||
|
"minLength": 1
|
||||||
|
},
|
||||||
|
"description": {
|
||||||
|
"type": "string",
|
||||||
|
"minLength": 1
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -22,6 +22,7 @@
|
|||||||
},
|
},
|
||||||
"license": "Apache-2.0",
|
"license": "Apache-2.0",
|
||||||
"scripts": {
|
"scripts": {
|
||||||
|
"validate:integrations": "node --test test/integration-catalog.test.mjs",
|
||||||
"build:server": "cd packages/server && npm run build",
|
"build:server": "cd packages/server && npm run build",
|
||||||
"build:console": "cd packages/console && npm run build",
|
"build:console": "cd packages/console && npm run build",
|
||||||
"build": "npm run build:server && npm run build:console",
|
"build": "npm run build:server && npm run build:console",
|
||||||
|
|||||||
@@ -0,0 +1,159 @@
|
|||||||
|
import assert from 'node:assert/strict';
|
||||||
|
import { readFile } from 'node:fs/promises';
|
||||||
|
import test from 'node:test';
|
||||||
|
|
||||||
|
const root = new URL('../', import.meta.url);
|
||||||
|
|
||||||
|
const expectedProviderIds = [
|
||||||
|
'augment',
|
||||||
|
'claudecode',
|
||||||
|
'cline',
|
||||||
|
'codex',
|
||||||
|
'copilot',
|
||||||
|
'cursor',
|
||||||
|
'droid',
|
||||||
|
'gemini',
|
||||||
|
'grok',
|
||||||
|
'kimi',
|
||||||
|
'kirocli',
|
||||||
|
'kiroide',
|
||||||
|
'letta',
|
||||||
|
'opencode',
|
||||||
|
'qwen',
|
||||||
|
];
|
||||||
|
|
||||||
|
const expectedCustomIntegrationIds = ['enterprise', 'gui', 'other', 'sdk'];
|
||||||
|
const expectedAdapterKeys = ['go', 'node', 'python'];
|
||||||
|
const requiredProviderFields = [
|
||||||
|
'id',
|
||||||
|
'name',
|
||||||
|
'vendor',
|
||||||
|
'surface',
|
||||||
|
'integration_mode',
|
||||||
|
'config_format',
|
||||||
|
'config_paths',
|
||||||
|
'events',
|
||||||
|
'blocking',
|
||||||
|
'adapters',
|
||||||
|
'delivery_state',
|
||||||
|
'source_url',
|
||||||
|
];
|
||||||
|
|
||||||
|
async function readJson(path) {
|
||||||
|
return JSON.parse(await readFile(new URL(path, root), 'utf8'));
|
||||||
|
}
|
||||||
|
|
||||||
|
function deliveryState(adapters) {
|
||||||
|
const availableCount = Object.values(adapters).filter(Boolean).length;
|
||||||
|
if (availableCount === expectedAdapterKeys.length) return 'available';
|
||||||
|
if (availableCount === 0) return 'planned';
|
||||||
|
return 'partial';
|
||||||
|
}
|
||||||
|
|
||||||
|
test('catalog contains the complete, ordered integration inventory', async () => {
|
||||||
|
const catalog = await readJson('integrations/catalog.json');
|
||||||
|
|
||||||
|
assert.equal(catalog.schema_version, 1);
|
||||||
|
assert.match(catalog.verified_on, /^\d{4}-\d{2}-\d{2}$/);
|
||||||
|
assert.deepEqual(
|
||||||
|
catalog.providers.map(({ id }) => id),
|
||||||
|
expectedProviderIds,
|
||||||
|
);
|
||||||
|
assert.deepEqual(
|
||||||
|
catalog.custom_integrations.map(({ id }) => id),
|
||||||
|
expectedCustomIntegrationIds,
|
||||||
|
);
|
||||||
|
});
|
||||||
|
|
||||||
|
test('every provider exposes a complete, machine-readable hook contract', async () => {
|
||||||
|
const catalog = await readJson('integrations/catalog.json');
|
||||||
|
|
||||||
|
for (const provider of catalog.providers) {
|
||||||
|
for (const field of requiredProviderFields) {
|
||||||
|
assert.ok(field in provider, `${provider.id} is missing ${field}`);
|
||||||
|
}
|
||||||
|
|
||||||
|
assert.match(provider.id, /^[a-z][a-z0-9]*$/);
|
||||||
|
assert.equal(typeof provider.name, 'string');
|
||||||
|
assert.equal(typeof provider.vendor, 'string');
|
||||||
|
assert.ok(['cli', 'ide', 'cli_and_ide'].includes(provider.surface));
|
||||||
|
assert.ok(['command_hooks', 'plugin_api'].includes(provider.integration_mode));
|
||||||
|
assert.ok(['json', 'toml', 'plugin'].includes(provider.config_format));
|
||||||
|
assert.ok(Array.isArray(provider.config_paths));
|
||||||
|
assert.equal(typeof provider.events.before_tool, 'string');
|
||||||
|
assert.equal(typeof provider.events.after_tool, 'string');
|
||||||
|
assert.ok([
|
||||||
|
'any_nonzero_exit',
|
||||||
|
'exception',
|
||||||
|
'exit_code_2',
|
||||||
|
'hook_policy',
|
||||||
|
].includes(provider.blocking.mechanism));
|
||||||
|
assert.ok([
|
||||||
|
'adapter_controlled',
|
||||||
|
'configurable',
|
||||||
|
'fail_closed',
|
||||||
|
'fail_open',
|
||||||
|
].includes(provider.blocking.failure_mode));
|
||||||
|
assert.deepEqual(Object.keys(provider.adapters).sort(), expectedAdapterKeys);
|
||||||
|
assert.ok(Object.values(provider.adapters).every((value) => typeof value === 'boolean'));
|
||||||
|
assert.equal(provider.delivery_state, deliveryState(provider.adapters));
|
||||||
|
assert.match(provider.source_url, /^https:\/\//);
|
||||||
|
|
||||||
|
if (provider.integration_mode === 'command_hooks') {
|
||||||
|
assert.ok(provider.config_paths.length > 0, `${provider.id} requires config paths`);
|
||||||
|
}
|
||||||
|
|
||||||
|
if (provider.event_fields) {
|
||||||
|
assert.equal(typeof provider.event_fields.name, 'string');
|
||||||
|
assert.equal(typeof provider.event_fields.input, 'string');
|
||||||
|
assert.equal(typeof provider.event_fields.session, 'string');
|
||||||
|
}
|
||||||
|
}
|
||||||
|
});
|
||||||
|
|
||||||
|
test('schema freezes the provider contract and supported enums', async () => {
|
||||||
|
const schema = await readJson('integrations/catalog.schema.json');
|
||||||
|
const providerSchema = schema.properties.providers.items;
|
||||||
|
|
||||||
|
assert.equal(schema.$schema, 'https://json-schema.org/draft/2020-12/schema');
|
||||||
|
assert.equal(schema.additionalProperties, false);
|
||||||
|
assert.deepEqual([...providerSchema.required].sort(), [...requiredProviderFields].sort());
|
||||||
|
assert.deepEqual(providerSchema.properties.surface.enum, ['cli', 'ide', 'cli_and_ide']);
|
||||||
|
assert.deepEqual(providerSchema.properties.integration_mode.enum, ['command_hooks', 'plugin_api']);
|
||||||
|
assert.deepEqual(providerSchema.properties.delivery_state.enum, ['available', 'partial', 'planned']);
|
||||||
|
});
|
||||||
|
|
||||||
|
test('high-drift providers retain their verified hook contracts', async () => {
|
||||||
|
const catalog = await readJson('integrations/catalog.json');
|
||||||
|
const providers = new Map(catalog.providers.map((provider) => [provider.id, provider]));
|
||||||
|
|
||||||
|
assert.deepEqual(providers.get('codex').config_paths, [
|
||||||
|
'~/.codex/hooks.json',
|
||||||
|
'.codex/hooks.json',
|
||||||
|
]);
|
||||||
|
assert.deepEqual(providers.get('kimi').events, {
|
||||||
|
before_tool: 'PreToolUse',
|
||||||
|
after_tool: 'PostToolUse',
|
||||||
|
});
|
||||||
|
assert.equal(providers.get('kimi').config_format, 'toml');
|
||||||
|
assert.deepEqual(providers.get('grok').event_fields, {
|
||||||
|
name: 'toolName',
|
||||||
|
input: 'toolInput',
|
||||||
|
session: 'sessionId',
|
||||||
|
});
|
||||||
|
assert.deepEqual(providers.get('kirocli').config_paths, [
|
||||||
|
'~/.kiro/agents/*.json',
|
||||||
|
'.kiro/agents/*.json',
|
||||||
|
]);
|
||||||
|
assert.deepEqual(providers.get('kiroide').config_paths, [
|
||||||
|
'.kiro/hooks/*.json',
|
||||||
|
]);
|
||||||
|
assert.deepEqual(providers.get('kiroide').events, {
|
||||||
|
before_tool: 'PreToolUse',
|
||||||
|
after_tool: 'PostToolUse',
|
||||||
|
});
|
||||||
|
assert.deepEqual(providers.get('kiroide').blocking, {
|
||||||
|
mechanism: 'exit_code_2',
|
||||||
|
failure_mode: 'fail_open',
|
||||||
|
});
|
||||||
|
});
|
||||||
Reference in new issue
Block a user