openclaw-zulip 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 whizzlefred
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,129 @@
+# openclaw-zulip
+
+A clean-room [OpenClaw](https://github.com/openclaw/openclaw) channel plugin for [Zulip](https://zulip.com), built from scratch with the OpenClaw Plugin SDK.
+
+## Features
+
+- **Full Zulip messaging** — Streams, topics, DMs, reactions, media, edits, unsend
+- **ACP topic bindings** — Bind ACP agent sessions to specific Zulip topics
+- **Dual account modes** — Run as a bot or impersonate a user account
+- **Stream-level controls** — Per-stream config (require mention, enable/disable)
+- **Security** — DM policy enforcement, allow-from lists
+- **Actions** — Channel list, channel info, member info queries
+
+## Installation
+
+```bash
+openclaw plugins install openclaw-zulip
+```
+
+## Configuration
+
+Add a `channels.zulip` section to your OpenClaw config:
+
+```yaml
+channels:
+  zulip:
+    serverUrl: https://your-org.zulipchat.com
+    email: bot@your-org.zulipchat.com
+    apiKey: your-bot-api-key
+    mode: bot  # or "user"
+
+    # Optional: per-stream overrides
+    streams:
+      general:
+        requireMention: true
+      private-ops:
+        enabled: false
+
+    # Optional: multi-account setup
+    accounts:
+      work-bot:
+        serverUrl: https://work.zulipchat.com
+        email: bot@work.zulipchat.com
+        apiKey: ...
+```
+
+### Account modes
+
+| Mode | Description |
+|------|-------------|
+| `bot` | Connects as a Zulip bot (default). Messages appear from the bot identity. |
+| `user` | Connects as a regular Zulip user. Messages appear from that user's identity. |
+
+### Configuration fields
+
+| Field | Required | Description |
+|-------|----------|-------------|
+| `serverUrl` | Yes | Zulip server URL |
+| `email` | Yes | Bot or user email address |
+| `apiKey` | Yes | Zulip API key |
+| `mode` | No | `bot` (default) or `user` |
+| `streams` | No | Per-stream config overrides |
+| `dmPolicy` | No | DM handling policy |
+| `allowFrom` | No | Allowed user IDs or emails |
+| `replyToMode` | No | Reply targeting behavior |
+
+## Capabilities
+
+| Feature | Supported |
+|---------|-----------|
+| Direct messages | Yes |
+| Group conversations (streams) | Yes |
+| Threads (topics) | Yes |
+| Reactions | Yes |
+| Message editing | Yes |
+| Unsend | Yes |
+| Reply | Yes |
+| Media | Yes |
+| ACP topic bindings | Yes |
+| Native commands | No |
+| Polls | No |
+
+## Migrating from openclaw-channel-zulip
+
+If you're replacing the old `openclaw-channel-zulip` plugin, note these config changes:
+
+### Config field renames
+
+| Old field | New field |
+|-----------|-----------|
+| `url` | `serverUrl` |
+
+### Streams format change
+
+The old plugin used an array of stream names:
+
+```yaml
+streams:
+  - "AI System"
+  - "Homelab"
+```
+
+The new plugin uses an object with per-stream config:
+
+```yaml
+streams:
+  AI System:
+    requireMention: true
+  Homelab:
+    enabled: true
+```
+
+To migrate, convert each stream name to a key with `{}` (empty config) or add per-stream settings as needed.
+
+## Development
+
+```bash
+git clone https://github.com/whizzlelabs/openclaw-zulip.git
+cd openclaw-zulip
+npm install
+npm run build
+npm test
+```
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for the full development workflow.
+
+## License
+
+TBD

package/dist/actions.d.ts

@@ -0,0 +1,3 @@
+import type { ChannelPlugin } from "openclaw/plugin-sdk/core";
+export declare const zulipActionsAdapter: NonNullable<ChannelPlugin["actions"]>;
+//# sourceMappingURL=actions.d.ts.map

package/dist/actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../src/actions.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAQ9D,eAAO,MAAM,mBAAmB,EAAE,WAAW,CAAC,aAAa,CAAC,SAAS,CAAC,CAyJrE,CAAC"}

package/dist/actions.js

@@ -0,0 +1,149 @@
+import { Type } from "@sinclair/typebox";
+import { buildClient } from "./outbound.js";
+// ---------------------------------------------------------------------------
+// Zulip message actions adapter
+// ---------------------------------------------------------------------------
+export const zulipActionsAdapter = {
+    describeMessageTool(_ctx) {
+        return {
+            actions: ["react", "edit", "unsend", "search", "topic-edit", "upload-file", "download-file", "channel-list", "channel-info", "member-info"],
+            schema: {
+                visibility: "current-channel",
+                properties: {
+                    zulip_message_id: Type.Optional(Type.Number({ description: "Zulip message ID to act on (required for react, edit, unsend, topic-edit)" })),
+                    zulip_emoji: Type.Optional(Type.String({ description: "Emoji name for the react action (e.g. 'thumbs_up', '+1')" })),
+                    zulip_content: Type.Optional(Type.String({ description: "New message content for the edit action" })),
+                    zulip_topic: Type.Optional(Type.String({ description: "Topic name for topic-edit or search narrow" })),
+                    zulip_stream_id: Type.Optional(Type.Number({ description: "Stream ID for topic-edit or search narrow" })),
+                    zulip_query: Type.Optional(Type.String({ description: "Full-text search query for the search action" })),
+                    zulip_propagate_mode: Type.Optional(Type.String({
+                        description: "Topic propagation mode for topic-edit: 'change_one', 'change_later', or 'change_all' (default)",
+                    })),
+                    zulip_file_path: Type.Optional(Type.String({ description: "Local file path for upload-file, or Zulip file URI for download-file" })),
+                    zulip_limit: Type.Optional(Type.Number({ description: "Maximum number of messages to return from search (default 10)" })),
+                    zulip_user_id: Type.Optional(Type.Number({ description: "Zulip user ID for the member-info action" })),
+                },
+            },
+        };
+    },
+    async handleAction(ctx) {
+        const client = buildClient(ctx.cfg, ctx.accountId);
+        const p = ctx.params;
+        const text = (s) => String(s ?? "");
+        const requireMessageId = () => {
+            const raw = p.zulip_message_id;
+            if (raw == null || raw === "")
+                return null;
+            const n = Number(raw);
+            if (!Number.isFinite(n))
+                return null;
+            return n;
+        };
+        switch (ctx.action) {
+            case "react": {
+                const messageId = requireMessageId();
+                if (messageId == null)
+                    return err("zulip_message_id is required for react");
+                const emojiName = text(p.zulip_emoji) || "thumbs_up";
+                await client.addReaction(messageId, emojiName);
+                return ok(`Reacted with :${emojiName}: on message ${messageId}`);
+            }
+            case "edit": {
+                const messageId = requireMessageId();
+                if (messageId == null)
+                    return err("zulip_message_id is required for edit");
+                const content = text(p.zulip_content);
+                if (!content)
+                    return err("zulip_content is required for edit");
+                await client.editMessage(messageId, content);
+                return ok(`Edited message ${messageId}`);
+            }
+            case "unsend":
+            case "delete": {
+                const messageId = requireMessageId();
+                if (messageId == null)
+                    return err("zulip_message_id is required for unsend");
+                await client.deleteMessage(messageId);
+                return ok(`Deleted message ${messageId}`);
+            }
+            case "search": {
+                const limit = p.zulip_limit ? Number(p.zulip_limit) || 10 : 10;
+                const narrow = [];
+                if (p.zulip_stream_id)
+                    narrow.push({ operator: "stream", operand: text(p.zulip_stream_id) });
+                if (p.zulip_topic)
+                    narrow.push({ operator: "topic", operand: text(p.zulip_topic) });
+                if (p.zulip_query)
+                    narrow.push({ operator: "search", operand: text(p.zulip_query) });
+                const messages = await client.searchMessages({
+                    anchor: "newest",
+                    numBefore: limit,
+                    numAfter: 0,
+                    narrow,
+                });
+                return ok(JSON.stringify(messages, null, 2));
+            }
+            case "topic-edit": {
+                const messageId = requireMessageId();
+                if (messageId == null)
+                    return err("zulip_message_id is required for topic-edit");
+                const topic = text(p.zulip_topic);
+                if (!topic)
+                    return err("zulip_topic is required for topic-edit");
+                const propagateMode = text(p.zulip_propagate_mode) || "change_all";
+                const streamId = p.zulip_stream_id ? Number(p.zulip_stream_id) : undefined;
+                await client.updateMessageTopic(messageId, topic, propagateMode, streamId);
+                return ok(`Topic updated to "${topic}" (mode: ${propagateMode})`);
+            }
+            case "upload-file": {
+                const filePath = text(p.zulip_file_path);
+                if (!filePath)
+                    return err("zulip_file_path is required for upload-file");
+                if (!ctx.mediaReadFile)
+                    return err("File read access not available in this context");
+                const buffer = await ctx.mediaReadFile(filePath);
+                const filename = filePath.split("/").pop() ?? "file";
+                const result = await client.uploadFile(filename, buffer);
+                return ok(result.uri);
+            }
+            case "download-file": {
+                const fileUrl = text(p.zulip_file_path);
+                if (!fileUrl)
+                    return err("zulip_file_path is required for download-file");
+                const buffer = await client.downloadFile(fileUrl);
+                const base64 = buffer.toString("base64");
+                return ok(`data:application/octet-stream;base64,${base64}`);
+            }
+            case "channel-list": {
+                const streams = await client.getStreams();
+                return ok(JSON.stringify(streams, null, 2));
+            }
+            case "channel-info": {
+                const streamId = p.zulip_stream_id ? Number(p.zulip_stream_id) : null;
+                if (streamId == null)
+                    return err("zulip_stream_id is required for channel-info");
+                const [stream, members] = await Promise.all([
+                    client.getStreamById(streamId),
+                    client.getStreamMembers(streamId),
+                ]);
+                return ok(JSON.stringify({ ...stream, subscribers: members }, null, 2));
+            }
+            case "member-info": {
+                const userId = p.zulip_user_id ? Number(p.zulip_user_id) : null;
+                if (userId == null)
+                    return err("zulip_user_id is required for member-info");
+                const user = await client.getUser(userId);
+                return ok(JSON.stringify(user, null, 2));
+            }
+            default:
+                return err(`Action "${ctx.action}" is not supported by the Zulip plugin`);
+        }
+    },
+};
+function ok(message) {
+    return { content: [{ type: "text", text: message }], details: { ok: true } };
+}
+function err(message) {
+    return { content: [{ type: "text", text: message }], details: { ok: false } };
+}
+//# sourceMappingURL=actions.js.map

package/dist/actions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions.js","sourceRoot":"","sources":["../src/actions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAGzC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,8EAA8E;AAC9E,gCAAgC;AAChC,8EAA8E;AAE9E,MAAM,CAAC,MAAM,mBAAmB,GAA0C;IACxE,mBAAmB,CAAC,IAAI;QACtB,OAAO;YACL,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,cAAc,EAAE,cAAc,EAAE,aAAa,CAAC;YAC3I,MAAM,EAAE;gBACN,UAAU,EAAE,iBAAiB;gBAC7B,UAAU,EAAE;oBACV,gBAAgB,EAAE,IAAI,CAAC,QAAQ,CAC7B,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,2EAA2E,EAAE,CAAC,CAC1G;oBACD,WAAW,EAAE,IAAI,CAAC,QAAQ,CACxB,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,0DAA0D,EAAE,CAAC,CACzF;oBACD,aAAa,EAAE,IAAI,CAAC,QAAQ,CAC1B,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,yCAAyC,EAAE,CAAC,CACxE;oBACD,WAAW,EAAE,IAAI,CAAC,QAAQ,CACxB,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,4CAA4C,EAAE,CAAC,CAC3E;oBACD,eAAe,EAAE,IAAI,CAAC,QAAQ,CAC5B,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,2CAA2C,EAAE,CAAC,CAC1E;oBACD,WAAW,EAAE,IAAI,CAAC,QAAQ,CACxB,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,8CAA8C,EAAE,CAAC,CAC7E;oBACD,oBAAoB,EAAE,IAAI,CAAC,QAAQ,CACjC,IAAI,CAAC,MAAM,CAAC;wBACV,WAAW,EAAE,gGAAgG;qBAC9G,CAAC,CACH;oBACD,eAAe,EAAE,IAAI,CAAC,QAAQ,CAC5B,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,sEAAsE,EAAE,CAAC,CACrG;oBACD,WAAW,EAAE,IAAI,CAAC,QAAQ,CACxB,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,+DAA+D,EAAE,CAAC,CAC9F;oBACD,aAAa,EAAE,IAAI,CAAC,QAAQ,CAC1B,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,0CAA0C,EAAE,CAAC,CACzE;iBACF;aACF;SACF,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,GAAgC;QACjD,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,SAAS,CAAC,CAAC;QACnD,MAAM,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC;QAErB,MAAM,IAAI,GAAG,CAAC,CAAU,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QAC7C,MAAM,gBAAgB,GAAG,GAAkB,EAAE;YAC3C,MAAM,GAAG,GAAG,CAAC,CAAC,gBAAgB,CAAC;YAC/B,IAAI,GAAG,IAAI,IAAI,IAAI,GAAG,KAAK,EAAE;gBAAE,OAAO,IAAI,CAAC;YAC3C,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;YACtB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;gBAAE,OAAO,IAAI,CAAC;YACrC,OAAO,CAAC,CAAC;QACX,CAAC,CAAC;QAEF,QAAQ,GAAG,CAAC,MAAM,EAAE,CAAC;YACnB,KAAK,OAAO,CAAC,CAAC,CAAC;gBACb,MAAM,SAAS,GAAG,gBAAgB,EAAE,CAAC;gBACrC,IAAI,SAAS,IAAI,IAAI;oBAAE,OAAO,GAAG,CAAC,wCAAwC,CAAC,CAAC;gBAC5E,MAAM,SAAS,GAAG,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,WAAW,CAAC;gBACrD,MAAM,MAAM,CAAC,WAAW,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;gBAC/C,OAAO,EAAE,CAAC,iBAAiB,SAAS,gBAAgB,SAAS,EAAE,CAAC,CAAC;YACnE,CAAC;YAED,KAAK,MAAM,CAAC,CAAC,CAAC;gBACZ,MAAM,SAAS,GAAG,gBAAgB,EAAE,CAAC;gBACrC,IAAI,SAAS,IAAI,IAAI;oBAAE,OAAO,GAAG,CAAC,uCAAuC,CAAC,CAAC;gBAC3E,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC;gBACtC,IAAI,CAAC,OAAO;oBAAE,OAAO,GAAG,CAAC,oCAAoC,CAAC,CAAC;gBAC/D,MAAM,MAAM,CAAC,WAAW,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;gBAC7C,OAAO,EAAE,CAAC,kBAAkB,SAAS,EAAE,CAAC,CAAC;YAC3C,CAAC;YAED,KAAK,QAAQ,CAAC;YACd,KAAK,QAAQ,CAAC,CAAC,CAAC;gBACd,MAAM,SAAS,GAAG,gBAAgB,EAAE,CAAC;gBACrC,IAAI,SAAS,IAAI,IAAI;oBAAE,OAAO,GAAG,CAAC,yCAAyC,CAAC,CAAC;gBAC7E,MAAM,MAAM,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;gBACtC,OAAO,EAAE,CAAC,mBAAmB,SAAS,EAAE,CAAC,CAAC;YAC5C,CAAC;YAED,KAAK,QAAQ,CAAC,CAAC,CAAC;gBACd,MAAM,KAAK,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC/D,MAAM,MAAM,GAAiD,EAAE,CAAC;gBAChE,IAAI,CAAC,CAAC,eAAe;oBAAE,MAAM,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;gBAC7F,IAAI,CAAC,CAAC,WAAW;oBAAE,MAAM,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;gBACpF,IAAI,CAAC,CAAC,WAAW;oBAAE,MAAM,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;gBACrF,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC;oBAC3C,MAAM,EAAE,QAAQ;oBAChB,SAAS,EAAE,KAAK;oBAChB,QAAQ,EAAE,CAAC;oBACX,MAAM;iBACP,CAAC,CAAC;gBACH,OAAO,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YAC/C,CAAC;YAED,KAAK,YAAY,CAAC,CAAC,CAAC;gBAClB,MAAM,SAAS,GAAG,gBAAgB,EAAE,CAAC;gBACrC,IAAI,SAAS,IAAI,IAAI;oBAAE,OAAO,GAAG,CAAC,6CAA6C,CAAC,CAAC;gBACjF,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;gBAClC,IAAI,CAAC,KAAK;oBAAE,OAAO,GAAG,CAAC,wCAAwC,CAAC,CAAC;gBACjE,MAAM,aAAa,GAAG,IAAI,CAAC,CAAC,CAAC,oBAAoB,CAAC,IAAI,YAAY,CAAC;gBACnE,MAAM,QAAQ,GAAG,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;gBAC3E,MAAM,MAAM,CAAC,kBAAkB,CAAC,SAAS,EAAE,KAAK,EAAE,aAAa,EAAE,QAAQ,CAAC,CAAC;gBAC3E,OAAO,EAAE,CAAC,qBAAqB,KAAK,YAAY,aAAa,GAAG,CAAC,CAAC;YACpE,CAAC;YAED,KAAK,aAAa,CAAC,CAAC,CAAC;gBACnB,MAAM,QAAQ,GAAG,IAAI,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC;gBACzC,IAAI,CAAC,QAAQ;oBAAE,OAAO,GAAG,CAAC,6CAA6C,CAAC,CAAC;gBACzE,IAAI,CAAC,GAAG,CAAC,aAAa;oBAAE,OAAO,GAAG,CAAC,gDAAgD,CAAC,CAAC;gBACrF,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;gBACjD,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,MAAM,CAAC;gBACrD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;gBACzD,OAAO,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACxB,CAAC;YAED,KAAK,eAAe,CAAC,CAAC,CAAC;gBACrB,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC;gBACxC,IAAI,CAAC,OAAO;oBAAE,OAAO,GAAG,CAAC,+CAA+C,CAAC,CAAC;gBAC1E,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;gBAClD,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;gBACzC,OAAO,EAAE,CAAC,wCAAwC,MAAM,EAAE,CAAC,CAAC;YAC9D,CAAC;YAED,KAAK,cAAc,CAAC,CAAC,CAAC;gBACpB,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,UAAU,EAAE,CAAC;gBAC1C,OAAO,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YAC9C,CAAC;YAED,KAAK,cAAc,CAAC,CAAC,CAAC;gBACpB,MAAM,QAAQ,GAAG,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;gBACtE,IAAI,QAAQ,IAAI,IAAI;oBAAE,OAAO,GAAG,CAAC,8CAA8C,CAAC,CAAC;gBACjF,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;oBAC1C,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC;oBAC9B,MAAM,CAAC,gBAAgB,CAAC,QAAQ,CAAC;iBAClC,CAAC,CAAC;gBACH,OAAO,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YAC1E,CAAC;YAED,KAAK,aAAa,CAAC,CAAC,CAAC;gBACnB,MAAM,MAAM,GAAG,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;gBAChE,IAAI,MAAM,IAAI,IAAI;oBAAE,OAAO,GAAG,CAAC,2CAA2C,CAAC,CAAC;gBAC5E,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;gBAC1C,OAAO,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YAC3C,CAAC;YAED;gBACE,OAAO,GAAG,CAAC,WAAW,GAAG,CAAC,MAAM,wCAAwC,CAAC,CAAC;QAC9E,CAAC;IACH,CAAC;CACF,CAAC;AAEF,SAAS,EAAE,CAAC,OAAe;IACzB,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC;AACxF,CAAC;AAED,SAAS,GAAG,CAAC,OAAe;IAC1B,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC;AACzF,CAAC"}

package/dist/agent-prompt.d.ts

@@ -0,0 +1,3 @@
+import type { ChannelPlugin } from "openclaw/plugin-sdk/core";
+export declare const zulipAgentPromptAdapter: NonNullable<ChannelPlugin["agentPrompt"]>;
+//# sourceMappingURL=agent-prompt.d.ts.map

package/dist/agent-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-prompt.d.ts","sourceRoot":"","sources":["../src/agent-prompt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAM9D,eAAO,MAAM,uBAAuB,EAAE,WAAW,CAAC,aAAa,CAAC,aAAa,CAAC,CAiB7E,CAAC"}

package/dist/agent-prompt.js

@@ -0,0 +1,21 @@
+// ---------------------------------------------------------------------------
+// Agent prompt adapter — Zulip-specific hints for the AI agent
+// ---------------------------------------------------------------------------
+export const zulipAgentPromptAdapter = {
+    messageToolHints() {
+        return [
+            "Zulip uses Markdown for formatting (bold, italic, code blocks, links, lists).",
+            "Stream messages require a topic. Topics organize conversations within a stream.",
+            "Use @-mentions (@**Full Name**) to notify specific users.",
+            "Emoji syntax: :emoji_name: (e.g. :thumbs_up:, :heart:).",
+            "LaTeX math is supported: $$formula$$ for display, $formula$ for inline.",
+        ];
+    },
+    reactionGuidance() {
+        return {
+            level: "extensive",
+            channelLabel: "Zulip",
+        };
+    },
+};
+//# sourceMappingURL=agent-prompt.js.map

package/dist/agent-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-prompt.js","sourceRoot":"","sources":["../src/agent-prompt.ts"],"names":[],"mappings":"AAEA,8EAA8E;AAC9E,+DAA+D;AAC/D,8EAA8E;AAE9E,MAAM,CAAC,MAAM,uBAAuB,GAA8C;IAChF,gBAAgB;QACd,OAAO;YACL,+EAA+E;YAC/E,iFAAiF;YACjF,2DAA2D;YAC3D,yDAAyD;YACzD,yEAAyE;SAC1E,CAAC;IACJ,CAAC;IAED,gBAAgB;QACd,OAAO;YACL,KAAK,EAAE,WAAW;YAClB,YAAY,EAAE,OAAO;SACtB,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/allowlist.d.ts

@@ -0,0 +1,3 @@
+import type { ChannelPlugin } from "openclaw/plugin-sdk/core";
+export declare const zulipAllowlistAdapter: NonNullable<ChannelPlugin["allowlist"]>;
+//# sourceMappingURL=allowlist.d.ts.map

package/dist/allowlist.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"allowlist.d.ts","sourceRoot":"","sources":["../src/allowlist.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAU9D,eAAO,MAAM,qBAAqB,EAAE,WAAW,CAAC,aAAa,CAAC,WAAW,CAAC,CA+CzE,CAAC"}

package/dist/allowlist.js

@@ -0,0 +1,50 @@
+import { resolveZulipAccount } from "./config.js";
+const SECTION_KEY = "zulip";
+// ---------------------------------------------------------------------------
+// Allowlist adapter — DM allow-from management
+// ---------------------------------------------------------------------------
+export const zulipAllowlistAdapter = {
+    applyConfigEdit({ cfg, parsedConfig, accountId, scope, action, entry }) {
+        if (scope !== "dm")
+            return { kind: "invalid-entry" };
+        const id = accountId ?? "default";
+        const path = `channels.${SECTION_KEY}.accounts.${id}.allowFrom`;
+        // Read current allowFrom
+        const section = cfg.channels?.zulip;
+        const accountCfg = section?.accounts?.[id];
+        const current = accountCfg?.allowFrom ?? section?.allowFrom ?? [];
+        let next;
+        if (action === "add") {
+            if (current.includes(entry))
+                return { kind: "ok", changed: false, pathLabel: path, writeTarget: { kind: "global" } };
+            next = [...current, entry];
+        }
+        else {
+            next = current.filter((e) => e !== entry);
+            if (next.length === current.length)
+                return { kind: "ok", changed: false, pathLabel: path, writeTarget: { kind: "global" } };
+        }
+        // Apply to parsed config
+        const accounts = parsedConfig.accounts ?? {};
+        const acct = accounts[id] ?? {};
+        acct.allowFrom = next;
+        accounts[id] = acct;
+        parsedConfig.accounts = accounts;
+        return { kind: "ok", changed: true, pathLabel: path, writeTarget: { kind: "global" } };
+    },
+    readConfig({ cfg, accountId }) {
+        const account = resolveZulipAccount(cfg, accountId);
+        return {
+            dmAllowFrom: account.allowFrom,
+            dmPolicy: account.dmPolicy,
+        };
+    },
+    resolveNames({ entries }) {
+        // Zulip entries are emails or user IDs — no transformation needed
+        return entries.map((input) => ({ input, resolved: true, name: input }));
+    },
+    supportsScope({ scope }) {
+        return scope === "dm" || scope === "all";
+    },
+};
+//# sourceMappingURL=allowlist.js.map

package/dist/allowlist.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"allowlist.js","sourceRoot":"","sources":["../src/allowlist.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAElD,MAAM,WAAW,GAAG,OAAO,CAAC;AAE5B,8EAA8E;AAC9E,+CAA+C;AAC/C,8EAA8E;AAE9E,MAAM,CAAC,MAAM,qBAAqB,GAA4C;IAC5E,eAAe,CAAC,EAAE,GAAG,EAAE,YAAY,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE;QACpE,IAAI,KAAK,KAAK,IAAI;YAAE,OAAO,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC;QAErD,MAAM,EAAE,GAAG,SAAS,IAAI,SAAS,CAAC;QAClC,MAAM,IAAI,GAAG,YAAY,WAAW,aAAa,EAAE,YAAY,CAAC;QAEhE,yBAAyB;QACzB,MAAM,OAAO,GAAI,GAAkB,CAAC,QAAQ,EAAE,KAAK,CAAC;QACpD,MAAM,UAAU,GAAG,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC;QAC3C,MAAM,OAAO,GAA2B,UAAU,EAAE,SAAS,IAAI,OAAO,EAAE,SAAS,IAAI,EAAE,CAAC;QAE1F,IAAI,IAA4B,CAAC;QACjC,IAAI,MAAM,KAAK,KAAK,EAAE,CAAC;YACrB,IAAI,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;gBAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,CAAC;YACrH,IAAI,GAAG,CAAC,GAAG,OAAO,EAAE,KAAK,CAAC,CAAC;QAC7B,CAAC;aAAM,CAAC;YACN,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC;YAC1C,IAAI,IAAI,CAAC,MAAM,KAAK,OAAO,CAAC,MAAM;gBAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,CAAC;QAC9H,CAAC;QAED,yBAAyB;QACzB,MAAM,QAAQ,GAAI,YAAwC,CAAC,QAA+D,IAAI,EAAE,CAAC;QACjI,MAAM,IAAI,GAAG,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC;QAChC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACtB,QAAQ,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC;QACnB,YAAwC,CAAC,QAAQ,GAAG,QAAQ,CAAC;QAE9D,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,CAAC;IACzF,CAAC;IAED,UAAU,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE;QAC3B,MAAM,OAAO,GAAG,mBAAmB,CAAC,GAAiB,EAAE,SAAS,CAAC,CAAC;QAClE,OAAO;YACL,WAAW,EAAE,OAAO,CAAC,SAAS;YAC9B,QAAQ,EAAE,OAAO,CAAC,QAAQ;SAC3B,CAAC;IACJ,CAAC;IAED,YAAY,CAAC,EAAE,OAAO,EAAE;QACtB,kEAAkE;QAClE,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;IAC1E,CAAC;IAED,aAAa,CAAC,EAAE,KAAK,EAAE;QACrB,OAAO,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,KAAK,CAAC;IAC3C,CAAC;CACF,CAAC"}

package/dist/bindings.d.ts

@@ -0,0 +1,24 @@
+import type { ChannelPlugin } from "openclaw/plugin-sdk";
+import type { SessionBindingAdapter } from "openclaw/plugin-sdk/conversation-runtime";
+type ChannelConfiguredBindingProvider = NonNullable<ChannelPlugin["bindings"]>;
+type ChannelConversationBindingSupport = NonNullable<ChannelPlugin["conversationBindings"]>;
+export type ZulipTopicBinding = {
+    bindingId: string;
+    accountId: string;
+    conversationId: string;
+    parentConversationId?: string;
+    targetSessionKey: string;
+    targetKind: "subagent" | "session";
+    boundAt: number;
+    lastActivityAt: number;
+    idleTimeoutMs?: number;
+    maxAgeMs?: number;
+};
+export declare function getZulipBindingStore(accountId: string): Map<string, ZulipTopicBinding>;
+export declare function clearZulipBindingStore(accountId: string): void;
+export declare function touchZulipBindingByConversation(accountId: string, conversationId: string, at?: number): void;
+export declare function createZulipSessionBindingAdapter(accountId: string): SessionBindingAdapter;
+export declare const zulipBindingsAdapter: ChannelConfiguredBindingProvider;
+export declare const zulipConversationBindingsSupport: ChannelConversationBindingSupport;
+export {};
+//# sourceMappingURL=bindings.d.ts.map

package/dist/bindings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bindings.d.ts","sourceRoot":"","sources":["../src/bindings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EACV,qBAAqB,EAItB,MAAM,0CAA0C,CAAC;AAElD,KAAK,gCAAgC,GAAG,WAAW,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC,CAAC;AAC/E,KAAK,iCAAiC,GAAG,WAAW,CAAC,aAAa,CAAC,sBAAsB,CAAC,CAAC,CAAC;AAM5F,MAAM,MAAM,iBAAiB,GAAG;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,UAAU,GAAG,SAAS,CAAC;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAMF,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAOtF;AAED,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAE9D;AAED,wBAAgB,+BAA+B,CAC7C,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,MAAM,EACtB,EAAE,CAAC,EAAE,MAAM,GACV,IAAI,CAQN;AAsCD,wBAAgB,gCAAgC,CAC9C,SAAS,EAAE,MAAM,GAChB,qBAAqB,CAsEvB;AAgBD,eAAO,MAAM,oBAAoB,EAAE,gCAwElC,CAAC;AAiCF,eAAO,MAAM,gCAAgC,EAAE,iCA4C9C,CAAC"}