@plosson/agentio 0.4.2 → 0.4.3

package/src/gateway/types.ts

@@ -0,0 +1,325 @@
+import type { ServiceName, GatewayConfig } from '../types/config';
+
+// Re-export for convenience
+export type { GatewayConfig } from '../types/config';
+
+/**
+ * Inbound message - received from external services
+ */
+export interface InboundMessage {
+  id: string;                    // UUID
+  service: ServiceName;
+  profile: string;
+  conversationId: string;        // Chat/thread identifier
+  platformId: string;            // Original message ID from platform
+
+  senderId: string;
+  senderName?: string;
+  senderHandle?: string;
+
+  content?: string;              // Message text
+  mediaType?: MediaType;
+  mediaPath?: string;            // Local path if downloaded
+
+  receivedAt: number;            // Unix timestamp
+  status: InboxStatus;
+  doneAt?: number;
+
+  replyToId?: string;            // If this is a reply
+  metadata?: Record<string, unknown>;
+}
+
+/**
+ * Outbound message - queued for sending to services
+ */
+export interface OutboundMessage {
+  id: string;                    // UUID
+  service: ServiceName;
+  profile: string;
+  conversationId: string;        // Destination chat/thread
+
+  content?: string;
+  mediaPath?: string;
+  mediaType?: MediaType;
+
+  replyToPlatformId?: string;    // If replying to a message
+
+  queuedAt: number;              // Unix timestamp
+  status: OutboxStatus;
+  sentAt?: number;
+  error?: string;
+  platformId?: string;           // Assigned after send
+
+  metadata?: Record<string, unknown>;
+}
+
+export type MediaType = 'image' | 'video' | 'audio' | 'document';
+export type InboxStatus = 'pending' | 'done';
+export type OutboxStatus = 'pending' | 'sending' | 'sent' | 'failed';
+
+export const DEFAULT_GATEWAY_CONFIG: Required<GatewayConfig> = {
+  name: '',
+  secret: '',
+  api: {
+    port: 7890,
+    host: '127.0.0.1',
+    secret: '',
+  },
+  webhook: {
+    url: '',
+    secret: '',
+    debounceMs: 2000,
+  },
+  media: {
+    download: true,
+    maxSizeMb: 50,
+  },
+  retention: {
+    doneMessagesDays: 30,
+    sentMessagesDays: 7,
+  },
+};
+
+/**
+ * Gateway HTTP API request/response types
+ */
+export interface InboxPullRequest {
+  service?: ServiceName;
+  profile?: string;
+  conversationId?: string;  // Filter by conversation/group
+  limit?: number;
+  status?: InboxStatus;
+}
+
+export interface InboxPullResponse {
+  messages: InboundMessage[];
+}
+
+export interface InboxGetRequest {
+  id: string;
+}
+
+export interface InboxGetResponse {
+  message: InboundMessage | null;
+}
+
+export interface InboxAckRequest {
+  id: string;
+}
+
+export interface InboxAckResponse {
+  success: boolean;
+}
+
+export interface InboxReplyRequest {
+  id: string;
+  content: string;
+  mediaPath?: string;
+  mediaType?: MediaType;
+}
+
+export interface InboxReplyResponse {
+  outboxId: string;
+  status: OutboxStatus;
+}
+
+export interface InboxStatsRequest {
+  service?: ServiceName;
+  profile?: string;
+}
+
+export interface InboxStatsResponse {
+  pending: number;
+  done: number;
+  total: number;
+}
+
+export interface OutboxSendRequest {
+  service: ServiceName;
+  profile: string;
+  conversationId: string;
+  content?: string;
+  mediaPath?: string;
+  mediaType?: MediaType;
+  replyToPlatformId?: string;
+  metadata?: Record<string, unknown>;
+}
+
+export interface OutboxSendResponse {
+  id: string;
+  status: OutboxStatus;
+}
+
+export interface OutboxStatusRequest {
+  id: string;
+}
+
+export interface OutboxStatusResponse {
+  message: OutboundMessage | null;
+}
+
+export interface OutboxListRequest {
+  service?: ServiceName;
+  profile?: string;
+  status?: OutboxStatus;
+  limit?: number;
+}
+
+export interface OutboxListResponse {
+  messages: OutboundMessage[];
+}
+
+export interface GatewayStatusResponse {
+  running: boolean;
+  uptime: number;
+  adapters: {
+    service: ServiceName;
+    profile: string;
+    connected: boolean;
+    error?: string;
+  }[];
+}
+
+export interface HealthResponse {
+  status: 'ok' | 'error';
+  timestamp: number;
+}
+
+/**
+ * Webhook notification payload
+ */
+export interface WebhookPayload {
+  event: 'inbox.message';
+  timestamp: number;
+  messages: {
+    id: string;
+    service: ServiceName;
+    profile: string;
+    sender: string;
+    preview: string;
+  }[];
+}
+
+/**
+ * Daemon state
+ */
+export interface DaemonState {
+  pid: number;
+  startedAt: number;
+  adapters: string[];  // Format: "service:profile"
+}
+
+/**
+ * WhatsApp pairing request/response types
+ */
+export interface WhatsAppPairRequest {
+  profile: string;
+}
+
+export interface WhatsAppPairResponse {
+  status: 'waiting_qr' | 'connected' | 'connecting' | 'not_configured';
+  qrCode?: string;         // QR code string for Baileys
+  phoneNumber?: string;    // Phone number if connected
+  displayName?: string;    // Display name if available
+  message?: string;        // Status message
+}
+
+/**
+ * WhatsApp Group API types
+ */
+import type {
+  WhatsAppGroup,
+  WhatsAppGroupCreateOptions,
+  WhatsAppGroupUpdateOptions,
+  WhatsAppParticipantAction,
+} from '../types/whatsapp';
+
+export interface WhatsAppGroupListRequest {
+  profile: string;
+}
+
+export interface WhatsAppGroupListResponse {
+  groups: WhatsAppGroup[];
+}
+
+export interface WhatsAppGroupGetRequest {
+  profile: string;
+  groupId: string;
+}
+
+export interface WhatsAppGroupGetResponse {
+  group: WhatsAppGroup;
+}
+
+export interface WhatsAppGroupCreateRequest {
+  profile: string;
+  name: string;
+  participants: string[];
+  picture?: string;  // Path to profile picture image
+}
+
+export interface WhatsAppGroupCreateResponse {
+  group: WhatsAppGroup;
+}
+
+export interface WhatsAppGroupUpdateRequest {
+  profile: string;
+  groupId: string;
+  subject?: string;
+  description?: string;
+  picture?: string;  // Path to profile picture image
+}
+
+export interface WhatsAppGroupUpdateResponse {
+  success: boolean;
+}
+
+export interface WhatsAppGroupParticipantsRequest {
+  profile: string;
+  groupId: string;
+  participants: string[];
+  action: WhatsAppParticipantAction;
+}
+
+export interface WhatsAppGroupParticipantsResponse {
+  success: boolean;
+  results?: { participant: string; status: string }[];
+}
+
+export interface WhatsAppGroupLeaveRequest {
+  profile: string;
+  groupId: string;
+}
+
+export interface WhatsAppGroupLeaveResponse {
+  success: boolean;
+}
+
+export interface WhatsAppGroupInviteRequest {
+  profile: string;
+  groupId: string;
+}
+
+export interface WhatsAppGroupInviteResponse {
+  inviteCode: string;
+  inviteLink: string;
+}
+
+export interface WhatsAppGroupJoinRequest {
+  profile: string;
+  inviteCode: string;
+}
+
+export interface WhatsAppGroupJoinResponse {
+  groupId: string;
+}
+
+export interface WhatsAppGroupResolveRequest {
+  profile: string;
+  nameOrId: string;
+}
+
+export interface WhatsAppGroupResolveResponse {
+  groupId: string | null;
+  groupName: string | null;
+}

package/src/gateway/webhook.ts

@@ -0,0 +1,109 @@
+import { createHmac } from 'crypto';
+import type { ServiceName } from '../types/config';
+import type { WebhookPayload, GatewayConfig } from './types';
+
+interface PendingMessage {
+  id: string;
+  service: ServiceName;
+  profile: string;
+  sender: string;
+  preview: string;
+}
+
+let pendingMessages: PendingMessage[] = [];
+let debounceTimer: ReturnType<typeof setTimeout> | null = null;
+let webhookConfig: GatewayConfig['webhook'] | null = null;
+
+/**
+ * Configure the webhook notifier
+ */
+export function configureWebhook(config: GatewayConfig['webhook']): void {
+  webhookConfig = config;
+}
+
+/**
+ * Queue a message for webhook notification
+ * Messages are debounced to batch multiple notifications
+ */
+export function queueWebhookNotification(message: PendingMessage): void {
+  if (!webhookConfig?.url) return;
+
+  pendingMessages.push(message);
+
+  // Clear existing timer
+  if (debounceTimer) {
+    clearTimeout(debounceTimer);
+  }
+
+  // Set new debounce timer
+  const debounceMs = webhookConfig.debounceMs ?? 2000;
+  debounceTimer = setTimeout(() => {
+    sendWebhook();
+  }, debounceMs);
+}
+
+/**
+ * Send pending webhook notifications
+ */
+async function sendWebhook(): Promise<void> {
+  if (!webhookConfig?.url || pendingMessages.length === 0) return;
+
+  const messages = [...pendingMessages];
+  pendingMessages = [];
+  debounceTimer = null;
+
+  const payload: WebhookPayload = {
+    event: 'inbox.message',
+    timestamp: Math.floor(Date.now() / 1000),
+    messages,
+  };
+
+  const body = JSON.stringify(payload);
+  const headers: Record<string, string> = {
+    'Content-Type': 'application/json',
+  };
+
+  // Add HMAC signature if secret is configured
+  if (webhookConfig.secret) {
+    const signature = createHmac('sha256', webhookConfig.secret)
+      .update(body)
+      .digest('hex');
+    headers['X-Agentio-Signature'] = `sha256=${signature}`;
+  }
+
+  try {
+    const response = await fetch(webhookConfig.url, {
+      method: 'POST',
+      headers,
+      body,
+    });
+
+    if (!response.ok) {
+      console.error(`Webhook failed: ${response.status} ${response.statusText}`);
+    }
+  } catch (error) {
+    console.error('Webhook error:', error instanceof Error ? error.message : error);
+  }
+}
+
+/**
+ * Flush any pending webhook notifications immediately
+ */
+export async function flushWebhook(): Promise<void> {
+  if (debounceTimer) {
+    clearTimeout(debounceTimer);
+  }
+  await sendWebhook();
+}
+
+/**
+ * Stop the webhook notifier
+ */
+export function stopWebhook(): void {
+  if (debounceTimer) {
+    clearTimeout(debounceTimer);
+    debounceTimer = null;
+  }
+  pendingMessages = [];
+  webhookConfig = null;
+}

package/src/index.ts

@@ -1,21 +1,30 @@
 #!/usr/bin/env bun
+// Polyfills must be imported first (before any code that uses protobufjs)
+import './polyfills';
 import { Command } from 'commander';
-import { registerGmailCommands } from './commands/gmail';
+// Services (alphabetical)
+import { registerDiscourseCommands } from './commands/discourse';
+import { registerGCalCommands } from './commands/gcal';
+import { registerGChatCommands } from './commands/gchat';
 import { registerGDocsCommands } from './commands/gdocs';
 import { registerGDriveCommands } from './commands/gdrive';
-import { registerTelegramCommands } from './commands/telegram';
-import { registerGChatCommands } from './commands/gchat';
 import { registerGitHubCommands } from './commands/github';
+import { registerGmailCommands } from './commands/gmail';
+import { registerGTasksCommands } from './commands/gtasks';
 import { registerJiraCommands } from './commands/jira';
-import { registerSlackCommands } from './commands/slack';
 import { registerRssCommands } from './commands/rss';
-import { registerDiscourseCommands } from './commands/discourse';
+import { registerSlackCommands } from './commands/slack';
 import { registerSqlCommands } from './commands/sql';
-import { registerUpdateCommand } from './commands/update';
-import { registerConfigCommands } from './commands/config';
+import { registerTelegramCommands } from './commands/telegram';
+import { registerWhatsAppCommands } from './commands/whatsapp';
+
+// Agentio utilities
 import { registerClaudeCommands } from './commands/claude';
-import { registerStatusCommand } from './commands/status';
+import { registerConfigCommands } from './commands/config';
 import { registerDocsCommand } from './commands/docs';
+import { registerGatewayCommands } from './commands/gateway';
+import { registerStatusCommand } from './commands/status';
+import { registerUpdateCommand } from './commands/update';
 
 declare const BUILD_VERSION: string | undefined;
 
@@ -34,21 +43,28 @@ program
   .description('CLI for LLM agents to interact with communication and tracking services')
   .version(getVersion());
 
-registerGmailCommands(program);
+// Services (alphabetical)
+registerDiscourseCommands(program);
+registerGCalCommands(program);
+registerGChatCommands(program);
 registerGDocsCommands(program);
 registerGDriveCommands(program);
-registerTelegramCommands(program);
-registerGChatCommands(program);
 registerGitHubCommands(program);
+registerGmailCommands(program);
+registerGTasksCommands(program);
 registerJiraCommands(program);
-registerSlackCommands(program);
 registerRssCommands(program);
-registerDiscourseCommands(program);
+registerSlackCommands(program);
 registerSqlCommands(program);
-registerUpdateCommand(program);
-registerConfigCommands(program);
+registerTelegramCommands(program);
+registerWhatsAppCommands(program);
+
+// Agentio utilities
 registerClaudeCommands(program);
-registerStatusCommand(program);
+registerConfigCommands(program);
 registerDocsCommand(program);
+registerGatewayCommands(program);
+registerStatusCommand(program);
+registerUpdateCommand(program);
 
 program.parse();

package/src/polyfills.ts

@@ -0,0 +1,10 @@
+// Polyfills for native binary compilation
+// This must be imported BEFORE any code that uses protobufjs (e.g., Baileys)
+
+import Long from 'long';
+import protobuf from 'protobufjs';
+
+// Fix for protobufjs Long support in Bun native binaries
+// Without this, $util.Long.fromBits is undefined at runtime
+protobuf.util.Long = Long;
+protobuf.configure();