kite.json Manifest Reference

{
  "name": "my-agent",
  "sink": { "type": "proxy", "target": "http://localhost:3000/webhooks" }
}

{
  "name": "my-agent",
  "subscriptions": [
    { "source": "github" },
    { "type": "com.stripe.payment_intent.succeeded" }
  ],
  "sink": {
    "type": "exec",
    "command": "./handle-event.sh",
    "importance": "high"
  },
  "filters": {
    "drop": [
      { "source": "github", "type": "com.github.ping" }
    ],
    "keep_only": [
      { "source": "github", "type": "com.github.push" },
      { "source": "github", "type": "com.github.pull_request.*" }
    ]
  },
  "enrichment": [
    {
      "match": { "source": "github", "type": "com.github.pull_request.*" },
      "run": "scripts/enrich-pr.sh",
      "timeout": "30s"
    }
  ],
  "scoring": {
    "rules": [
      {
        "match": { "source": "github", "type": "com.github.push" },
        "importance": "high",
        "paths": ["src/auth/*"],
        "reason": "auth-path push"
      }
    ],
    "dedup": {
      "window": "5m",
      "key": ["source", "type"],
      "strategy": "keep_last"
    },
    "default_importance": "normal"
  },
  "queue": {
    "retention": "7d",
    "max_size": "1000"
  }
}

Narrows the WebSocket subscription scope. All conditions within a subscription entry are AND'd; multiple entries are OR'd.

The `sink.type` field selects the delivery mode.

`stdout`

Print events to standard output.

{ "type": "stdout", "json": true }

`proxy`

Forward events as HTTP POST to a local server.

{ "type": "proxy", "target": "http://localhost:3000/webhooks" }

`socket`

Write events to a Unix domain socket.

{ "type": "socket", "path": "/tmp/kite.sock" }

`exec`

Execute a shell command for each event. Event JSON is passed on stdin.

{ "type": "exec", "command": "./handle.sh", "importance": "high" }

`mcp_server`

Expose events as an MCP (Model Context Protocol) server.

{ "type": "mcp_server", "buffer_size": 100 }

`paperclip`

Trigger Paperclip agent heartbeats on matching events.

{
  "type": "paperclip",
  "api_url": "https://api.paperclip.ing",
  "company_id": "your-company-id",
  "agent_id": "optional-agent-id"
}

Applied before delivery. Drop rules run first; if any match, the event is dropped. `keep_only` rules run next — if any are defined and none match, the event is also dropped.

{
  "filters": {
    "drop": [
      { "source": "github", "type": "com.github.ping" }
    ],
    "keep_only": [
      { "source": "github", "type": "com.github.push" }
    ]
  }
}

FilterRule fields

All fields are optional and AND'd together. Glob patterns (`*`, `**`) are supported in `source` and `type`.

Run a shell script before delivery. The script receives the CloudEvent JSON on stdin and can emit JSON to stdout to merge additional fields.

Assign importance levels to events and optionally deduplicate within a time window.

ScoringRule

DedupConfig

Controls local dead-letter queue retention.