@avernet-plugin/deepseek-harness-channel-bcn 0.1.0

package/dist/endpoint.js

@@ -0,0 +1,156 @@
+import { lookup as dnsLookup } from 'node:dns/promises';
+import { BlockList, isIP } from 'node:net';
+const BLOCKED_IPV6 = new BlockList();
+BLOCKED_IPV6.addSubnet('::', 96, 'ipv6');
+BLOCKED_IPV6.addSubnet('64:ff9b::', 96, 'ipv6');
+BLOCKED_IPV6.addSubnet('64:ff9b:1::', 48, 'ipv6');
+BLOCKED_IPV6.addSubnet('fc00::', 7, 'ipv6');
+BLOCKED_IPV6.addSubnet('fe80::', 10, 'ipv6');
+BLOCKED_IPV6.addSubnet('fec0::', 10, 'ipv6');
+BLOCKED_IPV6.addSubnet('ff00::', 8, 'ipv6');
+BLOCKED_IPV6.addSubnet('100::', 64, 'ipv6');
+BLOCKED_IPV6.addSubnet('2001::', 32, 'ipv6');
+BLOCKED_IPV6.addSubnet('2001:2::', 48, 'ipv6');
+BLOCKED_IPV6.addSubnet('2001:db8::', 32, 'ipv6');
+BLOCKED_IPV6.addSubnet('2001:20::', 28, 'ipv6');
+BLOCKED_IPV6.addSubnet('2002::', 16, 'ipv6');
+export async function resolveEndpoint(input, resolver = async (hostname) => dnsLookup(hostname, { all: true, verbatim: true })) {
+    const baseUrl = parseEndpoint(input);
+    const hostname = stripIpv6Brackets(baseUrl.hostname).toLowerCase();
+    const literalFamily = isIP(hostname);
+    const addresses = literalFamily
+        ? [{ address: hostname, family: literalFamily }]
+        : await resolver(hostname);
+    if (addresses.length === 0)
+        throw new Error('BCN endpoint hostname resolved to no addresses');
+    const normalized = addresses.map(({ address, family }) => {
+        const actualFamily = isIP(address);
+        if ((family !== 4 && family !== 6) || actualFamily !== family) {
+            throw new Error('BCN endpoint hostname returned an invalid DNS address');
+        }
+        return { address, family };
+    });
+    const loopbackHost = hostname === 'localhost'
+        || (literalFamily !== 0 && normalized.every(item => isLoopbackAddress(item.address)));
+    if (loopbackHost) {
+        if (!normalized.every(item => isLoopbackAddress(item.address))) {
+            throw new Error('Loopback BCN endpoint resolved outside the loopback range');
+        }
+    }
+    else if (!normalized.every(item => isPublicAddress(item.address))) {
+        throw new Error('BCN endpoint resolved to a private, link-local, or reserved address');
+    }
+    const lookup = createPinnedLookup(hostname, normalized);
+    const webSocketUrl = new URL('ws/bot', baseUrl);
+    webSocketUrl.protocol = baseUrl.protocol === 'https:' ? 'wss:' : 'ws:';
+    return { baseUrl, webSocketUrl, addresses: normalized, lookup, loopback: loopbackHost };
+}
+export function canonicalizeEndpoint(input) {
+    return parseEndpoint(input).toString();
+}
+export function parseEndpoint(input) {
+    let parsed;
+    try {
+        parsed = new URL(input);
+    }
+    catch {
+        throw new Error('BCN endpoint must be an absolute HTTP(S) URL');
+    }
+    if (parsed.protocol !== 'http:' && parsed.protocol !== 'https:') {
+        throw new Error('BCN endpoint must use HTTP or HTTPS');
+    }
+    if (!parsed.hostname)
+        throw new Error('BCN endpoint must include a hostname');
+    if (parsed.username || parsed.password || parsed.search || parsed.hash) {
+        throw new Error('BCN endpoint must not contain credentials, query parameters, or a fragment');
+    }
+    parsed.pathname = `${parsed.pathname.replace(/\/+$/, '')}/`;
+    return parsed;
+}
+export function isPublicAddress(address) {
+    const family = isIP(address);
+    if (family === 4)
+        return isPublicIpv4(address);
+    if (family === 6)
+        return isPublicIpv6(address);
+    return false;
+}
+export function isLoopbackAddress(address) {
+    const normalized = address.toLowerCase();
+    if (normalized === '::1')
+        return true;
+    if (normalized.startsWith('::ffff:'))
+        return isLoopbackAddress(normalized.slice(7));
+    const parts = parseIpv4(normalized);
+    return parts?.[0] === 127;
+}
+function isPublicIpv4(address) {
+    const parts = parseIpv4(address);
+    if (!parts)
+        return false;
+    const [a, b, c] = parts;
+    if (a === 0 || a === 10 || a === 127 || a >= 224)
+        return false;
+    if (a === 100 && b >= 64 && b <= 127)
+        return false;
+    if (a === 169 && b === 254)
+        return false;
+    if (a === 172 && b >= 16 && b <= 31)
+        return false;
+    if (a === 192 && b === 168)
+        return false;
+    if (a === 198 && (b === 18 || b === 19))
+        return false;
+    if (a === 192 && b === 0 && (c === 0 || c === 2))
+        return false;
+    if (a === 198 && b === 51 && c === 100)
+        return false;
+    if (a === 203 && b === 0 && c === 113)
+        return false;
+    return true;
+}
+function isPublicIpv6(address) {
+    const normalized = address.toLowerCase().split('%', 1)[0] ?? '';
+    if (!normalized || normalized.startsWith('::ffff:'))
+        return false;
+    return !BLOCKED_IPV6.check(normalized, 'ipv6');
+}
+function parseIpv4(address) {
+    const parts = address.split('.');
+    if (parts.length !== 4)
+        return undefined;
+    const values = parts.map(part => Number(part));
+    if (values.some(value => !Number.isInteger(value) || value < 0 || value > 255))
+        return undefined;
+    return values;
+}
+function stripIpv6Brackets(hostname) {
+    return hostname.startsWith('[') && hostname.endsWith(']') ? hostname.slice(1, -1) : hostname;
+}
+function createPinnedLookup(expectedHostname, addresses) {
+    let cursor = 0;
+    return ((hostname, options, callback) => {
+        if (stripIpv6Brackets(hostname).toLowerCase() !== expectedHostname) {
+            callback(new Error('Refusing DNS lookup for an unexpected BCN hostname'));
+            return;
+        }
+        const optionRecord = typeof options === 'object' && options !== null
+            ? options
+            : { family: typeof options === 'number' ? options : 0 };
+        const matching = optionRecord.family === 4 || optionRecord.family === 6
+            ? addresses.filter(item => item.family === optionRecord.family)
+            : [...addresses];
+        if (matching.length === 0) {
+            callback(new Error('No validated BCN address matches the requested address family'));
+            return;
+        }
+        if (optionRecord.all) {
+            callback(null, matching);
+            return;
+        }
+        const selected = matching[cursor % matching.length];
+        cursor += 1;
+        callback(null, selected?.address, selected?.family);
+    });
+}
+//# sourceMappingURL=endpoint.js.map

package/dist/endpoint.js.map

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

package/dist/http-client.d.ts

@@ -0,0 +1,28 @@
+import type { Config } from './config.js';
+import type { ResolvedEndpoint } from './endpoint.js';
+import { type BotSession, type RegisterBotResponse } from './protocol.js';
+export interface HttpTransport {
+    requestJson(endpoint: ResolvedEndpoint, path: string, options: {
+        method: 'POST';
+        headers?: Record<string, string>;
+        body?: unknown;
+        query?: URLSearchParams;
+    }, timeoutMs: number): Promise<unknown>;
+}
+export declare class NodeHttpTransport implements HttpTransport {
+    requestJson(endpoint: ResolvedEndpoint, path: string, options: {
+        method: 'POST';
+        headers?: Record<string, string>;
+        body?: unknown;
+        query?: URLSearchParams;
+    }, timeoutMs: number): Promise<unknown>;
+}
+export declare class BcnOnboardingClient {
+    private readonly endpoint;
+    private readonly transport;
+    private readonly timeoutMs;
+    constructor(endpoint: ResolvedEndpoint, transport: HttpTransport, timeoutMs: number);
+    register(token: string, botName: string): Promise<RegisterBotResponse>;
+    onboard(session: BotSession, config: Config): Promise<void>;
+}
+//# sourceMappingURL=http-client.d.ts.map

package/dist/http-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-client.d.ts","sourceRoot":"","sources":["../src/http-client.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAIL,KAAK,UAAU,EACf,KAAK,mBAAmB,EACzB,MAAM,eAAe,CAAC;AAEvB,MAAM,WAAW,aAAa;IAC5B,WAAW,CACT,QAAQ,EAAE,gBAAgB,EAC1B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,eAAe,CAAA;KAAE,EACtG,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,OAAO,CAAC,CAAC;CACrB;AAED,qBAAa,iBAAkB,YAAW,aAAa;IAC/C,WAAW,CACf,QAAQ,EAAE,gBAAgB,EAC1B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,eAAe,CAAA;KAAE,EACtG,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,OAAO,CAAC;CA6DpB;AAED,qBAAa,mBAAmB;IAE5B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAFT,QAAQ,EAAE,gBAAgB,EAC1B,SAAS,EAAE,aAAa,EACxB,SAAS,EAAE,MAAM;IAG9B,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAiBtE,OAAO,CAAC,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAqBlE"}

package/dist/http-client.js

@@ -0,0 +1,106 @@
+import { request as httpRequest } from 'node:http';
+import { request as httpsRequest } from 'node:https';
+import { MAX_FRAME_BYTES, asNonEmptyString, asRecord, } from './protocol.js';
+export class NodeHttpTransport {
+    async requestJson(endpoint, path, options, timeoutMs) {
+        const url = new URL(path.replace(/^\/+/, ''), endpoint.baseUrl);
+        if (options.query)
+            url.search = options.query.toString();
+        const body = options.body === undefined ? undefined : Buffer.from(JSON.stringify(options.body), 'utf8');
+        if (body && body.byteLength > MAX_FRAME_BYTES)
+            throw new Error('BCN HTTP request body exceeds 2 MiB');
+        const requestOptions = {
+            protocol: url.protocol,
+            hostname: url.hostname,
+            port: url.port || undefined,
+            path: `${url.pathname}${url.search}`,
+            method: options.method,
+            lookup: endpoint.lookup,
+            headers: {
+                accept: 'application/json',
+                ...(body ? { 'content-type': 'application/json', 'content-length': String(body.byteLength) } : {}),
+                ...options.headers,
+            },
+            agent: false,
+        };
+        // COSEC: endpoint resolution rejects non-public destinations (except exact
+        // loopback development), pins DNS, and this client never follows redirects.
+        // HTTP is an explicit deployment option; production operators should prefer HTTPS.
+        return new Promise((resolve, reject) => {
+            const request = (url.protocol === 'https:' ? httpsRequest : httpRequest)(requestOptions, response => {
+                let total = 0;
+                const chunks = [];
+                response.on('data', (chunk) => {
+                    const buffer = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
+                    total += buffer.byteLength;
+                    if (total > MAX_FRAME_BYTES) {
+                        request.destroy(new Error('BCN HTTP response exceeds 2 MiB'));
+                        return;
+                    }
+                    chunks.push(buffer);
+                });
+                response.on('end', () => {
+                    const status = response.statusCode ?? 0;
+                    if (status < 200 || status >= 300) {
+                        reject(new Error(`BCN HTTP request failed with status ${status}`));
+                        return;
+                    }
+                    const raw = Buffer.concat(chunks).toString('utf8');
+                    if (!raw) {
+                        resolve({});
+                        return;
+                    }
+                    try {
+                        resolve(JSON.parse(raw));
+                    }
+                    catch {
+                        reject(new Error('BCN HTTP response is not valid JSON'));
+                    }
+                });
+            });
+            request.setTimeout(timeoutMs, () => request.destroy(new Error('BCN HTTP request timed out')));
+            request.on('error', error => reject(new Error('BCN HTTP request failed', { cause: error })));
+            if (body)
+                request.write(body);
+            request.end();
+        });
+    }
+}
+export class BcnOnboardingClient {
+    endpoint;
+    transport;
+    timeoutMs;
+    constructor(endpoint, transport, timeoutMs) {
+        this.endpoint = endpoint;
+        this.transport = transport;
+        this.timeoutMs = timeoutMs;
+    }
+    async register(token, botName) {
+        const query = new URLSearchParams({ token, 'bot-name': botName });
+        const response = asRecord(await this.transport.requestJson(this.endpoint, 'register', { method: 'POST', query }, this.timeoutMs));
+        const registeredName = asNonEmptyString(response?.bot_name);
+        const botUuid = asNonEmptyString(response?.bot_uuid);
+        const botToken = asNonEmptyString(response?.bot_token);
+        if (!registeredName || !botUuid || !botToken) {
+            throw new Error('BCN registration returned an incomplete Bot Session');
+        }
+        return { bot_name: registeredName, bot_uuid: botUuid, bot_token: botToken };
+    }
+    async onboard(session, config) {
+        const response = asRecord(await this.transport.requestJson(this.endpoint, 'bots/onboard', {
+            method: 'POST',
+            headers: { authorization: `Bearer ${session.botToken}` },
+            body: {
+                name: config.botName || session.botName,
+                summary: config.summary,
+                domains: config.domains,
+                skills: config.skills,
+                scopes: config.scopes,
+            },
+        }, this.timeoutMs));
+        if (response?.onboarded !== true || asNonEmptyString(response.bot_uuid) !== session.botUuid) {
+            throw new Error('BCN rejected Bot descriptor onboarding');
+        }
+    }
+}
+//# sourceMappingURL=http-client.js.map

package/dist/http-client.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+import type { Context } from '@deepseek-ai/cordis';
+import { Config, type Config as PluginConfig } from './config.js';
+export declare const name = "deepseek-harness-channel-bcn";
+export declare const inject: string[];
+export { Config };
+export type { Config as DeepSeekHarnessBcnConfig } from './config.js';
+export declare function apply(ctx: Context, rawConfig: PluginConfig): Promise<() => Promise<void>>;
+//# 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,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAEnD,OAAO,EAAE,MAAM,EAAmB,KAAK,MAAM,IAAI,YAAY,EAAE,MAAM,aAAa,CAAC;AAInF,eAAO,MAAM,IAAI,iCAAiC,CAAC;AACnD,eAAO,MAAM,MAAM,UASlB,CAAC;AACF,OAAO,EAAE,MAAM,EAAE,CAAC;AAClB,YAAY,EAAE,MAAM,IAAI,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAEtE,wBAAsB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,SAAS,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,CA0B/F"}

package/dist/index.js

@@ -0,0 +1,42 @@
+import { BcnBridge } from './bridge.js';
+import { Config, normalizeConfig } from './config.js';
+import { loadOrOnboardBotSession, persistBotSession } from './credentials.js';
+import { BcnWsClient } from './ws-client.js';
+export const name = 'deepseek-harness-channel-bcn';
+export const inject = [
+    'agentDefaultModel',
+    'agentPresets',
+    'agents',
+    'credentials',
+    'sessions',
+    'sessionPersistence',
+    'systemPrompt',
+    'tools',
+];
+export { Config };
+export async function apply(ctx, rawConfig) {
+    const config = normalizeConfig(rawConfig);
+    const log = ctx.logger(name);
+    if (!config.enabled) {
+        log.info('BCN channel is installed but disabled');
+        return async () => { };
+    }
+    const { session, endpoint } = await loadOrOnboardBotSession(ctx, config);
+    let bridge;
+    const client = new BcnWsClient({
+        endpoint,
+        session,
+        config,
+        status: () => bridge?.busy ? 'busy' : 'idle',
+        onSessionChanged: rotated => persistBotSession(ctx, config, rotated),
+        log,
+    });
+    bridge = new BcnBridge(ctx, client, config, log);
+    bridge.start();
+    client.start();
+    return async () => {
+        await bridge?.dispose();
+        await client.stop();
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,MAAM,EAAE,eAAe,EAA+B,MAAM,aAAa,CAAC;AACnF,OAAO,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC9E,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C,MAAM,CAAC,MAAM,IAAI,GAAG,8BAA8B,CAAC;AACnD,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,mBAAmB;IACnB,cAAc;IACd,QAAQ;IACR,aAAa;IACb,UAAU;IACV,oBAAoB;IACpB,cAAc;IACd,OAAO;CACR,CAAC;AACF,OAAO,EAAE,MAAM,EAAE,CAAC;AAGlB,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,GAAY,EAAE,SAAuB;IAC/D,MAAM,MAAM,GAAG,eAAe,CAAC,SAAS,CAAC,CAAC;IAC1C,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC7B,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,GAAG,CAAC,IAAI,CAAC,uCAAuC,CAAC,CAAC;QAClD,OAAO,KAAK,IAAI,EAAE,GAAE,CAAC,CAAC;IACxB,CAAC;IAED,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,MAAM,uBAAuB,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IACzE,IAAI,MAA6B,CAAC;IAClC,MAAM,MAAM,GAAG,IAAI,WAAW,CAAC;QAC7B,QAAQ;QACR,OAAO;QACP,MAAM;QACN,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM;QAC5C,gBAAgB,EAAE,OAAO,CAAC,EAAE,CAAC,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC;QACpE,GAAG;KACJ,CAAC,CAAC;IACH,MAAM,GAAG,IAAI,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC;IACjD,MAAM,CAAC,KAAK,EAAE,CAAC;IACf,MAAM,CAAC,KAAK,EAAE,CAAC;IAEf,OAAO,KAAK,IAAI,EAAE;QAChB,MAAM,MAAM,EAAE,OAAO,EAAE,CAAC;QACxB,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;IACtB,CAAC,CAAC;AACJ,CAAC"}

package/dist/protocol.d.ts

@@ -0,0 +1,107 @@
+export declare const BCN_PROTOCOL_VERSION = 2;
+export declare const MAX_FRAME_BYTES: number;
+export interface RequestFrame {
+    type: 'req';
+    id: string;
+    method: string;
+    params: Record<string, unknown>;
+}
+export interface ResponseFrame {
+    type: 'res';
+    id: string;
+    ok: boolean;
+    payload?: Record<string, unknown>;
+    error?: {
+        code: string;
+        message: string;
+        retryable: boolean;
+        details?: unknown;
+        retry_after_ms?: number;
+    };
+}
+export interface EventFrame {
+    type: 'event';
+    event: string;
+    payload: Record<string, unknown>;
+    seq?: number;
+}
+export type BcnFrame = RequestFrame | ResponseFrame | EventFrame;
+export interface BotSession {
+    version: 1;
+    endpoint: string;
+    botUuid: string;
+    botToken: string;
+    botName: string;
+}
+export interface RegisterBotResponse {
+    bot_name: string;
+    bot_uuid: string;
+    bot_token: string;
+}
+export interface BotConnectResponse {
+    is_new: boolean;
+    token: string;
+    bot_uuid: string;
+    protocol_version: number;
+    min_supported_version?: number;
+    env?: Record<string, string>;
+}
+export interface MessageContent {
+    role: string;
+    content: Array<Record<string, unknown>>;
+    timestamp: number;
+}
+export interface ChatSendParams {
+    session_key: string;
+    bcs_group_id: string;
+    bcs_session_id?: string;
+    message: MessageContent;
+    channel: Record<string, unknown>;
+    session_context: Record<string, unknown>;
+    timeout_ms?: number;
+    idempotency_key?: string;
+    tags?: string[];
+    attachments?: Array<Record<string, unknown>>;
+}
+export interface ChatInjectParams {
+    session_key: string;
+    bcs_group_id: string;
+    bcs_session_id?: string;
+    message: MessageContent;
+    channel: Record<string, unknown>;
+    session_context: Record<string, unknown>;
+    tags?: string[];
+    attachments?: Array<Record<string, unknown>>;
+}
+export interface RouteSelector {
+    type: 'name' | 'bot';
+    value: string;
+}
+export interface ChatEventRouting {
+    responders: Array<{
+        type: string;
+        value?: string;
+    }>;
+    mode: 'required' | 'optional';
+    reason: string;
+    include_self: boolean;
+    dedupe_key?: string;
+}
+export interface PendingRouteIntent {
+    responders: Array<{
+        type: string;
+        value?: string;
+    }>;
+    mode: 'required' | 'optional';
+    reason: string;
+    includeSelf: boolean;
+    dedupeKey?: string;
+}
+export declare function asRecord(value: unknown): Record<string, unknown> | undefined;
+export declare function asNonEmptyString(value: unknown): string | undefined;
+export declare function parseFrame(value: unknown): BcnFrame | undefined;
+export declare function parseBotSession(value: string): BotSession;
+export declare function parseChatSendParams(value: unknown): ChatSendParams;
+export declare function parseChatInjectParams(value: unknown): ChatInjectParams;
+export declare function extractMessageText(message: MessageContent): string;
+//# sourceMappingURL=protocol.d.ts.map

package/dist/protocol.d.ts.map

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

package/dist/protocol.js

@@ -0,0 +1,157 @@
+export const BCN_PROTOCOL_VERSION = 2;
+export const MAX_FRAME_BYTES = 2 * 1024 * 1024;
+export function asRecord(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        return undefined;
+    return value;
+}
+export function asNonEmptyString(value) {
+    if (typeof value !== 'string')
+        return undefined;
+    const trimmed = value.trim();
+    return trimmed || undefined;
+}
+export function parseFrame(value) {
+    const frame = asRecord(value);
+    const id = asNonEmptyString(frame?.id);
+    if (!frame || !asNonEmptyString(frame.type))
+        return undefined;
+    if (frame.type === 'res') {
+        if (!id || typeof frame.ok !== 'boolean')
+            return undefined;
+        const payload = frame.payload === undefined ? undefined : asRecord(frame.payload);
+        if (frame.payload !== undefined && !payload)
+            return undefined;
+        const error = frame.error === undefined ? undefined : parseResponseError(frame.error);
+        if (frame.error !== undefined && !error)
+            return undefined;
+        if (!frame.ok && !error)
+            return undefined;
+        return {
+            type: 'res',
+            id,
+            ok: frame.ok,
+            ...(payload ? { payload } : {}),
+            ...(error ? { error } : {}),
+        };
+    }
+    if (frame.type === 'req') {
+        const method = asNonEmptyString(frame.method);
+        const params = asRecord(frame.params);
+        if (!id || !method || !params)
+            return undefined;
+        return { type: 'req', id, method, params };
+    }
+    if (frame.type === 'event') {
+        const event = asNonEmptyString(frame.event);
+        const payload = asRecord(frame.payload);
+        const seq = frame.seq === undefined ? undefined : Number(frame.seq);
+        if (!event || !payload || (seq !== undefined && (!Number.isSafeInteger(seq) || seq < 0)))
+            return undefined;
+        return { type: 'event', event, payload, ...(seq !== undefined ? { seq } : {}) };
+    }
+    return undefined;
+}
+function parseResponseError(value) {
+    const error = asRecord(value);
+    const code = asNonEmptyString(error?.code);
+    const message = asNonEmptyString(error?.message);
+    if (!error || !code || !message || typeof error.retryable !== 'boolean')
+        return undefined;
+    const retryAfterMs = error.retry_after_ms;
+    if (retryAfterMs !== undefined && (!Number.isSafeInteger(retryAfterMs) || Number(retryAfterMs) < 0)) {
+        return undefined;
+    }
+    return {
+        code,
+        message,
+        retryable: error.retryable,
+        ...(Object.hasOwn(error, 'details') ? { details: error.details } : {}),
+        ...(retryAfterMs !== undefined ? { retry_after_ms: Number(retryAfterMs) } : {}),
+    };
+}
+export function parseBotSession(value) {
+    let parsed;
+    try {
+        parsed = JSON.parse(value);
+    }
+    catch {
+        throw new Error('BCN Bot Session credential is not valid JSON');
+    }
+    const record = asRecord(parsed);
+    const endpoint = asNonEmptyString(record?.endpoint);
+    const botUuid = asNonEmptyString(record?.botUuid);
+    const botToken = asNonEmptyString(record?.botToken);
+    const botName = asNonEmptyString(record?.botName);
+    if (record?.version !== 1 || !endpoint || !botUuid || !botToken || !botName) {
+        throw new Error('BCN Bot Session credential has an unsupported or incomplete shape');
+    }
+    return { version: 1, endpoint, botUuid, botToken, botName };
+}
+export function parseChatSendParams(value) {
+    return parseChatParams(value, true);
+}
+export function parseChatInjectParams(value) {
+    return parseChatParams(value, false);
+}
+function parseChatParams(value, allowSendFields) {
+    const record = asRecord(value);
+    const sessionKey = asNonEmptyString(record?.session_key);
+    const groupId = asNonEmptyString(record?.bcs_group_id);
+    const message = asRecord(record?.message);
+    const channel = asRecord(record?.channel);
+    const sessionContext = asRecord(record?.session_context);
+    if (!record || !sessionKey || !groupId || !message || !channel || !sessionContext) {
+        throw new Error('chat params require session_key, bcs_group_id, message, channel, and session_context');
+    }
+    if (!Array.isArray(message.content) || !Number.isFinite(message.timestamp) || typeof message.role !== 'string') {
+        throw new Error('chat message has an invalid shape');
+    }
+    const content = message.content.map((block) => {
+        const item = asRecord(block);
+        if (!item || !asNonEmptyString(item.type))
+            throw new Error('chat message contains an invalid content block');
+        return item;
+    });
+    const bcsSessionId = asNonEmptyString(record.bcs_session_id);
+    const attachments = Array.isArray(record.attachments)
+        ? record.attachments.flatMap((item) => {
+            const attachment = asRecord(item);
+            return attachment ? [attachment] : [];
+        })
+        : undefined;
+    const base = {
+        session_key: sessionKey,
+        bcs_group_id: groupId,
+        ...(bcsSessionId ? { bcs_session_id: bcsSessionId } : {}),
+        message: { role: message.role, content, timestamp: Number(message.timestamp) },
+        channel,
+        session_context: sessionContext,
+        ...(Array.isArray(record.tags) ? { tags: record.tags.filter((item) => typeof item === 'string') } : {}),
+        ...(attachments ? { attachments } : {}),
+    };
+    if (!allowSendFields)
+        return base;
+    const idempotencyKey = asNonEmptyString(record.idempotency_key);
+    return {
+        ...base,
+        ...(typeof record.timeout_ms === 'number' && Number.isFinite(record.timeout_ms)
+            ? { timeout_ms: record.timeout_ms }
+            : {}),
+        ...(idempotencyKey ? { idempotency_key: idempotencyKey } : {}),
+    };
+}
+export function extractMessageText(message) {
+    const chunks = [];
+    for (const block of message.content) {
+        if (block.type === 'text' && typeof block.text === 'string')
+            chunks.push(block.text);
+    }
+    const text = chunks.join('').trim();
+    if (!text)
+        throw new Error('BCN message contains no visible text');
+    if (Buffer.byteLength(text, 'utf8') > 1024 * 1024)
+        throw new Error('BCN message text exceeds 1 MiB');
+    return text;
+}
+//# sourceMappingURL=protocol.js.map