@plosson/agentio 0.4.2 → 0.4.3

package/src/types/config.ts

@@ -1,17 +1,52 @@
+export interface GatewayApiConfig {
+  port?: number;
+  host?: string;
+  secret?: string;
+}
+
+export interface GatewayWebhookConfig {
+  url?: string;
+  secret?: string;
+  debounceMs?: number;
+}
+
+export interface GatewayMediaConfig {
+  download?: boolean;
+  maxSizeMb?: number;
+}
+
+export interface GatewayRetentionConfig {
+  doneMessagesDays?: number;
+  sentMessagesDays?: number;
+}
+
+export interface GatewayConfig {
+  name?: string;           // Gateway identity name
+  secret?: string;         // Shared secret for API auth and teleport
+  api?: GatewayApiConfig;
+  webhook?: GatewayWebhookConfig;
+  media?: GatewayMediaConfig;
+  retention?: GatewayRetentionConfig;
+}
+
 export interface Config {
   profiles: {
     gdocs?: string[];
     gdrive?: string[];
     gmail?: string[];
+    gcal?: string[];
+    gtasks?: string[];
     gchat?: string[];
     github?: string[];
     jira?: string[];
     slack?: string[];
     telegram?: string[];
+    whatsapp?: string[];
     discourse?: string[];
     sql?: string[];
   };
   env?: Record<string, string>;
+  gateway?: GatewayConfig;
 }
 
-export type ServiceName = 'gdocs' | 'gdrive' | 'gmail' | 'gchat' | 'github' | 'jira' | 'slack' | 'telegram' | 'discourse' | 'sql';
+export type ServiceName = 'gdocs' | 'gdrive' | 'gmail' | 'gcal' | 'gtasks' | 'gchat' | 'github' | 'jira' | 'slack' | 'telegram' | 'whatsapp' | 'discourse' | 'sql';

package/src/types/gcal.ts

@@ -0,0 +1,135 @@
+import type { OAuthTokens } from './tokens';
+
+export type GCalCredentials = OAuthTokens & { email?: string };
+
+export interface GCalCalendar {
+  id: string;
+  summary: string;
+  description?: string;
+  accessRole: string;
+  primary?: boolean;
+  timeZone?: string;
+}
+
+export interface GCalEventDateTime {
+  dateTime?: string;  // RFC3339 timestamp with timezone
+  date?: string;      // YYYY-MM-DD for all-day events
+  timeZone?: string;  // IANA timezone name
+}
+
+export interface GCalAttendee {
+  email: string;
+  displayName?: string;
+  responseStatus?: string;  // needsAction, declined, tentative, accepted
+  optional?: boolean;
+  organizer?: boolean;
+  self?: boolean;
+  comment?: string;
+}
+
+export interface GCalReminder {
+  method: 'email' | 'popup';
+  minutes: number;
+}
+
+export interface GCalEvent {
+  id: string;
+  summary?: string;
+  description?: string;
+  location?: string;
+  start: GCalEventDateTime;
+  end: GCalEventDateTime;
+  status?: string;  // confirmed, tentative, cancelled
+  htmlLink?: string;
+  created?: string;
+  updated?: string;
+  colorId?: string;
+  creator?: { email: string; displayName?: string };
+  organizer?: { email: string; displayName?: string };
+  attendees?: GCalAttendee[];
+  recurrence?: string[];
+  recurringEventId?: string;
+  transparency?: string;  // opaque (busy) or transparent (free)
+  visibility?: string;  // default, public, private, confidential
+  reminders?: {
+    useDefault: boolean;
+    overrides?: GCalReminder[];
+  };
+  hangoutLink?: string;
+  conferenceData?: {
+    entryPoints?: Array<{
+      entryPointType: string;
+      uri: string;
+      label?: string;
+    }>;
+  };
+  eventType?: string;  // default, focusTime, outOfOffice, workingLocation
+}
+
+export interface GCalFreeBusyResponse {
+  calendars: Record<string, {
+    busy: Array<{ start: string; end: string }>;
+    errors?: Array<{ domain: string; reason: string }>;
+  }>;
+}
+
+export interface GCalListOptions {
+  calendarId?: string;
+  timeMin?: string;  // RFC3339
+  timeMax?: string;  // RFC3339
+  maxResults?: number;
+  pageToken?: string;
+  query?: string;
+  singleEvents?: boolean;
+  orderBy?: 'startTime' | 'updated';
+}
+
+export interface GCalCreateOptions {
+  calendarId?: string;
+  summary: string;
+  description?: string;
+  location?: string;
+  start: string;  // RFC3339 or YYYY-MM-DD for all-day
+  end: string;
+  allDay?: boolean;
+  attendees?: string[];  // email addresses
+  recurrence?: string[];  // RRULE strings
+  reminders?: Array<{ method: 'email' | 'popup'; minutes: number }>;
+  colorId?: string;
+  visibility?: 'default' | 'public' | 'private' | 'confidential';
+  transparency?: 'opaque' | 'transparent';
+  sendUpdates?: 'all' | 'externalOnly' | 'none';
+  withMeet?: boolean;
+}
+
+export interface GCalUpdateOptions {
+  calendarId?: string;
+  eventId: string;
+  summary?: string;
+  description?: string;
+  location?: string;
+  start?: string;
+  end?: string;
+  allDay?: boolean;
+  attendees?: string[];
+  addAttendees?: string[];
+  recurrence?: string[];
+  reminders?: Array<{ method: 'email' | 'popup'; minutes: number }>;
+  colorId?: string;
+  visibility?: 'default' | 'public' | 'private' | 'confidential';
+  transparency?: 'opaque' | 'transparent';
+  sendUpdates?: 'all' | 'externalOnly' | 'none';
+}
+
+export interface GCalRespondOptions {
+  calendarId?: string;
+  eventId: string;
+  status: 'accepted' | 'declined' | 'tentative';
+  comment?: string;
+}
+
+export interface GCalFreeBusyOptions {
+  calendarIds: string[];
+  timeMin: string;
+  timeMax: string;
+}

package/src/types/gtasks.ts

@@ -0,0 +1,58 @@
+import type { OAuthTokens } from './tokens';
+
+export type GTasksCredentials = OAuthTokens & { email?: string };
+
+export interface GTaskList {
+  id: string;
+  title: string;
+  updated?: string;
+  selfLink?: string;
+}
+
+export interface GTask {
+  id: string;
+  title: string;
+  status: 'needsAction' | 'completed';
+  notes?: string;
+  due?: string;
+  completed?: string;
+  parent?: string;
+  position?: string;
+  updated?: string;
+  selfLink?: string;
+  webViewLink?: string;
+  hidden?: boolean;
+  deleted?: boolean;
+}
+
+export interface GTasksListOptions {
+  tasklistId: string;
+  maxResults?: number;
+  pageToken?: string;
+  showCompleted?: boolean;
+  showDeleted?: boolean;
+  showHidden?: boolean;
+  dueMin?: string;
+  dueMax?: string;
+  completedMin?: string;
+  completedMax?: string;
+  updatedMin?: string;
+}
+
+export interface GTasksCreateOptions {
+  tasklistId: string;
+  title: string;
+  notes?: string;
+  due?: string;
+  parent?: string;
+  previous?: string;
+}
+
+export interface GTasksUpdateOptions {
+  tasklistId: string;
+  taskId: string;
+  title?: string;
+  notes?: string;
+  due?: string;
+  status?: 'needsAction' | 'completed';
+}

package/src/types/qrcode-terminal.d.ts

@@ -0,0 +1,8 @@
+declare module 'qrcode-terminal' {
+  interface Options {
+    small?: boolean;
+  }
+
+  export function generate(text: string, options?: Options, callback?: (qrcode: string) => void): void;
+  export function setErrorLevel(level: 'L' | 'M' | 'Q' | 'H'): void;
+}

package/src/types/whatsapp.ts

@@ -0,0 +1,116 @@
+/**
+ * WhatsApp credentials stored for a profile
+ * Note: The actual auth state (keys, session) is stored in the gateway SQLite database
+ */
+export interface WhatsAppCredentials {
+  // Profile identifier (phone number after pairing)
+  phoneNumber?: string;
+  // Display name of the WhatsApp account
+  displayName?: string;
+  // Whether this profile has been paired
+  paired: boolean;
+  // Timestamp of last successful connection
+  lastConnected?: number;
+}
+
+/**
+ * WhatsApp message types
+ */
+export type WhatsAppMessageType = 'text' | 'image' | 'video' | 'audio' | 'document' | 'sticker' | 'location' | 'contact';
+
+/**
+ * WhatsApp contact info
+ */
+export interface WhatsAppContact {
+  id: string;          // JID (e.g., "1234567890@s.whatsapp.net")
+  name?: string;       // Push name
+  notify?: string;     // Notify name
+  verifiedName?: string; // Business verified name
+  phone: string;       // Phone number extracted from JID
+}
+
+/**
+ * WhatsApp chat info
+ */
+export interface WhatsAppChat {
+  id: string;          // JID
+  name?: string;       // Chat name (contact name or group name)
+  isGroup: boolean;
+  participantCount?: number;
+  unreadCount?: number;
+  lastMessageTime?: number;
+}
+
+/**
+ * WhatsApp message
+ */
+export interface WhatsAppMessage {
+  id: string;          // Message ID
+  chatId: string;      // Chat JID
+  senderId: string;    // Sender JID
+  senderName?: string;
+  timestamp: number;
+  type: WhatsAppMessageType;
+  content?: string;    // Text content
+  caption?: string;    // Media caption
+  mediaUrl?: string;   // URL for media
+  quotedMessageId?: string;
+  isFromMe: boolean;
+}
+
+/**
+ * WhatsApp send options
+ */
+export interface WhatsAppSendOptions {
+  quotedMessageId?: string;
+}
+
+/**
+ * WhatsApp group information
+ */
+export interface WhatsAppGroup {
+  id: string;              // Group JID (e.g., "120363xxx@g.us")
+  name: string;            // Group subject/name
+  description?: string;
+  owner?: string;          // Owner JID
+  creation?: number;       // Creation timestamp
+  participantCount: number;
+  participants?: WhatsAppGroupParticipant[];
+  isAdmin: boolean;        // Whether current user is admin
+  isSuperAdmin: boolean;   // Whether current user is super admin (creator)
+  announce: boolean;       // Only admins can send messages
+  restrict: boolean;       // Only admins can modify group info
+  inviteCode?: string;
+}
+
+/**
+ * WhatsApp group participant
+ */
+export interface WhatsAppGroupParticipant {
+  id: string;              // Participant JID
+  name?: string;           // Push name
+  phone: string;           // Phone number
+  isAdmin: boolean;
+  isSuperAdmin: boolean;
+}
+
+/**
+ * Options for creating a group
+ */
+export interface WhatsAppGroupCreateOptions {
+  name: string;
+  participants: string[];  // Phone numbers or JIDs
+}
+
+/**
+ * Options for updating a group
+ */
+export interface WhatsAppGroupUpdateOptions {
+  subject?: string;        // Group name
+  description?: string;    // Group description
+}
+
+/**
+ * Participant update action
+ */
+export type WhatsAppParticipantAction = 'add' | 'remove' | 'promote' | 'demote';