agenthub-multiagent-mcp 1.75.0 → 1.76.1

package/dist/goshtiChannel/e2e.test.js

@@ -0,0 +1,163 @@
+// The real entry point, spawned the way Claude Code spawns it, against a local
+// stand-in for Goshti (REST + WebSocket). Covers what the unit tests cannot:
+// that a failure reaches the session as a channel notification rather than a
+// silent idle server, and that a trigger posted in Goshti arrives and can be
+// answered in its thread.
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";
+import { mkdtempSync, writeFileSync } from "node:fs";
+import { createServer } from "node:http";
+import { tmpdir } from "node:os";
+import { join, resolve } from "node:path";
+import { afterEach, describe, expect, it } from "vitest";
+import { z } from "zod";
+import { WebSocketServer } from "ws";
+const ENTRY = resolve(__dirname, "..", "goshtiChannel.ts");
+const TOKEN = "e2e-token-not-real";
+const Note = z.object({
+    method: z.literal("notifications/claude/channel"),
+    params: z.object({ content: z.string(), meta: z.record(z.string(), z.string()) }),
+});
+const cleanups = [];
+afterEach(async () => {
+    for (const c of cleanups.splice(0).reverse())
+        await c();
+});
+function home(config, credential = true) {
+    const d = mkdtempSync(join(tmpdir(), "goshti-e2e-"));
+    if (config)
+        writeFileSync(join(d, "config.json"), JSON.stringify(config));
+    if (credential && config) {
+        writeFileSync(join(d, "credentials.json"), JSON.stringify({ accounts: { [String(config.url)]: TOKEN } }), {
+            mode: 0o600,
+        });
+    }
+    return d;
+}
+async function start(dir) {
+    const notes = [];
+    const client = new Client({ name: "e2e", version: "0" }, { capabilities: {} });
+    client.setNotificationHandler(Note, async (n) => {
+        notes.push(n.params);
+    });
+    const transport = new StdioClientTransport({
+        command: process.execPath,
+        args: ["--import", "tsx", ENTRY],
+        env: { ...process.env, GOSHTI_CHANNEL_HOME: dir },
+        stderr: "pipe",
+    });
+    await client.connect(transport);
+    cleanups.push(() => client.close());
+    return { client, notes };
+}
+async function until(cond, ms = 15_000) {
+    const t = Date.now();
+    while (!cond()) {
+        if (Date.now() - t > ms)
+            throw new Error("timed out");
+        await new Promise((r) => setTimeout(r, 25));
+    }
+}
+async function goshti(opts = {}) {
+    const posts = [];
+    const http = createServer((req, res) => {
+        if (req.headers.authorization !== `Bearer ${TOKEN}` || opts.refuse) {
+            res.writeHead(401).end("{}");
+            return;
+        }
+        if (req.url === "/api/v4/users/me") {
+            res.end(JSON.stringify({ id: "me1", username: "sumit", is_bot: false }));
+        }
+        else if (req.url === "/api/v4/posts" && req.method === "POST") {
+            let body = "";
+            req.on("data", (c) => (body += c));
+            req.on("end", () => {
+                posts.push(JSON.parse(body));
+                res.writeHead(201).end(JSON.stringify({ id: "reply1" }));
+            });
+        }
+        else {
+            res.writeHead(404).end("{}");
+        }
+    });
+    const wss = new WebSocketServer({ noServer: true });
+    let current;
+    http.on("upgrade", (req, sock, head) => {
+        wss.handleUpgrade(req, sock, head, (ws) => {
+            current = ws;
+            ws.on("message", (raw) => {
+                const f = JSON.parse(raw.toString());
+                if (f.action === "authentication_challenge") {
+                    ws.send(JSON.stringify({ seq_reply: f.seq, status: "OK" }));
+                    ws.send(JSON.stringify({ event: "hello", data: {} }));
+                }
+            });
+        });
+    });
+    await new Promise((r) => http.listen(0, "127.0.0.1", r));
+    cleanups.push(() => new Promise((r) => {
+        for (const c of wss.clients)
+            c.terminate();
+        http.close(() => r());
+    }));
+    return { url: `http://127.0.0.1:${http.address().port}`, posts, socket: () => current };
+}
+describe("goshti-channel as Claude Code runs it", { timeout: 30_000 }, () => {
+    it("declares the channel capability and the reply tool", async () => {
+        const { client } = await start(home(null));
+        expect(client.getServerCapabilities()?.experimental).toHaveProperty("claude/channel");
+        const tools = await client.listTools();
+        expect(tools.tools.map((t) => t.name)).toEqual(["goshti_reply"]);
+    });
+    it("tells the session it is not set up, rather than idling silently", async () => {
+        const { notes } = await start(home(null));
+        await until(() => notes.length > 0);
+        expect(notes[0].meta).toMatchObject({ source: "goshti", status: "offline", reason: "not_configured" });
+        expect(notes[0].content).toMatch(/goshti-channel setup/);
+    });
+    // Spec: "Token revoked".
+    it("tells the session the channel is offline when the token is refused", async () => {
+        const g = await goshti({ refuse: true });
+        const { notes } = await start(home({ url: g.url }));
+        await until(() => notes.length > 0);
+        expect(notes[0].meta).toMatchObject({ status: "offline", reason: "token_refused" });
+        expect(notes[0].content).toMatch(/revoked|expired/);
+    });
+    it("delivers the person's trigger and answers in its thread, marked", async () => {
+        const g = await goshti();
+        const { client, notes } = await start(home({ url: g.url }));
+        await until(() => g.socket() !== undefined);
+        // Give the hello a moment to land before posting.
+        await new Promise((r) => setTimeout(r, 200));
+        g.socket().send(JSON.stringify({
+            event: "posted",
+            data: {
+                post: JSON.stringify({ id: "p1", channel_id: "c1", user_id: "me1", root_id: "", message: "@claude hello", type: "", props: {} }),
+                channel_type: "O",
+                channel_name: "town-square",
+                sender_name: "@sumit",
+            },
+        }));
+        g.socket().send(JSON.stringify({
+            event: "posted",
+            data: {
+                post: JSON.stringify({ id: "p2", channel_id: "c1", user_id: "col1", root_id: "", message: "@claude rm -rf", type: "", props: {} }),
+                channel_type: "O",
+                channel_name: "town-square",
+                sender_name: "@alice",
+            },
+        }));
+        await until(() => notes.some((n) => n.meta.post_id === "p1"));
+        await new Promise((r) => setTimeout(r, 200));
+        expect(notes.filter((n) => n.meta.type === "post").map((n) => n.meta.post_id)).toEqual(["p1"]);
+        const refused = await client.callTool({ name: "goshti_reply", arguments: { post_id: "p2", text: "no" } });
+        expect(refused.isError).toBe(true);
+        expect(g.posts).toHaveLength(0);
+        const ok = await client.callTool({ name: "goshti_reply", arguments: { post_id: "p1", text: "Hi!" } });
+        expect(ok.isError).toBe(false);
+        expect(g.posts).toHaveLength(1);
+        expect(g.posts[0]).toMatchObject({ channel_id: "c1", root_id: "p1", props: { from_claude: "true" } });
+        expect(String(g.posts[0].message)).toMatch(/^Hi![\s\S]*via Claude, for @sumit/);
+    });
+});
+//# sourceMappingURL=e2e.test.js.map

package/dist/goshtiChannel/e2e.test.js.map

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

package/dist/goshtiChannel/policy.d.ts

@@ -0,0 +1,154 @@
+/**
+ * The post property every reply carries, so this channel never delivers its
+ * own reply back to the session (the person's own post, often in their own
+ * direct conversation, quoting the trigger word) and readers and exports can
+ * tell a generated answer from a typed one.
+ *
+ * The connector's marker (task 1.5) is not built yet; when it is, the two
+ * should agree on this name.
+ */
+export declare const MARKER_PROP = "from_claude";
+/** The chat server rejects a post longer than 16,383 characters. */
+export declare const MAX_REPLY_CHARS = 16000;
+/** The longest triggering message passed to the session as is. */
+export declare const MAX_TRIGGER_CHARS = 8000;
+export interface ChannelPost {
+    id: string;
+    channelId: string;
+    userId: string;
+    rootId: string;
+    message: string;
+    /** Non-empty for system messages ("joined the channel"). */
+    type: string;
+    props: Record<string, unknown>;
+    createAt: number;
+}
+export interface PostedEvent {
+    post: ChannelPost;
+    /** "O" public, "P" private, "D" direct, "G" group. */
+    channelType: string;
+    channelName: string;
+    channelDisplayName?: string;
+    /** The poster's @name, as the server sends it. */
+    senderName: string;
+}
+export interface Me {
+    id: string;
+    username: string;
+}
+export interface Allowlist {
+    users: string[];
+    channels: string[];
+}
+export interface TriggerConfig {
+    trigger: string;
+    allow: Allowlist;
+}
+export type Decision = {
+    deliver: true;
+    reason: "own_trigger" | "self_dm" | "allowlisted";
+    thirdParty: boolean;
+} | {
+    deliver: false;
+    reason: "system" | "webhook" | "bot" | "own_reply" | "no_trigger" | "not_allowlisted" | "sender_unknown";
+};
+/**
+ * A `posted` WebSocket event, or null for one with no readable post. The post
+ * itself arrives as a JSON string inside the event's data.
+ */
+export declare function parsePostedEvent(data: Record<string, unknown>): PostedEvent | null;
+/**
+ * Whether a message contains the trigger word, as a word of its own: not part
+ * of a longer name (`@claudebot`, `@claude.team`) or an address (`x@claude.ai`).
+ */
+export declare function hasTrigger(message: string, trigger: string): boolean;
+/** Whether the event is in the person's direct conversation with themselves. */
+export declare function isSelfDirect(ev: PostedEvent, me: Me): boolean;
+/**
+ * Whether a post may be delivered to the session.
+ *
+ * `senderIsBot` is the sender's account as the server reports it: true, false,
+ * or undefined when it could not be looked up. Unknown is refused — an
+ * allowlist is a statement about people, and a sender who cannot be shown to
+ * be one is not let through on the strength of it.
+ */
+export declare function decide(ev: PostedEvent, me: Me, cfg: TriggerConfig, senderIsBot: boolean | undefined): Decision;
+/**
+ * Someone else's words, framed so they read as information and not as
+ * instructions. The text cannot close its own wrapper: any occurrence of the
+ * tag inside it is defused.
+ */
+export declare function wrapThirdParty(text: string, who: {
+    author: string;
+    userId: string;
+}): string;
+export interface ContextPost {
+    id: string;
+    userId: string;
+    message: string;
+    createAt: number;
+}
+export interface BoundedContext {
+    included: Array<ContextPost & {
+        truncated: boolean;
+    }>;
+    /** Posts in the thread that were left out. */
+    omitted: number;
+}
+/**
+ * The thread context sent with a delivery: the posts before the trigger, the
+ * most recent `maxPosts` of them, within `maxChars` in all (oldest dropped
+ * first), each one cut to a size of its own.
+ */
+export declare function boundContext(posts: ContextPost[], triggerId: string, bounds: {
+    maxPosts: number;
+    maxChars: number;
+}): BoundedContext;
+export interface ThreadTarget {
+    channelId: string;
+    rootId: string;
+}
+/**
+ * The threads this session may answer in: those that produced a delivery.
+ * Held in memory only, so a restarted session starts with none.
+ */
+export declare class ReplyGuard {
+    private readonly byPost;
+    record(post: {
+        id: string;
+        channelId: string;
+        rootId: string;
+    }): void;
+    resolve(postId: string): ThreadTarget | null;
+}
+/** A reply as posted: the visible marker added, the property set, the size held. */
+export declare function markReply(text: string, me: Me): {
+    message: string;
+    props: Record<string, string>;
+    truncated: boolean;
+};
+/**
+ * Fixed-period delivery cap. A period opens on the first delivery after the
+ * last one closed; what arrives over the cap is counted, not queued, and the
+ * count is handed out once, after its period ends.
+ */
+export declare class RateGate {
+    private readonly max;
+    private readonly periodMs;
+    private readonly now;
+    private start;
+    private count;
+    private held;
+    private pending;
+    constructor(max: number, periodMs: number, now?: () => number);
+    private roll;
+    admit(): boolean;
+    /** When the open period ends, or null when none is open. */
+    periodEndsAt(): number | null;
+    /** The number held back in periods that have ended, once; null if none. */
+    takeSummary(): {
+        held: number;
+        periodMs: number;
+    } | null;
+}
+//# sourceMappingURL=policy.d.ts.map

package/dist/goshtiChannel/policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.d.ts","sourceRoot":"","sources":["../../src/goshtiChannel/policy.ts"],"names":[],"mappings":"AAgBA;;;;;;;;GAQG;AACH,eAAO,MAAM,WAAW,gBAAgB,CAAC;AAEzC,oEAAoE;AACpE,eAAO,MAAM,eAAe,QAAS,CAAC;AAEtC,kEAAkE;AAClE,eAAO,MAAM,iBAAiB,OAAQ,CAAC;AAKvC,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,WAAW,CAAC;IAClB,sDAAsD;IACtD,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,kDAAkD;IAClD,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,EAAE;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,SAAS,CAAC;CAClB;AAED,MAAM,MAAM,QAAQ,GAChB;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,aAAa,GAAG,SAAS,GAAG,aAAa,CAAC;IAAC,UAAU,EAAE,OAAO,CAAA;CAAE,GACzF;IACE,OAAO,EAAE,KAAK,CAAC;IACf,MAAM,EACF,QAAQ,GACR,SAAS,GACT,KAAK,GACL,WAAW,GACX,YAAY,GACZ,iBAAiB,GACjB,gBAAgB,CAAC;CACtB,CAAC;AAKN;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,WAAW,GAAG,IAAI,CA6BlF;AAMD;;;GAGG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAKpE;AAED,gFAAgF;AAChF,wBAAgB,YAAY,CAAC,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,EAAE,GAAG,OAAO,CAE7D;AAED;;;;;;;GAOG;AACH,wBAAgB,MAAM,CACpB,EAAE,EAAE,WAAW,EACf,EAAE,EAAE,EAAE,EACN,GAAG,EAAE,aAAa,EAClB,WAAW,EAAE,OAAO,GAAG,SAAS,GAC/B,QAAQ,CAsBV;AAQD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAM5F;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,KAAK,CAAC,WAAW,GAAG;QAAE,SAAS,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IACtD,8CAA8C;IAC9C,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,WAAW,EAAE,EACpB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAC7C,cAAc,CAiBhB;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmC;IAE1D,MAAM,CAAC,IAAI,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAMrE,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;CAI7C;AAED,oFAAoF;AACpF,wBAAgB,SAAS,CACvB,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,EAAE,GACL;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CAMxE;AAED;;;;GAIG;AACH,qBAAa,QAAQ;IAOjB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,GAAG;IARtB,OAAO,CAAC,KAAK,CAAuB;IACpC,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,IAAI,CAAK;IACjB,OAAO,CAAC,OAAO,CAAK;gBAGD,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,EAChB,GAAG,GAAE,MAAM,MAAyB;IAGvD,OAAO,CAAC,IAAI;IASZ,KAAK,IAAI,OAAO;IAWhB,4DAA4D;IAC5D,YAAY,IAAI,MAAM,GAAG,IAAI;IAI7B,2EAA2E;IAC3E,WAAW,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;CAOzD"}

package/dist/goshtiChannel/policy.js

@@ -0,0 +1,240 @@
+// The rules of the Goshti channel (add-goshti-claude-connector, design Part 2).
+//
+// A channel pushes other people's text into a session that can run tools on
+// the person's machine. Treated carelessly that is remote prompt injection by
+// anyone who can post where the person can read. Everything here is pure, so
+// each rule is tested on its own and the I/O around it cannot quietly bend one:
+//
+//   1. Only the person's own posts trigger by default — the trigger word in a
+//      post, or anything in their direct conversation with themselves.
+//   2. Another sender is delivered only when both they and the channel are in
+//      the local allowlist. Bots and webhooks never, allowlisted or not.
+//   3. Anyone else's text is wrapped and labelled as untrusted.
+//   4. Thread context is bounded: last N posts, a character cap.
+//   5. A reply goes only into a thread that produced a delivery this session.
+//   6. Deliveries are capped per period; over it, one summary.
+/**
+ * The post property every reply carries, so this channel never delivers its
+ * own reply back to the session (the person's own post, often in their own
+ * direct conversation, quoting the trigger word) and readers and exports can
+ * tell a generated answer from a typed one.
+ *
+ * The connector's marker (task 1.5) is not built yet; when it is, the two
+ * should agree on this name.
+ */
+export const MARKER_PROP = "from_claude";
+/** The chat server rejects a post longer than 16,383 characters. */
+export const MAX_REPLY_CHARS = 16_000;
+/** The longest triggering message passed to the session as is. */
+export const MAX_TRIGGER_CHARS = 8_000;
+/** The longest single post of thread context. */
+const MAX_CONTEXT_POST_CHARS = 2_000;
+const str = (v) => (typeof v === "string" ? v : "");
+const truthy = (v) => v === true || v === "true";
+/**
+ * A `posted` WebSocket event, or null for one with no readable post. The post
+ * itself arrives as a JSON string inside the event's data.
+ */
+export function parsePostedEvent(data) {
+    const raw = data.post;
+    if (typeof raw !== "string" || raw === "")
+        return null;
+    let p;
+    try {
+        p = JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+    if (!p || typeof p !== "object" || !str(p.id) || !str(p.user_id) || !str(p.channel_id))
+        return null;
+    const props = p.props && typeof p.props === "object" ? p.props : {};
+    const out = {
+        post: {
+            id: str(p.id),
+            channelId: str(p.channel_id),
+            userId: str(p.user_id),
+            rootId: str(p.root_id),
+            message: str(p.message),
+            type: str(p.type),
+            props,
+            createAt: typeof p.create_at === "number" ? p.create_at : 0,
+        },
+        channelType: str(data.channel_type),
+        channelName: str(data.channel_name),
+        senderName: str(data.sender_name),
+    };
+    const display = str(data.channel_display_name);
+    if (display)
+        out.channelDisplayName = display;
+    return out;
+}
+function escapeRegex(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+/**
+ * Whether a message contains the trigger word, as a word of its own: not part
+ * of a longer name (`@claudebot`, `@claude.team`) or an address (`x@claude.ai`).
+ */
+export function hasTrigger(message, trigger) {
+    const t = trigger.trim();
+    if (!t)
+        return false;
+    const re = new RegExp(`(^|[^\\w@.-])${escapeRegex(t)}(?![\\w-]|\\.\\w)`, "i");
+    return re.test(message);
+}
+/** Whether the event is in the person's direct conversation with themselves. */
+export function isSelfDirect(ev, me) {
+    return ev.channelType === "D" && ev.channelName === `${me.id}__${me.id}`;
+}
+/**
+ * Whether a post may be delivered to the session.
+ *
+ * `senderIsBot` is the sender's account as the server reports it: true, false,
+ * or undefined when it could not be looked up. Unknown is refused — an
+ * allowlist is a statement about people, and a sender who cannot be shown to
+ * be one is not let through on the strength of it.
+ */
+export function decide(ev, me, cfg, senderIsBot) {
+    const { post } = ev;
+    if (post.type !== "")
+        return { deliver: false, reason: "system" };
+    if (truthy(post.props.from_webhook))
+        return { deliver: false, reason: "webhook" };
+    if (truthy(post.props.from_bot))
+        return { deliver: false, reason: "bot" };
+    if (truthy(post.props[MARKER_PROP]))
+        return { deliver: false, reason: "own_reply" };
+    if (post.userId === me.id) {
+        if (isSelfDirect(ev, me))
+            return { deliver: true, reason: "self_dm", thirdParty: false };
+        if (hasTrigger(post.message, cfg.trigger)) {
+            return { deliver: true, reason: "own_trigger", thirdParty: false };
+        }
+        return { deliver: false, reason: "no_trigger" };
+    }
+    if (!cfg.allow.users.includes(post.userId) || !cfg.allow.channels.includes(post.channelId)) {
+        return { deliver: false, reason: "not_allowlisted" };
+    }
+    if (senderIsBot === undefined)
+        return { deliver: false, reason: "sender_unknown" };
+    if (senderIsBot)
+        return { deliver: false, reason: "bot" };
+    if (!hasTrigger(post.message, cfg.trigger))
+        return { deliver: false, reason: "no_trigger" };
+    return { deliver: true, reason: "allowlisted", thirdParty: true };
+}
+const WRAP_TAG = "untrusted_third_party_text";
+function attr(s) {
+    return s.replace(/[^\w@.\- ]/g, "");
+}
+/**
+ * Someone else's words, framed so they read as information and not as
+ * instructions. The text cannot close its own wrapper: any occurrence of the
+ * tag inside it is defused.
+ */
+export function wrapThirdParty(text, who) {
+    const defused = text.replace(new RegExp(`<\\s*(/?)\\s*${WRAP_TAG}`, "gi"), (_m, slash) => `<${slash}_${WRAP_TAG}`);
+    return `<${WRAP_TAG} author="${attr(who.author)}" user_id="${attr(who.userId)}">\n${defused}\n</${WRAP_TAG}>`;
+}
+/**
+ * The thread context sent with a delivery: the posts before the trigger, the
+ * most recent `maxPosts` of them, within `maxChars` in all (oldest dropped
+ * first), each one cut to a size of its own.
+ */
+export function boundContext(posts, triggerId, bounds) {
+    const candidates = posts
+        .filter((p) => p.id !== triggerId)
+        .sort((a, b) => a.createAt - b.createAt);
+    const perPost = Math.max(1, Math.min(bounds.maxChars, MAX_CONTEXT_POST_CHARS));
+    const recent = candidates.slice(Math.max(0, candidates.length - bounds.maxPosts));
+    const included = [];
+    let total = 0;
+    for (let i = recent.length - 1; i >= 0; i--) {
+        const p = recent[i];
+        const cut = p.message.length > perPost;
+        const message = cut ? p.message.slice(0, perPost) : p.message;
+        if (total + message.length > bounds.maxChars)
+            break;
+        total += message.length;
+        included.unshift({ ...p, message, truncated: cut });
+    }
+    return { included, omitted: candidates.length - included.length };
+}
+/**
+ * The threads this session may answer in: those that produced a delivery.
+ * Held in memory only, so a restarted session starts with none.
+ */
+export class ReplyGuard {
+    byPost = new Map();
+    record(post) {
+        const target = { channelId: post.channelId, rootId: post.rootId || post.id };
+        this.byPost.set(post.id, target);
+        this.byPost.set(target.rootId, target);
+    }
+    resolve(postId) {
+        if (!postId)
+            return null;
+        return this.byPost.get(postId) ?? null;
+    }
+}
+/** A reply as posted: the visible marker added, the property set, the size held. */
+export function markReply(text, me) {
+    const marker = `\n\n_— via Claude, for @${me.username}_`;
+    const room = MAX_REPLY_CHARS - marker.length - 2;
+    const truncated = text.length > room;
+    const body = truncated ? `${text.slice(0, room)}…` : text;
+    return { message: `${body}${marker}`, props: { [MARKER_PROP]: "true" }, truncated };
+}
+/**
+ * Fixed-period delivery cap. A period opens on the first delivery after the
+ * last one closed; what arrives over the cap is counted, not queued, and the
+ * count is handed out once, after its period ends.
+ */
+export class RateGate {
+    max;
+    periodMs;
+    now;
+    start = null;
+    count = 0;
+    held = 0;
+    pending = 0;
+    constructor(max, periodMs, now = () => Date.now()) {
+        this.max = max;
+        this.periodMs = periodMs;
+        this.now = now;
+    }
+    roll() {
+        if (this.start !== null && this.now() >= this.start + this.periodMs) {
+            this.pending += this.held;
+            this.start = null;
+            this.count = 0;
+            this.held = 0;
+        }
+    }
+    admit() {
+        this.roll();
+        if (this.start === null)
+            this.start = this.now();
+        if (this.count < this.max) {
+            this.count++;
+            return true;
+        }
+        this.held++;
+        return false;
+    }
+    /** When the open period ends, or null when none is open. */
+    periodEndsAt() {
+        return this.start === null ? null : this.start + this.periodMs;
+    }
+    /** The number held back in periods that have ended, once; null if none. */
+    takeSummary() {
+        this.roll();
+        if (this.pending === 0)
+            return null;
+        const held = this.pending;
+        this.pending = 0;
+        return { held, periodMs: this.periodMs };
+    }
+}
+//# sourceMappingURL=policy.js.map

package/dist/goshtiChannel/policy.js.map

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

package/dist/goshtiChannel/policy.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=policy.test.d.ts.map

package/dist/goshtiChannel/policy.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.test.d.ts","sourceRoot":"","sources":["../../src/goshtiChannel/policy.test.ts"],"names":[],"mappings":""}