@vibearound/plugin-channel-sdk 0.1.0

package/dist/connection.d.ts

@@ -0,0 +1,62 @@
+/**
+ * ACP stdio connection helpers.
+ *
+ * Handles the boilerplate of wiring Node.js stdio streams to an ACP
+ * ClientSideConnection, performing the initialize handshake, and extracting
+ * plugin config from the host's _meta response.
+ */
+import { type Agent, type Client } from "@agentclientprotocol/sdk";
+import type { PluginInitMeta } from "./types.js";
+export interface PluginInfo {
+    name: string;
+    version: string;
+}
+export interface AgentInfo {
+    name?: string;
+    version?: string;
+}
+export interface ConnectResult {
+    /** ACP agent reference — call agent.prompt() to send messages. */
+    agent: Agent;
+    /** Plugin config and cache dir provided by the host at startup. */
+    meta: PluginInitMeta;
+    /** Info about the host agent (name, version) reported during initialize. */
+    agentInfo: AgentInfo;
+    /**
+     * The ACP connection. Await `conn.closed` to keep the process alive until
+     * the host disconnects.
+     */
+    conn: {
+        readonly closed: Promise<void>;
+    };
+}
+/**
+ * Connect to the VibeAround host via stdio ACP.
+ *
+ * Sets up Node.js stdio streams → ACP transport, calls `initialize`, and
+ * returns the agent reference plus plugin config/meta from the host.
+ *
+ * @param pluginInfo - Name and version reported to the host
+ * @param makeClient - Factory called with the Agent; returns the Client
+ *   implementation (sessionUpdate, requestPermission, extNotification).
+ *   Capture the agent argument here if you need it before this function resolves.
+ *
+ * @example
+ * ```ts
+ * let agent!: Agent;
+ * const { meta, conn } = await connectToHost(
+ *   { name: "vibearound-mybot", version: "0.1.0" },
+ *   (a) => { agent = a; return myClient; },
+ * );
+ * ```
+ */
+export declare function connectToHost(pluginInfo: PluginInfo, makeClient: (agent: Agent) => Client): Promise<ConnectResult>;
+/**
+ * Normalize ACP ext notification method names.
+ *
+ * The ACP SDK prepends "_" to ext method names (e.g. "_channel/system_text").
+ * Strip the prefix to get the canonical method name used in plugin.json.
+ */
+export declare function normalizeExtMethod(method: string): string;
+export declare function redirectConsoleToStderr(): void;
+//# sourceMappingURL=connection.d.ts.map

package/dist/connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../src/connection.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAIL,KAAK,KAAK,EACV,KAAK,MAAM,EACZ,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAMjD,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,kEAAkE;IAClE,KAAK,EAAE,KAAK,CAAC;IACb,mEAAmE;IACnE,IAAI,EAAE,cAAc,CAAC;IACrB,4EAA4E;IAC5E,SAAS,EAAE,SAAS,CAAC;IACrB;;;OAGG;IACH,IAAI,EAAE;QAAE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;KAAE,CAAC;CAC1C;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,aAAa,CACjC,UAAU,EAAE,UAAU,EACtB,UAAU,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,MAAM,GACnC,OAAO,CAAC,aAAa,CAAC,CAqCxB;AAMD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEzD;AAWD,wBAAgB,uBAAuB,IAAI,IAAI,CAe9C"}

package/dist/connection.js

@@ -0,0 +1,89 @@
+/**
+ * ACP stdio connection helpers.
+ *
+ * Handles the boilerplate of wiring Node.js stdio streams to an ACP
+ * ClientSideConnection, performing the initialize handshake, and extracting
+ * plugin config from the host's _meta response.
+ */
+import { Readable, Writable } from "node:stream";
+import { ClientSideConnection, ndJsonStream, PROTOCOL_VERSION, } from "@agentclientprotocol/sdk";
+/**
+ * Connect to the VibeAround host via stdio ACP.
+ *
+ * Sets up Node.js stdio streams → ACP transport, calls `initialize`, and
+ * returns the agent reference plus plugin config/meta from the host.
+ *
+ * @param pluginInfo - Name and version reported to the host
+ * @param makeClient - Factory called with the Agent; returns the Client
+ *   implementation (sessionUpdate, requestPermission, extNotification).
+ *   Capture the agent argument here if you need it before this function resolves.
+ *
+ * @example
+ * ```ts
+ * let agent!: Agent;
+ * const { meta, conn } = await connectToHost(
+ *   { name: "vibearound-mybot", version: "0.1.0" },
+ *   (a) => { agent = a; return myClient; },
+ * );
+ * ```
+ */
+export async function connectToHost(pluginInfo, makeClient) {
+    // Keep stdout clean for JSON-RPC — redirect all console output to stderr
+    redirectConsoleToStderr();
+    const inputStream = Readable.toWeb(process.stdin);
+    const outputStream = Writable.toWeb(process.stdout);
+    const stream = ndJsonStream(outputStream, inputStream);
+    let capturedAgent;
+    const wrappedMakeClient = (a) => {
+        capturedAgent = a;
+        return makeClient(a);
+    };
+    const conn = new ClientSideConnection(wrappedMakeClient, stream);
+    const initResponse = await conn.initialize({
+        protocolVersion: PROTOCOL_VERSION,
+        clientInfo: { name: pluginInfo.name, version: pluginInfo.version },
+        capabilities: {},
+    });
+    const rawMeta = initResponse._meta;
+    const meta = {
+        config: (rawMeta?.config ?? {}),
+        cacheDir: rawMeta?.cacheDir,
+    };
+    const agentInfo = {
+        name: initResponse.agentInfo?.name,
+        version: initResponse.agentInfo?.version,
+    };
+    return { agent: capturedAgent, meta, agentInfo, conn };
+}
+// ---------------------------------------------------------------------------
+// Utilities
+// ---------------------------------------------------------------------------
+/**
+ * Normalize ACP ext notification method names.
+ *
+ * The ACP SDK prepends "_" to ext method names (e.g. "_channel/system_text").
+ * Strip the prefix to get the canonical method name used in plugin.json.
+ */
+export function normalizeExtMethod(method) {
+    return method.startsWith("_") ? method.slice(1) : method;
+}
+/**
+ * Redirect all console.* output to stderr.
+ *
+ * ACP uses stdout for JSON-RPC framing — any stray console output corrupts
+ * the protocol. Call this once at plugin startup (connectToHost does this
+ * automatically).
+ */
+let _consoleRedirected = false;
+export function redirectConsoleToStderr() {
+    if (_consoleRedirected)
+        return;
+    _consoleRedirected = true;
+    const toStderr = (...args) => process.stderr.write(args.map(String).join(" ") + "\n");
+    console.log = toStderr;
+    console.info = toStderr;
+    console.warn = (...args) => process.stderr.write("[warn] " + args.map(String).join(" ") + "\n");
+    console.error = (...args) => process.stderr.write("[error] " + args.map(String).join(" ") + "\n");
+    console.debug = (...args) => process.stderr.write("[debug] " + args.map(String).join(" ") + "\n");
+}
+//# sourceMappingURL=connection.js.map

package/dist/connection.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,59 @@
+/**
+ * @vibearound/plugin-channel-sdk
+ *
+ * Base classes and utilities for building VibeAround channel plugins.
+ *
+ * ## Quick start
+ *
+ * ```ts
+ * import {
+ *   connectToHost,
+ *   BlockRenderer,
+ *   normalizeExtMethod,
+ *   type Agent,
+ *   type SessionNotification,
+ * } from "@vibearound/plugin-channel-sdk";
+ *
+ * class MyRenderer extends BlockRenderer<string> {
+ *   protected async sendBlock(channelId, kind, content) {
+ *     const msg = await myPlatform.send(channelId, content);
+ *     return msg.id;
+ *   }
+ *   protected async editBlock(channelId, ref, kind, content, sealed) {
+ *     await myPlatform.edit(ref, content);
+ *   }
+ * }
+ *
+ * let agent!: Agent;
+ * const renderer = new MyRenderer();
+ *
+ * const { meta, conn } = await connectToHost(
+ *   { name: "vibearound-mybot", version: "0.1.0" },
+ *   (a) => {
+ *     agent = a;
+ *     return {
+ *       sessionUpdate: async (n) => renderer.onSessionUpdate(n),
+ *       requestPermission: async (p) => ({
+ *         outcome: { outcome: "selected", optionId: p.options![0].optionId },
+ *       }),
+ *       extNotification: async (method, params) => {
+ *         switch (normalizeExtMethod(method)) {
+ *           case "channel/system_text":
+ *             await myPlatform.send(params.channelId as string, params.text as string);
+ *             break;
+ *         }
+ *       },
+ *     };
+ *   },
+ * );
+ *
+ * const botToken = meta.config.bot_token as string;
+ * // … start your platform bot …
+ * await conn.closed;
+ * ```
+ */
+export { connectToHost, normalizeExtMethod, redirectConsoleToStderr } from "./connection.js";
+export type { PluginInfo, ConnectResult, AgentInfo } from "./connection.js";
+export { BlockRenderer } from "./renderer.js";
+export type { Agent, Client, SessionNotification, RequestPermissionRequest, RequestPermissionResponse, BlockKind, VerboseConfig, BlockRendererOptions, PluginCapabilities, PluginManifest, PluginInitMeta, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +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,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

@@ -0,0 +1,59 @@
+/**
+ * @vibearound/plugin-channel-sdk
+ *
+ * Base classes and utilities for building VibeAround channel plugins.
+ *
+ * ## Quick start
+ *
+ * ```ts
+ * import {
+ *   connectToHost,
+ *   BlockRenderer,
+ *   normalizeExtMethod,
+ *   type Agent,
+ *   type SessionNotification,
+ * } from "@vibearound/plugin-channel-sdk";
+ *
+ * class MyRenderer extends BlockRenderer<string> {
+ *   protected async sendBlock(channelId, kind, content) {
+ *     const msg = await myPlatform.send(channelId, content);
+ *     return msg.id;
+ *   }
+ *   protected async editBlock(channelId, ref, kind, content, sealed) {
+ *     await myPlatform.edit(ref, content);
+ *   }
+ * }
+ *
+ * let agent!: Agent;
+ * const renderer = new MyRenderer();
+ *
+ * const { meta, conn } = await connectToHost(
+ *   { name: "vibearound-mybot", version: "0.1.0" },
+ *   (a) => {
+ *     agent = a;
+ *     return {
+ *       sessionUpdate: async (n) => renderer.onSessionUpdate(n),
+ *       requestPermission: async (p) => ({
+ *         outcome: { outcome: "selected", optionId: p.options![0].optionId },
+ *       }),
+ *       extNotification: async (method, params) => {
+ *         switch (normalizeExtMethod(method)) {
+ *           case "channel/system_text":
+ *             await myPlatform.send(params.channelId as string, params.text as string);
+ *             break;
+ *         }
+ *       },
+ *     };
+ *   },
+ * );
+ *
+ * const botToken = meta.config.bot_token as string;
+ * // … start your platform bot …
+ * await conn.closed;
+ * ```
+ */
+// Connection helpers
+export { connectToHost, normalizeExtMethod, redirectConsoleToStderr } from "./connection.js";
+// Block renderer
+export { BlockRenderer } from "./renderer.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +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"}

package/dist/renderer.d.ts

@@ -0,0 +1,154 @@
+/**
+ * BlockRenderer — abstract base class for block-based message rendering.
+ *
+ * ## How it works
+ *
+ * ACP streams agent responses as a sequence of typed events:
+ *   text chunk, text chunk, tool call, tool update, text chunk, …
+ *
+ * Each contiguous run of the **same kind** (text / thinking / tool) is grouped
+ * into one "block". When the kind changes, the current block is **sealed**
+ * (no more edits) and a new block starts.
+ *
+ * Blocks are rendered to the platform by subclass-implemented `sendBlock` and
+ * `editBlock`. The renderer handles:
+ *
+ *   - **Debounced flushing** — batches rapid deltas before sending (avoids
+ *     excessive API calls during fast streaming).
+ *   - **Edit throttling** — enforces a minimum interval between edits to
+ *     respect platform rate limits.
+ *   - **Ordered delivery** — a `sendChain` Promise serializes all send/edit
+ *     calls so messages always arrive in the correct order.
+ *   - **Sentinel guard** — prevents concurrent creates for the same block.
+ *   - **Verbose filtering** — thinking / tool blocks can be suppressed without
+ *     creating phantom block boundaries.
+ *
+ * ## Usage
+ *
+ * ```ts
+ * class MyRenderer extends BlockRenderer<string> {
+ *   protected async sendBlock(channelId, kind, content) {
+ *     const msg = await myApi.sendMessage(channelId, content);
+ *     return msg.id;
+ *   }
+ *   protected async editBlock(channelId, ref, kind, content, sealed) {
+ *     await myApi.editMessage(ref, content);
+ *   }
+ * }
+ *
+ * // In main.ts:
+ * const renderer = new MyRenderer({ verbose: { showThinking: false } });
+ *
+ * // When user sends a message:
+ * renderer.onPromptSent(channelId);
+ * try {
+ *   await agent.prompt({ sessionId, content });
+ *   await renderer.onTurnEnd(channelId);
+ * } catch (e) {
+ *   await renderer.onTurnError(channelId, String(e));
+ * }
+ *
+ * // In the ACP client's sessionUpdate handler:
+ * renderer.onSessionUpdate(notification);
+ * ```
+ */
+import type { SessionNotification } from "@agentclientprotocol/sdk";
+import type { BlockKind, BlockRendererOptions, VerboseConfig } from "./types.js";
+/**
+ * Abstract base class for block-based rendering of ACP session streams.
+ *
+ * @typeParam TRef - Platform-specific message reference type (e.g. `number`
+ *   for Telegram message IDs, `string` for Feishu message IDs). Used as the
+ *   return type of `sendBlock` and the first argument of `editBlock`.
+ */
+export declare abstract class BlockRenderer<TRef = string> {
+    protected readonly flushIntervalMs: number;
+    protected readonly minEditIntervalMs: number;
+    protected readonly verbose: VerboseConfig;
+    private states;
+    constructor(options?: BlockRendererOptions);
+    /**
+     * Send a new block message to the platform.
+     *
+     * Return the platform message reference that will be passed to future
+     * `editBlock` calls. Return `null` if editing is not supported.
+     */
+    protected abstract sendBlock(channelId: string, kind: BlockKind, content: string): Promise<TRef | null>;
+    /**
+     * Edit an existing block message in-place.
+     *
+     * Optional — if not implemented, blocks are never edited (send-only mode,
+     * suitable for platforms like WeChat that don't support message editing).
+     *
+     * @param sealed - `true` when this is the final edit (block done streaming).
+     *   Use to switch from a "streaming" card format to a finalized one.
+     */
+    protected editBlock?(channelId: string, ref: TRef, kind: BlockKind, content: string, sealed: boolean): Promise<void>;
+    /**
+     * Format block content before sending or editing.
+     *
+     * Default applies standard emoji prefixes:
+     *   - `thinking` → `💭 <content>`
+     *   - `tool`     → trimmed content
+     *   - `text`     → content as-is
+     *
+     * Override to apply platform-specific formatting (e.g. markdown escaping).
+     */
+    protected formatContent(kind: BlockKind, content: string, _sealed: boolean): string;
+    /**
+     * Called after the last block has been flushed and the turn is complete.
+     * Override to perform cleanup (e.g. remove a "typing" indicator, a
+     * processing reaction, etc.).
+     */
+    protected onAfterTurnEnd(_channelId: string): Promise<void>;
+    /**
+     * Called after a turn error, once state has been cleaned up.
+     * Override to send an error message to the user.
+     */
+    protected onAfterTurnError(_channelId: string, _error: string): Promise<void>;
+    /**
+     * Map an ACP `sessionId` to the channel ID used internally.
+     *
+     * Default: identity (sessionId === channelId).
+     *
+     * Override if your plugin namespaces channel IDs (e.g. Feishu uses
+     * `"feishu:<sessionId>"`, WeChat uses `"weixin-openclaw-bridge:<sessionId>"`).
+     */
+    protected sessionIdToChannelId(sessionId: string): string;
+    /**
+     * Process an ACP `sessionUpdate` notification from the host.
+     *
+     * Routes the event to the correct block based on its variant, appending
+     * deltas to the current block or starting a new one when the kind changes.
+     *
+     * Call this from the ACP `Client.sessionUpdate` handler.
+     */
+    onSessionUpdate(notification: SessionNotification): void;
+    /**
+     * Call this before sending a prompt to the agent.
+     *
+     * Clears any leftover state from a previous turn so the new turn starts
+     * with a clean slate.
+     */
+    onPromptSent(channelId: string): void;
+    /**
+     * Call this after `agent.prompt()` resolves (turn complete).
+     *
+     * Seals and flushes the last block, then waits for all pending sends/edits
+     * to complete before calling `onAfterTurnEnd`.
+     */
+    onTurnEnd(channelId: string): Promise<void>;
+    /**
+     * Call this when `agent.prompt()` throws (turn error).
+     *
+     * Discards pending state and calls `onAfterTurnError` so the subclass can
+     * send an error message to the user.
+     */
+    onTurnError(channelId: string, error: string): Promise<void>;
+    private appendToBlock;
+    private scheduleFlush;
+    private flush;
+    private enqueueFlush;
+    private flushBlock;
+}
+//# sourceMappingURL=renderer.d.ts.map

package/dist/renderer.d.ts.map

@@ -0,0 +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"}