loudmouth-ai 0.1.0 → 0.2.0

package/extensions/zalo/src/status-issues.ts

@@ -1,50 +0,0 @@
-import type { ChannelAccountSnapshot, ChannelStatusIssue } from "clawdbot/plugin-sdk";
-
-type ZaloAccountStatus = {
-  accountId?: unknown;
-  enabled?: unknown;
-  configured?: unknown;
-  dmPolicy?: unknown;
-};
-
-const isRecord = (value: unknown): value is Record<string, unknown> =>
-  Boolean(value && typeof value === "object");
-
-const asString = (value: unknown): string | undefined =>
-  typeof value === "string" ? value : typeof value === "number" ? String(value) : undefined;
-
-function readZaloAccountStatus(value: ChannelAccountSnapshot): ZaloAccountStatus | null {
-  if (!isRecord(value)) return null;
-  return {
-    accountId: value.accountId,
-    enabled: value.enabled,
-    configured: value.configured,
-    dmPolicy: value.dmPolicy,
-  };
-}
-
-export function collectZaloStatusIssues(
-  accounts: ChannelAccountSnapshot[],
-): ChannelStatusIssue[] {
-  const issues: ChannelStatusIssue[] = [];
-  for (const entry of accounts) {
-    const account = readZaloAccountStatus(entry);
-    if (!account) continue;
-    const accountId = asString(account.accountId) ?? "default";
-    const enabled = account.enabled !== false;
-    const configured = account.configured === true;
-    if (!enabled || !configured) continue;
-
-    if (account.dmPolicy === "open") {
-      issues.push({
-        channel: "zalo",
-        accountId,
-        kind: "config",
-        message:
-          'Zalo dmPolicy is "open", allowing any user to message the bot without pairing.',
-        fix: 'Set channels.zalo.dmPolicy to "pairing" or "allowlist" to restrict access.',
-      });
-    }
-  }
-  return issues;
-}

package/extensions/zalo/src/token.ts

@@ -1,55 +0,0 @@
-import { readFileSync } from "node:fs";
-
-import { DEFAULT_ACCOUNT_ID } from "clawdbot/plugin-sdk";
-
-import type { ZaloConfig } from "./types.js";
-
-export type ZaloTokenResolution = {
-  token: string;
-  source: "env" | "config" | "configFile" | "none";
-};
-
-export function resolveZaloToken(
-  config: ZaloConfig | undefined,
-  accountId?: string | null,
-): ZaloTokenResolution {
-  const resolvedAccountId = accountId ?? DEFAULT_ACCOUNT_ID;
-  const isDefaultAccount = resolvedAccountId === DEFAULT_ACCOUNT_ID;
-  const baseConfig = config;
-  const accountConfig =
-    resolvedAccountId !== DEFAULT_ACCOUNT_ID
-      ? (baseConfig?.accounts?.[resolvedAccountId] as ZaloConfig | undefined)
-      : undefined;
-
-  if (accountConfig) {
-    const token = accountConfig.botToken?.trim();
-    if (token) return { token, source: "config" };
-    const tokenFile = accountConfig.tokenFile?.trim();
-    if (tokenFile) {
-      try {
-        const fileToken = readFileSync(tokenFile, "utf8").trim();
-        if (fileToken) return { token: fileToken, source: "configFile" };
-      } catch {
-        // ignore read failures
-      }
-    }
-  }
-
-  if (isDefaultAccount) {
-    const token = baseConfig?.botToken?.trim();
-    if (token) return { token, source: "config" };
-    const tokenFile = baseConfig?.tokenFile?.trim();
-    if (tokenFile) {
-      try {
-        const fileToken = readFileSync(tokenFile, "utf8").trim();
-        if (fileToken) return { token: fileToken, source: "configFile" };
-      } catch {
-        // ignore read failures
-      }
-    }
-    const envToken = process.env.ZALO_BOT_TOKEN?.trim();
-    if (envToken) return { token: envToken, source: "env" };
-  }
-
-  return { token: "", source: "none" };
-}

package/extensions/zalo/src/types.ts

@@ -1,42 +0,0 @@
-export type ZaloAccountConfig = {
-  /** Optional display name for this account (used in CLI/UI lists). */
-  name?: string;
-  /** If false, do not start this Zalo account. Default: true. */
-  enabled?: boolean;
-  /** Bot token from Zalo Bot Creator. */
-  botToken?: string;
-  /** Path to file containing the bot token. */
-  tokenFile?: string;
-  /** Webhook URL for receiving updates (HTTPS required). */
-  webhookUrl?: string;
-  /** Webhook secret token (8-256 chars) for request verification. */
-  webhookSecret?: string;
-  /** Webhook path for the gateway HTTP server (defaults to webhook URL path). */
-  webhookPath?: string;
-  /** Direct message access policy (default: pairing). */
-  dmPolicy?: "pairing" | "allowlist" | "open" | "disabled";
-  /** Allowlist for DM senders (Zalo user IDs). */
-  allowFrom?: Array<string | number>;
-  /** Max inbound media size in MB. */
-  mediaMaxMb?: number;
-  /** Proxy URL for API requests. */
-  proxy?: string;
-};
-
-export type ZaloConfig = {
-  /** Optional per-account Zalo configuration (multi-account). */
-  accounts?: Record<string, ZaloAccountConfig>;
-  /** Default account ID when multiple accounts are configured. */
-  defaultAccount?: string;
-} & ZaloAccountConfig;
-
-export type ZaloTokenSource = "env" | "config" | "configFile" | "none";
-
-export type ResolvedZaloAccount = {
-  accountId: string;
-  name?: string;
-  enabled: boolean;
-  token: string;
-  tokenSource: ZaloTokenSource;
-  config: ZaloAccountConfig;
-};

package/extensions/zalouser/CHANGELOG.md

@@ -1,33 +0,0 @@
-# Changelog
-
-## 2026.1.23
-
-### Changes
-- Version alignment with core Clawdbot release numbers.
-
-## 2026.1.22
-
-### Changes
-- Version alignment with core Clawdbot release numbers.
-
-## 2026.1.21
-
-### Changes
-- Version alignment with core Clawdbot release numbers.
-
-## 2026.1.20
-
-### Changes
-- Version alignment with core Clawdbot release numbers.
-
-## 2026.1.17-1
-
-- Initial version with full channel plugin support
-- QR code login via zca-cli
-- Multi-account support
-- Agent tool for sending messages
-- Group and DM policy support
-- ChannelDock for lightweight shared metadata
-- Zod-based config schema validation
-- Setup adapter for programmatic configuration
-- Dedicated probe and status issues modules

package/extensions/zalouser/README.md

@@ -1,221 +0,0 @@
-# @clawdbot/zalouser
-
-Clawdbot extension for Zalo Personal Account messaging via [zca-cli](https://zca-cli.dev).
-
-> **Warning:** Using Zalo automation may result in account suspension or ban. Use at your own risk. This is an unofficial integration.
-
-## Features
-
-- **Channel Plugin Integration**: Appears in onboarding wizard with QR login
-- **Gateway Integration**: Real-time message listening via the gateway
-- **Multi-Account Support**: Manage multiple Zalo personal accounts
-- **CLI Commands**: Full command-line interface for messaging
-- **Agent Tool**: AI agent integration for automated messaging
-
-## Prerequisites
-
-Install `zca` CLI and ensure it's in your PATH:
-
-
-**macOS / Linux:**
-```bash
-curl -fsSL https://get.zca-cli.dev/install.sh | bash
-
-# Or with custom install directory
-ZCA_INSTALL_DIR=~/.local/bin curl -fsSL https://get.zca-cli.dev/install.sh | bash
-
-# Install specific version
-curl -fsSL https://get.zca-cli.dev/install.sh | bash -s v1.0.0
-
-# Uninstall
-curl -fsSL https://get.zca-cli.dev/install.sh | bash -s uninstall
-```
-
-**Windows (PowerShell):**
-```powershell
-irm https://get.zca-cli.dev/install.ps1 | iex
-
-# Or with custom install directory
-$env:ZCA_INSTALL_DIR = "C:\Tools\zca"; irm https://get.zca-cli.dev/install.ps1 | iex
-
-# Install specific version
-iex "& { $(irm https://get.zca-cli.dev/install.ps1) } -Version v1.0.0"
-
-# Uninstall
-iex "& { $(irm https://get.zca-cli.dev/install.ps1) } -Uninstall"
-```
-
-### Manual Download
-
-Download binary directly:
-
-**macOS / Linux:**
-```bash
-curl -fsSL https://get.zca-cli.dev/latest/zca-darwin-arm64 -o zca && chmod +x zca
-```
-
-**Windows (PowerShell):**
-```powershell
-Invoke-WebRequest -Uri https://get.zca-cli.dev/latest/zca-windows-x64.exe -OutFile zca.exe
-```
-
-Available binaries:
-- `zca-darwin-arm64` - macOS Apple Silicon
-- `zca-darwin-x64` - macOS Intel
-- `zca-linux-arm64` - Linux ARM64
-- `zca-linux-x64` - Linux x86_64
-- `zca-windows-x64.exe` - Windows
-
-See [zca-cli](https://zca-cli.dev) for manual download (binaries for macOS/Linux/Windows) or building from source.
-
-## Quick Start
-
-### Option 1: Onboarding Wizard (Recommended)
-
-```bash
-clawdbot onboard
-# Select "Zalo Personal" from channel list
-# Follow QR code login flow
-```
-
-### Option 2: Login (QR, on the Gateway machine)
-
-```bash
-clawdbot channels login --channel zalouser
-# Scan QR code with Zalo app
-```
-
-### Send a Message
-
-```bash
-clawdbot message send --channel zalouser --target <threadId> --message "Hello from Clawdbot!"
-```
-
-## Configuration
-
-After onboarding, your config will include:
-
-```yaml
-channels:
-  zalouser:
-    enabled: true
-    dmPolicy: pairing  # pairing | allowlist | open | disabled
-```
-
-For multi-account:
-
-```yaml
-channels:
-  zalouser:
-    enabled: true
-    defaultAccount: default
-    accounts:
-      default:
-        enabled: true
-        profile: default
-      work:
-        enabled: true
-        profile: work
-```
-
-## Commands
-
-### Authentication
-
-```bash
-clawdbot channels login --channel zalouser              # Login via QR
-clawdbot channels login --channel zalouser --account work
-clawdbot channels status --probe
-clawdbot channels logout --channel zalouser
-```
-
-### Directory (IDs, contacts, groups)
-
-```bash
-clawdbot directory self --channel zalouser
-clawdbot directory peers list --channel zalouser --query "name"
-clawdbot directory groups list --channel zalouser --query "work"
-clawdbot directory groups members --channel zalouser --group-id <id>
-```
-
-### Account Management
-
-```bash
-zca account list      # List all profiles
-zca account current   # Show active profile
-zca account switch <profile>
-zca account remove <profile>
-zca account label <profile> "Work Account"
-```
-
-### Messaging
-
-```bash
-# Text
-clawdbot message send --channel zalouser --target <threadId> --message "message"
-
-# Media (URL)
-clawdbot message send --channel zalouser --target <threadId> --message "caption" --media-url "https://example.com/img.jpg"
-```
-
-### Listener
-
-The listener runs inside the Gateway when the channel is enabled. For debugging,
-use `clawdbot channels logs --channel zalouser` or run `zca listen` directly.
-
-### Data Access
-
-```bash
-# Friends
-zca friend list
-zca friend list -j    # JSON output
-zca friend find "name"
-zca friend online
-
-# Groups
-zca group list
-zca group info <groupId>
-zca group members <groupId>
-
-# Profile
-zca me info
-zca me id
-```
-
-## Multi-Account Support
-
-Use `--profile` or `-p` to work with multiple accounts:
-
-```bash
-clawdbot channels login --channel zalouser --account work
-clawdbot message send --channel zalouser --account work --target <id> --message "Hello"
-ZCA_PROFILE=work zca listen
-```
-
-Profile resolution order: `--profile` flag > `ZCA_PROFILE` env > default
-
-## Agent Tool
-
-The extension registers a `zalouser` tool for AI agents:
-
-```json
-{
-  "action": "send",
-  "threadId": "123456",
-  "message": "Hello from AI!",
-  "isGroup": false,
-  "profile": "default"
-}
-```
-
-Available actions: `send`, `image`, `link`, `friends`, `groups`, `me`, `status`
-
-## Troubleshooting
-
-- **Login Issues:** Run `zca auth logout` then `zca auth login`
-- **API Errors:** Try `zca auth cache-refresh` or re-login
-- **File Uploads:** Check size (max 100MB) and path accessibility
-
-## Credits
-
-Built on [zca-cli](https://zca-cli.dev) which uses [zca-js](https://github.com/RFS-ADRENO/zca-js).

package/extensions/zalouser/clawdbot.plugin.json

@@ -1,11 +0,0 @@
-{
-  "id": "zalouser",
-  "channels": [
-    "zalouser"
-  ],
-  "configSchema": {
-    "type": "object",
-    "additionalProperties": false,
-    "properties": {}
-  }
-}

package/extensions/zalouser/index.ts

@@ -1,32 +0,0 @@
-import type { ClawdbotPluginApi } from "clawdbot/plugin-sdk";
-import { emptyPluginConfigSchema } from "clawdbot/plugin-sdk";
-
-import { zalouserDock, zalouserPlugin } from "./src/channel.js";
-import { ZalouserToolSchema, executeZalouserTool } from "./src/tool.js";
-import { setZalouserRuntime } from "./src/runtime.js";
-
-const plugin = {
-  id: "zalouser",
-  name: "Zalo Personal",
-  description: "Zalo personal account messaging via zca-cli",
-  configSchema: emptyPluginConfigSchema(),
-  register(api: ClawdbotPluginApi) {
-    setZalouserRuntime(api.runtime);
-    // Register channel plugin (for onboarding & gateway)
-    api.registerChannel({ plugin: zalouserPlugin, dock: zalouserDock });
-
-    // Register agent tool
-    api.registerTool({
-      name: "zalouser",
-      label: "Zalo Personal",
-      description:
-        "Send messages and access data via Zalo personal account. " +
-        "Actions: send (text message), image (send image URL), link (send link), " +
-        "friends (list/search friends), groups (list groups), me (profile info), status (auth check).",
-      parameters: ZalouserToolSchema,
-      execute: executeZalouserTool,
-    });
-  },
-};
-
-export default plugin;

package/extensions/zalouser/package.json

@@ -1,33 +0,0 @@
-{
-  "name": "@clawdbot/zalouser",
-  "version": "2026.1.25",
-  "type": "module",
-  "description": "Clawdbot Zalo Personal Account plugin via zca-cli",
-  "dependencies": {
-    "clawdbot": "workspace:*",
-    "@sinclair/typebox": "0.34.47"
-  },
-  "clawdbot": {
-    "extensions": [
-      "./index.ts"
-    ],
-    "channel": {
-      "id": "zalouser",
-      "label": "Zalo Personal",
-      "selectionLabel": "Zalo (Personal Account)",
-      "docsPath": "/channels/zalouser",
-      "docsLabel": "zalouser",
-      "blurb": "Zalo personal account via QR code login.",
-      "aliases": [
-        "zlu"
-      ],
-      "order": 85,
-      "quickstartAllowFrom": true
-    },
-    "install": {
-      "npmSpec": "@clawdbot/zalouser",
-      "localPath": "extensions/zalouser",
-      "defaultChoice": "npm"
-    }
-  }
-}

package/extensions/zalouser/src/accounts.ts

@@ -1,117 +0,0 @@
-import type { ClawdbotConfig } from "clawdbot/plugin-sdk";
-import { DEFAULT_ACCOUNT_ID, normalizeAccountId } from "clawdbot/plugin-sdk";
-
-import { runZca, parseJsonOutput } from "./zca.js";
-import type { ResolvedZalouserAccount, ZalouserAccountConfig, ZalouserConfig } from "./types.js";
-
-function listConfiguredAccountIds(cfg: ClawdbotConfig): string[] {
-  const accounts = (cfg.channels?.zalouser as ZalouserConfig | undefined)?.accounts;
-  if (!accounts || typeof accounts !== "object") return [];
-  return Object.keys(accounts).filter(Boolean);
-}
-
-export function listZalouserAccountIds(cfg: ClawdbotConfig): string[] {
-  const ids = listConfiguredAccountIds(cfg);
-  if (ids.length === 0) return [DEFAULT_ACCOUNT_ID];
-  return ids.sort((a, b) => a.localeCompare(b));
-}
-
-export function resolveDefaultZalouserAccountId(cfg: ClawdbotConfig): string {
-  const zalouserConfig = cfg.channels?.zalouser as ZalouserConfig | undefined;
-  if (zalouserConfig?.defaultAccount?.trim()) return zalouserConfig.defaultAccount.trim();
-  const ids = listZalouserAccountIds(cfg);
-  if (ids.includes(DEFAULT_ACCOUNT_ID)) return DEFAULT_ACCOUNT_ID;
-  return ids[0] ?? DEFAULT_ACCOUNT_ID;
-}
-
-function resolveAccountConfig(
-  cfg: ClawdbotConfig,
-  accountId: string,
-): ZalouserAccountConfig | undefined {
-  const accounts = (cfg.channels?.zalouser as ZalouserConfig | undefined)?.accounts;
-  if (!accounts || typeof accounts !== "object") return undefined;
-  return accounts[accountId] as ZalouserAccountConfig | undefined;
-}
-
-function mergeZalouserAccountConfig(
-  cfg: ClawdbotConfig,
-  accountId: string,
-): ZalouserAccountConfig {
-  const raw = (cfg.channels?.zalouser ?? {}) as ZalouserConfig;
-  const { accounts: _ignored, defaultAccount: _ignored2, ...base } = raw;
-  const account = resolveAccountConfig(cfg, accountId) ?? {};
-  return { ...base, ...account };
-}
-
-function resolveZcaProfile(config: ZalouserAccountConfig, accountId: string): string {
-  if (config.profile?.trim()) return config.profile.trim();
-  if (process.env.ZCA_PROFILE?.trim()) return process.env.ZCA_PROFILE.trim();
-  if (accountId !== DEFAULT_ACCOUNT_ID) return accountId;
-  return "default";
-}
-
-export async function checkZcaAuthenticated(profile: string): Promise<boolean> {
-  const result = await runZca(["auth", "status"], { profile, timeout: 5000 });
-  return result.ok;
-}
-
-export async function resolveZalouserAccount(params: {
-  cfg: ClawdbotConfig;
-  accountId?: string | null;
-}): Promise<ResolvedZalouserAccount> {
-  const accountId = normalizeAccountId(params.accountId);
-  const baseEnabled = (params.cfg.channels?.zalouser as ZalouserConfig | undefined)?.enabled !== false;
-  const merged = mergeZalouserAccountConfig(params.cfg, accountId);
-  const accountEnabled = merged.enabled !== false;
-  const enabled = baseEnabled && accountEnabled;
-  const profile = resolveZcaProfile(merged, accountId);
-  const authenticated = await checkZcaAuthenticated(profile);
-
-  return {
-    accountId,
-    name: merged.name?.trim() || undefined,
-    enabled,
-    profile,
-    authenticated,
-    config: merged,
-  };
-}
-
-export function resolveZalouserAccountSync(params: {
-  cfg: ClawdbotConfig;
-  accountId?: string | null;
-}): ResolvedZalouserAccount {
-  const accountId = normalizeAccountId(params.accountId);
-  const baseEnabled = (params.cfg.channels?.zalouser as ZalouserConfig | undefined)?.enabled !== false;
-  const merged = mergeZalouserAccountConfig(params.cfg, accountId);
-  const accountEnabled = merged.enabled !== false;
-  const enabled = baseEnabled && accountEnabled;
-  const profile = resolveZcaProfile(merged, accountId);
-
-  return {
-    accountId,
-    name: merged.name?.trim() || undefined,
-    enabled,
-    profile,
-    authenticated: false, // unknown without async check
-    config: merged,
-  };
-}
-
-export async function listEnabledZalouserAccounts(
-  cfg: ClawdbotConfig,
-): Promise<ResolvedZalouserAccount[]> {
-  const ids = listZalouserAccountIds(cfg);
-  const accounts = await Promise.all(
-    ids.map((accountId) => resolveZalouserAccount({ cfg, accountId }))
-  );
-  return accounts.filter((account) => account.enabled);
-}
-
-export async function getZcaUserInfo(profile: string): Promise<{ userId?: string; displayName?: string } | null> {
-  const result = await runZca(["me", "info", "-j"], { profile, timeout: 10000 });
-  if (!result.ok) return null;
-  return parseJsonOutput<{ userId?: string; displayName?: string }>(result.stdout);
-}
-
-export type { ResolvedZalouserAccount } from "./types.js";

package/extensions/zalouser/src/channel.test.ts

@@ -1,17 +0,0 @@
-import { describe, expect, it } from "vitest";
-
-import { zalouserPlugin } from "./channel.js";
-
-describe("zalouser outbound chunker", () => {
-  it("chunks without empty strings and respects limit", () => {
-    const chunker = zalouserPlugin.outbound?.chunker;
-    expect(chunker).toBeTypeOf("function");
-    if (!chunker) return;
-
-    const limit = 10;
-    const chunks = chunker("hello world\nthis is a test", limit);
-    expect(chunks.length).toBeGreaterThan(1);
-    expect(chunks.every((c) => c.length > 0)).toBe(true);
-    expect(chunks.every((c) => c.length <= limit)).toBe(true);
-  });
-});