@decentchat/decentchat-plugin 0.1.9

package/src/peer/polyfill.ts

@@ -0,0 +1,43 @@
+/**
+ * polyfill.ts — install node-datachannel globals so PeerJS works in Node.js
+ *
+ * This file SELF-INSTALLS as a side effect when imported.
+ * Import it first so RTCPeerConnection is set before PeerJS loads.
+ *
+ * Under jiti (OpenClaw's TypeScript loader), all static imports are hoisted
+ * to require() calls in order — so the FIRST import wins. Keep this as the
+ * very first import in DecentChatNodePeer.ts.
+ */
+
+if (typeof RTCPeerConnection === 'undefined') {
+  try {
+    // eslint-disable-next-line @typescript-eslint/no-require-imports
+    const dc = require('node-datachannel/polyfill') as Record<string, unknown>;
+
+    const globals: Record<string, unknown> = {
+      RTCPeerConnection: dc['RTCPeerConnection'],
+      RTCIceCandidate: dc['RTCIceCandidate'],
+      RTCSessionDescription: dc['RTCSessionDescription'],
+      RTCDataChannel: dc['RTCDataChannel'],
+      RTCDataChannelEvent: dc['RTCDataChannelEvent'],
+      RTCIceTransport: dc['RTCIceTransport'],
+      RTCPeerConnectionIceEvent: dc['RTCPeerConnectionIceEvent'],
+      MediaStream: dc['MediaStream'],
+    };
+
+    for (const [key, val] of Object.entries(globals)) {
+      if (val !== undefined) {
+        (globalThis as Record<string, unknown>)[key] = val;
+      }
+    }
+  } catch (e) {
+    throw new Error(
+      `node-datachannel not available. Run: npm install node-datachannel\nOriginal: ${e}`,
+    );
+  }
+}
+
+// Legacy export for backward compatibility
+export function installWebRTCPolyfill(): void {
+  // No-op: installation happens at module load time (side effect above)
+}

package/src/peer-registry.ts

@@ -0,0 +1,32 @@
+/**
+ * Shared registry for active DecentChatNodePeer instances, keyed by account id.
+ * Allows channel.ts adapters to deliver outbound messages and directory lookups
+ * via the correct P2P peer when multiple DecentChat accounts are running.
+ */
+
+import type { DecentChatNodePeer } from "./peer/DecentChatNodePeer.js";
+
+const DEFAULT_ACCOUNT_ID = "default";
+
+const activePeers = new Map<string, InstanceType<typeof DecentChatNodePeer>>();
+
+export function setActivePeer(
+  peer: InstanceType<typeof DecentChatNodePeer> | null,
+  accountId: string = DEFAULT_ACCOUNT_ID,
+): void {
+  const key = accountId?.trim() || DEFAULT_ACCOUNT_ID;
+  if (peer) {
+    activePeers.set(key, peer);
+  } else {
+    activePeers.delete(key);
+  }
+}
+
+export function getActivePeer(accountId: string = DEFAULT_ACCOUNT_ID): InstanceType<typeof DecentChatNodePeer> | null {
+  const key = accountId?.trim() || DEFAULT_ACCOUNT_ID;
+  return activePeers.get(key) ?? null;
+}
+
+export function listActivePeerAccountIds(): string[] {
+  return Array.from(activePeers.keys()).sort((a, b) => a.localeCompare(b));
+}

package/src/runtime.ts

@@ -0,0 +1,63 @@
+import type { PluginRuntime } from "openclaw/plugin-sdk";
+
+let runtime: PluginRuntime | null = null;
+
+const bootstrapInFlight = new Map<string, Promise<void>>();
+const bootstrapCompleted = new Set<string>();
+
+export function setDecentChatRuntime(next: PluginRuntime): void {
+  runtime = next;
+}
+
+export function getDecentChatRuntime(): PluginRuntime {
+  if (!runtime) {
+    throw new Error("DecentChat runtime not initialized");
+  }
+  return runtime;
+}
+
+export function buildDecentChatRuntimeBootstrapKey(manifestPath: string, scope?: string): string {
+  const normalizedScope = scope?.trim();
+  if (normalizedScope) {
+    return `runtime:${manifestPath}:${normalizedScope}`;
+  }
+  return `runtime:${manifestPath}`;
+}
+
+export async function runDecentChatBootstrapOnce(key: string, task: () => Promise<void>): Promise<void> {
+  if (bootstrapCompleted.has(key)) return;
+
+  const inFlight = bootstrapInFlight.get(key);
+  if (inFlight) {
+    await inFlight;
+    return;
+  }
+
+  const run = (async () => {
+    try {
+      await task();
+      bootstrapCompleted.add(key);
+    } finally {
+      bootstrapInFlight.delete(key);
+    }
+  })();
+
+  bootstrapInFlight.set(key, run);
+  await run;
+}
+
+export function resetDecentChatRuntimeBootstrapStateForTests(): void {
+  bootstrapInFlight.clear();
+  bootstrapCompleted.clear();
+}
+
+/**
+ * Invalidate a specific bootstrap key so the next `runDecentChatBootstrapOnce`
+ * call with the same key will re-run the task. Used during gateway restarts
+ * to ensure bootstrap logic (workspace creation, invite joins, etc.) is not
+ * permanently skipped when the gateway recycles within the same process.
+ */
+export function invalidateDecentChatBootstrapKey(key: string): void {
+  bootstrapCompleted.delete(key);
+  bootstrapInFlight.delete(key);
+}

package/src/types.ts

@@ -0,0 +1,136 @@
+
+export type OpenClawAgentListEntryConfig = {
+  id?: string;
+  workspace?: string;
+  [key: string]: unknown;
+};
+
+export type OpenClawRouteBindingConfig = {
+  type?: string;
+  agentId?: string;
+  match?: {
+    channel?: string;
+    accountId?: string;
+  };
+  [key: string]: unknown;
+};
+
+export type OpenClawConfigShape = {
+  channels?: Record<string, unknown>;
+  agents?: {
+    list?: OpenClawAgentListEntryConfig[];
+    [key: string]: unknown;
+  };
+  bindings?: OpenClawRouteBindingConfig[];
+  [key: string]: unknown;
+};
+
+export type DecentChatCompanySimBootstrapConfig = {
+  enabled?: boolean;
+  mode?: 'runtime' | 'off';
+  manifestPath?: string;
+  targetWorkspaceId?: string;
+  targetInviteCode?: string;
+};
+
+export type DecentChatCompanySimConfig = {
+  enabled?: boolean;
+  manifestPath?: string;
+  companyId?: string;
+  employeeId?: string;
+  roleFilesDir?: string;
+  silentChannelIds?: string[];
+};
+
+export type DecentChatChannelConfig = {
+  enabled?: boolean;
+  dmPolicy?: string;
+  seedPhrase?: string;
+  signalingServer?: string;
+  invites?: string[];
+  alias?: string;
+  dataDir?: string;
+  channels?: Record<string, { requireMention?: boolean }>;
+  streamEnabled?: boolean;
+  replyToMode?: "off" | "first" | "all";
+  replyToModeByChatType?: {
+    direct?: "off" | "first" | "all";
+    group?: "off" | "first" | "all";
+    channel?: "off" | "first" | "all";
+  };
+  thread?: {
+    historyScope?: "thread" | "channel";
+    inheritParent?: boolean;
+    initialHistoryLimit?: number;
+  };
+  huddle?: {
+    enabled?: boolean;
+    autoJoin?: boolean;
+    sttEngine?: 'whisper-cpp' | 'whisper-python' | 'openai' | 'groq';
+    whisperModel?: string;
+    sttLanguage?: string;
+    sttApiKey?: string;
+    ttsVoice?: string;
+    vadSilenceMs?: number;
+    vadThreshold?: number;
+  };
+  companySim?: DecentChatCompanySimConfig;
+  companySimBootstrap?: DecentChatCompanySimBootstrapConfig;
+  companySimBootstrapEnabled?: boolean;
+  companySimBootstrapMode?: 'runtime' | 'off';
+  companySimBootstrapManifestPath?: string;
+  companySimBootstrapTargetWorkspaceId?: string;
+  companySimBootstrapTargetInviteCode?: string;
+  defaultAccount?: string;
+  accounts?: Record<string, Omit<DecentChatChannelConfig, 'accounts'>>;
+};
+
+export type ResolvedDecentChatAccount = {
+  accountId: string;
+  enabled: boolean;
+  dmPolicy: string;
+  configured: boolean;
+  seedPhrase?: string;
+  signalingServer?: string;
+  invites: string[];
+  alias: string;
+  dataDir?: string;
+  streamEnabled: boolean;
+  replyToMode: "off" | "first" | "all";
+  replyToModeByChatType: {
+    direct?: "off" | "first" | "all";
+    group?: "off" | "first" | "all";
+    channel?: "off" | "first" | "all";
+  };
+  thread: {
+    historyScope: "thread" | "channel";
+    inheritParent: boolean;
+    initialHistoryLimit: number;
+  };
+  huddle?: {
+    enabled?: boolean;
+    autoJoin?: boolean;
+    sttEngine?: 'whisper-cpp' | 'whisper-python' | 'openai' | 'groq';
+    whisperModel?: string;
+    sttLanguage?: string;
+    sttApiKey?: string;
+    ttsVoice?: string;
+    vadSilenceMs?: number;
+    vadThreshold?: number;
+  };
+  companySim?: {
+    enabled: boolean;
+    manifestPath?: string;
+    companyId?: string;
+    employeeId?: string;
+    roleFilesDir?: string;
+    silentChannelIds?: string[];
+  };
+  companySimBootstrap?: {
+    enabled: boolean;
+    mode: 'runtime' | 'off';
+    manifestPath?: string;
+    targetWorkspaceId?: string;
+    targetInviteCode?: string;
+  };
+};