@vibearound/plugin-channel-sdk 0.1.2 → 0.3.0

package/dist/errors.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Error normalization for channel plugins.
+ *
+ * Every plugin had an ad-hoc ladder that tried `instanceof Error`, then
+ * `typeof error === "object"`, then fell back to `String(error)`. That
+ * ladder lived in five slightly-different forms across bot.ts files and
+ * drifted over time. Centralize it here.
+ */
+/**
+ * Extract a human-readable message from an unknown thrown value.
+ *
+ * Prefers `Error.message`, falls back to a non-circular JSON stringify for
+ * objects, and finally to `String(e)` for primitives.
+ */
+export declare function extractErrorMessage(e: unknown): string;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,CAatD"}

package/dist/errors.js

@@ -0,0 +1,33 @@
+/**
+ * Error normalization for channel plugins.
+ *
+ * Every plugin had an ad-hoc ladder that tried `instanceof Error`, then
+ * `typeof error === "object"`, then fell back to `String(error)`. That
+ * ladder lived in five slightly-different forms across bot.ts files and
+ * drifted over time. Centralize it here.
+ */
+/**
+ * Extract a human-readable message from an unknown thrown value.
+ *
+ * Prefers `Error.message`, falls back to a non-circular JSON stringify for
+ * objects, and finally to `String(e)` for primitives.
+ */
+export function extractErrorMessage(e) {
+    if (e instanceof Error)
+        return e.message;
+    if (typeof e === "string")
+        return e;
+    if (e && typeof e === "object") {
+        const msg = e.message;
+        if (typeof msg === "string")
+            return msg;
+        try {
+            return JSON.stringify(e);
+        }
+        catch {
+            return String(e);
+        }
+    }
+    return String(e);
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,CAAU;IAC5C,IAAI,CAAC,YAAY,KAAK;QAAE,OAAO,CAAC,CAAC,OAAO,CAAC;IACzC,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,CAAC,CAAC;IACpC,IAAI,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;QAC/B,MAAM,GAAG,GAAI,CAA2B,CAAC,OAAO,CAAC;QACjD,IAAI,OAAO,GAAG,KAAK,QAAQ;YAAE,OAAO,GAAG,CAAC;QACxC,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;QAC3B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;QACnB,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;AACnB,CAAC"}

package/dist/index.d.ts

@@ -54,6 +54,9 @@
  */
 export { connectToHost, normalizeExtMethod, redirectConsoleToStderr } from "./connection.js";
 export type { PluginInfo, ConnectResult, AgentInfo } from "./connection.js";
+export { extractErrorMessage } from "./errors.js";
+export { runChannelPlugin } from "./run-plugin.js";
+export type { ChannelBot, ChannelPluginLogger, ChannelStreamHandler, CreateBotContext, RunChannelPluginSpec, VerboseOptions, } from "./run-plugin.js";
 export { BlockRenderer } from "./renderer.js";
 export type { Agent, Client, ContentBlock, SessionNotification, RequestPermissionRequest, RequestPermissionResponse, BlockKind, VerboseConfig, BlockRendererOptions, PluginCapabilities, PluginManifest, PluginInitMeta, } from "./types.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG;AAGH,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAC7F,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAG5E,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAG9C,YAAY,EAEV,KAAK,EACL,MAAM,EACN,YAAY,EACZ,mBAAmB,EACnB,wBAAwB,EACxB,yBAAyB,EAEzB,SAAS,EACT,aAAa,EACb,oBAAoB,EACpB,kBAAkB,EAClB,cAAc,EACd,cAAc,GACf,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG;AAGH,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAC7F,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAG5E,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAGlD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,YAAY,EACV,UAAU,EACV,mBAAmB,EACnB,oBAAoB,EACpB,gBAAgB,EAChB,oBAAoB,EACpB,cAAc,GACf,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAI9C,YAAY,EAEV,KAAK,EACL,MAAM,EACN,YAAY,EACZ,mBAAmB,EACnB,wBAAwB,EACxB,yBAAyB,EAEzB,SAAS,EACT,aAAa,EACb,oBAAoB,EACpB,kBAAkB,EAClB,cAAc,EACd,cAAc,GACf,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -54,6 +54,10 @@
  */
 // Connection helpers
 export { connectToHost, normalizeExtMethod, redirectConsoleToStderr } from "./connection.js";
+// Error normalization
+export { extractErrorMessage } from "./errors.js";
+// Plugin runner (absorbs the main.ts boilerplate)
+export { runChannelPlugin } from "./run-plugin.js";
 // Block renderer
 export { BlockRenderer } from "./renderer.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG;AAEH,qBAAqB;AACrB,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAG7F,iBAAiB;AACjB,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG;AAEH,qBAAqB;AACrB,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAG7F,sBAAsB;AACtB,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAElD,kDAAkD;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAUnD,iBAAiB;AACjB,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC"}

package/dist/renderer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"renderer.d.ts","sourceRoot":"","sources":["../src/renderer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,KAAK,EAAE,SAAS,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAuCjF;;;;;;GAMG;AACH,8BAAsB,aAAa,CAAC,IAAI,GAAG,MAAM;IAC/C,SAAS,CAAC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IAC3C,SAAS,CAAC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IAC7C,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAE1C,OAAO,CAAC,MAAM,CAAyC;gBAE3C,OAAO,GAAE,oBAAyB;IAa9C;;;;;OAKG;IACH,SAAS,CAAC,QAAQ,CAAC,SAAS,CAC1B,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,SAAS,EACf,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;IAEvB;;;;;;;;OAQG;IACH,SAAS,CAAC,SAAS,CAAC,CAClB,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,IAAI,EACT,IAAI,EAAE,SAAS,EACf,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,OAAO,GACd,OAAO,CAAC,IAAI,CAAC;IAEhB;;;;;;;;;OASG;IACH,SAAS,CAAC,aAAa,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM;IAQnF;;;;OAIG;IACH,SAAS,CAAC,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI3D;;;OAGG;IACH,SAAS,CAAC,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7E;;;;;;;OAOG;IACH,SAAS,CAAC,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAQzD;;;;;;;OAOG;IACH,eAAe,CAAC,YAAY,EAAE,mBAAmB,GAAG,IAAI;IAqCxD;;;;;OAKG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAWrC;;;;;OAKG;IACG,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBjD;;;;;OAKG;IACG,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWlE,OAAO,CAAC,aAAa;IA8BrB,OAAO,CAAC,aAAa;IASrB,OAAO,CAAC,KAAK;IAoBb,OAAO,CAAC,YAAY;YAMN,UAAU;CAqBzB"}
+{"version":3,"file":"renderer.d.ts","sourceRoot":"","sources":["../src/renderer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,KAAK,EAAE,SAAS,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AA6EjF;;;;;;GAMG;AACH,8BAAsB,aAAa,CAAC,IAAI,GAAG,MAAM;IAC/C,SAAS,CAAC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IAC3C,SAAS,CAAC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IAC7C,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAE1C,OAAO,CAAC,MAAM,CAAyC;gBAE3C,OAAO,GAAE,oBAAyB;IAa9C;;;;;OAKG;IACH,SAAS,CAAC,QAAQ,CAAC,SAAS,CAC1B,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,SAAS,EACf,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;IAEvB;;;;;;;;OAQG;IACH,SAAS,CAAC,SAAS,CAAC,CAClB,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,IAAI,EACT,IAAI,EAAE,SAAS,EACf,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,OAAO,GACd,OAAO,CAAC,IAAI,CAAC;IAEhB;;;;;;;;;OASG;IACH,SAAS,CAAC,aAAa,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM;IAQnF;;;;OAIG;IACH,SAAS,CAAC,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI3D;;;OAGG;IACH,SAAS,CAAC,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7E;;;;;;;OAOG;IACH,SAAS,CAAC,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAQzD;;;;;;;OAOG;IACH,eAAe,CAAC,YAAY,EAAE,mBAAmB,GAAG,IAAI;IAgDxD;;;;;OAKG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAWrC;;;;;OAKG;IACG,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBjD;;;;;OAKG;IACG,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWlE,OAAO,CAAC,aAAa;IA8BrB,OAAO,CAAC,aAAa;IASrB,OAAO,CAAC,KAAK;IA+Bb,OAAO,CAAC,YAAY;YAMN,UAAU;CAqBzB"}

package/dist/renderer.js

@@ -136,13 +136,23 @@ export class BlockRenderer {
      */
     onSessionUpdate(notification) {
         const sessionId = notification.sessionId;
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        const update = notification.update;
-        const variant = update.sessionUpdate;
+        // Narrow through the local ConsumedSessionUpdate union — see the type
+        // declaration above this class for why we re-declare it locally instead
+        // of importing the SDK's own union. Variants other than the four we
+        // handle are treated as no-ops.
+        const rawUpdate = notification.update;
+        const variant = rawUpdate.sessionUpdate;
+        if (variant !== "agent_message_chunk" &&
+            variant !== "agent_thought_chunk" &&
+            variant !== "tool_call" &&
+            variant !== "tool_call_update") {
+            return;
+        }
+        const update = rawUpdate;
         const channelId = this.sessionIdToChannelId(sessionId);
-        switch (variant) {
+        switch (update.sessionUpdate) {
             case "agent_message_chunk": {
-                const delta = (update.content?.text ?? "");
+                const delta = update.content?.text ?? "";
                 if (delta)
                     this.appendToBlock(channelId, "text", delta);
                 break;
@@ -150,7 +160,7 @@ export class BlockRenderer {
             case "agent_thought_chunk": {
                 if (!this.verbose.showThinking)
                     return; // skip — no block, no boundary
-                const delta = (update.content?.text ?? "");
+                const delta = update.content?.text ?? "";
                 if (delta)
                     this.appendToBlock(channelId, "thinking", delta);
                 break;
@@ -158,21 +168,20 @@ export class BlockRenderer {
             case "tool_call": {
                 if (!this.verbose.showToolUse)
                     return; // skip
-                const title = update.title;
-                if (title)
-                    this.appendToBlock(channelId, "tool", `🔧 ${title}\n`);
+                if (update.title)
+                    this.appendToBlock(channelId, "tool", `🔧 ${update.title}\n`);
                 break;
             }
             case "tool_call_update": {
                 if (!this.verbose.showToolUse)
                     return; // skip
-                const title = (update.title ?? "tool");
-                const status = update.status;
-                if (status === "completed" || status === "error") {
+                const title = update.title ?? "tool";
+                if (update.status === "completed" || update.status === "error") {
                     this.appendToBlock(channelId, "tool", `✅ ${title}\n`);
                 }
                 break;
             }
+            // Unknown / unconsumed variant — ignore.
         }
     }
     /**
@@ -271,6 +280,16 @@ export class BlockRenderer {
         const block = state.blocks.at(-1);
         if (!block || block.sealed || !block.content)
             return;
+        // Send-only mode: subclasses that don't override `editBlock` (e.g.
+        // QQ Bot, where the platform has no edit support) would otherwise
+        // POST a new message for every debounced flush, so the user sees a
+        // partial chunk followed by the full message as two separate
+        // deliveries. Defer intermediate sends; only `onTurnEnd` and block
+        // boundary transitions inside `appendToBlock` (which seal the block
+        // first) will actually POST.
+        if (!this.editBlock) {
+            return;
+        }
         const now = Date.now();
         if (now - state.lastEditMs < this.minEditIntervalMs) {
             // Throttled — reschedule for the remaining window

package/dist/renderer.js.map

@@ -1 +1 @@
-{"version":3,"file":"renderer.js","sourceRoot":"","sources":["../src/renderer.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"renderer.js","sourceRoot":"","sources":["../src/renderer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG;AAqEH,8EAA8E;AAC9E,YAAY;AACZ,8EAA8E;AAE9E,MAAM,yBAAyB,GAAG,GAAG,CAAC;AACtC,MAAM,4BAA4B,GAAG,IAAI,CAAC;AAE1C,8EAA8E;AAC9E,gBAAgB;AAChB,8EAA8E;AAE9E;;;;;;GAMG;AACH,MAAM,OAAgB,aAAa;IACd,eAAe,CAAS;IACxB,iBAAiB,CAAS;IAC1B,OAAO,CAAgB;IAElC,MAAM,GAAG,IAAI,GAAG,EAA8B,CAAC;IAEvD,YAAY,UAAgC,EAAE;QAC5C,IAAI,CAAC,eAAe,GAAG,OAAO,CAAC,eAAe,IAAI,yBAAyB,CAAC;QAC5E,IAAI,CAAC,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,IAAI,4BAA4B,CAAC;QACnF,IAAI,CAAC,OAAO,GAAG;YACb,YAAY,EAAE,OAAO,CAAC,OAAO,EAAE,YAAY,IAAI,KAAK;YACpD,WAAW,EAAE,OAAO,CAAC,OAAO,EAAE,WAAW,IAAI,KAAK;SACnD,CAAC;IACJ,CAAC;IAmCD;;;;;;;;;OASG;IACO,aAAa,CAAC,IAAe,EAAE,OAAe,EAAE,OAAgB;QACxE,QAAQ,IAAI,EAAE,CAAC;YACb,KAAK,UAAU,CAAC,CAAC,OAAO,MAAM,OAAO,EAAE,CAAC;YACxC,KAAK,MAAM,CAAC,CAAK,OAAO,OAAO,CAAC,IAAI,EAAE,CAAC;YACvC,KAAK,MAAM,CAAC,CAAK,OAAO,OAAO,CAAC;QAClC,CAAC;IACH,CAAC;IAED;;;;OAIG;IACO,cAAc,CAAC,UAAkB;QACzC,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC3B,CAAC;IAED;;;OAGG;IACO,gBAAgB,CAAC,UAAkB,EAAE,MAAc;QAC3D,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC3B,CAAC;IAED;;;;;;;OAOG;IACO,oBAAoB,CAAC,SAAiB;QAC9C,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,8EAA8E;IAC9E,aAAa;IACb,8EAA8E;IAE9E;;;;;;;OAOG;IACH,eAAe,CAAC,YAAiC;QAC/C,MAAM,SAAS,GAAG,YAAY,CAAC,SAAS,CAAC;QACzC,sEAAsE;QACtE,wEAAwE;QACxE,oEAAoE;QACpE,gCAAgC;QAChC,MAAM,SAAS,GAAG,YAAY,CAAC,MAA8C,CAAC;QAC9E,MAAM,OAAO,GAAG,SAAS,CAAC,aAAa,CAAC;QACxC,IACE,OAAO,KAAK,qBAAqB;YACjC,OAAO,KAAK,qBAAqB;YACjC,OAAO,KAAK,WAAW;YACvB,OAAO,KAAK,kBAAkB,EAC9B,CAAC;YACD,OAAO;QACT,CAAC;QACD,MAAM,MAAM,GAAG,SAAkC,CAAC;QAClD,MAAM,SAAS,GAAG,IAAI,CAAC,oBAAoB,CAAC,SAAS,CAAC,CAAC;QAEvD,QAAQ,MAAM,CAAC,aAAa,EAAE,CAAC;YAC7B,KAAK,qBAAqB,CAAC,CAAC,CAAC;gBAC3B,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,EAAE,IAAI,IAAI,EAAE,CAAC;gBACzC,IAAI,KAAK;oBAAE,IAAI,CAAC,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;gBACxD,MAAM;YACR,CAAC;YACD,KAAK,qBAAqB,CAAC,CAAC,CAAC;gBAC3B,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY;oBAAE,OAAO,CAAC,+BAA+B;gBACvE,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,EAAE,IAAI,IAAI,EAAE,CAAC;gBACzC,IAAI,KAAK;oBAAE,IAAI,CAAC,aAAa,CAAC,SAAS,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC;gBAC5D,MAAM;YACR,CAAC;YACD,KAAK,WAAW,CAAC,CAAC,CAAC;gBACjB,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW;oBAAE,OAAO,CAAC,OAAO;gBAC9C,IAAI,MAAM,CAAC,KAAK;oBAAE,IAAI,CAAC,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC,KAAK,IAAI,CAAC,CAAC;gBAChF,MAAM;YACR,CAAC;YACD,KAAK,kBAAkB,CAAC,CAAC,CAAC;gBACxB,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW;oBAAE,OAAO,CAAC,OAAO;gBAC9C,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC;gBACrC,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW,IAAI,MAAM,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;oBAC/D,IAAI,CAAC,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,KAAK,IAAI,CAAC,CAAC;gBACxD,CAAC;gBACD,MAAM;YACR,CAAC;YACD,yCAAyC;QAC3C,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,YAAY,CAAC,SAAiB;QAC5B,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACvC,IAAI,GAAG,EAAE,UAAU;YAAE,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAClD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE;YACzB,MAAM,EAAE,EAAE;YACV,UAAU,EAAE,IAAI;YAChB,UAAU,EAAE,CAAC;YACb,SAAS,EAAE,OAAO,CAAC,OAAO,EAAE;SAC7B,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,SAAS,CAAC,SAAiB;QAC/B,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACzC,IAAI,CAAC,KAAK;YAAE,OAAO;QAEnB,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;YACrB,YAAY,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;YAC/B,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC;QAC1B,CAAC;QAED,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QACjC,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACzB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;YACnB,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QACjC,CAAC;QAED,oDAAoD;QACpD,MAAM,KAAK,CAAC,SAAS,CAAC;QACtB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAC9B,MAAM,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC;IACvC,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,WAAW,CAAC,SAAiB,EAAE,KAAa;QAChD,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACzC,IAAI,KAAK,EAAE,UAAU;YAAE,YAAY,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QACtD,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAC9B,MAAM,IAAI,CAAC,gBAAgB,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IAChD,CAAC;IAED,8EAA8E;IAC9E,8BAA8B;IAC9B,8EAA8E;IAEtE,aAAa,CAAC,SAAiB,EAAE,IAAe,EAAE,KAAa;QACrE,IAAI,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACvC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,8EAA8E;YAC9E,KAAK,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;YACtF,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QACpC,CAAC;QAED,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAEjC,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;YAC/C,yBAAyB;YACzB,IAAI,CAAC,OAAO,IAAI,KAAK,CAAC;QACxB,CAAC;aAAM,CAAC;YACN,wDAAwD;YACxD,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;gBACzB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;gBACnB,+EAA+E;gBAC/E,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;oBACrB,YAAY,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;oBAC/B,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC;gBAC1B,CAAC;gBACD,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;YACjC,CAAC;YACD,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;QACpG,CAAC;QAED,IAAI,CAAC,aAAa,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IACvC,CAAC;IAEO,aAAa,CAAC,SAAiB,EAAE,KAAyB;QAChE,IAAI,KAAK,CAAC,UAAU;YAAE,OAAO,CAAC,oBAAoB;QAElD,KAAK,CAAC,UAAU,GAAG,UAAU,CAAC,GAAG,EAAE;YACjC,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC;YACxB,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QAC/B,CAAC,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC;IAC3B,CAAC;IAEO,KAAK,CAAC,SAAiB,EAAE,KAAyB;QACxD,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAClC,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO;YAAE,OAAO;QAErD,mEAAmE;QACnE,kEAAkE;QAClE,mEAAmE;QACnE,6DAA6D;QAC7D,mEAAmE;QACnE,oEAAoE;QACpE,6BAA6B;QAC7B,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,OAAO;QACT,CAAC;QAED,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,IAAI,GAAG,GAAG,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC,iBAAiB,EAAE,CAAC;YACpD,kDAAkD;YAClD,MAAM,KAAK,GAAG,IAAI,CAAC,iBAAiB,GAAG,CAAC,GAAG,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC;YAChE,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC;gBACtB,KAAK,CAAC,UAAU,GAAG,UAAU,CAAC,GAAG,EAAE;oBACjC,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC;oBACxB,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;gBAC/B,CAAC,EAAE,KAAK,CAAC,CAAC;YACZ,CAAC;YACD,OAAO;QACT,CAAC;QAED,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAClC,CAAC;IAEO,YAAY,CAAC,KAAyB,EAAE,KAAyB;QACvE,KAAK,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS;aAC9B,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;aACzC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC,CAAC,uCAAuC;IAC7D,CAAC;IAEO,KAAK,CAAC,UAAU,CAAC,KAAyB,EAAE,KAAyB;QAC3E,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;QAC5E,IAAI,CAAC,OAAO;YAAE,OAAO;QAErB,IAAI,CAAC;YACH,IAAI,KAAK,CAAC,GAAG,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;gBAC1C,0DAA0D;gBAC1D,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC;gBACtB,KAAK,CAAC,GAAG,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;gBACvE,KAAK,CAAC,QAAQ,GAAG,KAAK,CAAC;gBACvB,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAChC,CAAC;iBAAM,IAAI,KAAK,CAAC,GAAG,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,QAAQ,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;gBACnE,oCAAoC;gBACpC,MAAM,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;gBACpF,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAChC,CAAC;YACD,uDAAuD;QACzD,CAAC;QAAC,MAAM,CAAC;YACP,KAAK,CAAC,QAAQ,GAAG,KAAK,CAAC;QACzB,CAAC;IACH,CAAC;CACF"}

package/dist/run-plugin.d.ts

@@ -0,0 +1,95 @@
+/**
+ * runChannelPlugin — shared main.ts boilerplate for every channel plugin.
+ *
+ * Each channel plugin used to have a ~120-line `main.ts` that was 85%
+ * identical across Slack, Telegram, Discord, DingTalk, WeCom, etc:
+ * connect to host, validate config keys, wire the standard sessionUpdate
+ * and extNotification handlers, create the stream handler, start the bot,
+ * wait for disconnect, stop. This helper absorbs that boilerplate so each
+ * plugin's `main.ts` reduces to ~20 lines — a factory for the bot and a
+ * factory for the stream handler.
+ *
+ * ## Usage
+ *
+ * ```ts
+ * import { runChannelPlugin } from "@vibearound/plugin-channel-sdk";
+ * import { SlackBot } from "./bot.js";
+ * import { AgentStreamHandler } from "./agent-stream.js";
+ *
+ * runChannelPlugin({
+ *   name: "vibearound-slack",
+ *   version: "0.1.0",
+ *   requiredConfig: ["bot_token", "app_token"],
+ *   createBot: ({ config, agent, log, cacheDir }) =>
+ *     new SlackBot(
+ *       { bot_token: config.bot_token as string, app_token: config.app_token as string },
+ *       agent,
+ *       log,
+ *       cacheDir,
+ *     ),
+ *   createStreamHandler: (bot, log, verbose) =>
+ *     new AgentStreamHandler(bot, log, verbose),
+ * });
+ * ```
+ */
+import type { Agent } from "@agentclientprotocol/sdk";
+import type { SessionNotification } from "./types.js";
+export type ChannelPluginLogger = (level: string, msg: string) => void;
+export interface ChannelStreamHandler {
+    onSessionUpdate(params: SessionNotification): void;
+    onSystemText(text: string): void;
+    onAgentReady(agent: string, version: string): void;
+    onSessionReady(sessionId: string): void;
+}
+export interface ChannelBot<THandler extends ChannelStreamHandler = ChannelStreamHandler> {
+    setStreamHandler(handler: THandler): void;
+    start(): Promise<void> | void;
+    stop(): Promise<void> | void;
+}
+export interface CreateBotContext {
+    config: Record<string, unknown>;
+    agent: Agent;
+    log: ChannelPluginLogger;
+    cacheDir: string;
+}
+export interface VerboseOptions {
+    showThinking: boolean;
+    showToolUse: boolean;
+}
+export interface RunChannelPluginSpec<TBot extends ChannelBot<THandler>, THandler extends ChannelStreamHandler> {
+    /** Plugin name reported during ACP initialize (e.g. "vibearound-slack"). */
+    name: string;
+    /** Plugin version reported during ACP initialize. */
+    version: string;
+    /**
+     * Config keys that MUST be present on `meta.config`. Plugin startup
+     * fails with a clear error if any are missing. Keep to primitives
+     * (strings/booleans); deeper validation belongs in the bot constructor.
+     */
+    requiredConfig?: string[];
+    /** Factory: build the platform bot from host-supplied config + agent. */
+    createBot: (ctx: CreateBotContext) => TBot | Promise<TBot>;
+    /**
+     * Factory: build the agent stream handler for this plugin. The handler
+     * is wired to the bot via `bot.setStreamHandler(handler)` before the
+     * bot is started.
+     */
+    createStreamHandler: (bot: TBot, log: ChannelPluginLogger, verbose: VerboseOptions) => THandler;
+    /**
+     * Optional hook invoked after the bot has been constructed but before
+     * `start()` is called. Use this for one-off initialization that needs
+     * to log diagnostic info (e.g. Telegram's `probe()`).
+     */
+    afterCreate?: (bot: TBot, log: ChannelPluginLogger) => Promise<void> | void;
+}
+/**
+ * Run a channel plugin to completion.
+ *
+ * Performs the ACP initialize handshake, validates required config,
+ * constructs the bot + stream handler, starts the bot, waits for the host
+ * connection to close, then stops the bot and exits the process.
+ *
+ * Never returns under normal operation — the process exits at the end.
+ */
+export declare function runChannelPlugin<TBot extends ChannelBot<THandler>, THandler extends ChannelStreamHandler>(spec: RunChannelPluginSpec<TBot, THandler>): Promise<void>;
+//# sourceMappingURL=run-plugin.d.ts.map

package/dist/run-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-plugin.d.ts","sourceRoot":"","sources":["../src/run-plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAIH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AAItD,OAAO,KAAK,EAGV,mBAAmB,EACpB,MAAM,YAAY,CAAC;AAMpB,MAAM,MAAM,mBAAmB,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;AAEvE,MAAM,WAAW,oBAAoB;IACnC,eAAe,CAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACnD,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACnD,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CACzC;AAED,MAAM,WAAW,UAAU,CAAC,QAAQ,SAAS,oBAAoB,GAAG,oBAAoB;IACtF,gBAAgB,CAAC,OAAO,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC1C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC9B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAC9B;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,KAAK,EAAE,KAAK,CAAC;IACb,GAAG,EAAE,mBAAmB,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,OAAO,CAAC;IACtB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,oBAAoB,CACnC,IAAI,SAAS,UAAU,CAAC,QAAQ,CAAC,EACjC,QAAQ,SAAS,oBAAoB;IAErC,4EAA4E;IAC5E,IAAI,EAAE,MAAM,CAAC;IAEb,qDAAqD;IACrD,OAAO,EAAE,MAAM,CAAC;IAEhB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAE1B,yEAAyE;IACzE,SAAS,EAAE,CAAC,GAAG,EAAE,gBAAgB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE3D;;;;OAIG;IACH,mBAAmB,EAAE,CACnB,GAAG,EAAE,IAAI,EACT,GAAG,EAAE,mBAAmB,EACxB,OAAO,EAAE,cAAc,KACpB,QAAQ,CAAC;IAEd;;;;OAIG;IACH,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,mBAAmB,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAC7E;AAMD;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,SAAS,UAAU,CAAC,QAAQ,CAAC,EACjC,QAAQ,SAAS,oBAAoB,EACrC,IAAI,EAAE,oBAAoB,CAAC,IAAI,EAAE,QAAQ,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAY3D"}

package/dist/run-plugin.js

@@ -0,0 +1,132 @@
+/**
+ * runChannelPlugin — shared main.ts boilerplate for every channel plugin.
+ *
+ * Each channel plugin used to have a ~120-line `main.ts` that was 85%
+ * identical across Slack, Telegram, Discord, DingTalk, WeCom, etc:
+ * connect to host, validate config keys, wire the standard sessionUpdate
+ * and extNotification handlers, create the stream handler, start the bot,
+ * wait for disconnect, stop. This helper absorbs that boilerplate so each
+ * plugin's `main.ts` reduces to ~20 lines — a factory for the bot and a
+ * factory for the stream handler.
+ *
+ * ## Usage
+ *
+ * ```ts
+ * import { runChannelPlugin } from "@vibearound/plugin-channel-sdk";
+ * import { SlackBot } from "./bot.js";
+ * import { AgentStreamHandler } from "./agent-stream.js";
+ *
+ * runChannelPlugin({
+ *   name: "vibearound-slack",
+ *   version: "0.1.0",
+ *   requiredConfig: ["bot_token", "app_token"],
+ *   createBot: ({ config, agent, log, cacheDir }) =>
+ *     new SlackBot(
+ *       { bot_token: config.bot_token as string, app_token: config.app_token as string },
+ *       agent,
+ *       log,
+ *       cacheDir,
+ *     ),
+ *   createStreamHandler: (bot, log, verbose) =>
+ *     new AgentStreamHandler(bot, log, verbose),
+ * });
+ * ```
+ */
+import os from "node:os";
+import path from "node:path";
+import { connectToHost, normalizeExtMethod } from "./connection.js";
+import { extractErrorMessage } from "./errors.js";
+// ---------------------------------------------------------------------------
+// Implementation
+// ---------------------------------------------------------------------------
+/**
+ * Run a channel plugin to completion.
+ *
+ * Performs the ACP initialize handshake, validates required config,
+ * constructs the bot + stream handler, starts the bot, waits for the host
+ * connection to close, then stops the bot and exits the process.
+ *
+ * Never returns under normal operation — the process exits at the end.
+ */
+export async function runChannelPlugin(spec) {
+    const prefix = `[${spec.name.replace(/^vibearound-/, "")}-plugin]`;
+    const log = (level, msg) => {
+        process.stderr.write(`${prefix}[${level}] ${msg}\n`);
+    };
+    try {
+        await runInner(spec, log);
+    }
+    catch (err) {
+        log("error", `fatal: ${extractErrorMessage(err)}`);
+        process.exit(1);
+    }
+}
+async function runInner(spec, log) {
+    log("info", "initializing ACP connection...");
+    let streamHandler = null;
+    const { agent, meta, agentInfo, conn } = await connectToHost({ name: spec.name, version: spec.version }, () => ({
+        async sessionUpdate(params) {
+            streamHandler?.onSessionUpdate(params);
+        },
+        async requestPermission(params) {
+            const first = params.options?.[0];
+            if (first) {
+                return { outcome: { outcome: "selected", optionId: first.optionId } };
+            }
+            throw new Error("No permission options provided");
+        },
+        async extNotification(method, params) {
+            switch (normalizeExtMethod(method)) {
+                case "channel/system_text": {
+                    const text = params.text;
+                    streamHandler?.onSystemText(text);
+                    break;
+                }
+                case "channel/agent_ready": {
+                    const agentName = params.agent;
+                    const version = params.version;
+                    log("info", `agent_ready: ${agentName} v${version}`);
+                    streamHandler?.onAgentReady(agentName, version);
+                    break;
+                }
+                case "channel/session_ready": {
+                    const sessionId = params.sessionId;
+                    log("info", `session_ready: ${sessionId}`);
+                    streamHandler?.onSessionReady(sessionId);
+                    break;
+                }
+                default:
+                    log("warn", `unhandled ext_notification: ${method}`);
+            }
+        },
+    }));
+    const config = meta.config;
+    // Validate required config keys up front so a misconfigured plugin fails
+    // with a clear error instead of some downstream "undefined is not a
+    // string" crash in the bot constructor.
+    for (const key of spec.requiredConfig ?? []) {
+        if (config[key] === undefined || config[key] === null || config[key] === "") {
+            throw new Error(`${key} is required in config`);
+        }
+    }
+    const cacheDir = meta.cacheDir ?? path.join(os.homedir(), ".vibearound", ".cache");
+    log("info", `initialized, host=${agentInfo.name ?? "unknown"} cacheDir=${cacheDir}`);
+    const bot = await spec.createBot({ config, agent, log, cacheDir });
+    if (spec.afterCreate) {
+        await spec.afterCreate(bot, log);
+    }
+    const verboseRaw = config.verbose;
+    const verbose = {
+        showThinking: verboseRaw?.show_thinking ?? false,
+        showToolUse: verboseRaw?.show_tool_use ?? false,
+    };
+    streamHandler = spec.createStreamHandler(bot, log, verbose);
+    bot.setStreamHandler(streamHandler);
+    await bot.start();
+    log("info", "plugin started");
+    await conn.closed;
+    log("info", "connection closed, shutting down");
+    await bot.stop();
+    process.exit(0);
+}
+//# sourceMappingURL=run-plugin.js.map

package/dist/run-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-plugin.js","sourceRoot":"","sources":["../src/run-plugin.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibearound/plugin-channel-sdk",
-  "version": "0.1.2",
+  "version": "0.3.0",
   "description": "VibeAround Plugin SDK — base classes and utilities for building channel plugins",
   "license": "MIT",
   "type": "module",

package/src/errors.ts

@@ -0,0 +1,29 @@
+/**
+ * Error normalization for channel plugins.
+ *
+ * Every plugin had an ad-hoc ladder that tried `instanceof Error`, then
+ * `typeof error === "object"`, then fell back to `String(error)`. That
+ * ladder lived in five slightly-different forms across bot.ts files and
+ * drifted over time. Centralize it here.
+ */
+
+/**
+ * Extract a human-readable message from an unknown thrown value.
+ *
+ * Prefers `Error.message`, falls back to a non-circular JSON stringify for
+ * objects, and finally to `String(e)` for primitives.
+ */
+export function extractErrorMessage(e: unknown): string {
+  if (e instanceof Error) return e.message;
+  if (typeof e === "string") return e;
+  if (e && typeof e === "object") {
+    const msg = (e as { message?: unknown }).message;
+    if (typeof msg === "string") return msg;
+    try {
+      return JSON.stringify(e);
+    } catch {
+      return String(e);
+    }
+  }
+  return String(e);
+}

package/src/index.ts

@@ -57,9 +57,24 @@
 export { connectToHost, normalizeExtMethod, redirectConsoleToStderr } from "./connection.js";
 export type { PluginInfo, ConnectResult, AgentInfo } from "./connection.js";
 
+// Error normalization
+export { extractErrorMessage } from "./errors.js";
+
+// Plugin runner (absorbs the main.ts boilerplate)
+export { runChannelPlugin } from "./run-plugin.js";
+export type {
+  ChannelBot,
+  ChannelPluginLogger,
+  ChannelStreamHandler,
+  CreateBotContext,
+  RunChannelPluginSpec,
+  VerboseOptions,
+} from "./run-plugin.js";
+
 // Block renderer
 export { BlockRenderer } from "./renderer.js";
 
+
 // Types (re-exports ACP SDK types + SDK-specific types)
 export type {
   // ACP SDK

package/src/renderer.ts

@@ -56,6 +56,44 @@
 import type { SessionNotification } from "@agentclientprotocol/sdk";
 import type { BlockKind, BlockRendererOptions, VerboseConfig } from "./types.js";
 
+// ---------------------------------------------------------------------------
+// Local ACP session-update narrowing
+// ---------------------------------------------------------------------------
+//
+// The ACP SDK's `SessionNotification.update` is a discriminated union keyed on
+// the `sessionUpdate` field, but the shape we get back at runtime varies by
+// version. We only consume four variants here, so we define a narrow local
+// view that documents exactly the fields this renderer depends on. A mismatch
+// against the upstream type will show up as a compile error when the SDK is
+// bumped, instead of silently producing `undefined` at runtime.
+
+interface AgentMessageChunk {
+  sessionUpdate: "agent_message_chunk";
+  content?: { text?: string };
+}
+
+interface AgentThoughtChunk {
+  sessionUpdate: "agent_thought_chunk";
+  content?: { text?: string };
+}
+
+interface ToolCall {
+  sessionUpdate: "tool_call";
+  title?: string;
+}
+
+interface ToolCallUpdate {
+  sessionUpdate: "tool_call_update";
+  title?: string;
+  status?: string;
+}
+
+type ConsumedSessionUpdate =
+  | AgentMessageChunk
+  | AgentThoughtChunk
+  | ToolCall
+  | ToolCallUpdate;
+
 // ---------------------------------------------------------------------------
 // Internal state types
 // ---------------------------------------------------------------------------
@@ -210,38 +248,49 @@ export abstract class BlockRenderer<TRef = string> {
    */
   onSessionUpdate(notification: SessionNotification): void {
     const sessionId = notification.sessionId;
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    const update = notification.update as any;
-    const variant = update.sessionUpdate as string;
+    // Narrow through the local ConsumedSessionUpdate union — see the type
+    // declaration above this class for why we re-declare it locally instead
+    // of importing the SDK's own union. Variants other than the four we
+    // handle are treated as no-ops.
+    const rawUpdate = notification.update as unknown as { sessionUpdate: string };
+    const variant = rawUpdate.sessionUpdate;
+    if (
+      variant !== "agent_message_chunk" &&
+      variant !== "agent_thought_chunk" &&
+      variant !== "tool_call" &&
+      variant !== "tool_call_update"
+    ) {
+      return;
+    }
+    const update = rawUpdate as ConsumedSessionUpdate;
     const channelId = this.sessionIdToChannelId(sessionId);
 
-    switch (variant) {
+    switch (update.sessionUpdate) {
       case "agent_message_chunk": {
-        const delta = (update.content?.text ?? "") as string;
+        const delta = update.content?.text ?? "";
         if (delta) this.appendToBlock(channelId, "text", delta);
         break;
       }
       case "agent_thought_chunk": {
         if (!this.verbose.showThinking) return; // skip — no block, no boundary
-        const delta = (update.content?.text ?? "") as string;
+        const delta = update.content?.text ?? "";
         if (delta) this.appendToBlock(channelId, "thinking", delta);
         break;
       }
       case "tool_call": {
         if (!this.verbose.showToolUse) return; // skip
-        const title = update.title as string | undefined;
-        if (title) this.appendToBlock(channelId, "tool", `🔧 ${title}\n`);
+        if (update.title) this.appendToBlock(channelId, "tool", `🔧 ${update.title}\n`);
         break;
       }
       case "tool_call_update": {
         if (!this.verbose.showToolUse) return; // skip
-        const title = (update.title ?? "tool") as string;
-        const status = update.status as string | undefined;
-        if (status === "completed" || status === "error") {
+        const title = update.title ?? "tool";
+        if (update.status === "completed" || update.status === "error") {
           this.appendToBlock(channelId, "tool", `✅ ${title}\n`);
         }
         break;
       }
+      // Unknown / unconsumed variant — ignore.
     }
   }
 
@@ -349,6 +398,17 @@ export abstract class BlockRenderer<TRef = string> {
     const block = state.blocks.at(-1);
     if (!block || block.sealed || !block.content) return;
 
+    // Send-only mode: subclasses that don't override `editBlock` (e.g.
+    // QQ Bot, where the platform has no edit support) would otherwise
+    // POST a new message for every debounced flush, so the user sees a
+    // partial chunk followed by the full message as two separate
+    // deliveries. Defer intermediate sends; only `onTurnEnd` and block
+    // boundary transitions inside `appendToBlock` (which seal the block
+    // first) will actually POST.
+    if (!this.editBlock) {
+      return;
+    }
+
     const now = Date.now();
     if (now - state.lastEditMs < this.minEditIntervalMs) {
       // Throttled — reschedule for the remaining window

package/src/run-plugin.ts

@@ -0,0 +1,249 @@
+/**
+ * runChannelPlugin — shared main.ts boilerplate for every channel plugin.
+ *
+ * Each channel plugin used to have a ~120-line `main.ts` that was 85%
+ * identical across Slack, Telegram, Discord, DingTalk, WeCom, etc:
+ * connect to host, validate config keys, wire the standard sessionUpdate
+ * and extNotification handlers, create the stream handler, start the bot,
+ * wait for disconnect, stop. This helper absorbs that boilerplate so each
+ * plugin's `main.ts` reduces to ~20 lines — a factory for the bot and a
+ * factory for the stream handler.
+ *
+ * ## Usage
+ *
+ * ```ts
+ * import { runChannelPlugin } from "@vibearound/plugin-channel-sdk";
+ * import { SlackBot } from "./bot.js";
+ * import { AgentStreamHandler } from "./agent-stream.js";
+ *
+ * runChannelPlugin({
+ *   name: "vibearound-slack",
+ *   version: "0.1.0",
+ *   requiredConfig: ["bot_token", "app_token"],
+ *   createBot: ({ config, agent, log, cacheDir }) =>
+ *     new SlackBot(
+ *       { bot_token: config.bot_token as string, app_token: config.app_token as string },
+ *       agent,
+ *       log,
+ *       cacheDir,
+ *     ),
+ *   createStreamHandler: (bot, log, verbose) =>
+ *     new AgentStreamHandler(bot, log, verbose),
+ * });
+ * ```
+ */
+
+import os from "node:os";
+import path from "node:path";
+import type { Agent } from "@agentclientprotocol/sdk";
+
+import { connectToHost, normalizeExtMethod } from "./connection.js";
+import { extractErrorMessage } from "./errors.js";
+import type {
+  RequestPermissionRequest,
+  RequestPermissionResponse,
+  SessionNotification,
+} from "./types.js";
+
+// ---------------------------------------------------------------------------
+// Public types
+// ---------------------------------------------------------------------------
+
+export type ChannelPluginLogger = (level: string, msg: string) => void;
+
+export interface ChannelStreamHandler {
+  onSessionUpdate(params: SessionNotification): void;
+  onSystemText(text: string): void;
+  onAgentReady(agent: string, version: string): void;
+  onSessionReady(sessionId: string): void;
+}
+
+export interface ChannelBot<THandler extends ChannelStreamHandler = ChannelStreamHandler> {
+  setStreamHandler(handler: THandler): void;
+  start(): Promise<void> | void;
+  stop(): Promise<void> | void;
+}
+
+export interface CreateBotContext {
+  config: Record<string, unknown>;
+  agent: Agent;
+  log: ChannelPluginLogger;
+  cacheDir: string;
+}
+
+export interface VerboseOptions {
+  showThinking: boolean;
+  showToolUse: boolean;
+}
+
+export interface RunChannelPluginSpec<
+  TBot extends ChannelBot<THandler>,
+  THandler extends ChannelStreamHandler,
+> {
+  /** Plugin name reported during ACP initialize (e.g. "vibearound-slack"). */
+  name: string;
+
+  /** Plugin version reported during ACP initialize. */
+  version: string;
+
+  /**
+   * Config keys that MUST be present on `meta.config`. Plugin startup
+   * fails with a clear error if any are missing. Keep to primitives
+   * (strings/booleans); deeper validation belongs in the bot constructor.
+   */
+  requiredConfig?: string[];
+
+  /** Factory: build the platform bot from host-supplied config + agent. */
+  createBot: (ctx: CreateBotContext) => TBot | Promise<TBot>;
+
+  /**
+   * Factory: build the agent stream handler for this plugin. The handler
+   * is wired to the bot via `bot.setStreamHandler(handler)` before the
+   * bot is started.
+   */
+  createStreamHandler: (
+    bot: TBot,
+    log: ChannelPluginLogger,
+    verbose: VerboseOptions,
+  ) => THandler;
+
+  /**
+   * Optional hook invoked after the bot has been constructed but before
+   * `start()` is called. Use this for one-off initialization that needs
+   * to log diagnostic info (e.g. Telegram's `probe()`).
+   */
+  afterCreate?: (bot: TBot, log: ChannelPluginLogger) => Promise<void> | void;
+}
+
+// ---------------------------------------------------------------------------
+// Implementation
+// ---------------------------------------------------------------------------
+
+/**
+ * Run a channel plugin to completion.
+ *
+ * Performs the ACP initialize handshake, validates required config,
+ * constructs the bot + stream handler, starts the bot, waits for the host
+ * connection to close, then stops the bot and exits the process.
+ *
+ * Never returns under normal operation — the process exits at the end.
+ */
+export async function runChannelPlugin<
+  TBot extends ChannelBot<THandler>,
+  THandler extends ChannelStreamHandler,
+>(spec: RunChannelPluginSpec<TBot, THandler>): Promise<void> {
+  const prefix = `[${spec.name.replace(/^vibearound-/, "")}-plugin]`;
+  const log: ChannelPluginLogger = (level, msg) => {
+    process.stderr.write(`${prefix}[${level}] ${msg}\n`);
+  };
+
+  try {
+    await runInner(spec, log);
+  } catch (err) {
+    log("error", `fatal: ${extractErrorMessage(err)}`);
+    process.exit(1);
+  }
+}
+
+async function runInner<
+  TBot extends ChannelBot<THandler>,
+  THandler extends ChannelStreamHandler,
+>(
+  spec: RunChannelPluginSpec<TBot, THandler>,
+  log: ChannelPluginLogger,
+): Promise<void> {
+  log("info", "initializing ACP connection...");
+
+  let streamHandler: THandler | null = null;
+
+  const { agent, meta, agentInfo, conn } = await connectToHost(
+    { name: spec.name, version: spec.version },
+    () => ({
+      async sessionUpdate(params: SessionNotification): Promise<void> {
+        streamHandler?.onSessionUpdate(params);
+      },
+
+      async requestPermission(
+        params: RequestPermissionRequest,
+      ): Promise<RequestPermissionResponse> {
+        const first = params.options?.[0];
+        if (first) {
+          return { outcome: { outcome: "selected", optionId: first.optionId } };
+        }
+        throw new Error("No permission options provided");
+      },
+
+      async extNotification(
+        method: string,
+        params: Record<string, unknown>,
+      ): Promise<void> {
+        switch (normalizeExtMethod(method)) {
+          case "channel/system_text": {
+            const text = params.text as string;
+            streamHandler?.onSystemText(text);
+            break;
+          }
+          case "channel/agent_ready": {
+            const agentName = params.agent as string;
+            const version = params.version as string;
+            log("info", `agent_ready: ${agentName} v${version}`);
+            streamHandler?.onAgentReady(agentName, version);
+            break;
+          }
+          case "channel/session_ready": {
+            const sessionId = params.sessionId as string;
+            log("info", `session_ready: ${sessionId}`);
+            streamHandler?.onSessionReady(sessionId);
+            break;
+          }
+          default:
+            log("warn", `unhandled ext_notification: ${method}`);
+        }
+      },
+    }),
+  );
+
+  const config = meta.config;
+
+  // Validate required config keys up front so a misconfigured plugin fails
+  // with a clear error instead of some downstream "undefined is not a
+  // string" crash in the bot constructor.
+  for (const key of spec.requiredConfig ?? []) {
+    if (config[key] === undefined || config[key] === null || config[key] === "") {
+      throw new Error(`${key} is required in config`);
+    }
+  }
+
+  const cacheDir =
+    meta.cacheDir ?? path.join(os.homedir(), ".vibearound", ".cache");
+
+  log(
+    "info",
+    `initialized, host=${agentInfo.name ?? "unknown"} cacheDir=${cacheDir}`,
+  );
+
+  const bot = await spec.createBot({ config, agent, log, cacheDir });
+
+  if (spec.afterCreate) {
+    await spec.afterCreate(bot, log);
+  }
+
+  const verboseRaw = config.verbose as
+    | { show_thinking?: boolean; show_tool_use?: boolean }
+    | undefined;
+  const verbose: VerboseOptions = {
+    showThinking: verboseRaw?.show_thinking ?? false,
+    showToolUse: verboseRaw?.show_tool_use ?? false,
+  };
+
+  streamHandler = spec.createStreamHandler(bot, log, verbose);
+  bot.setStreamHandler(streamHandler);
+
+  await bot.start();
+  log("info", "plugin started");
+
+  await conn.closed;
+  log("info", "connection closed, shutting down");
+  await bot.stop();
+  process.exit(0);
+}