@aipermission/mcp 0.2.18 → 0.2.19

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -113,10 +113,14 @@ previews and published payloads can contain secrets or customer data; use short
113
113
  reasons and prefer approval-required access until the workflow is trusted.
114
114
 
115
115
  For Kafka or Redpanda, call `get_connector_actions(target_ref)` to discover
116
- cluster, topic, consumer-group, lag, and bounded message-read actions. Message
117
- reads use explicit partition assignment, never join a consumer group, and
118
- never commit offsets. Payloads can contain sensitive application data, so keep
119
- these reads in Prompt mode until the workflow is trusted.
116
+ cluster, topic, consumer-group, lag, bounded message-read, guarded publish, and
117
+ single-partition offset actions. Message reads use explicit partition
118
+ assignment, never join a consumer group, and never commit offsets. Publishing
119
+ is a write action; consumer-group offset changes are destructive and reject
120
+ active classic groups and modern consumer-protocol groups. Payloads can contain
121
+ sensitive application data, and offset changes can replay or skip records, so
122
+ keep these actions in Prompt mode unless direct execution is intentional. If a
123
+ publish has an unknown delivery outcome, inspect before retrying.
120
124
 
121
125
  For Docker, call `get_connector_actions(target_ref)` to discover bounded
122
126
  actions such as `docker_version`, `list_containers`, `list_images`,
@@ -56,6 +56,14 @@ RabbitMQ messages only when the operator explicitly asked for a write.
56
56
  For Kafka / Redpanda, discover topics before describing partitions or reading
57
57
  messages. Keep message reads bounded, prefer Prompt because payloads can be
58
58
  sensitive, and remember that read actions never join groups or commit offsets.
59
+ Use `publish_message` only for one explicitly requested topic partition. Treat
60
+ `set_consumer_group_offset` as destructive because it can replay or skip
61
+ records; keep both actions on Prompt unless direct execution is intentional.
62
+ If a publish reports an unknown delivery outcome, inspect the topic before
63
+ retrying. Offset changes support inactive classic groups and reject modern
64
+ consumer-protocol groups. The inactive-group check is best effort because
65
+ Kafka cannot atomically prevent a member joining between the final check and
66
+ commit; inspect the returned post-commit state and warning.
59
67
 
60
68
  Avoid vague reasons:
61
69
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@aipermission/mcp",
3
- "version": "0.2.18",
3
+ "version": "0.2.19",
4
4
  "mcpName": "io.github.aipermission/aipermission-mcp",
5
5
  "description": "Local-first MCP bridge for the aipermission gateway.",
6
6
  "license": "AGPL-3.0-only",
package/server.json CHANGED
@@ -3,12 +3,12 @@
3
3
  "name": "io.github.aipermission/aipermission-mcp",
4
4
  "title": "AIPermission",
5
5
  "description": "Local-first MCP bridge for the AIPermission gateway.",
6
- "version": "0.2.18",
6
+ "version": "0.2.19",
7
7
  "packages": [
8
8
  {
9
9
  "registryType": "npm",
10
10
  "identifier": "@aipermission/mcp",
11
- "version": "0.2.18",
11
+ "version": "0.2.19",
12
12
  "transport": {
13
13
  "type": "stdio"
14
14
  }