@vicfei/dsh-super-agent 0.6.1 → 0.8.0

package/dist/slack.js

@@ -0,0 +1,106 @@
+// Slack channel (v0.8 M8-3, issue #45) — Socket Mode (no public URL) bridged onto the
+// pull-based Source contract via a capped buffer, same pattern as the Feishu channel; replies
+// via chat.postMessage. The bot's own user id is fetched once via auth.test, so group @mention
+// detection (<@U…> in text) is precise without manual configuration.
+const BUFFER_CAP = 1000;
+export function slackTriggerFromEvent(e, botUserId) {
+    if (!e.channel || !e.ts)
+        return null;
+    if (e.subtype && e.subtype !== "thread_broadcast")
+        return null; // joins/edits/deletes are not work requests
+    const isDm = e.channel_type === "im";
+    const text = e.text ?? "";
+    const addressing = isDm ? true // a DM is inherently addressed
+        : botUserId ? text.includes(`<@${botUserId}>`)
+            : false; // unknown bot id → fail closed (inferred via listedNotAddressing remains)
+    const author = e.user ?? e.bot_id ?? "unknown";
+    return {
+        id: `slack:msg:${e.channel}/${e.ts}`,
+        source: "slack",
+        scope: isDm ? "im_dm" : "im_group",
+        threadId: `slack:${isDm ? "dm" : "channel"}/${e.channel}`,
+        author: { login: author, isBot: e.bot_id !== undefined },
+        addressing,
+        body: text,
+        ts: new Date(Number(e.ts.split(".")[0]) * 1000).toISOString(),
+    };
+}
+export class SlackSource {
+    opts;
+    subscribe;
+    kind = "slack";
+    buffer = [];
+    starting = null;
+    constructor(opts, 
+    /** Test seam: replaces the Socket Mode subscription. */
+    subscribe) {
+        this.opts = opts;
+        this.subscribe = subscribe;
+    }
+    start() {
+        this.starting ??= this.connect();
+        return this.starting;
+    }
+    async connect() {
+        const onEvent = (e) => {
+            const t = slackTriggerFromEvent(e, this.opts.botUserId);
+            if (!t)
+                return;
+            if (this.buffer.length >= BUFFER_CAP)
+                this.buffer.shift();
+            this.buffer.push(t);
+        };
+        if (this.subscribe) {
+            await this.subscribe(onEvent);
+            return;
+        }
+        const { SocketModeClient } = await import("@slack/socket-mode");
+        const socket = new SocketModeClient({ appToken: this.opts.appToken });
+        socket.on("message", ({ body }) => {
+            // Events API envelope: { type: "event_callback", event: {...} }
+            const inner = body.event;
+            if (inner)
+                onEvent(inner);
+        });
+        await socket.start();
+    }
+    async collect(from, opts = {}) {
+        await this.start();
+        const triggers = this.buffer.splice(0).filter((t) => !opts.exclude?.has(t.id));
+        return { triggers, next: from }; // push source: replay safety is the engine's idempotence
+    }
+}
+export class SlackReplyChannel {
+    send;
+    constructor(send) {
+        this.send = send;
+    }
+    matches(threadId) {
+        return threadId.startsWith("slack:");
+    }
+    async deliver(threadId, body) {
+        const channel = threadId.slice(threadId.indexOf("/") + 1);
+        if (!channel || channel.includes("/"))
+            throw new Error(`cannot resolve channel from thread ${threadId}`);
+        const { ts } = await this.send(channel, body);
+        return { externalId: `msg:${channel}/${ts}` };
+    }
+}
+/** Build the real sender; also resolves the bot's own user id (auth.test) for @mention detection. */
+export async function createSlackSender(botToken) {
+    const { WebClient } = await import("@slack/web-api");
+    const web = new WebClient(botToken);
+    const auth = await web.auth.test();
+    const botUserId = auth.user_id;
+    return {
+        botUserId,
+        send: async (channel, text) => {
+            const res = await web.chat.postMessage({ channel, text });
+            const ts = res.ts;
+            if (!ts)
+                throw new Error("slack postMessage returned no ts");
+            return { ts };
+        },
+    };
+}
+//# sourceMappingURL=slack.js.map

package/dist/slack.js.map

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

package/dist/source.d.ts

@@ -0,0 +1,25 @@
+import type { Trigger } from "./domain.js";
+export interface SourceState {
+    /** Max item id already taken per feed; 0 = never polled. Feed names are source-specific. */
+    positions: Record<string, number>;
+}
+export interface Source {
+    /** Channel namespace — also the threadId prefix and the positions kv suffix. */
+    readonly kind: string;
+    /** Pure collection: triggers newer than `from` plus the next state; persists nothing. */
+    collect(from: SourceState, opts: {
+        exclude?: ReadonlySet<string>;
+    }): Promise<{
+        triggers: Trigger[];
+        next: SourceState;
+    }>;
+}
+export interface ReplyChannel {
+    matches(threadId: string): boolean;
+    /** Deliver a reply body into the thread; returns the source-scoped external message id. */
+    deliver(threadId: string, body: string): Promise<{
+        externalId: string;
+    }>;
+}
+/** GitHub's channel: threads are `github:owner/repo/(issues|pulls)/N`, delivery is an issue comment. */
+export declare function threadSource(threadId: string): string;

package/dist/source.js

@@ -0,0 +1,11 @@
+// Source & ReplyChannel — the multi-source contracts (v0.8, issue #45).
+// A Source turns one channel's events into domain Triggers and owns its read state, namespaced
+// by `kind`; the Engine persists that state in the same transaction as the triggers it produced
+// (exactly-once across restarts — docs/001: "a Source holds its own read position").
+// A ReplyChannel delivers outbox reply effects back where the trigger came from; routing is by
+// threadId prefix ("github:…", "feishu:…", "slack:…", "wechat:…").
+/** GitHub's channel: threads are `github:owner/repo/(issues|pulls)/N`, delivery is an issue comment. */
+export function threadSource(threadId) {
+    return threadId.split(":")[0] ?? "";
+}
+//# sourceMappingURL=source.js.map

package/dist/source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source.js","sourceRoot":"","sources":["../src/source.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,+FAA+F;AAC/F,gGAAgG;AAChG,qFAAqF;AACrF,+FAA+F;AAC/F,mEAAmE;AAsBnE,wGAAwG;AACxG,MAAM,UAAU,YAAY,CAAC,QAAgB;IAC3C,OAAO,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AACtC,CAAC"}

package/dist/usage.d.ts

@@ -1,4 +1,4 @@
-export declare const USAGE = "dsh-super-agent \u2014 admission control, observe mode & tickets for any CLI coding agent\n\nUsage: dsh-super-agent <command> [options]\n\nCommands:\n  poll      one pass: poll GitHub \u2192 gate \u2192 (assessment) \u2192 record; --post also drains queued replies\n  work      claim queued tickets \u2192 run the executor in a worktree \u2192 report\n  watch     poll + work + panel as one daemon (Ctrl-C stops after the current cycle)\n  tickets   list tickets; \"tickets stop <id>\" ends one\n  panel     serve the awaiting-human panel (http://127.0.0.1:8787)\n  merge     sweep open ticket PRs \u2014 merge those meeting policy.merge requirements (default off)\n  help      show this usage\n\nCommon options:\n  --repo owner/name         repository to watch\n  --agent-login <login>     the agent's GitHub login (mention detection)\n  --config <file>           policy config        (default policy.json, auto-scaffolded from examples/)\n  --executor-config <file>  executor config      (default executor.json, auto-scaffolded from examples/)\n  --db <file>               state database       (default .state/engine.db)\n  --token <token>           GitHub token (or env GITHUB_TOKEN)\n  --assessment <mode>       stub-positive | stub-negative | llm\n  --interval <seconds>      watch poll interval (\u00B120% jitter)\n  --no-panel                watch without the panel server\n  --post                    poll also posts queued replies (needs a token)\n\nEnvironment: GITHUB_TOKEN, or GitHub App auth (GITHUB_APP_ID + GITHUB_APP_PRIVATE_KEY[_PATH],\noptional GITHUB_APP_INSTALLATION_ID), ASSESS_BASE_URL, ASSESS_MODEL, ASSESS_API_KEY, PANEL_PORT.\nDocs: https://github.com/vicfei/dsh-super-agent#quick-start";
+export declare const USAGE = "dsh-super-agent \u2014 admission control, observe mode & tickets for any CLI coding agent\n\nUsage: dsh-super-agent <command> [options]\n\nCommands:\n  poll      one pass: poll GitHub \u2192 gate \u2192 (assessment) \u2192 record; --post also drains queued replies\n  work      claim queued tickets \u2192 run the executor in a worktree \u2192 report\n  watch     poll + work + panel as one daemon (Ctrl-C stops after the current cycle)\n  tickets   list tickets; \"tickets stop <id>\" ends one\n  panel     serve the awaiting-human panel (http://127.0.0.1:8787)\n  merge     sweep open ticket PRs \u2014 merge those meeting policy.merge requirements (default off)\n  wechat-login  iLink QR login: scan with WeChat, credentials land in the engine db\n  help      show this usage\n\nCommon options:\n  --repo owner/name         repository to watch\n  --agent-login <login>     the agent's GitHub login (mention detection)\n  --config <file>           policy config        (default policy.json, auto-scaffolded from examples/)\n  --executor-config <file>  executor config      (default executor.json, auto-scaffolded from examples/)\n  --db <file>               state database       (default .state/engine.db)\n  --token <token>           GitHub token (or env GITHUB_TOKEN)\n  --assessment <mode>       stub-positive | stub-negative | llm\n  --interval <seconds>      watch poll interval (\u00B120% jitter)\n  --no-panel                watch without the panel server\n  --post                    poll also posts queued replies (needs a token)\n\nEnvironment: GITHUB_TOKEN, or GitHub App auth (GITHUB_APP_ID + GITHUB_APP_PRIVATE_KEY[_PATH],\noptional GITHUB_APP_INSTALLATION_ID); Feishu channel (FEISHU_APP_ID + FEISHU_APP_SECRET,\noptional FEISHU_BOT_OPEN_ID); Slack channel (SLACK_BOT_TOKEN + SLACK_APP_TOKEN);\nASSESS_BASE_URL, ASSESS_MODEL, ASSESS_API_KEY, PANEL_PORT.\nDocs: https://github.com/vicfei/dsh-super-agent#quick-start";
 export declare function examplePath(name: string): string | null;
 /** Copy the packaged example to `target` when neither exists yet. True ⇒ caller should tell the user to edit & rerun. */
 export declare function scaffoldFromExample(target: string, example: string): boolean;

package/dist/usage.js

@@ -15,6 +15,7 @@ Commands:
   tickets   list tickets; "tickets stop <id>" ends one
   panel     serve the awaiting-human panel (http://127.0.0.1:8787)
   merge     sweep open ticket PRs — merge those meeting policy.merge requirements (default off)
+  wechat-login  iLink QR login: scan with WeChat, credentials land in the engine db
   help      show this usage
 
 Common options:
@@ -30,7 +31,9 @@ Common options:
   --post                    poll also posts queued replies (needs a token)
 
 Environment: GITHUB_TOKEN, or GitHub App auth (GITHUB_APP_ID + GITHUB_APP_PRIVATE_KEY[_PATH],
-optional GITHUB_APP_INSTALLATION_ID), ASSESS_BASE_URL, ASSESS_MODEL, ASSESS_API_KEY, PANEL_PORT.
+optional GITHUB_APP_INSTALLATION_ID); Feishu channel (FEISHU_APP_ID + FEISHU_APP_SECRET,
+optional FEISHU_BOT_OPEN_ID); Slack channel (SLACK_BOT_TOKEN + SLACK_APP_TOKEN);
+ASSESS_BASE_URL, ASSESS_MODEL, ASSESS_API_KEY, PANEL_PORT.
 Docs: https://github.com/vicfei/dsh-super-agent#quick-start`;
 const examplesDir = join(dirname(fileURLToPath(import.meta.url)), "..", "examples");
 export function examplePath(name) {

package/dist/usage.js.map

@@ -1 +1 @@
-{"version":3,"file":"usage.js","sourceRoot":"","sources":["../src/usage.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,4FAA4F;AAC5F,yEAAyE;AAEzE,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,CAAC,MAAM,KAAK,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;4DA2BuC,CAAC;AAE7D,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;AAEpF,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,MAAM,CAAC,GAAG,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;IAClC,OAAO,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAClC,CAAC;AAED,yHAAyH;AACzH,MAAM,UAAU,mBAAmB,CAAC,MAAc,EAAE,OAAe;IACjE,MAAM,GAAG,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;IACjC,IAAI,CAAC,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC;QAAE,OAAO,KAAK,CAAC;IAC7C,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAC1B,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,CAAC,MAAM,aAAa,GAAG;;;uGAG0E,CAAC"}
+{"version":3,"file":"usage.js","sourceRoot":"","sources":["../src/usage.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,4FAA4F;AAC5F,yEAAyE;AAEzE,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,CAAC,MAAM,KAAK,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4DA8BuC,CAAC;AAE7D,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;AAEpF,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,MAAM,CAAC,GAAG,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;IAClC,OAAO,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAClC,CAAC;AAED,yHAAyH;AACzH,MAAM,UAAU,mBAAmB,CAAC,MAAc,EAAE,OAAe;IACjE,MAAM,GAAG,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;IACjC,IAAI,CAAC,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC;QAAE,OAAO,KAAK,CAAC;IAC7C,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAC1B,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,CAAC,MAAM,aAAa,GAAG;;;uGAG0E,CAAC"}

package/dist/watch.d.ts

@@ -1,14 +1,17 @@
 import type { Policy, Trigger } from "./domain.js";
 import type { Engine } from "./engine.js";
-import type { GitHubSource } from "./github/source.js";
+import type { ReplyChannel, Source } from "./source.js";
 import type { Executor } from "./executor.js";
 import type { GitHubClient } from "./github/client.js";
 export type AssessmentFn = (t: Trigger) => Promise<"positive" | "negative"> | "positive" | "negative";
 export interface WatchOptions {
     engine: Engine;
-    source: GitHubSource;
+    /** All sources, polled each cycle (v0.8); each keeps its own read state in the engine. */
+    sources: Source[];
     executor: Executor;
     client: GitHubClient | null;
+    /** Reply routes by threadId prefix (v0.8). */
+    channels: ReplyChannel[];
     repo: string;
     policy: Policy;
     assessment: AssessmentFn;

package/dist/watch.js

@@ -32,23 +32,27 @@ export async function runWatch(opts) {
     }
 }
 async function runCycle(opts, log) {
-    const { engine, source, executor, client, repo, policy } = opts;
-    const { triggers, next } = await source.collect(engine.positions(), { exclude: engine.selfPosted() });
+    const { engine, executor, client, channels, repo, policy } = opts;
     const batch = [];
-    for (const t of triggers)
-        batch.push(classify(t, policy, await opts.assessment(t)));
+    const nextBySource = {};
+    for (const source of opts.sources) {
+        const { triggers, next } = await source.collect(engine.sourceState(source.kind), { exclude: engine.selfPosted() });
+        nextBySource[source.kind] = next;
+        for (const t of triggers)
+            batch.push(classify(t, policy, await opts.assessment(t)));
+    }
     for (const outcome of batch)
         log(formatOutcome(outcome));
-    const report = engine.ingest(batch, next);
+    const report = engine.ingest(batch, nextBySource);
     for (const refusal of report.refusals)
         log(`[REFUSED] ${refusal}`);
-    const reports = await runWork(engine, executor, repo, client);
+    const reports = await runWork(engine, executor, repo, client, channels);
     for (const r of reports)
         log(`#${r.ticketId} [${r.outcome}] ${r.detail}`);
     // Auto-merge sweep (M6-1) — no-op unless policy.merge.enabled; structural brakes inside.
-    const merged = client ? await runMergeSweep(engine, client, repo, policy, (l) => log(`[merge] ${l}`)) : [];
+    const merged = client ? await runMergeSweep(engine, client, repo, policy, channels, (l) => log(`[merge] ${l}`)) : [];
     if (batch.length > 0 || reports.length > 0 || report.refusals.length > 0 || merged.length > 0) {
-        log(`— cycle: fresh=${report.fresh} opened=${report.ticketsOpened} resumed=${report.resumed} worked=${reports.length} merged=${merged.length}`);
+        log(`— cycle: fresh=${report.fresh} opened=${report.ticketsOpened} resumed=${report.resumed} joined=${report.joined} worked=${reports.length} merged=${merged.length}`);
         return true;
     }
     return false;

package/dist/watch.js.map

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

package/dist/wechat.d.ts

@@ -0,0 +1,142 @@
+import type { Trigger } from "./domain.js";
+import type { ReplyChannel, Source, SourceState } from "./source.js";
+export declare const WECHAT_DEFAULT_BASE = "https://ilinkai.weixin.qq.com";
+export interface WeixinMessage {
+    message_id?: string;
+    seq?: number;
+    from_user_id?: string;
+    to_user_id?: string;
+    session_id?: string;
+    group_id?: string;
+    /** 1 = USER, 2 = BOT. */
+    message_type?: number;
+    create_time_ms?: number;
+    item_list?: {
+        type?: number;
+        text_item?: {
+            text?: string;
+        };
+    }[];
+    context_token?: string;
+}
+export interface GetUpdatesResp {
+    ret?: number;
+    errcode?: number;
+    errmsg?: string;
+    msgs?: WeixinMessage[];
+    get_updates_buf?: string;
+}
+export interface SendMessageResp {
+    ret?: number;
+    errmsg?: string;
+    message_id?: string;
+}
+export interface WechatAuth {
+    token: string;
+    baseUrl: string;
+}
+export interface WechatRoute {
+    toUserId: string;
+    groupId?: string;
+    sessionId?: string;
+    contextToken: string;
+}
+export interface WechatStore {
+    loadAuth(): WechatAuth | null;
+    saveAuth(auth: WechatAuth): void;
+    loadCursor(): string;
+    saveCursor(buf: string): void;
+    loadRoute(threadId: string): WechatRoute | null;
+    saveRoute(threadId: string, route: WechatRoute): void;
+    /** Session expired (-14): drop everything, a new QR scan is required. */
+    clearAll(): void;
+}
+export declare class MemoryWechatStore implements WechatStore {
+    private auth;
+    private cursor;
+    private readonly routes;
+    loadAuth(): WechatAuth | null;
+    saveAuth(auth: WechatAuth): void;
+    loadCursor(): string;
+    saveCursor(buf: string): void;
+    loadRoute(threadId: string): WechatRoute | null;
+    saveRoute(threadId: string, route: WechatRoute): void;
+    clearAll(): void;
+}
+/** Production store over the engine's kv (same db as the tickets — one backup story). */
+export declare class EngineWechatStore implements WechatStore {
+    private readonly kv;
+    constructor(kv: {
+        kvGet(k: string): string | null;
+        kvSet(k: string, v: string): void;
+        kvDelete(k: string): void;
+    });
+    loadAuth(): WechatAuth | null;
+    saveAuth(auth: WechatAuth): void;
+    loadCursor(): string;
+    saveCursor(buf: string): void;
+    loadRoute(threadId: string): WechatRoute | null;
+    saveRoute(threadId: string, route: WechatRoute): void;
+    clearAll(): void;
+}
+export interface WechatClientOptions {
+    token: string;
+    baseUrl?: string;
+    apiBase?: string;
+    fetchImpl?: typeof fetch;
+}
+export declare class WechatApiClient {
+    private readonly fetchImpl;
+    private readonly base;
+    private readonly token;
+    constructor(opts: WechatClientOptions);
+    private post;
+    getUpdates(getUpdatesBuf: string, signal?: AbortSignal): Promise<GetUpdatesResp>;
+    sendMessage(msg: WeixinMessage): Promise<SendMessageResp>;
+}
+export interface QrPayload {
+    qrcode: string;
+    imgBase64: string;
+}
+/**
+ * QR login flow: fetch a QR (the caller renders/saves the image — it must be scanned by the
+ * human's WeChat app), long-poll status until confirmed, return credentials.
+ */
+export declare function wechatLogin(onQr: (qr: QrPayload) => void, opts?: {
+    apiBase?: string;
+    fetchImpl?: typeof fetch;
+    pollMs?: number;
+}): Promise<WechatAuth>;
+/** threadId for a message: groups are threads; a DM peer is a thread. */
+export declare function wechatThreadId(m: WeixinMessage): string;
+export declare function wechatTriggerFromMessage(m: WeixinMessage): Trigger | null;
+export interface WechatSourceOptions {
+    store: WechatStore;
+    /** Abort the long-poll after this many ms so a watch cycle is never blocked (default 8s). */
+    pollTimeoutMs?: number;
+    apiBase?: string;
+    fetchImpl?: typeof fetch;
+    log?: (l: string) => void;
+}
+export declare class WechatSource implements Source {
+    private readonly opts;
+    readonly kind: "wechat";
+    private warnedNoAuth;
+    constructor(opts: WechatSourceOptions);
+    collect(from: SourceState, opts?: {
+        exclude?: ReadonlySet<string>;
+    }): Promise<{
+        triggers: Trigger[];
+        next: SourceState;
+    }>;
+}
+export declare class WechatReplyChannel implements ReplyChannel {
+    private readonly store;
+    private readonly clientOf;
+    private readonly log;
+    constructor(store: WechatStore, clientOf: (auth: WechatAuth) => WechatApiClient, log?: (l: string) => void);
+    matches(threadId: string): boolean;
+    deliver(threadId: string, body: string): Promise<{
+        externalId: string;
+    }>;
+}