botschat 0.1.0

package/packages/plugin/dist/src/accounts.js

@@ -0,0 +1,103 @@
+const DEFAULT_ACCOUNT_ID = "default";
+/** Extract the botschat section from the full config. */
+function section(cfg) {
+    const c = cfg;
+    return c?.channels?.botschat ?? {};
+}
+/** List all configured account IDs. */
+export function listBotsChatAccountIds(cfg) {
+    const s = section(cfg);
+    const ids = [];
+    // Top-level counts as "default" if it has cloudUrl
+    if (s.cloudUrl) {
+        ids.push(DEFAULT_ACCOUNT_ID);
+    }
+    // Named accounts
+    if (s.accounts) {
+        for (const id of Object.keys(s.accounts)) {
+            if (id !== DEFAULT_ACCOUNT_ID || !s.cloudUrl) {
+                ids.push(id);
+            }
+        }
+    }
+    return ids.length > 0 ? ids : [DEFAULT_ACCOUNT_ID];
+}
+/** Resolve default account ID. */
+export function resolveDefaultBotsChatAccountId(cfg) {
+    const ids = listBotsChatAccountIds(cfg);
+    return ids[0] ?? DEFAULT_ACCOUNT_ID;
+}
+/** Resolve a single account by ID. */
+export function resolveBotsChatAccount(cfg, accountId) {
+    const s = section(cfg);
+    const id = accountId ?? resolveDefaultBotsChatAccountId(cfg);
+    let acct;
+    if (id === DEFAULT_ACCOUNT_ID || !s.accounts?.[id]) {
+        // Use top-level config
+        acct = {
+            enabled: s.enabled,
+            name: s.name,
+            cloudUrl: s.cloudUrl,
+            pairingToken: s.pairingToken,
+        };
+    }
+    else {
+        acct = s.accounts[id];
+    }
+    const cloudUrl = acct.cloudUrl ?? "";
+    const pairingToken = acct.pairingToken ?? "";
+    return {
+        accountId: id,
+        name: acct.name,
+        enabled: acct.enabled !== false,
+        configured: !!cloudUrl && !!pairingToken,
+        cloudUrl,
+        pairingToken,
+        config: acct,
+    };
+}
+/** Delete an account from config, returning the updated config. */
+export function deleteBotsChatAccount(cfg, accountId) {
+    const c = cfg;
+    const botschat = { ...c?.channels?.botschat };
+    if (accountId === DEFAULT_ACCOUNT_ID) {
+        delete botschat.cloudUrl;
+        delete botschat.pairingToken;
+        delete botschat.name;
+        botschat.enabled = false;
+    }
+    else if (botschat.accounts) {
+        const accounts = { ...botschat.accounts };
+        delete accounts[accountId];
+        botschat.accounts = accounts;
+    }
+    return {
+        ...c,
+        channels: {
+            ...c.channels,
+            botschat,
+        },
+    };
+}
+/** Enable or disable an account, returning updated config. */
+export function setBotsChatAccountEnabled(cfg, accountId, enabled) {
+    const c = cfg;
+    const botschat = { ...c?.channels?.botschat };
+    if (accountId === DEFAULT_ACCOUNT_ID) {
+        botschat.enabled = enabled;
+    }
+    else if (botschat.accounts) {
+        botschat.accounts = {
+            ...botschat.accounts,
+            [accountId]: { ...botschat.accounts[accountId], enabled },
+        };
+    }
+    return {
+        ...c,
+        channels: {
+            ...c.channels,
+            botschat,
+        },
+    };
+}
+//# sourceMappingURL=accounts.js.map

package/packages/plugin/dist/src/accounts.js.map

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

package/packages/plugin/dist/src/channel.d.ts

@@ -0,0 +1,206 @@
+import type { ResolvedBotsChatAccount } from "./types.js";
+import { BotsChatCloudClient } from "./ws-client.js";
+export declare const botschatPlugin: {
+    readonly id: "botschat";
+    readonly meta: {
+        readonly id: "botschat";
+        readonly label: "BotsChat";
+        readonly selectionLabel: "BotsChat (cloud)";
+        readonly docsPath: "/channels/botschat";
+        readonly docsLabel: "botschat";
+        readonly blurb: "Cloud-based multi-channel chat interface";
+        readonly order: 80;
+        readonly quickstartAllowFrom: false;
+    };
+    readonly capabilities: {
+        readonly chatTypes: string[];
+        readonly polls: false;
+        readonly reactions: false;
+        readonly threads: true;
+        readonly media: true;
+    };
+    readonly agentPrompt: {
+        readonly messageToolHints: () => string[];
+    };
+    readonly reload: {
+        readonly configPrefixes: readonly ["channels.botschat"];
+    };
+    readonly config: {
+        readonly listAccountIds: (cfg: unknown) => string[];
+        readonly resolveAccount: (cfg: unknown, accountId?: string | null) => ResolvedBotsChatAccount;
+        readonly defaultAccountId: (cfg: unknown) => string;
+        readonly setAccountEnabled: ({ cfg, accountId, enabled }: {
+            cfg: unknown;
+            accountId: string;
+            enabled: boolean;
+        }) => unknown;
+        readonly deleteAccount: ({ cfg, accountId }: {
+            cfg: unknown;
+            accountId: string;
+        }) => unknown;
+        readonly isConfigured: (account: ResolvedBotsChatAccount) => boolean;
+        readonly isEnabled: (account: ResolvedBotsChatAccount) => boolean;
+        readonly describeAccount: (account: ResolvedBotsChatAccount) => {
+            accountId: string;
+            name: string | undefined;
+            enabled: boolean;
+            configured: boolean;
+            baseUrl: string;
+        };
+    };
+    readonly outbound: {
+        readonly deliveryMode: "direct";
+        readonly sendText: (ctx: {
+            to: string;
+            text: string;
+            replyToId?: string | null;
+            threadId?: string | number | null;
+            accountId?: string | null;
+        }) => Promise<{
+            ok: boolean;
+            error: Error;
+        } | {
+            ok: boolean;
+            error?: undefined;
+        }>;
+        readonly sendMedia: (ctx: {
+            to: string;
+            text: string;
+            mediaUrl?: string;
+            accountId?: string | null;
+        }) => Promise<{
+            ok: boolean;
+            error: Error;
+        } | {
+            ok: boolean;
+            error?: undefined;
+        }>;
+    };
+    readonly gateway: {
+        readonly startAccount: (ctx: {
+            cfg: unknown;
+            accountId: string;
+            account: ResolvedBotsChatAccount;
+            runtime: unknown;
+            abortSignal: AbortSignal;
+            log?: {
+                info: (m: string) => void;
+                warn: (m: string) => void;
+                error: (m: string) => void;
+            };
+            getStatus: () => Record<string, unknown>;
+            setStatus: (s: Record<string, unknown>) => void;
+        }) => Promise<BotsChatCloudClient | undefined>;
+        readonly stopAccount: (ctx: {
+            accountId: string;
+            getStatus: () => Record<string, unknown>;
+            setStatus: (s: Record<string, unknown>) => void;
+        }) => Promise<void>;
+    };
+    readonly threading: {
+        readonly resolveReplyToMode: () => "all";
+        readonly buildToolContext: ({ context, hasRepliedRef }: {
+            context: {
+                To?: string;
+                MessageThreadId?: string | number;
+                ReplyToId?: string;
+            };
+            hasRepliedRef?: {
+                value: boolean;
+            };
+        }) => {
+            currentChannelId: string | undefined;
+            currentChannelProvider: string;
+            currentThreadTs: string | undefined;
+            hasRepliedRef: {
+                value: boolean;
+            } | undefined;
+        };
+    };
+    readonly pairing: {
+        readonly idLabel: "botsChatUserId";
+        readonly normalizeAllowEntry: (entry: string) => string;
+    };
+    readonly security: {
+        readonly resolveDmPolicy: (_ctx: {
+            account: ResolvedBotsChatAccount;
+        }) => {
+            policy: string;
+            allowFrom: string[];
+            policyPath: string;
+            allowFromPath: string;
+            approveHint: string;
+        };
+    };
+    readonly setup: {
+        readonly applyAccountConfig: ({ cfg, input }: {
+            cfg: unknown;
+            accountId: string;
+            input: {
+                url?: string;
+                token?: string;
+                name?: string;
+                useEnv?: boolean;
+            };
+        }) => {
+            channels: {
+                botschat: {
+                    name?: string;
+                    enabled: boolean;
+                    cloudUrl: string;
+                    pairingToken: string;
+                    accounts?: Record<string, import("./types.js").BotsChatAccountConfig>;
+                };
+            };
+        };
+        readonly validateInput: ({ input }: {
+            cfg: unknown;
+            accountId: string;
+            input: {
+                url?: string;
+                token?: string;
+                useEnv?: boolean;
+            };
+        }) => "BotsChat requires --url (e.g., --url botschat.app)" | "BotsChat requires --token (pairing token from botschat.app dashboard)" | null;
+    };
+    readonly status: {
+        readonly defaultRuntime: {
+            readonly accountId: "default";
+            readonly running: false;
+            readonly connected: false;
+            readonly lastStartAt: null;
+            readonly lastStopAt: null;
+            readonly lastError: null;
+        };
+        readonly buildAccountSnapshot: ({ account, runtime }: {
+            account: ResolvedBotsChatAccount;
+            cfg: unknown;
+            runtime?: Record<string, unknown>;
+        }) => {
+            accountId: string;
+            name: string | undefined;
+            enabled: boolean;
+            configured: boolean;
+            baseUrl: string;
+            running: boolean;
+            connected: boolean;
+            lastStartAt: number;
+            lastStopAt: number;
+            lastError: string;
+            lastConnectedAt: number;
+            lastDisconnect: {} | null;
+        };
+        readonly collectStatusIssues: (accounts: Array<{
+            accountId: string;
+            lastError?: string | null;
+            connected?: boolean;
+            configured?: boolean;
+        }>) => {
+            channel: string;
+            accountId: string;
+            kind: string;
+            message: string;
+        }[];
+    };
+};
+//# sourceMappingURL=channel.d.ts.map

package/packages/plugin/dist/src/channel.d.ts.map

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