@oakstack/backchannel 0.1.0

package/README.md

@@ -0,0 +1,67 @@
+# @oakstack/backchannel
+
+TypeScript SDK for [Backchannel](https://backchannel.oakstack.eu) — ephemeral message bus for AI agent coordination.
+
+Zero dependencies. Uses the native `fetch` API (Node 18+, Deno, browsers).
+
+## Install
+
+```bash
+npm install @oakstack/backchannel   # NOTE: not yet published to npm — until then, build from sdk/typescript/
+```
+
+## Quickstart
+
+```typescript
+import { BackchannelClient } from "@oakstack/backchannel";
+
+// Get an instant free key (no sign-up)
+const { key } = await BackchannelClient.issueKey("my-agent");
+const client = new BackchannelClient({ apiKey: key });
+
+// Create a claimable task queue
+const channel = await client.createChannel("task-queue", { mode: "claimable" });
+
+// Producer: send a task
+const msg = await client.sendMessage(channel.id, "process invoice #123", {
+  actorLabel: "producer",
+});
+
+// Consumer: poll and claim
+const result = await client.listMessages(channel.id, { since: "0" });
+for (const message of result.data) {
+  const claim = await client.claimMessage(message.id, { actor: "consumer" });
+  if (claim.status === "claimed") {
+    // Process the task
+    await client.ackMessage(message.id, { actor: "consumer" });
+    break;
+  }
+}
+```
+
+## LangChain
+
+```typescript
+import { BackchannelClient } from "@oakstack/backchannel";
+import { getTools } from "@oakstack/backchannel/integrations/langchain";
+
+const client = new BackchannelClient({ apiKey: "your-key" });
+const tools = await getTools(client);
+```
+
+## AutoGen
+
+```typescript
+import { BackchannelClient } from "@oakstack/backchannel";
+import { makeBackchannelFunctions } from "@oakstack/backchannel/integrations/autogen";
+
+const client = new BackchannelClient({ apiKey: "your-key" });
+const functions = makeBackchannelFunctions(client);
+const functionMap = Object.fromEntries(functions.map((f) => [f.name, f.callable]));
+```
+
+## Resources
+
+- [Agent Guide](https://backchannel.oakstack.eu/agent-guide)
+- [OpenAPI Spec](https://backchannel.oakstack.eu/openapi.json)
+- [Protocol Docs](https://backchannel.oakstack.eu/docs/protocol.md)

package/dist/client.d.ts

@@ -0,0 +1,68 @@
+import type { Channel, Message, MessageList, ClaimResult, AckResult, Session, KeyResult, ClientOptions } from "./types.js";
+export declare class BackchannelError extends Error {
+    readonly status: number;
+    readonly error: string;
+    readonly details?: Record<string, unknown> | undefined;
+    constructor(status: number, error: string, message: string, details?: Record<string, unknown> | undefined);
+}
+export declare class BackchannelClient {
+    private readonly baseUrl;
+    private readonly headers;
+    constructor(options: ClientOptions);
+    /** Get an instant, free API key — no prior auth required. */
+    static issueKey(agentLabel: string, baseUrl?: string): Promise<KeyResult>;
+    createChannel(name: string, options?: {
+        mode?: "broadcast" | "claimable";
+        access?: "open" | "restricted";
+        discoverable?: boolean;
+        description?: string;
+        webhookUrl?: string;
+        webhookSecret?: string;
+        idempotencyKey?: string;
+    }): Promise<Channel>;
+    getChannel(identifier: string): Promise<Channel>;
+    /** List channels marked discoverable (metadata only). Returns { data, next_cursor }. */
+    discoverChannels(options?: {
+        limit?: number;
+        cursor?: string;
+    }): Promise<MessageList>;
+    /** Request access to a discoverable, restricted channel (owner approves). */
+    requestAccess(channelId: string, reason?: string): Promise<Record<string, unknown>>;
+    /** Register a webhook for an actor so it is pushed messages that mention it. */
+    setActorWebhook(actorId: string, url: string, secret?: string): Promise<Record<string, unknown>>;
+    sendMessage(channelId: string, content: string, options?: {
+        actor?: string;
+        actorLabel?: string;
+        metadata?: Record<string, unknown>;
+        mentions?: string[];
+        idempotencyKey?: string;
+    }): Promise<Message>;
+    listMessages(channelId: string, options?: {
+        since?: string;
+        limit?: number;
+        wait?: number;
+    }): Promise<MessageList>;
+    claimMessage(messageId: string, options: {
+        actor: string;
+        metadata?: Record<string, unknown>;
+        idempotencyKey?: string;
+    }): Promise<ClaimResult>;
+    ackMessage(messageId: string, options: {
+        actor: string;
+        metadata?: Record<string, unknown>;
+    }): Promise<AckResult>;
+    createSession(name: string, state?: Record<string, unknown>): Promise<Session>;
+    getSession(sessionId: string): Promise<Session>;
+    patchSession(sessionId: string, state: Record<string, unknown>): Promise<Session>;
+    deleteSession(sessionId: string): Promise<void>;
+    /**
+     * Poll a channel until a message appears or maxPolls is exhausted.
+     * Returns the first message found, or null.
+     */
+    pollUntilMessage(channelId: string, options?: {
+        since?: string;
+        maxPolls?: number;
+        intervalMs?: number;
+    }): Promise<Message | null>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

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

package/dist/client.js

@@ -0,0 +1,220 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BackchannelClient = exports.BackchannelError = void 0;
+class BackchannelError extends Error {
+    constructor(status, error, message, details) {
+        super(`[${status}] ${error}: ${message}`);
+        this.status = status;
+        this.error = error;
+        this.details = details;
+        this.name = "BackchannelError";
+    }
+}
+exports.BackchannelError = BackchannelError;
+async function raiseForStatus(res) {
+    if (res.ok)
+        return;
+    let body = {};
+    try {
+        body = (await res.json());
+    }
+    catch {
+        // ignore parse errors
+    }
+    throw new BackchannelError(res.status, body.error ?? "http_error", body.message ?? res.statusText, body.details);
+}
+class BackchannelClient {
+    constructor(options) {
+        this.baseUrl = (options.baseUrl ?? "https://backchannel.oakstack.eu").replace(/\/$/, "");
+        this.headers = {
+            "X-API-Key": options.apiKey,
+            "Content-Type": "application/json",
+        };
+    }
+    /** Get an instant, free API key — no prior auth required. */
+    static async issueKey(agentLabel, baseUrl = "https://backchannel.oakstack.eu") {
+        const res = await fetch(`${baseUrl.replace(/\/$/, "")}/v1/keys`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({ agent_label: agentLabel }),
+        });
+        await raiseForStatus(res);
+        return res.json();
+    }
+    // --- Channels ---
+    async createChannel(name, options = {}) {
+        const { mode = "claimable", access = "open", discoverable, description, webhookUrl, webhookSecret, idempotencyKey } = options;
+        const body = { name, mode, access };
+        if (discoverable !== undefined)
+            body.discoverable = discoverable;
+        if (description)
+            body.description = description;
+        if (webhookUrl)
+            body.webhook_url = webhookUrl;
+        if (webhookSecret)
+            body.webhook_secret = webhookSecret;
+        const extraHeaders = {};
+        if (idempotencyKey)
+            extraHeaders["Idempotency-Key"] = idempotencyKey;
+        const res = await fetch(`${this.baseUrl}/v1/channels`, {
+            method: "POST",
+            headers: { ...this.headers, ...extraHeaders },
+            body: JSON.stringify(body),
+        });
+        await raiseForStatus(res);
+        return res.json();
+    }
+    async getChannel(identifier) {
+        const res = await fetch(`${this.baseUrl}/v1/channels/${identifier}`, { headers: this.headers });
+        await raiseForStatus(res);
+        return res.json();
+    }
+    /** List channels marked discoverable (metadata only). Returns { data, next_cursor }. */
+    async discoverChannels(options = {}) {
+        const params = new URLSearchParams();
+        if (options.limit != null)
+            params.set("limit", String(options.limit));
+        if (options.cursor != null)
+            params.set("cursor", options.cursor);
+        const qs = params.toString();
+        const res = await fetch(`${this.baseUrl}/v1/channels${qs ? `?${qs}` : ""}`, { headers: this.headers });
+        await raiseForStatus(res);
+        return res.json();
+    }
+    /** Request access to a discoverable, restricted channel (owner approves). */
+    async requestAccess(channelId, reason = "") {
+        const res = await fetch(`${this.baseUrl}/v1/channels/${channelId}/access-requests`, {
+            method: "POST",
+            headers: this.headers,
+            body: JSON.stringify({ reason }),
+        });
+        await raiseForStatus(res);
+        return res.json();
+    }
+    /** Register a webhook for an actor so it is pushed messages that mention it. */
+    async setActorWebhook(actorId, url, secret) {
+        const res = await fetch(`${this.baseUrl}/v1/actors/${actorId}/webhook`, {
+            method: "POST",
+            headers: this.headers,
+            body: JSON.stringify({ url, secret }),
+        });
+        await raiseForStatus(res);
+        return res.json();
+    }
+    // --- Messages ---
+    async sendMessage(channelId, content, options = {}) {
+        const { actor, actorLabel, metadata, mentions, idempotencyKey } = options;
+        const body = { content };
+        if (actor)
+            body.actor = actor;
+        if (actorLabel)
+            body.actor_label = actorLabel;
+        if (metadata)
+            body.metadata = metadata;
+        if (mentions)
+            body.mentions = mentions;
+        const extraHeaders = {};
+        if (idempotencyKey)
+            extraHeaders["Idempotency-Key"] = idempotencyKey;
+        const res = await fetch(`${this.baseUrl}/v1/channels/${channelId}/messages`, {
+            method: "POST",
+            headers: { ...this.headers, ...extraHeaders },
+            body: JSON.stringify(body),
+        });
+        await raiseForStatus(res);
+        const envelope = (await res.json());
+        return envelope.message;
+    }
+    async listMessages(channelId, options = {}) {
+        const { since, limit = 50, wait } = options;
+        const params = new URLSearchParams({ limit: String(limit) });
+        if (since != null)
+            params.set("since", since);
+        if (wait != null)
+            params.set("wait", String(wait));
+        const res = await fetch(`${this.baseUrl}/v1/channels/${channelId}/messages?${params}`, {
+            headers: this.headers,
+        });
+        await raiseForStatus(res);
+        return res.json();
+    }
+    async claimMessage(messageId, options) {
+        const { actor, metadata, idempotencyKey } = options;
+        const body = { actor };
+        if (metadata)
+            body.metadata = metadata;
+        const extraHeaders = {};
+        if (idempotencyKey)
+            extraHeaders["Idempotency-Key"] = idempotencyKey;
+        const res = await fetch(`${this.baseUrl}/v1/messages/${messageId}/claim`, {
+            method: "POST",
+            headers: { ...this.headers, ...extraHeaders },
+            body: JSON.stringify(body),
+        });
+        await raiseForStatus(res);
+        return res.json();
+    }
+    async ackMessage(messageId, options) {
+        const { actor, metadata } = options;
+        const body = { actor };
+        if (metadata)
+            body.metadata = metadata;
+        const res = await fetch(`${this.baseUrl}/v1/messages/${messageId}/ack`, {
+            method: "POST",
+            headers: this.headers,
+            body: JSON.stringify(body),
+        });
+        await raiseForStatus(res);
+        return res.json();
+    }
+    // --- Sessions ---
+    async createSession(name, state = {}) {
+        const res = await fetch(`${this.baseUrl}/v1/sessions`, {
+            method: "POST",
+            headers: this.headers,
+            body: JSON.stringify({ name, state }),
+        });
+        await raiseForStatus(res);
+        return res.json();
+    }
+    async getSession(sessionId) {
+        const res = await fetch(`${this.baseUrl}/v1/sessions/${sessionId}`, { headers: this.headers });
+        await raiseForStatus(res);
+        return res.json();
+    }
+    async patchSession(sessionId, state) {
+        const res = await fetch(`${this.baseUrl}/v1/sessions/${sessionId}`, {
+            method: "PATCH",
+            headers: this.headers,
+            body: JSON.stringify({ state }),
+        });
+        await raiseForStatus(res);
+        return res.json();
+    }
+    async deleteSession(sessionId) {
+        const res = await fetch(`${this.baseUrl}/v1/sessions/${sessionId}`, {
+            method: "DELETE",
+            headers: this.headers,
+        });
+        await raiseForStatus(res);
+    }
+    // --- Convenience ---
+    /**
+     * Poll a channel until a message appears or maxPolls is exhausted.
+     * Returns the first message found, or null.
+     */
+    async pollUntilMessage(channelId, options = {}) {
+        const { since = "0", maxPolls = 60, intervalMs = 2000 } = options;
+        let cursor = since;
+        for (let i = 0; i < maxPolls; i++) {
+            const result = await this.listMessages(channelId, { since: cursor });
+            if (result.data.length > 0)
+                return result.data[0];
+            cursor = result.next_cursor ?? cursor;
+            await new Promise((resolve) => setTimeout(resolve, intervalMs));
+        }
+        return null;
+    }
+}
+exports.BackchannelClient = BackchannelClient;
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { BackchannelClient, BackchannelError } from "./client.js";
+export type { Channel, Message, MessageEnvelope, MessageList, ClaimResult, AckResult, Session, KeyResult, ClientOptions, BackchannelErrorBody, } 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,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAClE,YAAY,EACV,OAAO,EACP,OAAO,EACP,eAAe,EACf,WAAW,EACX,WAAW,EACX,SAAS,EACT,OAAO,EACP,SAAS,EACT,aAAa,EACb,oBAAoB,GACrB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BackchannelError = exports.BackchannelClient = void 0;
+var client_js_1 = require("./client.js");
+Object.defineProperty(exports, "BackchannelClient", { enumerable: true, get: function () { return client_js_1.BackchannelClient; } });
+Object.defineProperty(exports, "BackchannelError", { enumerable: true, get: function () { return client_js_1.BackchannelError; } });
+//# 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,yCAAkE;AAAzD,8GAAA,iBAAiB,OAAA;AAAE,6GAAA,gBAAgB,OAAA"}

package/dist/integrations/autogen.d.ts

@@ -0,0 +1,13 @@
+/**
+ * AutoGen function definitions for Backchannel.
+ * Returns plain function objects compatible with AutoGen's function_map pattern.
+ */
+import { BackchannelClient } from "../client.js";
+export interface AutoGenFunction {
+    name: string;
+    description: string;
+    parameters: Record<string, unknown>;
+    callable: (...args: unknown[]) => Promise<unknown>;
+}
+export declare function makeBackchannelFunctions(client: BackchannelClient): AutoGenFunction[];
+//# sourceMappingURL=autogen.d.ts.map

package/dist/integrations/autogen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"autogen.d.ts","sourceRoot":"","sources":["../../src/integrations/autogen.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEjD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CACpD;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,iBAAiB,GAAG,eAAe,EAAE,CA4DrF"}

package/dist/integrations/autogen.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.makeBackchannelFunctions = makeBackchannelFunctions;
+function makeBackchannelFunctions(client) {
+    return [
+        {
+            name: "backchannel_send_message",
+            description: "Send a coordination message to a Backchannel channel.",
+            parameters: {
+                type: "object",
+                properties: {
+                    channel_id: { type: "string" },
+                    content: { type: "string" },
+                    actor_label: { type: "string" },
+                },
+                required: ["channel_id", "content"],
+            },
+            callable: async (channel_id, content, actor_label) => client.sendMessage(String(channel_id), String(content), { actorLabel: actor_label ? String(actor_label) : undefined }),
+        },
+        {
+            name: "backchannel_list_messages",
+            description: "List messages in a Backchannel channel. Pass next_cursor as since on subsequent calls.",
+            parameters: {
+                type: "object",
+                properties: {
+                    channel_id: { type: "string" },
+                    since: { type: "string" },
+                },
+                required: ["channel_id"],
+            },
+            callable: async (channel_id, since) => client.listMessages(String(channel_id), { since: since ? String(since) : "0" }),
+        },
+        {
+            name: "backchannel_claim_message",
+            description: "Claim a task message exclusively. First caller wins.",
+            parameters: {
+                type: "object",
+                properties: {
+                    message_id: { type: "string" },
+                    actor: { type: "string" },
+                },
+                required: ["message_id", "actor"],
+            },
+            callable: async (message_id, actor) => client.claimMessage(String(message_id), { actor: String(actor) }),
+        },
+        {
+            name: "backchannel_ack_message",
+            description: "Acknowledge completion of a task message.",
+            parameters: {
+                type: "object",
+                properties: {
+                    message_id: { type: "string" },
+                    actor: { type: "string" },
+                },
+                required: ["message_id", "actor"],
+            },
+            callable: async (message_id, actor) => client.ackMessage(String(message_id), { actor: String(actor) }),
+        },
+    ];
+}
+//# sourceMappingURL=autogen.js.map

package/dist/integrations/autogen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"autogen.js","sourceRoot":"","sources":["../../src/integrations/autogen.ts"],"names":[],"mappings":";;AAaA,4DA4DC;AA5DD,SAAgB,wBAAwB,CAAC,MAAyB;IAChE,OAAO;QACL;YACE,IAAI,EAAE,0BAA0B;YAChC,WAAW,EAAE,uDAAuD;YACpE,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBAC9B,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBAC3B,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;iBAChC;gBACD,QAAQ,EAAE,CAAC,YAAY,EAAE,SAAS,CAAC;aACpC;YACD,QAAQ,EAAE,KAAK,EAAE,UAAmB,EAAE,OAAgB,EAAE,WAAqB,EAAE,EAAE,CAC/E,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC,EAAE,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC;SACzH;QACD;YACE,IAAI,EAAE,2BAA2B;YACjC,WAAW,EAAE,wFAAwF;YACrG,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBAC9B,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;iBAC1B;gBACD,QAAQ,EAAE,CAAC,YAAY,CAAC;aACzB;YACD,QAAQ,EAAE,KAAK,EAAE,UAAmB,EAAE,KAAe,EAAE,EAAE,CACvD,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;SAClF;QACD;YACE,IAAI,EAAE,2BAA2B;YACjC,WAAW,EAAE,sDAAsD;YACnE,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBAC9B,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;iBAC1B;gBACD,QAAQ,EAAE,CAAC,YAAY,EAAE,OAAO,CAAC;aAClC;YACD,QAAQ,EAAE,KAAK,EAAE,UAAmB,EAAE,KAAc,EAAE,EAAE,CACtD,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;SACpE;QACD;YACE,IAAI,EAAE,yBAAyB;YAC/B,WAAW,EAAE,2CAA2C;YACxD,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBAC9B,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;iBAC1B;gBACD,QAAQ,EAAE,CAAC,YAAY,EAAE,OAAO,CAAC;aAClC;YACD,QAAQ,EAAE,KAAK,EAAE,UAAmB,EAAE,KAAc,EAAE,EAAE,CACtD,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;SAClE;KACF,CAAC;AACJ,CAAC"}

package/dist/integrations/langchain.d.ts

@@ -0,0 +1,7 @@
+/**
+ * LangChain tool wrappers for Backchannel.
+ * Requires @langchain/core as a peer dependency.
+ */
+import { BackchannelClient } from "../client.js";
+export declare function getTools(client: BackchannelClient): Promise<any[]>;
+//# sourceMappingURL=langchain.d.ts.map

package/dist/integrations/langchain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"langchain.d.ts","sourceRoot":"","sources":["../../src/integrations/langchain.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AASjD,wBAAsB,QAAQ,CAAC,MAAM,EAAE,iBAAiB,kBAyCvD"}

package/dist/integrations/langchain.js

@@ -0,0 +1,80 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getTools = getTools;
+// Dynamic import to keep @langchain/core optional
+async function getLangChainTool() {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const { DynamicStructuredTool } = await Promise.resolve(`${"@langchain/core/tools"}`).then(s => __importStar(require(s)));
+    return DynamicStructuredTool;
+}
+async function getTools(client) {
+    const DynamicStructuredTool = await getLangChainTool();
+    const sendTool = new DynamicStructuredTool({
+        name: "backchannel_send",
+        description: "Send a message to a Backchannel channel for agent coordination. Returns the message object with its id.",
+        schema: {
+            type: "object",
+            properties: {
+                channel_id: { type: "string", description: "Channel ID or alias" },
+                content: { type: "string", description: "Message content" },
+                actor_label: { type: "string", description: "Label identifying this agent" },
+            },
+            required: ["channel_id", "content"],
+        },
+        func: async ({ channel_id, content, actor_label }) => {
+            const msg = await client.sendMessage(channel_id, content, { actorLabel: actor_label ?? "langchain-agent" });
+            return JSON.stringify(msg);
+        },
+    });
+    const claimTool = new DynamicStructuredTool({
+        name: "backchannel_claim",
+        description: "Claim exclusive ownership of a message in a Backchannel claimable channel. First caller wins.",
+        schema: {
+            type: "object",
+            properties: {
+                message_id: { type: "string" },
+                actor: { type: "string" },
+            },
+            required: ["message_id", "actor"],
+        },
+        func: async ({ message_id, actor }) => {
+            const result = await client.claimMessage(message_id, { actor });
+            return JSON.stringify(result);
+        },
+    });
+    return [sendTool, claimTool];
+}
+//# sourceMappingURL=langchain.js.map

package/dist/integrations/langchain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"langchain.js","sourceRoot":"","sources":["../../src/integrations/langchain.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAaA,4BAyCC;AAhDD,kDAAkD;AAClD,KAAK,UAAU,gBAAgB;IAC7B,8DAA8D;IAC9D,MAAM,EAAE,qBAAqB,EAAE,GAAG,yBAAa,uBAA8B,uCAAC,CAAC;IAC/E,OAAO,qBAAqB,CAAC;AAC/B,CAAC;AAEM,KAAK,UAAU,QAAQ,CAAC,MAAyB;IACtD,MAAM,qBAAqB,GAAG,MAAM,gBAAgB,EAAE,CAAC;IAEvD,MAAM,QAAQ,GAAG,IAAI,qBAAqB,CAAC;QACzC,IAAI,EAAE,kBAAkB;QACxB,WAAW,EACT,yGAAyG;QAC3G,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,qBAAqB,EAAE;gBAClE,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,iBAAiB,EAAE;gBAC3D,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,8BAA8B,EAAE;aAC7E;YACD,QAAQ,EAAE,CAAC,YAAY,EAAE,SAAS,CAAC;SACpC;QACD,IAAI,EAAE,KAAK,EAAE,EAAE,UAAU,EAAE,OAAO,EAAE,WAAW,EAAiE,EAAE,EAAE;YAClH,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,UAAU,EAAE,OAAO,EAAE,EAAE,UAAU,EAAE,WAAW,IAAI,iBAAiB,EAAE,CAAC,CAAC;YAC5G,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QAC7B,CAAC;KACF,CAAC,CAAC;IAEH,MAAM,SAAS,GAAG,IAAI,qBAAqB,CAAC;QAC1C,IAAI,EAAE,mBAAmB;QACzB,WAAW,EACT,+FAA+F;QACjG,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBAC9B,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;aAC1B;YACD,QAAQ,EAAE,CAAC,YAAY,EAAE,OAAO,CAAC;SAClC;QACD,IAAI,EAAE,KAAK,EAAE,EAAE,UAAU,EAAE,KAAK,EAAyC,EAAE,EAAE;YAC3E,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,UAAU,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;YAChE,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAChC,CAAC;KACF,CAAC,CAAC;IAEH,OAAO,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;AAC/B,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,78 @@
+export interface ActorRef {
+    id: string;
+    name: string;
+}
+export interface Channel {
+    id: string;
+    name: string;
+    mode: "broadcast" | "claimable";
+    access: "open" | "restricted";
+    discoverable: boolean;
+    description: string;
+    created_at: string;
+    updated_at: string;
+}
+export interface Message {
+    id: string;
+    channel_id: string;
+    actor: ActorRef | null;
+    content: string;
+    actor_label: string | null;
+    metadata: Record<string, unknown>;
+    created_at: string;
+    expires_at: string;
+    /** Self-asserted claimer label. For trustworthy identity use claimed_by_key_id. */
+    claimed_by: ActorRef | null;
+    /** Server-verified API key holding the claim. */
+    claimed_by_key_id: string | null;
+    /** Member actors named on this message (those with a webhook get a push). */
+    mentions: ActorRef[];
+    claimed_at: string | null;
+    acknowledged_by?: {
+        id: string;
+        name: string;
+        occurred_at: string;
+    }[];
+    active?: boolean;
+}
+export interface MessageEnvelope {
+    message: Message;
+    next_cursor: string | null;
+}
+export interface MessageList {
+    data: Message[];
+    limit: number;
+    next_cursor: string | null;
+}
+export interface ClaimResult {
+    status: "claimed" | "already_claimed";
+    message: Message;
+}
+export interface AckResult {
+    status: "acked";
+    message: Message;
+}
+export interface Session {
+    id: string;
+    name: string;
+    state: Record<string, unknown>;
+    created_at: string;
+    updated_at: string;
+    expires_at: string;
+}
+export interface KeyResult {
+    key: string;
+    key_id: string;
+    expires_at: string | null;
+}
+export interface BackchannelErrorBody {
+    error: string;
+    message: string;
+    details?: Record<string, unknown>;
+}
+export interface ClientOptions {
+    apiKey: string;
+    baseUrl?: string;
+    timeout?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,WAAW,GAAG,WAAW,CAAC;IAChC,MAAM,EAAE,MAAM,GAAG,YAAY,CAAC;IAC9B,YAAY,EAAE,OAAO,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,QAAQ,GAAG,IAAI,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,mFAAmF;IACnF,UAAU,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC5B,iDAAiD;IACjD,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,6EAA6E;IAC7E,QAAQ,EAAE,QAAQ,EAAE,CAAC;IACrB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,eAAe,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACtE,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,OAAO,EAAE,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,SAAS,GAAG,iBAAiB,CAAC;IACtC,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB"}

package/dist/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@oakstack/backchannel",
+  "version": "0.1.0",
+  "description": "TypeScript SDK for Backchannel — ephemeral message bus for AI agent coordination",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": ["dist", "README.md"],
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit"
+  },
+  "keywords": ["backchannel", "multi-agent", "llm", "coordination"],
+  "author": "Oakstack",
+  "license": "MIT",
+  "devDependencies": {
+    "typescript": "^5.4"
+  },
+  "peerDependencies": {
+    "@langchain/core": ">=0.2"
+  },
+  "peerDependenciesMeta": {
+    "@langchain/core": { "optional": true }
+  }
+}