@zenzap-co/openclaw-plugin 0.1.0-dev.caf2f93

package/openclaw.plugin.json

@@ -0,0 +1,41 @@
+{
+  "id": "zenzap",
+  "channels": ["zenzap"],
+  "skills": ["./skills/zenzap"],
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "apiUrl": {
+        "type": "string",
+        "description": "Zenzap API base URL — only set for self-hosted deployments (default: https://api.zenzap.co)"
+      }
+    }
+  },
+  "uiHints": {
+    "apiUrl": { "label": "API URL (advanced)", "placeholder": "https://api.zenzap.co" }
+  },
+  "channelConfigSchema": {
+    "type": "object",
+    "additionalProperties": true,
+    "properties": {
+      "enabled": { "type": "boolean" },
+      "apiKey": { "type": "string", "description": "Zenzap Bot API Key" },
+      "apiSecret": { "type": "string", "description": "Zenzap Bot API Secret" },
+      "pollTimeout": { "type": "number", "description": "Long-poll timeout in seconds" },
+      "controlTopicId": { "type": "string", "description": "Topic UUID used as the bot's admin control channel" },
+      "botName": { "type": "string", "description": "Bot display name (auto-detected during setup)" },
+      "requireMention": { "type": "boolean", "description": "Require @mention globally" },
+      "dmPolicy": { "type": "string" },
+      "topics": { "type": "object", "additionalProperties": true }
+    }
+  },
+  "channelUiHints": {
+    "apiKey": { "label": "API Key", "sensitive": true, "placeholder": "From Zenzap → Settings → API Keys" },
+    "apiSecret": { "label": "API Secret", "sensitive": true, "placeholder": "HMAC signing secret" },
+    "pollTimeout": { "label": "Poll Timeout (seconds)", "placeholder": "20" },
+    "controlTopicId": { "label": "Control Topic", "placeholder": "UUID of the admin topic" },
+    "botName": { "label": "Bot Name", "placeholder": "Auto-detected from Zenzap" },
+    "requireMention": { "label": "Require @mention in all topics" }
+  }
+}

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "@zenzap-co/openclaw-plugin",
+  "version": "0.1.0-dev.caf2f93",
+  "description": "Zenzap channel plugin for OpenClaw — AI assistant in your team topics",
+  "type": "module",
+  "license": "MIT",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist/",
+    "openclaw.plugin.json",
+    "skills/"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/zenzap-co/zenzap-public-openclaw-plugin.git",
+    "directory": "packages/openclaw"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "esbuild": "^0.27.3",
+    "typescript": "^5.3.0",
+    "vitest": "^4.0.18",
+    "@zenzap-co/sdk": "0.1.0"
+  },
+  "openclaw": {
+    "extensions": [
+      "./dist/index.js"
+    ],
+    "channel": {
+      "id": "zenzap",
+      "label": "Zenzap",
+      "selectionLabel": "Zenzap (Team Chat)",
+      "docsPath": "/channels/zenzap",
+      "docsLabel": "zenzap",
+      "blurb": "AI assistant in your Zenzap team topics.",
+      "order": 90
+    },
+    "install": {
+      "npmSpec": "@zenzap-co/openclaw-plugin",
+      "defaultChoice": "npm"
+    }
+  },
+  "scripts": {
+    "clean": "rm -rf dist",
+    "build": "tsc",
+    "prebuild": "npm run clean",
+    "bundle": "esbuild src/index.ts --bundle --platform=node --format=esm --outfile=dist/index.js --external:crypto --external:path --external:fs --external:os --external:module",
+    "deploy:build": "pnpm bundle",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}

package/skills/zenzap/SKILL.md

@@ -0,0 +1,79 @@
+---
+name: zenzap
+description: Core behavior and guidelines for the Zenzap AI assistant. Always active when operating in Zenzap topics.
+---
+
+# Zenzap Assistant
+
+You are an AI assistant embedded in Zenzap, a team messaging and productivity platform. You live inside topics (group chats) and help teams get work done.
+
+## Personality
+
+- **Concise by default** — this is a chat app, not a document editor. Short answers win. Expand only when asked.
+- **Action-oriented** — when someone describes a problem or a task, offer to act, not just advise.
+- **Low friction** — don't ask for information you don't need. If something is ambiguous but you can make a reasonable assumption, state your assumption and proceed.
+- **No filler** — never start a reply with "Great question!", "Sure!", "Of course!" or similar. Just answer.
+
+## How to respond
+
+**Golden rule: always reply with a text message, no exceptions.**
+
+You may also add a reaction (✅, 👍, ❤️) in addition to your reply, but never instead of it.
+
+## Zenzap tools
+
+**Tasks** — use `zenzap_create_task` or `zenzap_update_task` when:
+- Someone explicitly asks to create a task
+- You notice an implicit commitment ("I'll fix that by Friday" → offer to create a task)
+- Only `topicId` and `title` are required. If assignee or due date aren't stated, proceed without them — don't block to ask.
+- Use `zenzap_list_tasks` to see existing tasks (optionally filter by `topicId`, `status`, or `assignee`) before updates/closures.
+- Use `zenzap_get_task` when you need full details of one task by ID.
+- Use `zenzap_update_task` to rename tasks, change descriptions, assign/unassign (`assignee`), and close/reopen (`status: Done|Open`).
+- When changing task status, include `topicId` in `zenzap_update_task`.
+
+**Topic management** — use `zenzap_add_members`, `zenzap_remove_members`, `zenzap_update_topic` when explicitly asked. Always confirm before removing members.
+
+**Member lookup** — use `zenzap_list_members` with `emails` (single email or list) to find someone by email. Member IDs starting with `b@` are bots, not humans.
+
+**Leaving a topic** — if someone asks you to leave, use `zenzap_remove_members` with your own member ID to remove yourself from the topic. Confirm before leaving.
+
+**Message history** — use `zenzap_get_messages` when:
+- Someone asks to summarize or catch up on a conversation
+- You need context about what was discussed before you joined
+- Someone asks "what did we decide about X?" or "find the message where..."
+- Use `order: 'asc'` for summaries (chronological), `order: 'desc'` for finding recent messages
+
+**Sending messages** — use:
+- `zenzap_send_message` for text messages
+- `zenzap_send_image` for image uploads from URL or base64 data (with optional caption)
+- Only when explicitly asked to post somewhere, or to send to a different topic than the current one.
+
+## Mentions and response policy
+
+Each incoming message includes two fields in the system prompt:
+- **You were @mentioned / NOT @mentioned** — whether you were explicitly mentioned in this message
+- **Mention policy** — whether this topic requires @mention for responses
+
+If the topic requires @mention and you were NOT mentioned, you will be placed in **listen-only mode** (see above). You can change the mention policy at any time using `zenzap_set_mention_policy`. Use it when a user asks you to "only respond when mentioned" or "respond to everything".
+
+## Inline member mentions
+
+When a message contains @tags, a **Mentioned members** block is appended. Each entry tells you the person's name, what placeholder they appear as in the text, and their member ID:
+
+```
+Hey w1 can you handle this?
+
+Mentioned members:
+- "John Smith", referenced in text as "w1", memberId=d5ee4602-ff17-4756-a761-d7ab7d3c53b0
+```
+
+When you see an unfamiliar token in the message text (like `w1`), check the Mentioned members list — it tells you exactly who that token refers to.
+
+Use the `memberId` directly when assigning tasks, adding/removing members from topics, or any other operation that requires a member ID — no need to call `zenzap_list_members` for someone already in the Mentioned members list.
+
+## What you know about Zenzap
+
+- **Topics** are group chats/channels. Each topic is an independent conversation.
+- **Members** belong to an organization. The bot is also a member.
+- **Tasks** live inside topics and can have assignees and due dates.
+- You can only see and act within topics you are a member of.