@aipermission/mcp 0.2.17 → 0.2.19

package/README.md

@@ -9,7 +9,7 @@ credentials, or other connector secrets.
 The gateway is intentionally local-only. Run it on the developer machine and
 keep the URL on `localhost`; remote systems are connector targets, not places
 to host the gateway for LAN or internet users. SSH, Postgres, ClickHouse,
-Redis / Valkey, RabbitMQ, S3, Docker, and Kubernetes are built-in connectors that use the same
+Redis / Valkey, RabbitMQ, Kafka / Redpanda, S3, Docker, and Kubernetes are built-in connectors that use the same
 target/profile/action permission model as future connectors.
 
 ![AIPermission demo: AI operates through approval-based connector access](https://raw.githubusercontent.com/aipermission/aipermission/main/docs/assets/demo/aipermission-demo.gif)
@@ -66,7 +66,7 @@ The generated MCP config contains a bearer token. Keep it private. For project-l
 - `cancel_vault_action_request`
 
 All integration work goes through connector targets. SSH, Postgres, ClickHouse,
-Redis / Valkey, RabbitMQ, S3, Docker, Kubernetes, and future connectors share the same model: target,
+Redis / Valkey, RabbitMQ, Kafka / Redpanda, S3, Docker, Kubernetes, and future connectors share the same model: target,
 credential profile, connector action, token action permission, approval,
 history, and audit.
 
@@ -112,6 +112,16 @@ browser actions such as `overview`, `list_vhosts`, `list_queues`, `get_queue`,
 previews and published payloads can contain secrets or customer data; use short
 reasons and prefer approval-required access until the workflow is trusted.
 
+For Kafka or Redpanda, call `get_connector_actions(target_ref)` to discover
+cluster, topic, consumer-group, lag, bounded message-read, guarded publish, and
+single-partition offset actions. Message reads use explicit partition
+assignment, never join a consumer group, and never commit offsets. Publishing
+is a write action; consumer-group offset changes are destructive and reject
+active classic groups and modern consumer-protocol groups. Payloads can contain
+sensitive application data, and offset changes can replay or skip records, so
+keep these actions in Prompt mode unless direct execution is intentional. If a
+publish has an unknown delivery outcome, inspect before retrying.
+
 For Docker, call `get_connector_actions(target_ref)` to discover bounded
 actions such as `docker_version`, `list_containers`, `list_images`,
 `list_networks`, `list_volumes`, `inspect_container`, `container_logs`,

package/dist/resources/aipermission-operator/SKILL.md

@@ -53,6 +53,18 @@ Peek a RabbitMQ queue after the operator approved payload inspection. Publish
 RabbitMQ messages only when the operator explicitly asked for a write.
 ```
 
+For Kafka / Redpanda, discover topics before describing partitions or reading
+messages. Keep message reads bounded, prefer Prompt because payloads can be
+sensitive, and remember that read actions never join groups or commit offsets.
+Use `publish_message` only for one explicitly requested topic partition. Treat
+`set_consumer_group_offset` as destructive because it can replay or skip
+records; keep both actions on Prompt unless direct execution is intentional.
+If a publish reports an unknown delivery outcome, inspect the topic before
+retrying. Offset changes support inactive classic groups and reject modern
+consumer-protocol groups. The inactive-group check is best effort because
+Kafka cannot atomically prevent a member joining between the final check and
+commit; inspect the returned post-commit state and warning.
+
 Avoid vague reasons:
 
 ```text

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aipermission/mcp",
-  "version": "0.2.17",
+  "version": "0.2.19",
   "mcpName": "io.github.aipermission/aipermission-mcp",
   "description": "Local-first MCP bridge for the aipermission gateway.",
   "license": "AGPL-3.0-only",

package/server.json

@@ -3,12 +3,12 @@
   "name": "io.github.aipermission/aipermission-mcp",
   "title": "AIPermission",
   "description": "Local-first MCP bridge for the AIPermission gateway.",
-  "version": "0.2.17",
+  "version": "0.2.19",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "@aipermission/mcp",
-      "version": "0.2.17",
+      "version": "0.2.19",
       "transport": {
         "type": "stdio"
       }